@zintrust/core 0.4.86 → 0.4.87

package/package.json

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

package/src/boot/registry/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2O9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AAqUF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAyF7D,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2O9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AAsUF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAyF7D,CAAC"}

package/src/boot/registry/runtime.js

@@ -440,7 +440,8 @@ const initializeSystemTrace = async (router) => {
         Logger.info(`System Trace dashboard auto-mounted at ${basePath}.`);
     }
     catch (error) {
-        Logger.warn('Failed to initialize System Trace runtime', error);
+        Logger.error('Failed to initialize System Trace runtime', error);
+        throw error;
     }
 };
 const initializeSockets = (router) => {

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 "@zintrust/db-mysql/register";');
+        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "../../../packages/db-mysql/src/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/cli/utils/spawn.d.ts

@@ -4,6 +4,7 @@ export interface SpawnAndWaitInput {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
     forwardSignals?: boolean;
+    shell?: boolean;
 }
 export declare const SpawnUtil: Readonly<{
     spawnAndWait(input: SpawnAndWaitInput): Promise<number>;

package/src/cli/utils/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA0CD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EA+E7D,CAAC"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0CD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EAiF7D,CAAC"}

package/src/cli/utils/spawn.js

@@ -42,11 +42,12 @@ const buildCommandNotFoundMessage = (command) => {
 export const SpawnUtil = Object.freeze({
     async spawnAndWait(input) {
         const cwd = input.cwd ?? process.cwd();
-        const resolvedCommand = resolveLocalBin(input.command, cwd);
+        const resolvedCommand = input.shell === true ? input.command : resolveLocalBin(input.command, cwd);
         const child = spawn(resolvedCommand, input.args, {
             cwd,
             env: input.env ?? appConfig.getSafeEnv(),
             stdio: 'inherit',
+            shell: input.shell === true,
         });
         // In interactive shells, the foreground process group already receives SIGINT
         // (and often SIGTERM) so forwarding can cause duplicates. `tsx watch` is

package/src/http/middleware/FileUploadMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUploadMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/FileUploadMiddleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAW9D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,UA8DlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"FileUploadMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/FileUploadMiddleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAW9D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,UA8DlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/src/http/middleware/FileUploadMiddleware.js

@@ -4,6 +4,7 @@
  */
 import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { MultipartParser } from '../parsers/MultipartParser.js';
 import { MultipartParserRegistry } from '../parsers/MultipartParserRegistry.js';
 /**
@@ -19,7 +20,7 @@ const getContentType = (req) => {
  * File upload middleware
  * Automatically parses multipart/form-data and makes files available
  */
-export const fileUploadMiddleware = async (req, res, next) => {
+export const fileUploadMiddleware = async (req, _res, next) => {
     const contentType = getContentType(req);
     // Only process multipart/form-data requests
     if (!MultipartParser.isMultipart(contentType)) {
@@ -29,10 +30,10 @@ export const fileUploadMiddleware = async (req, res, next) => {
     // Phase 4 default behavior: multipart requires external streaming parser.
     const provider = MultipartParserRegistry.get();
     if (provider === null) {
-        res.setStatus(415).json({
-            error: 'multipart/form-data not supported. Install @zintrust/storage to enable uploads.',
+        throw ErrorFactory.createConfigError('Multipart upload parser is not configured.', {
+            contentType,
+            hint: 'Install @zintrust/storage to enable multipart/form-data uploads.',
         });
-        return;
     }
     try {
         const maxFileSizeBytes = Env.getInt('MAX_FILE_SIZE', 50 * 1024 * 1024);

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.86
+ * @zintrust/core v0.4.87
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-09T08:00:41.050Z
+ *   Built: 2026-04-09T17:36:11.089Z
  *   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-09T08:00:41.015Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-09T17:36:11.024Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/microservices/MicroserviceBootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MicroserviceBootstrap.d.ts","sourceRoot":"","sources":["../../../src/microservices/MicroserviceBootstrap.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC;QACjC,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QAChD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,IAAI,MAAM,CAAC;IACzB,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC1E,oBAAoB,IAAI,aAAa,EAAE,CAAC;IACxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACxD,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAgFD;;GAEG;AACH,eAAO,MAAM,qBAAqB;mBAEf,sBAAsB;aAC5B,IAAI;cACH,sBAAsB;CA8GjC,CAAC;AAyKJ;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAGrD;AAED,eAAO,MAAM,mBAAmB;;;;;;CAM/B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"MicroserviceBootstrap.d.ts","sourceRoot":"","sources":["../../../src/microservices/MicroserviceBootstrap.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC;QACjC,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QAChD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,IAAI,MAAM,CAAC;IACzB,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC1E,oBAAoB,IAAI,aAAa,EAAE,CAAC;IACxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACxD,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AA+ED;;GAEG;AACH,eAAO,MAAM,qBAAqB;mBAEf,sBAAsB;aAC5B,IAAI;cACH,sBAAsB;CA8GjC,CAAC;AAuKJ;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAGrD;AAED,eAAO,MAAM,mBAAmB;;;;;;CAM/B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/src/microservices/MicroserviceBootstrap.js

@@ -2,7 +2,7 @@ import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { MicroserviceManager, getEnabledServices, isMicroservicesEnabled, } from './MicroserviceManager.js';
 import { getServiceId, serviceMatchesAllowList, } from './ServiceManifest.js';
-import fs from '../node-singletons/fs.js';
+import fs, { fsPromises } from '../node-singletons/fs.js';
 import * as path from '../node-singletons/path.js';
 import { ProjectRuntime } from '../runtime/ProjectRuntime.js';
 const projectCwd = process.cwd();
@@ -19,12 +19,12 @@ async function runDiscoverServices(state) {
             Logger.info(`✅ Discovered ${manifestServices.length} microservices from static manifest`);
             return manifestServices;
         }
-        const domains = getDomains(state.servicesDir);
-        const services = [];
-        for (const domain of domains) {
-            const domainServices = discoverServicesInDomain(state, domain, services.length);
-            services.push(...domainServices);
-        }
+        const domains = await getDomains(state.servicesDir);
+        const services = await domains.reduce(async (pending, domain) => {
+            const discovered = await pending;
+            const domainServices = await discoverServicesInDomain(state, domain, discovered.length);
+            return [...discovered, ...domainServices];
+        }, Promise.resolve([]));
         Logger.info(`✅ Discovered ${services.length} microservices`);
         return services;
     }
@@ -186,13 +186,11 @@ async function discoverServicesFromManifest(state) {
 /**
  * Get all domains in services directory
  */
-function getDomains(servicesDir) {
+async function getDomains(servicesDir) {
     if (!fs.existsSync(servicesDir))
         return [];
-    return fs.readdirSync(servicesDir).filter((file) => {
-        const filePath = path.join(servicesDir, file);
-        return fs.statSync(filePath).isDirectory();
-    });
+    const entries = await fsPromises.readdir(servicesDir, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
 }
 /**
  * Check if a service is enabled via environment
@@ -203,8 +201,8 @@ function isServiceEnabled(serviceName, enabledServices) {
 /**
  * Load service configuration from file
  */
-function loadServiceConfig(domain, serviceName, configPath, index) {
-    const configData = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+async function loadServiceConfig(domain, serviceName, configPath, index) {
+    const configData = JSON.parse(await fsPromises.readFile(configPath, 'utf-8'));
     return {
         id: getServiceId(domain, serviceName),
         name: serviceName,
@@ -255,33 +253,30 @@ function createServiceConfigFromManifest(entry, index) {
 /**
  * Try to load service configuration if it exists
  */
-function tryLoadServiceConfig(state, domain, serviceName, domainPath, index) {
+async function tryLoadServiceConfig(state, domain, serviceName, domainPath, index) {
     const configPath = path.join(domainPath, serviceName, 'service.config.json');
     if (!fs.existsSync(configPath))
         return null;
-    const config = loadServiceConfig(domain, serviceName, configPath, index);
+    const config = await loadServiceConfig(domain, serviceName, configPath, index);
     state.serviceConfigs.set(getServiceKey(domain, serviceName), config);
     return config;
 }
 /**
  * Discover all services within a specific domain
  */
-function discoverServicesInDomain(state, domain, startIndex) {
+async function discoverServicesInDomain(state, domain, startIndex) {
     const domainPath = path.join(state.servicesDir, domain);
-    const serviceNames = fs.readdirSync(domainPath).filter((file) => {
-        const filePath = path.join(domainPath, file);
-        return fs.statSync(filePath).isDirectory() && file !== 'shared';
-    });
-    const services = [];
+    const entries = await fsPromises.readdir(domainPath, { withFileTypes: true });
+    const serviceNames = entries
+        .filter((entry) => entry.isDirectory() && entry.name !== 'shared')
+        .map((entry) => entry.name);
     const enabledServices = getEnabledServices();
-    for (const serviceName of serviceNames) {
-        if (isServiceEnabled(serviceName, enabledServices)) {
-            const config = tryLoadServiceConfig(state, domain, serviceName, domainPath, startIndex + services.length);
-            if (config)
-                services.push(config);
-        }
-    }
-    return services;
+    const eligibleServiceNames = serviceNames.filter((serviceName) => isServiceEnabled(serviceName, enabledServices));
+    // Pre-filter to services that actually have config files so that the index
+    // used for default port assignment (3001 + index) stays contiguous and stable.
+    const servicesWithConfig = eligibleServiceNames.filter((serviceName) => fs.existsSync(path.join(domainPath, serviceName, 'service.config.json')));
+    const services = await Promise.all(servicesWithConfig.map(async (serviceName, index) => tryLoadServiceConfig(state, domain, serviceName, domainPath, startIndex + index)));
+    return services.filter((config) => config !== null);
 }
 /**
  * Handle discovery errors gracefully

package/src/microservices/PostgresAdapter.d.ts

@@ -59,6 +59,12 @@ export interface IPostgresAdapter {
     }>): Promise<void>;
     healthCheck(): Promise<boolean>;
 }
+export interface IPostgresAdapterManager {
+    getInstance(config: PostgresPoolConfig, key?: string): IPostgresAdapter;
+    getAllInstances(): IPostgresAdapter[];
+    releaseInstance(key: string): Promise<void>;
+    disconnectAll(): Promise<void>;
+}
 /**
  * PostgreSQL Adapter with Connection Pooling
  * Supports both shared (multi-service) and isolated (per-service) database modes
@@ -77,14 +83,14 @@ export declare function getInstance(config: PostgresPoolConfig, key?: string): I
  * Get all instances
  */
 export declare function getAllInstances(): IPostgresAdapter[];
+/**
+ * Disconnect and release a single cached adapter instance.
+ */
+export declare function releaseInstance(key: string): Promise<void>;
 /**
  * Disconnect all instances
  */
 export declare function disconnectAll(): Promise<void>;
-export declare const PostgresAdapterManager: Readonly<{
-    getInstance: typeof getInstance;
-    getAllInstances: typeof getAllInstances;
-    disconnectAll: typeof disconnectAll;
-}>;
+export declare const PostgresAdapterManager: IPostgresAdapterManager;
 export default PostgresAdapter;
 //# sourceMappingURL=PostgresAdapter.d.ts.map

package/src/microservices/PostgresAdapter.d.ts.map

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

package/src/microservices/PostgresAdapter.js

@@ -291,6 +291,17 @@ export function getInstance(config, key = 'default') {
 export function getAllInstances() {
     return Array.from(instances.values());
 }
+/**
+ * Disconnect and release a single cached adapter instance.
+ */
+export async function releaseInstance(key) {
+    const adapter = instances.get(key);
+    if (adapter === undefined) {
+        return;
+    }
+    await adapter.disconnectAll();
+    instances.delete(key);
+}
 /**
  * Disconnect all instances
  */
@@ -301,6 +312,7 @@ export async function disconnectAll() {
 export const PostgresAdapterManager = Object.freeze({
     getInstance,
     getAllInstances,
+    releaseInstance,
     disconnectAll,
 });
 export default PostgresAdapter;

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

@@ -1 +1 @@
-{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgShE,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAsRhE,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}

package/src/runtime/PluginManager.js

@@ -8,7 +8,6 @@ import { readEnvString } from '../common/ExternalServiceUtils.js';
 import { esmDirname, resolvePackageManager } from '../common/index.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
-import { execSync } from '../node-singletons/child-process.js';
 import { existsSync, fsPromises as fs } from '../node-singletons/fs.js';
 import * as path from '../node-singletons/path.js';
 import { PluginRegistry } from './PluginRegistry.js';
@@ -92,21 +91,6 @@ async function npmInstall(packages, options) {
     Logger.info(`Installing ${options.label}: ${packages.join(', ')}...`);
     const projectRoot = options.projectRoot ?? resolveProjectRoot();
     const pm = options.packageManager ?? resolvePackageManager();
-    // Legacy behavior: npm uses execSync in this framework.
-    // This keeps behavior predictable for CI/test environments and matches existing unit tests.
-    if (pm === 'npm') {
-        const cmd = options.dev
-            ? `npm install -D ${packages.join(' ')}`
-            : `npm install ${packages.join(' ')}`;
-        try {
-            execSync(cmd, { cwd: projectRoot, stdio: 'inherit' });
-            return;
-        }
-        catch (error) {
-            ErrorFactory.createCliError(`Failed to install ${options.label}`, { error });
-            throw error;
-        }
-    }
     let cmd;
     let args = [];
     switch (pm) {
@@ -217,7 +201,7 @@ async function ensurePluginAutoImports(plugin) {
     const next = lines.join('\n') + '\n';
     await fs.writeFile(pluginFile, next, 'utf-8');
 }
-function runPostInstall(plugin) {
+async function runPostInstall(plugin) {
     if (!plugin.postInstall)
         return;
     const projectRoot = resolveProjectRoot();
@@ -227,14 +211,20 @@ function runPostInstall(plugin) {
         const allow = getAllowPostInstallEnv() === '1';
         if (allow) {
             Logger.info(`Running post-install command: ${plugin.postInstall.command}...`);
+            let exit;
             try {
-                execSync(plugin.postInstall.command, {
-                    stdio: 'inherit',
+                exit = await SpawnUtil.spawnAndWait({
+                    command: plugin.postInstall.command,
+                    args: [],
                     cwd: projectRoot,
+                    shell: true,
                 });
             }
             catch (error) {
-                ErrorFactory.createCliError('Post-install command failed', { error });
+                throw ErrorFactory.createCliError('Post-install command failed', { error });
+            }
+            if (exit !== 0) {
+                throw ErrorFactory.createCliError('Post-install command failed', { exit });
             }
         }
         else {
@@ -332,8 +322,8 @@ export const PluginManager = Object.freeze({
         await copyPluginTemplates(plugin);
         // 2b. Ensure plugin-side effects are imported by the project
         await ensurePluginAutoImports(plugin);
-        // 3. Post-Install (still executed via execSync - opt-in)
-        runPostInstall(plugin);
+        // 3. Post-Install (opt-in, async to avoid blocking the event loop)
+        await runPostInstall(plugin);
         Logger.info(`✓ Plugin ${plugin.name} installed successfully`);
     },
     /**

package/src/zintrust.comon.d.ts

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,17 @@
+/* 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';

package/src/zintrust.plugins.d.ts

@@ -1,7 +1,10 @@
 /**
- * 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.
+ * 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.
+ *
  */
 export type {};
 export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";

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;;;;GAIG;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;;;;;;;GAOG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}

package/src/zintrust.plugins.js

@@ -1,7 +1,10 @@
 /**
- * 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.
+ * 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.
+ *
  */
 import * as TraceRuntime from './runtime/plugins/trace-runtime.js';
 globalThis.__zintrust_system_trace_plugin_requested__ = true;