@xorr-finance/irion-sdk 0.1.0

package/README.md

@@ -0,0 +1,105 @@
+# @xorr-finance/irion-sdk
+
+Drop-in **"Buy Now, Pay Never"** checkout for any merchant or shopping site —
+powered by Irion private consumer credit on Canton. Like a payment-gateway SDK
+(Stripe-style): create a checkout on your server with an API key, open it in the
+browser, get the result back.
+
+```bash
+npm install @xorr-finance/irion-sdk
+```
+
+> Migrating from `@xorr/sdk`? The old names (`XorrClient`, `openXorrCheckout`,
+> `PayWithXorr`, `XorrConfig`) are still exported as deprecated aliases, and the
+> `txDigest` field is kept alongside the new `txHash`, so existing code keeps
+> working.
+
+## 1. Get your API keys
+
+From the **Irion merchant dashboard** → your App → API credentials, copy:
+
+- `client_id`  → `x-client-id` (public)
+- `client_secret` → `x-client-secret` (**secret — server only**)
+
+## 2. Create a checkout (server-side)
+
+`clientSecret` must never reach the browser, so create the session in your
+backend (API route / server action / serverless fn):
+
+```ts
+import { IrionClient } from "@xorr-finance/irion-sdk";
+
+const irion = new IrionClient({
+  clientId: process.env.IRION_CLIENT_ID!,
+  clientSecret: process.env.IRION_CLIENT_SECRET!,
+  // baseUrl: "http://localhost:3001", // self-hosted / local dev; omit for hosted gateway
+});
+
+// e.g. inside POST /api/irion-checkout
+const { checkoutUrl, billHash } = await irion.createCheckout({
+  amount: 49.99,          // in USDC
+  orderId: "cart_8842",
+  description: "Sneakers x1",
+});
+return Response.json({ checkoutUrl });
+```
+
+## 3. Open the checkout (browser)
+
+### Vanilla JS / any framework
+
+```ts
+import { openIrionCheckout } from "@xorr-finance/irion-sdk";
+
+const { checkoutUrl } = await fetch("/api/irion-checkout", { method: "POST" }).then(r => r.json());
+
+openIrionCheckout(checkoutUrl, {
+  onSuccess: (r) => console.log("paid!", r.txHash, r.loanId),
+  onError:   (r) => console.warn("failed", r.error),
+  onClose:   () => console.log("shopper closed checkout"),
+  // redirect: true,  // full-page redirect instead of a popup
+});
+```
+
+### React
+
+```tsx
+import { PayWithIrion } from "@xorr-finance/irion-sdk/react";
+
+<PayWithIrion
+  createCheckout={() => fetch("/api/irion-checkout", { method: "POST" }).then(r => r.json())}
+  onSuccess={(r) => router.push(`/success?tx=${r.txHash}`)}
+/>
+```
+
+## How payment works
+
+The shopper picks **Pay Never** (over-collateralized BNPL: their collateral
+earns yield that auto-repays the purchase) or pays in full. Their credit is
+scored **privately** — income/debts stay in a private Daml contract that only the
+shopper and the operator can see, never the wider network. Settlement happens on
+Canton; you get the `txHash` + `loanId` back.
+
+## Result shape (`postMessage` / callbacks)
+
+```ts
+interface PaymentResult {
+  success: boolean;
+  billHash?: string;
+  loanId?: string;     // on-chain BNPL loan id
+  txHash?: string;     // Canton settlement id (update id)
+  txDigest?: string;   // @deprecated legacy alias for txHash (Sui era)
+  paymentMode?: "bnpl" | "split3" | "full";
+  error?: string;
+}
+```
+
+## API
+
+| Export | Where | Purpose |
+|--------|-------|---------|
+| `new IrionClient(config)` | server | `createCheckout(params)`, `getBill(hash)`, `checkoutUrl(hash)` |
+| `openIrionCheckout(url, opts)` | browser | opens the checkout popup, resolves via callbacks |
+| `<PayWithIrion/>` (`@xorr-finance/irion-sdk/react`) | browser | prebuilt button |
+
+MIT.

