alepha 0.13.0 → 0.13.1

package/dist/api-verifications/index.cjs

@@ -1,407 +0,0 @@
-let alepha = require("alepha");
-let alepha_server = require("alepha/server");
-let node_crypto = require("node:crypto");
-let alepha_datetime = require("alepha/datetime");
-let alepha_logger = require("alepha/logger");
-let alepha_orm = require("alepha/orm");
-let alepha_scheduler = require("alepha/scheduler");
-
-//#region src/api-verifications/schemas/requestVerificationCodeResponseSchema.ts
-const requestVerificationCodeResponseSchema = alepha.t.object({
-	token: alepha.t.string({ description: "The verification token (6-digit code for phone, UUID for email). The caller should send this to the user via their preferred notification method." }),
-	codeExpiration: alepha.t.integer({ description: "Time in seconds before your verification token expires." }),
-	verificationCooldown: alepha.t.integer({ description: "Cooldown period in seconds before you can request another verification." }),
-	maxVerificationAttempts: alepha.t.integer({ description: "Maximum number of verification attempts allowed before the token is locked." })
-});
-
-//#endregion
-//#region src/api-verifications/schemas/validateVerificationCodeResponseSchema.ts
-const validateVerificationCodeResponseSchema = alepha.t.object({
-	ok: alepha.t.boolean({ description: "Indicates whether the verification was successful." }),
-	alreadyVerified: alepha.t.optional(alepha.t.boolean({ description: "Indicates whether the target was already verified." }))
-});
-
-//#endregion
-//#region src/api-verifications/schemas/verificationTypeEnumSchema.ts
-const verificationTypeEnumSchema = alepha.t.enum(["code", "link"]);
-
-//#endregion
-//#region src/api-verifications/entities/verifications.ts
-const verifications = (0, alepha_orm.$entity)({
-	name: "verification",
-	schema: alepha.t.object({
-		id: alepha_orm.pg.primaryKey(alepha.t.bigint()),
-		createdAt: alepha_orm.pg.createdAt(),
-		updatedAt: alepha_orm.pg.updatedAt(),
-		version: alepha_orm.pg.version(),
-		type: verificationTypeEnumSchema,
-		target: alepha.t.text({ description: "Can be a phone (E.164 format) or email address" }),
-		code: alepha.t.text({ description: "Hashed verification token (n-digit code or UUID)" }),
-		verifiedAt: alepha.t.optional(alepha.t.datetime({ description: "When it was successfully verified" })),
-		attempts: alepha_orm.pg.default(alepha.t.integer({ description: "Number of failed attempts (to prevent brute-force)" }), 0)
-	}),
-	indexes: ["createdAt", { columns: ["target", "code"] }]
-});
-const verificationEntitySchema = verifications.schema;
-const verificationEntityInsertSchema = verifications.insertSchema;
-
-//#endregion
-//#region src/api-verifications/schemas/verificationSettingsSchema.ts
-const verificationSettingsSchema = alepha.t.object({
-	code: alepha.t.object({
-		maxAttempts: alepha.t.integer({
-			description: "Maximum number of attempts before locking the verification.",
-			minimum: 1,
-			maximum: 10
-		}),
-		codeLength: alepha.t.integer({
-			description: "Length of the verification code.",
-			minimum: 4,
-			maximum: 12
-		}),
-		codeExpiration: alepha.t.integer({
-			description: "Time in seconds before the verification code expires.",
-			minimum: 60,
-			maximum: 3600
-		}),
-		verificationCooldown: alepha.t.integer({
-			description: "Cooldown period in seconds after a request verification.",
-			minimum: 0,
-			maximum: 3600
-		}),
-		limitPerDay: alepha.t.integer({
-			description: "Maximum number of verification requests per day for one entry.",
-			minimum: 1,
-			maximum: 100
-		})
-	}, { description: "Settings specific to code verifications." }),
-	link: alepha.t.object({
-		maxAttempts: alepha.t.integer({
-			description: "Maximum number of attempts before locking the verification.",
-			minimum: 1,
-			maximum: 10
-		}),
-		codeExpiration: alepha.t.integer({
-			description: "Time in seconds before the verification token expires.",
-			minimum: 60,
-			maximum: 7200
-		}),
-		verificationCooldown: alepha.t.integer({
-			description: "Cooldown period in seconds after a request verification.",
-			minimum: 0,
-			maximum: 3600
-		}),
-		limitPerDay: alepha.t.integer({
-			description: "Maximum number of verification requests per day for one entry.",
-			minimum: 1,
-			maximum: 100
-		})
-	}, { description: "Settings specific to link verifications." }),
-	purgeDays: alepha.t.integer({
-		description: "Number of days after which expired verifications are automatically deleted. Set to 0 to disable auto-deletion.",
-		minimum: 0,
-		maximum: 365
-	})
-});
-
-//#endregion
-//#region src/api-verifications/parameters/VerificationParameters.ts
-/**
-* Verification settings configuration atom
-*/
-const verificationOptions = (0, alepha.$atom)({
-	name: "alepha.api.verifications.options",
-	schema: verificationSettingsSchema,
-	default: {
-		code: {
-			maxAttempts: 5,
-			codeLength: 6,
-			codeExpiration: 300,
-			verificationCooldown: 90,
-			limitPerDay: 10
-		},
-		link: {
-			maxAttempts: 3,
-			codeExpiration: 1800,
-			verificationCooldown: 90,
-			limitPerDay: 10
-		},
-		purgeDays: 1
-	}
-});
-var VerificationParameters = class {
-	options = (0, alepha.$use)(verificationOptions);
-	get(key) {
-		return this.options[key];
-	}
-};
-
-//#endregion
-//#region src/api-verifications/services/VerificationService.ts
-var VerificationService = class {
-	log = (0, alepha_logger.$logger)();
-	dateTimeProvider = (0, alepha.$inject)(alepha_datetime.DateTimeProvider);
-	verificationParameters = (0, alepha.$inject)(VerificationParameters);
-	verificationRepository = (0, alepha_orm.$repository)(verifications);
-	async findByEntry(entry) {
-		this.log.trace("Finding verification by entry", {
-			type: entry.type,
-			target: entry.target
-		});
-		const results = await this.verificationRepository.findMany({
-			limit: 1,
-			orderBy: {
-				column: "createdAt",
-				direction: "desc"
-			},
-			where: {
-				type: { eq: entry.type },
-				target: { eq: entry.target }
-			}
-		});
-		if (results.length === 0) {
-			this.log.debug("Verification entry not found", {
-				type: entry.type,
-				target: entry.target
-			});
-			throw new alepha_server.NotFoundError("Verification entry not found");
-		}
-		this.log.debug("Verification entry found", {
-			id: results[0].id,
-			type: entry.type,
-			target: entry.target
-		});
-		return results[0];
-	}
-	findRecentsByEntry(entry) {
-		this.log.trace("Finding recent verifications by entry", {
-			type: entry.type,
-			target: entry.target
-		});
-		return this.verificationRepository.findMany({
-			orderBy: {
-				column: "createdAt",
-				direction: "desc"
-			},
-			where: {
-				type: { eq: entry.type },
-				target: { eq: entry.target },
-				createdAt: { gte: this.dateTimeProvider.now().startOf("day").toISOString() }
-			}
-		});
-	}
-	/**
-	* Creates a verification entry and returns the token.
-	* The caller is responsible for sending notifications with the token.
-	* This allows for context-specific notifications (e.g., password reset vs email verification).
-	*/
-	async createVerification(entry) {
-		this.log.trace("Creating verification", {
-			type: entry.type,
-			target: entry.target
-		});
-		const settings = this.verificationParameters.get(entry.type);
-		const recents = await this.findRecentsByEntry(entry);
-		if (recents.length >= settings.limitPerDay) {
-			this.log.warn("Daily verification limit reached", {
-				type: entry.type,
-				target: entry.target,
-				limit: settings.limitPerDay,
-				count: recents.length
-			});
-			throw new alepha_server.BadRequestError(`Maximum number of verification requests per day reached (${settings.limitPerDay})`);
-		}
-		const existingVerification = recents[0];
-		if (existingVerification) {
-			const diffSec = this.dateTimeProvider.now().unix() - this.dateTimeProvider.of(existingVerification.createdAt).unix();
-			if (diffSec < settings.verificationCooldown) {
-				const remainingCooldown = Math.floor(settings.verificationCooldown - diffSec);
-				this.log.debug("Verification on cooldown", {
-					type: entry.type,
-					target: entry.target,
-					remainingSeconds: remainingCooldown
-				});
-				throw new alepha_server.BadRequestError(`Verification is on cooldown for ${remainingCooldown} seconds`);
-			}
-		}
-		const token = this.generateToken(entry.type);
-		const verification = await this.verificationRepository.create({
-			type: entry.type,
-			target: entry.target,
-			code: this.hashCode(token)
-		});
-		this.log.info("Verification created", {
-			id: verification.id,
-			type: entry.type,
-			target: entry.target,
-			expiresInSeconds: settings.codeExpiration
-		});
-		return {
-			token,
-			codeExpiration: settings.codeExpiration,
-			verificationCooldown: settings.verificationCooldown,
-			maxVerificationAttempts: settings.maxAttempts
-		};
-	}
-	async verifyCode(entry, code) {
-		this.log.trace("Verifying code", {
-			type: entry.type,
-			target: entry.target
-		});
-		const settings = this.verificationParameters.get(entry.type);
-		const verification = await this.findByEntry(entry);
-		if (verification.verifiedAt) {
-			this.log.debug("Verification already verified", {
-				id: verification.id,
-				type: entry.type,
-				target: entry.target,
-				verifiedAt: verification.verifiedAt
-			});
-			return {
-				ok: true,
-				alreadyVerified: true
-			};
-		}
-		const now = this.dateTimeProvider.now();
-		const expirationDate = this.dateTimeProvider.of(verification.createdAt).add(settings.codeExpiration, "seconds");
-		if (now > expirationDate) {
-			this.log.warn("Verification code expired", {
-				id: verification.id,
-				type: entry.type,
-				target: entry.target,
-				createdAt: verification.createdAt,
-				expiredAt: expirationDate.toISOString()
-			});
-			throw new alepha_server.BadRequestError("Verification code has expired");
-		}
-		if (verification.attempts >= settings.maxAttempts) {
-			this.log.warn("Verification locked due to max attempts", {
-				id: verification.id,
-				type: entry.type,
-				target: entry.target,
-				attempts: verification.attempts,
-				maxAttempts: settings.maxAttempts
-			});
-			throw new alepha_server.BadRequestError("Maximum number of attempts reached - verification is locked");
-		}
-		if (verification.code !== this.hashCode(code)) {
-			const newAttempts = verification.attempts + 1;
-			this.log.warn("Invalid verification code", {
-				id: verification.id,
-				type: entry.type,
-				target: entry.target,
-				attempts: newAttempts,
-				maxAttempts: settings.maxAttempts
-			});
-			await this.verificationRepository.updateById(verification.id, { attempts: newAttempts });
-			throw new alepha_server.BadRequestError("Invalid verification code");
-		}
-		await this.verificationRepository.updateById(verification.id, { verifiedAt: this.dateTimeProvider.nowISOString() });
-		this.log.info("Verification code verified", {
-			id: verification.id,
-			type: entry.type,
-			target: entry.target
-		});
-		return { ok: true };
-	}
-	hashCode(code) {
-		return (0, node_crypto.createHash)("sha256").update(code).digest("hex");
-	}
-	generateToken(type) {
-		if (type === "code") {
-			const settings = this.verificationParameters.get("code");
-			return (0, node_crypto.randomInt)(0, 1e6).toString().padStart(settings.codeLength, "0");
-		} else if (type === "link") return (0, node_crypto.randomUUID)();
-		throw new alepha_server.BadRequestError(`Invalid verification type: ${type}`);
-	}
-};
-
-//#endregion
-//#region src/api-verifications/controllers/VerificationController.ts
-var VerificationController = class {
-	verificationService = (0, alepha.$inject)(VerificationService);
-	url = "/verifications";
-	group = "verifications";
-	requestVerificationCode = (0, alepha_server.$action)({
-		path: `${this.url}/:type`,
-		group: this.group,
-		method: "POST",
-		schema: {
-			params: alepha.t.object({ type: verificationTypeEnumSchema }),
-			body: alepha.t.object({ target: alepha.t.text() }),
-			response: requestVerificationCodeResponseSchema
-		},
-		handler: async ({ body, params }) => {
-			return await this.verificationService.createVerification({
-				type: params.type,
-				target: body.target
-			});
-		}
-	});
-	validateVerificationCode = (0, alepha_server.$action)({
-		path: `${this.url}/:type/validate`,
-		group: this.group,
-		method: "POST",
-		schema: {
-			params: alepha.t.object({ type: verificationTypeEnumSchema }),
-			body: alepha.t.object({
-				target: alepha.t.text(),
-				token: alepha.t.text({ description: "The verification token (6-digit code for phone, UUID for email)." })
-			}),
-			response: validateVerificationCodeResponseSchema
-		},
-		handler: async ({ body, params }) => {
-			return this.verificationService.verifyCode({
-				type: params.type,
-				target: body.target
-			}, body.token);
-		}
-	});
-};
-
-//#endregion
-//#region src/api-verifications/jobs/VerificationJobs.ts
-var VerificationJobs = class {
-	verificationRepository = (0, alepha_orm.$repository)(verifications);
-	verificationParameters = (0, alepha.$inject)(VerificationParameters);
-	dateTimeProvider = (0, alepha.$inject)(alepha_datetime.DateTimeProvider);
-	cleanExpired = (0, alepha_scheduler.$scheduler)({
-		cron: "0 0 * * *",
-		description: "Clean expired verifications",
-		handler: async () => {
-			const purgeDays = this.verificationParameters.get("purgeDays");
-			if (purgeDays <= 0) return;
-			const purgeThreshold = Date.now() - purgeDays * (1440 * 60 * 1e3);
-			await this.verificationRepository.deleteMany({ createdAt: { lt: this.dateTimeProvider.of(purgeThreshold).toISOString() } });
-		}
-	});
-};
-
-//#endregion
-//#region src/api-verifications/index.ts
-/**
-* Provides email/phone verification management API endpoints for Alepha applications.
-*
-* This module includes verification code generation, validation,
-* and related functionalities. Notifications are handled by the consuming module
-* (e.g., api-users) for context-specific messaging.
-*
-* @module alepha.api.verifications
-*/
-const AlephaApiVerification = (0, alepha.$module)({
-	name: "alepha.api.verifications",
-	services: [
-		VerificationController,
-		VerificationJobs,
-		VerificationService
-	]
-});
-
-//#endregion
-exports.AlephaApiVerification = AlephaApiVerification;
-exports.VerificationController = VerificationController;
-exports.VerificationService = VerificationService;
-exports.requestVerificationCodeResponseSchema = requestVerificationCodeResponseSchema;
-exports.validateVerificationCodeResponseSchema = validateVerificationCodeResponseSchema;
-exports.verificationTypeEnumSchema = verificationTypeEnumSchema;
-//# sourceMappingURL=index.cjs.map

