@fayz-ai/plugin-inventory 0.18.16 → 0.19.1

package/dist/migrations/index.d.ts

@@ -29,6 +29,7 @@ export declare const MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM = "-- =
 export declare const MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT = "-- ============================================================================\n-- 028 \u2014 a receipt keeps the variant\n--\n-- `inventory_receive` read `variant_id` off each line, checked it belonged to\n-- the product, and then did not write it: every receipt landed on the\n-- product's default variant. A shirt received as 10 M and 9 G was 19 of\n-- \"Padr\u00E3o\". The line's variant now reaches the ledger row, which is what the\n-- per-variant balance is computed from.\n--\n-- Patched in place, as 026 and 027 did.\n--\n-- The column itself was never in this plugin's chain (022 says so): pools got\n-- it by hand, a database built from zero did not. It is declared here, in the\n-- shape the pools have. The value is read off the line's JSON, which exists in\n-- every version of the function; `v_ln.variant_id` only exists where the\n-- parser was widened by hand.\n-- ============================================================================\n\nALTER TABLE public.plg_inventory_stock_movements\n  ADD COLUMN IF NOT EXISTS variant_id uuid REFERENCES public.product_variants(id) ON DELETE SET NULL;\nCREATE INDEX IF NOT EXISTS plg_inventory_stock_movements_variant_idx\n  ON public.plg_inventory_stock_movements (tenant_id, variant_id) WHERE variant_id IS NOT NULL;\n\nDO $patch$\nDECLARE\n  v_fn  regprocedure := 'public.inventory_receive(uuid, jsonb, jsonb, text)'::regprocedure;\n  v_def text := pg_get_functiondef(v_fn);\n  v_cols constant text := 'source_item_type, source_item_id)';\n  v_vals constant text := 'nullif(v_line->>''source_item_id'', '''')::uuid)';\nBEGIN\n  IF position('source_item_type, source_item_id, variant_id)' in v_def) > 0 THEN\n    RETURN;  -- already writes it (a replay, or a later rewrite)\n  END IF;\n  IF position(v_cols in v_def) = 0 OR position(v_vals in v_def) = 0 THEN\n    RAISE EXCEPTION '028: inventory_receive no longer has the INSERT this extends; patch it by hand';\n  END IF;\n  v_def := overlay(v_def PLACING 'source_item_type, source_item_id, variant_id)'\n                   FROM position(v_cols in v_def) FOR length(v_cols));\n  v_def := overlay(v_def PLACING 'nullif(v_line->>''source_item_id'', '''')::uuid, nullif(v_line->>''variant_id'', '''')::uuid)'\n                   FROM position(v_vals in v_def) FOR length(v_vals));\n  EXECUTE v_def;\nEND $patch$;\n";
 export declare const MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT = "-- ============================================================================\n-- 029 \u2014 a reversal undoes the same variant\n--\n-- 028 made a receipt keep the variant it was for. `inventory_reverse` copies\n-- the row it undoes and left the variant out, so undoing \"6 of M\" tried to\n-- take 6 from the product's default variant \u2014 which has none, and the\n-- reversal was refused (\"would take variant \u2026 below zero\"). A receipt by size\n-- could be made and never corrected.\n--\n-- The reversal now carries the variant of the row it reverses.\n-- Patched in place, like 026\u2013028.\n-- ============================================================================\n\nDO $patch$\nDECLARE\n  v_fn  regprocedure := 'public.inventory_reverse(text, text)'::regprocedure;\n  v_def text := pg_get_functiondef(v_fn);\n  v_new text;\n  -- The function has two INSERTs (one per branch); both copy the row they undo.\n  v_cols  constant text := 'reverses_movement_id, idempotency_key, line_no, operation_id, metadata)';\n  v_vals1 constant text := 'jsonb_build_object(''reversed_movement_id'', r.id))';\n  v_vals2 constant text := '''reversed_kind'', r.kind))';\nBEGIN\n  IF position('r.variant_id' in v_def) > 0 THEN\n    RETURN;  -- already carries it (a replay, or a later rewrite)\n  END IF;\n  v_new := replace(v_def, v_cols, 'reverses_movement_id, idempotency_key, line_no, operation_id, metadata, variant_id)');\n  v_new := replace(v_new, v_vals1, 'jsonb_build_object(''reversed_movement_id'', r.id), r.variant_id)');\n  v_new := replace(v_new, v_vals2, '''reversed_kind'', r.kind), r.variant_id)');\n  -- Every INSERT that gained the column must have gained the value.\n  IF (length(v_new) - length(replace(v_new, 'metadata, variant_id)', ''))) / length('metadata, variant_id)')\n     <> (length(v_new) - length(replace(v_new, ', r.variant_id)', ''))) / length(', r.variant_id)')\n     OR position('metadata, variant_id)' in v_new) = 0 THEN\n    RAISE EXCEPTION '029: inventory_reverse no longer has the INSERTs this extends; patch it by hand';\n  END IF;\n  EXECUTE v_new;\nEND $patch$;\n";
 export declare const MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED = "-- ============================================================================\n-- 030 \u2014 the minimum can be saved\n--\n-- The product form saves its minimum with an upsert on\n-- (tenant_id, product_id, unit_id). The only unique index on those columns\n-- was the expression index (tenant_id, product_id, COALESCE(unit_id, zero)),\n-- which ON CONFLICT cannot infer from a column list, so every save came back\n-- 42P10 and the client never looked at the error: \"Quantidade M\u00EDnima\" was\n-- dropped in silence.\n--\n-- A plain column index with NULLS NOT DISTINCT is an arbiter for that\n-- conflict target and treats the tenant-wide row (unit_id NULL) as one row,\n-- which is what the expression index already enforced. Both are kept: they\n-- agree on every row, and dropping the old one is not this fix's business.\n--\n-- Hand-applied on cluster-squash-test on 2026-10-22 under this same name, so\n-- this file must be a no-op there.\n--\n-- Second part: the Insumo tab had its own minimum/maximum, stored on\n-- plg_inventory_product_ingredient_info, which no alert or restock list\n-- reads. The tab no longer offers them. Whatever was typed there is copied\n-- into the tenant-wide settings row when the product has none yet, so the\n-- number the person entered becomes the one that is acted on. The columns\n-- stay; nothing is dropped.\n-- ============================================================================\n\nCREATE UNIQUE INDEX IF NOT EXISTS plg_inventory_product_settings_upsert_key\n  ON public.plg_inventory_product_settings (tenant_id, product_id, unit_id) NULLS NOT DISTINCT;\n\nINSERT INTO public.plg_inventory_product_settings (tenant_id, product_id, unit_id, min_quantity, max_quantity)\nSELECT i.tenant_id,\n       i.product_id,\n       NULL,\n       GREATEST(COALESCE(i.minimum_quantity, 0), 0),\n       CASE WHEN i.maximum_quantity >= 0 THEN i.maximum_quantity END\n  FROM public.plg_inventory_product_ingredient_info i\n  JOIN public.products p ON p.id = i.product_id AND p.tenant_id = i.tenant_id\n WHERE (COALESCE(i.minimum_quantity, 0) > 0 OR i.maximum_quantity IS NOT NULL)\n   AND NOT EXISTS (\n         SELECT 1\n           FROM public.plg_inventory_product_settings s\n          WHERE s.tenant_id = i.tenant_id\n            AND s.product_id = i.product_id\n            AND s.unit_id IS NULL)\nON CONFLICT (tenant_id, product_id, unit_id) DO NOTHING;\n";
