@pafi-dev/issuer 0.35.0 → 0.36.0

package/dist/http/index.d.cts

@@ -0,0 +1,112 @@
+import { PafiErrorType, PafiSdkError } from '@pafi-dev/core';
+
+/**
+ * Stripe-style HTTP error envelope shared by every PAFI service and
+ * issuer backend. The framework-agnostic `normalizeErrorToEnvelope`
+ * helper produces this from any thrown value; framework-specific
+ * filters (`@pafi-dev/issuer/nestjs`) call into it and write the
+ * result to their response object.
+ *
+ * Wire format:
+ *
+ * ```json
+ * {
+ *   "success": false,
+ *   "statusCode": 422,
+ *   "error": {
+ *     "type": "business_logic_error",
+ *     "code": "REDEMPTION_POLICY_DENIED",
+ *     "message": "redemption denied: amount 1 below per-tx minimum",
+ *     "param": null,
+ *     "metadata": { "policyDenialCode": "PER_TX_MIN" },
+ *     "safeToRetry": false,
+ *     "details": null
+ *   },
+ *   "meta": {
+ *     "timestamp": "2026-05-07T...",
+ *     "requestId": "...",
+ *     "path": "/pt/redeem"
+ *   }
+ * }
+ * ```
+ */
+
+/** Inner `error` block of the envelope. */
+interface PafiErrorPayload {
+    type: PafiErrorType;
+    code: string;
+    message: string;
+    param?: string;
+    metadata?: Record<string, unknown>;
+    details?: unknown;
+    safeToRetry: boolean;
+}
+/** Outer envelope returned for any non-2xx response. */
+interface PafiErrorEnvelope {
+    success: false;
+    statusCode: number;
+    error: PafiErrorPayload;
+    meta: {
+        timestamp: string;
+        requestId: string;
+        path: string;
+    };
+}
+/** Per-call request context the filter must collect from the host framework. */
+interface NormalizeContext {
+    /** `req.url` or equivalent. */
+    path: string;
+    /** Resolved request id (header or generated). */
+    requestId: string;
+    /** Optional `now()` injection for deterministic tests. */
+    now?: () => Date;
+}
+/**
+ * Generic error duck-type. The filter passes a small descriptor for
+ * any framework exception so the normalizer doesn't depend on
+ * `@nestjs/common` or any specific HTTP library.
+ */
+interface GenericHttpExceptionDescriptor {
+    /** HTTP status code carried by the exception. */
+    statusCode: number;
+    /**
+     * The body the framework would have serialized. For NestJS this is
+     * `exception.getResponse()`. May be a string or a record with
+     * `code`/`error`/`message`/`details`/`safeToRetry`/`type`/etc.
+     */
+    responseBody: unknown;
+    /** Exception class name, used as a last-resort `code` fallback. */
+    exceptionName: string;
+    /** Original `error.message`, used as a last-resort `message` fallback. */
+    fallbackMessage: string;
+}
+/**
+ * Convert a `PafiSdkError` directly to the inner `error` payload —
+ * skipping any framework exception wrapper. Used by frameworks that
+ * surface SDK errors without going through `createSdkErrorMapper`.
+ */
+declare function payloadFromPafiSdkError(err: PafiSdkError): PafiErrorPayload;
+/**
+ * Build the full envelope for any thrown value. The caller resolves
+ * `HttpException`-shaped exceptions and passes a descriptor; plain
+ * `Error` instances and unknown throws are handled directly.
+ */
+declare function buildErrorEnvelope(input: {
+    status: number;
+    payload: PafiErrorPayload;
+    ctx: NormalizeContext;
+}): PafiErrorEnvelope;
+/**
+ * Normalize a known `HttpException`-shaped exception into a payload.
+ * Framework filters supply the descriptor; the rest is shape-agnostic.
+ */
+declare function payloadFromHttpException(desc: GenericHttpExceptionDescriptor): PafiErrorPayload;
+/**
+ * Normalize a generic `Error` (not an HttpException) — TypeORM
+ * `QueryFailedError`, viem revert errors, etc. Returns a redacted
+ * 500-class payload with no message bleed-through unless the error
+ * is recognizably benign.
+ */
+declare function payloadFromGenericError(err: Error): PafiErrorPayload;
+
+export { type GenericHttpExceptionDescriptor, type NormalizeContext, type PafiErrorEnvelope, type PafiErrorPayload, buildErrorEnvelope, payloadFromGenericError, payloadFromHttpException, payloadFromPafiSdkError };

package/dist/http/index.d.ts

