npm - recur-tw - Versions diffs - 0.0.1 - Mend

recur-tw 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2025 Recur
+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 ADDED Viewed

@@ -0,0 +1,379 @@
+# Recur SDK (Taiwan)
+A React SDK for embedding subscription checkout flows in your application.
+**專為台灣市場設計** - 使用 PAYUNi 支付網關處理訂閱式付款。
+Taiwan-specific subscription checkout SDK powered by PAYUNi payment gateway.
+## Installation
+Install the package via npm or pnpm:
+```bash
+npm install recur-tw
+# or
+pnpm add recur-tw
+# or
+yarn add recur-tw
+```
+Then import it in your React application:
+```tsx
+import { RecurProvider, useRecur } from 'recur-tw';
+```
+## Quick Start
+### 1. Wrap your app with RecurProvider
+```tsx
+// app/layout.tsx or your root component
+import { RecurProvider } from 'recur-tw';
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        <RecurProvider config={{ organizationId: 'your-org-id' }}>
+          {children}
+        </RecurProvider>
+      </body>
+    </html>
+  );
+}
+```
+### 2. Use the checkout function in your components
+```tsx
+// components/pricing-button.tsx
+'use client';
+import { useRecur } from 'recur-tw';
+export function PricingButton({ planId }: { planId: string }) {
+  const { checkout, isCheckingOut } = useRecur();
+  return (
+    <Button
+      onClick={async () => {
+        await checkout({ planId });
+      }}
+      disabled={isCheckingOut}
+    >
+      {isCheckingOut ? 'Processing...' : 'Subscribe'}
+    </Button>
+  );
+}
+```
+## Configuration
+### RecurProvider Props
+```tsx
+interface RecurConfig {
+  // Organization ID for the checkout
+  organizationId?: string;
+  // Base URL for API calls (defaults to current origin)
+  baseUrl?: string;
+  // Redirect mode: 'redirect' (default) or 'popup'
+  redirectMode?: 'redirect' | 'popup';
+  // Success callback URL
+  successUrl?: string;
+  // Cancel callback URL
+  cancelUrl?: string;
+}
+```
+## Usage Examples
+### Basic Checkout
+```tsx
+const { checkout } = useRecur();
+await checkout({
+  planId: 'pro-monthly',
+});
+```
+### Checkout with Customer Information
+```tsx
+const { checkout } = useRecur();
+await checkout({
+  planId: 'pro-monthly',
+  customerName: 'John Doe',
+  customerEmail: 'john@example.com',
+  customerPhone: '+886912345678',
+});
+```
+### Checkout with Callbacks
+```tsx
+const { checkout } = useRecur();
+await checkout({
+  planId: 'pro-monthly',
+  onSuccess: (result) => {
+    console.log('Checkout initiated:', result.subscription.id);
+    // Show success toast
+  },
+  onError: (error) => {
+    console.error('Checkout failed:', error.message);
+    // Show error toast
+  },
+});
+```
+### Popup Mode
+```tsx
+// In your RecurProvider config
+<RecurProvider config={{ redirectMode: 'popup' }}>
+  {children}
+</RecurProvider>
+// In your component
+const { checkout } = useRecur();
+await checkout({
+  planId: 'pro-monthly',
+  onPaymentComplete: (subscription) => {
+    console.log('Payment completed!', subscription);
+    // Refresh page or update UI
+  },
+  onPaymentCancel: () => {
+    console.log('Payment cancelled');
+  },
+});
+```
+### Custom Form
+```tsx
+'use client';
+import { useState } from 'react';
+import { useRecur } from '@/lib/recur';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+export function CustomCheckoutForm({ planId }: { planId: string }) {
+  const { checkout, isCheckingOut } = useRecur();
+  const [email, setEmail] = useState('');
+  const [name, setName] = useState('');
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    await checkout({
+      planId,
+      customerEmail: email,
+      customerName: name,
+      onSuccess: () => {
+        // Show success message
+      },
+      onError: (error) => {
+        alert(error.message);
+      },
+    });
+  };
+  return (
+    <form onSubmit={handleSubmit}>
+      <Input
+        type="text"
+        placeholder="Name"
+        value={name}
+        onChange={(e) => setName(e.target.value)}
+        required
+      />
+      <Input
+        type="email"
+        placeholder="Email"
+        value={email}
+        onChange={(e) => setEmail(e.target.value)}
+        required
+      />
+      <Button type="submit" disabled={isCheckingOut}>
+        {isCheckingOut ? 'Processing...' : 'Subscribe'}
+      </Button>
+    </form>
+  );
+}
+```
+### Dynamic Organization ID
+```tsx
+// Override organization ID per checkout
+const { checkout } = useRecur();
+await checkout({
+  planId: 'pro-monthly',
+  organizationId: 'different-org-id',
+});
+```
+### Update Configuration Dynamically
+```tsx
+const { updateConfig } = useRecur();
+// Switch to popup mode
+updateConfig({ redirectMode: 'popup' });
+// Update organization ID
+updateConfig({ organizationId: 'new-org-id' });
+```
+## API Reference
+### `useRecur()`
+Returns a `RecurContextValue` object with the following properties:
+#### `checkout(options: CheckoutOptions): Promise<void>`
+Initiates a checkout flow.
+**Options:**
+- `planId` (required): The ID of the subscription plan
+- `customerName` (optional): Customer's name
+- `customerEmail` (optional): Customer's email
+- `customerPhone` (optional): Customer's phone number
+- `organizationId` (optional): Override the organization ID
+- `onSuccess` (optional): Callback when checkout is initiated successfully
+- `onError` (optional): Callback when checkout fails
+- `onPaymentComplete` (optional): Callback when payment is completed (popup mode only)
+- `onPaymentCancel` (optional): Callback when payment is cancelled (popup mode only)
+#### `isCheckingOut: boolean`
+Indicates whether a checkout is currently in progress.
+#### `config: RecurConfig`
+Current configuration object.
+#### `updateConfig(config: Partial<RecurConfig>): void`
+Updates the configuration.
+## Error Handling
+All checkout errors are caught and passed to the `onError` callback:
+```tsx
+await checkout({
+  planId: 'pro-monthly',
+  onError: (error) => {
+    console.error('Error code:', error.code);
+    console.error('Error message:', error.message);
+    console.error('Error details:', error.details);
+  },
+});
+```
+Common error codes:
+- `CHECKOUT_FAILED`: Failed to initiate checkout
+- `CHECKOUT_ERROR`: General checkout error
+## TypeScript Support
+The SDK is written in TypeScript and provides full type definitions:
+```tsx
+import type {
+  RecurConfig,
+  CheckoutOptions,
+  CheckoutResult,
+  CheckoutError,
+  SubscriptionResult,
+} from 'recur-tw';
+```
+## Advanced Usage
+### Server-Side Organization Detection
+```tsx
+// app/layout.tsx
+import { RecurProvider } from '@/lib/recur';
+import { getOrganizationIdFromDomain } from '@/lib/utils';
+export default async function RootLayout({ children }) {
+  const organizationId = await getOrganizationIdFromDomain();
+  return (
+    <html>
+      <body>
+        <RecurProvider config={{ organizationId }}>
+          {children}
+        </RecurProvider>
+      </body>
+    </html>
+  );
+}
+```
+### Multi-Organization Support
+```tsx
+// Let each checkout specify its own organization
+<RecurProvider>
+  <App />
+</RecurProvider>
+// In component
+const { checkout } = useRecur();
+// Store A
+await checkout({ planId: 'plan-a', organizationId: 'store-a' });
+// Store B
+await checkout({ planId: 'plan-b', organizationId: 'store-b' });
+```
+### Integration with Toast Notifications
+```tsx
+import { useRecur } from '@/lib/recur';
+import { toast } from 'sonner';
+export function CheckoutButton({ planId }: { planId: string }) {
+  const { checkout, isCheckingOut } = useRecur();
+  const handleCheckout = async () => {
+    await checkout({
+      planId,
+      onSuccess: (result) => {
+        toast.success('Redirecting to payment...');
+      },
+      onError: (error) => {
+        toast.error(error.message);
+      },
+    });
+  };
+  return (
+    <button onClick={handleCheckout} disabled={isCheckingOut}>
+      {isCheckingOut ? 'Loading...' : 'Subscribe Now'}
+    </button>
+  );
+}
+```
+## License
+This SDK is part of the Recur project.

