alepha 0.11.5 → 0.11.6

package/email.d.ts

@@ -1,4 +1,5 @@
 import * as _alepha_core1 from "alepha";
+import { Descriptor, InstantiableClass, KIND } from "alepha";
 import * as _alepha_logger0 from "alepha/logger";
 import { Transporter } from "nodemailer";
 
@@ -22,6 +23,43 @@ type EmailSendOptions = {
   body: string;
 };
 //#endregion
+//#region src/descriptors/$email.d.ts
+declare const $email: {
+  (options?: EmailDescriptorOptions): EmailDescriptor;
+  [KIND]: typeof EmailDescriptor;
+};
+interface EmailDescriptorOptions {
+  name?: string;
+  provider?: InstantiableClass<EmailProvider> | "memory";
+}
+/**
+ * Email descriptor for sending emails through various providers.
+ *
+ * Usage:
+ * ```typescript
+ * class MyService {
+ *   private readonly welcomeEmail = $email({ name: "welcome" });
+ *
+ *   async sendWelcome(userEmail: string, userName: string) {
+ *     await this.welcomeEmail.send({
+ *       to: userEmail,
+ *       subject: "Welcome!",
+ *       body: `<p>Hello ${userName}!</p>`
+ *     });
+ *   }
+ * }
+ * ```
+ */
+declare class EmailDescriptor extends Descriptor<EmailDescriptorOptions> {
+  protected readonly provider: EmailProvider;
+  get name(): string;
+  /**
+   * Send an email using the configured provider.
+   */
+  send(options: EmailSendOptions): Promise<void>;
+  protected $provider(): EmailProvider;
+}
+//#endregion
 //#region src/errors/EmailError.d.ts
 declare class EmailError extends Error {
   constructor(message: string, cause?: Error);
@@ -126,6 +164,11 @@ declare module "alepha" {
       provider: EmailProvider;
       abort(): void;
     };
+    "email:sent": {
+      to: string | string[];
+      template: string;
+      provider: EmailProvider;
+    };
   }
 }
 /**
@@ -138,7 +181,7 @@ declare module "alepha" {
  * @see {@link EmailProvider}
  * @module alepha.email
  */
-declare const AlephaEmail: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaEmail: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
-export { AlephaEmail, EmailError, EmailProvider, EmailRecord, EmailSendOptions, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, NodemailerEmailProvider, NodemailerEmailProviderOptions };
+export { $email, AlephaEmail, EmailDescriptor, EmailDescriptorOptions, EmailError, EmailProvider, EmailRecord, EmailSendOptions, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, NodemailerEmailProvider, NodemailerEmailProviderOptions };
 //# sourceMappingURL=index.d.ts.map

package/fake.d.ts

