@aibtc/tx-schemas 0.1.0

package/dist/core/payment.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { InFlightPaymentStateSchema, PAYMENT_STATE_TO_CATEGORY, PaymentStateCategorySchema, PaymentStateSchema, } from "./enums.js";
+import { IsoDateTimeSchema, NonNegativeIntegerSchema, PaymentIdSchema, TransactionIdSchema, UrlSchema, } from "./primitives.js";
+import { FailedTerminalReasonSchema, NotFoundTerminalReasonSchema, ReplacedTerminalReasonSchema, } from "./terminal-reasons.js";
+const PaymentStatusBaseSchema = z.object({
+    state: PaymentStateSchema,
+    category: PaymentStateCategorySchema,
+});
+function inFlightStatusSchema(state) {
+    return PaymentStatusBaseSchema.extend({
+        state: z.literal(state),
+        category: z.literal(PAYMENT_STATE_TO_CATEGORY[state]),
+        paymentId: PaymentIdSchema,
+        txid: TransactionIdSchema.optional(),
+    });
+}
+export const RequiresPaymentStatusSchema = PaymentStatusBaseSchema.extend({
+    state: z.literal("requires_payment"),
+    category: z.literal(PAYMENT_STATE_TO_CATEGORY.requires_payment),
+});
+export const SubmittedPaymentStatusSchema = inFlightStatusSchema("submitted");
+export const QueuedPaymentStatusSchema = inFlightStatusSchema("queued");
+export const BroadcastingPaymentStatusSchema = inFlightStatusSchema("broadcasting");
+export const MempoolPaymentStatusSchema = inFlightStatusSchema("mempool");
+export const ConfirmedPaymentStatusSchema = PaymentStatusBaseSchema.extend({
+    state: z.literal("confirmed"),
+    category: z.literal(PAYMENT_STATE_TO_CATEGORY.confirmed),
+    paymentId: PaymentIdSchema,
+    txid: TransactionIdSchema.optional(),
+    blockHeight: NonNegativeIntegerSchema.optional(),
+    confirmedAt: IsoDateTimeSchema.optional(),
+    explorerUrl: UrlSchema.optional(),
+});
+export const FailedPaymentStatusSchema = PaymentStatusBaseSchema.extend({
+    state: z.literal("failed"),
+    category: z.literal(PAYMENT_STATE_TO_CATEGORY.failed),
+    paymentId: PaymentIdSchema,
+    txid: TransactionIdSchema.optional(),
+    reason: FailedTerminalReasonSchema,
+    detail: z.string().optional(),
+    retryable: z.boolean().optional(),
+});
+export const ReplacedPaymentStatusSchema = PaymentStatusBaseSchema.extend({
+    state: z.literal("replaced"),
+    category: z.literal(PAYMENT_STATE_TO_CATEGORY.replaced),
+    paymentId: PaymentIdSchema,
+    txid: TransactionIdSchema.optional(),
+    reason: ReplacedTerminalReasonSchema,
+    detail: z.string().optional(),
+});
+export const NotFoundPaymentStatusSchema = PaymentStatusBaseSchema.extend({
+    state: z.literal("not_found"),
+    category: z.literal(PAYMENT_STATE_TO_CATEGORY.not_found),
+    paymentId: PaymentIdSchema,
+    reason: NotFoundTerminalReasonSchema,
+    detail: z.string().optional(),
+});
+export const PaymentStatusSchema = z.discriminatedUnion("state", [
+    RequiresPaymentStatusSchema,
+    SubmittedPaymentStatusSchema,
+    QueuedPaymentStatusSchema,
+    BroadcastingPaymentStatusSchema,
+    MempoolPaymentStatusSchema,
+    ConfirmedPaymentStatusSchema,
+    FailedPaymentStatusSchema,
+    ReplacedPaymentStatusSchema,
+    NotFoundPaymentStatusSchema,
+]);
+export const TrackedPaymentStatusSchema = z.discriminatedUnion("state", [
+    SubmittedPaymentStatusSchema,
+    QueuedPaymentStatusSchema,
+    BroadcastingPaymentStatusSchema,
+    MempoolPaymentStatusSchema,
+    ConfirmedPaymentStatusSchema,
+    FailedPaymentStatusSchema,
+    ReplacedPaymentStatusSchema,
+    NotFoundPaymentStatusSchema,
+]);
+export const TerminalPaymentStatusSchema = z.discriminatedUnion("state", [
+    ConfirmedPaymentStatusSchema,
+    FailedPaymentStatusSchema,
+    ReplacedPaymentStatusSchema,
+    NotFoundPaymentStatusSchema,
+]);
+//# sourceMappingURL=payment.js.map

