sinfactura-types 1.6.29 → 1.6.31

package/dist/basket.d.ts

@@ -24,6 +24,14 @@ declare global {
         ivaType: number;
         cost: number;
         price: number;
+        listId?: number;
+        currency?: string;
+        currencyValue?: number;
+        currencyValueAt?: number;
+        priceSource?: 'percent' | 'amount';
+        appliedMinQty?: number;
+        promoApplied?: boolean;
+        basePrice?: number;
     }
 }
 export {};

package/dist/currency.d.ts

@@ -30,5 +30,42 @@ declare global {
         value: number;
         source?: string;
     }
+    type FxProvider = "ambito" | "dolarapi" | "bluelytics" | "bcra";
+    interface PlatformFxSource {
+        /** Stable identifier — referenced by `Store.fxAutoUpdate.bindings[].sourceId`. */
+        id: string;
+        isoCode: string;
+        variant: CurrencyVariant;
+        provider: FxProvider;
+    }
+    interface PlatformFxSourceWithStatus extends PlatformFxSource {
+        enabled: boolean;
+        /** EventBridge cron expression (`minute hour day month weekday`). */
+        cron: string;
+        /** Optional override for the provider's source URL. */
+        sourceUrl?: string;
+        /** Unix ms of the last successful fetch. Undefined if never succeeded. */
+        lastSuccessAt?: number;
+        /** Unix ms of the last failed fetch. Undefined if no failures yet. */
+        lastFailureAt?: number;
+        /** Short reason for the most recent failure (truncated to 256 chars). */
+        lastFailureReason?: string;
+        /** Consecutive-failure streak; resets on first success. Drives failover (>=3) + alerts. */
+        consecutiveFailures?: number;
+        /** Sibling source id to attempt when `consecutiveFailures` crosses the failover threshold. */
+        fallbackSourceId?: string;
+        /** Server-derived: `now - lastSuccessAt > maxStaleness`. Added by the SUPER GET handler. */
+        isStale: boolean;
+    }
+    interface PlatformFxSourcesRow {
+        enabled: boolean;
+        sources: PlatformFxSourceWithStatus[];
+        maxStaleness: {
+            default: number;
+        } & Record<string, number>;
+        updatedAt: number;
+        /** `true` once an explicit row is persisted; `false` when the handler is returning DEFAULT_FX_SOURCES. */
+        persisted?: boolean;
+    }
 }
 export {};

package/dist/customer.d.ts

