@sanity/codegen 5.10.1 → 6.0.0

package/dist/_exports/index.d.ts

@@ -0,0 +1,555 @@
+import {BooleanFlag} from '@oclif/core/interfaces'
+import {CustomOptions} from '@oclif/core/interfaces'
+import {DefinedTelemetryTrace} from '@sanity/telemetry'
+import {ExprNode} from 'groq-js'
+import {FSWatcher} from 'chokidar'
+import {OptionFlag} from '@oclif/core/interfaces'
+import {SanityCommand} from '@sanity/cli-core'
+import {SchemaType} from 'groq-js'
+import {spinner} from '@sanity/cli-core/ux'
+import * as t from '@babel/types'
+import {TransformOptions} from '@babel/core'
+import {WorkerChannel} from '@sanity/worker-channels'
+import {WorkerChannelReporter} from '@sanity/worker-channels'
+import * as z from 'zod'
+
+/**
+ * @deprecated use TypeGenConfig
+ * @public
+ */
+export declare type CodegenConfig = TypeGenConfig
+
+/**
+ * @public
+ */
+export declare const configDefinition: z.ZodObject<
+  {
+    formatGeneratedCode: z.ZodDefault<z.ZodBoolean>
+    generates: z.ZodDefault<z.ZodString>
+    overloadClientMethods: z.ZodDefault<z.ZodBoolean>
+    path: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>
+    schema: z.ZodDefault<z.ZodString>
+  },
+  z.core.$strip
+>
+
+/**
+ * A module containing queries that have been evaluated.
+ * @public
+ */
+export declare interface EvaluatedModule {
+  errors: (QueryEvaluationError | QueryExtractionError)[]
+  filename: string
+  queries: EvaluatedQuery[]
+}
+
+/**
+ * An `ExtractedQuery` that has been evaluated against a schema, yielding a TypeScript type.
+ * @public
+ */
+export declare interface EvaluatedQuery extends ExtractedQuery {
+  ast: t.ExportNamedDeclaration
+  code: string
+  id: t.Identifier
+  stats: TypeEvaluationStats
+  tsType: t.TSType
+}
+
+/**
+ * A module (file) containing extracted GROQ queries.
+ * @public
+ */
+export declare interface ExtractedModule {
+  errors: QueryExtractionError[]
+  filename: string
+  queries: ExtractedQuery[]
+}
+
+/**
+ * A GROQ query extracted from a source file.
+ * @public
+ */
+export declare interface ExtractedQuery {
+  filename: string
+  query: string
+  variable: QueryVariable
+}
+
+/**
+ * Filter a union of object types by the _type property. This is handy when working with page builder
+ * setups where the returned type is an array containing multiple types.
+ *
+ * @example
+ * ```ts
+ *
+ * export type Callout = {
+ *   _type: 'callout'
+ *   title?: string
+ *   content?: string
+ * }
+ *
+ * export type Video = {
+ *   _type: 'video'
+ *   url?: string
+ *   caption?: string
+ * }
+ * type FORM_QUERY_RESULT = {
+ *   _id: string
+ *   title?: string
+ *   content?: Array<
+ *     | ({ _key: string } & Callout)
+ *     | ({ _key: string } & Video)
+ *   >
+ * } | null
+ *
+ * // Get the type of the content with the Get helper
+ * type Content = Get<FORM_QUERY_RESULT, 'content', number>
+ *
+ * // Get the type for a callout module from the page builder type
+ * type CalloutModule = FilterByType<Content, 'callout'>
+ * // → { _key: string } & Callout
+ * ```
+ * @public
+ */
+export declare type FilterByType<
+  U extends {
+    _type: string
+  },
+  T extends U['_type'],
+> = Extract<
+  U,
+  {
+    _type: T
+  }
+>
+
+/**
+ * findQueriesInPath takes a path or array of paths and returns all GROQ queries in the files.
+ * @param path - The path or array of paths to search for queries
+ * @param babelOptions - The babel configuration to use when parsing the source
+ * @param resolver - A resolver function to use when resolving module imports
+ * @returns An async generator that yields the results of the search
+ * @beta
+ * @internal
+ */
+export declare function findQueriesInPath({
+  babelOptions,
+  path,
+  resolver,
+}: FindQueriesInPathOptions): {
+  files: string[]
+  queries: AsyncIterable<ExtractedModule>
+}
+
+declare interface FindQueriesInPathOptions {
+  path: string | string[]
+  babelOptions?: TransformOptions
+  resolver?: NodeJS.RequireResolve
+}
+
+/**
+ * findQueriesInSource takes a source string and returns all GROQ queries in it.
+ * @param source - The source code to search for queries
+ * @param filename - The filename of the source code
+ * @param babelConfig - The babel configuration to use when parsing the source
+ * @param resolver - A resolver function to use when resolving module imports
+ * @returns
+ * @beta
+ * @internal
+ */
+export declare function findQueriesInSource(
+  source: string,
+  filename: string,
+  babelConfig?: TransformOptions,
+  resolver?: NodeJS.RequireResolve,
+): ExtractedModule
+
+/** @public */
+export declare interface GenerateTypesOptions {
+  schema: SchemaType
+  overloadClientMethods?: boolean
+  queries?: AsyncIterable<ExtractedModule>
+  reporter?: WorkerChannelReporter<TypegenWorkerChannel>
+  root?: string
+  schemaPath?: string
+}
+
+/**
+ * Result from a single generation run.
+ * @public
+ */
+export declare interface GenerationResult {
+  code: string
+  duration: number
+  emptyUnionTypeNodesGenerated: number
+  filesWithErrors: number
+  outputSize: number
+  queriesCount: number
+  queryFilesCount: number
+  schemaTypesCount: number
+  typeNodesGenerated: number
+  unknownTypeNodesGenerated: number
+  unknownTypeNodesRatio: number
+}
+
+/**
+ * Get a deeply nested property type from a complex type structure. Safely navigates
+ * through nullable types (`T | null | undefined`) at each level, preserving the
+ * nullability of the final accessed property.
+ *
+ * Supports up to 20 levels of nesting.
+ *
+ * @example
+ * ```ts
+ * type POST_QUERY_RESULT = {
+ *   _id: string
+ *   author: {
+ *     profile: {
+ *       name: string;
+ *     } | null;
+ *   } | null;
+ *   links: Array<{
+ *     _key: string
+ *     type: 'link'
+ *     label: string
+ *     url: string
+ *   }> | null
+ * } | null
+ *
+ * // Basic property access:
+ * type Id = Get<POST_QUERY_RESULT, '_id'>;
+ * // → string
+ *
+ * // Nested property access:
+ * type Profile = Get<POST_QUERY_RESULT, 'author', 'profile';
+ * // → { name: string } | null
+ *
+ * // Array element access using `number`:
+ * type Link = Get<POST_QUERY_RESULT, 'links', number, 'label'>;
+ * // → string
+ * ```
+ * @public
+ */
+export declare type Get<
+  T,
+  K1 extends keyof NonNullish<T>,
+  K2 extends keyof NavigatePath<T, [K1]> = never,
+  K3 extends keyof NavigatePath<T, [K1, K2]> = never,
+  K4 extends keyof NavigatePath<T, [K1, K2, K3]> = never,
+  K5 extends keyof NavigatePath<T, [K1, K2, K3, K4]> = never,
+  K6 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5]> = never,
+  K7 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6]> = never,
+  K8 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7]> = never,
+  K9 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8]> = never,
+  K10 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8, K9]> = never,
+  K11 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10]> = never,
+  K12 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11]> = never,
+  K13 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12]> = never,
+  K14 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13]> =
+    never,
+  K15 extends keyof NavigatePath<T, [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14]> =
+    never,
+  K16 extends keyof NavigatePath<
+    T,
+    [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15]
+  > = never,
+  K17 extends keyof NavigatePath<
+    T,
+    [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15, K16]
+  > = never,
+  K18 extends keyof NavigatePath<
+    T,
+    [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15, K16, K17]
+  > = never,
+  K19 extends keyof NavigatePath<
+    T,
+    [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15, K16, K17, K18]
+  > = never,
+  K20 extends keyof NavigatePath<
+    T,
+    [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15, K16, K17, K18, K19]
+  > = never,
+> = GetAtPath<
+  T,
+  TakeUntilNever<
+    [K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15, K16, K17, K18, K19, K20]
+  >
+>
+
+/** Recursively gets value at path, preserving nullability at final access. */
+declare type GetAtPath<T, Path extends unknown[]> = Path extends []
+  ? T
+  : Path extends [infer K]
+    ? K extends keyof NonNullish<T>
+      ? NonNullish<T>[K]
+      : never
+    : Path extends [infer K, ...infer Rest]
+      ? K extends keyof NonNullish<T>
+        ? GetAtPath<NonNullish<T>[K], Rest>
+        : never
+      : never
+
+/**
+ * This is a custom implementation of require.resolve that takes into account the paths
+ * configuration in tsconfig.json. This is necessary if we want to resolve paths that are
+ * custom defined in the tsconfig.json file.
+ * Resolving here is best effort and might not work in all cases.
+ * @beta
+ */
+export declare function getResolver(cwd?: string): NodeJS.RequireResolve
+
+/** Recursively navigates through a path, stripping nullability for key lookup. */
+declare type NavigatePath<T, Path extends unknown[]> = Path extends []
+  ? NonNullish<T>
+  : Path extends [infer K, ...infer Rest]
+    ? K extends keyof NonNullish<T>
+      ? NavigatePath<NonNullish<T>[K], Rest>
+      : never
+    : never
+
+/** Excludes `null` and `undefined` from a type. */
+declare type NonNullish<T> = T extends null | undefined ? never : T
+
+/**
+ * An error that occurred during query evaluation.
+ * @public
+ */
+declare class QueryEvaluationError extends Error {
+  filename: string
+  variable?: QueryVariable
+  constructor({cause, filename, variable}: QueryEvaluationErrorOptions)
+}
+
+declare interface QueryEvaluationErrorOptions {
+  cause: unknown
+  filename: string
+  variable?: QueryVariable
+}
+
+/**
+ * An error that occurred during query extraction.
+ * @public
+ */
+export declare class QueryExtractionError extends Error {
+  filename: string
+  variable?: QueryVariable
+  constructor({cause, filename, variable}: QueryExtractionErrorOptions)
+}
+
+declare interface QueryExtractionErrorOptions {
+  cause: unknown
+  filename: string
+  variable?: QueryVariable
+}
+
+declare interface QueryVariable {
+  id: t.Identifier
+  end?: number
+  start?: number
+}
+
+/**
+ * Read, parse and process a config file
+ * @internal
+ */
+export declare function readConfig(path: string): Promise<TypeGenConfig>
+
+/**
+ * Read a schema from a given path
+ * @param path - The path to the schema
+ * @returns The schema
+ * @internal
+ * @beta
+ **/
+export declare function readSchema(path: string): Promise<SchemaType>
+
+/**
+ * Register Babel with the given options
+ *
+ * @param babelOptions - The options to use when registering Babel
+ * @beta
+ */
+export declare function registerBabel(babelOptions?: TransformOptions): void
+
+/**
+ * Runs a single typegen generation.
+ *
+ * This is the programmatic API for generating TypeScript types from GROQ queries.
+ * It spawns a worker thread to perform the generation and displays progress via CLI spinners.
+ *
+ * @param options - Configuration options including typegen config and working directory
+ * @returns Generation result containing the generated code and statistics
+ * @public
+ */
+export declare function runTypegenGenerate(options: RunTypegenOptions): Promise<GenerationResult>
+
+/**
+ * Options for running a single typegen generation.
+ * This is the programmatic API for one-off generation without file watching.
+ * @public
+ */
+export declare interface RunTypegenOptions {
+  /** Working directory (usually project root) */
+  workDir: string
+  /** Typegen configuration */
+  config?: Partial<TypeGenConfig>
+  /** Optional spinner instance for progress display */
+  spin?: ReturnType<typeof spinner>
+}
+
+/**
+ * Starts a file watcher that triggers typegen on changes.
+ * Watches both query files (via patterns) and the schema JSON file.
+ * Implements debouncing and concurrency control to prevent multiple generations.
+ * @public
+ */
+export declare function runTypegenWatcher(options: RunTypegenOptions): {
+  getStats: () => WatcherStats
+  stop: () => Promise<void>
+  watcher: FSWatcher
+}
+
+/**
+ * safeParseQuery parses a GROQ query string, but first attempts to extract any parameters used in slices. This method is _only_
+ * intended for use in type generation where we don't actually execute the parsed AST on a dataset, and should not be used elsewhere.
+ * @internal
+ */
+export declare function safeParseQuery(query: string): ExprNode
+
+/** Builds a tuple from elements, stopping at the first `never`. */
+declare type TakeUntilNever<T extends unknown[]> = T extends [infer H, ...infer Rest]
+  ? [H] extends [never]
+    ? []
+    : [H, ...TakeUntilNever<Rest>]
+  : []
+
+/**
+ * Statistics from the query type evaluation process.
+ * @public
+ */
+declare interface TypeEvaluationStats {
+  allTypes: number
+  emptyUnions: number
+  unknownTypes: number
+}
+
+/** @public */
+export declare type TypeGenConfig = z.infer<typeof configDefinition>
+
+/**
+ * A class used to generate TypeScript types from a given schema
+ * @beta
+ */
+export declare class TypeGenerator {
+  private getSchemaTypeGenerator
+  private getSchemaTypeDeclarations
+  private getAllSanitySchemaTypesDeclaration
+  private getArrayOfDeclaration
+  private getInternalReferenceSymbolDeclaration
+  private static getEvaluatedModules
+  private static getQueryMapDeclaration
+  generateTypes(options: GenerateTypesOptions): Promise<{
+    ast: t.Program
+    code: string
+  }>
+}
+
+/**
+ * @internal
+ */
+export declare class TypegenGenerateCommand extends SanityCommand<typeof TypegenGenerateCommand> {
+  static description: string
+  static examples: {
+    command: string
+    description: string
+  }[]
+  static flags: {
+    'config-path': OptionFlag<string | undefined, CustomOptions>
+    watch: BooleanFlag<boolean>
+  }
+  run(): Promise<void>
+  private getConfig
+  private runSingle
+  private runWatcher
+}
+
+/** @public */
+export declare const TypegenWatchModeTrace: DefinedTelemetryTrace<
+  TypegenWatchModeTraceAttributes,
+  void
+>
+
+/**
+ * Attributes for typegen watch mode trace - tracks the start and stop of watch mode
+ * sessions with statistics about generation runs.
+ */
+declare type TypegenWatchModeTraceAttributes =
+  | {
+      averageGenerationDuration: number
+      generationFailedCount: number
+      generationSuccessfulCount: number
+      step: 'stopped'
+      watcherDuration: number
+    }
+  | {
+      step: 'started'
+    }
+
+/** @public */
+export declare type TypegenWorkerChannel = WorkerChannel.Definition<{
+  evaluatedModules: WorkerChannel.Stream<EvaluatedModule>
+  generatedQueryTypes: WorkerChannel.Event<{
+    queryMapDeclaration: {
+      ast: t.Program
+      code: string
+    }
+  }>
+  generatedSchemaTypes: WorkerChannel.Event<{
+    allSanitySchemaTypesDeclaration: {
+      ast: t.ExportNamedDeclaration
+      code: string
+      id: t.Identifier
+    }
+    internalReferenceSymbol: {
+      ast: t.ExportNamedDeclaration
+      code: string
+      id: t.Identifier
+    }
+    schemaTypeDeclarations: {
+      ast: t.ExportNamedDeclaration
+      code: string
+      id: t.Identifier
+      name: string
+      tsType: t.TSType
+    }[]
+  }>
+}>
+
+/** @public */
+export declare const TypesGeneratedTrace: DefinedTelemetryTrace<TypesGeneratedTraceAttributes, void>
+
+declare interface TypesGeneratedTraceAttributes {
+  configMethod: 'cli' | 'legacy'
+  configOverloadClientMethods: boolean
+  emptyUnionTypeNodesGenerated: number
+  filesWithErrors: number
+  outputSize: number
+  queriesCount: number
+  queryFilesCount: number
+  schemaTypesCount: number
+  typeNodesGenerated: number
+  unknownTypeNodesGenerated: number
+  unknownTypeNodesRatio: number
+}
+
+declare type WatcherStats = Omit<
+  Extract<
+    TypegenWatchModeTraceAttributes,
+    {
+      step: 'stopped'
+    }
+  >,
+  'step'
+>
+
+export {}