package/dist/api-verifications/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["t","t","t","t","pg","t","DateTimeProvider","NotFoundError","BadRequestError","t","DateTimeProvider"],"sources":["../../src/api-verifications/schemas/requestVerificationCodeResponseSchema.ts","../../src/api-verifications/schemas/validateVerificationCodeResponseSchema.ts","../../src/api-verifications/schemas/verificationTypeEnumSchema.ts","../../src/api-verifications/entities/verifications.ts","../../src/api-verifications/schemas/verificationSettingsSchema.ts","../../src/api-verifications/parameters/VerificationParameters.ts","../../src/api-verifications/services/VerificationService.ts","../../src/api-verifications/controllers/VerificationController.ts","../../src/api-verifications/jobs/VerificationJobs.ts","../../src/api-verifications/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const requestVerificationCodeResponseSchema = t.object({\n  token: t.string({\n    description:\n      \"The verification token (6-digit code for phone, UUID for email). The caller should send this to the user via their preferred notification method.\",\n  }),\n  codeExpiration: t.integer({\n    description: \"Time in seconds before your verification token expires.\",\n  }),\n  verificationCooldown: t.integer({\n    description:\n      \"Cooldown period in seconds before you can request another verification.\",\n  }),\n  maxVerificationAttempts: t.integer({\n    description:\n      \"Maximum number of verification attempts allowed before the token is locked.\",\n  }),\n});\n\nexport type RequestVerificationResponse = Static<\n  typeof requestVerificationCodeResponseSchema\n>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const validateVerificationCodeResponseSchema = t.object({\n  ok: t.boolean({\n    description: \"Indicates whether the verification was successful.\",\n  }),\n  alreadyVerified: t.optional(\n    t.boolean({\n      description: \"Indicates whether the target was already verified.\",\n    }),\n  ),\n});\n\nexport type ValidateVerificationCodeResponse = Static<\n  typeof validateVerificationCodeResponseSchema\n>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const verificationTypeEnumSchema = t.enum([\"code\", \"link\"]);\nexport type VerificationTypeEnum = Static<typeof verificationTypeEnumSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { $entity, pg } from \"alepha/orm\";\nimport { verificationTypeEnumSchema } from \"../schemas/verificationTypeEnumSchema.ts\";\n\nexport const verifications = $entity({\n  name: \"verification\",\n  schema: t.object({\n    id: pg.primaryKey(t.bigint()),\n\n    createdAt: pg.createdAt(),\n\n    updatedAt: pg.updatedAt(),\n\n    version: pg.version(),\n\n    type: verificationTypeEnumSchema,\n\n    target: t.text({\n      description: \"Can be a phone (E.164 format) or email address\",\n    }),\n\n    code: t.text({\n      description: \"Hashed verification token (n-digit code or UUID)\",\n    }),\n\n    verifiedAt: t.optional(\n      t.datetime({\n        description: \"When it was successfully verified\",\n      }),\n    ),\n\n    attempts: pg.default(\n      t.integer({\n        description: \"Number of failed attempts (to prevent brute-force)\",\n      }),\n      0,\n    ),\n  }),\n  indexes: [\n    \"createdAt\",\n    {\n      columns: [\"target\", \"code\"],\n    },\n  ],\n});\n\nexport const verificationEntitySchema = verifications.schema;\nexport const verificationEntityInsertSchema = verifications.insertSchema;\nexport type VerificationEntity = Static<typeof verifications.schema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const verificationSettingsSchema = t.object({\n  code: t.object(\n    {\n      maxAttempts: t.integer({\n        description:\n          \"Maximum number of attempts before locking the verification.\",\n        minimum: 1,\n        maximum: 10,\n      }),\n      codeLength: t.integer({\n        description: \"Length of the verification code.\",\n        minimum: 4,\n        maximum: 12,\n      }),\n      codeExpiration: t.integer({\n        description: \"Time in seconds before the verification code expires.\",\n        minimum: 60, // 1 minute\n        maximum: 3600, // 1 hour\n      }),\n      verificationCooldown: t.integer({\n        description: \"Cooldown period in seconds after a request verification.\",\n        minimum: 0,\n        maximum: 3600, // 1 hour\n      }),\n      limitPerDay: t.integer({\n        description:\n          \"Maximum number of verification requests per day for one entry.\",\n        minimum: 1,\n        maximum: 100,\n      }),\n    },\n    {\n      description: \"Settings specific to code verifications.\",\n    },\n  ),\n  link: t.object(\n    {\n      maxAttempts: t.integer({\n        description:\n          \"Maximum number of attempts before locking the verification.\",\n        minimum: 1,\n        maximum: 10,\n      }),\n      codeExpiration: t.integer({\n        description: \"Time in seconds before the verification token expires.\",\n        minimum: 60, // 1 minute\n        maximum: 7200, // 2 hours\n      }),\n      verificationCooldown: t.integer({\n        description: \"Cooldown period in seconds after a request verification.\",\n        minimum: 0,\n        maximum: 3600, // 1 hour\n      }),\n      limitPerDay: t.integer({\n        description:\n          \"Maximum number of verification requests per day for one entry.\",\n        minimum: 1,\n        maximum: 100,\n      }),\n    },\n    {\n      description: \"Settings specific to link verifications.\",\n    },\n  ),\n  purgeDays: t.integer({\n    description:\n      \"Number of days after which expired verifications are automatically deleted. Set to 0 to disable auto-deletion.\",\n    minimum: 0,\n    maximum: 365,\n  }),\n});\n\nexport type VerificationSettings = Static<typeof verificationSettingsSchema>;\n","import { $atom, $use, type Static } from \"alepha\";\nimport {\n  type VerificationSettings,\n  verificationSettingsSchema,\n} from \"../schemas/verificationSettingsSchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Verification settings configuration atom\n */\nexport const verificationOptions = $atom({\n  name: \"alepha.api.verifications.options\",\n  schema: verificationSettingsSchema,\n  default: {\n    code: {\n      maxAttempts: 5,\n      codeLength: 6,\n      codeExpiration: 300, // 5 minutes\n      verificationCooldown: 90,\n      limitPerDay: 10,\n    },\n    link: {\n      maxAttempts: 3, // Lower since UUIDs are harder to guess\n      codeExpiration: 1800, // 30 minutes\n      verificationCooldown: 90,\n      limitPerDay: 10,\n    },\n    purgeDays: 1,\n  },\n});\n\nexport type VerificationOptions = Static<typeof verificationOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [verificationOptions.key]: VerificationOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class VerificationParameters {\n  protected readonly options = $use(verificationOptions);\n\n  public get<K extends keyof VerificationSettings>(\n    key: K,\n  ): VerificationSettings[K] {\n    return this.options[key];\n  }\n}\n","import { createHash, randomInt, randomUUID } from \"node:crypto\";\nimport { $inject } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { BadRequestError, NotFoundError } from \"alepha/server\";\nimport {\n  type VerificationEntity,\n  verifications,\n} from \"../entities/verifications.ts\";\nimport { VerificationParameters } from \"../parameters/VerificationParameters.ts\";\nimport type { RequestVerificationResponse } from \"../schemas/requestVerificationCodeResponseSchema.ts\";\nimport type { ValidateVerificationCodeResponse } from \"../schemas/validateVerificationCodeResponseSchema.ts\";\nimport type { VerificationTypeEnum } from \"../schemas/verificationTypeEnumSchema.ts\";\n\nexport class VerificationService {\n  protected readonly log = $logger();\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly verificationParameters = $inject(VerificationParameters);\n  protected readonly verificationRepository = $repository(verifications);\n\n  public async findByEntry(\n    entry: VerificationEntry,\n  ): Promise<VerificationEntity> {\n    this.log.trace(\"Finding verification by entry\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const results = await this.verificationRepository.findMany({\n      limit: 1, // only need the most recent entry\n      orderBy: {\n        column: \"createdAt\",\n        direction: \"desc\",\n      },\n      where: {\n        type: { eq: entry.type },\n        target: { eq: entry.target },\n      },\n    });\n\n    if (results.length === 0) {\n      this.log.debug(\"Verification entry not found\", {\n        type: entry.type,\n        target: entry.target,\n      });\n      throw new NotFoundError(\"Verification entry not found\");\n    }\n\n    this.log.debug(\"Verification entry found\", {\n      id: results[0].id,\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return results[0];\n  }\n\n  public findRecentsByEntry(entry: VerificationEntry) {\n    this.log.trace(\"Finding recent verifications by entry\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return this.verificationRepository.findMany({\n      orderBy: {\n        column: \"createdAt\",\n        direction: \"desc\",\n      },\n      where: {\n        type: { eq: entry.type },\n        target: { eq: entry.target },\n        createdAt: {\n          gte: this.dateTimeProvider.now().startOf(\"day\").toISOString(),\n        },\n      },\n    });\n  }\n\n  /**\n   * Creates a verification entry and returns the token.\n   * The caller is responsible for sending notifications with the token.\n   * This allows for context-specific notifications (e.g., password reset vs email verification).\n   */\n  public async createVerification(\n    entry: VerificationEntry,\n  ): Promise<RequestVerificationResponse> {\n    this.log.trace(\"Creating verification\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const settings = this.verificationParameters.get(entry.type);\n\n    const recents = await this.findRecentsByEntry(entry);\n    if (recents.length >= settings.limitPerDay) {\n      this.log.warn(\"Daily verification limit reached\", {\n        type: entry.type,\n        target: entry.target,\n        limit: settings.limitPerDay,\n        count: recents.length,\n      });\n      throw new BadRequestError(\n        `Maximum number of verification requests per day reached (${settings.limitPerDay})`,\n      );\n    }\n\n    const existingVerification = recents[0];\n    if (existingVerification) {\n      const nowSec = this.dateTimeProvider.now().unix();\n      const createdAtSec = this.dateTimeProvider\n        .of(existingVerification.createdAt)\n        .unix();\n\n      const diffSec = nowSec - createdAtSec;\n      if (diffSec < settings.verificationCooldown) {\n        const remainingCooldown = Math.floor(\n          settings.verificationCooldown - diffSec,\n        );\n        this.log.debug(\"Verification on cooldown\", {\n          type: entry.type,\n          target: entry.target,\n          remainingSeconds: remainingCooldown,\n        });\n        throw new BadRequestError(\n          `Verification is on cooldown for ${remainingCooldown} seconds`,\n        );\n      }\n    }\n\n    const token = this.generateToken(entry.type);\n\n    const verification = await this.verificationRepository.create({\n      type: entry.type,\n      target: entry.target,\n      code: this.hashCode(token),\n    });\n\n    this.log.info(\"Verification created\", {\n      id: verification.id,\n      type: entry.type,\n      target: entry.target,\n      expiresInSeconds: settings.codeExpiration,\n    });\n\n    return {\n      token,\n      codeExpiration: settings.codeExpiration,\n      verificationCooldown: settings.verificationCooldown,\n      maxVerificationAttempts: settings.maxAttempts,\n    };\n  }\n\n  public async verifyCode(\n    entry: VerificationEntry,\n    code: string,\n  ): Promise<ValidateVerificationCodeResponse> {\n    this.log.trace(\"Verifying code\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const settings = this.verificationParameters.get(entry.type);\n\n    const verification = await this.findByEntry(entry);\n    if (verification.verifiedAt) {\n      this.log.debug(\"Verification already verified\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        verifiedAt: verification.verifiedAt,\n      });\n      return { ok: true, alreadyVerified: true };\n    }\n\n    // DO NOT DELETE THE VERIFICATION WHEN IT IS REJECTED,\n    // or we won't be able to cooldown the verification\n\n    const now = this.dateTimeProvider.now();\n    const expirationDate = this.dateTimeProvider\n      .of(verification.createdAt)\n      .add(settings.codeExpiration, \"seconds\");\n\n    if (now > expirationDate) {\n      this.log.warn(\"Verification code expired\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        createdAt: verification.createdAt,\n        expiredAt: expirationDate.toISOString(),\n      });\n      throw new BadRequestError(\"Verification code has expired\");\n    }\n\n    if (verification.attempts >= settings.maxAttempts) {\n      this.log.warn(\"Verification locked due to max attempts\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        attempts: verification.attempts,\n        maxAttempts: settings.maxAttempts,\n      });\n      throw new BadRequestError(\n        \"Maximum number of attempts reached - verification is locked\",\n      );\n    }\n\n    if (verification.code !== this.hashCode(code)) {\n      const newAttempts = verification.attempts + 1;\n      this.log.warn(\"Invalid verification code\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        attempts: newAttempts,\n        maxAttempts: settings.maxAttempts,\n      });\n      await this.verificationRepository.updateById(verification.id, {\n        attempts: newAttempts,\n      });\n      throw new BadRequestError(\"Invalid verification code\");\n    }\n\n    await this.verificationRepository.updateById(verification.id, {\n      verifiedAt: this.dateTimeProvider.nowISOString(),\n    });\n\n    this.log.info(\"Verification code verified\", {\n      id: verification.id,\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return { ok: true };\n  }\n\n  public hashCode(code: string): string {\n    return createHash(\"sha256\").update(code).digest(\"hex\");\n  }\n\n  public generateToken(type: VerificationTypeEnum): string {\n    if (type === \"code\") {\n      const settings = this.verificationParameters.get(\"code\");\n      return randomInt(0, 1_000_000)\n        .toString()\n        .padStart(settings.codeLength, \"0\");\n    } else if (type === \"link\") {\n      return randomUUID();\n    }\n\n    throw new BadRequestError(`Invalid verification type: ${type}`);\n  }\n}\n\nexport interface VerificationEntry {\n  type: VerificationTypeEnum;\n  target: string;\n}\n","import { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { requestVerificationCodeResponseSchema } from \"../schemas/requestVerificationCodeResponseSchema.ts\";\nimport { validateVerificationCodeResponseSchema } from \"../schemas/validateVerificationCodeResponseSchema.ts\";\nimport { verificationTypeEnumSchema } from \"../schemas/verificationTypeEnumSchema.ts\";\nimport { VerificationService } from \"../services/VerificationService.ts\";\n\nexport class VerificationController {\n  protected readonly verificationService = $inject(VerificationService);\n\n  public readonly url = \"/verifications\";\n  public readonly group = \"verifications\";\n\n  public readonly requestVerificationCode = $action({\n    path: `${this.url}/:type`,\n    group: this.group,\n    method: \"POST\",\n    schema: {\n      params: t.object({\n        type: verificationTypeEnumSchema,\n      }),\n      body: t.object({\n        target: t.text(),\n      }),\n      response: requestVerificationCodeResponseSchema,\n    },\n    handler: async ({ body, params }) => {\n      return await this.verificationService.createVerification({\n        type: params.type,\n        target: body.target,\n      });\n    },\n  });\n\n  public readonly validateVerificationCode = $action({\n    path: `${this.url}/:type/validate`,\n    group: this.group,\n    method: \"POST\",\n    schema: {\n      params: t.object({\n        type: verificationTypeEnumSchema,\n      }),\n      body: t.object({\n        target: t.text(),\n        token: t.text({\n          description:\n            \"The verification token (6-digit code for phone, UUID for email).\",\n        }),\n      }),\n      response: validateVerificationCodeResponseSchema,\n    },\n    handler: async ({ body, params }) => {\n      return this.verificationService.verifyCode(\n        {\n          type: params.type,\n          target: body.target,\n        },\n        body.token,\n      );\n    },\n  });\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $repository } from \"alepha/orm\";\nimport { $scheduler } from \"alepha/scheduler\";\nimport { verifications } from \"../entities/verifications.ts\";\nimport { VerificationParameters } from \"../parameters/VerificationParameters.ts\";\n\nexport class VerificationJobs {\n  protected readonly verificationRepository = $repository(verifications);\n  protected readonly verificationParameters = $inject(VerificationParameters);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  public readonly cleanExpired = $scheduler({\n    cron: \"0 0 * * *\", // Every day at midnight\n    description: \"Clean expired verifications\",\n    handler: async () => {\n      const purgeDays = this.verificationParameters.get(\"purgeDays\");\n      if (purgeDays <= 0) {\n        return; // Auto deletion is disabled\n      }\n\n      const dayMs = 24 * 60 * 60 * 1000;\n      const purgeThreshold = Date.now() - purgeDays * dayMs;\n\n      await this.verificationRepository.deleteMany({\n        createdAt: {\n          lt: this.dateTimeProvider.of(purgeThreshold).toISOString(),\n        },\n      });\n    },\n  });\n}\n","import { $module } from \"alepha\";\nimport { VerificationController } from \"./controllers/VerificationController.ts\";\nimport { VerificationJobs } from \"./jobs/VerificationJobs.ts\";\nimport { VerificationService } from \"./services/VerificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/VerificationController.ts\";\nexport * from \"./schemas/requestVerificationCodeResponseSchema.ts\";\nexport * from \"./schemas/validateVerificationCodeResponseSchema.ts\";\nexport * from \"./schemas/verificationTypeEnumSchema.ts\";\nexport * from \"./services/VerificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides email/phone verification management API endpoints for Alepha applications.\n *\n * This module includes verification code generation, validation,\n * and related functionalities. Notifications are handled by the consuming module\n * (e.g., api-users) for context-specific messaging.\n *\n * @module alepha.api.verifications\n */\nexport const AlephaApiVerification = $module({\n  name: \"alepha.api.verifications\",\n  services: [VerificationController, VerificationJobs, VerificationService],\n});\n"],"mappings":";;;;;;;;;AAGA,MAAa,wCAAwCA,SAAE,OAAO;CAC5D,OAAOA,SAAE,OAAO,EACd,aACE,qJACH,CAAC;CACF,gBAAgBA,SAAE,QAAQ,EACxB,aAAa,2DACd,CAAC;CACF,sBAAsBA,SAAE,QAAQ,EAC9B,aACE,2EACH,CAAC;CACF,yBAAyBA,SAAE,QAAQ,EACjC,aACE,+EACH,CAAC;CACH,CAAC;;;;AChBF,MAAa,yCAAyCC,SAAE,OAAO;CAC7D,IAAIA,SAAE,QAAQ,EACZ,aAAa,sDACd,CAAC;CACF,iBAAiBA,SAAE,SACjBA,SAAE,QAAQ,EACR,aAAa,sDACd,CAAC,CACH;CACF,CAAC;;;;ACTF,MAAa,6BAA6BC,SAAE,KAAK,CAAC,QAAQ,OAAO,CAAC;;;;ACElE,MAAa,wCAAwB;CACnC,MAAM;CACN,QAAQC,SAAE,OAAO;EACf,IAAIC,cAAG,WAAWD,SAAE,QAAQ,CAAC;EAE7B,WAAWC,cAAG,WAAW;EAEzB,WAAWA,cAAG,WAAW;EAEzB,SAASA,cAAG,SAAS;EAErB,MAAM;EAEN,QAAQD,SAAE,KAAK,EACb,aAAa,kDACd,CAAC;EAEF,MAAMA,SAAE,KAAK,EACX,aAAa,oDACd,CAAC;EAEF,YAAYA,SAAE,SACZA,SAAE,SAAS,EACT,aAAa,qCACd,CAAC,CACH;EAED,UAAUC,cAAG,QACXD,SAAE,QAAQ,EACR,aAAa,sDACd,CAAC,EACF,EACD;EACF,CAAC;CACF,SAAS,CACP,aACA,EACE,SAAS,CAAC,UAAU,OAAO,EAC5B,CACF;CACF,CAAC;AAEF,MAAa,2BAA2B,cAAc;AACtD,MAAa,iCAAiC,cAAc;;;;AC7C5D,MAAa,6BAA6BE,SAAE,OAAO;CACjD,MAAMA,SAAE,OACN;EACE,aAAaA,SAAE,QAAQ;GACrB,aACE;GACF,SAAS;GACT,SAAS;GACV,CAAC;EACF,YAAYA,SAAE,QAAQ;GACpB,aAAa;GACb,SAAS;GACT,SAAS;GACV,CAAC;EACF,gBAAgBA,SAAE,QAAQ;GACxB,aAAa;GACb,SAAS;GACT,SAAS;GACV,CAAC;EACF,sBAAsBA,SAAE,QAAQ;GAC9B,aAAa;GACb,SAAS;GACT,SAAS;GACV,CAAC;EACF,aAAaA,SAAE,QAAQ;GACrB,aACE;GACF,SAAS;GACT,SAAS;GACV,CAAC;EACH,EACD,EACE,aAAa,4CACd,CACF;CACD,MAAMA,SAAE,OACN;EACE,aAAaA,SAAE,QAAQ;GACrB,aACE;GACF,SAAS;GACT,SAAS;GACV,CAAC;EACF,gBAAgBA,SAAE,QAAQ;GACxB,aAAa;GACb,SAAS;GACT,SAAS;GACV,CAAC;EACF,sBAAsBA,SAAE,QAAQ;GAC9B,aAAa;GACb,SAAS;GACT,SAAS;GACV,CAAC;EACF,aAAaA,SAAE,QAAQ;GACrB,aACE;GACF,SAAS;GACT,SAAS;GACV,CAAC;EACH,EACD,EACE,aAAa,4CACd,CACF;CACD,WAAWA,SAAE,QAAQ;EACnB,aACE;EACF,SAAS;EACT,SAAS;EACV,CAAC;CACH,CAAC;;;;;;;AC9DF,MAAa,wCAA4B;CACvC,MAAM;CACN,QAAQ;CACR,SAAS;EACP,MAAM;GACJ,aAAa;GACb,YAAY;GACZ,gBAAgB;GAChB,sBAAsB;GACtB,aAAa;GACd;EACD,MAAM;GACJ,aAAa;GACb,gBAAgB;GAChB,sBAAsB;GACtB,aAAa;GACd;EACD,WAAW;EACZ;CACF,CAAC;AAYF,IAAa,yBAAb,MAAoC;CAClC,AAAmB,2BAAe,oBAAoB;CAEtD,AAAO,IACL,KACyB;AACzB,SAAO,KAAK,QAAQ;;;;;;ACjCxB,IAAa,sBAAb,MAAiC;CAC/B,AAAmB,kCAAe;CAClC,AAAmB,uCAA2BC,iCAAiB;CAC/D,AAAmB,6CAAiC,uBAAuB;CAC3E,AAAmB,qDAAqC,cAAc;CAEtE,MAAa,YACX,OAC6B;AAC7B,OAAK,IAAI,MAAM,iCAAiC;GAC9C,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;EAEF,MAAM,UAAU,MAAM,KAAK,uBAAuB,SAAS;GACzD,OAAO;GACP,SAAS;IACP,QAAQ;IACR,WAAW;IACZ;GACD,OAAO;IACL,MAAM,EAAE,IAAI,MAAM,MAAM;IACxB,QAAQ,EAAE,IAAI,MAAM,QAAQ;IAC7B;GACF,CAAC;AAEF,MAAI,QAAQ,WAAW,GAAG;AACxB,QAAK,IAAI,MAAM,gCAAgC;IAC7C,MAAM,MAAM;IACZ,QAAQ,MAAM;IACf,CAAC;AACF,SAAM,IAAIC,4BAAc,+BAA+B;;AAGzD,OAAK,IAAI,MAAM,4BAA4B;GACzC,IAAI,QAAQ,GAAG;GACf,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;AAEF,SAAO,QAAQ;;CAGjB,AAAO,mBAAmB,OAA0B;AAClD,OAAK,IAAI,MAAM,yCAAyC;GACtD,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;AAEF,SAAO,KAAK,uBAAuB,SAAS;GAC1C,SAAS;IACP,QAAQ;IACR,WAAW;IACZ;GACD,OAAO;IACL,MAAM,EAAE,IAAI,MAAM,MAAM;IACxB,QAAQ,EAAE,IAAI,MAAM,QAAQ;IAC5B,WAAW,EACT,KAAK,KAAK,iBAAiB,KAAK,CAAC,QAAQ,MAAM,CAAC,aAAa,EAC9D;IACF;GACF,CAAC;;;;;;;CAQJ,MAAa,mBACX,OACsC;AACtC,OAAK,IAAI,MAAM,yBAAyB;GACtC,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;EAEF,MAAM,WAAW,KAAK,uBAAuB,IAAI,MAAM,KAAK;EAE5D,MAAM,UAAU,MAAM,KAAK,mBAAmB,MAAM;AACpD,MAAI,QAAQ,UAAU,SAAS,aAAa;AAC1C,QAAK,IAAI,KAAK,oCAAoC;IAChD,MAAM,MAAM;IACZ,QAAQ,MAAM;IACd,OAAO,SAAS;IAChB,OAAO,QAAQ;IAChB,CAAC;AACF,SAAM,IAAIC,8BACR,4DAA4D,SAAS,YAAY,GAClF;;EAGH,MAAM,uBAAuB,QAAQ;AACrC,MAAI,sBAAsB;GAMxB,MAAM,UALS,KAAK,iBAAiB,KAAK,CAAC,MAAM,GAC5B,KAAK,iBACvB,GAAG,qBAAqB,UAAU,CAClC,MAAM;AAGT,OAAI,UAAU,SAAS,sBAAsB;IAC3C,MAAM,oBAAoB,KAAK,MAC7B,SAAS,uBAAuB,QACjC;AACD,SAAK,IAAI,MAAM,4BAA4B;KACzC,MAAM,MAAM;KACZ,QAAQ,MAAM;KACd,kBAAkB;KACnB,CAAC;AACF,UAAM,IAAIA,8BACR,mCAAmC,kBAAkB,UACtD;;;EAIL,MAAM,QAAQ,KAAK,cAAc,MAAM,KAAK;EAE5C,MAAM,eAAe,MAAM,KAAK,uBAAuB,OAAO;GAC5D,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,MAAM,KAAK,SAAS,MAAM;GAC3B,CAAC;AAEF,OAAK,IAAI,KAAK,wBAAwB;GACpC,IAAI,aAAa;GACjB,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,kBAAkB,SAAS;GAC5B,CAAC;AAEF,SAAO;GACL;GACA,gBAAgB,SAAS;GACzB,sBAAsB,SAAS;GAC/B,yBAAyB,SAAS;GACnC;;CAGH,MAAa,WACX,OACA,MAC2C;AAC3C,OAAK,IAAI,MAAM,kBAAkB;GAC/B,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;EAEF,MAAM,WAAW,KAAK,uBAAuB,IAAI,MAAM,KAAK;EAE5D,MAAM,eAAe,MAAM,KAAK,YAAY,MAAM;AAClD,MAAI,aAAa,YAAY;AAC3B,QAAK,IAAI,MAAM,iCAAiC;IAC9C,IAAI,aAAa;IACjB,MAAM,MAAM;IACZ,QAAQ,MAAM;IACd,YAAY,aAAa;IAC1B,CAAC;AACF,UAAO;IAAE,IAAI;IAAM,iBAAiB;IAAM;;EAM5C,MAAM,MAAM,KAAK,iBAAiB,KAAK;EACvC,MAAM,iBAAiB,KAAK,iBACzB,GAAG,aAAa,UAAU,CAC1B,IAAI,SAAS,gBAAgB,UAAU;AAE1C,MAAI,MAAM,gBAAgB;AACxB,QAAK,IAAI,KAAK,6BAA6B;IACzC,IAAI,aAAa;IACjB,MAAM,MAAM;IACZ,QAAQ,MAAM;IACd,WAAW,aAAa;IACxB,WAAW,eAAe,aAAa;IACxC,CAAC;AACF,SAAM,IAAIA,8BAAgB,gCAAgC;;AAG5D,MAAI,aAAa,YAAY,SAAS,aAAa;AACjD,QAAK,IAAI,KAAK,2CAA2C;IACvD,IAAI,aAAa;IACjB,MAAM,MAAM;IACZ,QAAQ,MAAM;IACd,UAAU,aAAa;IACvB,aAAa,SAAS;IACvB,CAAC;AACF,SAAM,IAAIA,8BACR,8DACD;;AAGH,MAAI,aAAa,SAAS,KAAK,SAAS,KAAK,EAAE;GAC7C,MAAM,cAAc,aAAa,WAAW;AAC5C,QAAK,IAAI,KAAK,6BAA6B;IACzC,IAAI,aAAa;IACjB,MAAM,MAAM;IACZ,QAAQ,MAAM;IACd,UAAU;IACV,aAAa,SAAS;IACvB,CAAC;AACF,SAAM,KAAK,uBAAuB,WAAW,aAAa,IAAI,EAC5D,UAAU,aACX,CAAC;AACF,SAAM,IAAIA,8BAAgB,4BAA4B;;AAGxD,QAAM,KAAK,uBAAuB,WAAW,aAAa,IAAI,EAC5D,YAAY,KAAK,iBAAiB,cAAc,EACjD,CAAC;AAEF,OAAK,IAAI,KAAK,8BAA8B;GAC1C,IAAI,aAAa;GACjB,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;AAEF,SAAO,EAAE,IAAI,MAAM;;CAGrB,AAAO,SAAS,MAAsB;AACpC,qCAAkB,SAAS,CAAC,OAAO,KAAK,CAAC,OAAO,MAAM;;CAGxD,AAAO,cAAc,MAAoC;AACvD,MAAI,SAAS,QAAQ;GACnB,MAAM,WAAW,KAAK,uBAAuB,IAAI,OAAO;AACxD,qCAAiB,GAAG,IAAU,CAC3B,UAAU,CACV,SAAS,SAAS,YAAY,IAAI;aAC5B,SAAS,OAClB,qCAAmB;AAGrB,QAAM,IAAIA,8BAAgB,8BAA8B,OAAO;;;;;;AClPnE,IAAa,yBAAb,MAAoC;CAClC,AAAmB,0CAA8B,oBAAoB;CAErE,AAAgB,MAAM;CACtB,AAAgB,QAAQ;CAExB,AAAgB,qDAAkC;EAChD,MAAM,GAAG,KAAK,IAAI;EAClB,OAAO,KAAK;EACZ,QAAQ;EACR,QAAQ;GACN,QAAQC,SAAE,OAAO,EACf,MAAM,4BACP,CAAC;GACF,MAAMA,SAAE,OAAO,EACb,QAAQA,SAAE,MAAM,EACjB,CAAC;GACF,UAAU;GACX;EACD,SAAS,OAAO,EAAE,MAAM,aAAa;AACnC,UAAO,MAAM,KAAK,oBAAoB,mBAAmB;IACvD,MAAM,OAAO;IACb,QAAQ,KAAK;IACd,CAAC;;EAEL,CAAC;CAEF,AAAgB,sDAAmC;EACjD,MAAM,GAAG,KAAK,IAAI;EAClB,OAAO,KAAK;EACZ,QAAQ;EACR,QAAQ;GACN,QAAQA,SAAE,OAAO,EACf,MAAM,4BACP,CAAC;GACF,MAAMA,SAAE,OAAO;IACb,QAAQA,SAAE,MAAM;IAChB,OAAOA,SAAE,KAAK,EACZ,aACE,oEACH,CAAC;IACH,CAAC;GACF,UAAU;GACX;EACD,SAAS,OAAO,EAAE,MAAM,aAAa;AACnC,UAAO,KAAK,oBAAoB,WAC9B;IACE,MAAM,OAAO;IACb,QAAQ,KAAK;IACd,EACD,KAAK,MACN;;EAEJ,CAAC;;;;;ACrDJ,IAAa,mBAAb,MAA8B;CAC5B,AAAmB,qDAAqC,cAAc;CACtE,AAAmB,6CAAiC,uBAAuB;CAC3E,AAAmB,uCAA2BC,iCAAiB;CAE/D,AAAgB,gDAA0B;EACxC,MAAM;EACN,aAAa;EACb,SAAS,YAAY;GACnB,MAAM,YAAY,KAAK,uBAAuB,IAAI,YAAY;AAC9D,OAAI,aAAa,EACf;GAIF,MAAM,iBAAiB,KAAK,KAAK,GAAG,aADtB,OAAU,KAAK;AAG7B,SAAM,KAAK,uBAAuB,WAAW,EAC3C,WAAW,EACT,IAAI,KAAK,iBAAiB,GAAG,eAAe,CAAC,aAAa,EAC3D,EACF,CAAC;;EAEL,CAAC;;;;;;;;;;;;;;ACNJ,MAAa,4CAAgC;CAC3C,MAAM;CACN,UAAU;EAAC;EAAwB;EAAkB;EAAoB;CAC1E,CAAC"}

