alepha 0.21.2 → 0.22.0

package/dist/captcha/index.d.ts

@@ -1,6 +1,3 @@
-import * as _$alepha from "alepha";
-import * as _$alepha_logger0 from "alepha/logger";
-
 //#region ../../src/captcha/providers/CaptchaProvider.d.ts
 /**
  * Captcha verification provider interface.
@@ -40,7 +37,7 @@ interface CaptchaRecord {
  * and `accept()` to restore. All verification attempts are recorded for assertions.
  */
 declare class MemoryCaptchaProvider implements CaptchaProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   /**
    * All verification attempts.
    */
@@ -127,7 +124,7 @@ declare class MemoryCaptchaProvider implements CaptchaProvider {
  * @see https://developers.cloudflare.com/turnstile/get-started/server-side-validation/
  */
 declare class TurnstileCaptchaProvider implements CaptchaProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly secretKey: string;
   protected readonly siteKey: string;
   constructor();
@@ -146,7 +143,7 @@ declare class TurnstileCaptchaProvider implements CaptchaProvider {
  *
  * @module alepha.captcha
  */
-declare const AlephaCaptcha: _$alepha.Service<_$alepha.Module>;
+declare const AlephaCaptcha: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { AlephaCaptcha, CaptchaProvider, CaptchaRecord, MemoryCaptchaProvider, TurnstileCaptchaProvider };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/captcha/providers/CaptchaProvider.ts","../../src/captcha/providers/MemoryCaptchaProvider.ts","../../src/captcha/providers/TurnstileCaptchaProvider.ts","../../src/captcha/index.ts"],"mappings":";;;;;;;;AAOA;;;uBAAsB,eAAA;EAQJ;;;;;;;EAAA,SAAA,MAAA,CAAO,KAAA,UAAe,EAAA,YAAc,OAAA;;;ACZtD;;;;EDoBS,UAAA,CAAA;AAAA;;;UCpBQ,aAAA;EACf,KAAA;EACA,EAAA;EACA,UAAA,EAAY,IAAA;AAAA;;;;;;;cASD,qBAAA,YAAiC,eAAA;EAAA,mBACzB,GAAA,EADc,gBAAA,CACX,MAAA;EDOL;;;ECFV,OAAA,EAAS,aAAA;EAAA,UAEN,YAAA;EAEH,UAAA,CAAA;EAIM,MAAA,CAAO,KAAA,UAAe,EAAA,YAAc,OAAA;EAvBjC;;;EAsCT,MAAA,CAAA;EAtCK;;;EA6CL,MAAA,CAAA;EApC0B;;;EA2C1B,WAAA,CAAY,KAAA;EA7B8B;;;EAAA,IAoCtC,IAAA,CAAA,GAAQ,aAAA;AAAA;;;;;;AD1DrB;;;;;;;;;;;;;;ACJA;;;;;;;;;;AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCgDa,wBAAA,YAAoC,eAAA;EAAA,mBAC5B,GAAA,EADiB,gBAAA,CACd,MAAA;EAAA,mBACH,SAAA;EAAA,mBACA,OAAA;;EAsBZ,UAAA,CAAA;EAIM,MAAA,CAAO,KAAA,UAAe,EAAA,YAAc,OAAA;AAAA;;;;AFrFnD;;;;;;;;;cGgBa,aAAA,EAAa,QAAA,CAAA,OAAA,CAUxB,QAAA,CAVwB,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/captcha/providers/CaptchaProvider.ts","../../src/captcha/providers/MemoryCaptchaProvider.ts","../../src/captcha/providers/TurnstileCaptchaProvider.ts","../../src/captcha/index.ts"],"mappings":";;AAOA;;;;;;uBAAsB,eAAA;EAQgC;;;AAQnC;;;;EARmC,SAApC,MAAA,CAAO,KAAA,UAAe,EAAA,YAAc,OAAO;ECZ/B;;;;;;EDoBrB,UAAA;AAAA;;;UCpBQ,aAAA;EACf,KAAA;EACA,EAAA;EACA,UAAA,EAAY,IAAI;AAAA;;;;;;ADiBC;cCRN,qBAAA,YAAiC,eAAA;EAAA,mBACzB,GAAA,0BAAG,MAAA;;AAbxB;;EAkBS,OAAA,EAAS,aAAA;EAAA,UAEN,YAAA;EAEH,UAAA;EAIM,MAAA,CAAO,KAAA,UAAe,EAAA,YAAc,OAAA;EAvBjD;;;EAsCO,MAAA;EA7BI;;;EAoCJ,MAAA;EAtB0C;;;EA6B1C,WAAA,CAAY,KAAA;EA3CwC;;;EAAA,IAkDhD,IAAA,IAAQ,aAAA;AAAA;;;AD1DrB;;;;;;;;;;AAgBmB;;;;ACpBnB;;;;;;;;;AAGkB;AASlB;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDkC;;;;ACFlC;;;;AFxDA,cEwDa,wBAAA,YAAoC,eAAe;EAAA,mBAC3C,GAAA,0BAAG,MAAA;EAAA,mBACH,SAAA;EAAA,mBACA,OAAA;;EAsBZ,UAAA;EAIM,MAAA,CAAO,KAAA,UAAe,EAAA,YAAc,OAAA;AAAA;;;;;;;;;;;AFrEhC;;cGAN,aAAA,mBAAa,OAAA,kBAAA,MAAA"}

package/dist/captcha/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/captcha/providers/CaptchaProvider.ts","../../src/captcha/providers/MemoryCaptchaProvider.ts","../../src/captcha/providers/TurnstileCaptchaProvider.ts","../../src/captcha/index.ts"],"sourcesContent":["/**\n * Captcha verification provider interface.\n *\n * Verifies that a user-submitted captcha token is valid. Implementations\n * call the relevant captcha service (Turnstile, reCAPTCHA, hCaptcha, etc.)\n * to validate the token server-side.\n */\nexport abstract class CaptchaProvider {\n  /**\n   * Verify a captcha token.\n   *\n   * @param token - The captcha response token submitted by the client.\n   * @param ip - Optional client IP address for additional validation.\n   * @returns Whether the token is valid.\n   */\n  public abstract verify(token: string, ip?: string): Promise<boolean>;\n\n  /**\n   * Public site/widget key to hand to the browser, when applicable.\n   *\n   * Returns `undefined` for providers that don't need a client key\n   * (e.g. in-memory/test providers).\n   */\n  public getSiteKey(): string | undefined {\n    return undefined;\n  }\n}\n","import { $logger } from \"alepha/logger\";\nimport type { CaptchaProvider } from \"./CaptchaProvider.ts\";\n\nexport interface CaptchaRecord {\n  token: string;\n  ip?: string;\n  verifiedAt: Date;\n}\n\n/**\n * In-memory captcha provider for testing.\n *\n * Accepts all tokens by default. Use `reject()` to make verification fail,\n * and `accept()` to restore. All verification attempts are recorded for assertions.\n */\nexport class MemoryCaptchaProvider implements CaptchaProvider {\n  protected readonly log = $logger();\n\n  /**\n   * All verification attempts.\n   */\n  public records: CaptchaRecord[] = [];\n\n  protected shouldAccept = true;\n\n  public getSiteKey(): string | undefined {\n    return undefined;\n  }\n\n  public async verify(token: string, ip?: string): Promise<boolean> {\n    this.log.debug(\"Verifying captcha in memory store\", { token, ip });\n\n    this.records.push({\n      token,\n      ip,\n      verifiedAt: new Date(),\n    });\n\n    return this.shouldAccept;\n  }\n\n  /**\n   * Make all subsequent verifications fail.\n   */\n  public reject(): void {\n    this.shouldAccept = false;\n  }\n\n  /**\n   * Make all subsequent verifications pass (default behavior).\n   */\n  public accept(): void {\n    this.shouldAccept = true;\n  }\n\n  /**\n   * Whether a token was verified.\n   */\n  public wasVerified(token: string): boolean {\n    return this.records.some((r) => r.token === token);\n  }\n\n  /**\n   * Get the last verification attempt.\n   */\n  public get last(): CaptchaRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","import { $context, AlephaError, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { CaptchaProvider } from \"./CaptchaProvider.ts\";\n\n/**\n * Cloudflare Turnstile captcha verification provider.\n *\n * Validates captcha tokens against the Cloudflare Turnstile siteverify API.\n * Free, privacy-friendly, and supports invisible mode.\n *\n * ## Setup\n *\n * 1. Create a Turnstile widget at https://dash.cloudflare.com/?to=/:account/turnstile\n * 2. Copy the **Site Key** (public, for the client) and **Secret Key** (private, for the server)\n * 3. Set `TURNSTILE_SECRET_KEY` in your environment\n *\n * ## Client-side integration\n *\n * Add the Turnstile script and widget to your form:\n *\n * ```html\n * <script src=\"https://challenges.cloudflare.com/turnstile/v0/api.js\" async defer></script>\n * <form>\n *   <div class=\"cf-turnstile\" data-sitekey=\"YOUR_SITE_KEY\"></div>\n *   <button type=\"submit\">Submit</button>\n * </form>\n * ```\n *\n * The widget injects a hidden `cf-turnstile-response` input into the form.\n * Send this value as the `captchaToken` in your registration request.\n *\n * For explicit rendering (React, SPA):\n *\n * ```ts\n * turnstile.render(\"#container\", {\n *   sitekey: \"YOUR_SITE_KEY\",\n *   callback: (token) => setCaptchaToken(token),\n * });\n * ```\n *\n * ## Server-side usage\n *\n * Register the provider in your app:\n *\n * ```ts\n * import { CaptchaProvider } from \"alepha/captcha\";\n * import { TurnstileCaptchaProvider } from \"alepha/captcha\";\n *\n * alepha.with({ provide: CaptchaProvider, use: TurnstileCaptchaProvider });\n * ```\n *\n * ## Test keys (for development)\n *\n * - Always passes: site `1x00000000000000000000AA`, secret `1x0000000000000000000000000000000AA`\n * - Always blocks: site `2x00000000000000000000AB`, secret `2x0000000000000000000000000000000AB`\n * - Forces interactive: site `3x00000000000000000000FF`\n *\n * ## Environment Variables\n *\n * - `TURNSTILE_SECRET_KEY`: The secret key from the Cloudflare Turnstile dashboard.\n *\n * @see https://developers.cloudflare.com/turnstile/get-started/server-side-validation/\n */\nexport class TurnstileCaptchaProvider implements CaptchaProvider {\n  protected readonly log = $logger();\n  protected readonly secretKey: string;\n  protected readonly siteKey: string;\n\n  constructor() {\n    const { alepha } = $context();\n\n    const env = alepha.parseEnv(\n      t.object({\n        TURNSTILE_SECRET_KEY: t.text({\n          description:\n            \"The secret key from the Cloudflare Turnstile dashboard.\",\n        }),\n        TURNSTILE_SITE_KEY: t.text({\n          description:\n            \"The public site key from the Cloudflare Turnstile dashboard, rendered on the client.\",\n        }),\n      }),\n    );\n\n    this.secretKey = env.TURNSTILE_SECRET_KEY;\n    this.siteKey = env.TURNSTILE_SITE_KEY;\n  }\n\n  public getSiteKey(): string {\n    return this.siteKey;\n  }\n\n  public async verify(token: string, ip?: string): Promise<boolean> {\n    const body = new URLSearchParams();\n    body.set(\"secret\", this.secretKey);\n    body.set(\"response\", token);\n\n    if (ip) {\n      body.set(\"remoteip\", ip);\n    }\n\n    try {\n      const res = await fetch(\n        \"https://challenges.cloudflare.com/turnstile/v0/siteverify\",\n        {\n          method: \"POST\",\n          body,\n        },\n      );\n\n      const data = (await res.json()) as TurnstileResponse;\n\n      if (!data.success) {\n        this.log.debug(\"Turnstile verification failed\", {\n          errorCodes: data[\"error-codes\"],\n        });\n      }\n\n      return data.success;\n    } catch (error) {\n      throw new AlephaError(\"Failed to verify Turnstile captcha token\", {\n        cause: error,\n      });\n    }\n  }\n}\n\ninterface TurnstileResponse {\n  success: boolean;\n  \"error-codes\"?: string[];\n  challenge_ts?: string;\n  hostname?: string;\n  action?: string;\n  cdata?: string;\n}\n","import { $module } from \"alepha\";\nimport { CaptchaProvider } from \"./providers/CaptchaProvider.ts\";\nimport { MemoryCaptchaProvider } from \"./providers/MemoryCaptchaProvider.ts\";\nimport { TurnstileCaptchaProvider } from \"./providers/TurnstileCaptchaProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/CaptchaProvider.ts\";\nexport * from \"./providers/MemoryCaptchaProvider.ts\";\nexport * from \"./providers/TurnstileCaptchaProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Captcha verification for bot protection.\n *\n * **Features:**\n * - Provider abstraction for captcha services\n * - Cloudflare Turnstile support (free, privacy-friendly)\n * - In-memory provider for testing\n *\n * @module alepha.captcha\n */\nexport const AlephaCaptcha = $module({\n  name: \"alepha.captcha\",\n  services: [CaptchaProvider],\n  variants: [MemoryCaptchaProvider, TurnstileCaptchaProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CaptchaProvider,\n      use: MemoryCaptchaProvider,\n    }),\n});\n"],"mappings":";;;;;;;;;;AAOA,IAAsB,kBAAtB,MAAsC;;;;;;;CAgBpC,aAAwC;;;;;;;;;;ACR1C,IAAa,wBAAb,MAA8D;CAC5D,MAAyB,SAAS;;;;CAKlC,UAAkC,EAAE;CAEpC,eAAyB;CAEzB,aAAwC;CAIxC,MAAa,OAAO,OAAe,IAA+B;EAChE,KAAK,IAAI,MAAM,qCAAqC;GAAE;GAAO;GAAI,CAAC;EAElE,KAAK,QAAQ,KAAK;GAChB;GACA;GACA,4BAAY,IAAI,MAAM;GACvB,CAAC;EAEF,OAAO,KAAK;;;;;CAMd,SAAsB;EACpB,KAAK,eAAe;;;;;CAMtB,SAAsB;EACpB,KAAK,eAAe;;;;;CAMtB,YAAmB,OAAwB;EACzC,OAAO,KAAK,QAAQ,MAAM,MAAM,EAAE,UAAU,MAAM;;;;;CAMpD,IAAW,OAAkC;EAC3C,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACH9C,IAAa,2BAAb,MAAiE;CAC/D,MAAyB,SAAS;CAClC;CACA;CAEA,cAAc;EACZ,MAAM,EAAE,WAAW,UAAU;EAE7B,MAAM,MAAM,OAAO,SACjB,EAAE,OAAO;GACP,sBAAsB,EAAE,KAAK,EAC3B,aACE,2DACH,CAAC;GACF,oBAAoB,EAAE,KAAK,EACzB,aACE,wFACH,CAAC;GACH,CAAC,CACH;EAED,KAAK,YAAY,IAAI;EACrB,KAAK,UAAU,IAAI;;CAGrB,aAA4B;EAC1B,OAAO,KAAK;;CAGd,MAAa,OAAO,OAAe,IAA+B;EAChE,MAAM,OAAO,IAAI,iBAAiB;EAClC,KAAK,IAAI,UAAU,KAAK,UAAU;EAClC,KAAK,IAAI,YAAY,MAAM;EAE3B,IAAI,IACF,KAAK,IAAI,YAAY,GAAG;EAG1B,IAAI;GASF,MAAM,OAAQ,OAAM,MARF,MAChB,6DACA;IACE,QAAQ;IACR;IACD,CACF,EAEuB,MAAM;GAE9B,IAAI,CAAC,KAAK,SACR,KAAK,IAAI,MAAM,iCAAiC,EAC9C,YAAY,KAAK,gBAClB,CAAC;GAGJ,OAAO,KAAK;WACL,OAAO;GACd,MAAM,IAAI,YAAY,4CAA4C,EAChE,OAAO,OACR,CAAC;;;;;;;;;;;;;;;;ACnGR,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,UAAU,CAAC,gBAAgB;CAC3B,UAAU,CAAC,uBAAuB,yBAAyB;CAC3D,WAAW,WACT,OAAO,KAAK;EACV,UAAU;EACV,SAAS;EACT,KAAK;EACN,CAAC;CACL,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/captcha/providers/CaptchaProvider.ts","../../src/captcha/providers/MemoryCaptchaProvider.ts","../../src/captcha/providers/TurnstileCaptchaProvider.ts","../../src/captcha/index.ts"],"sourcesContent":["/**\n * Captcha verification provider interface.\n *\n * Verifies that a user-submitted captcha token is valid. Implementations\n * call the relevant captcha service (Turnstile, reCAPTCHA, hCaptcha, etc.)\n * to validate the token server-side.\n */\nexport abstract class CaptchaProvider {\n  /**\n   * Verify a captcha token.\n   *\n   * @param token - The captcha response token submitted by the client.\n   * @param ip - Optional client IP address for additional validation.\n   * @returns Whether the token is valid.\n   */\n  public abstract verify(token: string, ip?: string): Promise<boolean>;\n\n  /**\n   * Public site/widget key to hand to the browser, when applicable.\n   *\n   * Returns `undefined` for providers that don't need a client key\n   * (e.g. in-memory/test providers).\n   */\n  public getSiteKey(): string | undefined {\n    return undefined;\n  }\n}\n","import { $logger } from \"alepha/logger\";\nimport type { CaptchaProvider } from \"./CaptchaProvider.ts\";\n\nexport interface CaptchaRecord {\n  token: string;\n  ip?: string;\n  verifiedAt: Date;\n}\n\n/**\n * In-memory captcha provider for testing.\n *\n * Accepts all tokens by default. Use `reject()` to make verification fail,\n * and `accept()` to restore. All verification attempts are recorded for assertions.\n */\nexport class MemoryCaptchaProvider implements CaptchaProvider {\n  protected readonly log = $logger();\n\n  /**\n   * All verification attempts.\n   */\n  public records: CaptchaRecord[] = [];\n\n  protected shouldAccept = true;\n\n  public getSiteKey(): string | undefined {\n    return undefined;\n  }\n\n  public async verify(token: string, ip?: string): Promise<boolean> {\n    this.log.debug(\"Verifying captcha in memory store\", { token, ip });\n\n    this.records.push({\n      token,\n      ip,\n      verifiedAt: new Date(),\n    });\n\n    return this.shouldAccept;\n  }\n\n  /**\n   * Make all subsequent verifications fail.\n   */\n  public reject(): void {\n    this.shouldAccept = false;\n  }\n\n  /**\n   * Make all subsequent verifications pass (default behavior).\n   */\n  public accept(): void {\n    this.shouldAccept = true;\n  }\n\n  /**\n   * Whether a token was verified.\n   */\n  public wasVerified(token: string): boolean {\n    return this.records.some((r) => r.token === token);\n  }\n\n  /**\n   * Get the last verification attempt.\n   */\n  public get last(): CaptchaRecord | undefined {\n    return this.records[this.records.length - 1];\n  }\n}\n","import { $context, AlephaError, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { CaptchaProvider } from \"./CaptchaProvider.ts\";\n\n/**\n * Cloudflare Turnstile captcha verification provider.\n *\n * Validates captcha tokens against the Cloudflare Turnstile siteverify API.\n * Free, privacy-friendly, and supports invisible mode.\n *\n * ## Setup\n *\n * 1. Create a Turnstile widget at https://dash.cloudflare.com/?to=/:account/turnstile\n * 2. Copy the **Site Key** (public, for the client) and **Secret Key** (private, for the server)\n * 3. Set `TURNSTILE_SECRET_KEY` in your environment\n *\n * ## Client-side integration\n *\n * Add the Turnstile script and widget to your form:\n *\n * ```html\n * <script src=\"https://challenges.cloudflare.com/turnstile/v0/api.js\" async defer></script>\n * <form>\n *   <div class=\"cf-turnstile\" data-sitekey=\"YOUR_SITE_KEY\"></div>\n *   <button type=\"submit\">Submit</button>\n * </form>\n * ```\n *\n * The widget injects a hidden `cf-turnstile-response` input into the form.\n * Send this value as the `captchaToken` in your registration request.\n *\n * For explicit rendering (React, SPA):\n *\n * ```ts\n * turnstile.render(\"#container\", {\n *   sitekey: \"YOUR_SITE_KEY\",\n *   callback: (token) => setCaptchaToken(token),\n * });\n * ```\n *\n * ## Server-side usage\n *\n * Register the provider in your app:\n *\n * ```ts\n * import { CaptchaProvider } from \"alepha/captcha\";\n * import { TurnstileCaptchaProvider } from \"alepha/captcha\";\n *\n * alepha.with({ provide: CaptchaProvider, use: TurnstileCaptchaProvider });\n * ```\n *\n * ## Test keys (for development)\n *\n * - Always passes: site `1x00000000000000000000AA`, secret `1x0000000000000000000000000000000AA`\n * - Always blocks: site `2x00000000000000000000AB`, secret `2x0000000000000000000000000000000AB`\n * - Forces interactive: site `3x00000000000000000000FF`\n *\n * ## Environment Variables\n *\n * - `TURNSTILE_SECRET_KEY`: The secret key from the Cloudflare Turnstile dashboard.\n *\n * @see https://developers.cloudflare.com/turnstile/get-started/server-side-validation/\n */\nexport class TurnstileCaptchaProvider implements CaptchaProvider {\n  protected readonly log = $logger();\n  protected readonly secretKey: string;\n  protected readonly siteKey: string;\n\n  constructor() {\n    const { alepha } = $context();\n\n    const env = alepha.parseEnv(\n      t.object({\n        TURNSTILE_SECRET_KEY: t.text({\n          description:\n            \"The secret key from the Cloudflare Turnstile dashboard.\",\n        }),\n        TURNSTILE_SITE_KEY: t.text({\n          description:\n            \"The public site key from the Cloudflare Turnstile dashboard, rendered on the client.\",\n        }),\n      }),\n    );\n\n    this.secretKey = env.TURNSTILE_SECRET_KEY;\n    this.siteKey = env.TURNSTILE_SITE_KEY;\n  }\n\n  public getSiteKey(): string {\n    return this.siteKey;\n  }\n\n  public async verify(token: string, ip?: string): Promise<boolean> {\n    const body = new URLSearchParams();\n    body.set(\"secret\", this.secretKey);\n    body.set(\"response\", token);\n\n    if (ip) {\n      body.set(\"remoteip\", ip);\n    }\n\n    try {\n      const res = await fetch(\n        \"https://challenges.cloudflare.com/turnstile/v0/siteverify\",\n        {\n          method: \"POST\",\n          body,\n        },\n      );\n\n      const data = (await res.json()) as TurnstileResponse;\n\n      if (!data.success) {\n        this.log.debug(\"Turnstile verification failed\", {\n          errorCodes: data[\"error-codes\"],\n        });\n      }\n\n      return data.success;\n    } catch (error) {\n      throw new AlephaError(\"Failed to verify Turnstile captcha token\", {\n        cause: error,\n      });\n    }\n  }\n}\n\ninterface TurnstileResponse {\n  success: boolean;\n  \"error-codes\"?: string[];\n  challenge_ts?: string;\n  hostname?: string;\n  action?: string;\n  cdata?: string;\n}\n","import { $module } from \"alepha\";\nimport { CaptchaProvider } from \"./providers/CaptchaProvider.ts\";\nimport { MemoryCaptchaProvider } from \"./providers/MemoryCaptchaProvider.ts\";\nimport { TurnstileCaptchaProvider } from \"./providers/TurnstileCaptchaProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/CaptchaProvider.ts\";\nexport * from \"./providers/MemoryCaptchaProvider.ts\";\nexport * from \"./providers/TurnstileCaptchaProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Captcha verification for bot protection.\n *\n * **Features:**\n * - Provider abstraction for captcha services\n * - Cloudflare Turnstile support (free, privacy-friendly)\n * - In-memory provider for testing\n *\n * @module alepha.captcha\n */\nexport const AlephaCaptcha = $module({\n  name: \"alepha.captcha\",\n  services: [CaptchaProvider],\n  variants: [MemoryCaptchaProvider, TurnstileCaptchaProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CaptchaProvider,\n      use: MemoryCaptchaProvider,\n    }),\n});\n"],"mappings":";;;;;;;;;;AAOA,IAAsB,kBAAtB,MAAsC;;;;;;;CAgBpC,aAAwC,CAExC;AACF;;;;;;;;;ACXA,IAAa,wBAAb,MAA8D;CAC5D,MAAyB,QAAQ;;;;CAKjC,UAAkC,CAAC;CAEnC,eAAyB;CAEzB,aAAwC,CAExC;CAEA,MAAa,OAAO,OAAe,IAA+B;EAChE,KAAK,IAAI,MAAM,qCAAqC;GAAE;GAAO;EAAG,CAAC;EAEjE,KAAK,QAAQ,KAAK;GAChB;GACA;GACA,4BAAY,IAAI,KAAK;EACvB,CAAC;EAED,OAAO,KAAK;CACd;;;;CAKA,SAAsB;EACpB,KAAK,eAAe;CACtB;;;;CAKA,SAAsB;EACpB,KAAK,eAAe;CACtB;;;;CAKA,YAAmB,OAAwB;EACzC,OAAO,KAAK,QAAQ,MAAM,MAAM,EAAE,UAAU,KAAK;CACnD;;;;CAKA,IAAW,OAAkC;EAC3C,OAAO,KAAK,QAAQ,KAAK,QAAQ,SAAS;CAC5C;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACLA,IAAa,2BAAb,MAAiE;CAC/D,MAAyB,QAAQ;CACjC;CACA;CAEA,cAAc;EACZ,MAAM,EAAE,WAAW,SAAS;EAE5B,MAAM,MAAM,OAAO,SACjB,EAAE,OAAO;GACP,sBAAsB,EAAE,KAAK,EAC3B,aACE,0DACJ,CAAC;GACD,oBAAoB,EAAE,KAAK,EACzB,aACE,uFACJ,CAAC;EACH,CAAC,CACH;EAEA,KAAK,YAAY,IAAI;EACrB,KAAK,UAAU,IAAI;CACrB;CAEA,aAA4B;EAC1B,OAAO,KAAK;CACd;CAEA,MAAa,OAAO,OAAe,IAA+B;EAChE,MAAM,OAAO,IAAI,gBAAgB;EACjC,KAAK,IAAI,UAAU,KAAK,SAAS;EACjC,KAAK,IAAI,YAAY,KAAK;EAE1B,IAAI,IACF,KAAK,IAAI,YAAY,EAAE;EAGzB,IAAI;GASF,MAAM,OAAQ,OAAM,MARF,MAChB,6DACA;IACE,QAAQ;IACR;GACF,CACF,GAEwB,KAAK;GAE7B,IAAI,CAAC,KAAK,SACR,KAAK,IAAI,MAAM,iCAAiC,EAC9C,YAAY,KAAK,eACnB,CAAC;GAGH,OAAO,KAAK;EACd,SAAS,OAAO;GACd,MAAM,IAAI,YAAY,4CAA4C,EAChE,OAAO,MACT,CAAC;EACH;CACF;AACF;;;;;;;;;;;;;ACtGA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,UAAU,CAAC,eAAe;CAC1B,UAAU,CAAC,uBAAuB,wBAAwB;CAC1D,WAAW,WACT,OAAO,KAAK;EACV,UAAU;EACV,SAAS;EACT,KAAK;CACP,CAAC;AACL,CAAC"}

