@fayz-ai/plugin-forms 0.9.0 → 0.9.1

package/src/migrations/003_agent_rpcs.sql

@@ -1,174 +0,0 @@
--- ============================================================================
--- plugin-forms 003: server-plane agent write RPC.
---
--- public.agent_forms_upsert_template — the assistant BUILDS or EDITS a form
--- template from any surface or channel (in-app FAB, WhatsApp, MCP). Same
--- contract as every agent_* RPC (agenda 005, financial 009):
---   (p_tenant_id, p_actor_user_id, p_payload jsonb) → jsonb
---   {ok:true, id, record:{...}} | {ok:false, denial:{...}} | {ok:false, error}
---
--- The grid layout is computed HERE (col 0, sequential rows, full-width span) so
--- the model only ever sends {type,label,required?,options?} — never positions.
---
--- Payload:
---   template_id?   uuid  — omit to CREATE, provide to EDIT
---   name?          text  — required on create
---   category?      text  — anamnesis|evolution|report|contract|general
---   description?   text
---   fields?        [{type,label,required?,placeholder?,options?[]}] — REPLACE all
---   append_fields? [{...}]                                          — APPEND to existing
---
--- GRANT authenticated+service_role — NEVER anon (the broker calls with the pool
--- service key and injects tenant/actor; in-browser the signed-in user calls it
--- directly and spine RLS/actor guards bind them to their own tenant).
--- ============================================================================
-
-CREATE OR REPLACE FUNCTION public.agent_forms_upsert_template(
-  p_tenant_id uuid,
-  p_actor_user_id uuid,
-  p_payload jsonb
-) RETURNS jsonb
-LANGUAGE plpgsql SECURITY DEFINER
-SET search_path = public
-AS $$
-DECLARE
-  v_denial jsonb;
-  v_used int;
-  v_template_id uuid;
-  v_is_update boolean;
-  v_name text;
-  v_category text;
-  v_description text;
-  v_existing jsonb;
-  v_input jsonb;
-  v_merged jsonb;
-  v_fields jsonb;
-  v_schema jsonb;
-  v_final_id uuid;
-BEGIN
-  -- ── payload ──────────────────────────────────────────────────────────────
-  BEGIN
-    v_template_id := NULLIF(p_payload->>'template_id','')::uuid;
-  EXCEPTION WHEN OTHERS THEN
-    RETURN jsonb_build_object('ok', false, 'error', 'invalid template_id');
-  END;
-  v_is_update   := v_template_id IS NOT NULL;
-  v_name        := btrim(p_payload->>'name');
-  v_category    := lower(COALESCE(NULLIF(p_payload->>'category',''), 'general'));
-  v_description := left(p_payload->>'description', 1000);
-  IF v_category NOT IN ('anamnesis','evolution','report','contract','general') THEN
-    v_category := 'general';
-  END IF;
-
-  IF NOT v_is_update AND (v_name IS NULL OR v_name = '') THEN
-    RETURN jsonb_build_object('ok', false, 'error', 'name is required to create a form');
-  END IF;
-
-  -- ── authorization: role → plan → form_templates cap ──────────────────────
-  SELECT count(*) INTO v_used FROM plg_forms_templates
-   WHERE tenant_id = p_tenant_id AND is_deleted = false;
-  v_denial := agent_guard(p_tenant_id, p_actor_user_id, 'custom_forms',
-                CASE WHEN v_is_update THEN 'update' ELSE 'create' END,
-                'form_templates', v_used, CASE WHEN v_is_update THEN 0 ELSE 1 END);
-  IF v_denial IS NOT NULL THEN
-    RETURN jsonb_build_object('ok', false, 'denial', v_denial);
-  END IF;
-
-  -- ── current fields (for APPEND / to reject an unknown id) ────────────────
-  IF v_is_update THEN
-    SELECT COALESCE(schema->'fields','[]'::jsonb) INTO v_existing
-    FROM plg_forms_templates
-    WHERE id = v_template_id AND tenant_id = p_tenant_id AND is_deleted = false;
-    IF v_existing IS NULL THEN
-      RETURN jsonb_build_object('ok', false, 'error', 'unknown template for this tenant');
-    END IF;
-  ELSE
-    v_existing := '[]'::jsonb;
-  END IF;
-
-  -- ── normalize the incoming fields to the builder's FormFieldDef shape ────
-  -- (id, type, label, required, placeholder, col, colSpan, options) — row is
-  -- assigned last, across the merged list.
-  WITH src AS (
-    SELECT CASE
-             WHEN p_payload ? 'fields'        THEN COALESCE(p_payload->'fields','[]'::jsonb)
-             WHEN p_payload ? 'append_fields' THEN COALESCE(p_payload->'append_fields','[]'::jsonb)
-             ELSE '[]'::jsonb
-           END AS arr
-  ),
-  norm AS (
-    SELECT f.ord, jsonb_strip_nulls(jsonb_build_object(
-      'id',    COALESCE(NULLIF(f.value->>'id',''), gen_random_uuid()::text),
-      'type',  COALESCE(NULLIF(f.value->>'type',''), 'text'),
-      'label', COALESCE(NULLIF(f.value->>'label',''), 'Campo'),
-      'required', COALESCE((f.value->>'required')::boolean, false),
-      'placeholder', NULLIF(f.value->>'placeholder',''),
-      'col', 0,
-      'colSpan', 12,
-      'options', CASE
-        WHEN jsonb_typeof(f.value->'options') = 'array' AND jsonb_array_length(f.value->'options') > 0
-        THEN (SELECT jsonb_agg(jsonb_build_object(
-                'label', opt,
-                'value', lower(regexp_replace(btrim(opt), '\s+', '_', 'g'))))
-              FROM jsonb_array_elements_text(f.value->'options') opt)
-        ELSE NULL END
-    )) AS field
-    FROM src, jsonb_array_elements(src.arr) WITH ORDINALITY AS f(value, ord)
-  )
-  SELECT COALESCE(jsonb_agg(field ORDER BY ord), '[]'::jsonb) INTO v_input FROM norm;
-
-  -- REPLACE with `fields`; otherwise APPEND onto what's already there.
-  IF p_payload ? 'fields' THEN
-    v_merged := v_input;
-  ELSE
-    v_merged := v_existing || v_input;
-  END IF;
-
-  -- sequential rows across the final list
-  SELECT COALESCE(jsonb_agg(jsonb_set(e.value, '{row}', to_jsonb((e.ord - 1))) ORDER BY e.ord), '[]'::jsonb)
-    INTO v_fields
-  FROM jsonb_array_elements(v_merged) WITH ORDINALITY AS e(value, ord);
-
-  v_schema := jsonb_build_object('layout', jsonb_build_object('columns', 12), 'fields', v_fields);
-
-  -- ── write + audit ────────────────────────────────────────────────────────
-  IF v_is_update THEN
-    UPDATE plg_forms_templates SET
-      name        = COALESCE(NULLIF(v_name,''), name),
-      category    = v_category,
-      description = COALESCE(v_description, description),
-      schema      = v_schema,
-      updated_by  = p_actor_user_id,
-      updated_at  = now()
-    WHERE id = v_template_id AND tenant_id = p_tenant_id AND is_deleted = false
-    RETURNING id INTO v_final_id;
-  ELSE
-    INSERT INTO plg_forms_templates (tenant_id, name, category, description, schema, created_by, updated_by)
-    VALUES (p_tenant_id, v_name, v_category, v_description, v_schema, p_actor_user_id, p_actor_user_id)
-    RETURNING id INTO v_final_id;
-  END IF;
-
-  INSERT INTO audit_logs (tenant_id, user_id, action, entity_type, entity_id, metadata)
-  VALUES (p_tenant_id, p_actor_user_id,
-          CASE WHEN v_is_update THEN 'agent.updateFormTemplate' ELSE 'agent.createFormTemplate' END,
-          'form_template', v_final_id::text,
-          jsonb_build_object('payload', p_payload));
-
-  RETURN jsonb_build_object(
-    'ok', true,
-    'id', v_final_id,
-    'record', jsonb_build_object(
-      'ref', jsonb_build_object('id', v_final_id, 'resource', 'plg_forms_templates',
-                                'archetype', 'custom_forms:template'),
-      'name', COALESCE(NULLIF(v_name,''), (SELECT name FROM plg_forms_templates WHERE id = v_final_id)),
-      'category', v_category,
-      'fieldCount', jsonb_array_length(v_fields)
-    )
-  );
-END;
-$$;
-
-REVOKE ALL ON FUNCTION public.agent_forms_upsert_template(uuid, uuid, jsonb) FROM public;
-REVOKE EXECUTE ON FUNCTION public.agent_forms_upsert_template(uuid, uuid, jsonb) FROM anon;
-GRANT EXECUTE ON FUNCTION public.agent_forms_upsert_template(uuid, uuid, jsonb)
-  TO authenticated, service_role;