sinfactura-types 1.6.8 → 1.6.11

package/dist/index.d.ts

@@ -21,8 +21,10 @@ export * from "./product";
 export * from "./return";
 export * from "./stock";
 export * from "./store";
+export * from "./storefrontEvent";
 export * from "./subscription";
 export * from "./supplier";
 export * from "./user";
+export * from "./userActivity";
 export * from "./whatsapp";
 export * from "./provinces";

package/dist/index.js

@@ -21,8 +21,10 @@ export * from "./product";
 export * from "./return";
 export * from "./stock";
 export * from "./store";
+export * from "./storefrontEvent";
 export * from "./subscription";
 export * from "./supplier";
 export * from "./user";
+export * from "./userActivity";
 export * from "./whatsapp";
 export * from "./provinces";

package/dist/store.d.ts

@@ -119,13 +119,6 @@ declare global {
             priceDecimals: 0 | 1 | 2 | 3;
             stock: boolean;
             changePrice: boolean;
-            /**
-             * @deprecated since app#1539 — alias of `displayCurrency`. Kept
-             * during the migration so unmigrated readers stay correct.
-             * Removed once every FE read-site has switched to
-             * `displayCurrency`.
-             */
-            currency: string;
             /**
              * Back-office display currency (catalogId). The single currency
              * the operator's screens are framed in — distinct from the
@@ -152,6 +145,7 @@ declare global {
         photoData?: string;
         newPhotoURL?: string;
         removePhotoURL?: string;
+        mercadopagoUserId?: string;
         currencies: StoreCurrencySubscription[];
         cashInMethods: Method[];
         cashOutMethods: Method[];

package/dist/storefrontEvent.d.ts

@@ -0,0 +1,99 @@
+declare global {
+    interface StorefrontEventBase {
+        anonymous_id: string;
+        customer_id?: string;
+        tenant_store_id: string;
+        schema_version: 1;
+        event_id: string;
+        screen_type: 'desktop' | 'mobile';
+        app_version: number;
+        ts: string;
+    }
+    interface ProductViewedEvent extends StorefrontEventBase {
+        event: 'Product Viewed';
+        product_id: string;
+        product_name: string;
+        price: number;
+        currency: string;
+    }
+    interface ProductListViewedEvent extends StorefrontEventBase {
+        event: 'Product List Viewed';
+        list_name: string;
+        products: Array<{
+            product_id: string;
+            product_name: string;
+            price: number;
+        }>;
+    }
+    interface CartItemAddedEvent extends StorefrontEventBase {
+        event: 'Cart Item Added';
+        product_id: string;
+        product_name: string;
+        quantity: number;
+        price: number;
+        currency: string;
+    }
+    interface CartItemRemovedEvent extends StorefrontEventBase {
+        event: 'Cart Item Removed';
+        product_id: string;
+        product_name: string;
+        quantity: number;
+    }
+    interface CartViewedEvent extends StorefrontEventBase {
+        event: 'Cart Viewed';
+        cart_total: number;
+        items_count: number;
+        currency: string;
+    }
+    interface SearchSubmittedEvent extends StorefrontEventBase {
+        event: 'Search Submitted';
+        query: string;
+        results_count: number;
+    }
+    interface CheckoutStartedEvent extends StorefrontEventBase {
+        event: 'Checkout Started';
+        cart_total: number;
+        items_count: number;
+        currency: string;
+    }
+    interface CheckoutStepCompletedEvent extends StorefrontEventBase {
+        event: 'Checkout Step Completed';
+        step: number;
+        step_name: string;
+    }
+    interface PaymentInfoEnteredEvent extends StorefrontEventBase {
+        event: 'Payment Info Entered';
+        payment_type: string;
+    }
+    interface OrderCompletedEvent extends StorefrontEventBase {
+        event: 'Order Completed';
+        transaction_id: string;
+        revenue: number;
+        currency: string;
+        items_count: number;
+    }
+    interface CustomerLoggedInEvent extends StorefrontEventBase {
+        event: 'Customer Logged In';
+        method: 'email' | 'google' | 'facebook';
+    }
+    interface CustomerSignedUpEvent extends StorefrontEventBase {
+        event: 'Customer Signed Up';
+        method: 'email' | 'google' | 'facebook';
+    }
+    interface CustomerLoggedOutEvent extends StorefrontEventBase {
+        event: 'Customer Logged Out';
+    }
+    interface CustomerIdentifiedEvent extends StorefrontEventBase {
+        event: 'Customer Identified';
+        customer_id: string;
+    }
+    type StorefrontEvent = ProductViewedEvent | ProductListViewedEvent | CartItemAddedEvent | CartItemRemovedEvent | CartViewedEvent | SearchSubmittedEvent | CheckoutStartedEvent | CheckoutStepCompletedEvent | PaymentInfoEnteredEvent | OrderCompletedEvent | CustomerLoggedInEvent | CustomerSignedUpEvent | CustomerLoggedOutEvent | CustomerIdentifiedEvent;
+    interface IdentityLink {
+        tenant_store_id: string;
+        anonymous_id: string;
+        customer_id: string;
+        linked_at: string;
+        link_event_id: string;
+    }
+}
+export {};

package/dist/storefrontEvent.js

@@ -0,0 +1,16 @@
+// Typed storefront events pipeline (types#69, api#1239/#1240,
+// storefront#425/#429, app#1638). Schema-validated discriminated union
+// emitted by `sinfactura/storefront` (via the `track()` wrapper in
+// `src/utils/track.ts`), validated and persisted by `sinfactura/api`
+// (Zod mirror in `stacks/helpers/storefrontEvents/schema.ts`), rendered
+// by `sinfactura/app` (typed activity feed in `<ActivityFeed>`).
+//
+// Naming follows Segment Spec: Title Case Object + Past-Tense Action
+// for event names; snake_case for properties so the GA4 / Segment
+// vocabulary on the wire maps without translation.
+//
+// 14 variants — the 4 storefront-only events (`Page Viewed`,
+// `Favorite Toggled`, `Whatsapp Clicked`, `Error Captured`) currently
+// emitted by storefront are NOT in this taxonomy yet; they ride the
+// legacy `Log` path and are tracked for a follow-up types release.
+export {};

package/dist/userActivity.d.ts

@@ -0,0 +1,102 @@
+declare global {
+    interface UserActivityEventBase {
+        tenant_store_id: string;
+        user_id: string;
+        actor_role: 'USER' | 'ADMIN' | 'SUPERVISOR' | 'MANAGER';
+        actor_full_name: string;
+        actor_ip?: string;
+        event_id: string;
+        schema_version: 1;
+        ts: string;
+    }
+    interface UserLoggedInEvent extends UserActivityEventBase {
+        event: 'User Logged In';
+        method: 'password' | 'totp' | 'refresh';
+    }
+    interface UserLoggedOutEvent extends UserActivityEventBase {
+        event: 'User Logged Out';
+    }
+    interface UserPasswordChangedEvent extends UserActivityEventBase {
+        event: 'User Password Changed';
+        target_user_id: string;
+    }
+    interface UserSuspendedEvent extends UserActivityEventBase {
+        event: 'User Suspended';
+        target_user_id: string;
+        reason: string;
+    }
+    interface StorePaletteChangedEvent extends UserActivityEventBase {
+        event: 'Store Palette Changed';
+        before: Record<string, unknown>;
+        after: Record<string, unknown>;
+    }
+    interface StoreSettingsUpdatedEvent extends UserActivityEventBase {
+        event: 'Store Settings Updated';
+        section: string;
+        before: Record<string, unknown>;
+        after: Record<string, unknown>;
+    }
+    interface PlanChangedEvent extends UserActivityEventBase {
+        event: 'Plan Changed';
+        from_tier: string;
+        to_tier: string;
+    }
+    interface InvoiceCreatedEvent extends UserActivityEventBase {
+        event: 'Invoice Created';
+        invoice_id: string;
+        total: number;
+        currency: string;
+        type: string;
+    }
+    interface OrderCreatedEvent extends UserActivityEventBase {
+        event: 'Order Created';
+        order_id: string;
+        total: number;
+        currency: string;
+    }
+    interface OrderCancelledEvent extends UserActivityEventBase {
+        event: 'Order Cancelled';
+        order_id: string;
+        reason: string;
+    }
+    interface ProductPriceChangedEvent extends UserActivityEventBase {
+        event: 'Product Price Changed';
+        product_id: string;
+        from_price: number;
+        to_price: number;
+        currency: string;
+    }
+    interface CustomerCreatedEvent extends UserActivityEventBase {
+        event: 'Customer Created';
+        customer_id: string;
+    }
+    interface CustomerEditedEvent extends UserActivityEventBase {
+        event: 'Customer Edited';
+        customer_id: string;
+        fields_changed: string[];
+    }
+    interface CashDrawerOpenedEvent extends UserActivityEventBase {
+        event: 'Cash Drawer Opened';
+        cash_id: string;
+        opening_balance: number;
+        currency: string;
+    }
+    interface CashDrawerClosedEvent extends UserActivityEventBase {
+        event: 'Cash Drawer Closed';
+        cash_id: string;
+        final_balance: number;
+        discrepancy: number;
+        currency: string;
+    }
+    interface TenantImpersonatedEvent extends UserActivityEventBase {
+        event: 'Tenant Impersonated';
+        target_store_id: string;
+        reason: string;
+    }
+    interface SecretRotatedEvent extends UserActivityEventBase {
+        event: 'Secret Rotated';
+        secret_name: string;
+    }
+    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent;
+}
+export {};

package/dist/userActivity.js

@@ -0,0 +1,19 @@
+// Typed user activity audit pipeline (types#70, api#1244).
+//
+// Actor-centric audit trail companion to the entity-centric `AUDIT#{entity}#{entityId}`
+// rows authored in `sinfactura/api/stacks/services/audit.ts`. Schema mirrored in
+// `sinfactura/api/stacks/helpers/userActivity/schema.ts`; emitted via the
+// `recordUserActivity` synchronous helper at the end of mutating REST handlers.
+//
+// Naming follows the same convention as `StorefrontEvent` (types#69): Title Case
+// Object + Past-Tense Action for event names, snake_case for properties.
+//
+// Distinct from `StorefrontEvent` (types#69):
+//   - Subject: internal staff (USER/ADMIN/SUPERVISOR/MANAGER), never anonymous
+//   - Retention: 90d hot + multi-year archive (vs 30d hot + 90d archive)
+//   - Erasure: append-only / anti-erasure per Ley 25.326 audit-trail exemption
+//   - Ingest: synchronous REST-handler helper (WS ingest explicitly disallowed)
+//
+// 17 variants — covers the Phase 1 MVP wire-ins in api#1244 plus the rest of
+// the canonical taxonomy. Add new variants here as Phase 2/3 ships coverage.
+export {};

package/package.json

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