@zauru-sdk/common 6.13.0 → 6.14.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [6.14.0](https://github.com/intuitiva/zauru-typescript-sdk/compare/@zauru-sdk/common@6.13.0...@zauru-sdk/common@6.14.0) (2026-10-30)
+
+
+### Features
+
+* preservar estado local al reautenticar webapps ([e1f76e6](https://github.com/intuitiva/zauru-typescript-sdk/commit/e1f76e6fe06a76c9dc183b0d1af91439f4cadea7))
+
+
+
+
+
 # [6.13.0](https://github.com/intuitiva/zauru-typescript-sdk/compare/@zauru-sdk/common@6.12.0...@zauru-sdk/common@6.13.0) (2026-10-29)
 
 

package/dist/esm/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./oauthErrors.js"), exports);
 __exportStar(require("./providerRestrictions.js"), exports);
 __exportStar(require("./providerReceptionMatrix.js"), exports);
 __exportStar(require("./rejectionPercentageAdjustment.js"), exports);
+__exportStar(require("./sessionReauth.js"), exports);

package/dist/esm/sessionReauth.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isZauruSessionReauthPayload = exports.createZauruSessionReauthPayload = exports.hasZauruOauthReauthCookie = exports.isZauruSessionExpiredError = exports.ZAURU_OAUTH_REAUTH_COOKIE = exports.ZAURU_SESSION_REAUTH_URL = void 0;
+exports.ZAURU_SESSION_REAUTH_URL = "/logout?reauth=1";
+exports.ZAURU_OAUTH_REAUTH_COOKIE = "zauru_oauth_reauth";
+const errorText = (value) => {
+    if (value instanceof Error)
+        return value.message;
+    if (typeof value === "string")
+        return value;
+    if (value == null)
+        return "";
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+};
+const hasUnauthorizedStatus = (value) => {
+    if (!value || typeof value !== "object" || !("status" in value)) {
+        return false;
+    }
+    return Number(value.status) === 401;
+};
+/**
+ * Detects the HTTP 401 response Zauru emits when the API token stored in the
+ * Remix session expires. It accepts direct Response-like values and nested
+ * messages produced by handlePossibleAxiosErrors.
+ */
+const isZauruSessionExpiredError = (...values) => {
+    for (const value of values) {
+        if (hasUnauthorizedStatus(value))
+            return true;
+        const text = errorText(value);
+        const isUnauthorized = /HTTP\s*401/i.test(text) ||
+            /status(?:\s+code)?[\s:=]+401/i.test(text) ||
+            /401\s+Unauthorized/i.test(text);
+        const isFromZauru = /zauru/i.test(text) ||
+            /\/apps\/webapp_tables\//i.test(text) ||
+            /your session expired/i.test(text);
+        if (isUnauthorized && isFromZauru)
+            return true;
+    }
+    return false;
+};
+exports.isZauruSessionExpiredError = isZauruSessionExpiredError;
+const hasZauruOauthReauthCookie = (cookieHeader) => (cookieHeader ?? "")
+    .split(";")
+    .some((part) => part.trim() === `${exports.ZAURU_OAUTH_REAUTH_COOKIE}=1`);
+exports.hasZauruOauthReauthCookie = hasZauruOauthReauthCookie;
+const createZauruSessionReauthPayload = (overrides = {}) => ({
+    error: true,
+    reauthRequired: true,
+    reauthUrl: overrides.reauthUrl ?? exports.ZAURU_SESSION_REAUTH_URL,
+    title: overrides.title ?? "La sesión venció",
+    type: overrides.type ?? "info",
+    description: overrides.description ??
+        "Inicie sesión nuevamente para continuar con la operación.",
+});
+exports.createZauruSessionReauthPayload = createZauruSessionReauthPayload;
+const isZauruSessionReauthPayload = (value) => Boolean(value &&
+    typeof value === "object" &&
+    value.reauthRequired === true);
+exports.isZauruSessionReauthPayload = isZauruSessionReauthPayload;

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from "./oauthErrors.js";
 export * from "./providerRestrictions.js";
 export * from "./providerReceptionMatrix.js";
 export * from "./rejectionPercentageAdjustment.js";
+export * from "./sessionReauth.js";

package/dist/sessionReauth.d.ts

@@ -0,0 +1,21 @@
+export declare const ZAURU_SESSION_REAUTH_URL = "/logout?reauth=1";
+export declare const ZAURU_OAUTH_REAUTH_COOKIE = "zauru_oauth_reauth";
+export type ZauruSessionReauthPayload = {
+    error: true;
+    reauthRequired: true;
+    reauthUrl: string;
+    title: string;
+    type: "info";
+    description: string;
+};
+type ZauruSessionReauthPayloadOverrides = Partial<Pick<ZauruSessionReauthPayload, "reauthUrl" | "title" | "type" | "description">>;
+/**
+ * Detects the HTTP 401 response Zauru emits when the API token stored in the
+ * Remix session expires. It accepts direct Response-like values and nested
+ * messages produced by handlePossibleAxiosErrors.
+ */
+export declare const isZauruSessionExpiredError: (...values: unknown[]) => boolean;
+export declare const hasZauruOauthReauthCookie: (cookieHeader?: string | null) => boolean;
+export declare const createZauruSessionReauthPayload: (overrides?: ZauruSessionReauthPayloadOverrides) => ZauruSessionReauthPayload;
+export declare const isZauruSessionReauthPayload: (value: unknown) => value is ZauruSessionReauthPayload;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zauru-sdk/common",
-  "version": "6.13.0",
+  "version": "6.14.0",
   "description": "Funciones de uso común en el desarrollo de webapps en Zauru",
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
@@ -12,7 +12,7 @@
   "scripts": {
     "build": "npm run build:esm",
     "build:esm": "tsc -p tsconfig.esm.json",
-    "test": "tsx --test src/httpClientPolicy.test.ts src/providerRestrictions.test.ts src/providerReceptionMatrix.test.ts src/purchaseOrderFinancials.test.ts"
+    "test": "tsx --test src/httpClientPolicy.test.ts src/providerRestrictions.test.ts src/providerReceptionMatrix.test.ts src/purchaseOrderFinancials.test.ts src/sessionReauth.test.ts"
   },
   "author": "Oscar Cuéllar",
   "license": "MIT",
@@ -26,5 +26,5 @@
     "moment": "^2.30.1",
     "moment-timezone": "^0.5.45"
   },
-  "gitHead": "671859beecfce09a1ccf138055a4de26a8c1f059"
+  "gitHead": "8e5cb991b0da7d1a5d70cd6275d7bfdc52ee1102"
 }

package/src/index.ts

@@ -5,3 +5,4 @@ export * from "./oauthErrors.js";
 export * from "./providerRestrictions.js";
 export * from "./providerReceptionMatrix.js";
 export * from "./rejectionPercentageAdjustment.js";
+export * from "./sessionReauth.js";

package/src/sessionReauth.test.ts

@@ -0,0 +1,50 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import {
+  ZAURU_SESSION_REAUTH_URL,
+  createZauruSessionReauthPayload,
+  hasZauruOauthReauthCookie,
+  isZauruSessionExpiredError,
+  isZauruSessionReauthPayload,
+} from "./sessionReauth.js";
+
+describe("isZauruSessionExpiredError", () => {
+  it("When a Zauru webapp table returns HTTP 401, it should detect an expired session", () => {
+    const message =
+      "Error: HTTP 401 Unauthorized - URI: https://app.zauru.com/apps/webapp_tables/58/webapp_rows.json - <title>Your session expired</title>";
+
+    assert.equal(isZauruSessionExpiredError(message), true);
+  });
+
+  it("When a Response-like value has status 401, it should detect an expired session", () => {
+    assert.equal(isZauruSessionExpiredError({ status: 401 }), true);
+  });
+
+  it("When an unrelated Zauru error occurs, it should not request reauthentication", () => {
+    assert.equal(
+      isZauruSessionExpiredError(
+        "HTTP 500 Internal Server Error - URI: https://app.zauru.com/apps/webapp_tables/58/webapp_rows.json",
+      ),
+      false,
+    );
+  });
+});
+
+describe("Zauru session reauthentication", () => {
+  it("When the reauth marker cookie is present, it should recognize the refresh flow", () => {
+    assert.equal(
+      hasZauruOauthReauthCookie("foo=bar; zauru_oauth_reauth=1; theme=dark"),
+      true,
+    );
+  });
+
+  it("When building a payload, it should keep the standard contract and custom copy", () => {
+    const payload = createZauruSessionReauthPayload({
+      description: "El registro local se conservará.",
+    });
+
+    assert.equal(payload.reauthUrl, ZAURU_SESSION_REAUTH_URL);
+    assert.equal(payload.description, "El registro local se conservará.");
+    assert.equal(isZauruSessionReauthPayload(payload), true);
+  });
+});

package/src/sessionReauth.ts

@@ -0,0 +1,95 @@
+export const ZAURU_SESSION_REAUTH_URL = "/logout?reauth=1";
+export const ZAURU_OAUTH_REAUTH_COOKIE = "zauru_oauth_reauth";
+
+export type ZauruSessionReauthPayload = {
+  error: true;
+  reauthRequired: true;
+  reauthUrl: string;
+  title: string;
+  type: "info";
+  description: string;
+};
+
+type ZauruSessionReauthPayloadOverrides = Partial<
+  Pick<
+    ZauruSessionReauthPayload,
+    "reauthUrl" | "title" | "type" | "description"
+  >
+>;
+
+const errorText = (value: unknown): string => {
+  if (value instanceof Error) return value.message;
+  if (typeof value === "string") return value;
+  if (value == null) return "";
+
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+};
+
+const hasUnauthorizedStatus = (value: unknown): boolean => {
+  if (!value || typeof value !== "object" || !("status" in value)) {
+    return false;
+  }
+
+  return Number((value as { status?: unknown }).status) === 401;
+};
+
+/**
+ * Detects the HTTP 401 response Zauru emits when the API token stored in the
+ * Remix session expires. It accepts direct Response-like values and nested
+ * messages produced by handlePossibleAxiosErrors.
+ */
+export const isZauruSessionExpiredError = (...values: unknown[]): boolean => {
+  for (const value of values) {
+    if (hasUnauthorizedStatus(value)) return true;
+
+    const text = errorText(value);
+    const isUnauthorized =
+      /HTTP\s*401/i.test(text) ||
+      /status(?:\s+code)?[\s:=]+401/i.test(text) ||
+      /401\s+Unauthorized/i.test(text);
+    const isFromZauru =
+      /zauru/i.test(text) ||
+      /\/apps\/webapp_tables\//i.test(text) ||
+      /your session expired/i.test(text);
+
+    if (isUnauthorized && isFromZauru) return true;
+  }
+
+  return false;
+};
+
+export const hasZauruOauthReauthCookie = (
+  cookieHeader?: string | null,
+): boolean =>
+  (cookieHeader ?? "")
+    .split(";")
+    .some(
+      (part) =>
+        part.trim() === `${ZAURU_OAUTH_REAUTH_COOKIE}=1`,
+    );
+
+export const createZauruSessionReauthPayload = (
+  overrides: ZauruSessionReauthPayloadOverrides = {},
+): ZauruSessionReauthPayload => ({
+  error: true,
+  reauthRequired: true,
+  reauthUrl: overrides.reauthUrl ?? ZAURU_SESSION_REAUTH_URL,
+  title: overrides.title ?? "La sesión venció",
+  type: overrides.type ?? "info",
+  description:
+    overrides.description ??
+    "Inicie sesión nuevamente para continuar con la operación.",
+});
+
+export const isZauruSessionReauthPayload = (
+  value: unknown,
+): value is ZauruSessionReauthPayload =>
+  Boolean(
+    value &&
+      typeof value === "object" &&
+      (value as { reauthRequired?: unknown }).reauthRequired === true,
+  );