@buildspacestudio/sdk 0.2.2 → 0.4.0

package/dist/billing/index.d.ts

@@ -0,0 +1,60 @@
+import { f as BillingStatusResponse, e as BillingProduct, d as BillingPrice, C as CreateServerCheckoutOptions, a as BillingCheckoutResponse, h as CreateServerPortalSessionOptions, c as BillingPortalResponse, g as BillingSubscriptionResponse, b as BillingEntitlementsResponse } from '../client-d7kX5WfR.js';
+export { B as BillingClientNamespace, s as shouldShowTestBanner } from '../client-d7kX5WfR.js';
+import { H as HttpTransport } from '../http-D2gXpNpr.js';
+
+declare class BillingServerNamespace {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Read whether billing is enabled for the app environment tied to this API
+     * key, and whether the connected Stripe account is in test or live mode.
+     *
+     * Render a "Test mode" banner in your app whenever `testMode` is true.
+     */
+    getStatus(): Promise<BillingStatusResponse>;
+    /**
+     * List the active billing products configured for the app environment tied to
+     * this API key.
+     */
+    listProducts(): Promise<{
+        products: BillingProduct[];
+    }>;
+    /**
+     * List the active billing prices configured for the app environment tied to
+     * this API key.
+     */
+    listPrices(): Promise<{
+        prices: BillingPrice[];
+    }>;
+    /**
+     * Create a Stripe Checkout Session on the creator's connected Stripe account.
+     *
+     * Use `userId` for Buildspace-authenticated users, or `appUserId` when your
+     * app uses its own auth system and you want Buildspace to track billing state
+     * against an app-defined user id.
+     */
+    createCheckout(opts: CreateServerCheckoutOptions): Promise<BillingCheckoutResponse>;
+    /**
+     * Create a Stripe-hosted customer portal session for the specified billing
+     * identity.
+     */
+    createPortalSession(opts: CreateServerPortalSessionOptions): Promise<BillingPortalResponse>;
+    /**
+     * Read the current subscription state for a Buildspace user or app-defined
+     * billing identity.
+     */
+    getSubscription(opts?: {
+        appUserId?: string;
+        userId?: string;
+    }): Promise<BillingSubscriptionResponse>;
+    /**
+     * Read the current paid entitlement state for a Buildspace user or app-defined
+     * billing identity.
+     */
+    getEntitlements(opts?: {
+        appUserId?: string;
+        userId?: string;
+    }): Promise<BillingEntitlementsResponse>;
+}
+
+export { BillingCheckoutResponse, BillingEntitlementsResponse, BillingPortalResponse, BillingPrice, BillingProduct, BillingServerNamespace, BillingStatusResponse, BillingSubscriptionResponse, CreateServerCheckoutOptions, CreateServerPortalSessionOptions };

package/dist/billing/index.js

