@agilesyndrome/cf-genai-base 5.0.2 → 6.0.0

package/dist/data/resources.js

@@ -0,0 +1,129 @@
+import { DATA_OPERATIONS, DATA_SCOPES, } from "./model.js";
+export { DATA_OPERATIONS, DATA_SCOPES } from "./model.js";
+export class DataScopeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DataScopeError";
+    }
+}
+/** Validate once at application composition time; query builders can then stay simple. */
+export function normalizeDataResources(resources = []) {
+    const names = new Set();
+    return resources.map((resource) => normalizeDataResource(resource, names));
+}
+function normalizeDataResource(resource, names) {
+    if (!resource || !/^[a-z][a-z0-9_-]*$/.test(String(resource.name || ""))) {
+        throw new TypeError("Data resources require a safe name");
+    }
+    if (!/^[a-z][a-z0-9_]*$/.test(String(resource.table || ""))) {
+        throw new TypeError(`Data resource ${resource.name} requires a safe table name`);
+    }
+    const name = String(resource.name);
+    if (names.has(name))
+        throw new TypeError(`Duplicate data resource: ${name}`);
+    names.add(name);
+    const scope = String(resource.scope || "").toLowerCase();
+    if (!isDataScope(scope)) {
+        throw new TypeError(`Data resource ${resource.name} requires scope user, tenant, public, or system`);
+    }
+    const columns = uniqueStrings(resource.columns || []);
+    if (!columns.length || columns.some((column) => !safeIdentifier(column))) {
+        throw new TypeError(`Data resource ${resource.name} requires safe columns`);
+    }
+    const idColumn = String(resource.idColumn || "id");
+    if (!columns.includes(idColumn))
+        throw new TypeError(`Data resource ${resource.name} must include ${idColumn}`);
+    const ownerColumn = String(resource.ownerColumn || "user_id");
+    const tenantColumn = String(resource.tenantColumn || "tenant_id");
+    if (scope === "user" && !columns.includes(ownerColumn)) {
+        throw new TypeError(`User resource ${resource.name} must include ${ownerColumn}`);
+    }
+    if (["tenant", "public"].includes(scope) && !columns.includes(tenantColumn)) {
+        throw new TypeError(`${scope} resource ${resource.name} must include ${tenantColumn}`);
+    }
+    const filterableColumns = uniqueStrings(resource.filterableColumns || columns);
+    const orderableColumns = uniqueStrings(resource.orderableColumns || columns);
+    for (const column of [...filterableColumns, ...orderableColumns]) {
+        if (!columns.includes(column)) {
+            throw new TypeError(`Data resource ${resource.name} references an unselected column`);
+        }
+    }
+    const writableColumns = uniqueStrings(resource.writableColumns || [])
+        .filter((column) => column !== ownerColumn && column !== tenantColumn);
+    if (writableColumns.some((column) => !columns.includes(column))) {
+        throw new TypeError(`Data resource ${resource.name} references an unwritable column`);
+    }
+    const columnScopes = Object.fromEntries(Object.entries(resource.columnScopes || {}).map(([column, scopes]) => [
+        String(column),
+        Array.isArray(scopes) ? scopes.map(String) : [String(scopes)],
+    ]));
+    const invalidColumnScope = Object.entries(columnScopes).some(([column, scopes]) => !columns.includes(column)
+        || scopes.some((requiredScope) => !/^[a-z0-9]+(?::[a-z0-9-]+)+$/.test(requiredScope)));
+    if (invalidColumnScope)
+        throw new TypeError(`Data resource ${resource.name} has invalid column scopes`);
+    const operationScopes = {};
+    for (const [operation, scopes] of Object.entries(resource.operationScopes || {})) {
+        const normalizedScopes = Array.isArray(scopes) ? uniqueStrings(scopes) : [String(scopes)];
+        if (!isDataOperation(operation)
+            || normalizedScopes.some((requiredScope) => !/^[a-z0-9]+(?::[a-z0-9-]+)+$/.test(requiredScope))) {
+            throw new TypeError(`Data resource ${resource.name} has invalid operation scopes`);
+        }
+        operationScopes[operation] = normalizedScopes;
+    }
+    if (!Array.isArray(resource.readableColumns) || !resource.readableColumns.length) {
+        throw new TypeError(`Data resource ${resource.name} requires explicit readableColumns`);
+    }
+    const readableColumns = uniqueStrings(resource.readableColumns);
+    if (readableColumns.some((column) => !columns.includes(column))) {
+        throw new TypeError(`Data resource ${resource.name} references an unreadable column`);
+    }
+    const defaultOperations = ["read", ...(writableColumns.length ? ["create", "update", "delete"] : [])];
+    const normalizedOperations = uniqueStrings(resource.operations || defaultOperations)
+        .map((operation) => operation.toLowerCase());
+    if (!normalizedOperations.length
+        || normalizedOperations.some((operation) => !isDataOperation(operation))
+        || !normalizedOperations.includes("read"))
+        throw new TypeError(`Data resource ${name} has invalid operations`);
+    const operations = [];
+    for (const operation of normalizedOperations) {
+        if (isDataOperation(operation))
+            operations.push(operation);
+    }
+    const publicRead = resource.publicRead && typeof resource.publicRead === "object"
+        ? { column: String(resource.publicRead.column || ""), value: resource.publicRead.value }
+        : Boolean(resource.publicRead);
+    if (publicRead && typeof publicRead === "object"
+        && (!safeIdentifier(publicRead.column) || !columns.includes(publicRead.column)))
+        throw new TypeError(`Public resource ${resource.name} requires a selected visibility column`);
+    return {
+        ...resource,
+        name,
+        table: String(resource.table),
+        scope,
+        columns,
+        readableColumns,
+        idColumn,
+        ownerColumn,
+        tenantColumn,
+        filterableColumns,
+        orderableColumns,
+        writableColumns,
+        columnScopes,
+        operationScopes,
+        operations,
+        publicRead,
+    };
+}
+function uniqueStrings(values) {
+    return [...new Set(values.map(String))];
+}
+function safeIdentifier(value) {
+    return /^[a-z][a-z0-9_]*$/.test(value);
+}
+function isDataScope(value) {
+    return DATA_SCOPES.some((scope) => scope === value);
+}
+function isDataOperation(value) {
+    return DATA_OPERATIONS.some((operation) => operation === value);
+}
+//# sourceMappingURL=resources.js.map

