@builder.io/ai-utils 0.17.3 → 0.18.0

package/src/projects.js

@@ -1,49 +1,50 @@
 export const EXAMPLE_REPOS = [
-    "steve8708/mui-vite",
-    "steve8708/carbon-vite",
-    "steve8708/vite-react-shopify-polaris",
-    "steve8708/cloudscape-demos",
-    "BuilderIO/fusion-angular-tailwind-starter",
-    "BuilderIO/fusion-svelte-tailwind-starter",
-    "BuilderIO/fusion-vue-tailwind-starter",
+	"steve8708/mui-vite",
+	"steve8708/carbon-vite",
+	"steve8708/vite-react-shopify-polaris",
+	"steve8708/cloudscape-demos",
+	"BuilderIO/fusion-angular-tailwind-starter",
+	"BuilderIO/fusion-svelte-tailwind-starter",
+	"BuilderIO/fusion-vue-tailwind-starter",
 ];
 export const STARTER_REPO = "BuilderIO/fusion-starter";
 export const EXAMPLE_OR_STARTER_REPOS = [...EXAMPLE_REPOS, STARTER_REPO];
-export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo) => `https://github.com/${repo}`);
+export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map(
+	(repo) => `https://github.com/${repo}`,
+);
 export const checkIsNewBranch = (branch) => {
-    return "projectId" in branch;
+	return "projectId" in branch;
 };
 /**
  * Get the state of a branch, checking `state` first and falling back to `deleted` for backwards compatibility.
  */
 export const getBranchState = (branch) => {
-    if (branch.state)
-        return branch.state;
-    return branch.deleted ? "deleted" : "active";
+	if (branch.state) return branch.state;
+	return branch.deleted ? "deleted" : "active";
 };
 /**
  * Get the state of a project, checking `state` first and falling back to `deleted` for backwards compatibility.
  */
 export const getProjectState = (project) => {
-    var _a;
-    return (_a = project.state) !== null && _a !== void 0 ? _a : "active";
+	var _a;
+	return (_a = project.state) !== null && _a !== void 0 ? _a : "active";
 };
 /**
  * Check if a branch is deleted, supporting both `state` and legacy `deleted` fields.
  * Note: Archived branches are NOT considered deleted.
  */
 export const isBranchDeleted = (branch) => {
-    return getBranchState(branch) === "deleted";
+	return getBranchState(branch) === "deleted";
 };
 /**
  * Check if a branch is archived.
  */
 export const isBranchArchived = (branch) => {
-    return getBranchState(branch) === "archived";
+	return getBranchState(branch) === "archived";
 };
 /**
  * Check if a project is deleted, supporting both `state` and legacy `deleted` fields.
  */
 export const isProjectDeleted = (project) => {
-    return getProjectState(project) === "deleted";
+	return getProjectState(project) === "deleted";
 };

package/src/repo-indexing.d.ts

@@ -1,132 +1,150 @@
-export type StoreComponentDocsInput = StoreComponentDocsInputV1 | StoreComponentDocsInputV2 | IndexDocumentV1;
+export type StoreComponentDocsInput =
+	| StoreComponentDocsInputV1
+	| StoreComponentDocsInputV2
+	| IndexDocumentV1;
 export interface ManualDocumentV1 {
-    document: IndexDocumentV1;
-    filePath: string;
-    frontmatter: Record<string, any>;
-    body: string;
+	document: IndexDocumentV1;
+	filePath: string;
+	frontmatter: Record<string, any>;
+	body: string;
 }
-export type IndexDocumentV1 = ComponentDocument | TokenDocument | IconDocument | AgentDocument | InstallationDocument;
+export type IndexDocumentV1 =
+	| ComponentDocument
+	| TokenDocument
+	| IconDocument
+	| AgentDocument
+	| InstallationDocument;
 export interface ComponentDocument extends DocumentBase {
-    type: "component";
-    relatedComponents: string[];
-    relevantFiles: string[];
-    hash: string;
+	type: "component";
+	relatedComponents: string[];
+	relevantFiles: string[];
+	hash: string;
 }
 export interface TokenDocument extends DocumentBase {
-    type: "token";
-    hash: string;
-    relevantFiles: string[];
+	type: "token";
+	hash: string;
+	relevantFiles: string[];
 }
 export interface IconDocument extends DocumentBase {
-    type: "icon";
-    hash: string;
+	type: "icon";
+	hash: string;
 }
 export interface AgentDocument extends DocumentBase {
-    type: "agent";
+	type: "agent";
 }
 export interface InstallationDocument extends DocumentBase {
-    type: "installation";
-    hash: string;
+	type: "installation";
+	hash: string;
 }
 export interface DocumentBase {
-    id?: string;
-    name: string;
-    description: string;
-    content: string;
-    designSystemId: string;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    tokens?: number;
-    sessionId?: string;
+	id?: string;
+	name: string;
+	description: string;
+	content: string;
+	designSystemId: string;
+	designSystemPackage?: string;
+	designSystemVersion?: string;
+	tokens?: number;
+	sessionId?: string;
 }
