@fayz-ai/core 0.7.0 → 0.7.1

package/dist/seo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACxC;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AA8BD,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAO9C;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWjF;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzG"}

package/dist/types/payment.d.ts

@@ -0,0 +1,38 @@
+export type PaymentMethod = 'pix' | (string & {});
+export type ChargeStatus = 'pending' | 'paid' | 'expired' | 'failed';
+export interface CreateChargeInput {
+    /** Amount in the currency's major unit (e.g. 220.00 = R$ 220,00). */
+    amount: number;
+    /** ISO 4217 currency code, e.g. 'BRL'. */
+    currency: string;
+    method: PaymentMethod;
+    /** Human-readable description (statement/receipt). */
+    description?: string;
+    /** The booking/order this charge settles, for reconciliation. */
+    orderId?: string;
+    /** Payer contact, when known (name/email/phone). */
+    customer?: {
+        name?: string;
+        email?: string;
+        phone?: string;
+    };
+}
+export interface PixCharge {
+    chargeId: string;
+    status: ChargeStatus;
+    amount: number;
+    currency: string;
+    /** QR image payload. For Pix this is the BR Code string encoded into the QR. */
+    pixQrCode: string;
+    /** "Copia e cola" — the raw Pix BR Code the payer pastes into their bank app. */
+    pixCopyPaste: string;
+    /** ISO datetime the charge/QR expires. */
+    expiresAt: string;
+}
+export interface PaymentProvider {
+    /** Create a charge and return its payable artifacts (Pix QR + copia-e-cola). */
+    createCharge(input: CreateChargeInput): Promise<PixCharge>;
+    /** Current status of a charge (polled by the UI, or driven by a webhook later). */
+    getChargeStatus(chargeId: string): Promise<ChargeStatus>;
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/types/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/types/payment.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEpE,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,aAAa,CAAA;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7D;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1D,mFAAmF;IACnF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fayz-ai/core",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Fayz SDK core — data providers, entity system, plugin runtime, i18n, routing",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -79,7 +79,7 @@
   "dependencies": {
     "@supabase/supabase-js": "^2.45.0",
     "zustand": "^4.5.0",
-    "@fayz-ai/sdk": "^0.6.5"
+    "@fayz-ai/sdk": "^0.6.7"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/src/index.ts

@@ -18,6 +18,17 @@ export { createArchetypeProvider } from './data/archetype'
 export { withCache } from './data/cached'
 export { resolveDataProvider } from './data/resolve'
 export { createSafeDataProvider } from './plugin/createSafeDataProvider'
+export {
+  COUNTRIES, DEFAULT_COUNTRY, getCountry, unmaskPhone, maskPhone, maskDigitCount,
+} from './phone'
+export type { CountryDef } from './phone'
+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)

package/src/phone/index.ts

@@ -0,0 +1,85 @@
+// ---------------------------------------------------------------------------
+// Reusable phone / country helpers (SDK-level — shared by any plugin that
+// collects a phone number: booking, CRM, forms, auth…). Provides the country
+// list (flag + dial code + national mask) and mask/unmask utilities.
+// ---------------------------------------------------------------------------
+
+export interface CountryDef {
+  /** ISO 3166-1 alpha-2 code, e.g. 'BR'. */
+  iso2: string
+  /** Localized-ish display name. */
+  name: string
+  /** International dial code including '+', e.g. '+55'. */
+  dial: string
+  /** Flag emoji (derived from iso2). */
+  flag: string
+  /** National number mask; '#' = one digit. e.g. '(##) #####-####'. */
+  mask: string
+}
+
+/** Derive a flag emoji from an ISO2 code via regional indicator symbols. */
+function flagOf(iso2: string): string {
+  return iso2
+    .toUpperCase()
+    .replace(/[^A-Z]/g, '')
+    .split('')
+    .map((c) => String.fromCodePoint(0x1f1e6 + c.charCodeAt(0) - 65))
+    .join('')
+}
+
+const RAW: Omit<CountryDef, 'flag'>[] = [
+  { iso2: 'BR', name: 'Brasil', dial: '+55', mask: '(##) #####-####' },
+  { iso2: 'US', name: 'Estados Unidos', dial: '+1', mask: '(###) ###-####' },
+  { iso2: 'PT', name: 'Portugal', dial: '+351', mask: '### ### ###' },
+  { iso2: 'AR', name: 'Argentina', dial: '+54', mask: '(##) ####-####' },
+  { iso2: 'ES', name: 'Espanha', dial: '+34', mask: '### ### ###' },
+  { iso2: 'MX', name: 'México', dial: '+52', mask: '## #### ####' },
+  { iso2: 'GB', name: 'Reino Unido', dial: '+44', mask: '##### ######' },
+  { iso2: 'FR', name: 'França', dial: '+33', mask: '# ## ## ## ##' },
+  { iso2: 'DE', name: 'Alemanha', dial: '+49', mask: '#### #######' },
+  { iso2: 'IT', name: 'Itália', dial: '+39', mask: '### #######' },
+]
+
+export const COUNTRIES: CountryDef[] = RAW.map((c) => ({ ...c, flag: flagOf(c.iso2) }))
+
+export const DEFAULT_COUNTRY = 'BR'
+
+const BY_ISO = new Map(COUNTRIES.map((c) => [c.iso2, c]))
+
+/** Look up a country by ISO2 (falls back to the default). */
+export function getCountry(iso2: string | undefined): CountryDef {
+  return (iso2 && BY_ISO.get(iso2.toUpperCase())) || BY_ISO.get(DEFAULT_COUNTRY)!
+}
+
+/** Keep only digit characters. */
+export function unmaskPhone(value: string): string {
+  return (value || '').replace(/\D/g, '')
+}
+
+/**
+ * Apply a '#'-placeholder mask to a raw string, consuming its digits. Extra
+ * digits beyond the mask are dropped; partial input masks progressively.
+ *
+ *   maskPhone('11987654321', '(##) #####-####') -> '(11) 98765-4321'
+ */
+export function maskPhone(value: string, mask: string): string {
+  const digits = unmaskPhone(value)
+  let out = ''
+  let di = 0
+  for (const ch of mask) {
+    if (di >= digits.length) break
+    if (ch === '#') {
+      out += digits[di++]
+    } else {
+      out += ch
+    }
+  }
+  return out
+}
+
+/** Count how many digits a mask expects. */
+export function maskDigitCount(mask: string): number {
+  let n = 0
+  for (const ch of mask) if (ch === '#') n++
+  return n
+}

package/src/seo/index.ts

@@ -0,0 +1,128 @@
+import { useEffect } from 'react'
+
+// ---------------------------------------------------------------------------
+// Generic, domain-agnostic SEO / structured-data head manager (SDK-level).
+// ANY surface (blog, booking, reviews, product, landing) uses `useSeo` to set
+// <title>, meta description, canonical, OpenGraph/Twitter cards and JSON-LD per
+// route. Domain plugins build their own schema.org objects (BlogPosting,
+// Product, Event…) and pass them via `jsonLd` — the mechanics live here once.
+//
+// NOTE: a SPA still benefits from SSR/prerendering for the strongest SEO — that
+// is the real upgrade; this covers everything achievable client-side.
+// ---------------------------------------------------------------------------
+
+const MANAGED = 'data-fayz-seo'
+
+export interface SeoConfig {
+  title: string
+  description?: string
+  canonical?: string
+  image?: string
+  type?: 'website' | 'article' | (string & {})
+  siteName?: string
+  /** One or more JSON-LD objects injected as <script type="application/ld+json">. */
+  jsonLd?: Array<Record<string, unknown>>
+}
+
+/** Current page origin (empty during SSR). */
+export function seoOrigin(): string {
+  return typeof window !== 'undefined' ? window.location.origin : ''
+}
+
+/** Build an absolute URL from a path, using the current origin. */
+export function absoluteUrl(path: string): string {
+  return `${seoOrigin()}${path.startsWith('/') ? path : `/${path}`}`
+}
+
+function upsertMeta(attr: 'name' | 'property', key: string, content: string) {
+  if (!content) return
+  let el = document.head.querySelector<HTMLMetaElement>(`meta[${attr}="${key}"]`)
+  if (!el) {
+    el = document.createElement('meta')
+    el.setAttribute(attr, key)
+    el.setAttribute(MANAGED, '')
+    document.head.appendChild(el)
+  }
+  el.setAttribute('content', content)
+}
+
+function upsertLink(rel: string, href: string) {
+  if (!href) return
+  let el = document.head.querySelector<HTMLLinkElement>(`link[rel="${rel}"]`)
+  if (!el) {
+    el = document.createElement('link')
+    el.setAttribute('rel', rel)
+    el.setAttribute(MANAGED, '')
+    document.head.appendChild(el)
+  }
+  el.setAttribute('href', href)
+}
+
+function clearManaged() {
+  document.head.querySelectorAll(`[${MANAGED}]`).forEach((el) => el.remove())
+}
+
+/** Imperatively apply SEO tags (used by useSeo; exported for non-React callers). */
+export function applySeo(config: SeoConfig): void {
+  if (typeof document === 'undefined') return
+  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 ?? []) {
+    const script = document.createElement('script')
+    script.type = 'application/ld+json'
+    script.setAttribute(MANAGED, '')
+    script.text = JSON.stringify(obj)
+    document.head.appendChild(script)
+  }
+}
+
+/** Apply SEO head tags for the current route; cleans up on unmount. */
+export function useSeo(config: SeoConfig): void {
+  const key = JSON.stringify(config)
+  useEffect(() => {
+    applySeo(config)
+    return () => clearManaged()
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [key])
+}
+
+// --- Generic schema.org builders (reusable across plugins) -----------------
+
+export interface BreadcrumbItem {
+  name: string
+  url: string
+}
+
+/** schema.org BreadcrumbList from an ordered list of crumbs. */
+export function breadcrumbJsonLd(items: BreadcrumbItem[]): Record<string, unknown> {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BreadcrumbList',
+    itemListElement: items.map((c, i) => ({
+      '@type': 'ListItem',
+      position: i + 1,
+      name: c.name,
+      item: c.url,
+    })),
+  }
+}
+
+/** schema.org Organization publisher block. */
+export function organizationJsonLd(name: string, extra?: Record<string, unknown>): Record<string, unknown> {
+  return { '@type': 'Organization', name, ...extra }
+}