+export declare const MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW = "-- ============================================================================\n-- 031 \u2014 the stock says when it runs low\n--\n-- A product's minimum (plg_inventory_product_settings.min_quantity) only ever\n-- fed a count and a filter: \"estoque baixo\" was something you found by opening\n-- the Estoque screen or asking the assistant. Nothing told anyone.\n--\n-- Now the moment a product's balance CROSSES its minimum \u2014 from above it to at\n-- or below it \u2014 the database records the fact `inventory.stock_low` in the\n-- event log, with what anyone acting on it needs: the product, the scope, the\n-- balance and the minimum. That is all it does.\n--\n-- WHO is told and HOW is not decided here (ADR 0003, \"where logic lives\"):\n-- the Integration service reads these facts, rings the bell for whoever can\n-- read the stock \u2014 asking this database who that is \u2014 and is where WhatsApp\n-- or e-mail would be added. The detection stays here because only the\n-- transaction that moves the stock sees the balance before and after it.\n--\n-- The rules are the ones v_inventory_low_stock already states, so the alert and\n-- the screen never disagree:\n--   - a minimum applies when it is > 0;\n--   - \"low\" is on_hand <= min_quantity;\n--   - a settings row with unit_id set watches that unit's positions; the row\n--     with unit_id NULL watches the product across the whole tenant.\n--\n-- EDGE, not level. The fact is the crossing, not every movement while the\n-- product stays low \u2014 selling the tenth bottle of a product already at its\n-- minimum must not tell anyone ten times. It re-arms by itself: once a receipt\n-- lifts the balance above the minimum, the next fall is recorded again. The same crossing\n-- is checked when the minimum itself changes: raising it above what is on the\n-- shelf is as much \"this is now low\" as selling down to it.\n--\n-- PER TRANSACTION, not per statement. Every position write goes through\n-- app.inventory_apply_to_position, one position per call, so a transfer is two\n-- statements \u2014 the source goes down, then the destination goes up \u2014 and a\n-- recipe consumes ingredient by ingredient. Checked per statement, a transfer\n-- between two units of a product sitting near its minimum would dip the tenant\n-- total in between and report a crossing for a balance that never changed. So:\n--   - a BEFORE row trigger records, on the first touch of a transaction, the\n--     balance of each scope it touches (the product across the tenant, and the\n--     unit) in a transaction-local setting \u2014 that is the balance BEFORE;\n--   - a DEFERRED constraint trigger runs at COMMIT, when every statement of\n--     the transaction has landed, compares each minimum's scope against what\n--     was recorded, records a crossing, and moves the record forward so the\n--     other rows of the same commit do not record it again.\n\n-- A failure here never takes the stock write with it: everything runs inside\n-- exception blocks that only warn.\n-- ============================================================================\n\n-- Record one minimum that has just been crossed.\nCREATE OR REPLACE FUNCTION app.inventory_record_stock_low(\n  p_setting_id uuid,\n  p_tenant_id  uuid,\n  p_product_id uuid,\n  p_unit_id    uuid,\n  p_on_hand    numeric,\n  p_min        numeric\n)\nRETURNS void\nLANGUAGE plpgsql\nSECURITY DEFINER\nSET search_path TO ''\nAS $$\nDECLARE\n  v_name    text;\n  v_measure text;\n  v_unit    text;\nBEGIN\n  BEGIN\n    SELECT pl.name INTO v_name FROM app.inventory_product_label(p_product_id) pl(name, sku);\n    SELECT nullif(btrim(coalesce(p.unit, '')), '') INTO v_measure\n      FROM public.products p WHERE p.id = p_product_id;\n    IF p_unit_id IS NOT NULL THEN\n      SELECT u.name INTO v_unit FROM app.units u WHERE u.id = p_unit_id;\n    END IF;\n\n    PERFORM public.plg_emit_event(\n      'inventory.stock_low',\n      jsonb_build_object(\n        'settingId', p_setting_id,\n        'productId', p_product_id,\n        'productName', v_name,\n        'measure', v_measure,\n        'unitId', p_unit_id,\n        'unitName', v_unit,\n        'onHand', p_on_hand,\n        'minQuantity', p_min),\n      'product', p_product_id::text, p_tenant_id);\n  EXCEPTION WHEN OTHERS THEN\n    RAISE WARNING 'inventory_record_stock_low: %', SQLERRM;\n  END;\nEND;\n$$;\n\n-- The balance a minimum watches: the unit's positions, or the tenant's.\nCREATE OR REPLACE FUNCTION app.inventory_scope_on_hand(p_tenant_id uuid, p_product_id uuid, p_unit_id uuid)\nRETURNS numeric\nLANGUAGE sql\nSTABLE\nSECURITY DEFINER\nSET search_path TO ''\nAS $$\n  SELECT coalesce(sum(p.quantity), 0)\n    FROM public.plg_inventory_stock_positions p\n   WHERE p.tenant_id = p_tenant_id\n     AND p.product_id = p_product_id\n     AND (p_unit_id IS NULL OR p.unit_id = p_unit_id);\n$$;\n\n-- The transaction-local setting holding a scope's balance before this\n-- transaction. md5 keeps the name a plain identifier of fixed length.\nCREATE OR REPLACE FUNCTION app.inventory_low_stock_key(p_tenant_id uuid, p_product_id uuid, p_unit_id uuid)\nRETURNS text\nLANGUAGE sql\nIMMUTABLE\nSET search_path TO ''\nAS $$\n  SELECT 'fayz_low_stock.s' || md5(p_tenant_id::text || '|' || p_product_id::text || '|' || coalesce(p_unit_id::text, '*'));\n$$;\n\n-- BEFORE each position write: remember the balances as they were when this\n-- transaction first touched them. A key already set means \"already touched\".\nCREATE OR REPLACE FUNCTION app.trg_inventory_positions_low_stock_snapshot()\nRETURNS trigger\nLANGUAGE plpgsql\nSECURITY DEFINER\nSET search_path TO ''\nAS $$\nDECLARE\n  r   record;\n  v_k text;\nBEGIN\n  BEGIN\n    FOR r IN\n      SELECT DISTINCT x.tenant_id, x.product_id, x.unit_id\n        FROM (SELECT NEW.tenant_id, NEW.product_id, NEW.unit_id WHERE TG_OP <> 'DELETE'\n              UNION ALL\n              SELECT OLD.tenant_id, OLD.product_id, OLD.unit_id WHERE TG_OP <> 'INSERT') AS x(tenant_id, product_id, unit_id)\n       WHERE x.tenant_id IS NOT NULL AND x.product_id IS NOT NULL\n    LOOP\n      v_k := app.inventory_low_stock_key(r.tenant_id, r.product_id, NULL);\n      IF coalesce(current_setting(v_k, true), '') = '' THEN\n        PERFORM set_config(v_k, app.inventory_scope_on_hand(r.tenant_id, r.product_id, NULL)::text, true);\n      END IF;\n      IF r.unit_id IS NOT NULL THEN\n        v_k := app.inventory_low_stock_key(r.tenant_id, r.product_id, r.unit_id);\n        IF coalesce(current_setting(v_k, true), '') = '' THEN\n          PERFORM set_config(v_k, app.inventory_scope_on_hand(r.tenant_id, r.product_id, r.unit_id)::text, true);\n        END IF;\n      END IF;\n    END LOOP;\n  EXCEPTION WHEN OTHERS THEN\n    RAISE WARNING 'trg_inventory_positions_low_stock_snapshot: %', SQLERRM;\n  END;\n  RETURN CASE WHEN TG_OP = 'DELETE' THEN OLD ELSE NEW END;\nEND;\n$$;\n\n-- At COMMIT, once per written row: every minimum of the row's product whose\n-- scope this transaction touched is compared against the recorded balance.\nCREATE OR REPLACE FUNCTION app.trg_inventory_positions_low_stock_check()\nRETURNS trigger\nLANGUAGE plpgsql\nSECURITY DEFINER\nSET search_path TO ''\nAS $$\nDECLARE\n  v_tenant  uuid;\n  v_product uuid;\n  s         record;\n  v_k       text;\n  v_before  text;\n  v_now     numeric;\nBEGIN\n  -- Everything, the reads of OLD/NEW included, inside the block that only\n  -- warns: this runs at COMMIT, and an error here would undo the sale.\n  BEGIN\n    IF TG_OP = 'DELETE' THEN\n      v_tenant := OLD.tenant_id; v_product := OLD.product_id;\n    ELSE\n      v_tenant := NEW.tenant_id; v_product := NEW.product_id;\n    END IF;\n    FOR s IN\n      SELECT st.id, st.tenant_id, st.product_id, st.unit_id, st.min_quantity\n        FROM public.plg_inventory_product_settings st\n       WHERE st.tenant_id = v_tenant AND st.product_id = v_product AND st.min_quantity > 0\n    LOOP\n      v_k := app.inventory_low_stock_key(s.tenant_id, s.product_id, s.unit_id);\n      v_before := current_setting(v_k, true);\n      CONTINUE WHEN coalesce(v_before, '') = '';\n      v_now := app.inventory_scope_on_hand(s.tenant_id, s.product_id, s.unit_id);\n      IF v_now <= s.min_quantity AND v_before::numeric > s.min_quantity THEN\n        PERFORM app.inventory_record_stock_low(\n          s.id, s.tenant_id, s.product_id, s.unit_id, v_now, s.min_quantity);\n      END IF;\n      -- Forward: the next row of this commit compares against now.\n      PERFORM set_config(v_k, v_now::text, true);\n    END LOOP;\n  EXCEPTION WHEN OTHERS THEN\n    RAISE WARNING 'trg_inventory_positions_low_stock_check: %', SQLERRM;\n  END;\n  RETURN NULL;\nEND;\n$$;\n\nDROP TRIGGER IF EXISTS plg_inventory_stock_positions_low_stock_snapshot ON public.plg_inventory_stock_positions;\nCREATE TRIGGER plg_inventory_stock_positions_low_stock_snapshot\n  BEFORE INSERT OR UPDATE OR DELETE ON public.plg_inventory_stock_positions\n  FOR EACH ROW EXECUTE FUNCTION app.trg_inventory_positions_low_stock_snapshot();\n\nDROP TRIGGER IF EXISTS plg_inventory_stock_positions_low_stock_check ON public.plg_inventory_stock_positions;\nCREATE CONSTRAINT TRIGGER plg_inventory_stock_positions_low_stock_check\n  AFTER INSERT OR UPDATE OR DELETE ON public.plg_inventory_stock_positions\n  DEFERRABLE INITIALLY DEFERRED\n  FOR EACH ROW EXECUTE FUNCTION app.trg_inventory_positions_low_stock_check();\n\n-- The minimum moved: low now and not low under the old minimum is a crossing.\n-- A new minimum on a product that has never been stocked is not a crossing.\nCREATE OR REPLACE FUNCTION app.trg_inventory_minimum_check_low_stock()\nRETURNS trigger\nLANGUAGE plpgsql\nSECURITY DEFINER\nSET search_path TO ''\nAS $$\nDECLARE\n  v_on_hand numeric;\n  v_old_min numeric := 0;\nBEGIN\n  BEGIN\n    IF TG_OP = 'UPDATE' THEN v_old_min := OLD.min_quantity; END IF;\n    IF coalesce(NEW.min_quantity, 0) <= 0 THEN RETURN NULL; END IF;\n    -- A minimum set on a product nobody has stocked yet is the product being\n    -- registered, not stock running out: every new item would be reported\n    -- low before its first receipt. Only a product with positions counts.\n    IF TG_OP = 'INSERT' AND NOT EXISTS (\n         SELECT 1 FROM public.plg_inventory_stock_positions p\n          WHERE p.tenant_id = NEW.tenant_id AND p.product_id = NEW.product_id) THEN\n      RETURN NULL;\n    END IF;\n    v_on_hand := app.inventory_scope_on_hand(NEW.tenant_id, NEW.product_id, NEW.unit_id);\n    IF v_on_hand <= NEW.min_quantity\n       AND NOT (coalesce(v_old_min, 0) > 0 AND v_on_hand <= v_old_min) THEN\n      PERFORM app.inventory_record_stock_low(\n        NEW.id, NEW.tenant_id, NEW.product_id, NEW.unit_id, v_on_hand, NEW.min_quantity);\n    END IF;\n  EXCEPTION WHEN OTHERS THEN\n    RAISE WARNING 'trg_inventory_minimum_check_low_stock: %', SQLERRM;\n  END;\n  RETURN NULL;\nEND;\n$$;\n\nDROP TRIGGER IF EXISTS plg_inventory_product_settings_low_stock ON public.plg_inventory_product_settings;\nCREATE TRIGGER plg_inventory_product_settings_low_stock\n  AFTER INSERT OR UPDATE OF min_quantity ON public.plg_inventory_product_settings\n  FOR EACH ROW EXECUTE FUNCTION app.trg_inventory_minimum_check_low_stock();\n\n-- Internal machinery: nobody calls these over PostgREST.\nREVOKE ALL ON FUNCTION app.inventory_low_stock_key(uuid, uuid, uuid) FROM PUBLIC;\nREVOKE ALL ON FUNCTION app.inventory_record_stock_low(uuid, uuid, uuid, uuid, numeric, numeric) FROM PUBLIC;\nREVOKE ALL ON FUNCTION app.inventory_scope_on_hand(uuid, uuid, uuid) FROM PUBLIC;\nREVOKE ALL ON FUNCTION app.trg_inventory_positions_low_stock_snapshot() FROM PUBLIC;\nREVOKE ALL ON FUNCTION app.trg_inventory_positions_low_stock_check() FROM PUBLIC;\nREVOKE ALL ON FUNCTION app.trg_inventory_minimum_check_low_stock() FROM PUBLIC;\n";
 export declare const MIGRATIONS: Array<{
     id: string;
     sql: string;

package/dist/migrations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,yn7NAy+GlC,CAAA;AAED,eAAO,MAAM,sDAAsD,g0bA+QlE,CAAA;AAED,eAAO,MAAM,uCAAuC,ymbAsRnD,CAAA;AAED,eAAO,MAAM,+CAA+C,+zNAmK3D,CAAA;AAED,eAAO,MAAM,4CAA4C,szYAsLxD,CAAA;AAED,eAAO,MAAM,mDAAmD,g5JA0E/D,CAAA;AAED,eAAO,MAAM,4CAA4C,60nBAuUxD,CAAA;AAED,eAAO,MAAM,kCAAkC,oxSA+L9C,CAAA;AAED,eAAO,MAAM,qDAAqD,6yCA0BjE,CAAA;AAED,eAAO,MAAM,uDAAuD,s+XA4KnE,CAAA;AAED,eAAO,MAAM,0CAA0C,gm4BA4atD,CAAA;AAED,eAAO,MAAM,wCAAwC,y43BAsgBpD,CAAA;AAED,eAAO,MAAM,sEAAsE,o1ZAmRlF,CAAA;AAED,eAAO,MAAM,gDAAgD,2uXAmQ5D,CAAA;AAED,eAAO,MAAM,yCAAyC,umXA6PrD,CAAA;AAED,eAAO,MAAM,6CAA6C,w9WA2PzD,CAAA;AAED,eAAO,MAAM,4CAA4C,k8XAoQxD,CAAA;AAED,eAAO,MAAM,8CAA8C,okPA4K1D,CAAA;AAED,eAAO,MAAM,qCAAqC,umWAqPjD,CAAA;AAED,eAAO,MAAM,oCAAoC,skQA0LhD,CAAA;AAED,eAAO,MAAM,sDAAsD,6ufAwTlE,CAAA;AAED,eAAO,MAAM,sCAAsC,onPAsIlD,CAAA;AAED,eAAO,MAAM,+CAA+C,o9JAiF3D,CAAA;AAED,eAAO,MAAM,gDAAgD,myCAoB5D,CAAA;AAED,eAAO,MAAM,kDAAkD,otFAuD9D,CAAA;AAED,eAAO,MAAM,yCAAyC,25eAgTrD,CAAA;AAED,eAAO,MAAM,2CAA2C,2tOAwIvD,CAAA;AAED,eAAO,MAAM,mDAAmD,+5DAoC/D,CAAA;AAED,eAAO,MAAM,yCAAyC,4xEA0CrD,CAAA;AAED,eAAO,MAAM,gDAAgD,ikEAqC5D,CAAA;AAED,eAAO,MAAM,sCAAsC,02EA6ClD,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAgCzD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,yn7NAy+GlC,CAAA;AAED,eAAO,MAAM,sDAAsD,g0bA+QlE,CAAA;AAED,eAAO,MAAM,uCAAuC,ymbAsRnD,CAAA;AAED,eAAO,MAAM,+CAA+C,+zNAmK3D,CAAA;AAED,eAAO,MAAM,4CAA4C,szYAsLxD,CAAA;AAED,eAAO,MAAM,mDAAmD,g5JA0E/D,CAAA;AAED,eAAO,MAAM,4CAA4C,60nBAuUxD,CAAA;AAED,eAAO,MAAM,kCAAkC,oxSA+L9C,CAAA;AAED,eAAO,MAAM,qDAAqD,6yCA0BjE,CAAA;AAED,eAAO,MAAM,uDAAuD,s+XA4KnE,CAAA;AAED,eAAO,MAAM,0CAA0C,gm4BA4atD,CAAA;AAED,eAAO,MAAM,wCAAwC,y43BAsgBpD,CAAA;AAED,eAAO,MAAM,sEAAsE,o1ZAmRlF,CAAA;AAED,eAAO,MAAM,gDAAgD,2uXAmQ5D,CAAA;AAED,eAAO,MAAM,yCAAyC,umXA6PrD,CAAA;AAED,eAAO,MAAM,6CAA6C,w9WA2PzD,CAAA;AAED,eAAO,MAAM,4CAA4C,k8XAoQxD,CAAA;AAED,eAAO,MAAM,8CAA8C,okPA4K1D,CAAA;AAED,eAAO,MAAM,qCAAqC,umWAqPjD,CAAA;AAED,eAAO,MAAM,oCAAoC,skQA0LhD,CAAA;AAED,eAAO,MAAM,sDAAsD,6ufAwTlE,CAAA;AAED,eAAO,MAAM,sCAAsC,onPAsIlD,CAAA;AAED,eAAO,MAAM,+CAA+C,o9JAiF3D,CAAA;AAED,eAAO,MAAM,gDAAgD,myCAoB5D,CAAA;AAED,eAAO,MAAM,kDAAkD,otFAuD9D,CAAA;AAED,eAAO,MAAM,yCAAyC,25eAgTrD,CAAA;AAED,eAAO,MAAM,2CAA2C,2tOAwIvD,CAAA;AAED,eAAO,MAAM,mDAAmD,+5DAoC/D,CAAA;AAED,eAAO,MAAM,yCAAyC,4xEA0CrD,CAAA;AAED,eAAO,MAAM,gDAAgD,ikEAqC5D,CAAA;AAED,eAAO,MAAM,sCAAsC,02EA6ClD,CAAA;AAED,eAAO,MAAM,6CAA6C,ghXAyQzD,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAiCzD,CAAA"}

package/dist/migrations/main.browser.js

@@ -30,8 +30,9 @@ var MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM = "";
 var MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT = "";
 var MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT = "";
 var MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED = "";
+var MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW = "";
 var MIGRATIONS = [];
 
-export { MIGRATIONS, MIGRATION_000_BASELINE, MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED, MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE, MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER, MIGRATION_004_A_POSICAO_DE_ESTOQUE_ATRAVESSA, MIGRATION_005_A_POSICAO_E_CONSEQUENCIA_DO_MOVIMENTO, MIGRATION_006_A_PRODUCAO_TEM_ORDEM_E_ESTACAO, MIGRATION_007_A_PRODUCAO_ATRAVESSA, MIGRATION_008_O_GRUPO_DA_RECEITA_TAMBEM_E_DE_UMA_CASA, MIGRATION_009_A_DIRECAO_DO_MOVIMENTO_NAO_ESTA_NO_NUMERO, MIGRATION_010_A_ENTRADA_DE_NOTAS_ATRAVESSA, MIGRATION_011_O_CONSUMO_TEM_DUAS_ORIGENS, MIGRATION_012_O_CONSUMO_CLINICO_NAO_PRECISA_DA_TABELA_DE_ITENS_INTEIRA, MIGRATION_013_A_FILA_DE_AUDITORIA_TEM_UMA_JANELA, MIGRATION_014_A_SESSAO_SE_BUSCA_UMA_A_UMA, MIGRATION_015_LATERAL_SEM_CERCA_NAO_E_LATERAL, MIGRATION_016_A_DATA_DO_CONSUMO_E_UMA_COLUNA, MIGRATION_017_APROVAR_E_BAIXAR_SAO_DOIS_GESTOS, MIGRATION_018_O_NOME_NAO_SAI_DA_VISTA, MIGRATION_019_SEM_SALDO_NAO_SE_BAIXA, MIGRATION_020_O_PRODUTO_E_VARIAS_COISAS_AO_MESMO_TEMPO, MIGRATION_021_O_RAZAO_DIZ_DE_ONDE_VEIO, MIGRATION_022_RECEBER_ESTOQUE_VOLTA_A_FUNCIONAR, MIGRATION_023_A_RECEITA_SE_ESCREVE_COM_PERMISSAO, MIGRATION_024_A_CATEGORIA_DO_PRODUTO_E_DO_CATALOGO, MIGRATION_025_A_FICHA_TECNICA_POR_ESTACAO, MIGRATION_026_STOCK_COST_KNOWS_ITS_CURRENCY, MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM, MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT, MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT, MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED };
+export { MIGRATIONS, MIGRATION_000_BASELINE, MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED, MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE, MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER, MIGRATION_004_A_POSICAO_DE_ESTOQUE_ATRAVESSA, MIGRATION_005_A_POSICAO_E_CONSEQUENCIA_DO_MOVIMENTO, MIGRATION_006_A_PRODUCAO_TEM_ORDEM_E_ESTACAO, MIGRATION_007_A_PRODUCAO_ATRAVESSA, MIGRATION_008_O_GRUPO_DA_RECEITA_TAMBEM_E_DE_UMA_CASA, MIGRATION_009_A_DIRECAO_DO_MOVIMENTO_NAO_ESTA_NO_NUMERO, MIGRATION_010_A_ENTRADA_DE_NOTAS_ATRAVESSA, MIGRATION_011_O_CONSUMO_TEM_DUAS_ORIGENS, MIGRATION_012_O_CONSUMO_CLINICO_NAO_PRECISA_DA_TABELA_DE_ITENS_INTEIRA, MIGRATION_013_A_FILA_DE_AUDITORIA_TEM_UMA_JANELA, MIGRATION_014_A_SESSAO_SE_BUSCA_UMA_A_UMA, MIGRATION_015_LATERAL_SEM_CERCA_NAO_E_LATERAL, MIGRATION_016_A_DATA_DO_CONSUMO_E_UMA_COLUNA, MIGRATION_017_APROVAR_E_BAIXAR_SAO_DOIS_GESTOS, MIGRATION_018_O_NOME_NAO_SAI_DA_VISTA, MIGRATION_019_SEM_SALDO_NAO_SE_BAIXA, MIGRATION_020_O_PRODUTO_E_VARIAS_COISAS_AO_MESMO_TEMPO, MIGRATION_021_O_RAZAO_DIZ_DE_ONDE_VEIO, MIGRATION_022_RECEBER_ESTOQUE_VOLTA_A_FUNCIONAR, MIGRATION_023_A_RECEITA_SE_ESCREVE_COM_PERMISSAO, MIGRATION_024_A_CATEGORIA_DO_PRODUTO_E_DO_CATALOGO, MIGRATION_025_A_FICHA_TECNICA_POR_ESTACAO, MIGRATION_026_STOCK_COST_KNOWS_ITS_CURRENCY, MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM, MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT, MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT, MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED, MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW };
 //# sourceMappingURL=main.browser.js.map
 //# sourceMappingURL=main.browser.js.map

package/dist/migrations/main.browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../node_modules/.cache/fayz-migration-stubs/main.ts"],"names":[],"mappings":";AAEO,IAAM,sBAAA,GAAyB;AAC/B,IAAM,sDAAA,GAAyD;AAC/D,IAAM,uCAAA,GAA0C;AAChD,IAAM,+CAAA,GAAkD;AACxD,IAAM,4CAAA,GAA+C;AACrD,IAAM,mDAAA,GAAsD;AAC5D,IAAM,4CAAA,GAA+C;AACrD,IAAM,kCAAA,GAAqC;AAC3C,IAAM,qDAAA,GAAwD;AAC9D,IAAM,uDAAA,GAA0D;AAChE,IAAM,0CAAA,GAA6C;AACnD,IAAM,wCAAA,GAA2C;AACjD,IAAM,sEAAA,GAAyE;AAC/E,IAAM,gDAAA,GAAmD;AACzD,IAAM,yCAAA,GAA4C;AAClD,IAAM,6CAAA,GAAgD;AACtD,IAAM,4CAAA,GAA+C;AACrD,IAAM,8CAAA,GAAiD;AACvD,IAAM,qCAAA,GAAwC;AAC9C,IAAM,oCAAA,GAAuC;AAC7C,IAAM,sDAAA,GAAyD;AAC/D,IAAM,sCAAA,GAAyC;AAC/C,IAAM,+CAAA,GAAkD;AACxD,IAAM,gDAAA,GAAmD;AACzD,IAAM,kDAAA,GAAqD;AAC3D,IAAM,yCAAA,GAA4C;AAClD,IAAM,2CAAA,GAA8C;AACpD,IAAM,mDAAA,GAAsD;AAC5D,IAAM,yCAAA,GAA4C;AAClD,IAAM,gDAAA,GAAmD;AACzD,IAAM,sCAAA,GAAyC;AAC/C,IAAM,aAAiD","file":"main.browser.js","sourcesContent":["// GENERATED by scripts/tsup-migrations.mjs — the browser build of a\n// migrations barrel: the same names, no SQL. See that script for why.\nexport const MIGRATION_000_BASELINE = ''\nexport const MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED = ''\nexport const MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE = ''\nexport const MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER = ''\nexport const MIGRATION_004_A_POSICAO_DE_ESTOQUE_ATRAVESSA = ''\nexport const MIGRATION_005_A_POSICAO_E_CONSEQUENCIA_DO_MOVIMENTO = ''\nexport const MIGRATION_006_A_PRODUCAO_TEM_ORDEM_E_ESTACAO = ''\nexport const MIGRATION_007_A_PRODUCAO_ATRAVESSA = ''\nexport const MIGRATION_008_O_GRUPO_DA_RECEITA_TAMBEM_E_DE_UMA_CASA = ''\nexport const MIGRATION_009_A_DIRECAO_DO_MOVIMENTO_NAO_ESTA_NO_NUMERO = ''\nexport const MIGRATION_010_A_ENTRADA_DE_NOTAS_ATRAVESSA = ''\nexport const MIGRATION_011_O_CONSUMO_TEM_DUAS_ORIGENS = ''\nexport const MIGRATION_012_O_CONSUMO_CLINICO_NAO_PRECISA_DA_TABELA_DE_ITENS_INTEIRA = ''\nexport const MIGRATION_013_A_FILA_DE_AUDITORIA_TEM_UMA_JANELA = ''\nexport const MIGRATION_014_A_SESSAO_SE_BUSCA_UMA_A_UMA = ''\nexport const MIGRATION_015_LATERAL_SEM_CERCA_NAO_E_LATERAL = ''\nexport const MIGRATION_016_A_DATA_DO_CONSUMO_E_UMA_COLUNA = ''\nexport const MIGRATION_017_APROVAR_E_BAIXAR_SAO_DOIS_GESTOS = ''\nexport const MIGRATION_018_O_NOME_NAO_SAI_DA_VISTA = ''\nexport const MIGRATION_019_SEM_SALDO_NAO_SE_BAIXA = ''\nexport const MIGRATION_020_O_PRODUTO_E_VARIAS_COISAS_AO_MESMO_TEMPO = ''\nexport const MIGRATION_021_O_RAZAO_DIZ_DE_ONDE_VEIO = ''\nexport const MIGRATION_022_RECEBER_ESTOQUE_VOLTA_A_FUNCIONAR = ''\nexport const MIGRATION_023_A_RECEITA_SE_ESCREVE_COM_PERMISSAO = ''\nexport const MIGRATION_024_A_CATEGORIA_DO_PRODUTO_E_DO_CATALOGO = ''\nexport const MIGRATION_025_A_FICHA_TECNICA_POR_ESTACAO = ''\nexport const MIGRATION_026_STOCK_COST_KNOWS_ITS_CURRENCY = ''\nexport const MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM = ''\nexport const MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT = ''\nexport const MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT = ''\nexport const MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED = ''\nexport const MIGRATIONS: Array<{ id: string; sql: string }> = []\n"]}
+{"version":3,"sources":["../../node_modules/.cache/fayz-migration-stubs/main.ts"],"names":[],"mappings":";AAEO,IAAM,sBAAA,GAAyB;AAC/B,IAAM,sDAAA,GAAyD;AAC/D,IAAM,uCAAA,GAA0C;AAChD,IAAM,+CAAA,GAAkD;AACxD,IAAM,4CAAA,GAA+C;AACrD,IAAM,mDAAA,GAAsD;AAC5D,IAAM,4CAAA,GAA+C;AACrD,IAAM,kCAAA,GAAqC;AAC3C,IAAM,qDAAA,GAAwD;AAC9D,IAAM,uDAAA,GAA0D;AAChE,IAAM,0CAAA,GAA6C;AACnD,IAAM,wCAAA,GAA2C;AACjD,IAAM,sEAAA,GAAyE;AAC/E,IAAM,gDAAA,GAAmD;AACzD,IAAM,yCAAA,GAA4C;AAClD,IAAM,6CAAA,GAAgD;AACtD,IAAM,4CAAA,GAA+C;AACrD,IAAM,8CAAA,GAAiD;AACvD,IAAM,qCAAA,GAAwC;AAC9C,IAAM,oCAAA,GAAuC;AAC7C,IAAM,sDAAA,GAAyD;AAC/D,IAAM,sCAAA,GAAyC;AAC/C,IAAM,+CAAA,GAAkD;AACxD,IAAM,gDAAA,GAAmD;AACzD,IAAM,kDAAA,GAAqD;AAC3D,IAAM,yCAAA,GAA4C;AAClD,IAAM,2CAAA,GAA8C;AACpD,IAAM,mDAAA,GAAsD;AAC5D,IAAM,yCAAA,GAA4C;AAClD,IAAM,gDAAA,GAAmD;AACzD,IAAM,sCAAA,GAAyC;AAC/C,IAAM,6CAAA,GAAgD;AACtD,IAAM,aAAiD","file":"main.browser.js","sourcesContent":["// GENERATED by scripts/tsup-migrations.mjs — the browser build of a\n// migrations barrel: the same names, no SQL. See that script for why.\nexport const MIGRATION_000_BASELINE = ''\nexport const MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED = ''\nexport const MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE = ''\nexport const MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER = ''\nexport const MIGRATION_004_A_POSICAO_DE_ESTOQUE_ATRAVESSA = ''\nexport const MIGRATION_005_A_POSICAO_E_CONSEQUENCIA_DO_MOVIMENTO = ''\nexport const MIGRATION_006_A_PRODUCAO_TEM_ORDEM_E_ESTACAO = ''\nexport const MIGRATION_007_A_PRODUCAO_ATRAVESSA = ''\nexport const MIGRATION_008_O_GRUPO_DA_RECEITA_TAMBEM_E_DE_UMA_CASA = ''\nexport const MIGRATION_009_A_DIRECAO_DO_MOVIMENTO_NAO_ESTA_NO_NUMERO = ''\nexport const MIGRATION_010_A_ENTRADA_DE_NOTAS_ATRAVESSA = ''\nexport const MIGRATION_011_O_CONSUMO_TEM_DUAS_ORIGENS = ''\nexport const MIGRATION_012_O_CONSUMO_CLINICO_NAO_PRECISA_DA_TABELA_DE_ITENS_INTEIRA = ''\nexport const MIGRATION_013_A_FILA_DE_AUDITORIA_TEM_UMA_JANELA = ''\nexport const MIGRATION_014_A_SESSAO_SE_BUSCA_UMA_A_UMA = ''\nexport const MIGRATION_015_LATERAL_SEM_CERCA_NAO_E_LATERAL = ''\nexport const MIGRATION_016_A_DATA_DO_CONSUMO_E_UMA_COLUNA = ''\nexport const MIGRATION_017_APROVAR_E_BAIXAR_SAO_DOIS_GESTOS = ''\nexport const MIGRATION_018_O_NOME_NAO_SAI_DA_VISTA = ''\nexport const MIGRATION_019_SEM_SALDO_NAO_SE_BAIXA = ''\nexport const MIGRATION_020_O_PRODUTO_E_VARIAS_COISAS_AO_MESMO_TEMPO = ''\nexport const MIGRATION_021_O_RAZAO_DIZ_DE_ONDE_VEIO = ''\nexport const MIGRATION_022_RECEBER_ESTOQUE_VOLTA_A_FUNCIONAR = ''\nexport const MIGRATION_023_A_RECEITA_SE_ESCREVE_COM_PERMISSAO = ''\nexport const MIGRATION_024_A_CATEGORIA_DO_PRODUTO_E_DO_CATALOGO = ''\nexport const MIGRATION_025_A_FICHA_TECNICA_POR_ESTACAO = ''\nexport const MIGRATION_026_STOCK_COST_KNOWS_ITS_CURRENCY = ''\nexport const MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM = ''\nexport const MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT = ''\nexport const MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT = ''\nexport const MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED = ''\nexport const MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW = ''\nexport const MIGRATIONS: Array<{ id: string; sql: string }> = []\n"]}

package/dist/migrations/main.js

@@ -9324,6 +9324,272 @@ SELECT i.tenant_id,
             AND s.unit_id IS NULL)
 ON CONFLICT (tenant_id, product_id, unit_id) DO NOTHING;
 `;
+var MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW = `-- ============================================================================
+-- 031 \u2014 the stock says when it runs low
+--
+-- A product's minimum (plg_inventory_product_settings.min_quantity) only ever
+-- fed a count and a filter: "estoque baixo" was something you found by opening
+-- the Estoque screen or asking the assistant. Nothing told anyone.
+--
+-- Now the moment a product's balance CROSSES its minimum \u2014 from above it to at
+-- or below it \u2014 the database records the fact \`inventory.stock_low\` in the
+-- event log, with what anyone acting on it needs: the product, the scope, the
+-- balance and the minimum. That is all it does.
+--
+-- WHO is told and HOW is not decided here (ADR 0003, "where logic lives"):
+-- the Integration service reads these facts, rings the bell for whoever can
+-- read the stock \u2014 asking this database who that is \u2014 and is where WhatsApp
+-- or e-mail would be added. The detection stays here because only the
+-- transaction that moves the stock sees the balance before and after it.
+--
+-- The rules are the ones v_inventory_low_stock already states, so the alert and
+-- the screen never disagree:
+--   - a minimum applies when it is > 0;
+--   - "low" is on_hand <= min_quantity;
+--   - a settings row with unit_id set watches that unit's positions; the row
+--     with unit_id NULL watches the product across the whole tenant.
+--
+-- EDGE, not level. The fact is the crossing, not every movement while the
+-- product stays low \u2014 selling the tenth bottle of a product already at its
+-- minimum must not tell anyone ten times. It re-arms by itself: once a receipt
+-- lifts the balance above the minimum, the next fall is recorded again. The same crossing
+-- is checked when the minimum itself changes: raising it above what is on the
+-- shelf is as much "this is now low" as selling down to it.
+--
+-- PER TRANSACTION, not per statement. Every position write goes through
+-- app.inventory_apply_to_position, one position per call, so a transfer is two
+-- statements \u2014 the source goes down, then the destination goes up \u2014 and a
+-- recipe consumes ingredient by ingredient. Checked per statement, a transfer
+-- between two units of a product sitting near its minimum would dip the tenant
+-- total in between and report a crossing for a balance that never changed. So:
+--   - a BEFORE row trigger records, on the first touch of a transaction, the
+--     balance of each scope it touches (the product across the tenant, and the
+--     unit) in a transaction-local setting \u2014 that is the balance BEFORE;
+--   - a DEFERRED constraint trigger runs at COMMIT, when every statement of
+--     the transaction has landed, compares each minimum's scope against what
+--     was recorded, records a crossing, and moves the record forward so the
+--     other rows of the same commit do not record it again.
+
+-- A failure here never takes the stock write with it: everything runs inside
+-- exception blocks that only warn.
+-- ============================================================================
+
+-- Record one minimum that has just been crossed.
+CREATE OR REPLACE FUNCTION app.inventory_record_stock_low(
+  p_setting_id uuid,
+  p_tenant_id  uuid,
+  p_product_id uuid,
+  p_unit_id    uuid,
+  p_on_hand    numeric,
+  p_min        numeric
+)
+RETURNS void
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v_name    text;
+  v_measure text;
+  v_unit    text;
+BEGIN
+  BEGIN
+    SELECT pl.name INTO v_name FROM app.inventory_product_label(p_product_id) pl(name, sku);
+    SELECT nullif(btrim(coalesce(p.unit, '')), '') INTO v_measure
+      FROM public.products p WHERE p.id = p_product_id;
+    IF p_unit_id IS NOT NULL THEN
+      SELECT u.name INTO v_unit FROM app.units u WHERE u.id = p_unit_id;
+    END IF;
+
+    PERFORM public.plg_emit_event(
+      'inventory.stock_low',
+      jsonb_build_object(
+        'settingId', p_setting_id,
+        'productId', p_product_id,
+        'productName', v_name,
+        'measure', v_measure,
+        'unitId', p_unit_id,
+        'unitName', v_unit,
+        'onHand', p_on_hand,
+        'minQuantity', p_min),
+      'product', p_product_id::text, p_tenant_id);
+  EXCEPTION WHEN OTHERS THEN
+    RAISE WARNING 'inventory_record_stock_low: %', SQLERRM;
+  END;
+END;
+$$;
+
+-- The balance a minimum watches: the unit's positions, or the tenant's.
+CREATE OR REPLACE FUNCTION app.inventory_scope_on_hand(p_tenant_id uuid, p_product_id uuid, p_unit_id uuid)
+RETURNS numeric
+LANGUAGE sql
+STABLE
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+  SELECT coalesce(sum(p.quantity), 0)
+    FROM public.plg_inventory_stock_positions p
+   WHERE p.tenant_id = p_tenant_id
+     AND p.product_id = p_product_id
+     AND (p_unit_id IS NULL OR p.unit_id = p_unit_id);
+$$;
+
+-- The transaction-local setting holding a scope's balance before this
+-- transaction. md5 keeps the name a plain identifier of fixed length.
+CREATE OR REPLACE FUNCTION app.inventory_low_stock_key(p_tenant_id uuid, p_product_id uuid, p_unit_id uuid)
+RETURNS text
+LANGUAGE sql
+IMMUTABLE
+SET search_path TO ''
+AS $$
+  SELECT 'fayz_low_stock.s' || md5(p_tenant_id::text || '|' || p_product_id::text || '|' || coalesce(p_unit_id::text, '*'));
+$$;
+
+-- BEFORE each position write: remember the balances as they were when this
+-- transaction first touched them. A key already set means "already touched".
+CREATE OR REPLACE FUNCTION app.trg_inventory_positions_low_stock_snapshot()
+RETURNS trigger
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  r   record;
+  v_k text;
+BEGIN
+  BEGIN
+    FOR r IN
+      SELECT DISTINCT x.tenant_id, x.product_id, x.unit_id
+        FROM (SELECT NEW.tenant_id, NEW.product_id, NEW.unit_id WHERE TG_OP <> 'DELETE'
+              UNION ALL
+              SELECT OLD.tenant_id, OLD.product_id, OLD.unit_id WHERE TG_OP <> 'INSERT') AS x(tenant_id, product_id, unit_id)
+       WHERE x.tenant_id IS NOT NULL AND x.product_id IS NOT NULL
+    LOOP
+      v_k := app.inventory_low_stock_key(r.tenant_id, r.product_id, NULL);
+      IF coalesce(current_setting(v_k, true), '') = '' THEN
+        PERFORM set_config(v_k, app.inventory_scope_on_hand(r.tenant_id, r.product_id, NULL)::text, true);
+      END IF;
+      IF r.unit_id IS NOT NULL THEN
+        v_k := app.inventory_low_stock_key(r.tenant_id, r.product_id, r.unit_id);
+        IF coalesce(current_setting(v_k, true), '') = '' THEN
+          PERFORM set_config(v_k, app.inventory_scope_on_hand(r.tenant_id, r.product_id, r.unit_id)::text, true);
+        END IF;
+      END IF;
+    END LOOP;
+  EXCEPTION WHEN OTHERS THEN
+    RAISE WARNING 'trg_inventory_positions_low_stock_snapshot: %', SQLERRM;
+  END;
+  RETURN CASE WHEN TG_OP = 'DELETE' THEN OLD ELSE NEW END;
+END;
+$$;
+
+-- At COMMIT, once per written row: every minimum of the row's product whose
+-- scope this transaction touched is compared against the recorded balance.
+CREATE OR REPLACE FUNCTION app.trg_inventory_positions_low_stock_check()
+RETURNS trigger
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v_tenant  uuid;
+  v_product uuid;
+  s         record;
+  v_k       text;
+  v_before  text;
+  v_now     numeric;
+BEGIN
+  -- Everything, the reads of OLD/NEW included, inside the block that only
+  -- warns: this runs at COMMIT, and an error here would undo the sale.
+  BEGIN
+    IF TG_OP = 'DELETE' THEN
+      v_tenant := OLD.tenant_id; v_product := OLD.product_id;
+    ELSE
+      v_tenant := NEW.tenant_id; v_product := NEW.product_id;
+    END IF;
+    FOR s IN
+      SELECT st.id, st.tenant_id, st.product_id, st.unit_id, st.min_quantity
+        FROM public.plg_inventory_product_settings st
+       WHERE st.tenant_id = v_tenant AND st.product_id = v_product AND st.min_quantity > 0
+    LOOP
+      v_k := app.inventory_low_stock_key(s.tenant_id, s.product_id, s.unit_id);
+      v_before := current_setting(v_k, true);
+      CONTINUE WHEN coalesce(v_before, '') = '';
+      v_now := app.inventory_scope_on_hand(s.tenant_id, s.product_id, s.unit_id);
+      IF v_now <= s.min_quantity AND v_before::numeric > s.min_quantity THEN
+        PERFORM app.inventory_record_stock_low(
+          s.id, s.tenant_id, s.product_id, s.unit_id, v_now, s.min_quantity);
+      END IF;
+      -- Forward: the next row of this commit compares against now.
+      PERFORM set_config(v_k, v_now::text, true);
+    END LOOP;
+  EXCEPTION WHEN OTHERS THEN
+    RAISE WARNING 'trg_inventory_positions_low_stock_check: %', SQLERRM;
+  END;
+  RETURN NULL;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS plg_inventory_stock_positions_low_stock_snapshot ON public.plg_inventory_stock_positions;
+CREATE TRIGGER plg_inventory_stock_positions_low_stock_snapshot
+  BEFORE INSERT OR UPDATE OR DELETE ON public.plg_inventory_stock_positions
+  FOR EACH ROW EXECUTE FUNCTION app.trg_inventory_positions_low_stock_snapshot();
+
+DROP TRIGGER IF EXISTS plg_inventory_stock_positions_low_stock_check ON public.plg_inventory_stock_positions;
+CREATE CONSTRAINT TRIGGER plg_inventory_stock_positions_low_stock_check
+  AFTER INSERT OR UPDATE OR DELETE ON public.plg_inventory_stock_positions
+  DEFERRABLE INITIALLY DEFERRED
+  FOR EACH ROW EXECUTE FUNCTION app.trg_inventory_positions_low_stock_check();
+
+-- The minimum moved: low now and not low under the old minimum is a crossing.
+-- A new minimum on a product that has never been stocked is not a crossing.
+CREATE OR REPLACE FUNCTION app.trg_inventory_minimum_check_low_stock()
+RETURNS trigger
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v_on_hand numeric;
+  v_old_min numeric := 0;
+BEGIN
+  BEGIN
+    IF TG_OP = 'UPDATE' THEN v_old_min := OLD.min_quantity; END IF;
+    IF coalesce(NEW.min_quantity, 0) <= 0 THEN RETURN NULL; END IF;
+    -- A minimum set on a product nobody has stocked yet is the product being
+    -- registered, not stock running out: every new item would be reported
+    -- low before its first receipt. Only a product with positions counts.
+    IF TG_OP = 'INSERT' AND NOT EXISTS (
+         SELECT 1 FROM public.plg_inventory_stock_positions p
+          WHERE p.tenant_id = NEW.tenant_id AND p.product_id = NEW.product_id) THEN
+      RETURN NULL;
+    END IF;
+    v_on_hand := app.inventory_scope_on_hand(NEW.tenant_id, NEW.product_id, NEW.unit_id);
+    IF v_on_hand <= NEW.min_quantity
+       AND NOT (coalesce(v_old_min, 0) > 0 AND v_on_hand <= v_old_min) THEN
+      PERFORM app.inventory_record_stock_low(
+        NEW.id, NEW.tenant_id, NEW.product_id, NEW.unit_id, v_on_hand, NEW.min_quantity);
+    END IF;
+  EXCEPTION WHEN OTHERS THEN
+    RAISE WARNING 'trg_inventory_minimum_check_low_stock: %', SQLERRM;
+  END;
+  RETURN NULL;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS plg_inventory_product_settings_low_stock ON public.plg_inventory_product_settings;
+CREATE TRIGGER plg_inventory_product_settings_low_stock
+  AFTER INSERT OR UPDATE OF min_quantity ON public.plg_inventory_product_settings
+  FOR EACH ROW EXECUTE FUNCTION app.trg_inventory_minimum_check_low_stock();
+
+-- Internal machinery: nobody calls these over PostgREST.
+REVOKE ALL ON FUNCTION app.inventory_low_stock_key(uuid, uuid, uuid) FROM PUBLIC;
+REVOKE ALL ON FUNCTION app.inventory_record_stock_low(uuid, uuid, uuid, uuid, numeric, numeric) FROM PUBLIC;
+REVOKE ALL ON FUNCTION app.inventory_scope_on_hand(uuid, uuid, uuid) FROM PUBLIC;
+REVOKE ALL ON FUNCTION app.trg_inventory_positions_low_stock_snapshot() FROM PUBLIC;
+REVOKE ALL ON FUNCTION app.trg_inventory_positions_low_stock_check() FROM PUBLIC;
+REVOKE ALL ON FUNCTION app.trg_inventory_minimum_check_low_stock() FROM PUBLIC;
+`;
 var MIGRATIONS = [
   { id: "000_baseline", sql: MIGRATION_000_BASELINE },
   { id: "001_the_usage_that_left_stock_can_be_audited", sql: MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED },
@@ -9355,9 +9621,10 @@ var MIGRATIONS = [
   { id: "027_a_receipt_names_the_line_it_came_from", sql: MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM },
   { id: "028_a_receipt_keeps_the_variant", sql: MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT },
   { id: "029_a_reversal_undoes_the_same_variant", sql: MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT },
-  { id: "030_the_minimum_can_be_saved", sql: MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED }
+  { id: "030_the_minimum_can_be_saved", sql: MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED },
+  { id: "031_the_stock_says_when_it_runs_low", sql: MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW }
 ];
 
-export { MIGRATIONS, MIGRATION_000_BASELINE, MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED, MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE, MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER, MIGRATION_004_A_POSICAO_DE_ESTOQUE_ATRAVESSA, MIGRATION_005_A_POSICAO_E_CONSEQUENCIA_DO_MOVIMENTO, MIGRATION_006_A_PRODUCAO_TEM_ORDEM_E_ESTACAO, MIGRATION_007_A_PRODUCAO_ATRAVESSA, MIGRATION_008_O_GRUPO_DA_RECEITA_TAMBEM_E_DE_UMA_CASA, MIGRATION_009_A_DIRECAO_DO_MOVIMENTO_NAO_ESTA_NO_NUMERO, MIGRATION_010_A_ENTRADA_DE_NOTAS_ATRAVESSA, MIGRATION_011_O_CONSUMO_TEM_DUAS_ORIGENS, MIGRATION_012_O_CONSUMO_CLINICO_NAO_PRECISA_DA_TABELA_DE_ITENS_INTEIRA, MIGRATION_013_A_FILA_DE_AUDITORIA_TEM_UMA_JANELA, MIGRATION_014_A_SESSAO_SE_BUSCA_UMA_A_UMA, MIGRATION_015_LATERAL_SEM_CERCA_NAO_E_LATERAL, MIGRATION_016_A_DATA_DO_CONSUMO_E_UMA_COLUNA, MIGRATION_017_APROVAR_E_BAIXAR_SAO_DOIS_GESTOS, MIGRATION_018_O_NOME_NAO_SAI_DA_VISTA, MIGRATION_019_SEM_SALDO_NAO_SE_BAIXA, MIGRATION_020_O_PRODUTO_E_VARIAS_COISAS_AO_MESMO_TEMPO, MIGRATION_021_O_RAZAO_DIZ_DE_ONDE_VEIO, MIGRATION_022_RECEBER_ESTOQUE_VOLTA_A_FUNCIONAR, MIGRATION_023_A_RECEITA_SE_ESCREVE_COM_PERMISSAO, MIGRATION_024_A_CATEGORIA_DO_PRODUTO_E_DO_CATALOGO, MIGRATION_025_A_FICHA_TECNICA_POR_ESTACAO, MIGRATION_026_STOCK_COST_KNOWS_ITS_CURRENCY, MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM, MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT, MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT, MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED };
+export { MIGRATIONS, MIGRATION_000_BASELINE, MIGRATION_001_THE_USAGE_THAT_LEFT_STOCK_CAN_BE_AUDITED, MIGRATION_002_A_AUDITORIA_FECHA_EM_LOTE, MIGRATION_003_STOCK_COUNT_CLOSES_THROUGH_LEDGER, MIGRATION_004_A_POSICAO_DE_ESTOQUE_ATRAVESSA, MIGRATION_005_A_POSICAO_E_CONSEQUENCIA_DO_MOVIMENTO, MIGRATION_006_A_PRODUCAO_TEM_ORDEM_E_ESTACAO, MIGRATION_007_A_PRODUCAO_ATRAVESSA, MIGRATION_008_O_GRUPO_DA_RECEITA_TAMBEM_E_DE_UMA_CASA, MIGRATION_009_A_DIRECAO_DO_MOVIMENTO_NAO_ESTA_NO_NUMERO, MIGRATION_010_A_ENTRADA_DE_NOTAS_ATRAVESSA, MIGRATION_011_O_CONSUMO_TEM_DUAS_ORIGENS, MIGRATION_012_O_CONSUMO_CLINICO_NAO_PRECISA_DA_TABELA_DE_ITENS_INTEIRA, MIGRATION_013_A_FILA_DE_AUDITORIA_TEM_UMA_JANELA, MIGRATION_014_A_SESSAO_SE_BUSCA_UMA_A_UMA, MIGRATION_015_LATERAL_SEM_CERCA_NAO_E_LATERAL, MIGRATION_016_A_DATA_DO_CONSUMO_E_UMA_COLUNA, MIGRATION_017_APROVAR_E_BAIXAR_SAO_DOIS_GESTOS, MIGRATION_018_O_NOME_NAO_SAI_DA_VISTA, MIGRATION_019_SEM_SALDO_NAO_SE_BAIXA, MIGRATION_020_O_PRODUTO_E_VARIAS_COISAS_AO_MESMO_TEMPO, MIGRATION_021_O_RAZAO_DIZ_DE_ONDE_VEIO, MIGRATION_022_RECEBER_ESTOQUE_VOLTA_A_FUNCIONAR, MIGRATION_023_A_RECEITA_SE_ESCREVE_COM_PERMISSAO, MIGRATION_024_A_CATEGORIA_DO_PRODUTO_E_DO_CATALOGO, MIGRATION_025_A_FICHA_TECNICA_POR_ESTACAO, MIGRATION_026_STOCK_COST_KNOWS_ITS_CURRENCY, MIGRATION_027_A_RECEIPT_NAMES_THE_LINE_IT_CAME_FROM, MIGRATION_028_A_RECEIPT_KEEPS_THE_VARIANT, MIGRATION_029_A_REVERSAL_UNDOES_THE_SAME_VARIANT, MIGRATION_030_THE_MINIMUM_CAN_BE_SAVED, MIGRATION_031_THE_STOCK_SAYS_WHEN_IT_RUNS_LOW };
 //# sourceMappingURL=main.js.map
 //# sourceMappingURL=main.js.map