@fayz-ai/admin 0.10.0

package/dist/app/admin-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-app.d.ts","sourceRoot":"","sources":["../../src/app/admin-app.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAU9B,OAAO,EAGL,KAAK,UAAU,EAGf,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAA;AAyB7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAyC7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC3B,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IACpC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC,OAAO,eAAe,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,CAAA;CAC1E,CA0BA;AAqMD,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAyGxG;yBAzGe,cAAc;;;AAqH9B,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,KAAK,CAAC,aAAa,CA6BxE"}

package/dist/app/config.d.ts

@@ -0,0 +1,277 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { AuthProvider, OrgAdapter, PluginManifest, ThemeMode, LocaleConfig, PermissionsConfig, LimitDeclaration, AgentDomainKnowledge, AgentRpcDeclaration, EntityDef } from '@fayz-ai/core';
+import type { AuthPluginOptions, ResolvedAuthPlugin, LoginAmbassador } from '@fayz-ai/plugin-auth';
+import type { BottomNavItem, MobileHeaderVariant } from '@fayz-ai/ui';
+import type { SaasTheme } from '../theme/tokens';
+import type { CreateThemeOptions } from '../theme/utils';
+import type { PlanConfig } from '../types/billing';
+import type { FayzAgentConnectionConfig } from '../lib/fayz-agent';
+export type PageSection = 'main' | 'secondary' | 'settings';
+export interface CustomPage {
+    /** Route path, e.g. '/reports' */
+    path: string;
+    /** Display label in navigation */
+    label?: string;
+    /** Lucide icon name or any string identifier */
+    icon?: string;
+    component?: ComponentType;
+    section?: PageSection;
+    position?: number;
+    badge?: string | number;
+    /** Sales-channel / external link. When set, this entry opens the URL in a new
+     *  tab instead of routing to `component`; no internal route is registered. */
+    href?: string;
+    permission?: {
+        feature: string;
+        action: 'read' | 'create' | 'edit' | 'delete';
+    };
+    /** Show this page in the sidebar/topbar navigation. Default: true. Set `false`
+     *  for mobile-only pages reachable via bottomNav/avatar (e.g. a "Mais" overflow
+     *  hub or a "Perfil" avatar target): the route still works, but the entry is
+     *  hidden from desktop navigation where those mobile constructs are meaningless. */
+    nav?: boolean;
+    children?: CustomPage[];
+}
+/** A statically-declared fayz site for an app (see FayzAppConfig.site). Used as
+ *  the "Seu site" widget's fallback when the tenant has no DB project. */
+export interface AppSiteConfig {
+    name: string;
+    /**
+     * Heading above the widget in the sidebar footer. Defaults to "Seu site" —
+     * override it when the app's word for the thing isn't "site" ("Sua loja" for
+     * a store admin, "Seu portal", …).
+     */
+    label?: string;
+    /** Live/preview site URL (the "Abrir" action). */
+    previewUrl?: string;
+    /** Explicit editor URL; otherwise derived from fayzProjectId (fayz.ai/editor/{id}). */
+    editorUrl?: string;
+    /** Platform project id — used to derive the editor URL. */
+    fayzProjectId?: string;
+    kind?: 'site' | 'storefront' | 'landing_page' | 'other';
+    /**
+     * In-app route the "Editar" action navigates to INSTEAD of opening the
+     * external fayz editor. For apps that own their storefront screen (theme,
+     * channels, domain) inside the admin: sending a merchant out to a separate
+     * editor to change their own store is a context switch they didn't ask for.
+     * Takes precedence over `editorUrl` / `fayzProjectId`.
+     */
+    editRoute?: string;
+}
+export interface AuthConfig {
+    /** 'supabase' | 'mock' or bring your own AuthAdapter */
+    adapter?: AuthPluginOptions['adapter'];
+    /** New plugin-auth provider selector. Existing apps may keep using adapter. */
+    provider?: AuthPluginOptions['provider'];
+    /** Redirect to login when no session is found (default: true) */
+    requireAuth?: boolean;
+    /** New plugin-auth route and provider options. */
+    routes?: AuthPluginOptions['routes'];
+    supabase?: AuthPluginOptions['supabase'];
+    oauth?: AuthPluginOptions['oauth'];
+    layout?: AuthPluginOptions['layout'];
+    logo?: ReactNode;
+    tagline?: string;
+    description?: string;
+    loginLogo?: ReactNode;
+    loginLayout?: 'split' | 'centered';
+    loginTagline?: string;
+    loginDescription?: string;
+    /** Product ambassadors shown as a small social-proof avatar strip above the
+     *  tagline on the split-login brand panel. Each needs a local `image` path;
+     *  degrades to nothing when omitted. */
+    loginAmbassadors?: LoginAmbassador[];
+    /** Optional microtext beside the ambassador strip, e.g. "+2 mil profissionais". */
+    loginAmbassadorsLabel?: string;
+    showOAuth?: boolean;
+    oauthProviders?: Exclude<AuthProvider, 'email'>[];
+}
+export type AppAuthConfig = AuthConfig | ResolvedAuthPlugin;
+export interface OrgConfig {
+    /** 'supabase' | 'mock' or bring your own OrgAdapter */
+    adapter?: 'supabase' | 'mock' | OrgAdapter;
+    /** Support multiple orgs per user (default: true) */
+    multiOrg?: boolean;
+    /** Auto-create an org when the user has none (default: true) */
+    autoCreate?: boolean;
+    /**
+     * How long the org bootstrap (org + memberships + members + roles) is served
+     * from cache before the provider goes back to the network. Default 5 min;
+     * `0` fetches on every load.
+     */
+    cacheTtlMs?: number;
+}
+export interface TeamConfig {
+    /**
+     * Which person `kind`s make up the "team" (shown on /settings/team).
+     * Person-first model: the Team screen is driven by people of these kinds;
+     * `tenant_members` (login + role) is an optional access overlay per person.
+     * e.g. beauty-saas: ['staff'] · school-saas: ['teacher', 'staff'].
+     * When empty/undefined, the Team screen falls back to membership-only (legacy).
+     */
+    personKinds?: string[];
+}
+export interface ChatConfig {
+    enabled?: boolean;
+    title?: string;
+    /** `'dock'` (default) mounts the assistant in the shell's right rail.
+     *  `'none'` mounts no surface — the engine stays available to the app. */
+    surface?: 'dock' | 'none';
+    /** Extra guidance appended to the agent's own instructions. */
+    systemPrompt?: string;
+    /**
+     * Bring-your-own chat backend. Leave unset to use the Fayz agent configured
+     * for this project — the container injects the connection env, so no key or
+     * URL needs to live in app config.
+     */
+    apiEndpoint?: string;
+    /**
+     * Overrides for the Fayz agent connection, for apps built outside a Fayz
+     * container. `false` opts out of the Fayz agent entirely.
+     */
+    agent?: FayzAgentConnectionConfig | false;
+    /** Speaking and listening. Sensible defaults; no config needed to get a mic. */
+    voice?: ChatVoiceConfig;
+    /**
+     * "Continuar no WhatsApp" — a discreet hand-off under the composer that
+     * opens wa.me with a prefilled message. Set the business number (digits,
+     * with country code) to enable; omit to hide.
+     */
+    whatsapp?: {
+        number: string;
+        message?: string;
+    };
+}
+export interface ChatVoiceConfig {
+    /** `false` hides the microphone entirely. */
+    input?: boolean;
+    /** Recognition language (BCP-47). Defaults to the browser's. */
+    locale?: string;
+    /**
+     * Endpoint that takes an audio clip (multipart `file`) and answers
+     * `{ text }`. This is the seam for Whisper or any other STT service — set it
+     * and the mic stops using the browser's recognizer. Left unset (the default)
+     * the assistant listens with the browser's own engine: no key, no backend.
+     */
+    transcribeEndpoint?: string;
+    /** Send the transcript without review. Default false — dictation fills the
+     *  composer and the user presses send. */
+    autoSend?: boolean;
+    /** Offer the spoken-replies toggle (default `true`). */
+    replies?: boolean;
+    /** Start with spoken replies ON. Off by default — a back-office app that
+     *  starts talking on its own is a support ticket, not a feature. */
+    repliesDefaultOn?: boolean;
+}
+export interface FayzBillingConfig {
+    plans: PlanConfig[];
+    stripePublishableKey?: string;
+    portalUrl?: string;
+    /**
+     * Payment-gateway seam. When defined, the shell's Subscription page calls this
+     * with the target plan id INSTEAD of writing `plan` straight onto the org — this
+     * is where Stripe Checkout / Pix / Mercado Pago plug in (create the intent,
+     * redirect, let the webhook persist the plan). Left undefined, changing plan is
+     * an optimistic `adapter.updateOrg(orgId, { plan })`.
+     */
+    onCheckout?: (planId: string) => Promise<void> | void;
+    /**
+     * App-level limit declarations layered on top of the plugins' `declaredLimits`
+     * (app wins on key collision). Use to add limits for app-local tables the
+     * plugins don't know about, or to re-point a key at a different table.
+     */
+    limitDeclarations?: LimitDeclaration[];
+}
+export interface FayzAppConfig {
+    /** Application display name */
+    name: string;
+    logo?: string | ReactNode;
+    /**
+     * Icon-only mark, for square contexts (the connect/consent badge).
+     *
+     * `logo` is usually a wordmark, and a wordmark in a 48px square is cropped or
+     * illegible. Apps that have a standalone icon should pass it here; without
+     * it, those contexts fall back to the app's initial.
+     */
+    markLogo?: ReactNode;
+    supabaseUrl?: string;
+    supabaseAnonKey?: string;
+    auth?: AppAuthConfig;
+    org?: OrgConfig;
+    team?: TeamConfig;
+    plugins?: PluginManifest[];
+    pages?: CustomPage[];
+    /** Components mounted once inside the authenticated shell, rendering nothing
+     *  visible. Escape hatch for app-level behavior that must run while the shell
+     *  is open — e.g. contributing runtime nav entries via `useNavContribution`
+     *  (sales channels and other per-tenant, data-driven menu items the static
+     *  plugin/pages config cannot express). Keeps such wiring out of the SDK: the
+     *  shell just mounts them and resolves whatever they contribute. */
+    shellMounts?: ComponentType[];
+    /** Extra content rendered in the sidebar bottom region, directly above the
+     *  user row (below the built-in "Seu site" project widget). Use for app-level
+     *  footer affordances. */
+    sidebarFooter?: ReactNode;
+    /**
+     * Render nav-group children as bare labels with an elbow (↳) marking the
+     * active one, instead of an icon per child. An icon on every child makes a
+     * group read as a second flat menu; the elbow says "you are inside this one"
+     * with one mark. Off by default — it restyles every existing rail.
+     */
+    navChildConnector?: boolean;
+    /** The app's own fayz site, shown by the "Seu site" widget when the tenant has
+     *  no per-tenant project in the DB (mock/standalone apps with no supabase pool
+     *  to seed). Ignored once real fayz_projects rows exist for the tenant. */
+    site?: AppSiteConfig;
+    theme?: CreateThemeOptions | SaasTheme;
+    defaultThemeMode?: ThemeMode;
+    /** Shell layout variant (default: 'sidebar') */
+    layout?: 'sidebar' | 'topbar' | 'minimal';
+    /** Mobile bottom tab bar. Rendered by AppShell on small screens (md:hidden)
+     *  for every layout variant. Route items map a lucide icon name to a route; an
+     *  `{ kind: 'action', id, icon }` item renders as a raised center button
+     *  (Mobills style) that fires `onBottomNavAction(id)` instead of navigating. */
+    bottomNav?: BottomNavItem[];
+    /** Fired when a bottom-nav `action` item (e.g. the center "+") is tapped. */
+    onBottomNavAction?: (id: string) => void;
+    /** Mobile header treatment (<md), default 'minimal'. 'transparent' renders no
+     *  header bar (edge-to-edge content) with a floating profile avatar top-right;
+     *  'hidden' renders neither. Desktop keeps its sidebar + user menu. */
+    mobileHeader?: MobileHeaderVariant;
+    /** Wrap the main content in an inset "framed" card (default: true). The
+     *  sidebar itself is always flush/full-height. */
+    contentFrame?: boolean;
+    /** How module-internal navigation renders. Defaults to 'tabs' for the
+     *  'sidebar' layout and 'rail' for 'topbar'. 'sidebar' renders no sub-nav in
+     *  the page — the shell's sidebar carries the module's views as children. */
+    moduleNav?: 'rail' | 'tabs' | 'sidebar';
+    /** Page navigation animation applied to all nested navigations (route + module
+     *  view changes). Default: 'slide'. Set per repo/app for a different feel. */
+    navTransition?: 'slide' | 'fade' | 'none';
+    locale?: LocaleConfig;
+    /** Show org-level settings tabs (Equipe/Permissões/Localizações/Regras).
+     *  Defaults to `Boolean(org)` for back-compat. B2C/personal apps that still
+     *  need an org for the workspace can set `false` to hide these ERP tabs. */
+    orgSettings?: boolean;
+    /** Show the branding ("Identidade Visual") + company "Geral" settings tabs.
+     *  Default: `true`. B2C apps set `false` to drop org-identity settings, leaving
+     *  Perfil + Segurança + plugin settings only. */
+    branding?: boolean;
+    permissions?: PermissionsConfig;
+    billing?: FayzBillingConfig;
+    chat?: ChatConfig;
+    agentContract?: {
+        /** 'server' flips data tools to broker-side execution for this app. */
+        executionPlane?: 'client' | 'server';
+        knowledge?: AgentDomainKnowledge;
+        /** RPCs the app itself ships (vertical-specific, e.g. pricing quote). */
+        rpcs?: AgentRpcDeclaration[];
+        /** App-level read-models for the agent's data primitives (same contract
+         *  as PluginManifest.queryEntities — stable ASCII keys). */
+        queryEntities?: Array<{
+            key: string;
+            entity: EntityDef;
+        }>;
+    };
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/app/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/app/config.ts"],"names":[],"mappings":"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"}

package/dist/app/core-entities.d.ts

@@ -0,0 +1,25 @@
+import type { EntityDef } from '@fayz-ai/core';
+export interface CoreQueryEntity {
+    key: string;
+    entity: EntityDef;
+    writable?: boolean;
+    /**
+     * How this entity attaches to another record — appended to the descriptions
+     * of the data primitives that can act on it. These entities do NOT stand
+     * alone, and nothing in a flat enum of ~37 keys conveys that.
+     *
+     * Both directions matter, and each fails differently without it. On WRITE the
+     * model reaches for `updateRecord` on the parent, is told the fields do not
+     * exist, and then gives up or buries the data in a free-text column. On READ
+     * it searches the parent, finds no address on it, and confidently answers
+     * "this contact has no address registered" — a falsehood, since the row is
+     * one filtered query away.
+     *
+     * Stated here rather than inferred at failure time on purpose: guessing the
+     * intended entity from rejected FIELD NAMES points "add an address to this
+     * contact" at the business-locations table, which declares the same columns.
+     */
+    agentHint?: string;
+}
+export declare const CORE_QUERY_ENTITIES: CoreQueryEntity[];
+//# sourceMappingURL=core-entities.d.ts.map

package/dist/app/core-entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-entities.d.ts","sourceRoot":"","sources":["../../src/app/core-entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA4E9C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,mBAAmB,EAAE,eAAe,EAUhD,CAAA"}

package/dist/app/derive-contract.d.ts

@@ -0,0 +1,8 @@
+import type { AgentContract, LimitDeclaration, RegisteredEntity } from '@fayz-ai/core';
+import type { FayzAppConfig } from './config';
+export interface DerivedAgentSections {
+    agent: AgentContract;
+    limitDeclarations: LimitDeclaration[];
+}
+export declare function deriveAgentContract(config: FayzAppConfig, entities?: RegisteredEntity[]): DerivedAgentSections;
+//# sourceMappingURL=derive-contract.d.ts.map

package/dist/app/derive-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-contract.d.ts","sourceRoot":"","sources":["../../src/app/derive-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAKb,gBAAgB,EAGhB,gBAAgB,EACjB,MAAM,eAAe,CAAA;AAMtB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAkF7C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAA;IACpB,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;CACtC;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,gBAAgB,EAAqB,GAC9C,oBAAoB,CA2GtB"}

package/dist/app/nav-contributions.store.d.ts

@@ -0,0 +1,17 @@
+import type { PluginNavigationEntry } from '@fayz-ai/core';
+interface NavContributionsState {
+    contributions: Record<string, PluginNavigationEntry[]>;
+    setContribution: (id: string, entries: PluginNavigationEntry[]) => void;
+    clearContribution: (id: string) => void;
+}
+export declare const useNavContributionsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<NavContributionsState>>;
+/**
+ * Contribute runtime nav entries under a stable `id`. Reactive: whenever
+ * `entries` changes the shell rebuilds the sidebar. Entries participate in the
+ * same route-prefix nesting as plugin/page nav — so children whose route is a
+ * sub-path of an existing entry (e.g. `/channels/…` under a static `/channels`)
+ * nest under it automatically. Contribution is cleared on unmount.
+ */
+export declare function useNavContribution(id: string, entries: PluginNavigationEntry[]): void;
+export {};
+//# sourceMappingURL=nav-contributions.store.d.ts.map

package/dist/app/nav-contributions.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-contributions.store.d.ts","sourceRoot":"","sources":["../../src/app/nav-contributions.store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAiB1D,UAAU,qBAAqB;IAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAA;IACtD,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,IAAI,CAAA;IACvE,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC;AAED,eAAO,MAAM,wBAAwB,oFAWlC,CAAA;AAEH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAWrF"}

package/dist/app/routing.d.ts

@@ -0,0 +1,10 @@
+export declare function normalizeAdminPath(path: string): string;
+export declare function navigateTo(to: string): void;
+export declare function useAdminPath(): string;
+/** Match '/courses/:id' against '/courses/abc' → { id: 'abc' }; supports a
+ *  trailing '/*' wildcard (matches the base and any deeper path). */
+export declare function matchRoute(pattern: string, path: string): Record<string, string> | null;
+/** Score a route pattern for specificity so the most specific match wins
+ *  (static segments beat params; longer beats shorter; wildcard loses). */
+export declare function routeScore(pattern: string): number;
+//# sourceMappingURL=routing.d.ts.map

package/dist/app/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/app/routing.tsx"],"names":[],"mappings":"AAYA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED;qEACqE;AACrE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAkBvF;AAED;2EAC2E;AAC3E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/app/scaffold.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import type { AppManifest } from '@fayz-ai/core';
+import type { FayzAppConfig } from './config';
+/** Fayz/Saas config → AppManifest (sugar → data). During the Beauty/Resto
+ * migration, config-authored apps keep a live config ref so renderApp can
+ * preserve code-backed plugins and custom pages while the JSON manifest path
+ * matures. Serialized manifests still resolve through plugin/page registries. */
+export declare function defineSaas(config: FayzAppConfig): AppManifest;
+export declare function AdminScaffold({ manifest, surface }: {
+    manifest: AppManifest;
+    surface: string;
+}): React.JSX.Element;
+export declare namespace AdminScaffold {
+    var displayName: string;
+}
+export declare function registerAdminScaffold(): void;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/app/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/app/scaffold.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAO9B,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,eAAe,CAAA;AAItB,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,UAAU,CAAA;AA2BzD;;;iFAGiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CA6B7D;AA6DD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,qBAkC9F;yBAlCe,aAAa;;;AAwC7B,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}

