@strimz/shared-types 0.1.0

package/dist/index.js

@@ -0,0 +1,858 @@
+import { z } from 'zod';
+
+// src/common.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");
+var emailSchema = z.string().email().trim().toLowerCase().max(320);
+var httpsUrlSchema = z.string().url().refine((v) => v.startsWith("https://"), {
+  message: "must be an https:// URL"
+});
+var httpUrlSchema = 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");
+var uintSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var isoTimestampSchema = z.string().datetime({ offset: true, message: "must be an ISO-8601 timestamp" });
+var countryCodeSchema = z.string().length(2).regex(/^[A-Z]{2}$/, "must be an ISO-3166 alpha-2 country code");
+var paginationInputSchema = z.object({
+  limit: z.number().int().min(1).max(100).default(25),
+  cursor: z.string().min(1).max(200).nullish()
+});
+var makePaginatedSchema = (item) => z.object({
+  data: z.array(item),
+  nextCursor: z.string().nullable(),
+  hasMore: z.boolean()
+});
+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({});
+var modeSchema = z.enum(["test", "live"]);
+var paymentCurrencySchema = z.enum(["USDC", "EURC"]);
+var tokenSymbolSchema = z.enum(["USDC", "EURC", "USYC"]);
+var merchantTierSchema = z.enum(["free", "growth", "business", "enterprise"]);
+var arcEnvironmentSchema = z.enum(["testnet", "mainnet"]);
+var merchantStatusSchema = z.enum(["active", "suspended", "closed"]);
+var merchantRoleSchema = z.enum(["owner", "admin", "developer", "read_only"]);
+var merchantSchema = z.object({
+  id: idSchema,
+  onchainMerchantId: z.number().int().nonnegative().nullable(),
+  businessName: z.string().min(2).max(120),
+  email: emailSchema,
+  tier: merchantTierSchema,
+  status: merchantStatusSchema,
+  payoutAddress: evmAddressSchema.nullable(),
+  defaultCurrency: z.enum(["USDC", "EURC"]),
+  countryCode: z.string().length(2).nullable(),
+  websiteUrl: z.string().url().nullable(),
+  logoUrl: z.string().url().nullable(),
+  whitelabelEnabled: z.boolean(),
+  metadata: metadataSchema,
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createMerchantInputSchema = z.object({
+  businessName: z.string().min(2).max(120),
+  email: emailSchema,
+  password: z.string().min(12).max(128),
+  countryCode: z.string().length(2).optional(),
+  websiteUrl: z.string().url().optional()
+});
+var updateMerchantInputSchema = z.object({
+  businessName: z.string().min(2).max(120),
+  payoutAddress: evmAddressSchema,
+  defaultCurrency: z.enum(["USDC", "EURC"]),
+  websiteUrl: z.string().url().nullable(),
+  logoUrl: z.string().url().nullable(),
+  countryCode: z.string().length(2).nullable(),
+  metadata: metadataSchema
+}).partial();
+var changeTierInputSchema = z.object({
+  tier: merchantTierSchema
+});
+var merchantMemberSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  email: emailSchema,
+  role: merchantRoleSchema,
+  invitedAt: isoTimestampSchema,
+  acceptedAt: isoTimestampSchema.nullable()
+});
+var inviteMemberInputSchema = z.object({
+  email: emailSchema,
+  role: merchantRoleSchema
+});
+var loginInputSchema = z.object({
+  email: emailSchema,
+  password: z.string().min(1).max(128)
+});
+var loginOutputSchema = z.object({
+  accessToken: z.string(),
+  refreshToken: z.string(),
+  merchant: merchantSchema
+});
+var apiKeyKindSchema = z.enum(["secret", "publishable"]);
+var apiKeyScopeSchema = z.enum([
+  "sessions_read",
+  "sessions_write",
+  "subscriptions_read",
+  "subscriptions_write",
+  "refunds_read",
+  "refunds_write",
+  "transactions_read",
+  "webhooks_read",
+  "webhooks_write",
+  "invoices_read",
+  "invoices_write",
+  "storefronts_read",
+  "storefronts_write",
+  "agents_read",
+  "agents_write",
+  // Meta-tx relayer — submitting payer-signed EIP-3009 / EIP-2612
+  // authorizations on the merchant's behalf. Granted to keys used by
+  // hosted checkout and merchants embedding the SDK.
+  "relay_read",
+  "relay_write"
+]);
+var apiKeySchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  name: z.string().min(1).max(60),
+  kind: apiKeyKindSchema,
+  mode: modeSchema,
+  prefix: z.string().min(8).max(24),
+  lastFour: z.string().length(4),
+  scopes: z.array(apiKeyScopeSchema).nonempty(),
+  createdAt: isoTimestampSchema,
+  lastUsedAt: isoTimestampSchema.nullable(),
+  revokedAt: isoTimestampSchema.nullable()
+});
+var createApiKeyInputSchema = z.object({
+  name: z.string().min(1).max(60),
+  kind: apiKeyKindSchema,
+  mode: modeSchema,
+  scopes: z.array(apiKeyScopeSchema).nonempty()
+});
+var createApiKeyOutputSchema = z.object({
+  apiKey: apiKeySchema,
+  /** Full plaintext key — shown exactly once. */
+  secret: z.string()
+});
+var rotateApiKeyInputSchema = z.object({
+  id: idSchema
+});
+var customerSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  walletAddress: evmAddressSchema,
+  email: emailSchema.nullable(),
+  /** Merchant-provided external identifier (e.g. their own user id). */
+  externalRef: z.string().min(1).max(120).nullable(),
+  displayName: z.string().min(1).max(120).nullable(),
+  metadata: metadataSchema,
+  firstSeenAt: isoTimestampSchema,
+  lastSeenAt: isoTimestampSchema
+});
+var upsertCustomerInputSchema = z.object({
+  walletAddress: evmAddressSchema,
+  email: emailSchema.optional(),
+  externalRef: z.string().min(1).max(120).optional(),
+  displayName: z.string().min(1).max(120).optional(),
+  metadata: metadataSchema.optional()
+});
+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
+});
+var transactionKindSchema = z.enum([
+  "one_shot",
+  "subscription_charge",
+  "refund",
+  "invoice_payment",
+  "storefront_purchase"
+]);
+var transactionStatusSchema = z.enum(["pending", "confirmed", "failed"]);
+var transactionSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  kind: transactionKindSchema,
+  status: transactionStatusSchema,
+  sessionId: idSchema.nullable(),
+  subscriptionId: idSchema.nullable(),
+  subscriptionChargeId: idSchema.nullable(),
+  refundId: idSchema.nullable(),
+  customerId: idSchema.nullable(),
+  amount: tokenAmountSchema,
+  feeAmount: tokenAmountSchema,
+  netAmount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  payerAddress: evmAddressSchema,
+  merchantAddress: evmAddressSchema,
+  onchainTxHash: evmTxHashSchema,
+  blockNumber: z.number().int().nonnegative(),
+  blockTimestamp: isoTimestampSchema,
+  createdAt: isoTimestampSchema
+});
+var subscriptionIntervalSchema = z.enum([
+  "daily",
+  "weekly",
+  "monthly",
+  "quarterly",
+  "yearly"
+]);
+var subscriptionPlanStatusSchema = z.enum(["active", "archived"]);
+var subscriptionPlanSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  /**
+   * On-chain StrimzRegistry merchant id (uint96) as a decimal string.
+   * See `paymentSessionSchema.chainMerchantId`. Null when the merchant
+   * hasn't been registered on-chain yet — the hosted enrolment page
+   * refuses to take signatures in that state.
+   */
+  chainMerchantId: z.string().regex(/^[0-9]+$/u, "must be a non-negative decimal integer string").nullable(),
+  /**
+   * ERC-20 token contract address resolved from `currency` — the
+   * EIP-2612 `verifyingContract` the wallet signs over.
+   */
+  tokenAddress: evmAddressSchema.nullable(),
+  /**
+   * Charge cadence in seconds, derived from `interval` + `intervalCount`
+   * so the meta-tx layer can pass a uint32 to StrimzSubscriptions
+   * without re-deriving the conversion on the client.
+   */
+  intervalSeconds: z.number().int().positive(),
+  name: z.string().min(1).max(120),
+  description: z.string().max(500).nullable(),
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  interval: subscriptionIntervalSchema,
+  intervalCount: z.number().int().min(1).max(365),
+  trialPeriodDays: z.number().int().min(0).max(365).nullable(),
+  status: subscriptionPlanStatusSchema,
+  metadata: metadataSchema,
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createSubscriptionPlanInputSchema = z.object({
+  name: z.string().min(1).max(120),
+  description: z.string().max(500).optional(),
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  interval: subscriptionIntervalSchema,
+  intervalCount: z.number().int().min(1).max(365).default(1),
+  trialPeriodDays: z.number().int().min(0).max(365).optional(),
+  metadata: metadataSchema.optional()
+});
+var subscriptionStatusSchema = z.enum([
+  "trialing",
+  "active",
+  "at_risk",
+  "paused",
+  "cancelled",
+  "lapsed"
+]);
+var subscriptionSchema = z.object({
+  id: idSchema,
+  onchainSubscriptionId: z.number().int().nonnegative().nullable(),
+  merchantId: idSchema,
+  customerId: idSchema,
+  planId: idSchema,
+  status: subscriptionStatusSchema,
+  payerAddress: evmAddressSchema,
+  currency: paymentCurrencySchema,
+  amount: tokenAmountSchema,
+  interval: subscriptionIntervalSchema,
+  intervalCount: z.number().int().min(1),
+  trialEndsAt: isoTimestampSchema.nullable(),
+  currentPeriodStartAt: isoTimestampSchema,
+  currentPeriodEndAt: isoTimestampSchema,
+  nextChargeAt: isoTimestampSchema.nullable(),
+  gracePeriodHours: z.number().int().min(0).max(72),
+  cancelledAt: isoTimestampSchema.nullable(),
+  metadata: metadataSchema,
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createSubscriptionInputSchema = z.object({
+  planId: idSchema,
+  customer: z.object({
+    walletAddress: evmAddressSchema,
+    email: z.string().email().optional(),
+    externalRef: z.string().max(120).optional()
+  }),
+  gracePeriodHours: z.union([z.literal(24), z.literal(48), z.literal(72)]).default(48),
+  metadata: metadataSchema.optional()
+});
+var cancelSubscriptionInputSchema = z.object({
+  id: idSchema,
+  reason: z.string().max(500).optional()
+});
+var subscriptionChargeOutcomeSchema = z.enum([
+  "charged",
+  "insufficient_funds",
+  "revoked_approval",
+  "cancelled",
+  "skipped"
+]);
+var subscriptionChargeStatusSchema = z.enum([
+  "pending",
+  "in_flight",
+  "succeeded",
+  "failed",
+  "retrying",
+  "abandoned"
+]);
+var subscriptionChargeSchema = z.object({
+  id: idSchema,
+  subscriptionId: idSchema,
+  merchantId: idSchema,
+  chargeAttemptId: z.string().length(66, "must be a 32-byte 0x-prefixed hex string"),
+  periodStartAt: isoTimestampSchema,
+  periodEndAt: isoTimestampSchema,
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  status: subscriptionChargeStatusSchema,
+  outcome: subscriptionChargeOutcomeSchema.nullable(),
+  attemptNumber: z.number().int().min(1),
+  scheduledAt: isoTimestampSchema,
+  executedAt: isoTimestampSchema.nullable(),
+  onchainTxHash: evmTxHashSchema.nullable(),
+  failureReason: z.string().max(500).nullable(),
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var refundReasonSchema = z.enum([
+  "customer_request",
+  "product_issue",
+  "duplicate_charge",
+  "fraudulent",
+  "other"
+]);
+var refundStatusSchema = z.enum([
+  "pending",
+  "awaiting_signature",
+  "submitted",
+  "completed",
+  "failed",
+  "cancelled"
+]);
+var refundSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  transactionId: idSchema,
+  amount: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  reason: refundReasonSchema,
+  note: z.string().max(500).nullable(),
+  status: refundStatusSchema,
+  payerAddress: evmAddressSchema,
+  refundTxHash: evmTxHashSchema.nullable(),
+  failureReason: z.string().max(500).nullable(),
+  initiatedBy: idSchema,
+  createdAt: isoTimestampSchema,
+  completedAt: isoTimestampSchema.nullable()
+});
+var createRefundInputSchema = z.object({
+  transactionId: idSchema,
+  amount: tokenAmountSchema,
+  reason: refundReasonSchema,
+  note: z.string().max(500).optional()
+});
+var submitRefundSignatureInputSchema = z.object({
+  id: idSchema,
+  refundTxHash: evmTxHashSchema
+});
+var webhookEventNameSchema = z.enum([
+  "payment.created",
+  "payment.completed",
+  "payment.failed",
+  "subscription.created",
+  "subscription.charged",
+  "subscription.charge_failed",
+  "subscription.recovery_attempt",
+  "subscription.recovery_outcome",
+  "subscription.cancelled",
+  "subscription.lapsed",
+  "refund.created",
+  "refund.completed",
+  "refund.failed",
+  "invoice.created",
+  "invoice.paid",
+  "invoice.overdue",
+  "agent.action_executed",
+  "agent.job_proposed",
+  "agent.job_completed",
+  "agent.job_disputed",
+  "compliance.wallet_flagged",
+  "compliance.wallet_blocked"
+]);
+var webhookEndpointStatusSchema = z.enum(["active", "disabled"]);
+var webhookEndpointSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  mode: modeSchema,
+  url: httpsUrlSchema,
+  description: z.string().max(200).nullable(),
+  events: z.array(webhookEventNameSchema).nonempty(),
+  status: webhookEndpointStatusSchema,
+  signingSecretPrefix: z.string().min(4).max(12),
+  lastDeliveredAt: isoTimestampSchema.nullable(),
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createWebhookEndpointInputSchema = z.object({
+  url: httpsUrlSchema,
+  events: z.array(webhookEventNameSchema).nonempty(),
+  description: z.string().max(200).optional(),
+  mode: modeSchema
+});
+var createWebhookEndpointOutputSchema = z.object({
+  endpoint: webhookEndpointSchema,
+  /** Full signing secret — shown exactly once. */
+  signingSecret: z.string()
+});
+var webhookDeliveryStatusSchema = z.enum([
+  "pending",
+  "delivered",
+  "retrying",
+  "permanently_failed"
+]);
+var webhookDeliverySchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  endpointId: idSchema,
+  eventId: idSchema,
+  eventName: webhookEventNameSchema,
+  status: webhookDeliveryStatusSchema,
+  attempt: z.number().int().min(1).max(6),
+  responseCode: z.number().int().min(100).max(599).nullable(),
+  responseMs: z.number().int().min(0).nullable(),
+  lastError: z.string().max(1e3).nullable(),
+  nextAttemptAt: isoTimestampSchema.nullable(),
+  deliveredAt: isoTimestampSchema.nullable(),
+  createdAt: isoTimestampSchema
+});
+var replayDeliveryInputSchema = z.object({
+  id: idSchema
+});
+var complianceProviderSchema = z.enum(["trm", "elliptic", "disabled"]);
+var complianceStatusSchema = z.enum(["clear", "flagged", "blocked", "error"]);
+var complianceScreeningContextSchema = z.enum([
+  "merchant_onboarding",
+  "payer_checkout",
+  "subscriber_signup",
+  "refund_recipient"
+]);
+var complianceLogSchema = z.object({
+  id: idSchema,
+  walletAddress: evmAddressSchema,
+  provider: complianceProviderSchema,
+  status: complianceStatusSchema,
+  riskScore: z.number().min(0).max(100).nullable(),
+  flags: z.array(z.string().max(120)).default([]),
+  context: complianceScreeningContextSchema,
+  merchantId: idSchema.nullable(),
+  sessionId: idSchema.nullable(),
+  subscriptionId: idSchema.nullable(),
+  providerRequestId: z.string().max(200).nullable(),
+  createdAt: isoTimestampSchema
+});
+var agentIdentitySchema = z.object({
+  id: idSchema,
+  /** ERC-8004 on-chain identity address. */
+  onchainAddress: evmAddressSchema,
+  /** Public key or agent credential digest, as emitted by ERC-8004. */
+  credentialDigest: z.string().regex(/^0x[a-fA-F0-9]+$/),
+  name: z.string().min(1).max(120),
+  version: z.string().min(1).max(40),
+  reputationScore: z.number().min(0).max(100).nullable(),
+  registeredAt: isoTimestampSchema
+});
+var agentCapabilitySchema = z.enum([
+  "identity",
+  "recovery",
+  "routing",
+  "cashflow",
+  "commerce",
+  "pricing_intelligence"
+]);
+var agentMerchantConfigSchema = z.object({
+  merchantId: idSchema,
+  enabledCapabilities: z.array(agentCapabilitySchema).default([]),
+  recovery: z.object({
+    gracePeriodHours: z.union([z.literal(24), z.literal(48), z.literal(72)]).default(48),
+    strategy: z.enum(["once", "twice", "until_grace_ends"]).default("twice"),
+    notificationTemplate: z.string().max(2e3).nullable()
+  }),
+  cashflow: z.object({
+    digestEnabled: z.boolean().default(false),
+    anomalySensitivity: z.enum(["low", "medium", "high"]).default("medium"),
+    autoConvertToYield: z.boolean().default(false),
+    minimumLiquidReserveCents: z.number().int().nonnegative().default(1e5)
+  }),
+  commerce: z.object({
+    requireHumanApprovalAboveUsdCents: z.number().int().nonnegative().default(1e5),
+    approvedVendors: z.array(evmAddressSchema).default([]),
+    monthlySpendCapUsdCents: z.number().int().nonnegative().nullable()
+  }),
+  updatedAt: isoTimestampSchema
+});
+var updateAgentConfigInputSchema = agentMerchantConfigSchema.omit({ merchantId: true, updatedAt: true }).partial();
+var agentActionTypeSchema = z.enum([
+  "recovery_notification_sent",
+  "recovery_retry_scheduled",
+  "recovery_retry_executed",
+  "recovery_abandoned",
+  "routing_bridge_initiated",
+  "routing_payment_completed",
+  "cashflow_digest_sent",
+  "cashflow_anomaly_flagged",
+  "cashflow_yield_converted",
+  "commerce_job_created",
+  "commerce_job_approved",
+  "commerce_job_completed",
+  "commerce_job_disputed"
+]);
+var agentActionOutcomeSchema = z.enum(["success", "failure", "pending", "skipped"]);
+var agentActivityLogSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  capability: agentCapabilitySchema,
+  actionType: agentActionTypeSchema,
+  outcome: agentActionOutcomeSchema,
+  subscriptionId: idSchema.nullable(),
+  transactionId: idSchema.nullable(),
+  jobId: idSchema.nullable(),
+  metadata: metadataSchema,
+  createdAt: isoTimestampSchema
+});
+var agentJobStatusSchema = z.enum([
+  "proposed",
+  "accepted",
+  "in_progress",
+  "delivered",
+  "approved",
+  "completed",
+  "disputed",
+  "cancelled"
+]);
+var agentJobSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  /** On-chain job id from StrimzAgentEscrow. */
+  onchainJobId: z.number().int().nonnegative().nullable(),
+  vendorAddress: evmAddressSchema,
+  description: z.string().min(1).max(2e3),
+  amount: tokenAmountSchema,
+  currency: z.enum(["USDC", "EURC"]),
+  status: agentJobStatusSchema,
+  assessorAddress: evmAddressSchema,
+  deliverableHash: z.string().regex(/^0x[a-fA-F0-9]+$/).nullable(),
+  escrowTxHash: evmTxHashSchema.nullable(),
+  releaseTxHash: evmTxHashSchema.nullable(),
+  createdAt: isoTimestampSchema,
+  completedAt: isoTimestampSchema.nullable()
+});
+var createAgentJobInputSchema = z.object({
+  vendorAddress: evmAddressSchema,
+  description: z.string().min(1).max(2e3),
+  amount: tokenAmountSchema,
+  currency: z.enum(["USDC", "EURC"]),
+  assessorAddress: evmAddressSchema.optional()
+});
+var storefrontStatusSchema = z.enum(["draft", "published", "archived"]);
+var storefrontSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  slug: z.string().min(3).max(40).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "slug must be lowercase alphanumeric with hyphens"),
+  name: z.string().min(2).max(120),
+  description: z.string().max(2e3).nullable(),
+  logoUrl: httpsUrlSchema.nullable(),
+  coverImageUrl: httpsUrlSchema.nullable(),
+  accentColor: z.string().regex(/^#[0-9a-fA-F]{6}$/).nullable(),
+  socialLinks: z.array(httpsUrlSchema).max(10).default([]),
+  status: storefrontStatusSchema,
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createStorefrontInputSchema = storefrontSchema.pick({
+  slug: true,
+  name: true,
+  description: true,
+  logoUrl: true,
+  coverImageUrl: true,
+  accentColor: true,
+  socialLinks: true
+});
+var storefrontProductTypeSchema = z.enum(["one_time", "subscription"]);
+var storefrontProductSchema = z.object({
+  id: idSchema,
+  storefrontId: idSchema,
+  name: z.string().min(1).max(120),
+  description: z.string().max(2e3).nullable(),
+  imageUrl: httpsUrlSchema.nullable(),
+  price: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  type: storefrontProductTypeSchema,
+  interval: subscriptionIntervalSchema.nullable(),
+  intervalCount: z.number().int().min(1).max(365).nullable(),
+  /** null = unlimited stock. */
+  stock: z.number().int().min(0).nullable(),
+  planId: idSchema.nullable(),
+  isActive: z.boolean(),
+  sortOrder: z.number().int().nonnegative().default(0),
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createStorefrontProductInputSchema = storefrontProductSchema.omit({
+  id: true,
+  storefrontId: true,
+  planId: true,
+  createdAt: true,
+  updatedAt: true
+}).extend({
+  imageUrl: httpsUrlSchema.optional()
+});
+var invoiceStatusSchema = z.enum(["draft", "sent", "paid", "overdue", "void"]);
+var invoiceLineItemSchema = z.object({
+  description: z.string().min(1).max(500),
+  quantity: z.number().int().min(1).max(1e4),
+  unitAmount: tokenAmountSchema
+});
+var invoiceSchema = z.object({
+  id: idSchema,
+  merchantId: idSchema,
+  number: z.string().min(1).max(40),
+  customerName: z.string().min(1).max(200).nullable(),
+  customerEmail: emailSchema.nullable(),
+  lineItems: z.array(invoiceLineItemSchema).nonempty(),
+  subtotal: tokenAmountSchema,
+  total: tokenAmountSchema,
+  currency: paymentCurrencySchema,
+  status: invoiceStatusSchema,
+  note: z.string().max(2e3).nullable(),
+  sessionId: idSchema.nullable(),
+  dueAt: isoTimestampSchema,
+  paidAt: isoTimestampSchema.nullable(),
+  sentAt: isoTimestampSchema.nullable(),
+  createdAt: isoTimestampSchema,
+  updatedAt: isoTimestampSchema
+});
+var createInvoiceInputSchema = z.object({
+  customerName: z.string().min(1).max(200).optional(),
+  customerEmail: emailSchema.optional(),
+  lineItems: z.array(invoiceLineItemSchema).nonempty(),
+  currency: paymentCurrencySchema,
+  note: z.string().max(2e3).optional(),
+  dueInDays: z.number().int().min(1).max(90).default(7)
+});
+var envelope = (name, data) => z.object({
+  id: idSchema,
+  type: z.literal(name),
+  apiVersion: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  mode: modeSchema,
+  createdAt: isoTimestampSchema,
+  data
+});
+var paymentCreatedEventSchema = envelope("payment.created", paymentSessionSchema);
+var paymentCompletedEventSchema = envelope(
+  "payment.completed",
+  z.object({ session: paymentSessionSchema, transaction: transactionSchema })
+);
+var paymentFailedEventSchema = envelope(
+  "payment.failed",
+  z.object({ session: paymentSessionSchema, reason: z.string() })
+);
+var subscriptionCreatedEventSchema = envelope("subscription.created", subscriptionSchema);
+var subscriptionChargedEventSchema = envelope(
+  "subscription.charged",
+  z.object({
+    subscription: subscriptionSchema,
+    charge: subscriptionChargeSchema,
+    transaction: transactionSchema
+  })
+);
+var subscriptionChargeFailedEventSchema = envelope(
+  "subscription.charge_failed",
+  z.object({ subscription: subscriptionSchema, charge: subscriptionChargeSchema })
+);
+var subscriptionRecoveryAttemptEventSchema = envelope(
+  "subscription.recovery_attempt",
+  z.object({ subscription: subscriptionSchema, attemptNumber: z.number().int().min(1) })
+);
+var subscriptionRecoveryOutcomeEventSchema = envelope(
+  "subscription.recovery_outcome",
+  z.object({
+    subscription: subscriptionSchema,
+    outcome: z.enum(["recovered", "churned"])
+  })
+);
+var subscriptionCancelledEventSchema = envelope(
+  "subscription.cancelled",
+  subscriptionSchema
+);
+var subscriptionLapsedEventSchema = envelope("subscription.lapsed", subscriptionSchema);
+var refundCreatedEventSchema = envelope("refund.created", refundSchema);
+var refundCompletedEventSchema = envelope(
+  "refund.completed",
+  z.object({ refund: refundSchema, transaction: transactionSchema })
+);
+var refundFailedEventSchema = envelope(
+  "refund.failed",
+  z.object({ refund: refundSchema, reason: z.string() })
+);
+var invoiceCreatedEventSchema = envelope("invoice.created", invoiceSchema);
+var invoicePaidEventSchema = envelope(
+  "invoice.paid",
+  z.object({ invoice: invoiceSchema, transaction: transactionSchema })
+);
+var invoiceOverdueEventSchema = envelope("invoice.overdue", invoiceSchema);
+var agentActionExecutedEventSchema = envelope(
+  "agent.action_executed",
+  agentActivityLogSchema
+);
+var agentJobProposedEventSchema = envelope("agent.job_proposed", agentJobSchema);
+var agentJobCompletedEventSchema = envelope("agent.job_completed", agentJobSchema);
+var agentJobDisputedEventSchema = envelope("agent.job_disputed", agentJobSchema);
+var complianceWalletFlaggedEventSchema = envelope(
+  "compliance.wallet_flagged",
+  complianceLogSchema
+);
+var complianceWalletBlockedEventSchema = envelope(
+  "compliance.wallet_blocked",
+  complianceLogSchema
+);
+var webhookEventSchema = z.discriminatedUnion("type", [
+  paymentCreatedEventSchema,
+  paymentCompletedEventSchema,
+  paymentFailedEventSchema,
+  subscriptionCreatedEventSchema,
+  subscriptionChargedEventSchema,
+  subscriptionChargeFailedEventSchema,
+  subscriptionRecoveryAttemptEventSchema,
+  subscriptionRecoveryOutcomeEventSchema,
+  subscriptionCancelledEventSchema,
+  subscriptionLapsedEventSchema,
+  refundCreatedEventSchema,
+  refundCompletedEventSchema,
+  refundFailedEventSchema,
+  invoiceCreatedEventSchema,
+  invoicePaidEventSchema,
+  invoiceOverdueEventSchema,
+  agentActionExecutedEventSchema,
+  agentJobProposedEventSchema,
+  agentJobCompletedEventSchema,
+  agentJobDisputedEventSchema,
+  complianceWalletFlaggedEventSchema,
+  complianceWalletBlockedEventSchema
+]);
+var addressSchema = z.string().regex(/^0x[0-9a-fA-F]{40}$/u, "must be a 0x-prefixed 20-byte address");
+var tokenCapabilitiesSchema = z.object({
+  permit2612: z.boolean(),
+  transferAuth3009: z.boolean()
+});
+var tokenMetadataSchema = z.object({
+  address: addressSchema,
+  name: z.string(),
+  symbol: z.string(),
+  /**
+   * EIP-712 domain version. Read from ERC-5267 `eip712Domain()` when
+   * available; otherwise defaults to "1". Used by typed-data builders
+   * — domain mismatch produces a different digest and the contract's
+   * ecrecover would recover a different address.
+   */
+  version: z.string(),
+  decimals: z.number().int().min(0).max(255),
+  capabilities: tokenCapabilitiesSchema
+});
+var tokenPermitNonceSchema = z.object({
+  token: addressSchema,
+  owner: addressSchema,
+  nonce: z.string().regex(/^[0-9]+$/u, "must be a decimal integer string")
+});
+
+export { agentActionExecutedEventSchema, agentActionOutcomeSchema, agentActionTypeSchema, agentActivityLogSchema, agentCapabilitySchema, agentIdentitySchema, agentJobCompletedEventSchema, agentJobDisputedEventSchema, agentJobProposedEventSchema, agentJobSchema, agentJobStatusSchema, agentMerchantConfigSchema, apiKeyKindSchema, apiKeySchema, apiKeyScopeSchema, arcEnvironmentSchema, cancelSubscriptionInputSchema, changeTierInputSchema, complianceLogSchema, complianceProviderSchema, complianceScreeningContextSchema, complianceStatusSchema, complianceWalletBlockedEventSchema, complianceWalletFlaggedEventSchema, countryCodeSchema, createAgentJobInputSchema, createApiKeyInputSchema, createApiKeyOutputSchema, createInvoiceInputSchema, createMerchantInputSchema, createPaymentSessionInputSchema, createRefundInputSchema, createStorefrontInputSchema, createStorefrontProductInputSchema, createSubscriptionInputSchema, createSubscriptionPlanInputSchema, createWebhookEndpointInputSchema, createWebhookEndpointOutputSchema, customerSchema, emailSchema, evmAddressSchema, evmTxHashSchema, httpUrlSchema, httpsUrlSchema, idSchema, inviteMemberInputSchema, invoiceCreatedEventSchema, invoiceLineItemSchema, invoiceOverdueEventSchema, invoicePaidEventSchema, invoiceSchema, invoiceStatusSchema, isoTimestampSchema, loginInputSchema, loginOutputSchema, makePaginatedSchema, merchantMemberSchema, merchantRoleSchema, merchantSchema, merchantStatusSchema, merchantTierSchema, metadataSchema, modeSchema, paginationInputSchema, paymentCompletedEventSchema, paymentCreatedEventSchema, paymentCurrencySchema, paymentFailedEventSchema, paymentSessionSchema, paymentSessionStatusSchema, refundCompletedEventSchema, refundCreatedEventSchema, refundFailedEventSchema, refundReasonSchema, refundSchema, refundStatusSchema, replayDeliveryInputSchema, rotateApiKeyInputSchema, storefrontProductSchema, storefrontProductTypeSchema, storefrontSchema, storefrontStatusSchema, submitPaymentSessionInputSchema, submitRefundSignatureInputSchema, subscriptionCancelledEventSchema, subscriptionChargeFailedEventSchema, subscriptionChargeOutcomeSchema, subscriptionChargeSchema, subscriptionChargeStatusSchema, subscriptionChargedEventSchema, subscriptionCreatedEventSchema, subscriptionIntervalSchema, subscriptionLapsedEventSchema, subscriptionPlanSchema, subscriptionPlanStatusSchema, subscriptionRecoveryAttemptEventSchema, subscriptionRecoveryOutcomeEventSchema, subscriptionSchema, subscriptionStatusSchema, tokenAmountSchema, tokenCapabilitiesSchema, tokenMetadataSchema, tokenPermitNonceSchema, tokenSymbolSchema, transactionKindSchema, transactionSchema, transactionStatusSchema, uintSchema, updateAgentConfigInputSchema, updateMerchantInputSchema, upsertCustomerInputSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEndpointSchema, webhookEndpointStatusSchema, webhookEventNameSchema, webhookEventSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map