@fayz-ai/core 0.10.0 → 0.12.0

package/dist/index.js

@@ -1,15 +1,19 @@
-export { connectorDirection, connectorPlanes, preferredPlane, withAfterHooks } from './chunk-6RBW2Y5K.js';
-export { PluginContractError, assertConnectorContract, assertPluginManifestContract } from './chunk-CPMHCTX3.js';
-import { getActiveTenantId, globalCache, getSupabaseClientOptional, resolveDataProvider } from './chunk-JO7Z2AOE.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-JO7Z2AOE.js';
-import { getBlock, checkNodePlacement, getScaffold } from './chunk-732GZEUI.js';
-export { BLOCK_SETTING_TYPES, ENTITY_FIELD_TYPES, GENERIC_ENTITY_TABLE, PLUGIN_API_VERSION, PluginRuntimeProvider, RESERVED_ENTITY_FIELDS, Registry, SIDECAR_REFERENCES, auditBlocks, blockRegistry, buildEntityDomainEvents, checkAgainstSchema, checkBlockConstraints, checkBlockContext, checkNodePlacement, clearEntityDeclarations, clearExtensionPoints, clearHandles, clearLoaders, clearSidecarDeclarations, componentRegistry, dataNeedKey, defaultPropsFromSettings, defineBlock, defineEntity, defineExtensionPoint, defineLoader, definePlugin, defineSidecarFields, describeBlock, describeBlocks, describeEntities, describeExtensionPoints, describeLoaders, entityAdminForm, entityDeclarationRegistry, entityEventKey, entityRecordSchema, extensionAfterHooks, extensionPointRegistry, formatSchemaIssues, getAnalyticsCards, getBlock, getBlockMeta, getComponent, getDashboardWidgets, getHandle, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, handleNameFor, handleRegistry, hasEntityDeclaration, hasExtensionPoint, hasHandle, hasLoader, hasSidecarDeclaration, isBlockEnabledOn, isCustomId, isLoaderParamRef, isLoaderPropRef, listBlocks, listEntityDeclarations, listExtensionHandlers, listExtensionPoints, listHandles, listLoaders, listMetrics, listPluginFactories, listPlugins, loaderRegistry, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerExtensionHandler, registerHandle, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, repairBlockTree, resolveEntityDeclaration, resolveHandle, resolveLoader, resolvePluginComponent, resolvePluginRuntime, resolveSidecarDeclaration, runEscapeValve, runExtensionPoint, scaffoldRegistry, settingsToJsonSchema, sidecarDeclarationRegistry, summarizeBlockAudit, unregisterExtensionHandler, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional, validateEntityRecordData } from './chunk-732GZEUI.js';
+export { PluginContractError, assertConnectorContract, assertPluginManifestContract, bespokeConnectorTables } from './chunk-IKZR3WSK.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-7GJTLBG3.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 { eventBus, DATA_CHANGED_EVENT, resolveDataProvider } from './chunk-S5FOFKR4.js';
+export { CustomFieldsError, DATA_CHANGED_EVENT, DataError, FIELDS_TABLE, attachPersistentCache, bulkCreate, bulkRemove, cacheKeyFor, cachePrefixFor, clearCustomFieldsCache, countByTenant, createArchetypeProvider, createEventBus, createFayzApiProvider, createMockProvider, dataCall, dataQuery, emitDataChanged, eventBus, getPersistentCache, invalidateCount, localList, matchesDataChange, mergeCustomFields, registerDataTelemetry, replicaKeyFor, resolveCustomFields, resolveDataProvider, syncReplica, toDataError, useDataChanged, validateCustomFields, withCache, withOffline } from './chunk-S5FOFKR4.js';
+import { getActiveTenantId, getSupabaseClientOptional } from './chunk-KFBEKFII.js';
+export { DEFAULT_CACHE_TTL, applyRangeToQuery, clearGlobalCache, createCacheStore, createSupabaseProvider, getActiveTenantId, getSupabaseClientOptional, globalCache, isFilterObject, matchesRange, parseRangeFilter, setActiveTenantId, setGlobalSupabaseClient, stableKey, subscribeActiveTenant, useActiveTenantId } from './chunk-KFBEKFII.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 { getCurrentLocale } from './chunk-M27JPX3K.js';
-export { I18nProvider, coreTranslations, getCurrentLocale, mergeTranslations, preloadLocale, registerTranslations, setCurrentLocale, setLocaleStore, tl, useI18nConfig, useTranslation } from './chunk-M27JPX3K.js';
+import { getCurrentLocale } from './chunk-U3252GZO.js';
+export { I18nProvider, coreTranslations, getCurrentLocale, mergeTranslations, preloadLocale, registerTranslations, setCurrentLocale, setLocaleStore, tl, useI18nConfig, useTranslation } from './chunk-U3252GZO.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 * as React2 from 'react';
 import { useEffect } from 'react';
 import { create } from 'zustand';
 
