@zintrust/core 0.1.8 → 0.1.9

package/src/templates/project/basic/routes/health.ts.tpl

@@ -3,13 +3,17 @@
  * Provides health, liveness, and readiness endpoints.
  */
 
-import { appConfig } from '@/config';
-import { RuntimeHealthProbes } from '@/health/RuntimeHealthProbes';
-import { Env } from '@zintrust/core';
-import { Logger } from '@config/logger';
-import { useDatabase } from '@zintrust/core';
-import { QueryBuilder } from '@zintrust/core';
-import { type IRouter, Router } from '@zintrust/core';
+import {
+  Env,
+  Logger,
+  QueryBuilder,
+  RuntimeHealthProbes,
+  type IRouter,
+  Router,
+  useDatabase,
+} from '@zintrust/core';
+
+import { appConfig } from '../config';
 
 export function registerHealthRoutes(router: IRouter): void {
   registerHealthRoute(router);

package/src/templates/project/basic/routes/storage.ts.tpl

@@ -1,8 +1,11 @@
-import { HTTP_HEADERS } from '@config/constants';
-import { Env } from '@zintrust/core';
-import { type IRouter, Router } from '@zintrust/core';
-import { LocalSignedUrl } from '@storage/LocalSignedUrl';
-import { Storage } from '@storage/index';
+import {
+  Env,
+  HTTP_HEADERS,
+  LocalSignedUrl,
+  Storage,
+  type IRouter,
+  Router,
+} from '@zintrust/core';
 
 export function registerStorageRoutes(router: IRouter): void {
   Router.get(router, '/storage/download', async (req, res) => {

package/src/templates/project/basic/src/index.ts.tpl

@@ -4,6 +4,8 @@
 
 import { Application, Env, Logger, Server } from '@zintrust/core';
 import process from '@zintrust/core/node';
+// Optional adapters/drivers registered via `zin plugin install`
+import './zintrust.plugins.js';
 
 type AppInstance = ReturnType<typeof Application.create>;
 type ServerInstance = ReturnType<typeof Server.create>;

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

@@ -0,0 +1,8 @@
+/**
+ * Zintrust plugin auto-imports
+ *
+ * This file is managed by `zin plugin install` and contains side-effect
+ * imports that register optional adapters/drivers into core registries.
+ */
+
+// Intentionally empty by default.

package/src/tools/broadcast/drivers/Redis.js

@@ -41,7 +41,7 @@ export const RedisDriver = (() => {
             const globalFake = globalThis
                 .__fakeRedisClient;
             if (globalFake === undefined) {
-                throw ErrorFactory.createConfigError("Redis broadcast driver requires the 'redis' package or a test fake client set in globalThis.__fakeRedisClient");
+                throw ErrorFactory.createConfigError("Redis broadcast driver requires the 'redis' package (run `zin add broadcast:redis` / `zin plugin install broadcast:redis`, or `npm install redis`) or a test fake client set in globalThis.__fakeRedisClient");
             }
             client = globalFake;
             connected = true;

package/src/tools/mail/Mail.d.ts

@@ -12,7 +12,7 @@ export type SendMailInput = {
 };
 export type SendMailResult = {
     ok: boolean;
-    driver: 'sendgrid' | 'disabled' | 'smtp' | 'ses' | 'mailgun';
+    driver: 'sendgrid' | 'disabled' | 'smtp' | 'ses' | 'mailgun' | 'nodemailer';
     messageId?: string;
 };
 export declare const Mail: Readonly<{

package/src/tools/mail/Mail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mail.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/Mail.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG7E,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAkIF,eAAO,MAAM,IAAI;gBACG,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;EAqBzD,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Mail.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/Mail.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI7E,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA6IF,eAAO,MAAM,IAAI;gBACG,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;EAqBzD,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/src/tools/mail/Mail.js

@@ -5,6 +5,7 @@ import { SendGridDriver } from './drivers/SendGrid.js';
 import { SesDriver } from './drivers/Ses.js';
 import { SmtpDriver } from './drivers/Smtp.js';
 import { resolveAttachments } from './attachments.js';
+import { MailDriverRegistry } from './MailDriverRegistry.js';
 import { Storage } from '../storage/index.js';
 const resolveFrom = (input) => {
     const address = input?.address ?? mailConfig.from.address;
@@ -76,6 +77,16 @@ const sendWithDriver = async (driver, message) => {
         const result = await SesDriver.send({ region: driver.region }, message);
         return { ok: result.ok, driver: 'ses', messageId: result.messageId };
     }
+    // External drivers can register via MailDriverRegistry (e.g., nodemailer)
+    const external = MailDriverRegistry.get(driver.driver);
+    if (external !== undefined) {
+        const result = await external(driver, message);
+        return {
+            ok: Boolean(result?.ok),
+            driver: driver.driver,
+            messageId: typeof result?.messageId === 'string' ? result.messageId : undefined,
+        };
+    }
     // Config exists for future drivers, but implementations are intentionally CLI/runtime-safe and added incrementally.
     {
         const err = ErrorFactory.createConfigError(`Mail driver not implemented: ${mailConfig.default}`);

package/src/tools/mail/MailDriverRegistry.d.ts

@@ -0,0 +1,16 @@
+export type MailSendHandler = (config: unknown, message: unknown) => Promise<{
+    ok: boolean;
+    messageId?: string;
+}>;
+declare function register(driver: string, handler: MailSendHandler): void;
+declare function get(driver: string): MailSendHandler | undefined;
+declare function has(driver: string): boolean;
+declare function list(): string[];
+export declare const MailDriverRegistry: Readonly<{
+    register: typeof register;
+    get: typeof get;
+    has: typeof has;
+    list: typeof list;
+}>;
+export {};
+//# sourceMappingURL=MailDriverRegistry.d.ts.map

package/src/tools/mail/MailDriverRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailDriverRegistry.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/MailDriverRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIlD,iBAAS,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAEhE;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAExD;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpC;AAED,iBAAS,IAAI,IAAI,MAAM,EAAE,CAExB;AAED,eAAO,MAAM,kBAAkB;;;;;EAK7B,CAAC"}

package/src/tools/mail/MailDriverRegistry.js

@@ -0,0 +1,19 @@
+const registry = new Map();
+function register(driver, handler) {
+    registry.set(driver, handler);
+}
+function get(driver) {
+    return registry.get(driver);
+}
+function has(driver) {
+    return registry.has(driver);
+}
+function list() {
+    return Array.from(registry.keys());
+}
+export const MailDriverRegistry = Object.freeze({
+    register,
+    get,
+    has,
+    list,
+});

package/src/tools/queue/drivers/Redis.js

@@ -43,7 +43,7 @@ export const RedisQueue = (() => {
             const globalFake = globalThis
                 .__fakeRedisClient;
             if (globalFake === undefined) {
-                throw ErrorFactory.createConfigError("Redis queue driver requires the 'redis' package or a test fake client set in globalThis.__fakeRedisClient");
+                throw ErrorFactory.createConfigError("Redis queue driver requires the 'redis' package (run `zin add queue:redis` / `zin plugin install queue:redis`, or `npm install redis`) or a test fake client set in globalThis.__fakeRedisClient");
             }
             client = globalFake;
             connected = true;