@blocklet/payment-react-headless 1.26.0

package/src/types/checkout-augmented.ts

@@ -0,0 +1,77 @@
+import type { TCheckoutSessionExpanded, TPrice, TPriceExpanded } from '@blocklet/payment-types';
+
+// ── Session user (runtime field added by API, not in base TCheckoutSession) ──
+export interface CheckoutSessionUser {
+  did?: string;
+  sourceAppPid?: string;
+  connectedAccounts?: Array<{ provider: string }>;
+  extraConfigs?: { connectedAccounts?: Array<{ provider: string }> };
+}
+
+// Extended checkout session with runtime-only fields not in the base type
+export type CheckoutSessionRuntime = TCheckoutSessionExpanded & {
+  user?: CheckoutSessionUser;
+  quote_locked_at?: number;
+};
+
+// Price with expanded cross-sell relation
+export type PriceWithCrossSell = TPriceExpanded & {
+  cross_sell?: {
+    cross_sells_to?: TPrice;
+    cross_sells_to_id?: string;
+  };
+};
+
+// Expanded upsell type (upsell field on TPrice only has upsells_to_id, but API expands it)
+export interface UpsellExpanded {
+  upsells_to_id?: string;
+  upsells_to?: TPrice;
+}
+
+// ── Error handling helpers ──
+
+interface AxiosLikeError {
+  response?: {
+    data?: {
+      error?: string;
+      code?: string;
+      [key: string]: unknown;
+    };
+  };
+  message?: string;
+  name?: string;
+}
+
+/**
+ * Get human-readable message from unknown error.
+ * Works for standard Error, AxiosError, and string errors.
+ */
+export function getErrorMessage(err: unknown): string {
+  // Check axios response body first — AxiosError extends Error,
+  // so instanceof Error would return the generic "Request failed with status code 400"
+  const axErr = err as AxiosLikeError;
+  if (axErr?.response?.data?.error) return axErr.response.data.error;
+  if (err instanceof Error) return err.message;
+  if (typeof err === 'string') return err;
+  return axErr?.message || 'Unknown error';
+}
+
+/**
+ * Extract API error details from an unknown axios-like error.
+ * Returns message, error code, and raw response data.
+ */
+export function getAxiosErrorDetails(err: unknown): {
+  message: string;
+  code: string | undefined;
+  data: Record<string, unknown> | undefined;
+  isCancelled: boolean;
+} {
+  const axErr = err as AxiosLikeError;
+  const data = axErr?.response?.data;
+  return {
+    message: data?.error || axErr?.message || 'Unknown error',
+    code: data?.code as string | undefined,
+    data: data as Record<string, unknown> | undefined,
+    isCancelled: axErr?.name === 'CanceledError' || axErr?.name === 'AbortError',
+  };
+}

package/src/types/external.d.ts

@@ -0,0 +1,18 @@
+declare module 'google-libphonenumber' {
+  export class PhoneNumberUtil {
+    static getInstance(): PhoneNumberUtil;
+    parseAndKeepRawInput(numberToParse: string, defaultRegion?: string): any;
+    isValidNumber(number: any): boolean;
+  }
+}
+
+declare module '@arcblock/ws' {
+  export class WsClient {
+    constructor(url: string, options?: Record<string, any>);
+    connect(): void;
+    disconnect(): void;
+    isConnected(): boolean;
+    subscribe(channel: string): any;
+    unsubscribe(channel: string): void;
+  }
+}

package/tools/jest.js

@@ -0,0 +1 @@
+require('../../../tools/jest');

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "esnext",
+    "lib": [
+      "esnext",
+      "DOM"
+    ],
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "strict": true,
+    "strictNullChecks": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "jsx": "react-jsx"
+  }
+}