@zintrust/core 0.4.67 → 0.4.70

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.67",
+  "version": "0.4.70",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

package/src/boot/bootstrap.js

@@ -9,6 +9,7 @@ import { appConfig } from '../config/app.js';
 import { Cloudflare } from '../config/cloudflare.js';
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
+import { shutdownRedisConnections } from '../config/workers.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { ProjectRuntime } from '../runtime/ProjectRuntime.js';
 import { WorkerProjectAutoImports } from '../runtime/WorkerProjectAutoImports.js';
@@ -152,6 +153,13 @@ const gracefulShutdown = async (signal) => {
                     Logger.warn('App shutdown failed or timed out, forcing exit', error);
                 }
             }
+            try {
+                const redisBudgetMs = Math.max(250, Math.min(3000, remainingMs()));
+                await withTimeout(shutdownRedisConnections(), redisBudgetMs, 'Redis connection shutdown timed out');
+            }
+            catch (error) {
+                Logger.warn('Redis connection shutdown failed (continuing with app shutdown)', error);
+            }
         })(), shutdownBudgetMs, 'Graceful shutdown timed out');
         globalThis.clearTimeout(forceExitTimer);
         process.exit(0);
@@ -284,6 +292,9 @@ const BootstrapFunctions = Object.freeze({
         process.on('SIGINT', async () => {
             await gracefulShutdown('SIGINT');
         });
+        process.on('SIGUSR2', async () => {
+            await gracefulShutdown('SIGUSR2');
+        });
     },
 });
 // Run bootstrap

package/src/cli/commands/MigrateCommand.js

