clefbase 1.5.2 → 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