Feat/migrate backend

ai-context/core-features-reference.md

@@ -12,23 +12,23 @@ This document provides the correct import paths and type definitions for commonl
 ## Features
 
 ### TenantContext
-- **Import:** `import { TenantContext } from "@webiny/api-tenancy/features/TenantContext"`
-- **Interface Type:** See `packages/api-tenancy/src/features/TenantContext/abstractions.ts`
+- **Import:** `import { TenantContext } from "@webiny/api-core/features/TenantContext"`
+- **Interface Type:** See `packages/api-core/src/features/TenantContext/abstractions.ts`
 - **Usage:** Access current tenant information
 
 ### IdentityContext
-- **Import:** `import { IdentityContext } from "@webiny/api-security/features/IdentityContext"`
-- **Interface Type:** See `packages/api-security/src/features/IdentityContext/abstractions.ts`
+- **Import:** `import { IdentityContext } from "@webiny/api-core/features/IdentityContext"`
+- **Interface Type:** See `packages/api-core/src/features/IdentityContext/abstractions.ts`
 - **Usage:** Access current user identity and permissions
 
 ### EventPublisher
-- **Import:** `import { EventPublisher } from "@webiny/api-core"`
+- **Import:** `import { EventPublisher } from "@webiny/api-core/features/EventPublisher"`
 - **Interface Type:** See `packages/api-core/src/event-publisher/abstractions.ts`
 - **Usage:** Publish domain events
 
 ### WcpContext
-- **Import:** `import { WcpContext } from "@webiny/api-wcp/features/WcpContext"`
-- **Interface Type:** See `packages/api-wcp/src/features/WcpContext/abstractions.ts`
+- **Import:** `import { WcpContext } from "@webiny/api-core/features/WcpContext"`
+- **Interface Type:** See `packages/api-core/src/features/WcpContext/abstractions.ts`
 - **Usage:** WCP (Webiny Control Panel) integration for seats/tenants management
 
 ### GetSettings
@@ -43,6 +43,94 @@ This document provides the correct import paths and type definitions for commonl
 
 ---
 
