paylio 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Paylio
+
+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,102 @@
+# Paylio Node.js SDK
+
+Official Node.js/TypeScript client library for the [Paylio API](https://api.paylio.pro).
+
+## Requirements
+
+- Node.js 18 or later
+
+## Installation
+
+```bash
+npm install paylio
+```
+
+## Usage
+
+### TypeScript
+
+```typescript
+import { PaylioClient, AuthenticationError } from "paylio";
+
+const client = new PaylioClient("sk_live_xxx");
+
+// Retrieve current subscription
+const sub = await client.subscription.retrieve("user_123");
+console.log(sub.status, sub.plan.name);
+
+// List subscription history
+const history = await client.subscription.list("user_123", { page: 1, pageSize: 10 });
+for (const item of history.items) {
+  console.log(item.plan_name);
+}
+console.log(history.hasMore);
+
+// Cancel a subscription (safe default: at end of billing period)
+const result = await client.subscription.cancel("sub_uuid");
+console.log(result.success);
+
+// Cancel immediately
+await client.subscription.cancel("sub_uuid", { cancelNow: true });
+
+client.close();
+```
+
+### JavaScript (CommonJS)
+
+```javascript
+const { PaylioClient } = require("paylio");
+
+const client = new PaylioClient("sk_live_xxx");
+const sub = await client.subscription.retrieve("user_123");
+console.log(sub.status);
+client.close();
+```
+
+### Error Handling
+
+```typescript
+import { PaylioClient, AuthenticationError, NotFoundError, PaylioError } from "paylio";
+
+const client = new PaylioClient("sk_live_xxx");
+
+try {
+  await client.subscription.retrieve("user_123");
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error("Invalid API key:", error.message);
+  } else if (error instanceof NotFoundError) {
+    console.error("Subscription not found:", error.message);
+  } else if (error instanceof PaylioError) {
+    console.error(`API error ${error.httpStatus}: ${error.message}`);
+  }
+}
+
+client.close();
+```
+
+### Custom Configuration
+
+```typescript
+const client = new PaylioClient("sk_live_xxx", {
+  baseUrl: "https://custom.api.com/v1",
+  timeout: 60_000, // 60 seconds
+});
+```
+
+## Error Types
+
+| Error | HTTP Status | Description |
+|---|---|---|
+| `AuthenticationError` | 401 | Invalid or missing API key |
+| `InvalidRequestError` | 400 | Bad request parameters |
+| `NotFoundError` | 404 | Resource not found |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `APIError` | 5xx | Server error or unexpected response |
+| `APIConnectionError` | — | Network or connection failure |
+
+All errors extend `PaylioError`, which extends `Error`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,381 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  APIConnectionError: () => APIConnectionError,
+  APIError: () => APIError,
+  AuthenticationError: () => AuthenticationError,
+  InvalidRequestError: () => InvalidRequestError,
+  NotFoundError: () => NotFoundError,
+  PaginatedList: () => PaginatedList,
+  PaylioClient: () => PaylioClient,
+  PaylioError: () => PaylioError,
+  PaylioObject: () => PaylioObject,
+  RateLimitError: () => RateLimitError,
+  Subscription: () => Subscription,
+  SubscriptionCancel: () => SubscriptionCancel,
+  SubscriptionHistoryItem: () => SubscriptionHistoryItem,
+  VERSION: () => VERSION
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var PaylioError = class extends Error {
+  httpStatus;
+  httpBody;
+  jsonBody;
+  headers;
+  code;
+  constructor(params) {
+    const msg = params?.message ?? "";
+    super(msg);
+    this.name = this.constructor.name;
+    this.message = msg;
+    this.httpStatus = params?.httpStatus;
+    this.httpBody = params?.httpBody;
+    this.jsonBody = params?.jsonBody;
+    this.headers = params?.headers ?? {};
+    this.code = params?.code;
+  }
+  toString() {
+    return this.message;
+  }
+};
+var APIError = class extends PaylioError {
+};
+var AuthenticationError = class extends PaylioError {
+};
+var InvalidRequestError = class extends PaylioError {
+};
+var NotFoundError = class extends PaylioError {
+};
+var RateLimitError = class extends PaylioError {
+};
+var APIConnectionError = class extends PaylioError {
+};
+
+// src/version.ts
+var VERSION = "0.1.0";
+
+// src/httpClient.ts
+var DEFAULT_BASE_URL = "https://api.paylio.pro/flying/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var HTTPClient = class {
+  _apiKey;
+  _baseUrl;
+  _timeout;
+  _fetchFn;
+  constructor(options) {
+    this._apiKey = options.apiKey;
+    this._baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this._timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    this._fetchFn = options.fetchFn ?? globalThis.fetch;
+  }
+  async request(method, path, options) {
+    const url = new URL(`${this._baseUrl}${path}`);
+    if (options?.params) {
+      for (const [key, value] of Object.entries(options.params)) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+    const headers = this._buildHeaders();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this._timeout);
+    let response;
+    try {
+      response = await this._fetchFn(url.toString(), {
+        method,
+        headers,
+        body: options?.jsonBody ? JSON.stringify(options.jsonBody) : void 0,
+        signal: controller.signal
+      });
+    } catch (error) {
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new APIConnectionError({ message: "Request timed out" });
+      }
+      throw new APIConnectionError({
+        message: `Connection error: ${error instanceof Error ? error.message : String(error)}`
+      });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+    return this._handleResponse(response);
+  }
+  _buildHeaders() {
+    return {
+      "X-API-Key": this._apiKey,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      "User-Agent": `paylio-node/${VERSION}`
+    };
+  }
+  async _handleResponse(response) {
+    const httpStatus = response.status;
+    const httpBody = await response.text();
+    const headers = {};
+    response.headers.forEach((value, key) => {
+      headers[key] = value;
+    });
+    let jsonBody;
+    try {
+      jsonBody = JSON.parse(httpBody);
+    } catch {
+      jsonBody = void 0;
+    }
+    if (httpStatus >= 200 && httpStatus < 300) {
+      if (!jsonBody) {
+        throw new APIError({
+          message: "Invalid JSON in response body",
+          httpStatus,
+          httpBody
+        });
+      }
+      return jsonBody;
+    }
+    let errorCode;
+    let errorMessage = httpBody;
+    if (jsonBody) {
+      const err = jsonBody["error"];
+      if (err && typeof err === "object" && !Array.isArray(err)) {
+        const errObj = err;
+        errorCode = typeof errObj["code"] === "string" ? errObj["code"] : void 0;
+        errorMessage = typeof errObj["message"] === "string" ? errObj["message"] : httpBody;
+      } else if (typeof err === "string") {
+        errorMessage = err;
+      } else if (typeof jsonBody["detail"] === "string") {
+        errorMessage = jsonBody["detail"];
+      }
+    }
+    const ErrorClass = errorClassForStatus(httpStatus);
+    throw new ErrorClass({
+      message: errorMessage,
+      httpStatus,
+      httpBody,
+      jsonBody,
+      headers,
+      code: errorCode
+    });
+  }
+  close() {
+  }
+};
+function errorClassForStatus(status) {
+  switch (status) {
+    case 401:
+      return AuthenticationError;
+    case 400:
+      return InvalidRequestError;
+    case 404:
+      return NotFoundError;
+    case 429:
+      return RateLimitError;
+    default:
+      return APIError;
+  }
+}
+
+// src/paylioObject.ts
+var PaylioObject = class _PaylioObject {
+  /** @internal */
+  _data;
+  constructor(data) {
+    this._data = {};
+    if (data) {
+      for (const [key, value] of Object.entries(data)) {
+        this._data[key] = _PaylioObject._wrap(value);
+      }
+    }
+    return new Proxy(this, {
+      get(target, prop, receiver) {
+        if (typeof prop === "symbol" || typeof prop !== "string") {
+          return Reflect.get(target, prop, receiver);
+        }
+        if (prop in target && typeof target[prop] === "function") {
+          return target[prop].bind(target);
+        }
+        if (prop.startsWith("_")) {
+          return Reflect.get(target, prop, receiver);
+        }
+        if (prop in target._data) {
+          return target._data[prop];
+        }
+        return Reflect.get(target, prop, receiver);
+      },
+      set(target, prop, value) {
+        if (typeof prop === "string" && !prop.startsWith("_")) {
+          target._data[prop] = value;
+          return true;
+        }
+        return Reflect.set(target, prop, value);
+      }
+    });
+  }
+  static _wrap(value) {
+    if (value instanceof _PaylioObject) {
+      return value;
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => {
+        if (item instanceof _PaylioObject) return item;
+        if (item !== null && typeof item === "object" && !Array.isArray(item)) {
+          return new _PaylioObject(item);
+        }
+        return item;
+      });
+    }
+    if (value !== null && typeof value === "object") {
+      return new _PaylioObject(value);
+    }
+    return value;
+  }
+  get(key, defaultValue) {
+    return key in this._data ? this._data[key] : defaultValue;
+  }
+  toDict() {
+    const result = {};
+    for (const [key, value] of Object.entries(this._data)) {
+      if (value instanceof _PaylioObject) {
+        result[key] = value.toDict();
+      } else if (Array.isArray(value)) {
+        result[key] = value.map(
+          (item) => item instanceof _PaylioObject ? item.toDict() : item
+        );
+      } else {
+        result[key] = value;
+      }
+    }
+    return result;
+  }
+  static constructFrom(data) {
+    return new _PaylioObject(data);
+  }
+  toString() {
+    const id = this._data["id"];
+    if (id !== void 0 && id !== null) {
+      return `<${this.constructor.name} id=${id}>`;
+    }
+    return `<${this.constructor.name} ${JSON.stringify(this._data)}>`;
+  }
+};
+
+// src/resources/subscription.ts
+var Subscription = class extends PaylioObject {
+  static OBJECT_NAME = "subscription";
+};
+var SubscriptionCancel = class extends PaylioObject {
+  static OBJECT_NAME = "subscription_cancel";
+};
+var SubscriptionHistoryItem = class extends PaylioObject {
+  static OBJECT_NAME = "subscription_history_item";
+};
+var PaginatedList = class extends PaylioObject {
+  static OBJECT_NAME = "list";
+  get hasMore() {
+    const page = this.get("page", 1);
+    const totalPages = this.get("total_pages", 1);
+    return page < totalPages;
+  }
+};
+
+// src/services/subscriptionService.ts
+var SubscriptionService = class {
+  _http;
+  constructor(httpClient) {
+    this._http = httpClient;
+  }
+  async retrieve(userId) {
+    if (!userId || !userId.trim()) {
+      throw new Error("userId is required");
+    }
+    const data = await this._http.request("GET", `/subscription/${userId}`);
+    return new Subscription(data);
+  }
+  async list(userId, options) {
+    if (!userId || !userId.trim()) {
+      throw new Error("userId is required");
+    }
+    const params = {
+      page: options?.page ?? 1,
+      page_size: options?.pageSize ?? 20
+    };
+    const data = await this._http.request("GET", `/users/${userId}/subscriptions`, { params });
+    if (data["items"] && Array.isArray(data["items"])) {
+      data["items"] = data["items"].map(
+        (item) => new SubscriptionHistoryItem(item)
+      );
+    }
+    return new PaginatedList(data);
+  }
+  async cancel(subscriptionId, options) {
+    if (!subscriptionId || !subscriptionId.trim()) {
+      throw new Error("subscriptionId is required");
+    }
+    const cancelNow = options?.cancelNow ?? false;
+    const data = await this._http.request("POST", `/subscription/${subscriptionId}/cancel`, {
+      jsonBody: { cancel_at_period_end: !cancelNow }
+    });
+    return new SubscriptionCancel(data);
+  }
+};
+
+// src/client.ts
+var PaylioClient = class {
+  _http;
+  subscription;
+  constructor(apiKey, options) {
+    if (!apiKey) {
+      throw new AuthenticationError({
+        message: "No API key provided. Set your API key when creating the PaylioClient: new PaylioClient('sk_live_xxx')"
+      });
+    }
+    this._http = new HTTPClient({
+      apiKey,
+      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,
+      timeout: options?.timeout ?? DEFAULT_TIMEOUT,
+      fetchFn: options?.fetchFn
+    });
+    this.subscription = new SubscriptionService(this._http);
+  }
+  close() {
+    this._http.close();
+  }
+  [Symbol.dispose]() {
+    this.close();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIConnectionError,
+  APIError,
+  AuthenticationError,
+  InvalidRequestError,
+  NotFoundError,
+  PaginatedList,
+  PaylioClient,
+  PaylioError,
+  PaylioObject,
+  RateLimitError,
+  Subscription,
+  SubscriptionCancel,
+  SubscriptionHistoryItem,
+  VERSION
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/version.ts","../src/httpClient.ts","../src/paylioObject.ts","../src/resources/subscription.ts","../src/services/subscriptionService.ts","../src/client.ts"],"sourcesContent":["export { PaylioClient } from \"./client.js\";\nexport type { PaylioClientOptions } from \"./client.js\";\n\nexport {\n  PaylioError,\n  APIError,\n  APIConnectionError,\n  AuthenticationError,\n  InvalidRequestError,\n  NotFoundError,\n  RateLimitError,\n} from \"./errors.js\";\nexport type { PaylioErrorParams } from \"./errors.js\";\n\nexport { PaylioObject } from \"./paylioObject.js\";\n\nexport {\n  Subscription,\n  SubscriptionCancel,\n  SubscriptionHistoryItem,\n  PaginatedList,\n} from \"./resources/subscription.js\";\n\nexport { VERSION } from \"./version.js\";\n","export interface PaylioErrorParams {\n  message?: string;\n  httpStatus?: number;\n  httpBody?: string;\n  jsonBody?: Record<string, unknown>;\n  headers?: Record<string, string>;\n  code?: string;\n}\n\nexport class PaylioError extends Error {\n  readonly httpStatus: number | undefined;\n  readonly httpBody: string | undefined;\n  readonly jsonBody: Record<string, unknown> | undefined;\n  readonly headers: Record<string, string>;\n  readonly code: string | undefined;\n\n  constructor(params?: PaylioErrorParams) {\n    const msg = params?.message ?? \"\";\n    super(msg);\n    this.name = this.constructor.name;\n    this.message = msg;\n    this.httpStatus = params?.httpStatus;\n    this.httpBody = params?.httpBody;\n    this.jsonBody = params?.jsonBody;\n    this.headers = params?.headers ?? {};\n    this.code = params?.code;\n  }\n\n  override toString(): string {\n    return this.message;\n  }\n}\n\n/** General API error (5xx or unexpected responses). */\nexport class APIError extends PaylioError {}\n\n/** Invalid or missing API key (401). */\nexport class AuthenticationError extends PaylioError {}\n\n/** Bad request parameters (400). */\nexport class InvalidRequestError extends PaylioError {}\n\n/** Resource not found (404). */\nexport class NotFoundError extends PaylioError {}\n\n/** Rate limit exceeded (429). */\nexport class RateLimitError extends PaylioError {}\n\n/** Network/connection failure. */\nexport class APIConnectionError extends PaylioError {}\n","export const VERSION = \"0.1.0\";\n","import {\n  APIConnectionError,\n  APIError,\n  AuthenticationError,\n  InvalidRequestError,\n  NotFoundError,\n  PaylioError,\n  RateLimitError,\n} from \"./errors.js\";\nimport { VERSION } from \"./version.js\";\n\nexport const DEFAULT_BASE_URL = \"https://api.paylio.pro/flying/v1\";\nexport const DEFAULT_TIMEOUT = 30_000;\n\nexport interface HTTPClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  timeout?: number;\n  fetchFn?: typeof fetch;\n}\n\nexport class HTTPClient {\n  private readonly _apiKey: string;\n  private readonly _baseUrl: string;\n  private readonly _timeout: number;\n  private readonly _fetchFn: typeof fetch;\n\n  constructor(options: HTTPClientOptions) {\n    this._apiKey = options.apiKey;\n    this._baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this._timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this._fetchFn = options.fetchFn ?? globalThis.fetch;\n  }\n\n  async request(\n    method: string,\n    path: string,\n    options?: {\n      params?: Record<string, string | number>;\n      jsonBody?: Record<string, unknown>;\n    },\n  ): Promise<Record<string, unknown>> {\n    const url = new URL(`${this._baseUrl}${path}`);\n    if (options?.params) {\n      for (const [key, value] of Object.entries(options.params)) {\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    const headers = this._buildHeaders();\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this._timeout);\n\n    let response: Response;\n    try {\n      response = await this._fetchFn(url.toString(), {\n        method,\n        headers,\n        body: options?.jsonBody ? JSON.stringify(options.jsonBody) : undefined,\n        signal: controller.signal,\n      });\n    } catch (error: unknown) {\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new APIConnectionError({ message: \"Request timed out\" });\n      }\n      throw new APIConnectionError({\n        message: `Connection error: ${error instanceof Error ? error.message : String(error)}`,\n      });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n\n    return this._handleResponse(response);\n  }\n\n  private _buildHeaders(): Record<string, string> {\n    return {\n      \"X-API-Key\": this._apiKey,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      \"User-Agent\": `paylio-node/${VERSION}`,\n    };\n  }\n\n  private async _handleResponse(response: Response): Promise<Record<string, unknown>> {\n    const httpStatus = response.status;\n    const httpBody = await response.text();\n    const headers: Record<string, string> = {};\n    response.headers.forEach((value, key) => {\n      headers[key] = value;\n    });\n\n    let jsonBody: Record<string, unknown> | undefined;\n    try {\n      jsonBody = JSON.parse(httpBody) as Record<string, unknown>;\n    } catch {\n      jsonBody = undefined;\n    }\n\n    if (httpStatus >= 200 && httpStatus < 300) {\n      if (!jsonBody) {\n        throw new APIError({\n          message: \"Invalid JSON in response body\",\n          httpStatus,\n          httpBody,\n        });\n      }\n      return jsonBody;\n    }\n\n    // Extract error details — handle all 3 backend response formats:\n    //   {\"error\": {\"code\": \"...\", \"message\": \"...\"}}  (public API v1)\n    //   {\"error\": \"string\"}                           (legacy API)\n    //   {\"detail\": \"string\"}                          (FastAPI / dashboard)\n    let errorCode: string | undefined;\n    let errorMessage: string = httpBody;\n\n    if (jsonBody) {\n      const err = jsonBody[\"error\"];\n      if (err && typeof err === \"object\" && !Array.isArray(err)) {\n        const errObj = err as Record<string, unknown>;\n        errorCode = typeof errObj[\"code\"] === \"string\" ? errObj[\"code\"] : undefined;\n        errorMessage =\n          typeof errObj[\"message\"] === \"string\" ? (errObj[\"message\"] as string) : httpBody;\n      } else if (typeof err === \"string\") {\n        errorMessage = err;\n      } else if (typeof jsonBody[\"detail\"] === \"string\") {\n        errorMessage = jsonBody[\"detail\"] as string;\n      }\n    }\n\n    const ErrorClass = errorClassForStatus(httpStatus);\n    throw new ErrorClass({\n      message: errorMessage,\n      httpStatus,\n      httpBody,\n      jsonBody,\n      headers,\n      code: errorCode,\n    });\n  }\n\n  close(): void {\n    // No-op for fetch-based client. Included for API parity with Python SDK.\n  }\n}\n\nfunction errorClassForStatus(status: number): typeof PaylioError {\n  switch (status) {\n    case 401:\n      return AuthenticationError;\n    case 400:\n      return InvalidRequestError;\n    case 404:\n      return NotFoundError;\n    case 429:\n      return RateLimitError;\n    default:\n      return APIError;\n  }\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Base class for Paylio API response objects.\n *\n * Supports both dot-style and bracket-style access:\n *   (obj as any).status  // dot access\n *   obj[\"status\"]        // bracket access (via Proxy)\n */\nexport class PaylioObject {\n  /** @internal */\n  readonly _data: Record<string, unknown>;\n\n  constructor(data?: Record<string, unknown>) {\n    this._data = {};\n    if (data) {\n      for (const [key, value] of Object.entries(data)) {\n        this._data[key] = PaylioObject._wrap(value);\n      }\n    }\n\n    return new Proxy(this, {\n      get(target, prop, receiver) {\n        // Let class methods and internals resolve normally via prototype chain\n        if (typeof prop === \"symbol\" || typeof prop !== \"string\") {\n          return Reflect.get(target, prop, receiver);\n        }\n        // Prioritize own methods over data keys\n        if (prop in target && typeof (target as any)[prop] === \"function\") {\n          return (target as any)[prop].bind(target);\n        }\n        // Internal properties (starting with _) go to the real object\n        if (prop.startsWith(\"_\")) {\n          return Reflect.get(target, prop, receiver);\n        }\n        // Data keys\n        if (prop in target._data) {\n          return target._data[prop];\n        }\n        // Fallback to prototype chain (constructor, etc.)\n        return Reflect.get(target, prop, receiver);\n      },\n      set(target, prop, value) {\n        if (typeof prop === \"string\" && !prop.startsWith(\"_\")) {\n          target._data[prop] = value;\n          return true;\n        }\n        return Reflect.set(target, prop, value);\n      },\n    });\n  }\n\n  static _wrap(value: unknown): unknown {\n    if (value instanceof PaylioObject) {\n      return value;\n    }\n    if (Array.isArray(value)) {\n      return value.map((item) => {\n        if (item instanceof PaylioObject) return item;\n        if (item !== null && typeof item === \"object\" && !Array.isArray(item)) {\n          return new PaylioObject(item as Record<string, unknown>);\n        }\n        return item;\n      });\n    }\n    if (value !== null && typeof value === \"object\") {\n      return new PaylioObject(value as Record<string, unknown>);\n    }\n    return value;\n  }\n\n  get(key: string, defaultValue?: unknown): unknown {\n    return key in this._data ? this._data[key] : defaultValue;\n  }\n\n  toDict(): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(this._data)) {\n      if (value instanceof PaylioObject) {\n        result[key] = value.toDict();\n      } else if (Array.isArray(value)) {\n        result[key] = value.map((item: any) =>\n          item instanceof PaylioObject ? item.toDict() : item,\n        );\n      } else {\n        result[key] = value;\n      }\n    }\n    return result;\n  }\n\n  static constructFrom(data: Record<string, unknown>): PaylioObject {\n    return new PaylioObject(data);\n  }\n\n  toString(): string {\n    const id = this._data[\"id\"];\n    if (id !== undefined && id !== null) {\n      return `<${this.constructor.name} id=${id}>`;\n    }\n    return `<${this.constructor.name} ${JSON.stringify(this._data)}>`;\n  }\n}\n","import { PaylioObject } from \"../paylioObject.js\";\n\nexport class Subscription extends PaylioObject {\n  static readonly OBJECT_NAME = \"subscription\";\n}\n\nexport class SubscriptionCancel extends PaylioObject {\n  static readonly OBJECT_NAME = \"subscription_cancel\";\n}\n\nexport class SubscriptionHistoryItem extends PaylioObject {\n  static readonly OBJECT_NAME = \"subscription_history_item\";\n}\n\nexport class PaginatedList extends PaylioObject {\n  static readonly OBJECT_NAME = \"list\";\n\n  get hasMore(): boolean {\n    const page = this.get(\"page\", 1) as number;\n    const totalPages = this.get(\"total_pages\", 1) as number;\n    return page < totalPages;\n  }\n}\n","import type { HTTPClient } from \"../httpClient.js\";\nimport {\n  PaginatedList,\n  Subscription,\n  SubscriptionCancel,\n  SubscriptionHistoryItem,\n} from \"../resources/subscription.js\";\n\nexport class SubscriptionService {\n  private readonly _http: HTTPClient;\n\n  constructor(httpClient: HTTPClient) {\n    this._http = httpClient;\n  }\n\n  async retrieve(userId: string): Promise<Subscription> {\n    if (!userId || !userId.trim()) {\n      throw new Error(\"userId is required\");\n    }\n    const data = await this._http.request(\"GET\", `/subscription/${userId}`);\n    return new Subscription(data);\n  }\n\n  async list(\n    userId: string,\n    options?: { page?: number; pageSize?: number },\n  ): Promise<PaginatedList> {\n    if (!userId || !userId.trim()) {\n      throw new Error(\"userId is required\");\n    }\n\n    const params = {\n      page: options?.page ?? 1,\n      page_size: options?.pageSize ?? 20,\n    };\n\n    const data = await this._http.request(\"GET\", `/users/${userId}/subscriptions`, { params });\n\n    // Convert items to typed objects\n    if (data[\"items\"] && Array.isArray(data[\"items\"])) {\n      data[\"items\"] = (data[\"items\"] as Record<string, unknown>[]).map(\n        (item) => new SubscriptionHistoryItem(item),\n      );\n    }\n\n    return new PaginatedList(data);\n  }\n\n  async cancel(\n    subscriptionId: string,\n    options?: { cancelNow?: boolean },\n  ): Promise<SubscriptionCancel> {\n    if (!subscriptionId || !subscriptionId.trim()) {\n      throw new Error(\"subscriptionId is required\");\n    }\n\n    const cancelNow = options?.cancelNow ?? false;\n    const data = await this._http.request(\"POST\", `/subscription/${subscriptionId}/cancel`, {\n      jsonBody: { cancel_at_period_end: !cancelNow },\n    });\n    return new SubscriptionCancel(data);\n  }\n}\n","import { AuthenticationError } from \"./errors.js\";\nimport { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, HTTPClient } from \"./httpClient.js\";\nimport { SubscriptionService } from \"./services/subscriptionService.js\";\n\nexport interface PaylioClientOptions {\n  baseUrl?: string;\n  timeout?: number;\n  fetchFn?: typeof fetch;\n}\n\nexport class PaylioClient {\n  private readonly _http: HTTPClient;\n  readonly subscription: SubscriptionService;\n\n  constructor(apiKey: string, options?: PaylioClientOptions) {\n    if (!apiKey) {\n      throw new AuthenticationError({\n        message:\n          \"No API key provided. Set your API key when creating \" +\n          \"the PaylioClient: new PaylioClient('sk_live_xxx')\",\n      });\n    }\n\n    this._http = new HTTPClient({\n      apiKey,\n      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,\n      timeout: options?.timeout ?? DEFAULT_TIMEOUT,\n      fetchFn: options?.fetchFn,\n    });\n\n    this.subscription = new SubscriptionService(this._http);\n  }\n\n  close(): void {\n    this._http.close();\n  }\n\n  [Symbol.dispose](): void {\n    this.close();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,118 @@
+interface HTTPClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    fetchFn?: typeof fetch;
+}
+declare class HTTPClient {
+    private readonly _apiKey;
+    private readonly _baseUrl;
+    private readonly _timeout;
+    private readonly _fetchFn;
+    constructor(options: HTTPClientOptions);
+    request(method: string, path: string, options?: {
+        params?: Record<string, string | number>;
+        jsonBody?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    private _buildHeaders;
+    private _handleResponse;
+    close(): void;
+}
+
+/**
+ * Base class for Paylio API response objects.
+ *
+ * Supports both dot-style and bracket-style access:
+ *   (obj as any).status  // dot access
+ *   obj["status"]        // bracket access (via Proxy)
+ */
+declare class PaylioObject {
+    /** @internal */
+    readonly _data: Record<string, unknown>;
+    constructor(data?: Record<string, unknown>);
+    static _wrap(value: unknown): unknown;
+    get(key: string, defaultValue?: unknown): unknown;
+    toDict(): Record<string, unknown>;
+    static constructFrom(data: Record<string, unknown>): PaylioObject;
+    toString(): string;
+}
+
+declare class Subscription extends PaylioObject {
+    static readonly OBJECT_NAME = "subscription";
+}
+declare class SubscriptionCancel extends PaylioObject {
+    static readonly OBJECT_NAME = "subscription_cancel";
+}
+declare class SubscriptionHistoryItem extends PaylioObject {
+    static readonly OBJECT_NAME = "subscription_history_item";
+}
+declare class PaginatedList extends PaylioObject {
+    static readonly OBJECT_NAME = "list";
+    get hasMore(): boolean;
+}
+
+declare class SubscriptionService {
+    private readonly _http;
+    constructor(httpClient: HTTPClient);
+    retrieve(userId: string): Promise<Subscription>;
+    list(userId: string, options?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<PaginatedList>;
+    cancel(subscriptionId: string, options?: {
+        cancelNow?: boolean;
+    }): Promise<SubscriptionCancel>;
+}
+
+interface PaylioClientOptions {
+    baseUrl?: string;
+    timeout?: number;
+    fetchFn?: typeof fetch;
+}
+declare class PaylioClient {
+    private readonly _http;
+    readonly subscription: SubscriptionService;
+    constructor(apiKey: string, options?: PaylioClientOptions);
+    close(): void;
+    [Symbol.dispose](): void;
+}
+
+interface PaylioErrorParams {
+    message?: string;
+    httpStatus?: number;
+    httpBody?: string;
+    jsonBody?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    code?: string;
+}
+declare class PaylioError extends Error {
+    readonly httpStatus: number | undefined;
+    readonly httpBody: string | undefined;
+    readonly jsonBody: Record<string, unknown> | undefined;
+    readonly headers: Record<string, string>;
+    readonly code: string | undefined;
+    constructor(params?: PaylioErrorParams);
+    toString(): string;
+}
+/** General API error (5xx or unexpected responses). */
+declare class APIError extends PaylioError {
+}
+/** Invalid or missing API key (401). */
+declare class AuthenticationError extends PaylioError {
+}
+/** Bad request parameters (400). */
+declare class InvalidRequestError extends PaylioError {
+}
+/** Resource not found (404). */
+declare class NotFoundError extends PaylioError {
+}
+/** Rate limit exceeded (429). */
+declare class RateLimitError extends PaylioError {
+}
+/** Network/connection failure. */
+declare class APIConnectionError extends PaylioError {
+}
+
+declare const VERSION = "0.1.0";
+
+export { APIConnectionError, APIError, AuthenticationError, InvalidRequestError, NotFoundError, PaginatedList, PaylioClient, type PaylioClientOptions, PaylioError, type PaylioErrorParams, PaylioObject, RateLimitError, Subscription, SubscriptionCancel, SubscriptionHistoryItem, VERSION };

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+interface HTTPClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    fetchFn?: typeof fetch;
+}
+declare class HTTPClient {
+    private readonly _apiKey;
+    private readonly _baseUrl;
+    private readonly _timeout;
+    private readonly _fetchFn;
+    constructor(options: HTTPClientOptions);
+    request(method: string, path: string, options?: {
+        params?: Record<string, string | number>;
+        jsonBody?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    private _buildHeaders;
+    private _handleResponse;
+    close(): void;
+}
+
+/**
+ * Base class for Paylio API response objects.
+ *
+ * Supports both dot-style and bracket-style access:
+ *   (obj as any).status  // dot access
+ *   obj["status"]        // bracket access (via Proxy)
+ */
+declare class PaylioObject {
+    /** @internal */
+    readonly _data: Record<string, unknown>;
+    constructor(data?: Record<string, unknown>);
+    static _wrap(value: unknown): unknown;
+    get(key: string, defaultValue?: unknown): unknown;
+    toDict(): Record<string, unknown>;
+    static constructFrom(data: Record<string, unknown>): PaylioObject;
+    toString(): string;
+}
+
+declare class Subscription extends PaylioObject {
+    static readonly OBJECT_NAME = "subscription";
+}
+declare class SubscriptionCancel extends PaylioObject {
+    static readonly OBJECT_NAME = "subscription_cancel";
+}
+declare class SubscriptionHistoryItem extends PaylioObject {
+    static readonly OBJECT_NAME = "subscription_history_item";
+}
+declare class PaginatedList extends PaylioObject {
+    static readonly OBJECT_NAME = "list";
+    get hasMore(): boolean;
+}
+
+declare class SubscriptionService {
+    private readonly _http;
+    constructor(httpClient: HTTPClient);
+    retrieve(userId: string): Promise<Subscription>;
+    list(userId: string, options?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<PaginatedList>;
+    cancel(subscriptionId: string, options?: {
+        cancelNow?: boolean;
+    }): Promise<SubscriptionCancel>;
+}
+
+interface PaylioClientOptions {
+    baseUrl?: string;
+    timeout?: number;
+    fetchFn?: typeof fetch;
+}
+declare class PaylioClient {
+    private readonly _http;
+    readonly subscription: SubscriptionService;
+    constructor(apiKey: string, options?: PaylioClientOptions);
+    close(): void;
+    [Symbol.dispose](): void;
+}
+
+interface PaylioErrorParams {
+    message?: string;
+    httpStatus?: number;
+    httpBody?: string;
+    jsonBody?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    code?: string;
+}
+declare class PaylioError extends Error {
+    readonly httpStatus: number | undefined;
+    readonly httpBody: string | undefined;
+    readonly jsonBody: Record<string, unknown> | undefined;
+    readonly headers: Record<string, string>;
+    readonly code: string | undefined;
+    constructor(params?: PaylioErrorParams);
+    toString(): string;
+}
+/** General API error (5xx or unexpected responses). */
+declare class APIError extends PaylioError {
+}
+/** Invalid or missing API key (401). */
+declare class AuthenticationError extends PaylioError {
+}
+/** Bad request parameters (400). */
+declare class InvalidRequestError extends PaylioError {
+}
+/** Resource not found (404). */
+declare class NotFoundError extends PaylioError {
+}
+/** Rate limit exceeded (429). */
+declare class RateLimitError extends PaylioError {
+}
+/** Network/connection failure. */
+declare class APIConnectionError extends PaylioError {
+}
+
+declare const VERSION = "0.1.0";
+
+export { APIConnectionError, APIError, AuthenticationError, InvalidRequestError, NotFoundError, PaginatedList, PaylioClient, type PaylioClientOptions, PaylioError, type PaylioErrorParams, PaylioObject, RateLimitError, Subscription, SubscriptionCancel, SubscriptionHistoryItem, VERSION };

package/dist/index.mjs

@@ -0,0 +1,341 @@
+// src/errors.ts
+var PaylioError = class extends Error {
+  httpStatus;
+  httpBody;
+  jsonBody;
+  headers;
+  code;
+  constructor(params) {
+    const msg = params?.message ?? "";
+    super(msg);
+    this.name = this.constructor.name;
+    this.message = msg;
+    this.httpStatus = params?.httpStatus;
+    this.httpBody = params?.httpBody;
+    this.jsonBody = params?.jsonBody;
+    this.headers = params?.headers ?? {};
+    this.code = params?.code;
+  }
+  toString() {
+    return this.message;
+  }
+};
+var APIError = class extends PaylioError {
+};
+var AuthenticationError = class extends PaylioError {
+};
+var InvalidRequestError = class extends PaylioError {
+};
+var NotFoundError = class extends PaylioError {
+};
+var RateLimitError = class extends PaylioError {
+};
+var APIConnectionError = class extends PaylioError {
+};
+
+// src/version.ts
+var VERSION = "0.1.0";
+
+// src/httpClient.ts
+var DEFAULT_BASE_URL = "https://api.paylio.pro/flying/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var HTTPClient = class {
+  _apiKey;
+  _baseUrl;
+  _timeout;
+  _fetchFn;
+  constructor(options) {
+    this._apiKey = options.apiKey;
+    this._baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this._timeout = options.timeout ?? DEFAULT_TIMEOUT;
+    this._fetchFn = options.fetchFn ?? globalThis.fetch;
+  }
+  async request(method, path, options) {
+    const url = new URL(`${this._baseUrl}${path}`);
+    if (options?.params) {
+      for (const [key, value] of Object.entries(options.params)) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+    const headers = this._buildHeaders();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this._timeout);
+    let response;
+    try {
+      response = await this._fetchFn(url.toString(), {
+        method,
+        headers,
+        body: options?.jsonBody ? JSON.stringify(options.jsonBody) : void 0,
+        signal: controller.signal
+      });
+    } catch (error) {
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new APIConnectionError({ message: "Request timed out" });
+      }
+      throw new APIConnectionError({
+        message: `Connection error: ${error instanceof Error ? error.message : String(error)}`
+      });
+    } finally {
+      clearTimeout(timeoutId);
+    }
+    return this._handleResponse(response);
+  }
+  _buildHeaders() {
+    return {
+      "X-API-Key": this._apiKey,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      "User-Agent": `paylio-node/${VERSION}`
+    };
+  }
+  async _handleResponse(response) {
+    const httpStatus = response.status;
+    const httpBody = await response.text();
+    const headers = {};
+    response.headers.forEach((value, key) => {
+      headers[key] = value;
+    });
+    let jsonBody;
+    try {
+      jsonBody = JSON.parse(httpBody);
+    } catch {
+      jsonBody = void 0;
+    }
+    if (httpStatus >= 200 && httpStatus < 300) {
+      if (!jsonBody) {
+        throw new APIError({
+          message: "Invalid JSON in response body",
+          httpStatus,
+          httpBody
+        });
+      }
+      return jsonBody;
+    }
+    let errorCode;
+    let errorMessage = httpBody;
+    if (jsonBody) {
+      const err = jsonBody["error"];
+      if (err && typeof err === "object" && !Array.isArray(err)) {
+        const errObj = err;
+        errorCode = typeof errObj["code"] === "string" ? errObj["code"] : void 0;
+        errorMessage = typeof errObj["message"] === "string" ? errObj["message"] : httpBody;
+      } else if (typeof err === "string") {
+        errorMessage = err;
+      } else if (typeof jsonBody["detail"] === "string") {
+        errorMessage = jsonBody["detail"];
+      }
+    }
+    const ErrorClass = errorClassForStatus(httpStatus);
+    throw new ErrorClass({
+      message: errorMessage,
+      httpStatus,
+      httpBody,
+      jsonBody,
+      headers,
+      code: errorCode
+    });
+  }
+  close() {
+  }
+};
+function errorClassForStatus(status) {
+  switch (status) {
+    case 401:
+      return AuthenticationError;
+    case 400:
+      return InvalidRequestError;
+    case 404:
+      return NotFoundError;
+    case 429:
+      return RateLimitError;
+    default:
+      return APIError;
+  }
+}
+
+// src/paylioObject.ts
+var PaylioObject = class _PaylioObject {
+  /** @internal */
+  _data;
+  constructor(data) {
+    this._data = {};
+    if (data) {
+      for (const [key, value] of Object.entries(data)) {
+        this._data[key] = _PaylioObject._wrap(value);
+      }
+    }
+    return new Proxy(this, {
+      get(target, prop, receiver) {
+        if (typeof prop === "symbol" || typeof prop !== "string") {
+          return Reflect.get(target, prop, receiver);
+        }
+        if (prop in target && typeof target[prop] === "function") {
+          return target[prop].bind(target);
+        }
+        if (prop.startsWith("_")) {
+          return Reflect.get(target, prop, receiver);
+        }
+        if (prop in target._data) {
+          return target._data[prop];
+        }
+        return Reflect.get(target, prop, receiver);
+      },
+      set(target, prop, value) {
+        if (typeof prop === "string" && !prop.startsWith("_")) {
+          target._data[prop] = value;
+          return true;
+        }
+        return Reflect.set(target, prop, value);
+      }
+    });
+  }
+  static _wrap(value) {
+    if (value instanceof _PaylioObject) {
+      return value;
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => {
+        if (item instanceof _PaylioObject) return item;
+        if (item !== null && typeof item === "object" && !Array.isArray(item)) {
+          return new _PaylioObject(item);
+        }
+        return item;
+      });
+    }
+    if (value !== null && typeof value === "object") {
+      return new _PaylioObject(value);
+    }
+    return value;
+  }
+  get(key, defaultValue) {
+    return key in this._data ? this._data[key] : defaultValue;
+  }
+  toDict() {
+    const result = {};
+    for (const [key, value] of Object.entries(this._data)) {
+      if (value instanceof _PaylioObject) {
+        result[key] = value.toDict();
+      } else if (Array.isArray(value)) {
+        result[key] = value.map(
+          (item) => item instanceof _PaylioObject ? item.toDict() : item
+        );
+      } else {
+        result[key] = value;
+      }
+    }
+    return result;
+  }
+  static constructFrom(data) {
+    return new _PaylioObject(data);
+  }
+  toString() {
+    const id = this._data["id"];
+    if (id !== void 0 && id !== null) {
+      return `<${this.constructor.name} id=${id}>`;
+    }
+    return `<${this.constructor.name} ${JSON.stringify(this._data)}>`;
+  }
+};
+
+// src/resources/subscription.ts
+var Subscription = class extends PaylioObject {
+  static OBJECT_NAME = "subscription";
+};
+var SubscriptionCancel = class extends PaylioObject {
+  static OBJECT_NAME = "subscription_cancel";
+};
+var SubscriptionHistoryItem = class extends PaylioObject {
+  static OBJECT_NAME = "subscription_history_item";
+};
+var PaginatedList = class extends PaylioObject {
+  static OBJECT_NAME = "list";
+  get hasMore() {
+    const page = this.get("page", 1);
+    const totalPages = this.get("total_pages", 1);
+    return page < totalPages;
+  }
+};
+
+// src/services/subscriptionService.ts
+var SubscriptionService = class {
+  _http;
+  constructor(httpClient) {
+    this._http = httpClient;
+  }
+  async retrieve(userId) {
+    if (!userId || !userId.trim()) {
+      throw new Error("userId is required");
+    }
+    const data = await this._http.request("GET", `/subscription/${userId}`);
+    return new Subscription(data);
+  }
+  async list(userId, options) {
+    if (!userId || !userId.trim()) {
+      throw new Error("userId is required");
+    }
+    const params = {
+      page: options?.page ?? 1,
+      page_size: options?.pageSize ?? 20
+    };
+    const data = await this._http.request("GET", `/users/${userId}/subscriptions`, { params });
+    if (data["items"] && Array.isArray(data["items"])) {
+      data["items"] = data["items"].map(
+        (item) => new SubscriptionHistoryItem(item)
+      );
+    }
+    return new PaginatedList(data);
+  }
+  async cancel(subscriptionId, options) {
+    if (!subscriptionId || !subscriptionId.trim()) {
+      throw new Error("subscriptionId is required");
+    }
+    const cancelNow = options?.cancelNow ?? false;
+    const data = await this._http.request("POST", `/subscription/${subscriptionId}/cancel`, {
+      jsonBody: { cancel_at_period_end: !cancelNow }
+    });
+    return new SubscriptionCancel(data);
+  }
+};
+
+// src/client.ts
+var PaylioClient = class {
+  _http;
+  subscription;
+  constructor(apiKey, options) {
+    if (!apiKey) {
+      throw new AuthenticationError({
+        message: "No API key provided. Set your API key when creating the PaylioClient: new PaylioClient('sk_live_xxx')"
+      });
+    }
+    this._http = new HTTPClient({
+      apiKey,
+      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,
+      timeout: options?.timeout ?? DEFAULT_TIMEOUT,
+      fetchFn: options?.fetchFn
+    });
+    this.subscription = new SubscriptionService(this._http);
+  }
+  close() {
+    this._http.close();
+  }
+  [Symbol.dispose]() {
+    this.close();
+  }
+};
+export {
+  APIConnectionError,
+  APIError,
+  AuthenticationError,
+  InvalidRequestError,
+  NotFoundError,
+  PaginatedList,
+  PaylioClient,
+  PaylioError,
+  PaylioObject,
+  RateLimitError,
+  Subscription,
+  SubscriptionCancel,
+  SubscriptionHistoryItem,
+  VERSION
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/version.ts","../src/httpClient.ts","../src/paylioObject.ts","../src/resources/subscription.ts","../src/services/subscriptionService.ts","../src/client.ts"],"sourcesContent":["export interface PaylioErrorParams {\n  message?: string;\n  httpStatus?: number;\n  httpBody?: string;\n  jsonBody?: Record<string, unknown>;\n  headers?: Record<string, string>;\n  code?: string;\n}\n\nexport class PaylioError extends Error {\n  readonly httpStatus: number | undefined;\n  readonly httpBody: string | undefined;\n  readonly jsonBody: Record<string, unknown> | undefined;\n  readonly headers: Record<string, string>;\n  readonly code: string | undefined;\n\n  constructor(params?: PaylioErrorParams) {\n    const msg = params?.message ?? \"\";\n    super(msg);\n    this.name = this.constructor.name;\n    this.message = msg;\n    this.httpStatus = params?.httpStatus;\n    this.httpBody = params?.httpBody;\n    this.jsonBody = params?.jsonBody;\n    this.headers = params?.headers ?? {};\n    this.code = params?.code;\n  }\n\n  override toString(): string {\n    return this.message;\n  }\n}\n\n/** General API error (5xx or unexpected responses). */\nexport class APIError extends PaylioError {}\n\n/** Invalid or missing API key (401). */\nexport class AuthenticationError extends PaylioError {}\n\n/** Bad request parameters (400). */\nexport class InvalidRequestError extends PaylioError {}\n\n/** Resource not found (404). */\nexport class NotFoundError extends PaylioError {}\n\n/** Rate limit exceeded (429). */\nexport class RateLimitError extends PaylioError {}\n\n/** Network/connection failure. */\nexport class APIConnectionError extends PaylioError {}\n","export const VERSION = \"0.1.0\";\n","import {\n  APIConnectionError,\n  APIError,\n  AuthenticationError,\n  InvalidRequestError,\n  NotFoundError,\n  PaylioError,\n  RateLimitError,\n} from \"./errors.js\";\nimport { VERSION } from \"./version.js\";\n\nexport const DEFAULT_BASE_URL = \"https://api.paylio.pro/flying/v1\";\nexport const DEFAULT_TIMEOUT = 30_000;\n\nexport interface HTTPClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  timeout?: number;\n  fetchFn?: typeof fetch;\n}\n\nexport class HTTPClient {\n  private readonly _apiKey: string;\n  private readonly _baseUrl: string;\n  private readonly _timeout: number;\n  private readonly _fetchFn: typeof fetch;\n\n  constructor(options: HTTPClientOptions) {\n    this._apiKey = options.apiKey;\n    this._baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this._timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this._fetchFn = options.fetchFn ?? globalThis.fetch;\n  }\n\n  async request(\n    method: string,\n    path: string,\n    options?: {\n      params?: Record<string, string | number>;\n      jsonBody?: Record<string, unknown>;\n    },\n  ): Promise<Record<string, unknown>> {\n    const url = new URL(`${this._baseUrl}${path}`);\n    if (options?.params) {\n      for (const [key, value] of Object.entries(options.params)) {\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    const headers = this._buildHeaders();\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this._timeout);\n\n    let response: Response;\n    try {\n      response = await this._fetchFn(url.toString(), {\n        method,\n        headers,\n        body: options?.jsonBody ? JSON.stringify(options.jsonBody) : undefined,\n        signal: controller.signal,\n      });\n    } catch (error: unknown) {\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new APIConnectionError({ message: \"Request timed out\" });\n      }\n      throw new APIConnectionError({\n        message: `Connection error: ${error instanceof Error ? error.message : String(error)}`,\n      });\n    } finally {\n      clearTimeout(timeoutId);\n    }\n\n    return this._handleResponse(response);\n  }\n\n  private _buildHeaders(): Record<string, string> {\n    return {\n      \"X-API-Key\": this._apiKey,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      \"User-Agent\": `paylio-node/${VERSION}`,\n    };\n  }\n\n  private async _handleResponse(response: Response): Promise<Record<string, unknown>> {\n    const httpStatus = response.status;\n    const httpBody = await response.text();\n    const headers: Record<string, string> = {};\n    response.headers.forEach((value, key) => {\n      headers[key] = value;\n    });\n\n    let jsonBody: Record<string, unknown> | undefined;\n    try {\n      jsonBody = JSON.parse(httpBody) as Record<string, unknown>;\n    } catch {\n      jsonBody = undefined;\n    }\n\n    if (httpStatus >= 200 && httpStatus < 300) {\n      if (!jsonBody) {\n        throw new APIError({\n          message: \"Invalid JSON in response body\",\n          httpStatus,\n          httpBody,\n        });\n      }\n      return jsonBody;\n    }\n\n    // Extract error details — handle all 3 backend response formats:\n    //   {\"error\": {\"code\": \"...\", \"message\": \"...\"}}  (public API v1)\n    //   {\"error\": \"string\"}                           (legacy API)\n    //   {\"detail\": \"string\"}                          (FastAPI / dashboard)\n    let errorCode: string | undefined;\n    let errorMessage: string = httpBody;\n\n    if (jsonBody) {\n      const err = jsonBody[\"error\"];\n      if (err && typeof err === \"object\" && !Array.isArray(err)) {\n        const errObj = err as Record<string, unknown>;\n        errorCode = typeof errObj[\"code\"] === \"string\" ? errObj[\"code\"] : undefined;\n        errorMessage =\n          typeof errObj[\"message\"] === \"string\" ? (errObj[\"message\"] as string) : httpBody;\n      } else if (typeof err === \"string\") {\n        errorMessage = err;\n      } else if (typeof jsonBody[\"detail\"] === \"string\") {\n        errorMessage = jsonBody[\"detail\"] as string;\n      }\n    }\n\n    const ErrorClass = errorClassForStatus(httpStatus);\n    throw new ErrorClass({\n      message: errorMessage,\n      httpStatus,\n      httpBody,\n      jsonBody,\n      headers,\n      code: errorCode,\n    });\n  }\n\n  close(): void {\n    // No-op for fetch-based client. Included for API parity with Python SDK.\n  }\n}\n\nfunction errorClassForStatus(status: number): typeof PaylioError {\n  switch (status) {\n    case 401:\n      return AuthenticationError;\n    case 400:\n      return InvalidRequestError;\n    case 404:\n      return NotFoundError;\n    case 429:\n      return RateLimitError;\n    default:\n      return APIError;\n  }\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Base class for Paylio API response objects.\n *\n * Supports both dot-style and bracket-style access:\n *   (obj as any).status  // dot access\n *   obj[\"status\"]        // bracket access (via Proxy)\n */\nexport class PaylioObject {\n  /** @internal */\n  readonly _data: Record<string, unknown>;\n\n  constructor(data?: Record<string, unknown>) {\n    this._data = {};\n    if (data) {\n      for (const [key, value] of Object.entries(data)) {\n        this._data[key] = PaylioObject._wrap(value);\n      }\n    }\n\n    return new Proxy(this, {\n      get(target, prop, receiver) {\n        // Let class methods and internals resolve normally via prototype chain\n        if (typeof prop === \"symbol\" || typeof prop !== \"string\") {\n          return Reflect.get(target, prop, receiver);\n        }\n        // Prioritize own methods over data keys\n        if (prop in target && typeof (target as any)[prop] === \"function\") {\n          return (target as any)[prop].bind(target);\n        }\n        // Internal properties (starting with _) go to the real object\n        if (prop.startsWith(\"_\")) {\n          return Reflect.get(target, prop, receiver);\n        }\n        // Data keys\n        if (prop in target._data) {\n          return target._data[prop];\n        }\n        // Fallback to prototype chain (constructor, etc.)\n        return Reflect.get(target, prop, receiver);\n      },\n      set(target, prop, value) {\n        if (typeof prop === \"string\" && !prop.startsWith(\"_\")) {\n          target._data[prop] = value;\n          return true;\n        }\n        return Reflect.set(target, prop, value);\n      },\n    });\n  }\n\n  static _wrap(value: unknown): unknown {\n    if (value instanceof PaylioObject) {\n      return value;\n    }\n    if (Array.isArray(value)) {\n      return value.map((item) => {\n        if (item instanceof PaylioObject) return item;\n        if (item !== null && typeof item === \"object\" && !Array.isArray(item)) {\n          return new PaylioObject(item as Record<string, unknown>);\n        }\n        return item;\n      });\n    }\n    if (value !== null && typeof value === \"object\") {\n      return new PaylioObject(value as Record<string, unknown>);\n    }\n    return value;\n  }\n\n  get(key: string, defaultValue?: unknown): unknown {\n    return key in this._data ? this._data[key] : defaultValue;\n  }\n\n  toDict(): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(this._data)) {\n      if (value instanceof PaylioObject) {\n        result[key] = value.toDict();\n      } else if (Array.isArray(value)) {\n        result[key] = value.map((item: any) =>\n          item instanceof PaylioObject ? item.toDict() : item,\n        );\n      } else {\n        result[key] = value;\n      }\n    }\n    return result;\n  }\n\n  static constructFrom(data: Record<string, unknown>): PaylioObject {\n    return new PaylioObject(data);\n  }\n\n  toString(): string {\n    const id = this._data[\"id\"];\n    if (id !== undefined && id !== null) {\n      return `<${this.constructor.name} id=${id}>`;\n    }\n    return `<${this.constructor.name} ${JSON.stringify(this._data)}>`;\n  }\n}\n","import { PaylioObject } from \"../paylioObject.js\";\n\nexport class Subscription extends PaylioObject {\n  static readonly OBJECT_NAME = \"subscription\";\n}\n\nexport class SubscriptionCancel extends PaylioObject {\n  static readonly OBJECT_NAME = \"subscription_cancel\";\n}\n\nexport class SubscriptionHistoryItem extends PaylioObject {\n  static readonly OBJECT_NAME = \"subscription_history_item\";\n}\n\nexport class PaginatedList extends PaylioObject {\n  static readonly OBJECT_NAME = \"list\";\n\n  get hasMore(): boolean {\n    const page = this.get(\"page\", 1) as number;\n    const totalPages = this.get(\"total_pages\", 1) as number;\n    return page < totalPages;\n  }\n}\n","import type { HTTPClient } from \"../httpClient.js\";\nimport {\n  PaginatedList,\n  Subscription,\n  SubscriptionCancel,\n  SubscriptionHistoryItem,\n} from \"../resources/subscription.js\";\n\nexport class SubscriptionService {\n  private readonly _http: HTTPClient;\n\n  constructor(httpClient: HTTPClient) {\n    this._http = httpClient;\n  }\n\n  async retrieve(userId: string): Promise<Subscription> {\n    if (!userId || !userId.trim()) {\n      throw new Error(\"userId is required\");\n    }\n    const data = await this._http.request(\"GET\", `/subscription/${userId}`);\n    return new Subscription(data);\n  }\n\n  async list(\n    userId: string,\n    options?: { page?: number; pageSize?: number },\n  ): Promise<PaginatedList> {\n    if (!userId || !userId.trim()) {\n      throw new Error(\"userId is required\");\n    }\n\n    const params = {\n      page: options?.page ?? 1,\n      page_size: options?.pageSize ?? 20,\n    };\n\n    const data = await this._http.request(\"GET\", `/users/${userId}/subscriptions`, { params });\n\n    // Convert items to typed objects\n    if (data[\"items\"] && Array.isArray(data[\"items\"])) {\n      data[\"items\"] = (data[\"items\"] as Record<string, unknown>[]).map(\n        (item) => new SubscriptionHistoryItem(item),\n      );\n    }\n\n    return new PaginatedList(data);\n  }\n\n  async cancel(\n    subscriptionId: string,\n    options?: { cancelNow?: boolean },\n  ): Promise<SubscriptionCancel> {\n    if (!subscriptionId || !subscriptionId.trim()) {\n      throw new Error(\"subscriptionId is required\");\n    }\n\n    const cancelNow = options?.cancelNow ?? false;\n    const data = await this._http.request(\"POST\", `/subscription/${subscriptionId}/cancel`, {\n      jsonBody: { cancel_at_period_end: !cancelNow },\n    });\n    return new SubscriptionCancel(data);\n  }\n}\n","import { AuthenticationError } from \"./errors.js\";\nimport { DEFAULT_BASE_URL, DEFAULT_TIMEOUT, HTTPClient } from \"./httpClient.js\";\nimport { SubscriptionService } from \"./services/subscriptionService.js\";\n\nexport interface PaylioClientOptions {\n  baseUrl?: string;\n  timeout?: number;\n  fetchFn?: typeof fetch;\n}\n\nexport class PaylioClient {\n  private readonly _http: HTTPClient;\n  readonly subscription: SubscriptionService;\n\n  constructor(apiKey: string, options?: PaylioClientOptions) {\n    if (!apiKey) {\n      throw new AuthenticationError({\n        message:\n          \"No API key provided. Set your API key when creating \" +\n          \"the PaylioClient: new PaylioClient('sk_live_xxx')\",\n      });\n    }\n\n    this._http = new HTTPClient({\n      apiKey,\n      baseUrl: options?.baseUrl ?? DEFAULT_BASE_URL,\n      timeout: options?.timeout ?? DEFAULT_TIMEOUT,\n      fetchFn: options?.fetchFn,\n    });\n\n    this.subscription = new SubscriptionService(this._http);\n  }\n\n  close(): void {\n    this._http.close();\n  }\n\n  [Symbol.dispose](): void {\n    this.close();\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "paylio",
+  "version": "0.1.0",
+  "description": "Node.js/TypeScript client library for the Paylio API",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint --fix src/ tests/",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "paylio",
+    "api",
+    "sdk",
+    "subscription",
+    "billing"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paylio-org/paylio-node.git"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.0",
+    "@vitest/coverage-istanbul": "^4.0.0",
+    "eslint": "^10.0.0",
+    "prettier": "^3.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^4.0.0"
+  },
+  "overrides": {
+    "minimatch": ">=10.2.1"
+  }
+}