alepha 0.14.3 → 0.15.0

package/dist/sms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/sms/providers/SmsProvider.ts","../../src/sms/errors/SmsError.ts","../../src/sms/primitives/$sms.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAKsB,uBAAA,WAAA,CAMU;EAGpB;;;;ACdZ;yBDWgC,iBAAiB;;KAGrC,cAAA;EEFC,EAAA,EAAA,MAC2B,GAAA,MAAA,EAAA;EADV,OAAA,EAAA,MAAA;CAAmB;;;cDZpC,QAAA,SAAiB,KAAA;uCACS;;;;cCW1B;aAAiB,sBAAmB;EFP3B,MAAA,EAAA,mBAMU;AAGhC,CAAA;UEGiB,mBAAA;;aAEJ,kBAAkB;ADnB/B;;;;ACYA;;;;;;AAKA;AAwBA;;;;;;;AAA2C,cAA9B,YAAA,SAAqB,SAAS,CAAC,mBAAD,CAAA,CAAA;+BACd;;;ACpC7B;AAQA;EAA8B,IAAA,CAAA,OACN,EDoCK,cCpCL,CAAA,EDoCsB,OCpCtB,CAAA,IAAA,CAAA;EAGD,UAAA,SAAA,CAAA,CAAA,EDqDE,WCrDF;;;;UAZN,uBAAA;;;;AHDjB;EASY,SAAA,CAAA,EAAA,MAAc;;cGAb,gBAAA,YAA4B;0BAAX,cAAA,CACN;EFfX,mBAAS,SACiB,EADT,MAAK;wBEkBZ;gBAIM,iBAAiB;;IDVjC,EAAA,EAC2B,MAAA;IADV,OAAA,EAAA,MAAA;EAAmB,CAAA,CAAA,EAAA,MAAA;;;;UEThC,SAAA;;;UAGP;AJDV;AASY,cILC,iBAAA,YAA6B,WJKhB,CAAA;0BILK,cAAA,CACP;WACN;gBAEW,iBAAiB;EHbjC;;;cG6BQ;AFjBrB;;;AFEA,eAAY,QAAc,CAAA;;;;MCdb,QAAS,EAAA,MACiB;iBIoBtB;gBACD;;IHVH,CAAA;IAAiB,UAAA,EAAA;MAAmB,EAAA,EAAA,MAAA,GAAA,MAAA,EAAA;;gBGgBjC;;EHXC;AAwBjB;;;;;;;;;;;ACnCiB,cEuCJ,SFvC2B,EEuClB,OAAA,CAAA,OFvCkB,CEiDtC,OAAA,CAVoB,MAAA,CFvCkB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/sms/providers/SmsProvider.ts","../../src/sms/errors/SmsError.ts","../../src/sms/primitives/$sms.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/index.ts"],"mappings":";;;;;;;AAKA;AASA;;;uBATsB,WAAA;EAAA;AAStB;;;;EATsB,SAAA,KAAA,OAAA,EAMU,cAAA,GAAiB,OAAA;AAAA;AAAA,KAGrC,cAAA;EAAA,EAAA;EAAA,OAAA;AAAA;;;cCdC,QAAA,SAAiB,KAAA;EAAA,YAAA,OAAA,UAAA,KAAA,GACS,KAAA;AAAA;;;cCW1B,IAAA;EAAA,CAAA,OAAA,GAAiB,mBAAA,GAAmB,YAAA;EAAA;;UAKhC,mBAAA;EAAA,IAAA;EAAA,QAAA,GAEJ,iBAAA,CAAkB,WAAA;AAAA;AAAA;AAsB/B;;;;;;;;;;;ACnCA;AAQA;;;;ADK+B,cAsBlB,YAAA,SAAqB,SAAA,CAAU,mBAAA;EAAA,mBAAA,QAAA,EACf,WAAA;EAAA,IAAA,KAAA;EAAA;;;EAAA,KAAA,OAAA,EASA,cAAA,GAAiB,OAAA;EAAA,UAAA,UAAA,GAoBrB,WAAA;AAAA;;;UCjER,uBAAA;EAAA;AAQjB;;;EARiB,SAAA;AAAA;AAAA,cAQJ,gBAAA,YAA4B,WAAA;EAAA,mBAAA,GAAA,EAAX,cAAA,CACN,MAAA;EAAA,mBAAA,EAAA,EACD,kBAAA;EAAA,mBAAA,SAAA;EAAA,YAAA,OAAA,GAGA,uBAAA;EAAA,KAAA,OAAA,EAIM,cAAA,GAAiB,OAAA;EAAA,cAAA,OAAA;IAAA,EAAA;IAAA,OAAA;EAAA;AAAA;;;UCpB7B,SAAA;EAAA,EAAA;EAAA,OAAA;EAAA,MAAA,EAGP,IAAA;AAAA;AAAA,cAGG,iBAAA,YAA6B,WAAA;EAAA,mBAAA,GAAA,EAAX,cAAA,CACP,MAAA;EAAA,OAAA,EACN,SAAA;EAAA,KAAA,OAAA,EAEW,cAAA,GAAiB,OAAA;EAAA;;;EAAA,IAAA,KAAA,GAgBzB,SAAA;AAAA;;;;;;;;iBCRJ,MAAA;MAAA,QAAA,EACD,WAAA;MAAA,KAAA;IAAA;IAAA;MAAA,EAAA;MAAA,QAAA;MAAA,QAAA,EAMA,WAAA;IAAA;EAAA;AAAA;AAAA;;;;AAiBhB;;;;;;AAjBgB,cAiBH,SAAA,EAAS,OAAA,CAAA,OAAA,CAUpB,OAAA,CAVoB,MAAA"}

