@sanity/cli 8.25.0 → 8.27.0

package/dist/util/telemetry/cliCommandIdentity.js

@@ -0,0 +1,222 @@
+// Command paths only: positional user input must never become command identity.
+const commandPaths = new Set([
+    'api',
+    'assets upload',
+    'backup disable',
+    'backup download',
+    'backup enable',
+    'backup list',
+    'backups disable',
+    'backups download',
+    'backups enable',
+    'backups list',
+    'blueprints add',
+    'blueprints config',
+    'blueprints deploy',
+    'blueprints destroy',
+    'blueprints doctor',
+    'blueprints info',
+    'blueprints init',
+    'blueprints logs',
+    'blueprints mint-deploy-token',
+    'blueprints plan',
+    'blueprints promote',
+    'blueprints stacks',
+    'build',
+    'check',
+    'codemod',
+    'context build',
+    'context create',
+    'context delete',
+    'context entries get',
+    'context entries list',
+    'context entries rebuild',
+    'context get',
+    'context imports create',
+    'context imports delete',
+    'context imports download',
+    'context imports get',
+    'context imports list',
+    'context issues apply',
+    'context issues dismiss',
+    'context issues get',
+    'context issues list',
+    'context issues reopen',
+    'context issues resolve',
+    'context jobs get',
+    'context list',
+    'context mcp create',
+    'context mcp delete',
+    'context mcp get',
+    'context mcp list',
+    'context mcp status',
+    'context mcp update',
+    'context query',
+    'context refresh',
+    'context update',
+    'cors add',
+    'cors delete',
+    'cors list',
+    'dataset alias create',
+    'dataset alias delete',
+    'dataset alias link',
+    'dataset alias unlink',
+    'dataset copy',
+    'dataset create',
+    'dataset delete',
+    'dataset export',
+    'dataset import',
+    'dataset list',
+    'datasets alias create',
+    'datasets alias delete',
+    'datasets alias link',
+    'datasets alias unlink',
+    'datasets copy',
+    'datasets create',
+    'datasets delete',
+    'datasets embeddings disable',
+    'datasets embeddings enable',
+    'datasets embeddings status',
+    'datasets export',
+    'datasets import',
+    'datasets list',
+    'datasets visibility get',
+    'datasets visibility set',
+    'dataset visibility get',
+    'dataset visibility set',
+    'debug',
+    'deploy',
+    'dev',
+    'docs browse',
+    'docs read',
+    'docs search',
+    'doctor',
+    'documents create',
+    'documents delete',
+    'documents get',
+    'documents query',
+    'documents validate',
+    'exec',
+    'functions add',
+    'functions build',
+    'functions deploy',
+    'functions dev',
+    'functions env add',
+    'functions env list',
+    'functions env remove',
+    'functions list',
+    'functions logs',
+    'functions test',
+    'graphql deploy',
+    'graphql list',
+    'graphql undeploy',
+    'help',
+    'hook list',
+    'hooks attempt',
+    'hooks create',
+    'hooks delete',
+    'hooks list',
+    'hooks logs',
+    'init',
+    'init plugin',
+    'install',
+    'learn',
+    'login',
+    'logout',
+    'manage',
+    'manifest extract',
+    'mcp configure',
+    'media create-aspect',
+    'media delete-aspect',
+    'media deploy-aspect',
+    'media export',
+    'media import',
+    'media prune-aspect-data',
+    'media pull-aspects',
+    'migration create',
+    'migration list',
+    'migration run',
+    'migrations create',
+    'migrations list',
+    'migrations run',
+    'new',
+    'openapi get',
+    'openapi list',
+    'organizations create',
+    'organizations delete',
+    'organizations get',
+    'organizations list',
+    'organizations update',
+    'preview',
+    'projects create',
+    'projects list',
+    'projects unclaimed',
+    'schema delete',
+    'schema deploy',
+    'schema extract',
+    'schema list',
+    'schemas delete',
+    'schemas deploy',
+    'schemas extract',
+    'schemas list',
+    'schemas validate',
+    'schema validate',
+    'skills install',
+    'telemetry disable',
+    'telemetry enable',
+    'telemetry status',
+    'tokens create',
+    'tokens delete',
+    'tokens list',
+    'tokens rotate',
+    'typegen generate',
+    'undeploy',
+    'uninstall',
+    'upgrade',
+    'users invite',
+    'users list',
+    'versions',
+    'whoami',
+    'workflows abort',
+    'workflows blueprint generate',
+    'workflows definition delete',
+    'workflows definition diff',
+    'workflows definition list',
+    'workflows definition show',
+    'workflows deploy',
+    'workflows diagnose',
+    'workflows fire-action',
+    'workflows list',
+    'workflows nuke',
+    'workflows reset-activity',
+    'workflows set-stage',
+    'workflows show',
+    'workflows start',
+    'workflows tail'
+]);
+const knownRoots = new Set([
+    ...commandPaths
+].map((path)=>path.split(' ')[0]));
+export function commandIdentity(group, args) {
+    const root = typeof group === 'string' ? group.split(':') : [];
+    const parts = [
+        ...root,
+        ...Array.isArray(args) ? args : []
+    ];
+    if (!knownRoots.has(root[0])) return {
+        commandArguments: [],
+        groupOrCommand: 'unknown'
+    };
+    let commandArguments = [];
+    for(let length = 2; length <= Math.min(parts.length, 4); length++){
+        const candidate = parts.slice(0, length);
+        if (!candidate.every((part)=>typeof part === 'string')) break;
+        if (commandPaths.has(candidate.join(' '))) commandArguments = candidate.slice(1);
+    }
+    return {
+        commandArguments,
+        groupOrCommand: root[0]
+    };
+}
+
+//# sourceMappingURL=cliCommandIdentity.js.map

