@beel_es/sdk 1.2.0 → 2.0.0

package/dist/index.js

@@ -43,12 +43,18 @@ __export(index_exports, {
   BeeLNotFoundError: () => BeeLNotFoundError,
   BeeLRateLimitError: () => BeeLRateLimitError,
   BeeLValidationError: () => BeeLValidationError,
+  CatalogsResource: () => CatalogsResource,
   CompanyCustomersResource: () => CompanyCustomersResource,
+  CompanyInvoiceScheduleResource: () => CompanyInvoiceScheduleResource,
   CompanyInvoicesResource: () => CompanyInvoicesResource,
+  CompanyPaymentConnectionsResource: () => CompanyPaymentConnectionsResource,
+  CompanyPaymentEventsResource: () => CompanyPaymentEventsResource,
   CompanyProductsResource: () => CompanyProductsResource,
   CompanyRecurringInvoicesResource: () => CompanyRecurringInvoicesResource,
   CompanyScope: () => CompanyScope,
   CompanySeriesResource: () => CompanySeriesResource,
+  CompanyTaxConfigurationResource: () => CompanyTaxConfigurationResource,
+  CompanyVeriFactuConfigurationResource: () => CompanyVeriFactuConfigurationResource,
   CustomerBuilder: () => CustomerBuilder,
   InvoiceBuilder: () => InvoiceBuilder,
   VeriFactuSubmissionStatus: () => VeriFactuSubmissionStatus,
@@ -483,6 +489,29 @@ var ConfigurationResource = class {
     return data.data;
   }
 };
+var CatalogsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Tax types the API accepts. Canonical form of `configuration/tax-types`. */
+  async taxTypes() {
+    const { data } = await this.client.GET("/v1/tax-types");
+    return data.data;
+  }
+  /** Invoice customization options. Canonical form of the `configuration` read. */
+  async invoiceCustomizationOptions() {
+    const { data } = await this.client.GET("/v1/invoice-customization-options");
+    return data.data;
+  }
+  /**
+   * The signed-in person's preferences. Canonical form of
+   * `PUT /v1/configuration/language`: the language belongs to the person, not to a company.
+   */
+  async updateMe(body) {
+    const { data } = await this.client.PATCH("/v1/me", { body });
+    return data.data;
+  }
+};
 
 // src/resources/series.ts
 var SeriesResource = class {
@@ -558,7 +587,10 @@ var AccountsResource = class {
     const { data } = await this.client.GET("/v1/accounts", { params: { query: params } });
     return data.data;
   }
-  /** Provision a new managed account. */
+  /**
+   * Provision a new managed account. Answers with the provisioning result — the account
+   * id, its status and, when one is issued, the claim link — not with the account summary.
+   */
   async provision(body) {
     const { data } = await this.client.POST("/v1/accounts", { body });
     return data.data;
@@ -779,7 +811,10 @@ var AccountCompaniesResource = class {
     const { data } = await this.client.GET("/v1/accounts/{account_id}/companies", {
       params: { path: { account_id: this.accountId }, query: params }
     });
-    return { companies: data.data ?? [], pagination: data.pagination };
+    return {
+      companies: data.data?.companies ?? [],
+      pagination: data.data?.pagination
+    };
   }
   /** Register a new company (NIF) under the account. */
   async create(body) {
@@ -798,6 +833,134 @@ var AccountCompaniesResource = class {
   }
 };
 
+// src/resources/payment-connections.ts
+var CompanyPaymentConnectionsResource = class {
+  constructor(client, companyId) {
+    this.client = client;
+    this.companyId = companyId;
+  }
+  path() {
+    return { company_id: this.companyId };
+  }
+  /** Every payment connection of this company. */
+  async list() {
+    const { data } = await this.client.GET("/v1/companies/{company_id}/payment-connections", {
+      params: { path: this.path() }
+    });
+    return data.data;
+  }
+  /**
+   * Start an authorization and get the URL where the NIF's holder approves it.
+   *
+   * This is the one place the provider slug is used — currently only `stripe`.
+   */
+  async authorize(body) {
+    const { data } = await this.client.POST(
+      "/v1/companies/{company_id}/payment-connections/authorizations",
+      { params: { path: this.path() }, body }
+    );
+    return data.data;
+  }
+  /** Update one connection, addressed by its UUID. */
+  async update(connectionId, body) {
+    const { data } = await this.client.PATCH(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}",
+      { params: { path: { ...this.path(), connection_id: connectionId } }, body }
+    );
+    return data.data;
+  }
+  /**
+   * Disconnect one connection. Tokens are revoked and auto-invoicing stops;
+   * already-issued invoices are untouched.
+   */
+  async disconnect(connectionId) {
+    await this.client.DELETE("/v1/companies/{company_id}/payment-connections/{connection_id}", {
+      params: { path: { ...this.path(), connection_id: connectionId } }
+    });
+  }
+  /** The payment events of one connection — where you audit what did and didn't invoice. */
+  events(connectionId) {
+    return new CompanyPaymentEventsResource(this.client, this.companyId, connectionId);
+  }
+};
+var CompanyPaymentEventsResource = class {
+  constructor(client, companyId, connectionId) {
+    this.client = client;
+    this.companyId = companyId;
+    this.connectionId = connectionId;
+  }
+  path() {
+    return { company_id: this.companyId, connection_id: this.connectionId };
+  }
+  /**
+   * Events of the connection, most recent first. Nothing is hidden by default:
+   * skipped events, duplicates and disputes are all returned — narrow with the
+   * filters. `charges_only` returns one row per money movement instead.
+   */
+  async list(params) {
+    const { data } = await this.client.GET(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events",
+      { params: { path: this.path(), query: params } }
+    );
+    return data.data;
+  }
+  /** One event. */
+  async get(eventId) {
+    const { data } = await this.client.GET(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}",
+      { params: { path: { ...this.path(), event_id: eventId } } }
+    );
+    return data.data;
+  }
+  /**
+   * Reprocess an event whose automatic invoicing didn't complete, applying the NIF's
+   * **current** configuration. Only retryable states qualify and the retry budget is
+   * finite: otherwise `400`.
+   */
+  async retry(eventId) {
+    const { data } = await this.client.POST(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/retry",
+      { params: { path: { ...this.path(), event_id: eventId } } }
+    );
+    return data.data;
+  }
+  /**
+   * Build a **draft** invoice from an event that couldn't be invoiced automatically,
+   * so you can review it before issuing. Returns the draft's id.
+   */
+  async draft(eventId) {
+    const { data } = await this.client.POST(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/draft",
+      { params: { path: { ...this.path(), event_id: eventId } } }
+    );
+    return data.data;
+  }
+  /** Mark an event as dealt with outside the automatic flow. */
+  async resolve(eventId) {
+    const { data } = await this.client.POST(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/resolve",
+      { params: { path: { ...this.path(), event_id: eventId } } }
+    );
+    return data.data;
+  }
+  /** Discard an event so it stops asking for attention. Reversible with {@link restore}. */
+  async discard(eventId) {
+    const { data } = await this.client.POST(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/discard",
+      { params: { path: { ...this.path(), event_id: eventId } } }
+    );
+    return data.data;
+  }
+  /** Bring a discarded event back into the list. */
+  async restore(eventId) {
+    const { data } = await this.client.POST(
+      "/v1/companies/{company_id}/payment-connections/{connection_id}/events/{event_id}/restore",
+      { params: { path: { ...this.path(), event_id: eventId } } }
+    );
+    return data.data;
+  }
+};
+
 // src/resources/company.ts
 var CompanyScope = class {
   constructor(client, companyId) {
@@ -808,6 +971,9 @@ var CompanyScope = class {
     this.products = new CompanyProductsResource(client, companyId);
     this.series = new CompanySeriesResource(client, companyId);
     this.recurringInvoices = new CompanyRecurringInvoicesResource(client, companyId);
+    this.paymentConnections = new CompanyPaymentConnectionsResource(client, companyId);
+    this.taxConfiguration = new CompanyTaxConfigurationResource(client, companyId);
+    this.verifactuConfiguration = new CompanyVeriFactuConfigurationResource(client, companyId);
   }
   path() {
     return { company_id: this.companyId };
@@ -850,6 +1016,17 @@ var CompanyInvoicesResource = class {
   constructor(client, companyId) {
     this.client = client;
     this.companyId = companyId;
+    this.schedule = new CompanyInvoiceScheduleResource(client, companyId);
+  }
+  /**
+   * Derive a new invoice from an existing one — the canonical form of `duplicate`.
+   */
+  async derive(body) {
+    const { data } = await this.client.POST("/v1/companies/{company_id}/invoices/derivations", {
+      params: { path: { company_id: this.companyId } },
+      body
+    });
+    return data.data;
   }
   path(rest) {
     return { company_id: this.companyId, ...rest };
@@ -918,6 +1095,37 @@ var CompanyInvoicesResource = class {
     });
     return data.data;
   }
+  /**
+   * Issue a full invoice in exchange for one or more issued simplified invoices, when the
+   * customer asks for an invoice with their details. It is not a corrective: the simplified
+   * invoices become `VOIDED` with `void_cause: 'EXCHANGED'`, and the new `STANDARD` invoice
+   * lists them in `replaced_invoice_ids`.
+   *
+   * @example
+   * ```typescript
+   * const invoice = await company.invoices.createSimplifiedExchange({
+   *   simplified_invoice_ids: ['simplified-uuid'],
+   *   recipient: { customer_id: 'customer-uuid' },
+   * });
+   * ```
+   */
+  async createSimplifiedExchange(body) {
+    const { data } = await this.client.POST("/v1/companies/{company_id}/invoices/simplified-exchanges", {
+      params: { path: this.path() },
+      body
+    });
+    return data.data;
+  }
+  /**
+   * The VeriFactu records of an invoice, oldest first: its registration and, if it was
+   * voided, its cancellation. An invoice never submitted answers with an empty list.
+   */
+  async verifactuRecords(invoiceId) {
+    const { data } = await this.client.GET("/v1/companies/{company_id}/invoices/{invoice_id}/verifactu-records", {
+      params: { path: this.path({ invoice_id: invoiceId }) }
+    });
+    return data.data.records;
+  }
   /** Update payment status (e.g. mark as paid). */
   async setStatus(invoiceId, body) {
     const { data } = await this.client.PUT("/v1/companies/{company_id}/invoices/{invoice_id}/status", {
@@ -942,6 +1150,36 @@ var CompanyInvoicesResource = class {
     return data.data;
   }
 };
+var CompanyInvoiceScheduleResource = class {
+  constructor(client, companyId) {
+    this.client = client;
+    this.companyId = companyId;
+  }
+  async get(invoiceId) {
+    const { data } = await this.client.GET(
+      "/v1/companies/{company_id}/invoices/{invoice_id}/schedule",
+      { params: { path: { company_id: this.companyId, invoice_id: invoiceId } } }
+    );
+    return data.data;
+  }
+  /**
+   * Set or move the schedule. One `PUT` replaces the three legacy calls
+   * (`schedule`, `reschedule`, `unschedule`): setting it again moves it.
+   */
+  async set(invoiceId, body) {
+    const { data } = await this.client.PUT(
+      "/v1/companies/{company_id}/invoices/{invoice_id}/schedule",
+      { params: { path: { company_id: this.companyId, invoice_id: invoiceId } }, body }
+    );
+    return data.data;
+  }
+  /** Clear the schedule — the canonical form of `unschedule`. */
+  async clear(invoiceId) {
+    await this.client.DELETE("/v1/companies/{company_id}/invoices/{invoice_id}/schedule", {
+      params: { path: { company_id: this.companyId, invoice_id: invoiceId } }
+    });
+  }
+};
 var CompanyCustomersResource = class {
   constructor(client, companyId) {
     this.client = client;
@@ -1149,16 +1387,57 @@ var CompanyRecurringInvoicesResource = class {
     return data.data;
   }
 };
+var CompanyTaxConfigurationResource = class {
+  constructor(client, companyId) {
+    this.client = client;
+    this.companyId = companyId;
+  }
+  async get() {
+    const { data } = await this.client.GET("/v1/companies/{company_id}/tax-configuration", {
+      params: { path: { company_id: this.companyId } }
+    });
+    return data.data;
+  }
+  /** Replaces the whole state — this is a `PUT`, not a merge. */
+  async update(body) {
+    const { data } = await this.client.PUT("/v1/companies/{company_id}/tax-configuration", {
+      params: { path: { company_id: this.companyId } },
+      body
+    });
+    return data.data;
+  }
+};
+var CompanyVeriFactuConfigurationResource = class {
+  constructor(client, companyId) {
+    this.client = client;
+    this.companyId = companyId;
+  }
+  async get() {
+    const { data } = await this.client.GET("/v1/companies/{company_id}/verifactu-configuration", {
+      params: { path: { company_id: this.companyId } }
+    });
+    return data.data;
+  }
+  /** Flip VeriFactu for this NIF. `enabled` is the only field you can write. */
+  async update(body) {
+    const { data } = await this.client.PUT("/v1/companies/{company_id}/verifactu-configuration", {
+      params: { path: { company_id: this.companyId } },
+      body
+    });
+    return data.data;
+  }
+};
 
 // src/client.ts
 var BeeL = class {
   constructor(config) {
     const client = createBeeLClient(config);
-    this._client = client;
+    this.raw = client;
     this.invoices = new InvoicesResource(client);
     this.customers = new CustomersResource(client);
     this.products = new ProductsResource(client);
     this.configuration = new ConfigurationResource(client);
+    this.catalogs = new CatalogsResource(client);
     this.series = new SeriesResource(client);
     this.nif = new NifResource(client);
     this.accounts = new AccountsResource(client);
@@ -1174,7 +1453,7 @@ var BeeL = class {
    * ```
    */
   company(companyId) {
-    return new CompanyScope(this._client, companyId);
+    return new CompanyScope(this.raw, companyId);
   }
   /**
    * Returns a facade scoped to one managed account — members, invitations,
@@ -1187,7 +1466,7 @@ var BeeL = class {
    * ```
    */
   account(accountId) {
-    return new AccountScope(this._client, accountId);
+    return new AccountScope(this.raw, accountId);
   }
   /**
    * Download an invoice PDF as a Buffer.
@@ -1239,6 +1518,7 @@ var WebhookVerifier = class {
    * const verifier = new WebhookVerifier('your_secret');
    * const event = verifier.verify(rawBody, signature);
    * 
+   * if (event.test) return; // a "Send test" delivery carries a synthetic `data`
    * if (event.type === 'verifactu.status.updated') {
    *   console.log('Invoice:', event.data.invoice_number);
    *   console.log('Status:', event.data.new_status);
@@ -1362,6 +1642,24 @@ var InvoiceIssuedEvent;
   })(type = InvoiceIssuedEvent2.type || (InvoiceIssuedEvent2.type = {}));
 })(InvoiceIssuedEvent || (InvoiceIssuedEvent = {}));
 
+// src/generated-webhooks/models/InvoicePdfGeneratedEvent.ts
+var InvoicePdfGeneratedEvent;
+((InvoicePdfGeneratedEvent2) => {
+  let type;
+  ((type2) => {
+    type2["INVOICE_PDF_GENERATED"] = "invoice.pdf.generated";
+  })(type = InvoicePdfGeneratedEvent2.type || (InvoicePdfGeneratedEvent2.type = {}));
+})(InvoicePdfGeneratedEvent || (InvoicePdfGeneratedEvent = {}));
+
+// src/generated-webhooks/models/InvoiceScheduleFailedEvent.ts
+var InvoiceScheduleFailedEvent;
+((InvoiceScheduleFailedEvent2) => {
+  let type;
+  ((type2) => {
+    type2["INVOICE_SCHEDULE_FAILED"] = "invoice.schedule_failed";
+  })(type = InvoiceScheduleFailedEvent2.type || (InvoiceScheduleFailedEvent2.type = {}));
+})(InvoiceScheduleFailedEvent || (InvoiceScheduleFailedEvent = {}));
+
 // src/generated-webhooks/models/InvoiceVoidedEvent.ts
 var InvoiceVoidedEvent;
 ((InvoiceVoidedEvent2) => {
@@ -1412,8 +1710,10 @@ var WebhookEventType = /* @__PURE__ */ ((WebhookEventType2) => {
   WebhookEventType2["VERIFACTU_STATUS_UPDATED"] = "verifactu.status.updated";
   WebhookEventType2["INVOICE_ISSUED"] = "invoice.issued";
   WebhookEventType2["INVOICE_EMAIL_SENT"] = "invoice.email.sent";
+  WebhookEventType2["INVOICE_PDF_GENERATED"] = "invoice.pdf.generated";
   WebhookEventType2["INVOICE_VOIDED"] = "invoice.voided";
   WebhookEventType2["RECURRING_INVOICE_PAUSED"] = "recurring_invoice.paused";
+  WebhookEventType2["INVOICE_SCHEDULE_FAILED"] = "invoice.schedule_failed";
   WebhookEventType2["ACCOUNT_CLAIMED"] = "account.claimed";
   WebhookEventType2["COMPANY_CREATED"] = "company.created";
   WebhookEventType2["REPRESENTATION_SIGNED"] = "representation.signed";
@@ -1542,12 +1842,18 @@ var InvoiceBuilder = class _InvoiceBuilder {
   BeeLNotFoundError,
   BeeLRateLimitError,
   BeeLValidationError,
+  CatalogsResource,
   CompanyCustomersResource,
+  CompanyInvoiceScheduleResource,
   CompanyInvoicesResource,
+  CompanyPaymentConnectionsResource,
+  CompanyPaymentEventsResource,
   CompanyProductsResource,
   CompanyRecurringInvoicesResource,
   CompanyScope,
   CompanySeriesResource,
+  CompanyTaxConfigurationResource,
+  CompanyVeriFactuConfigurationResource,
   CustomerBuilder,
   InvoiceBuilder,
   VeriFactuSubmissionStatus,