@@ -67,7 +67,7 @@ declare class FakeProvider {
  * @see {@link FakeProvider}
  * @module alepha.fake
  */
-declare const AlephaFake: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+declare const AlephaFake: _alepha_core0.Service<_alepha_core0.Module>;
 //#endregion
 export { AlephaFake, FakeOptions, FakeProvider };
 //# sourceMappingURL=index.d.ts.map

package/file.d.ts

@@ -522,7 +522,7 @@ declare class NodeFileSystem implements FileSystem {
  * @see {@link NodeFileSystem}
  * @module alepha.file
  */
-declare const AlephaFile: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+declare const AlephaFile: _alepha_core0.Service<_alepha_core0.Module>;
 //#endregion
 export { AlephaFile, CpOptions, CreateFileFromArrayBufferOptions, CreateFileFromBufferOptions, CreateFileFromStreamOptions, CreateFileFromTextOptions, CreateFileFromUrlOptions, CreateFileFromWebFileOptions, CreateFileOptions, FileSystem, FileTypeResult, LsOptions, MkdirOptions, NodeFileSystem, RmOptions, bufferToArrayBuffer, createFile, createFileFromBuffer, createFileFromStream, createFileFromUrl, createFileFromWebFile, detectFileType, getContentType, isReadableStream, mimeMap, streamToBuffer };
 //# sourceMappingURL=index.d.ts.map

package/lock/redis.d.ts

@@ -18,7 +18,7 @@ declare class RedisLockProvider implements LockProvider {
  * @see {@link RedisLockProvider}
  * @module alepha.lock.redis
  */
-declare const AlephaLockRedis: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+declare const AlephaLockRedis: _alepha_core0.Service<_alepha_core0.Module>;
 //#endregion
 export { AlephaLockRedis, RedisLockProvider };
 //# sourceMappingURL=index.d.ts.map

package/lock.d.ts

@@ -546,7 +546,7 @@ declare class MemoryLockProvider implements LockProvider {
  * @see {@link $lock}
  * @module alepha.lock
  */
-declare const AlephaLock: _alepha_core1.Service<_alepha_core1.Module<{}>>;
+declare const AlephaLock: _alepha_core1.Service<_alepha_core1.Module>;
 //#endregion
 export { $lock, AlephaLock, LockDescriptor, LockDescriptorOptions, LockProvider, LockResult, LockTopicProvider, MemoryLockProvider };
 //# sourceMappingURL=index.d.ts.map

package/logger.d.ts

@@ -223,7 +223,7 @@ declare class SimpleFormatterProvider extends LogFormatterProvider {
  *
  * Log level is also available in the state as `logLevel`, which can be used to dynamically change the log level at runtime.
  * ```ts
- * alepha.state.set("logLevel", "debug");
+ * alepha.state.set("alepha.logger.level", "debug");
  * ```
  *
  * Log level is $module aware, meaning you can set different log levels for different modules.
@@ -240,7 +240,7 @@ declare class SimpleFormatterProvider extends LogFormatterProvider {
  * - Empty parts are gracefully skipped: `LOG_LEVEL=",,debug,,"` works fine
  * - Better error messages: "Invalid log level 'bad' for module pattern 'alepha'"
  */
-declare const AlephaLogger: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+declare const AlephaLogger: _alepha_core0.Service<_alepha_core0.Module>;
 declare const envSchema: _alepha_core0.TObject<{
   /**
    * Default log level for the application.
@@ -270,7 +270,10 @@ declare const envSchema: _alepha_core0.TObject<{
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
   interface State {
-    logLevel?: string;
+    /**
+     * Current log level for the application or specific modules.
+     */
+    "alepha.logger.level"?: string;
   }
   interface Hooks {
     log: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.11.5",
+	"version": "0.11.6",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -15,56 +15,56 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/api-files": "0.11.5",
-		"@alepha/api-jobs": "0.11.5",
-		"@alepha/api-notifications": "0.11.5",
-		"@alepha/api-users": "0.11.5",
-		"@alepha/api-verifications": "0.11.5",
-		"@alepha/batch": "0.11.5",
-		"@alepha/bucket": "0.11.5",
-		"@alepha/cache": "0.11.5",
-		"@alepha/cache-redis": "0.11.5",
-		"@alepha/command": "0.11.5",
-		"@alepha/core": "0.11.5",
-		"@alepha/datetime": "0.11.5",
-		"@alepha/devtools": "0.11.5",
-		"@alepha/email": "0.11.5",
-		"@alepha/fake": "0.11.5",
-		"@alepha/file": "0.11.5",
-		"@alepha/lock": "0.11.5",
-		"@alepha/lock-redis": "0.11.5",
-		"@alepha/logger": "0.11.5",
-		"@alepha/postgres": "0.11.5",
-		"@alepha/queue": "0.11.5",
-		"@alepha/queue-redis": "0.11.5",
-		"@alepha/react": "0.11.5",
-		"@alepha/react-auth": "0.11.5",
-		"@alepha/react-form": "0.11.5",
-		"@alepha/react-head": "0.11.5",
-		"@alepha/react-i18n": "0.11.5",
-		"@alepha/redis": "0.11.5",
-		"@alepha/retry": "0.11.5",
-		"@alepha/router": "0.11.5",
-		"@alepha/scheduler": "0.11.5",
-		"@alepha/security": "0.11.5",
-		"@alepha/server": "0.11.5",
-		"@alepha/server-cache": "0.11.5",
-		"@alepha/server-compress": "0.11.5",
-		"@alepha/server-cookies": "0.11.5",
-		"@alepha/server-cors": "0.11.5",
-		"@alepha/server-health": "0.11.5",
-		"@alepha/server-helmet": "0.11.5",
-		"@alepha/server-links": "0.11.5",
-		"@alepha/server-metrics": "0.11.5",
-		"@alepha/server-multipart": "0.11.5",
-		"@alepha/server-proxy": "0.11.5",
-		"@alepha/server-security": "0.11.5",
-		"@alepha/server-static": "0.11.5",
-		"@alepha/server-swagger": "0.11.5",
-		"@alepha/topic": "0.11.5",
-		"@alepha/topic-redis": "0.11.5",
-		"@alepha/ui": "0.11.5",
-		"@alepha/vite": "0.11.5",
+		"@alepha/api-files": "0.11.6",
+		"@alepha/api-jobs": "0.11.6",
+		"@alepha/api-notifications": "0.11.6",
+		"@alepha/api-users": "0.11.6",
+		"@alepha/api-verifications": "0.11.6",
+		"@alepha/batch": "0.11.6",
+		"@alepha/bucket": "0.11.6",
+		"@alepha/cache": "0.11.6",
+		"@alepha/cache-redis": "0.11.6",
+		"@alepha/command": "0.11.6",
+		"@alepha/core": "0.11.6",
+		"@alepha/datetime": "0.11.6",
+		"@alepha/devtools": "0.11.6",
+		"@alepha/email": "0.11.6",
+		"@alepha/fake": "0.11.6",
+		"@alepha/file": "0.11.6",
+		"@alepha/lock": "0.11.6",
+		"@alepha/lock-redis": "0.11.6",
+		"@alepha/logger": "0.11.6",
+		"@alepha/postgres": "0.11.6",
+		"@alepha/queue": "0.11.6",
+		"@alepha/queue-redis": "0.11.6",
+		"@alepha/react": "0.11.6",
+		"@alepha/react-auth": "0.11.6",
+		"@alepha/react-form": "0.11.6",
+		"@alepha/react-head": "0.11.6",
+		"@alepha/react-i18n": "0.11.6",
+		"@alepha/redis": "0.11.6",
+		"@alepha/retry": "0.11.6",
+		"@alepha/router": "0.11.6",
+		"@alepha/scheduler": "0.11.6",
+		"@alepha/security": "0.11.6",
+		"@alepha/server": "0.11.6",
+		"@alepha/server-cache": "0.11.6",
+		"@alepha/server-compress": "0.11.6",
+		"@alepha/server-cookies": "0.11.6",
+		"@alepha/server-cors": "0.11.6",
+		"@alepha/server-health": "0.11.6",
+		"@alepha/server-helmet": "0.11.6",
+		"@alepha/server-links": "0.11.6",
+		"@alepha/server-metrics": "0.11.6",
+		"@alepha/server-multipart": "0.11.6",
+		"@alepha/server-proxy": "0.11.6",
+		"@alepha/server-security": "0.11.6",
+		"@alepha/server-static": "0.11.6",
+		"@alepha/server-swagger": "0.11.6",
+		"@alepha/topic": "0.11.6",
+		"@alepha/topic-redis": "0.11.6",
+		"@alepha/ui": "0.11.6",
+		"@alepha/vite": "0.11.6",
 		"react": "^19.2.0",
 		"react-dom": "^19.2.0"
 	},