@fayz-ai/plugin-forms 0.1.5 → 0.8.0

package/README.md

@@ -5,6 +5,8 @@
 [![npm](https://img.shields.io/npm/v/@fayz-ai/plugin-forms.svg)](https://www.npmjs.com/package/@fayz-ai/plugin-forms)
 [![license](https://img.shields.io/npm/l/@fayz-ai/plugin-forms.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
 
+**Status:** beta — pre-1.0. Core surface is stable; some backend facets (see `PLUGIN_PATTERNS.md`) are still landing. APIs may change before 1.0.
+
 Every real business runs on forms it never wanted to build: anamnesis sheets, evolution notes, consent contracts, intake docs. plugin-forms kills that busywork. Define a template once, attach a filled document to a person, and the data lives in your tenant — not in a PDF nobody can query.
 
 It snaps into a `defineSaas` app as the document engine. A clinic fills health anamnesis, a salon collects consent forms, a studio signs contracts — same plugin, same `frm_*` tables, different templates. Documents surface right inside the person record via a detail-tab widget, and the AI assistant can list templates and a client's documents on demand.

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import type { PluginScope, VerticalId } from '@fayz-ai/core';
+import type { PluginRegistryDef, PluginScope, VerticalId } from '@fayz-ai/core';
 import type { CustomFormsDataProvider } from './data/types';
 export interface CustomFormsPluginOptions {
     scope?: PluginScope;
@@ -7,10 +7,13 @@ export interface CustomFormsPluginOptions {
     navSection?: 'main' | 'secondary' | 'settings';
     navPosition?: number;
     labels?: Partial<CustomFormsLabels>;
+    /** App-owned registries shown inside Forms & Documents settings. */
+    settingsRegistries?: PluginRegistryDef[];
 }
 export interface CustomFormsLabels {
     pageTitle: string;
     settingsLabel: string;
+    settingsSubtitle: string;
     templates: string;
     documents: string;
     newTemplate: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,YAAY,CAAC,EAAE,uBAAuB,CAAA;IACtC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAWD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAInF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,YAAY,CAAC,EAAE,uBAAuB,CAAA;IACtC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACnC,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAYD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAInF"}

package/dist/data/supabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/data/supabase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAgGtD,wBAAgB,2BAA2B,IAAI,uBAAuB,CAmTrE"}
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/data/supabase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAiGtD,wBAAgB,2BAA2B,IAAI,uBAAuB,CAmTrE"}

package/dist/data/tables.d.ts

@@ -0,0 +1,7 @@
+export declare const T: {
+    readonly documents: "plg_forms_documents";
+    readonly templates: "plg_forms_templates";
+    readonly documentFiles: "plg_forms_document_files";
+    readonly categories: "plg_forms_categories";
+};
+//# sourceMappingURL=tables.d.ts.map

package/dist/data/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/data/tables.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,CAAC;;;;;CAKJ,CAAA"}

package/dist/index.cjs

@@ -3,6 +3,7 @@
 var chunkXLUULIVL_cjs = require('./chunk-XLUULIVL.cjs');
 var React2 = require('react');
 var core = require('@fayz-ai/core');
+var saas = require('@fayz-ai/saas');
 var zustand = require('zustand');
 var lucideReact = require('lucide-react');
 var ui = require('@fayz-ai/ui');
@@ -12,6 +13,14 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var React2__default = /*#__PURE__*/_interopDefault(React2);
 
+// src/data/tables.ts
+var T = {
+  documents: "plg_forms_documents",
+  templates: "plg_forms_templates",
+  documentFiles: "plg_forms_document_files",
+  categories: "plg_forms_categories"
+};
+
 // src/data/mock.ts
 function uuid() {
   return crypto.randomUUID();
@@ -260,7 +269,7 @@ function createSupabaseFormsProvider() {
     // ── Templates ──────────────────────────────────────────
     async getTemplates(query) {
       const db = getClient();
-      let qb = db.from("frm_templates").select("*", { count: "exact" }).eq("tenant_id", getTenantId()).eq("is_current", true).eq("is_deleted", false);
+      let qb = db.from(T.templates).select("*", { count: "exact" }).eq("tenant_id", getTenantId()).eq("is_current", true).eq("is_deleted", false);
       if (query.category) qb = qb.eq("category", query.category);
       if (query.search) qb = qb.ilike("name", `%${query.search}%`);
       const page = query.page ?? 1;
@@ -272,14 +281,14 @@ function createSupabaseFormsProvider() {
     },
     async getTemplateById(id) {
       const db = getClient();
-      const { data, error } = await db.from("frm_templates").select("*").eq("id", id).eq("is_deleted", false).single();
+      const { data, error } = await db.from(T.templates).select("*").eq("id", id).eq("is_deleted", false).single();
       if (error || !data) return null;
       return mapTemplate(data);
     },
     async createTemplate(input) {
       const db = getClient();
       const tenantId = getTenantId();
-      const { data, error } = await db.from("frm_templates").insert({
+      const { data, error } = await db.from(T.templates).insert({
         tenant_id: tenantId,
         name: input.name,
         description: input.description,
@@ -295,12 +304,12 @@ function createSupabaseFormsProvider() {
     async updateTemplate(id, input) {
       const db = getClient();
       const tenantId = getTenantId();
-      const { count } = await db.from("frm_documents").select("document_id", { count: "exact", head: true }).eq("template_id", id);
+      const { count } = await db.from(T.documents).select("document_id", { count: "exact", head: true }).eq("template_id", id);
       const hasDocuments = (count ?? 0) > 0;
       if (hasDocuments && input.schema) {
         const existing = await this.getTemplateById(id);
         if (!existing) throw new Error("Template not found");
-        const { data: newRow, error: insertError } = await db.from("frm_templates").insert({
+        const { data: newRow, error: insertError } = await db.from(T.templates).insert({
           tenant_id: tenantId,
           name: input.name ?? existing.name,
           description: input.description ?? existing.description,
@@ -315,7 +324,7 @@ function createSupabaseFormsProvider() {
           parent_id: existing.parentId ?? existing.id
         }).select().single();
         if (insertError) throw new Error(insertError.message);
-        await db.from("frm_templates").update({ is_current: false, updated_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", id);
+        await db.from(T.templates).update({ is_current: false, updated_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", id);
         return mapTemplate(newRow);
       }
       const updates = { updated_at: (/* @__PURE__ */ new Date()).toISOString() };
@@ -327,16 +336,16 @@ function createSupabaseFormsProvider() {
       if (input.tags !== void 0) updates.tags = input.tags;
       if (input.metadata !== void 0) updates.metadata = input.metadata;
       if (input.isActive !== void 0) updates.is_active = input.isActive;
-      const { data, error } = await db.from("frm_templates").update(updates).eq("id", id).select().single();
+      const { data, error } = await db.from(T.templates).update(updates).eq("id", id).select().single();
       if (error) throw new Error(error.message);
       return mapTemplate(data);
     },
     async deleteTemplate(id) {
       const db = getClient();
-      const { error } = await db.from("frm_templates").update({ is_deleted: true, updated_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", id);
+      const { error } = await db.from(T.templates).update({ is_deleted: true, updated_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", id);
       if (error) throw new Error(error.message);
     },
-    // ── Documents (saas_core.documents + frm_documents extension) ──
+    // ── Documents (public.documents + plg_forms_documents extension) ──
     async getDocuments(query) {
       const db = getClient();
       let qb = db.from("v_documents").select("*", { count: "exact" }).eq("tenant_id", getTenantId()).eq("is_active", true);
@@ -363,7 +372,7 @@ function createSupabaseFormsProvider() {
     async createDocument(input) {
       const tenantId = getTenantId();
       const isForm = !!input.templateId;
-      const { data: coreDoc, error: coreError } = await getClient().from("frm_core_documents").insert({
+      const { data: coreDoc, error: coreError } = await getClient().from("documents").insert({
         tenant_id: tenantId,
         kind: input.kind ?? (isForm ? "form" : "attachment"),
         person_id: input.personId,
@@ -378,14 +387,14 @@ function createSupabaseFormsProvider() {
       if (coreError) throw new Error(coreError.message);
       if (isForm && input.templateId) {
         const db = getClient();
-        const { error: extError } = await db.from("frm_documents").insert({
+        const { error: extError } = await db.from(T.documents).insert({
           document_id: coreDoc.id,
           tenant_id: tenantId,
           template_id: input.templateId,
           data: input.data ?? {}
         });
         if (extError) {
-          await getClient().from("frm_core_documents").delete().eq("id", coreDoc.id);
+          await getClient().from("documents").delete().eq("id", coreDoc.id);
           throw new Error(extError.message);
         }
       }
@@ -398,23 +407,23 @@ function createSupabaseFormsProvider() {
       if (input.status !== void 0) coreUpdates.status = input.status;
       if (input.title !== void 0) coreUpdates.title = input.title;
       if (input.notes !== void 0) coreUpdates.notes = input.notes;
-      const { error: coreError } = await getClient().from("frm_core_documents").update(coreUpdates).eq("id", id);
+      const { error: coreError } = await getClient().from("documents").update(coreUpdates).eq("id", id);
       if (coreError) throw new Error(coreError.message);
       if (input.data !== void 0) {
         const db = getClient();
-        await db.from("frm_documents").update({ data: input.data, updated_at: now2 }).eq("document_id", id);
+        await db.from(T.documents).update({ data: input.data, updated_at: now2 }).eq("document_id", id);
       }
       const doc = await this.getDocumentById(id);
       return doc;
     },
     async deleteDocument(id) {
-      const { error } = await getClient().from("frm_core_documents").update({ is_active: false, updated_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", id);
+      const { error } = await getClient().from("documents").update({ is_active: false, updated_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", id);
       if (error) throw new Error(error.message);
     },
     // ── Files ──────────────────────────────────────────────
     async getDocumentFiles(documentId) {
       const db = getClient();
-      const { data, error } = await db.from("frm_document_files").select("*").eq("document_id", documentId).order("sort_order");
+      const { data, error } = await db.from(T.documentFiles).select("*").eq("document_id", documentId).order("sort_order");
       if (error) throw new Error(error.message);
       return (data ?? []).map(mapFile);
     },
@@ -426,7 +435,7 @@ function createSupabaseFormsProvider() {
       const { error: uploadError } = await db.storage.from("documents").upload(storagePath, file, { contentType: file.type });
       if (uploadError) throw new Error(uploadError.message);
       const { data: urlData } = db.storage.from("documents").getPublicUrl(storagePath);
-      const { data, error } = await db.from("frm_document_files").insert({
+      const { data, error } = await db.from(T.documentFiles).insert({
         tenant_id: tenantId,
         document_id: documentId,
         field_key: fieldKey,
@@ -440,7 +449,7 @@ function createSupabaseFormsProvider() {
     },
     async deleteFile(fileId) {
       const db = getClient();
-      const { error } = await db.from("frm_document_files").delete().eq("id", fileId);
+      const { error } = await db.from(T.documentFiles).delete().eq("id", fileId);
       if (error) throw new Error(error.message);
     }
   };
@@ -700,6 +709,7 @@ var customFormsLocales = {
 var DEFAULT_LABELS = {
   pageTitle: "Custom Forms",
   settingsLabel: "Forms & Documents",
+  settingsSubtitle: "Create and manage custom forms for your business",
   templates: "Templates",
   documents: "Documents",
   newTemplate: "New Template",
@@ -821,8 +831,7 @@ function TemplateListView({ store, config, onEdit, onNew }) {
     ] }) }, i)) })
   ] });
 }
-function CustomFormsSettingsTab({ config, provider, store, registries }) {
-  const t = core.useTranslation();
+function CustomFormsSettingsTab({ config, provider, store }) {
   const [builderTemplateId, setBuilderTemplateId] = React2.useState(null);
   const handleNew = React2.useCallback(() => {
     setBuilderTemplateId("__new__");
@@ -846,7 +855,7 @@ function CustomFormsSettingsTab({ config, provider, store, registries }) {
     }
     checkHash();
   }, []);
-  const templatesContent = builderTemplateId ? /* @__PURE__ */ jsxRuntime.jsx(
+  return builderTemplateId ? /* @__PURE__ */ jsxRuntime.jsx(
     BuilderWrapper,
     {
       templateId: builderTemplateId === "__new__" ? void 0 : builderTemplateId,
@@ -864,13 +873,6 @@ function CustomFormsSettingsTab({ config, provider, store, registries }) {
       onNew: handleNew
     }
   );
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { padding: "24px" }, children: [
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { marginBottom: "16px" }, children: [
-      /* @__PURE__ */ jsxRuntime.jsx("h1", { style: { fontSize: "20px", fontWeight: 600, margin: 0 }, children: t("customForms.settingsTitle") }),
-      /* @__PURE__ */ jsxRuntime.jsx("p", { style: { color: "var(--muted-foreground, #6b7280)", margin: "4px 0 0", fontSize: "14px" }, children: t("customForms.settingsSubtitle") })
-    ] }),
-    templatesContent
-  ] });
 }
 function BuilderWrapper({
   templateId,
@@ -1505,7 +1507,7 @@ function createCustomFormsPlugin(options) {
           { key: "isActive", label: "Active", type: "boolean", showInTable: true, defaultValue: true, inlineToggle: true }
         ],
         data: {
-          table: "frm_categories",
+          table: T.categories,
           tenantScoped: true
         }
       },
@@ -1520,8 +1522,23 @@ function createCustomFormsPlugin(options) {
       ]
     }
   ];
-  const SettingsComponent = () => React2__default.default.createElement(CustomFormsSettingsTab, { config, provider, store, registries: formRegistries });
-  SettingsComponent.displayName = "CustomFormsSettingsTab";
+  const registries = [...formRegistries, ...options?.settingsRegistries ?? []];
+  const SettingsComponent = () => React2__default.default.createElement(saas.PluginSettingsPanel, {
+    title: config.labels.settingsLabel,
+    subtitle: config.labels.settingsSubtitle,
+    customTabs: [
+      {
+        id: "forms",
+        label: config.labels.pageTitle,
+        icon: "FileText",
+        content: React2__default.default.createElement(CustomFormsSettingsTab, { config, provider, store })
+      }
+    ],
+    registries,
+    routeBase: "/settings/custom_forms",
+    hostPluginId: "custom_forms"
+  });
+  SettingsComponent.displayName = "CustomFormsSettingsPanel";
   const PersonDocumentsWidget2 = (props) => React2__default.default.createElement(PersonDocumentsWidget, { ...props, config, provider, store });
   PersonDocumentsWidget2.displayName = "PersonDocumentsWidget";
   return {
@@ -1555,7 +1572,7 @@ function createCustomFormsPlugin(options) {
         order: 0
       }
     ],
-    registries: formRegistries,
+    registries,
     aiTools: [
       {
         id: "custom_forms.list-templates",