-export declare const isAgentDocument: (doc: IndexDocumentV1) => doc is AgentDocument;
-export declare const isIconDocument: (doc: IndexDocumentV1) => doc is IconDocument;
-export declare const isTokenDocument: (doc: IndexDocumentV1) => doc is TokenDocument;
-export declare const isComponentDocument: (doc: IndexDocumentV1) => doc is ComponentDocument;
-export declare const isInstallationDocument: (doc: IndexDocumentV1) => doc is InstallationDocument;
+export declare const isAgentDocument: (
+	doc: IndexDocumentV1,
+) => doc is AgentDocument;
+export declare const isIconDocument: (
+	doc: IndexDocumentV1,
+) => doc is IconDocument;
+export declare const isTokenDocument: (
+	doc: IndexDocumentV1,
+) => doc is TokenDocument;
+export declare const isComponentDocument: (
+	doc: IndexDocumentV1,
+) => doc is ComponentDocument;
+export declare const isInstallationDocument: (
+	doc: IndexDocumentV1,
+) => doc is InstallationDocument;
 /**
  * @deprecated
  * While some documents may still use this format, new documents should use the
  * latest interface.
  */
 interface StoreComponentDocsInputV1 {
-    id?: string;
-    ownerId?: string;
-    userId?: string;
-    createdDate?: Date;
-    deprecated?: boolean;
-    description: string;
-    name: string;
-    relatedComponents: string[];
-    relevantFiles: string[];
-    content: string;
-    sessionId: string;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    hash?: string;
-    designSystemId?: string;
+	id?: string;
+	ownerId?: string;
+	userId?: string;
+	createdDate?: Date;
+	deprecated?: boolean;
+	description: string;
+	name: string;
+	relatedComponents: string[];
+	relevantFiles: string[];
+	content: string;
+	sessionId: string;
+	designSystemPackage?: string;
+	designSystemVersion?: string;
+	hash?: string;
+	designSystemId?: string;
 }
 /**
  * @deprecated
  */
 interface StoreComponentDocsInputV2 {
-    id?: string;
-    ownerId?: string;
-    userId?: string;
-    createdDate?: Date;
-    deprecated?: boolean;
-    description: string;
-    name: string;
-    relatedComponents: string[];
-    relevantFiles: string[];
-    content: string;
-    sessionId: string;
-    hash?: string;
-    designSystemId?: string;
-    tokens?: number;
+	id?: string;
+	ownerId?: string;
+	userId?: string;
+	createdDate?: Date;
+	deprecated?: boolean;
+	description: string;
+	name: string;
+	relatedComponents: string[];
+	relevantFiles: string[];
+	content: string;
+	sessionId: string;
+	hash?: string;
+	designSystemId?: string;
+	tokens?: number;
 }
 export type DesignSystemScope = "space" | "organization" | "global";
 export interface AddDesignSystemInput {
-    designSystemName: string;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    status: string;
-    spaceId: string;
-    rootOrgId: string;
-    scope: DesignSystemScope;
-    gitOriginUrl: string | undefined;
-    gitRelativePath: string | undefined;
-    cliArgs: string[];
+	designSystemName: string;
+	designSystemPackage?: string;
+	designSystemVersion?: string;
+	status: string;
+	spaceId: string;
+	rootOrgId: string;
+	scope: DesignSystemScope;
+	gitOriginUrl: string | undefined;
+	gitRelativePath: string | undefined;
+	cliArgs: string[];
 }
 export interface UpdateDesignSystemInput {
-    id: string;
-    designSystemName?: string;
-    scope?: DesignSystemScope;
-    designSystemPackage?: string;
-    designSystemVersion?: string;
-    status?: "in-progress" | "completed" | "failed";
-    source?: "auto" | "custom";
+	id: string;
+	designSystemName?: string;
+	scope?: DesignSystemScope;
+	designSystemPackage?: string;
+	designSystemVersion?: string;
+	status?: "in-progress" | "completed" | "failed";
+	source?: "auto" | "custom";
 }
 export interface DesignSystem {
-    id: string;
-    spaceId: string;
-    rootOrgId: string;
-    createdDate: Date;
-    createdByUserId: string;
-    lastUpdatedDate?: string;
-    lastUpdatedByUserId?: string;
-    designSystemName: string;
-    designSystemVersion?: string;
-    designSystemPackage?: string;
-    status: "in-progress" | "completed" | "failed";
-    scope: DesignSystemScope;
-    deprecated: boolean;
-    gitOriginUrl: string | undefined;
-    gitRelativePath: string | undefined;
-    cliArgs: string[];
-    source: "custom" | "auto";
+	id: string;
+	spaceId: string;
+	rootOrgId: string;
+	createdDate: Date;
+	createdByUserId: string;
+	lastUpdatedDate?: string;
+	lastUpdatedByUserId?: string;
+	designSystemName: string;
+	designSystemVersion?: string;
+	designSystemPackage?: string;
+	status: "in-progress" | "completed" | "failed";
+	scope: DesignSystemScope;
+	deprecated: boolean;
+	gitOriginUrl: string | undefined;
+	gitRelativePath: string | undefined;
+	cliArgs: string[];
+	source: "custom" | "auto";
 }
 export interface DisplayDesignSystem extends DesignSystem {
-    docCount: number;
+	docCount: number;
 }
 export {};

