@fayz-ai/shop 0.9.0 → 0.11.0

package/dist/inventory/stock-types.d.ts

@@ -0,0 +1,351 @@
+/**
+ * The per-variant tracking policy — a closed set, deliberately (§3).
+ *
+ * Unlike movement kinds and reason codes, these are NOT rows: each value
+ * changes what the engine does, so a tenant-invented mode would be data no
+ * code could honour. Widening this is a model change — this union, the
+ * `plg_shop_product_variants_tracking_check` CHECK, and the validator, together.
+ *
+ * - `none`     — never depletes. Made-to-order, digital, services.
+ * - `quantity` — one implicit lot. THE DEFAULT, so existing stores are unchanged.
+ * - `lot`      — batches with expiry; allocation is FEFO.
+ * - `serial`   — every unit is unique; a serial is a lot whose quantity is 1.
+ */
+export declare const STOCK_TRACKING_MODES: readonly ["none", "quantity", "lot", "serial"];
+export type StockTrackingMode = (typeof STOCK_TRACKING_MODES)[number];
+/** The default every variant gets, so adopting the ledger costs a simple store nothing. */
+export declare const DEFAULT_STOCK_TRACKING: StockTrackingMode;
+/** Closed set: allocation branches on it (transit stock cannot be promised). */
+export declare const STOCK_LOCATION_KINDS: readonly ["store", "warehouse", "transit", "virtual"];
+export type StockLocationKind = (typeof STOCK_LOCATION_KINDS)[number];
+/** Closed set: the §5 reservation lifecycle. */
+export declare const STOCK_RESERVATION_STATUSES: readonly ["held", "consumed", "released"];
+export type StockReservationStatus = (typeof STOCK_RESERVATION_STATUSES)[number];
+export declare const STOCK_LOT_STATUSES: readonly ["active", "quarantined", "expired", "consumed"];
+export type StockLotStatus = (typeof STOCK_LOT_STATUSES)[number];
+/**
+ * The sign contract a movement kind carries. It lives in the VOCABULARY ROW,
+ * not in the validator, which is precisely what lets a tenant add a kind.
+ */
+export declare const STOCK_MOVEMENT_DIRECTIONS: readonly ["in", "out", "either"];
+export type StockMovementDirection = (typeof STOCK_MOVEMENT_DIRECTIONS)[number];
+/** One movement-kind vocabulary row (plg_shop_stock_movement_kinds). */
+export interface StockMovementKind {
+    key: string;
+    label: string;
+    direction: StockMovementDirection;
+}
+/**
+ * One reason-code vocabulary row (plg_shop_stock_reason_codes).
+ *
+ * `movementKind` null means "valid for any kind"; naming one makes the pair
+ * checkable, so 'breakage' can never be recorded as a receipt.
+ */
+export interface StockReasonCode {
+    key: string;
+    label: string;
+    movementKind: string | null;
+}
+/**
+ * `fulfillment_provider` when the merchant dispatches by hand — a decision, not
+ * an absent one, which is why it is stored instead of inferred from "no gateway".
+ */
+export declare const OWN_FULFILLMENT = "own";
+/** Where stock sits, and — since 0058 — what ships from there. */
+export interface StockLocation {
+    id: string;
+    tenantId: string;
+    code: string;
+    name: string;
+    kind: StockLocationKind;
+    /** Stock here can be promised to a shopper. Transit stock cannot. */
+    isSellable: boolean;
+    isDefault: boolean;
+    status: 'active' | 'archived';
+    /** 8 bare digits. The origin a freight gateway quotes from. */
+    postalCode?: string | null;
+    city?: string | null;
+    state?: string | null;
+    street?: string | null;
+    number?: string | null;
+    district?: string | null;
+    complement?: string | null;
+    /** CNPJ/CPF, digits only — the carrier prints it on the label (0061). */
+    document?: string | null;
+    phone?: string | null;
+    email?: string | null;
+    /**
+     * Where THIS place drops its parcels, per carrier (0062):
+     * `{ 'melhor-envio': { id: '49276', name: 'Jadlog Barra' } }`.
+     *
+     * Per carrier because the choice is: the same warehouse can drop one
+     * carrier's parcels downtown and another's next door. Empty means "the
+     * nearest agency that accepts the service", which is what dispatch does.
+     */
+    carrierAgencies?: Record<string, {
+        id: string;
+        name?: string;
+    }> | null;
+    /** Online orders may be dispatched from here. */
+    shipsOnline?: boolean;
+    /** null follows the store, `OWN_FULFILLMENT` is by hand, else a connector id. */
+    fulfillmentProvider?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateStockLocationInput {
+    name: string;
+    /** Stable handle for a CSV import or an ERP connector. Defaults to a slug of the name. */
+    code?: string;
+    kind?: StockLocationKind;
+    isSellable?: boolean;
+    isDefault?: boolean;
+    status?: 'active' | 'archived';
+    postalCode?: string | null;
+    city?: string | null;
+    state?: string | null;
+    street?: string | null;
+    number?: string | null;
+    district?: string | null;
+    complement?: string | null;
+    document?: string | null;
+    phone?: string | null;
+    email?: string | null;
+    carrierAgencies?: Record<string, {
+        id: string;
+        name?: string;
+    }> | null;
+    shipsOnline?: boolean;
+    fulfillmentProvider?: string | null;
+}
+export type UpdateStockLocationInput = Partial<CreateStockLocationInput>;
+/** A batch. A serial-tracked unit is a lot whose quantity is 1. */
+export interface StockLot {
+    id: string;
+    tenantId: string;
+    variantId: string;
+    lotCode: string;
+    serial: string | null;
+    /** Calendar dates, not timestamps: FEFO order must not depend on a time zone. */
+    manufacturedAt: string | null;
+    expiresAt: string | null;
+    receivedAt: string;
+    unitCost: number | null;
+    supplierRef: string | null;
+    status: StockLotStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * One ledger row. Append-only and signed: a mistake is corrected by an
+ * OPPOSING movement, never by an edit, which is what makes the ledger
+ * auditable.
+ */
+export interface StockMovement {
+    id: string;
+    tenantId: string;
+    /** Null only after the variant row was deleted — the history survives it. */
+    variantId: string | null;
+    productId: string | null;
+    locationId: string;
+    lotId: string | null;
+    kind: string;
+    reasonCode: string | null;
+    /** Signed. The kind's `direction` decides which signs are legal. */
+    quantity: number;
+    unitCost: number | null;
+    orderId: string | null;
+    reservationId: string | null;
+    idempotencyKey: string | null;
+    /** WHEN it happened, which is not when it was recorded. */
+    occurredAt: string;
+    createdBy: string | null;
+    note: string | null;
+    createdAt: string;
+}
+/** What a caller supplies to append to the ledger. */
+export interface RecordStockMovementInput {
+    variantId: string;
+    kind: string;
+    quantity: number;
+    reasonCode?: string | null;
+    /** Omitted ⇒ the tenant's default location, created on demand. */
+    locationId?: string | null;
+    lotId?: string | null;
+    unitCost?: number | null;
+    orderId?: string | null;
+    reservationId?: string | null;
+    /** A retried write must not decrement twice. */
+    idempotencyKey?: string | null;
+    occurredAt?: string;
+    note?: string | null;
+}
+/**
+ * The materialised answer per (variant, lot, location) — an index over the
+ * ledger, not a second truth. `onHand` may be NEGATIVE: an over-recorded loss
+ * must stay visible rather than be refused, because refusing it would make the
+ * LEDGER lie. The clamp happens once, at the inventory_count mirror.
+ *
+ * ---------------------------------------------------------------------------
+ * NAME MAPPING TO SHOPIFY, so a connector never needs a translation table.
+ *
+ * Shopify's quantity states are `available`, `committed`, `on_hand`,
+ * `incoming`, plus `damaged`, `safety_stock` and `quality_control`. Ours:
+ *
+ *   ours          Shopify        note
+ *   ────────────  ─────────────  ──────────────────────────────────────────────
+ *   onHand        on_hand        identical
+ *   available     available      identical (onHand − reserved)
+ *   reserved      committed      SAME CONCEPT, different word. Ours is the
+ *                                schema name (0034, landed and green); theirs
+ *                                is published beside it by the
+ *                                plg_shop_stock_levels view, which exposes both
+ *                                `reserved` and `committed` columns. Renaming
+ *                                the column instead would have churned an
+ *                                already-green contract suite, the SQL
+ *                                regression, the mirror and the mock for a
+ *                                synonym.
+ *   (a non-sellable location's
+ *    balance)     incoming       we model it as a PLACE (`kind = 'transit'`,
+ *                                `is_sellable = false`) rather than as a fourth
+ *                                number, which is strictly more expressive:
+ *                                two warehouses in transit are two rows.
+ *   (a `loss` movement with
+ *    reason `damaged`) damaged   ours is a ledger entry with a reason code, so
+ *                                it carries when, who and how many; Shopify's
+ *                                is a bucket.
+ *   —             safety_stock   NOT MODELLED. Reorder point and low-stock
+ *                                threshold are §8's "forecasting", deliberately
+ *                                out of scope.
+ *   (a `lot` with status
+ *    'quarantined') quality_control  ours is a lot state, which is more precise:
+ *                                it is a BATCH that is under inspection, not a
+ *                                quantity.
+ *
+ * Where we go BEYOND Shopify we keep it: lots, `expiresAt`, FEFO and serial
+ * tracking have no native Shopify equivalent (merchants buy apps for both), and
+ * they are exactly what artorious and cristinarotondaro need. "Padrão Shopify"
+ * means compatible-by-default, never limited-to. The machine-readable form of
+ * this table is packages/shop/src/inventory/shopify-mapping.ts.
+ */
+export interface StockBalance {
+    id: string;
+    tenantId: string;
+    variantId: string;
+    locationId: string;
+    lotId: string | null;
+    onHand: number;
+    reserved: number;
+    /** onHand − reserved. What the mirror publishes to the storefront. */
+    available: number;
+    updatedAt: string;
+}
+/** A hold. Add-to-cart does NOT reserve; checkout start does (§5). */
+export interface StockReservation {
+    id: string;
+    tenantId: string;
+    variantId: string;
+    locationId: string;
+    lotId: string | null;
+    quantity: number;
+    status: StockReservationStatus;
+    orderId: string | null;
+    cartToken: string | null;
+    /** The TTL that makes pix and boleto honest. */
+    expiresAt: string | null;
+    idempotencyKey: string | null;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * One allocation-strategy vocabulary row
+ * (plg_shop_stock_allocation_strategies). The three behavioural fields are the
+ * ORDERING CONTRACT the engine reads — the same discipline as
+ * StockMovementKind.direction. Widening the vocabulary is a row, not a fork.
+ */
+export interface StockAllocationStrategy {
+    key: string;
+    label: string;
+    /** Order by expiry first, nulls last. FEFO. */
+    expiresFirst: boolean;
+    /** 'asc' = oldest receipt first (FIFO), 'desc' = newest first (LIFO). */
+    receivedOrder: 'asc' | 'desc';
+    /** Nothing is picked automatically; the caller names the lot. */
+    isManual: boolean;
+}
+/** One (lot, location) position allocation may draw from. */
+export interface StockAllocationCandidate {
+    /** null for a quantity-tracked variant's one implicit lot. */
+    lotId: string | null;
+    locationId: string;
+    /** onHand − reserved for this position. */
+    available: number;
+    /** Calendar date, so FEFO order cannot depend on a reader's time zone. */
+    expiresAt: string | null;
+    receivedAt: string;
+    /** Transit stock exists but cannot be promised. Default true. */
+    isSellableLocation?: boolean;
+    /** Breaks ties so the answer is reproducible, not merely correct. */
+    isDefaultLocation?: boolean;
+}
+export interface StockAllocationRequest {
+    variantId: string;
+    quantity: number;
+    tracking: StockTrackingMode;
+    /** Narrow to one location. Omitted, the default location leads. */
+    locationId?: string | null;
+    /** Narrow to one lot — required by the `manual` strategy. */
+    lotId?: string | null;
+    /** Most specific first: explicit, then variant, then store, then derived. */
+    strategy?: string | null;
+    variantStrategy?: string | null;
+    tenantStrategy?: string | null;
+}
+/** One lot chosen, in picking order. They sum to the requested quantity. */
+export interface StockAllocation {
+    lotId: string | null;
+    locationId: string;
+    quantity: number;
+}
+/** What a caller supplies to place a hold. Add-to-cart never calls this (§5). */
+export interface ReserveStockInput {
+    variantId: string;
+    quantity: number;
+    locationId: string;
+    lotId?: string | null;
+    orderId?: string | null;
+    cartToken?: string | null;
+    /** The TTL that makes pix and boleto honest. Omitted ⇒ a hold with no expiry. */
+    ttlMinutes?: number | null;
+    /** A retried checkout must not hold the unit twice. */
+    idempotencyKey?: string | null;
+}
+export interface ListStockBalancesOptions {
+    variantId?: string;
+    variantIds?: string[];
+    locationId?: string;
+    lotId?: string;
+    /** Only rows a shopper could be promised (sellable, active locations). */
+    sellableOnly?: boolean;
+}
+export interface ListStockLotsOptions {
+    variantId?: string;
+    status?: StockLotStatus;
+    /** Lots expiring on or before this date — the "what is about to go off" read. */
+    expiresBefore?: string;
+    /** FEFO order: expiresAt then receivedAt, nulls last. Default true. */
+    fefo?: boolean;
+    limit?: number;
+}
+export interface ListStockMovementsOptions {
+    variantId?: string;
+    lotId?: string;
+    orderId?: string;
+    kind?: string;
+    reasonCode?: string;
+    /** Newest first. Default true — "why is this 3?" reads backwards. */
+    newestFirst?: boolean;
+    limit?: number;
+}
+//# sourceMappingURL=stock-types.d.ts.map

package/dist/inventory/stock-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock-types.d.ts","sourceRoot":"","sources":["../../src/inventory/stock-types.ts"],"names":[],"mappings":"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"}

package/dist/inventory/supabase-stock-store.d.ts

@@ -0,0 +1,60 @@
+import type { StockStore } from './stock-store';
+import type { ListStockBalancesOptions, ListStockLotsOptions, ListStockMovementsOptions, RecordStockMovementInput, ReserveStockInput, StockAllocation, StockAllocationRequest, StockBalance, StockLocation, StockLot, StockMovement, StockReservation, StockReservationStatus } from './stock-types';
+export declare function rowToStockLocation(row: any): StockLocation;
+export declare class SupabaseStockStore implements StockStore {
+    private readonly explicitTenantId?;
+    /**
+     * An explicit tenant pins the store to one pool (what an ERP connector or a
+     * background job needs); omitted, it resolves per call through the same
+     * resolver every other plg_shop_* read uses.
+     */
+    constructor(explicitTenantId?: string | undefined);
+    private tenantId;
+    private requireTenantId;
+    listLocations(): Promise<StockLocation[]>;
+    getDefaultLocation(): Promise<StockLocation | null>;
+    /**
+     * `sellableOnly` filters by an id set read from the locations table rather
+     * than by an embedded `!inner` join. Locations are a handful of rows per
+     * tenant, and the set is the same one mirroredInventoryCount() takes — so the
+     * mock, this store and 0036's mirror all narrow "sellable" through one
+     * definition instead of three query dialects.
+     */
+    listBalances(options?: ListStockBalancesOptions): Promise<StockBalance[]>;
+    getAvailable(variantId: string): Promise<number>;
+    listLots(options?: ListStockLotsOptions): Promise<StockLot[]>;
+    listMovements(options?: ListStockMovementsOptions): Promise<StockMovement[]>;
+    listReservations(variantId?: string): Promise<StockReservation[]>;
+    /**
+     * Append to the ledger. Never an update — a mistake is corrected by an
+     * opposing movement.
+     *
+     * IDEMPOTENCY IS TWO MECHANISMS, not one, and the second is the real one:
+     *
+     *   1. A pre-read on (tenant_id, idempotency_key) returns the existing
+     *      movement. This is the ordinary retry — same caller, seconds later —
+     *      and it costs one cheap indexed SELECT.
+     *   2. A `23505` on the INSERT is caught and re-read. This is the race the
+     *      pre-read cannot cover: two retries in flight at once both miss the
+     *      SELECT and both attempt the INSERT. 0034's partial unique index
+     *      plg_shop_stock_movements_idempotency_key is what turns the loser into
+     *      an error we can recognise instead of a second decrement.
+     *
+     * Without (2) a retried place_order under load decrements twice, which is
+     * precisely the failure the idempotency key exists to prevent.
+     */
+    recordMovement(input: RecordStockMovementInput): Promise<StockMovement>;
+    allocate(request: Omit<StockAllocationRequest, 'tracking'>): Promise<StockAllocation[]>;
+    reserve(input: ReserveStockInput): Promise<StockReservation>;
+    setReservationStatus(reservationId: string, status: StockReservationStatus): Promise<void>;
+    sweepExpiredReservations(variantId?: string): Promise<number>;
+    private findByIdempotencyKey;
+    /** The variant facts the validator needs — tracking is 0034's new column. */
+    private readVariant;
+    private readLot;
+    /** on_hand for one lot across every location — the serial-bound predicate. */
+    private lotOnHand;
+    private sellableLocationIds;
+}
+export declare function createSupabaseStockStore(tenantId?: string): StockStore;
+//# sourceMappingURL=supabase-stock-store.d.ts.map

package/dist/inventory/supabase-stock-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-stock-store.d.ts","sourceRoot":"","sources":["../../src/inventory/supabase-stock-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EAEvB,MAAM,eAAe,CAAA;AAoDtB,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CA0B1D;AAuFD,qBAAa,kBAAmB,YAAW,UAAU;IAMvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAL9C;;;;OAIG;gBAC0B,gBAAgB,CAAC,EAAE,MAAM,YAAA;IAEtD,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,eAAe;IAYjB,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAYzC,kBAAkB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUzD;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmB7E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhD,QAAQ,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuBjE,aAAa,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAqBhF,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAcvE;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoGvE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAmBvF,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwB5D,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1F,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAarD,oBAAoB;IAUlC,6EAA6E;YAC/D,WAAW;YAkBX,OAAO;IAarB,8EAA8E;YAChE,SAAS;YAKT,mBAAmB;CAMlC;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAEtE"}

package/dist/inventory/vocabulary.d.ts

@@ -0,0 +1,86 @@
+import { Registry } from '@fayz-ai/core';
+import type { RegistryMeta } from '@fayz-ai/core';
+import type { RecordStockMovementInput, StockMovementKind, StockReasonCode, StockTrackingMode } from './stock-types';
+/**
+ * The core movement kinds — the SAME rows the 0034 seed inserts with
+ * tenant_id NULL. `direction` is the sign contract:
+ *   in     ⇒ quantity must be positive
+ *   out    ⇒ quantity must be negative
+ *   either ⇒ any non-zero quantity
+ */
+export declare const CORE_STOCK_MOVEMENT_KINDS: readonly StockMovementKind[];
+/**
+ * The core reason codes — the SAME rows migrations 0034 and 0038 seed with
+ * tenant_id NULL. `movementKind` null = valid for any kind.
+ *
+ * The last five arrived with 0038 so that Shopify's CLOSED adjustment-reason
+ * vocabulary maps onto ours without loss (founder: "vamos padrão Shopify").
+ * They are a widening, which is exactly what I9 promises the vocabulary can
+ * take: five INSERTs and five entries here, no migration to the ENGINE and no
+ * fork. The mapping itself is published as code in shopify-mapping.ts, and
+ * stock-store.test.ts fails if a Shopify reason has no target here.
+ */
+export declare const CORE_STOCK_REASON_CODES: readonly StockReasonCode[];
+/** The reason 0035 stamps on every backfilled opening balance. */
+export declare const OPENING_BALANCE_REASON = "opening_balance";
+/** The reason 0036's I10 shim stamps on a translated direct inventory_count write. */
+export declare const LEGACY_WRITE_REASON = "legacy_write";
+export declare const stockMovementKindRegistry: Registry<StockMovementKind>;
+export declare const stockReasonCodeRegistry: Registry<StockReasonCode>;
+/** Idempotent — consumers call before reads, mirroring registerCoreRuleAttributes. */
+export declare function registerCoreStockVocabulary(): void;
+export interface RegisterStockVocabularyOptions {
+    meta?: RegistryMeta;
+    /** Re-registering an existing key is an error unless the caller owns it. */
+    replace?: boolean;
+}
+/**
+ * Widen the movement-kind vocabulary. The SQL half of this is one INSERT into
+ * plg_shop_stock_movement_kinds with the tenant's id.
+ */
+export declare function registerStockMovementKind(kind: StockMovementKind, options?: RegisterStockVocabularyOptions): void;
+/** Widen the reason-code vocabulary — "quebra de vitrine" is a row, not a fork. */
+export declare function registerStockReasonCode(reason: StockReasonCode, options?: RegisterStockVocabularyOptions): void;
+/** The kind for a key, or an I2 hard error naming the valid set. */
+export declare function resolveStockMovementKind(key: string): StockMovementKind;
+/** The reason for a key, or an I2 hard error naming the valid set. */
+export declare function resolveStockReasonCode(key: string): StockReasonCode;
+export declare function listStockMovementKindKeys(): string[];
+export declare function listStockReasonCodeKeys(): string[];
+/** Every kind row, sorted — what an admin form renders itself from. */
+export declare function listStockMovementKinds(): StockMovementKind[];
+/** Every reason row, sorted. Optionally narrowed to one kind, which is exactly
+ *  what the "record a movement" form needs once a kind is chosen. */
+export declare function listStockReasonCodes(movementKind?: string): StockReasonCode[];
+/** Test seam — a suite that widens the vocabulary must not leak into the next. */
+export declare function clearStockVocabulary(): void;
+/** What the validator needs to know about the variant a movement targets. */
+export interface StockMovementVariantFacts {
+    tracking: StockTrackingMode;
+    /** Present only for lot/serial checks. */
+    lot?: {
+        id: string;
+        variantId: string;
+        serial: string | null;
+    } | null;
+    /**
+     * `on_hand` already recorded for (lot, location), needed ONLY by the serial
+     * rule below. Per-movement `|quantity| = 1` is not enough: two `+1` receipts
+     * on the same serial lot are each individually legal and together say the
+     * one-of-one unit exists twice. The cumulative check is what closes that,
+     * and it is the reason this fact has to be read before the write.
+     */
+    lotOnHand?: number;
+}
+/**
+ * Refuse anything the ledger must not accept. This is the TypeScript half of
+ * the specification whose SQL half is `shop_validate_stock_movement()` in
+ * migration 0034 — the two implement ONE ruleset, and
+ * `packages/shop/src/inventory/migrations.test.ts` pins the error vocabulary of
+ * both so they cannot quietly disagree.
+ *
+ * Throws with a message naming the valid set (I2). Never returns a "soft"
+ * failure: a movement that is dropped instead of refused is stock that vanishes.
+ */
+export declare function validateStockMovement(input: RecordStockMovementInput, facts: StockMovementVariantFacts): void;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/inventory/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/inventory/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,eAAe,CAAA;AAsBtB;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,iBAAiB,EASjE,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,eAAe,EAyB7D,CAAA;AAED,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AACvD,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAMjD,eAAO,MAAM,yBAAyB,6BAAuD,CAAA;AAC7F,eAAO,MAAM,uBAAuB,2BAAmD,CAAA;AAIvF,sFAAsF;AACtF,wBAAgB,2BAA2B,IAAI,IAAI,CAmBlD;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,8BAAmC,GAC3C,IAAI,CAqBN;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,8BAAmC,GAC3C,IAAI,CAuBN;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CASvE;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CASnE;AAED,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAGpD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAGlD;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAM5D;AAED;qEACqE;AACrE,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAQ7E;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAID,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,0CAA0C;IAC1C,GAAG,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IACrE;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,yBAAyB,GAC/B,IAAI,CAyFN"}

package/dist/inventory.js

@@ -0,0 +1,4 @@
+export { BEYOND_SHOPIFY, CORE_RESERVATION_TTL_MINUTES, CORE_STOCK_ALLOCATION_STRATEGIES, CORE_STOCK_MOVEMENT_KINDS, CORE_STOCK_REASON_CODES, DEFAULT_STOCK_TRACKING, LEGACY_WRITE_REASON, MockStockStore, OPENING_BALANCE_REASON, OWN_FULFILLMENT, SHOPIFY_ADJUSTMENT_REASONS, SHOPIFY_DEFAULT_OPTION_NAME, SHOPIFY_DEFAULT_VARIANT_TITLE, SHOPIFY_QUANTITY_STATES, STOCK_LOCATION_KINDS, STOCK_LOT_STATUSES, STOCK_MOVEMENT_DIRECTIONS, STOCK_RESERVATION_STATUSES, STOCK_TRACKING_MODES, StockAllocationError, StockMovementError, SupabaseStockStore, TRACKING_MODES_BEYOND_SHOPIFY, allocateStock, clearStockAllocationStrategies, clearStockStores, clearStockVocabulary, compareStockAllocationCandidates, createMockStockStore, createSupabaseStockStore, getRegisteredStockStore, listStockAllocationStrategies, listStockAllocationStrategyKeys, listStockMovementKindKeys, listStockMovementKinds, listStockReasonCodeKeys, listStockReasonCodes, mirroredInventoryCount, registerCoreStockAllocationStrategies, registerCoreStockVocabulary, registerStockAllocationStrategy, registerStockMovementKind, registerStockReasonCode, registerStockStore, replayStockLedger, resolveAllocationStrategyKey, resolveReservationTtlMinutes, resolveStockAllocationStrategy, resolveStockMovementKind, resolveStockReasonCode, resolveStockStore, shopifyDefaultOptions, shopifyReasonToStockReason, stockAllocationStrategyRegistry, stockBalanceKey, stockMovementKindRegistry, stockReasonCodeRegistry, toShopifyVariantTitle, validateStockMovement } from './chunk-STRNMFC4.js';
+import './chunk-KLDS7IPU.js';
+//# sourceMappingURL=inventory.js.map
+//# sourceMappingURL=inventory.js.map

package/dist/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"inventory.js"}

package/dist/lib/catalog.d.ts

@@ -0,0 +1,4 @@
+export { MOCK_PRODUCTS, MOCK_CATEGORIES, MOCK_DISCOUNTS, svgPlaceholder } from '../data/mock-catalog';
+export { buildMockCatalog } from '../data/mock-catalog';
+export type { CatalogInput, CatalogProductInput, CatalogCategoryInput } from '../data/mock-catalog';
+//# sourceMappingURL=catalog.d.ts.map

package/dist/lib/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/lib/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/{commerce.d.ts → lib/commerce.d.ts}

@@ -1,5 +1,5 @@
-import type { ShopProvider } from './provider';
-import type { CartTotals, DiscountValidation, InventoryCheck, InventoryLine, Order } from './types';
+import type { ShopProvider } from '../data/provider';
+import type { CartTotals, DiscountValidation, InventoryCheck, InventoryLine, Order } from '../types';
 /** Validate a discount code against the provider: existence, status, date window, usage limit, supported type. */
 export declare function validateDiscount(input: {
     code: string;

package/dist/lib/commerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../src/lib/commerce.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAkB,aAAa,EAAE,KAAK,EACrF,MAAM,UAAU,CAAA;AAkBjB,kHAAkH;AAClH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/D,QAAQ,GAAE,YAAgC,GACzC,OAAO,CAAC,kBAAkB,CAAC,CA0B7B;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAS9H;AAED,8FAA8F;AAC9F,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,GAAE,YAAgC,GACzC,OAAO,CAAC,cAAc,CAAC,CAazB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAChG,QAAQ,GAAE,YAAgC,GACzC,OAAO,CAAC,UAAU,CAAC,CA2BrB;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,YAAgC,GACzC,OAAO,CAAC,KAAK,EAAE,CAAC,CAElB"}

package/dist/lib/document.d.ts

@@ -0,0 +1,13 @@
+export type DocumentKind = 'cpf' | 'cnpj';
+export declare const documentDigits: (value: string | null | undefined) => string;
+export declare function isValidCpf(value: string | null | undefined): boolean;
+export declare function isValidCnpj(value: string | null | undefined): boolean;
+/** Which document this is, by length — `null` when it is neither yet. */
+export declare function documentKind(value: string | null | undefined): DocumentKind | null;
+export declare function isValidDocument(value: string | null | undefined): boolean;
+/**
+ * Progressive mask: formats what is typed so far and never blocks typing.
+ * A mask that only formats complete input leaves the field jumping at the end.
+ */
+export declare function formatDocument(value: string | null | undefined): string;
+//# sourceMappingURL=document.d.ts.map

package/dist/lib/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/lib/document.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAA;AAEzC,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAC1B,CAAA;AAcxC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CASpE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAOrE;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAKlF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAavE"}

package/dist/lib/emails.d.ts

@@ -0,0 +1,50 @@
+import type { EmailEventKey, EmailTemplate, EmailTemplateKind } from '../types';
+export interface EmailEventDef {
+    event: EmailEventKey;
+    kind: EmailTemplateKind;
+    /** Template name in the list. */
+    title: string;
+    /** What it does, in one line. */
+    description: string;
+    /** When it fires — the "event" half of the pair. */
+    trigger: string;
+    defaultSubject: string;
+    defaultBody: string;
+    /** lucide icon for the row. */
+    icon: string;
+    /** On by default in a new store. Order confirmation is the only email a buyer
+     *  EXPECTS; the rest are the merchant's choice. */
+    defaultEnabled: boolean;
+}
+/** Placeholders the send substitutes. Documented here because this is what the
+ *  merchant may type in the editor without breaking anything. */
+export declare const EMAIL_PLACEHOLDERS: readonly ["{{store_name}}", "{{customer_name}}", "{{order_number}}", "{{order_total}}", "{{order_items}}", "{{tracking_code}}", "{{cart_url}}"];
+export declare const SHOP_EMAIL_EVENTS: EmailEventDef[];
+/**
+ * Substitutes the placeholders. Beside the catalog because PREVIEW and SEND must
+ * agree: a screen doing its own `replace` has the merchant approve one text and
+ * the customer receive another.
+ *
+ * An unknown placeholder stays visible as `{{foo}}` on purpose — in the preview
+ * that exposes the typo; hiding it would hide the gap until the email had gone.
+ */
+export declare function renderEmailTemplate(text: string, values: Record<string, string>): string;
+/** Sample data for the preview. From no real order — the screen says so. */
+export declare const EMAIL_PREVIEW_SAMPLE: Record<string, string>;
+export interface ResolvedEmailTemplate extends EmailEventDef {
+    /** The merchant's override, when there is one. */
+    override: EmailTemplate | null;
+    enabled: boolean;
+    /** Text in force: the merchant's if any, else the default. */
+    subject: string;
+    body: string;
+    /** true when the merchant rewrote the text — the list flags it. */
+    customized: boolean;
+}
+/**
+ * Joins the code catalog with the database overrides. A function and not a
+ * query: the merge must give the same answer in the list, the editor and the
+ * send, and three places doing the same `??` is how they start to disagree.
+ */
+export declare function resolveEmailTemplates(overrides: EmailTemplate[]): ResolvedEmailTemplate[];
+//# sourceMappingURL=emails.d.ts.map

package/dist/lib/emails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emails.d.ts","sourceRoot":"","sources":["../../src/lib/emails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAe/E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,iBAAiB,CAAA;IACvB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ;uDACmD;IACnD,cAAc,EAAE,OAAO,CAAA;CACxB;AAED;iEACiE;AACjE,eAAO,MAAM,kBAAkB,iJAGrB,CAAA;AAEV,eAAO,MAAM,iBAAiB,EAAE,aAAa,EAiF5C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAExF;AAED,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQvD,CAAA;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,kDAAkD;IAClD,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,qBAAqB,EAAE,CAazF"}

package/dist/lib/message-events.d.ts

@@ -0,0 +1,4 @@
+import type { PluginEventDefinition, MessageDefaultsDef } from '@fayz-ai/core';
+export declare function buildShopDomainEvents(): PluginEventDefinition[];
+export declare function buildShopMessageDefaults(): MessageDefaultsDef[];
+//# sourceMappingURL=message-events.d.ts.map

package/dist/lib/message-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-events.d.ts","sourceRoot":"","sources":["../../src/lib/message-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAc,MAAM,eAAe,CAAA;AA8C1F,wBAAgB,qBAAqB,IAAI,qBAAqB,EAAE,CAU/D;AAeD,wBAAgB,wBAAwB,IAAI,kBAAkB,EAAE,CAiB/D"}

package/dist/lib/runtime.d.ts

@@ -0,0 +1,5 @@
+import type { ShopProvider } from '../data/provider';
+export declare function getShopProvider(): ShopProvider;
+export declare function setShopProvider(nextProvider: ShopProvider): void;
+export declare function resetShopProvider(): void;
+//# sourceMappingURL=runtime.d.ts.map