@zintrust/core 0.1.14 → 0.1.16

package/src/templates/project/basic/config/security.ts.tpl

@@ -16,10 +16,9 @@
  * security domains (e.g., different keys for different microservices).
  */
 
-import { Logger } from '@zintrust/core';
-
 import { appConfig } from './app';
 import { Env } from './env';
+import { Logger } from './logger';
 import { ErrorFactory } from '@zintrust/core';
 
 /**

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

@@ -8,7 +8,7 @@ import { Env } from './env';
 import type { StorageConfigRuntime, StorageDriverConfig, StorageDrivers } from './type';
 import { ErrorFactory } from '@zintrust/core';
 
-const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
+const hasOwn = <T extends object>(obj: T, key: PropertyKey): key is keyof T => {
   return Object.prototype.hasOwnProperty.call(obj, key);
 };
 
@@ -27,11 +27,13 @@ const getStorageDriver = (config: StorageConfigRuntime, name?: string): StorageD
     throw ErrorFactory.createConfigError(`Storage disk not configured: ${diskName}`);
   }
 
-  // Backwards-compatible fallback.
-  const fallback = config.drivers['local'] ?? Object.values(config.drivers)[0];
-  if (fallback !== undefined) return fallback;
+  if (Object.keys(config.drivers ?? {}).length === 0) {
+    throw ErrorFactory.createConfigError('No storage disks are configured');
+  }
 
-  throw ErrorFactory.createConfigError('No storage disks are configured');
+  throw ErrorFactory.createConfigError(
+    `Storage default disk not configured: ${diskName || '<empty>'}`
+  );
 };
 
 const getDrivers = (): StorageDrivers => ({
@@ -74,7 +76,7 @@ const storageConfigObj = {
    * Default storage driver (dynamic; tests may mutate process.env)
    */
   get default(): string {
-    return Env.get('STORAGE_DRIVER', 'local');
+    return Env.get('STORAGE_CONNECTION', Env.get('STORAGE_DRIVER', 'local')).trim().toLowerCase();
   },
 
   /**

package/src/templates/project/basic/config/type.ts.tpl

@@ -1,5 +1,5 @@
-import { Env } from '@config/env';
-import type { Middleware as MiddlewareFn } from '@middleware/MiddlewareStack';
+import { Env } from './env';
+import type { Middleware as MiddlewareFn } from '@zintrust/core';
 
 export type Environment =
   | 'development'

package/src/tools/broadcast/Broadcast.d.ts

@@ -3,6 +3,14 @@ type Broadcaster = Readonly<{
 }>;
 export declare const Broadcast: Readonly<{
     send(channel: string, event: string, data: unknown): Promise<unknown>;
+    broadcastNow(channel: string, event: string, data: unknown): Promise<unknown>;
+    BroadcastLater(channel: string, event: string, data: unknown, options?: {
+        queueName?: string;
+        timestamp?: number;
+    }): Promise<string>;
+    queue(queueName: string): Readonly<{
+        BroadcastLater: (channel: string, event: string, data: unknown, options?: {}) => Promise<string>;
+    }>;
     broadcaster(name?: string): Broadcaster;
 }>;
 export default Broadcast;

package/src/tools/broadcast/Broadcast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Broadcast.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/Broadcast.ts"],"names":[],"mappings":"AAQA,KAAK,WAAW,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E,CAAC,CAAC;AAyDH,eAAO,MAAM,SAAS;kBACA,MAAM,SAAS,MAAM,QAAQ,OAAO;uBAKrC,MAAM,GAAG,WAAW;EAQvC,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Broadcast.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/Broadcast.ts"],"names":[],"mappings":"AAQA,KAAK,WAAW,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E,CAAC,CAAC;AAyDH,eAAO,MAAM,SAAS;kBACA,MAAM,SAAS,MAAM,QAAQ,OAAO;0BAM5B,MAAM,SAAS,MAAM,QAAQ,OAAO;4BAMrD,MAAM,SACR,MAAM,QACP,OAAO,YACJ;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;qBAepC,MAAM;kCAEa,MAAM,SAAS,MAAM,QAAQ,OAAO;;uBAKrD,MAAM,GAAG,WAAW;EAQvC,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/src/tools/broadcast/Broadcast.js

@@ -49,6 +49,29 @@ export const Broadcast = Object.freeze({
         const config = await resolveBroadcasterConfig();
         return sendWithConfig(config, channel, event, data);
     },
+    // Alias for send() - explicit intent for immediate broadcast
+    async broadcastNow(channel, event, data) {
+        return this.send(channel, event, data);
+    },
+    // Queue broadcast for async processing
+    async BroadcastLater(channel, event, data, options = {}) {
+        const { queueName = 'broadcasts', timestamp = Date.now() } = options;
+        const { Queue } = await import('../queue/Queue.js');
+        const messageId = await Queue.enqueue(queueName, {
+            type: 'broadcast',
+            channel,
+            event,
+            data,
+            timestamp,
+            attempts: 0,
+        });
+        return messageId;
+    },
+    queue(queueName) {
+        return Object.freeze({
+            BroadcastLater: async (channel, event, data, options = {}) => Broadcast.BroadcastLater(channel, event, data, { ...options, queueName }),
+        });
+    },
     broadcaster(name) {
         return Object.freeze({
             send: async (channel, event, data) => {

package/src/tools/broadcast/BroadcastRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BroadcastRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/BroadcastRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC,GACxD,IAAI,CAWN"}
+{"version":3,"file":"BroadcastRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/BroadcastRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKzD;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC,GACxD,IAAI,CAeN"}

package/src/tools/broadcast/BroadcastRuntimeRegistration.js

@@ -1,3 +1,4 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { BroadcastRegistry } from './BroadcastRegistry.js';
 /**
  * Register broadcasters from runtime config.
@@ -12,9 +13,11 @@ export function registerBroadcastersFromRuntimeConfig(config) {
         BroadcastRegistry.register(name, driverConfig);
     }
     const defaultName = (config.default ?? '').toString().trim().toLowerCase();
-    if (defaultName.length === 0)
-        return;
-    if (BroadcastRegistry.has(defaultName)) {
-        BroadcastRegistry.register('default', BroadcastRegistry.get(defaultName));
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Broadcast default driver is not configured');
     }
+    if (!BroadcastRegistry.has(defaultName)) {
+        throw ErrorFactory.createConfigError(`Broadcast default driver not configured: ${defaultName}`);
+    }
+    BroadcastRegistry.register('default', BroadcastRegistry.get(defaultName));
 }

package/src/tools/notification/Notification.d.ts

@@ -5,6 +5,16 @@
  */
 export declare const Notification: Readonly<{
     send: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    NotifyNow: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    NotifyLater(recipient: string, message: string, notifyOptions?: Record<string, unknown>, queueOptions?: {
+        queueName?: string;
+        timestamp?: number;
+    }): Promise<string>;
+    queue(queueName: string): Readonly<{
+        NotifyLater: (recipient: string, message: string, notifyOptions?: Record<string, unknown>, queueOptions?: {
+            timestamp?: number;
+        }) => Promise<string>;
+    }>;
     channel: (name: string) => Readonly<{
         send: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
     }>;

package/src/tools/notification/Notification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Notification.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Notification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,YAAY;;oBAEP,MAAM;0BAEM,MAAM,WAAW,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAItF,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"Notification.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Notification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,YAAY;;;2BAQV,MAAM,WACR,MAAM,kBACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBACxB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,MAAM,CAAC;qBAcD,MAAM;iCAGN,MAAM,WACR,MAAM,kBACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBACxB;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE;;oBAM1B,MAAM;0BAEM,MAAM,WAAW,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAItF,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/tools/notification/Notification.js

@@ -6,6 +6,27 @@
 import { NotificationService } from './Service.js';
 export const Notification = Object.freeze({
     send: NotificationService.send,
+    // Alias for send() - explicit intent for immediate notification
+    NotifyNow: NotificationService.send,
+    // Queue notification for async processing
+    async NotifyLater(recipient, message, notifyOptions = {}, queueOptions = {}) {
+        const { queueName = 'notifications', timestamp = Date.now() } = queueOptions;
+        const { Queue } = await import('../queue/Queue.js');
+        const messageId = await Queue.enqueue(queueName, {
+            type: 'notification',
+            recipient,
+            message,
+            options: notifyOptions,
+            timestamp,
+            attempts: 0,
+        });
+        return messageId;
+    },
+    queue(queueName) {
+        return Object.freeze({
+            NotifyLater: async (recipient, message, notifyOptions = {}, queueOptions = {}) => Notification.NotifyLater(recipient, message, notifyOptions, { ...queueOptions, queueName }),
+        });
+    },
     channel: (name) => Object.freeze({
         send: async (recipient, message, options) => NotificationService.sendVia(name, recipient, message, options),
     }),

package/src/tools/notification/NotificationRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/NotificationRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3D,IAAI,CAWN;AAED,eAAO,MAAM,+BAA+B;;EAE1C,CAAC;AAEH,eAAe,+BAA+B,CAAC"}
+{"version":3,"file":"NotificationRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/NotificationRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAI5D;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3D,IAAI,CAiBN;AAED,eAAO,MAAM,+BAA+B;;EAE1C,CAAC;AAEH,eAAe,+BAA+B,CAAC"}

package/src/tools/notification/NotificationRuntimeRegistration.js

@@ -1,3 +1,4 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { NotificationChannelRegistry } from './NotificationChannelRegistry.js';
 /**
  * Register notification channels from runtime config.
@@ -10,11 +11,13 @@ export function registerNotificationChannelsFromRuntimeConfig(config) {
         NotificationChannelRegistry.register(name, driverConfig);
     }
     const defaultName = (config.default ?? '').toString().trim().toLowerCase();
-    if (defaultName.length === 0)
-        return;
-    if (NotificationChannelRegistry.has(defaultName)) {
-        NotificationChannelRegistry.register('default', NotificationChannelRegistry.get(defaultName));
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Notification default channel is not configured');
     }
+    if (!NotificationChannelRegistry.has(defaultName)) {
+        throw ErrorFactory.createConfigError(`Notification default channel not configured: ${defaultName}`);
+    }
+    NotificationChannelRegistry.register('default', NotificationChannelRegistry.get(defaultName));
 }
 export const NotificationRuntimeRegistration = Object.freeze({
     registerNotificationChannelsFromRuntimeConfig,

package/src/tools/queue/Queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/Queue.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAID,eAAO,MAAM,KAAK;mBACD,MAAM,UAAU,YAAY;aAIlC,IAAI;eAIF,MAAM,GAAG,YAAY;YAUlB,CAAC,mBAAmB,MAAM,WAAW,CAAC,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAK7E,CAAC,mBACN,MAAM,eACA,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;eAKtB,MAAM,MAAM,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAKpD,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iBAK9C,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAI9D,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/Queue.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAID,eAAO,MAAM,KAAK;mBACD,MAAM,UAAU,YAAY;aAIlC,IAAI;eAIF,MAAM,GAAG,YAAY;YAelB,CAAC,mBAAmB,MAAM,WAAW,CAAC,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAK7E,CAAC,mBACN,MAAM,eACA,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;eAKtB,MAAM,MAAM,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAKpD,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iBAK9C,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAI9D,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/src/tools/queue/Queue.js

@@ -8,7 +8,10 @@ export const Queue = Object.freeze({
         drivers.clear();
     },
     get(name) {
-        const driverName = (name ?? process.env['QUEUE_DRIVER'] ?? 'inmemory')
+        const driverName = (name ??
+            process.env['QUEUE_CONNECTION'] ??
+            process.env['QUEUE_DRIVER'] ??
+            'inmemory')
             .toString()
             .trim()
             .toLowerCase();

package/src/tools/queue/QueueRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueueRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/QueueRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAgBzE"}
+{"version":3,"file":"QueueRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/QueueRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAOjD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAczE"}

package/src/tools/queue/QueueRuntimeRegistration.js

@@ -1,3 +1,4 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { InMemoryQueue } from '../queue/drivers/InMemory.js';
 import { RedisQueue } from '../queue/drivers/Redis.js';
 import { Queue } from '../queue/Queue.js';
@@ -16,13 +17,9 @@ export function registerQueuesFromRuntimeConfig(config) {
     Queue.register('sync', InMemoryQueue);
     Queue.register('redis', RedisQueue);
     const defaultName = (config.default ?? '').toString().trim().toLowerCase();
-    if (defaultName.length === 0)
-        return;
-    try {
-        const drv = Queue.get(defaultName);
-        Queue.register('default', drv);
-    }
-    catch {
-        // Best-effort: external drivers may be registered by optional packages.
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Queue default driver is not configured');
     }
+    const drv = Queue.get(defaultName);
+    Queue.register('default', drv);
 }

package/src/tools/storage/StorageRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/storage/StorageRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG9E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACxD,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC1D,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAmBjF;AAED,eAAO,MAAM,0BAA0B;;EAErC,CAAC;AAEH,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"StorageRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/storage/StorageRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI9E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACxD,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC1D,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAiBjF;AAED,eAAO,MAAM,0BAA0B;;EAErC,CAAC;AAEH,eAAe,0BAA0B,CAAC"}

package/src/tools/storage/StorageRuntimeRegistration.js

@@ -1,21 +1,19 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { StorageDiskRegistry } from './StorageDiskRegistry.js';
 export function registerDisksFromRuntimeConfig(config) {
     for (const [name, driverConfig] of Object.entries(config.drivers)) {
         StorageDiskRegistry.register(name, driverConfig);
     }
     // Alias reserved name `default` to the configured default.
-    // Prefer config.getDriverConfig() so we preserve its fallback semantics.
-    let resolvedDefault;
-    if (typeof config.getDriverConfig === 'function') {
-        resolvedDefault = config.getDriverConfig('default');
+    const defaultName = String(config.default ?? '').trim();
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Storage default disk is not configured');
     }
-    else {
-        const values = Object.values(config.drivers);
-        resolvedDefault = config.drivers[config.default] ?? values[0];
-    }
-    if (resolvedDefault !== undefined) {
-        StorageDiskRegistry.register('default', resolvedDefault);
+    const resolvedDefault = config.drivers[defaultName];
+    if (resolvedDefault === undefined) {
+        throw ErrorFactory.createConfigError(`Storage default disk not configured: ${defaultName}`);
     }
+    StorageDiskRegistry.register('default', resolvedDefault);
 }
 export const StorageRuntimeRegistration = Object.freeze({
     registerDisksFromRuntimeConfig,

package/src/workers/BroadcastWorker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * BroadcastWorker - Processes queued broadcasts
+ *
+ * This worker dequeues broadcast messages and sends them using the Broadcast service.
+ * Use with Queue.dequeue() in a background process or cron job.
+ */
+export declare const BroadcastWorker: Readonly<{
+    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
+    processAll: (queueName?: string, driverName?: string) => Promise<number>;
+    runOnce: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        maxItems?: number;
+    }) => Promise<number>;
+    startWorker: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        signal?: AbortSignal;
+    }) => Promise<number>;
+}>;
+export default BroadcastWorker;
+//# sourceMappingURL=BroadcastWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BroadcastWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/BroadcastWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,eAAO,MAAM,eAAe;0BAbrB,CAAC,oBAAoB,CAAC;0BAGf,CAAC,oBAAoB,CAAC;kBACnB,CAAC;iBAAiB,CAAC;kBAE3B,CAAC;gBACC,CAAA;;sBAGE,CAAC;iBAGP,CAAA;kBAAwB,CAAC;cAC3B,CAAC;;EAaJ,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/workers/BroadcastWorker.js

