@strimz/shared-types 0.1.0

package/dist/payment-sessions.d.cts

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+
+/**
+ * Payment session — a one-shot checkout intent.
+ *
+ * State machine:
+ *   created → awaiting_payment → submitted → confirmed
+ *                                       \
+ *                                        → failed
+ *                               → expired
+ *                               → cancelled
+ */
+
+declare const paymentSessionStatusSchema: z.ZodEnum<["created", "awaiting_payment", "submitted", "confirmed", "failed", "expired", "cancelled"]>;
+type PaymentSessionStatus = z.infer<typeof paymentSessionStatusSchema>;
+declare const paymentSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    /**
+     * On-chain StrimzRegistry merchant id (uint96) as a decimal string.
+     * Set when the merchant has been registered on-chain; null when the
+     * merchant exists in our DB but the registry transaction hasn't
+     * been broadcast yet. Hosted checkout uses this to populate the
+     * meta-tx calldata; if null, the checkout refuses to accept
+     * payments.
+     */
+    chainMerchantId: z.ZodNullable<z.ZodString>;
+    /**
+     * ERC-20 token contract address resolved from `currency` on the
+     * active chain (Arc Testnet / Mainnet). Used as the `verifyingContract`
+     * in the EIP-712 domain for both EIP-3009 and EIP-2612 signing.
+     * Null on the (vanishingly unlikely) path where the API has no
+     * configured address for the session's currency.
+     */
+    tokenAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    customerId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<["created", "awaiting_payment", "submitted", "confirmed", "failed", "expired", "cancelled"]>;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    feeAmount: z.ZodEffects<z.ZodString, string, string>;
+    netAmount: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodNullable<z.ZodString>;
+    payerWalletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    payerEmail: z.ZodNullable<z.ZodString>;
+    successUrl: z.ZodNullable<z.ZodString>;
+    cancelUrl: z.ZodNullable<z.ZodString>;
+    sourceChain: z.ZodNullable<z.ZodEnum<["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]>>;
+    bridgeTxHash: z.ZodNullable<z.ZodString>;
+    onchainTxHash: z.ZodNullable<z.ZodString>;
+    checkoutUrl: z.ZodString;
+    metadata: z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>;
+    expiresAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "created" | "awaiting_payment" | "submitted" | "confirmed" | "failed" | "expired" | "cancelled";
+    id: string;
+    merchantId: string;
+    createdAt: string;
+    metadata: Record<string, string | number | boolean | null>;
+    chainMerchantId: string | null;
+    tokenAddress: string | null;
+    customerId: string | null;
+    amount: string;
+    currency: "USDC" | "EURC";
+    feeAmount: string;
+    netAmount: string;
+    description: string | null;
+    payerWalletAddress: string | null;
+    payerEmail: string | null;
+    successUrl: string | null;
+    cancelUrl: string | null;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana" | null;
+    bridgeTxHash: string | null;
+    onchainTxHash: string | null;
+    checkoutUrl: string;
+    expiresAt: string;
+    updatedAt: string;
+}, {
+    status: "created" | "awaiting_payment" | "submitted" | "confirmed" | "failed" | "expired" | "cancelled";
+    id: string;
+    merchantId: string;
+    createdAt: string;
+    chainMerchantId: string | null;
+    tokenAddress: string | null;
+    customerId: string | null;
+    amount: string;
+    currency: "USDC" | "EURC";
+    feeAmount: string;
+    netAmount: string;
+    description: string | null;
+    payerWalletAddress: string | null;
+    payerEmail: string | null;
+    successUrl: string | null;
+    cancelUrl: string | null;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana" | null;
+    bridgeTxHash: string | null;
+    onchainTxHash: string | null;
+    checkoutUrl: string;
+    expiresAt: string;
+    updatedAt: string;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+}>;
+type PaymentSession = z.infer<typeof paymentSessionSchema>;
+declare const createPaymentSessionInputSchema: z.ZodObject<{
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    description: z.ZodOptional<z.ZodString>;
+    customer: z.ZodOptional<z.ZodObject<{
+        walletAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        email: z.ZodOptional<z.ZodString>;
+        externalRef: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    }, {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    }>>;
+    successUrl: z.ZodOptional<z.ZodString>;
+    cancelUrl: z.ZodOptional<z.ZodString>;
+    /** Minutes until the session expires. Default 30, max 60*24 (one day). */
+    expiresInMinutes: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Allowed source chains a payer can bridge USDC from via CCTP. Omit to
+     * accept every CCTP-supported chain.
+     */
+    supportedSourceChains: z.ZodOptional<z.ZodArray<z.ZodEnum<["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]>, "many">>;
+    metadata: z.ZodOptional<z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    currency: "USDC" | "EURC";
+    expiresInMinutes: number;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+    description?: string | undefined;
+    successUrl?: string | undefined;
+    cancelUrl?: string | undefined;
+    customer?: {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    } | undefined;
+    supportedSourceChains?: ("arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana")[] | undefined;
+}, {
+    amount: string;
+    currency: "USDC" | "EURC";
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+    description?: string | undefined;
+    successUrl?: string | undefined;
+    cancelUrl?: string | undefined;
+    customer?: {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    } | undefined;
+    expiresInMinutes?: number | undefined;
+    supportedSourceChains?: ("arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana")[] | undefined;
+}>;
+type CreatePaymentSessionInput = z.infer<typeof createPaymentSessionInputSchema>;
+declare const submitPaymentSessionInputSchema: z.ZodObject<{
+    sourceChain: z.ZodEnum<["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]>;
+    onchainTxHash: z.ZodString;
+    bridgeTxHash: z.ZodOptional<z.ZodString>;
+    payerWalletAddress: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    payerWalletAddress: string;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana";
+    onchainTxHash: string;
+    bridgeTxHash?: string | undefined;
+}, {
+    payerWalletAddress: string;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana";
+    onchainTxHash: string;
+    bridgeTxHash?: string | undefined;
+}>;
+type SubmitPaymentSessionInput = z.infer<typeof submitPaymentSessionInputSchema>;
+
+export { type CreatePaymentSessionInput, type PaymentSession, type PaymentSessionStatus, type SubmitPaymentSessionInput, createPaymentSessionInputSchema, paymentSessionSchema, paymentSessionStatusSchema, submitPaymentSessionInputSchema };

package/dist/payment-sessions.d.ts

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+
+/**
+ * Payment session — a one-shot checkout intent.
+ *
+ * State machine:
+ *   created → awaiting_payment → submitted → confirmed
+ *                                       \
+ *                                        → failed
+ *                               → expired
+ *                               → cancelled
+ */
+
+declare const paymentSessionStatusSchema: z.ZodEnum<["created", "awaiting_payment", "submitted", "confirmed", "failed", "expired", "cancelled"]>;
+type PaymentSessionStatus = z.infer<typeof paymentSessionStatusSchema>;
+declare const paymentSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    merchantId: z.ZodString;
+    /**
+     * On-chain StrimzRegistry merchant id (uint96) as a decimal string.
+     * Set when the merchant has been registered on-chain; null when the
+     * merchant exists in our DB but the registry transaction hasn't
+     * been broadcast yet. Hosted checkout uses this to populate the
+     * meta-tx calldata; if null, the checkout refuses to accept
+     * payments.
+     */
+    chainMerchantId: z.ZodNullable<z.ZodString>;
+    /**
+     * ERC-20 token contract address resolved from `currency` on the
+     * active chain (Arc Testnet / Mainnet). Used as the `verifyingContract`
+     * in the EIP-712 domain for both EIP-3009 and EIP-2612 signing.
+     * Null on the (vanishingly unlikely) path where the API has no
+     * configured address for the session's currency.
+     */
+    tokenAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    customerId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<["created", "awaiting_payment", "submitted", "confirmed", "failed", "expired", "cancelled"]>;
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    feeAmount: z.ZodEffects<z.ZodString, string, string>;
+    netAmount: z.ZodEffects<z.ZodString, string, string>;
+    description: z.ZodNullable<z.ZodString>;
+    payerWalletAddress: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    payerEmail: z.ZodNullable<z.ZodString>;
+    successUrl: z.ZodNullable<z.ZodString>;
+    cancelUrl: z.ZodNullable<z.ZodString>;
+    sourceChain: z.ZodNullable<z.ZodEnum<["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]>>;
+    bridgeTxHash: z.ZodNullable<z.ZodString>;
+    onchainTxHash: z.ZodNullable<z.ZodString>;
+    checkoutUrl: z.ZodString;
+    metadata: z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>;
+    expiresAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "created" | "awaiting_payment" | "submitted" | "confirmed" | "failed" | "expired" | "cancelled";
+    id: string;
+    merchantId: string;
+    createdAt: string;
+    metadata: Record<string, string | number | boolean | null>;
+    chainMerchantId: string | null;
+    tokenAddress: string | null;
+    customerId: string | null;
+    amount: string;
+    currency: "USDC" | "EURC";
+    feeAmount: string;
+    netAmount: string;
+    description: string | null;
+    payerWalletAddress: string | null;
+    payerEmail: string | null;
+    successUrl: string | null;
+    cancelUrl: string | null;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana" | null;
+    bridgeTxHash: string | null;
+    onchainTxHash: string | null;
+    checkoutUrl: string;
+    expiresAt: string;
+    updatedAt: string;
+}, {
+    status: "created" | "awaiting_payment" | "submitted" | "confirmed" | "failed" | "expired" | "cancelled";
+    id: string;
+    merchantId: string;
+    createdAt: string;
+    chainMerchantId: string | null;
+    tokenAddress: string | null;
+    customerId: string | null;
+    amount: string;
+    currency: "USDC" | "EURC";
+    feeAmount: string;
+    netAmount: string;
+    description: string | null;
+    payerWalletAddress: string | null;
+    payerEmail: string | null;
+    successUrl: string | null;
+    cancelUrl: string | null;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana" | null;
+    bridgeTxHash: string | null;
+    onchainTxHash: string | null;
+    checkoutUrl: string;
+    expiresAt: string;
+    updatedAt: string;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+}>;
+type PaymentSession = z.infer<typeof paymentSessionSchema>;
+declare const createPaymentSessionInputSchema: z.ZodObject<{
+    amount: z.ZodEffects<z.ZodString, string, string>;
+    currency: z.ZodEnum<["USDC", "EURC"]>;
+    description: z.ZodOptional<z.ZodString>;
+    customer: z.ZodOptional<z.ZodObject<{
+        walletAddress: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        email: z.ZodOptional<z.ZodString>;
+        externalRef: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    }, {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    }>>;
+    successUrl: z.ZodOptional<z.ZodString>;
+    cancelUrl: z.ZodOptional<z.ZodString>;
+    /** Minutes until the session expires. Default 30, max 60*24 (one day). */
+    expiresInMinutes: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Allowed source chains a payer can bridge USDC from via CCTP. Omit to
+     * accept every CCTP-supported chain.
+     */
+    supportedSourceChains: z.ZodOptional<z.ZodArray<z.ZodEnum<["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]>, "many">>;
+    metadata: z.ZodOptional<z.ZodDefault<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    currency: "USDC" | "EURC";
+    expiresInMinutes: number;
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+    description?: string | undefined;
+    successUrl?: string | undefined;
+    cancelUrl?: string | undefined;
+    customer?: {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    } | undefined;
+    supportedSourceChains?: ("arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana")[] | undefined;
+}, {
+    amount: string;
+    currency: "USDC" | "EURC";
+    metadata?: Record<string, string | number | boolean | null> | undefined;
+    description?: string | undefined;
+    successUrl?: string | undefined;
+    cancelUrl?: string | undefined;
+    customer?: {
+        walletAddress?: string | undefined;
+        email?: string | undefined;
+        externalRef?: string | undefined;
+    } | undefined;
+    expiresInMinutes?: number | undefined;
+    supportedSourceChains?: ("arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana")[] | undefined;
+}>;
+type CreatePaymentSessionInput = z.infer<typeof createPaymentSessionInputSchema>;
+declare const submitPaymentSessionInputSchema: z.ZodObject<{
+    sourceChain: z.ZodEnum<["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]>;
+    onchainTxHash: z.ZodString;
+    bridgeTxHash: z.ZodOptional<z.ZodString>;
+    payerWalletAddress: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    payerWalletAddress: string;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana";
+    onchainTxHash: string;
+    bridgeTxHash?: string | undefined;
+}, {
+    payerWalletAddress: string;
+    sourceChain: "arc" | "ethereum" | "base" | "polygon" | "arbitrum" | "optimism" | "avalanche" | "solana";
+    onchainTxHash: string;
+    bridgeTxHash?: string | undefined;
+}>;
+type SubmitPaymentSessionInput = z.infer<typeof submitPaymentSessionInputSchema>;
+
+export { type CreatePaymentSessionInput, type PaymentSession, type PaymentSessionStatus, type SubmitPaymentSessionInput, createPaymentSessionInputSchema, paymentSessionSchema, paymentSessionStatusSchema, submitPaymentSessionInputSchema };

package/dist/payment-sessions.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+
+// src/payment-sessions.ts
+var idSchema = z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "id must be URL-safe");
+var evmAddressSchema = z.string().regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 40-character hex EVM address").transform((v) => v.toLowerCase());
+var evmTxHashSchema = z.string().regex(/^0x[a-fA-F0-9]{64}$/, "must be a 0x-prefixed 64-character hex EVM transaction hash");
+z.string().email().trim().toLowerCase().max(320);
+z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+z.string().url();
+var tokenAmountSchema = z.string().regex(/^[0-9]+$/, "must be a non-negative integer string (base-10)").refine((v) => BigInt(v) >= 0n, "must be >= 0");
+z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var isoTimestampSchema = z.string().datetime({ offset: true, message: "must be an ISO-8601 timestamp" });
+z.string().length(2).regex(/^[A-Z]{2}$/, "must be an ISO-3166 alpha-2 country code");
+z.object({
+  limit: z.number().int().min(1).max(100).default(25),
+  cursor: z.string().min(1).max(200).nullish()
+});
+var metadataSchema = z.record(
+  z.string().min(1).max(40),
+  z.union([z.string().max(500), z.number(), z.boolean(), z.null()])
+).refine((m) => Object.keys(m).length <= 50, "at most 50 metadata keys").default({});
+z.enum(["test", "live"]);
+var paymentCurrencySchema = z.enum(["USDC", "EURC"]);
+z.enum(["USDC", "EURC", "USYC"]);
+z.enum(["free", "growth", "business", "enterprise"]);
+z.enum(["testnet", "mainnet"]);
+
+// src/payment-sessions.ts
+var paymentSessionStatusSchema = z.enum([
+  "created",
+  "awaiting_payment",
+  "submitted",
+  "confirmed",
+  "failed",
+  "expired",
+  "cancelled"
+]);
+var paymentSessionSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  /**
+   * On-chain StrimzRegistry merchant id (uint96) as a decimal string.
+   * Set when the merchant has been registered on-chain; null when the
+   * merchant exists in our DB but the registry transaction hasn't
+   * been broadcast yet. Hosted checkout uses this to populate the
+   * meta-tx calldata; if null, the checkout refuses to accept
+   * payments.
+   */
+  chainMerchantId: z.string().regex(/^[0-9]+$/u, "must be a non-negative decimal integer string").nullable(),
+  /**
+   * ERC-20 token contract address resolved from `currency` on the
+   * active chain (Arc Testnet / Mainnet). Used as the `verifyingContract`
+   * in the EIP-712 domain for both EIP-3009 and EIP-2612 signing.
+   * Null on the (vanishingly unlikely) path where the API has no
+   * configured address for the session's currency.
+   */
+  tokenAddress: evmAddressSchema.nullable(),
+  customerId: idSchema.nullable(),
+  status: paymentSessionStatusSchema,
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  feeAmount: tokenAmountSchema,
+  netAmount: tokenAmountSchema,
+  description: z.string().max(500).nullable(),
+  payerWalletAddress: evmAddressSchema.nullable(),
+  payerEmail: z.string().email().nullable(),
+  successUrl: z.string().url().nullable(),
+  cancelUrl: z.string().url().nullable(),
+  sourceChain: z.enum(["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"]).nullable(),
+  bridgeTxHash: evmTxHashSchema.nullable(),
+  onchainTxHash: evmTxHashSchema.nullable(),
+  checkoutUrl: z.string().url(),
+  metadata: metadataSchema,
+  expiresAt: isoTimestampSchema,
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createPaymentSessionInputSchema = z.object({
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  description: z.string().max(500).optional(),
+  customer: z.object({
+    walletAddress: evmAddressSchema.optional(),
+    email: z.string().email().optional(),
+    externalRef: z.string().max(120).optional()
+  }).optional(),
+  successUrl: z.string().url().optional(),
+  cancelUrl: z.string().url().optional(),
+  /** Minutes until the session expires. Default 30, max 60*24 (one day). */
+  expiresInMinutes: z.number().int().min(1).max(60 * 24).default(30),
+  /**
+   * Allowed source chains a payer can bridge USDC from via CCTP. Omit to
+   * accept every CCTP-supported chain.
+   */
+  supportedSourceChains: z.array(
+    z.enum(["arc", "ethereum", "base", "polygon", "arbitrum", "optimism", "avalanche", "solana"])
+  ).optional(),
+  metadata: metadataSchema.optional()
+});
+var submitPaymentSessionInputSchema = z.object({
+  sourceChain: z.enum([
+    "arc",
+    "ethereum",
+    "base",
+    "polygon",
+    "arbitrum",
+    "optimism",
+    "avalanche",
+    "solana"
+  ]),
+  onchainTxHash: evmTxHashSchema,
+  bridgeTxHash: evmTxHashSchema.optional(),
+  payerWalletAddress: evmAddressSchema
+});
+
+export { createPaymentSessionInputSchema, paymentSessionSchema, paymentSessionStatusSchema, submitPaymentSessionInputSchema };
+//# sourceMappingURL=payment-sessions.js.map
+//# sourceMappingURL=payment-sessions.js.map

package/dist/payment-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common.ts","../src/payment-sessions.ts"],"names":["z"],"mappings":"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","file":"payment-sessions.js","sourcesContent":["/**\n * Primitive schemas shared across every entity.\n * Every higher-level schema builds on these so validation is consistent.\n */\n\nimport { z } from 'zod'\n\n/** CUID2 or UUID-style opaque identifier. */\nexport const idSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-zA-Z0-9_-]+$/, 'id must be URL-safe')\n\n/** EVM address. Hex-encoded, 0x-prefixed, 20 bytes. Normalised to lowercase. */\nexport const evmAddressSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{40}$/, 'must be a 0x-prefixed 40-character hex EVM address')\n  .transform((v) => v.toLowerCase())\n\n/** EVM transaction hash. 32-byte hex. */\nexport const evmTxHashSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{64}$/, 'must be a 0x-prefixed 64-character hex EVM transaction hash')\n\n/** Email address, trimmed and lower-cased. */\nexport const emailSchema = z.string().email().trim().toLowerCase().max(320)\n\n/** HTTPS URL. No http:// allowed outside dev. */\nexport const httpsUrlSchema = z\n  .string()\n  .url()\n  .refine((v) => v.startsWith('https://'), {\n    message: 'must be an https:// URL',\n  })\n\n/** URL permitting http and https (dev + prod). */\nexport const httpUrlSchema = z.string().url()\n\n/**\n * Amount expressed in the token's smallest unit, serialised as a string to\n * preserve precision beyond `Number.MAX_SAFE_INTEGER`. For USDC (6 decimals),\n * 1 USDC is the string \"1000000\".\n */\nexport const tokenAmountSchema = z\n  .string()\n  .regex(/^[0-9]+$/, 'must be a non-negative integer string (base-10)')\n  .refine((v) => BigInt(v) >= 0n, 'must be >= 0')\n\n/** Unsigned integer up to 2^53 - 1; validated and returned as number. */\nexport const uintSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER)\n\n/** ISO-8601 timestamp string (`.toISOString()`-compatible). */\nexport const isoTimestampSchema = z\n  .string()\n  .datetime({ offset: true, message: 'must be an ISO-8601 timestamp' })\n\n/** Two-letter ISO-3166 country code. */\nexport const countryCodeSchema = z\n  .string()\n  .length(2)\n  .regex(/^[A-Z]{2}$/, 'must be an ISO-3166 alpha-2 country code')\n\n/** Pagination inputs used by every list endpoint. */\nexport const paginationInputSchema = z.object({\n  limit: z.number().int().min(1).max(100).default(25),\n  cursor: z.string().min(1).max(200).nullish(),\n})\nexport type PaginationInput = z.infer<typeof paginationInputSchema>\n\n/** Pagination envelope used by every list response. */\nexport const makePaginatedSchema = <T extends z.ZodTypeAny>(item: T) =>\n  z.object({\n    data: z.array(item),\n    nextCursor: z.string().nullable(),\n    hasMore: z.boolean(),\n  })\n\n/** Free-form metadata bag the API round-trips for merchants. */\nexport const metadataSchema = z\n  .record(\n    z.string().min(1).max(40),\n    z.union([z.string().max(500), z.number(), z.boolean(), z.null()]),\n  )\n  .refine((m) => Object.keys(m).length <= 50, 'at most 50 metadata keys')\n  .default({})\n\n/** Environment mode carried on every mode-scoped resource. */\nexport const modeSchema = z.enum(['test', 'live'])\nexport type Mode = z.infer<typeof modeSchema>\n\n/** Payment token enum — mirrors `@strimz/shared-config`. */\nexport const paymentCurrencySchema = z.enum(['USDC', 'EURC'])\nexport type PaymentCurrency = z.infer<typeof paymentCurrencySchema>\n\n/** Every display-level currency (payment + treasury). */\nexport const tokenSymbolSchema = z.enum(['USDC', 'EURC', 'USYC'])\nexport type TokenSymbol = z.infer<typeof tokenSymbolSchema>\n\n/** Merchant tier enum — mirrors `@strimz/shared-config`. */\nexport const merchantTierSchema = z.enum(['free', 'growth', 'business', 'enterprise'])\nexport type MerchantTier = z.infer<typeof merchantTierSchema>\n\n/** Arc environment enum. */\nexport const arcEnvironmentSchema = z.enum(['testnet', 'mainnet'])\nexport type ArcEnvironment = z.infer<typeof arcEnvironmentSchema>\n\nexport type Id = z.infer<typeof idSchema>\nexport type EvmAddress = z.infer<typeof evmAddressSchema>\nexport type EvmTxHash = z.infer<typeof evmTxHashSchema>\nexport type TokenAmount = z.infer<typeof tokenAmountSchema>\nexport type IsoTimestamp = z.infer<typeof isoTimestampSchema>\nexport type Metadata = z.infer<typeof metadataSchema>\n","/**\n * Payment session — a one-shot checkout intent.\n *\n * State machine:\n *   created → awaiting_payment → submitted → confirmed\n *                                       \\\n *                                        → failed\n *                               → expired\n *                               → cancelled\n */\n\nimport { z } from 'zod'\nimport {\n  evmAddressSchema,\n  evmTxHashSchema,\n  idSchema,\n  isoTimestampSchema,\n  metadataSchema,\n  paymentCurrencySchema,\n  tokenAmountSchema,\n} from './common.js'\n\nexport const paymentSessionStatusSchema = z.enum([\n  'created',\n  'awaiting_payment',\n  'submitted',\n  'confirmed',\n  'failed',\n  'expired',\n  'cancelled',\n])\nexport type PaymentSessionStatus = z.infer<typeof paymentSessionStatusSchema>\n\nexport const paymentSessionSchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  /**\n   * On-chain StrimzRegistry merchant id (uint96) as a decimal string.\n   * Set when the merchant has been registered on-chain; null when the\n   * merchant exists in our DB but the registry transaction hasn't\n   * been broadcast yet. Hosted checkout uses this to populate the\n   * meta-tx calldata; if null, the checkout refuses to accept\n   * payments.\n   */\n  chainMerchantId: z\n    .string()\n    .regex(/^[0-9]+$/u, 'must be a non-negative decimal integer string')\n    .nullable(),\n  /**\n   * ERC-20 token contract address resolved from `currency` on the\n   * active chain (Arc Testnet / Mainnet). Used as the `verifyingContract`\n   * in the EIP-712 domain for both EIP-3009 and EIP-2612 signing.\n   * Null on the (vanishingly unlikely) path where the API has no\n   * configured address for the session's currency.\n   */\n  tokenAddress: evmAddressSchema.nullable(),\n  customerId: idSchema.nullable(),\n  status: paymentSessionStatusSchema,\n  amount: tokenAmountSchema,\n  currency: paymentCurrencySchema,\n  feeAmount: tokenAmountSchema,\n  netAmount: tokenAmountSchema,\n  description: z.string().max(500).nullable(),\n  payerWalletAddress: evmAddressSchema.nullable(),\n  payerEmail: z.string().email().nullable(),\n  successUrl: z.string().url().nullable(),\n  cancelUrl: z.string().url().nullable(),\n  sourceChain: z\n    .enum(['arc', 'ethereum', 'base', 'polygon', 'arbitrum', 'optimism', 'avalanche', 'solana'])\n    .nullable(),\n  bridgeTxHash: evmTxHashSchema.nullable(),\n  onchainTxHash: evmTxHashSchema.nullable(),\n  checkoutUrl: z.string().url(),\n  metadata: metadataSchema,\n  expiresAt: isoTimestampSchema,\n  createdAt: isoTimestampSchema,\n  updatedAt: isoTimestampSchema,\n})\nexport type PaymentSession = z.infer<typeof paymentSessionSchema>\n\n// ---------- DTOs ----------\n\nexport const createPaymentSessionInputSchema = z.object({\n  amount: tokenAmountSchema,\n  currency: paymentCurrencySchema,\n  description: z.string().max(500).optional(),\n  customer: z\n    .object({\n      walletAddress: evmAddressSchema.optional(),\n      email: z.string().email().optional(),\n      externalRef: z.string().max(120).optional(),\n    })\n    .optional(),\n  successUrl: z.string().url().optional(),\n  cancelUrl: z.string().url().optional(),\n  /** Minutes until the session expires. Default 30, max 60*24 (one day). */\n  expiresInMinutes: z\n    .number()\n    .int()\n    .min(1)\n    .max(60 * 24)\n    .default(30),\n  /**\n   * Allowed source chains a payer can bridge USDC from via CCTP. Omit to\n   * accept every CCTP-supported chain.\n   */\n  supportedSourceChains: z\n    .array(\n      z.enum(['arc', 'ethereum', 'base', 'polygon', 'arbitrum', 'optimism', 'avalanche', 'solana']),\n    )\n    .optional(),\n  metadata: metadataSchema.optional(),\n})\nexport type CreatePaymentSessionInput = z.infer<typeof createPaymentSessionInputSchema>\n\nexport const submitPaymentSessionInputSchema = z.object({\n  sourceChain: z.enum([\n    'arc',\n    'ethereum',\n    'base',\n    'polygon',\n    'arbitrum',\n    'optimism',\n    'avalanche',\n    'solana',\n  ]),\n  onchainTxHash: evmTxHashSchema,\n  bridgeTxHash: evmTxHashSchema.optional(),\n  payerWalletAddress: evmAddressSchema,\n})\nexport type SubmitPaymentSessionInput = z.infer<typeof submitPaymentSessionInputSchema>\n"]}

