@fayz-ai/core 0.9.0 → 0.11.0

package/dist/index.js

@@ -1,13 +1,17 @@
-export { connectorDirection, connectorPlanes, preferredPlane, withAfterHooks } from './chunk-L4TLMYGC.js';
-export { PluginContractError, assertConnectorContract, assertPluginManifestContract } from './chunk-X5THHG6T.js';
-import { getActiveTenantId, globalCache, getSupabaseClientOptional, resolveDataProvider } from './chunk-V2MSAUHO.js';
-export { applyRangeToQuery, bulkCreate, clearGlobalCache, countByTenant, createArchetypeProvider, createCacheStore, createFayzApiProvider, createMockProvider, createSupabaseProvider, getActiveTenantId, getSupabaseClientOptional, globalCache, invalidateCount, isFilterObject, matchesRange, parseRangeFilter, resolveDataProvider, setActiveTenantId, setGlobalSupabaseClient, stableKey, subscribeActiveTenant, useActiveTenantId, withCache } from './chunk-V2MSAUHO.js';
+export { PluginContractError, assertConnectorContract, assertPluginManifestContract, bespokeConnectorTables } from './chunk-V53GR4UT.js';
+export { CONNECTIONS_TABLE, CONNECTOR_CATEGORIES, ConnectionSettingsError, ConnectorRuntimeTokenUnavailableError, RequestBlockedError, RequestPlaneError, SYNC_RUNS_TABLE, assertSettingsAllowed, buyerIdempotencyKey, connectionKey, connectionRuns, connectionSettings, connectionStatus, connectorDirection, connectorEntities, connectorGrantScopes, connectorPermissions, connectorPlanes, connectorRuntimeToken, connectorSettings, connectorSubscribes, connectorSubscribesTo, createConnectionStore, createRpcEffectLedger, eventKeyMatches, getConnectorRuntimeTokenSource, grants, groupedPermissions, hasRequestPlane, hasSensitivePermission, invocationPlane, isConnectorCategory, isDataPermission, isEventPermission, isSettingSet, listConnections, missingRequiredSettings, permissionActions, permissionsWrite, preferredPlane, requestPlaneSpec, runEffect, runRequest, setConnectorRuntimeTokenSource, settingsStatus, setupStatusDetail, sortedPermissions, withAfterHooks } from './chunk-BEGXYHS4.js';
+export { CONNECTOR_RUNTIME_TOKEN_HEADER, ConnectorHttpError, RateLimitExceededError, advanceWindow, backoffDelay, classify, createRateLimiter, cursorCompleteness, fetchWithRetry, isExpiring, paginate, parseRetryAfter, reconcileMirror, serializeCursor, sliceWindow, statusNeedsBody } from './chunk-ED6NBH6U.js';
+import { resolveDataProvider } from './chunk-UVKH6RDX.js';
+export { CustomFieldsError, FIELDS_TABLE, bulkCreate, bulkRemove, clearCustomFieldsCache, countByTenant, createArchetypeProvider, createFayzApiProvider, createMockProvider, invalidateCount, mergeCustomFields, resolveCustomFields, resolveDataProvider, validateCustomFields, withCache } from './chunk-UVKH6RDX.js';
+import { getActiveTenantId, globalCache, getSupabaseClientOptional } from './chunk-LARZWDHA.js';
+export { applyRangeToQuery, clearGlobalCache, createCacheStore, createSupabaseProvider, getActiveTenantId, getSupabaseClientOptional, globalCache, isFilterObject, matchesRange, parseRangeFilter, setActiveTenantId, setGlobalSupabaseClient, stableKey, subscribeActiveTenant, useActiveTenantId } from './chunk-LARZWDHA.js';
+import { getBlock, checkNodePlacement, getScaffold } from './chunk-RRYFXUQX.js';
+export { BLOCK_SETTING_TYPES, PLUGIN_API_VERSION, PluginRuntimeProvider, auditBlocks, blockRegistry, buildEntityDomainEvents, checkAgainstSchema, checkBlockConstraints, checkBlockContext, checkNodePlacement, clearExtensionPoints, clearHandles, clearLoaders, componentRegistry, dataNeedKey, defaultPropsFromSettings, defineBlock, defineExtensionPoint, defineLoader, definePlugin, describeBlock, describeBlocks, describeExtensionPoints, describeLoaders, entityEventKey, extensionAfterHooks, extensionPointRegistry, formatSchemaIssues, getAnalyticsCards, getBlock, getBlockMeta, getComponent, getDashboardWidgets, getHandle, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, handleNameFor, handleRegistry, hasExtensionPoint, hasHandle, hasLoader, isBlockEnabledOn, isLoaderParamRef, isLoaderPropRef, listBlocks, listExtensionHandlers, listExtensionPoints, listHandles, listLoaders, listMetrics, listPluginFactories, listPlugins, loaderRegistry, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerExtensionHandler, registerHandle, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, repairBlockTree, resolveHandle, resolveLoader, resolvePluginComponent, resolvePluginRuntime, runEscapeValve, runExtensionPoint, scaffoldRegistry, settingsToJsonSchema, summarizeBlockAudit, unregisterExtensionHandler, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional } from './chunk-RRYFXUQX.js';
+export { ENTITY_FIELD_TYPES, GENERIC_ENTITY_TABLE, RESERVED_ENTITY_FIELDS, Registry, clearCustomFieldsDeclarations, clearEntityDeclarations, customFieldsRegistry, declaredCustomFields, defineCustomFields, defineEntity, describeEntities, entityAdminForm, entityDeclarationRegistry, entityRecordSchema, hasCustomFieldsDeclaration, hasEntityDeclaration, isCustomId, listEntityDeclarations, resolveEntityDeclaration, validateEntityRecordData } from './chunk-EWKX4VUM.js';
 export { clearEntityRegistry, deriveEntityKey, getAllEntities, getEntityByKey, registerEntity } from './chunk-CU64QI4A.js';
