alepha 0.14.4 → 0.15.1

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/datetime/providers/DateTimeProvider.ts","../../src/datetime/primitives/$interval.ts","../../src/datetime/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAmBY,QAAA,GAAW,QAAA,CAAS;KACpB,QAAA,GAAW,aAAA,CAAc;AADzB,KAEA,YAAA,GAFW,MAAA,GAInB,aAAA,CAAc,QAJmB,GAAA,CAAA,MAAA,EAKxB,cALwB,CAAA;AACzB,cAMC,KANU,EAAA,OAML,QANmB;AACzB,cAMC,UAJT,EAAA,CAAA,KAAA,EAAA,OAAc,EAAA,GAAA,KACL,IAGwC,QAH1B;AAEd,cAKA,gBAAA,CALgB;EAChB,OAAA,OAEZ,EAGwB,KAHxB,CAG8B,UALsB,CAEpD,GAAA,CAAA,CAAA;EAEY,UAAA,MAAA,EASK,MATW;EACE,UAAA,GAAA,EASd,QATc,GAAA,IAAA;EAAN,mBAAA,QAAA,EAUM,OAVN,EAAA;EAQP,mBAAA,SAAA,EAGc,QAHd,EAAA;EACD,WAAA,CAAA;EACc,mBAAA,OAAA,EACS,OAAA,CAQZ,aATG,CAAA,OAAA,CAAA;EACC,mBAAA,MAAA,EAQJ,OAAA,CAgBD,aAxBK,CAAA,MAAA,CAAA;EAAQ,SAQZ,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAA,UAgBD,CAAA,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAmBmB,QAnBnB;EAmBmB;;;EASzC,GAAA,CAAA,IAAA,EAAA,MAAA,GAAA,MAAA,GADuB,IACvB,GAD8B,KAC9B,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA,QAAA;EAO+B;;;EAOT,EAAA,CAAA,IAAA,EAAA,MAAA,GAAA,MAAA,GAPS,IAOT,GAPgB,KAOhB,GAAA,IAAA,GAAA,SAAA,CAAA,EAP2C,QAO3C;EAAgB;;;EAoD7B,WAAA,CAAA,IAAA,CAAA,EApDa,IAoDb,GAAA,MAAA,GApD6B,QAoD7B,CAAA,EAAA,MAAA;EACH;;;EAyBY,GAAA,CAAA,CAAA,EAvEP,QAuEO;EAWT;;;;;EAwDA,YAAA,CAAA,CAAA,EAAA,MAAA;EAET;;;;;EA8C4B,SAAA,CAAA,CAAA,EAAA,MAAA;EACnB;;;;;EAqBT,UAAA,cAAA,CAAA,CAAA,EA/KyB,QA+KzB;EA8Ca;;AAalB;EAMiB,QAAA,EAAO,CAAA,QAAA,EApOV,YAoOU,EAAA,IAAA,CAAA,EAnOb,cAmOa,EAAA,GAlOnB,QAkOmB;2CAtN0B;;;ACpKlD;;EAA2D,IAAA,CAAA,CAAA,EDgLpC,OChLoC,CAAA,IAAA,CAAA;;;;AAK3D;AAcA;;EACqC,IAAA,CAAA,QAAA,EDuKvB,YCvKuB,EAAA,QAAA,EAAA;IADE,MAAA,CAAA,ED0KxB,WC1KwB;IAAS,GAAA,CAAA,EAAA,MAAA;MD6K3C;+CA6BS,gCAET;;AEjOL;;gDFqPc,6BAET;wBA8B0B;0BAME;;;;2BAUhB,gBAAgB,QAAQ,cAC3B,eACT,QAAQ;;;;mBAkBC,qBACH,iBACN;;;;WA8Ca;;;;;;UAaD,QAAA;;;;;UAMA,OAAA;;;;;;;;;;;;;;cC1XJ;YAAsB,2BAAwB;;;UAK1C,wBAAA;EDGL;AACZ;AACA;EAKa,OAAA,EAAgB,GAAA,GAAA,OAAX;EACL;AAIb;;EACyB,QAAA,ECPb,YDOa;;AASR,cCXJ,iBAAA,SAA0B,SDWtB,CCXgC,wBDWhC,CAAA,CAAA;EACc,mBAAA,gBAAA,ECXM,gBDWN;EACC,MAAA,EAAA,MAAA;EAAQ,UAQZ,MAAA,CAAA,CAAA,EAAA,IAAA;;;;cE1Cf,gBAAc,OAAA,CAAA,QAIzB,OAAA,CAJyB,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/datetime/providers/DateTimeProvider.ts","../../src/datetime/primitives/$interval.ts","../../src/datetime/index.ts"],"mappings":";;;;;;;;;;;;KAmBY,QAAA,GAAW,QAAA,CAAS,KAAA;AAAA,KACpB,QAAA,GAAW,aAAA,CAAc,QAAA;AAAA,KACzB,YAAA,YAER,aAAA,CAAc,QAAA,YACL,cAAA;AAAA,cAEA,KAAA,SAAK,QAAA;AAAA,cACL,UAAA,GAAc,KAAA,cAAiB,KAAA,IAAS,QAAA;AAAA,cAIxC,gBAAA;EAAA,OACG,OAAA,EAAS,KAAA,CAAM,UAAA;EAAA,UAQnB,MAAA,EAAM,MAAA;EAAA,UACN,GAAA,EAAK,QAAA;EAAA,mBACI,QAAA,EAAU,OAAA;EAAA,mBACV,SAAA,EAAW,QAAA;;qBAQX,OAAA,EARmB,OAAA,CAQZ,aAAA;EAAA,mBAgBP,MAAA,EAhBO,OAAA,CAgBD,aAAA;EAelB,SAAA,CAAU,MAAA;EAIV,UAAA,CAAW,KAAA,YAAiB,KAAA,IAAS,QAAA;EA/D1C;;;EAsEK,GAAA,CACL,IAAA,oBAAwB,IAAA,GAAO,KAAA,sBAC9B,QAAA;EAvEsB;AAE3B;;EA4ES,EAAA,CAAG,IAAA,oBAAwB,IAAA,GAAO,KAAA,sBAA2B,QAAA;EA5EpD;;AAClB;EAkFS,WAAA,CAAY,IAAA,GAAM,IAAA,YAAgB,QAAA;;;;EAOlC,GAAA,CAAA,GAAO,QAAA;EAzFqC;;;AAIrD;;EA8FS,YAAA,CAAA;EA7FsB;;;;;EAyGtB,SAAA,CAAA;EA9F+B;;;;;EAAA,UA0G5B,cAAA,CAAA,GAAkB,QAAA;EA/CM;;;EA0D3B,QAAA,GACL,QAAA,EAAU,YAAA,EACV,IAAA,GAAO,cAAA,KACN,QAAA;EAYI,cAAA,CAAe,KAAA,YAAiB,KAAA,IAAS,YAAA;EA3DlC;;;;EAuED,IAAA,CAAA,GAAQ,OAAA;EAZ2B;;;;;;EAsBzC,IAAA,CACL,QAAA,EAAU,YAAA,EACV,OAAA;IACE,MAAA,GAAS,WAAA;IACT,GAAA;EAAA,IAED,OAAA;EA2BI,cAAA,CACL,GAAA,iBACA,QAAA,EAAU,YAAA,EACV,KAAA,aACC,QAAA;EAoEY;;;EAlDR,aAAA,CACL,QAAA,cACA,QAAA,EAAU,YAAA,EACV,GAAA,YACC,OAAA;EA8BI,YAAA,CAAa,OAAA,EAAS,OAAA;EAMtB,aAAA,CAAc,QAAA,EAAU,QAAA;EA8BnB;;;EArBC,QAAA,GAAA,CACX,EAAA,GAAK,MAAA,EAAQ,WAAA,KAAgB,OAAA,CAAQ,CAAA,GACrC,QAAA,EAAU,YAAA,GACT,OAAA,CAAQ,CAAA;EAkEa;;;EAjDX,MAAA,CACX,QAAA,EAAU,YAAA,EACV,IAAA,GAAO,cAAA,GACN,OAAA;EApS0B;;;EAkVtB,KAAA,CAAA,GAAS,QAAA;EAzUD;;;EAiVR,KAAA,CAAA;AAAA;AAAA,UAKQ,QAAA;EACf,KAAA;EACA,QAAA;EACA,GAAA;AAAA;AAAA,UAGe,OAAA;EACf,GAAA;EACA,KAAA;EACA,QAAA;EACA,QAAA;EACA,KAAA;AAAA;;;;;;;;cC/XW,SAAA;EAAA,UAAsB,wBAAA,GAAwB,iBAAA;EAAA;;UAK1C,wBAAA;EDGL;;;ECCV,OAAA;EDDmC;AACrC;;ECKE,QAAA,EAAU,YAAA;AAAA;AAAA,cAKC,iBAAA,SAA0B,SAAA,CAAU,wBAAA;EAAA,mBAC5B,gBAAA,EAAgB,gBAAA;EAE5B,MAAA;EAAA,UAEG,MAAA,CAAA;AAAA;;;cC1BC,cAAA,EAAc,OAAA,CAAA,OAAA,CAIzB,OAAA,CAJyB,MAAA"}

