@builder.io/dev-tools 1.31.0-dev.202603092107.4c4e8f23e → 1.31.0-dev.202603100528.281570c5c

package/types/cli/codegen-git-snapshot.test.d.ts

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

package/types/cli/indexing.d.ts

@@ -0,0 +1,5 @@
+import type { DevToolsSys } from "../types";
+import type { CLIArgs } from "./index";
+import { type Credentials } from "./credentials";
+export declare const runCodeIndexing: (_sys: DevToolsSys, _args: CLIArgs) => Promise<void>;
+export declare const codeIndexing: (sys: DevToolsSys, credentials: Credentials) => Promise<void>;

package/types/cli/launch/github.d.ts

@@ -0,0 +1,3 @@
+export declare const getKVHiddenComment: (key: string, value: string) => string;
+export declare const getPreviewUrl: (projectId: string, branchName: string) => string;
+export declare const getInitialDescription: (projectId: string, branchName: string) => string;

package/types/cli/repo-indexing.d.ts

@@ -0,0 +1,17 @@
+import type { DevToolsSys } from "../types";
+import type { CLIArgs } from "./index";
+export interface RepoIndexingDoc {
+    name: string;
+    content: string | {
+        name: string;
+        description: string;
+        components: string[];
+        relevantFiles: string[];
+    }[];
+    createdDate: string;
+    description: string;
+    id: string;
+    ownerId: string;
+    userId: string;
+}
+export declare const runRepoIndexing: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;

package/types/cli/repo-indexing.mock.d.ts

@@ -0,0 +1,5 @@
+export declare const mockDeps: {
+    getStoredComponentDocs: () => Promise<never[]>;
+    storeComponentDocs: () => Promise<{}>;
+    runCodeGen: () => Promise<string>;
+};

package/types/cli/utils/cdn-upload.d.ts

@@ -0,0 +1 @@
+export declare function uploadFrameToCDN(base64Data: string, mediaType: string, imageId: string, signal?: AbortSignal): Promise<string | null>;

package/types/cli/utils/dev-server-url-parser.d.ts

@@ -0,0 +1,12 @@
+export interface DevServerUrlInfo {
+    url: string;
+    port: number;
+}
+/**
+ * Parse dev server output to extract URL and port information
+ *
+ * @param output - The command output string to parse
+ * @param customPatterns - Optional array of custom regex patterns to try first
+ * @returns Object with url and port, or null if no valid URL found
+ */
+export declare function parseDevServerOutput(output: string, customPatterns?: string[]): DevServerUrlInfo | null;

package/types/cli/utils/dev-server-url-parser.test.d.ts

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

package/types/cli/utils/git-snapshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse multi-repo snapshot: "folder1:hash1,folder2:hash2" → { folder1: "hash1", ... }
+ * Backward compat: "abc123" (no colon) → { [primaryFolderName]: "abc123" }
+ */
+export declare function parseGitSnapshot(snapshot: string | undefined, primaryFolderName?: string): Record<string, string>;
+/**
+ * Serialize commits: { folder1: "hash1", ... } → "folder1:hash1,folder2:hash2"
+ * For single-repo, returns the full format with folder name
+ */
+export declare function serializeGitSnapshot(commits: Record<string, string>): string;
+/**
+ * Get commit for specific folder from snapshot
+ * @param snapshot - The snapshot string to parse
+ * @param folderName - The folder name to look up
+ * @param primaryFolderName - The primary folder name for parsing old format (optional, defaults to "code")
+ */
+export declare function getCommitFromSnapshot(snapshot: string | undefined, folderName: string, primaryFolderName?: string): string | undefined;

package/types/cli/utils/git-snapshot.test.d.ts

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

package/types/cli/utils/repo-indexing-group-prompts.d.ts

@@ -0,0 +1 @@
+export declare const REPO_INDEXING_GROUP_PROMPT: string;

package/types/cli/utils/timeline-collector.d.ts

