@libreapps/checkout 2.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @libreapps/checkout@2.0.0 build /Users/jetstart/dev/libre-apps/ui-main/pkg/checkout
+> tsc --outDir dist --declaration --emitDeclarationOnly false --module ESNext --esModuleInterop true --skipLibCheck true --sourceMap true
+

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# @libreapps/checkout
+
+## 2.0.1
+
+### Patch Changes
+
+- Reverted package scope to @libreapps.
+- Updated dependencies
+  - @libreapps/auth@3.0.1
+  - @libreapps/commerce@7.5.1
+  - @libreapps/ui@5.4.1
+
+## 2.0.0
+
+### Minor Changes
+
+- 6f41d89: Initial release of LibreApps UI packages to NPM
+
+### Patch Changes
+
+- Updated dependencies [6f41d89]
+  - @libreapps/ui@5.4.0
+  - @libreapps/auth@3.0.0
+  - @libreapps/commerce@7.5.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LibreApps.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,211 @@
+# @libreapps/checkout
+
+Embeddable checkout widget for LibreApps Commerce - a Stripe-like checkout experience.
+
+## Installation
+
+```bash
+npm install @libreapps/checkout
+# or
+pnpm add @libreapps/checkout
+# or
+yarn add @libreapps/checkout
+```
+
+## Quick Start
+
+### React Integration
+
+```tsx
+import { CheckoutProvider, CheckoutForm } from '@libreapps/checkout'
+
+function CheckoutPage() {
+  return (
+    <CheckoutProvider
+      options={{
+        apiKey: 'pk_live_xxx',
+        onSuccess: (result) => {
+          console.log('Payment successful!', result.orderId)
+        },
+        onError: (error) => {
+          console.error('Payment failed:', error.message)
+        }
+      }}
+      sessionId="cs_xxx" // Optional: load existing session
+    >
+      <CheckoutForm
+        showSummary={true}
+        expressCheckout={true}
+        submitText="Complete Purchase"
+      />
+    </CheckoutProvider>
+  )
+}
+```
+
+### Using the Hook
+
+```tsx
+import { CheckoutProvider, useCheckout } from '@libreapps/checkout'
+
+function CustomCheckout() {
+  const {
+    session,
+    step,
+    isLoading,
+    isProcessing,
+    createSession,
+    confirmPayment,
+    nextStep,
+    prevStep
+  } = useCheckout()
+
+  const handleCreateSession = async () => {
+    await createSession({
+      lineItems: [
+        {
+          name: 'Premium Plan',
+          description: 'Monthly subscription',
+          unitPrice: 2999, // $29.99 in cents
+          quantity: 1
+        }
+      ],
+      customer: {
+        email: 'customer@example.com'
+      }
+    })
+  }
+
+  // Build your custom UI...
+}
+```
+
+### Vanilla JavaScript
+
+```typescript
+import { createCheckout } from '@libreapps/checkout'
+
+const checkout = createCheckout({
+  apiKey: 'pk_live_xxx',
+  mode: 'production' // or 'sandbox'
+})
+
+// Create a session
+const session = await checkout.createSession({
+  lineItems: [
+    {
+      name: 'Product Name',
+      unitPrice: 1999,
+      quantity: 1
+    }
+  ],
+  successUrl: 'https://example.com/success',
+  cancelUrl: 'https://example.com/cancel'
+})
+
+// Redirect to hosted checkout
+checkout.redirectToCheckout(session.id)
+
+// Or open in a popup
+checkout.openPopup(session.id)
+```
+
+### Embed Script (No Build Step)
+
+```html
+<!-- Add the script -->
+<script src="https://js.libreapps.com/checkout.js"></script>
+
+<!-- Add checkout buttons -->
+<button
+  data-libreapps-checkout
+  data-libreapps-key="pk_live_xxx"
+  data-libreapps-amount="1999"
+  data-libreapps-currency="usd"
+  data-libreapps-name="Product Name"
+  data-libreapps-description="Product description"
+  data-libreapps-success-url="https://example.com/success"
+>
+  Pay $19.99
+</button>
+
+<!-- Initialize (optional, for global config) -->
+<script>
+  LibreAppsCheckout.init('pk_live_xxx', {
+    mode: 'production'
+  })
+</script>
+```
+
+## API Reference
+
+### CheckoutOptions
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `apiKey` | `string` | Your LibreApps publishable API key (required) |
+| `mode` | `'production' \| 'sandbox'` | Environment mode |
+| `apiEndpoint` | `string` | Custom API endpoint |
+| `locale` | `string` | Locale for i18n |
+| `appearance` | `CheckoutAppearance` | Theme customization |
+| `onSuccess` | `(result) => void` | Success callback |
+| `onError` | `(error) => void` | Error callback |
+| `onCancel` | `() => void` | Cancel callback |
+
+### CheckoutAppearance
+
+```typescript
+{
+  theme: 'light' | 'dark' | 'auto',
+  primaryColor: '#0066FF',
+  backgroundColor: '#FFFFFF',
+  borderRadius: '8px',
+  fontFamily: 'Inter, sans-serif',
+  variables: {
+    '--libreapps-spacing': '16px'
+  }
+}
+```
+
+### CreateSessionParams
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `lineItems` | `LineItem[]` | Products to purchase (required) |
+| `customer` | `Customer` | Customer information |
+| `successUrl` | `string` | Redirect URL on success |
+| `cancelUrl` | `string` | Redirect URL on cancel |
+| `currency` | `string` | Currency code (default: 'usd') |
+| `shipping` | `boolean` | Enable shipping collection |
+| `paymentMethods` | `string[]` | Allowed payment methods |
+| `promoCode` | `string` | Pre-applied promo code |
+
+## Styling
+
+The checkout widget uses CSS custom properties for easy theming:
+
+```css
+.libreapps-checkout-form {
+  --libreapps-primary: #0066FF;
+  --libreapps-primary-hover: #0052CC;
+  --libreapps-bg: #FFFFFF;
+  --libreapps-bg-secondary: #F5F5F5;
+  --libreapps-text: #1A1A1A;
+  --libreapps-text-secondary: #666666;
+  --libreapps-border: #E5E5E5;
+  --libreapps-radius: 8px;
+  --libreapps-font: 'Inter', -apple-system, sans-serif;
+}
+```
+
+## Payment Methods
+
+- Credit/Debit Cards (Visa, Mastercard, Amex, etc.)
+- Apple Pay
+- Google Pay
+- Cryptocurrency (ETH, USDC, etc.)
+- Bank Transfers
+
+## License
+
+BSD-3-Clause