package/dist/util/telemetry/cliCommandIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/util/telemetry/cliCommandIdentity.ts"],"sourcesContent":["// Command paths only: positional user input must never become command identity.\nconst commandPaths = new Set([\n  'api',\n  'assets upload',\n  'backup disable',\n  'backup download',\n  'backup enable',\n  'backup list',\n  'backups disable',\n  'backups download',\n  'backups enable',\n  'backups list',\n  'blueprints add',\n  'blueprints config',\n  'blueprints deploy',\n  'blueprints destroy',\n  'blueprints doctor',\n  'blueprints info',\n  'blueprints init',\n  'blueprints logs',\n  'blueprints mint-deploy-token',\n  'blueprints plan',\n  'blueprints promote',\n  'blueprints stacks',\n  'build',\n  'check',\n  'codemod',\n  'context build',\n  'context create',\n  'context delete',\n  'context entries get',\n  'context entries list',\n  'context entries rebuild',\n  'context get',\n  'context imports create',\n  'context imports delete',\n  'context imports download',\n  'context imports get',\n  'context imports list',\n  'context issues apply',\n  'context issues dismiss',\n  'context issues get',\n  'context issues list',\n  'context issues reopen',\n  'context issues resolve',\n  'context jobs get',\n  'context list',\n  'context mcp create',\n  'context mcp delete',\n  'context mcp get',\n  'context mcp list',\n  'context mcp status',\n  'context mcp update',\n  'context query',\n  'context refresh',\n  'context update',\n  'cors add',\n  'cors delete',\n  'cors list',\n  'dataset alias create',\n  'dataset alias delete',\n  'dataset alias link',\n  'dataset alias unlink',\n  'dataset copy',\n  'dataset create',\n  'dataset delete',\n  'dataset export',\n  'dataset import',\n  'dataset list',\n  'datasets alias create',\n  'datasets alias delete',\n  'datasets alias link',\n  'datasets alias unlink',\n  'datasets copy',\n  'datasets create',\n  'datasets delete',\n  'datasets embeddings disable',\n  'datasets embeddings enable',\n  'datasets embeddings status',\n  'datasets export',\n  'datasets import',\n  'datasets list',\n  'datasets visibility get',\n  'datasets visibility set',\n  'dataset visibility get',\n  'dataset visibility set',\n  'debug',\n  'deploy',\n  'dev',\n  'docs browse',\n  'docs read',\n  'docs search',\n  'doctor',\n  'documents create',\n  'documents delete',\n  'documents get',\n  'documents query',\n  'documents validate',\n  'exec',\n  'functions add',\n  'functions build',\n  'functions deploy',\n  'functions dev',\n  'functions env add',\n  'functions env list',\n  'functions env remove',\n  'functions list',\n  'functions logs',\n  'functions test',\n  'graphql deploy',\n  'graphql list',\n  'graphql undeploy',\n  'help',\n  'hook list',\n  'hooks attempt',\n  'hooks create',\n  'hooks delete',\n  'hooks list',\n  'hooks logs',\n  'init',\n  'init plugin',\n  'install',\n  'learn',\n  'login',\n  'logout',\n  'manage',\n  'manifest extract',\n  'mcp configure',\n  'media create-aspect',\n  'media delete-aspect',\n  'media deploy-aspect',\n  'media export',\n  'media import',\n  'media prune-aspect-data',\n  'media pull-aspects',\n  'migration create',\n  'migration list',\n  'migration run',\n  'migrations create',\n  'migrations list',\n  'migrations run',\n  'new',\n  'openapi get',\n  'openapi list',\n  'organizations create',\n  'organizations delete',\n  'organizations get',\n  'organizations list',\n  'organizations update',\n  'preview',\n  'projects create',\n  'projects list',\n  'projects unclaimed',\n  'schema delete',\n  'schema deploy',\n  'schema extract',\n  'schema list',\n  'schemas delete',\n  'schemas deploy',\n  'schemas extract',\n  'schemas list',\n  'schemas validate',\n  'schema validate',\n  'skills install',\n  'telemetry disable',\n  'telemetry enable',\n  'telemetry status',\n  'tokens create',\n  'tokens delete',\n  'tokens list',\n  'tokens rotate',\n  'typegen generate',\n  'undeploy',\n  'uninstall',\n  'upgrade',\n  'users invite',\n  'users list',\n  'versions',\n  'whoami',\n  'workflows abort',\n  'workflows blueprint generate',\n  'workflows definition delete',\n  'workflows definition diff',\n  'workflows definition list',\n  'workflows definition show',\n  'workflows deploy',\n  'workflows diagnose',\n  'workflows fire-action',\n  'workflows list',\n  'workflows nuke',\n  'workflows reset-activity',\n  'workflows set-stage',\n  'workflows show',\n  'workflows start',\n  'workflows tail',\n])\n\nconst knownRoots = new Set([...commandPaths].map((path) => path.split(' ')[0]))\n\nexport function commandIdentity(group: unknown, args: unknown) {\n  const root = typeof group === 'string' ? group.split(':') : []\n  const parts = [...root, ...(Array.isArray(args) ? args : [])]\n  if (!knownRoots.has(root[0])) return {commandArguments: [], groupOrCommand: 'unknown'}\n\n  let commandArguments: string[] = []\n  for (let length = 2; length <= Math.min(parts.length, 4); length++) {\n    const candidate = parts.slice(0, length)\n    if (!candidate.every((part) => typeof part === 'string')) break\n    if (commandPaths.has(candidate.join(' '))) commandArguments = candidate.slice(1)\n  }\n  return {commandArguments, groupOrCommand: root[0]}\n}\n"],"names":["commandPaths","Set","knownRoots","map","path","split","commandIdentity","group","args","root","parts","Array","isArray","has","commandArguments","groupOrCommand","length","Math","min","candidate","slice","every","part","join"],"mappings":"AAAA,gFAAgF;AAChF,MAAMA,eAAe,IAAIC,IAAI;IAC3B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED,MAAMC,aAAa,IAAID,IAAI;OAAID;CAAa,CAACG,GAAG,CAAC,CAACC,OAASA,KAAKC,KAAK,CAAC,IAAI,CAAC,EAAE;AAE7E,OAAO,SAASC,gBAAgBC,KAAc,EAAEC,IAAa;IAC3D,MAAMC,OAAO,OAAOF,UAAU,WAAWA,MAAMF,KAAK,CAAC,OAAO,EAAE;IAC9D,MAAMK,QAAQ;WAAID;WAAUE,MAAMC,OAAO,CAACJ,QAAQA,OAAO,EAAE;KAAE;IAC7D,IAAI,CAACN,WAAWW,GAAG,CAACJ,IAAI,CAAC,EAAE,GAAG,OAAO;QAACK,kBAAkB,EAAE;QAAEC,gBAAgB;IAAS;IAErF,IAAID,mBAA6B,EAAE;IACnC,IAAK,IAAIE,SAAS,GAAGA,UAAUC,KAAKC,GAAG,CAACR,MAAMM,MAAM,EAAE,IAAIA,SAAU;QAClE,MAAMG,YAAYT,MAAMU,KAAK,CAAC,GAAGJ;QACjC,IAAI,CAACG,UAAUE,KAAK,CAAC,CAACC,OAAS,OAAOA,SAAS,WAAW;QAC1D,IAAItB,aAAaa,GAAG,CAACM,UAAUI,IAAI,CAAC,OAAOT,mBAAmBK,UAAUC,KAAK,CAAC;IAChF;IACA,OAAO;QAACN;QAAkBC,gBAAgBN,IAAI,CAAC,EAAE;IAAA;AACnD"}