package/dist/data/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/data/resources.ts"],"names":[],"mappings":"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"}

package/dist/domain/app-domain.d.ts

@@ -0,0 +1,36 @@
+import type { DomainAuth, DomainRoute, DomainRouteInput, DomainView } from "./model.js";
+import type { DataResourceInput } from "../data/model.js";
+import type { RepositoryDefinitionInput } from "../repository/model.js";
+export interface AppDomainOptions {
+    name: string;
+    basePath: string;
+    auth?: DomainAuth;
+    scopes?: string | readonly string[];
+    csrf?: boolean;
+    dataResources?: readonly DataResourceInput[];
+    repositories?: readonly RepositoryDefinitionInput[];
+}
+/**
+ * A domain is the reusable unit of application composition: model type, API policy,
+ * routes, and named views travel together. It has no admin assumption, so packages
+ * such as cookbook can publish public, signed-in, scoped, or administrator domains.
+ */
+export declare abstract class AppDomain<Model = unknown, Env = unknown, State = unknown> {
+    #private;
+    readonly name: string;
+    readonly active: boolean;
+    readonly basePath: string;
+    readonly dataResources: readonly DataResourceInput[];
+    readonly repositories: readonly RepositoryDefinitionInput[];
+    readonly Model: Model;
+    protected constructor(options: AppDomainOptions);
+    protected route(input: DomainRouteInput<Env, State>): void;
+    protected view<Props, Result>(name: string, renderer: DomainView<Props, Result>): void;
+    get routes(): readonly DomainRoute<Env, State>[];
+    getView(name: string): DomainView<never, unknown>;
+    /** Optional idempotent boot hook for manifests or other domain-owned setup. */
+    initialize(_env: Env, _context: {
+        ctx: ExecutionContext;
+    }): void | Promise<void>;
+}
+//# sourceMappingURL=app-domain.d.ts.map

