@pafi-dev/issuer 0.7.9 → 0.9.0

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/http/index.js

@@ -0,0 +1,14 @@
+import "../chunk-R4FYJZ2N.js";
+import {
+  buildErrorEnvelope,
+  payloadFromGenericError,
+  payloadFromHttpException,
+  payloadFromPafiSdkError
+} from "../chunk-U3WMORJG.js";
+export {
+  buildErrorEnvelope,
+  payloadFromGenericError,
+  payloadFromHttpException,
+  payloadFromPafiSdkError
+};
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}