@zintrust/core 3.5.1 → 3.6.0

package/src/sockets/SocketRuntime.js

@@ -0,0 +1,59 @@
+import { Env } from '../config/env.js';
+const normalizeSocketPath = (value) => {
+    const trimmed = value.trim();
+    if (trimmed === '' || trimmed === '/')
+        return '/app';
+    const normalized = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    let end = normalized.length;
+    while (end > 1 && normalized[end - 1] === '/') {
+        end -= 1;
+    }
+    return end === normalized.length ? normalized : normalized.slice(0, end);
+};
+const pickFirstNonEmpty = (...values) => {
+    for (const value of values) {
+        if (value.trim() !== '') {
+            return value.trim();
+        }
+    }
+    return '';
+};
+const resolveTransport = (value) => {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'node' || normalized === 'cloudflare') {
+        return normalized;
+    }
+    return 'auto';
+};
+const readEnvString = (key, fallback = '') => {
+    if (typeof Env.get === 'function') {
+        return Env.get(key, fallback);
+    }
+    return fallback;
+};
+const readEnvBool = (key, fallback) => {
+    if (typeof Env.getBool === 'function') {
+        return Env.getBool(key, fallback);
+    }
+    return fallback;
+};
+const readEnvInt = (key, fallback) => {
+    if (typeof Env.getInt === 'function') {
+        return Env.getInt(key, fallback);
+    }
+    return fallback;
+};
+export const SocketFeature = Object.freeze({
+    getSettings() {
+        return Object.freeze({
+            enabled: readEnvBool('SOCKET_ENABLED', false),
+            transport: resolveTransport(readEnvString('SOCKET_TRANSPORT', 'auto')),
+            path: normalizeSocketPath(readEnvString('SOCKET_PATH', '/app')),
+            appId: pickFirstNonEmpty(readEnvString('PUSHER_APP_ID', ''), readEnvString('BROADCAST_APP_ID', '')),
+            appKey: pickFirstNonEmpty(readEnvString('PUSHER_APP_KEY', ''), readEnvString('BROADCAST_AUTH_KEY', ''), readEnvString('BROADCAST_APP_KEY', '')),
+            secret: pickFirstNonEmpty(readEnvString('PUSHER_APP_SECRET', ''), readEnvString('BROADCAST_SECRET', ''), readEnvString('BROADCAST_APP_SECRET', '')),
+            activityTimeout: readEnvInt('BROADCAST_ACTIVITY_TIMEOUT', 120),
+        });
+    },
+});
+export default SocketFeature;

package/src/sockets/SocketRuntimeRegistry.d.ts

@@ -0,0 +1,11 @@
+import type { SocketRouteRegistrar, SocketRuntime, SocketRuntimeDiagnostics } from './SocketRuntime.js';
+export declare const SocketRuntimeRegistry: Readonly<{
+    registerRuntime(runtime: SocketRuntime): void;
+    getRuntime(): SocketRuntime | undefined;
+    registerRoutes(routeRegistrar: SocketRouteRegistrar): void;
+    getRouteRegistrar(): SocketRouteRegistrar | undefined;
+    getDiagnostics: () => SocketRuntimeDiagnostics | null;
+    reset(): void;
+}>;
+export default SocketRuntimeRegistry;
+//# sourceMappingURL=SocketRuntimeRegistry.d.ts.map

package/src/sockets/SocketRuntimeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketRuntimeRegistry.d.ts","sourceRoot":"","sources":["../../../src/sockets/SocketRuntimeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAwBhC,eAAO,MAAM,qBAAqB;6BACP,aAAa,GAAG,IAAI;kBAI/B,aAAa,GAAG,SAAS;mCAIR,oBAAoB,GAAG,IAAI;yBAIrC,oBAAoB,GAAG,SAAS;0BAlB5B,wBAAwB,GAAG,IAAI;aAwB/C,IAAI;EAGb,CAAC;AAEH,eAAe,qBAAqB,CAAC"}

package/src/sockets/SocketRuntimeRegistry.js

@@ -0,0 +1,29 @@
+const getRegistryGlobal = () => globalThis;
+const getState = () => {
+    const globalRegistry = getRegistryGlobal();
+    globalRegistry.__zintrustSocketRuntimeRegistry ??= {};
+    return globalRegistry.__zintrustSocketRuntimeRegistry;
+};
+const getDiagnostics = () => {
+    const runtime = getState().runtime;
+    return runtime?.describe() ?? null;
+};
+export const SocketRuntimeRegistry = Object.freeze({
+    registerRuntime(runtime) {
+        getState().runtime = runtime;
+    },
+    getRuntime() {
+        return getState().runtime;
+    },
+    registerRoutes(routeRegistrar) {
+        getState().routeRegistrar = routeRegistrar;
+    },
+    getRouteRegistrar() {
+        return getState().routeRegistrar;
+    },
+    getDiagnostics,
+    reset() {
+        delete getRegistryGlobal().__zintrustSocketRuntimeRegistry;
+    },
+});
+export default SocketRuntimeRegistry;