package/dist/refunds.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/refunds.ts
+var idSchema = zod.z.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "id must be URL-safe");
+var evmAddressSchema = zod.z.string().regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 40-character hex EVM address").transform((v) => v.toLowerCase());
+var evmTxHashSchema = zod.z.string().regex(/^0x[a-fA-F0-9]{64}$/, "must be a 0x-prefixed 64-character hex EVM transaction hash");
+zod.z.string().email().trim().toLowerCase().max(320);
+zod.z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+zod.z.string().url();
+var tokenAmountSchema = zod.z.string().regex(/^[0-9]+$/, "must be a non-negative integer string (base-10)").refine((v) => BigInt(v) >= 0n, "must be >= 0");
+zod.z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var isoTimestampSchema = zod.z.string().datetime({ offset: true, message: "must be an ISO-8601 timestamp" });
+zod.z.string().length(2).regex(/^[A-Z]{2}$/, "must be an ISO-3166 alpha-2 country code");
+zod.z.object({
+  limit: zod.z.number().int().min(1).max(100).default(25),
+  cursor: zod.z.string().min(1).max(200).nullish()
+});
+zod.z.record(
+  zod.z.string().min(1).max(40),
+  zod.z.union([zod.z.string().max(500), zod.z.number(), zod.z.boolean(), zod.z.null()])
+).refine((m) => Object.keys(m).length <= 50, "at most 50 metadata keys").default({});
+zod.z.enum(["test", "live"]);
+var paymentCurrencySchema = zod.z.enum(["USDC", "EURC"]);
+zod.z.enum(["USDC", "EURC", "USYC"]);
+zod.z.enum(["free", "growth", "business", "enterprise"]);
+zod.z.enum(["testnet", "mainnet"]);
+
+// src/refunds.ts
+var refundReasonSchema = zod.z.enum([
+  "customer_request",
+  "product_issue",
+  "duplicate_charge",
+  "fraudulent",
+  "other"
+]);
+var refundStatusSchema = zod.z.enum([
+  "pending",
+  "awaiting_signature",
+  "submitted",
+  "completed",
+  "failed",
+  "cancelled"
+]);
+var refundSchema = zod.z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  transactionId: idSchema,
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  reason: refundReasonSchema,
+  note: zod.z.string().max(500).nullable(),
+  status: refundStatusSchema,
+  payerAddress: evmAddressSchema,
+  refundTxHash: evmTxHashSchema.nullable(),
+  failureReason: zod.z.string().max(500).nullable(),
+  initiatedBy: idSchema,
+  createdAt: isoTimestampSchema,
+  completedAt: isoTimestampSchema.nullable()
+});
+var createRefundInputSchema = zod.z.object({
+  transactionId: idSchema,
+  amount: tokenAmountSchema,
+  reason: refundReasonSchema,
+  note: zod.z.string().max(500).optional()
+});
+var submitRefundSignatureInputSchema = zod.z.object({
+  id: idSchema,
+  refundTxHash: evmTxHashSchema
+});
+
+exports.createRefundInputSchema = createRefundInputSchema;
+exports.refundReasonSchema = refundReasonSchema;
+exports.refundSchema = refundSchema;
+exports.refundStatusSchema = refundStatusSchema;
+exports.submitRefundSignatureInputSchema = submitRefundSignatureInputSchema;
+//# sourceMappingURL=refunds.cjs.map
+//# sourceMappingURL=refunds.cjs.map

