@lastbrain/ai-ui-core 1.0.3

package/dist/types/index.d.ts

@@ -0,0 +1,96 @@
+export interface ModelRef {
+    id: string;
+    name: string;
+    type: "text" | "language" | "image" | "embed";
+    provider: string;
+    tags?: string[];
+    pricing?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        imageTokens?: number;
+    };
+}
+export interface AiTextRequest {
+    model: string;
+    prompt: string;
+    context?: string;
+    editMode?: boolean;
+    inputValue?: string;
+    system?: string;
+    maxTokens?: number;
+    temperature?: number;
+    promptId?: string;
+    actionType?: "generate-text" | "generate-recipe-text" | "autocomplete";
+}
+export interface AiTextResponse {
+    text: string;
+    debitTokens: number;
+    requestId: string;
+}
+export interface AiImageRequest {
+    model: string;
+    prompt: string;
+    context?: string;
+    size?: string;
+    n?: number;
+    promptId?: string;
+}
+export interface AiImageResponse {
+    url: string;
+    debitTokens: number;
+    requestId: string;
+}
+export interface AiEmbedRequest {
+    model: string;
+    input: string;
+}
+export interface AiEmbedResponse {
+    embedding: number[];
+    embeddings?: number[][];
+    debitTokens?: number;
+    requestId?: string;
+}
+export interface AiStatus {
+    request_id: string;
+    api_key: {
+        id: string;
+        name: string;
+        prefix: string;
+        env: string;
+        scopes: string[];
+        rate_limit_rpm: number;
+        daily_token_limit: number | null;
+        created_at: string;
+    };
+    balance: {
+        purchased: number;
+        quota: number;
+        total: number;
+    };
+    quota: {
+        plan: string;
+        effective_quota: number;
+        used_quota: number;
+        remaining_quota: number;
+        period_start: string | null;
+        period_end: string | null;
+        is_active: boolean;
+    };
+    settings: {
+        mode: string;
+        max_tokens_per_call: number | null;
+    };
+    storage: {
+        db_mb: number;
+        files_mb: number;
+        total_mb: number;
+        allocated_mb: number;
+    };
+}
+export interface ClientConfig {
+    baseUrl: string;
+    apiKeyId: string;
+    timeout?: number;
+    retries?: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,eAAe,GAAG,sBAAsB,GAAG,cAAc,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@lastbrain/ai-ui-core",
+  "version": "1.0.3",
+  "description": "Framework-agnostic core library for LastBrain AI UI Kit",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./route-handlers/nextjs/gateway": {
+      "types": "./dist/route-handlers/nextjs/gateway.ts",
+      "import": "./dist/route-handlers/nextjs/gateway.ts",
+      "require": "./dist/route-handlers/nextjs/gateway.ts",
+      "default": "./dist/route-handlers/nextjs/gateway.ts"
+    }
+  },
+  "release": {
+    "type": "public"
+  },
+  "keywords": [
+    "ai",
+    "lastbrain",
+    "core",
+    "utilities",
+    "typescript",
+    "framework-agnostic"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lastpublication/starter.git",
+    "directory": "packages/ai-ui-core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "dev": "tsc -p tsconfig.json --watch",
+    "build": "tsc -p tsconfig.json && mkdir -p dist/route-handlers/nextjs && cp src/route-handlers/nextjs/gateway.ts dist/route-handlers/nextjs/gateway.ts",
+    "lint": "eslint ."
+  }
+}

package/src/client/createClient.ts

