@zintrust/core 0.1.39 → 0.1.41

package/src/runtime/PluginAutoImports.js

@@ -1,7 +1,7 @@
 import { pathToFileURL } from '../node-singletons/url.js';
 import { readEnvString } from '../common/ExternalServiceUtils.js';
 import { Logger } from '../config/logger.js';
-import { existsSync } from '../node-singletons/fs.js';
+import { existsSync, readFile } from '../node-singletons/fs.js';
 import * as path from '../node-singletons/path.js';
 const getProjectCwd = () => process.cwd();
 const getProjectRootEnv = () => readEnvString('ZINTRUST_PROJECT_ROOT');
@@ -22,6 +22,77 @@ const getCandidates = (projectRoot) => {
         path.join(projectRoot, 'src', 'zintrust.plugins.js'),
     ];
 };
+const extractImportSpecifiers = (raw) => {
+    const specifiers = [];
+    for (const line of raw.split(/\r?\n/)) {
+        const match = /^\s*import\s+['"]([^'"]+)['"];?\s*$/.exec(line);
+        if (match?.[1] !== null && match?.[1] !== undefined) {
+            specifiers.push(match[1]);
+        }
+    }
+    return specifiers;
+};
+const readImportSpecifiersFromFiles = async (files) => {
+    const importSpecifiers = [];
+    // Read all files in parallel
+    const fileReadPromises = files.map(async (filePath) => {
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            return { filePath, specifiers: extractImportSpecifiers(raw), success: true };
+        }
+        catch (error) {
+            Logger.debug('[plugins] Failed to read auto-import file for fallback', {
+                filePath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return { filePath, specifiers: [], success: false };
+        }
+    });
+    const results = await Promise.all(fileReadPromises);
+    // Collect all successful specifiers
+    for (const { filePath, specifiers } of results) {
+        for (const specifier of specifiers) {
+            importSpecifiers.push({ specifier, filePath });
+        }
+    }
+    return importSpecifiers;
+};
+const resolveRelativeSpecifier = (entry) => {
+    const baseDir = path.dirname(entry.filePath);
+    const basePath = path.resolve(baseDir, entry.specifier);
+    const candidates = [
+        basePath,
+        `${basePath}.js`,
+        `${basePath}.ts`,
+        path.join(basePath, 'index.js'),
+        path.join(basePath, 'index.ts'),
+    ];
+    const resolved = candidates.find((candidate) => existsSync(candidate)) ?? basePath;
+    return pathToFileURL(resolved).href;
+};
+const importSpecifiers = async (specifiers) => {
+    // Import all specifiers in parallel
+    const importPromises = Array.from(specifiers).map(async (entry) => {
+        const target = entry.specifier.startsWith('.')
+            ? resolveRelativeSpecifier(entry)
+            : entry.specifier;
+        try {
+            await import(target);
+            Logger.debug('[plugins] Loaded auto-import specifier', { specifier: entry.specifier });
+            return { specifier: entry.specifier, success: true };
+        }
+        catch (error) {
+            Logger.debug('[plugins] Failed auto-import specifier', {
+                specifier: entry.specifier,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return { specifier: entry.specifier, success: false };
+        }
+    });
+    const results = await Promise.allSettled(importPromises);
+    // Count successful imports
+    return results.filter((result) => result.status === 'fulfilled' && result.value.success).length;
+};
 export const PluginAutoImports = Object.freeze({
     /**
      * Best-effort import of a project's `src/zintrust.plugins.ts` file.
@@ -39,8 +110,7 @@ export const PluginAutoImports = Object.freeze({
             Logger.debug('[plugins] No plugin auto-imports file found', { projectRoot, candidates });
             return { ok: false, reason: 'not-found' };
         }
-        // Try all existing candidates in parallel
-        const importPromises = existingCandidates.map(async (candidate) => {
+        const tryImportCandidate = async (candidate) => {
             try {
                 const url = pathToFileURL(candidate).href;
                 await import(url);
@@ -55,7 +125,9 @@ export const PluginAutoImports = Object.freeze({
                     errorMessage,
                 };
             }
-        });
+        };
+        // Try all existing candidates in parallel
+        const importPromises = existingCandidates.map(async (candidate) => tryImportCandidate(candidate));
         // Return the first successful import, or the first failure if none succeed
         try {
             const results = await Promise.allSettled(importPromises);
@@ -65,15 +137,28 @@ export const PluginAutoImports = Object.freeze({
             }
             // Return the first failed result if no success
             const firstFailedResult = results.find((result) => result.status === 'fulfilled' && !result.value.ok);
-            return (firstFailedResult?.value ?? {
-                ok: false,
-                reason: 'import-failed',
-                errorMessage: 'All candidates failed',
-            });
+            const failed = firstFailedResult?.value ??
+                { ok: false, reason: 'import-failed', errorMessage: 'All candidates failed' };
+            Logger.debug('[plugins] Auto-import file failed, attempting per-import fallback', failed);
+            const fallbackResult = await this.tryImportFromFileContents(existingCandidates);
+            if (fallbackResult.ok)
+                return fallbackResult;
+            return failed;
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             return { ok: false, reason: 'import-failed', errorMessage };
         }
     },
+    async tryImportFromFileContents(files) {
+        const specifiers = await readImportSpecifiersFromFiles(files);
+        if (specifiers.length === 0) {
+            return { ok: false, reason: 'import-failed', errorMessage: 'No import specifiers found' };
+        }
+        const loaded = await importSpecifiers(specifiers);
+        if (loaded > 0) {
+            return { ok: true, loadedPath: 'manual-imports' };
+        }
+        return { ok: false, reason: 'import-failed', errorMessage: 'All specifier imports failed' };
+    },
 });

package/src/runtime/RuntimeAdapter.d.ts

@@ -1,5 +1,5 @@
 import type { IncomingMessage, ServerResponse } from '../node-singletons/http';
-type Tbody = string | Buffer | null;
+type Tbody = string | Buffer | ReadableStream<Uint8Array> | null;
 /**
  * Request body type for handlers
  */
@@ -14,6 +14,7 @@ export interface PlatformRequest {
     body?: Tbody;
     query?: Record<string, string | string[]>;
     remoteAddr?: string;
+    signal?: AbortSignal;
 }
 export interface PlatformResponse {
     statusCode: number;
@@ -110,17 +111,15 @@ export declare const HttpResponse: Readonly<{
 export declare const ErrorResponse: Readonly<{
     create(statusCode: number, message: string, details?: unknown): IHttpResponse;
 }>;
-/**
- * Create mock Node.js request/response objects for platform compatibility
- */
+type ResData = {
+    statusCode: number;
+    headers: Record<string, string | string[]>;
+    body: Tbody;
+};
 export declare function createMockHttpObjects(request: PlatformRequest): {
     req: Record<string, unknown>;
     res: Record<string, unknown>;
-    responseData: {
-        statusCode: number;
-        headers: Record<string, string | string[]>;
-        body: Tbody;
-    };
+    responseData: ResData;
 };
 export {};
 //# sourceMappingURL=RuntimeAdapter.d.ts.map

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

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

package/src/runtime/RuntimeAdapter.js

@@ -85,45 +85,79 @@ export const ErrorResponse = Object.freeze({
 /**
  * Create mock Node.js request/response objects for platform compatibility
  */
-export function createMockHttpObjects(request) {
-    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 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']);
-    const remoteAddress = typeof request.remoteAddr === 'string' && request.remoteAddr.trim() !== ''
-        ? request.remoteAddr.trim()
-        : (forwardedFor?.split(',')[0]?.trim() ?? '') || '0.0.0.0';
-    const responseData = {
-        statusCode: 200,
-        headers: { 'Content-Type': 'application/json' },
-        body: null,
-    };
-    // Create minimal mock objects for compatibility
-    const req = {
-        method: request.method,
-        url: request.path,
-        headers: request.headers,
+    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) => ({
+    method: request.method,
+    url: request.path,
+    headers: request.headers,
+    body: request.body ?? undefined,
+    remoteAddress,
+    socket: {
         remoteAddress,
-        socket: {
-            remoteAddress,
-        },
-        connection: {
-            remoteAddress,
-        },
-    };
-    const res = {
+    },
+    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) {
-            responseData.statusCode = statusCode;
-            if (headers) {
-                responseData.headers = { ...responseData.headers, ...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;
         },
@@ -132,15 +166,67 @@ export function createMockHttpObjects(request) {
             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

@@ -9,12 +9,12 @@ export declare const StartupConfigFile: {
     readonly Storage: "config/storage.ts";
     readonly Workers: "config/workers.ts";
 };
-export type StartupConfigFileTyps = 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 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 StartupConfigFileTyps[]): Promise<void>;
+    preload(files: readonly StartupConfigFileTypes[]): Promise<void>;
     isPreloaded(): boolean;
-    get<T>(file: StartupConfigFileTyps): T | undefined;
-    has(file: StartupConfigFileTyps): boolean;
+    get<T>(file: StartupConfigFileTypes): T | undefined;
+    has(file: StartupConfigFileTypes): boolean;
     /** Intended for tests only. */
     clear(): void;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"StartupConfigFileRegistry.d.ts","sourceRoot":"","sources":["../../../src/runtime/StartupConfigFileRegistry.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC7B,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;AAKrC,eAAO,MAAM,yBAAyB;mBACf,SAAS,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;mBAetD,OAAO;QAIlB,CAAC,QAAQ,qBAAqB,GAAG,CAAC,GAAG,SAAS;cAIxC,qBAAqB,GAAG,OAAO;IAIzC,+BAA+B;aACtB,IAAI;EAIb,CAAC;AAEH,eAAe,yBAAyB,CAAC"}
+{"version":3,"file":"StartupConfigFileRegistry.d.ts","sourceRoot":"","sources":["../../../src/runtime/StartupConfigFileRegistry.ts"],"names":[],"mappings":"AAGA,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;AAarC,eAAO,MAAM,yBAAyB;mBACf,SAAS,sBAAsB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;mBAqBvD,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

@@ -1,4 +1,5 @@
 import useFileLoader from './useFileLoader.js';
+// NOTE runtime config loader
 export const StartupConfigFile = {
     Broadcast: 'config/broadcast.ts',
     Cache: 'config/cache.ts',
@@ -12,9 +13,20 @@ export const StartupConfigFile = {
 };
 const cache = new Map();
 let preloaded = false;
+const getWorkersStartupOverrides = () => {
+    if (typeof globalThis === 'undefined')
+        return undefined;
+    const globalAny = globalThis;
+    return globalAny.__zintrustStartupConfigOverrides;
+};
 export const StartupConfigFileRegistry = Object.freeze({
     async preload(files) {
         const tasks = files.map(async (file) => {
+            const overrides = getWorkersStartupOverrides();
+            if (overrides?.has(file) === true) {
+                cache.set(file, overrides.get(file));
+                return;
+            }
             const loader = useFileLoader(file);
             if (!loader.exists()) {
                 cache.delete(file);

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":"AAeA,eAAO,MAAM,oBAAoB;;;EAG/B,CAAC"}