package/dist/refunds.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common.ts","../src/refunds.ts"],"names":["z"],"mappings":"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","file":"refunds.cjs","sourcesContent":["/**\n * Primitive schemas shared across every entity.\n * Every higher-level schema builds on these so validation is consistent.\n */\n\nimport { z } from 'zod'\n\n/** CUID2 or UUID-style opaque identifier. */\nexport const idSchema = z\n  .string()\n  .min(1)\n  .max(64)\n  .regex(/^[a-zA-Z0-9_-]+$/, 'id must be URL-safe')\n\n/** EVM address. Hex-encoded, 0x-prefixed, 20 bytes. Normalised to lowercase. */\nexport const evmAddressSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{40}$/, 'must be a 0x-prefixed 40-character hex EVM address')\n  .transform((v) => v.toLowerCase())\n\n/** EVM transaction hash. 32-byte hex. */\nexport const evmTxHashSchema = z\n  .string()\n  .regex(/^0x[a-fA-F0-9]{64}$/, 'must be a 0x-prefixed 64-character hex EVM transaction hash')\n\n/** Email address, trimmed and lower-cased. */\nexport const emailSchema = z.string().email().trim().toLowerCase().max(320)\n\n/** HTTPS URL. No http:// allowed outside dev. */\nexport const httpsUrlSchema = z\n  .string()\n  .url()\n  .refine((v) => v.startsWith('https://'), {\n    message: 'must be an https:// URL',\n  })\n\n/** URL permitting http and https (dev + prod). */\nexport const httpUrlSchema = z.string().url()\n\n/**\n * Amount expressed in the token's smallest unit, serialised as a string to\n * preserve precision beyond `Number.MAX_SAFE_INTEGER`. For USDC (6 decimals),\n * 1 USDC is the string \"1000000\".\n */\nexport const tokenAmountSchema = z\n  .string()\n  .regex(/^[0-9]+$/, 'must be a non-negative integer string (base-10)')\n  .refine((v) => BigInt(v) >= 0n, 'must be >= 0')\n\n/** Unsigned integer up to 2^53 - 1; validated and returned as number. */\nexport const uintSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER)\n\n/** ISO-8601 timestamp string (`.toISOString()`-compatible). */\nexport const isoTimestampSchema = z\n  .string()\n  .datetime({ offset: true, message: 'must be an ISO-8601 timestamp' })\n\n/** Two-letter ISO-3166 country code. */\nexport const countryCodeSchema = z\n  .string()\n  .length(2)\n  .regex(/^[A-Z]{2}$/, 'must be an ISO-3166 alpha-2 country code')\n\n/** Pagination inputs used by every list endpoint. */\nexport const paginationInputSchema = z.object({\n  limit: z.number().int().min(1).max(100).default(25),\n  cursor: z.string().min(1).max(200).nullish(),\n})\nexport type PaginationInput = z.infer<typeof paginationInputSchema>\n\n/** Pagination envelope used by every list response. */\nexport const makePaginatedSchema = <T extends z.ZodTypeAny>(item: T) =>\n  z.object({\n    data: z.array(item),\n    nextCursor: z.string().nullable(),\n    hasMore: z.boolean(),\n  })\n\n/** Free-form metadata bag the API round-trips for merchants. */\nexport const metadataSchema = z\n  .record(\n    z.string().min(1).max(40),\n    z.union([z.string().max(500), z.number(), z.boolean(), z.null()]),\n  )\n  .refine((m) => Object.keys(m).length <= 50, 'at most 50 metadata keys')\n  .default({})\n\n/** Environment mode carried on every mode-scoped resource. */\nexport const modeSchema = z.enum(['test', 'live'])\nexport type Mode = z.infer<typeof modeSchema>\n\n/** Payment token enum — mirrors `@strimz/shared-config`. */\nexport const paymentCurrencySchema = z.enum(['USDC', 'EURC'])\nexport type PaymentCurrency = z.infer<typeof paymentCurrencySchema>\n\n/** Every display-level currency (payment + treasury). */\nexport const tokenSymbolSchema = z.enum(['USDC', 'EURC', 'USYC'])\nexport type TokenSymbol = z.infer<typeof tokenSymbolSchema>\n\n/** Merchant tier enum — mirrors `@strimz/shared-config`. */\nexport const merchantTierSchema = z.enum(['free', 'growth', 'business', 'enterprise'])\nexport type MerchantTier = z.infer<typeof merchantTierSchema>\n\n/** Arc environment enum. */\nexport const arcEnvironmentSchema = z.enum(['testnet', 'mainnet'])\nexport type ArcEnvironment = z.infer<typeof arcEnvironmentSchema>\n\nexport type Id = z.infer<typeof idSchema>\nexport type EvmAddress = z.infer<typeof evmAddressSchema>\nexport type EvmTxHash = z.infer<typeof evmTxHashSchema>\nexport type TokenAmount = z.infer<typeof tokenAmountSchema>\nexport type IsoTimestamp = z.infer<typeof isoTimestampSchema>\nexport type Metadata = z.infer<typeof metadataSchema>\n","/**\n * Refund — a merchant-initiated return of funds to a payer.\n *\n * Refunds are executed off-chain (from the merchant's wallet to the payer's\n * wallet). Strimz records the intent, validates constraints, and reconciles\n * via the merchant-signed on-chain transfer.\n */\n\nimport { z } from 'zod'\nimport {\n  evmAddressSchema,\n  evmTxHashSchema,\n  idSchema,\n  isoTimestampSchema,\n  paymentCurrencySchema,\n  tokenAmountSchema,\n} from './common.js'\n\nexport const refundReasonSchema = z.enum([\n  'customer_request',\n  'product_issue',\n  'duplicate_charge',\n  'fraudulent',\n  'other',\n])\nexport type RefundReason = z.infer<typeof refundReasonSchema>\n\nexport const refundStatusSchema = z.enum([\n  'pending',\n  'awaiting_signature',\n  'submitted',\n  'completed',\n  'failed',\n  'cancelled',\n])\nexport type RefundStatus = z.infer<typeof refundStatusSchema>\n\nexport const refundSchema = z.object({\n  id: idSchema,\n  merchantId: idSchema,\n  transactionId: idSchema,\n  amount: tokenAmountSchema,\n  currency: paymentCurrencySchema,\n  reason: refundReasonSchema,\n  note: z.string().max(500).nullable(),\n  status: refundStatusSchema,\n  payerAddress: evmAddressSchema,\n  refundTxHash: evmTxHashSchema.nullable(),\n  failureReason: z.string().max(500).nullable(),\n  initiatedBy: idSchema,\n  createdAt: isoTimestampSchema,\n  completedAt: isoTimestampSchema.nullable(),\n})\nexport type Refund = z.infer<typeof refundSchema>\n\nexport const createRefundInputSchema = z.object({\n  transactionId: idSchema,\n  amount: tokenAmountSchema,\n  reason: refundReasonSchema,\n  note: z.string().max(500).optional(),\n})\nexport type CreateRefundInput = z.infer<typeof createRefundInputSchema>\n\nexport const submitRefundSignatureInputSchema = z.object({\n  id: idSchema,\n  refundTxHash: evmTxHashSchema,\n})\nexport type SubmitRefundSignatureInput = z.infer<typeof submitRefundSignatureInputSchema>\n"]}