@@ -0,0 +1,241 @@
+import type {
+  ClientConfig,
+  ModelRef,
+  AiTextRequest,
+  AiTextResponse,
+  AiImageRequest,
+  AiImageResponse,
+  AiEmbedRequest,
+  AiEmbedResponse,
+  AiStatus,
+} from "../types";
+import { normalizeError } from "../errors/normalizeError";
+
+const DEFAULT_TIMEOUT = 60000;
+const DEFAULT_RETRIES = 3;
+const INITIAL_RETRY_DELAY = 1000;
+
+interface RetryConfig {
+  retries: number;
+  delay: number;
+}
+
+async function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function fetchWithRetry<T>(
+  url: string,
+  options: RequestInit,
+  retryConfig: RetryConfig
+): Promise<T> {
+  let lastError: any;
+
+  for (let attempt = 0; attempt <= retryConfig.retries; attempt++) {
+    try {
+      const response = await fetch(url, options);
+
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const error: any = new Error(
+          errorData.message || `HTTP ${response.status}`
+        );
+        error.status = response.status;
+        error.response = { status: response.status };
+        throw error;
+      }
+
+      return await response.json();
+    } catch (error: any) {
+      lastError = error;
+
+      const isRetryable =
+        error.name === "AbortError" ||
+        error.code === "ECONNREFUSED" ||
+        error.code === "ENOTFOUND" ||
+        error.message?.includes("fetch failed") ||
+        (error.status && error.status >= 500);
+
+      if (isRetryable && attempt < retryConfig.retries) {
+        const delay = retryConfig.delay * Math.pow(2, attempt);
+        await sleep(delay);
+        continue;
+      }
+
+      throw error;
+    }
+  }
+
+  throw lastError;
+}
+
+export function createClient(config: ClientConfig) {
+  const timeout = config.timeout ?? DEFAULT_TIMEOUT;
+  const retries = config.retries ?? DEFAULT_RETRIES;
+
+  function createHeaders(): Record<string, string> {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+    };
+    console.log("[APIKEY] config.apiKeyId:", config.apiKeyId);
+    if (config.apiKeyId) {
+      headers.Authorization = `Bearer ${config.apiKeyId}`;
+    }
+
+    return headers;
+  }
+
+  function createAbortSignal(): AbortSignal {
+    const controller = new AbortController();
+    setTimeout(() => controller.abort(), timeout);
+    return controller.signal;
+  }
+
+  async function getModels(): Promise<ModelRef[]> {
+    try {
+      const url = `${config.baseUrl}/provider`;
+      const response = await fetchWithRetry<any>(
+        url,
+        {
+          method: "GET",
+          headers: createHeaders(),
+          signal: createAbortSignal(),
+        },
+        { retries, delay: INITIAL_RETRY_DELAY }
+      );
+
+      // Transform response: extract all models from providers array
+      if (response.providers && Array.isArray(response.providers)) {
+        const allModels: ModelRef[] = [];
+        for (const provider of response.providers) {
+          if (provider.models && Array.isArray(provider.models)) {
+            allModels.push(...provider.models);
+          }
+        }
+        return allModels;
+      }
+
+      // Fallback: if response is already a flat array
+      if (Array.isArray(response)) {
+        return response;
+      }
+
+      return [];
+    } catch (error) {
+      throw normalizeError(error);
+    }
+  }
+
+  async function generateText(req: AiTextRequest): Promise<AiTextResponse> {
+    try {
+      const url = `${config.baseUrl}/text-ai`;
+      const response = await fetchWithRetry<AiTextResponse>(
+        url,
+        {
+          method: "POST",
+          headers: createHeaders(),
+          body: JSON.stringify(req),
+          signal: createAbortSignal(),
+        },
+        { retries, delay: INITIAL_RETRY_DELAY }
+      );
+
+      // Track prompt usage if promptId is provided
+      if (req.promptId) {
+        try {
+          await fetch(`${config.baseUrl}/track-usage`, {
+            method: "POST",
+            headers: createHeaders(),
+            body: JSON.stringify({ promptId: req.promptId }),
+          }).catch(() => {
+            // Silently fail - don't block the response
+          });
+        } catch (_error) {
+          // Ignore tracking errors
+        }
+      }
+
+      return response;
+    } catch (error) {
+      throw normalizeError(error);
+    }
+  }
+
+  async function generateImage(req: AiImageRequest): Promise<AiImageResponse> {
+    try {
+      const url = `${config.baseUrl}/image-ai`;
+      const response = await fetchWithRetry<AiImageResponse>(
+        url,
+        {
+          method: "POST",
+          headers: createHeaders(),
+          body: JSON.stringify(req),
+          signal: createAbortSignal(),
+        },
+        { retries, delay: INITIAL_RETRY_DELAY }
+      );
+
+      // Track prompt usage if promptId is provided
+      if (req.promptId) {
+        try {
+          await fetch(`${config.baseUrl}/track-usage`, {
+            method: "POST",
+            headers: createHeaders(),
+            body: JSON.stringify({ promptId: req.promptId }),
+          }).catch(() => {
+            // Silently fail - don't block the response
+          });
+        } catch (error) {
+          // Ignore tracking errors
+        }
+      }
+
+      return response;
+    } catch (error) {
+      throw normalizeError(error);
+    }
+  }
+
+  async function embed(req: AiEmbedRequest): Promise<AiEmbedResponse> {
+    try {
+      const url = `${config.baseUrl}/ai/embed`;
+      return await fetchWithRetry<AiEmbedResponse>(
+        url,
+        {
+          method: "POST",
+          headers: createHeaders(),
+          body: JSON.stringify(req),
+          signal: createAbortSignal(),
+        },
+        { retries, delay: INITIAL_RETRY_DELAY }
+      );
+    } catch (error) {
+      throw normalizeError(error);
+    }
+  }
+
+  async function getStatus(): Promise<AiStatus> {
+    try {
+      const url = `${config.baseUrl}/status`;
+      return await fetchWithRetry<AiStatus>(
+        url,
+        {
+          method: "GET",
+          headers: createHeaders(),
+          signal: createAbortSignal(),
+        },
+        { retries, delay: INITIAL_RETRY_DELAY }
+      );
+    } catch (error) {
+      throw normalizeError(error);
+    }
+  }
+
+  return {
+    getModels,
+    generateText,
+    generateImage,
+    embed,
+    getStatus,
+  };
+}

