@justscale/core 0.1.0

package/dist/kernel/kernel.js

@@ -0,0 +1,134 @@
+import { Lifecycle } from '../core/lifecycle.js';
+import { AbstractLockProvider } from '../features/lock/lock-service.js';
+import { AbstractChannelBackend } from '../features/channel/backend.js';
+import { runContainerReadyHooks } from '../core/container-hooks.js';
+export function createKernel(opts) {
+    const { app, signals = true, logger = console } = opts;
+    let running = false;
+    let stopping = null;
+    let signalCleanup = null;
+    const startedAdapters = [];
+    async function stop() {
+        if (stopping)
+            return stopping;
+        if (!running && startedAdapters.length === 0)
+            return;
+        stopping = (async () => {
+            signalCleanup?.();
+            signalCleanup = null;
+            // Order matters: close abstract services FIRST while their underlying
+            // adapter (e.g. postgres pool) is still alive, then stop adapters last.
+            // The previous order (adapters first) caused TableLockProvider.release()
+            // to fire pg_notify against an already-closed pool, surfacing as
+            // CONNECTION_CLOSED unhandled rejections during teardown.
+            let lifecycle = null;
+            try {
+                lifecycle = (await app.container.resolve(Lifecycle));
+            }
+            catch {
+                // Lifecycle not registered - skip stop hooks
+            }
+            if (lifecycle) {
+                try {
+                    await lifecycle.runHook('stop');
+                }
+                catch (err) {
+                    logger.error?.("Kernel: lifecycle 'stop' hook failed:", err);
+                }
+            }
+            let lockProvider = null;
+            try {
+                lockProvider = await app.container.resolve(AbstractLockProvider);
+            }
+            catch {
+                // Lock provider not registered - nothing to close
+            }
+            if (lockProvider && typeof lockProvider.close === 'function') {
+                try {
+                    await lockProvider.close();
+                }
+                catch (err) {
+                    logger.error?.('Kernel: lock provider close failed:', err);
+                }
+            }
+            let channelBackend = null;
+            try {
+                channelBackend = await app.container.resolve(AbstractChannelBackend);
+            }
+            catch {
+                // Channel backend not registered - nothing to close
+            }
+            if (channelBackend && typeof channelBackend.close === 'function') {
+                try {
+                    await channelBackend.close();
+                }
+                catch (err) {
+                    logger.error?.('Kernel: channel backend close failed:', err);
+                }
+            }
+            for (let i = startedAdapters.length - 1; i >= 0; i--) {
+                const adapter = startedAdapters[i];
+                if (!adapter.stop)
+                    continue;
+                try {
+                    await adapter.stop();
+                }
+                catch (err) {
+                    logger.error?.(`Kernel: adapter '${adapter.name}' stop failed:`, err);
+                }
+            }
+            startedAdapters.length = 0;
+            running = false;
+        })();
+        return stopping;
+    }
+    async function start() {
+        if (running)
+            throw new Error('Kernel already running');
+        await app.ready;
+        const byName = new Map();
+        for (const a of app.adapters) {
+            const prev = byName.get(a.name);
+            if (prev && prev !== a) {
+                logger.warn?.(`Kernel: two adapters registered under '${a.name}' with different refs; using first.`);
+                continue;
+            }
+            if (!prev)
+                byName.set(a.name, a);
+        }
+        for (const adapter of byName.values()) {
+            const resolved = await Promise.all(adapter.requires.map((token) => app.container.resolve(token)));
+            await adapter.start(app, ...resolved);
+            startedAdapters.push(adapter);
+        }
+        running = true;
+        try {
+            await runContainerReadyHooks(app.container);
+        }
+        catch (err) {
+            logger.warn?.('Kernel: a container-ready hook threw:', err);
+        }
+        if (signals) {
+            const handler = () => {
+                void stop().finally(() => process.exit(0));
+            };
+            process.once('SIGINT', handler);
+            process.once('SIGTERM', handler);
+            signalCleanup = () => {
+                process.off('SIGINT', handler);
+                process.off('SIGTERM', handler);
+            };
+        }
+    }
+    return {
+        start,
+        stop,
+        get running() {
+            return running;
+        },
+        get startedAdapters() {
+            return startedAdapters;
+        },
+    };
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../../src/kernel/kernel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAepE,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IACvD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAAQ,GAAyB,IAAI,CAAC;IAC1C,IAAI,aAAa,GAAwB,IAAI,CAAC;IAC9C,MAAM,eAAe,GAAc,EAAE,CAAC;IAEtC,KAAK,UAAU,IAAI;QACjB,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErD,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;YACrB,aAAa,EAAE,EAAE,CAAC;YAClB,aAAa,GAAG,IAAI,CAAC;YAErB,sEAAsE;YACtE,wEAAwE;YACxE,yEAAyE;YACzE,iEAAiE;YACjE,0DAA0D;YAE1D,IAAI,SAAS,GAAyB,IAAI,CAAC;YAC3C,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAkB,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;YACD,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,EAAE,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YAED,IAAI,YAAY,GAA2C,IAAI,CAAC;YAChE,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;YACpD,CAAC;YACD,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC7D,IAAI,CAAC;oBACH,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC7B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,EAAE,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;YAED,IAAI,cAAc,GAA2C,IAAI,CAAC;YAClE,IAAI,CAAC;gBACH,cAAc,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;YACD,IAAI,cAAc,IAAI,OAAO,cAAc,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACjE,IAAI,CAAC;oBACH,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;gBAC/B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,EAAE,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrD,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,IAAI;oBAAE,SAAS;gBAC5B,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACvB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,EAAE,CAAC,oBAAoB,OAAO,CAAC,IAAI,gBAAgB,EAAE,GAAG,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;YACD,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;YAE3B,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,UAAU,KAAK;QAClB,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACvD,MAAM,GAAG,CAAC,KAAK,CAAC;QAEhB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,EAAE,CAAC,0CAA0C,CAAC,CAAC,IAAI,qCAAqC,CAAC,CAAC;gBACrG,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAA8B,CAAC,CACtD,CACF,CAAC;YACF,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;YACtC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,EAAE,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjC,aAAa,GAAG,GAAG,EAAE;gBACnB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,IAAI;QACJ,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,eAAe;YACjB,OAAO,eAAe,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/models/access.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Field-Level Access Evaluation
+ *
+ * Evaluates access rules against resolved principals to determine
+ * which fields should be visible during serialization.
+ */
+import type { AccessPrincipal } from '../core/context.js';
+import { ACCESS_RULES } from './symbols.js';
+/** Model class with optional access rules */
+export interface ModelClassLike {
+    readonly [ACCESS_RULES]?: Record<string, unknown>;
+}
+/**
+ * Get the access rules from a model class (if any).
+ */
+export declare function getAccessRules(modelClass: ModelClassLike): Record<string, unknown> | undefined;
+/**
+ * Filter an entity's enumerable properties based on access rules and principals.
+ * Returns a plain object with only the visible fields.
+ *
+ * - No access rules on model → returns all fields (backwards compatible)
+ * - Field not in access rules → included (default: visible)
+ * - Field in access rules → evaluated against principals
+ */
+export declare function filterByAccess(entity: Record<string, unknown>, modelClass: ModelClassLike, principals: readonly AccessPrincipal[]): Record<string, unknown>;
+//# sourceMappingURL=access.d.ts.map

package/dist/models/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/models/access.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAkI5C,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE9F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/models/access.js

@@ -0,0 +1,126 @@
+/**
+ * Field-Level Access Evaluation
+ *
+ * Evaluates access rules against resolved principals to determine
+ * which fields should be visible during serialization.
+ */
+import { ACCESS_RULES } from './symbols.js';
+import { isReference } from './reference/reference.js';
+/** Symbol used by permission defs - Symbol.for to match across packages */
+const PERMISSION_DEF = Symbol.for('@justscale/permission:permissionDef');
+function isPermissionDefLike(value) {
+    return typeof value === 'object' && value !== null && PERMISSION_DEF in value;
+}
+function hasIdentifier(value) {
+    return typeof value === 'object' && value !== null && 'identifier' in value;
+}
+function isRefTraversalLike(value) {
+    return 'path' in value && Array.isArray(value.path);
+}
+function isFieldExprLike(value) {
+    return 'eq' in value && typeof value.eq === 'function';
+}
+/**
+ * Check if a single permission def matches any of the given principals
+ * for a specific entity instance.
+ */
+function matchesPrincipal(def, entity, principals) {
+    const principal = principals.find((p) => p.type === def.subjectClass || p.type.prototype instanceof def.subjectClass);
+    if (!principal)
+        return false;
+    if (def.mode === 'always')
+        return true;
+    if (def.mode === 'when' && def.fieldAccessor) {
+        const accessor = typeof def.fieldAccessor === 'function' ? def.fieldAccessor() : def.fieldAccessor;
+        if (!accessor || typeof accessor !== 'object')
+            return false;
+        // RefTraversal: walk the path on the entity
+        if (isRefTraversalLike(accessor)) {
+            let current = entity;
+            for (let i = 0; i < accessor.path.length; i++) {
+                current = current?.[accessor.path[i]];
+                if (current && isReference(current)) {
+                    if (i === accessor.path.length - 1) {
+                        return current.identifier === principal.ref.identifier;
+                    }
+                    return false; // can't traverse further without awaiting
+                }
+            }
+            return hasIdentifier(current) && current.identifier === principal.ref.identifier;
+        }
+        // FieldExpr: get field name via .eq()
+        if (isFieldExprLike(accessor)) {
+            const condition = accessor.eq(principal.ref);
+            const fieldValue = entity[condition.field];
+            if (isReference(fieldValue)) {
+                return fieldValue.identifier === principal.ref.identifier;
+            }
+            return hasIdentifier(fieldValue) && fieldValue.identifier === principal.ref.identifier;
+        }
+    }
+    return false;
+}
+/**
+ * Normalize a see/set rule to extract the relevant portion.
+ * Returns undefined if the rule has no `see` restriction (visible to all).
+ */
+function extractSeeRule(rule) {
+    if (typeof rule === 'object' && rule !== null && !Array.isArray(rule) && ('see' in rule || 'set' in rule)) {
+        const objRule = rule;
+        if (objRule.see === undefined)
+            return undefined; // no see restriction = visible to all
+        return objRule.see;
+    }
+    return rule;
+}
+/**
+ * Check if a field access rule allows visibility for the given principals.
+ */
+function isFieldVisible(rule, entity, principals) {
+    const seeRule = extractSeeRule(rule);
+    if (seeRule === undefined)
+        return true; // { set: ... } without see = visible to all
+    // Empty array = nobody
+    if (Array.isArray(seeRule) && seeRule.length === 0)
+        return false;
+    // Single permission def
+    if (isPermissionDefLike(seeRule)) {
+        return matchesPrincipal(seeRule, entity, principals);
+    }
+    // Array of permission defs (OR semantics)
+    if (Array.isArray(seeRule)) {
+        return seeRule.some((def) => isPermissionDefLike(def) && matchesPrincipal(def, entity, principals));
+    }
+    return false;
+}
+/**
+ * Get the access rules from a model class (if any).
+ */
+export function getAccessRules(modelClass) {
+    return modelClass[ACCESS_RULES];
+}
+/**
+ * Filter an entity's enumerable properties based on access rules and principals.
+ * Returns a plain object with only the visible fields.
+ *
+ * - No access rules on model → returns all fields (backwards compatible)
+ * - Field not in access rules → included (default: visible)
+ * - Field in access rules → evaluated against principals
+ */
+export function filterByAccess(entity, modelClass, principals) {
+    const rules = getAccessRules(modelClass);
+    if (!rules)
+        return { ...entity };
+    const result = {};
+    for (const key of Object.keys(entity)) {
+        const rule = rules[key];
+        if (!rule) {
+            result[key] = entity[key];
+        }
+        else if (isFieldVisible(rule, entity, principals)) {
+            result[key] = entity[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=access.js.map

package/dist/models/access.js.map

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

package/dist/models/apply-types-config.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared utility for transforming string params into typed References
+ * using a `types` config. Used by both the process executor and HTTP server.
+ *
+ * Matching: key matches param name directly, lowercased, or lowercased + "Ref" suffix.
+ * `types: { Table }` matches `:table`, `:Table`, and `:tableRef`.
+ */
+import type { ModelClass } from './define-model.js';
+import { Reference } from './reference/reference.js';
+import type { ReferenceResolver } from './reference/reference.js';
+export declare function registerModelRefResolver(model: ModelClass<unknown>, resolver: ReferenceResolver<unknown>): void;
+export declare function getModelRefResolver(model: ModelClass<unknown>): ReferenceResolver<unknown> | undefined;
+/** Flatten intersection types for cleaner display */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Types config: maps model classes to path params */
+export type TypesConfig = Record<string, ModelClass<unknown>>;
+/**
+ * Extract param names from a path as a union of string literals.
+ * "/poker/:table/game/:gameId" → "table" | "gameId"
+ */
+export type ExtractParamNames<Path extends string> = Path extends `${string}:${infer Param}/${infer Rest}` ? Param | ExtractParamNames<`/${Rest}`> : Path extends `${string}:${infer Param}` ? Param : never;
+/**
+ * Extract params from a path as a record of string values.
+ * "/users/:id/posts/:postId" → { id: string; postId: string }
+ */
+export type ExtractParams<TPath extends string> = {
+    [K in ExtractParamNames<TPath>]: string;
+};
+/**
+ * Look up the model type for a param name from the types config.
+ *
+ * Matches by:
+ * 1. Direct key match: `types: { tableRef: Table }` → `:tableRef` gets `Ref<Table>`
+ * 2. Lowercased key: `types: { Table }` → `:table` gets `Ref<Table>`
+ * 3. Lowercased + "Ref" suffix: `types: { Table }` → `:tableRef` gets `Ref<Table>`
+ */
+export type ResolveParamType<TParamName extends string, TTypes extends Record<string, abstract new (...args: any[]) => any>> = {
+    [K in keyof TTypes]: K extends TParamName ? TTypes[K] : K extends string ? Lowercase<K> extends TParamName ? TTypes[K] : `${Lowercase<K>}Ref` extends TParamName ? TTypes[K] : never : never;
+}[keyof TTypes];
+/**
+ * Extract a clean Reference type from a model class.
+ * Uses InstanceType<T> so TypeScript preserves the class name in tooltips.
+ */
+type ModelReference<TModel extends abstract new (...args: any[]) => any> = Reference<InstanceType<TModel>>;
+export type TypedParams<TPath extends string, TTypes extends Record<string, abstract new (...args: any[]) => any>> = {
+    [P in ExtractParamNames<TPath>]: ResolveParamType<P, TTypes> extends never ? string : ModelReference<ResolveParamType<P, TTypes>>;
+};
+export declare function applyTypesConfig(params: Record<string, string>, types?: TypesConfig): Record<string, unknown>;
+export {};
+//# sourceMappingURL=apply-types-config.d.ts.map

package/dist/models/apply-types-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-types-config.d.ts","sourceRoot":"","sources":["../../src/models/apply-types-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAgB,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQlE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI,CAE/G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAEtG;AAMD,qDAAqD;AACrD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,IAAI,SAAS,MAAM,IAC/C,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GACjD,KAAK,GAAG,iBAAiB,CAAC,IAAI,IAAI,EAAE,CAAC,GACrC,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,EAAE,GACrC,KAAK,GACL,KAAK,CAAC;AAEd;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,MAAM,IAC5C;KAAG,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,MAAM;CAAE,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,CAC1B,UAAU,SAAS,MAAM,EACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,IACjE;KACD,CAAC,IAAI,MAAM,MAAM,GAAG,CAAC,SAAS,UAAU,GACrC,MAAM,CAAC,CAAC,CAAC,GACT,CAAC,SAAS,MAAM,GACd,SAAS,CAAC,CAAC,CAAC,SAAS,UAAU,GAC7B,MAAM,CAAC,CAAC,CAAC,GACT,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,UAAU,GACrC,MAAM,CAAC,CAAC,CAAC,GACT,KAAK,GACT,KAAK;CACZ,CAAC,MAAM,MAAM,CAAC,CAAC;AAEhB;;;GAGG;AACH,KAAK,cAAc,CAAC,MAAM,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IACrE,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AAElC,MAAM,MAAM,WAAW,CACrB,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,IACjE;KACD,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAC9B,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,KAAK,GACrC,MAAM,GACN,cAAc,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;CAChD,CAAC;AAMF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,KAAK,CAAC,EAAE,WAAW,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB"}

package/dist/models/apply-types-config.js

@@ -0,0 +1,47 @@
+/**
+ * Shared utility for transforming string params into typed References
+ * using a `types` config. Used by both the process executor and HTTP server.
+ *
+ * Matching: key matches param name directly, lowercased, or lowercased + "Ref" suffix.
+ * `types: { Table }` matches `:table`, `:Table`, and `:tableRef`.
+ */
+import { Reference, SET_RESOLVER } from './reference/reference.js';
+// ============================================================================
+// Global ref resolver registry - populated by storage adapters at boot
+// ============================================================================
+const _resolvers = new WeakMap();
+export function registerModelRefResolver(model, resolver) {
+    _resolvers.set(model, resolver);
+}
+export function getModelRefResolver(model) {
+    return _resolvers.get(model);
+}
+// ============================================================================
+// Runtime param transformation
+// ============================================================================
+export function applyTypesConfig(params, types) {
+    if (!types)
+        return params;
+    const lookup = new Map();
+    for (const [key, model] of Object.entries(types)) {
+        lookup.set(key, model);
+        lookup.set(key.toLowerCase(), model);
+        lookup.set(key.toLowerCase() + 'Ref', model);
+    }
+    const result = {};
+    for (const [paramName, stringValue] of Object.entries(params)) {
+        const model = lookup.get(paramName);
+        if (model) {
+            const ref = new Reference(stringValue);
+            const resolver = _resolvers.get(model);
+            if (resolver)
+                ref[SET_RESOLVER](resolver);
+            result[paramName] = ref;
+        }
+        else {
+            result[paramName] = stringValue;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=apply-types-config.js.map

package/dist/models/apply-types-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-types-config.js","sourceRoot":"","sources":["../../src/models/apply-types-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGnE,+EAA+E;AAC/E,uEAAuE;AACvE,+EAA+E;AAE/E,MAAM,UAAU,GAAG,IAAI,OAAO,EAAmD,CAAC;AAElF,MAAM,UAAU,wBAAwB,CAAC,KAA0B,EAAE,QAAoC;IACvG,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAsED,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,MAAM,UAAU,gBAAgB,CAC9B,MAA8B,EAC9B,KAAmB;IAEnB,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAA4B,CAAC,CAAC;YAC9D,IAAI,QAAQ;gBAAG,GAA8E,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtH,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}