+## Headless CMS Features
+
+### Content Entry Features
+
+#### GetEntryById
+- **Import:** `import { GetEntryByIdUseCase } from "@webiny/api-headless-cms/features/contentEntry/GetEntryById"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/GetEntryById/abstractions.ts`
+- **Usage:** Fetch single entry by exact revision ID
+
+#### GetEntry
+- **Import:** `import { GetEntryUseCase } from "@webiny/api-headless-cms/features/contentEntry/GetEntry"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/GetEntry/abstractions.ts`
+- **Usage:** Get single entry by query parameters (where + sort)
+
+#### ListLatestEntries
+- **Import:** `import { ListLatestEntriesUseCase } from "@webiny/api-headless-cms/features/contentEntry/ListEntries"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/ListEntries/abstractions.ts`
+- **Usage:** List latest entries (manage API)
+
+#### ListPublishedEntries
+- **Import:** `import { ListPublishedEntriesUseCase } from "@webiny/api-headless-cms/features/contentEntry/ListEntries"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/ListEntries/abstractions.ts`
+- **Usage:** List published entries (read API)
+
+#### ListDeletedEntries
+- **Import:** `import { ListDeletedEntriesUseCase } from "@webiny/api-headless-cms/features/contentEntry/ListEntries"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/ListEntries/abstractions.ts`
+- **Usage:** List deleted entries (manage API)
+
+#### CreateEntry
+- **Import:** `import { CreateEntryUseCase } from "@webiny/api-headless-cms/features/contentEntry/CreateEntry"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/CreateEntry/abstractions.ts`
+- **Usage:** Create new content entry
+
+#### UpdateEntry
+- **Import:** `import { UpdateEntryUseCase } from "@webiny/api-headless-cms/features/contentEntry/UpdateEntry"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/UpdateEntry/abstractions.ts`
+- **Usage:** Update existing content entry
+
+#### DeleteEntry
+- **Import:** `import { DeleteEntryUseCase } from "@webiny/api-headless-cms/features/contentEntry/DeleteEntry"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/DeleteEntry/abstractions.ts`
+- **Usage:** Delete content entry
+
+#### ListEntriesRepository
+- **Import:** `import { ListEntriesRepository } from "@webiny/api-headless-cms/features/contentEntry/ListEntries"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentEntry/ListEntries/abstractions.ts`
+- **Usage:** Repository for fetching entries from storage
+
+### Content Model Features
+
+#### GetModel
+- **Import:** `import { GetModelUseCase } from "@webiny/api-headless-cms/features/contentModel/GetModel"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/GetModel/abstractions.ts`
+- **Usage:** Retrieve single model by ID with access control
+
+#### ListModels
+- **Import:** `import { ListModelsUseCase } from "@webiny/api-headless-cms/features/contentModel/ListModels"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/ListModels/abstractions.ts`
+- **Usage:** List all accessible content models
+
+#### GetModelRepository
+- **Import:** `import { GetModelRepository } from "@webiny/api-headless-cms/features/contentModel/GetModel"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/GetModel/abstractions.ts`
+- **Usage:** Fetch model from cache (plugin + DB models)
+
+#### ListModelsRepository
+- **Import:** `import { ListModelsRepository } from "@webiny/api-headless-cms/features/contentModel/ListModels"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/ListModels/abstractions.ts`
+- **Usage:** Fetch all models from cache
+
+#### ModelsFetcher
+- **Import:** `import { ModelsFetcher } from "@webiny/api-headless-cms/features/contentModel/shared"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/shared/abstractions.ts`
+- **Usage:** Centralized model fetching with caching and access control
+
+#### ModelCache
+- **Import:** `import { ModelCache } from "@webiny/api-headless-cms/features/contentModel/shared"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/shared/abstractions.ts`
+- **Usage:** Cache for content models
+
+#### PluginModelsProvider
+- **Import:** `import { PluginModelsProvider } from "@webiny/api-headless-cms/features/contentModel/shared"`
+- **Interface Type:** See `packages/api-headless-cms/src/features/contentModel/shared/abstractions.ts`
+- **Usage:** Access to plugin-defined models
+
+---
+
 ## Notes
 
 - Always import abstractions from the feature path (not from package root)

ai-context/di-container.md

@@ -1,16 +1,61 @@
 ```ts
 // Abstraction.ts
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import type { Constructor, Dependencies, GetInterface, MapDependencies } from "./types.js";
+import { Metadata } from "./Metadata.js";
+
+type DropLast<T> = T extends [...infer P, any] ? [...P] : never;
+
+type Implementation<A extends Abstraction<any>, I extends Constructor> = I & {
+    __abstraction: A;
+};
+
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 export class Abstraction<T> {
     public readonly token: symbol;
 
     constructor(name: string) {
-        this.token = Symbol.for(name);
+        this.token = Symbol(name);
     }
 
     toString(): string {
         return this.token.description || this.token.toString();
     }
+
+    createImplementation<I extends Constructor<GetInterface<this>>>(params: {
+        implementation: I;
+        dependencies: Dependencies<I>;
+    }): Implementation<this, I> {
+        const metadata = new Metadata(params.implementation);
+        metadata.setAbstraction(this);
+        metadata.setDependencies(params.dependencies);
+
+        return params.implementation as Implementation<this, I>;
+    }
+
+    createDecorator<I extends Constructor>(params: {
+        decorator: I;
+        dependencies: MapDependencies<DropLast<ConstructorParameters<I>>>;
+    }): Implementation<this, I> {
+        const metadata = new Metadata(params.decorator);
+        metadata.setAbstraction(this);
+        metadata.setDependencies(params.dependencies as any);
+        metadata.setAttribute("IS_DECORATOR", true);
+
+        return params.decorator as Implementation<this, I>;
+    }
+
+    createComposite<I extends Constructor<GetInterface<this>>>(params: {
+        implementation: I;
+        dependencies: Dependencies<I>;
+    }): Implementation<this, I> {
+        const metadata = new Metadata(params.implementation);
+        metadata.setAbstraction(this);
+        metadata.setDependencies(params.dependencies);
+        metadata.setAttribute("IS_COMPOSITE", true);
+
+        return params.implementation as Implementation<this, I>;
+    }
 }
 ```
 