package/dist/domain/app-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-domain.d.ts","sourceRoot":"","sources":["../../src/domain/app-domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,YAAY,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACrD;AAED;;;;GAIG;AACH,8BAAsB,SAAS,CAAC,KAAK,GAAG,OAAO,EAAE,GAAG,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,SAAiB,KAAK,EAAE,KAAK,CAAC;IAS9B,SAAS,aAAa,OAAO,EAAE,gBAAgB,EAiB9C;IAED,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAiBzD;IAED,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAGrF;IAED,IAAI,MAAM,IAAI,SAAS,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAE/C;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAIhD;IAED,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE;QAAE,GAAG,EAAE,gBAAgB,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAG;CACpF"}

package/dist/domain/app-domain.js

@@ -0,0 +1,79 @@
+/**
+ * A domain is the reusable unit of application composition: model type, API policy,
+ * routes, and named views travel together. It has no admin assumption, so packages
+ * such as cookbook can publish public, signed-in, scoped, or administrator domains.
+ */
+export class AppDomain {
+    name;
+    active;
+    basePath;
+    dataResources;
+    repositories;
+    #defaults;
+    #routes = [];
+    #views = new Map();
+    constructor(options) {
+        if (!/^[a-z][a-z0-9.-]*$/.test(options.name)) {
+            throw new TypeError("Domain names must be lowercase dot-separated identifiers.");
+        }
+        if (!options.basePath.startsWith("/")) {
+            throw new TypeError("Domain basePath must be absolute.");
+        }
+        this.name = options.name;
+        this.active = true;
+        this.basePath = options.basePath === "/" ? "/" : options.basePath.replace(/\/$/, "");
+        this.dataResources = [...(options.dataResources ?? [])];
+        this.repositories = [...(options.repositories ?? [])];
+        this.#defaults = {
+            auth: options.auth ?? "user",
+            scopes: asList(options.scopes),
+            csrf: options.csrf ?? false,
+        };
+    }
+    route(input) {
+        const suffix = input.path ?? "";
+        const method = typeof input.method === "string"
+            ? upper(input.method)
+            : input.method.map(upper);
+        const path = input.absolutePath ?? joinPath(this.basePath, suffix);
+        const { absolutePath: _absolutePath, ...route } = input;
+        this.#routes.push({
+            ...route,
+            method,
+            path,
+            auth: input.auth ?? this.#defaults.auth,
+            scopes: input.scopes === undefined ? this.#defaults.scopes : asList(input.scopes),
+            scopeMode: input.scopeMode ?? "all",
+            csrf: input.csrf ?? this.#defaults.csrf,
+            domain: this.name,
+        });
+    }
+    view(name, renderer) {
+        if (this.#views.has(name))
+            throw new TypeError(`Duplicate ${this.name} view: ${name}`);
+        this.#views.set(name, renderer);
+    }
+    get routes() {
+        return this.#routes;
+    }
+    getView(name) {
+        const view = this.#views.get(name);
+        if (!view)
+            throw new TypeError(`Unknown ${this.name} view: ${name}`);
+        return view;
+    }
+    /** Optional idempotent boot hook for manifests or other domain-owned setup. */
+    initialize(_env, _context) { }
+}
+function asList(value) {
+    return value === undefined ? [] : typeof value === "string" ? [value] : [...value];
+}
+function upper(value) {
+    return String(value).toUpperCase();
+}
+function joinPath(basePath, suffix) {
+    if (!suffix)
+        return basePath;
+    return `${basePath === "/" ? "" : basePath}${suffix.startsWith("/") ? suffix : `/${suffix}`}`;
+}
+//# sourceMappingURL=app-domain.js.map

package/dist/domain/app-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-domain.js","sourceRoot":"","sources":["../../src/domain/app-domain.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,OAAgB,SAAS;IACpB,IAAI,CAAS;IACb,MAAM,CAAU;IAChB,QAAQ,CAAS;IACjB,aAAa,CAA+B;IAC5C,YAAY,CAAuC;IAEnD,SAAS,CAIhB;IACO,OAAO,GAA8B,EAAE,CAAC;IACxC,MAAM,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEhE,YAAsB,OAAyB;QAC7C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG;YACf,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;YAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;SAC5B,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,KAAmC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAC7C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;YACrB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,GAAG,KAAK;YACR,MAAM;YACN,IAAI;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI;YACvC,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACjF,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI;YACvC,MAAM,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAES,IAAI,CAAgB,IAAY,EAAE,QAAmC;QAC7E,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,aAAa,IAAI,CAAC,IAAI,UAAU,IAAI,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,WAAW,IAAI,CAAC,IAAI,UAAU,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,UAAU,CAAC,IAAS,EAAE,QAAmC,IAAyB,CAAC;CACpF;AAED,SAAS,MAAM,CAAC,KAAkC;IAChD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACrC,CAAC;AACD,SAAS,QAAQ,CAAC,QAAgB,EAAE,MAAc;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,OAAO,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC;AAChG,CAAC"}

