@heyinvoice/sdk 1.0.0

package/README.md

@@ -0,0 +1,178 @@
+# @heyinvoice/sdk
+
+> Official Node.js & TypeScript SDK for [HeyInvoice](https://heyinvoice.com).
+
+Stripe-like lightweight, fully-typed API client for managing invoices, PEPPOL e-invoicing, and customer billing.
+
+## 📦 Installation
+
+```bash
+# npm
+npm install @heyinvoice/sdk
+
+# pnpm
+pnpm add @heyinvoice/sdk
+
+# yarn
+yarn add @heyinvoice/sdk
+```
+
+## 🚀 Quick Start
+
+Initialize the SDK with your API key (`sk_live_...` or `sk_test_...`):
+
+```typescript
+import { HeyInvoice } from '@heyinvoice/sdk';
+
+// Initialize with API Key string
+const heyinvoice = new HeyInvoice('sk_test_51MzXYZ...');
+
+// Or with custom config options
+/*
+const heyinvoice = new HeyInvoice({
+  apiKey: 'sk_test_51MzXYZ...',
+  apiBase: 'https://api.heyinvoice.com',
+  timeout: 10000,
+});
+*/
+```
+
+---
+
+## 🧾 Invoice CRUD Operations
+
+### 1. Create a Draft Invoice
+
+```typescript
+const invoice = await heyinvoice.invoices.create({
+  id_customer: 1024,
+  invoice_date: '2026-07-26',
+  due_date: '2026-08-25',
+  currency: 'SGD',
+  payment_terms: 30,
+  notes: 'Thank you for doing business with us!',
+  line_items: [
+    {
+      description: 'Consulting Services (July 2026)',
+      quantity: 10,
+      unit_price_cents: 15000, // $150.00
+      gst_rate: 9, // 9% GST
+    },
+    {
+      description: 'Software Setup & Configuration',
+      quantity: 1,
+      unit_price_cents: 50000, // $500.00
+    },
+  ],
+});
+
+console.log('Created invoice:', invoice.id, invoice.total_cents);
+```
+
+### 2. Retrieve an Invoice
+
+```typescript
+const invoice = await heyinvoice.invoices.retrieve('inv_998123');
+// Or alias:
+// const invoice = await heyinvoice.invoices.get('inv_998123');
+console.log(invoice.invoice_number, invoice.status);
+```
+
+### 3. Update an Invoice
+
+```typescript
+const updatedInvoice = await heyinvoice.invoices.update('inv_998123', {
+  notes: 'Updated payment instructions: Pay via PayNow UEN 123456789W',
+  due_date: '2026-09-01',
+});
+```
+
+### 4. List Invoices with Filtering
+
+```typescript
+const { data: invoices, has_more } = await heyinvoice.invoices.list({
+  status: 'draft',
+  limit: 20,
+  page: 1,
+});
+
+for (const inv of invoices) {
+  console.log(inv.id, inv.invoice_number, inv.total_cents);
+}
+```
+
+### 5. Finalize / Send / Void / Delete Invoice
+
+```typescript
+// Send invoice to customer
+await heyinvoice.invoices.send('inv_998123');
+
+// Void invoice
+await heyinvoice.invoices.void('inv_998123');
+
+// Delete draft invoice
+await heyinvoice.invoices.del('inv_998123');
+```
+
+---
+
+## ⚠️ Error Handling
+
+The SDK throws specialized error classes inherited from `HeyInvoiceError`:
+
+```typescript
+import {
+  HeyInvoice,
+  AuthenticationError,
+  NotFoundError,
+  InvalidRequestError,
+  HeyInvoiceError,
+} from '@heyinvoice/sdk';
+
+try {
+  const invoice = await heyinvoice.invoices.retrieve('invalid_id');
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Invalid API Key provided');
+  } else if (error instanceof NotFoundError) {
+    console.error('Invoice does not exist');
+  } else if (error instanceof InvalidRequestError) {
+    console.error('Validation failed:', error.message);
+  } else if (error instanceof HeyInvoiceError) {
+    console.error(`API Error [${error.statusCode}]: ${error.message}`);
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+---
+
+## 🛠 Deploying & Publishing to NPM
+
+### 1. Build package locally
+
+```bash
+pnpm --filter=@heyinvoice/sdk build
+```
+
+### 2. Perform a dry-run publish
+
+```bash
+cd packages/sdk
+npm publish --dry-run
+```
+
+### 3. Publish to NPM Registry
+
+Ensure you are logged into your npm account (`npm login`), then publish with public access:
+
+```bash
+npm publish --access public
+```
+
+---
+
+## 📄 License
+
+MIT © [HeyInvoice](https://heyinvoice.com)

package/dist/index.d.mts

@@ -0,0 +1,223 @@
+interface ClientConfig {
+    /**
+     * HeyInvoice API Key (e.g. sk_live_... or sk_test_...)
+     */
+    apiKey: string;
+    /**
+     * Base URL of the HeyInvoice API server.
+     * @default 'https://api.heyinvoice.com'
+     */
+    apiBase?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of automatic retries on rate limits or server errors.
+     * @default 2
+     */
+    maxRetries?: number;
+    /**
+     * Custom HTTP headers to include with every request.
+     */
+    headers?: Record<string, string>;
+}
+type InvoiceStatus = 'draft' | 'final' | 'void' | 'paid' | 'overdue';
+interface InvoiceLineItem {
+    id?: string;
+    description: string;
+    quantity?: number;
+    unit_price_cents: number;
+    gst_rate?: number;
+    amount_cents?: number;
+}
+interface Invoice {
+    id: string;
+    object: 'invoice';
+    id_customer: number | string;
+    invoice_number: string;
+    status: InvoiceStatus;
+    invoice_date?: string;
+    due_date?: string;
+    currency?: string;
+    payment_type?: 'one_time' | 'recurring';
+    payment_terms?: number;
+    subtotal_cents?: number;
+    gst_amount_cents?: number;
+    total_cents?: number;
+    notes?: string;
+    internal_notes?: string;
+    line_items?: InvoiceLineItem[];
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+interface CreateInvoiceParams {
+    id_customer: number | string;
+    invoice_date?: string;
+    due_date?: string;
+    currency?: string;
+    payment_type?: 'one_time' | 'recurring';
+    payment_terms?: number;
+    notes?: string;
+    internal_notes?: string;
+    line_items: Array<{
+        description: string;
+        quantity?: number;
+        unit_price_cents: number;
+        gst_rate?: number;
+    }>;
+}
+interface UpdateInvoiceParams {
+    id_customer?: number | string;
+    invoice_date?: string;
+    due_date?: string;
+    currency?: string;
+    notes?: string;
+    internal_notes?: string;
+    status?: InvoiceStatus;
+    line_items?: Array<{
+        id?: string;
+        description: string;
+        quantity?: number;
+        unit_price_cents: number;
+        gst_rate?: number;
+    }>;
+}
+interface ListInvoicesParams {
+    limit?: number;
+    page?: number;
+    status?: InvoiceStatus;
+    customer_id?: number | string;
+    date_from?: string;
+    date_to?: string;
+}
+interface PaginatedList<T> {
+    object: 'list';
+    data: T[];
+    has_more: boolean;
+    total_count?: number;
+}
+interface DeletedResource {
+    id: string;
+    object: string;
+    deleted: true;
+}
+
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly apiBase;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly customHeaders;
+    constructor(config: ClientConfig);
+    request<T>(options: RequestOptions): Promise<T>;
+    private buildUrl;
+    private buildHeaders;
+    private delay;
+}
+
+declare abstract class Resource {
+    protected readonly client: HttpClient;
+    constructor(client: HttpClient);
+}
+
+declare class Invoices extends Resource {
+    /**
+     * Create a new invoice draft.
+     */
+    create(params: CreateInvoiceParams): Promise<Invoice>;
+    /**
+     * Retrieve an existing invoice by ID.
+     */
+    retrieve(id: string): Promise<Invoice>;
+    /**
+     * Alias for retrieve.
+     */
+    get(id: string): Promise<Invoice>;
+    /**
+     * Update an existing invoice.
+     */
+    update(id: string, params: UpdateInvoiceParams): Promise<Invoice>;
+    /**
+     * List invoices with optional pagination and filtering.
+     */
+    list(params?: ListInvoicesParams): Promise<PaginatedList<Invoice>>;
+    /**
+     * Delete or void an invoice.
+     */
+    del(id: string): Promise<DeletedResource>;
+    /**
+     * Finalize/Send a draft invoice.
+     */
+    send(id: string): Promise<Invoice>;
+    /**
+     * Void an invoice.
+     */
+    void(id: string): Promise<Invoice>;
+}
+
+declare class HeyInvoice {
+    private readonly httpClient;
+    readonly invoices: Invoices;
+    /**
+     * Initializes a new HeyInvoice SDK client.
+     *
+     * @param apiKeyOrConfig API Key string or full ClientConfig object
+     * @param options Additional client options if first parameter is an API Key string
+     *
+     * @example
+     * ```ts
+     * // String initialization
+     * const heyinvoice = new HeyInvoice('sk_live_xyz123');
+     *
+     * // Object initialization
+     * const heyinvoice = new HeyInvoice({
+     *   apiKey: 'sk_live_xyz123',
+     *   apiBase: 'https://api.heyinvoice.com',
+     * });
+     * ```
+     */
+    constructor(apiKeyOrConfig: string | ClientConfig, options?: Omit<ClientConfig, 'apiKey'>);
+}
+
+interface HeyInvoiceErrorOptions {
+    type?: string;
+    statusCode?: number;
+    code?: string;
+    requestId?: string;
+    raw?: unknown;
+}
+declare class HeyInvoiceError extends Error {
+    readonly type: string;
+    readonly statusCode?: number;
+    readonly code?: string;
+    readonly requestId?: string;
+    readonly raw?: unknown;
+    constructor(message: string, options?: HeyInvoiceErrorOptions);
+}
+declare class AuthenticationError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class InvalidRequestError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class NotFoundError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class APIError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class ConnectionError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+
+export { APIError, AuthenticationError, type ClientConfig, ConnectionError, type CreateInvoiceParams, type DeletedResource, HeyInvoice, HeyInvoiceError, type HeyInvoiceErrorOptions, InvalidRequestError, type Invoice, type InvoiceLineItem, type InvoiceStatus, Invoices, type ListInvoicesParams, NotFoundError, type PaginatedList, Resource, type UpdateInvoiceParams, HeyInvoice as default };

package/dist/index.d.ts

@@ -0,0 +1,223 @@
+interface ClientConfig {
+    /**
+     * HeyInvoice API Key (e.g. sk_live_... or sk_test_...)
+     */
+    apiKey: string;
+    /**
+     * Base URL of the HeyInvoice API server.
+     * @default 'https://api.heyinvoice.com'
+     */
+    apiBase?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of automatic retries on rate limits or server errors.
+     * @default 2
+     */
+    maxRetries?: number;
+    /**
+     * Custom HTTP headers to include with every request.
+     */
+    headers?: Record<string, string>;
+}
+type InvoiceStatus = 'draft' | 'final' | 'void' | 'paid' | 'overdue';
+interface InvoiceLineItem {
+    id?: string;
+    description: string;
+    quantity?: number;
+    unit_price_cents: number;
+    gst_rate?: number;
+    amount_cents?: number;
+}
+interface Invoice {
+    id: string;
+    object: 'invoice';
+    id_customer: number | string;
+    invoice_number: string;
+    status: InvoiceStatus;
+    invoice_date?: string;
+    due_date?: string;
+    currency?: string;
+    payment_type?: 'one_time' | 'recurring';
+    payment_terms?: number;
+    subtotal_cents?: number;
+    gst_amount_cents?: number;
+    total_cents?: number;
+    notes?: string;
+    internal_notes?: string;
+    line_items?: InvoiceLineItem[];
+    created_at?: string;
+    updated_at?: string;
+    [key: string]: unknown;
+}
+interface CreateInvoiceParams {
+    id_customer: number | string;
+    invoice_date?: string;
+    due_date?: string;
+    currency?: string;
+    payment_type?: 'one_time' | 'recurring';
+    payment_terms?: number;
+    notes?: string;
+    internal_notes?: string;
+    line_items: Array<{
+        description: string;
+        quantity?: number;
+        unit_price_cents: number;
+        gst_rate?: number;
+    }>;
+}
+interface UpdateInvoiceParams {
+    id_customer?: number | string;
+    invoice_date?: string;
+    due_date?: string;
+    currency?: string;
+    notes?: string;
+    internal_notes?: string;
+    status?: InvoiceStatus;
+    line_items?: Array<{
+        id?: string;
+        description: string;
+        quantity?: number;
+        unit_price_cents: number;
+        gst_rate?: number;
+    }>;
+}
+interface ListInvoicesParams {
+    limit?: number;
+    page?: number;
+    status?: InvoiceStatus;
+    customer_id?: number | string;
+    date_from?: string;
+    date_to?: string;
+}
+interface PaginatedList<T> {
+    object: 'list';
+    data: T[];
+    has_more: boolean;
+    total_count?: number;
+}
+interface DeletedResource {
+    id: string;
+    object: string;
+    deleted: true;
+}
+
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly apiBase;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly customHeaders;
+    constructor(config: ClientConfig);
+    request<T>(options: RequestOptions): Promise<T>;
+    private buildUrl;
+    private buildHeaders;
+    private delay;
+}
+
+declare abstract class Resource {
+    protected readonly client: HttpClient;
+    constructor(client: HttpClient);
+}
+
+declare class Invoices extends Resource {
+    /**
+     * Create a new invoice draft.
+     */
+    create(params: CreateInvoiceParams): Promise<Invoice>;
+    /**
+     * Retrieve an existing invoice by ID.
+     */
+    retrieve(id: string): Promise<Invoice>;
+    /**
+     * Alias for retrieve.
+     */
+    get(id: string): Promise<Invoice>;
+    /**
+     * Update an existing invoice.
+     */
+    update(id: string, params: UpdateInvoiceParams): Promise<Invoice>;
+    /**
+     * List invoices with optional pagination and filtering.
+     */
+    list(params?: ListInvoicesParams): Promise<PaginatedList<Invoice>>;
+    /**
+     * Delete or void an invoice.
+     */
+    del(id: string): Promise<DeletedResource>;
+    /**
+     * Finalize/Send a draft invoice.
+     */
+    send(id: string): Promise<Invoice>;
+    /**
+     * Void an invoice.
+     */
+    void(id: string): Promise<Invoice>;
+}
+
+declare class HeyInvoice {
+    private readonly httpClient;
+    readonly invoices: Invoices;
+    /**
+     * Initializes a new HeyInvoice SDK client.
+     *
+     * @param apiKeyOrConfig API Key string or full ClientConfig object
+     * @param options Additional client options if first parameter is an API Key string
+     *
+     * @example
+     * ```ts
+     * // String initialization
+     * const heyinvoice = new HeyInvoice('sk_live_xyz123');
+     *
+     * // Object initialization
+     * const heyinvoice = new HeyInvoice({
+     *   apiKey: 'sk_live_xyz123',
+     *   apiBase: 'https://api.heyinvoice.com',
+     * });
+     * ```
+     */
+    constructor(apiKeyOrConfig: string | ClientConfig, options?: Omit<ClientConfig, 'apiKey'>);
+}
+
+interface HeyInvoiceErrorOptions {
+    type?: string;
+    statusCode?: number;
+    code?: string;
+    requestId?: string;
+    raw?: unknown;
+}
+declare class HeyInvoiceError extends Error {
+    readonly type: string;
+    readonly statusCode?: number;
+    readonly code?: string;
+    readonly requestId?: string;
+    readonly raw?: unknown;
+    constructor(message: string, options?: HeyInvoiceErrorOptions);
+}
+declare class AuthenticationError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class InvalidRequestError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class NotFoundError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class APIError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+declare class ConnectionError extends HeyInvoiceError {
+    constructor(message?: string, options?: Omit<HeyInvoiceErrorOptions, 'type'>);
+}
+
+export { APIError, AuthenticationError, type ClientConfig, ConnectionError, type CreateInvoiceParams, type DeletedResource, HeyInvoice, HeyInvoiceError, type HeyInvoiceErrorOptions, InvalidRequestError, type Invoice, type InvoiceLineItem, type InvoiceStatus, Invoices, type ListInvoicesParams, NotFoundError, type PaginatedList, Resource, type UpdateInvoiceParams, HeyInvoice as default };

package/dist/index.js

@@ -0,0 +1,322 @@
+"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, {
+  APIError: () => APIError,
+  AuthenticationError: () => AuthenticationError,
+  ConnectionError: () => ConnectionError,
+  HeyInvoice: () => HeyInvoice,
+  HeyInvoiceError: () => HeyInvoiceError,
+  InvalidRequestError: () => InvalidRequestError,
+  Invoices: () => Invoices,
+  NotFoundError: () => NotFoundError,
+  Resource: () => Resource,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors/index.ts
+var HeyInvoiceError = class extends Error {
+  type;
+  statusCode;
+  code;
+  requestId;
+  raw;
+  constructor(message, options) {
+    super(message);
+    this.name = this.constructor.name;
+    this.type = options?.type || "api_error";
+    this.statusCode = options?.statusCode;
+    this.code = options?.code;
+    this.requestId = options?.requestId;
+    this.raw = options?.raw;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AuthenticationError = class extends HeyInvoiceError {
+  constructor(message = "Invalid API key or unauthorized request", options) {
+    super(message, { ...options, type: "authentication_error", statusCode: options?.statusCode || 401 });
+  }
+};
+var InvalidRequestError = class extends HeyInvoiceError {
+  constructor(message = "Invalid request parameters", options) {
+    super(message, { ...options, type: "invalid_request_error", statusCode: options?.statusCode || 400 });
+  }
+};
+var NotFoundError = class extends HeyInvoiceError {
+  constructor(message = "Resource not found", options) {
+    super(message, { ...options, type: "not_found_error", statusCode: options?.statusCode || 404 });
+  }
+};
+var APIError = class extends HeyInvoiceError {
+  constructor(message = "An error occurred on HeyInvoice servers", options) {
+    super(message, { ...options, type: "api_error", statusCode: options?.statusCode || 500 });
+  }
+};
+var ConnectionError = class extends HeyInvoiceError {
+  constructor(message = "Failed to connect to HeyInvoice API", options) {
+    super(message, { ...options, type: "connection_error" });
+  }
+};
+
+// src/http/httpClient.ts
+var HttpClient = class {
+  apiKey;
+  apiBase;
+  timeout;
+  maxRetries;
+  customHeaders;
+  constructor(config) {
+    if (!config.apiKey || typeof config.apiKey !== "string" || !config.apiKey.trim()) {
+      throw new AuthenticationError("API Key is required to instantiate HeyInvoice SDK");
+    }
+    this.apiKey = config.apiKey.trim();
+    this.apiBase = (config.apiBase || "https://api.heyinvoice.com").replace(/\/+$/, "");
+    this.timeout = config.timeout ?? 3e4;
+    this.maxRetries = config.maxRetries ?? 2;
+    this.customHeaders = config.headers || {};
+  }
+  async request(options) {
+    const url = this.buildUrl(options.path, options.query);
+    const headers = this.buildHeaders(options.headers);
+    let attempt = 0;
+    while (true) {
+      attempt++;
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          method: options.method,
+          headers,
+          body: options.body ? JSON.stringify(options.body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        const requestId = response.headers.get("x-request-id") || void 0;
+        let responseData;
+        const contentType = response.headers.get("content-type") || "";
+        if (contentType.includes("application/json")) {
+          responseData = await response.json();
+        } else {
+          responseData = await response.text();
+        }
+        if (response.ok) {
+          return responseData;
+        }
+        const errorMessage = typeof responseData === "object" && responseData?.message || typeof responseData === "string" && responseData || `HTTP Error ${response.status} ${response.statusText}`;
+        const code = typeof responseData === "object" ? responseData?.code : void 0;
+        if (response.status === 401 || response.status === 403) {
+          throw new AuthenticationError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        if (response.status === 404) {
+          throw new NotFoundError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        if (response.status === 400 || response.status === 422) {
+          throw new InvalidRequestError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        if (response.status >= 500) {
+          if (attempt <= this.maxRetries) {
+            await this.delay(attempt * 500);
+            continue;
+          }
+          throw new APIError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        throw new HeyInvoiceError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+      } catch (err) {
+        if (err instanceof HeyInvoiceError) {
+          throw err;
+        }
+        if (err.name === "AbortError") {
+          throw new ConnectionError(`Request timed out after ${this.timeout}ms`);
+        }
+        if (attempt <= this.maxRetries && err.name !== "AbortError") {
+          await this.delay(attempt * 500);
+          continue;
+        }
+        throw new ConnectionError(err.message || "Network communication failure", { raw: err });
+      }
+    }
+  }
+  buildUrl(path, query) {
+    const formattedPath = path.startsWith("/") ? path : `/${path}`;
+    const url = new URL(`${this.apiBase}${formattedPath}`);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.append(key, String(value));
+        }
+      });
+    }
+    return url.toString();
+  }
+  buildHeaders(extraHeaders) {
+    return {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      "Accept": "application/json",
+      "User-Agent": "HeyInvoice/v1 NodeSDK/1.0.0",
+      ...this.customHeaders,
+      ...extraHeaders
+    };
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/resources/resource.ts
+var Resource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+};
+
+// src/resources/invoices.ts
+var Invoices = class extends Resource {
+  /**
+   * Create a new invoice draft.
+   */
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/invoices",
+      body: params
+    });
+  }
+  /**
+   * Retrieve an existing invoice by ID.
+   */
+  async retrieve(id) {
+    return this.client.request({
+      method: "GET",
+      path: `/v1/invoices/${encodeURIComponent(id)}`
+    });
+  }
+  /**
+   * Alias for retrieve.
+   */
+  async get(id) {
+    return this.retrieve(id);
+  }
+  /**
+   * Update an existing invoice.
+   */
+  async update(id, params) {
+    return this.client.request({
+      method: "PATCH",
+      path: `/v1/invoices/${encodeURIComponent(id)}`,
+      body: params
+    });
+  }
+  /**
+   * List invoices with optional pagination and filtering.
+   */
+  async list(params) {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/invoices",
+      query: params
+    });
+  }
+  /**
+   * Delete or void an invoice.
+   */
+  async del(id) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/v1/invoices/${encodeURIComponent(id)}`
+    });
+  }
+  /**
+   * Finalize/Send a draft invoice.
+   */
+  async send(id) {
+    return this.client.request({
+      method: "POST",
+      path: `/v1/invoices/${encodeURIComponent(id)}/send`
+    });
+  }
+  /**
+   * Void an invoice.
+   */
+  async void(id) {
+    return this.client.request({
+      method: "POST",
+      path: `/v1/invoices/${encodeURIComponent(id)}/void`
+    });
+  }
+};
+
+// src/client.ts
+var HeyInvoice = class {
+  httpClient;
+  invoices;
+  /**
+   * Initializes a new HeyInvoice SDK client.
+   * 
+   * @param apiKeyOrConfig API Key string or full ClientConfig object
+   * @param options Additional client options if first parameter is an API Key string
+   * 
+   * @example
+   * ```ts
+   * // String initialization
+   * const heyinvoice = new HeyInvoice('sk_live_xyz123');
+   * 
+   * // Object initialization
+   * const heyinvoice = new HeyInvoice({
+   *   apiKey: 'sk_live_xyz123',
+   *   apiBase: 'https://api.heyinvoice.com',
+   * });
+   * ```
+   */
+  constructor(apiKeyOrConfig, options) {
+    let config;
+    if (typeof apiKeyOrConfig === "string") {
+      config = {
+        apiKey: apiKeyOrConfig,
+        ...options
+      };
+    } else if (apiKeyOrConfig && typeof apiKeyOrConfig === "object") {
+      config = apiKeyOrConfig;
+    } else {
+      throw new Error("Invalid constructor arguments: API key string or config object expected");
+    }
+    this.httpClient = new HttpClient(config);
+    this.invoices = new Invoices(this.httpClient);
+  }
+};
+
+// src/index.ts
+var index_default = HeyInvoice;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIError,
+  AuthenticationError,
+  ConnectionError,
+  HeyInvoice,
+  HeyInvoiceError,
+  InvalidRequestError,
+  Invoices,
+  NotFoundError,
+  Resource
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors/index.ts","../src/http/httpClient.ts","../src/resources/resource.ts","../src/resources/invoices.ts","../src/client.ts"],"sourcesContent":["import { HeyInvoice } from './client';\n\nexport { HeyInvoice };\nexport default HeyInvoice;\n\nexport * from './types';\nexport * from './errors';\nexport * from './resources/invoices';\nexport * from './resources/resource';\n","export interface HeyInvoiceErrorOptions {\n  type?: string;\n  statusCode?: number;\n  code?: string;\n  requestId?: string;\n  raw?: unknown;\n}\n\nexport class HeyInvoiceError extends Error {\n  readonly type: string;\n  readonly statusCode?: number;\n  readonly code?: string;\n  readonly requestId?: string;\n  readonly raw?: unknown;\n\n  constructor(message: string, options?: HeyInvoiceErrorOptions) {\n    super(message);\n    this.name = this.constructor.name;\n    this.type = options?.type || 'api_error';\n    this.statusCode = options?.statusCode;\n    this.code = options?.code;\n    this.requestId = options?.requestId;\n    this.raw = options?.raw;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class AuthenticationError extends HeyInvoiceError {\n  constructor(message = 'Invalid API key or unauthorized request', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'authentication_error', statusCode: options?.statusCode || 401 });\n  }\n}\n\nexport class InvalidRequestError extends HeyInvoiceError {\n  constructor(message = 'Invalid request parameters', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'invalid_request_error', statusCode: options?.statusCode || 400 });\n  }\n}\n\nexport class NotFoundError extends HeyInvoiceError {\n  constructor(message = 'Resource not found', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'not_found_error', statusCode: options?.statusCode || 404 });\n  }\n}\n\nexport class APIError extends HeyInvoiceError {\n  constructor(message = 'An error occurred on HeyInvoice servers', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'api_error', statusCode: options?.statusCode || 500 });\n  }\n}\n\nexport class ConnectionError extends HeyInvoiceError {\n  constructor(message = 'Failed to connect to HeyInvoice API', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'connection_error' });\n  }\n}\n","import { ClientConfig } from '../types';\nimport {\n  HeyInvoiceError,\n  AuthenticationError,\n  InvalidRequestError,\n  NotFoundError,\n  APIError,\n  ConnectionError,\n} from '../errors';\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n  path: string;\n  query?: Record<string, string | number | boolean | undefined>;\n  body?: unknown;\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly apiBase: string;\n  private readonly timeout: number;\n  private readonly maxRetries: number;\n  private readonly customHeaders: Record<string, string>;\n\n  constructor(config: ClientConfig) {\n    if (!config.apiKey || typeof config.apiKey !== 'string' || !config.apiKey.trim()) {\n      throw new AuthenticationError('API Key is required to instantiate HeyInvoice SDK');\n    }\n    this.apiKey = config.apiKey.trim();\n    this.apiBase = (config.apiBase || 'https://api.heyinvoice.com').replace(/\\/+$/, '');\n    this.timeout = config.timeout ?? 30000;\n    this.maxRetries = config.maxRetries ?? 2;\n    this.customHeaders = config.headers || {};\n  }\n\n  async request<T>(options: RequestOptions): Promise<T> {\n    const url = this.buildUrl(options.path, options.query);\n    const headers = this.buildHeaders(options.headers);\n\n    let attempt = 0;\n    while (true) {\n      attempt++;\n      try {\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n        const response = await fetch(url, {\n          method: options.method,\n          headers,\n          body: options.body ? JSON.stringify(options.body) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        const requestId = response.headers.get('x-request-id') || undefined;\n        let responseData: any;\n        const contentType = response.headers.get('content-type') || '';\n\n        if (contentType.includes('application/json')) {\n          responseData = await response.json();\n        } else {\n          responseData = await response.text();\n        }\n\n        if (response.ok) {\n          return responseData as T;\n        }\n\n        const errorMessage =\n          (typeof responseData === 'object' && responseData?.message) ||\n          (typeof responseData === 'string' && responseData) ||\n          `HTTP Error ${response.status} ${response.statusText}`;\n\n        const code = typeof responseData === 'object' ? responseData?.code : undefined;\n\n        if (response.status === 401 || response.status === 403) {\n          throw new AuthenticationError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n        if (response.status === 404) {\n          throw new NotFoundError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n        if (response.status === 400 || response.status === 422) {\n          throw new InvalidRequestError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n\n        if (response.status >= 500) {\n          if (attempt <= this.maxRetries) {\n            await this.delay(attempt * 500);\n            continue;\n          }\n          throw new APIError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n\n        throw new HeyInvoiceError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n      } catch (err: any) {\n        if (err instanceof HeyInvoiceError) {\n          throw err;\n        }\n\n        if (err.name === 'AbortError') {\n          throw new ConnectionError(`Request timed out after ${this.timeout}ms`);\n        }\n\n        if (attempt <= this.maxRetries && err.name !== 'AbortError') {\n          await this.delay(attempt * 500);\n          continue;\n        }\n\n        throw new ConnectionError(err.message || 'Network communication failure', { raw: err });\n      }\n    }\n  }\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean | undefined>): string {\n    const formattedPath = path.startsWith('/') ? path : `/${path}`;\n    const url = new URL(`${this.apiBase}${formattedPath}`);\n\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.append(key, String(value));\n        }\n      });\n    }\n\n    return url.toString();\n  }\n\n  private buildHeaders(extraHeaders?: Record<string, string>): Record<string, string> {\n    return {\n      'Authorization': `Bearer ${this.apiKey}`,\n      'Content-Type': 'application/json',\n      'Accept': 'application/json',\n      'User-Agent': 'HeyInvoice/v1 NodeSDK/1.0.0',\n      ...this.customHeaders,\n      ...extraHeaders,\n    };\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n","import { HttpClient } from '../http/httpClient';\n\nexport abstract class Resource {\n  protected readonly client: HttpClient;\n\n  constructor(client: HttpClient) {\n    this.client = client;\n  }\n}\n","import { Resource } from './resource';\nimport {\n  Invoice,\n  CreateInvoiceParams,\n  UpdateInvoiceParams,\n  ListInvoicesParams,\n  PaginatedList,\n  DeletedResource,\n} from '../types';\n\nexport class Invoices extends Resource {\n  /**\n   * Create a new invoice draft.\n   */\n  async create(params: CreateInvoiceParams): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'POST',\n      path: '/v1/invoices',\n      body: params,\n    });\n  }\n\n  /**\n   * Retrieve an existing invoice by ID.\n   */\n  async retrieve(id: string): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'GET',\n      path: `/v1/invoices/${encodeURIComponent(id)}`,\n    });\n  }\n\n  /**\n   * Alias for retrieve.\n   */\n  async get(id: string): Promise<Invoice> {\n    return this.retrieve(id);\n  }\n\n  /**\n   * Update an existing invoice.\n   */\n  async update(id: string, params: UpdateInvoiceParams): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'PATCH',\n      path: `/v1/invoices/${encodeURIComponent(id)}`,\n      body: params,\n    });\n  }\n\n  /**\n   * List invoices with optional pagination and filtering.\n   */\n  async list(params?: ListInvoicesParams): Promise<PaginatedList<Invoice>> {\n    return this.client.request<PaginatedList<Invoice>>({\n      method: 'GET',\n      path: '/v1/invoices',\n      query: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  /**\n   * Delete or void an invoice.\n   */\n  async del(id: string): Promise<DeletedResource> {\n    return this.client.request<DeletedResource>({\n      method: 'DELETE',\n      path: `/v1/invoices/${encodeURIComponent(id)}`,\n    });\n  }\n\n  /**\n   * Finalize/Send a draft invoice.\n   */\n  async send(id: string): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'POST',\n      path: `/v1/invoices/${encodeURIComponent(id)}/send`,\n    });\n  }\n\n  /**\n   * Void an invoice.\n   */\n  async void(id: string): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'POST',\n      path: `/v1/invoices/${encodeURIComponent(id)}/void`,\n    });\n  }\n}\n","import { ClientConfig } from './types';\nimport { HttpClient } from './http/httpClient';\nimport { Invoices } from './resources/invoices';\n\nexport class HeyInvoice {\n  private readonly httpClient: HttpClient;\n  readonly invoices: Invoices;\n\n  /**\n   * Initializes a new HeyInvoice SDK client.\n   * \n   * @param apiKeyOrConfig API Key string or full ClientConfig object\n   * @param options Additional client options if first parameter is an API Key string\n   * \n   * @example\n   * ```ts\n   * // String initialization\n   * const heyinvoice = new HeyInvoice('sk_live_xyz123');\n   * \n   * // Object initialization\n   * const heyinvoice = new HeyInvoice({\n   *   apiKey: 'sk_live_xyz123',\n   *   apiBase: 'https://api.heyinvoice.com',\n   * });\n   * ```\n   */\n  constructor(apiKeyOrConfig: string | ClientConfig, options?: Omit<ClientConfig, 'apiKey'>) {\n    let config: ClientConfig;\n\n    if (typeof apiKeyOrConfig === 'string') {\n      config = {\n        apiKey: apiKeyOrConfig,\n        ...options,\n      };\n    } else if (apiKeyOrConfig && typeof apiKeyOrConfig === 'object') {\n      config = apiKeyOrConfig;\n    } else {\n      throw new Error('Invalid constructor arguments: API key string or config object expected');\n    }\n\n    this.httpClient = new HttpClient(config);\n    this.invoices = new Invoices(this.httpClient);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,287 @@
+// src/errors/index.ts
+var HeyInvoiceError = class extends Error {
+  type;
+  statusCode;
+  code;
+  requestId;
+  raw;
+  constructor(message, options) {
+    super(message);
+    this.name = this.constructor.name;
+    this.type = options?.type || "api_error";
+    this.statusCode = options?.statusCode;
+    this.code = options?.code;
+    this.requestId = options?.requestId;
+    this.raw = options?.raw;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AuthenticationError = class extends HeyInvoiceError {
+  constructor(message = "Invalid API key or unauthorized request", options) {
+    super(message, { ...options, type: "authentication_error", statusCode: options?.statusCode || 401 });
+  }
+};
+var InvalidRequestError = class extends HeyInvoiceError {
+  constructor(message = "Invalid request parameters", options) {
+    super(message, { ...options, type: "invalid_request_error", statusCode: options?.statusCode || 400 });
+  }
+};
+var NotFoundError = class extends HeyInvoiceError {
+  constructor(message = "Resource not found", options) {
+    super(message, { ...options, type: "not_found_error", statusCode: options?.statusCode || 404 });
+  }
+};
+var APIError = class extends HeyInvoiceError {
+  constructor(message = "An error occurred on HeyInvoice servers", options) {
+    super(message, { ...options, type: "api_error", statusCode: options?.statusCode || 500 });
+  }
+};
+var ConnectionError = class extends HeyInvoiceError {
+  constructor(message = "Failed to connect to HeyInvoice API", options) {
+    super(message, { ...options, type: "connection_error" });
+  }
+};
+
+// src/http/httpClient.ts
+var HttpClient = class {
+  apiKey;
+  apiBase;
+  timeout;
+  maxRetries;
+  customHeaders;
+  constructor(config) {
+    if (!config.apiKey || typeof config.apiKey !== "string" || !config.apiKey.trim()) {
+      throw new AuthenticationError("API Key is required to instantiate HeyInvoice SDK");
+    }
+    this.apiKey = config.apiKey.trim();
+    this.apiBase = (config.apiBase || "https://api.heyinvoice.com").replace(/\/+$/, "");
+    this.timeout = config.timeout ?? 3e4;
+    this.maxRetries = config.maxRetries ?? 2;
+    this.customHeaders = config.headers || {};
+  }
+  async request(options) {
+    const url = this.buildUrl(options.path, options.query);
+    const headers = this.buildHeaders(options.headers);
+    let attempt = 0;
+    while (true) {
+      attempt++;
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          method: options.method,
+          headers,
+          body: options.body ? JSON.stringify(options.body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        const requestId = response.headers.get("x-request-id") || void 0;
+        let responseData;
+        const contentType = response.headers.get("content-type") || "";
+        if (contentType.includes("application/json")) {
+          responseData = await response.json();
+        } else {
+          responseData = await response.text();
+        }
+        if (response.ok) {
+          return responseData;
+        }
+        const errorMessage = typeof responseData === "object" && responseData?.message || typeof responseData === "string" && responseData || `HTTP Error ${response.status} ${response.statusText}`;
+        const code = typeof responseData === "object" ? responseData?.code : void 0;
+        if (response.status === 401 || response.status === 403) {
+          throw new AuthenticationError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        if (response.status === 404) {
+          throw new NotFoundError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        if (response.status === 400 || response.status === 422) {
+          throw new InvalidRequestError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        if (response.status >= 500) {
+          if (attempt <= this.maxRetries) {
+            await this.delay(attempt * 500);
+            continue;
+          }
+          throw new APIError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+        }
+        throw new HeyInvoiceError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });
+      } catch (err) {
+        if (err instanceof HeyInvoiceError) {
+          throw err;
+        }
+        if (err.name === "AbortError") {
+          throw new ConnectionError(`Request timed out after ${this.timeout}ms`);
+        }
+        if (attempt <= this.maxRetries && err.name !== "AbortError") {
+          await this.delay(attempt * 500);
+          continue;
+        }
+        throw new ConnectionError(err.message || "Network communication failure", { raw: err });
+      }
+    }
+  }
+  buildUrl(path, query) {
+    const formattedPath = path.startsWith("/") ? path : `/${path}`;
+    const url = new URL(`${this.apiBase}${formattedPath}`);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.append(key, String(value));
+        }
+      });
+    }
+    return url.toString();
+  }
+  buildHeaders(extraHeaders) {
+    return {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json",
+      "Accept": "application/json",
+      "User-Agent": "HeyInvoice/v1 NodeSDK/1.0.0",
+      ...this.customHeaders,
+      ...extraHeaders
+    };
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/resources/resource.ts
+var Resource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+};
+
+// src/resources/invoices.ts
+var Invoices = class extends Resource {
+  /**
+   * Create a new invoice draft.
+   */
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/v1/invoices",
+      body: params
+    });
+  }
+  /**
+   * Retrieve an existing invoice by ID.
+   */
+  async retrieve(id) {
+    return this.client.request({
+      method: "GET",
+      path: `/v1/invoices/${encodeURIComponent(id)}`
+    });
+  }
+  /**
+   * Alias for retrieve.
+   */
+  async get(id) {
+    return this.retrieve(id);
+  }
+  /**
+   * Update an existing invoice.
+   */
+  async update(id, params) {
+    return this.client.request({
+      method: "PATCH",
+      path: `/v1/invoices/${encodeURIComponent(id)}`,
+      body: params
+    });
+  }
+  /**
+   * List invoices with optional pagination and filtering.
+   */
+  async list(params) {
+    return this.client.request({
+      method: "GET",
+      path: "/v1/invoices",
+      query: params
+    });
+  }
+  /**
+   * Delete or void an invoice.
+   */
+  async del(id) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/v1/invoices/${encodeURIComponent(id)}`
+    });
+  }
+  /**
+   * Finalize/Send a draft invoice.
+   */
+  async send(id) {
+    return this.client.request({
+      method: "POST",
+      path: `/v1/invoices/${encodeURIComponent(id)}/send`
+    });
+  }
+  /**
+   * Void an invoice.
+   */
+  async void(id) {
+    return this.client.request({
+      method: "POST",
+      path: `/v1/invoices/${encodeURIComponent(id)}/void`
+    });
+  }
+};
+
+// src/client.ts
+var HeyInvoice = class {
+  httpClient;
+  invoices;
+  /**
+   * Initializes a new HeyInvoice SDK client.
+   * 
+   * @param apiKeyOrConfig API Key string or full ClientConfig object
+   * @param options Additional client options if first parameter is an API Key string
+   * 
+   * @example
+   * ```ts
+   * // String initialization
+   * const heyinvoice = new HeyInvoice('sk_live_xyz123');
+   * 
+   * // Object initialization
+   * const heyinvoice = new HeyInvoice({
+   *   apiKey: 'sk_live_xyz123',
+   *   apiBase: 'https://api.heyinvoice.com',
+   * });
+   * ```
+   */
+  constructor(apiKeyOrConfig, options) {
+    let config;
+    if (typeof apiKeyOrConfig === "string") {
+      config = {
+        apiKey: apiKeyOrConfig,
+        ...options
+      };
+    } else if (apiKeyOrConfig && typeof apiKeyOrConfig === "object") {
+      config = apiKeyOrConfig;
+    } else {
+      throw new Error("Invalid constructor arguments: API key string or config object expected");
+    }
+    this.httpClient = new HttpClient(config);
+    this.invoices = new Invoices(this.httpClient);
+  }
+};
+
+// src/index.ts
+var index_default = HeyInvoice;
+export {
+  APIError,
+  AuthenticationError,
+  ConnectionError,
+  HeyInvoice,
+  HeyInvoiceError,
+  InvalidRequestError,
+  Invoices,
+  NotFoundError,
+  Resource,
+  index_default as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts","../src/http/httpClient.ts","../src/resources/resource.ts","../src/resources/invoices.ts","../src/client.ts","../src/index.ts"],"sourcesContent":["export interface HeyInvoiceErrorOptions {\n  type?: string;\n  statusCode?: number;\n  code?: string;\n  requestId?: string;\n  raw?: unknown;\n}\n\nexport class HeyInvoiceError extends Error {\n  readonly type: string;\n  readonly statusCode?: number;\n  readonly code?: string;\n  readonly requestId?: string;\n  readonly raw?: unknown;\n\n  constructor(message: string, options?: HeyInvoiceErrorOptions) {\n    super(message);\n    this.name = this.constructor.name;\n    this.type = options?.type || 'api_error';\n    this.statusCode = options?.statusCode;\n    this.code = options?.code;\n    this.requestId = options?.requestId;\n    this.raw = options?.raw;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class AuthenticationError extends HeyInvoiceError {\n  constructor(message = 'Invalid API key or unauthorized request', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'authentication_error', statusCode: options?.statusCode || 401 });\n  }\n}\n\nexport class InvalidRequestError extends HeyInvoiceError {\n  constructor(message = 'Invalid request parameters', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'invalid_request_error', statusCode: options?.statusCode || 400 });\n  }\n}\n\nexport class NotFoundError extends HeyInvoiceError {\n  constructor(message = 'Resource not found', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'not_found_error', statusCode: options?.statusCode || 404 });\n  }\n}\n\nexport class APIError extends HeyInvoiceError {\n  constructor(message = 'An error occurred on HeyInvoice servers', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'api_error', statusCode: options?.statusCode || 500 });\n  }\n}\n\nexport class ConnectionError extends HeyInvoiceError {\n  constructor(message = 'Failed to connect to HeyInvoice API', options?: Omit<HeyInvoiceErrorOptions, 'type'>) {\n    super(message, { ...options, type: 'connection_error' });\n  }\n}\n","import { ClientConfig } from '../types';\nimport {\n  HeyInvoiceError,\n  AuthenticationError,\n  InvalidRequestError,\n  NotFoundError,\n  APIError,\n  ConnectionError,\n} from '../errors';\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';\n  path: string;\n  query?: Record<string, string | number | boolean | undefined>;\n  body?: unknown;\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly apiBase: string;\n  private readonly timeout: number;\n  private readonly maxRetries: number;\n  private readonly customHeaders: Record<string, string>;\n\n  constructor(config: ClientConfig) {\n    if (!config.apiKey || typeof config.apiKey !== 'string' || !config.apiKey.trim()) {\n      throw new AuthenticationError('API Key is required to instantiate HeyInvoice SDK');\n    }\n    this.apiKey = config.apiKey.trim();\n    this.apiBase = (config.apiBase || 'https://api.heyinvoice.com').replace(/\\/+$/, '');\n    this.timeout = config.timeout ?? 30000;\n    this.maxRetries = config.maxRetries ?? 2;\n    this.customHeaders = config.headers || {};\n  }\n\n  async request<T>(options: RequestOptions): Promise<T> {\n    const url = this.buildUrl(options.path, options.query);\n    const headers = this.buildHeaders(options.headers);\n\n    let attempt = 0;\n    while (true) {\n      attempt++;\n      try {\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n        const response = await fetch(url, {\n          method: options.method,\n          headers,\n          body: options.body ? JSON.stringify(options.body) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        const requestId = response.headers.get('x-request-id') || undefined;\n        let responseData: any;\n        const contentType = response.headers.get('content-type') || '';\n\n        if (contentType.includes('application/json')) {\n          responseData = await response.json();\n        } else {\n          responseData = await response.text();\n        }\n\n        if (response.ok) {\n          return responseData as T;\n        }\n\n        const errorMessage =\n          (typeof responseData === 'object' && responseData?.message) ||\n          (typeof responseData === 'string' && responseData) ||\n          `HTTP Error ${response.status} ${response.statusText}`;\n\n        const code = typeof responseData === 'object' ? responseData?.code : undefined;\n\n        if (response.status === 401 || response.status === 403) {\n          throw new AuthenticationError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n        if (response.status === 404) {\n          throw new NotFoundError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n        if (response.status === 400 || response.status === 422) {\n          throw new InvalidRequestError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n\n        if (response.status >= 500) {\n          if (attempt <= this.maxRetries) {\n            await this.delay(attempt * 500);\n            continue;\n          }\n          throw new APIError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n        }\n\n        throw new HeyInvoiceError(errorMessage, { statusCode: response.status, code, requestId, raw: responseData });\n      } catch (err: any) {\n        if (err instanceof HeyInvoiceError) {\n          throw err;\n        }\n\n        if (err.name === 'AbortError') {\n          throw new ConnectionError(`Request timed out after ${this.timeout}ms`);\n        }\n\n        if (attempt <= this.maxRetries && err.name !== 'AbortError') {\n          await this.delay(attempt * 500);\n          continue;\n        }\n\n        throw new ConnectionError(err.message || 'Network communication failure', { raw: err });\n      }\n    }\n  }\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean | undefined>): string {\n    const formattedPath = path.startsWith('/') ? path : `/${path}`;\n    const url = new URL(`${this.apiBase}${formattedPath}`);\n\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.append(key, String(value));\n        }\n      });\n    }\n\n    return url.toString();\n  }\n\n  private buildHeaders(extraHeaders?: Record<string, string>): Record<string, string> {\n    return {\n      'Authorization': `Bearer ${this.apiKey}`,\n      'Content-Type': 'application/json',\n      'Accept': 'application/json',\n      'User-Agent': 'HeyInvoice/v1 NodeSDK/1.0.0',\n      ...this.customHeaders,\n      ...extraHeaders,\n    };\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n","import { HttpClient } from '../http/httpClient';\n\nexport abstract class Resource {\n  protected readonly client: HttpClient;\n\n  constructor(client: HttpClient) {\n    this.client = client;\n  }\n}\n","import { Resource } from './resource';\nimport {\n  Invoice,\n  CreateInvoiceParams,\n  UpdateInvoiceParams,\n  ListInvoicesParams,\n  PaginatedList,\n  DeletedResource,\n} from '../types';\n\nexport class Invoices extends Resource {\n  /**\n   * Create a new invoice draft.\n   */\n  async create(params: CreateInvoiceParams): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'POST',\n      path: '/v1/invoices',\n      body: params,\n    });\n  }\n\n  /**\n   * Retrieve an existing invoice by ID.\n   */\n  async retrieve(id: string): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'GET',\n      path: `/v1/invoices/${encodeURIComponent(id)}`,\n    });\n  }\n\n  /**\n   * Alias for retrieve.\n   */\n  async get(id: string): Promise<Invoice> {\n    return this.retrieve(id);\n  }\n\n  /**\n   * Update an existing invoice.\n   */\n  async update(id: string, params: UpdateInvoiceParams): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'PATCH',\n      path: `/v1/invoices/${encodeURIComponent(id)}`,\n      body: params,\n    });\n  }\n\n  /**\n   * List invoices with optional pagination and filtering.\n   */\n  async list(params?: ListInvoicesParams): Promise<PaginatedList<Invoice>> {\n    return this.client.request<PaginatedList<Invoice>>({\n      method: 'GET',\n      path: '/v1/invoices',\n      query: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  /**\n   * Delete or void an invoice.\n   */\n  async del(id: string): Promise<DeletedResource> {\n    return this.client.request<DeletedResource>({\n      method: 'DELETE',\n      path: `/v1/invoices/${encodeURIComponent(id)}`,\n    });\n  }\n\n  /**\n   * Finalize/Send a draft invoice.\n   */\n  async send(id: string): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'POST',\n      path: `/v1/invoices/${encodeURIComponent(id)}/send`,\n    });\n  }\n\n  /**\n   * Void an invoice.\n   */\n  async void(id: string): Promise<Invoice> {\n    return this.client.request<Invoice>({\n      method: 'POST',\n      path: `/v1/invoices/${encodeURIComponent(id)}/void`,\n    });\n  }\n}\n","import { ClientConfig } from './types';\nimport { HttpClient } from './http/httpClient';\nimport { Invoices } from './resources/invoices';\n\nexport class HeyInvoice {\n  private readonly httpClient: HttpClient;\n  readonly invoices: Invoices;\n\n  /**\n   * Initializes a new HeyInvoice SDK client.\n   * \n   * @param apiKeyOrConfig API Key string or full ClientConfig object\n   * @param options Additional client options if first parameter is an API Key string\n   * \n   * @example\n   * ```ts\n   * // String initialization\n   * const heyinvoice = new HeyInvoice('sk_live_xyz123');\n   * \n   * // Object initialization\n   * const heyinvoice = new HeyInvoice({\n   *   apiKey: 'sk_live_xyz123',\n   *   apiBase: 'https://api.heyinvoice.com',\n   * });\n   * ```\n   */\n  constructor(apiKeyOrConfig: string | ClientConfig, options?: Omit<ClientConfig, 'apiKey'>) {\n    let config: ClientConfig;\n\n    if (typeof apiKeyOrConfig === 'string') {\n      config = {\n        apiKey: apiKeyOrConfig,\n        ...options,\n      };\n    } else if (apiKeyOrConfig && typeof apiKeyOrConfig === 'object') {\n      config = apiKeyOrConfig;\n    } else {\n      throw new Error('Invalid constructor arguments: API key string or config object expected');\n    }\n\n    this.httpClient = new HttpClient(config);\n    this.invoices = new Invoices(this.httpClient);\n  }\n}\n","import { HeyInvoice } from './client';\n\nexport { HeyInvoice };\nexport default HeyInvoice;\n\nexport * from './types';\nexport * from './errors';\nexport * from './resources/invoices';\nexport * from './resources/resource';\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@heyinvoice/sdk",
+  "version": "1.0.0",
+  "description": "Official Node.js and TypeScript SDK for HeyInvoice API",
+  "author": "HeyInvoice",
+  "license": "MIT",
+  "keywords": [
+    "heyinvoice",
+    "invoice",
+    "peppol",
+    "sdk",
+    "stripe-like",
+    "api-client"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "npx --cache /tmp/npm-cache -p tsup -p typescript@5.7.3 tsup",
+    "dev": "npx --cache /tmp/npm-cache -p tsup -p typescript@5.7.3 tsup --watch",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "workspace:*",
+    "tsup": "^8.3.6",
+    "typescript": "5.9.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}