@@ -49,217 +53,6 @@ function resolveBackendEnv(options = {}) {
   };
 }
 
-// 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
-  };
-}
-function recordEventRun(event, status = "recorded") {
-  const db = client();
-  if (!db) return;
-  const tenantId = event.tenantId ?? getActiveTenantId();
-  if (!tenantId) return;
-  void (async () => {
-    try {
-      await db.from(EVENT_LOG_TABLE).insert({
-        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
-      });
-    } catch (err) {
-      console.warn("[events] could not record run", err);
-    }
-  })();
-}
-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 = {
-    emit(event, payload) {
-      const set = handlers.get(event);
-      if (!set) return;
-      for (const handler of Array.from(set)) {
-        try {
-          handler(payload);
-        } catch (err) {
-          console.error(`[fayz] event handler for "${event}" threw:`, err);
-        }
-      }
-    },
-    on(event, handler) {
-      let set = handlers.get(event);
-      if (!set) {
-        set = /* @__PURE__ */ new Set();
-        handlers.set(event, set);
-      }
-      set.add(handler);
-      return () => bus.off(event, handler);
-    },
-    once(event, handler) {
-      const wrapped = (payload) => {
-        bus.off(event, wrapped);
-        handler(payload);
-      };
-      return bus.on(event, wrapped);
-    },
-    off(event, handler) {
-      handlers.get(event)?.delete(handler);
-    },
-    clear(event) {
-      if (event) handlers.delete(event);
-      else handlers.clear();
-    }
-  };
-  return bus;
-}
-var eventBus = createEventBus();
-function useOnEvent(event, handler, deps = []) {
-  const ref = React3.useRef(handler);
-  ref.current = handler;
-  React3.useEffect(
-    () => eventBus.on(event, (payload) => ref.current(payload)),
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [event, ...deps]
-  );
-}
-
-// src/data/refresh.ts
-var DATA_CHANGED_EVENT = "data:changed";
-function matchesDataChange(match, payload) {
-  const attributed = payload.table ?? payload.entityKey ?? payload.archetype;
-  if (!attributed) return true;
-  if (match.table && payload.table && match.table === payload.table) return true;
-  if (match.entityKey && payload.entityKey && match.entityKey === payload.entityKey) return true;
-  if (match.archetype && payload.archetype && match.archetype === payload.archetype) return true;
-  return !match.table && !match.entityKey && !match.archetype;
-}
-var pending = [];
-var flushTimer = null;
-function flush() {
-  const batch = pending;
-  pending = [];
-  flushTimer = null;
-  for (const payload of batch) eventBus.emit(DATA_CHANGED_EVENT, payload);
-}
-function emitDataChanged(payload = {}) {
-  if (payload.table) {
-    const tenant = getActiveTenantId() ?? "_";
-    const sibling = payload.table.startsWith("v_") ? payload.table.slice(2) : `v_${payload.table}`;
-    globalCache.invalidate(`${tenant}:${payload.table}`);
-    globalCache.invalidate(`${tenant}:${sibling}`);
-  } else {
-    globalCache.clear();
-  }
-  pending.push({ op: "unknown", source: "agent", ...payload });
-  if (flushTimer) return;
-  flushTimer = setTimeout(flush, 120);
-}
-function useDataChanged(match, handler, deps = []) {
-  const handlerRef = React3.useRef(handler);
-  handlerRef.current = handler;
-  const { table, entityKey, archetype } = match;
-  React3.useEffect(
-    () => eventBus.on(DATA_CHANGED_EVENT, (payload) => {
-      if (matchesDataChange({ table, entityKey, archetype }, payload)) handlerRef.current(payload);
-    }),
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [table, entityKey, archetype, ...deps]
-  );
-}
-
 // src/plugin/createSafeDataProvider.ts
 function createSafeDataProvider(makeSupabase, makeMock) {
   let resolved = null;
@@ -584,6 +377,148 @@ function exportCSV(columns, rows, filename) {
   downloadCSV(buildCSV(columns, rows), filename);
 }
 
+// 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 useOnEvent(event, handler, deps = []) {
+  const ref = React2.useRef(handler);
+  ref.current = handler;
+  React2.useEffect(
+    () => eventBus.on(event, (payload) => ref.current(payload)),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [event, ...deps]
+  );
+}
+
 // src/search/text.ts
 var COMBINING_MARKS = /[\u0300-\u036f]/g;
 function foldText(value) {
@@ -899,7 +834,8 @@ function assemble(query, hits, targets, opts) {
     via: opts.via,
     failed: opts.failed,
     elapsedMs: opts.elapsedMs,
-    partial: opts.partial ?? false
+    partial: opts.partial ?? false,
+    cached: opts.cached ?? opts.via === "cache"
   };
 }
 var cache = [];
