@beel_es/sdk 1.2.0 → 1.3.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 {
@@ -779,7 +808,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 +830,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 +968,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 +1013,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 };
@@ -942,6 +1116,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 +1353,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 +1419,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 +1432,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.
@@ -1542,12 +1787,18 @@ var InvoiceBuilder = class _InvoiceBuilder {
   BeeLNotFoundError,
   BeeLRateLimitError,
   BeeLValidationError,
+  CatalogsResource,
   CompanyCustomersResource,
+  CompanyInvoiceScheduleResource,
   CompanyInvoicesResource,
+  CompanyPaymentConnectionsResource,
+  CompanyPaymentEventsResource,
   CompanyProductsResource,
   CompanyRecurringInvoicesResource,
   CompanyScope,
   CompanySeriesResource,
+  CompanyTaxConfigurationResource,
+  CompanyVeriFactuConfigurationResource,
   CustomerBuilder,
   InvoiceBuilder,
   VeriFactuSubmissionStatus,