package/src/start.d.ts

@@ -0,0 +1,29 @@
+import { type ActiveServiceRuntime } from './microservices/ServiceManifest.js';
+export declare const isNodeMain: (importMetaUrl: string) => boolean;
+export declare const configureStandaloneService: (activeService: unknown) => ActiveServiceRuntime;
+export declare const bootStandaloneService: (importMetaUrl: string, activeService: unknown) => Promise<ActiveServiceRuntime>;
+/**
+ * Start the Node server (dev/prod) by delegating to the framework bootstrap.
+ *
+ * This uses a non-literal dynamic import so Worker bundlers don't pull Node-only modules.
+ */
+export declare const start: () => Promise<void>;
+declare const cloudflareWorker: Readonly<{
+    fetch: (request: Request, env: unknown, ctx: unknown) => Promise<Response>;
+}>;
+declare const deno: (request: Request) => Promise<Response>;
+declare const handler: (event: unknown, context: unknown) => Promise<unknown>;
+/**
+ * Cloudflare Workers entry (module worker style).
+ */
+export default cloudflareWorker;
+export { cloudflareWorker };
+/**
+ * Deno fetch handler.
+ */
+export { deno };
+/**
+ * AWS Lambda handler.
+ */
+export { handler };
+//# sourceMappingURL=start.d.ts.map

package/src/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAkFxC,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,KAAG,OAYlD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,eAAe,OAAO,KAAG,oBAOnE,CAAC;AAoEF,eAAO,MAAM,qBAAqB,GAChC,eAAe,MAAM,EACrB,eAAe,OAAO,KACrB,OAAO,CAAC,oBAAoB,CAS9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAW1C,CAAC;AAcF,QAAA,MAAM,gBAAgB;qBAZkB,OAAO,OAAO,OAAO,OAAO,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;EAc7F,CAAC;AAEH,QAAA,MAAM,IAAI,GAAU,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAKtD,CAAC;AAEF,QAAA,MAAM,OAAO,GAAU,OAAO,OAAO,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,OAAO,CAKxE,CAAC;AAEF;;GAEG;AACH,eAAe,gBAAgB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/src/start.js