package/dist/cli/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/config/defineConfig.ts"],"mappings":";;;;UAYiB,eAAA;;AAAjB;;EAIE,KAAA,GAAQ,eAAA;EAAA;;;EAKR,QAAA,GAAW,KAAA,CAAM,OAAA;EAKP;;;EAAV,OAAA,GAAU,KAAA,CAAM,OAAA;EAiBJ;;;EAZZ,KAAA,GAAQ,YAAA;EAVR;;;EAeA,GAAA,GAAM,UAAA;EAVI;;;;;EAiBV,GAAA,GAAM,MAAA;AAAA;AAAA,cAKK,YAAA,GAAgB,MAAA,EAAQ,eAAA,MAC3B,MAAA,EAAQ,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/config/defineConfig.ts"],"mappings":";;;;UAYiB,eAAA;;AAAjB;;EAIE,KAAA,GAAQ,eAAA;EAAA;;;EAKR,QAAA,GAAW,KAAA,CAAM,OAAA;EAKP;;;EAAV,OAAA,GAAU,KAAA,CAAM,OAAA;EAiBJ;;;EAZZ,KAAA,GAAQ,YAAA;EAVR;;;EAeA,GAAA,GAAM,UAAA;EAVI;;;;;EAiBV,GAAA,GAAM,MAAA;AAAA;AAAA,cAKK,YAAA,GAAgB,MAAA,EAAQ,eAAA,MAC3B,MAAA,EAAQ,MAAM"}