@@ -39,7 +39,15 @@ declare global {
         paymentMethod: number;
         phone: string;
         photoURL: string;
+        photoData?: string;
+        removePhotoURL?: string;
         postalCode: string;
+        /**
+         * FK to PriceList.id (NOT a positional ordinal). Picks which PriceSlot /
+         * materialized priceN applies to this customer. Legacy values 1..4 already
+         * equal the seeded list ids, so the migration is value-preserving; getPrice
+         * resolves by id, not by `price${ordinal}`. (#1780 / types#88)
+         */
         priceList: number;
         province: string;
         salt?: string;

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export * from "./mercadopago";
 export * from "./notification";
 export * from "./order";
 export * from "./payment";
+export * from "./pricing";
 export * from "./print";
 export * from "./product";
 export * from "./return";

package/dist/index.js

@@ -19,6 +19,7 @@ export * from "./mercadopago";
 export * from "./notification";
 export * from "./order";
 export * from "./payment";
+export * from "./pricing";
 export * from "./print";
 export * from "./product";
 export * from "./return";

package/dist/invoice.d.ts

@@ -48,6 +48,11 @@ declare global {
         quantity: number;
         iva: number;
         neto: number;
+        unitPrice?: number;
+        listId?: number;
+        appliedMinQty?: number;
+        promoApplied?: boolean;
+        basePrice?: number;
     }
     interface InvoiceWithCustomer extends Invoice {
         customer: Customer;

package/dist/mercadopago.d.ts

@@ -62,5 +62,67 @@ declare global {
         externalPosId?: string;
         operatingMode: "PDV" | "STANDALONE";
     }
+    type MpHookResult = 'config-missing' | 'test-event' | 'orphan' | 'duplicate' | 'not-approved' | 'item-saved' | 'error';
+    interface MpHookLogEntry {
+        hookId: string;
+        rawBodyB64?: string;
+        rawBodyLen?: number;
+        headers?: Record<string, string>;
+        path?: string;
+        resource?: string;
+        queryStringParameters?: Record<string, string> | null;
+        signatureValid?: boolean;
+        signatureV1Prefix?: string;
+        expectedPrefix?: string;
+        signatureReason?: string;
+        paymentId?: string;
+        userId?: string;
+        storeId?: string;
+        result: MpHookResult;
+        errorMessage?: string;
+        processingMs?: number;
+        createdAt: number;
+        ts?: number;
+        requestId?: string;
+        ttl?: number;
+    }
+    type MpIpnOutcome = 'polled-online' | 'no-online-tenants' | 'no-online-mp-tenants' | 'not-payment-topic' | 'none' | 'error';
+    interface MpIpnLogEntry {
+        ipnId: string;
+        topic: string;
+        resourceId: string;
+        rawBodyB64?: string;
+        rawBodyLen?: number;
+        headers?: Record<string, string>;
+        path?: string;
+        resource?: string;
+        queryStringParameters?: Record<string, string> | null;
+        processingMs?: number;
+        createdAt: number;
+        ttl?: number;
+        errorMessage?: string;
+        outcome?: MpIpnOutcome;
+        tenantsScanned?: number;
+        tenantsPolled?: number;
+        tenantsFailed?: number;
+    }
+    type MpMovementType = 'transfer_in' | 'qr_in' | 'transfer_out' | 'fee' | 'refund' | 'other';
+    interface MpMovementLogEntry {
+        operationId: string;
+        source: 'transfer';
+        amount: number;
+        currency: string;
+        type: MpMovementType;
+        date: number;
+        description: string;
+        sourceChannel?: string;
+        payerName?: string;
+        cuit?: string;
+        email?: string;
+        raw?: unknown;
+        createdAt: number;
+        processedAt: number;
+        ttl?: number;
+    }
 }
 export {};

package/dist/pricing.d.ts

@@ -0,0 +1,72 @@
+declare global {
+    /**
+     * ADR-0013 self-describing money stamp — STRICT (frozen rate required).
+     * Used ONLY on the new pricing-authoring shapes (PriceSlot[absolute] /
+     * PriceBreak / PricePromo). An optional frozen rate would reopen the
+     * live-rate hole (#1542). `currency` is bare `string` (catalogId) for parity
+     * with `Product.currency` — do NOT half-narrow to `CatalogId` while the
+     * entity stamps stay `string`. Do NOT retrofit this onto SupplierInvoice /
+     * SupplierAccount (optional-currency by design — would break supplier writes).
+     */
+    interface CurrencyStamp {
+        currency: string;
+        currencyValue: number;
+        currencyValueAt: number;
+    }
+    /**
+     * A named, extensible price list. Split OUT of the shared `Method` blob
+     * (`Method` is reused by 7 unrelated Store arrays — don't leak pricing into
+     * paymentMethods / ivaTypes). A structural SUPERSET of `Method` (keeps
+     * id / name / value? / removable? / editable?) so `store.priceLists:
+     * Method[] → PriceList[]` is type-compatible. `id` is the stable FK target
+     * for `Customer.priceList` + `PriceSlot.listId`.
+     */
+    interface PriceList {
+        id: number;
+        name: string;
+        value?: number;
+        removable?: boolean;
+        editable?: boolean;
+        order?: number;
+        defaultCurrency?: string;
+        tierGated?: boolean;
+    }
+    /**
+     * Quantity break within a slot. Resolution: highest `minQty <= qty` wins.
+     * Stored sorted ascending by `minQty`; no two breaks share a `minQty`
+     * (BE-validated). Open-ended top tier (no `maxQty` — ranges derive from the
+     * next break's `minQty`).
+     */
+    interface PriceBreak extends CurrencyStamp {
+        minQty: number;
+        amount: number;
+    }
+    /** Time-limited promo override. `amount` is absolute. */
+    interface PricePromo extends CurrencyStamp {
+        from?: number;
+        until: number;
+        amount: number;
+    }
+    /**
+     * One price list's pricing for a product. Discriminated union — kills the
+     * `{}`, both-set and neither-set invalid states; the `kind:'absolute' ⇒
+     * stamp` invariant rides the discriminant. `listId` is an FK to
+     * `PriceList.id`.
+     */
+    type PriceSlot = {
+        kind: 'percent';
+        listId: number;
+        percent: number;
+        breaks?: PriceBreak[];
+        promo?: PricePromo;
+        visibleOnStorefront?: boolean;
+    } | ({
+        kind: 'absolute';
+        listId: number;
+        amount: number;
+        breaks?: PriceBreak[];
+        promo?: PricePromo;
+        visibleOnStorefront?: boolean;
+    } & CurrencyStamp);
+}
+export {};

package/dist/pricing.js

@@ -0,0 +1 @@
+export {};

package/dist/product.d.ts

@@ -43,10 +43,11 @@ declare global {
         isNew: boolean;
         isService: boolean;
         cost: number;
-        price1: number;
-        price2: number;
-        price3: number;
-        price4: number;
+        prices?: PriceSlot[];
+        price1?: number;
+        price2?: number;
+        price3?: number;
+        price4?: number;
     }
 }
 export {};