-import { getBlock, getScaffold } from './chunk-YH25Y4FW.js';
-export { PLUGIN_API_VERSION, PluginRuntimeProvider, Registry, blockRegistry, componentRegistry, definePlugin, getBlock, getComponent, getDashboardWidgets, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, isCustomId, listBlocks, listMetrics, listPluginFactories, listPlugins, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, resolvePluginComponent, resolvePluginRuntime, scaffoldRegistry, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional } from './chunk-YH25Y4FW.js';
-import { getCurrentLocale } from './chunk-5RJVUC6J.js';
-export { I18nProvider, coreTranslations, getCurrentLocale, mergeTranslations, preloadLocale, registerTranslations, setCurrentLocale, setLocaleStore, useI18nConfig, useTranslation } from './chunk-5RJVUC6J.js';
-export { hashRouterAdapter, windowRouterAdapter } from './chunk-Y2C2FBQP.js';
+import { getCurrentLocale } from './chunk-TDI6F6PT.js';
+export { I18nProvider, coreTranslations, getCurrentLocale, mergeTranslations, preloadLocale, registerTranslations, setCurrentLocale, setLocaleStore, tl, useI18nConfig, useTranslation } from './chunk-TDI6F6PT.js';
+export { defaultRouterAdapter, hashRouterAdapter, historyRouterAdapter, hostRouterAdapter, staticRouterAdapter, windowRouterAdapter } from './chunk-OXQGRJZT.js';
 export { FayzRuntimeError, createFayzRuntimeClient } from './chunk-7RTUHSKY.js';
 import * as React3 from 'react';
 import { useEffect } from 'react';
@@ -25,6 +29,162 @@ var WidgetZone = {
   SETTINGS_AFTER: "settings.after",
   FLOATING: "shell.floating"
 };
