@innvoid/getmarket-sdk 0.2.3 → 0.2.5

package/dist/core/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/index.ts","../../src/core/errors.ts","../../src/core/http.ts","../../src/middlewares/requestId.ts","../../src/core/internalHttp.ts"],"sourcesContent":["// sdk/src/core/index.ts\n\nexport * from \"./errors\";\nexport * from \"./http\";\nexport * from \"./internalHttp\";\n","export type ClientErrorCode =\n    | \"UPSTREAM_TIMEOUT\"\n    | \"UPSTREAM_UNAVAILABLE\"\n    | \"UPSTREAM_BAD_RESPONSE\"\n    | \"UPSTREAM_NOT_FOUND\"\n    | \"UPSTREAM_UNAUTHORIZED\"\n    | \"UPSTREAM_FORBIDDEN\"\n    | \"UPSTREAM_UNKNOWN\";\n\nexport class UpstreamError extends Error {\n    public code: ClientErrorCode;\n    public status?: number;\n    public details?: any;\n\n    constructor(message: string, code: ClientErrorCode, status?: number, details?: any) {\n        super(message);\n        this.name = \"UpstreamError\";\n        this.code = code;\n        this.status = status;\n        this.details = details;\n    }\n}\n\nexport function mapAxiosToUpstreamError(err: any, svc: string): UpstreamError {\n    const status = err?.response?.status;\n    const data = err?.response?.data;\n    const isTimeout = err?.code === \"ECONNABORTED\" || String(err?.message || \"\").includes(\"timeout\");\n\n    if (isTimeout) {\n        return new UpstreamError(`[${svc}] timeout`, \"UPSTREAM_TIMEOUT\", 504, {cause: err?.message});\n    }\n    if (!err?.response) {\n        return new UpstreamError(`[${svc}] unavailable`, \"UPSTREAM_UNAVAILABLE\", 503, {cause: err?.message});\n    }\n    if (status === 404) return new UpstreamError(`[${svc}] not found`, \"UPSTREAM_NOT_FOUND\", 404, data);\n    if (status === 401) return new UpstreamError(`[${svc}] unauthorized`, \"UPSTREAM_UNAUTHORIZED\", 401, data);\n    if (status === 403) return new UpstreamError(`[${svc}] forbidden`, \"UPSTREAM_FORBIDDEN\", 403, data);\n    if (status >= 400 && status < 600) {\n        return new UpstreamError(`[${svc}] bad response`, \"UPSTREAM_BAD_RESPONSE\", status, data);\n    }\n    return new UpstreamError(`[${svc}] unknown error`, \"UPSTREAM_UNKNOWN\", status, data);\n}\n","// packages/sdk/src/core/http.ts\nimport axios, {AxiosInstance, AxiosRequestConfig} from \"axios\";\nimport {REQUEST_ID_HEADER} from \"../middlewares/requestId\";\n\nexport type HttpClientOpts = {\n    baseURL: string;\n    timeoutMs?: number;\n};\n\n/**\n * Headers compatibles con múltiples versiones de axios.\n * En axios antiguo, `headers` suele ser `any`, así que mantenemos tolerancia.\n */\nexport type AnyHeaders = NonNullable<AxiosRequestConfig[\"headers\"]> | Record<string, string>;\n\n/**\n * Agrega x-request-id a headers (sin pisar otros headers).\n */\nexport function withRequestId(headers: AnyHeaders | undefined, requestId?: string | null): AnyHeaders {\n    const h: Record<string, any> =\n        headers && typeof headers === \"object\"\n            ? {...(headers as any)}\n            : {};\n\n    const rid = (requestId || \"\").trim();\n    if (rid) h[REQUEST_ID_HEADER] = rid;\n\n    return h as AnyHeaders;\n}\n\n/**\n * Helper para construir config de axios con requestId\n * (SIN genéricos para compat con axios typings antiguos).\n */\nexport function withRequestIdConfig(\n    config: AxiosRequestConfig = {},\n    requestId?: string | null\n): AxiosRequestConfig {\n    return {\n        ...config,\n        headers: withRequestId((config as any).headers, requestId) as any,\n    };\n}\n\nexport function createHttpClient(opts: HttpClientOpts): AxiosInstance {\n    return axios.create({\n        baseURL: opts.baseURL,\n        timeout: opts.timeoutMs ?? 4000,\n        headers: {\"Content-Type\": \"application/json\"},\n    });\n}\n","// middlewares/requestId.ts\nimport type {Request, Response, NextFunction} from \"express\";\nimport {randomUUID, randomBytes} from \"crypto\";\n\nexport const REQUEST_ID_HEADER = \"x-request-id\";\nexport const REQUEST_ID_HEADER_ALT = \"x-requestid\";\nexport const RESPONSE_REQUEST_ID_HEADER = \"X-Request-Id\";\n\n// Si quieres IDs más cortos (opcional). Por defecto usamos UUID.\nfunction nanoidLike(len = 21) {\n    return randomBytes(16).toString(\"base64url\").slice(0, len);\n}\n\nexport default function requestId(req: Request, res: Response, next: NextFunction) {\n    const headerId = (req.headers[REQUEST_ID_HEADER] || req.headers[REQUEST_ID_HEADER_ALT]) as\n        | string\n        | undefined;\n\n    // ✅ estándar único: usa UUID (o cambia a nanoidLike() si prefieres corto)\n    const id = headerId?.trim() || randomUUID();\n\n    // ✅ estándar único (no legacy)\n    (req as any).requestId = id;\n    res.locals.requestId = id;\n\n    // ✅ respuesta\n    res.setHeader(RESPONSE_REQUEST_ID_HEADER, id);\n\n    next();\n}\n","// clients/internalHttp.ts\n\ntype RetryPolicy = {\n    retries: number;\n    baseDelayMs: number;\n    retryOnStatuses: number[];\n    retryOnNetworkErrors: boolean;\n};\n\ntype InternalHttpOptions = {\n    baseUrl: string;\n    apiKey?: string; // x-internal-api-key\n    timeoutMs?: number;\n    retry?: Partial<RetryPolicy>;\n};\n\nconst DEFAULT_RETRY: RetryPolicy = {\n    retries: 1,\n    baseDelayMs: 150,\n    retryOnStatuses: [429, 502, 503, 504],\n    retryOnNetworkErrors: true,\n};\n\nfunction sleep(ms: number) {\n    return new Promise((r) => setTimeout(r, ms));\n}\n\nfunction safeJsonStringify(v: any) {\n    try {\n        return JSON.stringify(v);\n    } catch {\n        return String(v);\n    }\n}\n\nfunction toHeaders(init?: HeadersInit): Headers {\n    return new Headers(init || {});\n}\n\nfunction isJsonContentType(contentType: string | null): boolean {\n    if (!contentType) return false;\n    const ct = contentType.toLowerCase();\n    return ct.includes(\"application/json\") || ct.includes(\"+json\");\n}\n\nfunction isAbortError(e: any): boolean {\n    return e?.name === \"AbortError\";\n}\n\nfunction withJitter(ms: number): number {\n    // jitter +-20%\n    const jitter = ms * 0.2;\n    const delta = (Math.random() * 2 - 1) * jitter;\n    return Math.max(0, Math.floor(ms + delta));\n}\n\nexport class InternalHttp {\n    private readonly baseUrl: string;\n    private readonly apiKey: string | undefined;\n    private readonly timeoutMs: number;\n    private retry: RetryPolicy;\n\n    constructor(opts: InternalHttpOptions) {\n        this.baseUrl = opts.baseUrl.replace(/\\/+$/, \"\");\n        this.apiKey = opts.apiKey;\n\n        // ✅ Default más seguro para internas (evita cascadas)\n        this.timeoutMs = opts.timeoutMs ?? 4000;\n\n        this.retry = {...DEFAULT_RETRY, ...(opts.retry || {})};\n    }\n\n    async request<T>(\n        path: string,\n        init: RequestInit & {\n            requestId?: string;\n            idempotencyKey?: string;\n            headers?: HeadersInit;\n        } = {}\n    ): Promise<T> {\n        const url = `${this.baseUrl}${path.startsWith(\"/\") ? \"\" : \"/\"}${path}`;\n\n        const baseHeaders = toHeaders(init.headers);\n\n        if (!baseHeaders.has(\"Content-Type\")) baseHeaders.set(\"Content-Type\", \"application/json\");\n        if (this.apiKey) baseHeaders.set(\"x-internal-api-key\", this.apiKey);\n\n        if (init.requestId) baseHeaders.set(\"x-request-id\", init.requestId);\n        if (init.idempotencyKey) baseHeaders.set(\"Idempotency-Key\", init.idempotencyKey);\n\n        const {headers: _ignored, ...restInit} = init;\n\n        const doFetchOnce = async () => {\n            const controller = new AbortController();\n            const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n            try {\n                const res = await fetch(url, {\n                    ...restInit,\n                    headers: baseHeaders,\n                    signal: controller.signal,\n                });\n\n                if (!res.ok) {\n                    const text = await res.text().catch(() => \"\");\n                    const err: any = new Error(\n                        `HTTP ${res.status} ${res.statusText}${text ? ` - ${text}` : \"\"}`\n                    );\n                    err.status = res.status;\n                    err.body = text;\n                    throw err;\n                }\n\n                if (res.status === 204) return undefined as unknown as T;\n\n                const contentType = res.headers.get(\"content-type\");\n                if (isJsonContentType(contentType)) {\n                    return (await res.json()) as T;\n                }\n\n                const text = await res.text().catch(() => \"\");\n                return text as unknown as T;\n            } finally {\n                clearTimeout(timeout);\n            }\n        };\n\n        let attempt = 0;\n\n        while (true) {\n            try {\n                return await doFetchOnce();\n            } catch (e: any) {\n                attempt++;\n\n                const status = e?.status;\n                const retryableStatus = !!status && this.retry.retryOnStatuses.includes(status);\n\n                const retryableNetwork =\n                    this.retry.retryOnNetworkErrors &&\n                    (isAbortError(e) || !status); // sin status suele ser red/dns/timeout\n\n                const isRetryable = retryableStatus || retryableNetwork;\n\n                if (!isRetryable || attempt > this.retry.retries) {\n                    console.error(\n                        `[InternalHttp] request failed: ${url} attempt=${attempt} status=${status ?? \"n/a\"} err=${e?.message\n                        } body=${safeJsonStringify(e?.body)}`\n                    );\n                    throw e;\n                }\n\n                const backoff = withJitter(this.retry.baseDelayMs * attempt);\n                await sleep(backoff);\n            }\n        }\n    }\n}\n"],"mappings":"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","names":["axios","text"]}
+{"version":3,"sources":["../../src/core/index.ts","../../src/core/errors.ts","../../src/core/http.ts","../../src/core/internalHttp.ts"],"sourcesContent":["// sdk/src/core/index.ts\n\nexport * from \"./errors\";\nexport * from \"./http\";\nexport * from \"./internalHttp\";\n","export type ClientErrorCode =\n    | \"UPSTREAM_TIMEOUT\"\n    | \"UPSTREAM_UNAVAILABLE\"\n    | \"UPSTREAM_BAD_RESPONSE\"\n    | \"UPSTREAM_NOT_FOUND\"\n    | \"UPSTREAM_UNAUTHORIZED\"\n    | \"UPSTREAM_FORBIDDEN\"\n    | \"UPSTREAM_UNKNOWN\";\n\nexport class UpstreamError extends Error {\n    public code: ClientErrorCode;\n    public status?: number;\n    public details?: any;\n\n    constructor(message: string, code: ClientErrorCode, status?: number, details?: any) {\n        super(message);\n        this.name = \"UpstreamError\";\n        this.code = code;\n        this.status = status;\n        this.details = details;\n    }\n}\n\nexport function mapAxiosToUpstreamError(err: any, svc: string): UpstreamError {\n    const status = err?.response?.status;\n    const data = err?.response?.data;\n    const isTimeout = err?.code === \"ECONNABORTED\" || String(err?.message || \"\").includes(\"timeout\");\n\n    if (isTimeout) {\n        return new UpstreamError(`[${svc}] timeout`, \"UPSTREAM_TIMEOUT\", 504, {cause: err?.message});\n    }\n    if (!err?.response) {\n        return new UpstreamError(`[${svc}] unavailable`, \"UPSTREAM_UNAVAILABLE\", 503, {cause: err?.message});\n    }\n    if (status === 404) return new UpstreamError(`[${svc}] not found`, \"UPSTREAM_NOT_FOUND\", 404, data);\n    if (status === 401) return new UpstreamError(`[${svc}] unauthorized`, \"UPSTREAM_UNAUTHORIZED\", 401, data);\n    if (status === 403) return new UpstreamError(`[${svc}] forbidden`, \"UPSTREAM_FORBIDDEN\", 403, data);\n    if (status >= 400 && status < 600) {\n        return new UpstreamError(`[${svc}] bad response`, \"UPSTREAM_BAD_RESPONSE\", status, data);\n    }\n    return new UpstreamError(`[${svc}] unknown error`, \"UPSTREAM_UNKNOWN\", status, data);\n}\n","// sdk/src/core/http.ts\nimport axios, {AxiosInstance, AxiosRequestConfig} from \"axios\";\n\nexport type HttpClient = AxiosInstance;\n\nexport type HttpClientOpts = {\n  baseURL: string;\n  timeoutMs?: number;\n  headers?: Record<string, string>;\n};\n\nexport function createHttpClient(opts: HttpClientOpts): HttpClient {\n  return axios.create({\n    baseURL: opts.baseURL.replace(/\\/+$/, \"\"),\n    timeout: opts.timeoutMs ?? 8000,\n    headers: opts.headers ?? {},\n  } satisfies AxiosRequestConfig);\n}\n","// clients/internalHttp.ts\n\ntype RetryPolicy = {\n    retries: number;\n    baseDelayMs: number;\n    retryOnStatuses: number[];\n    retryOnNetworkErrors: boolean;\n};\n\ntype InternalHttpOptions = {\n    baseUrl: string;\n    apiKey?: string; // x-internal-api-key\n    timeoutMs?: number;\n    retry?: Partial<RetryPolicy>;\n};\n\nconst DEFAULT_RETRY: RetryPolicy = {\n    retries: 1,\n    baseDelayMs: 150,\n    retryOnStatuses: [429, 502, 503, 504],\n    retryOnNetworkErrors: true,\n};\n\nfunction sleep(ms: number) {\n    return new Promise((r) => setTimeout(r, ms));\n}\n\nfunction safeJsonStringify(v: any) {\n    try {\n        return JSON.stringify(v);\n    } catch {\n        return String(v);\n    }\n}\n\nfunction toHeaders(init?: HeadersInit): Headers {\n    return new Headers(init || {});\n}\n\nfunction isJsonContentType(contentType: string | null): boolean {\n    if (!contentType) return false;\n    const ct = contentType.toLowerCase();\n    return ct.includes(\"application/json\") || ct.includes(\"+json\");\n}\n\nfunction isAbortError(e: any): boolean {\n    return e?.name === \"AbortError\";\n}\n\nfunction withJitter(ms: number): number {\n    // jitter +-20%\n    const jitter = ms * 0.2;\n    const delta = (Math.random() * 2 - 1) * jitter;\n    return Math.max(0, Math.floor(ms + delta));\n}\n\nexport class InternalHttp {\n    private readonly baseUrl: string;\n    private readonly apiKey: string | undefined;\n    private readonly timeoutMs: number;\n    private retry: RetryPolicy;\n\n    constructor(opts: InternalHttpOptions) {\n        this.baseUrl = opts.baseUrl.replace(/\\/+$/, \"\");\n        this.apiKey = opts.apiKey;\n\n        // ✅ Default más seguro para internas (evita cascadas)\n        this.timeoutMs = opts.timeoutMs ?? 4000;\n\n        this.retry = {...DEFAULT_RETRY, ...(opts.retry || {})};\n    }\n\n    async request<T>(\n        path: string,\n        init: RequestInit & {\n            requestId?: string;\n            idempotencyKey?: string;\n            headers?: HeadersInit;\n        } = {}\n    ): Promise<T> {\n        const url = `${this.baseUrl}${path.startsWith(\"/\") ? \"\" : \"/\"}${path}`;\n\n        const baseHeaders = toHeaders(init.headers);\n\n        if (!baseHeaders.has(\"Content-Type\")) baseHeaders.set(\"Content-Type\", \"application/json\");\n        if (this.apiKey) baseHeaders.set(\"x-internal-api-key\", this.apiKey);\n\n        if (init.requestId) baseHeaders.set(\"x-request-id\", init.requestId);\n        if (init.idempotencyKey) baseHeaders.set(\"Idempotency-Key\", init.idempotencyKey);\n\n        const {headers: _ignored, ...restInit} = init;\n\n        const doFetchOnce = async () => {\n            const controller = new AbortController();\n            const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n            try {\n                const res = await fetch(url, {\n                    ...restInit,\n                    headers: baseHeaders,\n                    signal: controller.signal,\n                });\n\n                if (!res.ok) {\n                    const text = await res.text().catch(() => \"\");\n                    const err: any = new Error(\n                        `HTTP ${res.status} ${res.statusText}${text ? ` - ${text}` : \"\"}`\n                    );\n                    err.status = res.status;\n                    err.body = text;\n                    throw err;\n                }\n\n                if (res.status === 204) return undefined as unknown as T;\n\n                const contentType = res.headers.get(\"content-type\");\n                if (isJsonContentType(contentType)) {\n                    return (await res.json()) as T;\n                }\n\n                const text = await res.text().catch(() => \"\");\n                return text as unknown as T;\n            } finally {\n                clearTimeout(timeout);\n            }\n        };\n\n        let attempt = 0;\n\n        while (true) {\n            try {\n                return await doFetchOnce();\n            } catch (e: any) {\n                attempt++;\n\n                const status = e?.status;\n                const retryableStatus = !!status && this.retry.retryOnStatuses.includes(status);\n\n                const retryableNetwork =\n                    this.retry.retryOnNetworkErrors &&\n                    (isAbortError(e) || !status); // sin status suele ser red/dns/timeout\n\n                const isRetryable = retryableStatus || retryableNetwork;\n\n                if (!isRetryable || attempt > this.retry.retries) {\n                    console.error(\n                        `[InternalHttp] request failed: ${url} attempt=${attempt} status=${status ?? \"n/a\"} err=${e?.message\n                        } body=${safeJsonStringify(e?.body)}`\n                    );\n                    throw e;\n                }\n\n                const backoff = withJitter(this.retry.baseDelayMs * attempt);\n                await sleep(backoff);\n            }\n        }\n    }\n}\n"],"mappings":"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","names":["axios","text"]}

