@base44-preview/sdk 0.8.52-pr.297.c6f2448 → 0.8.52-pr.297.e5cedd8

package/dist/modules/ai-gateway.types.d.ts

@@ -51,15 +51,15 @@ export interface AiGatewayModuleConfig {
  * against the provider directly, no separate account, API key, or billing
  * setup with the underlying model provider required.
  *
- * By default, `connection()` uses the OpenAI-compatible provider, which serves
- * chat, images, and videos. Pass `{ provider: "typesafe" }` for
- * structured evaluations.
+ * `connection()` takes an optional `provider`, and each provider serves a different API:
+ *
+ * - `openai` (default): OpenAI-compatible chat completions and image endpoints.
+ * - `typesafe`: structured evaluations with the `jev` model.
  *
  * Call `connection()` from a backend function rather than the browser. This
  * keeps your instructions, tools, and business logic server-side, and lets
- * you enforce your own auth, rate, and spend limits around the call. The
- * `token` it returns is the caller's regular session token, the same one
- * used for every other SDK call.
+ * you enforce your own auth, rate, and spend limits around the call. Which
+ * token it returns depends on the authentication mode, described below.
  *
  * ## OpenAI-compatible models
  *
@@ -76,33 +76,23 @@ export interface AiGatewayModuleConfig {
  * `'gemini_3_1_flash_image'` or `'gpt_image_2'`. For request options, the
  * full model list, and limits, see [Generate images with the AI Gateway](/developers/references/sdk/getting-started/ai-gateway-images).
  *
- * ## Videos
- *
- * The gateway serves OpenAI's asynchronous video endpoints through the
- * `openai` SDK's `videos` client. `videos.create()` starts a job and returns
- * its `id` right away; call `videos.retrieve(id)` until `status` is
- * `completed` or `failed`. A completed job exposes the stored video at `url`.
- * A backend function is a bounded HTTP call, so don't poll inside one: return
- * the `id`, then retrieve it from a later call or scheduled run. Video
- * requests need a specific model, such as `'veo_3_1_fast'` or
- * `'seedance_2_fast'`; there's no `'automatic'` option.
- *
  * ## Structured evaluations
  *
  * The `typesafe` provider runs the `jev` evaluation model through
- * `@ai-sdk/typesafe-ai` and the `ai` package's `experimental_evaluate`. Give
- * it some app state and a set of questions, each a `choice`, `score`, or
- * `boolean`, and it returns each answer with its probabilities. Use it
- * to classify, score, or route records, then apply your own thresholds and
- * actions in code.
+ * `@ai-sdk/typesafe-ai` and `experimental_evaluate` from the `ai` package,
+ * version 7.0.105 or later. Pass `evaluationModel("jev")`; the gateway rejects
+ * other model IDs, such as `"jev-latest"`. Give it some app state and a set of
+ * questions, each a `choice`, `score`, or `boolean`. Choice and score answers
+ * come back with `probabilities` per option; boolean answers with a single
+ * `probability` of `true`. Use it to classify, score, or route records, then
+ * apply your own thresholds and actions in code.
  *
  * ## Authentication Modes
  *
- * There's no permission difference between modes. Both just determine which
- * token `connection()` returns:
+ * The mode determines which token `connection()` returns:
  *
  * - **User authentication** (`base44.aiGateway`): Returns the signed-in app user's token.
- * - **Service role authentication** (`base44.asServiceRole.aiGateway`): Returns the service-role token instead, for calling the gateway when there's no signed-in user, such as from a scheduled automation.
+ * - **Service role authentication** (`base44.asServiceRole.aiGateway`): Returns the service-role token instead. Use it from backend functions: apps that restrict Core integrations, the default for new apps, reject user-token gateway calls on public apps. It also works when there's no signed-in user, such as from a scheduled automation.
  *
  * ## Billing and limits
  *
@@ -131,7 +121,7 @@ export interface AiGatewayModule {
      *
      * // Runs inside a backend function
      * const base44 = createClientFromRequest(request);
-     * const { baseURL, token, headers } = base44.aiGateway.connection();
+     * const { baseURL, token, headers } = base44.asServiceRole.aiGateway.connection();
      * const openai = new OpenAI({ baseURL, apiKey: token, defaultHeaders: headers });
      *
      * const response = await openai.chat.completions.create({
@@ -153,7 +143,7 @@ export interface AiGatewayModule {
      * // Runs inside a backend function, reviewing a return request
      * const base44 = createClientFromRequest(request);
      * const returnRequest = await base44.entities.ReturnRequest.get(returnId);
-     * const { baseURL, token, headers } = base44.aiGateway.connection();
+     * const { baseURL, token, headers } = base44.asServiceRole.aiGateway.connection();
      * // Point any OpenAI-compatible client at `baseURL` with `apiKey: token` and `headers`.
      * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token, headers });
      *
@@ -194,7 +184,7 @@ export interface AiGatewayModule {
      *
      * // Runs inside a backend function
      * const base44 = createClientFromRequest(request);
-     * const { baseURL, token, headers } = base44.aiGateway.connection();
+     * const { baseURL, token, headers } = base44.asServiceRole.aiGateway.connection();
      * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token, headers });
      *
      * const { image } = await generateImage({
@@ -210,32 +200,6 @@ export interface AiGatewayModule {
      *
      * @example
      * ```typescript
-     * // Start a video job, then check on it from a later call
-     * import { createClientFromRequest } from "@base44/sdk";
-     * import OpenAI from "openai";
-     *
-     * // Runs inside a backend function
-     * const base44 = createClientFromRequest(request);
-     * const { baseURL, token, headers } = base44.aiGateway.connection();
-     * const { videos } = new OpenAI({ baseURL, apiKey: token, defaultHeaders: headers });
-     *
-     * const { videoId } = await request.json();
-     * if (!videoId) {
-     *   // Avoid automatic replays of billed requests
-     *   const job = await videos.create(
-     *     { model: "veo_3_1_fast", prompt: "A paper boat drifting down a rainy street", seconds: "4" },
-     *     { maxRetries: 0 },
-     *   );
-     *   return Response.json({ videoId: job.id, status: job.status }, { status: 202 });
-     * }
-     *
-     * const video = await videos.retrieve(videoId);
-     * // `queued` and `in_progress` mean unfinished; `url` is set once `completed`
-     * return Response.json(video);
-     * ```
-     *
-     * @example
-     * ```typescript
      * // Route a support ticket with a structured evaluation
      * import { createClientFromRequest } from "@base44/sdk";
      * import { experimental_evaluate as evaluate } from "ai";
@@ -243,12 +207,12 @@ export interface AiGatewayModule {
      *
      * // Runs inside a backend function
      * const base44 = createClientFromRequest(request);
-     * const { baseURL, token, headers } = base44.aiGateway.connection({ provider: "typesafe" });
+     * const { baseURL, token, headers } = base44.asServiceRole.aiGateway.connection({ provider: "typesafe" });
      * const typesafe = createTypeSafeAi({ baseURL, apiKey: token, headers });
      *
-     * const { answers } = await evaluate({
+     * const { answers, providerMetadata } = await evaluate({
      *   model: typesafe.evaluationModel("jev"),
-     *   maxRetries: 0,
+     *   maxRetries: 0, // Avoid automatic replays of billed requests
      *   state: { message: "Please refund today's duplicate charge." },
      *   questions: {
      *     department: {
@@ -268,6 +232,7 @@ export interface AiGatewayModule {
      * // answers.department → { type: "choice", choice: "billing", probabilities: { billing: 0.97, support: 0.03 } }
      * // answers.urgency    → { type: "score", score: 1.2, probabilities: { 0: 0.1, 1: 0.6, 2: 0.3 } }
      * // answers.refund     → { type: "boolean", probability: 0.99 }
+     * // Choice and score confidence is in providerMetadata.typesafe.confidence
      * // Pick your own thresholds and act on them in code
      * const autoRefund = answers.department.choice === "billing" && answers.refund.probability > 0.9;
      * ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.52-pr.297.c6f2448",
+  "version": "0.8.52-pr.297.e5cedd8",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,6 @@
   ],
   "scripts": {
     "build": "tsc",
-    "lint": "eslint src",
     "test": "npm run test:types && vitest run",
     "test:types": "tsc --noEmit -p tsconfig.type-tests.json",
     "test:unit": "vitest run tests/unit",
@@ -26,29 +25,11 @@
     "create-docs:process": "node scripts/mintlify-post-processing/file-processing/file-processing.js"
   },
   "dependencies": {
-    "axios": "^1.18.1",
+    "axios": "^1.20.0",
     "partysocket": "^0.0.23",
     "socket.io-client": "^4.8.3",
     "uuid": "^13.0.2"
   },
-  "devDependencies": {
-    "@types/hast": "^3.0.4",
-    "@types/node": "^25.0.1",
-    "@types/unist": "^3.0.3",
-    "@typescript-eslint/parser": "^8.51.0",
-    "@vitest/coverage-istanbul": "^4.1.9",
-    "@vitest/coverage-v8": "^4.1.9",
-    "@vitest/ui": "^4.1.9",
-    "dotenv": "^16.3.1",
-    "eslint": "^9.39.2",
-    "eslint-plugin-import": "^2.32.0",
-    "nock": "^13.4.0",
-    "typedoc": "^0.28.14",
-    "typedoc-plugin-markdown": "^4.9.0",
-    "typescript": "^5.3.2",
-    "typescript-eslint": "^8.51.0",
-    "vitest": "^4.1.9"
-  },
   "keywords": [
     "base44",
     "api",
@@ -58,10 +39,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/base44/javascript-sdk.git"
+    "url": "git+https://github.com/base44/javascript-sdk.git",
+    "directory": "packages/sdk"
   },
   "bugs": {
     "url": "https://github.com/base44/javascript-sdk/issues"
   },
-  "homepage": "https://github.com/base44/javascript-sdk#readme"
+  "homepage": "https://github.com/base44/javascript-sdk/tree/main/packages/sdk#readme"
 }