package/dist/actions/typegenGenerate.js

@@ -14,6 +14,7 @@ import { processTypegenWorkerStream } from './streamProcessor.js';
  *
  * @param options - Configuration options including typegen config and working directory
  * @returns Generation result containing the generated code and statistics
+ * @public
  */ export async function runTypegenGenerate(options) {
     const { config, workDir } = options;
     const { formatGeneratedCode, generates, overloadClientMethods, path, schema } = prepareConfig(config);

package/dist/actions/typegenGenerate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/actions/typegenGenerate.ts"],"sourcesContent":["import {mkdir} from 'node:fs/promises'\nimport {dirname, isAbsolute, join} from 'node:path'\nimport {env} from 'node:process'\nimport {Worker} from 'node:worker_threads'\n\nimport {WorkerChannelReceiver} from '@sanity/worker-channels'\n\nimport {prepareConfig} from '../utils/config.js'\nimport {debug} from '../utils/debug.js'\nimport {processTypegenWorkerStream} from './streamProcessor.js'\nimport {\n  type GenerationResult,\n  type RunTypegenOptions,\n  TypegenGenerateTypesWorkerData,\n  TypegenWorkerChannel,\n} from './types.js'\n\n/**\n * Runs a single typegen generation.\n *\n * This is the programmatic API for generating TypeScript types from GROQ queries.\n * It spawns a worker thread to perform the generation and displays progress via CLI spinners.\n *\n * @param options - Configuration options including typegen config and working directory\n * @returns Generation result containing the generated code and statistics\n */\nexport async function runTypegenGenerate(options: RunTypegenOptions): Promise<GenerationResult> {\n  const {config, workDir} = options\n\n  const {formatGeneratedCode, generates, overloadClientMethods, path, schema} =\n    prepareConfig(config)\n\n  const outputPath = isAbsolute(generates) ? generates : join(workDir, generates)\n\n  // create output dir if it isn't there\n  const outputDir = dirname(outputPath)\n  await mkdir(outputDir, {recursive: true})\n\n  // set up worker\n  const workerPath = new URL('../actions/typegenGenerate.worker.js', import.meta.url)\n  const workerData: TypegenGenerateTypesWorkerData = {\n    overloadClientMethods,\n    schemaPath: schema,\n    searchPath: path,\n    workDir,\n  }\n  const worker = new Worker(workerPath, {env, workerData})\n\n  try {\n    const result = await processTypegenWorkerStream(\n      WorkerChannelReceiver.from<TypegenWorkerChannel>(worker),\n      {\n        formatGeneratedCode,\n        generates: outputPath,\n        overloadClientMethods,\n        path,\n        schema,\n      },\n    )\n\n    return result\n  } catch (err) {\n    debug('error generating types', err)\n    throw err\n  } finally {\n    worker.terminate()\n  }\n}\n"],"names":["mkdir","dirname","isAbsolute","join","env","Worker","WorkerChannelReceiver","prepareConfig","debug","processTypegenWorkerStream","runTypegenGenerate","options","config","workDir","formatGeneratedCode","generates","overloadClientMethods","path","schema","outputPath","outputDir","recursive","workerPath","URL","url","workerData","schemaPath","searchPath","worker","result","from","err","terminate"],"mappings":"AAAA,SAAQA,KAAK,QAAO,mBAAkB;AACtC,SAAQC,OAAO,EAAEC,UAAU,EAAEC,IAAI,QAAO,YAAW;AACnD,SAAQC,GAAG,QAAO,eAAc;AAChC,SAAQC,MAAM,QAAO,sBAAqB;AAE1C,SAAQC,qBAAqB,QAAO,0BAAyB;AAE7D,SAAQC,aAAa,QAAO,qBAAoB;AAChD,SAAQC,KAAK,QAAO,oBAAmB;AACvC,SAAQC,0BAA0B,QAAO,uBAAsB;AAQ/D;;;;;;;;CAQC,GACD,OAAO,eAAeC,mBAAmBC,OAA0B;IACjE,MAAM,EAACC,MAAM,EAAEC,OAAO,EAAC,GAAGF;IAE1B,MAAM,EAACG,mBAAmB,EAAEC,SAAS,EAAEC,qBAAqB,EAAEC,IAAI,EAAEC,MAAM,EAAC,GACzEX,cAAcK;IAEhB,MAAMO,aAAajB,WAAWa,aAAaA,YAAYZ,KAAKU,SAASE;IAErE,sCAAsC;IACtC,MAAMK,YAAYnB,QAAQkB;IAC1B,MAAMnB,MAAMoB,WAAW;QAACC,WAAW;IAAI;IAEvC,gBAAgB;IAChB,MAAMC,aAAa,IAAIC,IAAI,wCAAwC,YAAYC,GAAG;IAClF,MAAMC,aAA6C;QACjDT;QACAU,YAAYR;QACZS,YAAYV;QACZJ;IACF;IACA,MAAMe,SAAS,IAAIvB,OAAOiB,YAAY;QAAClB;QAAKqB;IAAU;IAEtD,IAAI;QACF,MAAMI,SAAS,MAAMpB,2BACnBH,sBAAsBwB,IAAI,CAAuBF,SACjD;YACEd;YACAC,WAAWI;YACXH;YACAC;YACAC;QACF;QAGF,OAAOW;IACT,EAAE,OAAOE,KAAK;QACZvB,MAAM,0BAA0BuB;QAChC,MAAMA;IACR,SAAU;QACRH,OAAOI,SAAS;IAClB;AACF"}
+{"version":3,"sources":["../../src/actions/typegenGenerate.ts"],"sourcesContent":["import {mkdir} from 'node:fs/promises'\nimport {dirname, isAbsolute, join} from 'node:path'\nimport {env} from 'node:process'\nimport {Worker} from 'node:worker_threads'\n\nimport {WorkerChannelReceiver} from '@sanity/worker-channels'\n\nimport {prepareConfig} from '../utils/config.js'\nimport {debug} from '../utils/debug.js'\nimport {processTypegenWorkerStream} from './streamProcessor.js'\nimport {\n  type GenerationResult,\n  type RunTypegenOptions,\n  TypegenGenerateTypesWorkerData,\n  TypegenWorkerChannel,\n} from './types.js'\n\n/**\n * Runs a single typegen generation.\n *\n * This is the programmatic API for generating TypeScript types from GROQ queries.\n * It spawns a worker thread to perform the generation and displays progress via CLI spinners.\n *\n * @param options - Configuration options including typegen config and working directory\n * @returns Generation result containing the generated code and statistics\n * @public\n */\nexport async function runTypegenGenerate(options: RunTypegenOptions): Promise<GenerationResult> {\n  const {config, workDir} = options\n\n  const {formatGeneratedCode, generates, overloadClientMethods, path, schema} =\n    prepareConfig(config)\n\n  const outputPath = isAbsolute(generates) ? generates : join(workDir, generates)\n\n  // create output dir if it isn't there\n  const outputDir = dirname(outputPath)\n  await mkdir(outputDir, {recursive: true})\n\n  // set up worker\n  const workerPath = new URL('../actions/typegenGenerate.worker.js', import.meta.url)\n  const workerData: TypegenGenerateTypesWorkerData = {\n    overloadClientMethods,\n    schemaPath: schema,\n    searchPath: path,\n    workDir,\n  }\n  const worker = new Worker(workerPath, {env, workerData})\n\n  try {\n    const result = await processTypegenWorkerStream(\n      WorkerChannelReceiver.from<TypegenWorkerChannel>(worker),\n      {\n        formatGeneratedCode,\n        generates: outputPath,\n        overloadClientMethods,\n        path,\n        schema,\n      },\n    )\n\n    return result\n  } catch (err) {\n    debug('error generating types', err)\n    throw err\n  } finally {\n    worker.terminate()\n  }\n}\n"],"names":["mkdir","dirname","isAbsolute","join","env","Worker","WorkerChannelReceiver","prepareConfig","debug","processTypegenWorkerStream","runTypegenGenerate","options","config","workDir","formatGeneratedCode","generates","overloadClientMethods","path","schema","outputPath","outputDir","recursive","workerPath","URL","url","workerData","schemaPath","searchPath","worker","result","from","err","terminate"],"mappings":"AAAA,SAAQA,KAAK,QAAO,mBAAkB;AACtC,SAAQC,OAAO,EAAEC,UAAU,EAAEC,IAAI,QAAO,YAAW;AACnD,SAAQC,GAAG,QAAO,eAAc;AAChC,SAAQC,MAAM,QAAO,sBAAqB;AAE1C,SAAQC,qBAAqB,QAAO,0BAAyB;AAE7D,SAAQC,aAAa,QAAO,qBAAoB;AAChD,SAAQC,KAAK,QAAO,oBAAmB;AACvC,SAAQC,0BAA0B,QAAO,uBAAsB;AAQ/D;;;;;;;;;CASC,GACD,OAAO,eAAeC,mBAAmBC,OAA0B;IACjE,MAAM,EAACC,MAAM,EAAEC,OAAO,EAAC,GAAGF;IAE1B,MAAM,EAACG,mBAAmB,EAAEC,SAAS,EAAEC,qBAAqB,EAAEC,IAAI,EAAEC,MAAM,EAAC,GACzEX,cAAcK;IAEhB,MAAMO,aAAajB,WAAWa,aAAaA,YAAYZ,KAAKU,SAASE;IAErE,sCAAsC;IACtC,MAAMK,YAAYnB,QAAQkB;IAC1B,MAAMnB,MAAMoB,WAAW;QAACC,WAAW;IAAI;IAEvC,gBAAgB;IAChB,MAAMC,aAAa,IAAIC,IAAI,wCAAwC,YAAYC,GAAG;IAClF,MAAMC,aAA6C;QACjDT;QACAU,YAAYR;QACZS,YAAYV;QACZJ;IACF;IACA,MAAMe,SAAS,IAAIvB,OAAOiB,YAAY;QAAClB;QAAKqB;IAAU;IAEtD,IAAI;QACF,MAAMI,SAAS,MAAMpB,2BACnBH,sBAAsBwB,IAAI,CAAuBF,SACjD;YACEd;YACAC,WAAWI;YACXH;YACAC;YACAC;QACF;QAGF,OAAOW;IACT,EAAE,OAAOE,KAAK;QACZvB,MAAM,0BAA0BuB;QAChC,MAAMA;IACR,SAAU;QACRH,OAAOI,SAAS;IAClB;AACF"}

package/dist/actions/typegenWatch.js

@@ -2,7 +2,8 @@ import { error, log } from 'node:console';
 import { isAbsolute, join, relative } from 'node:path';
 import { styleText } from 'node:util';
 import chokidar from 'chokidar';
-import { debounce, mean } from 'lodash-es';
+import debounce from 'lodash-es/debounce.js';
+import mean from 'lodash-es/mean.js';
 import { prepareConfig } from '../utils/config.js';
 import { runTypegenGenerate } from './typegenGenerate.js';
 const IGNORED_PATTERNS = [
@@ -48,6 +49,7 @@ const IGNORED_PATTERNS = [
  * Starts a file watcher that triggers typegen on changes.
  * Watches both query files (via patterns) and the schema JSON file.
  * Implements debouncing and concurrency control to prevent multiple generations.
+ * @public
  */ export function runTypegenWatcher(options) {
     const { config, workDir } = options;
     const { path, schema } = prepareConfig(config);

package/dist/actions/typegenWatch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/actions/typegenWatch.ts"],"sourcesContent":["import {error, log} from 'node:console'\nimport {isAbsolute, join, relative} from 'node:path'\nimport {styleText} from 'node:util'\n\nimport chokidar, {FSWatcher} from 'chokidar'\nimport {debounce, mean} from 'lodash-es'\n\nimport {TypegenWatchModeTraceAttributes} from '../typegen.telemetry.js'\nimport {prepareConfig} from '../utils/config.js'\nimport {runTypegenGenerate} from './typegenGenerate.js'\nimport {type RunTypegenOptions} from './types.js'\n\nconst IGNORED_PATTERNS = [\n  '**/node_modules/**',\n  '**/.git/**',\n  '**/dist/**',\n  '**/lib/**',\n  '**/.sanity/**',\n]\n\n/** State for tracking generation status */\ninterface WatchState {\n  isGenerating: boolean\n  pendingGeneration: boolean\n}\n\n/** Return type for createTypegenRunner */\ninterface TypegenRunner {\n  runGeneration: () => Promise<void>\n  state: WatchState\n}\n\ntype WatcherStats = Omit<Extract<TypegenWatchModeTraceAttributes, {step: 'stopped'}>, 'step'>\n\n/**\n * Creates a typegen runner with concurrency control.\n * If generation is already running, queues one more generation to run after completion.\n * Multiple queued requests are coalesced into a single pending generation.\n */\nfunction createTypegenRunner(onGenerate: () => Promise<unknown>): TypegenRunner {\n  const state: WatchState = {\n    isGenerating: false,\n    pendingGeneration: false,\n  }\n\n  async function runGeneration(): Promise<void> {\n    if (state.isGenerating) {\n      state.pendingGeneration = true\n      return\n    }\n\n    state.isGenerating = true\n    state.pendingGeneration = false\n\n    try {\n      await onGenerate()\n    } finally {\n      state.isGenerating = false\n\n      // If a change came in during generation, run again\n      if (state.pendingGeneration) {\n        state.pendingGeneration = false\n        await runGeneration()\n      }\n    }\n  }\n\n  return {runGeneration, state}\n}\n\n/**\n * Starts a file watcher that triggers typegen on changes.\n * Watches both query files (via patterns) and the schema JSON file.\n * Implements debouncing and concurrency control to prevent multiple generations.\n */\nexport function runTypegenWatcher(options: RunTypegenOptions): {\n  getStats: () => WatcherStats\n  stop: () => Promise<void>\n  watcher: FSWatcher\n} {\n  const {config, workDir} = options\n  const {path, schema} = prepareConfig(config)\n\n  const stats = {\n    failedCount: 0,\n    startTime: Date.now(),\n    successfulDurations: [] as number[],\n  }\n\n  const {runGeneration} = createTypegenRunner(async () => {\n    try {\n      const {duration} = await runTypegenGenerate({...options})\n      stats.successfulDurations.push(duration)\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : err\n      error(` ${styleText('red', '›')}   ${errorMessage}`)\n      stats.failedCount++\n    }\n  })\n\n  // Debounced generation trigger\n  const debouncedGenerate = debounce(runGeneration, 1000)\n\n  // Build absolute patterns for query files and schema file\n  const paths = Array.isArray(path) ? path : [path]\n  const absoluteQueryPatterns = paths.map((pattern) =>\n    isAbsolute(pattern) ? pattern : join(workDir, pattern),\n  )\n  const absoluteSchemaPath = isAbsolute(schema) ? schema : join(workDir, schema)\n  const watchTargets = [...absoluteQueryPatterns, absoluteSchemaPath]\n\n  // perform initial generation\n  debouncedGenerate()\n\n  // set up watcher\n  const watcher = chokidar.watch(watchTargets, {\n    cwd: workDir,\n    ignored: IGNORED_PATTERNS,\n    ignoreInitial: true,\n  })\n\n  watcher.on('all', (event: string, filePath: string) => {\n    const timestamp = new Date().toLocaleTimeString()\n    const relativePath = isAbsolute(filePath) ? relative(workDir, filePath) : filePath\n    log(`[${timestamp}] ${event}: ${relativePath}`)\n    debouncedGenerate()\n  })\n\n  watcher.on('error', (err: Error) => {\n    error(`Watcher error: ${err.message}`)\n  })\n\n  return {\n    getStats: () => ({\n      averageGenerationDuration: mean(stats.successfulDurations) || 0,\n      generationFailedCount: stats.failedCount,\n      generationSuccessfulCount: stats.successfulDurations.length,\n      watcherDuration: Date.now() - stats.startTime,\n    }),\n    stop: async () => {\n      await watcher.close()\n    },\n    watcher,\n  }\n}\n"],"names":["error","log","isAbsolute","join","relative","styleText","chokidar","debounce","mean","prepareConfig","runTypegenGenerate","IGNORED_PATTERNS","createTypegenRunner","onGenerate","state","isGenerating","pendingGeneration","runGeneration","runTypegenWatcher","options","config","workDir","path","schema","stats","failedCount","startTime","Date","now","successfulDurations","duration","push","err","errorMessage","Error","message","debouncedGenerate","paths","Array","isArray","absoluteQueryPatterns","map","pattern","absoluteSchemaPath","watchTargets","watcher","watch","cwd","ignored","ignoreInitial","on","event","filePath","timestamp","toLocaleTimeString","relativePath","getStats","averageGenerationDuration","generationFailedCount","generationSuccessfulCount","length","watcherDuration","stop","close"],"mappings":"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"}
+{"version":3,"sources":["../../src/actions/typegenWatch.ts"],"sourcesContent":["import {error, log} from 'node:console'\nimport {isAbsolute, join, relative} from 'node:path'\nimport {styleText} from 'node:util'\n\nimport chokidar, {FSWatcher} from 'chokidar'\nimport debounce from 'lodash-es/debounce.js'\nimport mean from 'lodash-es/mean.js'\n\nimport {TypegenWatchModeTraceAttributes} from '../typegen.telemetry.js'\nimport {prepareConfig} from '../utils/config.js'\nimport {runTypegenGenerate} from './typegenGenerate.js'\nimport {type RunTypegenOptions} from './types.js'\n\nconst IGNORED_PATTERNS = [\n  '**/node_modules/**',\n  '**/.git/**',\n  '**/dist/**',\n  '**/lib/**',\n  '**/.sanity/**',\n]\n\n/** State for tracking generation status */\ninterface WatchState {\n  isGenerating: boolean\n  pendingGeneration: boolean\n}\n\n/** Return type for createTypegenRunner */\ninterface TypegenRunner {\n  runGeneration: () => Promise<void>\n  state: WatchState\n}\n\ntype WatcherStats = Omit<Extract<TypegenWatchModeTraceAttributes, {step: 'stopped'}>, 'step'>\n\n/**\n * Creates a typegen runner with concurrency control.\n * If generation is already running, queues one more generation to run after completion.\n * Multiple queued requests are coalesced into a single pending generation.\n */\nfunction createTypegenRunner(onGenerate: () => Promise<unknown>): TypegenRunner {\n  const state: WatchState = {\n    isGenerating: false,\n    pendingGeneration: false,\n  }\n\n  async function runGeneration(): Promise<void> {\n    if (state.isGenerating) {\n      state.pendingGeneration = true\n      return\n    }\n\n    state.isGenerating = true\n    state.pendingGeneration = false\n\n    try {\n      await onGenerate()\n    } finally {\n      state.isGenerating = false\n\n      // If a change came in during generation, run again\n      if (state.pendingGeneration) {\n        state.pendingGeneration = false\n        await runGeneration()\n      }\n    }\n  }\n\n  return {runGeneration, state}\n}\n\n/**\n * Starts a file watcher that triggers typegen on changes.\n * Watches both query files (via patterns) and the schema JSON file.\n * Implements debouncing and concurrency control to prevent multiple generations.\n * @public\n */\nexport function runTypegenWatcher(options: RunTypegenOptions): {\n  getStats: () => WatcherStats\n  stop: () => Promise<void>\n  watcher: FSWatcher\n} {\n  const {config, workDir} = options\n  const {path, schema} = prepareConfig(config)\n\n  const stats = {\n    failedCount: 0,\n    startTime: Date.now(),\n    successfulDurations: [] as number[],\n  }\n\n  const {runGeneration} = createTypegenRunner(async () => {\n    try {\n      const {duration} = await runTypegenGenerate({...options})\n      stats.successfulDurations.push(duration)\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : err\n      error(` ${styleText('red', '›')}   ${errorMessage}`)\n      stats.failedCount++\n    }\n  })\n\n  // Debounced generation trigger\n  const debouncedGenerate = debounce(runGeneration, 1000)\n\n  // Build absolute patterns for query files and schema file\n  const paths = Array.isArray(path) ? path : [path]\n  const absoluteQueryPatterns = paths.map((pattern) =>\n    isAbsolute(pattern) ? pattern : join(workDir, pattern),\n  )\n  const absoluteSchemaPath = isAbsolute(schema) ? schema : join(workDir, schema)\n  const watchTargets = [...absoluteQueryPatterns, absoluteSchemaPath]\n\n  // perform initial generation\n  debouncedGenerate()\n\n  // set up watcher\n  const watcher = chokidar.watch(watchTargets, {\n    cwd: workDir,\n    ignored: IGNORED_PATTERNS,\n    ignoreInitial: true,\n  })\n\n  watcher.on('all', (event: string, filePath: string) => {\n    const timestamp = new Date().toLocaleTimeString()\n    const relativePath = isAbsolute(filePath) ? relative(workDir, filePath) : filePath\n    log(`[${timestamp}] ${event}: ${relativePath}`)\n    debouncedGenerate()\n  })\n\n  watcher.on('error', (err: Error) => {\n    error(`Watcher error: ${err.message}`)\n  })\n\n  return {\n    getStats: () => ({\n      averageGenerationDuration: mean(stats.successfulDurations) || 0,\n      generationFailedCount: stats.failedCount,\n      generationSuccessfulCount: stats.successfulDurations.length,\n      watcherDuration: Date.now() - stats.startTime,\n    }),\n    stop: async () => {\n      await watcher.close()\n    },\n    watcher,\n  }\n}\n"],"names":["error","log","isAbsolute","join","relative","styleText","chokidar","debounce","mean","prepareConfig","runTypegenGenerate","IGNORED_PATTERNS","createTypegenRunner","onGenerate","state","isGenerating","pendingGeneration","runGeneration","runTypegenWatcher","options","config","workDir","path","schema","stats","failedCount","startTime","Date","now","successfulDurations","duration","push","err","errorMessage","Error","message","debouncedGenerate","paths","Array","isArray","absoluteQueryPatterns","map","pattern","absoluteSchemaPath","watchTargets","watcher","watch","cwd","ignored","ignoreInitial","on","event","filePath","timestamp","toLocaleTimeString","relativePath","getStats","averageGenerationDuration","generationFailedCount","generationSuccessfulCount","length","watcherDuration","stop","close"],"mappings":"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"}

package/dist/actions/types.js

@@ -1,6 +1,6 @@
 /**
  * Result from a single generation run.
- * @internal
+ * @public
  */ export { };
 
 //# sourceMappingURL=types.js.map

package/dist/actions/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/actions/types.ts"],"sourcesContent":["import {spinner} from '@sanity/cli-core/ux'\nimport {WorkerChannel} from '@sanity/worker-channels'\n\nimport {TypeGenConfig} from '../readConfig.js'\nimport {type TypegenWorkerChannel as CodegenTypegenWorkerChannel} from '../typescript/typeGenerator.js'\n\n/**\n * Data passed to the typegen worker thread.\n * @internal\n */\nexport interface TypegenGenerateTypesWorkerData {\n  /** Path to the schema JSON file */\n  schemaPath: string\n  /** Glob pattern(s) for finding query files */\n  searchPath: string | string[]\n  /** Working directory (project root) */\n  workDir: string\n\n  /** Whether to generate client method overloads */\n  overloadClientMethods?: boolean\n}\n\n/**\n * Worker channel definition for typegen worker communication.\n * Extends the base TypegenWorkerChannel with additional events for progress tracking.\n * @internal\n */\nexport type TypegenWorkerChannel = WorkerChannel.Definition<\n  CodegenTypegenWorkerChannel['__definition'] & {\n    loadedSchema: WorkerChannel.Event\n    typegenComplete: WorkerChannel.Event<{code: string}>\n    typegenStarted: WorkerChannel.Event<{expectedFileCount: number}>\n  }\n>\n\n/**\n * Options for running a single typegen generation.\n * This is the programmatic API for one-off generation without file watching.\n */\nexport interface RunTypegenOptions {\n  /** Working directory (usually project root) */\n  workDir: string\n\n  /** Typegen configuration */\n  config?: Partial<TypeGenConfig>\n\n  /** Optional spinner instance for progress display */\n  spin?: ReturnType<typeof spinner>\n}\n\n/**\n * Result from a single generation run.\n * @internal\n */\nexport interface GenerationResult {\n  code: string\n  duration: number\n  emptyUnionTypeNodesGenerated: number\n  filesWithErrors: number\n  outputSize: number\n  queriesCount: number\n  queryFilesCount: number\n  schemaTypesCount: number\n  typeNodesGenerated: number\n  unknownTypeNodesGenerated: number\n  unknownTypeNodesRatio: number\n}\n"],"names":[],"mappings":"AAkDA;;;CAGC,GACD,WAYC"}
+{"version":3,"sources":["../../src/actions/types.ts"],"sourcesContent":["import {spinner} from '@sanity/cli-core/ux'\nimport {WorkerChannel} from '@sanity/worker-channels'\n\nimport {TypeGenConfig} from '../readConfig.js'\nimport {type TypegenWorkerChannel as CodegenTypegenWorkerChannel} from '../typescript/typeGenerator.js'\n\n/**\n * Data passed to the typegen worker thread.\n * @internal\n */\nexport interface TypegenGenerateTypesWorkerData {\n  /** Path to the schema JSON file */\n  schemaPath: string\n  /** Glob pattern(s) for finding query files */\n  searchPath: string | string[]\n  /** Working directory (project root) */\n  workDir: string\n\n  /** Whether to generate client method overloads */\n  overloadClientMethods?: boolean\n}\n\n/**\n * Worker channel definition for typegen worker communication.\n * Extends the base TypegenWorkerChannel with additional events for progress tracking.\n * @internal\n */\nexport type TypegenWorkerChannel = WorkerChannel.Definition<\n  CodegenTypegenWorkerChannel['__definition'] & {\n    loadedSchema: WorkerChannel.Event\n    typegenComplete: WorkerChannel.Event<{code: string}>\n    typegenStarted: WorkerChannel.Event<{expectedFileCount: number}>\n  }\n>\n\n/**\n * Options for running a single typegen generation.\n * This is the programmatic API for one-off generation without file watching.\n * @public\n */\nexport interface RunTypegenOptions {\n  /** Working directory (usually project root) */\n  workDir: string\n\n  /** Typegen configuration */\n  config?: Partial<TypeGenConfig>\n\n  /** Optional spinner instance for progress display */\n  spin?: ReturnType<typeof spinner>\n}\n\n/**\n * Result from a single generation run.\n * @public\n */\nexport interface GenerationResult {\n  code: string\n  duration: number\n  emptyUnionTypeNodesGenerated: number\n  filesWithErrors: number\n  outputSize: number\n  queriesCount: number\n  queryFilesCount: number\n  schemaTypesCount: number\n  typeNodesGenerated: number\n  unknownTypeNodesGenerated: number\n  unknownTypeNodesRatio: number\n}\n"],"names":[],"mappings":"AAmDA;;;CAGC,GACD,WAYC"}

package/dist/commands/typegen/generate.js

@@ -3,7 +3,8 @@ import { styleText } from 'node:util';
 import { Flags } from '@oclif/core';
 import { SanityCommand } from '@sanity/cli-core';
 import { spinner } from '@sanity/cli-core/ux';
-import { omit, once } from 'lodash-es';
+import omit from 'lodash-es/omit.js';
+import once from 'lodash-es/once.js';
 import { runTypegenGenerate } from '../../actions/typegenGenerate.js';
 import { runTypegenWatcher } from '../../actions/typegenWatch.js';
 import { configDefinition, readConfig } from '../../readConfig.js';