package/dist/core/index.d.cts

@@ -1,4 +1,4 @@
-import { AxiosRequestConfig, AxiosInstance } from 'axios';
+import { AxiosInstance } from 'axios';
 
 type ClientErrorCode = "UPSTREAM_TIMEOUT" | "UPSTREAM_UNAVAILABLE" | "UPSTREAM_BAD_RESPONSE" | "UPSTREAM_NOT_FOUND" | "UPSTREAM_UNAUTHORIZED" | "UPSTREAM_FORBIDDEN" | "UPSTREAM_UNKNOWN";
 declare class UpstreamError extends Error {
@@ -9,25 +9,13 @@ declare class UpstreamError extends Error {
 }
 declare function mapAxiosToUpstreamError(err: any, svc: string): UpstreamError;
 
+type HttpClient = AxiosInstance;
 type HttpClientOpts = {
     baseURL: string;
     timeoutMs?: number;
+    headers?: Record<string, string>;
 };
-/**
- * Headers compatibles con múltiples versiones de axios.
- * En axios antiguo, `headers` suele ser `any`, así que mantenemos tolerancia.
- */
-type AnyHeaders = NonNullable<AxiosRequestConfig["headers"]> | Record<string, string>;
-/**
- * Agrega x-request-id a headers (sin pisar otros headers).
- */
-declare function withRequestId(headers: AnyHeaders | undefined, requestId?: string | null): AnyHeaders;
-/**
- * Helper para construir config de axios con requestId
- * (SIN genéricos para compat con axios typings antiguos).
- */
-declare function withRequestIdConfig(config?: AxiosRequestConfig, requestId?: string | null): AxiosRequestConfig;
-declare function createHttpClient(opts: HttpClientOpts): AxiosInstance;
+declare function createHttpClient(opts: HttpClientOpts): HttpClient;
 
 type RetryPolicy = {
     retries: number;
@@ -54,4 +42,4 @@ declare class InternalHttp {
     }): Promise<T>;
 }
 