@@ -1016,7 +952,7 @@ async function mapLimited(items, limit, fn) {
   await Promise.all(workers);
   return results;
 }
-async function searchViaScan(query, targets, perTarget, onProgress) {
+async function searchViaScan(query, targets, perTarget, onProgress, fresh) {
   const multiWord = query.tokens.length > 1;
   const phrase = query.folded;
   const token = query.anchor.length >= MIN_QUERY_LENGTH ? query.anchor : phrase;
@@ -1024,12 +960,16 @@ async function searchViaScan(query, targets, perTarget, onProgress) {
   const widePageSize = Math.min(perTarget * 6, 40);
   const searchable = targets.filter((t) => searchableKeys(t.entity).length > 0);
   const running = [];
+  let anyCached = false;
   const round = (search, size) => mapLimited(searchable, SCAN_CONCURRENCY, async (target) => {
-    const provider = resolveDataProvider(target.entity, target.mockData);
+    const provider = resolveDataProvider(target.entity, target.mockData, {
+      cache: fresh ? false : void 0
+    });
     const result = await withTimeout(
       provider.list({ search, pageSize: size, countMode: "none" }),
       TARGET_TIMEOUT_MS
     );
+    if (result.cached || result.stale) anyCached = true;
     const rows = result.data;
     const hits = rows.map((row) => hitFromRow(target, row, query)).filter((h) => h !== null);
     if (hits.length && onProgress) {
@@ -1048,9 +988,9 @@ async function searchViaScan(query, targets, perTarget, onProgress) {
     return { hits, failed };
   };
   const first = collect(await round(phrase, pageSize));
-  if (first.hits.length > 0 || !multiWord || token === phrase) return first;
+  if (first.hits.length > 0 || !multiWord || token === phrase) return { ...first, cached: anyCached };
   const second = collect(await round(token, widePageSize));
-  return { hits: second.hits, failed: [.../* @__PURE__ */ new Set([...first.failed, ...second.failed])] };
+  return { hits: second.hits, failed: [.../* @__PURE__ */ new Set([...first.failed, ...second.failed])], cached: anyCached };
 }
 async function searchEverything(rawQuery, options) {
   const started2 = Date.now();
@@ -1061,7 +1001,7 @@ async function searchEverything(rawQuery, options) {
   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);
+  const exact = options.fresh ? void 0 : cacheGet(scope, query.folded);
   if (exact) {
     return assemble(rawQuery, exact.hits, targets, {
       via: "cache",
@@ -1071,7 +1011,7 @@ async function searchEverything(rawQuery, options) {
       limit
     });
   }
-  if (options.onPartial) {
+  if (options.onPartial && !options.fresh) {
     const prefix = cachePrefix(scope, query.folded);
     if (prefix) {
       const rescored = prefix.hits.map((hit) => {
@@ -1095,6 +1035,7 @@ async function searchEverything(rawQuery, options) {
   let hits = [];
   let failed = [];
   let via = "scan";
+  let anyCached = false;
   if (!options.forceScan && indexAvailable !== false) {
     try {
       const indexed = await searchViaIndex(query, targets, perTarget, limit);
@@ -1114,9 +1055,10 @@ async function searchEverything(rawQuery, options) {
       perTarget,
       limit,
       partial: true
-    })) : void 0);
+    })) : void 0, options.fresh);
     hits = scanned.hits;
     failed = scanned.failed;
+    anyCached = scanned.cached;
   }
   if (options.signal?.aborted) return empty(via);
   const result = assemble(rawQuery, hits, targets, {
@@ -1124,7 +1066,8 @@ async function searchEverything(rawQuery, options) {
     failed,
     elapsedMs: Date.now() - started2,
     perTarget,
-    limit
+    limit,
+    cached: anyCached
   });
   cacheSet({
     scope,
@@ -1156,15 +1099,15 @@ function blockEditorMode() {
 }
 var BLOCK_PATH_ATTRIBUTE = "data-fayz-block";
 var BLOCK_TYPE_ATTRIBUTE = "data-fayz-block-type";
-var BlockPathContext = React3.createContext("");
+var BlockPathContext = React2.createContext("");
 function useBlockPath() {
-  return React3.useContext(BlockPathContext);
+  return React2.useContext(BlockPathContext);
 }
 function getBlockErrorVisibility() {
   return errorVisibility ?? defaultVisibility();
 }
 function BlockErrorCard({ title, detail }) {
-  return React3.createElement(
+  return React2.createElement(
     "div",
     {
       "data-block-error": title,
@@ -1177,14 +1120,14 @@ function BlockErrorCard({ title, detail }) {
       }
     },
     title,
-    detail ? React3.createElement("div", { style: { opacity: 0.8, marginTop: 4 } }, detail) : null
+    detail ? React2.createElement("div", { style: { opacity: 0.8, marginTop: 4 } }, detail) : null
   );
 }
 function UnknownBlock({ type }) {
   if (getBlockErrorVisibility() === "silent") return null;
-  return React3.createElement(BlockErrorCard, { title: `Unknown block: "${type}"` });
+  return React2.createElement(BlockErrorCard, { title: `Unknown block: "${type}"` });
 }
-var BlockErrorBoundary = class extends React3.Component {
+var BlockErrorBoundary = class extends React2.Component {
   constructor() {
     super(...arguments);
     this.state = { error: null };
@@ -1198,22 +1141,22 @@ var BlockErrorBoundary = class extends React3.Component {
   render() {
     if (!this.state.error) return this.props.children;
     if (getBlockErrorVisibility() === "silent") return null;
-    return React3.createElement(BlockErrorCard, {
+    return React2.createElement(BlockErrorCard, {
       title: `Block "${this.props.blockType}" crashed`,
       detail: this.state.error.message
     });
   }
 };
-var BlockAncestryContext = React3.createContext([]);
+var BlockAncestryContext = React2.createContext([]);
 function ConstraintViolation({ detail }) {
   if (getBlockErrorVisibility() === "silent") return null;
-  return React3.createElement(BlockErrorCard, { title: "Misplaced block", detail });
+  return React2.createElement(BlockErrorCard, { title: "Misplaced block", detail });
 }
 var warnedViolations = /* @__PURE__ */ new Set();
 function BlockRenderer({ node, path }) {
-  const ancestry = React3.useContext(BlockAncestryContext);
+  const ancestry = React2.useContext(BlockAncestryContext);
   const Comp = getBlock(node.type);
-  if (!Comp) return React3.createElement(UnknownBlock, { type: node.type });
+  if (!Comp) return React2.createElement(UnknownBlock, { type: node.type });
   const violations = checkNodePlacement(node.type, ancestry);
   if (violations.length > 0) {
     const message = violations.map((v) => v.detail).join("; ");
@@ -1221,23 +1164,23 @@ function BlockRenderer({ node, path }) {
       warnedViolations.add(message);
       console.warn(`[blocks] ${message}`);
     }
-    return React3.createElement(ConstraintViolation, { detail: violations[0].detail });
+    return React2.createElement(ConstraintViolation, { detail: violations[0].detail });
   }
   const childEls = node.children?.length ? renderBlocks(node.children, path ? `${path}.children` : void 0) : null;
-  const rendered = React3.createElement(
+  const rendered = React2.createElement(
     BlockAncestryContext.Provider,
     { value: ancestry.length ? [...ancestry, node.type] : [node.type] },
-    React3.createElement(
+    React2.createElement(
       BlockErrorBoundary,
       { blockType: node.type },
-      React3.createElement(Comp, { ...node.props ?? {}, node }, childEls)
+      React2.createElement(Comp, { ...node.props ?? {}, node }, childEls)
     )
   );
   if (!editorMode || !path) return rendered;
-  return React3.createElement(
+  return React2.createElement(
     BlockPathContext.Provider,
     { value: path },
-    React3.createElement(
+    React2.createElement(
       "div",
       {
         [BLOCK_PATH_ATTRIBUTE]: path,
@@ -1250,7 +1193,7 @@ function BlockRenderer({ node, path }) {
 }
 function renderBlocks(nodes, basePath) {
   return nodes.map(
-    (node, i) => React3.createElement(BlockRenderer, {
+    (node, i) => React2.createElement(BlockRenderer, {
       key: node.id ?? `${node.type}-${i}`,
       node,
       // POSITIONAL, deliberately. `[#id]` is the reorder-stable form
@@ -2246,9 +2189,9 @@ var app_manifest_schema_default = {
     }
   }
 };
-var ManifestContext = React3.createContext(null);
+var ManifestContext = React2.createContext(null);
 function useManifest() {
-  return React3.useContext(ManifestContext);
+  return React2.useContext(ManifestContext);
 }
 function defineApp(manifest) {
   const full = {
@@ -2280,10 +2223,10 @@ function renderApp(input, opts = {}) {
       `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(
+  return React2.createElement(
     ManifestContext.Provider,
     { value: manifest },
-    React3.createElement(Scaffold, { manifest, surface: surfaceName })
+    React2.createElement(Scaffold, { manifest, surface: surfaceName })
   );
 }
 var MAX_ENTRIES = 20;
@@ -2399,6 +2342,137 @@ async function loadMessageOverrides(tenantId) {
   }
 }
 
-export { 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, clearEventSinks, clearMessageDefaults, clearPostalCache, clearSearchCache, computeContractHash, createEventBus, createSafeDataProvider, createViaCepProvider, defineApp, digitsOf, downloadCSV, emitDataChanged, emitDomainEvent, eventBus, exportCSV, foldText, foldWithMap, formatCurrency, formatDate, formatDateTime, formatPostalCode, getActiveLocale, getBlockErrorVisibility, getCountry, getDefaultCurrency, getEventsWithoutMessages, getMessageDefaults, getPostalLookupProvider, highlightRanges, isSearchIndexAvailable, isValidPostalCode, loadEventRuns, loadMessageOverrides, lookupPostalCode, maskDigitCount, maskPhone, matchesDataChange, migrateManifest, navHistoryBack, normalizePostalCode, normalizeQuery, onDomainEvent, onDomainEvents, organizationJsonLd, recordEventRun, recordNavigation, registerEventSink, registerManifestMigration, registerMessageDefaults, renderApp, renderBlocks, renderMessageTemplate, 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 };
+// 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, 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, createSafeDataProvider, createVendorReporter, createViaCepProvider, defineApp, digitsOf, downloadCSV, emitDomainEvent, exportCSV, foldText, foldWithMap, formatCurrency, formatDate, formatDateTime, formatPostalCode, getActiveLocale, getBlockErrorVisibility, getCountry, getDefaultCurrency, getEventsWithoutMessages, getMessageDefaults, getPostalLookupProvider, highlightRanges, installGlobalErrorHandlers, isSearchIndexAvailable, isValidPostalCode, loadEventRuns, loadMessageOverrides, lookupPostalCode, maskDigitCount, maskPhone, 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, useManifest, useNavHistoryStore, useNavReferrer, useOnEvent, useSeo, validateManifest };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map