package/dist/billing/index.d.ts

@@ -0,0 +1,5 @@
+export { useBillingStore } from './store';
+export type { BillingStore, BillingState, Subscription, Invoice, } from './store';
+export { resolvePlanBadge } from './plan-badge';
+export type { PlanBadgeInfo } from './plan-badge';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/billing/index.js

@@ -0,0 +1,3 @@
+export { resolvePlanBadge, useBillingStore } from '../chunk-VN5NTK26.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/billing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/billing/plan-badge.d.ts

@@ -0,0 +1,17 @@
+import type { Plan } from '@fayz-ai/core';
+export interface PlanBadgeInfo {
+    /** Display label, e.g. 'Free' or 'Pro'. */
+    label: string;
+    /** Resolved plan id (falls back to the raw org.plan string). */
+    planId: string;
+    /** Paid plan (price > 0) — drives the Crown icon + gold styling in the menus. */
+    paid: boolean;
+}
+/**
+ * Resolve an org's `plan` string against the configured billing plans into the
+ * badge shown next to the user in both menus. Falls back to a capitalized
+ * version of the raw string when the id isn't in config (defensive — e.g. a
+ * legacy 'free' tenant before billing was wired).
+ */
+export declare function resolvePlanBadge(planId: string | undefined | null, plans: Plan[]): PlanBadgeInfo;
+//# sourceMappingURL=plan-badge.d.ts.map