package/src/repo-indexing.js

@@ -1,15 +1,15 @@
 export const isAgentDocument = (doc) => {
-    return doc.type === "agent";
+	return doc.type === "agent";
 };
 export const isIconDocument = (doc) => {
-    return doc.type === "icon";
+	return doc.type === "icon";
 };
 export const isTokenDocument = (doc) => {
-    return doc.type === "token";
+	return doc.type === "token";
 };
 export const isComponentDocument = (doc) => {
-    return doc.type === "component";
+	return doc.type === "component";
 };
 export const isInstallationDocument = (doc) => {
-    return doc.type === "installation";
+	return doc.type === "installation";
 };

package/src/settings.d.ts

@@ -1,21 +1,23 @@
 export interface AssistantSettings {
-    assistantType?: string;
-    viewId?: string;
-    theme?: "dark" | "light";
-    allowNoStyleInspiration?: boolean;
+	assistantType?: string;
+	viewId?: string;
+	theme?: "dark" | "light";
+	allowNoStyleInspiration?: boolean;
 }
 interface IframeSettings extends Partial<AssistantSettings> {
-    local?: boolean;
-    /**
-     * The URL of the assistant.
-     */
-    baseUrl?: string;
+	local?: boolean;
+	/**
+	 * The URL of the assistant.
+	 */
+	baseUrl?: string;
 }
 export declare function getAssistantUrl(opts?: IframeSettings): string;
-export declare function parseAssistantUrlSettings(url: string): Partial<AssistantSettings>;
+export declare function parseAssistantUrlSettings(
+	url: string,
+): Partial<AssistantSettings>;
 export interface BuilderEditorAuth {
-    spaceId: string;
-    userId: string;
-    authToken: string;
+	spaceId: string;
+	userId: string;
+	authToken: string;
 }
 export {};

package/src/settings.js