@@ -0,0 +1,24 @@
+/**
+ * BroadcastWorker - Processes queued broadcasts
+ *
+ * This worker dequeues broadcast messages and sends them using the Broadcast service.
+ * Use with Queue.dequeue() in a background process or cron job.
+ */
+import { createQueueWorker } from '../workers/createQueueWorker.js';
+import { Broadcast } from '../tools/broadcast/Broadcast.js';
+export const BroadcastWorker = Object.freeze({
+    ...createQueueWorker({
+        kindLabel: 'broadcast',
+        defaultQueueName: 'broadcasts',
+        maxAttempts: 3,
+        getLogFields: (payload) => ({
+            channel: payload.channel,
+            event: payload.event,
+            queuedAt: payload.timestamp,
+        }),
+        handle: async (payload) => {
+            await Broadcast.send(payload.channel, payload.event, payload.data);
+        },
+    }),
+});
+export default BroadcastWorker;

package/src/workers/NotificationWorker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * NotificationWorker - Processes queued notifications
+ *
+ * This worker dequeues notification messages and sends them using the Notification service.
+ * Use with Queue.dequeue() in a background process or cron job.
+ */
+export declare const NotificationWorker: Readonly<{
+    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
+    processAll: (queueName?: string, driverName?: string) => Promise<number>;
+    runOnce: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        maxItems?: number;
+    }) => Promise<number>;
+    startWorker: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        signal?: AbortSignal;
+    }) => Promise<number>;
+}>;
+export default NotificationWorker;
+//# sourceMappingURL=NotificationWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/NotificationWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,eAAO,MAAM,kBAAkB;0BAdyD,CAAC,oBACzE,CAAC;0BAGf,CAAC,oBAAoB,CAAC;kBACnB,CAAC;iBAAkB,CAAA;kBAAwB,CAAC;gBAEtC,CAAC;;sBAGV,CAAC;iBAAiB,CAAC;kBACZ,CAAC;cAGL,CAAC;;EAaJ,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/src/workers/NotificationWorker.js

