@jmlq/auth 0.0.1-alpha.21 → 0.0.1-alpha.24

package/dist/domain/services/helpers/optional-audience.helper.d.ts

@@ -1 +1,14 @@
+/**
+ * Regla canónica de dominio para el claim estándar `aud` (audience).
+ *
+ * Propósito:
+ * - Aceptar `aud` como string o string[] (según librería/plugin).
+ * - Rechazar valores vacíos.
+ * - Si es array: normalizar de forma determinista (dedupe + sort),
+ *   útil para tests y debugging.
+ *
+ * Importante:
+ * - Esta validación es del CORE (@jmlq/auth).
+ * - Los plugins JWT NO deben validar audience; solo entregan payload verificado.
+ */
 export declare function optionalAudience(value: unknown): string | string[] | undefined;

package/dist/domain/services/helpers/optional-audience.helper.js

@@ -2,9 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionalAudience = optionalAudience;
 const errors_1 = require("../../errors");
+/**
+ * Regla canónica de dominio para el claim estándar `aud` (audience).
+ *
+ * Propósito:
+ * - Aceptar `aud` como string o string[] (según librería/plugin).
+ * - Rechazar valores vacíos.
+ * - Si es array: normalizar de forma determinista (dedupe + sort),
+ *   útil para tests y debugging.
+ *
+ * Importante:
+ * - Esta validación es del CORE (@jmlq/auth).
+ * - Los plugins JWT NO deben validar audience; solo entregan payload verificado.
+ */
 function optionalAudience(value) {
+    // aud ausente => ok
     if (value == null)
         return undefined;
+    // aud como string
     if (typeof value === "string") {
         const v = value.trim();
         if (!v) {
@@ -14,19 +29,19 @@ function optionalAudience(value) {
         }
         return v;
     }
+    // aud como string[]
     if (Array.isArray(value)) {
         const items = value
             .filter((x) => typeof x === "string")
             .map((x) => x.trim())
             .filter((x) => x.length > 0);
         if (items.length === 0) {
-            throw new errors_1.InvalidJwtPayloadError("JWT payload.aud must contain at least one non-empty string", {
-                field: "aud",
-            });
+            throw new errors_1.InvalidJwtPayloadError("JWT payload.aud must contain at least one non-empty string", { field: "aud" });
         }
-        // Determinista (útil para test/debug)
+        // Determinista: sin duplicados y ordenado
         return Array.from(new Set(items)).sort((a, b) => a.localeCompare(b));
     }
+    // Tipo inválido
     throw new errors_1.InvalidJwtPayloadError("JWT payload.aud must be a string or string[]", {
         field: "aud",
         receivedType: typeof value,

package/dist/domain/services/normalize-jwt-payload.service.d.ts

@@ -4,12 +4,16 @@ import type { IJWTPayload } from "../ports";
  * --------------
  * Normaliza y valida un payload JWT según las reglas del dominio.
  *
- * - Entrada: unknown (claims verificados por infraestructura)
+ * - Entrada: unknown (claims verificados por infraestructura/plugin)
  * - Salida: IJWTPayload tipado y confiable
  *
  * Importante:
  * - NO verifica firma
  * - NO parsea JWT
  * - Define únicamente reglas de dominio
+ *
+ * Contrato:
+ * - `aud` se valida exclusivamente aquí vía `optionalAudience()`.
+ * - Cualquier error de `aud` debe provenir de `InvalidJwtPayloadError`.
  */
 export declare function normalizeJwtPayload(input: unknown): IJWTPayload;

package/dist/domain/services/normalize-jwt-payload.service.js

@@ -8,13 +8,17 @@ const helpers_1 = require("./helpers");
  * --------------
  * Normaliza y valida un payload JWT según las reglas del dominio.
  *
- * - Entrada: unknown (claims verificados por infraestructura)
+ * - Entrada: unknown (claims verificados por infraestructura/plugin)
  * - Salida: IJWTPayload tipado y confiable
  *
  * Importante:
  * - NO verifica firma
  * - NO parsea JWT
  * - Define únicamente reglas de dominio
+ *
+ * Contrato:
+ * - `aud` se valida exclusivamente aquí vía `optionalAudience()`.
+ * - Cualquier error de `aud` debe provenir de `InvalidJwtPayloadError`.
  */
 function normalizeJwtPayload(input) {
     if (input == null || typeof input !== "object") {
@@ -23,12 +27,20 @@ function normalizeJwtPayload(input) {
         });
     }
     const obj = input;
+    // Required
     const sub = (0, helpers_1.requireNonEmptyString)(obj.sub, "sub");
     const sid = (0, helpers_1.requireNonEmptyString)(obj.sid, "sid");
     const jti = (0, helpers_1.requireNonEmptyString)(obj.jti, "jti");
     const iat = (0, helpers_1.requireFiniteNumber)(obj.iat, "iat");
     const exp = (0, helpers_1.requireFiniteNumber)(obj.exp, "exp");
+    // Optional
     const iss = (0, helpers_1.optionalNonEmptyString)(obj.iss);
+    /**
+     * Canonical audience rule (core):
+     * - string | string[] | undefined
+     * - empty string or empty array => InvalidJwtPayloadError
+     * - array => dedupe + sort
+     */
     const aud = (0, helpers_1.optionalAudience)(obj.aud);
     const roles = (0, helpers_1.optionalRoles)(obj.roles);
     const customClaims = (0, helpers_1.optionalRecord)(obj.customClaims, "customClaims");

package/dist/index.d.ts

@@ -1,5 +1,17 @@
 export type { IAuthServiceContainer } from "./infrastructure/types";
 export { AuthServiceFactoryOptions } from "./application/types";
+/**
+ * Contrato público (JWT payload):
+ * - Los plugins devuelven payload verificado criptográficamente como unknown.
+ * - El core normaliza/valida y expone API estable para consumo externo.
+ */
+export { normalizeJwtPayload } from "./domain/services";
+/**
+ * Export explícito (contractual):
+ * Aunque ya se exporta vía `export * from "./domain/errors"`,
+ * se expone de forma directa para que el host/plugins lo consuman sin ambigüedad.
+ */
+export { InvalidJwtPayloadError } from "./domain/errors";
 export * from "./domain/ports";
 export * from "./domain/entities";
 export * from "./domain/object-values";

package/dist/index.js

@@ -1,5 +1,4 @@
 "use strict";
-// export { BcryptPasswordHasher } from "./infrastructure/security";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -15,20 +14,32 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidJwtPayloadError = exports.normalizeJwtPayload = void 0;
+/**
+ * Contrato público (JWT payload):
+ * - Los plugins devuelven payload verificado criptográficamente como unknown.
+ * - El core normaliza/valida y expone API estable para consumo externo.
+ */
+var services_1 = require("./domain/services");
+Object.defineProperty(exports, "normalizeJwtPayload", { enumerable: true, get: function () { return services_1.normalizeJwtPayload; } });
+/**
+ * Export explícito (contractual):
+ * Aunque ya se exporta vía `export * from "./domain/errors"`,
+ * se expone de forma directa para que el host/plugins lo consuman sin ambigüedad.
+ */
+var errors_1 = require("./domain/errors");
+Object.defineProperty(exports, "InvalidJwtPayloadError", { enumerable: true, get: function () { return errors_1.InvalidJwtPayloadError; } });
 // Contratos (ports) + config
 __exportStar(require("./domain/ports"), exports);
 // Entities
 __exportStar(require("./domain/entities"), exports);
 // VOs
 __exportStar(require("./domain/object-values"), exports);
-// Contratos (ports) + config
+// Props (JWT generation inputs, etc.)
 __exportStar(require("./domain/props"), exports);
 // Errores públicos
 __exportStar(require("./domain/errors"), exports);
 // DTOs (solo types)
 __exportStar(require("./application/dtos"), exports);
-// Entry point principal
-// export * from "./application/factories";
+// Facades (entrypoint recomendado para hosts)
 __exportStar(require("./application/facades"), exports);
-// adapters útiles para tests/demos
-// export * from "./infrastructure/repositories/in-memory";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jmlq/auth",
   "description": "JWT authentication package with clean architecture",
-  "version": "0.0.1-alpha.21",
+  "version": "0.0.1-alpha.24",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {