clefbase 1.5.3 → 2.0.0

package/dist/ai.d.ts

@@ -0,0 +1,369 @@
+import { HttpClient } from "./http";
+export type AIProvider = "anthropic" | "google";
+export type AIModelCategory = "text" | "code" | "image" | "video" | "embedding";
+/**
+ * A model available in the project's AI service.
+ */
+export interface AIModel {
+    id: string;
+    name: string;
+    provider: AIProvider;
+    category: AIModelCategory;
+    description: string;
+    maxTokens?: number;
+    supportsStreaming?: boolean;
+    supportsSystemPrompt?: boolean;
+}
+export interface GenerateTextOptions {
+    /** Model ID, e.g. `"claude-sonnet-4-5"` or `"gemini-2.5-flash"` */
+    model: string;
+    /** The user-turn prompt */
+    prompt: string;
+    /** System-level instructions (supported by Anthropic + Gemini) */
+    systemPrompt?: string;
+    /** Hard token cap on the response */
+    maxTokens?: number;
+    /** Sampling temperature 0–2. Lower = more deterministic. */
+    temperature?: number;
+    /** Prior turns to send as context */
+    history?: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+}
+export interface GenerateTextResult {
+    id: string;
+    model: string;
+    provider: AIProvider;
+    /** `"text"` or `"code"` */
+    category: AIModelCategory;
+    content: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    createdAt: string;
+}
+export interface GenerateImageOptions {
+    /** Model ID, e.g. `"imagen-4.0-generate-001"` */
+    model: string;
+    /** Text description of the desired image */
+    prompt: string;
+    /** Things to exclude from the image */
+    negativePrompt?: string;
+    /** Output canvas ratio */
+    aspectRatio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4";
+    /** Number of images to generate (1–4) */
+    numberOfImages?: number;
+    /**
+     * Folder name inside the project's AI-output storage bucket where
+     * generated images will be saved, e.g. `"marketing"`.
+     * Leave undefined to use the bucket root.
+     */
+    outputFolder?: string;
+}
+export interface GeneratedMediaFile {
+    /** ID of the file in project Storage */
+    storageFileId: string;
+    /** Storage bucket ID */
+    bucketId: string;
+    /** Full storage path, e.g. `"ai-outputs/images/img_123.png"` */
+    fullPath: string;
+    sizeBytes: number;
+    mimeType: string;
+}
+export interface GenerateImageResult {
+    id: string;
+    model: string;
+    provider: AIProvider;
+    category: "image";
+    prompt: string;
+    /** Each generated image as a saved storage file */
+    files: GeneratedMediaFile[];
+    durationMs: number;
+    createdAt: string;
+}
+export interface GenerateVideoOptions {
+    /** Model ID, e.g. `"veo-3.1-generate-preview"` */
+    model: string;
+    /** Text description of the video */
+    prompt: string;
+    negativePrompt?: string;
+    /** Requested clip length in seconds (1–30) */
+    durationSeconds?: number;
+    aspectRatio?: "16:9" | "9:16" | "1:1";
+    /**
+     * Folder inside the AI-output storage bucket where the video will be saved.
+     */
+    outputFolder?: string;
+}
+export interface GenerateVideoResult {
+    id: string;
+    model: string;
+    provider: AIProvider;
+    category: "video";
+    prompt: string;
+    /** `"completed"` once the async Veo job finishes (may take 1–5 min) */
+    status: "completed" | "pending" | "failed";
+    /** Server-side async operation name — informational */
+    operationName?: string;
+    files: GeneratedMediaFile[];
+    durationMs: number;
+    createdAt: string;
+}
+export interface GenerateEmbeddingOptions {
+    /** Model ID, e.g. `"gemini-embedding-001"` */
+    model: string;
+    /** One string or an array of strings to embed */
+    input: string | string[];
+}
+export interface GenerateEmbeddingResult {
+    id: string;
+    model: string;
+    provider: AIProvider;
+    category: "embedding";
+    /** One float array per input string */
+    embeddings: number[][];
+    inputTokens: number;
+    durationMs: number;
+    createdAt: string;
+}
+export interface AIUsageRecord {
+    id: string;
+    model: string;
+    provider: AIProvider;
+    category: AIModelCategory;
+    inputTokens: number;
+    outputTokens: number;
+    mediaCount: number;
+    durationMs: number;
+    status: "success" | "error";
+    error?: string;
+    createdAt: string;
+}
+export interface AIUsageStats {
+    totalRequests: number;
+    successRequests: number;
+    errorRequests: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalMediaGenerated: number;
+    byModel: Record<string, number>;
+    byCategory: Partial<Record<AIModelCategory, number>>;
+}
+/**
+ * Thrown by all AI SDK methods when the server returns an error.
+ *
+ * @example
+ * import { AIError } from "clefbase";
+ *
+ * try {
+ *   const result = await ai.text({ model: "claude-sonnet-4-5", prompt: "Hello" });
+ * } catch (err) {
+ *   if (err instanceof AIError) {
+ *     console.error(err.message, err.httpStatus);
+ *   }
+ * }
+ */
+export declare class AIError extends Error {
+    /** HTTP status code returned by the server, if available */
+    readonly httpStatus?: number | undefined;
+    constructor(message: string, 
+    /** HTTP status code returned by the server, if available */
+    httpStatus?: number | undefined);
+}
+/**
+ * Clefbase AI service — obtained via `getAI(app)`.
+ *
+ * Provides access to text/code generation (Claude & Gemini), image generation
+ * (Imagen 3), video generation (Veo 2), and text embeddings.
+ * Generated images and videos are automatically saved to the project's
+ * configured storage bucket.
+ *
+ * @example
+ * import { initClefbase, getAI } from "clefbase";
+ *
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
+ * const ai  = getAI(app);
+ *
+ * // ── Text / code ────────────────────────────────────────────────────────────
+ * const { content } = await ai.text({
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Explain promises in JavaScript",
+ * });
+ *
+ * // ── Multi-turn chat ────────────────────────────────────────────────────────
+ * const { content } = await ai.text({
+ *   model:        "gemini-2.5-flash",
+ *   prompt:       "What did I just ask you?",
+ *   systemPrompt: "You are a helpful tutor.",
+ *   history: [
+ *     { role: "user",      content: "What is 2 + 2?" },
+ *     { role: "assistant", content: "4" },
+ *   ],
+ * });
+ *
+ * // ── Image (saved to Storage) ────────────────────────────────────────────────
+ * const { files } = await ai.image({
+ *   model:          "imagen-4.0-generate-001",
+ *   prompt:         "A serene mountain lake at dawn, photorealistic",
+ *   aspectRatio:    "16:9",
+ *   numberOfImages: 2,
+ *   outputFolder:   "landscapes",
+ * });
+ * // files[].fullPath      → path in project Storage
+ * // files[].storageFileId → pass to storage SDK to get a download URL
+ *
+ * // ── Video (saved to Storage) ───────────────────────────────────────────────
+ * const { status, files } = await ai.video({
+ *   model:           "veo-3.1-generate-preview",
+ *   prompt:          "A slow-motion waterfall in a rainforest",
+ *   durationSeconds: 8,
+ *   aspectRatio:     "16:9",
+ * });
+ *
+ * // ── Embeddings ─────────────────────────────────────────────────────────────
+ * const { embeddings } = await ai.embedding({
+ *   model: "gemini-embedding-001",
+ *   input: ["Hello world", "Semantic search"],
+ * });
+ * // embeddings: number[][]
+ *
+ * // ── Browse models ──────────────────────────────────────────────────────────
+ * const imageModels = await ai.listModels({ category: "image" });
+ *
+ * // ── Usage ──────────────────────────────────────────────────────────────────
+ * const stats   = await ai.getStats();
+ * const history = await ai.getUsage({ limit: 50 });
+ */
+export declare class ClefbaseAI {
+    private readonly _http;
+    /** @internal */
+    constructor(_http: HttpClient);
+    /**
+     * List all AI models available on the server.
+     * Optionally filter by `provider` or `category`.
+     *
+     * @example
+     * const textModels   = await ai.listModels({ category: "text" });
+     * const googleModels = await ai.listModels({ provider: "google" });
+     * const all          = await ai.listModels();
+     */
+    listModels(filter?: {
+        provider?: AIProvider;
+        category?: AIModelCategory;
+    }): Promise<AIModel[]>;
+    /**
+     * Generate text or code with a Claude or Gemini model.
+     *
+     * @example
+     * const { content, inputTokens, outputTokens } = await ai.text({
+     *   model:        "claude-sonnet-4-5",
+     *   prompt:       "Write a bubble-sort in Python",
+     *   systemPrompt: "Return only code, no explanation.",
+     *   maxTokens:    512,
+     * });
+     */
+    text(options: GenerateTextOptions): Promise<GenerateTextResult>;
+    /**
+     * Generate one or more images with an Imagen model.
+     * Outputs are automatically saved to the project's storage bucket.
+     *
+     * @example
+     * const { files } = await ai.image({
+     *   model:       "imagen-4.0-generate-001",
+     *   prompt:      "A futuristic city skyline at sunset",
+     *   aspectRatio: "16:9",
+     * });
+     * const path = files[0].fullPath; // use with storage.ref()
+     */
+    image(options: GenerateImageOptions): Promise<GenerateImageResult>;
+    /**
+     * Generate a video with Veo 2.
+     * This is an async server-side operation — the SDK call blocks until the
+     * job completes (usually 1–5 minutes). Outputs are saved to project storage.
+     *
+     * @example
+     * const { status, files } = await ai.video({
+     *   model:           "veo-3.1-generate-preview",
+     *   prompt:          "A golden retriever running on a sunny beach",
+     *   durationSeconds: 5,
+     *   outputFolder:    "clips",
+     * });
+     */
+    video(options: GenerateVideoOptions): Promise<GenerateVideoResult>;
+    /**
+     * Generate text embeddings — one float vector per input string.
+     *
+     * @example
+     * const { embeddings } = await ai.embedding({
+     *   model: "gemini-embedding-001",
+     *   input: ["cat", "dog", "automobile"],
+     * });
+     * // embeddings[0].length === 768
+     */
+    embedding(options: GenerateEmbeddingOptions): Promise<GenerateEmbeddingResult>;
+    /**
+     * Fetch aggregated usage statistics for this project.
+     *
+     * @example
+     * const { totalRequests, totalInputTokens, totalMediaGenerated } = await ai.getStats();
+     */
+    getStats(): Promise<AIUsageStats>;
+    /**
+     * Fetch the raw request log for this project (newest first).
+     *
+     * @param opts.limit  Max records to return (default: 50, server max: 200)
+     *
+     * @example
+     * const records = await ai.getUsage({ limit: 20 });
+     * for (const r of records) {
+     *   console.log(r.model, r.status, r.durationMs);
+     * }
+     */
+    getUsage(opts?: {
+        limit?: number;
+    }): Promise<AIUsageRecord[]>;
+    private _wrap;
+}
+/**
+ * Generate text or code. Sugar for `ai.text(options)`.
+ *
+ * @example
+ * const { content } = await generateText(ai, {
+ *   model: "claude-sonnet-4-5",
+ *   prompt: "What is the capital of France?",
+ * });
+ */
+export declare function generateText(ai: ClefbaseAI, options: GenerateTextOptions): Promise<GenerateTextResult>;
+/**
+ * Generate images. Sugar for `ai.image(options)`.
+ *
+ * @example
+ * const { files } = await generateImage(ai, {
+ *   model:  "imagen-4.0-generate-001",
+ *   prompt: "A calm ocean at sunset",
+ * });
+ */
+export declare function generateImage(ai: ClefbaseAI, options: GenerateImageOptions): Promise<GenerateImageResult>;
+/**
+ * Generate a video. Sugar for `ai.video(options)`.
+ *
+ * @example
+ * const { files } = await generateVideo(ai, {
+ *   model:  "veo-3.1-generate-preview",
+ *   prompt: "A timelapse of clouds over a mountain",
+ *   durationSeconds: 6,
+ * });
+ */
+export declare function generateVideo(ai: ClefbaseAI, options: GenerateVideoOptions): Promise<GenerateVideoResult>;
+/**
+ * Generate embeddings. Sugar for `ai.embedding(options)`.
+ *
+ * @example
+ * const { embeddings } = await generateEmbedding(ai, {
+ *   model: "gemini-embedding-001",
+ *   input: "Hello world",
+ * });
+ */
+export declare function generateEmbedding(ai: ClefbaseAI, options: GenerateEmbeddingOptions): Promise<GenerateEmbeddingResult>;
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

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