@@ -0,0 +1,112 @@
+import { PafiErrorType, PafiSdkError } from '@pafi-dev/core';
+
+/**
+ * Stripe-style HTTP error envelope shared by every PAFI service and
+ * issuer backend. The framework-agnostic `normalizeErrorToEnvelope`
+ * helper produces this from any thrown value; framework-specific
+ * filters (`@pafi-dev/issuer/nestjs`) call into it and write the
+ * result to their response object.
+ *
+ * Wire format:
+ *
+ * ```json
+ * {
+ *   "success": false,
+ *   "statusCode": 422,
+ *   "error": {
+ *     "type": "business_logic_error",
+ *     "code": "REDEMPTION_POLICY_DENIED",
+ *     "message": "redemption denied: amount 1 below per-tx minimum",
+ *     "param": null,
+ *     "metadata": { "policyDenialCode": "PER_TX_MIN" },
+ *     "safeToRetry": false,
+ *     "details": null
+ *   },
+ *   "meta": {
+ *     "timestamp": "2026-05-07T...",
+ *     "requestId": "...",
+ *     "path": "/pt/redeem"
+ *   }
+ * }
+ * ```
+ */
+
+/** Inner `error` block of the envelope. */
+interface PafiErrorPayload {
+    type: PafiErrorType;
+    code: string;
+    message: string;
+    param?: string;
+    metadata?: Record<string, unknown>;
+    details?: unknown;
+    safeToRetry: boolean;
+}
+/** Outer envelope returned for any non-2xx response. */
+interface PafiErrorEnvelope {
+    success: false;
+    statusCode: number;
+    error: PafiErrorPayload;
+    meta: {
+        timestamp: string;
+        requestId: string;
+        path: string;
+    };
+}
+/** Per-call request context the filter must collect from the host framework. */
+interface NormalizeContext {
+    /** `req.url` or equivalent. */
+    path: string;
+    /** Resolved request id (header or generated). */
+    requestId: string;
+    /** Optional `now()` injection for deterministic tests. */
+    now?: () => Date;
+}
+/**
+ * Generic error duck-type. The filter passes a small descriptor for
+ * any framework exception so the normalizer doesn't depend on
+ * `@nestjs/common` or any specific HTTP library.
+ */
+interface GenericHttpExceptionDescriptor {
+    /** HTTP status code carried by the exception. */
+    statusCode: number;
+    /**
+     * The body the framework would have serialized. For NestJS this is
+     * `exception.getResponse()`. May be a string or a record with
+     * `code`/`error`/`message`/`details`/`safeToRetry`/`type`/etc.
+     */
+    responseBody: unknown;
+    /** Exception class name, used as a last-resort `code` fallback. */
+    exceptionName: string;
+    /** Original `error.message`, used as a last-resort `message` fallback. */
+    fallbackMessage: string;
+}
+/**
+ * Convert a `PafiSdkError` directly to the inner `error` payload —
+ * skipping any framework exception wrapper. Used by frameworks that
+ * surface SDK errors without going through `createSdkErrorMapper`.
+ */
+declare function payloadFromPafiSdkError(err: PafiSdkError): PafiErrorPayload;
+/**
+ * Build the full envelope for any thrown value. The caller resolves
+ * `HttpException`-shaped exceptions and passes a descriptor; plain
+ * `Error` instances and unknown throws are handled directly.
+ */
+declare function buildErrorEnvelope(input: {
+    status: number;
+    payload: PafiErrorPayload;
+    ctx: NormalizeContext;
+}): PafiErrorEnvelope;
+/**
+ * Normalize a known `HttpException`-shaped exception into a payload.
+ * Framework filters supply the descriptor; the rest is shape-agnostic.
+ */
+declare function payloadFromHttpException(desc: GenericHttpExceptionDescriptor): PafiErrorPayload;
+/**
+ * Normalize a generic `Error` (not an HttpException) — TypeORM
+ * `QueryFailedError`, viem revert errors, etc. Returns a redacted
+ * 500-class payload with no message bleed-through unless the error
+ * is recognizably benign.
+ */
+declare function payloadFromGenericError(err: Error): PafiErrorPayload;
+
+export { type GenericHttpExceptionDescriptor, type NormalizeContext, type PafiErrorEnvelope, type PafiErrorPayload, buildErrorEnvelope, payloadFromGenericError, payloadFromHttpException, payloadFromPafiSdkError };

package/dist/index.cjs

@@ -4437,6 +4437,7 @@ function createNativePtQuoter(config) {
     cacheTtlMs = 3e4,
     fallbackEthPriceUsd = 3e3,
     fallbackPtPriceUsdt = 0.1,
+    failClosed = false,
     fetchImpl = globalThis.fetch,
     now = () => Date.now()
   } = config;
@@ -4461,6 +4462,11 @@ function createNativePtQuoter(config) {
       ethPriceCache = { value: answer, expiresAt: ts + cacheTtlMs };
       return answer;
     } catch (err) {
+      if (failClosed) {
+        throw new Error(
+          `[nativePtQuoter] Chainlink unavailable in fail-closed mode: ${err.message}`
+        );
+      }
       console.warn("[nativePtQuoter] Chainlink unavailable, using fallback:", err.message);
       return BigInt(Math.round(fallbackEthPriceUsd * 1e8));
     }
@@ -4493,6 +4499,11 @@ function createNativePtQuoter(config) {
       ptPriceCache = { value, expiresAt: ts + cacheTtlMs };
       return value;
     } catch (err) {
+      if (failClosed) {
+        throw new Error(
+          `[nativePtQuoter] subgraph miss for ${pointTokenAddress} in fail-closed mode: ${err.message}`
+        );
+      }
       console.warn("[nativePtQuoter] subgraph unavailable, using fallback:", err.message);
       const ptPerUsdtHuman = 1 / fallbackPtPriceUsdt;
       return parseBigDecimalTo18(ptPerUsdtHuman.toFixed(18));
@@ -5410,7 +5421,7 @@ var MemoryRedemptionHistoryStore = class {
 };
 
 // src/index.ts
-var PAFI_ISSUER_SDK_VERSION = true ? "0.35.0" : "dev";
+var PAFI_ISSUER_SDK_VERSION = true ? "0.35.1" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdapterMisconfiguredError,