@fayz-ai/db 0.25.0 → 0.26.0

package/migrations/{213_the_service_reads_facts_and_rings_the_bell.sql → 214_the_service_reads_facts_and_rings_the_bell.sql}

@@ -1,5 +1,5 @@
 -- ============================================================================
--- 213_the_service_reads_facts_and_rings_the_bell — two doors for the
+-- 214_the_service_reads_facts_and_rings_the_bell — two doors for the
 -- Integration service, so a fact recorded here can reach a person through it.
 --
 -- ADR 0003: the database records what happened (event_log) and answers who may

package/migrations/215_a_price_table_is_picked_on_the_sale.sql

@@ -0,0 +1,187 @@
+-- ============================================================================
+-- 215 — a price table is picked on the sale
+--
+-- A house that sells the same item at three prices (restaurant, resale, end
+-- customer) kept three products per item because nothing let the operator say
+-- "this sale is at the resale price". 086 built price tables for an automatic
+-- resolver (unit > channel > default); this migration adds the other half:
+-- an explicit pick, made on the document, after the customer.
+--
+--   * price_tables.items_only — the table is a catalogue as well as a price
+--     list: a pick offers only what the table lists (default). Off, every
+--     for-sale item is offered, priced by the table where it has a row.
+--   * price_tables.adjustment_percent — the list-wide rule for items the table
+--     does not list (items_only off): base price ± percent. Fixed rows win.
+--   * people.price_table_id — the customer's default table, pre-picked when
+--     the customer is chosen on a document.
+--   * price_table_offer() — what a picked table offers, with its price.
+--   * price_table_add_products() — fill a table with the catalogue at base
+--     price, one atomic action, so a 60-item table is not 60 clicks.
+--
+-- Additive and idempotent. Both functions are SECURITY INVOKER: the caller's
+-- RLS decides which tables, rows and products she can price with.
+-- ============================================================================
+
+ALTER TABLE public.price_tables
+  ADD COLUMN IF NOT EXISTS items_only boolean NOT NULL DEFAULT true;
+ALTER TABLE public.price_tables
+  ADD COLUMN IF NOT EXISTS adjustment_percent numeric;
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint
+                  WHERE conrelid = 'public.price_tables'::regclass
+                    AND conname = 'price_tables_adjustment_percent_check') THEN
+    ALTER TABLE public.price_tables ADD CONSTRAINT price_tables_adjustment_percent_check
+      CHECK (adjustment_percent IS NULL OR adjustment_percent > -100);
+  END IF;
+END $$;
+COMMENT ON COLUMN public.price_tables.items_only IS
+  'When the table is picked on a sale, only the items it lists are offered (true), or the whole for-sale catalogue with the table price where listed (false).';
+COMMENT ON COLUMN public.price_tables.adjustment_percent IS
+  'List-wide rule for items without a row (items_only = false): base price × (1 + percent/100). NULL = base price. A row''s fixed price always wins.';
+
+-- ── the customer's default table ───────────────────────────────────────────
+ALTER TABLE public.people
+  ADD COLUMN IF NOT EXISTS price_table_id uuid;
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint
+                  WHERE conrelid = 'public.people'::regclass
+                    AND conname = 'people_price_table_fk') THEN
+    -- SET NULL on the one column: a composite FK with a bare SET NULL would
+    -- also null tenant_id and orphan the person.
+    ALTER TABLE public.people ADD CONSTRAINT people_price_table_fk
+      FOREIGN KEY (tenant_id, price_table_id)
+      REFERENCES public.price_tables (tenant_id, id)
+      ON DELETE SET NULL (price_table_id);
+  END IF;
+END $$;
+CREATE INDEX IF NOT EXISTS people_price_table_idx
+  ON public.people (tenant_id, price_table_id) WHERE price_table_id IS NOT NULL;
+COMMENT ON COLUMN public.people.price_table_id IS
+  'Default price table for this customer: pre-picked on a sale once the customer is chosen (215). NULL = the house default or base prices.';
+
+-- The masked view of people follows its table (118): a column missing there
+-- reads to a client as "no such field". The N16d gate checks it.
+DO $$
+BEGIN
+  IF to_regprocedure('app.masked_view_refresh(regclass,text,text)') IS NOT NULL
+     AND EXISTS (SELECT 1 FROM app.masked_views WHERE table_name = 'people') THEN
+    PERFORM app.masked_view_refresh('public.people', 'person', 'person');
+  END IF;
+END $$;
+
+-- ── what a picked table offers ─────────────────────────────────────────────
+CREATE OR REPLACE FUNCTION public.price_table_offer(
+  p_table  uuid,
+  p_query  text    DEFAULT NULL,
+  p_kinds  text[]  DEFAULT NULL,
+  p_limit  integer DEFAULT 20,
+  p_offset integer DEFAULT 0,
+  p_at     date    DEFAULT current_date,
+  p_qty    numeric DEFAULT 1,
+  p_products uuid[] DEFAULT NULL
+)
+RETURNS TABLE (
+  product_id  uuid,
+  name        text,
+  sku         text,
+  kind        text,
+  description text,
+  base_price  numeric,
+  price       numeric,
+  listed      boolean,
+  total_count bigint
+)
+LANGUAGE plpgsql STABLE SECURITY INVOKER SET search_path = ''
+AS $$
+DECLARE
+  v_table public.price_tables%ROWTYPE;
+  v_q     text := nullif(btrim(coalesce(p_query, '')), '');
+BEGIN
+  SELECT * INTO v_table FROM public.price_tables t WHERE t.id = p_table;
+  IF NOT FOUND THEN
+    RAISE EXCEPTION 'price_table_not_found' USING ERRCODE = 'P0002',
+      DETAIL = 'The price table does not exist or is not visible to the caller.';
+  END IF;
+  IF NOT v_table.is_active
+     OR (v_table.valid_from IS NOT NULL AND v_table.valid_from > p_at)
+     OR (v_table.valid_to   IS NOT NULL AND v_table.valid_to   < p_at) THEN
+    RAISE EXCEPTION 'price_table_not_valid' USING ERRCODE = '22023',
+      DETAIL = format('The price table is inactive or outside its validity on %s.', p_at);
+  END IF;
+
+  RETURN QUERY
+  WITH listed_rows AS (
+    -- The product-wide row with the highest quantity tier that applies.
+    SELECT DISTINCT ON (i.product_id) i.product_id, i.price
+      FROM public.price_table_items i
+     WHERE i.price_table_id = p_table
+       AND i.variant_id IS NULL
+       AND i.min_qty <= coalesce(p_qty, 1)
+     ORDER BY i.product_id, i.min_qty DESC
+  ),
+  offer AS (
+    SELECT p.id, p.name, p.sku, p.kind, p.description, p.price AS base_price,
+           r.price AS row_price, (r.product_id IS NOT NULL) AS is_listed
+      FROM public.products p
+      LEFT JOIN listed_rows r ON r.product_id = p.id
+     WHERE p.is_active IS NOT FALSE
+       AND (p_kinds IS NULL OR p.kind = ANY (p_kinds))
+       AND (p_products IS NULL OR p.id = ANY (p_products))
+       AND (r.product_id IS NOT NULL
+            OR (NOT v_table.items_only
+                AND coalesce(p.metadata ->> 'productType', 'sale') = 'sale'))
+       AND (v_q IS NULL OR p.name ILIKE '%' || v_q || '%' OR p.sku ILIKE '%' || v_q || '%')
+  )
+  SELECT o.id, o.name, o.sku, o.kind, o.description, o.base_price,
+         coalesce(o.row_price,
+                  CASE WHEN v_table.adjustment_percent IS NULL THEN o.base_price
+                       ELSE round(o.base_price * (1 + v_table.adjustment_percent / 100.0), 2) END),
+         o.is_listed,
+         count(*) OVER ()
+    FROM offer o
+   ORDER BY o.name, o.id
+   LIMIT greatest(coalesce(p_limit, 20), 0)
+  OFFSET greatest(coalesce(p_offset, 0), 0);
+END $$;
+REVOKE ALL ON FUNCTION public.price_table_offer(uuid, text, text[], integer, integer, date, numeric, uuid[]) FROM PUBLIC, anon;
+GRANT EXECUTE ON FUNCTION public.price_table_offer(uuid, text, text[], integer, integer, date, numeric, uuid[]) TO authenticated, service_role;
+COMMENT ON FUNCTION public.price_table_offer(uuid, text, text[], integer, integer, date, numeric, uuid[]) IS
+  'The items a picked price table offers on a sale, each with the table price (fixed row > adjustment_percent > base). items_only limits the offer to listed items. Raises price_table_not_found / price_table_not_valid (215).';
+
+-- ── fill a table with the catalogue ────────────────────────────────────────
+CREATE OR REPLACE FUNCTION public.price_table_add_products(
+  p_table uuid,
+  p_kinds text[] DEFAULT ARRAY['good']
+)
+RETURNS integer
+LANGUAGE plpgsql VOLATILE SECURITY INVOKER SET search_path = ''
+AS $$
+DECLARE
+  v_tenant uuid;
+  v_added  integer;
+BEGIN
+  SELECT t.tenant_id INTO v_tenant FROM public.price_tables t WHERE t.id = p_table;
+  IF v_tenant IS NULL THEN
+    RAISE EXCEPTION 'price_table_not_found' USING ERRCODE = 'P0002',
+      DETAIL = 'The price table does not exist or is not visible to the caller.';
+  END IF;
+
+  INSERT INTO public.price_table_items (tenant_id, price_table_id, product_id, price, min_qty)
+  SELECT v_tenant, p_table, p.id, coalesce(p.price, 0), 1
+    FROM public.products p
+   WHERE p.tenant_id = v_tenant
+     AND p.is_active IS NOT FALSE
+     AND (p_kinds IS NULL OR p.kind = ANY (p_kinds))
+     AND coalesce(p.metadata ->> 'productType', 'sale') = 'sale'
+     AND NOT EXISTS (SELECT 1 FROM public.price_table_items i
+                      WHERE i.price_table_id = p_table AND i.product_id = p.id AND i.variant_id IS NULL)
+  ON CONFLICT ON CONSTRAINT price_table_items_unique DO NOTHING;
+  GET DIAGNOSTICS v_added = ROW_COUNT;
+  RETURN v_added;
+END $$;
+REVOKE ALL ON FUNCTION public.price_table_add_products(uuid, text[]) FROM PUBLIC, anon;
+GRANT EXECUTE ON FUNCTION public.price_table_add_products(uuid, text[]) TO authenticated, service_role;
+COMMENT ON FUNCTION public.price_table_add_products(uuid, text[]) IS
+  'Adds every active for-sale product the table does not list yet, at its base price, in one statement. Returns how many rows were added (215).';

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "beta"
   },
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Fayz SDK database layer — Drizzle schema primitives, spine references, and migration helpers shared across plugins.",
   "type": "module",
   "sideEffects": false,