@stackup-fi/sdk 1.0.7 → 1.0.8

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 export * from "./v1/gen/types.gen.js";
 import { type Config } from "./v1/gen/client/types.gen.js";
 import { StackupClient } from "./v1/gen/sdk.gen.js";
-export { type Config as OpencodeClientConfig, StackupClient };
+export { type Config as StackupClientConfig, StackupClient };
 export declare function createStackupClient(config?: Config): StackupClient;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./client.js";
+export * from "./notify/notify.js";
 export interface Options {
     accessToken: string;
     baseUrl?: string;

package/dist/index.js

@@ -1,8 +1,8 @@
 export * from "./client.js";
+export * from "./notify/notify.js";
 import { createStackupClient } from "./client.js";
 export function createStackup(options) {
     const client = createStackupClient({
-        baseUrl: options.baseUrl ?? "https://api.stackup.finance",
         headers: {
             Authorization: `Bearer ${options.accessToken}`,
         },

package/dist/notify/notify.d.ts

@@ -0,0 +1,4 @@
+import { type CheckArgs, type CheckResult, type WebhookArgs } from "./types.js";
+export * from "./types.js";
+export declare function notify(args: CheckArgs): Promise<CheckResult>;
+export declare function notify(args: WebhookArgs): (req: Request) => Promise<Response>;

package/dist/notify/notify.js

@@ -0,0 +1,54 @@
+import { createClient } from "../v1/gen/client/client.gen.js";
+import { StackupClient } from "../v1/gen/sdk.gen.js";
+import { verifyTimestamp } from "./util.js";
+export * from "./types.js";
+const DEFAULT_TOLERANCE = 300; // 5 minutes
+export function notify(args) {
+    if (args.mode === "check")
+        return check(args);
+    return webhook(args);
+}
+async function check(args) {
+    const client = new StackupClient({
+        client: createClient({
+            baseUrl: args.baseUrl ?? "https://api.stackup.finance",
+            headers: {
+                Authorization: `Bearer ${args.accessToken}`,
+            },
+        }),
+    });
+    return client.customer.check({
+        customerID: args.customerID,
+        productID: args.productID,
+    });
+}
+function webhook(config) {
+    const tolerance = config.tolerance ?? DEFAULT_TOLERANCE;
+    return async (req) => {
+        const timestamp = req.headers.get("x-webhook-timestamp");
+        const signature = req.headers.get("x-webhook-signature");
+        if (!timestamp || !signature)
+            return Response.json({
+                code: "bad_request",
+                message: "Missing webhook timestamp or signature",
+            }, { status: 400 });
+        const payload = await req.text();
+        if (!verifyTimestamp(timestamp, tolerance))
+            return Response.json({ code: "bad_request", message: "Webhook timestamp expired" }, { status: 400 });
+        const allow = await (async () => {
+            const encoder = new TextEncoder();
+            const key = await crypto.subtle.importKey("raw", encoder.encode(config.secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+            const bytes = await crypto.subtle.sign("HMAC", key, encoder.encode(`${timestamp}.${payload}`));
+            const expected = Array.from(new Uint8Array(bytes))
+                .map((b) => b.toString(16).padStart(2, "0"))
+                .join("");
+            return expected === signature.replace("sha256=", "");
+        })().catch(() => false);
+        if (!allow)
+            return Response.json({ code: "bad_request", message: "Invalid webhook signature" }, { status: 400 });
+        return await config
+            .handler(JSON.parse(payload))
+            .then(() => new Response(null, { status: 200 }))
+            .catch(() => Response.json({ code: "internal", message: "Internal server error" }, { status: 500 }));
+    };
+}

package/dist/notify/types.d.ts

@@ -0,0 +1,48 @@
+type Address = `0x${string}`;
+type Hex = `0x${string}`;
+import type { CustomerCheckErrors, CustomerCheckResponses } from "../v1/gen/types.gen.js";
+import type { RequestResult } from "../v1/gen/client/types.gen.js";
+type Prettify<T> = {
+    [K in keyof T]: Prettify<T[K]>;
+} & {};
+export interface Customer {
+    walletAddress: Address;
+    email: string | null;
+    name: string | null;
+    externalID: string | null;
+}
+export interface Payment {
+    status: "succeeded" | "failed";
+    amount: string;
+    tokenAddress: string | null;
+    txHash: Hex;
+    blockNumber: number;
+    productID: string | null;
+}
+export type WebhookEvent = Prettify<{
+    type: "payment.succeeded";
+    payload: {
+        customer: Customer;
+        payment: Payment;
+    };
+}>;
+export interface CheckArgs {
+    mode: "check";
+    accessToken: string;
+    customerID: string;
+    productID: string;
+    baseUrl?: string;
+}
+export interface WebhookArgs {
+    mode: "webhook";
+    secret: string;
+    tolerance?: number;
+    handler: WebhookHandler;
+}
+export type CheckResult = RequestResult<CustomerCheckResponses, CustomerCheckErrors, false>;
+export type WebhookHandler = (event: WebhookEvent) => Promise<void>;
+export declare class WebhookError extends Error {
+    code: "invalid_signature" | "invalid_timestamp" | "invalid_payload";
+    constructor(message: string, code: "invalid_signature" | "invalid_timestamp" | "invalid_payload");
+}
+export {};

package/dist/notify/types.js

@@ -0,0 +1,8 @@
+export class WebhookError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "WebhookError";
+    }
+}

package/dist/notify/util.d.ts

@@ -0,0 +1 @@
+export declare function verifyTimestamp(timestamp: string, tolerance: number): boolean;

package/dist/notify/util.js

@@ -0,0 +1,7 @@
+export function verifyTimestamp(timestamp, tolerance) {
+    const ts = parseInt(timestamp, 10);
+    if (isNaN(ts))
+        return false;
+    const now = Math.floor(Date.now() / 1000);
+    return Math.abs(now - ts) <= tolerance;
+}

package/dist/v1/gen/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type Client, type Options as Options2, type TDataShape } from "./client/index.js";
-import type { CheckoutSessionCreateErrors, CheckoutSessionCreateResponses, CustomerCreateErrors, CustomerCreateResponses, CustomerDeleteErrors, CustomerDeleteResponses, CustomerGetErrors, CustomerGetResponses, CustomerListResponses, CustomerUpdateErrors, CustomerUpdateResponses, ProductCreateErrors, ProductCreateResponses, ProductDeleteErrors, ProductDeleteResponses, ProductGetErrors, ProductGetResponses, ProductListResponses, ProductUpdateErrors, ProductUpdateResponses } from "./types.gen.js";
+import type { CheckoutSessionCreateErrors, CheckoutSessionCreateResponses, CustomerCheckErrors, CustomerCheckResponses, CustomerCreateErrors, CustomerCreateResponses, CustomerDeleteErrors, CustomerDeleteResponses, CustomerGetErrors, CustomerGetResponses, CustomerListResponses, CustomerUpdateErrors, CustomerUpdateResponses, ProductCreateErrors, ProductCreateResponses, ProductDeleteErrors, ProductDeleteResponses, ProductGetErrors, ProductGetResponses, ProductListResponses, ProductUpdateErrors, ProductUpdateResponses } from "./types.gen.js";
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -29,10 +29,9 @@ export declare class Customer extends HeyApiClient {
     /**
      * Create customer
      *
-     * Create a new customer with a wallet address
+     * Create a new customer
      */
     create<ThrowOnError extends boolean = false>(parameters?: {
-        walletAddress?: unknown;
         name?: string | null;
         email?: string | null;
         externalID?: string | null;
@@ -66,11 +65,19 @@ export declare class Customer extends HeyApiClient {
      */
     update<ThrowOnError extends boolean = false>(parameters: {
         id: string;
-        walletAddress?: unknown;
         name?: string | null;
         email?: string | null;
         externalID?: string | null;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<CustomerUpdateResponses, CustomerUpdateErrors, ThrowOnError, "fields">;
+    /**
+     * Check customer product payment
+     *
+     * Check if a customer has paid for a specific product
+     */
+    check<ThrowOnError extends boolean = false>(parameters: {
+        customerID: string;
+        productID: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<CustomerCheckResponses, CustomerCheckErrors, ThrowOnError, "fields">;
 }
 export declare class Product extends HeyApiClient {
     /**
@@ -81,9 +88,10 @@ export declare class Product extends HeyApiClient {
     create<ThrowOnError extends boolean = false>(parameters?: {
         walletID?: string;
         payoutWalletID?: string;
-        chainID?: 1 | 8453;
-        token?: unknown;
-        price?: string;
+        assetType?: string;
+        pricing?: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ProductCreateResponses, ProductCreateErrors, ThrowOnError, "fields">;
     /**
      * List products
@@ -114,27 +122,67 @@ export declare class Product extends HeyApiClient {
      */
     update<ThrowOnError extends boolean = false>(parameters: {
         id: string;
-        price?: string;
+        pricing?: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
         paused?: boolean;
+        supply?: number | null;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ProductUpdateResponses, ProductUpdateErrors, ThrowOnError, "fields">;
 }
 export declare class Session extends HeyApiClient {
     /**
      * Create checkout session
      *
-     * Generate a checkout session URL for a product and customer.
+     * Generate a checkout session URL for one or more products. Customer is optional - if not provided, a customer will be created from the buyer's wallet address at payment time.
      *
      * ```ts
      * const session = await client.checkout.session.create({
-     * productID: "prd_01ABC123",
-     * customerID: "cus_01DEF456"
+     * items: [
+     * { product: "prd_01ABC123", qty: 1 },
+     * { product: "prd_01DEF456", qty: 2 },
+     * ],
+     * customer: "cus_01DEF456", // optional
+     * theme: {
+     * primary: { light: "#7c3aed", dark: "#a78bfa" },
+     * background: { light: "#ffffff", dark: "#0b1220" },
+     * radius: "lg",
+     * }
      * });
      * console.log(session.url);
      * ```
      */
     create<ThrowOnError extends boolean = false>(parameters?: {
-        product?: string;
-        customer?: string;
+        items?: Array<{
+            product: string;
+            mode?: "required" | "optional" | "pick";
+            quantity?: number;
+            default?: boolean;
+            editable?: boolean;
+            max?: number | null;
+            group?: string | null;
+        }>;
+        customer?: string | null;
+        theme?: {
+            primary?: string | {
+                light: string;
+                dark: string;
+            };
+            background?: string | {
+                light: string;
+                dark: string;
+            };
+            radius?: "none" | "sm" | "md" | "lg" | "full";
+            font?: {
+                family?: string;
+                scale?: string;
+            };
+            logo?: string | {
+                light: string;
+                dark: string;
+            };
+            favicon?: string;
+            css?: string;
+        } | null;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<CheckoutSessionCreateResponses, CheckoutSessionCreateErrors, ThrowOnError, "fields">;
 }
 export declare class Checkout extends HeyApiClient {

package/dist/v1/gen/sdk.gen.js

@@ -25,13 +25,12 @@ export class Customer extends HeyApiClient {
     /**
      * Create customer
      *
-     * Create a new customer with a wallet address
+     * Create a new customer
      */
     create(parameters, options) {
         const params = buildClientParams([parameters], [
             {
                 args: [
-                    { in: "body", key: "walletAddress" },
                     { in: "body", key: "name" },
                     { in: "body", key: "email" },
                     { in: "body", key: "externalID" },
@@ -93,7 +92,6 @@ export class Customer extends HeyApiClient {
             {
                 args: [
                     { in: "path", key: "id" },
-                    { in: "body", key: "walletAddress" },
                     { in: "body", key: "name" },
                     { in: "body", key: "email" },
                     { in: "body", key: "externalID" },
@@ -111,6 +109,26 @@ export class Customer extends HeyApiClient {
             },
         });
     }
+    /**
+     * Check customer product payment
+     *
+     * Check if a customer has paid for a specific product
+     */
+    check(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "customerID" },
+                    { in: "path", key: "productID" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).get({
+            url: "/customer/{customerID}/products/{productID}/payment-status",
+            ...options,
+            ...params,
+        });
+    }
 }
 export class Product extends HeyApiClient {
     /**
@@ -124,9 +142,8 @@ export class Product extends HeyApiClient {
                 args: [
                     { in: "body", key: "walletID" },
                     { in: "body", key: "payoutWalletID" },
-                    { in: "body", key: "chainID" },
-                    { in: "body", key: "token" },
-                    { in: "body", key: "price" },
+                    { in: "body", key: "assetType" },
+                    { in: "body", key: "pricing" },
                 ],
             },
         ]);
@@ -185,8 +202,9 @@ export class Product extends HeyApiClient {
             {
                 args: [
                     { in: "path", key: "id" },
-                    { in: "body", key: "price" },
+                    { in: "body", key: "pricing" },
                     { in: "body", key: "paused" },
+                    { in: "body", key: "supply" },
                 ],
             },
         ]);
@@ -206,12 +224,20 @@ export class Session extends HeyApiClient {
     /**
      * Create checkout session
      *
-     * Generate a checkout session URL for a product and customer.
+     * Generate a checkout session URL for one or more products. Customer is optional - if not provided, a customer will be created from the buyer's wallet address at payment time.
      *
      * ```ts
      * const session = await client.checkout.session.create({
-     * productID: "prd_01ABC123",
-     * customerID: "cus_01DEF456"
+     * items: [
+     * { product: "prd_01ABC123", qty: 1 },
+     * { product: "prd_01DEF456", qty: 2 },
+     * ],
+     * customer: "cus_01DEF456", // optional
+     * theme: {
+     * primary: { light: "#7c3aed", dark: "#a78bfa" },
+     * background: { light: "#ffffff", dark: "#0b1220" },
+     * radius: "lg",
+     * }
      * });
      * console.log(session.url);
      * ```
@@ -220,8 +246,9 @@ export class Session extends HeyApiClient {
         const params = buildClientParams([parameters], [
             {
                 args: [
-                    { in: "body", key: "product" },
+                    { in: "body", key: "items" },
                     { in: "body", key: "customer" },
+                    { in: "body", key: "theme" },
                 ],
             },
         ]);

package/dist/v1/gen/types.gen.d.ts

@@ -13,7 +13,6 @@ export type NotFoundError = {
 };
 export type CustomerCreateData = {
     body?: {
-        walletAddress: unknown;
         name?: string | null;
         email?: string | null;
         externalID?: string | null;
@@ -39,7 +38,6 @@ export type CustomerCreateResponses = {
         timeCreated: unknown;
         timeUpdated: unknown;
         timeDeleted: unknown | null;
-        walletAddress: unknown;
         email: string | null;
         name: string | null;
         externalID: string | null;
@@ -62,7 +60,6 @@ export type CustomerListResponses = {
         timeCreated: unknown;
         timeUpdated: unknown;
         timeDeleted: unknown | null;
-        walletAddress: unknown;
         email: string | null;
         name: string | null;
         externalID: string | null;
@@ -124,7 +121,6 @@ export type CustomerGetResponses = {
         timeCreated: unknown;
         timeUpdated: unknown;
         timeDeleted: unknown | null;
-        walletAddress: unknown;
         email: string | null;
         name: string | null;
         externalID: string | null;
@@ -133,7 +129,6 @@ export type CustomerGetResponses = {
 export type CustomerGetResponse = CustomerGetResponses[keyof CustomerGetResponses];
 export type CustomerUpdateData = {
     body?: {
-        walletAddress?: unknown;
         name?: string | null;
         email?: string | null;
         externalID?: string | null;
@@ -165,20 +160,48 @@ export type CustomerUpdateResponses = {
         timeCreated: unknown;
         timeUpdated: unknown;
         timeDeleted: unknown | null;
-        walletAddress: unknown;
         email: string | null;
         name: string | null;
         externalID: string | null;
     };
 };
 export type CustomerUpdateResponse = CustomerUpdateResponses[keyof CustomerUpdateResponses];
+export type CustomerCheckData = {
+    body?: never;
+    path: {
+        customerID: string;
+        productID: string;
+    };
+    query?: never;
+    url: "/customer/{customerID}/products/{productID}/payment-status";
+};
+export type CustomerCheckErrors = {
+    /**
+     * Bad request
+     */
+    400: BadRequestError;
+};
+export type CustomerCheckError = CustomerCheckErrors[keyof CustomerCheckErrors];
+export type CustomerCheckResponses = {
+    /**
+     * Payment status
+     */
+    200: {
+        allowed: boolean;
+    };
+};
+export type CustomerCheckResponse = CustomerCheckResponses[keyof CustomerCheckResponses];
 export type ProductCreateData = {
     body?: {
         walletID: string;
         payoutWalletID: string;
-        chainID: 1 | 8453;
-        token: unknown;
-        price: string;
+        /**
+         * CAIP-19 asset type (e.g. eip155:1/erc20:0x6b17...)
+         */
+        assetType: string;
+        pricing: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
     };
     path?: never;
     query?: never;
@@ -203,12 +226,19 @@ export type ProductCreateResponses = {
         timeDeleted: unknown | null;
         walletID: string;
         payoutWalletID: string;
-        chainID: 1 | 8453;
-        token: unknown;
-        price: string;
+        /**
+         * CAIP-19 asset type (e.g. eip155:1/erc20:0x6b17...)
+         */
+        assetType: string;
+        pricing: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
+        supply: number | null;
+        sold: number;
         paused: boolean;
         name: string;
         description: string | null;
+        tokens: Array<string> | null;
     };
 };
 export type ProductCreateResponse = ProductCreateResponses[keyof ProductCreateResponses];
@@ -230,12 +260,19 @@ export type ProductListResponses = {
         timeDeleted: unknown | null;
         walletID: string;
         payoutWalletID: string;
-        chainID: 1 | 8453;
-        token: unknown;
-        price: string;
+        /**
+         * CAIP-19 asset type (e.g. eip155:1/erc20:0x6b17...)
+         */
+        assetType: string;
+        pricing: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
+        supply: number | null;
+        sold: number;
         paused: boolean;
         name: string;
         description: string | null;
+        tokens: Array<string> | null;
     }>;
 };
 export type ProductListResponse = ProductListResponses[keyof ProductListResponses];
@@ -296,19 +333,29 @@ export type ProductGetResponses = {
         timeDeleted: unknown | null;
         walletID: string;
         payoutWalletID: string;
-        chainID: 1 | 8453;
-        token: unknown;
-        price: string;
+        /**
+         * CAIP-19 asset type (e.g. eip155:1/erc20:0x6b17...)
+         */
+        assetType: string;
+        pricing: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
+        supply: number | null;
+        sold: number;
         paused: boolean;
         name: string;
         description: string | null;
+        tokens: Array<string> | null;
     };
 };
 export type ProductGetResponse = ProductGetResponses[keyof ProductGetResponses];
 export type ProductUpdateData = {
     body?: {
-        price?: string;
+        pricing?: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
         paused?: boolean;
+        supply?: number | null;
     };
     path: {
         id: string;
@@ -339,19 +386,55 @@ export type ProductUpdateResponses = {
         timeDeleted: unknown | null;
         walletID: string;
         payoutWalletID: string;
-        chainID: 1 | 8453;
-        token: unknown;
-        price: string;
+        /**
+         * CAIP-19 asset type (e.g. eip155:1/erc20:0x6b17...)
+         */
+        assetType: string;
+        pricing: string | number | boolean | null | Array<unknown> | {
+            [key: string]: unknown;
+        };
+        supply: number | null;
+        sold: number;
         paused: boolean;
         name: string;
         description: string | null;
+        tokens: Array<string> | null;
     };
 };
 export type ProductUpdateResponse = ProductUpdateResponses[keyof ProductUpdateResponses];
 export type CheckoutSessionCreateData = {
     body?: {
-        product: string;
-        customer: string;
+        items: Array<{
+            product: string;
+            mode?: "required" | "optional" | "pick";
+            quantity?: number;
+            default?: boolean;
+            editable?: boolean;
+            max?: number | null;
+            group?: string | null;
+        }>;
+        customer?: string | null;
+        theme?: {
+            primary?: string | {
+                light: string;
+                dark: string;
+            };
+            background?: string | {
+                light: string;
+                dark: string;
+            };
+            radius?: "none" | "sm" | "md" | "lg" | "full";
+            font?: {
+                family?: string;
+                scale?: string;
+            };
+            logo?: string | {
+                light: string;
+                dark: string;
+            };
+            favicon?: string;
+            css?: string;
+        } | null;
     };
     path?: never;
     query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackup-fi/sdk",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "module": "index.ts",
   "type": "module",
   "exports": {