@fayz-ai/core 0.9.0 → 0.10.0

package/src/index.ts

@@ -1,217 +0,0 @@
-// Types
-export type { EntityArchetype, BaseEntity, PersonEntity, ProductEntity, ServiceEntity, OrderEntity, TransactionEntity, LocationEntity, ScheduleEntity, CategoryEntity } from './types/entities'
-export type { EntityDef, EntityImageConfig, FieldDef, FieldType, FieldRelation, FieldGroup, DetailTab, FormLayout, ComputedFieldValue } from './types/crud'
-export type { PluginManifest, PluginScope, PluginStatus, ResolvedPluginManifest, PluginRuntime, PluginRuntimeContext, PluginWidgetZone, PluginWidgetDefinition, PluginNavigationEntry, PluginSettingsTab, PluginRouteDefinition, PluginAITool, AIToolMode, AIToolExecution, AgentRpcDeclaration, AIToolParameterProperty, AIToolParameters, AIToolSuggestion, PluginRegistryDef, PluginMigration, PluginDiagnostic, VerticalId, ScaffoldType, TenantPluginBinding, DashboardWidgetDef, DashboardWidgetKind, DashboardSurface, DashboardLayoutConfig, ResolvedDashboardWidget } from './types/plugins'
-export { WidgetZone } from './types/plugins'
-export type { AuthAdapter, AuthUser, AuthSession, AuthProvider } from './types/auth'
-export type { OrgAdapter, Organization, OrgMember, OrgMembership, TeamPerson, Location, Invite, CreateOrgOptions } from './types/org'
-export type { PermissionsConfig, FeatureDeclaration, PermissionAction, PermissionProfile, SystemPermission } from './types/permissions'
-export type { Plan, BillingConfig, BillingCheckoutFn } from './types/billing'
-export type { PlanEntitlements, LimitDeclaration } from './types/entitlements'
-export type { ThemeBrand, ThemeRadius, ThemeMode } from './types/theme'
-export type { LocaleConfig } from './types/i18n'
-
-// Data providers
-export { createSupabaseProvider, setGlobalSupabaseClient, getSupabaseClientOptional } from './data/supabase'
-export { countByTenant, invalidateCount } from './data/count'
-export type { CountByTenantOptions } from './data/count'
-export { createFayzApiProvider } from './data/platform-api'
-export { createMockProvider } from './data/mock'
-export { createArchetypeProvider } from './data/archetype'
-export { withCache } from './data/cached'
-export { resolveDataProvider } from './data/resolve'
-export { bulkCreate } from './data/bulk'
-export type { BulkWriteOptions, BulkWriteResult } from './data/types'
-export {
-  parseRangeFilter,
-  isFilterObject,
-  matchesRange,
-  applyRangeToQuery,
-} from './data/filters'
-export type { RangeFilter } from './data/filters'
-export {
-  DATA_CHANGED_EVENT,
-  emitDataChanged,
-  matchesDataChange,
-  useDataChanged,
-} from './data/refresh'
-export type { DataChangedPayload, DataChangedMatch } from './data/refresh'
-export { createSafeDataProvider } from './plugin/createSafeDataProvider'
-export {
-  COUNTRIES, DEFAULT_COUNTRY, getCountry, unmaskPhone, maskPhone, maskDigitCount,
-} from './phone'
-export type { CountryDef } from './phone'
-export {
-  normalizePostalCode, formatPostalCode, isValidPostalCode,
-  createViaCepProvider, setPostalLookupProvider, getPostalLookupProvider,
-  lookupPostalCode, clearPostalCache,
-} from './address'
-export type { PostalAddress, PostalLookupProvider } from './address'
-export type {
-  PaymentProvider, PaymentMethod, ChargeStatus, CreateChargeInput, PixCharge,
-} from './types/payment'
-export {
-  useSeo, applySeo, absoluteUrl, seoOrigin, breadcrumbJsonLd, organizationJsonLd,
-} from './seo'
-export type { SeoConfig, BreadcrumbItem } from './seo'
-export type { DataProvider, CrudQuery, CrudResult, SupabaseProviderConfig, FayzApiProviderConfig } from './data/index'
-
-// Tenant context (runtime DI for the data layer)
-export { setActiveTenantId, getActiveTenantId, subscribeActiveTenant, useActiveTenantId } from './tenant'
-
-// Runtime broker helpers
-export { createFayzRuntimeClient, FayzRuntimeError } from './runtime'
-export type {
-  FayzRuntimeClientOptions,
-  FayzRuntimeEnvironment,
-  GoogleCalendarEvent,
-  GoogleCalendarEventInput,
-  GoogleCalendarEventTime,
-  ListGoogleCalendarEventsInput,
-  PluginOAuthExchangeInput,
-  PluginOAuthExchangeResponse,
-  RuntimePluginOAuthGrant,
-} from './runtime'
-
-// Plugin contract assertions (integrity half of the deploy gate)
-export { assertPluginManifestContract, assertConnectorContract, PluginContractError } from './testing'
-
-// Integration connector spine (shared contract for external-provider sync)
-export { withAfterHooks, connectorPlanes, preferredPlane, connectorDirection } from './integrations'
-export type {
-  Connector,
-  ConnectorCapability,
-  ConnectionConfig,
-  SyncRun,
-  SyncDirection,
-  SyncTrigger,
-  IntegrationAuthKind,
-  TestConnectionResult,
-  ConnectorDefinition,
-  ConnectorField,
-  ConnectorStatus,
-  ConnectorPlane,
-  ConnectorDirection,
-  ConnectorAgentTool,
-} from './integrations'
-
-// Shared utilities
-export { formatCurrency, formatDate, formatDateTime, getActiveLocale, getDefaultCurrency, setDefaultCurrency } from './lib/format'
-export { exportCSV, buildCSV, downloadCSV } from './lib/csv'
-export type { CSVColumn } from './lib/csv'
-export { globalCache, createCacheStore, stableKey, clearGlobalCache } from './lib/cache'
-export type { CacheStore } from './lib/cache'
-
-// Plugin system
-export { definePlugin, resolvePluginRuntime, getWidgetsForZone, getDashboardWidgets, PluginRuntimeProvider, usePluginRuntime, usePluginRuntimeOptional, useConnectorsForPlugin, PLUGIN_API_VERSION, resolvePluginComponent } from './plugin/runtime'
-export type { PluginEventDefinition, PluginQuickAction } from './types/plugins'
-
-// Event bus
-export { createEventBus, eventBus, useOnEvent } from './events'
-export type { EventBus, EventHandler } from './events'
-
-// Entity registry
-export { registerEntity, getEntityByKey, getAllEntities, clearEntityRegistry, deriveEntityKey } from './entity/registry'
-export type { RegisteredEntity } from './entity/registry'
-
-// Global search (command palette + agent lookups share one engine)
-export {
-  searchEverything, clearSearchCache, setSearchIndexAvailable, isSearchIndexAvailable,
-  MIN_QUERY_LENGTH, foldText, foldWithMap, digitsOf, normalizeQuery, similarity,
-  scoreCandidate, highlightRanges,
-} from './search'
-export type {
-  SearchTarget, SearchHit, SearchGroup, SearchPath, SearchOptions, GlobalSearchResult,
-  NormalizedQuery, RankCandidate,
-} from './search'
-
-// Uniform registry (component / block / page / metric / scaffold / plugin)
-export {
-  Registry,
-  isCustomId,
-  componentRegistry,
-  blockRegistry,
-  pageRegistry,
-  scaffoldRegistry,
-  metricRegistry,
-  pluginRegistry,
-  registerComponent,
-  getComponent,
-  registerBlock,
-  getBlock,
-  listBlocks,
-  registerPage,
-  getPage,
-  registerScaffold,
-  getScaffold,
-  registerMetric,
-  getMetric,
-  listMetrics,
-  registerPlugin,
-  getPlugin,
-  listPlugins,
-  pluginFactoryRegistry,
-  registerPluginFactory,
-  getPluginFactory,
-  listPluginFactories,
-} from './registry'
-export type { PluginFactory } from './registry'
-export type {
-  JsonSchema,
-  RegistrySource,
-  RegistryMeta,
-  RegistryEntry,
-  MetricFormat,
-  MetricContext,
-  MetricValue,
-  MetricDefinition,
-} from './registry'
-
-// Block system (universal page primitive)
-export { BlockRenderer, renderBlocks, BlockChildren } from './blocks'
-export type { BlockNode, BlockComponentProps } from './blocks'
-
-// App manifest (the app, as data) + migration runner
-export {
-  CURRENT_MANIFEST_VERSION,
-  registerManifestMigration,
-  migrateManifest,
-  validateManifest,
-} from './manifest'
-export type {
-  AppManifest,
-  BackendProvider,
-  BackendRef,
-  SurfaceManifest,
-  PageManifest,
-  PluginRef,
-  ManifestMigration,
-  AgentContract,
-  AgentDomainKnowledge,
-  EntityContract,
-  AIToolContract,
-  RpcContract,
-} from './manifest'
-export { serializeManifest, computeContractHash, serializeManifestWithHash } from './manifest/serialize'
-export { default as appManifestSchema } from './manifest/app-manifest.schema.json'
-
-// App entry points (manifest → running app)
-export { defineApp, renderApp, useManifest } from './app/render'
-export type { RenderAppOptions } from './app/render'
-
-// i18n
-export { I18nProvider, useI18nConfig, useTranslation, coreTranslations, mergeTranslations, registerTranslations, getCurrentLocale, setCurrentLocale, preloadLocale, setLocaleStore } from './i18n/index'
-
-// Router
-export { hashRouterAdapter, windowRouterAdapter } from './router/index'
-export type { RouterAdapter } from './router/index'
-
-// Global cross-module navigation history (context-aware back buttons)
-export {
-  useNavHistoryStore,
-  recordNavigation,
-  useNavReferrer,
-  navHistoryBack,
-  routeModule,
-} from './router/history'
-export type { NavHistoryEntry } from './router/history'