@@ -0,0 +1,23 @@
+/**
+ * NotificationWorker - Processes queued notifications
+ *
+ * This worker dequeues notification messages and sends them using the Notification service.
+ * Use with Queue.dequeue() in a background process or cron job.
+ */
+import { createQueueWorker } from '../workers/createQueueWorker.js';
+import { Notification } from '../tools/notification/Notification.js';
+export const NotificationWorker = Object.freeze({
+    ...createQueueWorker({
+        kindLabel: 'notification',
+        defaultQueueName: 'notifications',
+        maxAttempts: 3,
+        getLogFields: (payload) => ({
+            recipient: payload.recipient,
+            queuedAt: payload.timestamp,
+        }),
+        handle: async (payload) => {
+            await Notification.send(payload.recipient, payload.message, payload.options);
+        },
+    }),
+});
+export default NotificationWorker;

package/src/workers/createQueueWorker.d.ts

@@ -0,0 +1,24 @@
+type QueueWorker = {
+    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
+    processAll: (queueName?: string, driverName?: string) => Promise<number>;
+    runOnce: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        maxItems?: number;
+    }) => Promise<number>;
+    startWorker: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        signal?: AbortSignal;
+    }) => Promise<number>;
+};
+export type CreateQueueWorkerOptions<TPayload> = {
+    kindLabel: string;
+    defaultQueueName: string;
+    maxAttempts: number;
+    getLogFields: (payload: TPayload) => Record<string, unknown>;
+    handle: (payload: TPayload) => Promise<void>;
+};
+export declare function createQueueWorker<TPayload>(options: CreateQueueWorkerOptions<TPayload>): QueueWorker;
+export {};
+//# sourceMappingURL=createQueueWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createQueueWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/createQueueWorker.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,QAAQ,IAAI;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AA4IF,wBAAgB,iBAAiB,CAAC,QAAQ,EACxC,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,WAAW,CAOb"}