@@ -0,0 +1,75 @@
+import type { ContentMessageItemImage, ContentMessageItemText, RecordFrameToolInput, TimelineEventCategory, TimelineRecording } from "$/ai-utils";
+export type CursorPositionReader = () => Promise<{
+    x: number | null;
+    y: number | null;
+    viewportWidth: number;
+    viewportHeight: number;
+} | null>;
+interface TimelineCollectorOptions {
+    framesDir: string;
+    debug?: boolean;
+    enableCdnUpload?: boolean;
+    readCursorPosition?: CursorPositionReader;
+}
+interface CollectedFrame {
+    image: ContentMessageItemImage;
+    title: string;
+    category: TimelineEventCategory;
+    eventId: number;
+    explicit: boolean;
+    timestamp: number;
+    fileName: string;
+    imageUrl?: string;
+    uploadPromise?: Promise<void>;
+    cursorX?: number | null;
+    cursorY?: number | null;
+    viewportWidth?: number;
+    viewportHeight?: number;
+}
+interface ProgressSnapshot {
+    eventCount: number;
+    frameCount: number;
+    lastLabel: string;
+    lastFrameFileName?: string;
+    lastThinking?: string;
+}
+export declare class TimelineCollector {
+    #private;
+    constructor(sessionId: string, options: TimelineCollectorOptions);
+    onToolCall(name: string, id: string, input: string): void;
+    onToolResult(result: {
+        tool_use_id?: string;
+        tool_name?: string;
+        tool_input?: string;
+        content: string | (ContentMessageItemText | ContentMessageItemImage)[];
+    }): void;
+    onRecordFrame(input: RecordFrameToolInput): void;
+    onThinking(content: string): void;
+    getLastCapturedImage(): ContentMessageItemImage | null;
+    getExplicitFrames(): Array<{
+        image: ContentMessageItemImage | null;
+        title: string;
+    }>;
+    getExplicitImages(): ContentMessageItemImage[];
+    getAllImages(): ContentMessageItemImage[];
+    getLegacyMetadataFrames(): Array<{
+        hasImage: boolean;
+        title: string;
+    }>;
+    getExplicitFrameDurations(): string[];
+    getProgressSnapshot(): ProgressSnapshot;
+    getEventCount(): number;
+    getFrameCount(): number;
+    getLastLabel(): string;
+    hasExplicitFrames(): boolean;
+    hasAnyFrames(): boolean;
+    getHighlightFrames(): CollectedFrame[];
+    getHighlightImages(): ContentMessageItemImage[];
+    getHighlightMetadataFrames(): Array<{
+        hasImage: boolean;
+        title: string;
+    }>;
+    getHighlightFrameDurations(): string[];
+    finalize(): Promise<TimelineRecording>;
+}
+export {};

package/types/scripts/analyze-projects.d.ts

@@ -0,0 +1,18 @@
+export declare function analyzeProjects(inputPath?: string): Promise<{
+    success: boolean;
+    error: string;
+    projectsCount?: undefined;
+    branchesCount?: undefined;
+    csvRowsCount?: undefined;
+    outputPath?: undefined;
+} | {
+    success: boolean;
+    projectsCount: number;
+    branchesCount: number;
+    csvRowsCount: number;
+    outputPath: string;
+    error?: undefined;
+}>;
+export declare function handleAnalyzeProjects(args: {
+    inputPath?: string;
+}): Promise<void>;

package/types/scripts/call-ensure-container.d.ts

@@ -0,0 +1,4 @@
+export declare function handleCallEnsureContainer(args: {
+    appName: string;
+    branchName: string;
+}): Promise<void>;

package/types/scripts/check-backup.d.ts

@@ -0,0 +1 @@
+export declare function handleCheckBackup(): Promise<void>;

package/types/scripts/cli.d.ts

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

package/types/scripts/download-projects.d.ts

@@ -0,0 +1,12 @@
+export declare function downloadProjects(): Promise<{
+    success: boolean;
+    count: number;
+    outputPath: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    count?: undefined;
+    outputPath?: undefined;
+}>;
+export declare function handleDownloadProjects(): Promise<void>;

package/types/scripts/utils/db.d.ts

@@ -0,0 +1,3 @@
+import admin from "firebase-admin";
+export declare const db: admin.firestore.Firestore;
+export declare const storage: admin.storage.Storage;

package/types/scripts/utils/ensure-container.d.ts

@@ -0,0 +1,7 @@
+export declare function ensureContainer(projectId: string, branchName: string): Promise<{
+    success: boolean;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+}>;

package/types/scripts/utils/remove-machine-and-volume.d.ts

@@ -0,0 +1,5 @@
+export declare function forceRemoveMachineAndVolume({ projectId, branchName, shouldDeleteVolume, }: {
+    projectId: string;
+    branchName: string;
+    shouldDeleteVolume?: boolean;
+}): Promise<void>;