@builder.io/ai-utils 0.86.0 → 0.86.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.86.0",
+  "version": "0.86.1",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -2911,7 +2911,7 @@ export type CodeGenInputOptions = z.infer<typeof CodeGenInputOptionsSchema> & {
      */
     _mcpClientWrapperFactory?: (realClient: any) => any;
 };
-export type CodeGenErrorCodes = "credits-limit-daily" | "credits-limit-monthly" | "credits-limit-user" | "credits-limit-other" | "cli-genetic-error" | "git-update-error" | "prompt-too-long" | "context-too-long" | "abrupt-end" | "unknown" | "failed-recover-state" | "completion-expired" | "ask-to-continue" | "bad-initial-url" | "bad-smart-export-payload" | "invalid-last-message" | "corrupted-session" | "privacy-mode-key-required" | "privacy-mode-key-invalid" | "privacy-mode-key-mismatch" | "cli-network-error" | "invalid-credentials" | "model-restricted-too-large" | "org-no-models-enabled" | "assertion" | "rate-limit" | "unknown-design-system";
+export type CodeGenErrorCodes = "credits-limit-daily" | "credits-limit-monthly" | "credits-limit-user" | "credits-limit-other" | "cli-genetic-error" | "git-update-error" | "prompt-too-long" | "context-too-long" | "abrupt-end" | "unknown" | "failed-recover-state" | "completion-expired" | "ask-to-continue" | "bad-initial-url" | "bad-smart-export-payload" | "invalid-last-message" | "corrupted-session" | "privacy-mode-key-required" | "privacy-mode-key-invalid" | "privacy-mode-key-mismatch" | "privacy-mode-validation-unavailable" | "cli-network-error" | "invalid-credentials" | "model-restricted-too-large" | "org-no-models-enabled" | "assertion" | "rate-limit" | "unknown-design-system";
 export interface CodegenUsage {
     total: number;
     fast: number;
@@ -3845,6 +3845,30 @@ export interface GenerateCodeEventError {
     message: string;
     usage?: CodegenUsage;
 }
+/**
+ * Wire schema for the pre-stream error protocol on `/codegen/completion`:
+ * middlewares that reject a request before the stream starts (credit limits,
+ * privacy mode) respond with an error status whose body is a single
+ * {@link GenerateCodeEventError} JSONL line. Loose so servers can attach
+ * extra fields (e.g. `usageInfo`), and `code` stays an open string so newer
+ * server codes pass through older clients.
+ */
+export declare const GenerateCodeEventErrorBodySchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    stopReason: z.ZodEnum<{
+        error: "error";
+        limit: "limit";
+    }>;
+    code: z.ZodString;
+    id: z.ZodString;
+    message: z.ZodString;
+}, z.core.$loose>;
+/**
+ * Decode a non-OK `/codegen/completion` response body as a structured error
+ * event. Returns undefined for anything else (auth failures, proxy errors,
+ * plain-text bodies), letting transport-level status handling take over.
+ */
+export declare function parseGenerateCodeEventErrorBody(body: string): GenerateCodeEventError | undefined;
 export interface GenerateCodeEventPagination {
     type: "pagination";
     pop: number;

package/src/codegen.js

@@ -2017,6 +2017,37 @@ export const CodegenSettingsRequestSchema = z
     repoHash: z.string().optional(),
 })
     .meta({ title: "CodegenSettingsRequest" });