package/src/workers/createQueueWorker.js

@@ -0,0 +1,114 @@
+import { Logger } from '../config/logger.js';
+import { Queue } from '../tools/queue/Queue.js';
+const buildBaseLogFields = (message, getLogFields) => {
+    return {
+        messageId: message.id,
+        ...getLogFields(message.payload),
+    };
+};
+const createProcessOne = (options) => {
+    return async (queueName = options.defaultQueueName, driverName) => {
+        const message = await Queue.dequeue(queueName, driverName);
+        if (!message)
+            return false;
+        const baseLogFields = buildBaseLogFields(message, options.getLogFields);
+        // Check for delayed execution
+        const payload = message.payload;
+        const rawTimestamp = 'timestamp' in payload ? payload['timestamp'] : 0;
+        const timestamp = typeof rawTimestamp === 'number' ? rawTimestamp : 0;
+        if (timestamp > Date.now()) {
+            Logger.info(`${options.kindLabel} not due yet, re-queueing`, {
+                ...baseLogFields,
+                dueAt: new Date(timestamp).toISOString(),
+            });
+            // Re-queue original payload
+            await Queue.enqueue(queueName, message.payload, driverName);
+            await Queue.ack(queueName, message.id, driverName);
+            return false;
+        }
+        try {
+            Logger.info(`Processing queued ${options.kindLabel}`, baseLogFields);
+            await options.handle(message.payload);
+            await Queue.ack(queueName, message.id, driverName);
+            Logger.info(`${options.kindLabel} processed successfully`, baseLogFields);
+            return true;
+        }
+        catch (error) {
+            const attempts = message.attempts ?? 0;
+            Logger.error(`Failed to process ${options.kindLabel}`, {
+                ...baseLogFields,
+                error,
+                attempts,
+            });
+            if (attempts < options.maxAttempts) {
+                await Queue.enqueue(queueName, message.payload, driverName);
+                Logger.info(`${options.kindLabel} re-queued for retry`, {
+                    ...baseLogFields,
+                    attempts: attempts + 1,
+                });
+            }
+            await Queue.ack(queueName, message.id, driverName);
+            return false;
+        }
+    };
+};
+const createProcessAll = (defaultQueueName, processOne) => {
+    return async (queueName = defaultQueueName, driverName) => {
+        let processed = 0;
+        let hasMore = true;
+        while (hasMore) {
+            // eslint-disable-next-line no-await-in-loop
+            hasMore = await processOne(queueName, driverName);
+            if (hasMore)
+                processed++;
+        }
+        return processed;
+    };
+};
+const createRunOnce = (defaultQueueName, processOne) => {
+    return async (opts = {}) => {
+        const { queueName = defaultQueueName, driverName, maxItems } = opts;
+        let processed = 0;
+        if (maxItems === undefined) {
+            while (true) {
+                // eslint-disable-next-line no-await-in-loop
+                const didProcess = await processOne(queueName, driverName);
+                if (!didProcess)
+                    break;
+                processed++;
+            }
+            return processed;
+        }
+        for (let i = 0; i < maxItems; i++) {
+            // eslint-disable-next-line no-await-in-loop
+            const didProcess = await processOne(queueName, driverName);
+            if (!didProcess)
+                break;
+            processed++;
+        }
+        return processed;
+    };
+};
+const createStartWorker = (kindLabel, defaultQueueName, processOne) => {
+    return async (opts = {}) => {
+        const { queueName = defaultQueueName, driverName, signal } = opts;
+        Logger.info(`Starting ${kindLabel} worker (drain-until-empty)`, { queueName });
+        let processedCount = 0;
+        while (signal?.aborted !== true) {
+            // eslint-disable-next-line no-await-in-loop
+            const didProcess = await processOne(queueName, driverName);
+            if (!didProcess)
+                break;
+            processedCount++;
+        }
+        Logger.info(`${kindLabel} worker finished (queue drained)`, { queueName, processedCount });
+        return processedCount;
+    };
+};
+export function createQueueWorker(options) {
+    const processOne = createProcessOne(options);
+    const processAll = createProcessAll(options.defaultQueueName, processOne);
+    const runOnce = createRunOnce(options.defaultQueueName, processOne);
+    const startWorker = createStartWorker(options.kindLabel, options.defaultQueueName, processOne);
+    return Object.freeze({ processOne, processAll, runOnce, startWorker });
+}