@@ -1,30 +1,31 @@
-const urlParamSettings = [
-    "assistantType",
-    "theme",
-    "viewId",
-];
+const urlParamSettings = ["assistantType", "theme", "viewId"];
 export function getAssistantUrl(opts = {}) {
-    var _a;
-    const url = new URL((_a = opts.baseUrl) !== null && _a !== void 0 ? _a : (opts.local ? "http://localhost:7242" : "https://assistant.builder.io"));
-    urlParamSettings.forEach((key) => {
-        const value = opts[key];
-        if (typeof value === "string" || typeof value === "boolean") {
-            url.searchParams.set(key, String(value));
-        }
-    });
-    return url.href;
+	var _a;
+	const url = new URL(
+		(_a = opts.baseUrl) !== null && _a !== void 0
+			? _a
+			: opts.local
+				? "http://localhost:7242"
+				: "https://assistant.builder.io",
+	);
+	urlParamSettings.forEach((key) => {
+		const value = opts[key];
+		if (typeof value === "string" || typeof value === "boolean") {
+			url.searchParams.set(key, String(value));
+		}
+	});
+	return url.href;
 }
 export function parseAssistantUrlSettings(url) {
-    const parsed = new URL(url);
-    const settings = {};
-    urlParamSettings.forEach((key) => {
-        const value = parsed.searchParams.get(key);
-        if (value === "true" || value === "false") {
-            settings[key] = value === "true";
-        }
-        else if (value) {
-            settings[key] = value;
-        }
-    });
-    return settings;
+	const parsed = new URL(url);
+	const settings = {};
+	urlParamSettings.forEach((key) => {
+		const value = parsed.searchParams.get(key);
+		if (value === "true" || value === "false") {
+			settings[key] = value === "true";
+		} else if (value) {
+			settings[key] = value;
+		}
+	});
+	return settings;
 }

package/src/vscode-tunnel.d.ts

@@ -19,7 +19,10 @@ export declare const DEFAULT_WORKSPACE_PATH = "/root/app/code";
  * generateVSCodeDeepLink("my-project-main")
  * // Returns: "vscode://vscode-remote/tunnel+my-project-main/root/app/code"
  */
-export declare function generateVSCodeDeepLink(tunnelName: string, workspacePath?: string): string;
+export declare function generateVSCodeDeepLink(
+	tunnelName: string,
+	workspacePath?: string,
+): string;
 /**
  * Generate a Cursor deep link for a tunnel
  *
@@ -31,7 +34,10 @@ export declare function generateVSCodeDeepLink(tunnelName: string, workspacePath
  * generateCursorDeepLink("my-project-main")
  * // Returns: "cursor://cursor-remote/tunnel+my-project-main/root/app/code"
  */
-export declare function generateCursorDeepLink(tunnelName: string, workspacePath?: string): string;
+export declare function generateCursorDeepLink(
+	tunnelName: string,
+	workspacePath?: string,
+): string;
 /**
  * Generate a web editor (vscode.dev) link for a tunnel
  *
@@ -43,7 +49,10 @@ export declare function generateCursorDeepLink(tunnelName: string, workspacePath
  * generateWebEditorLink("my-project-main")
  * // Returns: "https://vscode.dev/tunnel/my-project-main/root/app/code"
  */
-export declare function generateWebEditorLink(tunnelName: string, workspacePath?: string): string;
+export declare function generateWebEditorLink(
+	tunnelName: string,
+	workspacePath?: string,
+): string;
 /**
  * Generate all deep links for a tunnel
  *
@@ -59,10 +68,13 @@ export declare function generateWebEditorLink(tunnelName: string, workspacePath?
  * //   web: "https://vscode.dev/tunnel/my-project-main/root/app/code"
  * // }
  */