-export { type AnyHeaders, type ClientErrorCode, type HttpClientOpts, InternalHttp, UpstreamError, createHttpClient, mapAxiosToUpstreamError, withRequestId, withRequestIdConfig };
+export { type ClientErrorCode, type HttpClient, type HttpClientOpts, InternalHttp, UpstreamError, createHttpClient, mapAxiosToUpstreamError };

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-import { AxiosRequestConfig, AxiosInstance } from 'axios';
+import { AxiosInstance } from 'axios';
 
 type ClientErrorCode = "UPSTREAM_TIMEOUT" | "UPSTREAM_UNAVAILABLE" | "UPSTREAM_BAD_RESPONSE" | "UPSTREAM_NOT_FOUND" | "UPSTREAM_UNAUTHORIZED" | "UPSTREAM_FORBIDDEN" | "UPSTREAM_UNKNOWN";
 declare class UpstreamError extends Error {
@@ -9,25 +9,13 @@ declare class UpstreamError extends Error {
 }
 declare function mapAxiosToUpstreamError(err: any, svc: string): UpstreamError;
 
+type HttpClient = AxiosInstance;
 type HttpClientOpts = {
     baseURL: string;
     timeoutMs?: number;
+    headers?: Record<string, string>;
 };
-/**
- * Headers compatibles con múltiples versiones de axios.
- * En axios antiguo, `headers` suele ser `any`, así que mantenemos tolerancia.
- */
-type AnyHeaders = NonNullable<AxiosRequestConfig["headers"]> | Record<string, string>;
-/**
- * Agrega x-request-id a headers (sin pisar otros headers).
- */
-declare function withRequestId(headers: AnyHeaders | undefined, requestId?: string | null): AnyHeaders;
-/**
- * Helper para construir config de axios con requestId
- * (SIN genéricos para compat con axios typings antiguos).
- */
-declare function withRequestIdConfig(config?: AxiosRequestConfig, requestId?: string | null): AxiosRequestConfig;
-declare function createHttpClient(opts: HttpClientOpts): AxiosInstance;
+declare function createHttpClient(opts: HttpClientOpts): HttpClient;
 
 type RetryPolicy = {
     retries: number;
@@ -54,4 +42,4 @@ declare class InternalHttp {
     }): Promise<T>;
 }
 