package/src/errors/errorCodes.ts

@@ -0,0 +1,12 @@
+export enum ErrorCode {
+  NO_API_KEY = "NO_API_KEY",
+  MODEL_DISABLED = "MODEL_DISABLED",
+  PRICING_UNAVAILABLE = "PRICING_UNAVAILABLE",
+  INSUFFICIENT_TOKENS = "INSUFFICIENT_TOKENS",
+  PROVIDER_DOWN = "PROVIDER_DOWN",
+  BAD_REQUEST = "BAD_REQUEST",
+  UNAUTHORIZED = "UNAUTHORIZED",
+  NETWORK_ERROR = "NETWORK_ERROR",
+  TIMEOUT = "TIMEOUT",
+  UNKNOWN = "UNKNOWN",
+}

package/src/errors/normalizeError.ts

@@ -0,0 +1,107 @@
+import { ErrorCode } from "./errorCodes";
+
+export interface NormalizedError {
+  code: ErrorCode;
+  message: string;
+  status?: number;
+}
+
+export function normalizeError(error: any): NormalizedError {
+  if (error?.name === "AbortError" || error?.message?.includes("timeout")) {
+    return {
+      code: ErrorCode.TIMEOUT,
+      message: "Request timeout",
+      status: 408,
+    };
+  }
+
+  if (
+    error?.code === "ENOTFOUND" ||
+    error?.code === "ECONNREFUSED" ||
+    error?.message?.includes("fetch failed")
+  ) {
+    return {
+      code: ErrorCode.NETWORK_ERROR,
+      message: "Network error",
+      status: 0,
+    };
+  }
+
+  const status = error?.status || error?.response?.status;
+
+  if (status === 401 || status === 403) {
+    return {
+      code: ErrorCode.UNAUTHORIZED,
+      message: error?.message || "Unauthorized",
+      status,
+    };
+  }
+
+  if (status === 400) {
+    return {
+      code: ErrorCode.BAD_REQUEST,
+      message: error?.message || "Bad request",
+      status,
+    };
+  }
+
+  if (status === 503) {
+    return {
+      code: ErrorCode.PROVIDER_DOWN,
+      message: error?.message || "Provider unavailable",
+      status,
+    };
+  }
+
+  const errorMessage = error?.message?.toLowerCase() || "";
+
+  if (
+    errorMessage.includes("no api key") ||
+    errorMessage.includes("api key required")
+  ) {
+    return {
+      code: ErrorCode.NO_API_KEY,
+      message: error?.message || "No API key provided",
+      status,
+    };
+  }
+
+  if (
+    errorMessage.includes("model disabled") ||
+    errorMessage.includes("model not available")
+  ) {
+    return {
+      code: ErrorCode.MODEL_DISABLED,
+      message: error?.message || "Model disabled",
+      status,
+    };
+  }
+
+  if (
+    errorMessage.includes("pricing unavailable") ||
+    errorMessage.includes("pricing not found")
+  ) {
+    return {
+      code: ErrorCode.PRICING_UNAVAILABLE,
+      message: error?.message || "Pricing unavailable",
+      status,
+    };
+  }
+
+  if (
+    errorMessage.includes("insufficient tokens") ||
+    errorMessage.includes("not enough tokens")
+  ) {
+    return {
+      code: ErrorCode.INSUFFICIENT_TOKENS,
+      message: error?.message || "Insufficient tokens",
+      status,
+    };
+  }
+
+  return {
+    code: ErrorCode.UNKNOWN,
+    message: error?.message || "Unknown error",
+    status,
+  };
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./errors/errorCodes";
+export * from "./errors/normalizeError";
+export * from "./client/createClient";

package/src/route-handlers/nextjs/gateway.ts

@@ -0,0 +1,93 @@
+import { NextRequest, NextResponse } from "next/server";
+
+/**
+ * Next.js App Router gateway for LastBrain AI API
+ *
+ * Usage in app/api/lastbrain/[...path]/route.ts:
+ * export { GET, POST } from "@lastbrain/ai-ui-core/route-handlers/nextjs/gateway";
+ *
+ * This proxies requests to https://ai.lastbrain.io/api/public/v1/[...path]
+ */
+
+const LB_API_KEY = process.env.LB_API_KEY;
+const LB_BASE_URL =
+  process.env.LB_BASE_URL || "https://ai.lastbrain.io/api/public/v1";
+
+if (!LB_API_KEY) {
+  console.warn(
+    "⚠️  LB_API_KEY not found in environment variables. AI features will not work."
+  );
+}
+
+async function handleRequest(
+  request: NextRequest,
+  context: { params: Promise<{ path: string[] }> }
+) {
+  if (!LB_API_KEY) {
+    return NextResponse.json(
+      { error: "LB_API_KEY not configured" },
+      { status: 500 }
+    );
+  }
+
+  const params = await context.params;
+  const rawPath = params.path.join("/");
+  // Remove leading slash to avoid double slash
+  const path = rawPath.startsWith("/") ? rawPath.slice(1) : rawPath;
+  const url = `${LB_BASE_URL}/${path}`;
+  console.log("[Gateway] Proxying to:", url);
+  console.log(
+    "[Gateway] Bearer token:",
+    LB_API_KEY ? `${LB_API_KEY.substring(0, 10)}...` : "MISSING"
+  );
+
+  try {
+    const headers: HeadersInit = {
+      Authorization: `Bearer ${LB_API_KEY}`,
+      "Content-Type": "application/json",
+    };
+
+    let body: string | undefined;
+    if (request.method === "POST") {
+      const json = await request.json();
+      body = JSON.stringify(json);
+    }
+
+    const response = await fetch(url, {
+      method: request.method,
+      headers,
+      body,
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      return NextResponse.json(
+        { error: errorText || "API request failed" },
+        { status: response.status }
+      );
+    }
+
+    const data = await response.json();
+    return NextResponse.json(data);
+  } catch (error) {
+    console.error("LastBrain API gateway error:", error);
+    return NextResponse.json(
+      { error: "Internal server error" },
+      { status: 500 }
+    );
+  }
+}
+
+export async function GET(
+  request: NextRequest,
+  context: { params: Promise<{ path: string[] }> }
+) {
+  return handleRequest(request, context);
+}
+
+export async function POST(
+  request: NextRequest,
+  context: { params: Promise<{ path: string[] }> }
+) {
+  return handleRequest(request, context);
+}