package/dist/store.d.ts

@@ -154,7 +154,7 @@ declare global {
         cashInMethods: Method[];
         cashOutMethods: Method[];
         debitMethods: Method[];
-        priceLists: Method[];
+        priceLists: PriceList[];
         accountMethods: Method[];
         deliveryMethods: Method[];
         paymentMethods: Method[];

package/dist/subscription.d.ts

@@ -63,7 +63,7 @@ declare global {
      * every existing plan in `FEATURE_MATRIX` must then declare the new key
      * (TypeScript enforces this via `Record<FeatureKey, Entitlement>`).
      */
-    type FeatureKey = 'maxOrdersMonth' | 'maxInvoicesMonth' | 'maxProducts' | 'maxUsers' | 'maxCustomers' | 'maxStores' | 'afipInvoicing' | 'paymentIntegrations' | 'suppliers' | 'cashManagement' | 'multiStore' | 'importExport' | 'advancedReports' | 'customBranding' | 'apiAccess' | 'prioritySupport' | 'whatsappCommerce' | 'aiFeatures' | 'mobileApp' | 'customDomain';
+    type FeatureKey = 'maxOrdersMonth' | 'maxInvoicesMonth' | 'maxProducts' | 'maxUsers' | 'maxCustomers' | 'maxStores' | 'priceListsMax' | 'afipInvoicing' | 'paymentIntegrations' | 'suppliers' | 'cashManagement' | 'multiStore' | 'importExport' | 'advancedReports' | 'customBranding' | 'apiAccess' | 'prioritySupport' | 'whatsappCommerce' | 'aiFeatures' | 'mobileApp' | 'customDomain' | 'advancedPricing';
     /** Full feature matrix — every tier declares every feature. */
     type FeatureMatrix = Record<PlanTier, Record<FeatureKey, Entitlement>>;
     /** Resolved entitlements for a specific tenant (matrix + overrides applied). */

package/dist/supplier.d.ts

@@ -5,6 +5,8 @@ declare global {
         supplierId: string;
         createdAt: number;
         photoURL: string;
+        photoData?: string;
+        removePhotoURL?: string;
         company: string;
         cuit: string;
         razonSocial: string;

package/dist/user.d.ts

@@ -10,6 +10,8 @@ declare global {
         password?: string;
         roles: string;
         photoURL: string;
+        photoData?: string;
+        removePhotoURL?: string;
         disabled: boolean;
         search: string;
         accessToken: string;

package/dist/userActivity.d.ts

@@ -74,12 +74,18 @@ declare global {
         order_id: string;
         reason: string;
     }
+    interface PriceListChange {
+        list_id: number;
+        from: number;
+        to: number;
+    }
     interface ProductPriceChangedEvent extends UserActivityEventBase {
         event: 'Product Price Changed';
         product_id: string;
         from_price: number;
         to_price: number;
         currency: string;
+        changes?: PriceListChange[];
     }
     interface CustomerCreatedEvent extends UserActivityEventBase {
         event: 'Customer Created';
@@ -396,3 +402,11 @@ declare global {
  */
 export declare const UI_ONLY_USER_ACTIVITY_VARIANTS: readonly ["Audit Trail Viewed", "Report Viewed", "Customer PII Viewed", "Cash Drawer UI Opened", "Cash Drawer UI Closed", "Export Initiated", "Impersonation UI Started", "Impersonation UI Ended", "Payment Viewed", "Invoice Viewed", "Customer Detail Viewed", "Supplier Account Viewed", "Search Performed", "Action Denied", "Two-Factor Challenge Shown", "Two-Factor Code Validation Failed", "Two-Factor Enrollment Started", "Two-Factor Recovery Codes Revealed", "Two-Factor Reset Initiated"];
 export type UiOnlyUserActivityVariant = (typeof UI_ONLY_USER_ACTIVITY_VARIANTS)[number];
+/**
+ * Valid per-entity timeline entity types for the user-activity audit feed.
+ * MUST stay in sync with the BE `VALID_ENTITY_TYPES` const in
+ * `sinfactura/api/stacks/lambdas/userActivity/_get.ts` (api#1258), which Zod-
+ * enums the `entityType` query param. The api should import this union to
+ * derive that const so the two can't drift (separate api follow-up).
+ */
+export type UserActivityEntityType = 'order' | 'invoice' | 'supplier_invoice' | 'payment' | 'account' | 'customer' | 'supplier' | 'product' | 'user' | 'target_store' | 'brand' | 'category' | 'cash' | 'ticket' | 'report' | 'notification';

package/package.json

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