-export { type AnyHeaders, type ClientErrorCode, type HttpClientOpts, InternalHttp, UpstreamError, createHttpClient, mapAxiosToUpstreamError, withRequestId, withRequestIdConfig };
+export { type ClientErrorCode, type HttpClient, type HttpClientOpts, InternalHttp, UpstreamError, createHttpClient, mapAxiosToUpstreamError };

package/dist/core/index.js

@@ -2,17 +2,12 @@ import {
   InternalHttp,
   UpstreamError,
   createHttpClient,
-  mapAxiosToUpstreamError,
-  withRequestId,
-  withRequestIdConfig
-} from "../chunk-OSYBK5AN.js";
-import "../chunk-KJ64O2EG.js";
+  mapAxiosToUpstreamError
+} from "../chunk-5S2JP7PR.js";
 export {
   InternalHttp,
   UpstreamError,
   createHttpClient,
-  mapAxiosToUpstreamError,
-  withRequestId,
-  withRequestIdConfig
+  mapAxiosToUpstreamError
 };
 //# sourceMappingURL=index.js.map

package/dist/index.cjs

@@ -59,13 +59,17 @@ __export(src_exports, {
   createInternalHttpClient: () => createInternalHttpClient,
   createMdClient: () => createMdClient,
   createMediaClient: () => createMediaClient,
+  createMkpClient: () => createMkpClient,
   createPlatformClient: () => createPlatformClient,
   createResClient: () => createResClient,
   getOrSet: () => getOrSet,
   getRequestContextFromHeaders: () => getRequestContextFromHeaders,
   getTwoLevelCache: () => getTwoLevelCache,
   internalAuth: () => internalAuth,
+  isUid: () => isUid,
   mapAxiosToUpstreamError: () => mapAxiosToUpstreamError,
+  newUid: () => newUid,
+  newUidV4: () => newUidV4,
   parseHeaders: () => parseHeaders,
   readRs256PublicKey: () => readRs256PublicKey,
   readServiceEnv: () => readServiceEnv,
@@ -77,9 +81,7 @@ __export(src_exports, {
   requireRolesOrAnyPermission: () => requireRolesOrAnyPermission,
   sendError: () => sendError,
   sendOk: () => sendOk,
-  verifyBackendJwtRS256: () => verifyBackendJwtRS256,
-  withRequestId: () => withRequestId,
-  withRequestIdConfig: () => withRequestIdConfig
+  verifyBackendJwtRS256: () => verifyBackendJwtRS256
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -404,39 +406,11 @@ function mapAxiosToUpstreamError(err, svc) {
 
 // src/core/http.ts
 var import_axios = __toESM(require("axios"), 1);
-
-// src/middlewares/requestId.ts
-var import_crypto = require("crypto");
-var REQUEST_ID_HEADER = "x-request-id";
-var REQUEST_ID_HEADER_ALT = "x-requestid";
-var RESPONSE_REQUEST_ID_HEADER = "X-Request-Id";
-function requestId(req, res, next) {
-  const headerId = req.headers[REQUEST_ID_HEADER] || req.headers[REQUEST_ID_HEADER_ALT];
-  const id = headerId?.trim() || (0, import_crypto.randomUUID)();
-  req.requestId = id;
-  res.locals.requestId = id;
-  res.setHeader(RESPONSE_REQUEST_ID_HEADER, id);
-  next();
-}
-
-// src/core/http.ts
-function withRequestId(headers, requestId2) {
-  const h2 = headers && typeof headers === "object" ? { ...headers } : {};
-  const rid = (requestId2 || "").trim();
-  if (rid) h2[REQUEST_ID_HEADER] = rid;
-  return h2;
-}
-function withRequestIdConfig(config = {}, requestId2) {
-  return {
-    ...config,
-    headers: withRequestId(config.headers, requestId2)
-  };
-}
 function createHttpClient(opts) {
   return import_axios.default.create({
-    baseURL: opts.baseURL,
-    timeout: opts.timeoutMs ?? 4e3,
-    headers: { "Content-Type": "application/json" }
+    baseURL: opts.baseURL.replace(/\/+$/, ""),
+    timeout: opts.timeoutMs ?? 8e3,
+    headers: opts.headers ?? {}
   });
 }
 
@@ -579,6 +553,20 @@ function parseHeaders(req, _res, next) {
   next();
 }
 
+// src/middlewares/requestId.ts
+var import_crypto = require("crypto");
+var REQUEST_ID_HEADER = "x-request-id";
+var REQUEST_ID_HEADER_ALT = "x-requestid";
+var RESPONSE_REQUEST_ID_HEADER = "X-Request-Id";
+function requestId(req, res, next) {
+  const headerId = req.headers[REQUEST_ID_HEADER] || req.headers[REQUEST_ID_HEADER_ALT];
+  const id = headerId?.trim() || (0, import_crypto.randomUUID)();
+  req.requestId = id;
+  res.locals.requestId = id;
+  res.setHeader(RESPONSE_REQUEST_ID_HEADER, id);
+  next();
+}
+
 // src/middlewares/internalAuth.ts
 var import_fs = __toESM(require("fs"), 1);
 var import_crypto2 = __toESM(require("crypto"), 1);
@@ -1528,14 +1516,96 @@ function createMdClient() {
 // src/clients/fisClient.ts
 function createFisClient() {
   const env = readServiceEnv("FIS", { apiPrefix: "/internal/v1" });
+  const http = createHttpClient({
+    baseURL: `${env.baseURL}${env.apiPrefix}`,
+    timeoutMs: 8e3
+  });
   const taxes = createBulkRefsClient({
     namespace: "fis:tax",
     baseURL: env.baseURL,
     apiPrefix: env.apiPrefix,
     path: "/refs/taxes"
   });
+  const documents = createBulkRefsClient({
+    namespace: "fis:document",
+    baseURL: env.baseURL,
+    apiPrefix: env.apiPrefix,
+    path: "/refs/documents"
+  });
+  const submissions = createBulkRefsClient({
+    namespace: "fis:submission",
+    baseURL: env.baseURL,
+    apiPrefix: env.apiPrefix,
+    path: "/refs/submissions"
+  });
   return {
-    taxesRefs: (uids, opts) => taxes.bulkRefs(uids, opts)
+    // -----------------------------------------------------------------------
+    // Bulk refs
+    // -----------------------------------------------------------------------
+    taxesRefs: (uids, opts) => taxes.bulkRefs(uids, opts),
+    documentsRefs: (uids, opts) => documents.bulkRefs(uids, opts),
+    submissionsRefs: (uids, opts) => submissions.bulkRefs(uids, opts),
+    // -----------------------------------------------------------------------
+    // Fiscal calculation / build / lifecycle
+    // -----------------------------------------------------------------------
+    calculate: async (body) => {
+      const { data } = await http.post("/calculate", body);
+      return data;
+    },
+    buildDocument: async (body) => {
+      const { data } = await http.post("/documents/build", body);
+      return data;
+    },
+    signDocument: async (body) => {
+      const { data } = await http.post("/documents/sign", body);
+      return data;
+    },
+    submitDocument: async (body) => {
+      const { data } = await http.post("/documents/submit", body);
+      return data;
+    },
+    cancelDocument: async (body) => {
+      const { data } = await http.post("/documents/cancel", body);
+      return data;
+    },
+    // -----------------------------------------------------------------------
+    // Folios / series
+    // -----------------------------------------------------------------------
+    reserveFolio: async (body) => {
+      const { data } = await http.post("/folios/reserve", body);
+      return data;
+    },
+    consumeFolio: async (body) => {
+      const { data } = await http.post("/folios/consume", body);
+      return data;
+    },
+    // -----------------------------------------------------------------------
+    // Queries / detail
+    // -----------------------------------------------------------------------
+    queryDocuments: async (params) => {
+      const { data } = await http.get("/documents", { params });
+      return data;
+    },
+    getDocumentByUid: async (uid) => {
+      const { data } = await http.get(`/documents/${uid}`);
+      return data;
+    },
+    getSnapshotByUid: async (uid) => {
+      const { data } = await http.get(`/snapshots/${uid}`);
+      return data;
+    },
+    getSubmissionByUid: async (uid) => {
+      const { data } = await http.get(`/submissions/${uid}`);
+      return data;
+    },
+    getStatusEventsByDocumentUid: async (documentUid) => {
+      const { data } = await http.get(`/documents/${documentUid}/status-events`);
+      return data;
+    },
+    retrySubmission: async (body) => {
+      const { data } = await http.post("/submissions/retry", body);
+      return data;
+    }
   };
 }
 
@@ -1552,6 +1622,46 @@ function createMediaClient() {
     filesRefs: (uids, opts) => files.bulkRefs(uids, opts)
   };
 }
+
+// src/clients/mkpClient.ts
+function createMkpClient() {
+  const env = readServiceEnv("MKP", { apiPrefix: "/internal/v1" });
+  const publications = createBulkRefsClient({
+    namespace: "mkp:publication",
+    baseURL: env.baseURL,
+    apiPrefix: env.apiPrefix,
+    path: "/refs/publications"
+  });
+  const events = createBulkRefsClient({
+    namespace: "mkp:event",
+    baseURL: env.baseURL,
+    apiPrefix: env.apiPrefix,
+    path: "/refs/events"
+  });
+  const promotions = createBulkRefsClient({
+    namespace: "mkp:promotion",
+    baseURL: env.baseURL,
+    apiPrefix: env.apiPrefix,
+    path: "/refs/promotions"
+  });
+  return {
+    publicationsRefs: (uids, opts) => publications.bulkRefs(uids, opts),
+    eventsRefs: (uids, opts) => events.bulkRefs(uids, opts),
+    promotionsRefs: (uids, opts) => promotions.bulkRefs(uids, opts)
+  };
+}
+
+// src/common/ids.ts
+var import_uuid = require("uuid");
+function newUid() {
+  return (0, import_uuid.v7)();
+}
+function newUidV4() {
+  return (0, import_uuid.v4)();
+}
+function isUid(value) {
+  return (0, import_uuid.validate)(value) && ((0, import_uuid.version)(value) === 7 || (0, import_uuid.version)(value) === 4);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   HEADER_AUTHORIZATION,
@@ -1583,13 +1693,17 @@ function createMediaClient() {
   createInternalHttpClient,
   createMdClient,
   createMediaClient,
+  createMkpClient,
   createPlatformClient,
   createResClient,
   getOrSet,
   getRequestContextFromHeaders,
   getTwoLevelCache,
   internalAuth,
+  isUid,
   mapAxiosToUpstreamError,
+  newUid,
+  newUidV4,
   parseHeaders,
   readRs256PublicKey,
   readServiceEnv,
@@ -1601,8 +1715,6 @@ function createMediaClient() {
   requireRolesOrAnyPermission,
   sendError,
   sendOk,
-  verifyBackendJwtRS256,
-  withRequestId,
-  withRequestIdConfig
+  verifyBackendJwtRS256
 });
 //# sourceMappingURL=index.cjs.map