@@ -0,0 +1,222 @@
+// src/billing/shared.ts
+function shouldShowTestBanner(status) {
+  return status.testMode;
+}
+function billingIdentityQuery(opts) {
+  return { app_user_id: opts?.appUserId, user_id: opts?.userId };
+}
+function checkoutRequestBody(opts) {
+  return {
+    app_user_id: "appUserId" in opts ? opts.appUserId : void 0,
+    cancel_url: opts.cancelUrl,
+    checkout_request_id: opts.checkoutRequestId,
+    lookup_key: opts.lookupKey,
+    metadata: opts.metadata,
+    price_id: opts.priceId,
+    quantity: opts.quantity,
+    success_url: opts.successUrl,
+    user_id: "userId" in opts ? opts.userId : void 0
+  };
+}
+function portalRequestBody(opts) {
+  return {
+    app_user_id: "appUserId" in opts ? opts.appUserId : void 0,
+    return_url: opts.returnUrl,
+    user_id: "userId" in opts ? opts.userId : void 0
+  };
+}
+
+// src/billing/client.ts
+function redirectTo(url) {
+  const browser = globalThis;
+  if (!browser.window?.location) {
+    throw new Error("redirectToCheckout can only be used in a browser environment");
+  }
+  browser.window.location.href = url;
+}
+var BillingClientNamespace = class {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  /**
+   * Read whether billing is enabled for the app environment tied to this
+   * publishable key, and whether the connected Stripe account is in test or
+   * live mode.
+   *
+   * Render a "Test mode" banner in your app whenever `testMode` is true.
+   */
+  getStatus() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/status"
+    });
+  }
+  /**
+   * List the active billing products for the app environment tied to this
+   * publishable key.
+   */
+  listProducts() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/products"
+    });
+  }
+  /**
+   * List the active billing prices for the app environment tied to this
+   * publishable key.
+   */
+  listPrices() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/prices"
+    });
+  }
+  /**
+   * Create a Checkout Session for the signed-in browser user and redirect to
+   * the Stripe-hosted Checkout page.
+   *
+   * This method depends on a Buildspace session being available through
+   * `setSession()` or your app's authenticated request context.
+   */
+  async redirectToCheckout(opts) {
+    const checkout = await this.transport.request({
+      service: "billing",
+      path: "/v1/billing/checkout",
+      method: "POST",
+      body: checkoutRequestBody(opts)
+    });
+    redirectTo(checkout.url);
+  }
+  /**
+   * Open the Stripe-hosted customer portal for the signed-in browser user.
+   */
+  async redirectToPortal(opts) {
+    const portal = await this.transport.request({
+      service: "billing",
+      path: "/v1/billing/portal",
+      method: "POST",
+      body: portalRequestBody(opts)
+    });
+    redirectTo(portal.url);
+  }
+  /**
+   * Discoverable alias for redirectToPortal — opens the Stripe-hosted customer
+   * portal so the signed-in user can manage their subscription, payment method,
+   * and invoices.
+   */
+  manageSubscription(opts) {
+    return this.redirectToPortal(opts);
+  }
+  /**
+   * Read the current subscription state for the signed-in browser user.
+   */
+  getSubscription() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/subscription"
+    });
+  }
+  /**
+   * Read the current paid entitlement state for the signed-in browser user.
+   */
+  getEntitlements() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/entitlements"
+    });
+  }
+};
+
+// src/billing/server.ts
+var BillingServerNamespace = class {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  /**
+   * Read whether billing is enabled for the app environment tied to this API
+   * key, and whether the connected Stripe account is in test or live mode.
+   *
+   * Render a "Test mode" banner in your app whenever `testMode` is true.
+   */
+  getStatus() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/status"
+    });
+  }
+  /**
+   * List the active billing products configured for the app environment tied to
+   * this API key.
+   */
+  listProducts() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/products"
+    });
+  }
+  /**
+   * List the active billing prices configured for the app environment tied to
+   * this API key.
+   */
+  listPrices() {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/prices"
+    });
+  }
+  /**
+   * Create a Stripe Checkout Session on the creator's connected Stripe account.
+   *
+   * Use `userId` for Buildspace-authenticated users, or `appUserId` when your
+   * app uses its own auth system and you want Buildspace to track billing state
+   * against an app-defined user id.
+   */
+  createCheckout(opts) {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/checkout",
+      method: "POST",
+      body: checkoutRequestBody(opts)
+    });
+  }
+  /**
+   * Create a Stripe-hosted customer portal session for the specified billing
+   * identity.
+   */
+  createPortalSession(opts) {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/portal",
+      method: "POST",
+      body: portalRequestBody(opts)
+    });
+  }
+  /**
+   * Read the current subscription state for a Buildspace user or app-defined
+   * billing identity.
+   */
+  getSubscription(opts) {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/subscription",
+      query: billingIdentityQuery(opts)
+    });
+  }
+  /**
+   * Read the current paid entitlement state for a Buildspace user or app-defined
+   * billing identity.
+   */
+  getEntitlements(opts) {
+    return this.transport.request({
+      service: "billing",
+      path: "/v1/billing/entitlements",
+      query: billingIdentityQuery(opts)
+    });
+  }
+};
+
+export { BillingClientNamespace, BillingServerNamespace, shouldShowTestBanner };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/billing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/billing/shared.ts","../../src/billing/client.ts","../../src/billing/server.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export interface BillingProduct {\n  active: boolean;\n  createdAt: string;\n  description: string | null;\n  id: string;\n  name: string;\n}\n\nexport interface BillingPrice {\n  active: boolean;\n  amountCents: number | null;\n  createdAt: string;\n  currency: string;\n  id: string;\n  interval: string | null;\n  lookupKey: string | null;\n  productId: string;\n  productName: string;\n  type: \"one_time\" | \"recurring\" | \"metered\";\n}\n\nexport interface CreateServerCheckoutOptions {\n  appUserId?: string;\n  cancelUrl: string;\n  checkoutRequestId?: string;\n  lookupKey?: string;\n  metadata?: Record<string, string>;\n  priceId?: string;\n  quantity?: number;\n  successUrl: string;\n  userId?: string;\n}\n\nexport interface CreateClientCheckoutOptions {\n  cancelUrl: string;\n  checkoutRequestId?: string;\n  lookupKey?: string;\n  metadata?: Record<string, string>;\n  priceId?: string;\n  quantity?: number;\n  successUrl: string;\n}\n\nexport interface BillingCheckoutResponse {\n  id?: string;\n  stripe_checkout_session_id: string;\n  url: string;\n}\n\nexport interface BillingPortalResponse {\n  url: string;\n}\n\nexport interface BillingSubscriptionResponse {\n  subscription: {\n    cancelAtPeriodEnd: boolean;\n    currentPeriodEnd: string | null;\n    id: string;\n    status: string;\n  } | null;\n}\n\nexport interface BillingEntitlementsResponse {\n  active: boolean;\n  subscription: { currentPeriodEnd: string | null; id: string; status: string } | null;\n}\n\nexport type BillingMode = \"test\" | \"live\";\n\nexport type BillingConfigStatus = \"disabled\" | \"setup_required\" | \"active\" | \"paused\";\n\nexport interface BillingStatusResponse {\n  enabled: boolean;\n  mode: BillingMode | null;\n  status: BillingConfigStatus | null;\n  testMode: boolean;\n}\n\n/**\n * True when the app environment is wired to a Stripe test-mode account.\n *\n * Use this to render a \"Test mode\" banner in your app — payments aren't real\n * charges, and end-buyers should not be expected to enter real card details.\n */\nexport function shouldShowTestBanner(status: BillingStatusResponse): boolean {\n  return status.testMode;\n}\n\nexport interface CreateServerPortalSessionOptions {\n  appUserId?: string;\n  returnUrl: string;\n  userId?: string;\n}\n\nexport interface CreateClientPortalSessionOptions {\n  returnUrl: string;\n}\n\nexport function billingIdentityQuery(opts?: { appUserId?: string; userId?: string }) {\n  return { app_user_id: opts?.appUserId, user_id: opts?.userId };\n}\n\nexport function checkoutRequestBody(\n  opts: CreateServerCheckoutOptions | CreateClientCheckoutOptions\n) {\n  return {\n    app_user_id: \"appUserId\" in opts ? opts.appUserId : undefined,\n    cancel_url: opts.cancelUrl,\n    checkout_request_id: opts.checkoutRequestId,\n    lookup_key: opts.lookupKey,\n    metadata: opts.metadata,\n    price_id: opts.priceId,\n    quantity: opts.quantity,\n    success_url: opts.successUrl,\n    user_id: \"userId\" in opts ? opts.userId : undefined,\n  };\n}\n\nexport function portalRequestBody(\n  opts: CreateServerPortalSessionOptions | CreateClientPortalSessionOptions\n) {\n  return {\n    app_user_id: \"appUserId\" in opts ? opts.appUserId : undefined,\n    return_url: opts.returnUrl,\n    user_id: \"userId\" in opts ? opts.userId : undefined,\n  };\n}\n","import type { HttpTransport } from \"../http\";\nimport {\n  type BillingEntitlementsResponse,\n  type BillingPortalResponse,\n  type BillingPrice,\n  type BillingProduct,\n  type BillingStatusResponse,\n  type BillingSubscriptionResponse,\n  type CreateClientCheckoutOptions,\n  type CreateClientPortalSessionOptions,\n  checkoutRequestBody,\n  portalRequestBody,\n} from \"./shared\";\n\nfunction redirectTo(url: string): void {\n  const browser = globalThis as typeof globalThis & {\n    window?: { location: { href: string } };\n  };\n  if (!browser.window?.location) {\n    throw new Error(\"redirectToCheckout can only be used in a browser environment\");\n  }\n  browser.window.location.href = url;\n}\n\nexport class BillingClientNamespace {\n  private readonly transport: HttpTransport;\n\n  constructor(transport: HttpTransport) {\n    this.transport = transport;\n  }\n\n  /**\n   * Read whether billing is enabled for the app environment tied to this\n   * publishable key, and whether the connected Stripe account is in test or\n   * live mode.\n   *\n   * Render a \"Test mode\" banner in your app whenever `testMode` is true.\n   */\n  getStatus(): Promise<BillingStatusResponse> {\n    return this.transport.request<BillingStatusResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/status\",\n    });\n  }\n\n  /**\n   * List the active billing products for the app environment tied to this\n   * publishable key.\n   */\n  listProducts(): Promise<{ products: BillingProduct[] }> {\n    return this.transport.request<{ products: BillingProduct[] }>({\n      service: \"billing\",\n      path: \"/v1/billing/products\",\n    });\n  }\n\n  /**\n   * List the active billing prices for the app environment tied to this\n   * publishable key.\n   */\n  listPrices(): Promise<{ prices: BillingPrice[] }> {\n    return this.transport.request<{ prices: BillingPrice[] }>({\n      service: \"billing\",\n      path: \"/v1/billing/prices\",\n    });\n  }\n\n  /**\n   * Create a Checkout Session for the signed-in browser user and redirect to\n   * the Stripe-hosted Checkout page.\n   *\n   * This method depends on a Buildspace session being available through\n   * `setSession()` or your app's authenticated request context.\n   */\n  async redirectToCheckout(opts: CreateClientCheckoutOptions): Promise<void> {\n    const checkout = await this.transport.request<{ url: string }>({\n      service: \"billing\",\n      path: \"/v1/billing/checkout\",\n      method: \"POST\",\n      body: checkoutRequestBody(opts),\n    });\n    redirectTo(checkout.url);\n  }\n\n  /**\n   * Open the Stripe-hosted customer portal for the signed-in browser user.\n   */\n  async redirectToPortal(opts: CreateClientPortalSessionOptions): Promise<void> {\n    const portal = await this.transport.request<BillingPortalResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/portal\",\n      method: \"POST\",\n      body: portalRequestBody(opts),\n    });\n    redirectTo(portal.url);\n  }\n\n  /**\n   * Discoverable alias for redirectToPortal — opens the Stripe-hosted customer\n   * portal so the signed-in user can manage their subscription, payment method,\n   * and invoices.\n   */\n  manageSubscription(opts: CreateClientPortalSessionOptions): Promise<void> {\n    return this.redirectToPortal(opts);\n  }\n\n  /**\n   * Read the current subscription state for the signed-in browser user.\n   */\n  getSubscription(): Promise<BillingSubscriptionResponse> {\n    return this.transport.request<BillingSubscriptionResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/subscription\",\n    });\n  }\n\n  /**\n   * Read the current paid entitlement state for the signed-in browser user.\n   */\n  getEntitlements(): Promise<BillingEntitlementsResponse> {\n    return this.transport.request<BillingEntitlementsResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/entitlements\",\n    });\n  }\n}\n","import type { HttpTransport } from \"../http\";\nimport {\n  type BillingCheckoutResponse,\n  type BillingEntitlementsResponse,\n  type BillingPortalResponse,\n  type BillingPrice,\n  type BillingProduct,\n  type BillingStatusResponse,\n  type BillingSubscriptionResponse,\n  billingIdentityQuery,\n  type CreateServerCheckoutOptions,\n  type CreateServerPortalSessionOptions,\n  checkoutRequestBody,\n  portalRequestBody,\n} from \"./shared\";\n\nexport type {\n  BillingCheckoutResponse,\n  BillingEntitlementsResponse,\n  BillingPortalResponse,\n  BillingPrice,\n  BillingProduct,\n  BillingStatusResponse,\n  BillingSubscriptionResponse,\n  CreateServerCheckoutOptions,\n  CreateServerPortalSessionOptions,\n} from \"./shared\";\nexport { shouldShowTestBanner } from \"./shared\";\n\nexport class BillingServerNamespace {\n  private readonly transport: HttpTransport;\n\n  constructor(transport: HttpTransport) {\n    this.transport = transport;\n  }\n\n  /**\n   * Read whether billing is enabled for the app environment tied to this API\n   * key, and whether the connected Stripe account is in test or live mode.\n   *\n   * Render a \"Test mode\" banner in your app whenever `testMode` is true.\n   */\n  getStatus(): Promise<BillingStatusResponse> {\n    return this.transport.request<BillingStatusResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/status\",\n    });\n  }\n\n  /**\n   * List the active billing products configured for the app environment tied to\n   * this API key.\n   */\n  listProducts(): Promise<{ products: BillingProduct[] }> {\n    return this.transport.request<{ products: BillingProduct[] }>({\n      service: \"billing\",\n      path: \"/v1/billing/products\",\n    });\n  }\n\n  /**\n   * List the active billing prices configured for the app environment tied to\n   * this API key.\n   */\n  listPrices(): Promise<{ prices: BillingPrice[] }> {\n    return this.transport.request<{ prices: BillingPrice[] }>({\n      service: \"billing\",\n      path: \"/v1/billing/prices\",\n    });\n  }\n\n  /**\n   * Create a Stripe Checkout Session on the creator's connected Stripe account.\n   *\n   * Use `userId` for Buildspace-authenticated users, or `appUserId` when your\n   * app uses its own auth system and you want Buildspace to track billing state\n   * against an app-defined user id.\n   */\n  createCheckout(opts: CreateServerCheckoutOptions): Promise<BillingCheckoutResponse> {\n    return this.transport.request<BillingCheckoutResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/checkout\",\n      method: \"POST\",\n      body: checkoutRequestBody(opts),\n    });\n  }\n\n  /**\n   * Create a Stripe-hosted customer portal session for the specified billing\n   * identity.\n   */\n  createPortalSession(opts: CreateServerPortalSessionOptions): Promise<BillingPortalResponse> {\n    return this.transport.request<BillingPortalResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/portal\",\n      method: \"POST\",\n      body: portalRequestBody(opts),\n    });\n  }\n\n  /**\n   * Read the current subscription state for a Buildspace user or app-defined\n   * billing identity.\n   */\n  getSubscription(opts?: {\n    appUserId?: string;\n    userId?: string;\n  }): Promise<BillingSubscriptionResponse> {\n    return this.transport.request<BillingSubscriptionResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/subscription\",\n      query: billingIdentityQuery(opts),\n    });\n  }\n\n  /**\n   * Read the current paid entitlement state for a Buildspace user or app-defined\n   * billing identity.\n   */\n  getEntitlements(opts?: {\n    appUserId?: string;\n    userId?: string;\n  }): Promise<BillingEntitlementsResponse> {\n    return this.transport.request<BillingEntitlementsResponse>({\n      service: \"billing\",\n      path: \"/v1/billing/entitlements\",\n      query: billingIdentityQuery(opts),\n    });\n  }\n}\n"]}