package/dist/billing/plan-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-badge.d.ts","sourceRoot":"","sources":["../../src/billing/plan-badge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEzC,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,IAAI,EAAE,OAAO,CAAA;CACd;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACjC,KAAK,EAAE,IAAI,EAAE,GACZ,aAAa,CAOf"}

package/dist/billing/store.d.ts

@@ -0,0 +1,40 @@
+import type { Plan, BillingCheckoutFn } from '@fayz-ai/core';
+export interface Subscription {
+    id: string;
+    orgId: string;
+    planId: string;
+    status: 'active' | 'trialing' | 'past_due' | 'canceled' | 'incomplete';
+    currentPeriodStart: string;
+    currentPeriodEnd: string;
+    cancelAtPeriodEnd?: boolean;
+    stripeSubscriptionId?: string;
+}
+export interface Invoice {
+    id: string;
+    orgId: string;
+    amount: number;
+    currency: string;
+    status: 'paid' | 'open' | 'void' | 'uncollectible';
+    pdfUrl?: string;
+    createdAt: string;
+}
+export interface BillingState {
+    subscription: Subscription | null;
+    invoices: Invoice[];
+    plans: Plan[];
+    loading: boolean;
+    /** Payment-gateway seam seeded from `config.billing.onCheckout` (see core
+     *  BillingConfig). When set, the Subscription page routes plan changes through
+     *  it instead of writing `plan` straight onto the org. */
+    checkout: BillingCheckoutFn | null;
+}
+export interface BillingStore extends BillingState {
+    setSubscription: (subscription: Subscription | null) => void;
+    setInvoices: (invoices: Invoice[]) => void;
+    setPlans: (plans: Plan[]) => void;
+    setLoading: (loading: boolean) => void;
+    setCheckout: (checkout: BillingCheckoutFn | null) => void;
+    reset: () => void;
+}
+export declare const useBillingStore: import("zustand").UseBoundStore<import("zustand").StoreApi<BillingStore>>;
+//# sourceMappingURL=store.d.ts.map

package/dist/billing/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/billing/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAM5D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAA;IACtE,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAA;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB;;8DAE0D;IAC1D,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACnC;AAMD,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5D,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;IACjC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,WAAW,EAAE,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAA;IACzD,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAUD,eAAO,MAAM,eAAe,2EAQzB,CAAA"}