@zkp2p/pay-shared 0.0.1 → 1.0.0

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { PayCryptoTokenSymbol } from './crypto.js';
 export declare const PaymentPlatform: {
     readonly VENMO: "venmo";
     readonly CASHAPP: "cashapp";
@@ -7,6 +8,7 @@ export declare const PaymentPlatform: {
     readonly PAYPAL: "paypal";
     readonly MONZO: "monzo";
     readonly N26: "n26";
+    readonly CHIME: "chime";
 };
 export type PaymentPlatformType = typeof PaymentPlatform[keyof typeof PaymentPlatform];
 export declare const SupportedChains: Record<number, string>;
@@ -39,14 +41,238 @@ export declare const SessionStatus: {
     readonly CREATED: "CREATED";
     readonly ACTIVE: "ACTIVE";
     readonly COMPLETED: "COMPLETED";
+    readonly FAILED: "FAILED";
+    readonly REFUNDED: "REFUNDED";
     readonly EXPIRED: "EXPIRED";
     readonly CANCELLED: "CANCELLED";
 };
 export type SessionStatusType = typeof SessionStatus[keyof typeof SessionStatus];
+export declare const CheckoutMethod: {
+    readonly FIAT: "fiat";
+    readonly CRYPTO: "crypto";
+};
+export type CheckoutMethodType = typeof CheckoutMethod[keyof typeof CheckoutMethod];
+export declare const FeePayer: {
+    readonly MERCHANT: "MERCHANT";
+    readonly PAYEE: "PAYEE";
+};
+export type FeePayerType = typeof FeePayer[keyof typeof FeePayer];
+export declare const CheckoutOrderStatus: {
+    readonly CREATED: "CREATED";
+    readonly PARTIALLY_FULFILLED: "PARTIALLY_FULFILLED";
+    readonly FULFILLED: "FULFILLED";
+    readonly CANCELLED: "CANCELLED";
+};
+export type CheckoutOrderStatusType = typeof CheckoutOrderStatus[keyof typeof CheckoutOrderStatus];
+export declare const CheckoutPaymentStatus: {
+    readonly CREATED: "CREATED";
+    readonly SETTLED: "SETTLED";
+    readonly CANCELLED: "CANCELLED";
+    readonly EXPIRED: "EXPIRED";
+    readonly FAILED: "FAILED";
+};
+export type CheckoutPaymentStatusType = typeof CheckoutPaymentStatus[keyof typeof CheckoutPaymentStatus];
+export type ReferralFeeEntry = {
+    recipient: string;
+    feeBps: number;
+};
+export type ReferralSplitConfig = ReferralFeeEntry[];
+export type SettlementReferralFeeEntry = {
+    recipient: string;
+    feeUsdc: string;
+};
+type CreateOrderRequestBase = {
+    destinationAddress?: string;
+    destinationToken?: string;
+    destinationChainId?: number;
+    feePayer?: FeePayerType;
+    enabledRails?: string[];
+    successUrl?: string | null;
+    cancelUrl?: string | null;
+    notes?: Record<string, unknown> | null;
+};
+type CreateOrderRequestWithUsdc = CreateOrderRequestBase & {
+    requestedUsdcAmount: string;
+    requestedFiatAmount?: never;
+    requestedFiatCurrency?: never;
+};
+type CreateOrderRequestWithFiat = CreateOrderRequestBase & {
+    requestedUsdcAmount?: never;
+    requestedFiatAmount: string;
+    requestedFiatCurrency: string;
+};
+export type CreateOrderRequest = CreateOrderRequestWithUsdc | CreateOrderRequestWithFiat;
+export type CheckoutRequest = CreateOrderRequest;
+export type MerchantCheckoutTheme = {
+    presetName?: 'default' | 'dark' | 'light' | 'custom';
+    pageBackgroundColor?: string | null;
+    panelBackgroundColor?: string | null;
+    panelTextColor?: string | null;
+    panelTextMutedColor?: string | null;
+    panelAccentColor?: string | null;
+    panelBorderColor?: string | null;
+    buttonBackgroundColor?: string | null;
+    buttonTextColor?: string | null;
+    defaultMaxFeePercentage?: number;
+    payWithCryptoEnabled?: boolean;
+    [key: string]: unknown;
+};
+export type CheckoutMerchant = {
+    id: string;
+    name: string;
+    logoUrl: string | null;
+    environment: MerchantEnvironmentType;
+    disableBranding: boolean;
+    checkoutTheme: MerchantCheckoutTheme | null;
+    defaultPaymentCurrency?: string | null;
+};
+export type CheckoutOrder = {
+    id: string;
+    merchantId: string;
+    status: CheckoutOrderStatusType;
+    requestedUsdcAmount: string;
+    remainingUsdcAmount: string;
+    destinationAddress: string;
+    destinationToken: string;
+    destinationChainId: string;
+    feePayer: FeePayerType;
+    enabledRails: string[];
+    successUrl: string | null;
+    cancelUrl: string | null;
+    notes: unknown | null;
+    metadata: unknown | null;
+    bridgeInfo?: OrderBridgeInfo | null;
+    referralSplitConfig: ReferralSplitConfig | null;
+    cancelledAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+};
+export type CheckoutPaymentQuote = {
+    conversionRate?: string;
+    signalIntent: {
+        processorName: string;
+        depositId: string;
+        amount: string;
+        toAddress: string;
+        escrowAddress?: string;
+        fiatCurrencyCode?: string;
+        payeeDetails: string;
+    };
+    maker?: {
+        depositData: Record<string, string>;
+    };
+    intentHash?: string;
+};
+export type CheckoutQuote = {
+    displayAmount: string;
+    spreadPercentage: number;
+};
+export type CheckoutQuoteEntry = {
+    platform: string;
+    displayAmount: string;
+    spreadPercentage: number;
+};
+export type CheckoutQuotes = {
+    orderId: string;
+    fiatCurrency: string;
+    platforms: CheckoutQuoteEntry[];
+};
+export type CheckoutPayment = {
+    id: string;
+    orderId: string;
+    status: CheckoutPaymentStatusType;
+    rail: string;
+    currency: string;
+    payTo: string;
+    quote: CheckoutPaymentQuote;
+    quoteExpiresAt: string;
+    paymentAmount: string;
+    currencyPerUsdRate: string;
+    netSettledUsdcAmount: string | null;
+    totalUsdcFeeAmount: string;
+    referralFees: SettlementReferralFeeEntry[] | null;
+    railIdentifier: string | null;
+    fulfillTransaction: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+};
+export type CheckoutAggregate = {
+    order: CheckoutOrder;
+    merchant: CheckoutMerchant;
+    currentPayment: CheckoutPayment | null;
+};
+export type CreateOrderResponse = {
+    order: CheckoutOrder;
+    orderToken: string;
+};
+export type CreateCheckoutResponse = CreateOrderResponse;
+export type CheckoutCreateResponse = CreateOrderResponse;
+export type CreatePaymentRequest = {
+    rail: string;
+    fiatCurrency?: string;
+    currency?: string;
+    replacementPaymentId?: string;
+    quoteLimit?: number;
+    excludedPayToValues?: string[];
+};
+export type CheckoutPaymentCreationResponse = CheckoutPayment & {
+    relayerTransactionId?: string;
+};
+export type PaymentDeeplinkResponse = {
+    paymentId: string;
+    orderId: string;
+    intentHash: string;
+    url: string;
+    proofSubmissionUrl: string;
+    checkoutReturnUrl: string;
+};
+export type CheckoutDeeplinkResponse = PaymentDeeplinkResponse;
+export type MerchantConfig = {
+    id: string;
+    merchantId: string;
+    feePayer: FeePayerType;
+    enabledRails: string[];
+    defaultPaymentCurrency: string | null;
+    destinationChainId: string;
+    destinationToken: string;
+    sweepEnabled: boolean;
+    recipientOverrideEnabled: boolean;
+    disableBranding: boolean;
+    merchantCheckoutTheme: MerchantCheckoutTheme;
+    platformReferralFeeConfig: ReferralFeeConfig | null;
+    referralSplitConfig: ReferralSplitConfig | null;
+    createdAt: string;
+    updatedAt: string | null;
+};
+export type MerchantUser = {
+    id: string;
+    email: string | null;
+    privyUserId: string;
+    role: 'OWNER' | 'MANAGER';
+    merchantId: string | null;
+    createdAt: string;
+    updatedAt: string | null;
+};
+export type MerchantProfile = {
+    id: string;
+    name: string;
+    logoUrl: string | null;
+    apiKey: string;
+    environment: MerchantEnvironmentType;
+    sandboxMerchantId: string | null;
+    evmWalletAddress: string | null;
+    solanaWalletAddress: string | null;
+    tier: 'FREE' | 'PRO';
+    createdAt: string;
+    updatedAt: string | null;
+    merchantConfig: MerchantConfig | null;
+    merchantUsers: MerchantUser[];
+};
 export declare const OrderErrorCode: {
     readonly PROOF_INVALID: "PROOF_INVALID";
     readonly PROOF_EXPIRED: "PROOF_EXPIRED";
-    readonly PROOF_AMOUNT_MISMATCH: "PROOF_AMOUNT_MISMATCH";
     readonly PROOF_RECIPIENT_MISMATCH: "PROOF_RECIPIENT_MISMATCH";
     readonly FULFILL_TIMEOUT: "FULFILL_TIMEOUT";
     readonly FULFILL_REVERTED: "FULFILL_REVERTED";
@@ -55,7 +281,6 @@ export declare const OrderErrorCode: {
     readonly RPC_ERROR: "RPC_ERROR";
     readonly RELAYER_ERROR: "RELAYER_ERROR";
     readonly ATTESTATION_ERROR: "ATTESTATION_ERROR";
-    readonly BRIDGE_QUOTE_ERROR: "BRIDGE_QUOTE_ERROR";
     readonly BRIDGE_TIMEOUT: "BRIDGE_TIMEOUT";
     readonly FEE_THRESHOLD_EXCEEDED: "FEE_THRESHOLD_EXCEEDED";
     readonly SDK_ERROR: "SDK_ERROR";
@@ -67,6 +292,38 @@ export declare const MerchantEnvironment: {
     readonly SANDBOX: "SANDBOX";
 };
 export type MerchantEnvironmentType = typeof MerchantEnvironment[keyof typeof MerchantEnvironment];
+export declare const TrancheCurrency: {
+    readonly USD: "USD";
+    readonly USDC: "USDC";
+};
+export type TrancheCurrencyType = typeof TrancheCurrency[keyof typeof TrancheCurrency];
+export type FeeTranche = {
+    min: number;
+    max: number | null;
+    value: number;
+};
+export type ReferralFeeConfig = {
+    mode: 'default';
+} | {
+    mode: 'exempt';
+} | {
+    mode: 'flat';
+    currency: 'USDC';
+    valueBps: number;
+} | {
+    mode: 'tranches';
+    currency: 'USDC';
+    tranches: FeeTranche[];
+};
+export type MaxFeeConfig = {
+    mode: 'flat';
+    currency: 'USD';
+    valuePercentage: number;
+} | {
+    mode: 'tranches';
+    currency: 'USD';
+    tranches: FeeTranche[];
+};
 export type Merchant = {
     id: string;
     name: string;
@@ -75,13 +332,18 @@ export type Merchant = {
     apiKey: string;
     environment?: MerchantEnvironmentType;
     sandboxMerchantId?: string | null;
+    privyWalletAddress?: string | null;
+    privySolanaAddress?: string | null;
     createdAt: string;
     updatedAt: string;
     defaultChainId?: number | null;
-    defaultCheckoutMode?: 'exact-token' | 'exact-fiat' | null;
-    defaultFiatCurrency?: string | null;
+    defaultDestinationToken?: 'USDC' | 'USDT' | null;
     defaultMaxFeePercentage?: number | null;
+    defaultMaxFeeConfig?: MaxFeeConfig | null;
+    referralFeeConfig?: ReferralFeeConfig | null;
     enabledPaymentPlatforms?: PaymentPlatformType[] | null;
+    payWithCryptoEnabled: boolean;
+    relayPayoutsEnabled: boolean;
 };
 export type CreateMerchantRequest = {
     name: string;
@@ -96,8 +358,15 @@ export type CheckoutSession = {
     destinationToken: string;
     recipientAddress: string;
     status: SessionStatusType;
+    selectedCheckoutMethod?: CheckoutMethodType | null;
     selectedPaymentPlatform?: PaymentPlatformType | null;
     selectedFiatCurrency?: string | null;
+    paymentSentAt?: string | null;
+    cryptoRequestId?: string | null;
+    cryptoDepositAddress?: string | null;
+    cryptoOriginChainId?: number | null;
+    cryptoOriginToken?: PayCryptoTokenSymbol | null;
+    cryptoOriginAmount?: string | null;
     successUrl?: string | null;
     cancelUrl?: string | null;
     metadata?: Record<string, string> | null;
@@ -107,8 +376,12 @@ export type CheckoutSession = {
     fiatAmount?: string | null;
     fiatCurrency?: string | null;
     maxFeePercentage?: number | null;
+    maxFeeConfigSnapshot?: MaxFeeConfig | null;
+    requestedNetAmountUsdc?: string | null;
     requiresBridge?: boolean;
     enabledPaymentPlatforms?: PaymentPlatformType[] | null;
+    payWithCryptoEnabled: boolean;
+    cryptoPayment?: CheckoutCryptoPayment | null;
     createdAt: string;
     updatedAt: string;
     merchant?: {
@@ -125,6 +398,7 @@ export type QuoteIntent = {
     processorName: string;
     amount: string;
     toAddress: string;
+    escrowAddress?: string;
     payeeDetails: string;
     processorIntentData: Record<string, unknown>;
     fiatCurrencyCode: string;
@@ -152,6 +426,7 @@ export type Order = {
     paymentPlatform?: PaymentPlatformType | null;
     fiatCurrency?: string | null;
     amountUsdc?: string | null;
+    grossAmountUsdc?: string | null;
     netAmountUsdc?: string | null;
     conversionRate?: string | null;
     recipient?: string | null;
@@ -160,7 +435,7 @@ export type Order = {
     bridgeCommitmentData?: string | null;
     bridgeFulfillData?: string | null;
     bridgeDepositTxHash?: string | null;
-    bridgeStatus?: 'pending' | 'filled' | 'expired' | null;
+    bridgeStatus?: 'pending' | 'completed' | 'failed' | null;
     bridgeFilledAt?: string | null;
     bridgeFilledTxHash?: string | null;
     bridgeInfo?: OrderBridgeInfo | null;
@@ -216,10 +491,6 @@ type CreateSessionExactFiatRequest = CreateSessionBaseRequest & {
     maxFeePercentage?: number;
 };
 export type CreateSessionRequest = CreateSessionExactTokenRequest | CreateSessionExactFiatRequest;
-/**
- * Bridge information returned when session requires cross-chain bridging.
- * Amounts are in raw units (6 decimals for USDC).
- */
 export type BridgeInfo = {
     required: boolean;
     inputAmount?: string | null;
@@ -234,17 +505,53 @@ export type CreateSessionResponse = {
     checkoutUrl: string;
     bridge?: BridgeInfo;
 };
+export type SelectPlatformRequest = {
+    checkoutMethod: 'fiat';
+    paymentPlatform: PaymentPlatformType;
+    fiatCurrency: string;
+} | {
+    checkoutMethod: 'crypto';
+};
 export type StartSessionRequest = {
+    checkoutMethod: 'fiat';
     paymentPlatform?: PaymentPlatformType;
     fiatCurrency?: string;
+} | {
+    checkoutMethod: 'crypto';
+    originChainId: number;
+    originToken: PayCryptoTokenSymbol;
+};
+export type RelayCryptoPaymentStatus = 'refund' | 'delayed' | 'waiting' | 'failure' | 'pending' | 'success';
+export type CheckoutCryptoPayment = {
+    requestId: string;
+    status: RelayCryptoPaymentStatus;
+    depositAddress: string;
+    originChainId: number;
+    originToken: PayCryptoTokenSymbol;
+    originAmount: string;
+    expectedDestinationAmount?: string | null;
+    actualDestinationAmount?: string | null;
+    sourceTxHash?: string | null;
+    destinationTxHash?: string | null;
+    errorMessage?: string | null;
+    completedAt?: string | null;
 };
-export type StartSessionResponse = {
+export type StartFiatSessionResponse = {
+    resultType: 'fiat_order';
     session: CheckoutSession;
     order: Order;
     quote: Quote;
-    intentHash: string;
+    intentHash: string | null;
     expiresAt?: string | null;
+    status?: string | null;
+    relayerTransactionId?: string | null;
 };
+export type StartCryptoSessionResponse = {
+    resultType: 'crypto_quote';
+    session: CheckoutSession;
+    cryptoPayment: CheckoutCryptoPayment;
+};
+export type StartSessionResponse = StartFiatSessionResponse | StartCryptoSessionResponse;
 export type MarkPaymentSentResponse = {
     order: Order;
 };
@@ -267,36 +574,41 @@ export type ProofAttemptsResponse = {
     proofAttempts: ProofAttempt[];
 };
 export interface BridgeStatusResponse {
-    status: 'pending' | 'filled' | 'expired' | 'not_applicable';
+    status: 'pending' | 'completed' | 'failed' | 'not_applicable';
     destinationChainId?: string;
-    outputAmountUsdc?: string;
+    outputAmount?: string;
+    estimatedOutputAmount?: string;
+    minimumOutputAmount?: string;
     fillTxHash?: string;
     depositTxHash?: string;
-    acrossTrackingUrl?: string;
     estimatedFillTime?: number;
+    fallbackToOrigin?: boolean;
+    failureMessage?: string;
 }
-/**
- * Bridge information included in order responses.
- * Tracks the status of cross-chain bridging via Across Protocol.
- */
 export interface OrderBridgeInfo {
-    status: 'PENDING' | 'DEPOSITED' | 'FILLED' | 'EXPIRED';
+    status: 'PENDING' | 'SUBMITTED' | 'COMPLETED' | 'FAILED';
     destinationChainId: string;
-    outputAmountUsdc?: string;
-    estimatedOutputAmountUsdc?: string;
-    minOutputAmountUsdc?: string;
+    outputAmount?: string;
+    estimatedOutputAmount?: string;
+    minimumOutputAmount?: string;
     fillTxHash?: string | null;
     estimatedFillTime?: number | null;
+    fallbackToOrigin?: boolean;
+    failureMessage?: string | null;
 }
 export declare const WebhookEventType: {
-    readonly ORDER_CREATED: "order.created";
-    readonly ORDER_PAYMENT_SENT: "order.payment_sent";
-    readonly ORDER_FULFILLED: "order.fulfilled";
-    readonly ORDER_FAILED: "order.failed";
-    readonly ORDER_EXPIRED: "order.expired";
-    readonly SESSION_STARTED: "session.started";
-    readonly SESSION_COMPLETED: "session.completed";
-    readonly SESSION_ABANDONED: "session.abandoned";
+    readonly ORDER_CREATED: "ORDER_CREATED";
+    readonly ORDER_FULFILLED: "ORDER_FULFILLED";
+    readonly ORDER_CANCELLED: "ORDER_CANCELLED";
+    readonly PAYMENT_CREATED: "PAYMENT_CREATED";
+    readonly PAYMENT_SETTLED: "PAYMENT_SETTLED";
+    readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
+    readonly PAYMENT_EXPIRED: "PAYMENT_EXPIRED";
+    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
+    readonly PAYMENT_BRIDGE_PENDING: "PAYMENT_BRIDGE_PENDING";
+    readonly PAYMENT_BRIDGE_SUBMITTED: "PAYMENT_BRIDGE_SUBMITTED";
+    readonly PAYMENT_BRIDGE_COMPLETED: "PAYMENT_BRIDGE_COMPLETED";
+    readonly PAYMENT_BRIDGE_FAILED: "PAYMENT_BRIDGE_FAILED";
 };
 export type WebhookEventTypeValue = typeof WebhookEventType[keyof typeof WebhookEventType];
 export declare const WebhookDeliveryStatus: {
@@ -305,12 +617,17 @@ export declare const WebhookDeliveryStatus: {
     readonly FAILED: "FAILED";
 };
 export type WebhookDeliveryStatusType = typeof WebhookDeliveryStatus[keyof typeof WebhookDeliveryStatus];
+export type WebhookHeader = {
+    key: string;
+    value: string;
+};
 export type Webhook = {
     id: string;
     merchantId: string;
     url: string;
     events: WebhookEventTypeValue[];
     active: boolean;
+    customHeaders: WebhookHeader[];
     createdAt: string;
     updatedAt: string;
 };
@@ -333,26 +650,23 @@ export type WebhookPayload = {
     id: string;
     type: WebhookEventTypeValue;
     timestamp: string;
-    environment: MerchantEnvironmentType;
     data: {
-        session: CheckoutSession;
-        order?: Order | null;
-        txHash?: string | null;
-        error?: {
-            code: string;
-            message: string;
-        } | null;
+        order: CheckoutOrder | null;
+        payment: CheckoutPayment | null;
+        paymentBridge: Record<string, unknown> | null;
     };
 };
 export type CreateWebhookRequest = {
     url: string;
     events?: WebhookEventTypeValue[];
+    customHeaders?: WebhookHeader[];
 };
 export type CreateWebhookResponse = WebhookWithSecret;
 export type UpdateWebhookRequest = {
     url?: string;
     events?: WebhookEventTypeValue[];
     active?: boolean;
+    customHeaders?: WebhookHeader[];
 };
 export type ListWebhooksResponse = {
     webhooks: Webhook[];
@@ -367,4 +681,3 @@ export type TestWebhookResponse = {
     error?: string | null;
 };
 export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,3 +1,4 @@
+import { SupportedChainsMap } from './chains.js';
 export const PaymentPlatform = {
     VENMO: 'venmo',
     CASHAPP: 'cashapp',
@@ -7,10 +8,10 @@ export const PaymentPlatform = {
     PAYPAL: 'paypal',
     MONZO: 'monzo',
     N26: 'n26',
+    CHIME: 'chime',
 };
 // Supported chains for USDC destination
 // Re-exported from chains.ts for backward compatibility
-import { SupportedChainsMap } from './chains.js';
 export const SupportedChains = SupportedChainsMap;
 // Checkout mode determines how amounts are specified
 export const CheckoutMode = {
@@ -38,15 +39,38 @@ export const SessionStatus = {
     CREATED: 'CREATED',
     ACTIVE: 'ACTIVE',
     COMPLETED: 'COMPLETED',
+    FAILED: 'FAILED',
+    REFUNDED: 'REFUNDED',
     EXPIRED: 'EXPIRED',
     CANCELLED: 'CANCELLED',
 };
+export const CheckoutMethod = {
+    FIAT: 'fiat',
+    CRYPTO: 'crypto',
+};
+// ============ Canonical Checkout API  ============
+export const FeePayer = {
+    MERCHANT: 'MERCHANT',
+    PAYEE: 'PAYEE',
+};
+export const CheckoutOrderStatus = {
+    CREATED: 'CREATED',
+    PARTIALLY_FULFILLED: 'PARTIALLY_FULFILLED',
+    FULFILLED: 'FULFILLED',
+    CANCELLED: 'CANCELLED',
+};
+export const CheckoutPaymentStatus = {
+    CREATED: 'CREATED',
+    SETTLED: 'SETTLED',
+    CANCELLED: 'CANCELLED',
+    EXPIRED: 'EXPIRED',
+    FAILED: 'FAILED',
+};
 // Structured error codes for Order failures
 export const OrderErrorCode = {
     // Proof verification errors
     PROOF_INVALID: 'PROOF_INVALID', // Proof data failed attestation verification
     PROOF_EXPIRED: 'PROOF_EXPIRED', // Proof timestamp too old
-    PROOF_AMOUNT_MISMATCH: 'PROOF_AMOUNT_MISMATCH', // Payment amount doesn't match intent
     PROOF_RECIPIENT_MISMATCH: 'PROOF_RECIPIENT_MISMATCH', // Payment recipient doesn't match
     // Transaction errors
     FULFILL_TIMEOUT: 'FULFILL_TIMEOUT', // On-chain tx timed out
@@ -58,7 +82,6 @@ export const OrderErrorCode = {
     RELAYER_ERROR: 'RELAYER_ERROR', // Relayer submission failed
     ATTESTATION_ERROR: 'ATTESTATION_ERROR', // Attestation service unavailable
     // Bridge errors (cross-chain)
-    BRIDGE_QUOTE_ERROR: 'BRIDGE_QUOTE_ERROR', // Failed to get bridge quote
     BRIDGE_TIMEOUT: 'BRIDGE_TIMEOUT', // Bridge fill timed out
     // Fee threshold errors (exact-fiat mode)
     FEE_THRESHOLD_EXCEEDED: 'FEE_THRESHOLD_EXCEEDED', // Quote fee exceeds merchant's max
@@ -70,18 +93,24 @@ export const MerchantEnvironment = {
     LIVE: 'LIVE',
     SANDBOX: 'SANDBOX',
 };
+export const TrancheCurrency = {
+    USD: 'USD',
+    USDC: 'USDC',
+};
 // ============ Webhook Types ============
 export const WebhookEventType = {
-    // Order lifecycle events
-    ORDER_CREATED: 'order.created',
-    ORDER_PAYMENT_SENT: 'order.payment_sent',
-    ORDER_FULFILLED: 'order.fulfilled',
-    ORDER_FAILED: 'order.failed',
-    ORDER_EXPIRED: 'order.expired',
-    // Session lifecycle events
-    SESSION_STARTED: 'session.started',
-    SESSION_COMPLETED: 'session.completed',
-    SESSION_ABANDONED: 'session.abandoned',
+    ORDER_CREATED: 'ORDER_CREATED',
+    ORDER_FULFILLED: 'ORDER_FULFILLED',
+    ORDER_CANCELLED: 'ORDER_CANCELLED',
+    PAYMENT_CREATED: 'PAYMENT_CREATED',
+    PAYMENT_SETTLED: 'PAYMENT_SETTLED',
+    PAYMENT_CANCELLED: 'PAYMENT_CANCELLED',
+    PAYMENT_EXPIRED: 'PAYMENT_EXPIRED',
+    PAYMENT_FAILED: 'PAYMENT_FAILED',
+    PAYMENT_BRIDGE_PENDING: 'PAYMENT_BRIDGE_PENDING',
+    PAYMENT_BRIDGE_SUBMITTED: 'PAYMENT_BRIDGE_SUBMITTED',
+    PAYMENT_BRIDGE_COMPLETED: 'PAYMENT_BRIDGE_COMPLETED',
+    PAYMENT_BRIDGE_FAILED: 'PAYMENT_BRIDGE_FAILED',
 };
 export const WebhookDeliveryStatus = {
     PENDING: 'PENDING',

package/package.json

@@ -1,9 +1,30 @@
 {
   "name": "@zkp2p/pay-shared",
-  "version": "0.0.1",
+  "version": "1.0.0",
+  "description": "Shared TypeScript types, enums, and chain utilities used by ZKP2P Pay API, SDK, and frontend apps.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zkp2p/pay.git",
+    "directory": "packages/shared"
+  },
+  "bugs": {
+    "url": "https://github.com/zkp2p/pay/issues"
+  },
+  "homepage": "https://github.com/zkp2p/pay/tree/main/packages/shared#readme",
+  "keywords": [
+    "zkp2p",
+    "pay",
+    "shared",
+    "types",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -11,11 +32,12 @@
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "lint": "eslint . --ext .ts,.tsx"
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "lint": "eslint . --ext .ts,.tsx",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm pack --dry-run"
   }
 }