@sanity/cli 6.0.0-alpha.6 → 6.0.0-alpha.8

package/dist/prompts/init/nextjs.js

@@ -0,0 +1,56 @@
+import { confirm, input, select } from '@sanity/cli-core/ux';
+export function promptForEmbeddedStudio() {
+    return confirm({
+        default: true,
+        message: `Would you like an embedded Sanity Studio?`
+    });
+}
+export function promptForStudioPath() {
+    return input({
+        default: '/studio',
+        message: 'What route do you want to use for the Studio?',
+        validate (input) {
+            if (!input.startsWith('/')) {
+                return 'Must start with /';
+            }
+            if (input.endsWith('/')) {
+                return 'Must not end with /';
+            }
+            // a-Z, 0-9, -, _ and /
+            if (!/^[a-zA-Z0-9-_\\/]+$/.test(input)) {
+                return 'Must only contain a-Z, 0-9, -, _ and /';
+            }
+            return true;
+        }
+    });
+}
+export function promptForNextTemplate() {
+    return select({
+        choices: [
+            {
+                name: 'Blog (schema)',
+                value: 'blog'
+            },
+            {
+                name: 'Clean project with no predefined schema types',
+                value: 'clean'
+            }
+        ],
+        default: 'blog',
+        message: 'Select project template to use'
+    });
+}
+export function promptForAppendEnv(envFilename) {
+    return confirm({
+        default: true,
+        message: `Would you like to add the project ID and dataset to your ${envFilename} file?`
+    });
+}
+export function promptForConfigFiles() {
+    return confirm({
+        default: true,
+        message: 'Would you like to add configuration files for a Sanity project in this Next.js folder?'
+    });
+}
+
+//# sourceMappingURL=nextjs.js.map