package/dist/util/telemetry/cliTelemetryFlags.js

@@ -0,0 +1,186 @@
+// This catalog grants collection of flag names. Values require a separate enum.
+// Removing an entry always reduces collection, including for pinned clients.
+const knownFlags = new Set([
+    'aspect',
+    'bare',
+    'cadence',
+    'config-path',
+    'coupon',
+    'create-project',
+    'dataset',
+    'debug',
+    'debug-metafile-path',
+    'description',
+    'embeddings-projection',
+    'env',
+    'field',
+    'file',
+    'filename',
+    'force',
+    'format',
+    'from-export',
+    'from-url',
+    'generation',
+    'git',
+    'header',
+    'help',
+    'host',
+    'include',
+    'input',
+    'json',
+    'level',
+    'limit',
+    'manifest-dir',
+    'method',
+    'mode',
+    'name',
+    'offset',
+    'order',
+    'organization',
+    'out',
+    'output',
+    'output-path',
+    'package-manager',
+    'params',
+    'path',
+    'port',
+    'project',
+    'project-id',
+    'project-name',
+    'projection',
+    'query',
+    'raw-field',
+    'sort',
+    'template',
+    'template-token',
+    'text',
+    'title',
+    'token',
+    'type',
+    'url',
+    'version',
+    'visibility',
+    'watch',
+    'watch-patterns',
+    'workspace',
+    'yes'
+]);
+const values = {
+    cadence: [
+        'weekly',
+        'monthly'
+    ],
+    format: [
+        'json',
+        'ndjson',
+        'pretty',
+        'yaml'
+    ],
+    generation: [
+        'gen1',
+        'gen2',
+        'gen3'
+    ],
+    level: [
+        'error',
+        'warning',
+        'info'
+    ],
+    method: [
+        'GET',
+        'POST',
+        'PUT',
+        'PATCH',
+        'DELETE',
+        'HEAD',
+        'OPTIONS'
+    ],
+    mode: [
+        'stream',
+        'cursor'
+    ],
+    order: [
+        'asc',
+        'desc'
+    ],
+    'package-manager': [
+        'npm',
+        'pnpm',
+        'yarn',
+        'bun'
+    ],
+    type: [
+        'image',
+        'file'
+    ],
+    visibility: [
+        'public',
+        'private'
+    ]
+};
+const aliases = {
+    d: 'debug',
+    F: 'field',
+    f: 'raw-field',
+    H: 'header',
+    h: 'help',
+    i: 'include',
+    j: 'json',
+    t: 'token',
+    v: 'version',
+    X: 'method',
+    y: 'yes'
+};
+const shortBooleans = new Set([
+    'd',
+    'h',
+    'i',
+    'j',
+    'v',
+    'y'
+]);
+function flag(name, value) {
+    if (!knownFlags.has(name)) return undefined;
+    if (Object.hasOwn(values, name) && value !== undefined && values[name].includes(value)) {
+        return `--${name}=${value}`;
+    }
+    return `--${name}`;
+}
+export function sanitizeCliFlags(input) {
+    if (!Array.isArray(input)) return [];
+    const result = [];
+    for (const argument of input){
+        if (argument === '--') break;
+        if (typeof argument !== 'string') continue;
+        const long = /^--([A-Za-z][A-Za-z0-9-]*)(?:=([\s\S]*))?$/.exec(argument);
+        if (long) {
+            const safe = flag(long[1], long[2]);
+            if (safe) result.push(safe);
+            continue;
+        }
+        if (!/^-[A-Za-z]/.test(argument)) continue;
+        for(let index = 1; index < argument.length; index++){
+            const short = argument[index];
+            if (!Object.hasOwn(aliases, short)) break;
+            const name = aliases[short];
+            if (shortBooleans.has(short)) {
+                result.push(`--${name}`);
+                continue;
+            }
+            const safe = flag(name, argument.slice(index + 1).replace(/^=/, ''));
+            if (safe) result.push(safe);
+            break;
+        }
+    }
+    return result;
+}
+export function sanitizeCliFlagRecord(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) return {};
+    const result = {};
+    for (const [name, value] of Object.entries(input)){
+        if (knownFlags.has(name)) result[name] = Boolean(value);
+    }
+    return result;
+}
+
+//# sourceMappingURL=cliTelemetryFlags.js.map