package/client.ts

@@ -0,0 +1,318 @@
+/**
+ * @libreapps/checkout - Client
+ *
+ * LibreApps Checkout API client - similar to Stripe.js
+ */
+
+import type {
+  CheckoutOptions,
+  CheckoutSession,
+  CreateSessionParams,
+  CheckoutResult,
+  CheckoutError,
+  CheckoutAddress,
+  CheckoutPaymentMethod
+} from './types'
+
+const DEFAULT_API_ENDPOINT = 'https://api.libreapps.com/v1'
+const SANDBOX_API_ENDPOINT = 'https://sandbox.libreapps.com/v1'
+
+export class LibreAppsCheckout {
+  private apiKey: string
+  private apiEndpoint: string
+  private mode: 'production' | 'sandbox'
+  private options: CheckoutOptions
+
+  constructor(options: CheckoutOptions) {
+    if (!options.apiKey) {
+      throw new Error('LibreApps Checkout: apiKey is required')
+    }
+
+    this.apiKey = options.apiKey
+    this.mode = options.mode ?? 'production'
+    this.apiEndpoint = options.apiEndpoint ??
+      (this.mode === 'sandbox' ? SANDBOX_API_ENDPOINT : DEFAULT_API_ENDPOINT)
+    this.options = options
+  }
+
+  /**
+   * Create a new checkout session
+   */
+  async createSession(params: CreateSessionParams): Promise<CheckoutSession> {
+    const response = await this.request<CheckoutSession>('POST', '/checkout/sessions', {
+      line_items: params.lineItems.map(item => ({
+        product_id: item.productId,
+        sku: item.sku,
+        name: item.name,
+        description: item.description,
+        image_url: item.imageUrl,
+        quantity: item.quantity,
+        unit_price: item.unitPrice,
+        currency: item.currency ?? 'usd',
+        metadata: item.metadata
+      })),
+      customer: params.customer ? {
+        email: params.customer.email,
+        name: params.customer.name,
+        phone: params.customer.phone
+      } : undefined,
+      success_url: params.successUrl,
+      cancel_url: params.cancelUrl,
+      currency: params.currency ?? 'usd',
+      metadata: params.metadata,
+      shipping: params.shipping ?? true,
+      collect_phone: params.collectPhone ?? false,
+      payment_methods: params.paymentMethods ?? ['card'],
+      promo_code: params.promoCode
+    })
+
+    return this.normalizeSession(response)
+  }
+
+  /**
+   * Retrieve an existing checkout session
+   */
+  async retrieveSession(sessionId: string): Promise<CheckoutSession> {
+    const response = await this.request<CheckoutSession>('GET', `/checkout/sessions/${sessionId}`)
+    return this.normalizeSession(response)
+  }
+
+  /**
+   * Update shipping address
+   */
+  async updateShipping(sessionId: string, address: CheckoutAddress): Promise<CheckoutSession> {
+    const response = await this.request<CheckoutSession>(
+      'PATCH',
+      `/checkout/sessions/${sessionId}/shipping`,
+      {
+        line1: address.line1,
+        line2: address.line2,
+        city: address.city,
+        state: address.state,
+        postal_code: address.postalCode,
+        country: address.country
+      }
+    )
+    return this.normalizeSession(response)
+  }
+
+  /**
+   * Update billing address
+   */
+  async updateBilling(sessionId: string, address: CheckoutAddress): Promise<CheckoutSession> {
+    const response = await this.request<CheckoutSession>(
+      'PATCH',
+      `/checkout/sessions/${sessionId}/billing`,
+      {
+        line1: address.line1,
+        line2: address.line2,
+        city: address.city,
+        state: address.state,
+        postal_code: address.postalCode,
+        country: address.country
+      }
+    )
+    return this.normalizeSession(response)
+  }
+
+  /**
+   * Apply a promo code
+   */
+  async applyPromoCode(sessionId: string, code: string): Promise<CheckoutSession> {
+    const response = await this.request<CheckoutSession>(
+      'POST',
+      `/checkout/sessions/${sessionId}/promo`,
+      { code }
+    )
+    return this.normalizeSession(response)
+  }
+
+  /**
+   * Process payment
+   */
+  async confirmPayment(
+    sessionId: string,
+    paymentMethod: {
+      type: 'card'
+      card: {
+        number: string
+        expMonth: number
+        expYear: number
+        cvc: string
+      }
+    } | {
+      type: 'crypto'
+      crypto: {
+        currency: string
+        network: string
+      }
+    } | {
+      type: 'apple_pay' | 'google_pay'
+      token: string
+    }
+  ): Promise<CheckoutResult> {
+    const response = await this.request<{
+      session_id: string
+      order_id: string
+      status: 'success' | 'pending'
+      payment_intent_id?: string
+      customer_id?: string
+      receipt_url?: string
+    }>('POST', `/checkout/sessions/${sessionId}/confirm`, {
+      payment_method: paymentMethod
+    })
+
+    const result: CheckoutResult = {
+      sessionId: response.session_id,
+      orderId: response.order_id,
+      status: response.status,
+      paymentIntentId: response.payment_intent_id,
+      customerId: response.customer_id,
+      receiptUrl: response.receipt_url
+    }
+
+    if (this.options.onSuccess && result.status === 'success') {
+      this.options.onSuccess(result)
+    }
+
+    return result
+  }
+
+  /**
+   * Cancel session
+   */
+  async cancelSession(sessionId: string): Promise<void> {
+    await this.request('POST', `/checkout/sessions/${sessionId}/cancel`)
+    this.options.onCancel?.()
+  }
+
+  /**
+   * Redirect to hosted checkout page
+   */
+  redirectToCheckout(sessionId: string): void {
+    const host = this.mode === 'sandbox' ? 'sandbox.libreapps.com' : 'checkout.libreapps.com'
+    window.location.href = `https://${host}/c/${sessionId}`
+  }
+
+  /**
+   * Open checkout in a popup
+   */
+  openPopup(sessionId: string): Window | null {
+    const host = this.mode === 'sandbox' ? 'sandbox.libreapps.com' : 'checkout.libreapps.com'
+    const url = `https://${host}/c/${sessionId}?popup=true`
+    const width = 450
+    const height = 700
+    const left = (window.screen.width - width) / 2
+    const top = (window.screen.height - height) / 2
+
+    return window.open(
+      url,
+      'LibreAppsCheckout',
+      `width=${width},height=${height},left=${left},top=${top},toolbar=no,menubar=no,scrollbars=yes,resizable=yes`
+    )
+  }
+
+  /**
+   * Make API request
+   */
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: Record<string, unknown>
+  ): Promise<T> {
+    const url = `${this.apiEndpoint}${path}`
+
+    const headers: Record<string, string> = {
+      'Authorization': `Bearer ${this.apiKey}`,
+      'Content-Type': 'application/json',
+      'X-LibreApps-Client': 'checkout-js/1.0.0'
+    }
+
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined
+    })
+
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}))
+      const checkoutError: CheckoutError = {
+        code: error.code ?? 'unknown_error',
+        message: error.message ?? 'An unexpected error occurred',
+        details: error.details
+      }
+
+      if (this.options.onError) {
+        this.options.onError(checkoutError)
+      }
+
+      throw checkoutError
+    }
+
+    return response.json()
+  }
+
+  /**
+   * Normalize API response to CheckoutSession
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private normalizeSession(data: any): CheckoutSession {
+    return {
+      id: data.id as string,
+      status: data.status as CheckoutSession['status'],
+      lineItems: (data.line_items as Array<Record<string, unknown>> ?? []).map(item => ({
+        id: item.id as string,
+        productId: item.product_id as string,
+        sku: item.sku as string | undefined,
+        name: item.name as string,
+        description: item.description as string | undefined,
+        imageUrl: item.image_url as string | undefined,
+        quantity: item.quantity as number,
+        unitPrice: item.unit_price as number,
+        totalPrice: item.total_price as number,
+        currency: item.currency as string,
+        metadata: item.metadata as Record<string, string> | undefined
+      })),
+      subtotal: data.subtotal as number,
+      tax: data.tax as number,
+      shipping: data.shipping as number,
+      total: data.total as number,
+      currency: data.currency as string,
+      customer: data.customer ? {
+        id: (data.customer as Record<string, unknown>).id as string | undefined,
+        email: (data.customer as Record<string, unknown>).email as string,
+        name: (data.customer as Record<string, unknown>).name as string | undefined,
+        phone: (data.customer as Record<string, unknown>).phone as string | undefined
+      } : undefined,
+      shippingAddress: data.shipping_address ? this.normalizeAddress(data.shipping_address as Record<string, unknown>) : undefined,
+      billingAddress: data.billing_address ? this.normalizeAddress(data.billing_address as Record<string, unknown>) : undefined,
+      paymentMethod: data.payment_method as CheckoutPaymentMethod | undefined,
+      metadata: data.metadata as Record<string, string> | undefined,
+      successUrl: data.success_url as string | undefined,
+      cancelUrl: data.cancel_url as string | undefined,
+      expiresAt: data.expires_at as string | undefined,
+      createdAt: data.created_at as string,
+      updatedAt: data.updated_at as string
+    }
+  }
+
+  private normalizeAddress(data: Record<string, unknown>): CheckoutAddress {
+    return {
+      line1: data.line1 as string,
+      line2: data.line2 as string | undefined,
+      city: data.city as string,
+      state: data.state as string | undefined,
+      postalCode: data.postal_code as string,
+      country: data.country as string
+    }
+  }
+}
+
+/**
+ * Create a new LibreApps Checkout instance
+ */
+export function createCheckout(options: CheckoutOptions): LibreAppsCheckout {
+  return new LibreAppsCheckout(options)
+}
+
+export default LibreAppsCheckout