package/dist/api-verifications/index.d.cts

@@ -1,207 +0,0 @@
-import * as alepha76 from "alepha";
-import { Static } from "alepha";
-import * as alepha_server0 from "alepha/server";
-import * as alepha_logger0 from "alepha/logger";
-import * as alepha_orm56 from "alepha/orm";
-import { DateTimeProvider } from "alepha/datetime";
-
-//#region src/api-verifications/entities/verifications.d.ts
-declare const verifications: alepha_orm56.EntityDescriptor<alepha76.TObject<{
-  id: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_PRIMARY_KEY>, typeof alepha_orm56.PG_DEFAULT>;
-  createdAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_CREATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-  updatedAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_UPDATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-  version: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_VERSION>, typeof alepha_orm56.PG_DEFAULT>;
-  type: alepha76.TUnsafe<"link" | "code">;
-  target: alepha76.TString;
-  code: alepha76.TString;
-  verifiedAt: alepha76.TOptional<alepha76.TString>;
-  attempts: alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_DEFAULT>;
-}>>;
-type VerificationEntity = Static<typeof verifications.schema>;
-//#endregion
-//#region src/api-verifications/schemas/verificationSettingsSchema.d.ts
-declare const verificationSettingsSchema: alepha76.TObject<{
-  code: alepha76.TObject<{
-    maxAttempts: alepha76.TInteger;
-    codeLength: alepha76.TInteger;
-    codeExpiration: alepha76.TInteger;
-    verificationCooldown: alepha76.TInteger;
-    limitPerDay: alepha76.TInteger;
-  }>;
-  link: alepha76.TObject<{
-    maxAttempts: alepha76.TInteger;
-    codeExpiration: alepha76.TInteger;
-    verificationCooldown: alepha76.TInteger;
-    limitPerDay: alepha76.TInteger;
-  }>;
-  purgeDays: alepha76.TInteger;
-}>;
-type VerificationSettings = Static<typeof verificationSettingsSchema>;
-//#endregion
-//#region src/api-verifications/parameters/VerificationParameters.d.ts
-/**
- * Verification settings configuration atom
- */
-declare const verificationOptions: alepha76.Atom<alepha76.TObject<{
-  code: alepha76.TObject<{
-    maxAttempts: alepha76.TInteger;
-    codeLength: alepha76.TInteger;
-    codeExpiration: alepha76.TInteger;
-    verificationCooldown: alepha76.TInteger;
-    limitPerDay: alepha76.TInteger;
-  }>;
-  link: alepha76.TObject<{
-    maxAttempts: alepha76.TInteger;
-    codeExpiration: alepha76.TInteger;
-    verificationCooldown: alepha76.TInteger;
-    limitPerDay: alepha76.TInteger;
-  }>;
-  purgeDays: alepha76.TInteger;
-}>, "alepha.api.verifications.options">;
-type VerificationOptions = Static<typeof verificationOptions.schema>;
-declare module "alepha" {
-  interface State {
-    [verificationOptions.key]: VerificationOptions;
-  }
-}
-declare class VerificationParameters {
-  protected readonly options: Readonly<{
-    link: {
-      codeExpiration: number;
-      verificationCooldown: number;
-      maxAttempts: number;
-      limitPerDay: number;
-    };
-    code: {
-      codeExpiration: number;
-      verificationCooldown: number;
-      maxAttempts: number;
-      codeLength: number;
-      limitPerDay: number;
-    };
-    purgeDays: number;
-  }>;
-  get<K extends keyof VerificationSettings>(key: K): VerificationSettings[K];
-}
-//#endregion
-//#region src/api-verifications/schemas/requestVerificationCodeResponseSchema.d.ts
-declare const requestVerificationCodeResponseSchema: alepha76.TObject<{
-  token: alepha76.TString;
-  codeExpiration: alepha76.TInteger;
-  verificationCooldown: alepha76.TInteger;
-  maxVerificationAttempts: alepha76.TInteger;
-}>;
-type RequestVerificationResponse = Static<typeof requestVerificationCodeResponseSchema>;
-//#endregion
-//#region src/api-verifications/schemas/validateVerificationCodeResponseSchema.d.ts
-declare const validateVerificationCodeResponseSchema: alepha76.TObject<{
-  ok: alepha76.TBoolean;
-  alreadyVerified: alepha76.TOptional<alepha76.TBoolean>;
-}>;
-type ValidateVerificationCodeResponse = Static<typeof validateVerificationCodeResponseSchema>;
-//#endregion
-//#region src/api-verifications/schemas/verificationTypeEnumSchema.d.ts
-declare const verificationTypeEnumSchema: alepha76.TUnsafe<"link" | "code">;
-type VerificationTypeEnum = Static<typeof verificationTypeEnumSchema>;
-//#endregion
-//#region src/api-verifications/services/VerificationService.d.ts
-declare class VerificationService {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly verificationParameters: VerificationParameters;
-  protected readonly verificationRepository: alepha_orm56.Repository<alepha76.TObject<{
-    id: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_PRIMARY_KEY>, typeof alepha_orm56.PG_DEFAULT>;
-    createdAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_CREATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-    updatedAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_UPDATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-    version: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_VERSION>, typeof alepha_orm56.PG_DEFAULT>;
-    type: alepha76.TUnsafe<"link" | "code">;
-    target: alepha76.TString;
-    code: alepha76.TString;
-    verifiedAt: alepha76.TOptional<alepha76.TString>;
-    attempts: alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_DEFAULT>;
-  }>>;
-  findByEntry(entry: VerificationEntry): Promise<VerificationEntity>;
-  findRecentsByEntry(entry: VerificationEntry): Promise<alepha_orm56.PgStatic<alepha76.TObject<{
-    id: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_PRIMARY_KEY>, typeof alepha_orm56.PG_DEFAULT>;
-    createdAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_CREATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-    updatedAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_UPDATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-    version: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_VERSION>, typeof alepha_orm56.PG_DEFAULT>;
-    type: alepha76.TUnsafe<"link" | "code">;
-    target: alepha76.TString;
-    code: alepha76.TString;
-    verifiedAt: alepha76.TOptional<alepha76.TString>;
-    attempts: alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_DEFAULT>;
-  }>, alepha_orm56.PgRelationMap<alepha76.TObject<{
-    id: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_PRIMARY_KEY>, typeof alepha_orm56.PG_DEFAULT>;
-    createdAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_CREATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-    updatedAt: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TString, typeof alepha_orm56.PG_UPDATED_AT>, typeof alepha_orm56.PG_DEFAULT>;
-    version: alepha_orm56.PgAttr<alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_VERSION>, typeof alepha_orm56.PG_DEFAULT>;
-    type: alepha76.TUnsafe<"link" | "code">;
-    target: alepha76.TString;
-    code: alepha76.TString;
-    verifiedAt: alepha76.TOptional<alepha76.TString>;
-    attempts: alepha_orm56.PgAttr<alepha76.TInteger, typeof alepha_orm56.PG_DEFAULT>;
-  }>>>[]>;
-  /**
-   * Creates a verification entry and returns the token.
-   * The caller is responsible for sending notifications with the token.
-   * This allows for context-specific notifications (e.g., password reset vs email verification).
-   */
-  createVerification(entry: VerificationEntry): Promise<RequestVerificationResponse>;
-  verifyCode(entry: VerificationEntry, code: string): Promise<ValidateVerificationCodeResponse>;
-  hashCode(code: string): string;
-  generateToken(type: VerificationTypeEnum): string;
-}
-interface VerificationEntry {
-  type: VerificationTypeEnum;
-  target: string;
-}
-//#endregion
-//#region src/api-verifications/controllers/VerificationController.d.ts
-declare class VerificationController {
-  protected readonly verificationService: VerificationService;
-  readonly url = "/verifications";
-  readonly group = "verifications";
-  readonly requestVerificationCode: alepha_server0.ActionDescriptorFn<{
-    params: alepha76.TObject<{
-      type: alepha76.TUnsafe<"link" | "code">;
-    }>;
-    body: alepha76.TObject<{
-      target: alepha76.TString;
-    }>;
-    response: alepha76.TObject<{
-      token: alepha76.TString;
-      codeExpiration: alepha76.TInteger;
-      verificationCooldown: alepha76.TInteger;
-      maxVerificationAttempts: alepha76.TInteger;
-    }>;
-  }>;
-  readonly validateVerificationCode: alepha_server0.ActionDescriptorFn<{
-    params: alepha76.TObject<{
-      type: alepha76.TUnsafe<"link" | "code">;
-    }>;
-    body: alepha76.TObject<{
-      target: alepha76.TString;
-      token: alepha76.TString;
-    }>;
-    response: alepha76.TObject<{
-      ok: alepha76.TBoolean;
-      alreadyVerified: alepha76.TOptional<alepha76.TBoolean>;
-    }>;
-  }>;
-}
-//#endregion
-//#region src/api-verifications/index.d.ts
-/**
- * Provides email/phone verification management API endpoints for Alepha applications.
- *
- * This module includes verification code generation, validation,
- * and related functionalities. Notifications are handled by the consuming module
- * (e.g., api-users) for context-specific messaging.
- *
- * @module alepha.api.verifications
- */
-declare const AlephaApiVerification: alepha76.Service<alepha76.Module>;
-//#endregion
-export { AlephaApiVerification, RequestVerificationResponse, ValidateVerificationCodeResponse, VerificationController, VerificationEntry, VerificationService, VerificationTypeEnum, requestVerificationCodeResponseSchema, validateVerificationCodeResponseSchema, verificationTypeEnumSchema };
-//# sourceMappingURL=index.d.cts.map