+
+// src/data/backend-env.ts
+function str(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function resolveBackendEnv(options = {}) {
+  const env = options.env ?? (import.meta.env ?? {});
+  const url = str(env.VITE_SUPABASE_URL);
+  const key = str(env.VITE_SUPABASE_PUBLISHABLE_KEY) ?? str(env.VITE_SUPABASE_ANON_KEY);
+  const flag = env.VITE_SUPABASE_ENABLED;
+  const flagSet = flag !== void 0 && flag !== "";
+  const enabledByFlag = flag === true || flag === "true";
+  let live;
+  if (options.force) live = options.force === "live";
+  else if (flagSet) live = enabledByFlag && Boolean(url && key);
+  else live = Boolean(url && key);
+  return {
+    live,
+    supabaseUrl: live ? url : void 0,
+    supabaseAnonKey: live ? key : void 0,
+    adapter: live ? "supabase" : "mock"
+  };
+}
+
+// src/events/envelope.ts
+function emitDomainEvent(key, payload, meta) {
+  const event = {
+    key,
+    payload,
+    actorId: meta?.actorId ?? null,
+    tenantId: meta?.tenantId ?? null,
+    subject: meta?.subject ?? null,
+    occurredAt: meta?.occurredAt ?? (/* @__PURE__ */ new Date()).toISOString()
+  };
+  eventBus.emit(key, event);
+  for (const sink of sinks) {
+    try {
+      sink(event);
+    } catch (err) {
+      console.warn("[events] sink failed", err);
+    }
+  }
+  return event;
+}
+var sinks = /* @__PURE__ */ new Set();
+function registerEventSink(sink) {
+  sinks.add(sink);
+  return () => {
+    sinks.delete(sink);
+  };
+}
+function clearEventSinks() {
+  sinks.clear();
+}
+function onDomainEvent(key, handler) {
+  return eventBus.on(key, (e) => {
+    void handler(e);
+  });
+}
+function onDomainEvents(keys, known, handler) {
+  const matched = known.filter((k) => keys.some((p) => p === "*" || (p.endsWith(".*") ? k.startsWith(p.slice(0, -1)) : p === k)));
+  const offs = matched.map((k) => onDomainEvent(k, handler));
+  return () => {
+    for (const off of offs) off();
+  };
+}
+function sampleEventPayload(fields) {
+  const out = {};
+  for (const f of fields ?? []) out[f.name] = f.example ?? `{{${f.name}}}`;
+  return out;
+}
+
+// src/events/log.ts
+var EVENT_LOG_TABLE = "plg_event_log";
+function client() {
+  return getSupabaseClientOptional();
+}
+function toRun(row) {
+  return {
+    id: row.id,
+    eventKey: row.event_key,
+    status: row.status ?? "recorded",
+    payload: row.payload ?? {},
+    result: row.result ?? null,
+    error: row.error ?? null,
+    actorId: row.actor_id ?? null,
+    subjectType: row.subject_type ?? null,
+    subjectId: row.subject_id ?? null,
+    occurredAt: row.occurred_at ?? row.created_at
+  };
+}
+var pending = [];
+var flushing = false;
+function flushSoon() {
+  if (flushing) return;
+  flushing = true;
+  queueMicrotask(() => {
+    const rows = pending;
+    pending = [];
+    flushing = false;
+    if (!rows.length) return;
+    const db = client();
+    if (!db) return;
+    void (async () => {
+      try {
+        await db.from(EVENT_LOG_TABLE).insert(rows);
+      } catch (err) {
+        console.warn("[events] could not record run", err);
+      }
+    })();
+  });
+}
+function recordEventRun(event, status = "recorded") {
+  const db = client();
+  if (!db) return;
+  const tenantId = event.tenantId ?? getActiveTenantId();
+  if (!tenantId) return;
+  pending.push({
+    tenant_id: tenantId,
+    event_key: event.key,
+    status,
+    payload: event.payload ?? {},
+    actor_id: event.actorId ?? null,
+    subject_type: event.subject?.type ?? null,
+    subject_id: event.subject?.id ?? null,
+    occurred_at: event.occurredAt
+  });
+  flushSoon();
+}
+var started = false;
+function startEventLog() {
+  if (started) return () => {
+  };
+  started = true;
+  const off = registerEventSink((event) => recordEventRun(event));
+  return () => {
+    off();
+    started = false;
+  };
+}
+async function loadEventRuns(eventKey, options) {
+  const db = client();
+  if (!db) return [];
+  try {
+    let q = db.from(EVENT_LOG_TABLE).select("*").eq("event_key", eventKey).order("occurred_at", { ascending: false }).limit(options?.limit ?? 20);
+    if (options?.tenantId) q = q.eq("tenant_id", options.tenantId);
+    const { data, error } = await q;
+    if (error) throw error;
+    return (data ?? []).map(toRun);
+  } catch (err) {
+    console.warn("[events] could not load runs", err);
+    return [];
+  }
+}
+
+// src/events/index.tsx
 function createEventBus() {
   const handlers = /* @__PURE__ */ new Map();
   const bus = {
@@ -86,11 +246,11 @@ function matchesDataChange(match, payload) {
   if (match.archetype && payload.archetype && match.archetype === payload.archetype) return true;
   return !match.table && !match.entityKey && !match.archetype;
 }
-var pending = [];
+var pending2 = [];
 var flushTimer = null;
 function flush() {
-  const batch = pending;
-  pending = [];
+  const batch = pending2;
+  pending2 = [];
   flushTimer = null;
   for (const payload of batch) eventBus.emit(DATA_CHANGED_EVENT, payload);
 }
@@ -103,7 +263,7 @@ function emitDataChanged(payload = {}) {
   } else {
     globalCache.clear();
   }
-  pending.push({ op: "unknown", source: "agent", ...payload });
+  pending2.push({ op: "unknown", source: "agent", ...payload });
   if (flushTimer) return;
   flushTimer = setTimeout(flush, 120);
 }
@@ -134,7 +294,7 @@ function createSafeDataProvider(makeSupabase, makeMock) {
   });
 }
 
-// src/phone/index.ts
+// src/lib/phone.ts
 function flagOf(iso2) {
   return iso2.toUpperCase().replace(/[^A-Z]/g, "").split("").map((c) => String.fromCodePoint(127462 + c.charCodeAt(0) - 65)).join("");
 }
@@ -179,7 +339,7 @@ function maskDigitCount(mask) {
   return n;
 }
 
-// src/address/index.ts
+// src/lib/address.ts
 function normalizePostalCode(value) {
   return (value || "").replace(/\D/g, "");
 }