package/dist/sms/index.js

@@ -1,7 +1,6 @@
-import { $module, KIND, Primitive, createPrimitive } from "alepha";
+import { $inject, $module, KIND, Primitive, createPrimitive } from "alepha";
 import { $logger } from "alepha/logger";
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
+import { FileSystemProvider } from "alepha/file";
 
 //#region ../../src/sms/providers/MemorySmsProvider.ts
 var MemorySmsProvider = class {
@@ -103,9 +102,10 @@ var SmsError = class extends Error {
 //#region ../../src/sms/providers/LocalSmsProvider.ts
 var LocalSmsProvider = class {
 	log = $logger();
+	fs = $inject(FileSystemProvider);
 	directory;
 	constructor(options = {}) {
-		this.directory = options.directory ?? "node_modules/.sms";
+		this.directory = options.directory ?? "node_modules/.alepha/sms";
 	}
 	async send(options) {
 		const { to, message } = options;
@@ -115,16 +115,16 @@ var LocalSmsProvider = class {
 			directory: this.directory
 		});
 		try {
-			await fs.mkdir(this.directory, { recursive: true });
+			await this.fs.mkdir(this.directory, { recursive: true });
 			const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
 			for (const recipient of Array.isArray(to) ? to : [to]) {
 				const filename = `${recipient.replace(/[^0-9+]/g, "_")}+${timestamp}.txt`;
-				const filepath = path.join(this.directory, filename);
+				const filepath = this.fs.join(this.directory, filename);
 				const textContent = this.createSmsText({
 					to: recipient,
 					message
 				});
-				await fs.writeFile(filepath, textContent, "utf8");
+				await this.fs.writeFile(filepath, textContent);
 				this.log.info("SMS saved to local file", {
 					filepath,
 					to

package/dist/sms/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["message"],"sources":["../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/providers/SmsProvider.ts","../../src/sms/primitives/$sms.ts","../../src/sms/errors/SmsError.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/index.ts"],"sourcesContent":["import { $logger } from \"alepha/logger\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface SmsRecord {\n  to: string;\n  message: string;\n  sentAt: Date;\n}\n\nexport class MemorySmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  public records: SmsRecord[] = [];\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n    this.log.debug(\"Sending SMS to memory store\", { to, message });\n\n    for (const recipient of Array.isArray(to) ? to : [to]) {\n      this.records.push({\n        to: recipient,\n        message,\n        sentAt: new Date(),\n      });\n    }\n  }\n\n  /**\n   * Get the last SMS sent (for testing purposes).\n   */\n  public get last(): SmsRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","/**\n * SMS provider interface.\n *\n * All methods are asynchronous and return promises.\n */\nexport abstract class SmsProvider {\n  /**\n   * Send an SMS.\n   *\n   * @return Promise that resolves when the SMS is sent.\n   */\n  public abstract send(options: SmsSendOptions): Promise<void>;\n}\n\nexport type SmsSendOptions = {\n  to: string | string[];\n  message: string;\n};\n","import {\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n} from \"alepha\";\nimport { MemorySmsProvider } from \"../providers/MemorySmsProvider.ts\";\nimport type { SmsSendOptions } from \"../providers/SmsProvider.ts\";\nimport { SmsProvider } from \"../providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const $sms = (options: SmsPrimitiveOptions = {}) =>\n  createPrimitive(SmsPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SmsPrimitiveOptions {\n  name?: string;\n  provider?: InstantiableClass<SmsProvider> | \"memory\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SMS primitive for sending SMS messages through various providers.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   private readonly welcomeSms = $sms({ name: \"welcome\" });\n *\n *   async sendWelcome(phoneNumber: string, userName: string) {\n *     await this.welcomeSms.send({\n *       to: phoneNumber,\n *       message: `Hello ${userName}! Welcome to our service.`\n *     });\n *   }\n * }\n * ```\n */\nexport class SmsPrimitive extends Primitive<SmsPrimitiveOptions> {\n  protected readonly provider = this.$provider();\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  /**\n   * Send an SMS using the configured provider.\n   */\n  public async send(options: SmsSendOptions): Promise<void> {\n    await this.alepha.events.emit(\"sms:sending\", {\n      to: options.to,\n      template: this.name,\n      variables: {},\n      provider: this.provider,\n      abort: () => {\n        throw new Error(\"SMS sending aborted by hook\");\n      },\n    });\n\n    await this.provider.send(options);\n\n    await this.alepha.events.emit(\"sms:sent\", {\n      to: options.to,\n      template: this.name,\n      provider: this.provider,\n    });\n  }\n\n  protected $provider(): SmsProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(SmsProvider);\n    }\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemorySmsProvider);\n    }\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n$sms[KIND] = SmsPrimitive;\n","export class SmsError extends Error {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"SmsError\";\n    this.cause = cause;\n  }\n}\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { $logger } from \"alepha/logger\";\nimport { SmsError } from \"../errors/SmsError.ts\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface LocalSmsProviderOptions {\n  /**\n   * Directory to save SMS files.\n   * @default \"node_modules/.sms\" (relative to project root)\n   */\n  directory?: string;\n}\n\nexport class LocalSmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  protected readonly directory: string;\n\n  constructor(options: LocalSmsProviderOptions = {}) {\n    this.directory = options.directory ?? \"node_modules/.sms\";\n  }\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n\n    this.log.debug(\"Sending SMS to local file\", {\n      to,\n      message,\n      directory: this.directory,\n    });\n\n    try {\n      // Ensure directory exists\n      await fs.mkdir(this.directory, { recursive: true });\n\n      // Create filename: phone+date\n      const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n      for (const recipient of Array.isArray(to) ? to : [to]) {\n        const sanitizedPhone = recipient.replace(/[^0-9+]/g, \"_\");\n        const filename = `${sanitizedPhone}+${timestamp}.txt`;\n        const filepath = path.join(this.directory, filename);\n\n        // Create text content\n        const textContent = this.createSmsText({\n          to: recipient,\n          message,\n        });\n\n        // Write to file\n        await fs.writeFile(filepath, textContent, \"utf8\");\n\n        this.log.info(\"SMS saved to local file\", { filepath, to });\n      }\n    } catch (error) {\n      const message = `Failed to save SMS to local file: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, directory: this.directory });\n      throw new SmsError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  public createSmsText(options: { to: string; message: string }): string {\n    const { to, message } = options;\n    const timestamp = new Date().toISOString();\n\n    return `SMS Message\n===========\n\nSent: ${timestamp}\nTo: ${to}\n\nMessage:\n--------\n${message}\n`;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $sms } from \"./primitives/$sms.ts\";\nimport { LocalSmsProvider } from \"./providers/LocalSmsProvider.ts\";\nimport { MemorySmsProvider } from \"./providers/MemorySmsProvider.ts\";\nimport { SmsProvider } from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/SmsError.ts\";\nexport * from \"./primitives/$sms.ts\";\nexport * from \"./providers/LocalSmsProvider.ts\";\nexport * from \"./providers/MemorySmsProvider.ts\";\nexport * from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"sms:sending\": {\n      to: string | string[];\n      template: string;\n      variables: Record<string, unknown>;\n      provider: SmsProvider;\n      abort(): void;\n    };\n    \"sms:sent\": {\n      to: string | string[];\n      template: string;\n      provider: SmsProvider;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides SMS sending capabilities for Alepha applications with multiple provider backends.\n *\n * The SMS module enables declarative SMS sending through the `$sms` primitive, allowing you to send\n * text messages through different providers: memory (for testing) or local file system.\n * It supports automatic provider selection based on environment configuration.\n *\n * @see {@link SmsProvider}\n * @module alepha.sms\n */\nexport const AlephaSms = $module({\n  name: \"alepha.sms\",\n  primitives: [$sms],\n  services: [SmsProvider, MemorySmsProvider, LocalSmsProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: SmsProvider,\n      use: MemorySmsProvider,\n    }),\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["message"],"sources":["../../src/sms/providers/MemorySmsProvider.ts","../../src/sms/providers/SmsProvider.ts","../../src/sms/primitives/$sms.ts","../../src/sms/errors/SmsError.ts","../../src/sms/providers/LocalSmsProvider.ts","../../src/sms/index.ts"],"sourcesContent":["import { $logger } from \"alepha/logger\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface SmsRecord {\n  to: string;\n  message: string;\n  sentAt: Date;\n}\n\nexport class MemorySmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  public records: SmsRecord[] = [];\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n    this.log.debug(\"Sending SMS to memory store\", { to, message });\n\n    for (const recipient of Array.isArray(to) ? to : [to]) {\n      this.records.push({\n        to: recipient,\n        message,\n        sentAt: new Date(),\n      });\n    }\n  }\n\n  /**\n   * Get the last SMS sent (for testing purposes).\n   */\n  public get last(): SmsRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","/**\n * SMS provider interface.\n *\n * All methods are asynchronous and return promises.\n */\nexport abstract class SmsProvider {\n  /**\n   * Send an SMS.\n   *\n   * @return Promise that resolves when the SMS is sent.\n   */\n  public abstract send(options: SmsSendOptions): Promise<void>;\n}\n\nexport type SmsSendOptions = {\n  to: string | string[];\n  message: string;\n};\n","import {\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n} from \"alepha\";\nimport { MemorySmsProvider } from \"../providers/MemorySmsProvider.ts\";\nimport type { SmsSendOptions } from \"../providers/SmsProvider.ts\";\nimport { SmsProvider } from \"../providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const $sms = (options: SmsPrimitiveOptions = {}) =>\n  createPrimitive(SmsPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface SmsPrimitiveOptions {\n  name?: string;\n  provider?: InstantiableClass<SmsProvider> | \"memory\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * SMS primitive for sending SMS messages through various providers.\n *\n * Usage:\n * ```typescript\n * class MyService {\n *   private readonly welcomeSms = $sms({ name: \"welcome\" });\n *\n *   async sendWelcome(phoneNumber: string, userName: string) {\n *     await this.welcomeSms.send({\n *       to: phoneNumber,\n *       message: `Hello ${userName}! Welcome to our service.`\n *     });\n *   }\n * }\n * ```\n */\nexport class SmsPrimitive extends Primitive<SmsPrimitiveOptions> {\n  protected readonly provider = this.$provider();\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  /**\n   * Send an SMS using the configured provider.\n   */\n  public async send(options: SmsSendOptions): Promise<void> {\n    await this.alepha.events.emit(\"sms:sending\", {\n      to: options.to,\n      template: this.name,\n      variables: {},\n      provider: this.provider,\n      abort: () => {\n        throw new Error(\"SMS sending aborted by hook\");\n      },\n    });\n\n    await this.provider.send(options);\n\n    await this.alepha.events.emit(\"sms:sent\", {\n      to: options.to,\n      template: this.name,\n      provider: this.provider,\n    });\n  }\n\n  protected $provider(): SmsProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(SmsProvider);\n    }\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemorySmsProvider);\n    }\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n$sms[KIND] = SmsPrimitive;\n","export class SmsError extends Error {\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"SmsError\";\n    this.cause = cause;\n  }\n}\n","import { $inject } from \"alepha\";\nimport { FileSystemProvider } from \"alepha/file\";\nimport { $logger } from \"alepha/logger\";\nimport { SmsError } from \"../errors/SmsError.ts\";\nimport type { SmsProvider, SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface LocalSmsProviderOptions {\n  /**\n   * Directory to save SMS files.\n   * @default \"node_modules/.alepha/sms\" (relative to project root)\n   */\n  directory?: string;\n}\n\nexport class LocalSmsProvider implements SmsProvider {\n  protected readonly log = $logger();\n  protected readonly fs = $inject(FileSystemProvider);\n  protected readonly directory: string;\n\n  constructor(options: LocalSmsProviderOptions = {}) {\n    this.directory = options.directory ?? \"node_modules/.alepha/sms\";\n  }\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n\n    this.log.debug(\"Sending SMS to local file\", {\n      to,\n      message,\n      directory: this.directory,\n    });\n\n    try {\n      // Ensure directory exists\n      await this.fs.mkdir(this.directory, { recursive: true });\n\n      // Create filename: phone+date\n      const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n      for (const recipient of Array.isArray(to) ? to : [to]) {\n        const sanitizedPhone = recipient.replace(/[^0-9+]/g, \"_\");\n        const filename = `${sanitizedPhone}+${timestamp}.txt`;\n        const filepath = this.fs.join(this.directory, filename);\n\n        // Create text content\n        const textContent = this.createSmsText({\n          to: recipient,\n          message,\n        });\n\n        // Write to file\n        await this.fs.writeFile(filepath, textContent);\n\n        this.log.info(\"SMS saved to local file\", { filepath, to });\n      }\n    } catch (error) {\n      const message = `Failed to save SMS to local file: ${error instanceof Error ? error.message : String(error)}`;\n      this.log.error(message, { to, directory: this.directory });\n      throw new SmsError(message, error instanceof Error ? error : undefined);\n    }\n  }\n\n  public createSmsText(options: { to: string; message: string }): string {\n    const { to, message } = options;\n    const timestamp = new Date().toISOString();\n\n    return `SMS Message\n===========\n\nSent: ${timestamp}\nTo: ${to}\n\nMessage:\n--------\n${message}\n`;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $sms } from \"./primitives/$sms.ts\";\nimport { LocalSmsProvider } from \"./providers/LocalSmsProvider.ts\";\nimport { MemorySmsProvider } from \"./providers/MemorySmsProvider.ts\";\nimport { SmsProvider } from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./errors/SmsError.ts\";\nexport * from \"./primitives/$sms.ts\";\nexport * from \"./providers/LocalSmsProvider.ts\";\nexport * from \"./providers/MemorySmsProvider.ts\";\nexport * from \"./providers/SmsProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"sms:sending\": {\n      to: string | string[];\n      template: string;\n      variables: Record<string, unknown>;\n      provider: SmsProvider;\n      abort(): void;\n    };\n    \"sms:sent\": {\n      to: string | string[];\n      template: string;\n      provider: SmsProvider;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides SMS sending capabilities for Alepha applications with multiple provider backends.\n *\n * The SMS module enables declarative SMS sending through the `$sms` primitive, allowing you to send\n * text messages through different providers: memory (for testing) or local file system.\n * It supports automatic provider selection based on environment configuration.\n *\n * @see {@link SmsProvider}\n * @module alepha.sms\n */\nexport const AlephaSms = $module({\n  name: \"alepha.sms\",\n  primitives: [$sms],\n  services: [SmsProvider, MemorySmsProvider, LocalSmsProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: SmsProvider,\n      use: MemorySmsProvider,\n    }),\n});\n"],"mappings":";;;;;AASA,IAAa,oBAAb,MAAsD;CACpD,AAAmB,MAAM,SAAS;CAClC,AAAO,UAAuB,EAAE;CAEhC,MAAa,KAAK,SAAwC;EACxD,MAAM,EAAE,IAAI,YAAY;AACxB,OAAK,IAAI,MAAM,+BAA+B;GAAE;GAAI;GAAS,CAAC;AAE9D,OAAK,MAAM,aAAa,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,CACnD,MAAK,QAAQ,KAAK;GAChB,IAAI;GACJ;GACA,wBAAQ,IAAI,MAAM;GACnB,CAAC;;;;;CAON,IAAW,OAA8B;AACvC,SAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;;;;;;;;;;;ACzB9C,IAAsB,cAAtB,MAAkC;;;;ACOlC,MAAa,QAAQ,UAA+B,EAAE,KACpD,gBAAgB,cAAc,QAAQ;;;;;;;;;;;;;;;;;;AA4BxC,IAAa,eAAb,cAAkC,UAA+B;CAC/D,AAAmB,WAAW,KAAK,WAAW;CAE9C,IAAW,OAAO;AAChB,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,OAAO;;;;;CAM7C,MAAa,KAAK,SAAwC;AACxD,QAAM,KAAK,OAAO,OAAO,KAAK,eAAe;GAC3C,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,WAAW,EAAE;GACb,UAAU,KAAK;GACf,aAAa;AACX,UAAM,IAAI,MAAM,8BAA8B;;GAEjD,CAAC;AAEF,QAAM,KAAK,SAAS,KAAK,QAAQ;AAEjC,QAAM,KAAK,OAAO,OAAO,KAAK,YAAY;GACxC,IAAI,QAAQ;GACZ,UAAU,KAAK;GACf,UAAU,KAAK;GAChB,CAAC;;CAGJ,AAAU,YAAyB;AACjC,MAAI,CAAC,KAAK,QAAQ,SAChB,QAAO,KAAK,OAAO,OAAO,YAAY;AAExC,MAAI,KAAK,QAAQ,aAAa,SAC5B,QAAO,KAAK,OAAO,OAAO,kBAAkB;AAE9C,SAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,SAAS;;;AAMpD,KAAK,QAAQ;;;;ACpFb,IAAa,WAAb,cAA8B,MAAM;CAClC,YAAY,SAAiB,OAAe;AAC1C,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,QAAQ;;;;;;ACUjB,IAAa,mBAAb,MAAqD;CACnD,AAAmB,MAAM,SAAS;CAClC,AAAmB,KAAK,QAAQ,mBAAmB;CACnD,AAAmB;CAEnB,YAAY,UAAmC,EAAE,EAAE;AACjD,OAAK,YAAY,QAAQ,aAAa;;CAGxC,MAAa,KAAK,SAAwC;EACxD,MAAM,EAAE,IAAI,YAAY;AAExB,OAAK,IAAI,MAAM,6BAA6B;GAC1C;GACA;GACA,WAAW,KAAK;GACjB,CAAC;AAEF,MAAI;AAEF,SAAM,KAAK,GAAG,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,CAAC;GAGxD,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa,CAAC,QAAQ,SAAS,IAAI;AAChE,QAAK,MAAM,aAAa,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE;IAErD,MAAM,WAAW,GADM,UAAU,QAAQ,YAAY,IAAI,CACtB,GAAG,UAAU;IAChD,MAAM,WAAW,KAAK,GAAG,KAAK,KAAK,WAAW,SAAS;IAGvD,MAAM,cAAc,KAAK,cAAc;KACrC,IAAI;KACJ;KACD,CAAC;AAGF,UAAM,KAAK,GAAG,UAAU,UAAU,YAAY;AAE9C,SAAK,IAAI,KAAK,2BAA2B;KAAE;KAAU;KAAI,CAAC;;WAErD,OAAO;GACd,MAAMA,YAAU,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3G,QAAK,IAAI,MAAMA,WAAS;IAAE;IAAI,WAAW,KAAK;IAAW,CAAC;AAC1D,SAAM,IAAI,SAASA,WAAS,iBAAiB,QAAQ,QAAQ,OAAU;;;CAI3E,AAAO,cAAc,SAAkD;EACrE,MAAM,EAAE,IAAI,YAAY;AAGxB,SAAO;;;yBAFW,IAAI,MAAM,EAAC,aAAa,CAK5B;MACZ,GAAG;;;;EAIP,QAAQ;;;;;;;;;;;;;;;;;AC5BV,MAAa,YAAY,QAAQ;CAC/B,MAAM;CACN,YAAY,CAAC,KAAK;CAClB,UAAU;EAAC;EAAa;EAAmB;EAAiB;CAC5D,WAAW,WACT,OAAO,KAAK;EACV,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC;CACL,CAAC"}

package/dist/thread/index.d.ts

@@ -3,7 +3,6 @@ import { KIND, Primitive, TSchema } from "alepha";
 import * as alepha_logger0 from "alepha/logger";
 
 //#region ../../src/thread/primitives/$thread.d.ts
-
 /**
  * Creates a worker thread primitive for offloading CPU-intensive tasks to separate threads.
  *
@@ -124,83 +123,83 @@ declare const $thread: {
 };
 interface ThreadPrimitiveOptions {
   /**
-   * Unique name for this thread worker.
-   *
-   * Used for:
-   * - Thread pool identification (threads with same name share the same pool)
-   * - Logging and debugging
-   * - Error messages and stack traces
-   *
-   * If not provided, defaults to the property key of the primitive.
-   *
-   * @example "image-processor"
-   * @example "crypto-worker"
-   * @example "data-analysis"
-   */
+       * Unique name for this thread worker.
+       *
+       * Used for:
+       * - Thread pool identification (threads with same name share the same pool)
+       * - Logging and debugging
+       * - Error messages and stack traces
+       *
+       * If not provided, defaults to the property key of the primitive.
+       *
+       * @example "image-processor"
+       * @example "crypto-worker"
+       * @example "data-analysis"
+       */
   name?: string;
   /**
-   * The function to execute in the worker thread.
-   *
-   * This function:
-   * - Runs in a separate Node.js worker thread
-   * - Should contain the CPU-intensive logic
-   * - Can be async and return any serializable data
-   * - Has access to standard Node.js APIs and modules
-   * - Cannot directly access the main thread's memory or variables
-   *
-   * **Important**: The handler function is serialized and sent to the worker thread,
-   * so it cannot reference variables from the parent scope (closures won't work).
-   * All required data must be passed via the `execute()` method.
-   *
-   * @example
-   * ```ts
-   * handler: async () => {
-   *   // CPU-intensive work here
-   *   const result = performComplexCalculation();
-   *   return { result, completed: Date.now() };
-   * }
-   * ```
-   */
+       * The function to execute in the worker thread.
+       *
+       * This function:
+       * - Runs in a separate Node.js worker thread
+       * - Should contain the CPU-intensive logic
+       * - Can be async and return any serializable data
+       * - Has access to standard Node.js APIs and modules
+       * - Cannot directly access the main thread's memory or variables
+       *
+       * **Important**: The handler function is serialized and sent to the worker thread,
+       * so it cannot reference variables from the parent scope (closures won't work).
+       * All required data must be passed via the `execute()` method.
+       *
+       * @example
+       * ```ts
+       * handler: async () => {
+       *   // CPU-intensive work here
+       *   const result = performComplexCalculation();
+       *   return { result, completed: Date.now() };
+       * }
+       * ```
+       */
   handler: () => any | Promise<any>;
   /**
-   * Maximum number of worker threads in the pool.
-   *
-   * Controls how many threads can run concurrently for this named thread worker.
-   * When all threads are busy, additional `execute()` calls will queue until a thread becomes available.
-   *
-   * **Default**: `cpus().length * 2` (number of CPU cores × 2)
-   *
-   * **Guidelines**:
-   * - For CPU-bound tasks: Set to number of CPU cores
-   * - For I/O-bound tasks in workers: Can be higher (2x CPU cores)
-   * - For memory-intensive tasks: Set lower to avoid memory pressure
-   * - For short-lived tasks: Can be higher for better throughput
-   *
-   * @default cpus().length * 2
-   * @example 4    // Limit to 4 concurrent threads
-   * @example 1    // Single worker thread (sequential processing)
-   * @example 16   // High concurrency for lightweight tasks
-   */
+       * Maximum number of worker threads in the pool.
+       *
+       * Controls how many threads can run concurrently for this named thread worker.
+       * When all threads are busy, additional `execute()` calls will queue until a thread becomes available.
+       *
+       * **Default**: `cpus().length * 2` (number of CPU cores × 2)
+       *
+       * **Guidelines**:
+       * - For CPU-bound tasks: Set to number of CPU cores
+       * - For I/O-bound tasks in workers: Can be higher (2x CPU cores)
+       * - For memory-intensive tasks: Set lower to avoid memory pressure
+       * - For short-lived tasks: Can be higher for better throughput
+       *
+       * @default cpus().length * 2
+       * @example 4    // Limit to 4 concurrent threads
+       * @example 1    // Single worker thread (sequential processing)
+       * @example 16   // High concurrency for lightweight tasks
+       */
   maxPoolSize?: number;
   /**
-   * Time in milliseconds before idle worker threads are terminated.
-   *
-   * When a worker thread has been idle (not executing any tasks) for this duration,
-   * it will be automatically terminated to free up system resources. New threads
-   * will be created as needed when new tasks are submitted.
-   *
-   * **Default**: 60000 (60 seconds)
-   *
-   * **Considerations**:
-   * - Shorter timeouts: Save memory but increase thread creation overhead
-   * - Longer timeouts: Keep threads ready but consume more memory
-   * - Very short timeouts may cause constant thread creation/destruction
-   *
-   * @default 60000
-   * @example 30000   // 30 seconds
-   * @example 120000  // 2 minutes
-   * @example 5000    // 5 seconds (for very memory-constrained environments)
-   */
+       * Time in milliseconds before idle worker threads are terminated.
+       *
+       * When a worker thread has been idle (not executing any tasks) for this duration,
+       * it will be automatically terminated to free up system resources. New threads
+       * will be created as needed when new tasks are submitted.
+       *
+       * **Default**: 60000 (60 seconds)
+       *
+       * **Considerations**:
+       * - Shorter timeouts: Save memory but increase thread creation overhead
+       * - Longer timeouts: Keep threads ready but consume more memory
+       * - Very short timeouts may cause constant thread creation/destruction
+       *
+       * @default 60000
+       * @example 30000   // 30 seconds
+       * @example 120000  // 2 minutes
+       * @example 5000    // 5 seconds (for very memory-constrained environments)
+       */
   idleTimeout?: number;
 }
 declare class ThreadPrimitive extends Primitive<ThreadPrimitiveOptions> {

package/dist/thread/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/thread/primitives/$thread.ts","../../src/thread/providers/ThreadProvider.ts","../../src/thread/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAuHA;;;;;;AAMA;AAuFA;;;;;;;;;;;AAwDC;;;;;;;;;AChQD;;;;;;;;ACL8C;;;;;AAsB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cF0Fa;YAAoB,yBAAyB;;;UAMzC,sBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAwCM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+CV,eAAA,SAAwB,UAAU;;8BAEnB,YAAA;;;;;wCA6ByB,UAAU,QAAQ;YAe9C;eAKG;;cA6BtB,UAAA;;;;;;;;;YAgBY;;gCAqEoB,QAAQ;;;;eA8EzB;;;;cC3bR,cAAA;0BAAc,cAAA,CACH;;;;ED0GX,mBAEZ,KAAA,EC5GuB,OAAA,CAOE,aDqGzB,CAAA,OAAA,CAAA;EAFgC,OAAA,OAAA,CAAA,CAAA,EC5CA,OD4CA,CAAA,IAAA,CAAA;;;;;;;EAApB;;;;;;AAMb;AAuFA;AAA+C,cEvLlC,YFuLkC,EEvLtB,OAAA,CAAA,OFuLsB,CEnL7C,OAAA,CAJuB,MAAA,CFuLsB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/thread/primitives/$thread.ts","../../src/thread/providers/ThreadProvider.ts","../../src/thread/index.ts"],"mappings":";;;;;;AAuHA;;;;;;AAMA;AAuFA;;;;;;;;;;;AAwDC;;;;;;;;;AChQD;;;;;;;;ACL8C;;;;;AAsB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cF0Fa,OAAA;EAAA,CAAA,OAAA,EAAoB,sBAAA,GAAyB,eAAA;EAAA;;UAMzC,sBAAA;EAAA;AAuFjB;;;;;;;;;;;AAwDC;;EA/IgB,IAAA;EAAA;AAuFjB;;;;;;;;;;;AAwDC;;;;;;;;;AChQD;;EDiHiB,OAAA,cAwCM,OAAA;EAAA;AA+CvB;;;;;;;;;;;AAwDC;;;;;;;EAvGsB,WAAA;EAAA;AA+CvB;;;;;;;;;;;AAwDC;;;;;;;EAvGsB,WAAA;AAAA;AAAA,cA+CV,eAAA,SAAwB,SAAA,CAAU,sBAAA;EAAA,mBAAA,MAAA;EAAA,gBAAA,UAAA,EAEnB,GAAA,SAAA,UAAA;EAAA,IAAA,KAAA;EAAA,IAAA,YAAA;EAAA,IAAA,YAAA;EAAA,QAAA,OAAA;EAAA,OAAA,SAAA,CAAA,IAAA,QAAA,MAAA,GA6ByB,OAAA,GAAU,OAAA,CAAQ,CAAA;EAAA,OAAA,GAe9C,OAAA;EAAA,UAAA,GAKG,OAAA;AAAA;AAAA,cA6BtB,UAAA;EAAA,iBAAA,IAAA;EAAA,iBAAA,WAAA;EAAA,iBAAA,WAAA;EAAA,iBAAA,MAAA;EAAA,QAAA,SAAA;EAAA,QAAA,KAAA;EAAA,QAAA,SAAA;EAAA,YAAA,IAAA,UAAA,WAAA,UAAA,WAAA,UAAA,MAAA;EAAA,OAAA,GAgBY,OAAA;EAAA,QAAA,cAAA;EAAA,OAAA,SAAA,CAAA,IAAA,SAqEoB,OAAA,CAAQ,CAAA;EAAA,QAAA,YAAA;EAAA,QAAA,cAAA;EAAA,QAAA,oBAAA;EAAA,UAAA,GA8EzB,OAAA;AAAA;;;cC3bR,cAAA;EAAA,mBAAA,GAAA,EAAc,cAAA,CACH,MAAA;EAAA,mBAAA,GAAA;IAAA,aAAA;EAAA;EAAA,mBAAA,KAAA,EAAA,OAAA,CAOE,aAAA;EAAA,OAAA,QAAA,GAuDO,OAAA;AAAA;;;;;;;;;ACpEa;;;;;cAsBjC,YAAA,EAAY,OAAA,CAAA,OAAA,CAIvB,OAAA,CAJuB,MAAA"}