package/dist/cli/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/cli/config/defineConfig.ts"],"sourcesContent":["import type { Alepha, Service } from \"alepha\";\nimport {\n  type AppEntryOptions,\n  appEntryOptions,\n  type BuildOptions,\n  buildOptions,\n  type DevOptions,\n  devOptions,\n} from \"alepha/cli\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface AlephaCliConfig {\n  /**\n   * Override entry paths.\n   */\n  entry?: AppEntryOptions;\n\n  /**\n   * Register more services to the Alepha CLI (enhancements, commands, etc.).\n   */\n  services?: Array<Service>;\n\n  /**\n   * @alias services Register more services to the Alepha CLI (enhancements, commands, etc.).\n   */\n  plugins?: Array<Service>;\n\n  /**\n   * Configure Alepha build command.\n   */\n  build?: BuildOptions;\n\n  /**\n   * Configure Alepha dev command.\n   */\n  dev?: DevOptions;\n\n  /**\n   * Environment variables to set before running commands.\n   *\n   * Always use .env files by default, this is only for dynamic values.\n   */\n  env?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const defineConfig = (config: AlephaCliConfig) => {\n  return (alepha: Alepha) => {\n    if (config.services) {\n      for (const it of config.services) {\n        alepha.with(it);\n      }\n    }\n\n    if (config.plugins) {\n      for (const it of config.plugins) {\n        alepha.with(it);\n      }\n    }\n\n    if (config.env) {\n      for (const [key, value] of Object.entries(config.env)) {\n        process.env[key] = String(value);\n      }\n    }\n\n    if (config.build) {\n      alepha.set(buildOptions, config.build);\n    }\n\n    if (config.dev) {\n      alepha.set(devOptions, config.dev);\n    }\n\n    if (config.entry) {\n      alepha.set(appEntryOptions, config.entry);\n    }\n\n    return {};\n  };\n};\n"],"mappings":";;AAgDA,MAAa,gBAAgB,WAA4B;CACvD,QAAQ,WAAmB;EACzB,IAAI,OAAO,UACT,KAAK,MAAM,MAAM,OAAO,UACtB,OAAO,KAAK,GAAG;EAInB,IAAI,OAAO,SACT,KAAK,MAAM,MAAM,OAAO,SACtB,OAAO,KAAK,GAAG;EAInB,IAAI,OAAO,KACT,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,IAAI,EACnD,QAAQ,IAAI,OAAO,OAAO,MAAM;EAIpC,IAAI,OAAO,OACT,OAAO,IAAI,cAAc,OAAO,MAAM;EAGxC,IAAI,OAAO,KACT,OAAO,IAAI,YAAY,OAAO,IAAI;EAGpC,IAAI,OAAO,OACT,OAAO,IAAI,iBAAiB,OAAO,MAAM;EAG3C,OAAO,EAAE"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/cli/config/defineConfig.ts"],"sourcesContent":["import type { Alepha, Service } from \"alepha\";\nimport {\n  type AppEntryOptions,\n  appEntryOptions,\n  type BuildOptions,\n  buildOptions,\n  type DevOptions,\n  devOptions,\n} from \"alepha/cli\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface AlephaCliConfig {\n  /**\n   * Override entry paths.\n   */\n  entry?: AppEntryOptions;\n\n  /**\n   * Register more services to the Alepha CLI (enhancements, commands, etc.).\n   */\n  services?: Array<Service>;\n\n  /**\n   * @alias services Register more services to the Alepha CLI (enhancements, commands, etc.).\n   */\n  plugins?: Array<Service>;\n\n  /**\n   * Configure Alepha build command.\n   */\n  build?: BuildOptions;\n\n  /**\n   * Configure Alepha dev command.\n   */\n  dev?: DevOptions;\n\n  /**\n   * Environment variables to set before running commands.\n   *\n   * Always use .env files by default, this is only for dynamic values.\n   */\n  env?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const defineConfig = (config: AlephaCliConfig) => {\n  return (alepha: Alepha) => {\n    if (config.services) {\n      for (const it of config.services) {\n        alepha.with(it);\n      }\n    }\n\n    if (config.plugins) {\n      for (const it of config.plugins) {\n        alepha.with(it);\n      }\n    }\n\n    if (config.env) {\n      for (const [key, value] of Object.entries(config.env)) {\n        process.env[key] = String(value);\n      }\n    }\n\n    if (config.build) {\n      alepha.set(buildOptions, config.build);\n    }\n\n    if (config.dev) {\n      alepha.set(devOptions, config.dev);\n    }\n\n    if (config.entry) {\n      alepha.set(appEntryOptions, config.entry);\n    }\n\n    return {};\n  };\n};\n"],"mappings":";;AAgDA,MAAa,gBAAgB,WAA4B;CACvD,QAAQ,WAAmB;EACzB,IAAI,OAAO,UACT,KAAK,MAAM,MAAM,OAAO,UACtB,OAAO,KAAK,EAAE;EAIlB,IAAI,OAAO,SACT,KAAK,MAAM,MAAM,OAAO,SACtB,OAAO,KAAK,EAAE;EAIlB,IAAI,OAAO,KACT,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAAG,GAClD,QAAQ,IAAI,OAAO,OAAO,KAAK;EAInC,IAAI,OAAO,OACT,OAAO,IAAI,cAAc,OAAO,KAAK;EAGvC,IAAI,OAAO,KACT,OAAO,IAAI,YAAY,OAAO,GAAG;EAGnC,IAAI,OAAO,OACT,OAAO,IAAI,iBAAiB,OAAO,KAAK;EAG1C,OAAO,CAAC;CACV;AACF"}