@zauru-sdk/utils 6.13.0 → 6.15.0

package/dist/esm/index.js

@@ -1,3 +1,5 @@
+export * from "./zauru/api.loaders.js";
+export * from "./zauru/auth.loaders.js";
 export * from "./zauru/automatic-number.utils.js";
 export * from "./zauru/bitacora-edicion-masiva.utils.js";
 export * from "./zauru/bundles.utils.js";

package/dist/esm/zauru/api.loaders.js

@@ -0,0 +1,173 @@
+import { createElement } from "react";
+import { redirect } from "@remix-run/node";
+import { config } from "@zauru-sdk/config";
+import { getAgencyInfo, getEmployeeInfo, getHeaders, getOauthUserInfo, getProfileInformation, getReceptionTemplate, getSession, getVariablesByName, } from "@zauru-sdk/services";
+import { createCatalogsLoader, } from "./catalogs.loader.js";
+const missingParamPayload = (description) => ({
+    description,
+    title: "Ocurrió un error.",
+    error: true,
+    type: "error",
+});
+const namedErrorPayload = (name, empty, description) => ({
+    [name]: empty,
+    error: true,
+    type: "error",
+    title: `Ocurrió un error al obtener la información de ${name}!.`,
+    description,
+});
+const sdkProfileHandlers = {
+    oauthProfile: ({ session }) => getOauthUserInfo(session.get("code")),
+    agencyProfile: ({ headers, session }) => getAgencyInfo(headers, session),
+    employeeProfile: ({ headers, session }) => getEmployeeInfo(Number(session.get("employee_id")), headers),
+    userProfile: ({ headers }) => getProfileInformation(headers),
+};
+const sdkTemplateHandlers = {
+    receptionTemplate: async ({ headers, session, name }) => {
+        try {
+            const { reception_template_webapp_var } = await getVariablesByName(headers, session, ["reception_template_webapp_var"]);
+            headers.Accept = "text/html";
+            return getReceptionTemplate(headers, reception_template_webapp_var);
+        }
+        catch (error) {
+            console.error(error);
+            return Response.json(namedErrorPayload(name, {}, error?.toString() ?? ""));
+        }
+    },
+};
+const createNamedResourceLoader = (queryParam, sdkHandlers, extras, emptyOnError, missingDescription) => {
+    return async ({ request }) => {
+        try {
+            const cookie = request.headers.get("Cookie");
+            const session = await getSession(cookie);
+            if (!session.has("username")) {
+                return redirect("/");
+            }
+            const headers = await getHeaders(cookie, session);
+            const url = new URL(request.url);
+            const name = url.searchParams.get(queryParam) ?? "";
+            if (!name) {
+                return Response.json(missingParamPayload(missingDescription));
+            }
+            const handler = extras?.[name] ?? sdkHandlers[name];
+            if (!handler) {
+                return Response.json(missingParamPayload(missingDescription));
+            }
+            const result = await handler({
+                request,
+                session,
+                headers,
+                url,
+                name,
+            });
+            if (result instanceof Response) {
+                return result;
+            }
+            if (result.error || !result.data) {
+                return Response.json(namedErrorPayload(name, emptyOnError, `${result.userMsg ?? ""}`));
+            }
+            return { [name]: result.data };
+        }
+        catch (error) {
+            console.error(error);
+            const name = new URL(request.url).searchParams.get(queryParam) || queryParam;
+            return namedErrorPayload(name, emptyOnError, `${error}`);
+        }
+    };
+};
+/**
+ * Remix loader for `/api/profiles`. Pass extras to add or override profile names.
+ */
+export function createProfilesLoader(extras) {
+    return createNamedResourceLoader("profile", sdkProfileHandlers, extras, {}, "No se envió ningún parámetro de perfil a buscar");
+}
+/**
+ * Remix loader for `/api/session`.
+ * Modern query: `name` + `type` (`environment` | `sessionVariable` | session attr).
+ * Legacy Remix 1: `attribute` only, read from the session.
+ */
+export function createSessionLoader() {
+    return async ({ request }) => {
+        const cookie = request.headers.get("Cookie");
+        const session = await getSession(cookie);
+        const headers = await getHeaders(cookie, session);
+        if (!session.has("username")) {
+            return redirect("/");
+        }
+        const url = new URL(request.url);
+        const name = url.searchParams.get("name") ?? url.searchParams.get("attribute") ?? "";
+        const type = url.searchParams.get("type");
+        if (!name) {
+            return Response.json({
+                data: "",
+                ...missingParamPayload("No se envió ningún parámetro de name o type a buscar"),
+            });
+        }
+        if (type === "environment") {
+            return Response.json({
+                data: config[name],
+            });
+        }
+        if (type === "sessionVariable") {
+            try {
+                const response = await getVariablesByName(headers, session, [name]);
+                return Response.json({ data: response[name] });
+            }
+            catch {
+                return Response.json({
+                    data: "",
+                    ...missingParamPayload(`No se encontró la variable ${name} en la sesión`),
+                });
+            }
+        }
+        return Response.json({
+            data: session.get(name),
+        });
+    };
+}
+/**
+ * Remix loader for `/api/templates`. Pass extras to add or override template names.
+ */
+export function createTemplatesLoader(extras) {
+    return createNamedResourceLoader("object", sdkTemplateHandlers, extras, {}, "No se envió ningún parámetro de templates a buscar");
+}
+const apiResourceLoaders = (extras) => ({
+    catalogs: createCatalogsLoader(extras?.catalogs),
+    profiles: createProfilesLoader(extras?.profiles),
+    session: createSessionLoader(),
+    templates: createTemplatesLoader(extras?.templates),
+});
+const apiPathSegment = (request, splat) => {
+    if (splat) {
+        return splat.split("/").filter(Boolean)[0] ?? "";
+    }
+    const parts = new URL(request.url).pathname.split("/").filter(Boolean);
+    return parts.at(-1) ?? "";
+};
+/**
+ * Single Remix splat loader for `/api/catalogs|profiles|session|templates`.
+ * App-specific handlers go in `extras` under the matching resource.
+ */
+export function createZauruApiLoader(extras) {
+    const loaders = apiResourceLoaders(extras);
+    return async (args) => {
+        const segment = apiPathSegment(args.request, args.params?.["*"]);
+        const loader = loaders[segment];
+        if (!loader) {
+            return Response.json(missingParamPayload("No se envió ningún parámetro de catálogo a buscar"));
+        }
+        return loader(args);
+    };
+}
+export function ProfilesRoute() {
+    return createElement("div", { style: { fontFamily: "system-ui, sans-serif", lineHeight: "1.4" } }, "PROFILES LOAD");
+}
+export function SessionRoute() {
+    return createElement("div", { style: { fontFamily: "system-ui, sans-serif", lineHeight: "1.4" } }, "SESSION LOAD");
+}
+export function TemplatesRoute() {
+    return createElement("div", { style: { fontFamily: "system-ui, sans-serif", lineHeight: "1.4" } }, "TEMPLATES LOAD");
+}
+export function ZauruApiRoute() {
+    return createElement("div", { style: { fontFamily: "system-ui, sans-serif", lineHeight: "1.4" } }, "API LOAD");
+}