package/dist/chunk-6Y4GUDXC.js

@@ -0,0 +1,51 @@
+// src/browser.ts
+var RESULT_TYPES = ["IRION_PAYMENT_RESULT", "XORR_PAYMENT_RESULT", "POLARIS_PAYMENT_RESULT"];
+function openIrionCheckout(checkoutUrl, options = {}) {
+  if (typeof window === "undefined") {
+    throw new Error("openIrionCheckout must run in the browser. Create the checkout server-side with IrionClient, then call this on the client.");
+  }
+  if (options.redirect) {
+    window.location.href = checkoutUrl;
+    return () => {
+    };
+  }
+  const expectedOrigin = options.allowedOrigin ?? (() => {
+    try {
+      return new URL(checkoutUrl).origin;
+    } catch {
+      return void 0;
+    }
+  })();
+  const w = options.width ?? 460;
+  const h = options.height ?? 720;
+  const left = window.screenX + Math.max(0, (window.outerWidth - w) / 2);
+  const top = window.screenY + Math.max(0, (window.outerHeight - h) / 2);
+  const popup = window.open(checkoutUrl, "irion-checkout", `popup,width=${w},height=${h},left=${left},top=${top}`);
+  const handler = (event) => {
+    if (expectedOrigin && event.origin !== expectedOrigin) return;
+    const data = event.data;
+    if (!data || !data.type || !RESULT_TYPES.includes(data.type)) return;
+    if (data.success) options.onSuccess?.(data);
+    else options.onError?.(data);
+    cleanup();
+  };
+  const poll = window.setInterval(() => {
+    if (popup && popup.closed) {
+      cleanup();
+      options.onClose?.();
+    }
+  }, 600);
+  function cleanup() {
+    window.removeEventListener("message", handler);
+    window.clearInterval(poll);
+    try {
+      popup?.close();
+    } catch {
+    }
+  }
+  window.addEventListener("message", handler);
+  return cleanup;
+}
+var openXorrCheckout = openIrionCheckout;
+
+export { openIrionCheckout, openXorrCheckout };