package/dist/domain/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./model.js";
+export * from "./app-domain.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,3 @@
+export * from "./model.js";
+export * from "./app-domain.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/domain/model.d.ts

@@ -0,0 +1,37 @@
+export type DomainAuth = "public" | "user" | "admin";
+export interface DomainRequestContext<Env = unknown, State = unknown> {
+    request: Request;
+    env: Env;
+    ctx: ExecutionContext;
+    state: State;
+    identity: {
+        isAuthenticated: boolean;
+        isAdmin: boolean;
+        who: string;
+    };
+    params: Readonly<Record<string, string>>;
+}
+export type DomainPolicy<Env = unknown, State = unknown> = (context: DomainRequestContext<Env, State>) => boolean | Response | Promise<boolean | Response>;
+export type DomainHandler<Env = unknown, State = unknown> = (context: DomainRequestContext<Env, State>) => Response | Promise<Response>;
+export interface DomainRoute<Env = unknown, State = unknown> {
+    method: string | readonly string[];
+    path: string;
+    auth: DomainAuth;
+    scopes: readonly string[];
+    scopeMode: "all" | "any";
+    csrf: boolean;
+    authorize?(context: DomainRequestContext<Env, State>): boolean | Response | Promise<boolean | Response>;
+    handler(context: DomainRequestContext<Env, State>): Response | Promise<Response>;
+    domain: string;
+}
+export interface DomainRouteInput<Env = unknown, State = unknown> extends Omit<DomainRoute<Env, State>, "path" | "domain" | "auth" | "scopes" | "scopeMode" | "csrf"> {
+    path?: string;
+    /** Use only for a deliberate alias outside the domain's normal base path. */
+    absolutePath?: string;
+    auth?: DomainAuth;
+    scopes?: string | readonly string[];
+    scopeMode?: "all" | "any";
+    csrf?: boolean;
+}
+export type DomainView<Props = unknown, Result = unknown> = (props: Props) => Result;
+//# sourceMappingURL=model.d.ts.map

package/dist/domain/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/domain/model.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,oBAAoB,CAAC,GAAG,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,YAAY,CAAC,GAAG,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAAI,CACzD,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,KACtC,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;AAEtD,MAAM,MAAM,aAAa,CAAC,GAAG,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAAI,CAC1D,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,KACtC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,WAAW,WAAW,CAAC,GAAG,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACzD,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,CAAC,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IACxG,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB,CAAC,GAAG,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,CAC9D,SAAQ,IAAI,CACV,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,EACvB,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAC7D;IACD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC"}

package/dist/domain/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/domain/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/domain/model.ts"],"names":[],"mappings":""}

package/dist/features/index.d.ts

