@agilesyndrome/cf-genai-base 5.0.2 → 6.0.0

package/dist/repository/model.d.ts

@@ -0,0 +1,61 @@
+import type { DataPage, DataResourceInput, DataRow, DataScope, DataScopeReader } from "../data/model.js";
+export interface RepositoryRelation {
+    repository: string;
+    localKey?: string;
+    foreignKey?: string;
+    many?: boolean;
+    where?: DataRow;
+    options?: Record<string, unknown>;
+}
+export interface RepositoryHookContext {
+    env: RepositoryEnvironment;
+    context: unknown;
+    repository: Repository;
+}
+export type RepositoryHook<Input = unknown, Output = Input> = (value: Input, context: RepositoryHookContext) => Output | Promise<Output>;
+export interface RepositoryHooks {
+    list?: RepositoryHook<DataRow[]>;
+    page?: RepositoryHook<DataPage>;
+    find?: RepositoryHook<DataRow | null>;
+    findOne?: RepositoryHook<DataRow | null>;
+    beforeInsert?: RepositoryHook<DataRow>;
+    afterInsert?: RepositoryHook<DataRow>;
+    beforeUpdate?: RepositoryHook<DataRow>;
+    afterUpdate?: RepositoryHook<DataRow | null>;
+}
+export interface RepositoryDefinitionInput {
+    name?: string;
+    resource?: string;
+    scope?: DataScope;
+    relations?: Record<string, RepositoryRelation>;
+    hooks?: RepositoryHooks;
+    resourceDefinition?: DataResourceInput | null;
+}
+export interface RepositoryDefinition {
+    name: string;
+    resource: string;
+    scope: DataScope;
+    relations: Record<string, RepositoryRelation>;
+    hooks: RepositoryHooks;
+    resourceDefinition: DataResourceInput | null;
+}
+export interface RepositoryEnvironment {
+    data?: Partial<Record<DataScope, DataScopeReader>>;
+    [key: string]: unknown;
+}
+export interface Repository {
+    name: string;
+    resource: string;
+    list(options?: Record<string, unknown>): Promise<DataRow[]>;
+    page(options?: Record<string, unknown>): Promise<DataPage>;
+    count(options?: Record<string, unknown>): Promise<number>;
+    find(id: unknown): Promise<DataRow | null>;
+    findOne(where: DataRow, options?: Record<string, unknown>): Promise<DataRow | null>;
+    insert(values: DataRow): Promise<DataRow>;
+    update(id: unknown, changes: DataRow): Promise<DataRow | null>;
+    updateWhere(where: DataRow, changes: DataRow): Promise<number>;
+    delete(id: unknown): Promise<D1Result<unknown>>;
+    deleteWhere(where: DataRow): Promise<D1Result<unknown>>;
+    link(relation: string, record: DataRow): Promise<unknown>;
+}
+//# sourceMappingURL=model.d.ts.map

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

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

package/dist/repository/model.js

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

package/dist/repository/model.js.map

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

package/dist/repository.d.ts

@@ -0,0 +1,11 @@
+import type { Repository, RepositoryDefinition, RepositoryDefinitionInput, RepositoryEnvironment } from "./repository/model.js";
+export type * from "./repository/model.js";
+export declare class RepositoryError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+export declare function defineRepository({ name, resource, scope, relations, hooks, resourceDefinition, }?: RepositoryDefinitionInput): RepositoryDefinition;
+export declare function createRepositories(env: RepositoryEnvironment, definitions?: readonly RepositoryDefinitionInput[], { context }?: {
+    context?: unknown;
+}): Record<string, Repository>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EAEtB,MAAM,uBAAuB,CAAC;AAE/B,mBAAmB,uBAAuB,CAAC;AAE3C,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,EAIxC;CACF;AAED,wBAAgB,gBAAgB,CAC9B,EACE,IAAI,EACJ,QAAQ,EACR,KAAgB,EAChB,SAAc,EACd,KAAU,EACV,kBAAyB,GAC1B,GAAE,yBAA8B,GAChC,oBAAoB,CAatB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,qBAAqB,EAC1B,WAAW,GAAE,SAAS,yBAAyB,EAAO,EACtD,EAAE,OAAO,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAwG5B"}

package/dist/repository.js