package/src/integrations/index.ts

@@ -1,237 +0,0 @@
-// ---------------------------------------------------------------------------
-// Integration Connector spine
-// ---------------------------------------------------------------------------
-// An integration is a connector that keeps canonical Fayz data in agreement
-// with an external provider (Google Calendar, open banking, Shopify, …). This
-// module is the thin shared contract both native (SDK) and client-built
-// connectors implement. The heavy lifting (auth, fetch/push, idempotent
-// upserts) runs in the data plane — typically a Supabase Edge Function — while
-// the control plane (a settings tab + this contract) lives in the app/plugin.
-//
-// Design notes live in docs/design/bling-integration-brief.md. Proven precedents:
-// the Fayz runtime OAuth broker (packages/core/src/runtime/oauth.ts) and the
-// bank-statement edge functions in the predecessor app.
-import type * as React from 'react'
-
-/** How a connector authenticates to its provider. */
-export type IntegrationAuthKind = 'oauth' | 'api-key' | 'mtls'
-
-// ---------------------------------------------------------------------------
-// Planes — the two ways a connector gets honoured
-// ---------------------------------------------------------------------------
-// "Integração" and "conector" are the same noun. What differs is the plane it
-// runs on:
-//
-//   - 'agentic' — the provider's tools are handed to the assistant. Nothing is
-//     copied: the agent calls the provider at the moment it needs the answer,
-//     so there is no mirror to drift and no de-para to maintain. Preferred
-//     whenever the provider offers it.
-//   - 'sync'    — the old-school pipeline: authorize, map, run, keep an audit
-//     trail. Required when the data must exist *inside* Fayz — to be listed,
-//     filtered, reported on, or read while the provider is unreachable.
-//
-// A connector may support both; `preferredPlane` encodes the house rule.
-export type ConnectorPlane = 'agentic' | 'sync'
-
-/** Which side reaches for the other, from this app's point of view. */
-export type ConnectorDirection = 'inbound' | 'outbound'
-
-/** A tool the assistant gains once a connector is resolved on the agentic plane. */
-export interface ConnectorAgentTool {
-  name: string
-  description?: string
-}
-
-/** Which way data flows for a given capability. */
-export type SyncDirection = 'inbound' | 'outbound' | 'bidirectional'
-
-/** What causes a sync to run. */
-export type SyncTrigger = 'on-write' | 'scheduled' | 'manual' | 'webhook'
-
-/** One thing a connector can sync (an entity + its direction + triggers). */
-export interface ConnectorCapability {
-  /** Canonical entity synced, e.g. 'booking', 'movement'. */
-  entity: string
-  direction: SyncDirection
-  triggers: SyncTrigger[]
-}
-
-/** The state of a tenant's connection to a provider (one row in a *_integrations table). */
-export interface ConnectionConfig {
-  /** Provider key, e.g. 'google', 'plugbank'. */
-  provider: string
-  /** Whether the connection is active and should sync. */
-  active: boolean
-  /** Opaque, provider-specific config (calendar id, account id, cursor, …). Never secrets. */
-  settings?: Record<string, unknown>
-  /** Last successful sync, ISO timestamp. */
-  lastSyncAt?: string
-}
-
-/** Audit record of one sync execution (generalizes *_sync_log / *_sync_runs). */
-export interface SyncRun {
-  id?: string
-  provider: string
-  direction: SyncDirection
-  trigger: SyncTrigger
-  status: 'success' | 'partial' | 'error'
-  /** Items pulled/pushed and how many were written. */
-  fetched?: number
-  written?: number
-  /** Pagination/incremental cursor advanced by this run. */
-  cursor?: string
-  error?: string
-  startedAt?: string
-  finishedAt?: string
-}
-
-export interface TestConnectionResult {
-  ok: boolean
-  message?: string
-}
-
-/**
- * A connector's control-plane descriptor. The data-plane verbs (testConnection,
- * sync) are usually thin clients that invoke a Supabase Edge Function — the
- * function holds credentials and does the real work.
- */
-export interface Connector {
-  /** Stable connector id, e.g. 'google-calendar', 'plugbank'. */
-  id: string
-  /** Provider key matching ConnectionConfig.provider. */
-  provider: string
-  /** Plugin this connector extends, e.g. 'agenda', 'financial'. */
-  pluginId: string
-  authKind: IntegrationAuthKind
-  capabilities: ConnectorCapability[]
-  /** Validate the stored credentials/config without syncing. */
-  testConnection?(config: ConnectionConfig): Promise<TestConnectionResult>
-  /** Run a sync for the given direction; returns the audit record. */
-  sync?(input: { config: ConnectionConfig; direction: SyncDirection; trigger: SyncTrigger }): Promise<SyncRun>
-}
-
-// ---------------------------------------------------------------------------
-// Connector UI contract — how an addon plugin EXTENDS a host plugin's settings
-// ---------------------------------------------------------------------------
-// An addon plugin declares one or more ConnectorDefinitions on its manifest
-// (`connectors: [...]`). The runtime groups them by `hostPluginId`, and the host
-// plugin's settings panel renders them in a unified "Integrations" tab — the
-// same connect/credentials experience for every connector. The connector-
-// specific bits (import a statement, sync now, history) live in `ExtraPanel`.
-
-/** A credential input the unified setup form renders for an api-key/mtls connector. */
-export interface ConnectorField {
-  key: string
-  label: string
-  type: 'text' | 'password'
-  placeholder?: string
-}
-
-export interface ConnectorStatus {
-  connected: boolean
-  detail?: string
-  /** Which plane the live connection is running on (when connected). */
-  plane?: ConnectorPlane
-}
-
-/**
- * UI-facing connector descriptor. Built on the data-plane `Connector` concept
- * (`pluginId` → `hostPluginId`), plus the control-plane hooks the unified
- * Integrations hub calls. Lives in core so `PluginManifest.connectors` can type
- * it; the rendering hub lives in `@fayz-ai/saas`.
- */
-export interface ConnectorDefinition {
-  /** Stable connector id, e.g. 'google-calendar', 'plugbank'. */
-  id: string
-  /** The plugin this connector extends, e.g. 'financial', 'agenda'. */
-  hostPluginId: string
-  name: string
-  description?: string
-  /** Lucide icon name. */
-  icon?: string
-  /**
-   * The connector's own brand mark — a URL or an inline data URI. Preferred
-   * over the catalogue's icon and over `icon`, so a connector the Fayz
-   * directory doesn't carry still shows up as itself.
-   */
-  logoUrl?: string
-  authKind: IntegrationAuthKind
-  /** Planes this connector can be honoured on. Default: `['sync']`. */
-  planes?: ConnectorPlane[]
-  /** Default `'outbound'` — this app reaching a provider. */
-  direction?: ConnectorDirection
-  /** What the assistant gains on the agentic plane — shown before connecting. */
-  agentTools?: ConnectorAgentTool[]
-  /** Canonical entities this connector touches ('booking', 'movement'). */
-  entities?: string[]
-  /** Catalog category ('scheduling', 'payments', …) — matches the Fayz catalog. */
-  category?: string
-  /** Provider documentation, linked from the connector's detail. */
-  docsUrl?: string
-  /** Declarative credentials — the unified form renders these (api-key / mtls). */
-  fields?: ConnectorField[]
-  /** Current connection state for the status badge. */
-  getStatus(): Promise<ConnectorStatus>
-  /** Validate credentials without persisting (api-key / mtls). */
-  testConnection?(values: Record<string, string>): Promise<TestConnectionResult>
-  /** Persist the connection (api-key / mtls). */
-  saveConnection?(values: Record<string, string>): Promise<void>
-  /** Begin an OAuth connect flow — returns the consent URL to redirect to. */
-  startOAuth?(redirectTo?: string): Promise<string>
-  /** Tear down the connection. */
-  disconnect?(): Promise<void>
-  /** Move an existing connection between planes (only when `planes` has both). */
-  setPlane?(plane: ConnectorPlane): Promise<void>
-  /** Optional connector-specific UI below the connect panel (import / sync / history). */
-  ExtraPanel?: React.ComponentType
-}
-
-/** Planes a connector supports — the contract's default is the sync pipeline. */
-export function connectorPlanes(def: Pick<ConnectorDefinition, 'planes'>): ConnectorPlane[] {
-  return def.planes?.length ? def.planes : ['sync']
-}
-
-/**
- * The plane to offer first. Agentic wins whenever the connector supports it:
- * handing the assistant a tool costs nothing to keep in agreement, while a sync
- * pipeline is a copy that has to be maintained for as long as it exists.
- */
-export function preferredPlane(def: Pick<ConnectorDefinition, 'planes'>): ConnectorPlane {
-  return connectorPlanes(def).includes('agentic') ? 'agentic' : 'sync'
-}
-
-/** Direction a connector moves data in — outbound unless it says otherwise. */
-export function connectorDirection(def: Pick<ConnectorDefinition, 'direction'>): ConnectorDirection {
-  return def.direction ?? 'outbound'
-}
-
-/**
- * Wrap an object's async methods so a handler fires AFTER selected methods
- * resolve — the non-invasive hook for outbound, event-driven sync when there's
- * no app-level event bus. Example: wrap an AgendaDataProvider so that after
- * createBooking/updateBooking/deleteBooking succeed, an external calendar is
- * updated. The handler runs fire-and-forget; its failures never break the call.
- */
-export function withAfterHooks<T extends object>(
-  target: T,
-  methods: Partial<Record<keyof T, (args: unknown[], result: unknown) => void | Promise<void>>>,
-): T {
-  return new Proxy(target, {
-    get(obj, prop, receiver) {
-      const orig = Reflect.get(obj, prop, receiver)
-      const hook = (methods as Record<string | symbol, ((args: unknown[], result: unknown) => void | Promise<void>) | undefined>)[prop]
-      if (typeof orig !== 'function' || !hook) return orig
-      return (...args: unknown[]) => {
-        const result = (orig as (...a: unknown[]) => unknown).apply(obj, args)
-        if (result instanceof Promise) {
-          return result.then((value) => {
-            try { void Promise.resolve(hook(args, value)).catch(() => {}) } catch { /* never break the call */ }
-            return value
-          })
-        }
-        try { void Promise.resolve(hook(args, result)).catch(() => {}) } catch { /* noop */ }
-        return result
-      }
-    },
-  })
-}