package/src/types/payment.ts

@@ -0,0 +1,44 @@
+// ---------------------------------------------------------------------------
+// Payment provider contract (SDK-level, gateway-agnostic). A booking/checkout
+// flow declares "collect X" and calls createCharge; the concrete provider (mock
+// Pix now, MercadoPago/Stripe later) decides HOW. Kept in core so any plugin can
+// depend on the interface without depending on a payments plugin.
+// ---------------------------------------------------------------------------
+
+export type PaymentMethod = 'pix' | (string & {})
+
+export type ChargeStatus = 'pending' | 'paid' | 'expired' | 'failed'
+
+export interface CreateChargeInput {
+  /** Amount in the currency's major unit (e.g. 220.00 = R$ 220,00). */
+  amount: number
+  /** ISO 4217 currency code, e.g. 'BRL'. */
+  currency: string
+  method: PaymentMethod
+  /** Human-readable description (statement/receipt). */
+  description?: string
+  /** The booking/order this charge settles, for reconciliation. */
+  orderId?: string
+  /** Payer contact, when known (name/email/phone). */
+  customer?: { name?: string; email?: string; phone?: string }
+}
+
+export interface PixCharge {
+  chargeId: string
+  status: ChargeStatus
+  amount: number
+  currency: string
+  /** QR image payload. For Pix this is the BR Code string encoded into the QR. */
+  pixQrCode: string
+  /** "Copia e cola" — the raw Pix BR Code the payer pastes into their bank app. */
+  pixCopyPaste: string
+  /** ISO datetime the charge/QR expires. */
+  expiresAt: string
+}
+
+export interface PaymentProvider {
+  /** Create a charge and return its payable artifacts (Pix QR + copia-e-cola). */
+  createCharge(input: CreateChargeInput): Promise<PixCharge>
+  /** Current status of a charge (polled by the UI, or driven by a webhook later). */
+  getChargeStatus(chargeId: string): Promise<ChargeStatus>
+}