@omnibase/core-js 0.2.0 → 0.4.0

package/README.md

@@ -257,7 +257,7 @@ The SDK requires environment configuration for proper operation:
 
 ```bash
 # Required environment variables
-OMNIBASE_API_URL=https://your-api-endpoint.com
+OMNIBASE_AUTH_URL=https://your-auth-endpoint.com
 
 # Optional database configuration
 DATABASE_URL=postgresql://user:pass@host:5432/dbname

package/dist/payments/index.cjs

@@ -0,0 +1,195 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/payments/index.ts
+var payments_exports = {};
+__export(payments_exports, {
+  createCheckout: () => createCheckout,
+  createCustomerPortal: () => createCustomerPortal,
+  getAvailableProducts: () => getAvailableProducts,
+  getProduct: () => getProduct,
+  getStripeConfig: () => getStripeConfig,
+  recordUsage: () => recordUsage
+});
+module.exports = __toCommonJS(payments_exports);
+
+// src/payments/config.ts
+async function getStripeConfig() {
+  const baseUrl = process.env.OMNIBASE_AUTH_URL;
+  if (!baseUrl) {
+    throw new Error("OMNIBASE_AUTH_URL is not configured");
+  }
+  try {
+    const response = await fetch(`${baseUrl}/api/v1/stripe/config`, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      credentials: "include"
+    });
+    if (!response.ok) {
+      const errorData = await response.text();
+      throw new Error(
+        `Failed to get Stripe config: ${response.status} - ${errorData}`
+      );
+    }
+    const data = await response.json();
+    return data;
+  } catch (error) {
+    console.error("Error getting Stripe config:", error);
+    throw error;
+  }
+}
+async function getAvailableProducts() {
+  const configResponse = await getStripeConfig();
+  if (!configResponse.data?.config) {
+    throw new Error("No Stripe configuration found");
+  }
+  const products = configResponse.data.config.products;
+  return products.map(transformProductToUIReady).sort(
+    (a, b) => a.pricing_display.sort_order - b.pricing_display.sort_order
+  );
+}
+async function getProduct(productId) {
+  const configResponse = await getStripeConfig();
+  if (!configResponse.data?.config) {
+    return null;
+  }
+  const product = configResponse.data.config.products.find(
+    (p) => p.id === productId
+  );
+  return product || null;
+}
+function transformProductToUIReady(product) {
+  const ui = product.ui || {};
+  return {
+    ...product,
+    pricing_display: {
+      name: ui.display_name || product.name,
+      tagline: ui.tagline,
+      features: ui.features || [],
+      badge: ui.badge,
+      cta_text: ui.cta_text || "Choose Plan",
+      highlighted: ui.highlighted || false,
+      sort_order: ui.sort_order || 0,
+      prices: product.prices.map((price) => {
+        const priceUI = price.ui || {};
+        return {
+          id: price.id,
+          display_name: priceUI.display_name || formatDefaultPriceName(price),
+          formatted_price: formatPrice(price, priceUI),
+          billing_period: priceUI.billing_period || formatDefaultBillingPeriod(price),
+          features: priceUI.features || [],
+          limits: priceUI.limits || []
+        };
+      })
+    }
+  };
+}
+function formatPrice(price, priceUI) {
+  if (priceUI.price_display?.custom_text) {
+    return priceUI.price_display.custom_text;
+  }
+  if (!price.amount || price.amount === 0) {
+    return "Free";
+  }
+  const amount = price.amount / 100;
+  const currency = price.currency.toUpperCase();
+  let formattedPrice = "";
+  if (priceUI.price_display?.show_currency !== false) {
+    const currencySymbol = getCurrencySymbol(currency);
+    formattedPrice = `${currencySymbol}${amount.toFixed(2)}`;
+  } else {
+    formattedPrice = amount.toFixed(2);
+  }
+  if (priceUI.price_display?.suffix) {
+    formattedPrice += ` ${priceUI.price_display.suffix}`;
+  }
+  return formattedPrice;
+}
+function getCurrencySymbol(currency) {
+  const symbols = {
+    USD: "$",
+    EUR: "\u20AC",
+    GBP: "\xA3",
+    JPY: "\xA5",
+    CAD: "C$",
+    AUD: "A$"
+  };
+  return symbols[currency] || currency;
+}
+function formatDefaultPriceName(price) {
+  if (price.interval) {
+    return price.interval.charAt(0).toUpperCase() + price.interval.slice(1);
+  }
+  return "One-time";
+}
+function formatDefaultBillingPeriod(price) {
+  if (price.interval) {
+    const count = price.interval_count || 1;
+    const period = count === 1 ? price.interval : `${count} ${price.interval}s`;
+    return `per ${period}`;
+  }
+  return "one-time";
+}
+
+// src/payments/checkout.ts
+var API_URL = process.env.OMNIBASE_API_URL;
+if (!API_URL) throw new Error("must set OMNIBASE_API_URL in env variables");
+var createCheckout = async (options) => {
+  const response = await fetch(API_URL + "/api/v1/payments/checkout", {
+    method: "POST",
+    body: JSON.stringify(options)
+  });
+  const result = await response.json();
+  return result;
+};
+
+// src/payments/portal.ts
+var API_URL2 = process.env.OMNIBASE_API_URL;
+if (!API_URL2) throw new Error("must set OMNIBASE_API_URL in env variables");
+var createCustomerPortal = async (options) => {
+  const response = await fetch(API_URL2 + "/api/v1/payments/portal", {
+    method: "POST",
+    body: JSON.stringify(options)
+  });
+  const result = await response.json();
+  return result;
+};
+
+// src/payments/usage.ts
+var API_URL3 = process.env.OMNIBASE_API_URL;
+if (!API_URL3) throw new Error("must set OMNIBASE_API_URL in env variables");
+var recordUsage = async (options) => {
+  const response = await fetch(API_URL3 + "/api/v1/payments/usage", {
+    method: "POST",
+    body: JSON.stringify(options)
+  });
+  const result = await response.json();
+  return result;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCheckout,
+  createCustomerPortal,
+  getAvailableProducts,
+  getProduct,
+  getStripeConfig,
+  recordUsage
+});

package/dist/payments/index.d.cts

@@ -0,0 +1,191 @@
+import { A as ApiResponse } from '../types-DgsX5kVK.cjs';
+
+/**
+ * Stripe configuration types mirroring the Go structs and JSON schema
+ */
+type StripeConfigResponse = ApiResponse<{
+    config: StripeConfiguration;
+    message?: string;
+}>;
+interface StripeConfiguration {
+    version: string;
+    products: Product[];
+}
+interface Product {
+    id: string;
+    name: string;
+    description?: string;
+    type?: "service" | "good" | "metered";
+    prices: Price[];
+    ui?: ProductUI;
+}
+interface Price {
+    id: string;
+    amount?: number;
+    currency: string;
+    interval?: "month" | "year" | "week" | "day";
+    interval_count?: number;
+    usage_type?: "licensed" | "metered";
+    billing_scheme?: "per_unit" | "tiered";
+    tiers_mode?: "graduated" | "volume";
+    tiers?: Tier[];
+    ui?: PriceUI;
+}
+interface Tier {
+    up_to: number | "inf";
+    flat_amount?: number;
+    unit_amount?: number;
+}
+interface ProductUI {
+    display_name?: string;
+    tagline?: string;
+    features?: string[];
+    badge?: string;
+    cta_text?: string;
+    highlighted?: boolean;
+    sort_order?: number;
+}
+interface PriceUI {
+    display_name?: string;
+    price_display?: PriceDisplay;
+    billing_period?: string;
+    features?: string[];
+    limits?: PriceLimit[];
+}
+interface PriceDisplay {
+    custom_text?: string;
+    show_currency?: boolean;
+    suffix?: string;
+}
+interface PriceLimit {
+    text: string;
+    value?: number;
+    unit?: string;
+}
+interface ProductWithPricingUI extends Product {
+    pricing_display: {
+        name: string;
+        tagline?: string;
+        features: string[];
+        badge?: string;
+        cta_text: string;
+        highlighted: boolean;
+        sort_order: number;
+        prices: Array<{
+            id: string;
+            display_name: string;
+            formatted_price: string;
+            billing_period: string;
+            features: string[];
+            limits: Array<{
+                text: string;
+                value?: number;
+                unit?: string;
+            }>;
+        }>;
+    };
+}
+
+/**
+ * Get the current Stripe configuration from the database
+ *
+ * Retrieves the latest Stripe configuration including products, prices,
+ * and UI customization data. This configuration represents the current
+ * active pricing structure with all UI elements for pricing table rendering.
+ *
+ * @returns Promise resolving to the current Stripe configuration
+ *
+ * @throws {Error} When OMNIBASE_AUTH_URL environment variable is not configured
+ * @throws {Error} When the API request fails due to network issues
+ * @throws {Error} When the server returns an error response (4xx, 5xx status codes)
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const config = await getStripeConfig();
+ * console.log(`Found ${config.data.config.products.length} products`);
+ *
+ * // Access product UI configuration
+ * config.data.config.products.forEach(product => {
+ *   console.log(`${product.name}: ${product.ui?.tagline || 'No tagline'}`);
+ * });
+ * ```
+ */
+declare function getStripeConfig(): Promise<StripeConfigResponse>;
+/**
+ * Get available products with UI-ready pricing data
+ *
+ * Transforms the raw Stripe configuration into UI-ready format for pricing
+ * table rendering. Includes formatted pricing, features, limits, and all
+ * display customizations needed for marketing pages.
+ *
+ * @returns Promise resolving to products ready for UI consumption
+ *
+ * @throws {Error} When OMNIBASE_AUTH_URL environment variable is not configured
+ * @throws {Error} When the API request fails or configuration is invalid
+ *
+ * @example
+ * Pricing table rendering:
+ * ```typescript
+ * const products = await getAvailableProducts();
+ *
+ * products.forEach(product => {
+ *   const display = product.pricing_display;
+ *   console.log(`${display.name} - ${display.tagline}`);
+ *
+ *   display.prices.forEach(price => {
+ *     console.log(`  ${price.display_name}: ${price.formatted_price}`);
+ *   });
+ * });
+ * ```
+ */
+declare function getAvailableProducts(): Promise<ProductWithPricingUI[]>;
+/**
+ * Get a specific product by ID
+ *
+ * Retrieves a single product configuration by its ID from the current
+ * Stripe configuration. Useful for product-specific operations.
+ *
+ * @param productId - The configuration product ID to retrieve
+ * @returns Promise resolving to the product or null if not found
+ *
+ * @example
+ * ```typescript
+ * const product = await getProduct('starter_plan');
+ * if (product) {
+ *   console.log(`Found product: ${product.name}`);
+ * }
+ * ```
+ */
+declare function getProduct(productId: string): Promise<Product | null>;
+
+type CheckoutOptions = {
+    priceId: string;
+    mode: "payment" | "subscription";
+    successUrl: string;
+    cancelUrl: string;
+    customerId?: string;
+};
+type CreateCheckoutResponse = ApiResponse<{
+    url: string;
+    sessionId: string;
+}>;
+declare const createCheckout: (options: CheckoutOptions) => Promise<CreateCheckoutResponse>;
+
+type PortalOptions = {
+    customer_id: string;
+    return_url: string;
+};
+type CreateCustomerPortalResponse = ApiResponse<{
+    url: string;
+}>;
+declare const createCustomerPortal: (options: PortalOptions) => Promise<CreateCustomerPortalResponse>;
+
+type UsageOptions = {
+    meter_event_name: string;
+    customer_id: string;
+    value: string;
+};
+declare const recordUsage: (options: UsageOptions) => Promise<ApiResponse<"">>;
+
+export { type CheckoutOptions, type CreateCheckoutResponse, type CreateCustomerPortalResponse, type PortalOptions, type Price, type PriceDisplay, type PriceLimit, type PriceUI, type Product, type ProductUI, type ProductWithPricingUI, type StripeConfigResponse, type StripeConfiguration, type Tier, type UsageOptions, createCheckout, createCustomerPortal, getAvailableProducts, getProduct, getStripeConfig, recordUsage };