package/dist/util/telemetry/cliTelemetryFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/util/telemetry/cliTelemetryFlags.ts"],"sourcesContent":["// This catalog grants collection of flag names. Values require a separate enum.\n// Removing an entry always reduces collection, including for pinned clients.\nconst knownFlags = new Set([\n  'aspect',\n  'bare',\n  'cadence',\n  'config-path',\n  'coupon',\n  'create-project',\n  'dataset',\n  'debug',\n  'debug-metafile-path',\n  'description',\n  'embeddings-projection',\n  'env',\n  'field',\n  'file',\n  'filename',\n  'force',\n  'format',\n  'from-export',\n  'from-url',\n  'generation',\n  'git',\n  'header',\n  'help',\n  'host',\n  'include',\n  'input',\n  'json',\n  'level',\n  'limit',\n  'manifest-dir',\n  'method',\n  'mode',\n  'name',\n  'offset',\n  'order',\n  'organization',\n  'out',\n  'output',\n  'output-path',\n  'package-manager',\n  'params',\n  'path',\n  'port',\n  'project',\n  'project-id',\n  'project-name',\n  'projection',\n  'query',\n  'raw-field',\n  'sort',\n  'template',\n  'template-token',\n  'text',\n  'title',\n  'token',\n  'type',\n  'url',\n  'version',\n  'visibility',\n  'watch',\n  'watch-patterns',\n  'workspace',\n  'yes',\n])\nconst values: Record<string, readonly string[]> = {\n  cadence: ['weekly', 'monthly'],\n  format: ['json', 'ndjson', 'pretty', 'yaml'],\n  generation: ['gen1', 'gen2', 'gen3'],\n  level: ['error', 'warning', 'info'],\n  method: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'],\n  mode: ['stream', 'cursor'],\n  order: ['asc', 'desc'],\n  'package-manager': ['npm', 'pnpm', 'yarn', 'bun'],\n  type: ['image', 'file'],\n  visibility: ['public', 'private'],\n}\nconst aliases: Record<string, string> = {\n  d: 'debug',\n  F: 'field',\n  f: 'raw-field',\n  H: 'header',\n  h: 'help',\n  i: 'include',\n  j: 'json',\n  t: 'token',\n  v: 'version',\n  X: 'method',\n  y: 'yes',\n}\nconst shortBooleans = new Set(['d', 'h', 'i', 'j', 'v', 'y'])\n\nfunction flag(name: string, value?: string): string | undefined {\n  if (!knownFlags.has(name)) return undefined\n  if (Object.hasOwn(values, name) && value !== undefined && values[name].includes(value)) {\n    return `--${name}=${value}`\n  }\n  return `--${name}`\n}\n\nexport function sanitizeCliFlags(input: unknown): string[] {\n  if (!Array.isArray(input)) return []\n  const result: string[] = []\n  for (const argument of input) {\n    if (argument === '--') break\n    if (typeof argument !== 'string') continue\n    const long = /^--([A-Za-z][A-Za-z0-9-]*)(?:=([\\s\\S]*))?$/.exec(argument)\n    if (long) {\n      const safe = flag(long[1], long[2])\n      if (safe) result.push(safe)\n      continue\n    }\n    if (!/^-[A-Za-z]/.test(argument)) continue\n    for (let index = 1; index < argument.length; index++) {\n      const short = argument[index]\n      if (!Object.hasOwn(aliases, short)) break\n      const name = aliases[short]\n      if (shortBooleans.has(short)) {\n        result.push(`--${name}`)\n        continue\n      }\n      const safe = flag(name, argument.slice(index + 1).replace(/^=/, ''))\n      if (safe) result.push(safe)\n      break\n    }\n  }\n  return result\n}\n\nexport function sanitizeCliFlagRecord(input: unknown): Record<string, boolean> {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) return {}\n  const result: Record<string, boolean> = {}\n  for (const [name, value] of Object.entries(input)) {\n    if (knownFlags.has(name)) result[name] = Boolean(value)\n  }\n  return result\n}\n"],"names":["knownFlags","Set","values","cadence","format","generation","level","method","mode","order","type","visibility","aliases","d","F","f","H","h","i","j","t","v","X","y","shortBooleans","flag","name","value","has","undefined","Object","hasOwn","includes","sanitizeCliFlags","input","Array","isArray","result","argument","long","exec","safe","push","test","index","length","short","slice","replace","sanitizeCliFlagRecord","entries","Boolean"],"mappings":"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"}

package/dist/util/telemetry/commandTelemetry.js

@@ -17,18 +17,63 @@
         })
     };
 }
