sinfactura-types 1.10.183 → 1.10.185

package/dist/account.d.ts

@@ -74,6 +74,24 @@ declare global {
          * `currencyValue` alone until an Account writer exists.
          */
         currencyValueAt?: number;
+        /**
+         * How the money arrived, for a POS-originated movement — the SAME fixed
+         * vocabulary as {@link OrderTender.source}, deliberately coarser than
+         * `method` so a reader can branch without knowing the tenant's method
+         * table.
+         *
+         * Absent on a manual account entry, which is every row written to date.
+         * Absence is what keeps the free-text `subject` fallback correct for
+         * those rows; it does NOT mean cash.
+         */
+        source?: 'cash' | 'card' | 'qr' | 'transfer' | 'account' | 'other';
+        /**
+         * FK to a `Store.paymentMethods` entry's `id`, resolved at write time and
+         * frozen here — same semantics as {@link OrderTender.method}. The tenant
+         * may rename, reorder or remove that method afterwards; the row keeps the
+         * id it was written under, so do not read it as a live pointer.
+         */
+        method?: number;
         balance?: number;
         userId?: string;
         deleted?: boolean;

package/dist/cjs/socket.js

@@ -179,6 +179,10 @@ exports.SOCKET_ACTIONS = [
     // ⚠️ A frame for a period whose `periodStatus` is `'OPEN'` carries numbers
     // ML will still restate; a consumer must not render one as final.
     'mercadolibre_settlement_period',
+    // BE → all store users when an EMPRESA custom domain's provisioning state
+    // moves (`CustomDomainSocketPayload`). Status only: the row's
+    // `verificationToken` is an ownership credential and is never re-sent here.
+    'customDomain',
 ];
 /** Runtime guard — narrows an untrusted string to a known action. */
 const isSocketAction = (value) => typeof value === 'string' && exports.SOCKET_ACTIONS.includes(value);

package/dist/print.d.ts

@@ -45,6 +45,19 @@ declare global {
         paper?: string;
         rotate?: 0 | 90 | 180 | 270;
     }
+    /**
+     * Who caused a print-job transition. `fullName` is denormalized at write
+     * time, matching `OrderAuditActor` — a timeline has to stay readable after
+     * the user is renamed or removed, and re-resolving it per row on read would
+     * be a lookup per timeline entry.
+     *
+     * ⚠️ Storing it is not licence to log it: `fullname` is a `SENSITIVE_KEYS`
+     * entry, so it is scrubbed out of every log, Sentry event and `ERROR` row.
+     */
+    interface PrintJobActor {
+        userId: string;
+        fullName: string;
+    }
     interface PrintJobTransition {
         jobId: string;
         state: PrintJobState;
@@ -52,6 +65,12 @@ declare global {
         source: 'be' | 'agent';
         detail?: string;
         errorCode?: string;
+        /**
+         * Absent on an agent-driven transition, which no person initiates, and on
+         * every row written before actor identity shipped. Absence means "not
+         * attributed", never "the system" — render a fallback rather than a name.
+         */
+        actor?: PrintJobActor;
     }
     /**
      * One Cloud Print agent connection in `PrintAgentStatus.agents`.

package/dist/socket.d.ts

@@ -26,9 +26,29 @@
  * A client must ignore actions it does not own rather than assume it
  * receives all of them.
  */
-export declare const SOCKET_ACTIONS: readonly ["account", "baskets", "cart", "brands", "cash", "categories", "customers", "globals", "invoices", "literals", "orders", "products", "returns", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "whatsapp-message", "payment_received", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period"];
+export declare const SOCKET_ACTIONS: readonly ["account", "baskets", "cart", "brands", "cash", "categories", "customers", "globals", "invoices", "literals", "orders", "products", "returns", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "whatsapp-message", "payment_received", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
+/**
+ * Payload of the `'customDomain'` frame — a projection of `DomainRecord`, not
+ * the row. Deliberately OMITTED versus the row: `verificationToken` (an
+ * ownership credential, returned once at register time and never re-sent),
+ * any hosting-provider app id (internal), and `lastCheckedAt` / `startedAt`
+ * (operator-only diagnostics).
+ */
+export interface CustomDomainSocketPayload {
+    storeId: string;
+    /** The NORMALIZED host, as stored on the row. */
+    host: string;
+    provisioning: {
+        state: DomainProvisioningState;
+        certificateVerificationDnsRecord?: string;
+        subDomains?: DomainSubDomainRecord[];
+        /** Unix MILLISECONDS. Present once `state` reaches `active`. */
+        activatedAt?: number;
+        error?: string;
+    };
+}
 /** Runtime guard — narrows an untrusted string to a known action. */
 export declare const isSocketAction: (value: unknown) => value is SocketAction;
 /**

package/dist/socket.js

@@ -176,6 +176,10 @@ export const SOCKET_ACTIONS = [
     // ⚠️ A frame for a period whose `periodStatus` is `'OPEN'` carries numbers
     // ML will still restate; a consumer must not render one as final.
     'mercadolibre_settlement_period',
+    // BE → all store users when an EMPRESA custom domain's provisioning state
+    // moves (`CustomDomainSocketPayload`). Status only: the row's
+    // `verificationToken` is an ownership credential and is never re-sent here.
+    'customDomain',
 ];
 /** Runtime guard — narrows an untrusted string to a known action. */
 export const isSocketAction = (value) => typeof value === 'string' && SOCKET_ACTIONS.includes(value);

package/dist/store.d.ts

@@ -886,6 +886,54 @@ declare global {
      * domain slots — see `DomainErrorCode`.
      */
     type DomainStatus = "PENDING" | "VERIFIED" | "REVOKED";
+    /**
+     * Where EMPRESA custom-domain provisioning stands for a VERIFIED host. The
+     * ownership flow (register → DNS-TXT verify) is unchanged and precedes this;
+     * provisioning is what the platform does with a host once it is proven.
+     *
+     * - `pending_dns` — the association exists; waiting on the tenant to add the
+     *   CNAME records the hosting provider asked for.
+     * - `in_progress` — DNS looks right; the certificate is being issued and the
+     *   domain deployed.
+     * - `active` — the provider reports the domain live.
+     * - `failed` — the provider reported a failure, or no progress for 48 h.
+     * - `unconfigured` — this stage has no hosting-app id configured, so
+     *   provisioning cannot start here. A deployment fact, not a tenant fault.
+     */
+    type DomainProvisioningState = "pending_dns" | "in_progress" | "active" | "failed" | "unconfigured";
+    /** One sub-domain of a provisioned host, mirroring the hosting provider's own per-prefix record. */
+    interface DomainSubDomainRecord {
+        /** `''` for the apex, `'www'` etc. */
+        prefix: string;
+        /**
+         * The provider's CNAME instruction for this prefix, e.g. `"<name> CNAME <value>"`.
+         * Present once the provider has computed it — show it verbatim, never re-derive it.
+         */
+        dnsRecord?: string;
+        verified: boolean;
+    }
+    /**
+     * Provisioning sub-state carried on the SAME `DomainRecord` row — a domain is
+     * one entity, not two. Absent until provisioning has been attempted for the
+     * host, which is every row written before this shipped.
+     *
+     * Timestamps are **Unix MILLISECONDS**, the same unit as `createdAt` /
+     * `verifiedAt` on the enclosing row.
+     */
+    interface DomainProvisioning {
+        state: DomainProvisioningState;
+        /** The provider's certificate-validation CNAME instruction — shown to the tenant once, verbatim. */
+        certificateVerificationDnsRecord?: string;
+        subDomains?: DomainSubDomainRecord[];
+        /** Unix MILLISECONDS — last time the poller checked the provider. Operator diagnostic, not tenant-facing. */
+        lastCheckedAt?: number;
+        /** Unix MILLISECONDS. */
+        startedAt?: number;
+        /** Unix MILLISECONDS. Present once `state` reaches `active`. */
+        activatedAt?: number;
+        /** The provider's last reported failure reason. Diagnostic only — never a stable code to branch on. */
+        error?: string;
+    }
     /**
      * One row of `GET /store/domains`, which answers `{ data: DomainRecord[] }`.
      *
@@ -923,6 +971,8 @@ declare global {
         revokedAt?: number;
         /** Unix SECONDS — a DynamoDB TTL. PENDING rows only; removed on verify. */
         ttl?: number;
+        /** Present only once EMPRESA provisioning has been attempted for this VERIFIED host. */
+        provisioning?: DomainProvisioning;
     }
     /**
      * `POST /store/domains { mode: 'register' }` — the payload, carried ENVELOPED

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinfactura-types",
-  "version": "1.10.183",
+  "version": "1.10.185",
   "main": "dist/index.js",
   "type": "module",
   "types": "./dist/index.d.ts",