package/dist/index.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://pay.irion.finance";
+var IrionClient = class {
+  constructor(config) {
+    if (!config?.clientId || !config?.clientSecret) {
+      throw new Error("IrionClient: `clientId` and `clientSecret` are required (get them from the Irion merchant dashboard).");
+    }
+    this.clientId = config.clientId;
+    this.clientSecret = config.clientSecret;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.asset = config.asset ?? "USDC";
+  }
+  /** Create a BNPL checkout session. Returns a `checkoutUrl` to open/redirect the shopper to. */
+  async createCheckout(params) {
+    if (!params?.amount || params.amount <= 0) throw new Error("IrionClient.createCheckout: `amount` must be > 0");
+    const res = await fetch(`${this.baseUrl}/api/bills/create`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-client-id": this.clientId,
+        "x-client-secret": this.clientSecret
+      },
+      body: JSON.stringify({
+        amount: params.amount,
+        description: params.description,
+        asset: params.asset ?? this.asset,
+        metadata: { ...params.metadata ?? {}, ...params.orderId ? { orderId: params.orderId } : {} }
+      })
+    });
+    if (!res.ok) {
+      const detail = await res.text().catch(() => "");
+      throw new Error(`Irion createCheckout failed (${res.status}): ${detail || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /** Fetch the current state of a bill (e.g. to confirm payment server-side). */
+  async getBill(billHash) {
+    const res = await fetch(`${this.baseUrl}/api/bills/${billHash}`);
+    if (!res.ok) throw new Error(`Irion getBill failed (${res.status})`);
+    return await res.json();
+  }
+  /** The checkout URL for a bill hash (if you already have one). */
+  checkoutUrl(billHash) {
+    return `${this.baseUrl}/pay/${billHash}`;
+  }
+};
+var XorrClient = IrionClient;
+
+// src/browser.ts
+var RESULT_TYPES = ["IRION_PAYMENT_RESULT", "XORR_PAYMENT_RESULT", "POLARIS_PAYMENT_RESULT"];
+function openIrionCheckout(checkoutUrl, options = {}) {
+  if (typeof window === "undefined") {
+    throw new Error("openIrionCheckout must run in the browser. Create the checkout server-side with IrionClient, then call this on the client.");
+  }
+  if (options.redirect) {
+    window.location.href = checkoutUrl;
+    return () => {
+    };
+  }
+  const expectedOrigin = options.allowedOrigin ?? (() => {
+    try {
+      return new URL(checkoutUrl).origin;
+    } catch {
+      return void 0;
+    }
+  })();
+  const w = options.width ?? 460;
+  const h = options.height ?? 720;
+  const left = window.screenX + Math.max(0, (window.outerWidth - w) / 2);
+  const top = window.screenY + Math.max(0, (window.outerHeight - h) / 2);
+  const popup = window.open(checkoutUrl, "irion-checkout", `popup,width=${w},height=${h},left=${left},top=${top}`);
+  const handler = (event) => {
+    if (expectedOrigin && event.origin !== expectedOrigin) return;
+    const data = event.data;
+    if (!data || !data.type || !RESULT_TYPES.includes(data.type)) return;
+    if (data.success) options.onSuccess?.(data);
+    else options.onError?.(data);
+    cleanup();
+  };
+  const poll = window.setInterval(() => {
+    if (popup && popup.closed) {
+      cleanup();
+      options.onClose?.();
+    }
+  }, 600);
+  function cleanup() {
+    window.removeEventListener("message", handler);
+    window.clearInterval(poll);
+    try {
+      popup?.close();
+    } catch {
+    }
+  }
+  window.addEventListener("message", handler);
+  return cleanup;
+}
+var openXorrCheckout = openIrionCheckout;
+
+exports.IrionClient = IrionClient;
+exports.XorrClient = XorrClient;
+exports.openIrionCheckout = openIrionCheckout;
+exports.openXorrCheckout = openXorrCheckout;

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+import { I as IrionConfig, C as CreateCheckoutParams, a as Checkout, B as Bill, P as PaymentResult } from './types-Bk6JSyrl.cjs';
+export { X as XorrConfig } from './types-Bk6JSyrl.cjs';
+
+/**
+ * Server-side Irion client. Use it in your backend (API route, server action,
+ * serverless function) to create checkout sessions — NEVER expose
+ * `clientSecret` to the browser.
+ *
+ * ```ts
+ * const irion = new IrionClient({ clientId: process.env.IRION_CLIENT_ID!, clientSecret: process.env.IRION_CLIENT_SECRET! });
+ * const { checkoutUrl } = await irion.createCheckout({ amount: 49.99, orderId: "cart_123" });
+ * ```
+ */
+declare class IrionClient {
+    private readonly clientId;
+    private readonly clientSecret;
+    private readonly baseUrl;
+    private readonly asset;
+    constructor(config: IrionConfig);
+    /** Create a BNPL checkout session. Returns a `checkoutUrl` to open/redirect the shopper to. */
+    createCheckout(params: CreateCheckoutParams): Promise<Checkout>;
+    /** Fetch the current state of a bill (e.g. to confirm payment server-side). */
+    getBill(billHash: string): Promise<Bill>;
+    /** The checkout URL for a bill hash (if you already have one). */
+    checkoutUrl(billHash: string): string;
+}
+/** @deprecated Renamed to {@link IrionClient}. Kept for back-compat. */
+declare const XorrClient: typeof IrionClient;
+
+interface OpenCheckoutOptions {
+    /** Called when the shopper completes payment. */
+    onSuccess?: (result: PaymentResult) => void;
+    /** Called on a failed/cancelled payment. */
+    onError?: (result: PaymentResult) => void;
+    /** Called if the shopper closes the popup without finishing. */
+    onClose?: () => void;
+    /** Open in the same tab via redirect instead of a popup. */
+    redirect?: boolean;
+    /** Only accept payment-result messages from this exact origin. Defaults to the checkout URL's origin. */
+    allowedOrigin?: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Open the Irion checkout (browser-only) and resolve via callbacks when the
+ * shopper finishes. Returns a `cancel()` you can call to tear down listeners.
+ *
+ * ```ts
+ * openIrionCheckout(checkoutUrl, {
+ *   onSuccess: (r) => console.log("paid!", r.txHash),
+ *   onError:   (r) => console.warn(r.error),
+ * });
+ * ```
+ */
+declare function openIrionCheckout(checkoutUrl: string, options?: OpenCheckoutOptions): () => void;
+/** @deprecated Renamed to {@link openIrionCheckout}. Kept for back-compat. */
+declare const openXorrCheckout: typeof openIrionCheckout;
+
+export { Bill, Checkout, CreateCheckoutParams, IrionClient, IrionConfig, type OpenCheckoutOptions, PaymentResult, XorrClient, openIrionCheckout, openXorrCheckout };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { I as IrionConfig, C as CreateCheckoutParams, a as Checkout, B as Bill, P as PaymentResult } from './types-Bk6JSyrl.js';
+export { X as XorrConfig } from './types-Bk6JSyrl.js';
+
+/**
+ * Server-side Irion client. Use it in your backend (API route, server action,
+ * serverless function) to create checkout sessions — NEVER expose
+ * `clientSecret` to the browser.
+ *
+ * ```ts
+ * const irion = new IrionClient({ clientId: process.env.IRION_CLIENT_ID!, clientSecret: process.env.IRION_CLIENT_SECRET! });
+ * const { checkoutUrl } = await irion.createCheckout({ amount: 49.99, orderId: "cart_123" });
+ * ```
+ */
+declare class IrionClient {
+    private readonly clientId;
+    private readonly clientSecret;
+    private readonly baseUrl;
+    private readonly asset;
+    constructor(config: IrionConfig);
+    /** Create a BNPL checkout session. Returns a `checkoutUrl` to open/redirect the shopper to. */
+    createCheckout(params: CreateCheckoutParams): Promise<Checkout>;
+    /** Fetch the current state of a bill (e.g. to confirm payment server-side). */
+    getBill(billHash: string): Promise<Bill>;
+    /** The checkout URL for a bill hash (if you already have one). */
+    checkoutUrl(billHash: string): string;
+}
+/** @deprecated Renamed to {@link IrionClient}. Kept for back-compat. */
+declare const XorrClient: typeof IrionClient;
+
+interface OpenCheckoutOptions {
+    /** Called when the shopper completes payment. */
+    onSuccess?: (result: PaymentResult) => void;
+    /** Called on a failed/cancelled payment. */
+    onError?: (result: PaymentResult) => void;
+    /** Called if the shopper closes the popup without finishing. */
+    onClose?: () => void;
+    /** Open in the same tab via redirect instead of a popup. */
+    redirect?: boolean;
+    /** Only accept payment-result messages from this exact origin. Defaults to the checkout URL's origin. */
+    allowedOrigin?: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * Open the Irion checkout (browser-only) and resolve via callbacks when the
+ * shopper finishes. Returns a `cancel()` you can call to tear down listeners.
+ *
+ * ```ts
+ * openIrionCheckout(checkoutUrl, {
+ *   onSuccess: (r) => console.log("paid!", r.txHash),
+ *   onError:   (r) => console.warn(r.error),
+ * });
+ * ```
+ */
+declare function openIrionCheckout(checkoutUrl: string, options?: OpenCheckoutOptions): () => void;
+/** @deprecated Renamed to {@link openIrionCheckout}. Kept for back-compat. */
+declare const openXorrCheckout: typeof openIrionCheckout;
+
+export { Bill, Checkout, CreateCheckoutParams, IrionClient, IrionConfig, type OpenCheckoutOptions, PaymentResult, XorrClient, openIrionCheckout, openXorrCheckout };

package/dist/index.js

@@ -0,0 +1,51 @@
+export { openIrionCheckout, openXorrCheckout } from './chunk-6Y4GUDXC.js';
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://pay.irion.finance";
+var IrionClient = class {
+  constructor(config) {
+    if (!config?.clientId || !config?.clientSecret) {
+      throw new Error("IrionClient: `clientId` and `clientSecret` are required (get them from the Irion merchant dashboard).");
+    }
+    this.clientId = config.clientId;
+    this.clientSecret = config.clientSecret;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.asset = config.asset ?? "USDC";
+  }
+  /** Create a BNPL checkout session. Returns a `checkoutUrl` to open/redirect the shopper to. */
+  async createCheckout(params) {
+    if (!params?.amount || params.amount <= 0) throw new Error("IrionClient.createCheckout: `amount` must be > 0");
+    const res = await fetch(`${this.baseUrl}/api/bills/create`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-client-id": this.clientId,
+        "x-client-secret": this.clientSecret
+      },
+      body: JSON.stringify({
+        amount: params.amount,
+        description: params.description,
+        asset: params.asset ?? this.asset,
+        metadata: { ...params.metadata ?? {}, ...params.orderId ? { orderId: params.orderId } : {} }
+      })
+    });
+    if (!res.ok) {
+      const detail = await res.text().catch(() => "");
+      throw new Error(`Irion createCheckout failed (${res.status}): ${detail || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /** Fetch the current state of a bill (e.g. to confirm payment server-side). */
+  async getBill(billHash) {
+    const res = await fetch(`${this.baseUrl}/api/bills/${billHash}`);
+    if (!res.ok) throw new Error(`Irion getBill failed (${res.status})`);
+    return await res.json();
+  }
+  /** The checkout URL for a bill hash (if you already have one). */
+  checkoutUrl(billHash) {
+    return `${this.baseUrl}/pay/${billHash}`;
+  }
+};
+var XorrClient = IrionClient;
+
+export { IrionClient, XorrClient };

package/dist/react.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/react.tsx
+
+// src/browser.ts
+var RESULT_TYPES = ["IRION_PAYMENT_RESULT", "XORR_PAYMENT_RESULT", "POLARIS_PAYMENT_RESULT"];
+function openIrionCheckout(checkoutUrl, options = {}) {
+  if (typeof window === "undefined") {
+    throw new Error("openIrionCheckout must run in the browser. Create the checkout server-side with IrionClient, then call this on the client.");
+  }
+  if (options.redirect) {
+    window.location.href = checkoutUrl;
+    return () => {
+    };
+  }
+  const expectedOrigin = options.allowedOrigin ?? (() => {
+    try {
+      return new URL(checkoutUrl).origin;
+    } catch {
+      return void 0;
+    }
+  })();
+  const w = options.width ?? 460;
+  const h = options.height ?? 720;
+  const left = window.screenX + Math.max(0, (window.outerWidth - w) / 2);
+  const top = window.screenY + Math.max(0, (window.outerHeight - h) / 2);
+  const popup = window.open(checkoutUrl, "irion-checkout", `popup,width=${w},height=${h},left=${left},top=${top}`);
+  const handler = (event) => {
+    if (expectedOrigin && event.origin !== expectedOrigin) return;
+    const data = event.data;
+    if (!data || !data.type || !RESULT_TYPES.includes(data.type)) return;
+    if (data.success) options.onSuccess?.(data);
+    else options.onError?.(data);
+    cleanup();
+  };
+  const poll = window.setInterval(() => {
+    if (popup && popup.closed) {
+      cleanup();
+      options.onClose?.();
+    }
+  }, 600);
+  function cleanup() {
+    window.removeEventListener("message", handler);
+    window.clearInterval(poll);
+    try {
+      popup?.close();
+    } catch {
+    }
+  }
+  window.addEventListener("message", handler);
+  return cleanup;
+}
+function PayWithIrion({ checkoutUrl, createCheckout, onSuccess, onError, className, style, children }) {
+  const [loading, setLoading] = React__namespace.useState(false);
+  const handleClick = async () => {
+    setLoading(true);
+    try {
+      const url = checkoutUrl ?? (await createCheckout?.())?.checkoutUrl;
+      if (!url) throw new Error("PayWithIrion: provide `checkoutUrl` or a `createCheckout` that returns one.");
+      openIrionCheckout(url, {
+        onSuccess: (r) => {
+          setLoading(false);
+          onSuccess?.(r);
+        },
+        onError: (r) => {
+          setLoading(false);
+          onError?.(r);
+        },
+        onClose: () => setLoading(false)
+      });
+    } catch (e) {
+      setLoading(false);
+      onError?.({ success: false, error: e instanceof Error ? e.message : String(e) });
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: handleClick, disabled: loading, className, style, children: children ?? (loading ? "Opening Irion\u2026" : "Buy Now, Pay Never \u2014 with Irion") });
+}
+var PayWithXorr = PayWithIrion;
+
+exports.PayWithIrion = PayWithIrion;
+exports.PayWithXorr = PayWithXorr;

package/dist/react.d.cts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import { P as PaymentResult } from './types-Bk6JSyrl.cjs';
+
+interface PayWithIrionProps {
+    /** A checkout URL already created server-side via `IrionClient.createCheckout`. */
+    checkoutUrl?: string;
+    /** Or a callback (usually hitting your own backend) that returns a fresh one. */
+    createCheckout?: () => Promise<{
+        checkoutUrl: string;
+    }>;
+    onSuccess?: (result: PaymentResult) => void;
+    onError?: (result: PaymentResult) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+}
+/** @deprecated Renamed to {@link PayWithIrionProps}. Kept for back-compat. */
+type PayWithXorrProps = PayWithIrionProps;
+/**
+ * Drop-in "Buy Now, Pay Never with Irion" button. Pass a pre-created
+ * `checkoutUrl` (recommended) or a `createCheckout` callback.
+ *
+ * ```tsx
+ * <PayWithIrion createCheckout={() => fetch("/api/irion-checkout", {method:"POST"}).then(r=>r.json())}
+ *   onSuccess={(r) => router.push(`/success?tx=${r.txHash}`)} />
+ * ```
+ */
+declare function PayWithIrion({ checkoutUrl, createCheckout, onSuccess, onError, className, style, children }: PayWithIrionProps): React.JSX.Element;
+/** @deprecated Renamed to {@link PayWithIrion}. Kept for back-compat. */
+declare const PayWithXorr: typeof PayWithIrion;
+
+export { PayWithIrion, type PayWithIrionProps, PayWithXorr, type PayWithXorrProps };

package/dist/react.d.ts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import { P as PaymentResult } from './types-Bk6JSyrl.js';
+
+interface PayWithIrionProps {
+    /** A checkout URL already created server-side via `IrionClient.createCheckout`. */
+    checkoutUrl?: string;
+    /** Or a callback (usually hitting your own backend) that returns a fresh one. */
+    createCheckout?: () => Promise<{
+        checkoutUrl: string;
+    }>;
+    onSuccess?: (result: PaymentResult) => void;
+    onError?: (result: PaymentResult) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+}
+/** @deprecated Renamed to {@link PayWithIrionProps}. Kept for back-compat. */
+type PayWithXorrProps = PayWithIrionProps;
+/**
+ * Drop-in "Buy Now, Pay Never with Irion" button. Pass a pre-created
+ * `checkoutUrl` (recommended) or a `createCheckout` callback.
+ *
+ * ```tsx
+ * <PayWithIrion createCheckout={() => fetch("/api/irion-checkout", {method:"POST"}).then(r=>r.json())}
+ *   onSuccess={(r) => router.push(`/success?tx=${r.txHash}`)} />
+ * ```
+ */
+declare function PayWithIrion({ checkoutUrl, createCheckout, onSuccess, onError, className, style, children }: PayWithIrionProps): React.JSX.Element;
+/** @deprecated Renamed to {@link PayWithIrion}. Kept for back-compat. */
+declare const PayWithXorr: typeof PayWithIrion;
+
+export { PayWithIrion, type PayWithIrionProps, PayWithXorr, type PayWithXorrProps };

package/dist/react.js

@@ -0,0 +1,32 @@
+import { openIrionCheckout } from './chunk-6Y4GUDXC.js';
+import * as React from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+function PayWithIrion({ checkoutUrl, createCheckout, onSuccess, onError, className, style, children }) {
+  const [loading, setLoading] = React.useState(false);
+  const handleClick = async () => {
+    setLoading(true);
+    try {
+      const url = checkoutUrl ?? (await createCheckout?.())?.checkoutUrl;
+      if (!url) throw new Error("PayWithIrion: provide `checkoutUrl` or a `createCheckout` that returns one.");
+      openIrionCheckout(url, {
+        onSuccess: (r) => {
+          setLoading(false);
+          onSuccess?.(r);
+        },
+        onError: (r) => {
+          setLoading(false);
+          onError?.(r);
+        },
+        onClose: () => setLoading(false)
+      });
+    } catch (e) {
+      setLoading(false);
+      onError?.({ success: false, error: e instanceof Error ? e.message : String(e) });
+    }
+  };
+  return /* @__PURE__ */ jsx("button", { type: "button", onClick: handleClick, disabled: loading, className, style, children: children ?? (loading ? "Opening Irion\u2026" : "Buy Now, Pay Never \u2014 with Irion") });
+}
+var PayWithXorr = PayWithIrion;
+
+export { PayWithIrion, PayWithXorr };

package/dist/types-Bk6JSyrl.d.cts

@@ -0,0 +1,60 @@
+/** Configuration for the server-side {@link IrionClient}. Get your keys from
+ * the Irion merchant dashboard (Apps → API credentials). */
+interface IrionConfig {
+    /** `x-client-id` — your public merchant app id (e.g. `prod_...`). */
+    clientId: string;
+    /** `x-client-secret` — KEEP SERVER-SIDE ONLY. Never ship to the browser. */
+    clientSecret: string;
+    /** Irion API base URL. Defaults to the hosted gateway; point at your
+     * self-hosted Irion core/merchant deployment in dev (e.g. http://localhost:3001). */
+    baseUrl?: string;
+    /** Settlement asset. Defaults to `USDC`. */
+    asset?: string;
+}
+/** @deprecated Renamed to {@link IrionConfig}. Kept for back-compat. */
+type XorrConfig = IrionConfig;
+interface CreateCheckoutParams {
+    /** Amount due, in whole `asset` units (e.g. 49.99 USDC). */
+    amount: number;
+    /** Your order/cart id — echoed back in the payment result. */
+    orderId?: string;
+    /** Human-readable description shown on the checkout. */
+    description?: string;
+    /** Arbitrary metadata stored on the bill. */
+    metadata?: Record<string, unknown>;
+    /** Override the default asset for this checkout. */
+    asset?: string;
+}
+interface Checkout {
+    billId?: string;
+    /** Unique bill hash; the checkout lives at `{baseUrl}/pay/{billHash}`. */
+    billHash: string;
+    /** URL to open/redirect the shopper to in order to pay. */
+    checkoutUrl: string;
+    merchantName?: string;
+    status: string;
+}
+interface Bill {
+    billHash: string;
+    amount: number;
+    asset: string;
+    description?: string;
+    status: "pending" | "paid" | "expired" | string;
+    metadata?: Record<string, unknown>;
+}
+/** Posted back to `window.opener` (and resolved by {@link openIrionCheckout}) when
+ * the shopper finishes the Irion checkout. */
+interface PaymentResult {
+    success: boolean;
+    billHash?: string;
+    /** On-chain BNPL loan id (if the shopper chose Pay-Never / BNPL). */
+    loanId?: string;
+    /** Canton settlement id (update id) of the on-ledger transaction. */
+    txHash?: string;
+    /** @deprecated Use {@link PaymentResult.txHash}. Legacy alias from the Sui era. */
+    txDigest?: string;
+    paymentMode?: "bnpl" | "split3" | "full";
+    error?: string;
+}
+
+export type { Bill as B, CreateCheckoutParams as C, IrionConfig as I, PaymentResult as P, XorrConfig as X, Checkout as a };

package/dist/types-Bk6JSyrl.d.ts

@@ -0,0 +1,60 @@
+/** Configuration for the server-side {@link IrionClient}. Get your keys from
+ * the Irion merchant dashboard (Apps → API credentials). */
+interface IrionConfig {
+    /** `x-client-id` — your public merchant app id (e.g. `prod_...`). */
+    clientId: string;
+    /** `x-client-secret` — KEEP SERVER-SIDE ONLY. Never ship to the browser. */
+    clientSecret: string;
+    /** Irion API base URL. Defaults to the hosted gateway; point at your
+     * self-hosted Irion core/merchant deployment in dev (e.g. http://localhost:3001). */
+    baseUrl?: string;
+    /** Settlement asset. Defaults to `USDC`. */
+    asset?: string;
+}
+/** @deprecated Renamed to {@link IrionConfig}. Kept for back-compat. */
+type XorrConfig = IrionConfig;
+interface CreateCheckoutParams {
+    /** Amount due, in whole `asset` units (e.g. 49.99 USDC). */
+    amount: number;
+    /** Your order/cart id — echoed back in the payment result. */
+    orderId?: string;
+    /** Human-readable description shown on the checkout. */
+    description?: string;
+    /** Arbitrary metadata stored on the bill. */
+    metadata?: Record<string, unknown>;
+    /** Override the default asset for this checkout. */
+    asset?: string;
+}
+interface Checkout {
+    billId?: string;
+    /** Unique bill hash; the checkout lives at `{baseUrl}/pay/{billHash}`. */
+    billHash: string;
+    /** URL to open/redirect the shopper to in order to pay. */
+    checkoutUrl: string;
+    merchantName?: string;
+    status: string;
+}
+interface Bill {
+    billHash: string;
+    amount: number;
+    asset: string;
+    description?: string;
+    status: "pending" | "paid" | "expired" | string;
+    metadata?: Record<string, unknown>;
+}
+/** Posted back to `window.opener` (and resolved by {@link openIrionCheckout}) when
+ * the shopper finishes the Irion checkout. */
+interface PaymentResult {
+    success: boolean;
+    billHash?: string;
+    /** On-chain BNPL loan id (if the shopper chose Pay-Never / BNPL). */
+    loanId?: string;
+    /** Canton settlement id (update id) of the on-ledger transaction. */
+    txHash?: string;
+    /** @deprecated Use {@link PaymentResult.txHash}. Legacy alias from the Sui era. */
+    txDigest?: string;
+    paymentMode?: "bnpl" | "split3" | "full";
+    error?: string;
+}
+
+export type { Bill as B, CreateCheckoutParams as C, IrionConfig as I, PaymentResult as P, XorrConfig as X, Checkout as a };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@xorr-finance/irion-sdk",
+  "version": "0.1.0",
+  "description": "Irion Buy-Now-Pay-Never SDK — private consumer-credit checkout on Canton. Drop-in for any merchant / shopping site.",
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/nickthelegend/irion-sdk-canton.git" },
+  "homepage": "https://github.com/nickthelegend/irion-sdk-canton#readme",
+  "publishConfig": { "access": "public" },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": ["irion", "bnpl", "canton", "daml", "payments", "checkout", "buy-now-pay-never"],
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  }
+}