+/**
+ * Wire schema for the pre-stream error protocol on `/codegen/completion`:
+ * middlewares that reject a request before the stream starts (credit limits,
+ * privacy mode) respond with an error status whose body is a single
+ * {@link GenerateCodeEventError} JSONL line. Loose so servers can attach
+ * extra fields (e.g. `usageInfo`), and `code` stays an open string so newer
+ * server codes pass through older clients.
+ */
+export const GenerateCodeEventErrorBodySchema = z.looseObject({
+    type: z.literal("error"),
+    stopReason: z.enum(["error", "limit"]),
+    code: z.string(),
+    id: z.string(),
+    message: z.string(),
+});
+/**
+ * Decode a non-OK `/codegen/completion` response body as a structured error
+ * event. Returns undefined for anything else (auth failures, proxy errors,
+ * plain-text bodies), letting transport-level status handling take over.
+ */
+export function parseGenerateCodeEventErrorBody(body) {
+    try {
+        const parsed = GenerateCodeEventErrorBodySchema.safeParse(JSON.parse(body.trim().split("\n")[0]));
+        return parsed.success
+            ? parsed.data
+            : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
 /**
  * Request for generating a commit message via LLM
  */

package/src/codegen.spec.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { DEFAULT_QUEUE_BEHAVIOR, isInterruptSchedule, normalizeQueueMode, } from "./codegen";
+import { DEFAULT_QUEUE_BEHAVIOR, isInterruptSchedule, normalizeQueueMode, parseGenerateCodeEventErrorBody, } from "./codegen";
 describe("normalizeQueueMode", () => {
     it("returns the default behavior when input is undefined", () => {
         expect(normalizeQueueMode(undefined)).toEqual(DEFAULT_QUEUE_BEHAVIOR);
@@ -56,3 +56,38 @@ describe("isInterruptSchedule", () => {
         expect(isInterruptSchedule("until-idle")).toBe(false);
     });
 });
+describe("parseGenerateCodeEventErrorBody", () => {
+    it("decodes a structured error-event body", () => {
+        const body = JSON.stringify({
+            type: "error",
+            stopReason: "error",
+            code: "privacy-mode-key-required",
+            id: "abc",
+            message: "no key",
+        }) + "\n";
+        expect(parseGenerateCodeEventErrorBody(body)).toMatchObject({
+            code: "privacy-mode-key-required",
+            message: "no key",
+        });
+    });
+    it("preserves extra fields like usageInfo and decodes only the first line", () => {
+        const body = JSON.stringify({
+            type: "error",
+            stopReason: "limit",
+            code: "credits-limit-monthly",
+            id: "abc",
+            message: "limit reached",
+            usageInfo: { plan: "free" },
+        }) + "\nnot-json-second-line";
+        expect(parseGenerateCodeEventErrorBody(body)).toMatchObject({
+            code: "credits-limit-monthly",
+            usageInfo: { plan: "free" },
+        });
+    });
+    it("returns undefined for non-event bodies", () => {
+        expect(parseGenerateCodeEventErrorBody("Forbidden")).toBeUndefined();
+        expect(parseGenerateCodeEventErrorBody('{"error":"invalid token"}')).toBeUndefined();
+        expect(parseGenerateCodeEventErrorBody(JSON.stringify({ type: "error", code: 42, message: "bad shape" }))).toBeUndefined();
+        expect(parseGenerateCodeEventErrorBody("")).toBeUndefined();
+    });
+});

package/src/design-systems.d.ts

@@ -11,6 +11,22 @@ export interface FigmaHydrationResponse {
     manifest: import("./events.js").FigmaFrameManifest | null;
     files: FigmaHydrationFile[];
 }
+export declare const figmaDecodeJobStatusParamsSchema: z.ZodObject<{
+    jobId: z.ZodString;
+}, z.core.$strip>;
+export type FigmaDecodeJobStatusParams = z.infer<typeof figmaDecodeJobStatusParamsSchema>;
+export interface FigmaDecodeJobStatusResponse {
+    jobId: string;
+    status: "pending" | "processing" | "complete" | "error";
+    framesProcessed: number;
+    totalFrames: number;
+    branchName: string | null;
+    branchUrl: string | null;
+    error: string | null;
+    partialFailure?: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
 /**
  * Accepts `https://github.com/<owner>/<repo>` (optionally with a trailing
  * `.git` or path segments). Used to gate public-repo inputs before cloning.

package/src/design-systems.js

@@ -1,4 +1,7 @@
 import { z } from "zod";
+export const figmaDecodeJobStatusParamsSchema = z.object({
+    jobId: z.string().min(1),
+});
 /**
  * Accepts `https://github.com/<owner>/<repo>` (optionally with a trailing
  * `.git` or path segments). Used to gate public-repo inputs before cloning.