@@ -0,0 +1,118 @@
+import { auditLog } from "./core/events/index.js";
+export class RepositoryError extends Error {
+    status;
+    constructor(message, status = 500) {
+        super(message);
+        this.name = "RepositoryError";
+        this.status = status;
+    }
+}
+export function defineRepository({ name, resource, scope = "tenant", relations = {}, hooks = {}, resourceDefinition = null, } = {}) {
+    if (!/^[a-z][a-z0-9_-]*$/.test(String(name || ""))) {
+        throw new TypeError("Repositories require a safe name");
+    }
+    if (!resource)
+        throw new TypeError(`Repository ${name} requires a data resource`);
+    return {
+        name: String(name),
+        resource: String(resource),
+        scope,
+        relations: { ...relations },
+        hooks: { ...hooks },
+        resourceDefinition,
+    };
+}
+export function createRepositories(env, definitions = [], { context } = {}) {
+    const specs = new Map(definitions.map((definition) => {
+        const spec = defineRepository(definition);
+        return [spec.name, spec];
+    }));
+    const repositories = new Map();
+    const get = (name) => {
+        const result = repositories.get(String(name));
+        if (!result)
+            throw new RepositoryError(`Unknown repository: ${name}`, 500);
+        return result;
+    };
+    // Build every repository before exposing any of them so relations can point forward.
+    for (const spec of specs.values())
+        repositories.set(spec.name, createRepository(spec));
+    return Object.fromEntries(repositories);
+    function createRepository(spec) {
+        const reader = () => {
+            const data = env?.data;
+            const scopedReader = data?.[spec.scope];
+            if (!scopedReader) {
+                throw new RepositoryError(`Data scope ${spec.scope} is unavailable`, 500);
+            }
+            return scopedReader;
+        };
+        const invoke = async (hook, value) => {
+            return typeof hook === "function"
+                ? hook(value, { env, context, repository: api })
+                : value;
+        };
+        const api = {
+            name: spec.name,
+            resource: spec.resource,
+            async list(options) {
+                return invoke(spec.hooks.list, await reader().list(spec.resource, options));
+            },
+            async page(options) {
+                return invoke(spec.hooks.page, await reader().page(spec.resource, options));
+            },
+            async count(options) {
+                return reader().count(spec.resource, options);
+            },
+            async find(id) {
+                return invoke(spec.hooks.find, await reader().get(spec.resource, id));
+            },
+            async findOne(where, options = {}) {
+                const rows = await reader().list(spec.resource, { ...options, where, limit: 1 });
+                return invoke(spec.hooks.findOne, rows[0] || null);
+            },
+            async insert(values) {
+                const result = await reader().insert(spec.resource, await invoke(spec.hooks.beforeInsert, values));
+                auditLog({ who: "repository", operation: "create", resource: spec.name });
+                return invoke(spec.hooks.afterInsert, result);
+            },
+            async update(id, changes) {
+                const result = await reader().update(spec.resource, id, await invoke(spec.hooks.beforeUpdate, changes));
+                auditLog({ who: "repository", operation: "update", resource: spec.name });
+                return invoke(spec.hooks.afterUpdate, result);
+            },
+            async updateWhere(where, changes) {
+                return reader().updateWhere(spec.resource, where, await invoke(spec.hooks.beforeUpdate, changes));
+            },
+            async delete(id) {
+                const result = await reader().delete(spec.resource, id);
+                auditLog({ who: "repository", operation: "delete", resource: spec.name });
+                return result;
+            },
+            async deleteWhere(where) {
+                return reader().deleteWhere(spec.resource, where);
+            },
+            async link(relation, record) {
+                const relationSpec = spec.relations[relation];
+                if (!relationSpec) {
+                    throw new RepositoryError(`Unknown relation ${spec.name}.${relation}`, 500);
+                }
+                const target = get(relationSpec.repository);
+                const localKey = relationSpec.localKey || "id";
+                const foreignKey = relationSpec.foreignKey || `${spec.name}_id`;
+                const value = record?.[localKey];
+                if (value === undefined || value === null) {
+                    return relationSpec.many === false ? null : [];
+                }
+                return relationSpec.many === false
+                    ? target.findOne({ [foreignKey]: value })
+                    : target.list({
+                        where: { [foreignKey]: value, ...(relationSpec.where || {}) },
+                        ...(relationSpec.options || {}),
+                    });
+            },
+        };
+        return api;
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAYlD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,MAAM,GAAG,GAAG;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAC9B,EACE,IAAI,EACJ,QAAQ,EACR,KAAK,GAAG,QAAQ,EAChB,SAAS,GAAG,EAAE,EACd,KAAK,GAAG,EAAE,EACV,kBAAkB,GAAG,IAAI,GAC1B,GAA8B,EAAE;IAEjC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,cAAc,IAAI,2BAA2B,CAAC,CAAC;IAClF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC1B,KAAK;QACL,SAAS,EAAE,EAAE,GAAG,SAAS,EAAE;QAC3B,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE;QACnB,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAA0B,EAC1B,WAAW,GAAyC,EAAE,EACtD,EAAE,OAAO,EAAE,GAA0B,EAAE;IAEvC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CACH,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEnD,MAAM,GAAG,GAAG,CAAC,IAAY,EAAc,EAAE;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,eAAe,CAAC,uBAAuB,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,qFAAqF;IACrF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAExC,SAAS,gBAAgB,CAAC,IAA0B;QAClD,MAAM,MAAM,GAAG,GAAoB,EAAE;YACnC,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC;YACvB,MAAM,YAAY,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,eAAe,CAAC,cAAc,IAAI,CAAC,KAAK,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAC5E,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,KAAK,EAClB,IAA+C,EAC/C,KAAY,EACa,EAAE;YAC3B,OAAO,OAAO,IAAI,KAAK,UAAU;gBAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;gBAChD,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC,CAAC;QAEF,MAAM,GAAG,GAAe;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO;gBAChB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAC9E,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,OAAO;gBAChB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAC9E,CAAC;YACD,KAAK,CAAC,KAAK,CAAC,OAAO;gBACjB,OAAO,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE;gBACX,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE;gBAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,MAAM;gBACjB,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;gBACnG,QAAQ,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO;gBACtB,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;gBACxG,QAAQ,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;YACD,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO;gBAC9B,OAAO,MAAM,EAAE,CAAC,WAAW,CACzB,IAAI,CAAC,QAAQ,EACb,KAAK,EACL,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAC/C,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,EAAE;gBACb,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACxD,QAAQ,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1E,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,KAAK,CAAC,WAAW,CAAC,KAAK;gBACrB,OAAO,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM;gBACzB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,MAAM,IAAI,eAAe,CAAC,oBAAoB,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC9E,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,IAAI,IAAI,CAAC;gBAC/C,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;gBAChE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;gBACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,OAAO,YAAY,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,CAAC;gBACD,OAAO,YAAY,CAAC,IAAI,KAAK,KAAK;oBAChC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;oBACzC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;wBACZ,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;wBAC7D,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;qBAChC,CAAC,CAAC;YACP,CAAC;SACF,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/runtime/domains.d.ts

@@ -0,0 +1,14 @@
+import { AppDomain } from "../domain/index.js";
+import type { HealthProvider, RuntimeBindings, RuntimeState } from "./model.js";
+/** Public operational health belongs to a domain even though it has no D1 model. */
+export declare class RuntimeHealthDomain extends AppDomain<unknown, RuntimeBindings, RuntimeState> {
+    constructor(health?: HealthProvider);
+}
+/** Exposes the current user's available tenant context; it is not an admin API. */
+export declare class TenantContextDomain extends AppDomain<unknown, RuntimeBindings, RuntimeState> {
+    constructor();
+}
+export declare function createRuntimeDomains(options?: {
+    health?: HealthProvider;
+}): readonly [RuntimeHealthDomain, TenantContextDomain];
+//# sourceMappingURL=domains.d.ts.map

package/dist/runtime/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/runtime/domains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA6B,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIhF,oFAAoF;AACpF,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,CAAC;IACxF,YAAY,MAAM,CAAC,EAAE,cAAc,EAKlC;CACF;AAUD,mFAAmF;AACnF,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,CAAC;IACxF,cAGC;CACF;AAcD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAO,uDAE7E"}

package/dist/runtime/domains.js

@@ -0,0 +1,42 @@
+import { AppDomain } from "../domain/index.js";
+import { listFeatureHealth } from "../core/healthchecks/index.js";
+import { healthResponse } from "./health.js";
+/** Public operational health belongs to a domain even though it has no D1 model. */
+export class RuntimeHealthDomain extends AppDomain {
+    constructor(health) {
+        super({ name: "runtime.health", basePath: "/health", auth: "public" });
+        const handler = (context) => respondWithHealth(context, health);
+        this.route({ method: "GET", handler });
+        this.route({ method: "GET", absolutePath: "/api/health", handler });
+    }
+}
+async function respondWithHealth(context, health) {
+    const details = health ? await health(context.env, context) : {};
+    const features = context.env?.DB
+        ? await listFeatureHealth(context.env, { who: "system:read" }).catch(() => [])
+        : [];
+    return healthResponse(context.env, features.length ? { ...details, features } : details);
+}
+/** Exposes the current user's available tenant context; it is not an admin API. */
+export class TenantContextDomain extends AppDomain {
+    constructor() {
+        super({ name: "auth.tenant-context", basePath: "/api/tenant", auth: "user" });
+        this.route({ method: "GET", handler: tenantContext });
+    }
+}
+async function tenantContext({ state }) {
+    if (!state.data)
+        return Response.json({ error: "Data context is unavailable." }, { status: 500 });
+    const context = await state.data.context();
+    if (context.invalidTenant) {
+        return Response.json({ error: "The requested tenant is not available." }, { status: 400 });
+    }
+    const tenant = context.tenantId
+        ? { id: context.tenantId, name: context.tenants?.find((candidate) => candidate.id === context.tenantId)?.name ?? null }
+        : null;
+    return Response.json({ tenant, tenants: context.tenants ?? [] });
+}
+export function createRuntimeDomains(options = {}) {
+    return [new RuntimeHealthDomain(options.health), new TenantContextDomain()];
+}
+//# sourceMappingURL=domains.js.map

package/dist/runtime/domains.js.map

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

package/dist/runtime/features.d.ts

@@ -0,0 +1,10 @@
+import type { FeatureManifest } from "../core/healthchecks/model.js";
+import type { FeatureManifestOptions, RuntimeBindings } from "./model.js";
+/**
+ * Registration is idempotent per D1 binding and feature set. The cache only avoids
+ * duplicate work inside a warm isolate; D1 remains the durable source of truth.
+ */
+export declare function ensureFeatureManifests(env: RuntimeBindings, features?: readonly FeatureManifest[], { who }?: FeatureManifestOptions): Promise<void>;
+/** Run live health measurements without reusing the warm-isolate registration promise. */
+export declare function refreshFeatureManifests(env: RuntimeBindings, features?: readonly FeatureManifest[], { who }?: FeatureManifestOptions): Promise<void>;
+//# sourceMappingURL=features.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/runtime/features.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAO1E;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,eAAe,EACpB,QAAQ,GAAE,SAAS,eAAe,EAAO,EACzC,EAAE,GAAqB,EAAE,GAAE,sBAA2B,GACrD,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,0FAA0F;AAC1F,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,QAAQ,GAAE,SAAS,eAAe,EAAO,EACzC,EAAE,GAAqB,EAAE,GAAE,sBAA2B,GACrD,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/runtime/features.js

@@ -0,0 +1,37 @@
+import { evaluateCircuitBreaker, listCircuitBreakers } from "../core/circuits/index.js";
+import { registerFeatureManifests } from "../core/healthchecks/index.js";
+const featureRegistrationPromises = new WeakMap();
+/**
+ * Registration is idempotent per D1 binding and feature set. The cache only avoids
+ * duplicate work inside a warm isolate; D1 remains the durable source of truth.
+ */
+export function ensureFeatureManifests(env, features = [], { who = "system:update" } = {}) {
+    if (!env || typeof env !== "object" || !env.DB)
+        return Promise.resolve();
+    const key = features.map((feature) => String(feature?.name || "feature")).join("|");
+    let registrations = featureRegistrationPromises.get(env.DB);
+    if (!registrations) {
+        registrations = new Map();
+        featureRegistrationPromises.set(env.DB, registrations);
+    }
+    let promise = registrations.get(key);
+    if (!promise) {
+        promise = (async () => {
+            await registerFeatureManifests(env, features, { who });
+            const breakers = await listCircuitBreakers(env, { who });
+            await Promise.all(breakers.map((breaker) => evaluateCircuitBreaker(env, breaker.id, { who })));
+        })();
+        registrations.set(key, promise);
+        promise.catch(() => registrations?.delete(key));
+    }
+    return promise;
+}
+/** Run live health measurements without reusing the warm-isolate registration promise. */
+export async function refreshFeatureManifests(env, features = [], { who = "system:update" } = {}) {
+    if (!env?.DB)
+        return;
+    await registerFeatureManifests(env, features, { who });
+    const breakers = await listCircuitBreakers(env, { who });
+    await Promise.all(breakers.map((breaker) => evaluateCircuitBreaker(env, breaker.id, { who })));
+}
+//# sourceMappingURL=features.js.map

package/dist/runtime/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../src/runtime/features.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,MAAM,2BAA2B,GAAG,IAAI,OAAO,EAG5C,CAAC;AAEJ;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAoB,EACpB,QAAQ,GAA+B,EAAE,EACzC,EAAE,GAAG,GAAG,eAAe,EAAE,GAA2B,EAAE;IAEtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACzE,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpF,IAAI,aAAa,GAAG,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACvD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACzD,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAC5E,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;QACL,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAoB,EACpB,QAAQ,GAA+B,EAAE,EACzC,EAAE,GAAG,GAAG,eAAe,EAAE,GAA2B,EAAE;IAEtD,IAAI,CAAC,GAAG,EAAE,EAAE;QAAE,OAAO;IACrB,MAAM,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC"}

package/dist/runtime/health.d.ts

@@ -0,0 +1,6 @@
+import type { BootSpec, BootValidation, HealthDetails, RuntimeBindings } from "./model.js";
+export declare function validateBoot(env: RuntimeBindings, { bindings, required }?: BootSpec): BootValidation;
+export declare function assertBoot(env: RuntimeBindings, spec?: BootSpec): BootValidation;
+export declare function methodNotAllowed(allow?: string): Response;
+export declare function healthResponse(env: RuntimeBindings, details?: HealthDetails): Response;
+//# sourceMappingURL=health.d.ts.map

package/dist/runtime/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/runtime/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3F,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,QAAa,EAAE,QAAa,EAAE,GAAE,QAAa,GAAG,cAAc,CAUlH;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,GAAE,QAAa,GAAG,cAAc,CAQpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAQ,GAAG,QAAQ,CAExD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,GAAE,aAAkB,GAAG,QAAQ,CAO1F"}

package/dist/runtime/health.js

@@ -0,0 +1,28 @@
+export function validateBoot(env, { bindings = [], required = [] } = {}) {
+    const missingBindings = bindings.filter((name) => !env?.[name]);
+    const missingValues = required.filter((name) => !env?.[name] || String(env[name]).startsWith("replace-with-"));
+    return {
+        ok: missingBindings.length === 0 && missingValues.length === 0,
+        missingBindings,
+        missingValues,
+    };
+}
+export function assertBoot(env, spec = {}) {
+    const result = validateBoot(env, spec);
+    if (!result.ok) {
+        throw new Error(`Worker boot validation failed: ${[...result.missingBindings, ...result.missingValues].join(", ")}`);
+    }
+    return result;
+}
+export function methodNotAllowed(allow = "GET") {
+    return new Response("Method Not Allowed", { status: 405, headers: { Allow: allow } });
+}
+export function healthResponse(env, details = {}) {
+    return Response.json({
+        ok: true,
+        version: String(env.BUILD_SHA || "unknown").slice(0, 7),
+        build_number: env.BUILD_NUMBER ? String(env.BUILD_NUMBER) : null,
+        ...details,
+    }, { headers: { "Cache-Control": "no-store" } });
+}
+//# sourceMappingURL=health.js.map

package/dist/runtime/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/runtime/health.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,GAAoB,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAa,EAAE;IAChG,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7C,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,CAC9D,CAAC;IACF,OAAO;QACL,EAAE,EAAE,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAC9D,eAAe;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAoB,EAAE,IAAI,GAAa,EAAE;IAClE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,kCAAkC,CAAC,GAAG,MAAM,CAAC,eAAe,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAK,GAAG,KAAK;IAC5C,OAAO,IAAI,QAAQ,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAoB,EAAE,OAAO,GAAkB,EAAE;IAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC;QACnB,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;QAChE,GAAG,OAAO;KACX,EAAE,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/runtime/hono.d.ts

@@ -0,0 +1,30 @@
+import { Hono } from "hono";
+export type RuntimeExecutionContext = ExecutionContext;
+/**
+ * The public worker middleware contract predates Hono. This adapter lets existing
+ * features keep that contract while Hono owns ordering, dispatch, and fallthrough.
+ * New runtime middleware should prefer Hono's `(c, next)` shape directly.
+ */
+export type WorkerLayer<Env extends object = Record<string, unknown>, State = object> = (request: Request, env: Env, ctx: RuntimeExecutionContext, next: (request?: Request) => Promise<Response>, state: State) => Response | Promise<Response>;
+export interface HonoRuntimeOptions<Env extends object, State> {
+    layers?: readonly WorkerLayer<Env, State>[];
+    terminal: (request: Request, env: Env, ctx: RuntimeExecutionContext, state: State) => Response | Promise<Response>;
+}
+declare const STATE_KEY = "__cfgenai_runtime_state";
+declare const CONTEXT_KEY = "__cfgenai_execution_context";
+type RuntimeBindings<Env extends object, State> = Env & {
+    [STATE_KEY]?: State;
+    [CONTEXT_KEY]?: ExecutionContext;
+};
+/**
+ * Build one Hono application per Worker instance. State is attached to a short-lived
+ * environment facade for each request, never to the Hono app or module globals.
+ */
+export declare function createHonoRuntime<Env extends object, State>(options: HonoRuntimeOptions<Env, State>): {
+    app: Hono<{
+        Bindings: RuntimeBindings<Env, State>;
+    }, import("hono/types").BlankSchema, "/">;
+    fetch(request: Request, env: Env, ctx: ExecutionContext, state: State): Promise<Response> | Response;
+};
+export {};
+//# sourceMappingURL=hono.d.ts.map

package/dist/runtime/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/runtime/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,IAAI,CACtF,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAC9C,KAAK,EAAE,KAAK,KACT,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK;IAC3D,MAAM,CAAC,EAAE,SAAS,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;IAC5C,QAAQ,EAAE,CACR,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE,KAAK,KACT,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnC;AAED,QAAA,MAAM,SAAS,4BAA4B,CAAC;AAC5C,QAAA,MAAM,WAAW,gCAAgC,CAAC;AAElD,KAAK,eAAe,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,IAAI,GAAG,GAAG;IACtD,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC;IACpB,CAAC,WAAW,CAAC,CAAC,EAAE,gBAAgB,CAAC;CAClC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,EACzD,OAAO,EAAE,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC;;kBAEN,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC;;mBA2C3C,OAAO,OAAO,GAAG,OAAO,gBAAgB,SAAS,KAAK;EASxE"}

package/dist/runtime/hono.js

@@ -0,0 +1,50 @@
+import { Hono } from "hono";
+const STATE_KEY = "__cfgenai_runtime_state";
+const CONTEXT_KEY = "__cfgenai_execution_context";
+/**
+ * Build one Hono application per Worker instance. State is attached to a short-lived
+ * environment facade for each request, never to the Hono app or module globals.
+ */
+export function createHonoRuntime(options) {
+    const app = new Hono();
+    // Leave classification to createWorker's single error boundary.
+    app.onError((error) => { throw error; });
+    for (const layer of options.layers ?? []) {
+        const middleware = async (c, next) => {
+            const state = c.env[STATE_KEY];
+            const executionContext = c.env[CONTEXT_KEY];
+            if (!state || !executionContext)
+                return c.text("Runtime request state is missing.", 500);
+            let downstreamCalled = false;
+            const nextRequest = async (_request = c.req.raw) => {
+                downstreamCalled = true;
+                await next();
+                return c.res;
+            };
+            const response = await layer(c.req.raw, c.env, executionContext, nextRequest, state);
+            // Hono stores the downstream response on c.res. Returning it here preserves the
+            // old middleware contract while allowing Hono to continue its normal unwind.
+            return response instanceof Response ? response : downstreamCalled ? c.res : c.res;
+        };
+        app.use("*", middleware);
+    }
+    app.all("*", (c) => {
+        const state = c.env[STATE_KEY];
+        const executionContext = c.env[CONTEXT_KEY];
+        if (!state || !executionContext)
+            return c.text("Runtime request state is missing.", 500);
+        return options.terminal(c.req.raw, c.env, executionContext, state);
+    });
+    return {
+        app,
+        fetch(request, env, ctx, state) {
+            const requestEnv = {
+                ...env,
+                [STATE_KEY]: state,
+                [CONTEXT_KEY]: ctx,
+            };
+            return app.fetch(request, requestEnv, ctx);
+        },
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/runtime/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/runtime/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA4B5B,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,MAAM,WAAW,GAAG,6BAA6B,CAAC;AAOlD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAA6C,CAAC;IAClE,gEAAgE;IAChE,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,UAAU,GAAiE,KAAK,EACpF,CAAC,EACD,IAAI,EACJ,EAAE;YACF,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,CAAC,KAAK,IAAI,CAAC,gBAAgB;gBAAE,OAAO,CAAC,CAAC,IAAI,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;YAEzF,IAAI,gBAAgB,GAAG,KAAK,CAAC;YAC7B,MAAM,WAAW,GAAG,KAAK,EAAE,QAAQ,GAAY,CAAC,CAAC,GAAG,CAAC,GAAG,EAAqB,EAAE;gBAC7E,gBAAgB,GAAG,IAAI,CAAC;gBACxB,MAAM,IAAI,EAAE,CAAC;gBACb,OAAO,CAAC,CAAC,GAAG,CAAC;YACf,CAAC,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,CAAC,CAAC,GAAG,CAAC,GAAG,EACT,CAAC,CAAC,GAAG,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,CACN,CAAC;YAEF,gFAAgF;YAChF,6EAA6E;YAC7E,OAAO,QAAQ,YAAY,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACpF,CAAC,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,CAAC,gBAAgB;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QACzF,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG;QACH,KAAK,CAAC,OAAgB,EAAE,GAAQ,EAAE,GAAqB,EAAE,KAAY;YACnE,MAAM,UAAU,GAAgC;gBAC9C,GAAG,GAAG;gBACN,CAAC,SAAS,CAAC,EAAE,KAAK;gBAClB,CAAC,WAAW,CAAC,EAAE,GAAG;aACnB,CAAC;YACF,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/model.d.ts

@@ -0,0 +1,133 @@
+import type { AdminBindings, AdminIdentity, AdminRequestState } from "../admin/types.js";
+import type { AnyAppDomain, AppDefinition, AppDefinitionInput } from "../app.js";
+import type { AppEvent, EventHandler } from "../core/events/index.js";
+import type { DataActorContext, DataReader, DataResourceInput } from "../data/model.js";
+import type { Repository, RepositoryDefinitionInput } from "../repository/model.js";
+import type { CircuitBreakerInput } from "../core/circuits/model.js";
+import type { HealthcheckInput } from "../core/healthchecks/model.js";
+import type { WorkerLayer } from "./hono.js";
+export interface RuntimeFeature<Env extends RuntimeBindings = RuntimeBindings, State extends RuntimeState = RuntimeState> {
+    name: string;
+    id?: string;
+    displayName?: string;
+    packageName?: string;
+    version?: string;
+    domains?: readonly AnyAppDomain[];
+    healthcheck?: (env: Env, options?: FeatureManifestOptions) => HealthcheckInput | readonly HealthcheckInput[] | Promise<HealthcheckInput | readonly HealthcheckInput[]>;
+    healthchecks?: readonly HealthcheckInput[];
+    circuitBreakers?: readonly CircuitBreakerInput[];
+    middleware?: WorkerLayer<RuntimeRequestEnvironment<Env>, State>;
+    getUser?: (request: Request, env: Env) => AdminIdentity | null | Promise<AdminIdentity | null>;
+    eventHandler?: EventHandler<Env, ExecutionContext>;
+    event_handler?: EventHandler<Env, ExecutionContext>;
+    /** Environment values required when this feature handles a request. */
+    requiredEnvironment?: (context: {
+        request: Request;
+        url: URL;
+    }) => readonly string[];
+    [key: string]: unknown;
+}
+/** Shared options implemented by first-party and external App SDK features. */
+export interface RuntimeFeatureOptions<Env extends RuntimeBindings = RuntimeBindings, State extends RuntimeState = RuntimeState> {
+    name?: string;
+    displayName?: string;
+    domains?: readonly AnyAppDomain[];
+    healthcheck?: RuntimeFeature<Env, State>["healthcheck"];
+    healthchecks?: readonly HealthcheckInput[];
+    circuitBreakers?: readonly CircuitBreakerInput[];
+    boot?: (env: RuntimeRequestEnvironment<Env>, context: {
+        request: Request;
+        ctx: RuntimeExecutionContext;
+        state: State;
+    }) => void | Promise<void>;
+    middleware?: WorkerLayer<RuntimeRequestEnvironment<Env>, State>;
+}
+type RuntimeExecutionContext = Parameters<WorkerLayer>[2];
+export interface RuntimeBindings extends AdminBindings {
+    BUILD_SHA?: string;
+    BUILD_NUMBER?: string | number;
+    EVENT_HUB?: DurableObjectNamespace;
+    [key: string]: unknown;
+}
+export interface RuntimeState extends AdminRequestState {
+    requestId: string;
+    user?: AdminIdentity | null;
+    data?: DataReader;
+    context?: RuntimeRequestContext;
+    tenantId?: string;
+}
+export type RuntimeEventEmitter = (what: string, where?: string, details?: Record<string, unknown>, when?: Date) => Promise<AppEvent | null>;
+export interface RuntimeRequestContext {
+    request: Request;
+    env: RuntimeRequestEnvironment;
+    ctx: ExecutionContext;
+    state: RuntimeState;
+    data?: DataReader;
+    userId: string | null;
+    who: string;
+    isAuthenticated: boolean;
+    isAdmin: boolean;
+    event: RuntimeEventEmitter;
+}
+export type RuntimeRequestEnvironment<Env extends RuntimeBindings = RuntimeBindings> = Env & {
+    app?: Readonly<AppDefinition>;
+    features?: RuntimeFeature[];
+    data?: DataReader;
+    repositories?: Record<string, Repository>;
+    user?: AdminIdentity | null;
+    authUser?: AdminIdentity["authUser"];
+    userId?: string | null;
+    requestId?: string;
+    context?: RuntimeRequestContext;
+    eventHubBinding?: string;
+    eventHandler?: (event: AppEvent, env: RuntimeRequestEnvironment, ctx: ExecutionContext) => Promise<AppEvent | null>;
+    event?: RuntimeEventEmitter;
+};
+export type RuntimeMiddleware<Env extends RuntimeBindings, State extends RuntimeState> = WorkerLayer<RuntimeRequestEnvironment<Env>, State>;
+export interface CreateWorkerOptions<Env extends RuntimeBindings = RuntimeBindings, State extends RuntimeState = RuntimeState> {
+    fetch: (request: Request, env: RuntimeRequestEnvironment<Env>, ctx: ExecutionContext, state: State) => Response | Promise<Response>;
+    scheduled?: (controller: ScheduledController, env: Env, ctx: ExecutionContext) => void | Promise<void>;
+    app?: AppDefinitionInput;
+    authorize?: (context: {
+        request: Request;
+        url: URL;
+        user: AdminIdentity;
+        env: RuntimeRequestEnvironment<Env>;
+        ctx: ExecutionContext;
+        state: State;
+    }) => boolean | Promise<boolean>;
+    middleware?: readonly RuntimeMiddleware<Env, State>[];
+    publicTenantId?: string | null;
+    health?: HealthProvider;
+    boot?: (env: Env, context: {
+        request: Request;
+        ctx: ExecutionContext;
+    }) => unknown;
+    /** Bindings required before any request-specific work begins. */
+    requiredBindings?: readonly string[];
+    security?: boolean;
+    eventHubBinding?: string;
+}
+export type HealthDetails = Record<string, unknown>;
+export type HealthProvider = (env: RuntimeBindings, context: {
+    request: Request;
+    ctx: ExecutionContext;
+    state: RuntimeState;
+}) => HealthDetails | Promise<HealthDetails>;
+export interface FeatureManifestOptions {
+    who?: string;
+}
+export interface BootSpec {
+    bindings?: readonly string[];
+    required?: readonly string[];
+}
+export interface BootValidation {
+    ok: boolean;
+    missingBindings: string[];
+    missingValues: string[];
+}
+export type DomainResourceDefinition = DataResourceInput;
+export type DomainRepositoryDefinition = RepositoryDefinitionInput;
+export type ResolvedDataContext = DataActorContext;
+export {};
+//# sourceMappingURL=model.d.ts.map