@jmlq/auth 0.0.1-alpha.25 → 0.0.1-alpha.27

package/dist/domain/services/helpers/optional-non-empty-string.helper.d.ts

@@ -1 +1 @@
-export declare function optionalNonEmptyString(value: unknown): string | undefined;
+export declare function readNonEmptyString(value: unknown): string | undefined;

package/dist/domain/services/helpers/optional-non-empty-string.helper.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.optionalNonEmptyString = optionalNonEmptyString;
-function optionalNonEmptyString(value) {
+exports.readNonEmptyString = readNonEmptyString;
+function readNonEmptyString(value) {
     if (typeof value !== "string")
         return undefined;
     const v = value.trim();

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

@@ -34,7 +34,7 @@ function normalizeJwtPayload(input) {
     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);
+    const iss = (0, helpers_1.readNonEmptyString)(obj.iss);
     /**
      * Canonical audience rule (core):
      * - string | string[] | undefined

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export { normalizeJwtPayload } from "./domain/services";
 export { InvalidJwtPayloadError } from "./domain/errors";
 export * from "./domain/ports";
 export * from "./domain/entities";
+export { readNonEmptyString } from "./domain/services/helpers";
 export * from "./domain/object-values";
 export * from "./domain/props";
 export * from "./domain/errors";

package/dist/index.js

@@ -14,7 +14,7 @@ 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;
+exports.readNonEmptyString = exports.InvalidJwtPayloadError = exports.normalizeJwtPayload = void 0;
 /**
  * Contrato público (JWT payload):
  * - Los plugins devuelven payload verificado criptográficamente como unknown.
@@ -33,6 +33,9 @@ Object.defineProperty(exports, "InvalidJwtPayloadError", { enumerable: true, get
 __exportStar(require("./domain/ports"), exports);
 // Entities
 __exportStar(require("./domain/entities"), exports);
+// Helpers
+var helpers_1 = require("./domain/services/helpers");
+Object.defineProperty(exports, "readNonEmptyString", { enumerable: true, get: function () { return helpers_1.readNonEmptyString; } });
 // VOs
 __exportStar(require("./domain/object-values"), exports);
 // Props (JWT generation inputs, etc.)

package/dist/shared/jwt-plugin/create-jwt-id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Genera un identificador único para el claim `jti`.
+ * - Usa crypto.randomUUID cuando está disponible.
+ * - Fallback no-crypto para entornos legacy/dev.
+ */
+export declare function createJwtId(): string;

package/dist/shared/jwt-plugin/create-jwt-id.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJwtId = createJwtId;
+/**
+ * Obtiene el tiempo actual en segundos Unix.
+ *
+ * @returns Timestamp Unix (segundos).
+ */
+function nowUnixSeconds() {
+    return Math.floor(Date.now() / 1000);
+}
+/**
+ * Genera un identificador único para el claim `jti`.
+ * - Usa crypto.randomUUID cuando está disponible.
+ * - Fallback no-crypto para entornos legacy/dev.
+ */
+function createJwtId() {
+    if (hasCryptoRandomUUID(globalThis)) {
+        return globalThis.crypto.randomUUID();
+    }
+    return `jti_${nowUnixSeconds()}_${Math.random().toString(16).slice(2)}`;
+}
+function hasCryptoRandomUUID(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "crypto" in value &&
+        typeof value.crypto === "object" &&
+        typeof value.crypto
+            ?.randomUUID === "function");
+}

package/dist/shared/jwt-plugin/index.d.ts

@@ -4,3 +4,6 @@ export * from "./read-expires-in";
 export * from "./read-custom-claims";
 export * from "./resolve-expires-in";
 export * from "./is-retryable-auth-code";
+export * from "./read-session-id";
+export * from "./to-date-from-unix-seconds";
+export * from "./create-jwt-id";

package/dist/shared/jwt-plugin/index.js

@@ -20,3 +20,6 @@ __exportStar(require("./read-expires-in"), exports);
 __exportStar(require("./read-custom-claims"), exports);
 __exportStar(require("./resolve-expires-in"), exports);
 __exportStar(require("./is-retryable-auth-code"), exports);
+__exportStar(require("./read-session-id"), exports);
+__exportStar(require("./to-date-from-unix-seconds"), exports);
+__exportStar(require("./create-jwt-id"), exports);

package/dist/shared/jwt-plugin/read-session-id.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Lee y valida `sessionId`.
+ *
+ * Regla de dominio:
+ * - sessionId es obligatorio para soporte multi-sesión
+ *
+ * NOTA:
+ * - NO lanza Error genérico
+ * - La decisión del error final se delega al core
+ */
+export declare function readSessionId(value: unknown): string | undefined;

package/dist/shared/jwt-plugin/read-session-id.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSessionId = readSessionId;
+const helpers_1 = require("../../domain/services/helpers");
+/**
+ * Lee y valida `sessionId`.
+ *
+ * Regla de dominio:
+ * - sessionId es obligatorio para soporte multi-sesión
+ *
+ * NOTA:
+ * - NO lanza Error genérico
+ * - La decisión del error final se delega al core
+ */
+function readSessionId(value) {
+    return (0, helpers_1.readNonEmptyString)(value);
+}

package/dist/shared/jwt-plugin/to-date-from-unix-seconds.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Convierte segundos Unix a Date.
+ *
+ * @param expSeconds `exp` en segundos Unix.
+ * @returns Date correspondiente.
+ */
+export declare function toDateFromUnixSeconds(expSeconds: number): Date;

package/dist/shared/jwt-plugin/to-date-from-unix-seconds.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDateFromUnixSeconds = toDateFromUnixSeconds;
+/**
+ * Convierte segundos Unix a Date.
+ *
+ * @param expSeconds `exp` en segundos Unix.
+ * @returns Date correspondiente.
+ */
+function toDateFromUnixSeconds(expSeconds) {
+    return new Date(expSeconds * 1000);
+}

package/package.json

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