-export declare function generateAllEditorLinks(tunnelName: string, workspacePath?: string): {
-    vscode: string;
-    cursor: string;
-    web: string;
+export declare function generateAllEditorLinks(
+	tunnelName: string,
+	workspacePath?: string,
+): {
+	vscode: string;
+	cursor: string;
+	web: string;
 };
 /**
  * Generate a sanitized tunnel name from project and branch identifiers
@@ -75,7 +87,10 @@ export declare function generateAllEditorLinks(tunnelName: string, workspacePath
  * generateTunnelName("abc123", "feature/my-branch")
  * // Returns: "abc123-feature-my-branch"
  */
-export declare function generateTunnelName(projectId: string, branchName: string): string;
+export declare function generateTunnelName(
+	projectId: string,
+	branchName: string,
+): string;
 /**
  * Parse a tunnel URL to extract the tunnel name
  *

package/src/vscode-tunnel.js

@@ -19,8 +19,11 @@ export const DEFAULT_WORKSPACE_PATH = "/root/app/code";
  * generateVSCodeDeepLink("my-project-main")
  * // Returns: "vscode://vscode-remote/tunnel+my-project-main/root/app/code"
  */
-export function generateVSCodeDeepLink(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return `vscode://vscode-remote/tunnel+${tunnelName}${workspacePath}`;
+export function generateVSCodeDeepLink(
+	tunnelName,
+	workspacePath = DEFAULT_WORKSPACE_PATH,
+) {
+	return `vscode://vscode-remote/tunnel+${tunnelName}${workspacePath}`;
 }
 /**
  * Generate a Cursor deep link for a tunnel
@@ -33,8 +36,11 @@ export function generateVSCodeDeepLink(tunnelName, workspacePath = DEFAULT_WORKS
  * generateCursorDeepLink("my-project-main")
  * // Returns: "cursor://cursor-remote/tunnel+my-project-main/root/app/code"
  */
-export function generateCursorDeepLink(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return `cursor://cursor-remote/tunnel+${tunnelName}${workspacePath}`;
+export function generateCursorDeepLink(
+	tunnelName,
+	workspacePath = DEFAULT_WORKSPACE_PATH,
+) {
+	return `cursor://cursor-remote/tunnel+${tunnelName}${workspacePath}`;
 }
 /**
  * Generate a web editor (vscode.dev) link for a tunnel
@@ -47,8 +53,11 @@ export function generateCursorDeepLink(tunnelName, workspacePath = DEFAULT_WORKS
  * generateWebEditorLink("my-project-main")
  * // Returns: "https://vscode.dev/tunnel/my-project-main/root/app/code"
  */
-export function generateWebEditorLink(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return `https://vscode.dev/tunnel/${tunnelName}${workspacePath}`;
+export function generateWebEditorLink(
+	tunnelName,
+	workspacePath = DEFAULT_WORKSPACE_PATH,
+) {
+	return `https://vscode.dev/tunnel/${tunnelName}${workspacePath}`;
 }
 /**
  * Generate all deep links for a tunnel
@@ -65,12 +74,15 @@ export function generateWebEditorLink(tunnelName, workspacePath = DEFAULT_WORKSP
  * //   web: "https://vscode.dev/tunnel/my-project-main/root/app/code"
  * // }
  */
-export function generateAllEditorLinks(tunnelName, workspacePath = DEFAULT_WORKSPACE_PATH) {
-    return {
-        vscode: generateVSCodeDeepLink(tunnelName, workspacePath),
-        cursor: generateCursorDeepLink(tunnelName, workspacePath),
-        web: generateWebEditorLink(tunnelName, workspacePath),
-    };
+export function generateAllEditorLinks(
+	tunnelName,
+	workspacePath = DEFAULT_WORKSPACE_PATH,
+) {
+	return {
+		vscode: generateVSCodeDeepLink(tunnelName, workspacePath),
+		cursor: generateCursorDeepLink(tunnelName, workspacePath),
+		web: generateWebEditorLink(tunnelName, workspacePath),
+	};
 }
 /**
  * Generate a sanitized tunnel name from project and branch identifiers
@@ -84,14 +96,14 @@ export function generateAllEditorLinks(tunnelName, workspacePath = DEFAULT_WORKS
  * // Returns: "abc123-feature-my-branch"
  */
 export function generateTunnelName(projectId, branchName) {
-    const combined = `${projectId}-${branchName}`;
-    const sanitized = combined
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, "-")
-        .replace(/-+/g, "-")
-        .replace(/^-|-$/g, "")
-        .substring(0, 63);
-    return sanitized || "builder-tunnel";
+	const combined = `${projectId}-${branchName}`;
+	const sanitized = combined
+		.toLowerCase()
+		.replace(/[^a-z0-9-]/g, "-")
+		.replace(/-+/g, "-")
+		.replace(/^-|-$/g, "")
+		.substring(0, 63);
+	return sanitized || "builder-tunnel";
 }
 /**
  * Parse a tunnel URL to extract the tunnel name
@@ -104,6 +116,8 @@ export function generateTunnelName(projectId, branchName) {
  * // Returns: "my-project-main"
  */
 export function parseTunnelUrl(tunnelUrl) {
-    const match = tunnelUrl.match(/(?:vscode\.dev\/tunnel\/|tunnel\+)([a-zA-Z0-9_-]+)/);
-    return match ? match[1] : null;
+	const match = tunnelUrl.match(
+		/(?:vscode\.dev\/tunnel\/|tunnel\+)([a-zA-Z0-9_-]+)/,
+	);
+	return match ? match[1] : null;
 }