package/dist/core/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/core/payment.ts"],"names":[],"mappings":"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"}

package/dist/core/primitives.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const AmountStringSchema: z.ZodString;
+export declare const PaymentIdSchema: z.ZodString;
+export declare const TransactionHexSchema: z.ZodString;
+export declare const TransactionIdSchema: z.ZodString;
+export declare const StacksAddressSchema: z.ZodString;
+export declare const IsoDateTimeSchema: z.ZodString;
+export declare const PositiveIntegerSchema: z.ZodNumber;
+export declare const NonNegativeIntegerSchema: z.ZodNumber;
+export declare const UrlSchema: z.ZodString;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/core/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,aAE0B,CAAC;AAE1D,eAAO,MAAM,eAAe,aAEsD,CAAC;AAEnF,eAAO,MAAM,oBAAoB,aAEyC,CAAC;AAE3E,eAAO,MAAM,mBAAmB,aAEyC,CAAC;AAE1E,eAAO,MAAM,mBAAmB,aAEM,CAAC;AAEvC,eAAO,MAAM,iBAAiB,aAED,CAAC;AAE9B,eAAO,MAAM,qBAAqB,aAGrB,CAAC;AAEd,eAAO,MAAM,wBAAwB,aAGrB,CAAC;AAEjB,eAAO,MAAM,SAAS,aAAmB,CAAC"}

package/dist/core/primitives.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export const AmountStringSchema = z
+    .string()
+    .regex(/^[0-9]+$/, "Expected an integer amount string");
+export const PaymentIdSchema = z
+    .string()
+    .regex(/^pay_[A-Za-z0-9_-]+$/, "Expected a relay payment id with a pay_ prefix");
+export const TransactionHexSchema = z
+    .string()
+    .regex(/^(?:0x)?[0-9a-fA-F]+$/, "Expected hex-encoded transaction data");
+export const TransactionIdSchema = z
+    .string()
+    .regex(/^(?:0x)?[0-9a-fA-F]{64}$/, "Expected a 32-byte transaction id");
+export const StacksAddressSchema = z
+    .string()
+    .min(1, "Expected a Stacks address");
+export const IsoDateTimeSchema = z
+    .string()
+    .datetime({ offset: true });
+export const PositiveIntegerSchema = z
+    .number()
+    .int()
+    .positive();
+export const NonNegativeIntegerSchema = z
+    .number()
+    .int()
+    .nonnegative();
+export const UrlSchema = z.string().url();
+//# sourceMappingURL=primitives.js.map

package/dist/core/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/core/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,KAAK,CAAC,UAAU,EAAE,mCAAmC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,KAAK,CAAC,sBAAsB,EAAE,gDAAgD,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,EAAE;KACR,KAAK,CAAC,uBAAuB,EAAE,uCAAuC,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,KAAK,CAAC,0BAA0B,EAAE,mCAAmC,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,EAAE,CAAC;AAEd,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,EAAE;KACR,GAAG,EAAE;KACL,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC"}

package/dist/core/schemas.d.ts

@@ -0,0 +1,2 @@
+export { BroadcastingPaymentStatusSchema, ConfirmedPaymentStatusSchema, FailedPaymentStatusSchema, MempoolPaymentStatusSchema, NotFoundPaymentStatusSchema, PaymentStatusSchema, QueuedPaymentStatusSchema, ReplacedPaymentStatusSchema, RequiresPaymentStatusSchema, SubmittedPaymentStatusSchema, TerminalPaymentStatusSchema, TrackedPaymentStatusSchema, } from "./payment.js";
+//# sourceMappingURL=schemas.d.ts.map

package/dist/core/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/core/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAC"}

package/dist/core/schemas.js