@@ -0,0 +1,168 @@
+import { isArray, isNonEmptyString, isObject } from './helper/index.js';
+import { ZintrustLang } from './lang/lang.js';
+import { normalizeActiveServiceRuntime, } from './microservices/ServiceManifest.js';
+import { ensureNodeStartupEnvLoaded } from './runtime/NodeStartup.js';
+import { resolveNodeProjectRoot } from './runtime/resolveNodeProjectRoot.js';
+import { isNodeRuntime } from './runtime/detectRuntime.js';
+const getProjectRuntimeGlobal = () => globalThis;
+const getCachedProjectRuntime = () => {
+    return getProjectRuntimeGlobal().__zintrustProjectRuntime;
+};
+const setCachedProjectRuntime = (value) => {
+    const current = getCachedProjectRuntime();
+    const next = Object.freeze({
+        ...(current?.serviceManifest === undefined ? {} : { serviceManifest: current.serviceManifest }),
+        ...(current?.activeService === undefined ? {} : { activeService: current.activeService }),
+        ...(value.serviceManifest === undefined ? {} : { serviceManifest: value.serviceManifest }),
+        ...(value.activeService === undefined ? {} : { activeService: value.activeService }),
+    });
+    getProjectRuntimeGlobal().__zintrustProjectRuntime = next;
+    return next;
+};
+const createValidationError = (message) => {
+    // eslint-disable-next-line no-restricted-syntax
+    const error = new Error(message);
+    error.name = 'ValidationError';
+    error.statusCode = 400;
+    error.code = 'VALIDATION_ERROR';
+    return error;
+};
+const loadCloudflareWorker = async () => {
+    const module = (await import('./functions/cloudflare.js'));
+    if (typeof module.fetch === 'function') {
+        return module;
+    }
+    if (module.default !== undefined && typeof module.default.fetch === 'function') {
+        return module.default;
+    }
+    return module;
+};
+const isAbsolutePath = (value) => value.startsWith('/') || /^[A-Za-z]:[\\/]/.test(value);
+const fileUrlToPathLike = (value) => {
+    if (!value.startsWith(ZintrustLang.FILE_PROTOCOL))
+        return value;
+    // Basic file URL decoding (sufficient for macOS/Linux paths).
+    try {
+        return decodeURIComponent(value.slice(ZintrustLang.FILE_PROTOCOL.length));
+    }
+    catch {
+        return value.slice(ZintrustLang.FILE_PROTOCOL.length);
+    }
+};
+export const isNodeMain = (importMetaUrl) => {
+    if (!isNodeRuntime())
+        return false;
+    const argv1 = process.argv;
+    const scriptPath = Array.isArray(argv1) ? String(argv1[1] ?? '') : '';
+    if (scriptPath === '')
+        return false;
+    const here = fileUrlToPathLike(importMetaUrl);
+    if (scriptPath === here)
+        return true;
+    // Best-effort: handle relative argv paths and runner wrappers.
+    return scriptPath.endsWith(here);
+};
+export const configureStandaloneService = (activeService) => {
+    const normalized = normalizeActiveServiceRuntime(activeService);
+    if (normalized === undefined) {
+        throw createValidationError('Standalone service runtime requires at least domain and name.');
+    }
+    return setCachedProjectRuntime({ activeService: normalized }).activeService ?? normalized;
+};
+const normalizeStandaloneEnvPaths = (value) => {
+    if (isNonEmptyString(value)) {
+        const trimmed = value.trim();
+        return trimmed === '' ? [] : [trimmed];
+    }
+    if (!isArray(value))
+        return [];
+    return value
+        .filter(isNonEmptyString)
+        .map((item) => item.trim())
+        .filter((item) => item !== '');
+};
+const resolveServiceEnvPath = async (importMetaUrl, activeService, projectRoot) => {
+    const path = await import('./node-singletons/path.js');
+    if (isObject(activeService) && isNonEmptyString(activeService['configRoot'])) {
+        return path.dirname(path.join(projectRoot, activeService['configRoot']));
+    }
+    const entryFile = fileUrlToPathLike(importMetaUrl);
+    const entryDir = path.dirname(entryFile);
+    return path.basename(entryDir) === 'src' ? path.dirname(entryDir) : entryDir;
+};
+const resolveConfiguredEnvPaths = async (projectRoot, activeService, importMetaUrl) => {
+    const path = await import('./node-singletons/path.js');
+    const configured = isObject(activeService)
+        ? normalizeStandaloneEnvPaths(activeService['envPath'])
+        : [];
+    if (configured.length > 0) {
+        return configured.map((value) => isAbsolutePath(value) ? value : path.join(projectRoot, value));
+    }
+    return [await resolveServiceEnvPath(importMetaUrl, activeService, projectRoot)];
+};
+const ensureStandaloneServiceEnv = async (importMetaUrl, activeService) => {
+    if (!isNodeRuntime())
+        return;
+    const { EnvFileLoader } = await import('./cli/utils/EnvFileLoader.js');
+    const projectRoot = await resolveNodeProjectRoot();
+    const envPaths = await resolveConfiguredEnvPaths(projectRoot, activeService, importMetaUrl);
+    const rootEnv = !isObject(activeService) || activeService['rootEnv'] !== false;
+    EnvFileLoader.ensureLoaded({
+        cwd: projectRoot,
+        includeCwd: rootEnv,
+        envPaths,
+    });
+};
+export const bootStandaloneService = async (importMetaUrl, activeService) => {
+    await ensureStandaloneServiceEnv(importMetaUrl, activeService);
+    const configuredService = configureStandaloneService(activeService);
+    if (isNodeMain(importMetaUrl)) {
+        await start();
+    }
+    return configuredService;
+};
+/**
+ * Start the Node server (dev/prod) by delegating to the framework bootstrap.
+ *
+ * This uses a non-literal dynamic import so Worker bundlers don't pull Node-only modules.
+ */
+export const start = async () => {
+    if (!isNodeRuntime())
+        return;
+    await ensureNodeStartupEnvLoaded({
+        entry: '@zintrust/core/start',
+    });
+    const projectBootstrapModule = (await import('./runtime/ProjectBootstrap.js'));
+    await projectBootstrapModule.loadProjectBootstrap();
+};
+const cloudflareFetch = async (request, env, ctx) => {
+    const worker = await loadCloudflareWorker();
+    if (typeof worker.fetch === 'function') {
+        return worker.fetch(request, env, ctx);
+    }
+    throw createValidationError('Cloudflare worker entry must export a fetch(request, env, ctx) handler.');
+};
+const cloudflareWorker = Object.freeze({
+    fetch: cloudflareFetch,
+});
+const deno = async (request) => {
+    const module = (await import('./functions/deno.js'));
+    return module.default(request);
+};
+const handler = async (event, context) => {
+    const module = (await import('./functions/lambda.js'));
+    return module.handler(event, context);
+};
+/**
+ * Cloudflare Workers entry (module worker style).
+ */
+export default cloudflareWorker;
+export { cloudflareWorker };
+/**
+ * Deno fetch handler.
+ */
+export { deno };
+/**
+ * AWS Lambda handler.
+ */
+export { handler };

