@zintrust/core 0.4.17 → 0.4.19

package/src/runtime/RuntimeAdapter.js

@@ -0,0 +1,250 @@
+export const HttpResponse = Object.freeze({
+    create() {
+        const state = {
+            statusCode: 200,
+            headers: { 'Content-Type': 'application/json' },
+            body: null,
+            isBase64Encoded: false,
+        };
+        const self = {
+            get statusCode() {
+                return state.statusCode;
+            },
+            set statusCode(val) {
+                state.statusCode = val;
+            },
+            get headers() {
+                return state.headers;
+            },
+            set headers(val) {
+                state.headers = val;
+            },
+            get body() {
+                return state.body;
+            },
+            set body(val) {
+                state.body = val;
+            },
+            get isBase64Encoded() {
+                return state.isBase64Encoded;
+            },
+            set isBase64Encoded(val) {
+                state.isBase64Encoded = val;
+            },
+            setStatus(code) {
+                state.statusCode = code;
+                return self;
+            },
+            setHeader(key, value) {
+                state.headers[key] = value;
+                return self;
+            },
+            setHeaders(newHeaders) {
+                state.headers = { ...state.headers, ...newHeaders };
+                return self;
+            },
+            setBody(newBody, isBase64) {
+                state.body = newBody;
+                state.isBase64Encoded = isBase64 ?? false;
+                return self;
+            },
+            setJSON(data) {
+                state.headers['Content-Type'] = 'application/json';
+                state.body = JSON.stringify(data);
+                state.isBase64Encoded = false;
+                return self;
+            },
+            toResponse() {
+                return {
+                    statusCode: state.statusCode,
+                    headers: state.headers,
+                    body: state.body ?? undefined,
+                    isBase64Encoded: state.isBase64Encoded,
+                };
+            },
+        };
+        return self;
+    },
+});
+/**
+ * Error response helper
+ */
+export const ErrorResponse = Object.freeze({
+    create(statusCode, message, details) {
+        const response = HttpResponse.create();
+        response.setStatus(statusCode);
+        response.setJSON({
+            error: message,
+            statusCode,
+            timestamp: new Date().toISOString(),
+            ...(details === undefined ? {} : { details }),
+        });
+        return response;
+    },
+});
+/**
+ * Create mock Node.js request/response objects for platform compatibility
+ */
+const coerceFirstForwardedFor = (value) => {
+    if (Array.isArray(value)) {
+        const first = value[0];
+        return typeof first === 'string' && first.trim() !== '' ? first.trim() : undefined;
+    }
+    if (typeof value === 'string' && value.trim() !== '')
+        return value.trim();
+    return undefined;
+};
+const resolveRemoteAddress = (request) => {
+    const forwardedFor = coerceFirstForwardedFor(request.headers?.['x-forwarded-for']);
+    if (typeof request.remoteAddr === 'string' && request.remoteAddr.trim() !== '') {
+        return request.remoteAddr.trim();
+    }
+    return (forwardedFor?.split(',')[0]?.trim() ?? '') || '0.0.0.0';
+};
+const createResponseData = () => ({
+    statusCode: 200,
+    headers: { 'content-type': 'application/json' },
+    body: null,
+});
+const createMockRequest = (request, remoteAddress) => {
+    const hasQuery = request.query !== undefined && request.query !== null && Object.keys(request.query).length > 0;
+    const queryString = (() => {
+        if (!hasQuery)
+            return '';
+        const params = new URLSearchParams();
+        for (const [key, rawValue] of Object.entries(request.query ?? {})) {
+            if (Array.isArray(rawValue)) {
+                for (const value of rawValue)
+                    params.append(key, value);
+                continue;
+            }
+            params.append(key, rawValue);
+        }
+        return params.toString();
+    })();
+    const url = queryString === '' ? request.path : `${request.path}?${queryString}`;
+    return {
+        method: request.method,
+        url,
+        headers: request.headers,
+        body: request.body ?? undefined,
+        remoteAddress,
+        socket: {
+            remoteAddress,
+        },
+        connection: {
+            remoteAddress,
+        },
+    };
+};
+const applyWriteHead = (responseData, statusCode, headers) => {
+    responseData.statusCode = statusCode;
+    if (headers) {
+        const normalizedHeaders = {};
+        for (const [key, value] of Object.entries(headers)) {
+            normalizedHeaders[key.toLowerCase()] = value;
+        }
+        responseData.headers = { ...responseData.headers, ...normalizedHeaders };
+    }
+    if (responseData.headers['content-type'] === 'text/event-stream') {
+        // @ts-ignore - ReadableStream/TransformStream might not be in all TS envs type definitions
+        if (typeof TransformStream !== 'undefined') {
+            // @ts-ignore
+            const stream = new TransformStream();
+            responseData.body = stream.readable;
+            return stream.writable.getWriter();
+        }
+    }
+    return null;
+};
+const resData = (responseData, request) => {
+    return {
+        statusCode: 200,
+        headers: responseData.headers,
+        writeHead: function (statusCode, headers) {
+            this._writer = applyWriteHead(responseData, statusCode, headers);
+            // Handle abortion if signal is present
+            if (request.signal && this._writer) {
+                request.signal.addEventListener('abort', () => {
+                    if (this._writer) {
+                        try {
+                            this._writer.close();
+                        }
+                        catch {
+                            // Ignore close errors
+                        }
+                    }
+                    this.emit('close');
+                });
+            }
+            return this;
+        },
+        setHeader: function (name, value) {
+            responseData.headers[name.toLowerCase()] = value;
+            return this;
+        },
+        end: function (chunk) {
+            if (this._writer) {
+                if (chunk !== undefined && chunk !== null) {
+                    this._writer.write(new TextEncoder().encode(String(chunk)));
+                }
+                this._writer.close();
+                return this;
+            }
+            if (chunk !== undefined) {
+                responseData.body = chunk;
+            }
+            this.emit('finish');
+            return this;
+        },
+        write: function (chunk) {
+            if (this._writer) {
+                try {
+                    this._writer.write(new TextEncoder().encode(String(chunk)));
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            }
+            responseData.body = chunk;
+            return true;
+        },
+        on: function (event, listener) {
+            this._listeners ??= {};
+            this._listeners[event] ??= [];
+            this._listeners[event].push(listener);
+            return this;
+        },
+        once: function (event, listener) {
+            const wrapper = (...args) => {
+                this.removeListener(event, wrapper);
+                listener(...args);
+            };
+            return this.on(event, wrapper);
+        },
+        removeListener: function (event, listener) {
+            if (this._listeners?.[event] !== undefined) {
+                this._listeners[event] = this._listeners[event].filter((l) => l !== listener);
+            }
+            return this;
+        },
+        emit: function (event, ...args) {
+            if (this._listeners?.[event] !== undefined) {
+                // Create a copy to avoid issues if listeners remove themselves
+                [...this._listeners[event]].forEach((fn) => {
+                    fn(...args);
+                });
+            }
+        },
+        _writer: null,
+        _listeners: {},
+    };
+};
+export function createMockHttpObjects(request) {
+    const remoteAddress = resolveRemoteAddress(request);
+    const responseData = createResponseData();
+    const req = createMockRequest(request, remoteAddress);
+    const res = resData(responseData, request);
+    return { req, res, responseData };
+}

package/src/runtime/RuntimeServices.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Runtime Services
+ * Adapter layer for env/crypto/timers/fs/fetch across Node and Workers
+ * Sealed namespace for immutability
+ */
+export type RuntimePlatform = 'nodejs' | 'lambda' | 'fargate' | 'cloudflare' | 'deno';
+export type RuntimeEnvReader = {
+    get: (key: string, defaultValue?: string) => string;
+    getInt: (key: string, defaultValue?: number) => number;
+    getFloat: (key: string, defaultValue?: number) => number;
+    getBool: (key: string, defaultValue?: boolean) => boolean;
+};
+export type RandomValuesArray = Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | Int8Array | Int16Array | Int32Array | BigInt64Array | BigUint64Array;
+export type RuntimeCrypto = {
+    subtle: SubtleCrypto;
+    getRandomValues: <T extends RandomValuesArray>(array: T) => T;
+    randomUUID: () => string;
+    randomBytes?: (size: number) => Uint8Array;
+};
+export type RuntimeTimers = {
+    setTimeout: typeof setTimeout;
+    clearTimeout: typeof clearTimeout;
+    setInterval: typeof setInterval;
+    clearInterval: typeof clearInterval;
+};
+export type RuntimeFs = {
+    supported: boolean;
+    readFileSync: (path: string, encoding?: BufferEncoding) => string | Buffer;
+    readdirSync: (path: string) => string[];
+    existsSync: (path: string) => boolean;
+};
+export type RuntimeServices = {
+    platform: RuntimePlatform;
+    env: RuntimeEnvReader;
+    crypto: RuntimeCrypto;
+    timers: RuntimeTimers;
+    fs: RuntimeFs;
+    fetch: typeof fetch;
+};
+export declare const detectCloudflareWorkers: () => boolean;
+export declare const detectRuntimePlatform: () => RuntimePlatform;
+export declare const RUNTIME_PLATFORM: RuntimePlatform;
+export declare const RuntimeServices: Readonly<{
+    create(platform: RuntimePlatform): RuntimeServices;
+}>;
+export default RuntimeServices;
+//# sourceMappingURL=RuntimeServices.d.ts.map

package/src/runtime/RuntimeServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeServices.d.ts","sourceRoot":"","sources":["../../../src/runtime/RuntimeServices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,eAAe,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,aAAa,EAAE,OAAO,aAAa,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,KAAK,MAAM,GAAG,MAAM,CAAC;IAC3E,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,gBAAgB,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,OAE1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,eAGxC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAAyC,CAAC;AAwIzE,eAAO,MAAM,eAAe;qBACT,eAAe,GAAG,eAAe;EAqBlD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/runtime/RuntimeServices.js

@@ -0,0 +1,164 @@
+/**
+ * Runtime Services
+ * Adapter layer for env/crypto/timers/fs/fetch across Node and Workers
+ * Sealed namespace for immutability
+ */
+import { Cloudflare } from '../config/cloudflare.js';
+import { Env } from '../config/env.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { randomUUID as nodeRandomUUID, randomBytes } from '../node-singletons/crypto.js';
+import * as nodeFs from '../node-singletons/fs.js';
+export const detectCloudflareWorkers = () => {
+    return Cloudflare.getWorkersEnv() !== null;
+};
+export const detectRuntimePlatform = () => {
+    if (detectCloudflareWorkers())
+        return 'cloudflare';
+    return 'nodejs';
+};
+export const RUNTIME_PLATFORM = detectRuntimePlatform();
+const normalizeEnvValue = (value) => {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    return '';
+};
+const readEnvFromRecord = (record, key) => {
+    return normalizeEnvValue(record[key]);
+};
+const createWorkersEnvReader = () => {
+    return {
+        get(key, defaultValue = '') {
+            const env = Cloudflare.getWorkersEnv() ?? {};
+            const value = readEnvFromRecord(env, key);
+            return value === '' ? defaultValue : value;
+        },
+        getInt(key, defaultValue = 0) {
+            const raw = this.get(key, String(defaultValue));
+            const parsed = Number.parseInt(raw, 10);
+            return Number.isFinite(parsed) ? parsed : defaultValue;
+        },
+        getFloat(key, defaultValue = 0) {
+            const raw = this.get(key, String(defaultValue));
+            const parsed = Number.parseFloat(raw);
+            return Number.isFinite(parsed) ? parsed : defaultValue;
+        },
+        getBool(key, defaultValue = false) {
+            const raw = this.get(key, defaultValue ? 'true' : 'false').toLowerCase();
+            if (raw === '')
+                return defaultValue;
+            return raw === 'true' || raw === '1';
+        },
+    };
+};
+const createNodeEnvReader = () => {
+    return {
+        get: (key, defaultValue) => Env.get(key, defaultValue),
+        getInt: (key, defaultValue) => Env.getInt(key, defaultValue ?? 0),
+        getFloat: (key, defaultValue) => Env.getFloat(key, defaultValue ?? 0),
+        getBool: (key, defaultValue) => Env.getBool(key, defaultValue),
+    };
+};
+const getWebCrypto = () => {
+    if (globalThis.crypto === undefined) {
+        throw ErrorFactory.createConfigError('WebCrypto is not available in this runtime');
+    }
+    return globalThis.crypto;
+};
+const fillRandomValues = (webCrypto, array) => {
+    if (typeof webCrypto.getRandomValues === 'function') {
+        return webCrypto.getRandomValues(array);
+    }
+    if (array instanceof BigInt64Array || array instanceof BigUint64Array) {
+        throw ErrorFactory.createConfigError('BigInt typed arrays require WebCrypto support');
+    }
+    const bytes = randomBytes(array.byteLength);
+    const view = new Uint8Array(array.buffer, array.byteOffset, array.byteLength);
+    view.set(bytes);
+    return array;
+};
+const createNodeCrypto = () => {
+    const webCrypto = getWebCrypto();
+    if (webCrypto.subtle === undefined) {
+        throw ErrorFactory.createConfigError('WebCrypto subtle is not available in Node runtime');
+    }
+    return {
+        subtle: webCrypto.subtle,
+        getRandomValues: (array) => {
+            return fillRandomValues(webCrypto, array);
+        },
+        randomUUID: () => {
+            if (typeof webCrypto.randomUUID === 'function')
+                return webCrypto.randomUUID();
+            return nodeRandomUUID();
+        },
+        randomBytes: (size) => randomBytes(size),
+    };
+};
+const createWorkersCrypto = () => {
+    const webCrypto = getWebCrypto();
+    if (webCrypto.subtle === undefined) {
+        throw ErrorFactory.createConfigError('WebCrypto subtle is not available in Workers runtime');
+    }
+    return {
+        subtle: webCrypto.subtle,
+        getRandomValues: (array) => webCrypto.getRandomValues(array),
+        randomUUID: () => {
+            if (typeof webCrypto.randomUUID === 'function')
+                return webCrypto.randomUUID();
+            return nodeRandomUUID();
+        },
+    };
+};
+const createNodeFs = () => {
+    return {
+        supported: true,
+        readFileSync: (path, encoding) => nodeFs.readFileSync(path, encoding),
+        readdirSync: (path) => nodeFs.readdirSync(path),
+        existsSync: (path) => nodeFs.existsSync(path),
+    };
+};
+const createWorkersFs = () => {
+    const unsupported = () => {
+        throw ErrorFactory.createConfigError('Filesystem access is not supported in Workers runtime');
+    };
+    return {
+        supported: false,
+        readFileSync: () => unsupported(),
+        readdirSync: () => unsupported(),
+        existsSync: () => false,
+    };
+};
+const createTimers = () => ({
+    setTimeout: globalThis.setTimeout.bind(globalThis),
+    clearTimeout: globalThis.clearTimeout.bind(globalThis),
+    setInterval: globalThis.setInterval.bind(globalThis),
+    clearInterval: globalThis.clearInterval.bind(globalThis),
+});
+export const RuntimeServices = Object.freeze({
+    create(platform) {
+        if (platform === 'cloudflare') {
+            return {
+                platform,
+                env: createWorkersEnvReader(),
+                crypto: createWorkersCrypto(),
+                timers: createTimers(),
+                fs: createWorkersFs(),
+                fetch: globalThis.fetch.bind(globalThis),
+            };
+        }
+        return {
+            platform,
+            env: createNodeEnvReader(),
+            crypto: createNodeCrypto(),
+            timers: createTimers(),
+            fs: createNodeFs(),
+            fetch: globalThis.fetch.bind(globalThis),
+        };
+    },
+});
+export default RuntimeServices;

package/src/runtime/StartupConfigFileRegistry.d.ts

@@ -0,0 +1,22 @@
+export declare const StartupConfigFile: {
+    readonly Broadcast: "config/broadcast.ts";
+    readonly Cache: "config/cache.ts";
+    readonly Database: "config/database.ts";
+    readonly Mail: "config/mail.ts";
+    readonly Middleware: "config/middleware.ts";
+    readonly Notification: "config/notification.ts";
+    readonly Queue: "config/queue.ts";
+    readonly Storage: "config/storage.ts";
+    readonly Workers: "config/workers.ts";
+};
+export type StartupConfigFileTypes = typeof StartupConfigFile.Broadcast | typeof StartupConfigFile.Cache | typeof StartupConfigFile.Database | typeof StartupConfigFile.Mail | typeof StartupConfigFile.Middleware | typeof StartupConfigFile.Notification | typeof StartupConfigFile.Queue | typeof StartupConfigFile.Storage | typeof StartupConfigFile.Workers;
+export declare const StartupConfigFileRegistry: Readonly<{
+    preload(files: readonly StartupConfigFileTypes[]): Promise<void>;
+    isPreloaded(): boolean;
+    get<T>(file: StartupConfigFileTypes): T | undefined;
+    has(file: StartupConfigFileTypes): boolean;
+    /** Intended for tests only. */
+    clear(): void;
+}>;
+export default StartupConfigFileRegistry;
+//# sourceMappingURL=StartupConfigFileRegistry.d.ts.map

package/src/runtime/StartupConfigFileRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartupConfigFileRegistry.d.ts","sourceRoot":"","sources":["../../../src/runtime/StartupConfigFileRegistry.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAC9B,OAAO,iBAAiB,CAAC,SAAS,GAClC,OAAO,iBAAiB,CAAC,KAAK,GAC9B,OAAO,iBAAiB,CAAC,QAAQ,GACjC,OAAO,iBAAiB,CAAC,IAAI,GAC7B,OAAO,iBAAiB,CAAC,UAAU,GACnC,OAAO,iBAAiB,CAAC,YAAY,GACrC,OAAO,iBAAiB,CAAC,KAAK,GAC9B,OAAO,iBAAiB,CAAC,OAAO,GAChC,OAAO,iBAAiB,CAAC,OAAO,CAAC;AAiDrC,eAAO,MAAM,yBAAyB;mBACf,SAAS,sBAAsB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;mBAcvD,OAAO;QAIlB,CAAC,QAAQ,sBAAsB,GAAG,CAAC,GAAG,SAAS;cAIzC,sBAAsB,GAAG,OAAO;IAI1C,+BAA+B;aACtB,IAAI;EAIb,CAAC;AAEH,eAAe,yBAAyB,CAAC"}

package/src/runtime/StartupConfigFileRegistry.js

@@ -0,0 +1,81 @@
+import * as path from '../node-singletons/path.js';
+import mergeOverrideValues from './OverrideValueMerge.js';
+import { ProjectRuntime } from './ProjectRuntime.js';
+import useFileLoader from './useFileLoader.js';
+// NOTE runtime config loader
+export const StartupConfigFile = {
+    Broadcast: 'config/broadcast.ts',
+    Cache: 'config/cache.ts',
+    Database: 'config/database.ts',
+    Mail: 'config/mail.ts',
+    Middleware: 'config/middleware.ts',
+    Notification: 'config/notification.ts',
+    Queue: 'config/queue.ts',
+    Storage: 'config/storage.ts',
+    Workers: 'config/workers.ts',
+};
+const cache = new Map();
+let preloaded = false;
+const getWorkersStartupOverrides = () => {
+    if (typeof globalThis === 'undefined')
+        return undefined;
+    const globalAny = globalThis;
+    return globalAny.__zintrustStartupConfigOverrides;
+};
+const getServiceConfigFile = (file) => {
+    const activeService = ProjectRuntime.getActiveService();
+    if (activeService?.configRoot === undefined || activeService.configRoot.trim() === '') {
+        return undefined;
+    }
+    return `${activeService.configRoot}/${path.basename(file)}`;
+};
+const loadStartupOverride = async (file) => {
+    const overrides = getWorkersStartupOverrides();
+    if (overrides?.has(file) === true) {
+        return overrides.get(file);
+    }
+    const rootLoader = useFileLoader(file);
+    const serviceFile = getServiceConfigFile(file);
+    const serviceLoader = serviceFile === undefined ? undefined : useFileLoader(serviceFile);
+    const hasRoot = rootLoader.exists();
+    const hasService = serviceLoader?.exists() === true;
+    if (!hasRoot && !hasService) {
+        return undefined;
+    }
+    const rootOverride = hasRoot ? await rootLoader.get() : undefined;
+    const serviceOverride = hasService && serviceLoader !== undefined ? await serviceLoader.get() : undefined;
+    if (rootOverride === undefined)
+        return serviceOverride;
+    if (serviceOverride === undefined)
+        return rootOverride;
+    return mergeOverrideValues(rootOverride, serviceOverride);
+};
+export const StartupConfigFileRegistry = Object.freeze({
+    async preload(files) {
+        const tasks = files.map(async (file) => {
+            const value = await loadStartupOverride(file);
+            if (value === undefined) {
+                cache.delete(file);
+                return;
+            }
+            cache.set(file, value);
+        });
+        await Promise.all(tasks);
+        preloaded = true;
+    },
+    isPreloaded() {
+        return preloaded;
+    },
+    get(file) {
+        return cache.get(file);
+    },
+    has(file) {
+        return cache.has(file);
+    },
+    /** Intended for tests only. */
+    clear() {
+        cache.clear();
+        preloaded = false;
+    },
+});
+export default StartupConfigFileRegistry;

package/src/runtime/WorkerAdapterImports.d.ts

@@ -0,0 +1,5 @@
+export declare const WorkerAdapterImports: Readonly<{
+    loaded: boolean;
+    ready: void;
+}>;
+//# sourceMappingURL=WorkerAdapterImports.d.ts.map

package/src/runtime/WorkerAdapterImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerAdapterImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkerAdapterImports.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,oBAAoB;;;EAG/B,CAAC"}

package/src/runtime/WorkerAdapterImports.js

@@ -0,0 +1,34 @@
+// Worker-only adapter auto-imports for bundler-based runtimes (e.g. Cloudflare Workers).
+// Keep this list limited to database adapters needed by runtime config.
+import { ProjectRuntime } from './ProjectRuntime.js';
+const tryImportProjectRuntime = async () => {
+    try {
+        ProjectRuntime.set(await import('../zintrust.runtime.wg.js'));
+        return;
+    }
+    catch {
+        // continue
+    }
+    try {
+        ProjectRuntime.set(await import('../zintrust.runtime.js'));
+    }
+    catch {
+        // Ignore missing runtime modules. Worker startup can still proceed without them.
+    }
+};
+// These imports resolve against the host project (developer working directory)
+// via the @/ alias configured by the ZinTrust app templates.
+const tryImportOptional = async () => {
+    await tryImportProjectRuntime();
+    try {
+        await import('../zintrust.plugins.wg.js');
+    }
+    catch {
+        // Log and swallow errors since these are optional imports that may not exist in all projects.
+    }
+};
+const ready = await tryImportOptional();
+export const WorkerAdapterImports = Object.freeze({
+    loaded: true,
+    ready,
+});

package/src/runtime/WorkersModule.d.ts

@@ -0,0 +1,6 @@
+type WorkersModule = typeof import('../../packages/workers/src/index.js');
+type QueueMonitorModule = typeof import('../../packages/queue-monitor/src/index.js');
+export declare const loadWorkersModule: () => Promise<WorkersModule>;
+export declare const loadQueueMonitorModule: () => Promise<QueueMonitorModule>;
+export {};
+//# sourceMappingURL=WorkersModule.d.ts.map

package/src/runtime/WorkersModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkersModule.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkersModule.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,cAAc,mBAAmB,CAAC,CAAC;AACxD,KAAK,kBAAkB,GAAG,cAAc,yBAAyB,CAAC,CAAC;AA8WnE,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,aAAa,CAwB/D,CAAC;AA4CF,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,kBAAkB,CAkBzE,CAAC"}