@@ -0,0 +1,25 @@
+import { createLLMFeature } from "./llm/index.js";
+import { createMessagingFeature } from "./messaging/index.js";
+import type { LLMFeatureOptions } from "./llm/index.js";
+import type { MessagingFeatureOptions } from "./messaging/index.js";
+import type { RuntimeFeature } from "../runtime/model.js";
+declare const factories: Readonly<{
+    llm: typeof createLLMFeature;
+    messaging: typeof createMessagingFeature;
+}>;
+export type BuiltInFeatureName = keyof typeof factories;
+export interface BuiltInFeatureOptions {
+    llm: LLMFeatureOptions;
+    messaging: MessagingFeatureOptions;
+}
+export interface FeatureRequest<Name extends BuiltInFeatureName = BuiltInFeatureName> {
+    feature: Name;
+    options?: BuiltInFeatureOptions[Name];
+}
+export type FeatureRegistration = BuiltInFeatureName | FeatureRequest | RuntimeFeature;
+export declare const BUILT_IN_FEATURES: readonly ("llm" | "messaging")[];
+export declare function defineFeature<Name extends BuiltInFeatureName>(name: Name, options?: BuiltInFeatureOptions[Name]): Readonly<FeatureRequest<Name>>;
+export declare function resolveFeatures(requests?: readonly unknown[]): RuntimeFeature[];
+export { createLLMFeature, createMessagingFeature };
+export type { LLMFeatureOptions, MessagingFeatureOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/features/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,QAAA,MAAM,SAAS;;;EAGb,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,SAAS,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,iBAAiB,CAAC;IACvB,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,SAAS,kBAAkB,GAAG,kBAAkB;IAClF,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEvF,eAAO,MAAM,iBAAiB,kCAAgE,CAAC;AAE/F,wBAAgB,aAAa,CAAC,IAAI,SAAS,kBAAkB,EAC3D,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAahC;AAED,wBAAgB,eAAe,CAAC,QAAQ,GAAE,SAAS,OAAO,EAAO,GAAG,cAAc,EAAE,CAcnF;AA0BD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/features/index.js

@@ -0,0 +1,61 @@
+import { createLLMFeature } from "./llm/index.js";
+import { createMessagingFeature } from "./messaging/index.js";
+const factories = Object.freeze({
+    llm: createLLMFeature,
+    messaging: createMessagingFeature,
+});
+export const BUILT_IN_FEATURES = Object.freeze(Object.keys(factories));
+export function defineFeature(name, options) {
+    const normalizedName = String(name || "").trim();
+    if (!Object.hasOwn(factories, normalizedName)) {
+        throw new TypeError(`Unknown built-in feature: ${normalizedName || "(empty)"}`);
+    }
+    const resolvedOptions = options ?? {};
+    if (typeof resolvedOptions !== "object" || Array.isArray(resolvedOptions)) {
+        throw new TypeError(`Feature options for ${normalizedName} must be an object`);
+    }
+    return Object.freeze({
+        feature: normalizedName,
+        options: { ...resolvedOptions },
+    });
+}
+export function resolveFeatures(requests = []) {
+    if (!Array.isArray(requests))
+        throw new TypeError("features must be an array");
+    const resolved = [];
+    const names = new Set();
+    for (const request of requests) {
+        const feature = resolveFeature(request);
+        const name = String(feature?.name || "").trim();
+        if (!name)
+            throw new TypeError("Features require a name");
+        if (names.has(name))
+            throw new TypeError(`Duplicate feature: ${name}`);
+        names.add(name);
+        resolved.push(feature);
+    }
+    return resolved;
+}
+function resolveFeature(request) {
+    if (typeof request === "string")
+        return createBuiltInFeature(request);
+    if (!request || typeof request !== "object" || Array.isArray(request)) {
+        throw new TypeError("Feature requests must be names or feature objects");
+    }
+    if ("feature" in request && typeof request.feature === "string") {
+        const options = "options" in request && request.options && typeof request.options === "object"
+            ? request.options
+            : {};
+        return createBuiltInFeature(request.feature, options);
+    }
+    return request;
+}
+function createBuiltInFeature(name, options = {}) {
+    const normalizedName = String(name || "").trim();
+    const factory = factories[normalizedName];
+    if (!factory)
+        throw new TypeError(`Unknown built-in feature: ${normalizedName || "(empty)"}`);
+    return factory({ ...options, name: normalizedName });
+}
+export { createLLMFeature, createMessagingFeature };
+//# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"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"}

package/dist/features/llm/client.d.ts

@@ -0,0 +1,3 @@
+import type { LLMClient, LLMClientOptions, LLMEnvironment } from "./model.js";
+export declare function createLLM<Env extends LLMEnvironment = LLMEnvironment>(options?: LLMClientOptions<Env>): LLMClient<Env>;
+//# sourceMappingURL=client.d.ts.map

package/dist/features/llm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/features/llm/client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,SAAS,EACT,gBAAgB,EAChB,cAAc,EASf,MAAM,YAAY,CAAC;AA2BpB,wBAAgB,SAAS,CAAC,GAAG,SAAS,cAAc,GAAG,cAAc,EACnE,OAAO,GAAE,gBAAgB,CAAC,GAAG,CAAM,GAClC,SAAS,CAAC,GAAG,CAAC,CAkRhB"}