package/dist/payments/index.d.ts

@@ -0,0 +1,191 @@
+import { A as ApiResponse } from '../types-DgsX5kVK.js';
+
+/**
+ * Stripe configuration types mirroring the Go structs and JSON schema
+ */
+type StripeConfigResponse = ApiResponse<{
+    config: StripeConfiguration;
+    message?: string;
+}>;
+interface StripeConfiguration {
+    version: string;
+    products: Product[];
+}
+interface Product {
+    id: string;
+    name: string;
+    description?: string;
+    type?: "service" | "good" | "metered";
+    prices: Price[];
+    ui?: ProductUI;
+}
+interface Price {
+    id: string;
+    amount?: number;
+    currency: string;
+    interval?: "month" | "year" | "week" | "day";
+    interval_count?: number;
+    usage_type?: "licensed" | "metered";
+    billing_scheme?: "per_unit" | "tiered";
+    tiers_mode?: "graduated" | "volume";
+    tiers?: Tier[];
+    ui?: PriceUI;
+}
+interface Tier {
+    up_to: number | "inf";
+    flat_amount?: number;
+    unit_amount?: number;
+}
+interface ProductUI {
+    display_name?: string;
+    tagline?: string;
+    features?: string[];
+    badge?: string;
+    cta_text?: string;
+    highlighted?: boolean;
+    sort_order?: number;
+}
+interface PriceUI {
+    display_name?: string;
+    price_display?: PriceDisplay;
+    billing_period?: string;
+    features?: string[];
+    limits?: PriceLimit[];
+}
+interface PriceDisplay {
+    custom_text?: string;
+    show_currency?: boolean;
+    suffix?: string;
+}
+interface PriceLimit {
+    text: string;
+    value?: number;
+    unit?: string;
+}
+interface ProductWithPricingUI extends Product {
+    pricing_display: {
+        name: string;
+        tagline?: string;
+        features: string[];
+        badge?: string;
+        cta_text: string;
+        highlighted: boolean;
+        sort_order: number;
+        prices: Array<{
+            id: string;
+            display_name: string;
+            formatted_price: string;
+            billing_period: string;
+            features: string[];
+            limits: Array<{
+                text: string;
+                value?: number;
+                unit?: string;
+            }>;
+        }>;
+    };
+}
+
+/**
+ * Get the current Stripe configuration from the database
+ *
+ * Retrieves the latest Stripe configuration including products, prices,
+ * and UI customization data. This configuration represents the current
+ * active pricing structure with all UI elements for pricing table rendering.
+ *
+ * @returns Promise resolving to the current Stripe configuration
+ *
+ * @throws {Error} When OMNIBASE_AUTH_URL environment variable is not configured
+ * @throws {Error} When the API request fails due to network issues
+ * @throws {Error} When the server returns an error response (4xx, 5xx status codes)
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const config = await getStripeConfig();
+ * console.log(`Found ${config.data.config.products.length} products`);
+ *
+ * // Access product UI configuration
+ * config.data.config.products.forEach(product => {
+ *   console.log(`${product.name}: ${product.ui?.tagline || 'No tagline'}`);
+ * });
+ * ```
+ */
+declare function getStripeConfig(): Promise<StripeConfigResponse>;
+/**
+ * Get available products with UI-ready pricing data
+ *
+ * Transforms the raw Stripe configuration into UI-ready format for pricing
+ * table rendering. Includes formatted pricing, features, limits, and all
+ * display customizations needed for marketing pages.
+ *
+ * @returns Promise resolving to products ready for UI consumption
+ *
+ * @throws {Error} When OMNIBASE_AUTH_URL environment variable is not configured
+ * @throws {Error} When the API request fails or configuration is invalid
+ *
+ * @example
+ * Pricing table rendering:
+ * ```typescript
+ * const products = await getAvailableProducts();
+ *
+ * products.forEach(product => {
+ *   const display = product.pricing_display;
+ *   console.log(`${display.name} - ${display.tagline}`);
+ *
+ *   display.prices.forEach(price => {
+ *     console.log(`  ${price.display_name}: ${price.formatted_price}`);
+ *   });
+ * });
+ * ```
+ */
+declare function getAvailableProducts(): Promise<ProductWithPricingUI[]>;
+/**
+ * Get a specific product by ID
+ *
+ * Retrieves a single product configuration by its ID from the current
+ * Stripe configuration. Useful for product-specific operations.
+ *
+ * @param productId - The configuration product ID to retrieve
+ * @returns Promise resolving to the product or null if not found
+ *
+ * @example
+ * ```typescript
+ * const product = await getProduct('starter_plan');
+ * if (product) {
+ *   console.log(`Found product: ${product.name}`);
+ * }
+ * ```
+ */
+declare function getProduct(productId: string): Promise<Product | null>;
+
+type CheckoutOptions = {
+    priceId: string;
+    mode: "payment" | "subscription";
+    successUrl: string;
+    cancelUrl: string;
+    customerId?: string;
+};
+type CreateCheckoutResponse = ApiResponse<{
+    url: string;
+    sessionId: string;
+}>;
+declare const createCheckout: (options: CheckoutOptions) => Promise<CreateCheckoutResponse>;
+
+type PortalOptions = {
+    customer_id: string;
+    return_url: string;
+};
+type CreateCustomerPortalResponse = ApiResponse<{
+    url: string;
+}>;
+declare const createCustomerPortal: (options: PortalOptions) => Promise<CreateCustomerPortalResponse>;
+
+type UsageOptions = {
+    meter_event_name: string;
+    customer_id: string;
+    value: string;
+};
+declare const recordUsage: (options: UsageOptions) => Promise<ApiResponse<"">>;
+
+export { type CheckoutOptions, type CreateCheckoutResponse, type CreateCustomerPortalResponse, type PortalOptions, type Price, type PriceDisplay, type PriceLimit, type PriceUI, type Product, type ProductUI, type ProductWithPricingUI, type StripeConfigResponse, type StripeConfiguration, type Tier, type UsageOptions, createCheckout, createCustomerPortal, getAvailableProducts, getProduct, getStripeConfig, recordUsage };