package/src/storage-index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage Exports
+ * Provides storage drivers and utilities
+ */
+export { GcsDriver } from './tools/storage/drivers/Gcs.js';
+export { R2Driver } from './tools/storage/drivers/R2.js';
+export { S3Driver } from './tools/storage/drivers/S3.js';
+export { StorageDriverRegistry } from './tools/storage/StorageDriverRegistry.js';
+export { MultipartParserRegistry } from './http/parsers/MultipartParserRegistry.js';
+export type { MultipartFieldValue, MultipartParseInput, MultipartParserProvider, ParsedMultipartData, } from './http/parsers/MultipartParserRegistry.js';
+export type { GcsConfig } from './tools/storage/drivers/Gcs.js';
+export type { R2Config } from './tools/storage/drivers/R2.js';
+export type { S3Config } from './tools/storage/drivers/S3.js';
+//# sourceMappingURL=storage-index.d.ts.map

package/src/storage-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-index.d.ts","sourceRoot":"","sources":["../../src/storage-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC"}

package/src/storage-index.js

@@ -0,0 +1,9 @@
+/**
+ * Storage Exports
+ * Provides storage drivers and utilities
+ */
+export { GcsDriver } from './tools/storage/drivers/Gcs.js';
+export { R2Driver } from './tools/storage/drivers/R2.js';
+export { S3Driver } from './tools/storage/drivers/S3.js';
+export { StorageDriverRegistry } from './tools/storage/StorageDriverRegistry.js';
+export { MultipartParserRegistry } from './http/parsers/MultipartParserRegistry.js';

package/src/tasks.d.ts

@@ -0,0 +1,2 @@
+export { BackgroundTaskScheduler } from './runtime/BackgroundTaskScheduler.js';
+//# sourceMappingURL=tasks.d.ts.map

package/src/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC"}

package/src/tasks.js

@@ -0,0 +1 @@
+export { BackgroundTaskScheduler } from './runtime/BackgroundTaskScheduler.js';

package/src/templates/TemplateRegistry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Template Registry
+ * Maps base framework files to their .tpl template equivalents
+ * Sealed namespace pattern for immutability
+ */
+export interface TemplateMapping {
+    basePath: string;
+    templatePath: string;
+    description: string;
+}
+/**
+ * Sealed namespace providing template registry access
+ */
+export declare const TemplateRegistry: Readonly<{
+    /**
+     * Get all template mappings
+     */
+    getMappings(): TemplateMapping[];
+    /**
+     * Get a specific mapping by base path
+     */
+    getMapping(basePath: string): TemplateMapping | undefined;
+    /**
+     * Get all base file paths
+     */
+    getBasePaths(): string[];
+    /**
+     * Get all template paths
+     */
+    getTemplatePaths(): string[];
+    /**
+     * Validate if a base path is in the registry
+     */
+    isRegistered(basePath: string): boolean;
+    /**
+     * Get count of registered templates
+     */
+    count(): number;
+}>;
+//# sourceMappingURL=TemplateRegistry.d.ts.map

package/src/templates/TemplateRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateRegistry.d.ts","sourceRoot":"","sources":["../../../src/templates/TemplateRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAmCD;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;mBACY,eAAe,EAAE;IAIhC;;OAEG;yBACkB,MAAM,GAAG,eAAe,GAAG,SAAS;IAIzD;;OAEG;oBACa,MAAM,EAAE;IAIxB;;OAEG;wBACiB,MAAM,EAAE;IAI5B;;OAEG;2BACoB,MAAM,GAAG,OAAO;IAIvC;;OAEG;aACM,MAAM;EAGf,CAAC"}

package/src/templates/TemplateRegistry.js