package/dist/esm/zauru/auth.loaders.js

@@ -0,0 +1,141 @@
+import { redirect } from "@remix-run/node";
+import { config } from "@zauru-sdk/config";
+import { commitSession, destroySession, getRefreshSession, getSession, loginWebApp, } from "@zauru-sdk/services";
+const loginErrorPayload = (description, title) => ({
+    error: true,
+    type: "error",
+    title: title ??
+        "Ocurrió un error al cargar la información de inicio de sesión (Carga de webapp)",
+    description,
+});
+const isDenied = (result) => result === false;
+const authorizeUrl = (request) => {
+    const url = new URL(request.url);
+    const hostname = `${url.port ? "http://" : "https://"}${url.hostname}${url.port ? `:${url.port}` : ""}`;
+    return `${config.oauthBaseURL}/dialog/authorize?client_id=${config.oauthClientID}&response_type=code&redirect_uri=${hostname}/login`;
+};
+export function createLoginLoader() {
+    return async () => Response.json({});
+}
+/**
+ * Remix action for `/login`: OAuth authorize, `loginWebApp`, cookie commit.
+ * `afterLogin` runs before `commitSession`. `requireAccess` can deny after
+ * a successful OAuth exchange or when a session already has `code`.
+ */
+export function createLoginAction(extras) {
+    return async ({ request }) => {
+        const formData = await request.formData();
+        const { action, ...values } = Object.fromEntries(formData);
+        if (action === "redirect") {
+            const cookie = values?.cookie?.toString() ?? "";
+            return redirect("/home", {
+                headers: {
+                    "Set-Cookie": cookie,
+                },
+            });
+        }
+        const codeValue = new URL(request.url).searchParams.get("code") ?? "";
+        const cookie = request.headers.get("Cookie") ?? "";
+        const session = await getSession(cookie);
+        if (!session.has("code") && !codeValue) {
+            return redirect(authorizeUrl(request));
+        }
+        if (session.has("code")) {
+            if (isDenied(extras?.requireAccess?.(session))) {
+                return redirect("/");
+            }
+            return redirect("/home");
+        }
+        const loginResponse = await loginWebApp(session, codeValue, cookie);
+        if (loginResponse.error || !loginResponse.data) {
+            return Response.json(loginErrorPayload(loginResponse.userMsg?.toString() ?? ""));
+        }
+        if (isDenied(extras?.requireAccess?.(session))) {
+            return Response.json(loginErrorPayload("No tienes permiso para acceder a esta aplicación. Si crees que esto es un error, contacta al administrador.", "Acceso denegado"));
+        }
+        if (extras?.afterLogin) {
+            await extras.afterLogin({
+                request,
+                session,
+                headers: loginResponse.data.headers,
+                loginData: loginResponse.data,
+            });
+        }
+        const expires = new Date();
+        expires.setSeconds(expires.getSeconds() + Number(config.expirationDurationInSeconds));
+        return Response.json({
+            ...loginResponse.data,
+            cookie: await commitSession(session, { expires }),
+        });
+    };
+}
+/**
+ * Guard for `/home` and `/reload-catalogs`: no `username` → `/`.
+ */
+export function createSessionGuardLoader(extras) {
+    return async ({ request }) => {
+        const session = await getSession(request.headers.get("Cookie"));
+        if (!session.has("username")) {
+            return redirect("/");
+        }
+        if (isDenied(extras?.requireAccess?.(session))) {
+            return redirect("/");
+        }
+        return Response.json({});
+    };
+}
+export function createLogoutLoader(extras) {
+    return createSessionGuardLoader(extras);
+}
+export function createLogoutAction() {
+    return async ({ request }) => {
+        const session = await getSession(request.headers.get("Cookie"));
+        return redirect(`${config.oauthBaseURL}/logout`, {
+            headers: {
+                "Set-Cookie": await destroySession(session),
+            },
+        });
+    };
+}
+/**
+ * `/` welcome: existing session (and optional access) → `/home`.
+ */
+export function createIndexLoader(extras) {
+    return async ({ request }) => {
+        const session = await getSession(request.headers.get("Cookie"));
+        if (session.has("username")) {
+            if (isDenied(extras?.requireAccess?.(session))) {
+                return Response.json({});
+            }
+            return redirect("/home");
+        }
+        return Response.json({});
+    };
+}
+/**
+ * `/reload-catalogs`: session guard plus optional cookie refresh.
+ */
+export function createReloadCatalogsLoader(extras) {
+    return async ({ request }) => {
+        const session = await getSession(request.headers.get("Cookie"));
+        if (!session.has("username")) {
+            return redirect("/");
+        }
+        if (isDenied(extras?.requireAccess?.(session))) {
+            return redirect("/");
+        }
+        try {
+            const refreshSession = await getRefreshSession(request);
+            return Response.json({}, refreshSession
+                ? {
+                    headers: {
+                        "Set-Cookie": refreshSession,
+                    },
+                }
+                : {});
+        }
+        catch {
+            return Response.json({});
+        }
+    };
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./zauru/api.loaders.js";
+export * from "./zauru/auth.loaders.js";
 export * from "./zauru/automatic-number.utils.js";
 export * from "./zauru/bitacora-edicion-masiva.utils.js";
 export * from "./zauru/bundles.utils.js";

package/dist/zauru/api.loaders.d.ts

@@ -0,0 +1,41 @@
+import { type ReactElement } from "react";
+import type { LoaderFunction } from "@remix-run/node";
+import { getHeaders, getSession } from "@zauru-sdk/services";
+import type { AxiosUtilsResponse } from "@zauru-sdk/types";
+import { type CatalogHandler } from "./catalogs.loader.js";
+export type ApiHandlerContext = {
+    request: Request;
+    session: Awaited<ReturnType<typeof getSession>>;
+    headers: Awaited<ReturnType<typeof getHeaders>>;
+    url: URL;
+    name: string;
+};
+export type ApiHandler = (ctx: ApiHandlerContext) => Promise<AxiosUtilsResponse<unknown> | Response>;
+export type ZauruApiLoaderExtras = {
+    catalogs?: Record<string, CatalogHandler>;
+    profiles?: Record<string, ApiHandler>;
+    templates?: Record<string, ApiHandler>;
+};
+/**
+ * Remix loader for `/api/profiles`. Pass extras to add or override profile names.
+ */
+export declare function createProfilesLoader(extras?: Record<string, ApiHandler>): LoaderFunction;
+/**
+ * Remix loader for `/api/session`.
+ * Modern query: `name` + `type` (`environment` | `sessionVariable` | session attr).
+ * Legacy Remix 1: `attribute` only, read from the session.
+ */
+export declare function createSessionLoader(): LoaderFunction;
+/**
+ * Remix loader for `/api/templates`. Pass extras to add or override template names.
+ */
+export declare function createTemplatesLoader(extras?: Record<string, ApiHandler>): LoaderFunction;
+/**
+ * Single Remix splat loader for `/api/catalogs|profiles|session|templates`.
+ * App-specific handlers go in `extras` under the matching resource.
+ */
+export declare function createZauruApiLoader(extras?: ZauruApiLoaderExtras): LoaderFunction;
+export declare function ProfilesRoute(): ReactElement;
+export declare function SessionRoute(): ReactElement;
+export declare function TemplatesRoute(): ReactElement;
+export declare function ZauruApiRoute(): ReactElement;

package/dist/zauru/auth.loaders.d.ts

@@ -0,0 +1,40 @@
+import type { ActionFunction, LoaderFunction } from "@remix-run/node";
+import { getSession, loginWebApp } from "@zauru-sdk/services";
+export type AuthSession = Awaited<ReturnType<typeof getSession>>;
+export type LoginWebAppData = NonNullable<Awaited<ReturnType<typeof loginWebApp>>["data"]>;
+export type AuthAccessExtras = {
+    /**
+     * Return `false` to deny. Throw `redirect(...)` to send the user elsewhere.
+     * Any other return (including `void`) allows access.
+     */
+    requireAccess?: (session: AuthSession) => boolean | void;
+};
+export type LoginActionExtras = AuthAccessExtras & {
+    afterLogin?: (ctx: {
+        request: Request;
+        session: AuthSession;
+        headers: LoginWebAppData["headers"];
+        loginData: LoginWebAppData;
+    }) => Promise<void>;
+};
+export declare function createLoginLoader(): LoaderFunction;
+/**
+ * Remix action for `/login`: OAuth authorize, `loginWebApp`, cookie commit.
+ * `afterLogin` runs before `commitSession`. `requireAccess` can deny after
+ * a successful OAuth exchange or when a session already has `code`.
+ */
+export declare function createLoginAction(extras?: LoginActionExtras): ActionFunction;
+/**
+ * Guard for `/home` and `/reload-catalogs`: no `username` → `/`.
+ */
+export declare function createSessionGuardLoader(extras?: AuthAccessExtras): LoaderFunction;
+export declare function createLogoutLoader(extras?: AuthAccessExtras): LoaderFunction;
+export declare function createLogoutAction(): ActionFunction;
+/**
+ * `/` welcome: existing session (and optional access) → `/home`.
+ */
+export declare function createIndexLoader(extras?: AuthAccessExtras): LoaderFunction;
+/**
+ * `/reload-catalogs`: session guard plus optional cookie refresh.
+ */
+export declare function createReloadCatalogsLoader(extras?: AuthAccessExtras): LoaderFunction;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zauru-sdk/utils",
-  "version": "6.13.0",
+  "version": "6.15.0",
   "description": "Utilidades, parseo de request y demás para desarrollo de webapps de Zauru",
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
@@ -37,5 +37,5 @@
     "@zauru-sdk/types": "^6.16.0",
     "moment": "^2.30.1"
   },
-  "gitHead": "91e3b376891f89cef02d1badd765db595edbe086"
+  "gitHead": "7ccc6b0a3d1c426f8b62579a64a0bb0be73d2fcd"
 }