@zintrust/core 0.4.26 → 0.4.28

package/src/cli/utils/DistPackager.d.ts

@@ -1,7 +1,7 @@
 export declare const DistPackager: Readonly<{
     /**
-     * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`.
-     * This is intended for local dev/simulate apps, not publishing.
+    * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`
+    * without clobbering the publishable package manifest.
      */
     prepare(distPath: string, rootPath?: string): void;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"DistPackager.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DistPackager.ts"],"names":[],"mappings":"AAsLA,eAAO,MAAM,YAAY;IACvB;;;OAGG;sBACe,MAAM,aAAY,MAAM,GAAmB,IAAI;EAgBjE,CAAC"}
+{"version":3,"file":"DistPackager.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DistPackager.ts"],"names":[],"mappings":"AAmKA,eAAO,MAAM,YAAY;IACvB;;;OAGG;sBACe,MAAM,aAAY,MAAM,GAAmB,IAAI;EAgBjE,CAAC"}

package/src/cli/utils/DistPackager.js

@@ -30,7 +30,6 @@ const buildDistPackageJson = (rootPkg) => {
     return {
         name,
         version,
-        private: true,
         type: 'module',
         main: './index.js',
         types: './index.d.ts',
@@ -57,6 +56,10 @@ const buildDistPackageJson = (rootPkg) => {
                 types: './src/proxy.d.ts',
                 default: './src/proxy.js',
             },
+            './proxy/*': {
+                types: './src/proxy/*.d.ts',
+                default: './src/proxy/*.js',
+            },
             './collections': {
                 types: './src/collections/index.d.ts',
                 default: './src/collections/index.js',
@@ -76,6 +79,9 @@ const buildDistPackageJson = (rootPkg) => {
             './package.json': './package.json',
         },
         dependencies: coerceDependencies(rootPkg.dependencies),
+        publishConfig: {
+            access: 'public',
+        },
     };
 };
 const writeDistEntrypoints = (distPath) => {
@@ -110,8 +116,8 @@ const warnIfMissingDistArtifacts = (distPath) => {
 };
 export const DistPackager = Object.freeze({
     /**
-     * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`.
-     * This is intended for local dev/simulate apps, not publishing.
+    * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`
+    * without clobbering the publishable package manifest.
      */
     prepare(distPath, rootPath = process.cwd()) {
         if (!fs.existsSync(distPath)) {

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.26
+ * @zintrust/core v0.4.28
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-28T10:16:07.129Z
+ *   Built: 2026-03-29T11:38:07.594Z
  *   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-03-28T10:16:07.099Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-29T11:38:07.522Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/proxy.d.ts

@@ -1,4 +1,6 @@
 export { ErrorHandler } from './proxy/ErrorHandler';
 export { RequestValidator } from './proxy/RequestValidator';
 export { SigningService } from './proxy/SigningService';
+export { ZintrustD1Proxy } from './proxy/d1/ZintrustD1Proxy';
+export { ZintrustKvProxy } from './proxy/kv/ZintrustKvProxy';
 //# sourceMappingURL=proxy.d.ts.map

package/src/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/src/proxy.js

@@ -1,3 +1,5 @@
 export { ErrorHandler } from './proxy/ErrorHandler.js';
 export { RequestValidator } from './proxy/RequestValidator.js';
 export { SigningService } from './proxy/SigningService.js';
+export { ZintrustD1Proxy } from './proxy/d1/ZintrustD1Proxy.js';
+export { ZintrustKvProxy } from './proxy/kv/ZintrustKvProxy.js';

package/src/runtime/WorkerProjectAutoImports.d.ts

@@ -0,0 +1,14 @@
+type ImportResult = {
+    ok: true;
+    loadedPath: string;
+} | {
+    ok: false;
+    loadedPath?: string;
+    reason: 'not-found' | 'import-failed';
+    errorMessage?: string;
+};
+export declare const WorkerProjectAutoImports: Readonly<{
+    tryImportProjectWorkerEntrypoint(): Promise<ImportResult>;
+}>;
+export {};
+//# sourceMappingURL=WorkerProjectAutoImports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerProjectAutoImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkerProjectAutoImports.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA6BN,eAAO,MAAM,wBAAwB;wCACO,OAAO,CAAC,YAAY,CAAC;EA0C/D,CAAC"}

package/src/runtime/WorkerProjectAutoImports.js

@@ -0,0 +1,63 @@
+import { Logger } from '../config/logger.js';
+import { existsSync } from '../node-singletons/fs.js';
+import * as path from '../node-singletons/path.js';
+import { pathToFileURL } from '../node-singletons/url.js';
+const resolveProjectRoot = () => {
+    const projectRoot = String(process.env['ZINTRUST_PROJECT_ROOT'] ?? '').trim();
+    return projectRoot.length > 0 ? projectRoot : process.cwd();
+};
+const getCandidates = (projectRoot) => {
+    return [
+        path.join(projectRoot, 'src', 'zintrust.workers.ts'),
+        path.join(projectRoot, 'dist', 'src', 'zintrust.workers.js'),
+        path.join(projectRoot, 'src', 'zintrust.workers.js'),
+    ];
+};
+const invokeWorkerEntrypoint = async (mod) => {
+    let registerWorkers = null;
+    if (typeof mod['registerWorkers'] === 'function') {
+        registerWorkers = mod['registerWorkers'];
+    }
+    else if (typeof mod['default'] === 'function') {
+        registerWorkers = mod['default'];
+    }
+    if (registerWorkers !== null) {
+        await registerWorkers();
+    }
+};
+export const WorkerProjectAutoImports = Object.freeze({
+    async tryImportProjectWorkerEntrypoint() {
+        const candidates = getCandidates(resolveProjectRoot()).filter((candidate) => existsSync(candidate));
+        if (candidates.length === 0) {
+            return { ok: false, reason: 'not-found' };
+        }
+        let firstFailure = null;
+        for (const candidate of candidates) {
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                const mod = (await import(pathToFileURL(candidate).href));
+                // eslint-disable-next-line no-await-in-loop
+                await invokeWorkerEntrypoint(mod);
+                return { ok: true, loadedPath: candidate };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                Logger.debug('[workers] Project worker entrypoint import failed', {
+                    candidate,
+                    errorMessage,
+                });
+                firstFailure ??= {
+                    ok: false,
+                    loadedPath: candidate,
+                    reason: 'import-failed',
+                    errorMessage,
+                };
+            }
+        }
+        return (firstFailure ?? {
+            ok: false,
+            reason: 'import-failed',
+            errorMessage: 'All worker entrypoint candidates failed',
+        });
+    },
+});

package/src/templates/project/basic/app/Workers/ExampleWorker.ts.tpl

@@ -0,0 +1,17 @@
+import { Logger } from '@zintrust/core';
+
+export const workerDefinition = Object.freeze({
+  name: 'example-worker',
+  queueName: 'example-worker',
+  version: '1.0.0',
+  autoStart: false,
+  activeStatus: true,
+  concurrency: 1,
+  processorSpec: 'app/Workers/ExampleWorker.ts',
+});
+
+export async function ZinTrustProcessor(payload: unknown): Promise<void> {
+  Logger.info('Example worker processed job', { payload });
+}
+
+export default ZinTrustProcessor;

package/src/templates/project/basic/package.json.tpl

@@ -13,7 +13,7 @@
   "dependencies": {
     "@zintrust/core": "^{{coreVersion}}",
     "@zintrust/d1-migrator": "^0.4.6",
-    "@zintrust/governance": "^0.1.25"
+    "@zintrust/governance": "{{governanceVersion}}"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",

package/src/templates/project/basic/src/zintrust.workers.ts.tpl

@@ -0,0 +1,11 @@
+/**
+ * Optional ZinTrust worker bootstrap.
+ *
+ * Docker worker containers and worker CLI commands auto-load this file when it exists.
+ * For simple code-first workers that export `workerDefinition`, you usually do not need to
+ * update this file after scaffolding. Keep it for advanced pre-registration or grouped imports.
+ */
+
+import '@app/Workers/ExampleWorker';
+
+export const __zintrustGeneratedWorkerStub = 'zintrust.workers.ts';

package/src/zintrust.comon.d.ts

@@ -0,0 +1,9 @@
+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 '../packages/queue-redis/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,yCAAyC,CAAC"}

package/src/zintrust.comon.js

@@ -0,0 +1,15 @@
+/* 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 '../packages/queue-redis/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 declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";
 declare const _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;;;;GAIG;AAEH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}
+{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}

package/src/zintrust.plugins.js

@@ -1,7 +1,31 @@
 /**
- * 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.
+ *
  */
+// Example: pre-register persisted worker processorSpec mappings.
+// Uncomment and adapt to your project as needed.
+//
+// import { ZinTrustProcessor } from '../app/Workers/AdvancEmailWorker';
+// import { WorkerFactory, type WorkerFactoryConfig } from '@zintrust/workers';
+//
+// type PreRegisteredProcessorSpec = {
+//   processorSpec: string;
+//   processor: WorkerFactoryConfig['processor'];
+// };
+//
+// export const preRegisteredWorkerProcessorSpecs: ReadonlyArray<PreRegisteredProcessorSpec> = [
+//   {
+//     processorSpec: 'https://wk.zintrust.com/AdvancEmailWorker.js',
+//     processor: ZinTrustProcessor,
+//   },
+// ];
+//
+// for (const entry of preRegisteredWorkerProcessorSpecs) {
+//   WorkerFactory.registerProcessorSpec(entry.processorSpec, entry.processor);
+// }
 export const __zintrustGeneratedPluginStub = 'zintrust.plugins.ts';
 export default {};

package/start.d.ts

@@ -0,0 +1 @@
+export * from './src/start'; export { default } from './src/start';

package/start.js

@@ -0,0 +1 @@
+export * from './src/start.js'; export { default } from './src/start.js';