@@ -0,0 +1,78 @@
+/**
+ * Template Registry
+ * Maps base framework files to their .tpl template equivalents
+ * Sealed namespace pattern for immutability
+ */
+const MAPPINGS = [
+    {
+        basePath: 'src/orm/adapters/SQLiteAdapter.ts',
+        templatePath: 'src/templates/adapters/SQLiteAdapter.ts.tpl',
+        description: 'SQLite database adapter',
+    },
+    {
+        basePath: 'src/orm/adapters/PostgreSQLAdapter.ts',
+        templatePath: 'src/templates/adapters/PostgreSQLAdapter.ts.tpl',
+        description: 'PostgreSQL database adapter',
+    },
+    {
+        basePath: 'src/orm/adapters/MySQLAdapter.ts',
+        templatePath: 'src/templates/adapters/MySQLAdapter.ts.tpl',
+        description: 'MySQL database adapter',
+    },
+    {
+        basePath: 'src/orm/adapters/SQLServerAdapter.ts',
+        templatePath: 'src/templates/adapters/SQLServerAdapter.ts.tpl',
+        description: 'SQL Server database adapter',
+    },
+    {
+        basePath: 'src/auth/Auth.ts',
+        templatePath: 'src/templates/auth/Auth.ts.tpl',
+        description: 'Authentication feature with JWT & bcrypt',
+    },
+    {
+        basePath: 'src/features/Queue.ts',
+        templatePath: 'src/templates/features/Queue.ts.tpl',
+        description: 'Job queue feature',
+    },
+];
+/**
+ * Sealed namespace providing template registry access
+ */
+export const TemplateRegistry = Object.freeze({
+    /**
+     * Get all template mappings
+     */
+    getMappings() {
+        return [...MAPPINGS];
+    },
+    /**
+     * Get a specific mapping by base path
+     */
+    getMapping(basePath) {
+        return MAPPINGS.find((m) => m.basePath === basePath);
+    },
+    /**
+     * Get all base file paths
+     */
+    getBasePaths() {
+        return MAPPINGS.map((m) => m.basePath);
+    },
+    /**
+     * Get all template paths
+     */
+    getTemplatePaths() {
+        return MAPPINGS.map((m) => m.templatePath);
+    },
+    /**
+     * Validate if a base path is in the registry
+     */
+    isRegistered(basePath) {
+        return MAPPINGS.some((m) => m.basePath === basePath);
+    },
+    /**
+     * Get count of registered templates
+     */
+    count() {
+        return MAPPINGS.length;
+    },
+});

package/src/templates-index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ZinTrust Templates - Template utilities
+ * Contains template rendering and generation utilities
+ */
+export { MarkdownRenderer } from './tools/templates/index.js';
+//# sourceMappingURL=templates-index.d.ts.map

package/src/templates-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates-index.d.ts","sourceRoot":"","sources":["../../src/templates-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/src/templates-index.js

@@ -0,0 +1,6 @@
+/**
+ * ZinTrust Templates - Template utilities
+ * Contains template rendering and generation utilities
+ */
+// Templates
+export { MarkdownRenderer } from './tools/templates/index.js';

package/src/testing/TestEnvironment.d.ts

@@ -0,0 +1,40 @@
+import { type IServiceContainer } from '../container/ServiceContainer.js';
+import { type IKernel } from '../http/Kernel.js';
+import { type IRouter } from '../routes/Router.js';
+export type TestHeaders = Record<string, string>;
+export type TestRequestInput = {
+    method: string;
+    path: string;
+    headers?: TestHeaders;
+    body?: unknown;
+    validated?: {
+        body?: unknown;
+        query?: unknown;
+        params?: unknown;
+        headers?: unknown;
+    };
+};
+export type TestResponse = {
+    status: number;
+    headers: Record<string, string | string[]>;
+    bodyText: string;
+    json: unknown;
+    cookies: Record<string, string>;
+};
+export type TestEnvironmentOptions = {
+    router?: IRouter;
+    container?: IServiceContainer;
+    registerRoutes?: (router: IRouter) => void;
+};
+export interface ITestEnvironment {
+    router: IRouter;
+    container: IServiceContainer;
+    kernel: IKernel;
+    request(input: TestRequestInput): Promise<TestResponse>;
+    swapSingleton<T>(key: string, instance: T): () => void;
+    swapFactory<T>(key: string, factory: () => T): () => void;
+}
+export declare const TestEnvironment: Readonly<{
+    create(options?: TestEnvironmentOptions): ITestEnvironment;
+}>;
+//# sourceMappingURL=TestEnvironment.d.ts.map

package/src/testing/TestEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestEnvironment.d.ts","sourceRoot":"","sources":["../../../src/testing/TestEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG3D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C,CAAC;AA2HF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IACvD,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC;CAC3D;AAED,eAAO,MAAM,eAAe;qBACV,sBAAsB,GAAQ,gBAAgB;EA6C9D,CAAC"}