package/dist/index.cjs ADDED Viewed

@@ -0,0 +1,109 @@
+'use strict';
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+// src/context.tsx
+var RecurContext = react.createContext(null);
+function RecurProvider({ children, config: initialConfig = {} }) {
+  const [config, setConfig] = react.useState({
+    redirectMode: "redirect",
+    ...initialConfig
+  });
+  const [isCheckingOut, setIsCheckingOut] = react.useState(false);
+  const updateConfig = react.useCallback((newConfig) => {
+    setConfig((prev) => ({ ...prev, ...newConfig }));
+  }, []);
+  const checkout = react.useCallback(
+    async (options) => {
+      try {
+        setIsCheckingOut(true);
+        if (!options.planId) {
+          throw new Error("planId is required");
+        }
+        const organizationId = options.organizationId || config.organizationId;
+        if (!organizationId) {
+          throw new Error("organizationId is required. Provide it in RecurProvider config or checkout options.");
+        }
+        const baseUrl = config.baseUrl || (typeof window !== "undefined" ? window.location.origin : "");
+        const response = await fetch(`${baseUrl}/api/subscriptions`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            organizationId,
+            planId: options.planId,
+            customerName: options.customerName,
+            customerEmail: options.customerEmail,
+            customerPhone: options.customerPhone
+          })
+        });
+        if (!response.ok) {
+          const errorData = await response.json().catch(() => ({}));
+          const error = {
+            code: errorData.error || "CHECKOUT_FAILED",
+            message: errorData.message || "Failed to initiate checkout",
+            details: errorData
+          };
+          options.onError?.(error);
+          throw new Error(error.message);
+        }
+        const result = await response.json();
+        options.onSuccess?.(result);
+        if (config.redirectMode === "popup") {
+          const popup = window.open(
+            result.paymentUrl,
+            "recurCheckout",
+            "width=600,height=700,scrollbars=yes,resizable=yes"
+          );
+          if (!popup) {
+            throw new Error("Failed to open popup. Please allow popups for this site.");
+          }
+          const pollInterval = setInterval(() => {
+            if (popup.closed) {
+              clearInterval(pollInterval);
+              setIsCheckingOut(false);
+              if (options.onPaymentComplete) {
+                options.onPaymentComplete(result.subscription);
+              }
+            }
+          }, 500);
+        } else {
+          window.location.href = result.paymentUrl;
+        }
+      } catch (error) {
+        const checkoutError = {
+          code: "CHECKOUT_ERROR",
+          message: error instanceof Error ? error.message : "An unknown error occurred"
+        };
+        options.onError?.(checkoutError);
+        setIsCheckingOut(false);
+        throw error;
+      }
+    },
+    [config]
+  );
+  const value = react.useMemo(
+    () => ({
+      config,
+      checkout,
+      isCheckingOut,
+      updateConfig
+    }),
+    [config, checkout, isCheckingOut, updateConfig]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(RecurContext.Provider, { value, children });
+}
+function useRecur() {
+  const context = react.useContext(RecurContext);
+  if (!context) {
+    throw new Error("useRecur must be used within a RecurProvider");
+  }
+  return context;
+}
+exports.RecurProvider = RecurProvider;
+exports.useRecur = useRecur;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/context.tsx","../src/use-recur.ts"],"names":["createContext","useState","useCallback","useMemo","jsx","useContext"],"mappings":"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","file":"index.cjs","sourcesContent":["'use client';\n\nimport React, { createContext, useCallback, useState, useMemo } from 'react';\nimport type {\n RecurConfig,\n RecurContextValue,\n CheckoutOptions,\n CheckoutResult,\n CheckoutError,\n} from './types.js';\n\nconst RecurContext = createContext<RecurContextValue | null>(null);\n\nexport interface RecurProviderProps {\n children: React.ReactNode;\n config?: RecurConfig;\n}\n\n/**\n * RecurProvider\n *\n * Provides Recur checkout functionality to your React application\n *\n * @example\n * ```tsx\n * <RecurProvider config={{ organizationId: 'org_xxx' }}>\n * <App />\n * </RecurProvider>\n * ```\n */\nexport function RecurProvider({ children, config: initialConfig = {} }: RecurProviderProps) {\n const [config, setConfig] = useState<RecurConfig>({\n redirectMode: 'redirect',\n ...initialConfig,\n });\n\n const [isCheckingOut, setIsCheckingOut] = useState(false);\n\n const updateConfig = useCallback((newConfig: Partial<RecurConfig>) => {\n setConfig((prev) => ({ ...prev, ...newConfig }));\n }, []);\n\n const checkout = useCallback(\n async (options: CheckoutOptions) => {\n try {\n setIsCheckingOut(true);\n\n // Validate required fields\n if (!options.planId) {\n throw new Error('planId is required');\n }\n\n // Determine organization ID\n const organizationId = options.organizationId || config.organizationId;\n if (!organizationId) {\n throw new Error('organizationId is required. Provide it in RecurProvider config or checkout options.');\n }\n\n // Determine base URL\n const baseUrl = config.baseUrl || (typeof window !== 'undefined' ? window.location.origin : '');\n\n // Call the subscription API\n const response = await fetch(`${baseUrl}/api/subscriptions`, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n organizationId,\n planId: options.planId,\n customerName: options.customerName,\n customerEmail: options.customerEmail,\n customerPhone: options.customerPhone,\n }),\n });\n\n if (!response.ok) {\n const errorData = await response.json().catch(() => ({}));\n const error: CheckoutError = {\n code: errorData.error || 'CHECKOUT_FAILED',\n message: errorData.message || 'Failed to initiate checkout',\n details: errorData,\n };\n\n options.onError?.(error);\n throw new Error(error.message);\n }\n\n const result: CheckoutResult = await response.json();\n\n // Call success callback\n options.onSuccess?.(result);\n\n // Handle redirect based on mode\n if (config.redirectMode === 'popup') {\n // Open payment in popup window\n const popup = window.open(\n result.paymentUrl,\n 'recurCheckout',\n 'width=600,height=700,scrollbars=yes,resizable=yes'\n );\n\n if (!popup) {\n throw new Error('Failed to open popup. Please allow popups for this site.');\n }\n\n // Poll for popup close\n const pollInterval = setInterval(() => {\n if (popup.closed) {\n clearInterval(pollInterval);\n setIsCheckingOut(false);\n\n // Check if payment was completed\n // You might want to implement a message listener here\n // or poll your API to check subscription status\n if (options.onPaymentComplete) {\n // Note: result.subscription may not have all fields for SubscriptionResult\n // You may need to fetch full subscription details from API\n options.onPaymentComplete(result.subscription as any);\n }\n }\n }, 500);\n } else {\n // Full page redirect\n window.location.href = result.paymentUrl;\n }\n } catch (error) {\n const checkoutError: CheckoutError = {\n code: 'CHECKOUT_ERROR',\n message: error instanceof Error ? error.message : 'An unknown error occurred',\n };\n\n options.onError?.(checkoutError);\n setIsCheckingOut(false);\n throw error;\n }\n },\n [config]\n );\n\n const value = useMemo(\n () => ({\n config,\n checkout,\n isCheckingOut,\n updateConfig,\n }),\n [config, checkout, isCheckingOut, updateConfig]\n );\n\n return <RecurContext.Provider value={value}>{children}</RecurContext.Provider>;\n}\n\nexport { RecurContext };\n","'use client';\n\nimport { useContext } from 'react';\nimport { RecurContext } from './context.js';\nimport type { RecurContextValue } from './types.js';\n\n/**\n * useRecur Hook\n *\n * Access Recur checkout functionality from within your components\n *\n * @example\n * ```tsx\n * function MyComponent() {\n * const { checkout, isCheckingOut } = useRecur();\n *\n * return (\n * <button\n * onClick={() => checkout({ planId: 'pro' })}\n * disabled={isCheckingOut}\n * >\n * {isCheckingOut ? 'Processing...' : 'Subscribe'}\n * </button>\n * );\n * }\n * ```\n *\n * @throws {Error} If used outside of RecurProvider\n */\nexport function useRecur(): RecurContextValue {\n const context = useContext(RecurContext);\n\n if (!context) {\n throw new Error('useRecur must be used within a RecurProvider');\n }\n\n return context;\n}\n"]}

package/dist/index.d.cts ADDED Viewed

@@ -0,0 +1,176 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+/**
+ * Recur SDK Types
+ *
+ * Type definitions for the Recur checkout SDK
+ */
+interface RecurConfig {
+    /**
+     * Organization ID for the checkout
+     * If not provided, will be inferred from the current domain
+     */
+    organizationId?: string;
+    /**
+     * Base URL for API calls
+     * Defaults to current origin
+     */
+    baseUrl?: string;
+    /**
+     * Redirect mode - how to handle payment redirects
+     * - 'redirect': Full page redirect (default)
+     * - 'popup': Open payment in popup window
+     */
+    redirectMode?: 'redirect' | 'popup';
+    /**
+     * Success callback URL
+     * Where to redirect after successful payment
+     */
+    successUrl?: string;
+    /**
+     * Cancel callback URL
+     * Where to redirect if user cancels payment
+     */
+    cancelUrl?: string;
+}
+interface CheckoutOptions {
+    /**
+     * Plan ID to subscribe to
+     */
+    planId: string;
+    /**
+     * Customer information
+     */
+    customerName?: string;
+    customerEmail?: string;
+    customerPhone?: string;
+    /**
+     * Override organization ID
+     */
+    organizationId?: string;
+    /**
+     * Callback when checkout is initiated successfully
+     */
+    onSuccess?: (result: CheckoutResult) => void;
+    /**
+     * Callback when checkout fails
+     */
+    onError?: (error: CheckoutError) => void;
+    /**
+     * Callback when payment is completed
+     * (only works in popup mode)
+     */
+    onPaymentComplete?: (subscription: SubscriptionResult) => void;
+    /**
+     * Callback when payment is cancelled
+     * (only works in popup mode)
+     */
+    onPaymentCancel?: () => void;
+}
+interface CheckoutResult {
+    /**
+     * Created subscription object
+     */
+    subscription: {
+        id: string;
+        status: string;
+        planId: string;
+        amount: number;
+        billingPeriod: string;
+        trialEndsAt?: string;
+        nextBillingDate?: string;
+    };
+    /**
+     * Payment URL to redirect to
+     */
+    paymentUrl: string;
+}
+interface CheckoutError {
+    /**
+     * Error code
+     */
+    code: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Additional error details
+     */
+    details?: Record<string, unknown>;
+}
+interface SubscriptionResult {
+    id: string;
+    status: string;
+    planId: string;
+    amount: number;
+    billingPeriod: string;
+    trialEndsAt?: string;
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    nextBillingDate?: string;
+}
+interface RecurContextValue {
+    /**
+     * Current configuration
+     */
+    config: RecurConfig;
+    /**
+     * Initiate checkout flow
+     */
+    checkout: (options: CheckoutOptions) => Promise<void>;
+    /**
+     * Check if checkout is in progress
+     */
+    isCheckingOut: boolean;
+    /**
+     * Update configuration
+     */
+    updateConfig: (config: Partial<RecurConfig>) => void;
+}
+interface RecurProviderProps {
+    children: React.ReactNode;
+    config?: RecurConfig;
+}
+/**
+ * RecurProvider
+ *
+ * Provides Recur checkout functionality to your React application
+ *
+ * @example
+ * ```tsx
+ * <RecurProvider config={{ organizationId: 'org_xxx' }}>
+ *   <App />
+ * </RecurProvider>
+ * ```
+ */
+declare function RecurProvider({ children, config: initialConfig }: RecurProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * useRecur Hook
+ *
+ * Access Recur checkout functionality from within your components
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { checkout, isCheckingOut } = useRecur();
+ *
+ *   return (
+ *     <button
+ *       onClick={() => checkout({ planId: 'pro' })}
+ *       disabled={isCheckingOut}
+ *     >
+ *       {isCheckingOut ? 'Processing...' : 'Subscribe'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @throws {Error} If used outside of RecurProvider
+ */
+declare function useRecur(): RecurContextValue;
+export { type CheckoutError, type CheckoutOptions, type CheckoutResult, type RecurConfig, type RecurContextValue, RecurProvider, type RecurProviderProps, type SubscriptionResult, useRecur };

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,176 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+/**
+ * Recur SDK Types
+ *
+ * Type definitions for the Recur checkout SDK
+ */
+interface RecurConfig {
+    /**
+     * Organization ID for the checkout
+     * If not provided, will be inferred from the current domain
+     */
+    organizationId?: string;
+    /**
+     * Base URL for API calls
+     * Defaults to current origin
+     */
+    baseUrl?: string;
+    /**
+     * Redirect mode - how to handle payment redirects
+     * - 'redirect': Full page redirect (default)
+     * - 'popup': Open payment in popup window
+     */
+    redirectMode?: 'redirect' | 'popup';
+    /**
+     * Success callback URL
+     * Where to redirect after successful payment
+     */
+    successUrl?: string;
+    /**
+     * Cancel callback URL
+     * Where to redirect if user cancels payment
+     */
+    cancelUrl?: string;
+}
+interface CheckoutOptions {
+    /**
+     * Plan ID to subscribe to
+     */
+    planId: string;
+    /**
+     * Customer information
+     */
+    customerName?: string;
+    customerEmail?: string;
+    customerPhone?: string;
+    /**
+     * Override organization ID
+     */
+    organizationId?: string;
+    /**
+     * Callback when checkout is initiated successfully
+     */
+    onSuccess?: (result: CheckoutResult) => void;
+    /**
+     * Callback when checkout fails
+     */
+    onError?: (error: CheckoutError) => void;
+    /**
+     * Callback when payment is completed
+     * (only works in popup mode)
+     */
+    onPaymentComplete?: (subscription: SubscriptionResult) => void;
+    /**
+     * Callback when payment is cancelled
+     * (only works in popup mode)
+     */
+    onPaymentCancel?: () => void;
+}
+interface CheckoutResult {
+    /**
+     * Created subscription object
+     */
+    subscription: {
+        id: string;
+        status: string;
+        planId: string;
+        amount: number;
+        billingPeriod: string;
+        trialEndsAt?: string;
+        nextBillingDate?: string;
+    };
+    /**
+     * Payment URL to redirect to
+     */
+    paymentUrl: string;
+}
+interface CheckoutError {
+    /**
+     * Error code
+     */
+    code: string;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Additional error details
+     */
+    details?: Record<string, unknown>;
+}
+interface SubscriptionResult {
+    id: string;
+    status: string;
+    planId: string;
+    amount: number;
+    billingPeriod: string;
+    trialEndsAt?: string;
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    nextBillingDate?: string;
+}
+interface RecurContextValue {
+    /**
+     * Current configuration
+     */
+    config: RecurConfig;
+    /**
+     * Initiate checkout flow
+     */
+    checkout: (options: CheckoutOptions) => Promise<void>;
+    /**
+     * Check if checkout is in progress
+     */
+    isCheckingOut: boolean;
+    /**
+     * Update configuration
+     */
+    updateConfig: (config: Partial<RecurConfig>) => void;
+}
+interface RecurProviderProps {
+    children: React.ReactNode;
+    config?: RecurConfig;
+}
+/**
+ * RecurProvider
+ *
+ * Provides Recur checkout functionality to your React application
+ *
+ * @example
+ * ```tsx
+ * <RecurProvider config={{ organizationId: 'org_xxx' }}>
+ *   <App />
+ * </RecurProvider>
+ * ```
+ */
+declare function RecurProvider({ children, config: initialConfig }: RecurProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * useRecur Hook
+ *
+ * Access Recur checkout functionality from within your components
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { checkout, isCheckingOut } = useRecur();
+ *
+ *   return (
+ *     <button
+ *       onClick={() => checkout({ planId: 'pro' })}
+ *       disabled={isCheckingOut}
+ *     >
+ *       {isCheckingOut ? 'Processing...' : 'Subscribe'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @throws {Error} If used outside of RecurProvider
+ */
+declare function useRecur(): RecurContextValue;
+export { type CheckoutError, type CheckoutOptions, type CheckoutResult, type RecurConfig, type RecurContextValue, RecurProvider, type RecurProviderProps, type SubscriptionResult, useRecur };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,106 @@
+import { createContext, useState, useCallback, useMemo, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+// src/context.tsx
+var RecurContext = createContext(null);
+function RecurProvider({ children, config: initialConfig = {} }) {
+  const [config, setConfig] = useState({
+    redirectMode: "redirect",
+    ...initialConfig
+  });
+  const [isCheckingOut, setIsCheckingOut] = useState(false);
+  const updateConfig = useCallback((newConfig) => {
+    setConfig((prev) => ({ ...prev, ...newConfig }));
+  }, []);
+  const checkout = useCallback(
+    async (options) => {
+      try {
+        setIsCheckingOut(true);
+        if (!options.planId) {
+          throw new Error("planId is required");
+        }
+        const organizationId = options.organizationId || config.organizationId;
+        if (!organizationId) {
+          throw new Error("organizationId is required. Provide it in RecurProvider config or checkout options.");
+        }
+        const baseUrl = config.baseUrl || (typeof window !== "undefined" ? window.location.origin : "");
+        const response = await fetch(`${baseUrl}/api/subscriptions`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            organizationId,
+            planId: options.planId,
+            customerName: options.customerName,
+            customerEmail: options.customerEmail,
+            customerPhone: options.customerPhone
+          })
+        });
+        if (!response.ok) {
+          const errorData = await response.json().catch(() => ({}));
+          const error = {
+            code: errorData.error || "CHECKOUT_FAILED",
+            message: errorData.message || "Failed to initiate checkout",
+            details: errorData
+          };
+          options.onError?.(error);
+          throw new Error(error.message);
+        }
+        const result = await response.json();
+        options.onSuccess?.(result);
+        if (config.redirectMode === "popup") {
+          const popup = window.open(
+            result.paymentUrl,
+            "recurCheckout",
+            "width=600,height=700,scrollbars=yes,resizable=yes"
+          );
+          if (!popup) {
+            throw new Error("Failed to open popup. Please allow popups for this site.");
+          }
+          const pollInterval = setInterval(() => {
+            if (popup.closed) {
+              clearInterval(pollInterval);
+              setIsCheckingOut(false);
+              if (options.onPaymentComplete) {
+                options.onPaymentComplete(result.subscription);
+              }
+            }
+          }, 500);
+        } else {
+          window.location.href = result.paymentUrl;
+        }
+      } catch (error) {
+        const checkoutError = {
+          code: "CHECKOUT_ERROR",
+          message: error instanceof Error ? error.message : "An unknown error occurred"
+        };
+        options.onError?.(checkoutError);
+        setIsCheckingOut(false);
+        throw error;
+      }
+    },
+    [config]
+  );
+  const value = useMemo(
+    () => ({
+      config,
+      checkout,
+      isCheckingOut,
+      updateConfig
+    }),
+    [config, checkout, isCheckingOut, updateConfig]
+  );
+  return /* @__PURE__ */ jsx(RecurContext.Provider, { value, children });
+}
+function useRecur() {
+  const context = useContext(RecurContext);
+  if (!context) {
+    throw new Error("useRecur must be used within a RecurProvider");
+  }
+  return context;
+}
+export { RecurProvider, useRecur };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/context.tsx","../src/use-recur.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["'use client';\n\nimport React, { createContext, useCallback, useState, useMemo } from 'react';\nimport type {\n RecurConfig,\n RecurContextValue,\n CheckoutOptions,\n CheckoutResult,\n CheckoutError,\n} from './types.js';\n\nconst RecurContext = createContext<RecurContextValue | null>(null);\n\nexport interface RecurProviderProps {\n children: React.ReactNode;\n config?: RecurConfig;\n}\n\n/**\n * RecurProvider\n *\n * Provides Recur checkout functionality to your React application\n *\n * @example\n * ```tsx\n * <RecurProvider config={{ organizationId: 'org_xxx' }}>\n * <App />\n * </RecurProvider>\n * ```\n */\nexport function RecurProvider({ children, config: initialConfig = {} }: RecurProviderProps) {\n const [config, setConfig] = useState<RecurConfig>({\n redirectMode: 'redirect',\n ...initialConfig,\n });\n\n const [isCheckingOut, setIsCheckingOut] = useState(false);\n\n const updateConfig = useCallback((newConfig: Partial<RecurConfig>) => {\n setConfig((prev) => ({ ...prev, ...newConfig }));\n }, []);\n\n const checkout = useCallback(\n async (options: CheckoutOptions) => {\n try {\n setIsCheckingOut(true);\n\n // Validate required fields\n if (!options.planId) {\n throw new Error('planId is required');\n }\n\n // Determine organization ID\n const organizationId = options.organizationId || config.organizationId;\n if (!organizationId) {\n throw new Error('organizationId is required. Provide it in RecurProvider config or checkout options.');\n }\n\n // Determine base URL\n const baseUrl = config.baseUrl || (typeof window !== 'undefined' ? window.location.origin : '');\n\n // Call the subscription API\n const response = await fetch(`${baseUrl}/api/subscriptions`, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n organizationId,\n planId: options.planId,\n customerName: options.customerName,\n customerEmail: options.customerEmail,\n customerPhone: options.customerPhone,\n }),\n });\n\n if (!response.ok) {\n const errorData = await response.json().catch(() => ({}));\n const error: CheckoutError = {\n code: errorData.error || 'CHECKOUT_FAILED',\n message: errorData.message || 'Failed to initiate checkout',\n details: errorData,\n };\n\n options.onError?.(error);\n throw new Error(error.message);\n }\n\n const result: CheckoutResult = await response.json();\n\n // Call success callback\n options.onSuccess?.(result);\n\n // Handle redirect based on mode\n if (config.redirectMode === 'popup') {\n // Open payment in popup window\n const popup = window.open(\n result.paymentUrl,\n 'recurCheckout',\n 'width=600,height=700,scrollbars=yes,resizable=yes'\n );\n\n if (!popup) {\n throw new Error('Failed to open popup. Please allow popups for this site.');\n }\n\n // Poll for popup close\n const pollInterval = setInterval(() => {\n if (popup.closed) {\n clearInterval(pollInterval);\n setIsCheckingOut(false);\n\n // Check if payment was completed\n // You might want to implement a message listener here\n // or poll your API to check subscription status\n if (options.onPaymentComplete) {\n // Note: result.subscription may not have all fields for SubscriptionResult\n // You may need to fetch full subscription details from API\n options.onPaymentComplete(result.subscription as any);\n }\n }\n }, 500);\n } else {\n // Full page redirect\n window.location.href = result.paymentUrl;\n }\n } catch (error) {\n const checkoutError: CheckoutError = {\n code: 'CHECKOUT_ERROR',\n message: error instanceof Error ? error.message : 'An unknown error occurred',\n };\n\n options.onError?.(checkoutError);\n setIsCheckingOut(false);\n throw error;\n }\n },\n [config]\n );\n\n const value = useMemo(\n () => ({\n config,\n checkout,\n isCheckingOut,\n updateConfig,\n }),\n [config, checkout, isCheckingOut, updateConfig]\n );\n\n return <RecurContext.Provider value={value}>{children}</RecurContext.Provider>;\n}\n\nexport { RecurContext };\n","'use client';\n\nimport { useContext } from 'react';\nimport { RecurContext } from './context.js';\nimport type { RecurContextValue } from './types.js';\n\n/**\n * useRecur Hook\n *\n * Access Recur checkout functionality from within your components\n *\n * @example\n * ```tsx\n * function MyComponent() {\n * const { checkout, isCheckingOut } = useRecur();\n *\n * return (\n * <button\n * onClick={() => checkout({ planId: 'pro' })}\n * disabled={isCheckingOut}\n * >\n * {isCheckingOut ? 'Processing...' : 'Subscribe'}\n * </button>\n * );\n * }\n * ```\n *\n * @throws {Error} If used outside of RecurProvider\n */\nexport function useRecur(): RecurContextValue {\n const context = useContext(RecurContext);\n\n if (!context) {\n throw new Error('useRecur must be used within a RecurProvider');\n }\n\n return context;\n}\n"]}

package/package.json ADDED Viewed

@@ -0,0 +1,66 @@
+{
+  "name": "recur-tw",
+  "version": "0.0.1",
+  "description": "React SDK for embedding subscription checkout flows (Taiwan / PAYUNi)",
+  "type": "module",
+  "private": false,
+  "author": "Recur",
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "subscription",
+    "checkout",
+    "payment",
+    "payuni",
+    "recurring-billing",
+    "taiwan",
+    "繁體中文"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/recur-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/recur-sdk/issues"
+  },
+  "homepage": "https://github.com/your-org/recur-sdk#readme",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint . --max-warnings 0",
+    "type-check": "tsc --noEmit"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.9",
+    "@types/react": "^19.1.9",
+    "@types/react-dom": "^19.1.7",
+    "@workspace/eslint-config": "workspace:*",
+    "@workspace/typescript-config": "workspace:*",
+    "eslint": "^9.32.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.2"
+  }
+}