-export function redactTelemetryArguments(arguments_, commandTelemetry) {
-    let forwarding = false;
-    return arguments_.map((argument)=>{
-        if (argument === '--') {
-            forwarding = true;
-            return argument;
+export function collectTelemetryFlags(argv, flags, telemetry) {
+    const definitions = new Map();
+    for (const [name, flag] of Object.entries(flags)){
+        const canonical = `--${name}`;
+        const definition = {
+            canonical,
+            option: flag.type === 'option',
+            redact: telemetry?.redactedFlags.some((entry)=>entry.canonical === canonical) ?? false
+        };
+        definitions.set(canonical, definition);
+        for (const alias of flag.aliases ?? []){
+            definitions.set(`${alias.length === 1 ? '-' : '--'}${alias}`, definition);
         }
-        if (forwarding) return argument;
-        const isShortOption = argument.startsWith('-') && !argument.startsWith('--');
-        const redactedFlag = commandTelemetry?.redactedFlags.find(({ flags })=>flags.some((syntax)=>syntax.startsWith('--') ? argument === syntax || argument.startsWith(`${syntax}=`) : isShortOption && argument.startsWith(syntax)));
-        return redactedFlag?.canonical ?? argument;
-    });
+        for (const char of [
+            flag.char,
+            ...flag.charAliases ?? []
+        ]){
+            if (char) definitions.set(`-${char}`, definition);
+        }
+        if (flag.type === 'boolean' && flag.allowNo) {
+            definitions.set(`--no-${name}`, {
+                ...definition,
+                canonical: `--no-${name}`
+            });
+        }
+    }
+    const result = [];
+    for(let index = 0; index < argv.length; index++){
+        const argument = argv[index];
+        if (argument === '--') break;
+        if (!argument.startsWith('-') || argument === '-') continue;
+        if (argument.startsWith('--')) {
+            const separator = argument.indexOf('=');
+            const name = separator === -1 ? argument : argument.slice(0, separator);
+            const flag = definitions.get(name);
+            // An unknown option may consume the next token, including a known flag's spelling.
+            // Stop rather than interpreting private input as telemetry.
+            if (!flag) break;
+            const value = separator === -1 ? undefined : argument.slice(separator + 1);
+            result.push(flag.redact || !flag.option || value === undefined ? flag.canonical : `${flag.canonical}=${value}`);
+            if (flag.option && separator === -1) index++;
+            continue;
+        }
+        for(let offset = 1; offset < argument.length; offset++){
+            const flag = definitions.get(`-${argument[offset]}`);
+            if (!flag) return result;
+            if (!flag.option) {
+                result.push(flag.canonical);
+                continue;
+            }
+            const value = argument.slice(offset + 1);
+            result.push(flag.redact || !value ? flag.canonical : `${flag.canonical}=${value.replace(/^=/, '')}`);
+            if (!value) index++;
+            break;
+        }
+    }
+    return result;
 }
 
 //# sourceMappingURL=commandTelemetry.js.map

package/dist/util/telemetry/commandTelemetry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/util/telemetry/commandTelemetry.ts"],"sourcesContent":["import {type Interfaces} from '@oclif/core'\n\ninterface RedactedFlag {\n  canonical: string\n  flags: readonly string[]\n}\n\n/** @internal */\nexport interface CommandTelemetry {\n  redactedFlags: readonly RedactedFlag[]\n}\n\ntype OptionFlagName<Flags extends Interfaces.FlagInput> = string &\n  {\n    [Name in keyof Flags]: Flags[Name] extends {type: 'option'} ? Name : never\n  }[keyof Flags]\n\ntype CommandTelemetryConfig<Flags extends Interfaces.FlagInput> = {\n  redact?: readonly OptionFlagName<Flags>[]\n}\n\n/** @internal */\nexport function defineCommandTelemetry<const Flags extends Interfaces.FlagInput>(\n  flags: Flags,\n  config: CommandTelemetryConfig<Flags>,\n): CommandTelemetry {\n  return {\n    redactedFlags: (config.redact ?? []).map((name) => {\n      const flag = flags[name]\n      const aliases = flag?.aliases ?? []\n\n      return {\n        canonical: `--${name}`,\n        flags: [\n          `--${name}`,\n          ...aliases.map((alias) => `${alias.length === 1 ? '-' : '--'}${alias}`),\n          ...(flag?.char ? [`-${flag.char}`] : []),\n          ...(flag?.charAliases ?? []).map((alias) => `-${alias}`),\n        ],\n      }\n    }),\n  }\n}\n\nexport function redactTelemetryArguments(\n  arguments_: string[],\n  commandTelemetry?: CommandTelemetry,\n): string[] {\n  let forwarding = false\n\n  return arguments_.map((argument) => {\n    if (argument === '--') {\n      forwarding = true\n      return argument\n    }\n\n    if (forwarding) return argument\n\n    const isShortOption = argument.startsWith('-') && !argument.startsWith('--')\n    const redactedFlag = commandTelemetry?.redactedFlags.find(({flags}) =>\n      flags.some((syntax) =>\n        syntax.startsWith('--')\n          ? argument === syntax || argument.startsWith(`${syntax}=`)\n          : isShortOption && argument.startsWith(syntax),\n      ),\n    )\n\n    return redactedFlag?.canonical ?? argument\n  })\n}\n"],"names":["defineCommandTelemetry","flags","config","redactedFlags","redact","map","name","flag","aliases","canonical","alias","length","char","charAliases","redactTelemetryArguments","arguments_","commandTelemetry","forwarding","argument","isShortOption","startsWith","redactedFlag","find","some","syntax"],"mappings":"AAqBA,cAAc,GACd,OAAO,SAASA,uBACdC,KAAY,EACZC,MAAqC;IAErC,OAAO;QACLC,eAAe,AAACD,CAAAA,OAAOE,MAAM,IAAI,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC;YACxC,MAAMC,OAAON,KAAK,CAACK,KAAK;YACxB,MAAME,UAAUD,MAAMC,WAAW,EAAE;YAEnC,OAAO;gBACLC,WAAW,CAAC,EAAE,EAAEH,MAAM;gBACtBL,OAAO;oBACL,CAAC,EAAE,EAAEK,MAAM;uBACRE,QAAQH,GAAG,CAAC,CAACK,QAAU,GAAGA,MAAMC,MAAM,KAAK,IAAI,MAAM,OAAOD,OAAO;uBAClEH,MAAMK,OAAO;wBAAC,CAAC,CAAC,EAAEL,KAAKK,IAAI,EAAE;qBAAC,GAAG,EAAE;uBACpC,AAACL,CAAAA,MAAMM,eAAe,EAAE,AAAD,EAAGR,GAAG,CAAC,CAACK,QAAU,CAAC,CAAC,EAAEA,OAAO;iBACxD;YACH;QACF;IACF;AACF;AAEA,OAAO,SAASI,yBACdC,UAAoB,EACpBC,gBAAmC;IAEnC,IAAIC,aAAa;IAEjB,OAAOF,WAAWV,GAAG,CAAC,CAACa;QACrB,IAAIA,aAAa,MAAM;YACrBD,aAAa;YACb,OAAOC;QACT;QAEA,IAAID,YAAY,OAAOC;QAEvB,MAAMC,gBAAgBD,SAASE,UAAU,CAAC,QAAQ,CAACF,SAASE,UAAU,CAAC;QACvE,MAAMC,eAAeL,kBAAkBb,cAAcmB,KAAK,CAAC,EAACrB,KAAK,EAAC,GAChEA,MAAMsB,IAAI,CAAC,CAACC,SACVA,OAAOJ,UAAU,CAAC,QACdF,aAAaM,UAAUN,SAASE,UAAU,CAAC,GAAGI,OAAO,CAAC,CAAC,IACvDL,iBAAiBD,SAASE,UAAU,CAACI;QAI7C,OAAOH,cAAcZ,aAAaS;IACpC;AACF"}
+{"version":3,"sources":["../../../src/util/telemetry/commandTelemetry.ts"],"sourcesContent":["import {type Interfaces} from '@oclif/core'\n\ninterface RedactedFlag {\n  canonical: string\n  flags: readonly string[]\n}\n\n/** @internal */\nexport interface CommandTelemetry {\n  redactedFlags: readonly RedactedFlag[]\n}\n\ntype OptionFlagName<Flags extends Interfaces.FlagInput> = string &\n  {\n    [Name in keyof Flags]: Flags[Name] extends {type: 'option'} ? Name : never\n  }[keyof Flags]\n\ntype CommandTelemetryConfig<Flags extends Interfaces.FlagInput> = {\n  redact?: readonly OptionFlagName<Flags>[]\n}\n\n/** @internal */\nexport function defineCommandTelemetry<const Flags extends Interfaces.FlagInput>(\n  flags: Flags,\n  config: CommandTelemetryConfig<Flags>,\n): CommandTelemetry {\n  return {\n    redactedFlags: (config.redact ?? []).map((name) => {\n      const flag = flags[name]\n      const aliases = flag?.aliases ?? []\n\n      return {\n        canonical: `--${name}`,\n        flags: [\n          `--${name}`,\n          ...aliases.map((alias) => `${alias.length === 1 ? '-' : '--'}${alias}`),\n          ...(flag?.char ? [`-${flag.char}`] : []),\n          ...(flag?.charAliases ?? []).map((alias) => `-${alias}`),\n        ],\n      }\n    }),\n  }\n}\n\ninterface TelemetryFlag {\n  canonical: string\n  option: boolean\n  redact: boolean\n}\n\nexport function collectTelemetryFlags(\n  argv: string[],\n  flags: Interfaces.FlagInput,\n  telemetry?: CommandTelemetry,\n): string[] {\n  const definitions = new Map<string, TelemetryFlag>()\n  for (const [name, flag] of Object.entries(flags)) {\n    const canonical = `--${name}`\n    const definition = {\n      canonical,\n      option: flag.type === 'option',\n      redact: telemetry?.redactedFlags.some((entry) => entry.canonical === canonical) ?? false,\n    }\n    definitions.set(canonical, definition)\n    for (const alias of flag.aliases ?? []) {\n      definitions.set(`${alias.length === 1 ? '-' : '--'}${alias}`, definition)\n    }\n    for (const char of [flag.char, ...(flag.charAliases ?? [])]) {\n      if (char) definitions.set(`-${char}`, definition)\n    }\n    if (flag.type === 'boolean' && flag.allowNo) {\n      definitions.set(`--no-${name}`, {...definition, canonical: `--no-${name}`})\n    }\n  }\n\n  const result: string[] = []\n  for (let index = 0; index < argv.length; index++) {\n    const argument = argv[index]\n    if (argument === '--') break\n    if (!argument.startsWith('-') || argument === '-') continue\n\n    if (argument.startsWith('--')) {\n      const separator = argument.indexOf('=')\n      const name = separator === -1 ? argument : argument.slice(0, separator)\n      const flag = definitions.get(name)\n      // An unknown option may consume the next token, including a known flag's spelling.\n      // Stop rather than interpreting private input as telemetry.\n      if (!flag) break\n      const value = separator === -1 ? undefined : argument.slice(separator + 1)\n      result.push(\n        flag.redact || !flag.option || value === undefined\n          ? flag.canonical\n          : `${flag.canonical}=${value}`,\n      )\n      if (flag.option && separator === -1) index++\n      continue\n    }\n\n    for (let offset = 1; offset < argument.length; offset++) {\n      const flag = definitions.get(`-${argument[offset]}`)\n      if (!flag) return result\n      if (!flag.option) {\n        result.push(flag.canonical)\n        continue\n      }\n      const value = argument.slice(offset + 1)\n      result.push(\n        flag.redact || !value ? flag.canonical : `${flag.canonical}=${value.replace(/^=/, '')}`,\n      )\n      if (!value) index++\n      break\n    }\n  }\n\n  return result\n}\n"],"names":["defineCommandTelemetry","flags","config","redactedFlags","redact","map","name","flag","aliases","canonical","alias","length","char","charAliases","collectTelemetryFlags","argv","telemetry","definitions","Map","Object","entries","definition","option","type","some","entry","set","allowNo","result","index","argument","startsWith","separator","indexOf","slice","get","value","undefined","push","offset","replace"],"mappings":"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"}

package/dist/util/telemetry/createTelemetryStore.js

@@ -3,6 +3,7 @@ import { mkdir } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { generateTelemetryFilePath } from './generateTelemetryFilePath.js';
 import { createLogger } from './logger.js';
+import { sanitizeTelemetryEvent, telemetryError } from './sanitizeTelemetryEvent.js';
 import { telemetryStoreDebug } from './telemetryStoreDebug.js';
 /**
  * Creates a file-based telemetry store with cached consent and reliable synchronous I/O.
@@ -29,7 +30,7 @@ import { telemetryStoreDebug } from './telemetryStoreDebug.js';
             cachedConsent = await options.resolveConsent();
             telemetryStoreDebug('Cached consent status: %s', cachedConsent.status);
         } catch (error) {
-            telemetryStoreDebug('Failed to initialize consent, treating as undetermined: %o', error);
+            telemetryStoreDebug('Failed to initialize consent, treating as undetermined: %o', telemetryError(error));
             cachedConsent = {
                 reason: 'fetchError',
                 status: 'undetermined'
@@ -46,7 +47,7 @@ import { telemetryStoreDebug } from './telemetryStoreDebug.js';
             });
             telemetryStoreDebug('Created directory structure for: %s', filePath);
         } catch (error) {
-            telemetryStoreDebug('Failed to initialize file path: %o', error);
+            telemetryStoreDebug('Failed to initialize file path: %o', telemetryError(error));
             filePath = null;
         }
     };
@@ -65,11 +66,18 @@ import { telemetryStoreDebug } from './telemetryStoreDebug.js';
             appendFileSync(filePath, JSON.stringify(event) + '\n', 'utf8');
             telemetryStoreDebug('Successfully wrote event to file: %s', filePath);
         } catch (error) {
-            telemetryStoreDebug('Failed to write telemetry event: %o', error);
+            telemetryStoreDebug('Failed to write telemetry event: %o', telemetryError(error));
         // Silent failure - don't break CLI functionality
         }
     };
-    const emit = (event)=>{
+    const emit = (input)=>{
+        let event;
+        try {
+            event = sanitizeTelemetryEvent(input);
+        } catch  {
+            telemetryStoreDebug('Skipping an unserializable telemetry event');
+            return;
+        }
         if (!initComplete) {
             telemetryStoreDebug('Init pending, buffering event: %s', event.type);
             eventBuffer.push(event);
@@ -90,7 +98,7 @@ import { telemetryStoreDebug } from './telemetryStoreDebug.js';
         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);
+                telemetryStoreDebug('Error initializing %s: %o', type, telemetryError(result.reason));
             }
         }
         initComplete = true;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/util/telemetry/createTelemetryStore.ts"],"sourcesContent":["import {appendFileSync} from 'node:fs'\nimport {mkdir} from 'node:fs/promises'\nimport {dirname} from 'node:path'\n\nimport {\n  type CLITelemetryStore,\n  type ConsentInformation,\n  type TelemetryUserProperties,\n} from '@sanity/cli-core'\nimport {type TelemetryEvent} from '@sanity/telemetry'\n\nimport {generateTelemetryFilePath} from './generateTelemetryFilePath.js'\nimport {createLogger} from './logger.js'\nimport {telemetryStoreDebug} from './telemetryStoreDebug.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\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 *\n * @internal\n */\nexport function createTelemetryStore(\n  sessionId: string,\n  options: CreateTelemetryStoreOptions,\n): CLITelemetryStore {\n  telemetryStoreDebug('Creating telemetry store with sessionId: %s', sessionId)\n\n  let cachedConsent: ConsentInformation | null = null\n  let filePath: string | null = null\n  let initComplete = false\n  const eventBuffer: TelemetryEvent[] = []\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 writeEvent = (event: TelemetryEvent) => {\n    if (!filePath) {\n      telemetryStoreDebug('No file path, skipping event: %s', event.type)\n      return\n    }\n\n    telemetryStoreDebug('Emitting event: %s', event.type)\n\n    try {\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, JSON.stringify(event) + '\\n', '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 emit = (event: TelemetryEvent) => {\n    if (!initComplete) {\n      telemetryStoreDebug('Init pending, buffering event: %s', event.type)\n      eventBuffer.push(event)\n      return\n    }\n\n    if (!cachedConsent || cachedConsent.status !== 'granted') {\n      telemetryStoreDebug(\n        'Consent not granted (%s), skipping event: %s',\n        cachedConsent?.status ?? 'unresolved',\n        event.type,\n      )\n      return\n    }\n\n    writeEvent(event)\n  }\n\n  const logger = createLogger<TelemetryUserProperties>(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    initComplete = true\n\n    if (cachedConsent?.status === 'granted' && filePath) {\n      telemetryStoreDebug('Flushing %d buffered event(s)', eventBuffer.length)\n      for (const event of eventBuffer) {\n        writeEvent(event)\n      }\n    } else {\n      telemetryStoreDebug(\n        'Discarding %d buffered event(s), consent: %s',\n        eventBuffer.length,\n        cachedConsent?.status ?? 'unresolved',\n      )\n    }\n    eventBuffer.length = 0\n  })\n\n  return logger\n}\n"],"names":["appendFileSync","mkdir","dirname","generateTelemetryFilePath","createLogger","telemetryStoreDebug","createTelemetryStore","sessionId","options","cachedConsent","filePath","initComplete","eventBuffer","initializeConsent","resolveConsent","status","error","reason","initializeFilePath","recursive","writeEvent","event","type","JSON","stringify","emit","push","logger","Promise","allSettled","then","results","index","result","entries","length"],"mappings":"AAAA,SAAQA,cAAc,QAAO,UAAS;AACtC,SAAQC,KAAK,QAAO,mBAAkB;AACtC,SAAQC,OAAO,QAAO,YAAW;AASjC,SAAQC,yBAAyB,QAAO,iCAAgC;AACxE,SAAQC,YAAY,QAAO,cAAa;AACxC,SAAQC,mBAAmB,QAAO,2BAA0B;AA0B5D;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASC,qBACdC,SAAiB,EACjBC,OAAoC;IAEpCH,oBAAoB,+CAA+CE;IAEnE,IAAIE,gBAA2C;IAC/C,IAAIC,WAA0B;IAC9B,IAAIC,eAAe;IACnB,MAAMC,cAAgC,EAAE;IAExC,MAAMC,oBAAoB;QACxB,IAAIJ,eAAe;QAEnB,IAAI;YACFA,gBAAgB,MAAMD,QAAQM,cAAc;YAC5CT,oBAAoB,6BAA6BI,cAAcM,MAAM;QACvE,EAAE,OAAOC,OAAO;YACdX,oBAAoB,8DAA8DW;YAClFP,gBAAgB;gBAACQ,QAAQ;gBAAcF,QAAQ;YAAc;QAC/D;IACF;IAEA,MAAMG,qBAAqB;QACzB,IAAIR,UAAU;QAEd,IAAI;YACFA,WAAW,MAAMP,0BAA0BI;YAC3CF,oBAAoB,2BAA2BK;YAE/C,MAAMT,MAAMC,QAAQQ,WAAW;gBAACS,WAAW;YAAI;YAC/Cd,oBAAoB,uCAAuCK;QAC7D,EAAE,OAAOM,OAAO;YACdX,oBAAoB,sCAAsCW;YAC1DN,WAAW;QACb;IACF;IAEA,MAAMU,aAAa,CAACC;QAClB,IAAI,CAACX,UAAU;YACbL,oBAAoB,oCAAoCgB,MAAMC,IAAI;YAClE;QACF;QAEAjB,oBAAoB,sBAAsBgB,MAAMC,IAAI;QAEpD,IAAI;YACF,mFAAmF;YACnF,iFAAiF;YACjF,2EAA2E;YAC3E,uEAAuE;YACvE,kCAAkC;YAClCtB,eAAeU,UAAUa,KAAKC,SAAS,CAACH,SAAS,MAAM;YACvDhB,oBAAoB,wCAAwCK;QAC9D,EAAE,OAAOM,OAAO;YACdX,oBAAoB,uCAAuCW;QAC3D,iDAAiD;QACnD;IACF;IAEA,MAAMS,OAAO,CAACJ;QACZ,IAAI,CAACV,cAAc;YACjBN,oBAAoB,qCAAqCgB,MAAMC,IAAI;YACnEV,YAAYc,IAAI,CAACL;YACjB;QACF;QAEA,IAAI,CAACZ,iBAAiBA,cAAcM,MAAM,KAAK,WAAW;YACxDV,oBACE,gDACAI,eAAeM,UAAU,cACzBM,MAAMC,IAAI;YAEZ;QACF;QAEAF,WAAWC;IACb;IAEA,MAAMM,SAASvB,aAAsCG,WAAWkB;IAEhE,qDAAqD;IACrDG,QAAQC,UAAU,CAAC;QAAChB;QAAqBK;KAAqB,EAAEY,IAAI,CAAC,CAACC;QACpE,KAAK,MAAM,CAACC,OAAOC,OAAO,IAAIF,QAAQG,OAAO,GAAI;YAC/C,IAAID,OAAOlB,MAAM,KAAK,YAAY;gBAChC,MAAMO,OAAOU,UAAU,IAAI,YAAY;gBACvC3B,oBAAoB,6BAA6BiB,MAAMW,OAAOhB,MAAM;YACtE;QACF;QAEAN,eAAe;QAEf,IAAIF,eAAeM,WAAW,aAAaL,UAAU;YACnDL,oBAAoB,iCAAiCO,YAAYuB,MAAM;YACvE,KAAK,MAAMd,SAAST,YAAa;gBAC/BQ,WAAWC;YACb;QACF,OAAO;YACLhB,oBACE,gDACAO,YAAYuB,MAAM,EAClB1B,eAAeM,UAAU;QAE7B;QACAH,YAAYuB,MAAM,GAAG;IACvB;IAEA,OAAOR;AACT"}
+{"version":3,"sources":["../../../src/util/telemetry/createTelemetryStore.ts"],"sourcesContent":["import {appendFileSync} from 'node:fs'\nimport {mkdir} from 'node:fs/promises'\nimport {dirname} from 'node:path'\n\nimport {\n  type CLITelemetryStore,\n  type ConsentInformation,\n  type TelemetryUserProperties,\n} from '@sanity/cli-core'\nimport {type TelemetryEvent} from '@sanity/telemetry'\n\nimport {generateTelemetryFilePath} from './generateTelemetryFilePath.js'\nimport {createLogger} from './logger.js'\nimport {sanitizeTelemetryEvent, telemetryError} from './sanitizeTelemetryEvent.js'\nimport {telemetryStoreDebug} from './telemetryStoreDebug.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\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 *\n * @internal\n */\nexport function createTelemetryStore(\n  sessionId: string,\n  options: CreateTelemetryStoreOptions,\n): CLITelemetryStore {\n  telemetryStoreDebug('Creating telemetry store with sessionId: %s', sessionId)\n\n  let cachedConsent: ConsentInformation | null = null\n  let filePath: string | null = null\n  let initComplete = false\n  const eventBuffer: TelemetryEvent[] = []\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(\n        'Failed to initialize consent, treating as undetermined: %o',\n        telemetryError(error),\n      )\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', telemetryError(error))\n      filePath = null\n    }\n  }\n\n  const writeEvent = (event: TelemetryEvent) => {\n    if (!filePath) {\n      telemetryStoreDebug('No file path, skipping event: %s', event.type)\n      return\n    }\n\n    telemetryStoreDebug('Emitting event: %s', event.type)\n\n    try {\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, JSON.stringify(event) + '\\n', 'utf8')\n      telemetryStoreDebug('Successfully wrote event to file: %s', filePath)\n    } catch (error) {\n      telemetryStoreDebug('Failed to write telemetry event: %o', telemetryError(error))\n      // Silent failure - don't break CLI functionality\n    }\n  }\n\n  const emit = (input: TelemetryEvent) => {\n    let event: TelemetryEvent\n    try {\n      event = sanitizeTelemetryEvent(input)\n    } catch {\n      telemetryStoreDebug('Skipping an unserializable telemetry event')\n      return\n    }\n    if (!initComplete) {\n      telemetryStoreDebug('Init pending, buffering event: %s', event.type)\n      eventBuffer.push(event)\n      return\n    }\n\n    if (!cachedConsent || cachedConsent.status !== 'granted') {\n      telemetryStoreDebug(\n        'Consent not granted (%s), skipping event: %s',\n        cachedConsent?.status ?? 'unresolved',\n        event.type,\n      )\n      return\n    }\n\n    writeEvent(event)\n  }\n\n  const logger = createLogger<TelemetryUserProperties>(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, telemetryError(result.reason))\n      }\n    }\n\n    initComplete = true\n\n    if (cachedConsent?.status === 'granted' && filePath) {\n      telemetryStoreDebug('Flushing %d buffered event(s)', eventBuffer.length)\n      for (const event of eventBuffer) {\n        writeEvent(event)\n      }\n    } else {\n      telemetryStoreDebug(\n        'Discarding %d buffered event(s), consent: %s',\n        eventBuffer.length,\n        cachedConsent?.status ?? 'unresolved',\n      )\n    }\n    eventBuffer.length = 0\n  })\n\n  return logger\n}\n"],"names":["appendFileSync","mkdir","dirname","generateTelemetryFilePath","createLogger","sanitizeTelemetryEvent","telemetryError","telemetryStoreDebug","createTelemetryStore","sessionId","options","cachedConsent","filePath","initComplete","eventBuffer","initializeConsent","resolveConsent","status","error","reason","initializeFilePath","recursive","writeEvent","event","type","JSON","stringify","emit","input","push","logger","Promise","allSettled","then","results","index","result","entries","length"],"mappings":"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"}