ai-context/event-publisher.md

@@ -24,7 +24,7 @@ export class EventPublisher implements Abstraction.Interface {
 ```ts
 // __tests__/EventPublisher.test.ts
 import { describe, it, expect, beforeEach } from "vitest";
-import { Container, Abstraction, createImplementation } from "@webiny/di";
+import { Container, Abstraction } from "@webiny/di";
 import { EventPublisherFeature } from "../feature";
 import { EventPublisher as EventPublisherAbstraction } from "../abstractions";
 import type { DomainEvent, IEventHandler } from "../abstractions";
@@ -123,8 +123,7 @@ class SendNotificationHandler implements IEventHandler<PagePublishedEvent> {
     }
 }
 
-export const SendNotificationHandlerImpl = createImplementation({
-    abstraction: PagePublishedHandler,
+export const SendNotificationHandlerImpl = PagePublishedHandler.createImplementation({
     implementation: SendNotificationHandler,
     dependencies: []
 });
@@ -138,8 +137,7 @@ class UpdateSearchIndexHandler implements IEventHandler<PagePublishedEvent> {
     }
 }
 
-export const UpdateSearchIndexHandlerImpl = createImplementation({
-    abstraction: PagePublishedHandler,
+export const UpdateSearchIndexHandlerImpl = PagePublishedHandler.createImplementation({
     implementation: UpdateSearchIndexHandler,
     dependencies: []
 });
@@ -155,8 +153,7 @@ class LogPagePublishedHandler implements IEventHandler<PagePublishedEvent> {
     }
 }
 
-export const LogPagePublishedHandlerImpl = createImplementation({
-    abstraction: PagePublishedHandler,
+export const LogPagePublishedHandlerImpl = PagePublishedHandler.createImplementation({
     implementation: LogPagePublishedHandler,
     dependencies: []
 });
@@ -174,8 +171,7 @@ class SendWelcomeEmailHandler implements IEventHandler<UserRegisteredEvent> {
     }
 }
 
-export const SendWelcomeEmailHandlerImpl = createImplementation({
-    abstraction: UserRegisteredHandler,
+export const SendWelcomeEmailHandlerImpl = UserRegisteredHandler.createImplementation({
     implementation: SendWelcomeEmailHandler,
     dependencies: []
 });
@@ -189,8 +185,7 @@ class CreateUserProfileHandler implements IEventHandler<UserRegisteredEvent> {
     }
 }
 
-export const CreateUserProfileHandlerImpl = createImplementation({
-    abstraction: UserRegisteredHandler,
+export const CreateUserProfileHandlerImpl = UserRegisteredHandler.createImplementation({
     implementation: CreateUserProfileHandler,
     dependencies: []
 });
@@ -204,8 +199,7 @@ class TrackUserRegistrationHandler implements IEventHandler<UserRegisteredEvent>
     }
 }
 
-export const TrackUserRegistrationHandlerImpl = createImplementation({
-    abstraction: UserRegisteredHandler,
+export const TrackUserRegistrationHandlerImpl = UserRegisteredHandler.createImplementation({
     implementation: TrackUserRegistrationHandler,
     dependencies: []
 });
@@ -223,8 +217,7 @@ class ProcessPaymentHandler implements IEventHandler<OrderPlacedEvent> {
     }
 }
 
-export const ProcessPaymentHandlerImpl = createImplementation({
-    abstraction: OrderPlacedHandler,
+export const ProcessPaymentHandlerImpl = OrderPlacedHandler.createImplementation({
     implementation: ProcessPaymentHandler,
     dependencies: []
 });
@@ -238,8 +231,7 @@ class SendOrderConfirmationHandler implements IEventHandler<OrderPlacedEvent> {
     }
 }
 
-export const SendOrderConfirmationHandlerImpl = createImplementation({
-    abstraction: OrderPlacedHandler,
+export const SendOrderConfirmationHandlerImpl = OrderPlacedHandler.createImplementation({
     implementation: SendOrderConfirmationHandler,
     dependencies: []
 });
@@ -253,8 +245,7 @@ class UpdateInventoryHandler implements IEventHandler<OrderPlacedEvent> {
     }
 }
 
-export const UpdateInventoryHandlerImpl = createImplementation({
-    abstraction: OrderPlacedHandler,
+export const UpdateInventoryHandlerImpl = OrderPlacedHandler.createImplementation({
     implementation: UpdateInventoryHandler,
     dependencies: []
 });
@@ -541,8 +532,7 @@ describe("EventPublisher", () => {
                 }
             }
 
-            const FailingHandlerImpl = createImplementation({
-                abstraction: PagePublishedHandler,
+            const FailingHandlerImpl = PagePublishedHandler.createImplementation({
                 implementation: FailingHandler,
                 dependencies: []
             });

ai-context/simple-models.md

@@ -1,7 +1,6 @@
 ```ts
 // Page/PageModelBuilder.ts
 import { ModelBuilder as Builder } from "~/models/ModelBuilder.js";
-import { createImplementation } from "@webiny/di";
 import { PageSchema, PageModelBuilder as BuilderAbstraction, type IPage } from "./abstractions";
 
 class PageModelBuilderImpl implements BuilderAbstraction.Interface {
@@ -15,16 +14,14 @@ class PageModelBuilderImpl implements BuilderAbstraction.Interface {
     }
 }
 
-export const PageModelBuilder = createImplementation({
-    abstraction: BuilderAbstraction,
+export const PageModelBuilder = BuilderAbstraction.createImplementation({
     implementation: PageModelBuilderImpl,
     dependencies: []
 });
 ```
 
 ```ts
 // Page/PageModelFactory.ts
-import { createImplementation } from "@webiny/di";
 import {
     PageModelFactory as FactoryAbstraction,
     PageModelBuilder,
@@ -49,16 +46,14 @@ class PageModelFactoryImpl implements FactoryAbstraction.Interface {
     }
 }
 
-export const PageModelFactory = createImplementation({
-    abstraction: FactoryAbstraction,
+export const PageModelFactory = FactoryAbstraction.createImplementation({
     implementation: PageModelFactoryImpl,
     dependencies: [PageModelBuilder]
 });
 ```
 
 ```ts
 // Page/__tests__/PageModelBuilderDecorator.ts
-import { createDecorator } from "@webiny/di";
 import { PageModelBuilder as BuilderAbstraction } from "../abstractions";
 
 class PageModelBuilderDecoratorImpl implements BuilderAbstraction.Interface {
@@ -81,8 +76,7 @@ class PageModelBuilderDecoratorImpl implements BuilderAbstraction.Interface {
     }
 }
 
-export const PageModelBuilderDecorator = createDecorator({
-    abstraction: BuilderAbstraction,
+export const PageModelBuilderDecorator = BuilderAbstraction.createDecorator({
     decorator: PageModelBuilderDecoratorImpl,
     dependencies: []
 });
@@ -100,7 +94,6 @@ declare module "~/simple/Page/abstractions.js" {
 
 ```ts
 // Page/__tests__/PageModelBuilderDecorator2.ts
-import { createDecorator } from "@webiny/di";
 import { PageModelBuilder as BuilderAbstraction } from "../abstractions";
 
 class PageModelBuilderDecorator2Impl implements BuilderAbstraction.Interface {
@@ -117,8 +110,7 @@ class PageModelBuilderDecorator2Impl implements BuilderAbstraction.Interface {
     }
 }
 
-export const PageModelBuilderDecorator2 = createDecorator({
-    abstraction: BuilderAbstraction,
+export const PageModelBuilderDecorator2 = BuilderAbstraction.createDecorator({
     decorator: PageModelBuilderDecorator2Impl,
     dependencies: []
 });