@@ -0,0 +1,2 @@
+export { BroadcastingPaymentStatusSchema, ConfirmedPaymentStatusSchema, FailedPaymentStatusSchema, MempoolPaymentStatusSchema, NotFoundPaymentStatusSchema, PaymentStatusSchema, QueuedPaymentStatusSchema, ReplacedPaymentStatusSchema, RequiresPaymentStatusSchema, SubmittedPaymentStatusSchema, TerminalPaymentStatusSchema, TrackedPaymentStatusSchema, } from "./payment.js";
+//# sourceMappingURL=schemas.js.map

package/dist/core/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/core/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAC"}

package/dist/core/terminal-reasons.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+export declare const FAILED_TERMINAL_REASONS: readonly ["invalid_transaction", "not_sponsored", "sender_nonce_stale", "sender_nonce_gap", "sender_nonce_duplicate", "queue_unavailable", "sponsor_failure", "broadcast_failure", "chain_abort", "internal_error"];
+export declare const REPLACED_TERMINAL_REASONS: readonly ["nonce_replacement", "superseded"];
+export declare const NOT_FOUND_TERMINAL_REASONS: readonly ["expired", "unknown_payment_identity"];
+export declare const TERMINAL_REASONS: readonly ["invalid_transaction", "not_sponsored", "sender_nonce_stale", "sender_nonce_gap", "sender_nonce_duplicate", "queue_unavailable", "sponsor_failure", "broadcast_failure", "chain_abort", "internal_error", "nonce_replacement", "superseded", "expired", "unknown_payment_identity"];
+export declare const TERMINAL_REASON_CATEGORIES: readonly ["validation", "sender", "relay", "settlement", "replacement", "identity"];
+export declare const FailedTerminalReasonSchema: z.ZodEnum<{
+    invalid_transaction: "invalid_transaction";
+    not_sponsored: "not_sponsored";
+    sender_nonce_stale: "sender_nonce_stale";
+    sender_nonce_gap: "sender_nonce_gap";
+    sender_nonce_duplicate: "sender_nonce_duplicate";
+    queue_unavailable: "queue_unavailable";
+    sponsor_failure: "sponsor_failure";
+    broadcast_failure: "broadcast_failure";
+    chain_abort: "chain_abort";
+    internal_error: "internal_error";
+}>;
+export declare const ReplacedTerminalReasonSchema: z.ZodEnum<{
+    nonce_replacement: "nonce_replacement";
+    superseded: "superseded";
+}>;
+export declare const NotFoundTerminalReasonSchema: z.ZodEnum<{
+    expired: "expired";
+    unknown_payment_identity: "unknown_payment_identity";
+}>;
+export declare const TerminalReasonSchema: z.ZodEnum<{
+    invalid_transaction: "invalid_transaction";
+    not_sponsored: "not_sponsored";
+    sender_nonce_stale: "sender_nonce_stale";
+    sender_nonce_gap: "sender_nonce_gap";
+    sender_nonce_duplicate: "sender_nonce_duplicate";
+    queue_unavailable: "queue_unavailable";
+    sponsor_failure: "sponsor_failure";
+    broadcast_failure: "broadcast_failure";
+    chain_abort: "chain_abort";
+    internal_error: "internal_error";
+    nonce_replacement: "nonce_replacement";
+    superseded: "superseded";
+    expired: "expired";
+    unknown_payment_identity: "unknown_payment_identity";
+}>;
+export declare const TerminalReasonCategorySchema: z.ZodEnum<{
+    validation: "validation";
+    sender: "sender";
+    relay: "relay";
+    settlement: "settlement";
+    replacement: "replacement";
+    identity: "identity";
+}>;
+export declare const TERMINAL_REASON_TO_STATE: {
+    readonly invalid_transaction: "failed";
+    readonly not_sponsored: "failed";
+    readonly sender_nonce_stale: "failed";
+    readonly sender_nonce_gap: "failed";
+    readonly sender_nonce_duplicate: "failed";
+    readonly queue_unavailable: "failed";
+    readonly sponsor_failure: "failed";
+    readonly broadcast_failure: "failed";
+    readonly chain_abort: "failed";
+    readonly internal_error: "failed";
+    readonly nonce_replacement: "replaced";
+    readonly superseded: "replaced";
+    readonly expired: "not_found";
+    readonly unknown_payment_identity: "not_found";
+};
+export declare const paymentTerminalStateByReason: {
+    readonly invalid_transaction: "failed";
+    readonly not_sponsored: "failed";
+    readonly sender_nonce_stale: "failed";
+    readonly sender_nonce_gap: "failed";
+    readonly sender_nonce_duplicate: "failed";
+    readonly queue_unavailable: "failed";
+    readonly sponsor_failure: "failed";
+    readonly broadcast_failure: "failed";
+    readonly chain_abort: "failed";
+    readonly internal_error: "failed";
+    readonly nonce_replacement: "replaced";
+    readonly superseded: "replaced";
+    readonly expired: "not_found";
+    readonly unknown_payment_identity: "not_found";
+};
+export declare const TERMINAL_REASON_TO_CATEGORY: {
+    readonly invalid_transaction: "validation";
+    readonly not_sponsored: "validation";
+    readonly sender_nonce_stale: "sender";
+    readonly sender_nonce_gap: "sender";
+    readonly sender_nonce_duplicate: "sender";
+    readonly queue_unavailable: "relay";
+    readonly sponsor_failure: "relay";
+    readonly internal_error: "relay";
+    readonly broadcast_failure: "settlement";
+    readonly chain_abort: "settlement";
+    readonly nonce_replacement: "replacement";
+    readonly superseded: "replacement";
+    readonly expired: "identity";
+    readonly unknown_payment_identity: "identity";
+};
+export declare const paymentTerminalReasonCategoryByReason: {
+    readonly invalid_transaction: "validation";
+    readonly not_sponsored: "validation";
+    readonly sender_nonce_stale: "sender";
+    readonly sender_nonce_gap: "sender";
+    readonly sender_nonce_duplicate: "sender";
+    readonly queue_unavailable: "relay";
+    readonly sponsor_failure: "relay";
+    readonly internal_error: "relay";
+    readonly broadcast_failure: "settlement";
+    readonly chain_abort: "settlement";
+    readonly nonce_replacement: "replacement";
+    readonly superseded: "replacement";
+    readonly expired: "identity";
+    readonly unknown_payment_identity: "identity";
+};
+export declare const TerminalReasonDetailSchema: z.ZodObject<{
+    reason: z.ZodEnum<{
+        invalid_transaction: "invalid_transaction";
+        not_sponsored: "not_sponsored";
+        sender_nonce_stale: "sender_nonce_stale";
+        sender_nonce_gap: "sender_nonce_gap";
+        sender_nonce_duplicate: "sender_nonce_duplicate";
+        queue_unavailable: "queue_unavailable";
+        sponsor_failure: "sponsor_failure";
+        broadcast_failure: "broadcast_failure";
+        chain_abort: "chain_abort";
+        internal_error: "internal_error";
+        nonce_replacement: "nonce_replacement";
+        superseded: "superseded";
+        expired: "expired";
+        unknown_payment_identity: "unknown_payment_identity";
+    }>;
+    category: z.ZodEnum<{
+        validation: "validation";
+        sender: "sender";
+        relay: "relay";
+        settlement: "settlement";
+        replacement: "replacement";
+        identity: "identity";
+    }>;
+    terminalState: z.ZodEnum<{
+        failed: "failed";
+        replaced: "replaced";
+        not_found: "not_found";
+    }>;
+    code: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FailedTerminalReason = z.infer<typeof FailedTerminalReasonSchema>;
+export type ReplacedTerminalReason = z.infer<typeof ReplacedTerminalReasonSchema>;
+export type NotFoundTerminalReason = z.infer<typeof NotFoundTerminalReasonSchema>;
+export type TerminalReason = z.infer<typeof TerminalReasonSchema>;
+export type TerminalReasonCategory = z.infer<typeof TerminalReasonCategorySchema>;
+//# sourceMappingURL=terminal-reasons.d.ts.map

package/dist/core/terminal-reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-reasons.d.ts","sourceRoot":"","sources":["../../src/core/terminal-reasons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB,qNAW1B,CAAC;AAEX,eAAO,MAAM,yBAAyB,8CAG5B,CAAC;AAEX,eAAO,MAAM,0BAA0B,kDAG7B,CAAC;AAEX,eAAO,MAAM,gBAAgB,+RAInB,CAAC;AAEX,eAAO,MAAM,0BAA0B,qFAO7B,CAAC;AAEX,eAAO,MAAM,0BAA0B;;;;;;;;;;;EAAkC,CAAC;AAC1E,eAAO,MAAM,4BAA4B;;;EAAoC,CAAC;AAC9E,eAAO,MAAM,4BAA4B;;;EAAqC,CAAC;AAC/E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAA2B,CAAC;AAC7D,eAAO,MAAM,4BAA4B;;;;;;;EAAqC,CAAC;AAE/E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;CAe3B,CAAC;AAEX,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;CAA2B,CAAC;AAErE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;CAemE,CAAC;AAE5G,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;CAA8B,CAAC;AAEjF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/core/terminal-reasons.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+export const FAILED_TERMINAL_REASONS = [
+    "invalid_transaction",
+    "not_sponsored",
+    "sender_nonce_stale",
+    "sender_nonce_gap",
+    "sender_nonce_duplicate",
+    "queue_unavailable",
+    "sponsor_failure",
+    "broadcast_failure",
+    "chain_abort",
+    "internal_error",
+];
+export const REPLACED_TERMINAL_REASONS = [
+    "nonce_replacement",
+    "superseded",
+];
+export const NOT_FOUND_TERMINAL_REASONS = [
+    "expired",
+    "unknown_payment_identity",
+];
+export const TERMINAL_REASONS = [
+    ...FAILED_TERMINAL_REASONS,
+    ...REPLACED_TERMINAL_REASONS,
+    ...NOT_FOUND_TERMINAL_REASONS,
+];
+export const TERMINAL_REASON_CATEGORIES = [
+    "validation",
+    "sender",
+    "relay",
+    "settlement",
+    "replacement",
+    "identity",
+];
+export const FailedTerminalReasonSchema = z.enum(FAILED_TERMINAL_REASONS);
+export const ReplacedTerminalReasonSchema = z.enum(REPLACED_TERMINAL_REASONS);
+export const NotFoundTerminalReasonSchema = z.enum(NOT_FOUND_TERMINAL_REASONS);
+export const TerminalReasonSchema = z.enum(TERMINAL_REASONS);
+export const TerminalReasonCategorySchema = z.enum(TERMINAL_REASON_CATEGORIES);
+export const TERMINAL_REASON_TO_STATE = {
+    invalid_transaction: "failed",
+    not_sponsored: "failed",
+    sender_nonce_stale: "failed",
+    sender_nonce_gap: "failed",
+    sender_nonce_duplicate: "failed",
+    queue_unavailable: "failed",
+    sponsor_failure: "failed",
+    broadcast_failure: "failed",
+    chain_abort: "failed",
+    internal_error: "failed",
+    nonce_replacement: "replaced",
+    superseded: "replaced",
+    expired: "not_found",
+    unknown_payment_identity: "not_found",
+};
+export const paymentTerminalStateByReason = TERMINAL_REASON_TO_STATE;
+export const TERMINAL_REASON_TO_CATEGORY = {
+    invalid_transaction: "validation",
+    not_sponsored: "validation",
+    sender_nonce_stale: "sender",
+    sender_nonce_gap: "sender",
+    sender_nonce_duplicate: "sender",
+    queue_unavailable: "relay",
+    sponsor_failure: "relay",
+    internal_error: "relay",
+    broadcast_failure: "settlement",
+    chain_abort: "settlement",
+    nonce_replacement: "replacement",
+    superseded: "replacement",
+    expired: "identity",
+    unknown_payment_identity: "identity",
+};
+export const paymentTerminalReasonCategoryByReason = TERMINAL_REASON_TO_CATEGORY;
+export const TerminalReasonDetailSchema = z.object({
+    reason: TerminalReasonSchema,
+    category: TerminalReasonCategorySchema,
+    terminalState: z.enum(["failed", "replaced", "not_found"]),
+    code: z.string().min(1).optional(),
+    message: z.string().min(1).optional(),
+    retryable: z.boolean().optional(),
+});
+//# sourceMappingURL=terminal-reasons.js.map

package/dist/core/terminal-reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-reasons.js","sourceRoot":"","sources":["../../src/core/terminal-reasons.ts"],"names":[],"mappings":"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"}

package/dist/http/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schemas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,2 @@
+export * from "./schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}