package/dist/prompts/init/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/prompts/init/nextjs.ts"],"sourcesContent":["import {confirm, input, select} from '@sanity/cli-core/ux'\n\nexport function promptForEmbeddedStudio(): Promise<boolean> {\n  return confirm({\n    default: true,\n    message: `Would you like an embedded Sanity Studio?`,\n  })\n}\n\nexport function promptForStudioPath(): Promise<string> {\n  return input({\n    default: '/studio',\n    message: 'What route do you want to use for the Studio?',\n    validate(input) {\n      if (!input.startsWith('/')) {\n        return 'Must start with /'\n      }\n\n      if (input.endsWith('/')) {\n        return 'Must not end with /'\n      }\n\n      // a-Z, 0-9, -, _ and /\n      if (!/^[a-zA-Z0-9-_\\\\/]+$/.test(input)) {\n        return 'Must only contain a-Z, 0-9, -, _ and /'\n      }\n\n      return true\n    },\n  })\n}\n\nexport function promptForNextTemplate(): Promise<'blog' | 'clean'> {\n  return select({\n    choices: [\n      {\n        name: 'Blog (schema)',\n        value: 'blog',\n      },\n      {\n        name: 'Clean project with no predefined schema types',\n        value: 'clean',\n      },\n    ],\n    default: 'blog',\n    message: 'Select project template to use',\n  })\n}\n\nexport function promptForAppendEnv(envFilename: string): Promise<boolean> {\n  return confirm({\n    default: true,\n    message: `Would you like to add the project ID and dataset to your ${envFilename} file?`,\n  })\n}\n\nexport function promptForConfigFiles() {\n  return confirm({\n    default: true,\n    message:\n      'Would you like to add configuration files for a Sanity project in this Next.js folder?',\n  })\n}\n"],"names":["confirm","input","select","promptForEmbeddedStudio","default","message","promptForStudioPath","validate","startsWith","endsWith","test","promptForNextTemplate","choices","name","value","promptForAppendEnv","envFilename","promptForConfigFiles"],"mappings":"AAAA,SAAQA,OAAO,EAAEC,KAAK,EAAEC,MAAM,QAAO,sBAAqB;AAE1D,OAAO,SAASC;IACd,OAAOH,QAAQ;QACbI,SAAS;QACTC,SAAS,CAAC,yCAAyC,CAAC;IACtD;AACF;AAEA,OAAO,SAASC;IACd,OAAOL,MAAM;QACXG,SAAS;QACTC,SAAS;QACTE,UAASN,KAAK;YACZ,IAAI,CAACA,MAAMO,UAAU,CAAC,MAAM;gBAC1B,OAAO;YACT;YAEA,IAAIP,MAAMQ,QAAQ,CAAC,MAAM;gBACvB,OAAO;YACT;YAEA,uBAAuB;YACvB,IAAI,CAAC,sBAAsBC,IAAI,CAACT,QAAQ;gBACtC,OAAO;YACT;YAEA,OAAO;QACT;IACF;AACF;AAEA,OAAO,SAASU;IACd,OAAOT,OAAO;QACZU,SAAS;YACP;gBACEC,MAAM;gBACNC,OAAO;YACT;YACA;gBACED,MAAM;gBACNC,OAAO;YACT;SACD;QACDV,SAAS;QACTC,SAAS;IACX;AACF;AAEA,OAAO,SAASU,mBAAmBC,WAAmB;IACpD,OAAOhB,QAAQ;QACbI,SAAS;QACTC,SAAS,CAAC,yDAAyD,EAAEW,YAAY,MAAM,CAAC;IAC1F;AACF;AAEA,OAAO,SAASC;IACd,OAAOjB,QAAQ;QACbI,SAAS;QACTC,SACE;IACJ;AACF"}

package/dist/prompts/init/promptForTypescript.d.ts

@@ -1,2 +1 @@
 export declare function promptForTypeScript(): Promise<boolean>;
-export declare function promptImplicitReconfigure(): Promise<boolean>;

package/dist/prompts/init/promptForTypescript.js

@@ -5,11 +5,5 @@ export function promptForTypeScript() {
         message: 'Do you want to use TypeScript?'
     });
 }
-export function promptImplicitReconfigure() {
-    return confirm({
-        default: true,
-        message: 'The current folder contains a configured Sanity studio. Would you like to reconfigure it?'
-    });
-}
 
 //# sourceMappingURL=promptForTypescript.js.map

package/dist/prompts/init/promptForTypescript.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/prompts/init/promptForTypescript.ts"],"sourcesContent":["import {confirm} from '@sanity/cli-core/ux'\n\nexport function promptForTypeScript(): Promise<boolean> {\n  return confirm({\n    default: true,\n    message: 'Do you want to use TypeScript?',\n  })\n}\n\nexport function promptImplicitReconfigure(): Promise<boolean> {\n  return confirm({\n    default: true,\n    message:\n      'The current folder contains a configured Sanity studio. Would you like to reconfigure it?',\n  })\n}\n"],"names":["confirm","promptForTypeScript","default","message","promptImplicitReconfigure"],"mappings":"AAAA,SAAQA,OAAO,QAAO,sBAAqB;AAE3C,OAAO,SAASC;IACd,OAAOD,QAAQ;QACbE,SAAS;QACTC,SAAS;IACX;AACF;AAEA,OAAO,SAASC;IACd,OAAOJ,QAAQ;QACbE,SAAS;QACTC,SACE;IACJ;AACF"}
+{"version":3,"sources":["../../../src/prompts/init/promptForTypescript.ts"],"sourcesContent":["import {confirm} from '@sanity/cli-core/ux'\n\nexport function promptForTypeScript(): Promise<boolean> {\n  return confirm({\n    default: true,\n    message: 'Do you want to use TypeScript?',\n  })\n}\n"],"names":["confirm","promptForTypeScript","default","message"],"mappings":"AAAA,SAAQA,OAAO,QAAO,sBAAqB;AAE3C,OAAO,SAASC;IACd,OAAOD,QAAQ;QACbE,SAAS;QACTC,SAAS;IACX;AACF"}

package/dist/services/mcp.d.ts

@@ -1,5 +1,6 @@
 export declare const MCP_API_VERSION = "2025-12-09";
 export declare const MCP_SERVER_URL = "https://mcp.sanity.io";
+export declare const MCP_JOURNEY_API_VERSION = "v2024-02-23";
 type EditorName = 'Claude Code' | 'Cursor' | 'VS Code';
 export interface Editor {
     configKey: 'mcpServers' | 'servers';
@@ -17,6 +18,9 @@ interface ServerConfig {
     type: 'http';
     url: string;
 }
+interface PostInitPromptResponse {
+    message?: string;
+}
 /**
  * Create a child token for MCP usage
  * This token is tied to the parent CLI token and will be invalidated
@@ -26,4 +30,10 @@ interface ServerConfig {
  * @internal
  */
 export declare function createMCPToken(): Promise<string>;
+/**
+ * Fetches the post-init MCP prompt from the Journey API and interpolates editor names.
+ * Falls back to a hardcoded default if the API call fails, times out, or returns empty.
+ * Text wrapped in **markers** will be formatted with cyan color.
+ */
+export declare function getPostInitPrompt(): Promise<PostInitPromptResponse | null>;
 export {};

package/dist/services/mcp.js

@@ -1,6 +1,7 @@
 import { getGlobalCliClient } from '@sanity/cli-core';
 export const MCP_API_VERSION = '2025-12-09';
 export const MCP_SERVER_URL = 'https://mcp.sanity.io';
+export const MCP_JOURNEY_API_VERSION = 'v2024-02-23';
 /**
  * Create a child token for MCP usage
  * This token is tied to the parent CLI token and will be invalidated
@@ -30,5 +31,20 @@ export const MCP_SERVER_URL = 'https://mcp.sanity.io';
     });
     return tokenResponse.token;
 }
+/**
+ * Fetches the post-init MCP prompt from the Journey API and interpolates editor names.
+ * Falls back to a hardcoded default if the API call fails, times out, or returns empty.
+ * Text wrapped in **markers** will be formatted with cyan color.
+ */ export async function getPostInitPrompt() {
+    const client = await getGlobalCliClient({
+        apiVersion: MCP_JOURNEY_API_VERSION,
+        requireUser: false
+    });
+    return await client.request({
+        method: 'GET',
+        timeout: 1000,
+        uri: '/journey/mcp/post-init-prompt'
+    });
+}
 
 //# sourceMappingURL=mcp.js.map

package/dist/services/mcp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/services/mcp.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\n\nexport const MCP_API_VERSION = '2025-12-09'\nexport const MCP_SERVER_URL = 'https://mcp.sanity.io'\n\ntype EditorName = 'Claude Code' | 'Cursor' | 'VS Code'\n\nexport interface Editor {\n  configKey: 'mcpServers' | 'servers'\n  configPath: string\n  name: EditorName\n}\n\nexport interface MCPConfig {\n  mcpServers?: Record<string, ServerConfig>\n  servers?: Record<string, ServerConfig>\n}\n\ninterface ServerConfig {\n  headers: {\n    Authorization: string\n  }\n  type: 'http'\n  url: string\n}\n\n/**\n * Create a child token for MCP usage\n * This token is tied to the parent CLI token and will be invalidated\n * when the parent token is invalidated (e.g., on logout)\n *\n * @returns The MCP token string\n * @internal\n */\nexport async function createMCPToken(): Promise<string> {\n  const client = await getGlobalCliClient({\n    apiVersion: MCP_API_VERSION,\n    requireUser: true,\n  })\n\n  const sessionResponse = await client.request<{id: string; sid: string}>({\n    body: {\n      sourceId: 'sanity-mcp',\n      withStamp: false,\n    },\n    method: 'POST',\n    uri: '/auth/session/create',\n  })\n\n  const tokenResponse = await client.request<{label: string; token: string}>({\n    method: 'GET',\n    query: {sid: sessionResponse.sid},\n    uri: '/auth/fetch',\n  })\n\n  return tokenResponse.token\n}\n"],"names":["getGlobalCliClient","MCP_API_VERSION","MCP_SERVER_URL","createMCPToken","client","apiVersion","requireUser","sessionResponse","request","body","sourceId","withStamp","method","uri","tokenResponse","query","sid","token"],"mappings":"AAAA,SAAQA,kBAAkB,QAAO,mBAAkB;AAEnD,OAAO,MAAMC,kBAAkB,aAAY;AAC3C,OAAO,MAAMC,iBAAiB,wBAAuB;AAuBrD;;;;;;;CAOC,GACD,OAAO,eAAeC;IACpB,MAAMC,SAAS,MAAMJ,mBAAmB;QACtCK,YAAYJ;QACZK,aAAa;IACf;IAEA,MAAMC,kBAAkB,MAAMH,OAAOI,OAAO,CAA4B;QACtEC,MAAM;YACJC,UAAU;YACVC,WAAW;QACb;QACAC,QAAQ;QACRC,KAAK;IACP;IAEA,MAAMC,gBAAgB,MAAMV,OAAOI,OAAO,CAAiC;QACzEI,QAAQ;QACRG,OAAO;YAACC,KAAKT,gBAAgBS,GAAG;QAAA;QAChCH,KAAK;IACP;IAEA,OAAOC,cAAcG,KAAK;AAC5B"}
+{"version":3,"sources":["../../src/services/mcp.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\n\nexport const MCP_API_VERSION = '2025-12-09'\nexport const MCP_SERVER_URL = 'https://mcp.sanity.io'\nexport const MCP_JOURNEY_API_VERSION = 'v2024-02-23'\n\ntype EditorName = 'Claude Code' | 'Cursor' | 'VS Code'\n\nexport interface Editor {\n  configKey: 'mcpServers' | 'servers'\n  configPath: string\n  name: EditorName\n}\n\nexport interface MCPConfig {\n  mcpServers?: Record<string, ServerConfig>\n  servers?: Record<string, ServerConfig>\n}\n\ninterface ServerConfig {\n  headers: {\n    Authorization: string\n  }\n  type: 'http'\n  url: string\n}\n\ninterface PostInitPromptResponse {\n  message?: string\n}\n\n/**\n * Create a child token for MCP usage\n * This token is tied to the parent CLI token and will be invalidated\n * when the parent token is invalidated (e.g., on logout)\n *\n * @returns The MCP token string\n * @internal\n */\nexport async function createMCPToken(): Promise<string> {\n  const client = await getGlobalCliClient({\n    apiVersion: MCP_API_VERSION,\n    requireUser: true,\n  })\n\n  const sessionResponse = await client.request<{id: string; sid: string}>({\n    body: {\n      sourceId: 'sanity-mcp',\n      withStamp: false,\n    },\n    method: 'POST',\n    uri: '/auth/session/create',\n  })\n\n  const tokenResponse = await client.request<{label: string; token: string}>({\n    method: 'GET',\n    query: {sid: sessionResponse.sid},\n    uri: '/auth/fetch',\n  })\n\n  return tokenResponse.token\n}\n\n/**\n * Fetches the post-init MCP prompt from the Journey API and interpolates editor names.\n * Falls back to a hardcoded default if the API call fails, times out, or returns empty.\n * Text wrapped in **markers** will be formatted with cyan color.\n */\nexport async function getPostInitPrompt() {\n  const client = await getGlobalCliClient({apiVersion: MCP_JOURNEY_API_VERSION, requireUser: false})\n  return await client.request<PostInitPromptResponse | null>({\n    method: 'GET',\n    timeout: 1000,\n    uri: '/journey/mcp/post-init-prompt',\n  })\n}\n"],"names":["getGlobalCliClient","MCP_API_VERSION","MCP_SERVER_URL","MCP_JOURNEY_API_VERSION","createMCPToken","client","apiVersion","requireUser","sessionResponse","request","body","sourceId","withStamp","method","uri","tokenResponse","query","sid","token","getPostInitPrompt","timeout"],"mappings":"AAAA,SAAQA,kBAAkB,QAAO,mBAAkB;AAEnD,OAAO,MAAMC,kBAAkB,aAAY;AAC3C,OAAO,MAAMC,iBAAiB,wBAAuB;AACrD,OAAO,MAAMC,0BAA0B,cAAa;AA2BpD;;;;;;;CAOC,GACD,OAAO,eAAeC;IACpB,MAAMC,SAAS,MAAML,mBAAmB;QACtCM,YAAYL;QACZM,aAAa;IACf;IAEA,MAAMC,kBAAkB,MAAMH,OAAOI,OAAO,CAA4B;QACtEC,MAAM;YACJC,UAAU;YACVC,WAAW;QACb;QACAC,QAAQ;QACRC,KAAK;IACP;IAEA,MAAMC,gBAAgB,MAAMV,OAAOI,OAAO,CAAiC;QACzEI,QAAQ;QACRG,OAAO;YAACC,KAAKT,gBAAgBS,GAAG;QAAA;QAChCH,KAAK;IACP;IAEA,OAAOC,cAAcG,KAAK;AAC5B;AAEA;;;;CAIC,GACD,OAAO,eAAeC;IACpB,MAAMd,SAAS,MAAML,mBAAmB;QAACM,YAAYH;QAAyBI,aAAa;IAAK;IAChG,OAAO,MAAMF,OAAOI,OAAO,CAAgC;QACzDI,QAAQ;QACRO,SAAS;QACTN,KAAK;IACP;AACF"}

package/dist/services/projects.d.ts

@@ -1,3 +1,4 @@
+import { SanityProject } from '@sanity/client';
 import { type Invite, type Role } from '../actions/users/types.js';
 export declare const PROJECTS_API_VERSION = "2025-09-22";
 export declare const CREATE_PROJECT_API_VERSION = "v2025-05-14";
@@ -20,7 +21,7 @@ export interface CreateProjectResult {
  * Create a new Sanity project
  */
 export declare function createProject(options: CreateProjectOptions): Promise<CreateProjectResult>;
-export declare function getProjectById(projectId: string): Promise<import("@sanity/client").SanityProject>;
+export declare function getProjectById(projectId: string): Promise<SanityProject>;
 export declare function getProjectRoles(projectId: string): Promise<Role[]>;
 interface InviteUserOptions {
     email: string;
@@ -28,6 +29,8 @@ interface InviteUserOptions {
     role: string;
 }
 export declare function inviteUser({ email, projectId, role }: InviteUserOptions): Promise<any>;
-export declare function listProjects(): Promise<import("@sanity/client").SanityProject[]>;
+export declare function listProjects(): Promise<SanityProject[]>;
 export declare function getProjectInvites(projectId: string): Promise<Invite[]>;
+export declare function updateProjectInitializedAt(projectId: string): Promise<void>;
+export declare function updateProjectInitalTemplate(projectId: string, templateName: string): Promise<void>;
 export {};

package/dist/services/projects.js

@@ -78,5 +78,42 @@ export async function getProjectInvites(projectId) {
         uri: `/invitations/project/${projectId}`
     });
 }
+export async function updateProjectInitializedAt(projectId) {
+    const client = await getProjectCliClient({
+        apiVersion: PROJECTS_API_VERSION,
+        projectId,
+        requireUser: true
+    });
+    const project = await client.request({
+        uri: `/projects/${projectId}`
+    });
+    if (!project?.metadata?.cliInitializedAt) {
+        await client.request({
+            body: {
+                metadata: {
+                    cliInitializedAt: new Date().toISOString()
+                }
+            },
+            method: 'PATCH',
+            uri: `/projects/${projectId}`
+        });
+    }
+}
+export async function updateProjectInitalTemplate(projectId, templateName) {
+    const client = await getProjectCliClient({
+        apiVersion: PROJECTS_API_VERSION,
+        projectId,
+        requireUser: true
+    });
+    await client.request({
+        body: {
+            metadata: {
+                initialTemplate: templateName
+            }
+        },
+        method: 'PATCH',
+        uri: `/projects/${projectId}`
+    });
+}
 
 //# sourceMappingURL=projects.js.map

package/dist/services/projects.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/services/projects.ts"],"sourcesContent":["import {debug, getGlobalCliClient, getProjectCliClient} from '@sanity/cli-core'\n\nimport {type Invite, type Role} from '../actions/users/types.js'\n\nexport const PROJECTS_API_VERSION = '2025-09-22'\n\nexport const CREATE_PROJECT_API_VERSION = 'v2025-05-14'\n\nexport interface CreateProjectOptions {\n  displayName: string\n\n  metadata?: {\n    coupon?: string\n    integration?: string\n  }\n  organizationId?: string\n  subscription?: {planId: string}\n}\n\nexport interface CreateProjectResult {\n  displayName: string\n  projectId: string\n}\n\n/**\n * Create a new Sanity project\n */\nexport async function createProject(options: CreateProjectOptions): Promise<CreateProjectResult> {\n  const client = await getGlobalCliClient({\n    apiVersion: CREATE_PROJECT_API_VERSION,\n    requireUser: true,\n  })\n\n  try {\n    const response = await client.request({\n      body: {\n        ...options,\n        metadata: {\n          ...options?.metadata,\n          integration: 'cli',\n        },\n      },\n      method: 'POST',\n      uri: '/projects',\n    })\n\n    return {\n      displayName: options.displayName || '',\n      projectId: response.projectId || response.id,\n    }\n  } catch (err) {\n    debug('Error creating project', err)\n    throw err\n  }\n}\n\nexport async function getProjectById(projectId: string) {\n  const client = await getProjectCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    projectId,\n    requireUser: true,\n  })\n\n  return client.projects.getById(projectId)\n}\n\nexport async function getProjectRoles(projectId: string) {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.request<Role[]>({uri: `/projects/${projectId}/roles`})\n}\n\ninterface InviteUserOptions {\n  email: string\n  projectId: string\n  role: string\n}\n\nexport async function inviteUser({email, projectId, role}: InviteUserOptions) {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.request({\n    body: {email, role},\n    maxRedirects: 0,\n    method: 'POST',\n    uri: `/invitations/project/${projectId}`,\n    useGlobalApi: true,\n  })\n}\n\nexport async function listProjects() {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.projects.list()\n}\n\nexport async function getProjectInvites(projectId: string) {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.request<Invite[]>({uri: `/invitations/project/${projectId}`})\n}\n"],"names":["debug","getGlobalCliClient","getProjectCliClient","PROJECTS_API_VERSION","CREATE_PROJECT_API_VERSION","createProject","options","client","apiVersion","requireUser","response","request","body","metadata","integration","method","uri","displayName","projectId","id","err","getProjectById","projects","getById","getProjectRoles","inviteUser","email","role","maxRedirects","useGlobalApi","listProjects","list","getProjectInvites"],"mappings":"AAAA,SAAQA,KAAK,EAAEC,kBAAkB,EAAEC,mBAAmB,QAAO,mBAAkB;AAI/E,OAAO,MAAMC,uBAAuB,aAAY;AAEhD,OAAO,MAAMC,6BAA6B,cAAa;AAkBvD;;CAEC,GACD,OAAO,eAAeC,cAAcC,OAA6B;IAC/D,MAAMC,SAAS,MAAMN,mBAAmB;QACtCO,YAAYJ;QACZK,aAAa;IACf;IAEA,IAAI;QACF,MAAMC,WAAW,MAAMH,OAAOI,OAAO,CAAC;YACpCC,MAAM;gBACJ,GAAGN,OAAO;gBACVO,UAAU;oBACR,GAAGP,SAASO,QAAQ;oBACpBC,aAAa;gBACf;YACF;YACAC,QAAQ;YACRC,KAAK;QACP;QAEA,OAAO;YACLC,aAAaX,QAAQW,WAAW,IAAI;YACpCC,WAAWR,SAASQ,SAAS,IAAIR,SAASS,EAAE;QAC9C;IACF,EAAE,OAAOC,KAAK;QACZpB,MAAM,0BAA0BoB;QAChC,MAAMA;IACR;AACF;AAEA,OAAO,eAAeC,eAAeH,SAAiB;IACpD,MAAMX,SAAS,MAAML,oBAAoB;QACvCM,YAAYL;QACZe;QACAT,aAAa;IACf;IAEA,OAAOF,OAAOe,QAAQ,CAACC,OAAO,CAACL;AACjC;AAEA,OAAO,eAAeM,gBAAgBN,SAAiB;IACrD,MAAMX,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOI,OAAO,CAAS;QAACK,KAAK,CAAC,UAAU,EAAEE,UAAU,MAAM,CAAC;IAAA;AACpE;AAQA,OAAO,eAAeO,WAAW,EAACC,KAAK,EAAER,SAAS,EAAES,IAAI,EAAoB;IAC1E,MAAMpB,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOI,OAAO,CAAC;QACpBC,MAAM;YAACc;YAAOC;QAAI;QAClBC,cAAc;QACdb,QAAQ;QACRC,KAAK,CAAC,qBAAqB,EAAEE,WAAW;QACxCW,cAAc;IAChB;AACF;AAEA,OAAO,eAAeC;IACpB,MAAMvB,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOe,QAAQ,CAACS,IAAI;AAC7B;AAEA,OAAO,eAAeC,kBAAkBd,SAAiB;IACvD,MAAMX,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOI,OAAO,CAAW;QAACK,KAAK,CAAC,qBAAqB,EAAEE,WAAW;IAAA;AAC3E"}
+{"version":3,"sources":["../../src/services/projects.ts"],"sourcesContent":["import {debug, getGlobalCliClient, getProjectCliClient} from '@sanity/cli-core'\nimport {SanityProject} from '@sanity/client'\n\nimport {type Invite, type Role} from '../actions/users/types.js'\n\nexport const PROJECTS_API_VERSION = '2025-09-22'\n\nexport const CREATE_PROJECT_API_VERSION = 'v2025-05-14'\n\nexport interface CreateProjectOptions {\n  displayName: string\n\n  metadata?: {\n    coupon?: string\n    integration?: string\n  }\n  organizationId?: string\n  subscription?: {planId: string}\n}\n\nexport interface CreateProjectResult {\n  displayName: string\n  projectId: string\n}\n\n/**\n * Create a new Sanity project\n */\nexport async function createProject(options: CreateProjectOptions): Promise<CreateProjectResult> {\n  const client = await getGlobalCliClient({\n    apiVersion: CREATE_PROJECT_API_VERSION,\n    requireUser: true,\n  })\n\n  try {\n    const response = await client.request({\n      body: {\n        ...options,\n        metadata: {\n          ...options?.metadata,\n          integration: 'cli',\n        },\n      },\n      method: 'POST',\n      uri: '/projects',\n    })\n\n    return {\n      displayName: options.displayName || '',\n      projectId: response.projectId || response.id,\n    }\n  } catch (err) {\n    debug('Error creating project', err)\n    throw err\n  }\n}\n\nexport async function getProjectById(projectId: string) {\n  const client = await getProjectCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    projectId,\n    requireUser: true,\n  })\n\n  return client.projects.getById(projectId)\n}\n\nexport async function getProjectRoles(projectId: string) {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.request<Role[]>({uri: `/projects/${projectId}/roles`})\n}\n\ninterface InviteUserOptions {\n  email: string\n  projectId: string\n  role: string\n}\n\nexport async function inviteUser({email, projectId, role}: InviteUserOptions) {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.request({\n    body: {email, role},\n    maxRedirects: 0,\n    method: 'POST',\n    uri: `/invitations/project/${projectId}`,\n    useGlobalApi: true,\n  })\n}\n\nexport async function listProjects() {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.projects.list()\n}\n\nexport async function getProjectInvites(projectId: string) {\n  const client = await getGlobalCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    requireUser: true,\n  })\n\n  return client.request<Invite[]>({uri: `/invitations/project/${projectId}`})\n}\n\nexport async function updateProjectInitializedAt(projectId: string) {\n  const client = await getProjectCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    projectId,\n    requireUser: true,\n  })\n\n  const project = await client.request<SanityProject>({uri: `/projects/${projectId}`})\n\n  if (!project?.metadata?.cliInitializedAt) {\n    await client.request({\n      body: {metadata: {cliInitializedAt: new Date().toISOString()}},\n      method: 'PATCH',\n      uri: `/projects/${projectId}`,\n    })\n  }\n}\n\nexport async function updateProjectInitalTemplate(projectId: string, templateName: string) {\n  const client = await getProjectCliClient({\n    apiVersion: PROJECTS_API_VERSION,\n    projectId,\n    requireUser: true,\n  })\n\n  await client.request({\n    body: {metadata: {initialTemplate: templateName}},\n    method: 'PATCH',\n    uri: `/projects/${projectId}`,\n  })\n}\n"],"names":["debug","getGlobalCliClient","getProjectCliClient","PROJECTS_API_VERSION","CREATE_PROJECT_API_VERSION","createProject","options","client","apiVersion","requireUser","response","request","body","metadata","integration","method","uri","displayName","projectId","id","err","getProjectById","projects","getById","getProjectRoles","inviteUser","email","role","maxRedirects","useGlobalApi","listProjects","list","getProjectInvites","updateProjectInitializedAt","project","cliInitializedAt","Date","toISOString","updateProjectInitalTemplate","templateName","initialTemplate"],"mappings":"AAAA,SAAQA,KAAK,EAAEC,kBAAkB,EAAEC,mBAAmB,QAAO,mBAAkB;AAK/E,OAAO,MAAMC,uBAAuB,aAAY;AAEhD,OAAO,MAAMC,6BAA6B,cAAa;AAkBvD;;CAEC,GACD,OAAO,eAAeC,cAAcC,OAA6B;IAC/D,MAAMC,SAAS,MAAMN,mBAAmB;QACtCO,YAAYJ;QACZK,aAAa;IACf;IAEA,IAAI;QACF,MAAMC,WAAW,MAAMH,OAAOI,OAAO,CAAC;YACpCC,MAAM;gBACJ,GAAGN,OAAO;gBACVO,UAAU;oBACR,GAAGP,SAASO,QAAQ;oBACpBC,aAAa;gBACf;YACF;YACAC,QAAQ;YACRC,KAAK;QACP;QAEA,OAAO;YACLC,aAAaX,QAAQW,WAAW,IAAI;YACpCC,WAAWR,SAASQ,SAAS,IAAIR,SAASS,EAAE;QAC9C;IACF,EAAE,OAAOC,KAAK;QACZpB,MAAM,0BAA0BoB;QAChC,MAAMA;IACR;AACF;AAEA,OAAO,eAAeC,eAAeH,SAAiB;IACpD,MAAMX,SAAS,MAAML,oBAAoB;QACvCM,YAAYL;QACZe;QACAT,aAAa;IACf;IAEA,OAAOF,OAAOe,QAAQ,CAACC,OAAO,CAACL;AACjC;AAEA,OAAO,eAAeM,gBAAgBN,SAAiB;IACrD,MAAMX,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOI,OAAO,CAAS;QAACK,KAAK,CAAC,UAAU,EAAEE,UAAU,MAAM,CAAC;IAAA;AACpE;AAQA,OAAO,eAAeO,WAAW,EAACC,KAAK,EAAER,SAAS,EAAES,IAAI,EAAoB;IAC1E,MAAMpB,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOI,OAAO,CAAC;QACpBC,MAAM;YAACc;YAAOC;QAAI;QAClBC,cAAc;QACdb,QAAQ;QACRC,KAAK,CAAC,qBAAqB,EAAEE,WAAW;QACxCW,cAAc;IAChB;AACF;AAEA,OAAO,eAAeC;IACpB,MAAMvB,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOe,QAAQ,CAACS,IAAI;AAC7B;AAEA,OAAO,eAAeC,kBAAkBd,SAAiB;IACvD,MAAMX,SAAS,MAAMN,mBAAmB;QACtCO,YAAYL;QACZM,aAAa;IACf;IAEA,OAAOF,OAAOI,OAAO,CAAW;QAACK,KAAK,CAAC,qBAAqB,EAAEE,WAAW;IAAA;AAC3E;AAEA,OAAO,eAAee,2BAA2Bf,SAAiB;IAChE,MAAMX,SAAS,MAAML,oBAAoB;QACvCM,YAAYL;QACZe;QACAT,aAAa;IACf;IAEA,MAAMyB,UAAU,MAAM3B,OAAOI,OAAO,CAAgB;QAACK,KAAK,CAAC,UAAU,EAAEE,WAAW;IAAA;IAElF,IAAI,CAACgB,SAASrB,UAAUsB,kBAAkB;QACxC,MAAM5B,OAAOI,OAAO,CAAC;YACnBC,MAAM;gBAACC,UAAU;oBAACsB,kBAAkB,IAAIC,OAAOC,WAAW;gBAAE;YAAC;YAC7DtB,QAAQ;YACRC,KAAK,CAAC,UAAU,EAAEE,WAAW;QAC/B;IACF;AACF;AAEA,OAAO,eAAeoB,4BAA4BpB,SAAiB,EAAEqB,YAAoB;IACvF,MAAMhC,SAAS,MAAML,oBAAoB;QACvCM,YAAYL;QACZe;QACAT,aAAa;IACf;IAEA,MAAMF,OAAOI,OAAO,CAAC;QACnBC,MAAM;YAACC,UAAU;gBAAC2B,iBAAiBD;YAAY;QAAC;QAChDxB,QAAQ;QACRC,KAAK,CAAC,UAAU,EAAEE,WAAW;IAC/B;AACF"}

package/dist/services/telemetry.d.ts

@@ -0,0 +1,2 @@
+import { type TelemetryEvent } from '@sanity/telemetry';
+export declare function sendEvents(batch: TelemetryEvent[]): Promise<any>;

package/dist/services/telemetry.js

@@ -0,0 +1,20 @@
+import { getGlobalCliClient } from '@sanity/cli-core';
+const TELEMETRY_API_VERSION = 'v2023-12-18';
+export async function sendEvents(batch) {
+    const client = await getGlobalCliClient({
+        apiVersion: TELEMETRY_API_VERSION,
+        requireUser: true
+    });
+    const projectId = process.env.SANITY_TELEMETRY_PROJECT_ID;
+    return client.request({
+        body: {
+            batch,
+            projectId
+        },
+        json: true,
+        method: 'POST',
+        uri: '/intake/batch'
+    });
+}
+
+//# sourceMappingURL=telemetry.js.map

package/dist/services/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/telemetry.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\nimport {type TelemetryEvent} from '@sanity/telemetry'\n\nconst TELEMETRY_API_VERSION = 'v2023-12-18'\n\nexport async function sendEvents(batch: TelemetryEvent[]) {\n  const client = await getGlobalCliClient({\n    apiVersion: TELEMETRY_API_VERSION,\n    requireUser: true,\n  })\n\n  const projectId = process.env.SANITY_TELEMETRY_PROJECT_ID\n\n  return client.request({\n    body: {batch, projectId},\n    json: true,\n    method: 'POST',\n    uri: '/intake/batch',\n  })\n}\n"],"names":["getGlobalCliClient","TELEMETRY_API_VERSION","sendEvents","batch","client","apiVersion","requireUser","projectId","process","env","SANITY_TELEMETRY_PROJECT_ID","request","body","json","method","uri"],"mappings":"AAAA,SAAQA,kBAAkB,QAAO,mBAAkB;AAGnD,MAAMC,wBAAwB;AAE9B,OAAO,eAAeC,WAAWC,KAAuB;IACtD,MAAMC,SAAS,MAAMJ,mBAAmB;QACtCK,YAAYJ;QACZK,aAAa;IACf;IAEA,MAAMC,YAAYC,QAAQC,GAAG,CAACC,2BAA2B;IAEzD,OAAON,OAAOO,OAAO,CAAC;QACpBC,MAAM;YAACT;YAAOI;QAAS;QACvBM,MAAM;QACNC,QAAQ;QACRC,KAAK;IACP;AACF"}

package/dist/studioDependencies.d.ts

@@ -0,0 +1,16 @@
+export declare const studioDependencies: {
+    dependencies: {
+        sanity: string;
+        '@sanity/vision': string;
+        react: string;
+        'react-dom': string;
+        'styled-components': string;
+    };
+    devDependencies: {
+        '@sanity/eslint-config-studio': string;
+        '@types/react': string;
+        eslint: string;
+        prettier: string;
+        typescript: string;
+    };
+};

package/dist/studioDependencies.js

@@ -0,0 +1,24 @@
+export const studioDependencies = {
+    // Dependencies for a default Sanity installation
+    dependencies: {
+        // Official studio dependencies
+        sanity: 'latest',
+        // Official studio plugin dependencies
+        '@sanity/vision': 'latest',
+        // Non-Sanity dependencies
+        react: '^19.1',
+        'react-dom': '^19.1',
+        'styled-components': '^6.1.18'
+    },
+    devDependencies: {
+        // Linting/tooling
+        '@sanity/eslint-config-studio': 'latest',
+        // When using typescript, we'll want the these types too, so might as well install them
+        '@types/react': '^19.1',
+        eslint: '^9.28',
+        prettier: '^3.5',
+        typescript: '^5.8'
+    }
+};
+
+//# sourceMappingURL=studioDependencies.js.map

package/dist/studioDependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/studioDependencies.ts"],"sourcesContent":["export const studioDependencies = {\n  // Dependencies for a default Sanity installation\n  dependencies: {\n    // Official studio dependencies\n    sanity: 'latest',\n\n    // Official studio plugin dependencies\n    '@sanity/vision': 'latest',\n\n    // Non-Sanity dependencies\n    react: '^19.1',\n    'react-dom': '^19.1',\n    'styled-components': '^6.1.18',\n  },\n\n  devDependencies: {\n    // Linting/tooling\n    '@sanity/eslint-config-studio': 'latest',\n    // When using typescript, we'll want the these types too, so might as well install them\n    '@types/react': '^19.1',\n    eslint: '^9.28',\n    prettier: '^3.5',\n    typescript: '^5.8', // Peer dependency of eslint-config-studio (implicitly)\n  },\n}\n"],"names":["studioDependencies","dependencies","sanity","react","devDependencies","eslint","prettier","typescript"],"mappings":"AAAA,OAAO,MAAMA,qBAAqB;IAChC,iDAAiD;IACjDC,cAAc;QACZ,+BAA+B;QAC/BC,QAAQ;QAER,sCAAsC;QACtC,kBAAkB;QAElB,0BAA0B;QAC1BC,OAAO;QACP,aAAa;QACb,qBAAqB;IACvB;IAEAC,iBAAiB;QACf,kBAAkB;QAClB,gCAAgC;QAChC,uFAAuF;QACvF,gBAAgB;QAChBC,QAAQ;QACRC,UAAU;QACVC,YAAY;IACd;AACF,EAAC"}

package/dist/telemetry/cli.telemetry.d.ts

@@ -0,0 +1,20 @@
+export interface CLITraceData {
+    /**
+     * Command arguments, eg any arguments after `sanity <command>` (no flags)
+     */
+    commandArguments: string[];
+    coreOptions: {
+        debug?: boolean;
+        help?: boolean;
+        version?: boolean;
+    };
+    /**
+     * Arguments after the ended argument list (--)
+     */
+    extraArguments: string[];
+    /**
+     * Command flags, without the core options (help, debug, version etc)
+     */
+    groupOrCommand: string;
+}
+export declare const CliCommandTelemetry: import("@sanity/telemetry").DefinedTelemetryTrace<CLITraceData, void>;

package/dist/telemetry/cli.telemetry.js

@@ -0,0 +1,8 @@
+import { defineTrace } from '@sanity/telemetry';
+export const CliCommandTelemetry = defineTrace({
+    description: 'A CLI command was executed',
+    name: 'CLI Command Executed',
+    version: 1
+});
+
+//# sourceMappingURL=cli.telemetry.js.map

package/dist/telemetry/cli.telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/cli.telemetry.ts"],"sourcesContent":["import {defineTrace} from '@sanity/telemetry'\n\nexport interface CLITraceData {\n  /**\n   * Command arguments, eg any arguments after `sanity <command>` (no flags)\n   */\n  commandArguments: string[]\n\n  coreOptions: {\n    debug?: boolean\n    help?: boolean\n    version?: boolean\n  }\n\n  /**\n   * Arguments after the ended argument list (--)\n   */\n  extraArguments: string[]\n  /**\n   * Command flags, without the core options (help, debug, version etc)\n   */\n  groupOrCommand: string\n}\n\nexport const CliCommandTelemetry = defineTrace<CLITraceData>({\n  description: 'A CLI command was executed',\n  name: 'CLI Command Executed',\n  version: 1,\n})\n"],"names":["defineTrace","CliCommandTelemetry","description","name","version"],"mappings":"AAAA,SAAQA,WAAW,QAAO,oBAAmB;AAwB7C,OAAO,MAAMC,sBAAsBD,YAA0B;IAC3DE,aAAa;IACbC,MAAM;IACNC,SAAS;AACX,GAAE"}

package/dist/telemetry/store/cleanupOldTelemetryFiles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Cleans up telemetry files older than the specified number of days
+ * @internal
+ */
+export declare function cleanupOldTelemetryFiles(maxAgeDays?: number): Promise<void>;

package/dist/telemetry/store/cleanupOldTelemetryFiles.js

@@ -0,0 +1,30 @@
+import { rm, stat } from 'node:fs/promises';
+import { telemetryStoreDebug } from './debug.js';
+import { findTelemetryFiles } from './findTelemetryFiles.js';
+/**
+ * Cleans up telemetry files older than the specified number of days
+ * @internal
+ */ export async function cleanupOldTelemetryFiles(maxAgeDays = 7) {
+    try {
+        const files = await findTelemetryFiles();
+        const cutoffTime = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+        for (const filePath of files){
+            try {
+                const stats = await stat(filePath);
+                if (stats.mtime.getTime() < cutoffTime) {
+                    telemetryStoreDebug('Cleaning up old telemetry file: %s', filePath);
+                    await rm(filePath, {
+                        force: true
+                    });
+                }
+            } catch (error) {
+                telemetryStoreDebug('Error checking/removing old file %s: %o', filePath, error);
+            }
+        }
+    } catch (error) {
+        telemetryStoreDebug('Error during cleanup: %o', error);
+    // Don't throw - cleanup is best effort
+    }
+}
+
+//# sourceMappingURL=cleanupOldTelemetryFiles.js.map

package/dist/telemetry/store/cleanupOldTelemetryFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/telemetry/store/cleanupOldTelemetryFiles.ts"],"sourcesContent":["import {rm, stat} from 'node:fs/promises'\n\nimport {telemetryStoreDebug} from './debug.js'\nimport {findTelemetryFiles} from './findTelemetryFiles.js'\n\n/**\n * Cleans up telemetry files older than the specified number of days\n * @internal\n */\nexport async function cleanupOldTelemetryFiles(maxAgeDays: number = 7): Promise<void> {\n  try {\n    const files = await findTelemetryFiles()\n    const cutoffTime = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000\n\n    for (const filePath of files) {\n      try {\n        const stats = await stat(filePath)\n        if (stats.mtime.getTime() < cutoffTime) {\n          telemetryStoreDebug('Cleaning up old telemetry file: %s', filePath)\n          await rm(filePath, {force: true})\n        }\n      } catch (error) {\n        telemetryStoreDebug('Error checking/removing old file %s: %o', filePath, error)\n      }\n    }\n  } catch (error) {\n    telemetryStoreDebug('Error during cleanup: %o', error)\n    // Don't throw - cleanup is best effort\n  }\n}\n"],"names":["rm","stat","telemetryStoreDebug","findTelemetryFiles","cleanupOldTelemetryFiles","maxAgeDays","files","cutoffTime","Date","now","filePath","stats","mtime","getTime","force","error"],"mappings":"AAAA,SAAQA,EAAE,EAAEC,IAAI,QAAO,mBAAkB;AAEzC,SAAQC,mBAAmB,QAAO,aAAY;AAC9C,SAAQC,kBAAkB,QAAO,0BAAyB;AAE1D;;;CAGC,GACD,OAAO,eAAeC,yBAAyBC,aAAqB,CAAC;IACnE,IAAI;QACF,MAAMC,QAAQ,MAAMH;QACpB,MAAMI,aAAaC,KAAKC,GAAG,KAAKJ,aAAa,KAAK,KAAK,KAAK;QAE5D,KAAK,MAAMK,YAAYJ,MAAO;YAC5B,IAAI;gBACF,MAAMK,QAAQ,MAAMV,KAAKS;gBACzB,IAAIC,MAAMC,KAAK,CAACC,OAAO,KAAKN,YAAY;oBACtCL,oBAAoB,sCAAsCQ;oBAC1D,MAAMV,GAAGU,UAAU;wBAACI,OAAO;oBAAI;gBACjC;YACF,EAAE,OAAOC,OAAO;gBACdb,oBAAoB,2CAA2CQ,UAAUK;YAC3E;QACF;IACF,EAAE,OAAOA,OAAO;QACdb,oBAAoB,4BAA4Ba;IAChD,uCAAuC;IACzC;AACF"}

package/dist/telemetry/store/createTelemetryStore.d.ts

@@ -0,0 +1,39 @@
+import { type TelemetryStore } from '@sanity/telemetry';
+import { type ConsentInformation } from '../../actions/telemetry/types.js';
+/**
+ * FILE MANAGEMENT STRATEGY:
+ *
+ * The telemetry system uses a multi-file approach to handle concurrent CLI processes:
+ *
+ * 1. WRITING (per session):
+ *    - Each CLI session gets a unique file: telemetry-\{hash\}-\{env\}-\{sessionId\}.ndjson
+ *    - Prevents write conflicts when multiple CLI commands run simultaneously
+ *    - Events are written using an RxJS queue for ordered processing with retry logic
+ *
+ * 2. FLUSHING (aggregate all sessions):
+ *    - findTelemetryFiles() discovers ALL telemetry files for user/environment
+ *    - Events are collected from all session files and sent as a batch
+ *    - Files are deleted after successful transmission
+ *
+ * 3. CLEANUP (background maintenance):
+ *    - cleanupOldTelemetryFiles() removes stale files older than 7 days
+ *    - Prevents disk space accumulation from abandoned sessions
+ */
+interface CreateTelemetryStoreOptions {
+    resolveConsent: () => Promise<ConsentInformation>;
+}
+type CLITelemetryStore<T> = Pick<TelemetryStore<T>, 'logger'>;
+/**
+ * Creates a file-based telemetry store with cached consent and reliable synchronous I/O.
+ *
+ * Key optimizations:
+ * - Consent resolved once at creation and cached (vs checking on every emit)
+ * - File path generated and directory created once during initialization
+ * - Synchronous file writes to ensure events are captured even during process exit
+ *
+ * @param sessionId - Unique session identifier for file isolation
+ * @param options - Configuration options
+ * @returns TelemetryStore instance compatible with the telemetry interface
+ */
+export declare function createTelemetryStore<UserProperties>(sessionId: string, options: CreateTelemetryStoreOptions): CLITelemetryStore<UserProperties>;
+export {};

package/dist/telemetry/store/createTelemetryStore.js

@@ -0,0 +1,95 @@
+import { appendFileSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { telemetryStoreDebug } from './debug.js';
+import { generateTelemetryFilePath } from './generateTelemetryFilePath.js';
+import { createLogger } from './logger.js';
+/**
+ * Creates a file-based telemetry store with cached consent and reliable synchronous I/O.
+ *
+ * Key optimizations:
+ * - Consent resolved once at creation and cached (vs checking on every emit)
+ * - File path generated and directory created once during initialization
+ * - Synchronous file writes to ensure events are captured even during process exit
+ *
+ * @param sessionId - Unique session identifier for file isolation
+ * @param options - Configuration options
+ * @returns TelemetryStore instance compatible with the telemetry interface
+ */ export function createTelemetryStore(sessionId, options) {
+    telemetryStoreDebug('Creating telemetry store with sessionId: %s', sessionId);
+    let cachedConsent = null;
+    let filePath = null;
+    const initializeConsent = async ()=>{
+        if (cachedConsent) return;
+        try {
+            cachedConsent = await options.resolveConsent();
+            telemetryStoreDebug('Cached consent status: %s', cachedConsent.status);
+        } catch (error) {
+            telemetryStoreDebug('Failed to initialize consent, treating as undetermined: %o', error);
+            cachedConsent = {
+                reason: 'fetchError',
+                status: 'undetermined'
+            };
+        }
+    };
+    const initializeFilePath = async ()=>{
+        if (filePath) return;
+        try {
+            filePath = await generateTelemetryFilePath(sessionId);
+            telemetryStoreDebug('Generated file path: %s', filePath);
+            await mkdir(dirname(filePath), {
+                recursive: true
+            });
+            telemetryStoreDebug('Created directory structure for: %s', filePath);
+        } catch (error) {
+            telemetryStoreDebug('Failed to initialize file path: %o', error);
+            filePath = null;
+        }
+    };
+    const emit = (event)=>{
+        if (!cachedConsent || cachedConsent.status !== 'granted') {
+            if (cachedConsent) {
+                telemetryStoreDebug('Cached consent not granted (%s), skipping event: %s', cachedConsent.status, event.type);
+            } else {
+                telemetryStoreDebug('Consent not resolved, skipping event: %s', event.type);
+            }
+            return;
+        }
+        if (!filePath) {
+            telemetryStoreDebug('File path not initialized, skipping event: %s', event.type);
+            return;
+        }
+        telemetryStoreDebug('Emitting event: %s', event.type);
+        try {
+            const eventLine = JSON.stringify(event) + '\n';
+            // We use synchronous file writes to ensure telemetry events are captured even when
+            // the process exits abruptly (process.exit, uncaught exceptions, SIGTERM, etc.).
+            // The performance impact is probably negligible and is worth the trade-off
+            // for 100% reliability. Async writes would be lost when the event loop
+            // shuts down during process exit.
+            appendFileSync(filePath, eventLine, 'utf8');
+            telemetryStoreDebug('Successfully wrote event to file: %s', filePath);
+        } catch (error) {
+            telemetryStoreDebug('Failed to write telemetry event: %o', error);
+        // Silent failure - don't break CLI functionality
+        }
+    };
+    const logger = createLogger(sessionId, emit);
+    // Initialize both consent and file path concurrently
+    Promise.allSettled([
+        initializeConsent(),
+        initializeFilePath()
+    ]).then((results)=>{
+        for (const [index, result] of results.entries()){
+            if (result.status === 'rejected') {
+                const type = index === 0 ? 'consent' : 'file path';
+                telemetryStoreDebug('Error initializing %s: %o', type, result.reason);
+            }
+        }
+    });
+    return {
+        logger
+    };
+}
+
+//# sourceMappingURL=createTelemetryStore.js.map

package/dist/telemetry/store/createTelemetryStore.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/telemetry/store/createTelemetryStore.ts"],"sourcesContent":["import {appendFileSync} from 'node:fs'\nimport {mkdir} from 'node:fs/promises'\nimport {dirname} from 'node:path'\n\nimport {type TelemetryEvent, type TelemetryStore} from '@sanity/telemetry'\n\nimport {type ConsentInformation} from '../../actions/telemetry/types.js'\nimport {telemetryStoreDebug} from './debug.js'\nimport {generateTelemetryFilePath} from './generateTelemetryFilePath.js'\nimport {createLogger} from './logger.js'\n\n/**\n * FILE MANAGEMENT STRATEGY:\n *\n * The telemetry system uses a multi-file approach to handle concurrent CLI processes:\n *\n * 1. WRITING (per session):\n *    - Each CLI session gets a unique file: telemetry-\\{hash\\}-\\{env\\}-\\{sessionId\\}.ndjson\n *    - Prevents write conflicts when multiple CLI commands run simultaneously\n *    - Events are written using an RxJS queue for ordered processing with retry logic\n *\n * 2. FLUSHING (aggregate all sessions):\n *    - findTelemetryFiles() discovers ALL telemetry files for user/environment\n *    - Events are collected from all session files and sent as a batch\n *    - Files are deleted after successful transmission\n *\n * 3. CLEANUP (background maintenance):\n *    - cleanupOldTelemetryFiles() removes stale files older than 7 days\n *    - Prevents disk space accumulation from abandoned sessions\n */\n\ninterface CreateTelemetryStoreOptions {\n  resolveConsent: () => Promise<ConsentInformation>\n}\n\ntype CLITelemetryStore<T> = Pick<TelemetryStore<T>, 'logger'>\n\n/**\n * Creates a file-based telemetry store with cached consent and reliable synchronous I/O.\n *\n * Key optimizations:\n * - Consent resolved once at creation and cached (vs checking on every emit)\n * - File path generated and directory created once during initialization\n * - Synchronous file writes to ensure events are captured even during process exit\n *\n * @param sessionId - Unique session identifier for file isolation\n * @param options - Configuration options\n * @returns TelemetryStore instance compatible with the telemetry interface\n */\nexport function createTelemetryStore<UserProperties>(\n  sessionId: string,\n  options: CreateTelemetryStoreOptions,\n): CLITelemetryStore<UserProperties> {\n  telemetryStoreDebug('Creating telemetry store with sessionId: %s', sessionId)\n\n  let cachedConsent: ConsentInformation | null = null\n  let filePath: string | null = null\n\n  const initializeConsent = async () => {\n    if (cachedConsent) return\n\n    try {\n      cachedConsent = await options.resolveConsent()\n      telemetryStoreDebug('Cached consent status: %s', cachedConsent.status)\n    } catch (error) {\n      telemetryStoreDebug('Failed to initialize consent, treating as undetermined: %o', error)\n      cachedConsent = {reason: 'fetchError', status: 'undetermined'}\n    }\n  }\n\n  const initializeFilePath = async () => {\n    if (filePath) return\n\n    try {\n      filePath = await generateTelemetryFilePath(sessionId)\n      telemetryStoreDebug('Generated file path: %s', filePath)\n\n      await mkdir(dirname(filePath), {recursive: true})\n      telemetryStoreDebug('Created directory structure for: %s', filePath)\n    } catch (error) {\n      telemetryStoreDebug('Failed to initialize file path: %o', error)\n      filePath = null\n    }\n  }\n\n  const emit = (event: TelemetryEvent) => {\n    if (!cachedConsent || cachedConsent.status !== 'granted') {\n      if (cachedConsent) {\n        telemetryStoreDebug(\n          'Cached consent not granted (%s), skipping event: %s',\n          cachedConsent.status,\n          event.type,\n        )\n      } else {\n        telemetryStoreDebug('Consent not resolved, skipping event: %s', event.type)\n      }\n      return\n    }\n\n    if (!filePath) {\n      telemetryStoreDebug('File path not initialized, skipping event: %s', event.type)\n      return\n    }\n\n    telemetryStoreDebug('Emitting event: %s', event.type)\n\n    try {\n      const eventLine = JSON.stringify(event) + '\\n'\n\n      // We use synchronous file writes to ensure telemetry events are captured even when\n      // the process exits abruptly (process.exit, uncaught exceptions, SIGTERM, etc.).\n      // The performance impact is probably negligible and is worth the trade-off\n      // for 100% reliability. Async writes would be lost when the event loop\n      // shuts down during process exit.\n      appendFileSync(filePath, eventLine, 'utf8')\n      telemetryStoreDebug('Successfully wrote event to file: %s', filePath)\n    } catch (error) {\n      telemetryStoreDebug('Failed to write telemetry event: %o', error)\n      // Silent failure - don't break CLI functionality\n    }\n  }\n\n  const logger = createLogger<UserProperties>(sessionId, emit)\n\n  // Initialize both consent and file path concurrently\n  Promise.allSettled([initializeConsent(), initializeFilePath()]).then((results) => {\n    for (const [index, result] of results.entries()) {\n      if (result.status === 'rejected') {\n        const type = index === 0 ? 'consent' : 'file path'\n        telemetryStoreDebug('Error initializing %s: %o', type, result.reason)\n      }\n    }\n  })\n\n  return {\n    logger,\n  }\n}\n"],"names":["appendFileSync","mkdir","dirname","telemetryStoreDebug","generateTelemetryFilePath","createLogger","createTelemetryStore","sessionId","options","cachedConsent","filePath","initializeConsent","resolveConsent","status","error","reason","initializeFilePath","recursive","emit","event","type","eventLine","JSON","stringify","logger","Promise","allSettled","then","results","index","result","entries"],"mappings":"AAAA,SAAQA,cAAc,QAAO,UAAS;AACtC,SAAQC,KAAK,QAAO,mBAAkB;AACtC,SAAQC,OAAO,QAAO,YAAW;AAKjC,SAAQC,mBAAmB,QAAO,aAAY;AAC9C,SAAQC,yBAAyB,QAAO,iCAAgC;AACxE,SAAQC,YAAY,QAAO,cAAa;AA4BxC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,qBACdC,SAAiB,EACjBC,OAAoC;IAEpCL,oBAAoB,+CAA+CI;IAEnE,IAAIE,gBAA2C;IAC/C,IAAIC,WAA0B;IAE9B,MAAMC,oBAAoB;QACxB,IAAIF,eAAe;QAEnB,IAAI;YACFA,gBAAgB,MAAMD,QAAQI,cAAc;YAC5CT,oBAAoB,6BAA6BM,cAAcI,MAAM;QACvE,EAAE,OAAOC,OAAO;YACdX,oBAAoB,8DAA8DW;YAClFL,gBAAgB;gBAACM,QAAQ;gBAAcF,QAAQ;YAAc;QAC/D;IACF;IAEA,MAAMG,qBAAqB;QACzB,IAAIN,UAAU;QAEd,IAAI;YACFA,WAAW,MAAMN,0BAA0BG;YAC3CJ,oBAAoB,2BAA2BO;YAE/C,MAAMT,MAAMC,QAAQQ,WAAW;gBAACO,WAAW;YAAI;YAC/Cd,oBAAoB,uCAAuCO;QAC7D,EAAE,OAAOI,OAAO;YACdX,oBAAoB,sCAAsCW;YAC1DJ,WAAW;QACb;IACF;IAEA,MAAMQ,OAAO,CAACC;QACZ,IAAI,CAACV,iBAAiBA,cAAcI,MAAM,KAAK,WAAW;YACxD,IAAIJ,eAAe;gBACjBN,oBACE,uDACAM,cAAcI,MAAM,EACpBM,MAAMC,IAAI;YAEd,OAAO;gBACLjB,oBAAoB,4CAA4CgB,MAAMC,IAAI;YAC5E;YACA;QACF;QAEA,IAAI,CAACV,UAAU;YACbP,oBAAoB,iDAAiDgB,MAAMC,IAAI;YAC/E;QACF;QAEAjB,oBAAoB,sBAAsBgB,MAAMC,IAAI;QAEpD,IAAI;YACF,MAAMC,YAAYC,KAAKC,SAAS,CAACJ,SAAS;YAE1C,mFAAmF;YACnF,iFAAiF;YACjF,2EAA2E;YAC3E,uEAAuE;YACvE,kCAAkC;YAClCnB,eAAeU,UAAUW,WAAW;YACpClB,oBAAoB,wCAAwCO;QAC9D,EAAE,OAAOI,OAAO;YACdX,oBAAoB,uCAAuCW;QAC3D,iDAAiD;QACnD;IACF;IAEA,MAAMU,SAASnB,aAA6BE,WAAWW;IAEvD,qDAAqD;IACrDO,QAAQC,UAAU,CAAC;QAACf;QAAqBK;KAAqB,EAAEW,IAAI,CAAC,CAACC;QACpE,KAAK,MAAM,CAACC,OAAOC,OAAO,IAAIF,QAAQG,OAAO,GAAI;YAC/C,IAAID,OAAOjB,MAAM,KAAK,YAAY;gBAChC,MAAMO,OAAOS,UAAU,IAAI,YAAY;gBACvC1B,oBAAoB,6BAA6BiB,MAAMU,OAAOf,MAAM;YACtE;QACF;IACF;IAEA,OAAO;QACLS;IACF;AACF"}

package/dist/telemetry/store/createTraceId.d.ts

@@ -0,0 +1,10 @@
+type TraceId = string & {
+    __type: 'TraceId';
+};
+/**
+ * Creates a unique trace ID using typeid
+ *
+ * @internal
+ */
+export declare function createTraceId(): TraceId;
+export {};

package/dist/telemetry/store/createTraceId.js

@@ -0,0 +1,10 @@
+import { typeid } from 'typeid-js';
+/**
+ * Creates a unique trace ID using typeid
+ *
+ * @internal
+ */ export function createTraceId() {
+    return typeid('trace').toString();
+}
+
+//# sourceMappingURL=createTraceId.js.map

package/dist/telemetry/store/createTraceId.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/telemetry/store/createTraceId.ts"],"sourcesContent":["import {typeid} from 'typeid-js'\n\ntype TraceId = string & {__type: 'TraceId'}\n\n/**\n * Creates a unique trace ID using typeid\n *\n * @internal\n */\nexport function createTraceId(): TraceId {\n  return typeid('trace').toString() as TraceId\n}\n"],"names":["typeid","createTraceId","toString"],"mappings":"AAAA,SAAQA,MAAM,QAAO,YAAW;AAIhC;;;;CAIC,GACD,OAAO,SAASC;IACd,OAAOD,OAAO,SAASE,QAAQ;AACjC"}

package/dist/telemetry/store/debug.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Debug logger for telemetry store operations
+ * @internal
+ */
+export declare const telemetryStoreDebug: import("debug").Debugger;

package/dist/telemetry/store/debug.js

@@ -0,0 +1,7 @@
+import { telemetryDebug } from '../../actions/telemetry/telemetryDebug.js';
+/**
+ * Debug logger for telemetry store operations
+ * @internal
+ */ export const telemetryStoreDebug = telemetryDebug.extend('telemetryStore');
+
+//# sourceMappingURL=debug.js.map

package/dist/telemetry/store/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/telemetry/store/debug.ts"],"sourcesContent":["import {telemetryDebug} from '../../actions/telemetry/telemetryDebug.js'\n\n/**\n * Debug logger for telemetry store operations\n * @internal\n */\nexport const telemetryStoreDebug = telemetryDebug.extend('telemetryStore')\n"],"names":["telemetryDebug","telemetryStoreDebug","extend"],"mappings":"AAAA,SAAQA,cAAc,QAAO,4CAA2C;AAExE;;;CAGC,GACD,OAAO,MAAMC,sBAAsBD,eAAeE,MAAM,CAAC,kBAAiB"}