sinfactura-types 1.10.2 → 1.10.4

package/dist/print.d.ts

@@ -230,5 +230,38 @@ declare global {
          */
         printerId?: string;
     }
+    /**
+     * One mapping in the agent's `export_local_rules` frame — the migration of
+     * agent-local routing into `PRINT_RULE#${storeId}` (api#2010 /
+     * sinfactura/print#183, #156 phase 5).
+     *
+     * The agent resolves its own slot setting to a `printerId`, by matching the
+     * stored OS printer name against its **current enumerated set**. The BE never
+     * matches on name: `PrintPrinter.name` is a display label, not unique across
+     * agents, and explicitly not a key.
+     */
+    interface PrintLocalRuleExport {
+        useCase: PrintUseCase;
+        printerId: string;
+    }
+    /**
+     * A local slot the agent could NOT resolve to a registered printer, reported
+     * rather than dropped — a store's mapping must never vanish silently.
+     *
+     * Keyed by `useCase` so it shares units with `PrintLocalRuleExport`: one
+     * unresolvable `tags` slot is TWO unrouted use cases (`tag` + `label`), so
+     * slot-keyed entries would make the seeded/skipped counts incomparable.
+     * `slot` is retained anyway, because an operator configures slots, not use
+     * cases, and it is what tells them which printer to fix.
+     */
+    interface PrintLocalRuleSkip {
+        useCase: PrintUseCase;
+        /** Agent-local slot name — `orders` | `invoices` | `tags`. */
+        slot: string;
+        /** The OS printer name the slot still points at. */
+        printerName: string;
+        /** Free text from the agent; recorded for support, never parsed. */
+        reason: string;
+    }
 }
 export {};

package/dist/socket.d.ts

@@ -124,8 +124,43 @@ export interface SocketRegisterPrintersMessage {
     printers: PrintPrinterReport[];
     [key: string]: unknown;
 }
+/**
+ * Agent → BE, migration of the agent's local `useCase → printer` config into
+ * `PRINT_RULE#${storeId}` (api#2010 / sinfactura/print#183, #156 phase 5).
+ *
+ * **A distinct action, not a field on `register_printers`** — deliberately, and
+ * the failure modes are why. An unknown ACTION fails the api's discriminated
+ * union with a visible `400`; an unknown FIELD passes the loose gate and is then
+ * silently stripped by the handler's schema, so an agent shipping ahead of the
+ * BE would migrate nothing and still look healthy. `register_printers` also
+ * recurs on every reconnect, and a one-shot payload has no business riding it.
+ *
+ * Sent after a successful `register_printers` — the registry must exist before a
+ * rule can point into it — and **on every connect** rather than once per
+ * install. The agent cannot observe delivery (its frame is handed to the
+ * renderer, which may drop it, and the socket does not serialise), so a local
+ * "already exported" flag would turn one lost race into a store that never
+ * migrates. Exactly-once is the BE's `PRINT_AGENT#` marker alone; a repeat costs
+ * one failed conditional write.
+ *
+ * `agentId` is deliberately **not declared**, and unlike
+ * `SocketRegisterPrintersMessage` the api will not accept an advisory one — it
+ * comes from the authenticated SOCKET row only. Writing routing rules has a
+ * wider blast radius than writing a registry row.
+ *
+ * ⚠️ An EMPTY frame (no `rules`, no `skipped`) is not sent, and the api no-ops on
+ * one: otherwise a fresh install consumes the once-only marker and completes
+ * migration having seeded nothing, so anything configured locally afterwards
+ * could never migrate.
+ */
+export interface SocketExportLocalRulesMessage {
+    action: 'export_local_rules';
+    rules: PrintLocalRuleExport[];
+    skipped?: PrintLocalRuleSkip[];
+    [key: string]: unknown;
+}
 /** Any client→server JSON frame. */
-export type ClientSocketMessage = SocketAuthMessage | SocketLogsMessage | SocketHeartbeatMessage | SocketAckMessage | SocketRegisterPrintersMessage;
+export type ClientSocketMessage = SocketAuthMessage | SocketLogsMessage | SocketHeartbeatMessage | SocketAckMessage | SocketRegisterPrintersMessage | SocketExportLocalRulesMessage;
 /**
  * Why the backend refused the handshake (api#977 / app#1353).
  *

package/dist/userActivity.d.ts

@@ -443,7 +443,26 @@ declare global {
         from_status: ProductChannelStatus;
         to_status: ProductChannelStatus;
     }
-    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | OrderEditedEvent | OrderReturnedEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | BasketUpdatedEvent | BasketDeletedEvent | CashDrawerMovementEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent | IntegrationTokenRefreshedEvent | WaitlistConvertedEvent | PlatformConfigUpdatedEvent | MlChannelStatusChangedEvent;
+    interface PrintRuleCreatedEvent extends UserActivityEventBase {
+        event: 'Print Rule Created';
+        use_case: PrintUseCase;
+        agent_id: string;
+        printer_id: string;
+    }
+    interface PrintRuleEditedEvent extends UserActivityEventBase {
+        event: 'Print Rule Edited';
+        use_case: PrintUseCase;
+        agent_id: string;
+        printer_id: string;
+        fields_changed: string[];
+    }
+    interface PrintRuleDeletedEvent extends UserActivityEventBase {
+        event: 'Print Rule Deleted';
+        use_case: PrintUseCase;
+        agent_id: string;
+        printer_id: string;
+    }
+    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | OrderEditedEvent | OrderReturnedEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | BasketUpdatedEvent | BasketDeletedEvent | CashDrawerMovementEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent | IntegrationTokenRefreshedEvent | WaitlistConvertedEvent | PlatformConfigUpdatedEvent | MlChannelStatusChangedEvent | PrintRuleCreatedEvent | PrintRuleEditedEvent | PrintRuleDeletedEvent;
 }
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names — the 8

package/package.json

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