recur-tw 0.6.1 → 0.7.0

package/dist/server.cjs

@@ -0,0 +1,117 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/server/types.ts
+var RecurAPIError = class extends Error {
+  constructor(error, statusCode) {
+    super(error.message);
+    __publicField(this, "type");
+    __publicField(this, "code");
+    __publicField(this, "statusCode");
+    this.name = "RecurAPIError";
+    this.type = error.type;
+    this.code = error.code;
+    this.statusCode = statusCode;
+  }
+};
+
+// src/server/resources/portal.ts
+var PortalSessions = class {
+  constructor(config) {
+    __publicField(this, "config");
+    this.config = config;
+  }
+  /**
+   * Create a portal session for a customer
+   *
+   * @param params - Portal session creation parameters
+   * @returns The created portal session with URL
+   *
+   * @example
+   * ```typescript
+   * const session = await recur.portal.sessions.create({
+   *   customer: 'cus_xxx',
+   *   returnUrl: 'https://myapp.com/account',
+   * });
+   *
+   * // Redirect the customer to the portal
+   * redirect(session.url);
+   * ```
+   */
+  async create(params) {
+    const baseUrl = this.config.baseUrl || "https://api.recur.tw";
+    const response = await fetch(`${baseUrl}/v1/portal/sessions`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${this.config.secretKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        customerId: params.customer,
+        returnUrl: params.returnUrl,
+        configurationId: params.configuration,
+        locale: params.locale
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const error = data.error;
+      throw new RecurAPIError(error, response.status);
+    }
+    return {
+      id: data.id,
+      object: "portal.session",
+      url: data.url,
+      customer: data.customerId,
+      returnUrl: data.returnUrl,
+      status: data.status,
+      expiresAt: data.expiresAt,
+      accessedAt: data.accessedAt,
+      createdAt: data.createdAt
+    };
+  }
+};
+var Portal = class {
+  constructor(config) {
+    __publicField(this, "sessions");
+    this.sessions = new PortalSessions(config);
+  }
+};
+
+// src/server/recur.ts
+var Recur = class {
+  /**
+   * Create a new Recur client
+   *
+   * @param secretKey - Your Recur secret API key (sk_test_xxx or sk_live_xxx)
+   * @param options - Additional configuration options
+   */
+  constructor(secretKey, options) {
+    __publicField(this, "config");
+    /**
+     * Portal resource for managing customer portal sessions
+     */
+    __publicField(this, "portal");
+    if (!secretKey) {
+      throw new Error(
+        "Recur: secretKey is required. Get your API key from your organization settings."
+      );
+    }
+    if (!secretKey.startsWith("sk_")) {
+      throw new Error(
+        'Recur: Invalid API key format. Secret keys should start with "sk_". Use your secret key (sk_xxx), not your publishable key (pk_xxx).'
+      );
+    }
+    this.config = {
+      secretKey,
+      baseUrl: options?.baseUrl || "https://api.recur.tw"
+    };
+    this.portal = new Portal(this.config);
+  }
+};
+
+exports.Recur = Recur;
+exports.RecurAPIError = RecurAPIError;

package/dist/server.d.cts

@@ -0,0 +1,157 @@
+/**
+ * Recur Server SDK Types
+ */
+interface RecurConfig {
+    /**
+     * Secret API key for authentication
+     * Get this from your organization settings
+     *
+     * @example 'sk_test_abc123...' or 'sk_live_xyz789...'
+     */
+    secretKey: string;
+    /**
+     * Base URL for API calls
+     * Defaults to 'https://api.recur.tw'
+     */
+    baseUrl?: string;
+}
+interface PortalSessionCreateParams {
+    /**
+     * The ID of the customer to create a portal session for
+     */
+    customer: string;
+    /**
+     * The URL to redirect the customer to when they exit the portal
+     * If not provided, uses the default return URL from portal configuration
+     */
+    returnUrl?: string;
+    /**
+     * The ID of a specific portal configuration to use
+     * If not provided, uses the default configuration
+     */
+    configuration?: string;
+    /**
+     * Preferred locale for the portal
+     */
+    locale?: 'zh-TW' | 'en';
+}
+interface PortalSession {
+    /**
+     * Unique identifier for the portal session
+     */
+    id: string;
+    /**
+     * String representing the object's type
+     */
+    object: 'portal.session';
+    /**
+     * The URL to redirect the customer to access the portal
+     */
+    url: string;
+    /**
+     * The ID of the customer for this session
+     */
+    customer: string;
+    /**
+     * The URL to redirect the customer when they exit the portal
+     */
+    returnUrl: string;
+    /**
+     * The status of the session
+     */
+    status: 'active' | 'expired';
+    /**
+     * Time at which the session expires (ISO 8601)
+     */
+    expiresAt: string;
+    /**
+     * Time at which the session was last accessed (ISO 8601), or null
+     */
+    accessedAt: string | null;
+    /**
+     * Time at which the session was created (ISO 8601)
+     */
+    createdAt: string;
+}
+interface RecurError {
+    type: 'authentication_error' | 'invalid_request_error' | 'api_error';
+    code: string;
+    message: string;
+    details?: unknown;
+}
+declare class RecurAPIError extends Error {
+    readonly type: string;
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(error: RecurError, statusCode: number);
+}
+
+/**
+ * Portal Sessions Resource
+ *
+ * Create portal sessions to allow customers to manage their subscriptions
+ */
+
+declare class PortalSessions {
+    private config;
+    constructor(config: RecurConfig);
+    /**
+     * Create a portal session for a customer
+     *
+     * @param params - Portal session creation parameters
+     * @returns The created portal session with URL
+     *
+     * @example
+     * ```typescript
+     * const session = await recur.portal.sessions.create({
+     *   customer: 'cus_xxx',
+     *   returnUrl: 'https://myapp.com/account',
+     * });
+     *
+     * // Redirect the customer to the portal
+     * redirect(session.url);
+     * ```
+     */
+    create(params: PortalSessionCreateParams): Promise<PortalSession>;
+}
+declare class Portal {
+    readonly sessions: PortalSessions;
+    constructor(config: RecurConfig);
+}
+
+/**
+ * Recur Server SDK
+ *
+ * Server-side SDK for interacting with the Recur API
+ * Use this in your backend (API routes, server actions, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { Recur } from 'recur-tw/server';
+ *
+ * const recur = new Recur(process.env.RECUR_SECRET_KEY!);
+ *
+ * // Create a portal session
+ * const session = await recur.portal.sessions.create({
+ *   customer: 'cus_xxx',
+ *   returnUrl: 'https://myapp.com/account',
+ * });
+ * ```
+ */
+
+declare class Recur {
+    private config;
+    /**
+     * Portal resource for managing customer portal sessions
+     */
+    readonly portal: Portal;
+    /**
+     * Create a new Recur client
+     *
+     * @param secretKey - Your Recur secret API key (sk_test_xxx or sk_live_xxx)
+     * @param options - Additional configuration options
+     */
+    constructor(secretKey: string, options?: Omit<RecurConfig, 'secretKey'>);
+}
+
+export { type PortalSession, type PortalSessionCreateParams, Recur, RecurAPIError, type RecurConfig, type RecurError };

package/dist/server.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Recur Server SDK Types
+ */
+interface RecurConfig {
+    /**
+     * Secret API key for authentication
+     * Get this from your organization settings
+     *
+     * @example 'sk_test_abc123...' or 'sk_live_xyz789...'
+     */
+    secretKey: string;
+    /**
+     * Base URL for API calls
+     * Defaults to 'https://api.recur.tw'
+     */
+    baseUrl?: string;
+}
+interface PortalSessionCreateParams {
+    /**
+     * The ID of the customer to create a portal session for
+     */
+    customer: string;
+    /**
+     * The URL to redirect the customer to when they exit the portal
+     * If not provided, uses the default return URL from portal configuration
+     */
+    returnUrl?: string;
+    /**
+     * The ID of a specific portal configuration to use
+     * If not provided, uses the default configuration
+     */
+    configuration?: string;
+    /**
+     * Preferred locale for the portal
+     */
+    locale?: 'zh-TW' | 'en';
+}
+interface PortalSession {
+    /**
+     * Unique identifier for the portal session
+     */
+    id: string;
+    /**
+     * String representing the object's type
+     */
+    object: 'portal.session';
+    /**
+     * The URL to redirect the customer to access the portal
+     */
+    url: string;
+    /**
+     * The ID of the customer for this session
+     */
+    customer: string;
+    /**
+     * The URL to redirect the customer when they exit the portal
+     */
+    returnUrl: string;
+    /**
+     * The status of the session
+     */
+    status: 'active' | 'expired';
+    /**
+     * Time at which the session expires (ISO 8601)
+     */
+    expiresAt: string;
+    /**
+     * Time at which the session was last accessed (ISO 8601), or null
+     */
+    accessedAt: string | null;
+    /**
+     * Time at which the session was created (ISO 8601)
+     */
+    createdAt: string;
+}
+interface RecurError {
+    type: 'authentication_error' | 'invalid_request_error' | 'api_error';
+    code: string;
+    message: string;
+    details?: unknown;
+}
+declare class RecurAPIError extends Error {
+    readonly type: string;
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(error: RecurError, statusCode: number);
+}
+
+/**
+ * Portal Sessions Resource
+ *
+ * Create portal sessions to allow customers to manage their subscriptions
+ */
+
+declare class PortalSessions {
+    private config;
+    constructor(config: RecurConfig);
+    /**
+     * Create a portal session for a customer
+     *
+     * @param params - Portal session creation parameters
+     * @returns The created portal session with URL
+     *
+     * @example
+     * ```typescript
+     * const session = await recur.portal.sessions.create({
+     *   customer: 'cus_xxx',
+     *   returnUrl: 'https://myapp.com/account',
+     * });
+     *
+     * // Redirect the customer to the portal
+     * redirect(session.url);
+     * ```
+     */
+    create(params: PortalSessionCreateParams): Promise<PortalSession>;
+}
+declare class Portal {
+    readonly sessions: PortalSessions;
+    constructor(config: RecurConfig);
+}
+
+/**
+ * Recur Server SDK
+ *
+ * Server-side SDK for interacting with the Recur API
+ * Use this in your backend (API routes, server actions, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { Recur } from 'recur-tw/server';
+ *
+ * const recur = new Recur(process.env.RECUR_SECRET_KEY!);
+ *
+ * // Create a portal session
+ * const session = await recur.portal.sessions.create({
+ *   customer: 'cus_xxx',
+ *   returnUrl: 'https://myapp.com/account',
+ * });
+ * ```
+ */
+
+declare class Recur {
+    private config;
+    /**
+     * Portal resource for managing customer portal sessions
+     */
+    readonly portal: Portal;
+    /**
+     * Create a new Recur client
+     *
+     * @param secretKey - Your Recur secret API key (sk_test_xxx or sk_live_xxx)
+     * @param options - Additional configuration options
+     */
+    constructor(secretKey: string, options?: Omit<RecurConfig, 'secretKey'>);
+}
+
+export { type PortalSession, type PortalSessionCreateParams, Recur, RecurAPIError, type RecurConfig, type RecurError };

package/dist/server.js

@@ -0,0 +1,114 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/server/types.ts
+var RecurAPIError = class extends Error {
+  constructor(error, statusCode) {
+    super(error.message);
+    __publicField(this, "type");
+    __publicField(this, "code");
+    __publicField(this, "statusCode");
+    this.name = "RecurAPIError";
+    this.type = error.type;
+    this.code = error.code;
+    this.statusCode = statusCode;
+  }
+};
+
+// src/server/resources/portal.ts
+var PortalSessions = class {
+  constructor(config) {
+    __publicField(this, "config");
+    this.config = config;
+  }
+  /**
+   * Create a portal session for a customer
+   *
+   * @param params - Portal session creation parameters
+   * @returns The created portal session with URL
+   *
+   * @example
+   * ```typescript
+   * const session = await recur.portal.sessions.create({
+   *   customer: 'cus_xxx',
+   *   returnUrl: 'https://myapp.com/account',
+   * });
+   *
+   * // Redirect the customer to the portal
+   * redirect(session.url);
+   * ```
+   */
+  async create(params) {
+    const baseUrl = this.config.baseUrl || "https://api.recur.tw";
+    const response = await fetch(`${baseUrl}/v1/portal/sessions`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${this.config.secretKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        customerId: params.customer,
+        returnUrl: params.returnUrl,
+        configurationId: params.configuration,
+        locale: params.locale
+      })
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const error = data.error;
+      throw new RecurAPIError(error, response.status);
+    }
+    return {
+      id: data.id,
+      object: "portal.session",
+      url: data.url,
+      customer: data.customerId,
+      returnUrl: data.returnUrl,
+      status: data.status,
+      expiresAt: data.expiresAt,
+      accessedAt: data.accessedAt,
+      createdAt: data.createdAt
+    };
+  }
+};
+var Portal = class {
+  constructor(config) {
+    __publicField(this, "sessions");
+    this.sessions = new PortalSessions(config);
+  }
+};
+
+// src/server/recur.ts
+var Recur = class {
+  /**
+   * Create a new Recur client
+   *
+   * @param secretKey - Your Recur secret API key (sk_test_xxx or sk_live_xxx)
+   * @param options - Additional configuration options
+   */
+  constructor(secretKey, options) {
+    __publicField(this, "config");
+    /**
+     * Portal resource for managing customer portal sessions
+     */
+    __publicField(this, "portal");
+    if (!secretKey) {
+      throw new Error(
+        "Recur: secretKey is required. Get your API key from your organization settings."
+      );
+    }
+    if (!secretKey.startsWith("sk_")) {
+      throw new Error(
+        'Recur: Invalid API key format. Secret keys should start with "sk_". Use your secret key (sk_xxx), not your publishable key (pk_xxx).'
+      );
+    }
+    this.config = {
+      secretKey,
+      baseUrl: options?.baseUrl || "https://api.recur.tw"
+    };
+    this.portal = new Portal(this.config);
+  }
+};
+
+export { Recur, RecurAPIError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recur-tw",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "React & Vanilla JS SDK for embedding subscription checkout flows (Taiwan / PAYUNi)",
   "type": "module",
   "private": false,
@@ -45,6 +45,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
     "./vanilla": "./dist/recur.umd.js",
     "./package.json": "./package.json"
   },
@@ -82,8 +87,8 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
     "postcss": "^8.5.6",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1",
     "tailwindcss": "^4.1.11",
     "tsup": "^8.3.5",
     "typescript": "^5.9.2",