package/dist/client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @libreapps/checkout - Client
+ *
+ * LibreApps Checkout API client - similar to Stripe.js
+ */
+import type { CheckoutOptions, CheckoutSession, CreateSessionParams, CheckoutResult, CheckoutAddress } from './types';
+export declare class LibreAppsCheckout {
+    private apiKey;
+    private apiEndpoint;
+    private mode;
+    private options;
+    constructor(options: CheckoutOptions);
+    /**
+     * Create a new checkout session
+     */
+    createSession(params: CreateSessionParams): Promise<CheckoutSession>;
+    /**
+     * Retrieve an existing checkout session
+     */
+    retrieveSession(sessionId: string): Promise<CheckoutSession>;
+    /**
+     * Update shipping address
+     */
+    updateShipping(sessionId: string, address: CheckoutAddress): Promise<CheckoutSession>;
+    /**
+     * Update billing address
+     */
+    updateBilling(sessionId: string, address: CheckoutAddress): Promise<CheckoutSession>;
+    /**
+     * Apply a promo code
+     */
+    applyPromoCode(sessionId: string, code: string): Promise<CheckoutSession>;
+    /**
+     * Process payment
+     */
+    confirmPayment(sessionId: string, paymentMethod: {
+        type: 'card';
+        card: {
+            number: string;
+            expMonth: number;
+            expYear: number;
+            cvc: string;
+        };
+    } | {
+        type: 'crypto';
+        crypto: {
+            currency: string;
+            network: string;
+        };
+    } | {
+        type: 'apple_pay' | 'google_pay';
+        token: string;
+    }): Promise<CheckoutResult>;
+    /**
+     * Cancel session
+     */
+    cancelSession(sessionId: string): Promise<void>;
+    /**
+     * Redirect to hosted checkout page
+     */
+    redirectToCheckout(sessionId: string): void;
+    /**
+     * Open checkout in a popup
+     */
+    openPopup(sessionId: string): Window | null;
+    /**
+     * Make API request
+     */
+    private request;
+    /**
+     * Normalize API response to CheckoutSession
+     */
+    private normalizeSession;
+    private normalizeAddress;
+}
+/**
+ * Create a new LibreApps Checkout instance
+ */
+export declare function createCheckout(options: CheckoutOptions): LibreAppsCheckout;
+export default LibreAppsCheckout;