package/dist/datetime/index.js

@@ -132,16 +132,16 @@ var DateTimeProvider = class DateTimeProvider {
 	*/
 	wait(duration, options = {}) {
 		return new Promise((resolve) => {
-			let clearTimeout$1;
+			let clearTimeout;
 			let callback;
 			const timeout = this.createTimeout(() => {
-				if (options.signal && clearTimeout$1) options.signal.removeEventListener("abort", callback);
+				if (options.signal && clearTimeout) options.signal.removeEventListener("abort", callback);
 				resolve();
 			}, duration, options.now);
 			if (options.signal) {
-				clearTimeout$1 = () => this.clearTimeout(timeout);
+				clearTimeout = () => this.clearTimeout(timeout);
 				callback = () => {
-					clearTimeout$1();
+					clearTimeout();
 					resolve();
 				};
 				options.signal.addEventListener("abort", callback);

package/dist/datetime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["clearTimeout"],"sources":["../../src/datetime/providers/DateTimeProvider.ts","../../src/datetime/primitives/$interval.ts","../../src/datetime/index.ts"],"sourcesContent":["import \"dayjs/plugin/relativeTime.js\";\nimport \"dayjs/plugin/duration.js\";\nimport \"dayjs/plugin/utc.js\";\nimport \"dayjs/plugin/timezone.js\";\nimport \"dayjs/plugin/localizedFormat.js\";\nimport \"dayjs/locale/ar.js\";\nimport \"dayjs/locale/fr.js\";\nimport { $hook, $inject, Alepha } from \"alepha\";\nimport DayjsApi, {\n  type Dayjs,\n  type ManipulateType,\n  type PluginFunc,\n} from \"dayjs\";\nimport dayjsDuration from \"dayjs/plugin/duration.js\";\nimport dayjsLocalizedFormat from \"dayjs/plugin/localizedFormat.js\";\nimport dayjsRelativeTime from \"dayjs/plugin/relativeTime.js\";\nimport dayjsTimezone from \"dayjs/plugin/timezone.js\";\nimport dayjsUtc from \"dayjs/plugin/utc.js\";\n\nexport type DateTime = DayjsApi.Dayjs;\nexport type Duration = dayjsDuration.Duration;\nexport type DurationLike =\n  | number\n  | dayjsDuration.Duration\n  | [number, ManipulateType];\n\nexport const dayjs = DayjsApi;\nexport const isDateTime = (value: unknown): value is DateTime => {\n  return dayjs.isDayjs(value);\n};\n\nexport class DateTimeProvider {\n  public static PLUGINS: Array<PluginFunc<any>> = [\n    dayjsDuration,\n    dayjsRelativeTime,\n    dayjsUtc,\n    dayjsTimezone,\n    dayjsLocalizedFormat,\n  ];\n\n  protected alepha = $inject(Alepha);\n  protected ref: DateTime | null = null;\n  protected readonly timeouts: Timeout[] = [];\n  protected readonly intervals: Interval[] = [];\n\n  constructor() {\n    for (const plugin of DateTimeProvider.PLUGINS) {\n      dayjs.extend(plugin);\n    }\n  }\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      // we start intervals now but first tick will be rejected as App is not ready yet\n      await Promise.all(\n        this.intervals.map(async (interval) => {\n          if (interval.timer != null) {\n            return;\n          }\n          await interval.run();\n          interval.timer = setInterval(interval.run, interval.duration);\n        }),\n      );\n    },\n  });\n\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    handler: () => {\n      for (const timeout of this.timeouts) {\n        this.clearTimeout(timeout);\n      }\n\n      for (const interval of this.intervals) {\n        clearInterval(interval.timer);\n        interval.duration = 0;\n        interval.timer = null;\n      }\n    },\n  });\n\n  public setLocale(locale: string): void {\n    dayjs.locale(locale);\n  }\n\n  public isDateTime(value: unknown): value is DateTime {\n    return dayjs.isDayjs(value);\n  }\n\n  /**\n   * Create a new UTC DateTime instance.\n   */\n  public utc(\n    date: string | number | Date | Dayjs | null | undefined,\n  ): DateTime {\n    return dayjs.utc(date);\n  }\n\n  /**\n   * Create a new DateTime instance.\n   */\n  public of(date: string | number | Date | Dayjs | null | undefined): DateTime {\n    return dayjs(date);\n  }\n\n  /**\n   * Get the current date as a string.\n   */\n  public toISOString(date: Date | string | DateTime = this.now()): string {\n    return this.of(date).toISOString();\n  }\n\n  /**\n   * Get the current date.\n   */\n  public now(): DateTime {\n    return this.getCurrentDate();\n  }\n\n  /**\n   * Get the current date as a string.\n   *\n   * This is much faster than `DateTimeProvider.now().toISOString()` as it avoids creating a DateTime instance.\n   */\n  public nowISOString(): string {\n    if (this.ref) {\n      return this.ref.toISOString();\n    }\n    return new Date().toISOString();\n  }\n\n  /**\n   * Get the current date as milliseconds since epoch.\n   *\n   * This is much faster than `DateTimeProvider.now().valueOf()` as it avoids creating a DateTime instance.\n   */\n  public nowMillis(): number {\n    if (this.ref) {\n      return this.ref.valueOf();\n    }\n    return Date.now();\n  }\n\n  /**\n   * Get the current date as a string.\n   *\n   * @protected\n   */\n  protected getCurrentDate(): DateTime {\n    if (this.ref) {\n      return this.ref;\n    }\n\n    return dayjs();\n  }\n\n  /**\n   * Create a new Duration instance.\n   */\n  public duration = (\n    duration: DurationLike,\n    unit?: ManipulateType,\n  ): Duration => {\n    if (Array.isArray(duration)) {\n      return dayjs.duration(duration[0], duration[1]);\n    }\n\n    if (typeof duration === \"number\") {\n      return dayjs.duration(duration, unit || \"milliseconds\");\n    }\n\n    return duration;\n  };\n\n  public isDurationLike(value: unknown): value is DurationLike {\n    return dayjs.isDuration(this.duration(value as DurationLike));\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  // Timer Management\n\n  /**\n   * Return a promise that resolves after the next tick.\n   * It uses `setTimeout` with 0 ms delay.\n   */\n  public async tick(): Promise<void> {\n    await new Promise((resolve) => setTimeout(resolve, 0));\n  }\n\n  /**\n   * Wait for a certain duration.\n   *\n   * You can clear the timeout by using the `AbortSignal` API.\n   * Aborted signal will resolve the promise immediately, it does not reject it.\n   */\n  public wait(\n    duration: DurationLike,\n    options: {\n      signal?: AbortSignal;\n      now?: number;\n    } = {},\n  ): Promise<void> {\n    return new Promise((resolve) => {\n      let clearTimeout: any;\n      let callback: any;\n\n      const timeout = this.createTimeout(\n        () => {\n          if (options.signal && clearTimeout) {\n            options.signal.removeEventListener(\"abort\", callback);\n          }\n          resolve();\n        },\n        duration,\n        options.now,\n      );\n\n      if (options.signal) {\n        clearTimeout = () => this.clearTimeout(timeout);\n        callback = () => {\n          clearTimeout();\n          resolve();\n        };\n        options.signal.addEventListener(\"abort\", callback);\n      }\n    });\n  }\n\n  public createInterval(\n    run: () => unknown,\n    duration: DurationLike,\n    start = false,\n  ): Interval {\n    const interval: Interval = {\n      run,\n      duration: this.duration(duration).asMilliseconds(),\n    };\n\n    this.intervals.push(interval);\n\n    if (start) {\n      interval.timer = setInterval(interval.run, interval.duration);\n    }\n\n    return interval;\n  }\n\n  /**\n   * Run a callback after a certain duration.\n   */\n  public createTimeout(\n    callback: () => void,\n    duration: DurationLike,\n    now?: number,\n  ): Timeout {\n    if (this.ref && now) {\n      const next = this.of(now).add(this.duration(duration));\n      if (next < this.now()) {\n        callback();\n      }\n      return {\n        now,\n        duration: 0,\n        callback: () => {},\n        clear: () => {},\n      };\n    }\n\n    const timeout: Timeout = {\n      now: now ?? this.now().valueOf(),\n      duration: this.duration(duration).asMilliseconds(),\n      callback,\n      clear: () => this.clearTimeout(timeout),\n    };\n\n    timeout.timer = setTimeout(() => {\n      timeout.callback();\n    }, timeout.duration);\n\n    this.timeouts.push(timeout);\n\n    return timeout;\n  }\n\n  public clearTimeout(timeout: Timeout): void {\n    clearTimeout(timeout.timer);\n    timeout.duration = 0;\n    timeout.timer = null;\n  }\n\n  public clearInterval(interval: Interval): void {\n    clearInterval(interval.timer);\n    interval.duration = 0;\n    interval.timer = null;\n  }\n\n  /**\n   * Run a function with a deadline.\n   */\n  public async deadline<T>(\n    fn: (signal: AbortSignal) => Promise<T>,\n    duration: DurationLike,\n  ): Promise<T> {\n    const abort = new AbortController();\n    const timeout = this.createTimeout(() => abort.abort(), duration);\n    try {\n      return await fn(abort.signal);\n    } finally {\n      this.clearTimeout(timeout);\n    }\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  // Testing\n\n  /**\n   * Add time to the current date.\n   */\n  public async travel(\n    duration: DurationLike,\n    unit?: ManipulateType,\n  ): Promise<void> {\n    this.ref = this.ref || this.now();\n    this.ref = this.ref.add(this.duration(duration, unit));\n    const ms = this.duration(duration, unit).asMilliseconds();\n    const now = Date.now();\n\n    for (const timeout of this.timeouts) {\n      if (!timeout.timer) {\n        continue;\n      }\n\n      clearTimeout(timeout.timer);\n      timeout.timer = null;\n\n      const spent = now - timeout.now;\n      timeout.duration = timeout.duration - spent - ms;\n\n      if (timeout.duration <= 0) {\n        timeout.callback();\n      } else {\n        timeout.timer = setTimeout(() => {\n          timeout.callback();\n        }, timeout.duration);\n      }\n    }\n\n    for (const interval of this.intervals) {\n      if (!interval.timer) {\n        continue;\n      }\n\n      clearInterval(interval.timer);\n      interval.timer = null;\n\n      const repeat = Math.floor(ms / interval.duration);\n      for (let i = 0; i < repeat; i++) {\n        await interval.run();\n      }\n    }\n\n    await this.tick();\n  }\n\n  /**\n   * Stop the time.\n   */\n  public pause(): DateTime {\n    this.ref = this.ref || this.now();\n    return this.ref;\n  }\n\n  /**\n   * Reset the reference date.\n   */\n  public reset(): void {\n    this.ref = null;\n  }\n}\n\nexport interface Interval {\n  timer?: any;\n  duration: number;\n  run: () => unknown;\n}\n\nexport interface Timeout {\n  now: number;\n  timer?: any;\n  duration: number;\n  callback: () => void;\n  clear: () => void;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport {\n  DateTimeProvider,\n  type DurationLike,\n} from \"../providers/DateTimeProvider.ts\";\n\n/**\n * Run a function periodically.\n * It uses the `setInterval` internally.\n * It starts by default when the context starts and stops when the context stops.\n */\nexport const $interval = (options: IntervalPrimitiveOptions) =>\n  createPrimitive(IntervalPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface IntervalPrimitiveOptions {\n  /**\n   * The interval handler.\n   */\n  handler: () => unknown;\n\n  /**\n   * The interval duration.\n   */\n  duration: DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class IntervalPrimitive extends Primitive<IntervalPrimitiveOptions> {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  public called = 0;\n\n  protected onInit() {\n    this.dateTimeProvider.createInterval(async () => {\n      await this.options.handler();\n      this.called += 1;\n    }, this.options.duration);\n  }\n}\n\n$interval[KIND] = IntervalPrimitive;\n","import { $module } from \"alepha\";\nimport { $interval } from \"./primitives/$interval.ts\";\nimport { DateTimeProvider } from \"./providers/DateTimeProvider.ts\";\n\nexport * from \"./primitives/$interval.ts\";\nexport * from \"./providers/DateTimeProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaDateTime = $module({\n  name: \"alepha.datetime\",\n  primitives: [$interval],\n  services: [DateTimeProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/datetime/providers/DateTimeProvider.ts","../../src/datetime/primitives/$interval.ts","../../src/datetime/index.ts"],"sourcesContent":["import \"dayjs/plugin/relativeTime.js\";\nimport \"dayjs/plugin/duration.js\";\nimport \"dayjs/plugin/utc.js\";\nimport \"dayjs/plugin/timezone.js\";\nimport \"dayjs/plugin/localizedFormat.js\";\nimport \"dayjs/locale/ar.js\";\nimport \"dayjs/locale/fr.js\";\nimport { $hook, $inject, Alepha } from \"alepha\";\nimport DayjsApi, {\n  type Dayjs,\n  type ManipulateType,\n  type PluginFunc,\n} from \"dayjs\";\nimport dayjsDuration from \"dayjs/plugin/duration.js\";\nimport dayjsLocalizedFormat from \"dayjs/plugin/localizedFormat.js\";\nimport dayjsRelativeTime from \"dayjs/plugin/relativeTime.js\";\nimport dayjsTimezone from \"dayjs/plugin/timezone.js\";\nimport dayjsUtc from \"dayjs/plugin/utc.js\";\n\nexport type DateTime = DayjsApi.Dayjs;\nexport type Duration = dayjsDuration.Duration;\nexport type DurationLike =\n  | number\n  | dayjsDuration.Duration\n  | [number, ManipulateType];\n\nexport const dayjs = DayjsApi;\nexport const isDateTime = (value: unknown): value is DateTime => {\n  return dayjs.isDayjs(value);\n};\n\nexport class DateTimeProvider {\n  public static PLUGINS: Array<PluginFunc<any>> = [\n    dayjsDuration,\n    dayjsRelativeTime,\n    dayjsUtc,\n    dayjsTimezone,\n    dayjsLocalizedFormat,\n  ];\n\n  protected alepha = $inject(Alepha);\n  protected ref: DateTime | null = null;\n  protected readonly timeouts: Timeout[] = [];\n  protected readonly intervals: Interval[] = [];\n\n  constructor() {\n    for (const plugin of DateTimeProvider.PLUGINS) {\n      dayjs.extend(plugin);\n    }\n  }\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      // we start intervals now but first tick will be rejected as App is not ready yet\n      await Promise.all(\n        this.intervals.map(async (interval) => {\n          if (interval.timer != null) {\n            return;\n          }\n          await interval.run();\n          interval.timer = setInterval(interval.run, interval.duration);\n        }),\n      );\n    },\n  });\n\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    handler: () => {\n      for (const timeout of this.timeouts) {\n        this.clearTimeout(timeout);\n      }\n\n      for (const interval of this.intervals) {\n        clearInterval(interval.timer);\n        interval.duration = 0;\n        interval.timer = null;\n      }\n    },\n  });\n\n  public setLocale(locale: string): void {\n    dayjs.locale(locale);\n  }\n\n  public isDateTime(value: unknown): value is DateTime {\n    return dayjs.isDayjs(value);\n  }\n\n  /**\n   * Create a new UTC DateTime instance.\n   */\n  public utc(\n    date: string | number | Date | Dayjs | null | undefined,\n  ): DateTime {\n    return dayjs.utc(date);\n  }\n\n  /**\n   * Create a new DateTime instance.\n   */\n  public of(date: string | number | Date | Dayjs | null | undefined): DateTime {\n    return dayjs(date);\n  }\n\n  /**\n   * Get the current date as a string.\n   */\n  public toISOString(date: Date | string | DateTime = this.now()): string {\n    return this.of(date).toISOString();\n  }\n\n  /**\n   * Get the current date.\n   */\n  public now(): DateTime {\n    return this.getCurrentDate();\n  }\n\n  /**\n   * Get the current date as a string.\n   *\n   * This is much faster than `DateTimeProvider.now().toISOString()` as it avoids creating a DateTime instance.\n   */\n  public nowISOString(): string {\n    if (this.ref) {\n      return this.ref.toISOString();\n    }\n    return new Date().toISOString();\n  }\n\n  /**\n   * Get the current date as milliseconds since epoch.\n   *\n   * This is much faster than `DateTimeProvider.now().valueOf()` as it avoids creating a DateTime instance.\n   */\n  public nowMillis(): number {\n    if (this.ref) {\n      return this.ref.valueOf();\n    }\n    return Date.now();\n  }\n\n  /**\n   * Get the current date as a string.\n   *\n   * @protected\n   */\n  protected getCurrentDate(): DateTime {\n    if (this.ref) {\n      return this.ref;\n    }\n\n    return dayjs();\n  }\n\n  /**\n   * Create a new Duration instance.\n   */\n  public duration = (\n    duration: DurationLike,\n    unit?: ManipulateType,\n  ): Duration => {\n    if (Array.isArray(duration)) {\n      return dayjs.duration(duration[0], duration[1]);\n    }\n\n    if (typeof duration === \"number\") {\n      return dayjs.duration(duration, unit || \"milliseconds\");\n    }\n\n    return duration;\n  };\n\n  public isDurationLike(value: unknown): value is DurationLike {\n    return dayjs.isDuration(this.duration(value as DurationLike));\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  // Timer Management\n\n  /**\n   * Return a promise that resolves after the next tick.\n   * It uses `setTimeout` with 0 ms delay.\n   */\n  public async tick(): Promise<void> {\n    await new Promise((resolve) => setTimeout(resolve, 0));\n  }\n\n  /**\n   * Wait for a certain duration.\n   *\n   * You can clear the timeout by using the `AbortSignal` API.\n   * Aborted signal will resolve the promise immediately, it does not reject it.\n   */\n  public wait(\n    duration: DurationLike,\n    options: {\n      signal?: AbortSignal;\n      now?: number;\n    } = {},\n  ): Promise<void> {\n    return new Promise((resolve) => {\n      let clearTimeout: any;\n      let callback: any;\n\n      const timeout = this.createTimeout(\n        () => {\n          if (options.signal && clearTimeout) {\n            options.signal.removeEventListener(\"abort\", callback);\n          }\n          resolve();\n        },\n        duration,\n        options.now,\n      );\n\n      if (options.signal) {\n        clearTimeout = () => this.clearTimeout(timeout);\n        callback = () => {\n          clearTimeout();\n          resolve();\n        };\n        options.signal.addEventListener(\"abort\", callback);\n      }\n    });\n  }\n\n  public createInterval(\n    run: () => unknown,\n    duration: DurationLike,\n    start = false,\n  ): Interval {\n    const interval: Interval = {\n      run,\n      duration: this.duration(duration).asMilliseconds(),\n    };\n\n    this.intervals.push(interval);\n\n    if (start) {\n      interval.timer = setInterval(interval.run, interval.duration);\n    }\n\n    return interval;\n  }\n\n  /**\n   * Run a callback after a certain duration.\n   */\n  public createTimeout(\n    callback: () => void,\n    duration: DurationLike,\n    now?: number,\n  ): Timeout {\n    if (this.ref && now) {\n      const next = this.of(now).add(this.duration(duration));\n      if (next < this.now()) {\n        callback();\n      }\n      return {\n        now,\n        duration: 0,\n        callback: () => {},\n        clear: () => {},\n      };\n    }\n\n    const timeout: Timeout = {\n      now: now ?? this.now().valueOf(),\n      duration: this.duration(duration).asMilliseconds(),\n      callback,\n      clear: () => this.clearTimeout(timeout),\n    };\n\n    timeout.timer = setTimeout(() => {\n      timeout.callback();\n    }, timeout.duration);\n\n    this.timeouts.push(timeout);\n\n    return timeout;\n  }\n\n  public clearTimeout(timeout: Timeout): void {\n    clearTimeout(timeout.timer);\n    timeout.duration = 0;\n    timeout.timer = null;\n  }\n\n  public clearInterval(interval: Interval): void {\n    clearInterval(interval.timer);\n    interval.duration = 0;\n    interval.timer = null;\n  }\n\n  /**\n   * Run a function with a deadline.\n   */\n  public async deadline<T>(\n    fn: (signal: AbortSignal) => Promise<T>,\n    duration: DurationLike,\n  ): Promise<T> {\n    const abort = new AbortController();\n    const timeout = this.createTimeout(() => abort.abort(), duration);\n    try {\n      return await fn(abort.signal);\n    } finally {\n      this.clearTimeout(timeout);\n    }\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  // Testing\n\n  /**\n   * Add time to the current date.\n   */\n  public async travel(\n    duration: DurationLike,\n    unit?: ManipulateType,\n  ): Promise<void> {\n    this.ref = this.ref || this.now();\n    this.ref = this.ref.add(this.duration(duration, unit));\n    const ms = this.duration(duration, unit).asMilliseconds();\n    const now = Date.now();\n\n    for (const timeout of this.timeouts) {\n      if (!timeout.timer) {\n        continue;\n      }\n\n      clearTimeout(timeout.timer);\n      timeout.timer = null;\n\n      const spent = now - timeout.now;\n      timeout.duration = timeout.duration - spent - ms;\n\n      if (timeout.duration <= 0) {\n        timeout.callback();\n      } else {\n        timeout.timer = setTimeout(() => {\n          timeout.callback();\n        }, timeout.duration);\n      }\n    }\n\n    for (const interval of this.intervals) {\n      if (!interval.timer) {\n        continue;\n      }\n\n      clearInterval(interval.timer);\n      interval.timer = null;\n\n      const repeat = Math.floor(ms / interval.duration);\n      for (let i = 0; i < repeat; i++) {\n        await interval.run();\n      }\n    }\n\n    await this.tick();\n  }\n\n  /**\n   * Stop the time.\n   */\n  public pause(): DateTime {\n    this.ref = this.ref || this.now();\n    return this.ref;\n  }\n\n  /**\n   * Reset the reference date.\n   */\n  public reset(): void {\n    this.ref = null;\n  }\n}\n\nexport interface Interval {\n  timer?: any;\n  duration: number;\n  run: () => unknown;\n}\n\nexport interface Timeout {\n  now: number;\n  timer?: any;\n  duration: number;\n  callback: () => void;\n  clear: () => void;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport {\n  DateTimeProvider,\n  type DurationLike,\n} from \"../providers/DateTimeProvider.ts\";\n\n/**\n * Run a function periodically.\n * It uses the `setInterval` internally.\n * It starts by default when the context starts and stops when the context stops.\n */\nexport const $interval = (options: IntervalPrimitiveOptions) =>\n  createPrimitive(IntervalPrimitive, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface IntervalPrimitiveOptions {\n  /**\n   * The interval handler.\n   */\n  handler: () => unknown;\n\n  /**\n   * The interval duration.\n   */\n  duration: DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class IntervalPrimitive extends Primitive<IntervalPrimitiveOptions> {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  public called = 0;\n\n  protected onInit() {\n    this.dateTimeProvider.createInterval(async () => {\n      await this.options.handler();\n      this.called += 1;\n    }, this.options.duration);\n  }\n}\n\n$interval[KIND] = IntervalPrimitive;\n","import { $module } from \"alepha\";\nimport { $interval } from \"./primitives/$interval.ts\";\nimport { DateTimeProvider } from \"./providers/DateTimeProvider.ts\";\n\nexport * from \"./primitives/$interval.ts\";\nexport * from \"./providers/DateTimeProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaDateTime = $module({\n  name: \"alepha.datetime\",\n  primitives: [$interval],\n  services: [DateTimeProvider],\n});\n"],"mappings":";;;;;;;;;;;AA0BA,MAAa,QAAQ;AACrB,MAAa,cAAc,UAAsC;AAC/D,QAAO,MAAM,QAAQ,MAAM;;AAG7B,IAAa,mBAAb,MAAa,iBAAiB;CAC5B,OAAc,UAAkC;EAC9C;EACA;EACA;EACA;EACA;EACD;CAED,AAAU,SAAS,QAAQ,OAAO;CAClC,AAAU,MAAuB;CACjC,AAAmB,WAAsB,EAAE;CAC3C,AAAmB,YAAwB,EAAE;CAE7C,cAAc;AACZ,OAAK,MAAM,UAAU,iBAAiB,QACpC,OAAM,OAAO,OAAO;;CAIxB,AAAmB,UAAU,MAAM;EACjC,IAAI;EACJ,SAAS,YAAY;AAEnB,SAAM,QAAQ,IACZ,KAAK,UAAU,IAAI,OAAO,aAAa;AACrC,QAAI,SAAS,SAAS,KACpB;AAEF,UAAM,SAAS,KAAK;AACpB,aAAS,QAAQ,YAAY,SAAS,KAAK,SAAS,SAAS;KAC7D,CACH;;EAEJ,CAAC;CAEF,AAAmB,SAAS,MAAM;EAChC,IAAI;EACJ,eAAe;AACb,QAAK,MAAM,WAAW,KAAK,SACzB,MAAK,aAAa,QAAQ;AAG5B,QAAK,MAAM,YAAY,KAAK,WAAW;AACrC,kBAAc,SAAS,MAAM;AAC7B,aAAS,WAAW;AACpB,aAAS,QAAQ;;;EAGtB,CAAC;CAEF,AAAO,UAAU,QAAsB;AACrC,QAAM,OAAO,OAAO;;CAGtB,AAAO,WAAW,OAAmC;AACnD,SAAO,MAAM,QAAQ,MAAM;;;;;CAM7B,AAAO,IACL,MACU;AACV,SAAO,MAAM,IAAI,KAAK;;;;;CAMxB,AAAO,GAAG,MAAmE;AAC3E,SAAO,MAAM,KAAK;;;;;CAMpB,AAAO,YAAY,OAAiC,KAAK,KAAK,EAAU;AACtE,SAAO,KAAK,GAAG,KAAK,CAAC,aAAa;;;;;CAMpC,AAAO,MAAgB;AACrB,SAAO,KAAK,gBAAgB;;;;;;;CAQ9B,AAAO,eAAuB;AAC5B,MAAI,KAAK,IACP,QAAO,KAAK,IAAI,aAAa;AAE/B,0BAAO,IAAI,MAAM,EAAC,aAAa;;;;;;;CAQjC,AAAO,YAAoB;AACzB,MAAI,KAAK,IACP,QAAO,KAAK,IAAI,SAAS;AAE3B,SAAO,KAAK,KAAK;;;;;;;CAQnB,AAAU,iBAA2B;AACnC,MAAI,KAAK,IACP,QAAO,KAAK;AAGd,SAAO,OAAO;;;;;CAMhB,AAAO,YACL,UACA,SACa;AACb,MAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,MAAM,SAAS,SAAS,IAAI,SAAS,GAAG;AAGjD,MAAI,OAAO,aAAa,SACtB,QAAO,MAAM,SAAS,UAAU,QAAQ,eAAe;AAGzD,SAAO;;CAGT,AAAO,eAAe,OAAuC;AAC3D,SAAO,MAAM,WAAW,KAAK,SAAS,MAAsB,CAAC;;;;;;CAW/D,MAAa,OAAsB;AACjC,QAAM,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;;;;;;;;CASxD,AAAO,KACL,UACA,UAGI,EAAE,EACS;AACf,SAAO,IAAI,SAAS,YAAY;GAC9B,IAAI;GACJ,IAAI;GAEJ,MAAM,UAAU,KAAK,oBACb;AACJ,QAAI,QAAQ,UAAU,aACpB,SAAQ,OAAO,oBAAoB,SAAS,SAAS;AAEvD,aAAS;MAEX,UACA,QAAQ,IACT;AAED,OAAI,QAAQ,QAAQ;AAClB,yBAAqB,KAAK,aAAa,QAAQ;AAC/C,qBAAiB;AACf,mBAAc;AACd,cAAS;;AAEX,YAAQ,OAAO,iBAAiB,SAAS,SAAS;;IAEpD;;CAGJ,AAAO,eACL,KACA,UACA,QAAQ,OACE;EACV,MAAM,WAAqB;GACzB;GACA,UAAU,KAAK,SAAS,SAAS,CAAC,gBAAgB;GACnD;AAED,OAAK,UAAU,KAAK,SAAS;AAE7B,MAAI,MACF,UAAS,QAAQ,YAAY,SAAS,KAAK,SAAS,SAAS;AAG/D,SAAO;;;;;CAMT,AAAO,cACL,UACA,UACA,KACS;AACT,MAAI,KAAK,OAAO,KAAK;AAEnB,OADa,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,SAAS,CAAC,GAC3C,KAAK,KAAK,CACnB,WAAU;AAEZ,UAAO;IACL;IACA,UAAU;IACV,gBAAgB;IAChB,aAAa;IACd;;EAGH,MAAM,UAAmB;GACvB,KAAK,OAAO,KAAK,KAAK,CAAC,SAAS;GAChC,UAAU,KAAK,SAAS,SAAS,CAAC,gBAAgB;GAClD;GACA,aAAa,KAAK,aAAa,QAAQ;GACxC;AAED,UAAQ,QAAQ,iBAAiB;AAC/B,WAAQ,UAAU;KACjB,QAAQ,SAAS;AAEpB,OAAK,SAAS,KAAK,QAAQ;AAE3B,SAAO;;CAGT,AAAO,aAAa,SAAwB;AAC1C,eAAa,QAAQ,MAAM;AAC3B,UAAQ,WAAW;AACnB,UAAQ,QAAQ;;CAGlB,AAAO,cAAc,UAA0B;AAC7C,gBAAc,SAAS,MAAM;AAC7B,WAAS,WAAW;AACpB,WAAS,QAAQ;;;;;CAMnB,MAAa,SACX,IACA,UACY;EACZ,MAAM,QAAQ,IAAI,iBAAiB;EACnC,MAAM,UAAU,KAAK,oBAAoB,MAAM,OAAO,EAAE,SAAS;AACjE,MAAI;AACF,UAAO,MAAM,GAAG,MAAM,OAAO;YACrB;AACR,QAAK,aAAa,QAAQ;;;;;;CAW9B,MAAa,OACX,UACA,MACe;AACf,OAAK,MAAM,KAAK,OAAO,KAAK,KAAK;AACjC,OAAK,MAAM,KAAK,IAAI,IAAI,KAAK,SAAS,UAAU,KAAK,CAAC;EACtD,MAAM,KAAK,KAAK,SAAS,UAAU,KAAK,CAAC,gBAAgB;EACzD,MAAM,MAAM,KAAK,KAAK;AAEtB,OAAK,MAAM,WAAW,KAAK,UAAU;AACnC,OAAI,CAAC,QAAQ,MACX;AAGF,gBAAa,QAAQ,MAAM;AAC3B,WAAQ,QAAQ;GAEhB,MAAM,QAAQ,MAAM,QAAQ;AAC5B,WAAQ,WAAW,QAAQ,WAAW,QAAQ;AAE9C,OAAI,QAAQ,YAAY,EACtB,SAAQ,UAAU;OAElB,SAAQ,QAAQ,iBAAiB;AAC/B,YAAQ,UAAU;MACjB,QAAQ,SAAS;;AAIxB,OAAK,MAAM,YAAY,KAAK,WAAW;AACrC,OAAI,CAAC,SAAS,MACZ;AAGF,iBAAc,SAAS,MAAM;AAC7B,YAAS,QAAQ;GAEjB,MAAM,SAAS,KAAK,MAAM,KAAK,SAAS,SAAS;AACjD,QAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IAC1B,OAAM,SAAS,KAAK;;AAIxB,QAAM,KAAK,MAAM;;;;;CAMnB,AAAO,QAAkB;AACvB,OAAK,MAAM,KAAK,OAAO,KAAK,KAAK;AACjC,SAAO,KAAK;;;;;CAMd,AAAO,QAAc;AACnB,OAAK,MAAM;;;;;;;;;;;AChXf,MAAa,aAAa,YACxB,gBAAgB,mBAAmB,QAAQ;AAkB7C,IAAa,oBAAb,cAAuC,UAAoC;CACzE,AAAmB,mBAAmB,QAAQ,iBAAiB;CAE/D,AAAO,SAAS;CAEhB,AAAU,SAAS;AACjB,OAAK,iBAAiB,eAAe,YAAY;AAC/C,SAAM,KAAK,QAAQ,SAAS;AAC5B,QAAK,UAAU;KACd,KAAK,QAAQ,SAAS;;;AAI7B,UAAU,QAAQ;;;;AClClB,MAAa,iBAAiB,QAAQ;CACpC,MAAM;CACN,YAAY,CAAC,UAAU;CACvB,UAAU,CAAC,iBAAiB;CAC7B,CAAC"}

package/dist/email/index.d.ts

@@ -1,6 +1,7 @@
-import * as alepha1 from "alepha";
-import { InstantiableClass, KIND, Primitive } from "alepha";
+import * as alepha15 from "alepha";
+import { InstantiableClass, KIND, Primitive, Static } from "alepha";
 import * as alepha_logger0 from "alepha/logger";
+import { FileSystemProvider } from "alepha/file";
 import { Transporter } from "nodemailer";
 
 //#region ../../src/email/providers/EmailProvider.d.ts
@@ -66,16 +67,26 @@ declare class EmailPrimitive extends Primitive<EmailPrimitiveOptions> {
 }
 //#endregion
 //#region ../../src/email/providers/LocalEmailProvider.d.ts
-interface LocalEmailProviderOptions {
-  /**
-   * Directory to save email files.
-   */
-  directory?: string;
+/**
+ * Local email provider configuration atom
+ */
+declare const localEmailOptions: alepha15.Atom<alepha15.TObject<{
+  directory: alepha15.TString;
+}>, "alepha.email.local.options">;
+type LocalEmailProviderOptions = Static<typeof localEmailOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [localEmailOptions.key]: LocalEmailProviderOptions;
+  }
 }
 declare class LocalEmailProvider implements EmailProvider {
   protected readonly log: alepha_logger0.Logger;
-  protected readonly directory: string;
-  constructor(options?: LocalEmailProviderOptions);
+  protected readonly fs: FileSystemProvider;
+  protected readonly options: Readonly<{
+    directory: string;
+  }>;
+  protected get directory(): string;
+  protected onStart: alepha15.HookPrimitive<"start">;
   send(options: EmailSendOptions): Promise<void>;
   createEmailHtml(options: {
     to: string;
@@ -103,42 +114,78 @@ declare class MemoryEmailProvider implements EmailProvider {
 }
 //#endregion
 //#region ../../src/email/providers/NodemailerEmailProvider.d.ts
-interface NodemailerEmailProviderOptions {
-  /**
-   * Custom transporter configuration.
-   * If provided, will override environment variables.
-   */
-  transporter?: Transporter;
-  /**
-   * Custom from email address.
-   * If not provided, will use EMAIL_FROM from environment.
-   */
-  from?: string;
-  /**
-   * Additional nodemailer options.
-   */
-  options?: {
-    pool?: boolean;
-    maxConnections?: number;
-    maxMessages?: number;
-    rateDelta?: number;
-    rateLimit?: number;
-  };
+/**
+ * Nodemailer connection pooling and rate limiting options
+ */
+declare const nodemailerEmailOptions: alepha15.Atom<alepha15.TObject<{
+  pool: alepha15.TOptional<alepha15.TBoolean>;
+  maxConnections: alepha15.TOptional<alepha15.TNumber>;
+  maxMessages: alepha15.TOptional<alepha15.TNumber>;
+  rateDelta: alepha15.TOptional<alepha15.TNumber>;
+  rateLimit: alepha15.TOptional<alepha15.TNumber>;
+}>, "alepha.email.nodemailer.options">;
+type NodemailerEmailProviderOptions = Static<typeof nodemailerEmailOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [nodemailerEmailOptions.key]: NodemailerEmailProviderOptions;
+  }
 }
+/**
+ * Email provider using Nodemailer for SMTP transport.
+ *
+ * Configuration is provided via environment variables:
+ * - EMAIL_HOST: SMTP server host
+ * - EMAIL_PORT: SMTP server port (default: 587)
+ * - EMAIL_USER: SMTP authentication username
+ * - EMAIL_PASS: SMTP authentication password
+ * - EMAIL_FROM: Default from email address
+ * - EMAIL_SECURE: Use secure connection (default: false)
+ *
+ * Advanced pooling/rate limiting options can be configured via atom:
+ * @see {@link nodemailerEmailOptions}
+ *
+ * @example
+ * ```typescript
+ * // Configure via environment variables
+ * // EMAIL_HOST=smtp.example.com
+ * // EMAIL_PORT=587
+ * // EMAIL_USER=user@example.com
+ * // EMAIL_PASS=secret
+ * // EMAIL_FROM=noreply@example.com
+ *
+ * // Optionally configure pooling via atom
+ * alepha.state.set(nodemailerEmailOptions.key, {
+ *   pool: true,
+ *   maxConnections: 5,
+ *   rateLimit: 10,
+ * });
+ * ```
+ */
 declare class NodemailerEmailProvider implements EmailProvider {
   protected readonly env: {
-    EMAIL_HOST: string;
+    EMAIL_HOST?: string | undefined;
+    EMAIL_USER?: string | undefined;
+    EMAIL_PASS?: string | undefined;
+    EMAIL_FROM?: string | undefined;
     EMAIL_PORT: number;
-    EMAIL_USER: string;
-    EMAIL_PASS: string;
-    EMAIL_FROM: string;
     EMAIL_SECURE: boolean;
   };
   protected readonly log: alepha_logger0.Logger;
-  protected transporter: Transporter;
-  protected fromAddress: string;
-  readonly options: NodemailerEmailProviderOptions;
-  constructor();
+  protected readonly options: Readonly<{
+    pool?: boolean | undefined;
+    maxConnections?: number | undefined;
+    maxMessages?: number | undefined;
+    rateDelta?: number | undefined;
+    rateLimit?: number | undefined;
+  }>;
+  protected transporter: Transporter | null;
+  protected get host(): string;
+  protected get port(): number;
+  protected get secure(): boolean;
+  protected get user(): string | undefined;
+  protected get pass(): string | undefined;
+  protected get fromAddress(): string;
+  protected getTransporter(): Transporter;
   send(options: EmailSendOptions): Promise<void>;
   protected createTransporter(): Transporter;
   /**
@@ -149,8 +196,8 @@ declare class NodemailerEmailProvider implements EmailProvider {
    * Close the transporter connection.
    */
   close(): void;
-  protected readonly onStart: alepha1.HookPrimitive<"start">;
-  protected readonly onStop: alepha1.HookPrimitive<"stop">;
+  protected readonly onStart: alepha15.HookPrimitive<"start">;
+  protected readonly onStop: alepha15.HookPrimitive<"stop">;
 }
 //#endregion
 //#region ../../src/email/index.d.ts
@@ -180,7 +227,7 @@ declare module "alepha" {
  * @see {@link EmailProvider}
  * @module alepha.email
  */
-declare const AlephaEmail: alepha1.Service<alepha1.Module>;
+declare const AlephaEmail: alepha15.Service<alepha15.Module>;
 //#endregion
-export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailPrimitiveOptions, EmailProvider, EmailRecord, EmailSendOptions, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, NodemailerEmailProvider, NodemailerEmailProviderOptions };
+export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailPrimitiveOptions, EmailProvider, EmailRecord, EmailSendOptions, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, NodemailerEmailProvider, NodemailerEmailProviderOptions, localEmailOptions, nodemailerEmailOptions };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/email/providers/EmailProvider.ts","../../src/email/errors/EmailError.ts","../../src/email/primitives/$email.ts","../../src/email/providers/LocalEmailProvider.ts","../../src/email/providers/MemoryEmailProvider.ts","../../src/email/providers/NodemailerEmailProvider.ts","../../src/email/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;uBAKsB,aAAA;EAAA;AAStB;;;;ECda,SAAA,IAAW,CAAA,OAAA,EDWQ,gBCXK,CAAA,EDWc,OCXd,CAAA,IAAA,CAAA;;KDczB,gBAAA;;EEFC,OAAA,EAC6B,MAAA;EADV,IAAA,EAAA,MAAA;CAAqB;;;cDZxC,UAAA,SAAmB,KAAA;uCACO;;;;cCW1B;aAAmB,wBAAqB;;AFPrD,CAAA;AASY,UEGK,qBAAA,CFHW;;aEKf,kBAAkB;;ADnB/B;;;;ACYA;;;;;;AAKA;AAyBA;;;;;;;AAA6C,cAAhC,cAAA,SAAuB,SAAS,CAAC,qBAAD,CAAA,CAAA;+BAChB;;;ACrC7B;AAOA;EAAgC,IAAA,CAAA,OACR,EDsCK,gBCtCL,CAAA,EDsCwB,OCtCxB,CAAA,IAAA,CAAA;EAGD,UAAA,SAAA,CAAA,CAAA,EDuDE,aCvDF;;;;UAXN,yBAAA;;;;;AHDjB;AASY,cGDC,kBAAA,YAA8B,aHCf,CAAA;0BGDI,cAAA,CACR;;wBAGD;EFjBV,IAAA,CAAA,OAAA,EEqBgB,gBFpBU,CADP,EEqBgB,OFrBX,CAAA,IAAA,CAAA;;;;ICYxB,IAAA,EAC6B,MAAA;EADV,CAAA,CAAA,EAAA,MAAA;EAAqB,UAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;;UETpC,WAAA;;;;UAIP;AJFV;AASY,cIJC,mBAAA,YAA+B,aJIhB,CAAA;0BIJK,cAAA,CACT;WACN;gBAEW,mBAAmB;EHdnC;;;cG+BQ;AFnBrB;;;UGkBiB,8BAAA;;;;ALzBjB;EASY,WAAA,CAAA,EKqBI,WLrBY;;;;ACd5B;;;;ACYA;EAAgC,OAAA,CAAA,EAAA;IAAqB,IAAA,CAAA,EAAA,OAAA;;;;IAKpC,SAAA,CAAA,EAAA,MAAA;EAyBJ,CAAA;;AACgB,cGYhB,uBAAA,YAAmC,aHZnB,CAAA;EASA,mBAAA,GAAA,EAAA;IAAmB,UAAA,EAAA,MAAA;IAoBvB,UAAA,EAAA,MAAA;IA9BW,UAAA,EAAA,MAAA;IAAS,UAAA,EAAA,MAAA;;;;ECpC5B,mBAAA,GAAA,EEiDoB,cAAA,CAEb,MFnDkB;EAO7B,UAAA,WAAmB,EE6CP,WF7CO;EAAA,UAAA,WACR,EAAA,MAAA;EAGD,SAAA,OAAA,EE4CI,8BF5CJ;EAIM,WAAA,CAAA;EAAmB,IAAA,CAAA,OAAA,EE+CnB,gBF/CmB,CAAA,EE+CA,OF/CA,CAAA,IAAA,CAAA;EARL,UAAA,iBAAA,CAAA,CAAA,EEgFV,WFhFU;EAAa;;;YE6G/B;EDvHR;AAOjB;;EAEkB,KAAA,CAAA,CAAA,EAAA,IAAA;EAEW,mBAAA,OAAA,EC4GG,OAAA,CAkBJ,aD9HC,CAAA,OAAA,CAAA;EAAmB,mBAAA,MAAA,EC8HpB,OAAA,CAKD,aDnIqB,CAAA,MAAA,CAAA;;;;AJAhD,eAAY,QAAgB,CAAA;;;;MCdf,QAAW,EAAA,MACe;iBKsBtB;gBACD;;IJZH,CAAA;IAAmB,YAAA,EAAA;MAAqB,EAAA,EAAA,MAAA,GAAA,MAAA,EAAA;;gBIkBrC;;EJbC;AAyBjB;;;;;;;;;;;ACpCiB,cGyCJ,WHzC6B,EGyClB,OAAA,CAAA,OHzCkB,CG+ExC,OAAA,CAtCsB,MAAA,CHzCkB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/email/providers/EmailProvider.ts","../../src/email/errors/EmailError.ts","../../src/email/primitives/$email.ts","../../src/email/providers/LocalEmailProvider.ts","../../src/email/providers/MemoryEmailProvider.ts","../../src/email/providers/NodemailerEmailProvider.ts","../../src/email/index.ts"],"mappings":"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"}

package/dist/email/index.js

@@ -1,7 +1,6 @@
-import { $env, $hook, $module, KIND, Primitive, createPrimitive, t } from "alepha";
+import { $atom, $env, $hook, $inject, $module, $use, KIND, Primitive, createPrimitive, t } 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";
 import nodemailer from "nodemailer";
 
 //#region ../../src/email/providers/EmailProvider.ts
@@ -104,12 +103,34 @@ var EmailError = class extends Error {
 
 //#endregion
 //#region ../../src/email/providers/LocalEmailProvider.ts
+/**
+* Local email provider configuration atom
+*/
+const localEmailOptions = $atom({
+	name: "alepha.email.local.options",
+	schema: t.object({ directory: t.string({ description: "Directory path where email files will be stored" }) }),
+	default: { directory: "node_modules/.alepha/emails" }
+});
 var LocalEmailProvider = class {
 	log = $logger();
-	directory;
-	constructor(options = {}) {
-		this.directory = options.directory ?? "node_modules/.alepha/emails";
+	fs = $inject(FileSystemProvider);
+	options = $use(localEmailOptions);
+	get directory() {
+		return this.options.directory;
 	}
+	onStart = $hook({
+		on: "start",
+		handler: async () => {
+			try {
+				await this.fs.mkdir(this.directory, { recursive: true });
+				this.log.info("Email directory OK", { directory: this.directory });
+			} catch (error) {
+				const message = `Failed to create email directory: ${error instanceof Error ? error.message : String(error)}`;
+				this.log.error(message, { directory: this.directory });
+				throw new EmailError(message, error instanceof Error ? error : void 0);
+			}
+		}
+	});
 	async send(options) {
 		const { to, subject, body } = options;
 		this.log.debug("Sending email to local file", {
@@ -118,17 +139,16 @@ var LocalEmailProvider = class {
 			directory: this.directory
 		});
 		try {
-			await 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(/[^a-zA-Z0-9@.-]/g, "_")}+${timestamp}.html`;
-				const filepath = path.join(this.directory, filename);
+				const filepath = this.fs.join(this.directory, filename);
 				const htmlContent = this.createEmailHtml({
 					to: recipient,
 					subject,
 					body
 				});
-				await fs.writeFile(filepath, htmlContent, "utf8");
+				await this.fs.writeFile(filepath, htmlContent);
 				this.log.info("Email saved to local file", {
 					filepath,
 					to,
@@ -180,29 +200,98 @@ var LocalEmailProvider = class {
 
 //#endregion
 //#region ../../src/email/providers/NodemailerEmailProvider.ts
+/**
+* Environment variables for nodemailer configuration
+*/
 const envSchema = t.object({
-	EMAIL_HOST: t.text({ description: "SMTP server host" }),
+	EMAIL_HOST: t.optional(t.text({ description: "SMTP server host" })),
 	EMAIL_PORT: t.number({
 		default: 587,
 		description: "SMTP server port"
 	}),
-	EMAIL_USER: t.text({ description: "SMTP authentication username" }),
-	EMAIL_PASS: t.text({ description: "SMTP authentication password" }),
-	EMAIL_FROM: t.text({ description: "Default from email address" }),
+	EMAIL_USER: t.optional(t.text({ description: "SMTP authentication username" })),
+	EMAIL_PASS: t.optional(t.text({ description: "SMTP authentication password" })),
+	EMAIL_FROM: t.optional(t.text({ description: "Default from email address" })),
 	EMAIL_SECURE: t.boolean({
 		default: false,
 		description: "Use secure connection (TLS)"
 	})
 });
+/**
+* Nodemailer connection pooling and rate limiting options
+*/
+const nodemailerEmailOptions = $atom({
+	name: "alepha.email.nodemailer.options",
+	schema: t.object({
+		pool: t.optional(t.boolean({ description: "Enable connection pooling" })),
+		maxConnections: t.optional(t.number({ description: "Maximum number of connections in pool" })),
+		maxMessages: t.optional(t.number({ description: "Maximum messages per connection" })),
+		rateDelta: t.optional(t.number({ description: "Time in milliseconds between message sends" })),
+		rateLimit: t.optional(t.number({ description: "Maximum number of messages per rateDelta" }))
+	}),
+	default: {}
+});
+/**
+* Email provider using Nodemailer for SMTP transport.
+*
+* Configuration is provided via environment variables:
+* - EMAIL_HOST: SMTP server host
+* - EMAIL_PORT: SMTP server port (default: 587)
+* - EMAIL_USER: SMTP authentication username
+* - EMAIL_PASS: SMTP authentication password
+* - EMAIL_FROM: Default from email address
+* - EMAIL_SECURE: Use secure connection (default: false)
+*
+* Advanced pooling/rate limiting options can be configured via atom:
+* @see {@link nodemailerEmailOptions}
+*
+* @example
+* ```typescript
+* // Configure via environment variables
+* // EMAIL_HOST=smtp.example.com
+* // EMAIL_PORT=587
+* // EMAIL_USER=user@example.com
+* // EMAIL_PASS=secret
+* // EMAIL_FROM=noreply@example.com
+*
+* // Optionally configure pooling via atom
+* alepha.state.set(nodemailerEmailOptions.key, {
+*   pool: true,
+*   maxConnections: 5,
+*   rateLimit: 10,
+* });
+* ```
+*/
 var NodemailerEmailProvider = class {
 	env = $env(envSchema);
 	log = $logger();
-	transporter;
-	fromAddress;
-	options = {};
-	constructor() {
-		this.fromAddress = this.options.from ?? this.env.EMAIL_FROM;
-		this.transporter = this.createTransporter();
+	options = $use(nodemailerEmailOptions);
+	transporter = null;
+	get host() {
+		const host = this.env.EMAIL_HOST;
+		if (!host) throw new EmailError("Email host not configured. Set EMAIL_HOST env var.");
+		return host;
+	}
+	get port() {
+		return this.env.EMAIL_PORT;
+	}
+	get secure() {
+		return this.env.EMAIL_SECURE;
+	}
+	get user() {
+		return this.env.EMAIL_USER;
+	}
+	get pass() {
+		return this.env.EMAIL_PASS;
+	}
+	get fromAddress() {
+		const from = this.env.EMAIL_FROM;
+		if (!from) throw new EmailError("Email from address not configured. Set EMAIL_FROM env var.");
+		return from;
+	}
+	getTransporter() {
+		if (!this.transporter) this.transporter = this.createTransporter();
+		return this.transporter;
 	}
 	async send(options) {
 		const { to, subject, body } = options;
@@ -211,7 +300,7 @@ var NodemailerEmailProvider = class {
 			subject
 		});
 		try {
-			const result = await this.transporter.sendMail({
+			const result = await this.getTransporter().sendMail({
 				from: this.fromAddress,
 				to,
 				subject,
@@ -233,22 +322,26 @@ var NodemailerEmailProvider = class {
 		}
 	}
 	createTransporter() {
-		if (this.options.transporter) return this.options.transporter;
 		const transporterConfig = {
-			host: this.env.EMAIL_HOST,
-			port: this.env.EMAIL_PORT,
-			secure: this.env.EMAIL_SECURE,
-			auth: {
-				user: this.env.EMAIL_USER,
-				pass: this.env.EMAIL_PASS
-			},
-			...this.options.options
+			host: this.host,
+			port: this.port,
+			secure: this.secure,
+			auth: this.user && this.pass ? {
+				user: this.user,
+				pass: this.pass
+			} : void 0,
+			pool: this.options.pool,
+			maxConnections: this.options.maxConnections,
+			maxMessages: this.options.maxMessages,
+			rateDelta: this.options.rateDelta,
+			rateLimit: this.options.rateLimit
 		};
 		this.log.debug("Creating Nodemailer transporter", {
 			host: transporterConfig.host,
 			port: transporterConfig.port,
 			secure: transporterConfig.secure,
-			user: transporterConfig.auth.user
+			user: transporterConfig.auth?.user,
+			pool: transporterConfig.pool
 		});
 		return nodemailer.createTransport(transporterConfig);
 	}
@@ -257,7 +350,7 @@ var NodemailerEmailProvider = class {
 	*/
 	async verify() {
 		try {
-			await this.transporter.verify();
+			await this.getTransporter().verify();
 			this.log.info("Email server connection verified");
 			return true;
 		} catch (error) {
@@ -269,7 +362,10 @@ var NodemailerEmailProvider = class {
 	* Close the transporter connection.
 	*/
 	close() {
-		this.transporter.close();
+		if (this.transporter) {
+			this.transporter.close();
+			this.transporter = null;
+		}
 	}
 	onStart = $hook({
 		on: "start",
@@ -327,5 +423,5 @@ const AlephaEmail = $module({
 });
 
 //#endregion
-export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailProvider, LocalEmailProvider, MemoryEmailProvider, NodemailerEmailProvider };
+export { $email, AlephaEmail, EmailError, EmailPrimitive, EmailProvider, LocalEmailProvider, MemoryEmailProvider, NodemailerEmailProvider, localEmailOptions, nodemailerEmailOptions };
 //# sourceMappingURL=index.js.map