package/src/lib/cache.ts

@@ -1,118 +0,0 @@
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-interface CacheEntry<T = unknown> {
-  data: T
-  expiresAt: number
-  lastAccess: number
-}
-
-export interface CacheStore {
-  get<T>(key: string): T | undefined
-  set<T>(key: string, data: T, ttl?: number): void
-  /** Clear all entries whose key starts with `prefix` */
-  invalidate(prefix: string): void
-  clear(): void
-  size(): number
-}
-
-export interface CacheConfig {
-  /** Default time-to-live in ms (default: 60 000 — 1 minute) */
-  defaultTTL?: number
-  /** Maximum cached entries before LRU eviction (default: 500) */
-  maxEntries?: number
-}
-
-// ---------------------------------------------------------------------------
-// Stable key helper — deterministic JSON for cache keys
-// ---------------------------------------------------------------------------
-
-function sortDeep(value: unknown): unknown {
-  if (value === null || value === undefined || typeof value !== 'object') return value
-  if (Array.isArray(value)) return value.map(sortDeep)
-  const sorted: Record<string, unknown> = {}
-  for (const k of Object.keys(value as Record<string, unknown>).sort()) {
-    sorted[k] = sortDeep((value as Record<string, unknown>)[k])
-  }
-  return sorted
-}
-
-export function stableKey(...parts: unknown[]): string {
-  return parts.map((p) => (typeof p === 'string' ? p : JSON.stringify(sortDeep(p)))).join(':')
-}
-
-// ---------------------------------------------------------------------------
-// CacheStore implementation
-// ---------------------------------------------------------------------------
-
-export function createCacheStore(config?: CacheConfig): CacheStore {
-  const defaultTTL = config?.defaultTTL ?? 60_000
-  const maxEntries = config?.maxEntries ?? 500
-  const entries = new Map<string, CacheEntry>()
-
-  function evictLRU() {
-    if (entries.size <= maxEntries) return
-    // Find the entry with the oldest lastAccess
-    let oldestKey: string | null = null
-    let oldestAccess = Infinity
-    for (const [key, entry] of entries) {
-      if (entry.lastAccess < oldestAccess) {
-        oldestAccess = entry.lastAccess
-        oldestKey = key
-      }
-    }
-    if (oldestKey) entries.delete(oldestKey)
-  }
-
-  return {
-    get<T>(key: string): T | undefined {
-      const entry = entries.get(key)
-      if (!entry) return undefined
-      if (Date.now() > entry.expiresAt) {
-        entries.delete(key)
-        return undefined
-      }
-      entry.lastAccess = Date.now()
-      return entry.data as T
-    },
-
-    set<T>(key: string, data: T, ttl?: number): void {
-      const now = Date.now()
-      entries.set(key, {
-        data,
-        expiresAt: now + (ttl ?? defaultTTL),
-        lastAccess: now,
-      })
-      evictLRU()
-    },
-
-    invalidate(prefix: string): void {
-      for (const key of entries.keys()) {
-        if (key.startsWith(prefix)) {
-          entries.delete(key)
-        }
-      }
-    },
-
-    clear(): void {
-      entries.clear()
-    },
-
-    size(): number {
-      return entries.size
-    },
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Global singleton — auto-flushes on tenant/org switch
-// ---------------------------------------------------------------------------
-
-export const globalCache = createCacheStore()
-
-/** Flush the global cache — called by the tenant accessor when the active
- *  tenant changes (replaces the old org-store subscription). */
-export function clearGlobalCache(): void {
-  globalCache.clear()
-}

package/src/lib/csv.ts

@@ -1,54 +0,0 @@
-/** Column descriptor for generic CSV export */
-export interface CSVColumn {
-  key: string
-  label: string
-  format?: (value: any, row: Record<string, any>) => string
-}
-
-export function escapeCSVField(value: unknown): string {
-  if (value == null) return ''
-  const str = String(value)
-  if (str.includes(',') || str.includes('"') || str.includes('\n')) {
-    return `"${str.replace(/"/g, '""')}"`
-  }
-  return str
-}
-
-/** Build a CSV string from columns + rows. Each cell runs through `column.format` if provided, then escaping. */
-export function buildCSV(
-  columns: CSVColumn[],
-  rows: Record<string, any>[],
-): string {
-  const header = columns.map((c) => escapeCSVField(c.label)).join(',')
-  const body = rows.map((row) =>
-    columns
-      .map((col) => {
-        const raw = row[col.key]
-        const formatted = col.format ? col.format(raw, row) : raw
-        return escapeCSVField(formatted)
-      })
-      .join(','),
-  )
-  return [header, ...body].join('\n')
-}
-
-/** Trigger a CSV file download in the browser. */
-export function downloadCSV(csv: string, filename: string): void {
-  const bom = '\uFEFF'
-  const blob = new Blob([bom + csv], { type: 'text/csv;charset=utf-8;' })
-  const url = URL.createObjectURL(blob)
-  const a = document.createElement('a')
-  a.href = url
-  a.download = filename.endsWith('.csv') ? filename : `${filename}.csv`
-  a.click()
-  URL.revokeObjectURL(url)
-}
-
-/** Convenience: build + download in one call. */
-export function exportCSV(
-  columns: CSVColumn[],
-  rows: Record<string, any>[],
-  filename: string,
-): void {
-  downloadCSV(buildCSV(columns, rows), filename)
-}

package/src/lib/format.ts

@@ -1,58 +0,0 @@
-import { getCurrentLocale } from '../i18n'
-
-// Currency inferred from the active locale unless the app sets one explicitly
-// via createSaasApp({ locale: { currency: 'BRL' } }).
-const CURRENCY_BY_LOCALE: Record<string, string> = {
-  'pt-BR': 'BRL',
-  'pt-PT': 'EUR',
-  en: 'USD',
-  'en-US': 'USD',
-  'en-GB': 'GBP',
-  es: 'EUR',
-}
-
-let _defaultCurrency: string | null = null
-
-export function setDefaultCurrency(code: string | undefined): void {
-  _defaultCurrency = code ?? null
-}
-
-export function getActiveLocale(): string {
-  try {
-    return getCurrentLocale() || 'en'
-  } catch {
-    return 'en'
-  }
-}
-
-export function getDefaultCurrency(): string {
-  if (_defaultCurrency) return _defaultCurrency
-  return CURRENCY_BY_LOCALE[getActiveLocale()] ?? 'USD'
-}
-
-export function formatCurrency(value: unknown, currency?: string): string {
-  const num = typeof value === 'number' ? value : parseFloat(String(value))
-  if (isNaN(num)) return String(value ?? '')
-  return new Intl.NumberFormat(getActiveLocale(), {
-    style: 'currency',
-    currency: currency ?? getDefaultCurrency(),
-  }).format(num)
-}
-
-export function formatDate(value: unknown): string {
-  if (!value) return ''
-  try {
-    return new Intl.DateTimeFormat(getActiveLocale(), { dateStyle: 'medium' }).format(new Date(value as string))
-  } catch {
-    return String(value)
-  }
-}
-
-export function formatDateTime(value: unknown): string {
-  if (!value) return ''
-  try {
-    return new Intl.DateTimeFormat(getActiveLocale(), { dateStyle: 'medium', timeStyle: 'short' }).format(new Date(value as string))
-  } catch {
-    return String(value)
-  }
-}