@llmnative/react 1.0.0 → 1.1.0

package/dist/types/src/components/ui/fields/Upload.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { FormFieldProps } from "../../widgets/Form";
+import type { StorageProviderAdapter } from "../../../providers/storage/StorageProvider";
 export interface FileProps {
     key: string;
     fileName: string;
@@ -28,8 +29,16 @@ export interface UseFileUploadCoreOptions {
     srcsetWidths?: number[];
     /** Initial file list (e.g. from a form record on load). */
     initialFiles?: FileProps[];
+    /** Named storage provider slot to upload through — omit for the default. */
+    storageKey?: string;
+    /**
+     * Direct adapter instance — takes priority over `storageKey` when set. For callers that
+     * already computed the right adapter themselves (e.g. a per-record bucket resolved from
+     * that record's own fields, not from a registry key) rather than one registered globally.
+     */
+    storageProvider?: StorageProviderAdapter | null;
 }
-export declare const useFileUploadCore: ({ onFilesChange, onFileReady, uploadPath, srcsetWidths, initialFiles, }: UseFileUploadCoreOptions) => {
+export declare const useFileUploadCore: ({ onFilesChange, onFileReady, uploadPath, srcsetWidths, initialFiles, storageKey, storageProvider, }: UseFileUploadCoreOptions) => {
     files: FileProps[];
     setFiles: React.Dispatch<React.SetStateAction<FileProps[]>>;
     fileInputRef: React.MutableRefObject<HTMLInputElement | null>;
@@ -46,6 +55,10 @@ export interface UploadDocumentProps extends FormFieldProps {
     max?: number;
     /** StorageProvider path — when set, files are auto-uploaded on selection. */
     uploadPath?: string;
+    /** Named storage provider slot to upload through — omit for the default. */
+    storageKey?: string;
+    /** Direct adapter instance — takes priority over `storageKey` when set. */
+    storageProvider?: StorageProviderAdapter | null;
 }
 export interface UploadImageProps extends UploadDocumentProps {
     previewHeight?: number;
@@ -56,5 +69,5 @@ export interface UploadImageProps extends UploadDocumentProps {
     srcsetWidths?: number[];
 }
 export declare const getFileUrl: (file: FileProps, suffix?: string) => string;
-export declare const UploadDocument: ({ name, onChange, label, required, editable, multiple, max, accept, uploadPath, before, after, wrapperClassName, className, }: UploadDocumentProps) => React.JSX.Element;
-export declare const UploadImage: ({ name, onChange, label, feedback, editable, multiple, accept, required, max, previewHeight, previewWidth, uploadPath, srcsetWidths, before, after, wrapperClassName, className, }: UploadImageProps) => React.JSX.Element;
+export declare const UploadDocument: ({ name, onChange, label, required, editable, multiple, max, accept, uploadPath, storageKey, storageProvider, before, after, wrapperClassName, className, }: UploadDocumentProps) => React.JSX.Element;
+export declare const UploadImage: ({ name, onChange, label, feedback, editable, multiple, accept, required, max, previewHeight, previewWidth, uploadPath, srcsetWidths, storageKey, storageProvider, before, after, wrapperClassName, className, }: UploadImageProps) => React.JSX.Element;

package/dist/types/src/components/widgets/Prompt.d.ts

@@ -1,17 +1,13 @@
 import React from 'react';
 import { PromptVariables } from '../../conf/Prompt';
 import { type AIProviderAdapter, type AIRequestOptions, type AIAttachment } from '../../providers/ai/AIProvider';
+import { RecordProps } from '../../providers/data/DataProvider';
+import { type EditorCommand } from '../ui/fields/ContextMenu';
 import { FormFieldProps } from './Form';
 export declare enum PromptMode {
     EDIT = "edit",
     RUN = "run"
 }
-export type PromptCommand = {
-    name: string;
-    description?: string;
-    icon?: string;
-    handler?: (currentValue: string) => string | Promise<string>;
-};
 export type PromptAction = {
     key: string;
     icon: string;
@@ -33,6 +29,9 @@ export type PromptRunStats = {
 type PromptOptions = AIRequestOptions & {
     value: string;
 };
+type PromptConfig = Partial<PromptOptions> & {
+    enabled?: boolean;
+};
 type OnRunPrompt = (prompt: string, options: AIRequestOptions, data?: PromptVariables) => Promise<string>;
 type PromptDefaultValue = {
     value?: string;
@@ -51,26 +50,47 @@ type RenderAIUnavailable = (props: {
     reason?: string;
     configured: boolean;
 }) => React.ReactNode;
-type PromptSharedProps = FormFieldProps & {
+interface PromptFieldBase {
+    name: string;
+    label?: string;
+    required?: boolean;
+    onChange?: FormFieldProps["onChange"];
+    before?: React.ReactNode;
+    after?: React.ReactNode;
+    wrapperClassName?: string;
+    className?: string;
     minHeight?: number;
     maxHeight?: number;
+}
+interface PromptWithAI extends PromptFieldBase {
     defaultValue?: PromptDefaultValue;
     renderAIUnavailable?: RenderAIUnavailable;
+}
+interface PromptEditorProps extends PromptWithAI {
+    value?: RecordProps & {
+        prompt?: PromptConfig;
+    };
+}
+interface PromptRunProps extends PromptWithAI {
+    value?: RecordProps & {
+        prompt?: PromptConfig;
+    };
     variables?: PromptVariables;
-};
-type PromptEditProps = PromptSharedProps & {
-    mode?: PromptMode.EDIT;
-};
-type PromptRunProps = PromptSharedProps & {
-    mode: PromptMode.RUN;
     onRunPrompt?: OnRunPrompt;
     renderFallback?: RenderPlainFallback;
-    commands?: PromptCommand[];
+    commands?: EditorCommand[];
+    commandsTrigger?: string;
     attachments?: boolean;
     actions?: PromptAction[];
     statusItems?: PromptStatusItem[];
+}
+type PromptEditBranch = PromptEditorProps & {
+    mode?: PromptMode.EDIT;
+};
+type PromptRunBranch = PromptRunProps & {
+    mode: PromptMode.RUN;
 };
-export type PromptProps = PromptEditProps | PromptRunProps;
+export type PromptProps = PromptEditBranch | PromptRunBranch;
 export declare const Prompt: ({ mode, ...props }: PromptProps) => React.JSX.Element;
 export declare const runPrompt: (options: PromptOptions, data?: PromptVariables, onRunPrompt?: OnRunPrompt, provider?: AIProviderAdapter, attachments?: AIAttachment[], messages?: {
     noProvider?: string;

package/dist/types/src/index.d.ts

@@ -2,7 +2,7 @@ import './globals.css';
 export { default as App, AppProvider } from './App';
 export { useMenu } from './App';
 export type { AppProps, AppProviderProps, AppProvidersConfig, MenuConfig } from './App';
-export type { AIConfig } from './Config';
+export type { AIConfig, FirebaseConfig } from './Config';
 export type { ServicesConfig, SupabaseProviderConfig, GoogleProviderConfig, MockProviderConfig, DataDriverName, StorageDriverName, AuthDriverName, EmailDriverName, AIDriverName, } from './providers/manifest';
 export type { ProxyConfig } from './Config';
 export { Head, HeadProvider, DEFAULT_DOCUMENT_HEAD, DEFAULT_HEAD_APP_NAME, DEFAULT_LANGUAGE_HEAD, useAssetsHead, useDocumentHead, useHead, useHeadLinks, useLanguageHead, usePaginationHead, usePwaHead, useSchemaOrgHead, useSocialHead, } from './Head';
@@ -18,7 +18,7 @@ export type { DataProviderAdapter, FieldValue, RecordProps, RecordArray, Databas
 export type { OrderConfig, OrderDirection } from './libs/order';
 export { Order } from './libs/order';
 export { PromptUtils } from './libs/promptUtils';
-export type { PromptCommand, PromptAction, PromptStatusItem, PromptRunStats } from './components/widgets/Prompt';
+export type { PromptAction, PromptStatusItem, PromptRunStats } from './components/widgets/Prompt';
 export type { TableHeaderProp, TableReorderHandler, TableReorderMeta, TableSelectionChangeHandler, TableSelectionState } from './components/ui/Table';
 export type { GalleryRecord, GallerySelectionChangeHandler, GallerySelectionState } from './components/ui/Gallery';
 export type { GridAction, GridActions, GridAfterActionArgs, GridAfterActionHandler, GridArrayProps, GridColumn, GridCoreProps, GridDBPath, GridDBQuery, GridDBProps, GridFooterContext, GridFormContext, GridGalleryViewProps, GridHeaderContext, GridLayout, GridMutationDeleteArgs, GridMutationDeleteHandler, GridMutationSaveArgs, GridMutationSaveHandler, GridReorderHandler, GridReorderMeta, GridRecordKey, GridProps, GridSelectionChangeHandler, GridSelectionMode, GridSelectionState, GridSticky, GridTableViewProps, GridCellContext, } from './components/widgets/Grid';
@@ -41,23 +41,32 @@ export type { MotionEffect, MotionReference, MotionRegistry, MotionStyle, Motion
 export { createMotionTransition, resolveMotionEffect, useEnterMotion, useMotionEffect, useMotionState, usePressMotion } from './motion';
 export { FirebaseDataProvider } from './providers/data/firebase';
 export { FirestoreDataProvider } from './providers/data/firestore';
+export type { FirestoreDataProviderConfig } from './providers/data/firestore';
 export { SupabaseDataProvider } from './providers/data/supabase';
 export { MockDataProvider } from './providers/data/mock';
 export { useDataProvider, DataProvider } from './providers/data/DataProviderContext';
 export type { StorageProviderAdapter, UploadOptions, StorageOptions, DeleteOptions, MoveOptions, ListOptions, StorageFileInfo, UploadHandle } from './providers/storage/StorageProvider';
 export { FirebaseStorageProvider } from './providers/storage/firebase';
+export type { FirebaseStorageProviderConfig } from './providers/storage/firebase';
 export { SupabaseStorageProvider } from './providers/storage/supabase';
 export { useStorageProvider, StorageProvider } from './providers/storage/StorageProviderContext';
 export type { AuthProviderAdapter, AuthIntent, AuthSignInOptions, UserProfile } from './providers/auth/AuthProvider';
 export { useAuthProvider, AuthProvider } from './providers/auth/AuthProviderContext';
 export { GoogleAuthProvider } from './providers/auth/google/GoogleAuthProvider';
+export type { FirebaseAuthProviderOptions, FirebaseSignInOptions } from './providers/auth/firebase/FirebaseAuthProvider';
 export { FirebaseAuthProvider } from './providers/auth/firebase/FirebaseAuthProvider';
+export { callFirebaseFunction } from './providers/firebase-init';
 export { SupabaseAuthProvider } from './providers/auth/supabase/SupabaseAuthProvider';
 export { DropboxAuthProvider } from './providers/auth/dropbox/DropboxAuthProvider';
 export type { CredentialsAdapter } from './providers/credentials/CredentialsProvider';
 export { useCredentialsProvider } from './providers/credentials/CredentialsProviderContext';
 export { GoogleServiceAccountProvider } from './providers/credentials/google/GoogleServiceAccountProvider';
 export type { EmailProviderAdapter, EmailSendParams } from './providers/email/EmailProvider';
+export type { EmailProviderId } from './providers/email/definitions';
+export { EMAIL_PROVIDER_DEFINITIONS } from './providers/email/definitions';
+export type { BuildManifest, BuildArtifacts, DeployOptions, DeployResult, Deployment, PublishProviderAdapter } from './providers/publish/PublishProvider';
+export type { PublishProviderId } from './providers/publish/definitions';
+export { PUBLISH_PROVIDER_DEFINITIONS } from './providers/publish/definitions';
 export type { IconProviderAdapter, IconComponentProps } from './providers/icon/IconProvider';
 export { LucideIconProvider } from './providers/icon/LucideIconProvider';
 export { PhosphorIconProvider } from './providers/icon/PhosphorIconProvider';
@@ -66,8 +75,9 @@ export { IconProvider, useIconProvider, useIconController } from './providers/ic
 export type { AppIconProviderConfig, IconController } from './providers/icon/IconProviderContext';
 export { useEmailProvider, EmailProvider } from './providers/email/EmailProviderContext';
 export { GmailEmailProvider } from './providers/email/google/GmailEmailProvider';
-export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIModelCatalog } from './providers/ai';
-export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef } from './providers/ai';
+export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIModelCatalog, AIProviderDefinition } from './providers/ai';
+export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef, AI_PROVIDER_DEFINITIONS, AI_PROVIDER_DESCRIPTORS, OPENAI_COMPATIBLE_PROVIDER_DESCRIPTOR, toProviderDescriptor } from './providers/ai';
+export type { ProviderDescriptor, ProviderCredentialField } from './providers/ProviderDescriptor';
 export { useAIProvider, useAIProviderRegistry, AIProvider } from './providers/ai/AIProviderContext';
 export { proxyFetch, useProxy, configureProxy, isProxyEnabled } from './providers/proxy';
 export { googleGetAccessToken } from './providers/auth/google/GoogleAuth';

package/dist/types/src/providers/ProviderDescriptor.d.ts

@@ -0,0 +1,18 @@
+export type ProviderCredentialField = {
+    key: string;
+    label: string;
+    type: 'text' | 'password' | 'textarea';
+    placeholder?: string;
+};
+export type ProviderDescriptor = {
+    id: string;
+    label: string;
+    description: string;
+    credentialFields: ProviderCredentialField[];
+    /** Where to go find/generate this credential (the provider's own dashboard/API keys page). */
+    credentialsUrl?: string;
+    /** Short guidance on where in that dashboard to look, when the URL alone isn't obvious. */
+    credentialsHint?: string;
+    /** Numbered walkthrough for setups too involved for a one-line hint (e.g. multi-console flows). Rendered instead of credentialsHint when present. */
+    credentialsSteps?: string[];
+};

package/dist/types/src/providers/ai/index.d.ts

@@ -1,9 +1,20 @@
 import type { AIConfig } from '../../Config';
+import type { ProviderDescriptor } from '../ProviderDescriptor';
 import type { AIProviderAdapter } from './AIProvider';
 import { type AIProviderDefinition } from './shared';
 export type { AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIRequestOptions, AIAttachment } from './AIProvider';
 export { formatAIModelRef, parseAIModelRef } from './AIProvider';
-export type { AIModelCatalog } from './shared';
+export type { AIModelCatalog, AIProviderDefinition } from './shared';
 export { getAIModelCatalog } from './shared';
 export declare const AI_PROVIDER_DEFINITIONS: AIProviderDefinition[];
+/** Generic "connect this provider" view of an AIProviderDefinition — the shape a CMS/admin
+ * UI needs (label, description, credential fields, where to find them), independent of the
+ * runtime completion contract (discoverModels/complete) it also carries. */
+export declare const toProviderDescriptor: (definition: AIProviderDefinition) => ProviderDescriptor;
+export declare const AI_PROVIDER_DESCRIPTORS: ProviderDescriptor[];
+/** The user-configurable "bring your own endpoint" slot — metadata-only counterpart of the
+ * dynamic definition getDynamicAIProviderDefinitions() builds once a baseUrl is actually
+ * known. Not part of AI_PROVIDER_DEFINITIONS (there's nothing to build a working adapter
+ * from until the user supplies that URL), but a "connect" UI still needs to offer it. */
+export declare const OPENAI_COMPATIBLE_PROVIDER_DESCRIPTOR: ProviderDescriptor;
 export declare const createAIProviderRegistry: (aiConfig?: AIConfig) => Record<string, AIProviderAdapter>;

package/dist/types/src/providers/ai/openaiCompatible.d.ts

@@ -2,6 +2,7 @@ import type { AIProviderDefinition, BuiltInAIProviderId } from './shared';
 type OpenAICompatibleDefinitionOptions = {
     id: BuiltInAIProviderId;
     label: string;
+    description: string;
     configKey: string;
     requiredConfigKeys?: string[];
     defaultModel: string;
@@ -10,8 +11,9 @@ type OpenAICompatibleDefinitionOptions = {
     modelsUrl?: string;
     chatCompletionsUrl?: string;
     dashboardUrl?: string;
+    credentialsHint?: string;
     /** Override the default validateApiKey when the models endpoint is public or uses a non-standard error format. */
     validateApiKey?: AIProviderDefinition['validateApiKey'];
 };
-export declare const createOpenAICompatibleProviderDefinition: ({ id, label, configKey, requiredConfigKeys, defaultModel, fallbackModels, baseUrl, modelsUrl, chatCompletionsUrl, dashboardUrl, validateApiKey: validateApiKeyOverride, }: OpenAICompatibleDefinitionOptions) => AIProviderDefinition;
+export declare const createOpenAICompatibleProviderDefinition: ({ id, label, description, configKey, requiredConfigKeys, defaultModel, fallbackModels, baseUrl, modelsUrl, chatCompletionsUrl, dashboardUrl, credentialsHint, validateApiKey: validateApiKeyOverride, }: OpenAICompatibleDefinitionOptions) => AIProviderDefinition;
 export {};

package/dist/types/src/providers/ai/shared.d.ts

@@ -1,15 +1,24 @@
 import { type ProviderConfigurationState } from '../ProviderConfiguration';
+import type { ProviderCredentialField } from '../ProviderDescriptor';
 import type { AICompleteRequest, AIKeyValidationResult, AIModelDescriptor, AIProviderAdapter, AIProviderCapabilities, AIRequestOptions } from './AIProvider';
 export type BuiltInAIProviderId = 'openai' | 'openrouter' | 'opencode' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral' | 'glm';
 export type AIProviderDefinition = {
     id: BuiltInAIProviderId;
     label: string;
+    /** One-line description shown in a "connect this provider" UI. */
+    description?: string;
     configKey?: string;
     requiredConfigKeys?: string[];
     defaultModel: string;
     fallbackModels: string[];
-    /** URL to the provider's API key management page (shown in UI on validation error). */
+    /** URL to the provider's API key management page (shown in UI on validation error, and
+     * surfaced as ProviderDescriptor.credentialsUrl via toProviderDescriptor()). */
     dashboardUrl?: string;
+    /** Credential fields a "connect" UI should collect (defaults to a single apiKey field
+     * when omitted — see toProviderDescriptor() in ./index.ts). */
+    credentialFields?: ProviderCredentialField[];
+    /** Short guidance on where in the dashboard to find the credential. */
+    credentialsHint?: string;
     capabilities?: Omit<AIProviderCapabilities, 'models'>;
     discoverModels: (apiKey: string) => Promise<string[]>;
     complete: (apiKey: string, request: Required<Pick<AICompleteRequest, 'prompt' | 'model'>> & AIRequestOptions) => Promise<string | null>;

package/dist/types/src/providers/auth/AuthProvider.d.ts

@@ -19,4 +19,12 @@ export interface AuthProviderAdapter extends ProviderConfigurable {
     onAuthChange(callback: (user: UserProfile | null) => void): () => void;
     getAccessToken?(scopes?: string[]): Promise<string>;
     isAuthenticated?(): boolean;
+    /**
+     * Custom claims embedded in the current session's token (e.g. a JWT's payload),
+     * for providers backed by one — Firebase custom claims, a Supabase JWT, etc.
+     * Optional: providers with no token-claims concept (e.g. plain OAuth) omit it.
+     * Read-only/UI convenience — never a security boundary, the server always
+     * re-verifies the raw token itself rather than trusting client-read claims.
+     */
+    getIdTokenClaims?(): Promise<Record<string, unknown> | null>;
 }

package/dist/types/src/providers/auth/firebase/FirebaseAuthProvider.d.ts

@@ -1,5 +1,6 @@
 import type { AuthProviderAdapter, AuthSignInOptions, UserProfile } from '../AuthProvider';
 import type { ProviderConfigurationState } from '../../ProviderConfiguration';
+import type { FirebaseConfig } from '../../../Config';
 /**
  * Firebase-specific sign-in options.
  *
@@ -14,7 +15,28 @@ export interface FirebaseSignInOptions extends AuthSignInOptions {
     password?: string;
     provider?: string;
 }
+export interface FirebaseAuthProviderOptions {
+    /**
+     * Static config for this provider's own Firebase app. Omit when relying on
+     * another consumer (e.g. providers.firebase + FirebaseDataProvider, or the
+     * tenant-switching session factories in ProviderSession.tsx) to have already
+     * initialized the target app — matches the provider's original zero-arg behavior.
+     */
+    config?: FirebaseConfig;
+    /**
+     * Firebase app name this provider's session lives under. Defaults to the SDK's
+     * unnamed default app. Give this a dedicated name (e.g. 'control-plane') when a
+     * long-lived login session must coexist with the default app used by tenant
+     * switching — ProviderSession's 'data'/'storage' firebase factories reinitialize
+     * the default app on every switch, which would otherwise tear down this session.
+     */
+    appName?: string;
+}
 export declare class FirebaseAuthProvider implements AuthProviderAdapter {
+    private readonly options;
+    private readonly appName?;
+    private readonly initPromise;
+    constructor(options?: FirebaseAuthProviderOptions);
     getConfigurationState(): ProviderConfigurationState;
     isConfigured(): boolean;
     getUser(): UserProfile | null;
@@ -23,4 +45,5 @@ export declare class FirebaseAuthProvider implements AuthProviderAdapter {
     signOut(): Promise<void>;
     onAuthChange(callback: (user: UserProfile | null) => void): () => void;
     getAccessToken(): Promise<string>;
+    getIdTokenClaims(): Promise<Record<string, unknown> | null>;
 }

package/dist/types/src/providers/data/firestore.d.ts

@@ -1,8 +1,15 @@
 import { DataProviderAdapter, DatabaseOptions, ReadOptions, SetChunksOptions, RecordProps } from './DataProvider';
 import type { ProviderConfigurationState } from '../ProviderConfiguration';
+export interface FirestoreDataProviderConfig {
+    /** Named database within the current app's project — omit for the "(default)" database. */
+    databaseId?: string;
+}
 export declare class FirestoreDataProvider implements DataProviderAdapter {
     private static listenerRegistered;
-    constructor();
+    private databaseId?;
+    constructor(config?: FirestoreDataProviderConfig);
+    /** Same "(default)" database as before when no databaseId was configured. */
+    private getDb;
     getConfigurationState(): ProviderConfigurationState;
     isConfigured(): boolean;
     read: (path: string, { where, order, toArray, exception }?: ReadOptions) => Promise<any>;

package/dist/types/src/providers/email/definitions.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDescriptor } from '../ProviderDescriptor';
+export type EmailProviderId = 'resend' | 'sendgrid' | 'mailgun' | 'postmark' | 'ses' | 'smtp';
+export declare const EMAIL_PROVIDER_DEFINITIONS: ProviderDescriptor[];

package/dist/types/src/providers/firebase-init.d.ts

@@ -2,10 +2,10 @@ import { type FirebaseApp } from 'firebase/app';
 import { type Auth } from "firebase/auth";
 import { FirebaseConfig } from "../Config";
 import { type ProviderConfigurationState } from "./ProviderConfiguration";
-export declare const setFirebaseConfigState: (config: FirebaseConfig | undefined) => void;
-export declare const getFirebaseConfigurationState: () => ProviderConfigurationState;
-export declare const getFirestoreConfigurationState: () => ProviderConfigurationState;
-export declare const getSafeAuth: () => Auth | null;
+export declare const setFirebaseConfigState: (config: FirebaseConfig | undefined, appName?: string) => void;
+export declare const getFirebaseConfigurationState: (appName?: string) => ProviderConfigurationState;
+export declare const getFirestoreConfigurationState: (appName?: string) => ProviderConfigurationState;
+export declare const getSafeAuth: (appName?: string) => Auth | null;
 export declare const getFirebaseAuthorization: () => Promise<boolean>;
 /**
  * Signs into the currently-initialized Firebase app using a custom token minted
@@ -17,5 +17,11 @@ export declare const getFirebaseAuthorization: () => Promise<boolean>;
  * Call init(config) to point the app at the right project *before* calling this.
  */
 export declare const signInWithFirebaseCustomToken: (token: string) => Promise<boolean>;
-declare const init: (config: FirebaseConfig) => Promise<FirebaseApp>;
+declare const init: (config: FirebaseConfig, appName?: string) => Promise<FirebaseApp>;
+/**
+ * Invokes a Firebase Callable Function against a given app (the SDK auto-attaches
+ * that app's current auth session's ID token — no manual header wiring). Lazily
+ * imports 'firebase/functions' so it's not bundled for apps that never call one.
+ */
+export declare function callFirebaseFunction<T = unknown>(functionName: string, data: unknown, appName?: string, region?: string): Promise<T>;
 export default init;

package/dist/types/src/providers/publish/PublishProvider.d.ts

@@ -0,0 +1,29 @@
+import type { ProviderConfigurable } from '../ProviderConfiguration';
+export interface BuildManifest {
+    pages: number;
+    sizeBytes: number;
+    generatedAt: string;
+}
+export interface BuildArtifacts {
+    buildId: string;
+    outputPath: string;
+    manifest: BuildManifest;
+}
+export type DeployOptions = Record<string, never>;
+export interface DeployResult {
+    success: boolean;
+    buildId: string;
+    url?: string;
+    error?: string;
+}
+export interface Deployment {
+    buildId: string;
+    timestamp: string;
+    status: 'success' | 'failed' | 'in_progress';
+    url?: string;
+}
+export interface PublishProviderAdapter extends ProviderConfigurable {
+    deploy(artifacts: BuildArtifacts, options?: DeployOptions): Promise<DeployResult>;
+    rollback(buildId: string): Promise<DeployResult>;
+    getDeployments(limit?: number): Promise<Deployment[]>;
+}

package/dist/types/src/providers/publish/definitions.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDescriptor } from '../ProviderDescriptor';
+export type PublishProviderId = 'cloudflare_pages' | 'firebase_hosting' | 'supabase_storage' | 'ftp' | 'sftp' | 'netlify' | 'github_pages' | 's3_cloudfront' | 'static_export';
+export declare const PUBLISH_PROVIDER_DEFINITIONS: ProviderDescriptor[];

package/dist/types/src/providers/storage/firebase.d.ts

@@ -1,8 +1,14 @@
 import type { StorageProviderAdapter, UploadOptions, StorageOptions, DeleteOptions, MoveOptions, ListOptions, StorageFileInfo, UploadHandle } from './StorageProvider';
 import type { ProviderConfigurationState } from '../ProviderConfiguration';
+export interface FirebaseStorageProviderConfig {
+    /** Used when a call doesn't pass its own `opts.bucket` — omit for the project's default bucket. */
+    defaultBucket?: string;
+}
 export declare class FirebaseStorageProvider implements StorageProviderAdapter {
     private static listenerRegistered;
-    constructor();
+    private defaultBucket?;
+    constructor(config?: FirebaseStorageProviderConfig);
+    private resolveBucket;
     getConfigurationState(): ProviderConfigurationState;
     isConfigured(): boolean;
     upload: (file: string | File | Blob, path: string, opts?: UploadOptions) => Promise<string | undefined>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -15,18 +15,20 @@
     "./vite": "./dist/vite.mjs",
     "./dist/index.css": "./dist/index.css"
   },
-  "scripts": {
-    "prebuild": "node scripts/dev/build-local.js --restore-only",
-    "themes:compile:vscode": "node scripts/themes/compile-vscode-themes.js",
-    "build": "npm run themes:compile:vscode && vite build && tsc --emitDeclarationOnly",
-    "build:dev": "npm run themes:compile:vscode && vite build --mode development && tsc --emitDeclarationOnly",
+  "scripts": {
+    "prebuild": "node scripts/dev/build-local.js --restore-only",
+    "themes:compile:vscode": "node scripts/themes/compile-vscode-themes.js",
+    "build": "npm run themes:compile:vscode && vite build && tsc --emitDeclarationOnly",
+    "build:dev": "npm run themes:compile:vscode && vite build --mode development && tsc --emitDeclarationOnly",
     "watch:dev": "vite build --watch",
     "build:local": "node scripts/dev/build-local.js",
     "prepublishOnly": "npm run build",
     "updateReadme": "node scripts/dev/updateReadme.js",
     "test": "vitest run",
+    "test:e2e": "npx playwright test",
     "test:e2e:proxy-scaffold": "node scripts/e2e/test-proxy-scaffold.js",
     "test:e2e:proxy-runtime": "vitest run tests/e2e/proxy-runtime.test.ts --environment node",
+    "test:integration": "npx firebase emulators:exec --only database,firestore,storage --project demo-test \"npx vitest run --config vitest.integration.config.mts\"",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage"
   },
@@ -91,9 +93,12 @@
     "@babel/preset-env": "^7.25.7",
     "@babel/preset-react": "^7.25.7",
     "@babel/preset-typescript": "^7.25.7",
+    "@firebase/rules-unit-testing": "^5.0.1",
     "@phosphor-icons/react": "^2.1.10",
+    "@playwright/test": "^1.61.1",
     "@supabase/supabase-js": "^2.107.0",
     "@tailwindcss/postcss": "^4.2.4",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
@@ -103,6 +108,7 @@
     "@types/react-dom": "^18.2.0",
     "@vitest/coverage-v8": "2.1",
     "autoprefixer": "^10.5.0",
+    "firebase": "^12.0.0",
     "googleapis": "^171.4.0",
     "happy-dom": "^20.9.0",
     "jsdom": "^29.1.1",
@@ -114,7 +120,8 @@
     "tailwindcss": "^4.2.4",
     "typescript": "^5.6.2",
     "vite": "^5.4.21",
-    "vitest": "2.1"
+    "vitest": "2.1",
+    "ws": "^8.21.0"
   },
   "dependencies": {
     "@codemirror/autocomplete": "^6.20.3",