factuplan 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -122,6 +122,11 @@ interface CreateInvoiceInput {
     /** List of payment methods for multi-payment support. */
     payments?: InvoicePayment[];
     additionalInfo?: Record<string, string>;
+    /**
+     * Whether to send the authorized invoice by email to the customer.
+     * @default true
+     */
+    sendEmail?: boolean;
 }
 interface ImportByAccessKeyInput {
     /** 49-digit SRI access key (claveAcceso) of an already-authorized invoice */
@@ -222,6 +227,12 @@ interface FactuplanOptions {
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
+    /**
+     * Default taxpayer RUC sent as `x-taxpayer-ruc` header in every request.
+     * Required for most operations (emit, sign, customers, products, etc.).
+     * Not required for `queryExternalByAccessKey`.
+     */
+    ruc?: string;
 }
 interface QueryExternalByAccessKeyInput {
     /** Clave de acceso de 49 dígitos del comprobante en el SRI */
@@ -305,6 +316,7 @@ declare class Factuplan {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly timeout;
+    private readonly options;
     readonly customers: CustomersResource;
     readonly products: ProductsResource;
     readonly invoices: InvoicesResource;

package/dist/index.d.ts

@@ -122,6 +122,11 @@ interface CreateInvoiceInput {
     /** List of payment methods for multi-payment support. */
     payments?: InvoicePayment[];
     additionalInfo?: Record<string, string>;
+    /**
+     * Whether to send the authorized invoice by email to the customer.
+     * @default true
+     */
+    sendEmail?: boolean;
 }
 interface ImportByAccessKeyInput {
     /** 49-digit SRI access key (claveAcceso) of an already-authorized invoice */
@@ -222,6 +227,12 @@ interface FactuplanOptions {
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
+    /**
+     * Default taxpayer RUC sent as `x-taxpayer-ruc` header in every request.
+     * Required for most operations (emit, sign, customers, products, etc.).
+     * Not required for `queryExternalByAccessKey`.
+     */
+    ruc?: string;
 }
 interface QueryExternalByAccessKeyInput {
     /** Clave de acceso de 49 dígitos del comprobante en el SRI */
@@ -305,6 +316,7 @@ declare class Factuplan {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly timeout;
+    private readonly options;
     readonly customers: CustomersResource;
     readonly products: ProductsResource;
     readonly invoices: InvoicesResource;

package/dist/index.js

@@ -167,6 +167,7 @@ var Factuplan = class {
   constructor(apiKey, options) {
     if (!apiKey) throw new Error("API key is required");
     this.apiKey = apiKey;
+    this.options = options;
     this.baseUrl = (options?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
     const requester = this.request.bind(this);
@@ -197,6 +198,9 @@ var Factuplan = class {
       "x-api-key": this.apiKey,
       Accept: "application/json"
     };
+    if (this.options?.ruc) {
+      headers["x-taxpayer-ruc"] = this.options.ruc;
+    }
     if (body !== void 0) {
       headers["Content-Type"] = "application/json";
     }

package/dist/index.mjs

@@ -138,6 +138,7 @@ var Factuplan = class {
   constructor(apiKey, options) {
     if (!apiKey) throw new Error("API key is required");
     this.apiKey = apiKey;
+    this.options = options;
     this.baseUrl = (options?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
     const requester = this.request.bind(this);
@@ -168,6 +169,9 @@ var Factuplan = class {
       "x-api-key": this.apiKey,
       Accept: "application/json"
     };
+    if (this.options?.ruc) {
+      headers["x-taxpayer-ruc"] = this.options.ruc;
+    }
     if (body !== void 0) {
       headers["Content-Type"] = "application/json";
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "factuplan",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Official Factuplan SDK for JavaScript & TypeScript — Create electronic invoices for Ecuador (SRI)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",