@@ -215,7 +215,7 @@ const warnIfAdapterMissing = (cmd, conn) => {
     if (conn.driver === 'mysql' && DatabaseAdapterRegistry.get('mysql') === undefined) {
         cmd.warn('MySQL adapter is not installed/registered; migrations may not hit a real MySQL DB.');
         cmd.warn('Install via `zin plugin install adapter:mysql` (or `zin add db:mysql`).');
-        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "../../../packages/db-mysql/src/register";');
+        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "@zintrust/db-mysql/register";');
     }
     if (conn.driver === 'postgresql' && DatabaseAdapterRegistry.get('postgresql') === undefined) {
         cmd.warn('PostgreSQL adapter is not installed/registered; migrations may not hit a real PostgreSQL DB.');

package/src/config/workers.d.ts

@@ -7,6 +7,7 @@ import { type RedisTransportOptions } from '../tools/redis/RedisTransport';
 import type { RedisConfig, WorkersGlobalConfig } from './type';
 import type IORedis from 'ioredis';
 export declare const createRedisConnection: (config: RedisConfig, maxRetries?: number, options?: RedisTransportOptions) => IORedis;
+export declare const shutdownRedisConnections: () => Promise<void>;
 declare const createWorkersConfig: () => WorkersGlobalConfig;
 export type WorkersConfig = ReturnType<typeof createWorkersConfig>;
 export declare const workersConfig: WorkersConfig;

package/src/config/workers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/config/workers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EACV,WAAW,EAIX,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAoMnC,eAAO,MAAM,qBAAqB,GAChC,QAAQ,WAAW,EACnB,mBAAc,EACd,UAAU,qBAAqB,KAC9B,OA6BF,CAAC;AAgFF,QAAA,MAAM,mBAAmB,QAAO,mBA2D/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAqBnE,eAAO,MAAM,aAAa,EAAE,aAY1B,CAAC"}
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/config/workers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EACV,WAAW,EAIX,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAiTnC,eAAO,MAAM,qBAAqB,GAChC,QAAQ,WAAW,EACnB,mBAAc,EACd,UAAU,qBAAqB,KAC9B,OA6CF,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CA4B7D,CAAC;AAgFF,QAAA,MAAM,mBAAmB,QAAO,mBA2D/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAqBnE,eAAO,MAAM,aAAa,EAAE,aAY1B,CAAC"}

package/src/config/workers.js

@@ -12,6 +12,78 @@ import { createRequire } from '../node-singletons/module.js';
 import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 let redisModule;
 let warnedRedisProxyMismatch = false;
+const getRedisConnectionRegistry = () => {
+    const registryGlobal = globalThis;
+    registryGlobal.__zintrustRedisConnectionRegistry__ ??= {
+        activeConnections: new Set(),
+        cachedConnections: new Map(),
+    };
+    return registryGlobal.__zintrustRedisConnectionRegistry__;
+};
+const unregisterRedisConnection = (client) => {
+    const registry = getRedisConnectionRegistry();
+    registry.activeConnections.delete(client);
+    const registryKey = client.__zintrustRedisRegistryKey__;
+    if (registryKey !== undefined && registry.cachedConnections.get(registryKey) === client) {
+        registry.cachedConnections.delete(registryKey);
+    }
+};
+const hasReusableRedisStatus = (client) => {
+    return client.status !== 'end' && client.status !== 'close';
+};
+const shouldCacheRedisConnection = (isWorkersRuntime, options) => {
+    const subsystem = options?.subsystem?.trim() ?? '';
+    if (subsystem === '')
+        return false;
+    if (isWorkersRuntime)
+        return false;
+    return Env.NODE_ENV !== 'production';
+};
+const createRedisConnectionCacheKey = (config, maxRetries, options) => {
+    return JSON.stringify({
+        subsystem: options?.subsystem?.trim() ?? 'redis',
+        host: config.host,
+        port: config.port,
+        db: config.db,
+        password: config.password ?? '',
+        maxRetries,
+    });
+};
+const trackRedisConnection = (client, registryKey) => {
+    const managedClient = client;
+    const registry = getRedisConnectionRegistry();
+    registry.activeConnections.add(managedClient);
+    if (registryKey !== undefined) {
+        managedClient.__zintrustRedisRegistryKey__ = registryKey;
+        registry.cachedConnections.set(registryKey, managedClient);
+    }
+    if (managedClient.__zintrustRedisLifecycleManaged__ === true) {
+        return managedClient;
+    }
+    managedClient.__zintrustRedisLifecycleManaged__ = true;
+    const originalQuit = typeof managedClient.quit === 'function' ? managedClient.quit.bind(managedClient) : undefined;
+    if (originalQuit) {
+        managedClient.quit = async (...args) => {
+            unregisterRedisConnection(managedClient);
+            return originalQuit(...args);
+        };
+    }
+    const originalDisconnect = typeof managedClient.disconnect === 'function'
+        ? managedClient.disconnect.bind(managedClient)
+        : undefined;
+    if (originalDisconnect) {
+        managedClient.disconnect = (...args) => {
+            unregisterRedisConnection(managedClient);
+            return originalDisconnect(...args);
+        };
+    }
+    const clearConnection = () => {
+        unregisterRedisConnection(managedClient);
+    };
+    managedClient.on?.('end', clearConnection);
+    managedClient.on?.('close', clearConnection);
+    return managedClient;
+};
 const parseHttpProxyEndpoint = (proxyUrl) => {
     try {
         const url = new URL(proxyUrl);
@@ -159,6 +231,19 @@ export const createRedisConnection = (config, maxRetries = 3, options) => {
     const proxySettings = getProxySettings();
     const effectiveConfig = resolveEffectiveRedisConfig(config, isWorkersRuntime, proxySettings);
     validateRedisConfig(config, effectiveConfig, isWorkersRuntime, proxySettings);
+    const shouldCache = shouldCacheRedisConnection(isWorkersRuntime, options);
+    const cacheKey = shouldCache
+        ? createRedisConnectionCacheKey(effectiveConfig, maxRetries, options)
+        : undefined;
+    if (cacheKey !== undefined) {
+        const cachedClient = getRedisConnectionRegistry().cachedConnections.get(cacheKey);
+        if (cachedClient && hasReusableRedisStatus(cachedClient)) {
+            return cachedClient;
+        }
+        if (cachedClient) {
+            unregisterRedisConnection(cachedClient);
+        }
+    }
     const RedisCtor = resolveRedisConstructor();
     const client = new RedisCtor({
         host: effectiveConfig.host,
@@ -173,7 +258,32 @@ export const createRedisConnection = (config, maxRetries = 3, options) => {
         },
     });
     setupRedisErrorHandler(client);
-    return client;
+    return trackRedisConnection(client, cacheKey);
+};
+export const shutdownRedisConnections = async () => {
+    const registry = getRedisConnectionRegistry();
+    const trackedConnections = Array.from(registry.activeConnections);
+    if (trackedConnections.length === 0)
+        return;
+    registry.activeConnections.clear();
+    registry.cachedConnections.clear();
+    Logger.info('Shutting down tracked Redis connections', {
+        count: trackedConnections.length,
+    });
+    await Promise.allSettled(trackedConnections.map(async (client) => {
+        try {
+            await client.quit();
+        }
+        catch (error) {
+            Logger.warn('Tracked Redis graceful shutdown failed, forcing disconnect', error);
+            try {
+                client.disconnect();
+            }
+            catch (disconnectError) {
+                Logger.error('Tracked Redis forced disconnect failed', disconnectError);
+            }
+        }
+    }));
 };
 const createIntervalConfig = () => Env.SSE_SNAPSHOT_INTERVAL;
 /**

package/src/functions/cloudflare.d.ts

@@ -2,5 +2,9 @@ declare const _default: {
     fetch(request: Request, _env: unknown, _ctx: unknown): Promise<Response>;
 };
 export default _default;
-export { ZintrustSocketHub } from '@zintrust/socket';
+export declare class ZintrustSocketHub {
+    private readonly delegate;
+    constructor(state: unknown, env: unknown);
+    fetch(request: Request): Promise<Response>;
+}
 //# sourceMappingURL=cloudflare.d.ts.map

package/src/functions/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/functions/cloudflare.ts"],"names":[],"mappings":";mBAiOuB,OAAO,QAAQ,OAAO,QAAQ,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADhF,wBA+CE;AAEF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/functions/cloudflare.ts"],"names":[],"mappings":";mBA+OuB,OAAO,QAAQ,OAAO,QAAQ,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADhF,wBA+CE;AAGF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;gBAExC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO;IAKlC,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAkBjD"}

package/src/functions/cloudflare.js

@@ -172,6 +172,9 @@ const ensureStartupConfigOverridesLoaded = async () => {
     startupConfigOverridesPromise ??= applyStartupConfigOverrides();
     await startupConfigOverridesPromise;
 };
+const getRegisteredSocketHubClass = () => {
+    return globalThis.__zintrustSocketHubClass;
+};
 export default {
     async fetch(request, _env, _ctx) {
         try {
@@ -215,4 +218,25 @@ export default {
         }
     },
 };
-export { ZintrustSocketHub } from '@zintrust/socket';
+// eslint-disable-next-line no-restricted-syntax -- Cloudflare Durable Objects require class exports.
+export class ZintrustSocketHub {
+    delegate;
+    constructor(state, env) {
+        const HubClass = getRegisteredSocketHubClass();
+        this.delegate = HubClass ? new HubClass(state, env) : null;
+    }
+    async fetch(request) {
+        if (this.delegate !== null) {
+            return this.delegate.fetch(request);
+        }
+        return new Response(JSON.stringify({
+            error: 'socket_runtime_unavailable',
+            message: 'Socket durable object support requires the optional @zintrust/socket package.',
+        }), {
+            status: 503,
+            headers: {
+                'content-type': 'application/json',
+            },
+        });
+    }
+}

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.67
+ * @zintrust/core v0.4.70
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-06T10:02:30.824Z
+ *   Built: 2026-04-06T16:03:35.272Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-04-06T10:02:30.746Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-06T16:03:35.239Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/zintrust.plugins.d.ts

@@ -1,12 +1,8 @@
 /**
- * ZinTrust plugin auto-imports
- *
- * In real projects, this file is managed by `zin plugin install` and contains
- * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
- * optional adapters/drivers into core registries.
- *
+ * Auto-generated fallback module.
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
  */
-export type {};
 export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";
 declare const _default: {};
 export default _default;

package/src/zintrust.plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}
+{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}

package/src/zintrust.plugins.js

@@ -1,13 +1,7 @@
 /**
- * ZinTrust plugin auto-imports
- *
- * In real projects, this file is managed by `zin plugin install` and contains
- * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
- * optional adapters/drivers into core registries.
- *
+ * Auto-generated fallback module.
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
  */
-import * as SystemDebuggerRuntime from './runtime/plugins/system-debugger-runtime.js';
-globalThis.__zintrust_system_debugger_plugin_requested__ = true;
-globalThis.__zintrust_system_debugger_runtime__ = SystemDebuggerRuntime;
 export const __zintrustGeneratedPluginStub = 'zintrust.plugins.ts';
 export default {};

package/src/zintrust.plugins.wg.d.ts

@@ -3,7 +3,6 @@
  * This file is created by scripts/ensure-worker-plugins.mjs when missing.
  * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
  */
-export type {};
 export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.wg.ts";
 declare const _default: {};
 export default _default;

package/src/zintrust.plugins.wg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust.plugins.wg.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.wg.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;;AACtE,wBAAkB"}
+{"version":3,"file":"zintrust.plugins.wg.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.wg.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;;AACtE,wBAAkB"}

package/src/zintrust.plugins.wg.js

@@ -3,8 +3,5 @@
  * This file is created by scripts/ensure-worker-plugins.mjs when missing.
  * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
  */
-import * as SystemDebuggerRuntime from './runtime/plugins/system-debugger-runtime.js';
-globalThis.__zintrust_system_debugger_plugin_requested__ = true;
-globalThis.__zintrust_system_debugger_runtime__ = SystemDebuggerRuntime;
 export const __zintrustGeneratedPluginStub = 'zintrust.plugins.wg.ts';
 export default {};

package/src/zintrust.comon.d.ts

@@ -1,11 +0,0 @@
-import '../packages/db-d1/src/register.js';
-import '../packages/db-mysql/src/register.js';
-import '../packages/db-postgres/src/register.js';
-import '../packages/db-sqlite/src/register.js';
-import '../packages/db-sqlserver/src/register.js';
-import '../packages/mail-sendgrid/src/register.js';
-import '../packages/mail-smtp/src/register.js';
-import '@zintrust/queue-monitor';
-import '../packages/queue-redis/src/register.js';
-import '../packages/workers/src/register.js';
-//# sourceMappingURL=zintrust.comon.d.ts.map

package/src/zintrust.comon.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zintrust.comon.d.ts","sourceRoot":"","sources":["../../src/zintrust.comon.ts"],"names":[],"mappings":"AAQA,OAAO,mCAAmC,CAAC;AAC3C,OAAO,sCAAsC,CAAC;AAC9C,OAAO,yCAAyC,CAAC;AACjD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,0CAA0C,CAAC;AAClD,OAAO,2CAA2C,CAAC;AACnD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,wCAAwC,CAAC;AAChD,OAAO,yCAAyC,CAAC;AACjD,OAAO,qCAAqC,CAAC"}

package/src/zintrust.comon.js

@@ -1,17 +0,0 @@
-/* eslint-disable no-restricted-imports */
-// /**
-//  * ZinTrust comon plugin auto-imports
-//  *
-//  * This file is managed by `zin plugin install` and contains side-effect
-//  * imports that register optional adapters/drivers into core registries.
-//  */
-import '../packages/db-d1/src/register.js';
-import '../packages/db-mysql/src/register.js';
-import '../packages/db-postgres/src/register.js';
-import '../packages/db-sqlite/src/register.js';
-import '../packages/db-sqlserver/src/register.js';
-import '../packages/mail-sendgrid/src/register.js';
-import '../packages/mail-smtp/src/register.js';
-import '@zintrust/queue-monitor';
-import '../packages/queue-redis/src/register.js';
-import '../packages/workers/src/register.js';