factuplan 0.1.0

package/README.md

@@ -0,0 +1,199 @@
+# Factuplan
+
+SDK oficial de [Factuplan](https://tufactura.com) para JavaScript y TypeScript. Emite facturas electronicas en Ecuador (SRI) desde tu aplicacion.
+
+## Instalacion
+
+```bash
+npm install factuplan
+```
+
+## Inicio rapido
+
+```typescript
+import { Factuplan } from 'factuplan';
+
+const factuplan = new Factuplan('tu-api-key');
+
+// Crear una factura
+const invoice = await factuplan.invoices.create({
+  emissionPointId: 'ep_...',
+  customer: {
+    identificationType: 'RUC',
+    identification: '1790016919001',
+    legalName: 'Empresa ABC S.A.',
+    email: 'contabilidad@empresa.com',
+  },
+  items: [
+    {
+      code: 'SERV-001',
+      description: 'Servicio de consultoria',
+      quantity: 1,
+      unitPrice: 100.00,
+      taxType: 'IVA_RATE',
+    },
+  ],
+});
+
+console.log(invoice.accessKey); // Clave de acceso SRI
+```
+
+## Recursos
+
+### Clientes
+
+```typescript
+// Crear cliente
+const customer = await factuplan.customers.create({
+  identificationType: 'RUC',
+  identification: '1790016919001',
+  legalName: 'Empresa ABC S.A.',
+  email: 'info@empresa.com',
+});
+
+// Listar clientes (paginado)
+const { data, meta } = await factuplan.customers.list({ page: 1, limit: 20 });
+
+// Obtener cliente por ID
+const customer = await factuplan.customers.get('customer-id');
+
+// Actualizar cliente
+await factuplan.customers.update('customer-id', { phone: '0991234567' });
+
+// Eliminar cliente
+await factuplan.customers.delete('customer-id');
+```
+
+### Productos
+
+```typescript
+// Crear producto
+const product = await factuplan.products.create({
+  code: 'PROD-001',
+  name: 'Laptop Dell XPS',
+  unitPrice: 1200.00,
+  taxType: 'IVA_RATE',
+  type: 'PRODUCT',
+});
+
+// Listar productos (paginado)
+const { data, meta } = await factuplan.products.list({ page: 1, limit: 20 });
+
+// Obtener producto por ID
+const product = await factuplan.products.get('product-id');
+
+// Actualizar producto
+await factuplan.products.update('product-id', { unitPrice: 1150.00 });
+
+// Eliminar producto
+await factuplan.products.delete('product-id');
+```
+
+### Facturas
+
+```typescript
+// Crear factura
+const invoice = await factuplan.invoices.create({
+  emissionPointId: 'ep_...',
+  customer: {
+    identificationType: 'CEDULA',
+    identification: '1712345678',
+    legalName: 'Juan Perez',
+    email: 'juan@email.com',
+    saveToContacts: true,
+  },
+  items: [
+    {
+      code: 'SERV-001',
+      description: 'Desarrollo web',
+      quantity: 10,
+      unitPrice: 50.00,
+      discount: 25.00,
+      taxType: 'IVA_RATE',
+    },
+  ],
+  paymentMethod: 'TRANSFER',
+  additionalInfo: {
+    'Orden de compra': 'OC-2024-001',
+  },
+});
+
+// Consultar estado
+const status = await factuplan.invoices.getStatus('invoice-id');
+console.log(status.status); // 'AUTHORIZED', 'PENDING', etc.
+
+// Descargar XML autorizado
+const { url } = await factuplan.invoices.downloadXml('invoice-id');
+
+// Descargar PDF (RIDE)
+const { url } = await factuplan.invoices.downloadPdf('invoice-id');
+```
+
+### Uso y certificado
+
+```typescript
+// Consultar uso de la API
+const usage = await factuplan.usage();
+console.log(`${usage.used}/${usage.quota} facturas este mes`);
+
+// Estado del certificado de firma
+const cert = await factuplan.certificateStatus();
+console.log(`Expira en ${cert.daysUntilExpiry} dias`);
+```
+
+## Configuracion
+
+```typescript
+const factuplan = new Factuplan('tu-api-key', {
+  baseUrl: 'https://api.factuplan.com/api/v1', // default
+  timeout: 30000, // 30s default
+});
+```
+
+## Manejo de errores
+
+```typescript
+import { Factuplan, FactuplanError, AuthenticationError, RateLimitError } from 'factuplan';
+
+try {
+  await factuplan.invoices.create({ /* ... */ });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    // API key invalida (401)
+  } else if (error instanceof RateLimitError) {
+    // Limite de peticiones excedido (429)
+  } else if (error instanceof FactuplanError) {
+    console.error(error.message);    // Mensaje de error
+    console.error(error.statusCode); // Codigo HTTP
+    console.error(error.code);       // Codigo de error interno
+    console.error(error.details);    // Detalles adicionales
+  }
+}
+```
+
+## Tipos de identificacion
+
+| Tipo | Descripcion |
+|------|-------------|
+| `RUC` | Registro Unico de Contribuyentes (13 digitos) |
+| `CEDULA` | Cedula de identidad (10 digitos) |
+| `PASSPORT` | Pasaporte |
+| `FINAL_CONSUMER` | Consumidor final (9999999999999) |
+
+## Tipos de impuesto
+
+| Tipo | Descripcion |
+|------|-------------|
+| `IVA_RATE` | IVA 15% (tarifa vigente) |
+| `IVA_0` | IVA 0% |
+| `NOT_TAXABLE` | No objeto de impuesto |
+| `EXEMPT` | Exento de IVA |
+
+## Requisitos
+
+- Node.js 18+ (usa `fetch` nativo)
+- API key de [Factuplan](https://tufactura.com)
+
+## Licencia
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,218 @@
+interface PaginatedResponse<T> {
+    data: T[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+interface Customer {
+    id: string;
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identification: string;
+    legalName: string;
+    email?: string;
+    additionalEmail?: string;
+    phone?: string;
+    address?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateCustomerInput {
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identification: string;
+    legalName: string;
+    email?: string;
+    additionalEmail?: string;
+    phone?: string;
+    address?: string;
+}
+interface UpdateCustomerInput {
+    legalName?: string;
+    email?: string;
+    additionalEmail?: string;
+    phone?: string;
+    address?: string;
+}
+interface CustomerListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+interface Product {
+    id: string;
+    code: string;
+    auxiliaryCode?: string;
+    type: 'PRODUCT' | 'SERVICE';
+    name: string;
+    description?: string;
+    unitPrice: number | string;
+    taxType: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    iceCode?: string;
+    iceRate?: number | string;
+    irbpnr: boolean;
+    unitOfMeasure?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateProductInput {
+    code: string;
+    auxiliaryCode?: string;
+    type?: 'PRODUCT' | 'SERVICE';
+    name: string;
+    description?: string;
+    unitPrice: number;
+    taxType?: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    iceCode?: string;
+    iceRate?: number;
+    irbpnr?: boolean;
+    unitOfMeasure?: string;
+}
+interface UpdateProductInput {
+    name?: string;
+    description?: string;
+    unitPrice?: number;
+    taxType?: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    type?: 'PRODUCT' | 'SERVICE';
+    unitOfMeasure?: string;
+    isActive?: boolean;
+}
+interface ProductListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+interface InvoiceCustomer {
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identification: string;
+    legalName: string;
+    email?: string;
+    address?: string;
+    phone?: string;
+    saveToContacts?: boolean;
+}
+interface InvoiceItem {
+    code: string;
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    discount?: number;
+    taxType?: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    /** Tax rate override for IVA_RATE. Valid: 0, 5, 8, 12, 14, 15. Default: 15 */
+    tax?: number;
+}
+interface CreateInvoiceInput {
+    /** UUID of the emission point. Optional if using establishment + emissionPoint codes, or if the taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+    customer: InvoiceCustomer;
+    items: InvoiceItem[];
+    paymentMethod?: string;
+    additionalInfo?: Record<string, string>;
+}
+interface Invoice {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+}
+interface InvoiceStatus {
+    id: string;
+    status: string;
+    accessKey?: string;
+    authorizationNumber?: string;
+    authorizationDate?: string;
+}
+interface DownloadUrlResponse {
+    url: string;
+    s3Key?: string;
+}
+interface UsageResponse {
+    apiKeyId: string;
+    month: string;
+    quota: number;
+    used: number;
+    remaining: number;
+    costs: Record<string, unknown>;
+}
+interface CertificateStatus {
+    hasCertificate: boolean;
+    isExpired?: boolean;
+    daysUntilExpiry?: number | null;
+    ruc?: string;
+    legalName?: string;
+    expiresAt?: string;
+}
+interface FactuplanOptions {
+    /** Base URL of the API (default: https://api.factuplan.com/api/v1) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+
+type Requester$2 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+declare class CustomersResource {
+    private request;
+    constructor(request: Requester$2);
+    create(input: CreateCustomerInput): Promise<Customer>;
+    list(params?: CustomerListParams): Promise<PaginatedResponse<Customer>>;
+    get(id: string): Promise<Customer>;
+    update(id: string, input: UpdateCustomerInput): Promise<Customer>;
+    delete(id: string): Promise<void>;
+}
+
+type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+declare class ProductsResource {
+    private request;
+    constructor(request: Requester$1);
+    create(input: CreateProductInput): Promise<Product>;
+    list(params?: ProductListParams): Promise<PaginatedResponse<Product>>;
+    get(id: string): Promise<Product>;
+    update(id: string, input: UpdateProductInput): Promise<Product>;
+    delete(id: string): Promise<void>;
+}
+
+type Requester = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class InvoicesResource {
+    private request;
+    constructor(request: Requester);
+    create(input: CreateInvoiceInput): Promise<Invoice>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+}
+
+declare class Factuplan {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    readonly customers: CustomersResource;
+    readonly products: ProductsResource;
+    readonly invoices: InvoicesResource;
+    constructor(apiKey: string, options?: FactuplanOptions);
+    usage(): Promise<UsageResponse>;
+    certificateStatus(): Promise<CertificateStatus>;
+    private request;
+}
+
+declare class FactuplanError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, statusCode: number, code: string, details?: Record<string, unknown>);
+}
+declare class AuthenticationError extends FactuplanError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends FactuplanError {
+    constructor(message?: string);
+}
+
+export { AuthenticationError, type CertificateStatus, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, RateLimitError, type UpdateCustomerInput, type UpdateProductInput, type UsageResponse };

package/dist/index.d.ts

@@ -0,0 +1,218 @@
+interface PaginatedResponse<T> {
+    data: T[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+interface Customer {
+    id: string;
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identification: string;
+    legalName: string;
+    email?: string;
+    additionalEmail?: string;
+    phone?: string;
+    address?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateCustomerInput {
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identification: string;
+    legalName: string;
+    email?: string;
+    additionalEmail?: string;
+    phone?: string;
+    address?: string;
+}
+interface UpdateCustomerInput {
+    legalName?: string;
+    email?: string;
+    additionalEmail?: string;
+    phone?: string;
+    address?: string;
+}
+interface CustomerListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+interface Product {
+    id: string;
+    code: string;
+    auxiliaryCode?: string;
+    type: 'PRODUCT' | 'SERVICE';
+    name: string;
+    description?: string;
+    unitPrice: number | string;
+    taxType: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    iceCode?: string;
+    iceRate?: number | string;
+    irbpnr: boolean;
+    unitOfMeasure?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateProductInput {
+    code: string;
+    auxiliaryCode?: string;
+    type?: 'PRODUCT' | 'SERVICE';
+    name: string;
+    description?: string;
+    unitPrice: number;
+    taxType?: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    iceCode?: string;
+    iceRate?: number;
+    irbpnr?: boolean;
+    unitOfMeasure?: string;
+}
+interface UpdateProductInput {
+    name?: string;
+    description?: string;
+    unitPrice?: number;
+    taxType?: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    type?: 'PRODUCT' | 'SERVICE';
+    unitOfMeasure?: string;
+    isActive?: boolean;
+}
+interface ProductListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+interface InvoiceCustomer {
+    identificationType: 'RUC' | 'CEDULA' | 'PASSPORT' | 'FINAL_CONSUMER';
+    identification: string;
+    legalName: string;
+    email?: string;
+    address?: string;
+    phone?: string;
+    saveToContacts?: boolean;
+}
+interface InvoiceItem {
+    code: string;
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    discount?: number;
+    taxType?: 'IVA_0' | 'IVA_RATE' | 'NOT_TAXABLE' | 'EXEMPT';
+    /** Tax rate override for IVA_RATE. Valid: 0, 5, 8, 12, 14, 15. Default: 15 */
+    tax?: number;
+}
+interface CreateInvoiceInput {
+    /** UUID of the emission point. Optional if using establishment + emissionPoint codes, or if the taxpayer has a single active emission point. */
+    emissionPointId?: string;
+    /** SRI establishment code (e.g. "001"). Must be used together with emissionPoint. */
+    establishment?: string;
+    /** SRI emission point code (e.g. "001"). Must be used together with establishment. */
+    emissionPoint?: string;
+    customer: InvoiceCustomer;
+    items: InvoiceItem[];
+    paymentMethod?: string;
+    additionalInfo?: Record<string, string>;
+}
+interface Invoice {
+    id: string;
+    accessKey: string;
+    sequential: string;
+    status: string;
+    total: number | string;
+}
+interface InvoiceStatus {
+    id: string;
+    status: string;
+    accessKey?: string;
+    authorizationNumber?: string;
+    authorizationDate?: string;
+}
+interface DownloadUrlResponse {
+    url: string;
+    s3Key?: string;
+}
+interface UsageResponse {
+    apiKeyId: string;
+    month: string;
+    quota: number;
+    used: number;
+    remaining: number;
+    costs: Record<string, unknown>;
+}
+interface CertificateStatus {
+    hasCertificate: boolean;
+    isExpired?: boolean;
+    daysUntilExpiry?: number | null;
+    ruc?: string;
+    legalName?: string;
+    expiresAt?: string;
+}
+interface FactuplanOptions {
+    /** Base URL of the API (default: https://api.factuplan.com/api/v1) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+
+type Requester$2 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+declare class CustomersResource {
+    private request;
+    constructor(request: Requester$2);
+    create(input: CreateCustomerInput): Promise<Customer>;
+    list(params?: CustomerListParams): Promise<PaginatedResponse<Customer>>;
+    get(id: string): Promise<Customer>;
+    update(id: string, input: UpdateCustomerInput): Promise<Customer>;
+    delete(id: string): Promise<void>;
+}
+
+type Requester$1 = (method: string, path: string, body?: unknown, params?: Record<string, string | number | undefined>) => Promise<unknown>;
+declare class ProductsResource {
+    private request;
+    constructor(request: Requester$1);
+    create(input: CreateProductInput): Promise<Product>;
+    list(params?: ProductListParams): Promise<PaginatedResponse<Product>>;
+    get(id: string): Promise<Product>;
+    update(id: string, input: UpdateProductInput): Promise<Product>;
+    delete(id: string): Promise<void>;
+}
+
+type Requester = (method: string, path: string, body?: unknown) => Promise<unknown>;
+declare class InvoicesResource {
+    private request;
+    constructor(request: Requester);
+    create(input: CreateInvoiceInput): Promise<Invoice>;
+    get(id: string): Promise<Record<string, unknown>>;
+    getStatus(id: string): Promise<InvoiceStatus>;
+    downloadXml(id: string): Promise<DownloadUrlResponse>;
+    downloadPdf(id: string): Promise<DownloadUrlResponse>;
+}
+
+declare class Factuplan {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    readonly customers: CustomersResource;
+    readonly products: ProductsResource;
+    readonly invoices: InvoicesResource;
+    constructor(apiKey: string, options?: FactuplanOptions);
+    usage(): Promise<UsageResponse>;
+    certificateStatus(): Promise<CertificateStatus>;
+    private request;
+}
+
+declare class FactuplanError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, statusCode: number, code: string, details?: Record<string, unknown>);
+}
+declare class AuthenticationError extends FactuplanError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends FactuplanError {
+    constructor(message?: string);
+}
+
+export { AuthenticationError, type CertificateStatus, type CreateCustomerInput, type CreateInvoiceInput, type CreateProductInput, type Customer, type CustomerListParams, type DownloadUrlResponse, Factuplan, FactuplanError, type FactuplanOptions, type Invoice, type InvoiceCustomer, type InvoiceItem, type InvoiceStatus, type PaginatedResponse, type Product, type ProductListParams, RateLimitError, type UpdateCustomerInput, type UpdateProductInput, type UsageResponse };

package/dist/index.js

@@ -0,0 +1,191 @@
+"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, {
+  AuthenticationError: () => AuthenticationError,
+  Factuplan: () => Factuplan,
+  FactuplanError: () => FactuplanError,
+  RateLimitError: () => RateLimitError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var FactuplanError = class extends Error {
+  constructor(message, statusCode, code, details) {
+    super(message);
+    this.name = "FactuplanError";
+    this.statusCode = statusCode;
+    this.code = code;
+    this.details = details;
+  }
+};
+var AuthenticationError = class extends FactuplanError {
+  constructor(message = "Invalid API key") {
+    super(message, 401, "AUTH_ERROR");
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends FactuplanError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429, "RATE_LIMIT");
+    this.name = "RateLimitError";
+  }
+};
+
+// src/resources/customers.ts
+var CustomersResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/customers", input);
+  }
+  async list(params) {
+    return this.request("GET", "/developer/customers", void 0, params);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/customers/${id}`);
+  }
+  async update(id, input) {
+    return this.request("PATCH", `/developer/customers/${id}`, input);
+  }
+  async delete(id) {
+    await this.request("DELETE", `/developer/customers/${id}`);
+  }
+};
+
+// src/resources/products.ts
+var ProductsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/products", input);
+  }
+  async list(params) {
+    return this.request("GET", "/developer/products", void 0, params);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/products/${id}`);
+  }
+  async update(id, input) {
+    return this.request("PATCH", `/developer/products/${id}`, input);
+  }
+  async delete(id) {
+    await this.request("DELETE", `/developer/products/${id}`);
+  }
+};
+
+// src/resources/invoices.ts
+var InvoicesResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/invoices", input);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.factuplan.com/api/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var Factuplan = class {
+  constructor(apiKey, options) {
+    if (!apiKey) throw new Error("API key is required");
+    this.apiKey = apiKey;
+    this.baseUrl = (options?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    const requester = this.request.bind(this);
+    this.customers = new CustomersResource(requester);
+    this.products = new ProductsResource(requester);
+    this.invoices = new InvoicesResource(requester);
+  }
+  async usage() {
+    return this.request("GET", "/developer/usage");
+  }
+  async certificateStatus() {
+    return this.request("GET", "/developer/certificate/status");
+  }
+  async request(method, path, body, params) {
+    let url = `${this.baseUrl}${path}`;
+    if (params) {
+      const searchParams = new URLSearchParams();
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== void 0 && value !== null) {
+          searchParams.set(key, String(value));
+        }
+      }
+      const qs = searchParams.toString();
+      if (qs) url += `?${qs}`;
+    }
+    const headers = {
+      "x-api-key": this.apiKey,
+      "Accept": "application/json"
+    };
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0,
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (response.status === 204) return void 0;
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      const err = json?.error ?? json;
+      const message = err?.message ?? `Request failed with status ${response.status}`;
+      const code = err?.code ?? "UNKNOWN";
+      const details = err?.details;
+      if (response.status === 401) throw new AuthenticationError(message);
+      if (response.status === 429) throw new RateLimitError(message);
+      throw new FactuplanError(message, response.status, code, details);
+    }
+    if (json && typeof json === "object" && "data" in json && "meta" in json) {
+      const meta = json.meta;
+      if (Array.isArray(json.data) && typeof meta?.total !== "undefined") {
+        return { data: json.data, meta };
+      }
+      return json.data;
+    }
+    return json;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  Factuplan,
+  FactuplanError,
+  RateLimitError
+});

package/dist/index.mjs

@@ -0,0 +1,161 @@
+// src/errors.ts
+var FactuplanError = class extends Error {
+  constructor(message, statusCode, code, details) {
+    super(message);
+    this.name = "FactuplanError";
+    this.statusCode = statusCode;
+    this.code = code;
+    this.details = details;
+  }
+};
+var AuthenticationError = class extends FactuplanError {
+  constructor(message = "Invalid API key") {
+    super(message, 401, "AUTH_ERROR");
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends FactuplanError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429, "RATE_LIMIT");
+    this.name = "RateLimitError";
+  }
+};
+
+// src/resources/customers.ts
+var CustomersResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/customers", input);
+  }
+  async list(params) {
+    return this.request("GET", "/developer/customers", void 0, params);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/customers/${id}`);
+  }
+  async update(id, input) {
+    return this.request("PATCH", `/developer/customers/${id}`, input);
+  }
+  async delete(id) {
+    await this.request("DELETE", `/developer/customers/${id}`);
+  }
+};
+
+// src/resources/products.ts
+var ProductsResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/products", input);
+  }
+  async list(params) {
+    return this.request("GET", "/developer/products", void 0, params);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/products/${id}`);
+  }
+  async update(id, input) {
+    return this.request("PATCH", `/developer/products/${id}`, input);
+  }
+  async delete(id) {
+    await this.request("DELETE", `/developer/products/${id}`);
+  }
+};
+
+// src/resources/invoices.ts
+var InvoicesResource = class {
+  constructor(request) {
+    this.request = request;
+  }
+  async create(input) {
+    return this.request("POST", "/developer/invoices", input);
+  }
+  async get(id) {
+    return this.request("GET", `/developer/receipts/${id}`);
+  }
+  async getStatus(id) {
+    return this.request("GET", `/developer/receipts/${id}/status`);
+  }
+  async downloadXml(id) {
+    return this.request("GET", `/developer/receipts/${id}/xml`);
+  }
+  async downloadPdf(id) {
+    return this.request("GET", `/developer/receipts/${id}/pdf`);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.factuplan.com/api/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var Factuplan = class {
+  constructor(apiKey, options) {
+    if (!apiKey) throw new Error("API key is required");
+    this.apiKey = apiKey;
+    this.baseUrl = (options?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    const requester = this.request.bind(this);
+    this.customers = new CustomersResource(requester);
+    this.products = new ProductsResource(requester);
+    this.invoices = new InvoicesResource(requester);
+  }
+  async usage() {
+    return this.request("GET", "/developer/usage");
+  }
+  async certificateStatus() {
+    return this.request("GET", "/developer/certificate/status");
+  }
+  async request(method, path, body, params) {
+    let url = `${this.baseUrl}${path}`;
+    if (params) {
+      const searchParams = new URLSearchParams();
+      for (const [key, value] of Object.entries(params)) {
+        if (value !== void 0 && value !== null) {
+          searchParams.set(key, String(value));
+        }
+      }
+      const qs = searchParams.toString();
+      if (qs) url += `?${qs}`;
+    }
+    const headers = {
+      "x-api-key": this.apiKey,
+      "Accept": "application/json"
+    };
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+    }
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body !== void 0 ? JSON.stringify(body) : void 0,
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (response.status === 204) return void 0;
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      const err = json?.error ?? json;
+      const message = err?.message ?? `Request failed with status ${response.status}`;
+      const code = err?.code ?? "UNKNOWN";
+      const details = err?.details;
+      if (response.status === 401) throw new AuthenticationError(message);
+      if (response.status === 429) throw new RateLimitError(message);
+      throw new FactuplanError(message, response.status, code, details);
+    }
+    if (json && typeof json === "object" && "data" in json && "meta" in json) {
+      const meta = json.meta;
+      if (Array.isArray(json.data) && typeof meta?.total !== "undefined") {
+        return { data: json.data, meta };
+      }
+      return json.data;
+    }
+    return json;
+  }
+};
+export {
+  AuthenticationError,
+  Factuplan,
+  FactuplanError,
+  RateLimitError
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "factuplan",
+  "version": "0.1.0",
+  "description": "Official Factuplan SDK for JavaScript & TypeScript — Create electronic invoices for Ecuador (SRI)",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "keywords": [
+    "factuplan",
+    "ecuador",
+    "sri",
+    "invoice",
+    "factura",
+    "electronic-billing"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+  }
+}