@pimia/sdk 0.4.0 → 0.6.0

package/dist/client.d.ts

@@ -112,6 +112,19 @@ export interface ResponseWithMeta<T> {
 }
 /** Lo que se puede afinar en una escritura (`post`/`put`/`patch`). */
 export type WriteOptions = Pick<RequestOptions, 'headers' | 'query' | 'signal' | 'idempotencyKey'>;
+/**
+ * Lo que se puede afinar en una lectura (`get`/`delete` y los atajos de
+ * recurso).
+ *
+ * Sin `idempotencyKey`, que no significa nada en una lectura, y sin `query`,
+ * que en `get()` ya es un parámetro propio.
+ *
+ * Existe sobre todo por `signal`: hasta la 0.4 los atajos de lectura no
+ * aceptaban opciones, así que ponerle un timeout a un GET obligaba a bajar a
+ * `request()` — o a quedarse sin él, que es lo que pasa de verdad. Un cliente
+ * que sondea y se cuelga en una lectura deja de sondear sin dar un solo error.
+ */
+export type ReadOptions = Pick<RequestOptions, 'headers' | 'signal'>;
 export declare class PimiaClient {
     readonly oauth: OAuth;
     private readonly baseUrl;
@@ -128,13 +141,18 @@ export declare class PimiaClient {
     /** Cabeceras `X-RateLimit-*` de la última respuesta. */
     get rateLimit(): RateLimit;
     get invoices(): {
-        list: (query?: RequestOptions["query"]) => Promise<{
+        list: (query?: RequestOptions["query"], options?: ReadOptions) => Promise<{
             data: components["schemas"]["InvoiceResource"][];
             meta: {
                 invoice_total_count: number;
             };
+        } | {
+            data: components["schemas"]["InvoiceSummaryResource"][];
+            meta: {
+                invoice_total_count: number;
+            };
         }>;
-        get: (id: number | string) => Promise<{
+        get: (id: number | string, options?: ReadOptions) => Promise<{
             data: components["schemas"]["InvoiceResource"] & Record<string, never>;
         }>;
         /**
@@ -142,185 +160,192 @@ export declare class PimiaClient {
          * `200` de `invoices.store` está vacío ahí (ver {@link ResourceEnvelope}).
          */
         create: (body: InvoicesRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
-            id: string;
+            id: number;
             invoice_date: string;
-            due_date: string;
-            invoice_number: string;
+            due_date: string | null;
+            invoice_number: string | null;
             reference_number: string;
             status: string;
             paid_status: string;
             tax_per_item: string;
             tax_included: string;
             discount_per_item: string;
-            notes: string;
-            discount_type: string;
-            discount: string;
-            discount_val: string;
-            sub_total: string;
-            total: string;
+            notes: string | null;
+            discount_type: string | null;
+            discount: number;
+            discount_val: number;
+            sub_total: number;
+            total: number;
             effective_total: string;
-            tax: string;
+            tax: number;
             due_amount: string;
             effective_due_amount: string;
             sent: string;
             viewed: string;
-            unique_hash: string;
-            template_name: string;
+            sent_at: string;
+            viewed_at: string;
+            unique_hash: string | null;
+            template_name: string | null;
             invoice_series_id: string;
-            customer_id: string;
+            customer_id: number | null;
             external_ref: string | null;
             payment_method_id: string;
             recurring_invoice_id: string;
-            sequence_number: string;
-            exchange_rate: string;
-            base_discount_val: string;
-            base_sub_total: string;
-            base_total: string;
-            creator_id: string;
-            base_tax: string;
-            base_due_amount: string;
+            sequence_number: number | null;
+            exchange_rate: number | null;
+            base_discount_val: string | null;
+            base_sub_total: string | null;
+            base_total: string | null;
+            creator_id: number | null;
+            base_tax: string | null;
+            base_due_amount: string | null;
             effective_base_total: string;
             effective_base_due_amount: string;
             credited_total: string;
             credited_base_total: string;
-            currency_id: string;
+            currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;
             formatted_invoice_date: string;
             formatted_due_date: string;
             allow_edit: string;
             payment_module_enabled: string;
-            sales_tax_type: string;
-            sales_tax_address_type: string;
             overdue: string;
             effective_paid_status: string;
             effective_overdue: string;
             aeat_status: string;
-            qr_data: string;
-            hash: string;
-            aeat_csv: string;
-            is_credit_note: string | boolean;
-            rectified_invoice_id: string;
+            qr_data: string | null;
+            hash: string | null;
+            aeat_csv: string | null;
+            is_credit_note: boolean;
+            rectified_invoice_id: number | null;
             rectified_invoice_number?: string | null;
             rectified_invoice?: {
-                id: string;
-                invoice_number: string;
+                id: number;
+                invoice_number: string | null;
                 tax_per_item: string;
                 tax_included: string;
-                sub_total: string;
-                discount_val: string;
-                tax: string;
-                total: string;
+                sub_total: number;
+                discount_val: number;
+                tax: number;
+                total: number;
                 items: components["schemas"]["InvoiceItemResource"][];
                 taxes: components["schemas"]["TaxResource"][];
             };
-            credit_notes_count: number;
+            credit_notes_count: string | number;
             items?: components["schemas"]["InvoiceItemResource"][];
             payments?: components["schemas"]["PaymentResource"][];
-            customer?: components["schemas"]["CustomerResource"];
+            email_logs?: components["schemas"]["EmailLogResource"][];
+            customer?: components["schemas"]["CustomerResource"] | null;
             invoice_series?: components["schemas"]["InvoiceSeriesResource"];
             payment_method?: components["schemas"]["PaymentMethodResource"];
-            creator?: components["schemas"]["UserResource"];
+            creator?: components["schemas"]["UserResource"] | null;
             taxes: components["schemas"]["TaxResource"][];
             fields?: components["schemas"]["CustomFieldValueResource"][];
-            company?: components["schemas"]["CompanyResource"];
-            currency?: components["schemas"]["CurrencyResource"];
+            company?: components["schemas"]["CompanyResource"] | null;
+            currency?: components["schemas"]["CurrencyResource"] | null;
         }>>;
         /** Mismo caso que `create`: el `200` de `invoices.update` no está tipado en el spec. */
         update: (id: number | string, body: InvoicesRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
-            id: string;
+            id: number;
             invoice_date: string;
-            due_date: string;
-            invoice_number: string;
+            due_date: string | null;
+            invoice_number: string | null;
             reference_number: string;
             status: string;
             paid_status: string;
             tax_per_item: string;
             tax_included: string;
             discount_per_item: string;
-            notes: string;
-            discount_type: string;
-            discount: string;
-            discount_val: string;
-            sub_total: string;
-            total: string;
+            notes: string | null;
+            discount_type: string | null;
+            discount: number;
+            discount_val: number;
+            sub_total: number;
+            total: number;
             effective_total: string;
-            tax: string;
+            tax: number;
             due_amount: string;
             effective_due_amount: string;
             sent: string;
             viewed: string;
-            unique_hash: string;
-            template_name: string;
+            sent_at: string;
+            viewed_at: string;
+            unique_hash: string | null;
+            template_name: string | null;
             invoice_series_id: string;
-            customer_id: string;
+            customer_id: number | null;
             external_ref: string | null;
             payment_method_id: string;
             recurring_invoice_id: string;
-            sequence_number: string;
-            exchange_rate: string;
-            base_discount_val: string;
-            base_sub_total: string;
-            base_total: string;
-            creator_id: string;
-            base_tax: string;
-            base_due_amount: string;
+            sequence_number: number | null;
+            exchange_rate: number | null;
+            base_discount_val: string | null;
+            base_sub_total: string | null;
+            base_total: string | null;
+            creator_id: number | null;
+            base_tax: string | null;
+            base_due_amount: string | null;
             effective_base_total: string;
             effective_base_due_amount: string;
             credited_total: string;
             credited_base_total: string;
-            currency_id: string;
+            currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;
             formatted_invoice_date: string;
             formatted_due_date: string;
             allow_edit: string;
             payment_module_enabled: string;
-            sales_tax_type: string;
-            sales_tax_address_type: string;
             overdue: string;
             effective_paid_status: string;
             effective_overdue: string;
             aeat_status: string;
-            qr_data: string;
-            hash: string;
-            aeat_csv: string;
-            is_credit_note: string | boolean;
-            rectified_invoice_id: string;
+            qr_data: string | null;
+            hash: string | null;
+            aeat_csv: string | null;
+            is_credit_note: boolean;
+            rectified_invoice_id: number | null;
             rectified_invoice_number?: string | null;
             rectified_invoice?: {
-                id: string;
-                invoice_number: string;
+                id: number;
+                invoice_number: string | null;
                 tax_per_item: string;
                 tax_included: string;
-                sub_total: string;
-                discount_val: string;
-                tax: string;
-                total: string;
+                sub_total: number;
+                discount_val: number;
+                tax: number;
+                total: number;
                 items: components["schemas"]["InvoiceItemResource"][];
                 taxes: components["schemas"]["TaxResource"][];
             };
-            credit_notes_count: number;
+            credit_notes_count: string | number;
             items?: components["schemas"]["InvoiceItemResource"][];
             payments?: components["schemas"]["PaymentResource"][];
-            customer?: components["schemas"]["CustomerResource"];
+            email_logs?: components["schemas"]["EmailLogResource"][];
+            customer?: components["schemas"]["CustomerResource"] | null;
             invoice_series?: components["schemas"]["InvoiceSeriesResource"];
             payment_method?: components["schemas"]["PaymentMethodResource"];
-            creator?: components["schemas"]["UserResource"];
+            creator?: components["schemas"]["UserResource"] | null;
             taxes: components["schemas"]["TaxResource"][];
             fields?: components["schemas"]["CustomFieldValueResource"][];
-            company?: components["schemas"]["CompanyResource"];
-            currency?: components["schemas"]["CurrencyResource"];
+            company?: components["schemas"]["CompanyResource"] | null;
+            currency?: components["schemas"]["CurrencyResource"] | null;
         }>>;
     };
     get customers(): {
-        list: (query?: RequestOptions["query"]) => Promise<{
+        list: (query?: RequestOptions["query"], options?: ReadOptions) => Promise<{
             data: components["schemas"]["CustomerResource"][];
             meta: {
                 customer_total_count: number;
             };
+        } | {
+            data: components["schemas"]["CustomerSummaryResource"][];
+            meta: {
+                customer_total_count: number;
+            };
         }>;
-        get: (id: number | string) => Promise<{
+        get: (id: number | string, options?: ReadOptions) => Promise<{
             data: components["schemas"]["CustomerResource"];
         }>;
         create: (body: CustomerRequest, options?: WriteOptions) => Promise<{
@@ -328,52 +353,53 @@ export declare class PimiaClient {
         }>;
         /** El `200` de `customers.update` no está tipado en el spec. */
         update: (id: number | string, body: CustomerRequest, options?: WriteOptions) => Promise<ResourceEnvelope<{
-            id: string;
+            id: number;
             name: string;
-            email: string;
-            phone: string;
-            contact_name: string;
-            company_name: string;
-            website: string;
-            enable_portal: string;
+            email: string | null;
+            phone: string | null;
+            contact_name: string | null;
+            website: string | null;
+            enable_portal: boolean;
             password_added: boolean;
-            currency_id: string;
+            currency_id: number | null;
             payment_method_id: string;
-            company_id: string;
-            facebook_id: string;
-            google_id: string;
-            github_id: string;
-            created_at: string;
+            company_id: number | null;
+            created_at: string | null;
             formatted_created_at: string;
-            updated_at: string;
+            updated_at: string | null;
             avatar: string;
             due_amount: string;
             base_due_amount: string;
-            prefix: string;
+            prefix: string | null;
             tax_id: string;
             notes: string;
             external_ref: string | null;
-            iban: string;
-            bic: string;
-            sepa_mandate_id: string;
-            sepa_mandate_date: string;
-            billing?: components["schemas"]["AddressResource"];
-            shipping?: components["schemas"]["AddressResource"];
+            iban: string | null;
+            bic: string | null;
+            sepa_mandate_id: string | null;
+            sepa_mandate_date: string | null;
+            billing?: components["schemas"]["AddressResource"] | null;
+            shipping?: components["schemas"]["AddressResource"] | null;
             fields?: components["schemas"]["CustomFieldValueResource"][];
-            company?: components["schemas"]["CompanyResource"];
-            currency?: components["schemas"]["CurrencyResource"];
+            company?: components["schemas"]["CompanyResource"] | null;
+            currency?: components["schemas"]["CurrencyResource"] | null;
             payment_method?: components["schemas"]["PaymentMethodResource"];
         }>>;
     };
     get estimates(): {
-        list: (query?: RequestOptions["query"]) => Promise<{
+        list: (query?: RequestOptions["query"], options?: ReadOptions) => Promise<{
             data: components["schemas"]["EstimateResource"][];
             meta: {
                 estimate_total_count: number;
             };
+        } | {
+            data: components["schemas"]["EstimateSummaryResource"][];
+            meta: {
+                estimate_total_count: number;
+            };
         }>;
-        get: (id: number | string) => Promise<{
-            data: components["schemas"]["EstimateResource"];
+        get: (id: number | string, options?: ReadOptions) => Promise<{
+            data: components["schemas"]["EstimateResource"] & Record<string, never>;
         }>;
         create: (body: EstimatesRequest, options?: WriteOptions) => Promise<{
             data: components["schemas"]["EstimateResource"];
@@ -396,99 +422,115 @@ export declare class PimiaClient {
          * `estimate:{id}:invoice`— y el reintento tras un timeout no te creará
          * una segunda factura.
          *
+         * Y manda `externalRef` si la venta nació en tu sistema: es lo que hace
+         * que `invoice.created` e `invoice.paid` te lleguen con tu referencia en
+         * vez de con `null`. **Tiene que ir aquí, en la conversión**; etiquetar
+         * después con `PUT /invoices/{id}` llega tarde por dos motivos: para
+         * entonces `invoice.created` ya salió con la referencia nula, y entre las
+         * dos llamadas hay una ventana en la que la factura existe y no la
+         * encuentras por tu referencia.
+         *
+         * Va como opción y no como segundo parámetro para no romperle la llamada
+         * a quien ya hace `convertToInvoice(id, { idempotencyKey })`: el cuerpo lo
+         * monta el atajo, y `external_ref` es además el único campo que el
+         * endpoint acepta.
+         *
          * Exige `estimates:write` **e** `invoices:write`.
          */
-        convertToInvoice: (id: number | string, options?: WriteOptions) => Promise<ResourceEnvelope<{
-            id: string;
+        convertToInvoice: (id: number | string, options?: WriteOptions & {
+            externalRef?: string | null;
+        }) => Promise<ResourceEnvelope<{
+            id: number;
             invoice_date: string;
-            due_date: string;
-            invoice_number: string;
+            due_date: string | null;
+            invoice_number: string | null;
             reference_number: string;
             status: string;
             paid_status: string;
             tax_per_item: string;
             tax_included: string;
             discount_per_item: string;
-            notes: string;
-            discount_type: string;
-            discount: string;
-            discount_val: string;
-            sub_total: string;
-            total: string;
+            notes: string | null;
+            discount_type: string | null;
+            discount: number;
+            discount_val: number;
+            sub_total: number;
+            total: number;
             effective_total: string;
-            tax: string;
+            tax: number;
             due_amount: string;
             effective_due_amount: string;
             sent: string;
             viewed: string;
-            unique_hash: string;
-            template_name: string;
+            sent_at: string;
+            viewed_at: string;
+            unique_hash: string | null;
+            template_name: string | null;
             invoice_series_id: string;
-            customer_id: string;
+            customer_id: number | null;
             external_ref: string | null;
             payment_method_id: string;
             recurring_invoice_id: string;
-            sequence_number: string;
-            exchange_rate: string;
-            base_discount_val: string;
-            base_sub_total: string;
-            base_total: string;
-            creator_id: string;
-            base_tax: string;
-            base_due_amount: string;
+            sequence_number: number | null;
+            exchange_rate: number | null;
+            base_discount_val: string | null;
+            base_sub_total: string | null;
+            base_total: string | null;
+            creator_id: number | null;
+            base_tax: string | null;
+            base_due_amount: string | null;
             effective_base_total: string;
             effective_base_due_amount: string;
             credited_total: string;
             credited_base_total: string;
-            currency_id: string;
+            currency_id: number | null;
             formatted_created_at: string;
             invoice_pdf_url: string;
             formatted_invoice_date: string;
             formatted_due_date: string;
             allow_edit: string;
             payment_module_enabled: string;
-            sales_tax_type: string;
-            sales_tax_address_type: string;
             overdue: string;
             effective_paid_status: string;
             effective_overdue: string;
             aeat_status: string;
-            qr_data: string;
-            hash: string;
-            aeat_csv: string;
-            is_credit_note: string | boolean;
-            rectified_invoice_id: string;
+            qr_data: string | null;
+            hash: string | null;
+            aeat_csv: string | null;
+            is_credit_note: boolean;
+            rectified_invoice_id: number | null;
             rectified_invoice_number?: string | null;
             rectified_invoice?: {
-                id: string;
-                invoice_number: string;
+                id: number;
+                invoice_number: string | null;
                 tax_per_item: string;
                 tax_included: string;
-                sub_total: string;
-                discount_val: string;
-                tax: string;
-                total: string;
+                sub_total: number;
+                discount_val: number;
+                tax: number;
+                total: number;
                 items: components["schemas"]["InvoiceItemResource"][];
                 taxes: components["schemas"]["TaxResource"][];
             };
-            credit_notes_count: number;
+            credit_notes_count: string | number;
             items?: components["schemas"]["InvoiceItemResource"][];
             payments?: components["schemas"]["PaymentResource"][];
-            customer?: components["schemas"]["CustomerResource"];
+            email_logs?: components["schemas"]["EmailLogResource"][];
+            customer?: components["schemas"]["CustomerResource"] | null;
             invoice_series?: components["schemas"]["InvoiceSeriesResource"];
             payment_method?: components["schemas"]["PaymentMethodResource"];
-            creator?: components["schemas"]["UserResource"];
+            creator?: components["schemas"]["UserResource"] | null;
             taxes: components["schemas"]["TaxResource"][];
             fields?: components["schemas"]["CustomFieldValueResource"][];
-            company?: components["schemas"]["CompanyResource"];
-            currency?: components["schemas"]["CurrencyResource"];
+            company?: components["schemas"]["CompanyResource"] | null;
+            currency?: components["schemas"]["CurrencyResource"] | null;
         }>>;
     };
-    get<T = unknown>(path: string, query?: RequestOptions['query']): Promise<T>;
+    get<T = unknown>(path: string, query?: RequestOptions['query'], options?: ReadOptions): Promise<T>;
     post<T = unknown>(path: string, body?: unknown, options?: WriteOptions): Promise<T>;
     put<T = unknown>(path: string, body?: unknown, options?: WriteOptions): Promise<T>;
     patch<T = unknown>(path: string, body?: unknown, options?: WriteOptions): Promise<T>;
-    delete<T = unknown>(path: string): Promise<T>;
+    delete<T = unknown>(path: string, options?: ReadOptions): Promise<T>;
     /**
      * Petición cruda contra `/api/v1`. `path` puede llevar el prefijo o no:
      * `/invoices` y `/api/v1/invoices` son lo mismo.

package/dist/client.js

@@ -44,8 +44,8 @@ export class PimiaClient {
     }
     get invoices() {
         return {
-            list: (query) => this.get('/invoices', query),
-            get: (id) => this.get(`/invoices/${id}`),
+            list: (query, options) => this.get('/invoices', query, options),
+            get: (id, options) => this.get(`/invoices/${id}`, undefined, options),
             /**
              * Devuelve `{ data: InvoiceResource }`. El tipo NO sale del spec: el
              * `200` de `invoices.store` está vacío ahí (ver {@link ResourceEnvelope}).
@@ -57,8 +57,8 @@ export class PimiaClient {
     }
     get customers() {
         return {
-            list: (query) => this.get('/customers', query),
-            get: (id) => this.get(`/customers/${id}`),
+            list: (query, options) => this.get('/customers', query, options),
+            get: (id, options) => this.get(`/customers/${id}`, undefined, options),
             create: (body, options) => this.post('/customers', body, options),
             /** El `200` de `customers.update` no está tipado en el spec. */
             update: (id, body, options) => this.put(`/customers/${id}`, body, options),
@@ -66,8 +66,8 @@ export class PimiaClient {
     }
     get estimates() {
         return {
-            list: (query) => this.get('/estimates', query),
-            get: (id) => this.get(`/estimates/${id}`),
+            list: (query, options) => this.get('/estimates', query, options),
+            get: (id, options) => this.get(`/estimates/${id}`, undefined, options),
             create: (body, options) => this.post('/estimates', body, options),
             /**
              * Convierte un presupuesto aceptado en factura.
@@ -87,13 +87,33 @@ export class PimiaClient {
              * `estimate:{id}:invoice`— y el reintento tras un timeout no te creará
              * una segunda factura.
              *
+             * Y manda `externalRef` si la venta nació en tu sistema: es lo que hace
+             * que `invoice.created` e `invoice.paid` te lleguen con tu referencia en
+             * vez de con `null`. **Tiene que ir aquí, en la conversión**; etiquetar
+             * después con `PUT /invoices/{id}` llega tarde por dos motivos: para
+             * entonces `invoice.created` ya salió con la referencia nula, y entre las
+             * dos llamadas hay una ventana en la que la factura existe y no la
+             * encuentras por tu referencia.
+             *
+             * Va como opción y no como segundo parámetro para no romperle la llamada
+             * a quien ya hace `convertToInvoice(id, { idempotencyKey })`: el cuerpo lo
+             * monta el atajo, y `external_ref` es además el único campo que el
+             * endpoint acepta.
+             *
              * Exige `estimates:write` **e** `invoices:write`.
              */
-            convertToInvoice: (id, options) => this.post(`/estimates/${id}/convert-to-invoice`, {}, options),
+            convertToInvoice: (id, options) => {
+                const { externalRef, ...resto } = options ?? {};
+                return this.post(`/estimates/${id}/convert-to-invoice`, 
+                // Cuerpo vacío si no se pide, y no `external_ref: null`: mandar el
+                // null explícito DESVINCULA la referencia, que no es lo mismo que no
+                // tocarla.
+                externalRef === undefined ? {} : { external_ref: externalRef }, resto);
+            },
         };
     }
-    get(path, query) {
-        return this.request(path, { method: 'GET', query });
+    get(path, query, options) {
+        return this.request(path, { ...options, method: 'GET', query });
     }
     post(path, body, options) {
         return this.request(path, { ...options, method: 'POST', body });
@@ -104,8 +124,8 @@ export class PimiaClient {
     patch(path, body, options) {
         return this.request(path, { ...options, method: 'PATCH', body });
     }
-    delete(path) {
-        return this.request(path, { method: 'DELETE' });
+    delete(path, options) {
+        return this.request(path, { ...options, method: 'DELETE' });
     }
     /**
      * Petición cruda contra `/api/v1`. `path` puede llevar el prefijo o no:

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * salen los tipos de `./api`.
  */
 export { PimiaClient } from './client.js';
-export type { CustomerRequest, CustomerResource, EstimateResource, EstimatesRequest, InvoiceResource, InvoicesRequest, PimiaClientOptions, RateLimit, RequestOptions, ResourceEnvelope, ResponseMeta, ResponseWithMeta, WriteOptions, } from './client.js';
+export type { CustomerRequest, CustomerResource, EstimateResource, EstimatesRequest, InvoiceResource, InvoicesRequest, PimiaClientOptions, RateLimit, ReadOptions, RequestOptions, ResourceEnvelope, ResponseMeta, ResponseWithMeta, WriteOptions, } from './client.js';
 export { OAuth, createPkceChallenge, createState } from './oauth.js';
 export type { AuthorizationServerMetadata, AuthorizeUrlOptions, OAuthConfig, PkceChallenge, } from './oauth.js';
 export { MemoryTokenStore, isExpired, tokenSetFromResponse } from './tokens.js';
@@ -35,6 +35,16 @@ export declare const SCOPES: {
     readonly agendaRead: "agenda:read";
     readonly agendaWrite: "agenda:write";
     readonly reportsRead: "reports:read";
+    /** Leer la configuración de la empresa (impuestos, preferencias, series). */
+    readonly settingsRead: "settings:read";
+    /** Ver la tienda de módulos y qué tiene contratado el tenant. */
+    readonly storeRead: "store:read";
+    /** Leer la gestión de personal: empleados, ausencias, fichajes, calendarios. */
+    readonly hrRead: "hr:read";
+    /** Gestionar el personal: altas, ausencias, correcciones de fichaje, horarios. */
+    readonly hrWrite: "hr:write";
+    /** Gestionar los avisos (webhooks) que recibe tu app. */
+    readonly webhooksWrite: "webhooks:write";
     /**
      * Proponer cambios que el dueño del tenant aprueba antes de aplicarse.
      * `approvalsSubmit` es un alias del mismo permiso, aceptado por el