package/dist/ai.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClefbaseAI = exports.AIError = void 0;
+exports.generateText = generateText;
+exports.generateImage = generateImage;
+exports.generateVideo = generateVideo;
+exports.generateEmbedding = generateEmbedding;
+const types_1 = require("./types");
+// ─── AIError ──────────────────────────────────────────────────────────────────
+/**
+ * Thrown by all AI SDK methods when the server returns an error.
+ *
+ * @example
+ * import { AIError } from "clefbase";
+ *
+ * try {
+ *   const result = await ai.text({ model: "claude-sonnet-4-5", prompt: "Hello" });
+ * } catch (err) {
+ *   if (err instanceof AIError) {
+ *     console.error(err.message, err.httpStatus);
+ *   }
+ * }
+ */
+class AIError extends Error {
+    constructor(message, 
+    /** HTTP status code returned by the server, if available */
+    httpStatus) {
+        super(message);
+        this.httpStatus = httpStatus;
+        this.name = "AIError";
+        if (Error.captureStackTrace)
+            Error.captureStackTrace(this, AIError);
+    }
+}
+exports.AIError = AIError;
+// ─── ClefbaseAI ───────────────────────────────────────────────────────────────
+/**
+ * Clefbase AI service — obtained via `getAI(app)`.
+ *
+ * Provides access to text/code generation (Claude & Gemini), image generation
+ * (Imagen 3), video generation (Veo 2), and text embeddings.
+ * Generated images and videos are automatically saved to the project's
+ * configured storage bucket.
+ *
+ * @example
+ * import { initClefbase, getAI } from "clefbase";
+ *
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
+ * const ai  = getAI(app);
+ *
+ * // ── Text / code ────────────────────────────────────────────────────────────
+ * const { content } = await ai.text({
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Explain promises in JavaScript",
+ * });
+ *
+ * // ── Multi-turn chat ────────────────────────────────────────────────────────
+ * const { content } = await ai.text({
+ *   model:        "gemini-2.5-flash",
+ *   prompt:       "What did I just ask you?",
+ *   systemPrompt: "You are a helpful tutor.",
+ *   history: [
+ *     { role: "user",      content: "What is 2 + 2?" },
+ *     { role: "assistant", content: "4" },
+ *   ],
+ * });
+ *
+ * // ── Image (saved to Storage) ────────────────────────────────────────────────
+ * const { files } = await ai.image({
+ *   model:          "imagen-4.0-generate-001",
+ *   prompt:         "A serene mountain lake at dawn, photorealistic",
+ *   aspectRatio:    "16:9",
+ *   numberOfImages: 2,
+ *   outputFolder:   "landscapes",
+ * });
+ * // files[].fullPath      → path in project Storage
+ * // files[].storageFileId → pass to storage SDK to get a download URL
+ *
+ * // ── Video (saved to Storage) ───────────────────────────────────────────────
+ * const { status, files } = await ai.video({
+ *   model:           "veo-3.1-generate-preview",
+ *   prompt:          "A slow-motion waterfall in a rainforest",
+ *   durationSeconds: 8,
+ *   aspectRatio:     "16:9",
+ * });
+ *
+ * // ── Embeddings ─────────────────────────────────────────────────────────────
+ * const { embeddings } = await ai.embedding({
+ *   model: "gemini-embedding-001",
+ *   input: ["Hello world", "Semantic search"],
+ * });
+ * // embeddings: number[][]
+ *
+ * // ── Browse models ──────────────────────────────────────────────────────────
+ * const imageModels = await ai.listModels({ category: "image" });
+ *
+ * // ── Usage ──────────────────────────────────────────────────────────────────
+ * const stats   = await ai.getStats();
+ * const history = await ai.getUsage({ limit: 50 });
+ */
+class ClefbaseAI {
+    /** @internal */
+    constructor(_http) {
+        this._http = _http;
+    }
+    // ─── listModels ─────────────────────────────────────────────────────────────
+    /**
+     * List all AI models available on the server.
+     * Optionally filter by `provider` or `category`.
+     *
+     * @example
+     * const textModels   = await ai.listModels({ category: "text" });
+     * const googleModels = await ai.listModels({ provider: "google" });
+     * const all          = await ai.listModels();
+     */
+    async listModels(filter) {
+        const qs = new URLSearchParams();
+        if (filter?.provider)
+            qs.set("provider", filter.provider);
+        if (filter?.category)
+            qs.set("category", filter.category);
+        const query = qs.toString() ? `?${qs}` : "";
+        try {
+            return await this._http.get(`/models${query}`);
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── text ────────────────────────────────────────────────────────────────────
+    /**
+     * Generate text or code with a Claude or Gemini model.
+     *
+     * @example
+     * const { content, inputTokens, outputTokens } = await ai.text({
+     *   model:        "claude-sonnet-4-5",
+     *   prompt:       "Write a bubble-sort in Python",
+     *   systemPrompt: "Return only code, no explanation.",
+     *   maxTokens:    512,
+     * });
+     */
+    async text(options) {
+        try {
+            return await this._http.post("/generate/text", options);
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── image ───────────────────────────────────────────────────────────────────
+    /**
+     * Generate one or more images with an Imagen model.
+     * Outputs are automatically saved to the project's storage bucket.
+     *
+     * @example
+     * const { files } = await ai.image({
+     *   model:       "imagen-4.0-generate-001",
+     *   prompt:      "A futuristic city skyline at sunset",
+     *   aspectRatio: "16:9",
+     * });
+     * const path = files[0].fullPath; // use with storage.ref()
+     */
+    async image(options) {
+        try {
+            return await this._http.post("/generate/image", options);
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── video ───────────────────────────────────────────────────────────────────
+    /**
+     * Generate a video with Veo 2.
+     * This is an async server-side operation — the SDK call blocks until the
+     * job completes (usually 1–5 minutes). Outputs are saved to project storage.
+     *
+     * @example
+     * const { status, files } = await ai.video({
+     *   model:           "veo-3.1-generate-preview",
+     *   prompt:          "A golden retriever running on a sunny beach",
+     *   durationSeconds: 5,
+     *   outputFolder:    "clips",
+     * });
+     */
+    async video(options) {
+        try {
+            return await this._http.post("/generate/video", options);
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── embedding ───────────────────────────────────────────────────────────────
+    /**
+     * Generate text embeddings — one float vector per input string.
+     *
+     * @example
+     * const { embeddings } = await ai.embedding({
+     *   model: "gemini-embedding-001",
+     *   input: ["cat", "dog", "automobile"],
+     * });
+     * // embeddings[0].length === 768
+     */
+    async embedding(options) {
+        try {
+            return await this._http.post("/generate/embedding", options);
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── getStats ────────────────────────────────────────────────────────────────
+    /**
+     * Fetch aggregated usage statistics for this project.
+     *
+     * @example
+     * const { totalRequests, totalInputTokens, totalMediaGenerated } = await ai.getStats();
+     */
+    async getStats() {
+        try {
+            return await this._http.get("/stats");
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── getUsage ────────────────────────────────────────────────────────────────
+    /**
+     * Fetch the raw request log for this project (newest first).
+     *
+     * @param opts.limit  Max records to return (default: 50, server max: 200)
+     *
+     * @example
+     * const records = await ai.getUsage({ limit: 20 });
+     * for (const r of records) {
+     *   console.log(r.model, r.status, r.durationMs);
+     * }
+     */
+    async getUsage(opts) {
+        const limit = Math.min(opts?.limit ?? 50, 200);
+        try {
+            return await this._http.get(`/usage?limit=${limit}`);
+        }
+        catch (err) {
+            throw this._wrap(err);
+        }
+    }
+    // ─── Internal ─────────────────────────────────────────────────────────────────
+    _wrap(err) {
+        if (err instanceof AIError)
+            return err;
+        if (err instanceof types_1.ClefbaseError)
+            return new AIError(err.message, err.status);
+        return new AIError(err.message ?? "Unknown AI error");
+    }
+}
+exports.ClefbaseAI = ClefbaseAI;
+// ─── Top-level convenience functions ─────────────────────────────────────────
+/**
+ * Generate text or code. Sugar for `ai.text(options)`.
+ *
+ * @example
+ * const { content } = await generateText(ai, {
+ *   model: "claude-sonnet-4-5",
+ *   prompt: "What is the capital of France?",
+ * });
+ */
+async function generateText(ai, options) {
+    return ai.text(options);
+}
+/**
+ * Generate images. Sugar for `ai.image(options)`.
+ *
+ * @example
+ * const { files } = await generateImage(ai, {
+ *   model:  "imagen-4.0-generate-001",
+ *   prompt: "A calm ocean at sunset",
+ * });
+ */
+async function generateImage(ai, options) {
+    return ai.image(options);
+}
+/**
+ * Generate a video. Sugar for `ai.video(options)`.
+ *
+ * @example
+ * const { files } = await generateVideo(ai, {
+ *   model:  "veo-3.1-generate-preview",
+ *   prompt: "A timelapse of clouds over a mountain",
+ *   durationSeconds: 6,
+ * });
+ */
+async function generateVideo(ai, options) {
+    return ai.video(options);
+}
+/**
+ * Generate embeddings. Sugar for `ai.embedding(options)`.
+ *
+ * @example
+ * const { embeddings } = await generateEmbedding(ai, {
+ *   model: "gemini-embedding-001",
+ *   input: "Hello world",
+ * });
+ */
+async function generateEmbedding(ai, options) {
+    return ai.embedding(options);
+}
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

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

package/dist/app.d.ts

@@ -4,6 +4,7 @@ import { Auth } from "./auth";
 import { ClefbaseStorage } from "./storage";
 import { ClefbaseHosting } from "./hosting";
 import { ClefbaseFunctions } from "./functions";
+import { ClefbaseAI } from "./ai";
 import type { ClefbaseConfig } from "./types";
 /**
  * A Clefbase application instance.
@@ -16,11 +17,13 @@ export declare class ClefbaseApp {
     /** @internal */ readonly _storageHttp: HttpClient;
     /** @internal */ readonly _hostingHttp: HttpClient;
     /** @internal */ readonly _functionsHttp: HttpClient;
+    /** @internal */ readonly _aiHttp: HttpClient;
     private _db;
     private _auth;
     private _storage;
     private _hosting;
     private _functions;
+    private _ai;
     constructor(config: ClefbaseConfig);
     /** @internal */
     _getDb(): Database;
@@ -32,6 +35,8 @@ export declare class ClefbaseApp {
     _getHosting(): ClefbaseHosting;
     /** @internal */
     _getFunctions(): ClefbaseFunctions;
+    /** @internal */
+    _getAI(): ClefbaseAI;
 }
 /**
  * Initialise a Clefbase app. Call once at startup.
@@ -69,4 +74,39 @@ export declare function getHosting(app?: ClefbaseApp): ClefbaseHosting;
  * const { data } = await greet({ name: "Alice" });
  */
 export declare function getFunctions(app?: ClefbaseApp): ClefbaseFunctions;
+/**
+ * Get the AI service.
+ *
+ * @example
+ * import { initClefbase, getAI } from "clefbase";
+ *
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
+ * const ai  = getAI(app);
+ *
+ * // Text generation
+ * const { content } = await ai.text({
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Explain closures in JavaScript",
+ * });
+ *
+ * // Image generation — saved to project Storage automatically
+ * const { files } = await ai.image({
+ *   model:  "imagen-3.0-generate-002",
+ *   prompt: "A futuristic cityscape at sunset",
+ * });
+ *
+ * // Video generation
+ * const { status, files: videoFiles } = await ai.video({
+ *   model:  "veo-2.0-generate-001",
+ *   prompt: "A dog running on a beach",
+ *   durationSeconds: 5,
+ * });
+ *
+ * // Embeddings
+ * const { embeddings } = await ai.embedding({
+ *   model: "text-embedding-004",
+ *   input: ["Hello", "World"],
+ * });
+ */
+export declare function getAI(app?: ClefbaseApp): ClefbaseAI;
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAS,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAO,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAI,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAI,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IAErD,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,UAAU,CAAgC;gBAEtC,MAAM,EAAE,cAAc;IAalC,gBAAgB;IAChB,MAAM,IAAI,QAAQ;IAKlB,gBAAgB;IAChB,QAAQ,IAAI,IAAI;IAKhB,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,aAAa,IAAI,iBAAiB;CAKnC;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,MAAgB,GACrB,WAAW,CAKb;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAgB,GAAG,WAAW,CAQ1D;AAID,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,QAAQ,CAEvD;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/C;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAEjE"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAS,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAO,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAI,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAI,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IACrD,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAS,UAAU,CAAC;IAErD,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,GAAG,CAAuC;gBAEtC,MAAM,EAAE,cAAc;IAclC,gBAAgB;IAChB,MAAM,IAAI,QAAQ;IAKlB,gBAAgB;IAChB,QAAQ,IAAI,IAAI;IAKhB,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,aAAa,IAAI,iBAAiB;IAMlC,gBAAgB;IAChB,MAAM,IAAI,UAAU;CAKrB;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,MAAgB,GACrB,WAAW,CAKb;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAgB,GAAG,WAAW,CAQ1D;AAID,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,QAAQ,CAEvD;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/C;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,UAAU,CAEnD"}

package/dist/app.js

@@ -8,12 +8,14 @@ exports.getAuth = getAuth;
 exports.getStorage = getStorage;
 exports.getHosting = getHosting;
 exports.getFunctions = getFunctions;
+exports.getAI = getAI;
 const http_1 = require("./http");
 const db_1 = require("./db");
 const auth_1 = require("./auth");
 const storage_1 = require("./storage");
 const hosting_1 = require("./hosting");
 const functions_1 = require("./functions");
+const ai_1 = require("./ai");
 // ─── App ──────────────────────────────────────────────────────────────────────
 /**
  * A Clefbase application instance.
@@ -30,6 +32,7 @@ class ClefbaseApp {
         this._storageHttp = new http_1.HttpClient(`${base}/storage`, cfxKey);
         this._hostingHttp = new http_1.HttpClient(`${base}/api/hosting`, admin);
         this._functionsHttp = new http_1.HttpClient(`${base}/functions`, cfxKey);
+        this._aiHttp = new http_1.HttpClient(`${base}/ai`, cfxKey);
     }
     /** @internal */
     _getDb() {
@@ -61,6 +64,12 @@ class ClefbaseApp {
             this._functions = new functions_1.ClefbaseFunctions(this._functionsHttp);
         return this._functions;
     }
+    /** @internal */
+    _getAI() {
+        if (!this._ai)
+            this._ai = new ai_1.ClefbaseAI(this._aiHttp);
+        return this._ai;
+    }
 }
 exports.ClefbaseApp = ClefbaseApp;
 // ─── Registry ─────────────────────────────────────────────────────────────────
@@ -125,4 +134,41 @@ function getHosting(app) {
 function getFunctions(app) {
     return (app ?? getApp())._getFunctions();
 }
+/**
+ * Get the AI service.
+ *
+ * @example
+ * import { initClefbase, getAI } from "clefbase";
+ *
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
+ * const ai  = getAI(app);
+ *
+ * // Text generation
+ * const { content } = await ai.text({
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Explain closures in JavaScript",
+ * });
+ *
+ * // Image generation — saved to project Storage automatically
+ * const { files } = await ai.image({
+ *   model:  "imagen-3.0-generate-002",
+ *   prompt: "A futuristic cityscape at sunset",
+ * });
+ *
+ * // Video generation
+ * const { status, files: videoFiles } = await ai.video({
+ *   model:  "veo-2.0-generate-001",
+ *   prompt: "A dog running on a beach",
+ *   durationSeconds: 5,
+ * });
+ *
+ * // Embeddings
+ * const { embeddings } = await ai.embedding({
+ *   model: "text-embedding-004",
+ *   input: ["Hello", "World"],
+ * });
+ */
+function getAI(app) {
+    return (app ?? getApp())._getAI();
+}
 //# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/cli.js

@@ -34878,7 +34878,7 @@ async function promptRequired(message) {
 }
 
 // package.json
-var version = "1.5.3";
+var version = "2.0.0";
 
 // src/cli/index.ts
 var program2 = new Command();

package/dist/index.d.ts

@@ -4,58 +4,94 @@
  * @example
  * import {
  *   initClefbase, getDatabase, getAuth, getStorage, getHosting,
- *   getFunctions, httpsCallable, callFunction, deployFunction, deployFromFile,
- *   setAuthToken, FunctionsError, FieldValue,
+ *   getFunctions, getAI,
+ *   httpsCallable, callFunction, deployFunction, deployFromFile,
+ *   generateText, generateImage, generateVideo, generateEmbedding,
+ *   setAuthToken, FunctionsError, AIError, FieldValue,
  * } from "clefbase";
  *
- * const app  = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
- * const fns  = getFunctions(app);
- * const auth = getAuth(app);
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
  *
- * // ── Auth-aware function call ───────────────────────────────────────────────
+ * // ── Auth ──────────────────────────────────────────────────────────────────
+ * const auth = getAuth(app);
  * const { token } = await auth.signIn("alice@example.com", "password123");
- * setAuthToken(app, token);    // ctx.auth.uid / email now available in function
  *
- * // ── Typed callable ────────────────────────────────────────────────────────
+ * // ── Database ──────────────────────────────────────────────────────────────
+ * const db = getDatabase(app);
+ * await db.collection("posts").doc("p1").update({
+ *   views:       FieldValue.increment(1),
+ *   publishedAt: FieldValue.serverTimestamp(),
+ * });
+ *
+ * // ── Storage ───────────────────────────────────────────────────────────────
+ * const storage = getStorage(app);
+ * const url = await storage.ref("avatars/user-123.jpg").getDownloadURL();
+ *
+ * // ── Functions ─────────────────────────────────────────────────────────────
+ * const fns   = getFunctions(app);
  * const greet = httpsCallable<{ name: string }, { message: string }>(fns, "greetUser");
  * const { data } = await greet({ name: "Alice" });
  *
- * // ── One-shot call ─────────────────────────────────────────────────────────
- * const { data } = await callFunction(fns, "greetUser", { name: "Bob" });
+ * // ── AI — text / code ──────────────────────────────────────────────────────
+ * const ai = getAI(app);
  *
- * // ── Deploy from source ────────────────────────────────────────────────────
- * await deployFunction(fns, {
- *   name:    "greetUser",
- *   runtime: "node",
- *   trigger: { type: "http" },
- *   source:  `export async function handler(ctx) { return { message: "Hi " + ctx.data.name }; }`,
+ * const { content } = await ai.text({
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Explain async/await in JavaScript",
  * });
  *
- * // ── Deploy from file (Node.js) ────────────────────────────────────────────
- * await deployFromFile(fns, {
- *   name:     "processOrder",
- *   runtime:  "node",
- *   trigger:  { type: "http" },
- *   filePath: "./src/functions/processOrder.ts",
+ * // Multi-turn chat
+ * const reply = await ai.text({
+ *   model:        "gemini-2.5-flash",
+ *   prompt:       "Give me a harder example",
+ *   systemPrompt: "You are a JavaScript tutor.",
+ *   history:      [{ role: "user", content: "Explain closures" }, { role: "assistant", content: "..." }],
  * });
  *
- * // ── Error handling ────────────────────────────────────────────────────────
- * try {
- *   await callFunction(fns, "mayFail");
- * } catch (err) {
- *   if (err instanceof FunctionsError) {
- *     console.error(err.httpStatus, err.message);
- *   }
- * }
+ * // ── AI — image generation (auto-saved to Storage) ─────────────────────────
+ * const { files } = await ai.image({
+ *   model:          "imagen-4.0-generate-001",
+ *   prompt:         "A serene mountain lake at dawn, photorealistic",
+ *   aspectRatio:    "16:9",
+ *   numberOfImages: 2,
+ *   outputFolder:   "landscapes",
+ * });
+ * // files[].fullPath      → path in project Storage
+ * // files[].storageFileId → use with storage.ref() to get the download URL
  *
- * // ── Database ──────────────────────────────────────────────────────────────
- * const db = getDatabase(app);
- * await db.collection("posts").doc("p1").update({
- *   views:       FieldValue.increment(1),
- *   publishedAt: FieldValue.serverTimestamp(),
+ * // ── AI — video generation (auto-saved to Storage) ─────────────────────────
+ * const { status, files: clips } = await ai.video({
+ *   model:           "veo-3.1-generate-preview",
+ *   prompt:          "A slow-motion waterfall in a rainforest",
+ *   durationSeconds: 8,
+ *   aspectRatio:     "16:9",
+ * });
+ *
+ * // ── AI — embeddings ───────────────────────────────────────────────────────
+ * const { embeddings } = await ai.embedding({
+ *   model: "gemini-embedding-001",
+ *   input: ["Hello world", "Semantic search"],
+ * });
+ *
+ * // ── AI — browse models ────────────────────────────────────────────────────
+ * const imageModels = await ai.listModels({ category: "image" });
+ * const allModels   = await ai.listModels();
+ *
+ * // ── AI — usage stats ──────────────────────────────────────────────────────
+ * const stats   = await ai.getStats();
+ * const history = await ai.getUsage({ limit: 20 });
+ *
+ * // ── AI — convenience top-level functions ──────────────────────────────────
+ * const { content: code } = await generateText(ai, {
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Write a merge sort in TypeScript",
+ * });
+ * const { files: imgs } = await generateImage(ai, {
+ *   model:  "imagen-4.0-fast-generate-001",
+ *   prompt: "A cute cartoon robot",
  * });
  */
-export { ClefbaseApp, initClefbase, getApp, getDatabase, getAuth, getStorage, getHosting, getFunctions, } from "./app";
+export { ClefbaseApp, initClefbase, getApp, getDatabase, getAuth, getStorage, getHosting, getFunctions, getAI, } from "./app";
 export { Database, CollectionReference, CollectionGroup, DocumentReference, Query, WriteBatch, Transaction, runTransaction, } from "./db";
 export { Auth } from "./auth";
 export type { GoogleButtonOptions } from "./auth";
@@ -67,6 +103,8 @@ export { ClefbaseHosting, SiteReference } from "./hosting";
 export type { HostingSite, HostingDeploy, HostingFile, DeployResult, DeployOptions, HostingStatus, DeployStatus, } from "./hosting";
 export { ClefbaseFunctions, FunctionsError, httpsCallable, callFunction, deployFunction, deleteFunction, listFunctions, getFunctionExecutions, setAuthToken, deployFromFile, } from "./functions";
 export type { FunctionRuntime, FunctionTrigger, FunctionTriggerType, FunctionDef, FunctionExecution, FunctionsConfig, FunctionStats, DeployFunctionOptions, HttpsCallableResult, } from "./functions";
+export { ClefbaseAI, AIError, generateText, generateImage, generateVideo, generateEmbedding, } from "./ai";
+export type { AIModel, AIProvider, AIModelCategory, GenerateTextOptions, GenerateTextResult, GenerateImageOptions, GenerateImageResult, GeneratedMediaFile, GenerateVideoOptions, GenerateVideoResult, GenerateEmbeddingOptions, GenerateEmbeddingResult, AIUsageRecord, AIUsageStats, } from "./ai";
 export { FieldValue, FieldValueSentinel } from "./field_value";
 export type { FieldValueType } from "./field_value";
 export type { ClefbaseConfig, ClefbaseDocument, QueryOptions, QueryResult, FilterOperator, WhereClause, WhereValue, AuthUser, AuthSession, AuthResult, } from "./types";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,MAAM,EACN,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,iBAAiB,EAEjB,cAAc,EAEd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,MAAM,EACN,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,YAAY,EACZ,KAAK,GACN,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,iBAAiB,EAEjB,cAAc,EAEd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,UAAU,EAEV,OAAO,EAEP,YAAY,EACZ,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,MAAM,CAAC;AAEd,YAAY,EAEV,OAAO,EACP,UAAU,EACV,eAAe,EAEf,mBAAmB,EACnB,kBAAkB,EAElB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAElB,oBAAoB,EACpB,mBAAmB,EAEnB,wBAAwB,EACxB,uBAAuB,EAEvB,aAAa,EACb,YAAY,GACb,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -5,59 +5,95 @@
  * @example
  * import {
  *   initClefbase, getDatabase, getAuth, getStorage, getHosting,
- *   getFunctions, httpsCallable, callFunction, deployFunction, deployFromFile,
- *   setAuthToken, FunctionsError, FieldValue,
+ *   getFunctions, getAI,
+ *   httpsCallable, callFunction, deployFunction, deployFromFile,
+ *   generateText, generateImage, generateVideo, generateEmbedding,
+ *   setAuthToken, FunctionsError, AIError, FieldValue,
  * } from "clefbase";
  *
- * const app  = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
- * const fns  = getFunctions(app);
- * const auth = getAuth(app);
+ * const app = initClefbase({ serverUrl, projectId, apiKey, adminSecret: "" });
  *
- * // ── Auth-aware function call ───────────────────────────────────────────────
+ * // ── Auth ──────────────────────────────────────────────────────────────────
+ * const auth = getAuth(app);
  * const { token } = await auth.signIn("alice@example.com", "password123");
- * setAuthToken(app, token);    // ctx.auth.uid / email now available in function
  *
- * // ── Typed callable ────────────────────────────────────────────────────────
+ * // ── Database ──────────────────────────────────────────────────────────────
+ * const db = getDatabase(app);
+ * await db.collection("posts").doc("p1").update({
+ *   views:       FieldValue.increment(1),
+ *   publishedAt: FieldValue.serverTimestamp(),
+ * });
+ *
+ * // ── Storage ───────────────────────────────────────────────────────────────
+ * const storage = getStorage(app);
+ * const url = await storage.ref("avatars/user-123.jpg").getDownloadURL();
+ *
+ * // ── Functions ─────────────────────────────────────────────────────────────
+ * const fns   = getFunctions(app);
  * const greet = httpsCallable<{ name: string }, { message: string }>(fns, "greetUser");
  * const { data } = await greet({ name: "Alice" });
  *
- * // ── One-shot call ─────────────────────────────────────────────────────────
- * const { data } = await callFunction(fns, "greetUser", { name: "Bob" });
+ * // ── AI — text / code ──────────────────────────────────────────────────────
+ * const ai = getAI(app);
  *
- * // ── Deploy from source ────────────────────────────────────────────────────
- * await deployFunction(fns, {
- *   name:    "greetUser",
- *   runtime: "node",
- *   trigger: { type: "http" },
- *   source:  `export async function handler(ctx) { return { message: "Hi " + ctx.data.name }; }`,
+ * const { content } = await ai.text({
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Explain async/await in JavaScript",
  * });
  *
- * // ── Deploy from file (Node.js) ────────────────────────────────────────────
- * await deployFromFile(fns, {
- *   name:     "processOrder",
- *   runtime:  "node",
- *   trigger:  { type: "http" },
- *   filePath: "./src/functions/processOrder.ts",
+ * // Multi-turn chat
+ * const reply = await ai.text({
+ *   model:        "gemini-2.5-flash",
+ *   prompt:       "Give me a harder example",
+ *   systemPrompt: "You are a JavaScript tutor.",
+ *   history:      [{ role: "user", content: "Explain closures" }, { role: "assistant", content: "..." }],
  * });
  *
- * // ── Error handling ────────────────────────────────────────────────────────
- * try {
- *   await callFunction(fns, "mayFail");
- * } catch (err) {
- *   if (err instanceof FunctionsError) {
- *     console.error(err.httpStatus, err.message);
- *   }
- * }
+ * // ── AI — image generation (auto-saved to Storage) ─────────────────────────
+ * const { files } = await ai.image({
+ *   model:          "imagen-4.0-generate-001",
+ *   prompt:         "A serene mountain lake at dawn, photorealistic",
+ *   aspectRatio:    "16:9",
+ *   numberOfImages: 2,
+ *   outputFolder:   "landscapes",
+ * });
+ * // files[].fullPath      → path in project Storage
+ * // files[].storageFileId → use with storage.ref() to get the download URL
  *
- * // ── Database ──────────────────────────────────────────────────────────────
- * const db = getDatabase(app);
- * await db.collection("posts").doc("p1").update({
- *   views:       FieldValue.increment(1),
- *   publishedAt: FieldValue.serverTimestamp(),
+ * // ── AI — video generation (auto-saved to Storage) ─────────────────────────
+ * const { status, files: clips } = await ai.video({
+ *   model:           "veo-3.1-generate-preview",
+ *   prompt:          "A slow-motion waterfall in a rainforest",
+ *   durationSeconds: 8,
+ *   aspectRatio:     "16:9",
+ * });
+ *
+ * // ── AI — embeddings ───────────────────────────────────────────────────────
+ * const { embeddings } = await ai.embedding({
+ *   model: "gemini-embedding-001",
+ *   input: ["Hello world", "Semantic search"],
+ * });
+ *
+ * // ── AI — browse models ────────────────────────────────────────────────────
+ * const imageModels = await ai.listModels({ category: "image" });
+ * const allModels   = await ai.listModels();
+ *
+ * // ── AI — usage stats ──────────────────────────────────────────────────────
+ * const stats   = await ai.getStats();
+ * const history = await ai.getUsage({ limit: 20 });
+ *
+ * // ── AI — convenience top-level functions ──────────────────────────────────
+ * const { content: code } = await generateText(ai, {
+ *   model:  "claude-sonnet-4-5",
+ *   prompt: "Write a merge sort in TypeScript",
+ * });
+ * const { files: imgs } = await generateImage(ai, {
+ *   model:  "imagen-4.0-fast-generate-001",
+ *   prompt: "A cute cartoon robot",
  * });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClefbaseError = exports.FieldValueSentinel = exports.FieldValue = exports.deployFromFile = exports.setAuthToken = exports.getFunctionExecutions = exports.listFunctions = exports.deleteFunction = exports.deployFunction = exports.callFunction = exports.httpsCallable = exports.FunctionsError = exports.ClefbaseFunctions = exports.SiteReference = exports.ClefbaseHosting = exports.EmailVerificationCard = exports.BucketReference = exports.StorageReference = exports.ClefbaseStorage = exports.Auth = exports.runTransaction = exports.Transaction = exports.WriteBatch = exports.Query = exports.DocumentReference = exports.CollectionGroup = exports.CollectionReference = exports.Database = exports.getFunctions = exports.getHosting = exports.getStorage = exports.getAuth = exports.getDatabase = exports.getApp = exports.initClefbase = exports.ClefbaseApp = void 0;
+exports.ClefbaseError = exports.FieldValueSentinel = exports.FieldValue = exports.generateEmbedding = exports.generateVideo = exports.generateImage = exports.generateText = exports.AIError = exports.ClefbaseAI = exports.deployFromFile = exports.setAuthToken = exports.getFunctionExecutions = exports.listFunctions = exports.deleteFunction = exports.deployFunction = exports.callFunction = exports.httpsCallable = exports.FunctionsError = exports.ClefbaseFunctions = exports.SiteReference = exports.ClefbaseHosting = exports.EmailVerificationCard = exports.BucketReference = exports.StorageReference = exports.ClefbaseStorage = exports.Auth = exports.runTransaction = exports.Transaction = exports.WriteBatch = exports.Query = exports.DocumentReference = exports.CollectionGroup = exports.CollectionReference = exports.Database = exports.getAI = exports.getFunctions = exports.getHosting = exports.getStorage = exports.getAuth = exports.getDatabase = exports.getApp = exports.initClefbase = exports.ClefbaseApp = void 0;
 // ─── App ──────────────────────────────────────────────────────────────────────
 var app_1 = require("./app");
 Object.defineProperty(exports, "ClefbaseApp", { enumerable: true, get: function () { return app_1.ClefbaseApp; } });
@@ -68,6 +104,7 @@ Object.defineProperty(exports, "getAuth", { enumerable: true, get: function () {
 Object.defineProperty(exports, "getStorage", { enumerable: true, get: function () { return app_1.getStorage; } });
 Object.defineProperty(exports, "getHosting", { enumerable: true, get: function () { return app_1.getHosting; } });
 Object.defineProperty(exports, "getFunctions", { enumerable: true, get: function () { return app_1.getFunctions; } });
+Object.defineProperty(exports, "getAI", { enumerable: true, get: function () { return app_1.getAI; } });
 // ─── Database ─────────────────────────────────────────────────────────────────
 var db_1 = require("./db");
 Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return db_1.Database; } });
@@ -99,7 +136,7 @@ var functions_1 = require("./functions");
 Object.defineProperty(exports, "ClefbaseFunctions", { enumerable: true, get: function () { return functions_1.ClefbaseFunctions; } });
 // Error
 Object.defineProperty(exports, "FunctionsError", { enumerable: true, get: function () { return functions_1.FunctionsError; } });
-// Top-level factory / convenience (mirrors the standalone SDK's API shape)
+// Top-level factory / convenience
 Object.defineProperty(exports, "httpsCallable", { enumerable: true, get: function () { return functions_1.httpsCallable; } });
 Object.defineProperty(exports, "callFunction", { enumerable: true, get: function () { return functions_1.callFunction; } });
 Object.defineProperty(exports, "deployFunction", { enumerable: true, get: function () { return functions_1.deployFunction; } });
@@ -108,6 +145,17 @@ Object.defineProperty(exports, "listFunctions", { enumerable: true, get: functio
 Object.defineProperty(exports, "getFunctionExecutions", { enumerable: true, get: function () { return functions_1.getFunctionExecutions; } });
 Object.defineProperty(exports, "setAuthToken", { enumerable: true, get: function () { return functions_1.setAuthToken; } });
 Object.defineProperty(exports, "deployFromFile", { enumerable: true, get: function () { return functions_1.deployFromFile; } });
+// ─── AI ───────────────────────────────────────────────────────────────────────
+var ai_1 = require("./ai");
+// Class
+Object.defineProperty(exports, "ClefbaseAI", { enumerable: true, get: function () { return ai_1.ClefbaseAI; } });
+// Error
+Object.defineProperty(exports, "AIError", { enumerable: true, get: function () { return ai_1.AIError; } });
+// Top-level convenience functions
+Object.defineProperty(exports, "generateText", { enumerable: true, get: function () { return ai_1.generateText; } });
+Object.defineProperty(exports, "generateImage", { enumerable: true, get: function () { return ai_1.generateImage; } });
+Object.defineProperty(exports, "generateVideo", { enumerable: true, get: function () { return ai_1.generateVideo; } });
+Object.defineProperty(exports, "generateEmbedding", { enumerable: true, get: function () { return ai_1.generateEmbedding; } });
 // ─── FieldValue ───────────────────────────────────────────────────────────────
 var field_value_1 = require("./field_value");
 Object.defineProperty(exports, "FieldValue", { enumerable: true, get: function () { return field_value_1.FieldValue; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;;;AAEH,iFAAiF;AACjF,6BASe;AARb,kGAAA,WAAW,OAAA;AACX,mGAAA,YAAY,OAAA;AACZ,6FAAA,MAAM,OAAA;AACN,kGAAA,WAAW,OAAA;AACX,8FAAA,OAAO,OAAA;AACP,iGAAA,UAAU,OAAA;AACV,iGAAA,UAAU,OAAA;AACV,mGAAA,YAAY,OAAA;AAGd,iFAAiF;AACjF,2BASc;AARZ,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,uGAAA,iBAAiB,OAAA;AACjB,2FAAA,KAAK,OAAA;AACL,gGAAA,UAAU,OAAA;AACV,iGAAA,WAAW,OAAA;AACX,oGAAA,cAAc,OAAA;AAGhB,iFAAiF;AACjF,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAGb,iFAAiF;AACjF,qCAA+E;AAAtE,0GAAA,eAAe,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAM3D,iFAAiF;AACjF,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAE9B,iFAAiF;AACjF,qCAA2D;AAAlD,0GAAA,eAAe,OAAA;AAAE,wGAAA,aAAa,OAAA;AAWvC,iFAAiF;AACjF,yCAcqB;AAbnB,QAAQ;AACR,8GAAA,iBAAiB,OAAA;AACjB,QAAQ;AACR,2GAAA,cAAc,OAAA;AACd,2EAA2E;AAC3E,0GAAA,aAAa,OAAA;AACb,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,kHAAA,qBAAqB,OAAA;AACrB,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AAehB,iFAAiF;AACjF,6CAA+D;AAAtD,yGAAA,UAAU,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAiBvC,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;;;AAEH,iFAAiF;AACjF,6BAUe;AATb,kGAAA,WAAW,OAAA;AACX,mGAAA,YAAY,OAAA;AACZ,6FAAA,MAAM,OAAA;AACN,kGAAA,WAAW,OAAA;AACX,8FAAA,OAAO,OAAA;AACP,iGAAA,UAAU,OAAA;AACV,iGAAA,UAAU,OAAA;AACV,mGAAA,YAAY,OAAA;AACZ,4FAAA,KAAK,OAAA;AAGP,iFAAiF;AACjF,2BASc;AARZ,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,uGAAA,iBAAiB,OAAA;AACjB,2FAAA,KAAK,OAAA;AACL,gGAAA,UAAU,OAAA;AACV,iGAAA,WAAW,OAAA;AACX,oGAAA,cAAc,OAAA;AAGhB,iFAAiF;AACjF,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAGb,iFAAiF;AACjF,qCAA+E;AAAtE,0GAAA,eAAe,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAM3D,iFAAiF;AACjF,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAE9B,iFAAiF;AACjF,qCAA2D;AAAlD,0GAAA,eAAe,OAAA;AAAE,wGAAA,aAAa,OAAA;AAWvC,iFAAiF;AACjF,yCAcqB;AAbnB,QAAQ;AACR,8GAAA,iBAAiB,OAAA;AACjB,QAAQ;AACR,2GAAA,cAAc,OAAA;AACd,kCAAkC;AAClC,0GAAA,aAAa,OAAA;AACb,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,kHAAA,qBAAqB,OAAA;AACrB,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AAehB,iFAAiF;AACjF,2BAUc;AATZ,QAAQ;AACR,gGAAA,UAAU,OAAA;AACV,QAAQ;AACR,6FAAA,OAAO,OAAA;AACP,kCAAkC;AAClC,kGAAA,YAAY,OAAA;AACZ,mGAAA,aAAa,OAAA;AACb,mGAAA,aAAa,OAAA;AACb,uGAAA,iBAAiB,OAAA;AA0BnB,iFAAiF;AACjF,6CAA+D;AAAtD,yGAAA,UAAU,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAiBvC,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clefbase",
-  "version": "1.5.3",
+  "version": "2.0.0",
   "description": "Firebase-style SDK and CLI for Clefbase — database, auth, storage, hosting, and functions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",