@@ -296,23 +456,41 @@ function upsertLink(rel, href) {
 function clearManaged() {
   document.head.querySelectorAll(`[${MANAGED}]`).forEach((el) => el.remove());
 }
+function buildSeoTags(config) {
+  const description = config.description ?? "";
+  const meta = [
+    { name: "description", content: description },
+    { property: "og:title", content: config.title },
+    { property: "og:description", content: description },
+    { property: "og:type", content: config.type ?? "website" },
+    { name: "twitter:card", content: config.image ? "summary_large_image" : "summary" },
+    { name: "twitter:title", content: config.title },
+    { name: "twitter:description", content: description }
+  ];
+  if (config.canonical) meta.push({ property: "og:url", content: config.canonical });
+  if (config.image) {
+    meta.push({ property: "og:image", content: config.image });
+    meta.push({ name: "twitter:image", content: config.image });
+  }
+  if (config.siteName) meta.push({ property: "og:site_name", content: config.siteName });
+  return {
+    title: config.title,
+    meta: meta.filter((m) => m.content !== ""),
+    links: config.canonical ? [{ rel: "canonical", href: config.canonical }] : [],
+    jsonLd: config.jsonLd ?? []
+  };
+}
 function applySeo(config) {
   if (typeof document === "undefined") return;
+  const tags = buildSeoTags(config);
   clearManaged();
-  document.title = config.title;
-  upsertMeta("name", "description", config.description ?? "");
-  if (config.canonical) upsertLink("canonical", config.canonical);
-  upsertMeta("property", "og:title", config.title);
-  upsertMeta("property", "og:description", config.description ?? "");
-  upsertMeta("property", "og:type", config.type === "article" ? "article" : "website");
-  if (config.canonical) upsertMeta("property", "og:url", config.canonical);
-  if (config.image) upsertMeta("property", "og:image", config.image);
-  if (config.siteName) upsertMeta("property", "og:site_name", config.siteName);
-  upsertMeta("name", "twitter:card", config.image ? "summary_large_image" : "summary");
-  upsertMeta("name", "twitter:title", config.title);
-  upsertMeta("name", "twitter:description", config.description ?? "");
-  if (config.image) upsertMeta("name", "twitter:image", config.image);
-  for (const obj of config.jsonLd ?? []) {
+  document.title = tags.title;
+  for (const tag of tags.meta) {
+    if (tag.name) upsertMeta("name", tag.name, tag.content);
+    else if (tag.property) upsertMeta("property", tag.property, tag.content);
+  }
+  for (const link of tags.links) upsertLink(link.rel, link.href);
+  for (const obj of tags.jsonLd) {
     const script = document.createElement("script");
     script.type = "application/ld+json";
     script.setAttribute(MANAGED, "");
@@ -395,11 +573,11 @@ function formatDateTime(value) {
 // src/lib/csv.ts
 function escapeCSVField(value) {
   if (value == null) return "";
-  const str = String(value);
-  if (str.includes(",") || str.includes('"') || str.includes("\n")) {
-    return `"${str.replace(/"/g, '""')}"`;
+  const str2 = String(value);
+  if (str2.includes(",") || str2.includes('"') || str2.includes("\n")) {
+    return `"${str2.replace(/"/g, '""')}"`;
   }
-  return str;
+  return str2;
 }
 function buildCSV(columns, rows) {
   const header = columns.map((c) => escapeCSVField(c.label)).join(",");
@@ -780,11 +958,11 @@ function isMissingFunction(error) {
   return message.includes(RPC_NAME) && (message.includes("does not exist") || message.includes("not find"));
 }
 async function searchViaIndex(query, targets, perTarget, limit) {
-  const client = getSupabaseClientOptional();
+  const client2 = getSupabaseClientOptional();
   const tenantId = getActiveTenantId();
-  if (!client || !tenantId) return { hits: [], ok: false };
+  if (!client2 || !tenantId) return { hits: [], ok: false };
   const byKey = new Map(targets.map((t) => [t.key, t]));
-  const { data, error } = await client.rpc(RPC_NAME, {
+  const { data, error } = await client2.rpc(RPC_NAME, {
     p_query: query.raw,
     p_tenant_id: tenantId,
     p_entity_keys: targets.map((t) => t.key),
@@ -895,12 +1073,12 @@ async function searchViaScan(query, targets, perTarget, onProgress) {
   return { hits: second.hits, failed: [.../* @__PURE__ */ new Set([...first.failed, ...second.failed])] };
 }
 async function searchEverything(rawQuery, options) {
-  const started = Date.now();
+  const started2 = Date.now();
   const query = normalizeQuery(rawQuery);
   const targets = options.targets;
   const limit = options.limit ?? DEFAULT_LIMIT;
   const perTarget = options.perTarget ?? DEFAULT_PER_TARGET;
-  const empty = (via2) => assemble(rawQuery, [], targets, { via: via2, failed: [], elapsedMs: Date.now() - started, perTarget, limit });
+  const empty = (via2) => assemble(rawQuery, [], targets, { via: via2, failed: [], elapsedMs: Date.now() - started2, perTarget, limit });
   if (query.folded.length < MIN_QUERY_LENGTH || targets.length === 0) return empty("cache");
   const scope = scopeKey(targets);
   const exact = cacheGet(scope, query.folded);
@@ -908,7 +1086,7 @@ async function searchEverything(rawQuery, options) {
     return assemble(rawQuery, exact.hits, targets, {
       via: "cache",
       failed: [],
-      elapsedMs: Date.now() - started,
+      elapsedMs: Date.now() - started2,
       perTarget,
       limit
     });
@@ -927,7 +1105,7 @@ async function searchEverything(rawQuery, options) {
       options.onPartial(assemble(rawQuery, rescored, targets, {
         via: "cache",
         failed: [],
-        elapsedMs: Date.now() - started,
+        elapsedMs: Date.now() - started2,
         perTarget,
         limit,
         partial: true
@@ -952,7 +1130,7 @@ async function searchEverything(rawQuery, options) {
     const scanned = await searchViaScan(query, targets, perTarget, emit ? (running) => emit(assemble(rawQuery, running, targets, {
       via: "scan",
       failed: [],
-      elapsedMs: Date.now() - started,
+      elapsedMs: Date.now() - started2,
       perTarget,
       limit,
       partial: true
@@ -964,7 +1142,7 @@ async function searchEverything(rawQuery, options) {
   const result = assemble(rawQuery, hits, targets, {
     via,
     failed,
-    elapsedMs: Date.now() - started,
+    elapsedMs: Date.now() - started2,
     perTarget,
     limit
   });
@@ -978,37 +1156,142 @@ async function searchEverything(rawQuery, options) {
   });
   return result;
 }
-function UnknownBlock({ type }) {
+var errorVisibility = null;
+function defaultVisibility() {
+  try {
+    return process.env.NODE_ENV !== "production" ? "visible" : "silent";
+  } catch {
+    return "silent";
+  }
+}
+function setBlockErrorVisibility(visibility) {
+  errorVisibility = visibility;
+}
+var editorMode = false;
+function setBlockEditorMode(enabled) {
+  editorMode = enabled;
+}
+function blockEditorMode() {
+  return editorMode;
+}
+var BLOCK_PATH_ATTRIBUTE = "data-fayz-block";
+var BLOCK_TYPE_ATTRIBUTE = "data-fayz-block-type";
+var BlockPathContext = React3.createContext("");
+function useBlockPath() {
+  return React3.useContext(BlockPathContext);
+}
+function getBlockErrorVisibility() {
+  return errorVisibility ?? defaultVisibility();
+}
+function BlockErrorCard({ title, detail }) {
   return React3.createElement(
     "div",
     {
+      "data-block-error": title,
       style: {
-        border: "1px dashed #c026d3",
-        color: "#a21caf",
+        border: "1px dashed #dc2626",
+        color: "#b91c1c",
         padding: "8px 12px",
         font: "12px ui-monospace, monospace",
         borderRadius: 6
       }
     },
-    `Unknown block: "${type}"`
+    title,
+    detail ? React3.createElement("div", { style: { opacity: 0.8, marginTop: 4 } }, detail) : null
   );
 }
-function BlockRenderer({ node }) {
+function UnknownBlock({ type }) {
+  if (getBlockErrorVisibility() === "silent") return null;
+  return React3.createElement(BlockErrorCard, { title: `Unknown block: "${type}"` });
+}
+var BlockErrorBoundary = class extends React3.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    console.error(`[blocks] block "${this.props.blockType}" crashed while rendering:`, error, info.componentStack);
+  }
+  render() {
+    if (!this.state.error) return this.props.children;
+    if (getBlockErrorVisibility() === "silent") return null;
+    return React3.createElement(BlockErrorCard, {
+      title: `Block "${this.props.blockType}" crashed`,
+      detail: this.state.error.message
+    });
+  }
+};
+var BlockAncestryContext = React3.createContext([]);
+function ConstraintViolation({ detail }) {
+  if (getBlockErrorVisibility() === "silent") return null;
+  return React3.createElement(BlockErrorCard, { title: "Misplaced block", detail });
+}
+var warnedViolations = /* @__PURE__ */ new Set();
+function BlockRenderer({ node, path }) {
+  const ancestry = React3.useContext(BlockAncestryContext);
   const Comp = getBlock(node.type);
-  const childEls = node.children?.length ? node.children.map(
-    (child, i) => React3.createElement(BlockRenderer, { key: child.id ?? `${child.type}-${i}`, node: child })
-  ) : null;
   if (!Comp) return React3.createElement(UnknownBlock, { type: node.type });
-  return React3.createElement(Comp, { ...node.props ?? {}, node }, childEls);
+  const violations = checkNodePlacement(node.type, ancestry);
+  if (violations.length > 0) {
+    const message = violations.map((v) => v.detail).join("; ");
+    if (!warnedViolations.has(message)) {
+      warnedViolations.add(message);
+      console.warn(`[blocks] ${message}`);
+    }
+    return React3.createElement(ConstraintViolation, { detail: violations[0].detail });
+  }
+  const childEls = node.children?.length ? renderBlocks(node.children, path ? `${path}.children` : void 0) : null;
+  const rendered = React3.createElement(
+    BlockAncestryContext.Provider,
+    { value: ancestry.length ? [...ancestry, node.type] : [node.type] },
+    React3.createElement(
+      BlockErrorBoundary,
+      { blockType: node.type },
+      React3.createElement(Comp, { ...node.props ?? {}, node }, childEls)
+    )
+  );
+  if (!editorMode || !path) return rendered;
+  return React3.createElement(
+    BlockPathContext.Provider,
+    { value: path },
+    React3.createElement(
+      "div",
+      {
+        [BLOCK_PATH_ATTRIBUTE]: path,
+        [BLOCK_TYPE_ATTRIBUTE]: node.type,
+        style: { display: "contents" }
+      },
+      rendered
+    )
+  );
 }
-function renderBlocks(nodes) {
+function renderBlocks(nodes, basePath) {
   return nodes.map(
-    (node, i) => React3.createElement(BlockRenderer, { key: node.id ?? `${node.type}-${i}`, node })
+    (node, i) => React3.createElement(BlockRenderer, {
+      key: node.id ?? `${node.type}-${i}`,
+      node,
+      // POSITIONAL, deliberately. `[#id]` is the reorder-stable form
+      // store-change supports, and using it here looked obviously better — but
+      // by the time a node reaches this function its `id` has been synthesized
+      // (`${type}-${index}`) for every block the document did not name, and the
+      // renderer cannot tell an authored id from a generated one. Emitting
+      // `[#hero-0]` produced paths that resolve against nothing.
+      //
+      // The cost of positional is that a reorder invalidates an outstanding
+      // path. That is bounded: a path is captured on click and spent on save,
+      // and a document that names its blocks can be addressed by id by whoever
+      // holds the document — which is the editor, not the renderer.
+      path: basePath ? `${basePath}[${i}]` : void 0
+    })
   );
 }
 function BlockChildren({ node }) {
+  const path = useBlockPath();
   if (!node?.children?.length) return null;
-  return renderBlocks(node.children);
+  return renderBlocks(node.children, path ? `${path}.children` : void 0);
 }
 
 // src/manifest/index.ts
@@ -2014,7 +2297,7 @@ function renderApp(input, opts = {}) {
   const Scaffold = getScaffold(surface.scaffold);
   if (!Scaffold) {
     throw new Error(
-      `Scaffold "${surface.scaffold}" is not registered. Call renderApp from the package that provides it (e.g. @fayz-ai/saas, @fayz-ai/portal, @fayz-ai/storefront) or call its register*Scaffold() first.`
+      `Scaffold "${surface.scaffold}" is not registered. Call renderApp from the package that provides it (e.g. @fayz-ai/admin, @fayz-ai/portal, @fayz-ai/storefront) or call its register*Scaffold() first.`
     );
   }
   return React3.createElement(
@@ -2063,6 +2346,210 @@ function routeModule(path) {
   return path.replace(/^\/+/, "").split("/")[0] ?? "";
 }
 
-export { BlockChildren, BlockRenderer, COUNTRIES, CURRENT_MANIFEST_VERSION, DATA_CHANGED_EVENT, DEFAULT_COUNTRY, MIN_QUERY_LENGTH, WidgetZone, absoluteUrl, app_manifest_schema_default as appManifestSchema, applySeo, breadcrumbJsonLd, buildCSV, clearPostalCache, clearSearchCache, computeContractHash, createEventBus, createSafeDataProvider, createViaCepProvider, defineApp, digitsOf, downloadCSV, emitDataChanged, eventBus, exportCSV, foldText, foldWithMap, formatCurrency, formatDate, formatDateTime, formatPostalCode, getActiveLocale, getCountry, getDefaultCurrency, getPostalLookupProvider, highlightRanges, isSearchIndexAvailable, isValidPostalCode, lookupPostalCode, maskDigitCount, maskPhone, matchesDataChange, migrateManifest, navHistoryBack, normalizePostalCode, normalizeQuery, organizationJsonLd, recordNavigation, registerManifestMigration, renderApp, renderBlocks, routeModule, scoreCandidate, searchEverything, seoOrigin, serializeManifest, serializeManifestWithHash, setDefaultCurrency, setPostalLookupProvider, setSearchIndexAvailable, similarity, unmaskPhone, useDataChanged, useManifest, useNavHistoryStore, useNavReferrer, useOnEvent, useSeo, validateManifest };
+// src/messaging/registry.ts
+var defaultsRegistry = /* @__PURE__ */ new Map();
+function registerMessageDefaults(defs) {
+  for (const def of defs) defaultsRegistry.set(def.eventKey, def);
+}
+function getMessageDefaults() {
+  return Array.from(defaultsRegistry.values());
+}
+function clearMessageDefaults() {
+  defaultsRegistry.clear();
+}
+function renderMessageTemplate(text, values) {
+  return text.replace(/\{\{\s*(\w+)\s*\}\}/g, (whole, key) => values[key] ?? whole);
+}
+function resolveMessages(overrides, events) {
+  const byKey = new Map(overrides.map((o) => [`${o.eventKey}:${o.channel}`, o]));
+  const byEvent = new Map(events.map((e) => [e.name, e]));
+  const out = [];
+  for (const def of getMessageDefaults()) {
+    const event = byEvent.get(def.eventKey);
+    if (!event) continue;
+    const placeholders = (event.fields ?? []).map((f) => `{{${f.name}}}`);
+    for (const channel of def.channels) {
+      const fallback = def.defaults[channel];
+      if (!fallback) continue;
+      const override = byKey.get(`${def.eventKey}:${channel}`) ?? null;
+      out.push({
+        event,
+        kind: def.kind,
+        channel,
+        override,
+        enabled: override?.enabled ?? def.defaultEnabled?.[channel] ?? false,
+        subject: override?.subject ?? fallback.subject ?? "",
+        body: override?.body ?? fallback.body,
+        customized: Boolean(override?.subject || override?.body),
+        placeholders
+      });
+    }
+  }
+  return out;
+}
+function resolveMessage(eventKey, channel, overrides, events) {
+  return resolveMessages(overrides, events).find((m) => m.event.name === eventKey && m.channel === channel) ?? null;
+}
+function getEventsWithoutMessages(events) {
+  return events.filter((e) => !defaultsRegistry.has(e.name));
+}
+var MESSAGE_TEMPLATES_TABLE = "plg_automations_templates";
+async function loadMessageOverrides(tenantId) {
+  const client2 = getSupabaseClientOptional();
+  if (!client2) return [];
+  try {
+    let q = client2.from(MESSAGE_TEMPLATES_TABLE).select("*");
+    if (tenantId) q = q.eq("tenant_id", tenantId);
+    const { data, error } = await q;
+    if (error) throw error;
+    return (data ?? []).map((row) => ({
+      id: row.id,
+      tenantId: row.tenant_id,
+      eventKey: row.event_key,
+      channel: row.channel ?? "email",
+      enabled: row.enabled ?? null,
+      subject: row.subject || null,
+      body: row.body || null,
+      name: row.name || null,
+      updatedAt: row.updated_at ?? row.created_at
+    }));
+  } catch (err) {
+    console.warn("[messaging] could not load overrides; using defaults", err);
+    return [];
+  }
+}
+
+// src/telemetry/errors.ts
+var APP_ERROR_EVENT = "app.error";
+var reporters = /* @__PURE__ */ new Set();
+function registerErrorReporter(reporter) {
+  reporters.add(reporter);
+  return () => {
+    reporters.delete(reporter);
+  };
+}
+function clearErrorReporters() {
+  reporters.clear();
+}
+function makeErrorId() {
+  const bytes = globalThis.crypto?.getRandomValues?.(new Uint8Array(3));
+  const hex = bytes ? Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("") : Math.floor(Math.random() * 16777215).toString(16).padStart(6, "0");
+  return `ERR-${hex.toUpperCase()}`;
+}
+function toError(value) {
+  if (value instanceof Error) {
+    return { name: value.name, message: value.message, stack: value.stack };
+  }
+  if (typeof value === "string") return { name: "Error", message: value };
+  try {
+    return { name: "Error", message: JSON.stringify(value) ?? String(value) };
+  } catch {
+    return { name: "Error", message: String(value) };
+  }
+}
+var DEDUPE_WINDOW_MS = 5e3;
+var recent = /* @__PURE__ */ new Map();
+function isDuplicate(signature) {
+  const now = Date.now();
+  for (const [key, at] of recent) {
+    if (now - at > DEDUPE_WINDOW_MS) recent.delete(key);
+  }
+  const seen = recent.get(signature);
+  recent.set(signature, now);
+  return seen !== void 0 && now - seen < DEDUPE_WINDOW_MS;
+}
+function resetErrorDedupe() {
+  recent.clear();
+}
+function reportAppError(error, context = {}) {
+  const { name, message, stack } = toError(error);
+  const report = {
+    id: makeErrorId(),
+    name,
+    message,
+    stack,
+    source: context.source ?? "manual",
+    route: context.route ?? null,
+    location: context.location ?? (typeof window !== "undefined" ? window.location.href : null),
+    componentStack: context.componentStack ?? null,
+    tenantId: context.tenantId ?? getActiveTenantId() ?? null,
+    userId: context.userId ?? null,
+    occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+    userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0,
+    extra: context.extra,
+    error
+  };
+  if (isDuplicate(`${report.source}|${report.name}|${report.message}|${report.route ?? ""}`)) {
+    return report;
+  }
+  console.error(`[error:${report.source}] ${report.id}`, error);
+  for (const reporter of reporters) {
+    try {
+      reporter(report);
+    } catch (err) {
+      console.warn("[error] reporter failed", err);
+    }
+  }
+  try {
+    const { error: _raw, ...payload } = report;
+    emitDomainEvent(APP_ERROR_EVENT, payload, {
+      actorId: report.userId,
+      tenantId: report.tenantId
+    });
+  } catch (err) {
+    console.warn("[error] event emit failed", err);
+  }
+  return report;
+}
+var uninstall = null;
+function installGlobalErrorHandlers() {
+  if (uninstall) return uninstall;
+  if (typeof window === "undefined") return () => {
+  };
+  const onError = (event) => {
+    reportAppError(event.error ?? event.message, {
+      source: "window",
+      extra: { filename: event.filename, lineno: event.lineno, colno: event.colno }
+    });
+  };
+  const onRejection = (event) => {
+    reportAppError(event.reason, { source: "promise" });
+  };
+  window.addEventListener("error", onError);
+  window.addEventListener("unhandledrejection", onRejection);
+  uninstall = () => {
+    window.removeEventListener("error", onError);
+    window.removeEventListener("unhandledrejection", onRejection);
+    uninstall = null;
+  };
+  return uninstall;
+}
+function createVendorReporter(client2) {
+  return (report) => {
+    const hint = {
+      tags: {
+        errorId: report.id,
+        source: report.source,
+        route: report.route ?? "unknown",
+        tenantId: report.tenantId ?? "unknown"
+      },
+      extra: {
+        errorId: report.id,
+        location: report.location,
+        componentStack: report.componentStack,
+        userId: report.userId,
+        occurredAt: report.occurredAt,
+        ...report.extra
+      }
+    };
+    if (!(report.error instanceof Error) && client2.captureMessage) {
+      client2.captureMessage(`${report.name}: ${report.message}`, hint);
+      return;
+    }
+    client2.captureException(report.error, hint);
+  };
+}
+
+export { APP_ERROR_EVENT, BLOCK_PATH_ATTRIBUTE, BLOCK_TYPE_ATTRIBUTE, BlockChildren, BlockErrorBoundary, BlockRenderer, COUNTRIES, CURRENT_MANIFEST_VERSION, DATA_CHANGED_EVENT, DEFAULT_COUNTRY, EVENT_LOG_TABLE, MESSAGE_TEMPLATES_TABLE, MIN_QUERY_LENGTH, WidgetZone, absoluteUrl, app_manifest_schema_default as appManifestSchema, applySeo, blockEditorMode, breadcrumbJsonLd, buildCSV, buildSeoTags, clearErrorReporters, clearEventSinks, clearMessageDefaults, clearPostalCache, clearSearchCache, computeContractHash, createEventBus, createSafeDataProvider, createVendorReporter, createViaCepProvider, defineApp, digitsOf, downloadCSV, emitDataChanged, emitDomainEvent, eventBus, exportCSV, foldText, foldWithMap, formatCurrency, formatDate, formatDateTime, formatPostalCode, getActiveLocale, getBlockErrorVisibility, getCountry, getDefaultCurrency, getEventsWithoutMessages, getMessageDefaults, getPostalLookupProvider, highlightRanges, installGlobalErrorHandlers, isSearchIndexAvailable, isValidPostalCode, loadEventRuns, loadMessageOverrides, lookupPostalCode, maskDigitCount, maskPhone, matchesDataChange, migrateManifest, navHistoryBack, normalizePostalCode, normalizeQuery, onDomainEvent, onDomainEvents, organizationJsonLd, recordEventRun, recordNavigation, registerErrorReporter, registerEventSink, registerManifestMigration, registerMessageDefaults, renderApp, renderBlocks, renderMessageTemplate, reportAppError, resetErrorDedupe, resolveBackendEnv, resolveMessage, resolveMessages, routeModule, sampleEventPayload, scoreCandidate, searchEverything, seoOrigin, serializeManifest, serializeManifestWithHash, setBlockEditorMode, setBlockErrorVisibility, setDefaultCurrency, setPostalLookupProvider, setSearchIndexAvailable, similarity, startEventLog, unmaskPhone, useBlockPath, useDataChanged, useManifest, useNavHistoryStore, useNavReferrer, useOnEvent, useSeo, validateManifest };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map