gt 2.21.4 → 2.22.0

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 import type { CustomMapping } from '@generaltranslation/format/types';
+import type { UserTokenProvider } from 'generaltranslation/api';
+import type { ModelProvider } from 'generaltranslation/internal';
 import type { FileFormat } from 'generaltranslation/types';
 import { SUPPORTED_FILE_EXTENSIONS } from '../formats/files/supportedFiles.js';
 import { ParsingConfigOptions, GTParsingFlags, BaseParsingFlags, ParseFlagsByFileType } from './parsing.js';
@@ -179,6 +181,7 @@ export type Settings = {
     baseUrl: string;
     dashboardUrl: string;
     apiKey?: string;
+    userTokenProvider?: UserTokenProvider;
     projectId?: string;
     defaultLocale: string;
     locales: string[];
@@ -214,7 +217,7 @@ export type Settings = {
     fonts?: FontsConfig;
     framework?: SupportedFrameworks;
     options?: AdditionalOptions;
-    modelProvider?: string;
+    modelProvider?: ModelProvider;
     tag?: string;
     tagMessage?: string;
     parsingOptions: ParsingConfigOptions;
@@ -253,7 +256,9 @@ export type AdditionalOptions = {
     experimentalClearLocaleDirs?: boolean;
     clearLocaleDirsExclude?: string[];
     experimentalLocalizeStaticImports?: boolean;
-    experimentalLocalizeStaticUrls?: boolean;
+    experimentalLocalizeStaticUrls?: boolean | {
+        skipUntranslatedPages?: boolean;
+    };
     experimentalLocalizeRelativeAssets?: boolean;
     experimentalAddHeaderAnchorIds?: 'mintlify' | 'default';
     experimentalHideDefaultLocale?: boolean;

package/dist/utils/api.d.ts

@@ -1,16 +1,10 @@
 import type { CustomMapping } from '@generaltranslation/format/types';
-import { type ApiClientConfig, type CreateProjectData, type CreateTagData, type GetBranchInfoData, type ProcessFileMovesData, type PublishFilesData, type SubmitUserEditDiffsData } from 'generaltranslation/api';
+import type { ApiClientConfig } from 'generaltranslation/api';
 export declare function configureApiClient(config: ApiClientConfig & {
     customMapping?: CustomMapping;
 }): void;
 export declare const api: {
-    queryBranchData(body: GetBranchInfoData["body"]): Promise<{
-        branches: Array<import("@generaltranslation/api").Branch>;
-        defaultBranch: import("@generaltranslation/api").Branch & ({
-            [key: string]: unknown;
-        } | null);
-    }>;
-    checkJobStatus(jobIds: string[]): Promise<({
+    checkJobStatus(jobIds: string[], signal?: AbortSignal): Promise<({
         status: "queued";
         jobId: string;
     } | {
@@ -37,22 +31,80 @@ export declare const api: {
         currentLocales: Array<string>;
         autoApprove: boolean;
     }>;
-    publishFiles(files: PublishFilesData["body"]["files"]): Promise<{
-        results: Array<{
-            fileId: string;
-            versionId: string;
-            locale?: string;
-            branchId: string;
+    resolveAliasLocale(locale: string): string;
+    resolveCanonicalLocale(locale: string): string;
+    translate: (source: import("generaltranslation/types").TranslateManyEntry, options: string | import("generaltranslation/types").TranslateOptions, timeoutMs?: number | false) => Promise<import("generaltranslation/types").TranslationResult>;
+    translateMany: {
+        (sources: import("generaltranslation/types").TranslateManyEntry[], options: string | import("generaltranslation/types").TranslateOptions, timeoutMs?: number | false): Promise<import("generaltranslation/types").TranslateManyResult>;
+        (sources: Record<string, import("generaltranslation/types").TranslateManyEntry>, options: string | import("generaltranslation/types").TranslateOptions, timeoutMs?: number | false): Promise<Record<string, import("generaltranslation/types").TranslationResult>>;
+    };
+    queryBranchData(body: import("@generaltranslation/api").GetBranchInfoData["body"]): Promise<{
+        branches: Array<import("@generaltranslation/api").Branch>;
+        defaultBranch: import("@generaltranslation/api").Branch & ({
+            [key: string]: unknown;
+        } | null);
+    }>;
+    createBranch(body: import("@generaltranslation/api").CreateBranchData["body"]): Promise<{
+        branch: import("@generaltranslation/api").Branch;
+    }>;
+    processFileMoves(moves: import("@generaltranslation/api").ProcessFileMovesData["body"]["moves"], options?: Pick<import("@generaltranslation/api").ProcessFileMovesData["body"], "branchId"> & {
+        timeout?: number;
+    }): Promise<{
+        results: {
+            oldFileId: string;
+            newFileId: string;
             success: boolean;
+            newSourceFileId?: string;
+            clonedTranslationsCount?: number;
             error?: string;
+        }[];
+        summary: {
+            total: number;
+            succeeded: number;
+            failed: number;
+        };
+    }>;
+    getOrphanedFiles(branchId: string, fileIds: string[], options?: {
+        timeout?: number;
+    }): Promise<{
+        orphanedFiles: Array<{
+            fileId: string;
+            versionId: string;
+            fileName: string;
         }>;
     }>;
-    submitUserEditDiffs(body: SubmitUserEditDiffsData["body"]): Promise<{
-        filesProcessed: number;
-        entriesReceived: number;
+    setupProject(files: import("@generaltranslation/api").GenerateProjectContextData["body"]["files"], options?: Omit<import("@generaltranslation/api").GenerateProjectContextData["body"], "files"> & {
+        timeoutMs?: number;
+    }): Promise<{
+        status: "completed";
+    } | {
+        setupJobId: string;
+        status: "queued";
+    }>;
+    awaitJobs(jobIds: readonly string[], options?: import("@generaltranslation/api").AwaitJobsOptions): Promise<{
+        jobs: {
+            jobId: string;
+            status: import("@generaltranslation/api").GetTranslationJobInfoResponse[number]["status"];
+            error?: {
+                message: string;
+            };
+        }[];
+        complete: boolean;
+    }>;
+    enqueueFiles(files: import("@generaltranslation/api").EnqueueFileTranslationsData["body"]["files"], options: {
+        sourceLocale?: string;
+        targetLocales: string[];
+        modelProvider?: string;
+        force?: boolean;
+        timeout?: number;
+    }): Promise<{
+        jobData: {
+            [k: string]: any;
+        };
+        locales: string[];
         message: string;
-    }[]>;
-    createTag(body: CreateTagData["body"]): Promise<{
+    }>;
+    createTag(body: import("@generaltranslation/api").CreateTagData["body"]): Promise<{
         tag: {
             id: string;
             tagId: string;
@@ -61,7 +113,24 @@ export declare const api: {
             updatedAt: string;
         };
     }>;
-    createProject(orgId: CreateProjectData["path"]["orgId"], body: CreateProjectData["body"]): Promise<{
+    publishFiles(files: import("@generaltranslation/api").PublishFilesData["body"]["files"]): Promise<{
+        results: Array<{
+            fileId: string;
+            versionId: string;
+            locale?: string;
+            branchId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    submitUserEditDiffs(body: import("@generaltranslation/api").SubmitUserEditDiffsData["body"], options?: {
+        timeout?: number;
+    }): Promise<{
+        filesProcessed: number;
+        entriesReceived: number;
+        message: string;
+    }[]>;
+    createProject(orgId: import("@generaltranslation/api").CreateProjectData["path"]["orgId"], body: import("@generaltranslation/api").CreateProjectData["body"]): Promise<{
         project: {
             id: string;
             name: string;
@@ -69,34 +138,26 @@ export declare const api: {
             defaultLocale: string;
         };
     }>;
-    getOrphanedFiles(branchId: string, fileIds: string[]): Promise<{
-        orphanedFiles: Array<{
-            fileId: string;
-            versionId: string;
-            fileName: string;
-        }>;
-    }>;
-    processFileMoves(moves: ProcessFileMovesData["body"]["moves"], options: Pick<ProcessFileMovesData["body"], "branchId">): Promise<{
-        results: {
-            oldFileId: string;
-            newFileId: string;
-            success: boolean;
-            newSourceFileId?: string;
-            clonedTranslationsCount?: number;
-            error?: string;
-        }[];
-        summary: {
-            total: number;
-            succeeded: number;
-            failed: number;
+    listProjects(): Promise<{
+        id: string;
+        name: string;
+        orgId: string;
+        orgName: string;
+    }[]>;
+    listOrgs(): Promise<{
+        id: string;
+        name: string;
+    }[]>;
+    createProjectApiKey(projectId: import("@generaltranslation/api").CreateProjectApiKeyData["path"]["projectId"], body: import("@generaltranslation/api").CreateProjectApiKeyData["body"]): Promise<{
+        apiKey: {
+            id: string;
+            name: string;
+            key: string;
+            projectId: string;
+            type: "production";
         };
     }>;
-    resolveAliasLocale(locale: string): string;
-    resolveCanonicalLocale(locale: string): string;
-    createBranch(body: import("@generaltranslation/api").CreateBranchData["body"]): Promise<{
-        branch: import("@generaltranslation/api").Branch;
-    }>;
-    queryFileData(body: import("@generaltranslation/api").GetFileInfoData["body"]): Promise<{
+    queryFileData(body: import("@generaltranslation/api").GetFileInfoData["body"], timeoutMs?: number): Promise<{
         translatedFiles: {
             locale: string;
             branchId: string;
@@ -124,38 +185,46 @@ export declare const api: {
             publishedAt: string | null;
         }[];
     }>;
-    downloadFileBatch(files: import("@generaltranslation/api").DownloadFilesData["body"]): Promise<{
+    querySourceFile(path: import("@generaltranslation/api").GetTranslationStatusData["path"], query?: import("@generaltranslation/api").GetTranslationStatusData["query"], timeoutMs?: number): Promise<{
+        translations: {
+            locale: string;
+            completedAt: string | null;
+            approvedAt: string | null;
+            publishedAt: string | null;
+            createdAt: string | null;
+            updatedAt: string | null;
+        }[];
+        sourceFile: {
+            sourceLocale: string;
+            locales: string[];
+            id: string;
+            branchId: string;
+            fileId: string;
+            versionId: string;
+            fileName: string;
+            fileFormat: import("@generaltranslation/api").FileFormat;
+            dataFormat: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    downloadFileBatch(files: import("@generaltranslation/api").DownloadFilesData["body"], options?: {
+        timeout?: number;
+    }): Promise<{
         files: import("generaltranslation/types").DownloadedFile[];
         count: number;
         pending: {
+            locale: string;
             branchId: string;
             fileId: string;
-            locale: string;
             versionId: string;
         }[];
     }>;
-    setupProject(files: import("@generaltranslation/api").GenerateProjectContextData["body"]["files"], options?: Omit<import("@generaltranslation/api").GenerateProjectContextData["body"], "files">): Promise<{
-        status: "completed";
-    } | {
-        setupJobId: string;
-        status: "queued";
-    }>;
-    enqueueFiles(files: import("@generaltranslation/api").EnqueueFileTranslationsData["body"]["files"], options: {
-        sourceLocale?: string;
-        targetLocales: string[];
-        modelProvider?: string;
-        force?: boolean;
-    }): Promise<{
-        jobData: {
-            [k: string]: any;
-        };
-        locales: string[];
-        message: string;
-    }>;
     uploadSourceFiles(files: Array<{
         source: import("@generaltranslation/api").UploadSourceFilesData["body"]["data"][number]["source"];
     }>, options: {
         sourceLocale: string;
+        timeout?: number;
     }): Promise<{
         uploadedFiles: {
             branchId: string;
@@ -167,9 +236,19 @@ export declare const api: {
             locale?: string;
         }[];
     }>;
-    awaitJobs(jobIds: readonly string[], options?: import("@generaltranslation/api").AwaitJobsOptions): Promise<import("@generaltranslation/api").AwaitJobsResult>;
+    uploadFonts(fonts: import("@generaltranslation/api").UploadAssetsData["body"]["assets"], options?: {
+        timeout?: number;
+    }): Promise<{
+        assets: {
+            id: string;
+            assetKey: string;
+            fileName: string;
+        }[];
+        count: number;
+    }>;
     uploadTranslations(files: import("@generaltranslation/api").UploadTranslationsData["body"]["data"], options: {
         sourceLocale: string;
+        timeout?: number;
     }): Promise<{
         uploadedFiles: {
             branchId: string;

package/dist/utils/api.js

@@ -1,105 +1,16 @@
-import { createGtApiAdapter, unwrapApiResult } from "generaltranslation/internal";
-import { createApiClient, createProject, createTag, getBranchInfo, getOrphanedFiles, getProjectInfo, getTranslationJobInfo, processBatches, processFileMoves, publishFiles, submitUserEditDiffs } from "generaltranslation/api";
+import { createGtApiAdapter } from "generaltranslation/internal";
 //#region src/utils/api.ts
-const { configure: configureSharedApi, getClient, getClientConfig, ...sharedApi } = createGtApiAdapter();
+const { configure: configureSharedApi, getClient: _getClient, loadJobStatuses, loadProjectInfo, ...sharedApi } = createGtApiAdapter();
 function configureApiClient(config) {
 	configureSharedApi(config);
 }
 const api = {
 	...sharedApi,
-	async queryBranchData(body) {
-		return unwrapApiResult(await getBranchInfo({
-			body,
-			client: getClient()
-		}));
-	},
-	async checkJobStatus(jobIds) {
-		return unwrapApiResult(await getTranslationJobInfo({
-			body: { jobIds },
-			client: getClient()
-		}));
+	async checkJobStatus(jobIds, signal) {
+		return loadJobStatuses(jobIds, { signal });
 	},
 	async getProjectInfo(timeoutMs) {
-		const config = getClientConfig();
-		if (!config.projectId) throw new Error("Project ID is required to fetch project information");
-		return unwrapApiResult(await getProjectInfo({
-			client: createApiClient({
-				...config,
-				timeoutMs
-			}),
-			path: { projectId: config.projectId }
-		}));
-	},
-	async publishFiles(files) {
-		return unwrapApiResult(await publishFiles({
-			body: { files },
-			client: getClient()
-		}));
-	},
-	async submitUserEditDiffs(body) {
-		return processBatches(body.diffs, async (diffs) => [unwrapApiResult(await submitUserEditDiffs({
-			body: {
-				projectId: body.projectId,
-				diffs: diffs.map((diff) => ({
-					...diff,
-					locale: sharedApi.resolveCanonicalLocale(diff.locale)
-				}))
-			},
-			client: getClient()
-		}))]);
-	},
-	async createTag(body) {
-		return unwrapApiResult(await createTag({
-			body,
-			client: getClient()
-		}));
-	},
-	async createProject(orgId, body) {
-		return unwrapApiResult(await createProject({
-			path: { orgId },
-			body: {
-				...body,
-				defaultLocale: sharedApi.resolveCanonicalLocale(body.defaultLocale)
-			},
-			client: getClient()
-		}));
-	},
-	async getOrphanedFiles(branchId, fileIds) {
-		const request = async (batch) => unwrapApiResult(await getOrphanedFiles({
-			body: {
-				branchId,
-				fileIds: batch
-			},
-			client: getClient()
-		}));
-		if (fileIds.length === 0) return request([]);
-		const results = await processBatches(fileIds, async (batch) => [await request(batch)]);
-		const orphanedFiles = new Map(results[0].orphanedFiles.map((file) => [file.fileId, file]));
-		for (const result of results.slice(1)) {
-			const batchFileIds = new Set(result.orphanedFiles.map((file) => file.fileId));
-			for (const fileId of orphanedFiles.keys()) if (!batchFileIds.has(fileId)) orphanedFiles.delete(fileId);
-		}
-		return { orphanedFiles: [...orphanedFiles.values()] };
-	},
-	async processFileMoves(moves, options) {
-		const result = await processBatches(moves, async (batch) => {
-			return unwrapApiResult(await processFileMoves({
-				body: {
-					branchId: options.branchId,
-					moves: batch
-				},
-				client: getClient()
-			})).results;
-		});
-		const succeeded = result.filter(({ success }) => success).length;
-		return {
-			results: result,
-			summary: {
-				total: moves.length,
-				succeeded,
-				failed: result.length - succeeded
-			}
-		};
+		return loadProjectInfo(void 0, timeoutMs);
 	}
 };
 //#endregion

package/dist/utils/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","names":[],"sources":["../../src/utils/api.ts"],"sourcesContent":["import type { CustomMapping } from '@generaltranslation/format/types';\nimport {\n  createApiClient,\n  createProject,\n  createTag,\n  getBranchInfo,\n  getOrphanedFiles,\n  getProjectInfo,\n  getTranslationJobInfo,\n  processBatches,\n  processFileMoves,\n  publishFiles,\n  submitUserEditDiffs,\n  type ApiClientConfig,\n  type CreateProjectData,\n  type CreateTagData,\n  type GetBranchInfoData,\n  type ProcessFileMovesData,\n  type PublishFilesData,\n  type SubmitUserEditDiffsData,\n} from 'generaltranslation/api';\nimport {\n  createGtApiAdapter,\n  unwrapApiResult,\n} from 'generaltranslation/internal';\n\nconst {\n  configure: configureSharedApi,\n  getClient,\n  getClientConfig,\n  ...sharedApi\n} = createGtApiAdapter();\n\nexport function configureApiClient(\n  config: ApiClientConfig & { customMapping?: CustomMapping }\n): void {\n  configureSharedApi(config);\n}\n\nexport const api = {\n  ...sharedApi,\n  async queryBranchData(body: GetBranchInfoData['body']) {\n    return unwrapApiResult(await getBranchInfo({ body, client: getClient() }));\n  },\n\n  async checkJobStatus(jobIds: string[]) {\n    return unwrapApiResult(\n      await getTranslationJobInfo({\n        body: { jobIds },\n        client: getClient(),\n      })\n    );\n  },\n\n  async getProjectInfo(timeoutMs: number) {\n    const config = getClientConfig();\n    if (!config.projectId) {\n      throw new Error('Project ID is required to fetch project information');\n    }\n    const projectInfoClient = createApiClient({ ...config, timeoutMs });\n    return unwrapApiResult(\n      await getProjectInfo({\n        client: projectInfoClient,\n        path: { projectId: config.projectId },\n      })\n    );\n  },\n\n  async publishFiles(files: PublishFilesData['body']['files']) {\n    return unwrapApiResult(\n      await publishFiles({ body: { files }, client: getClient() })\n    );\n  },\n\n  async submitUserEditDiffs(body: SubmitUserEditDiffsData['body']) {\n    return processBatches(body.diffs, async (diffs) => [\n      unwrapApiResult(\n        await submitUserEditDiffs({\n          body: {\n            projectId: body.projectId,\n            diffs: diffs.map((diff) => ({\n              ...diff,\n              locale: sharedApi.resolveCanonicalLocale(diff.locale),\n            })),\n          },\n          client: getClient(),\n        })\n      ),\n    ]);\n  },\n\n  async createTag(body: CreateTagData['body']) {\n    return unwrapApiResult(await createTag({ body, client: getClient() }));\n  },\n\n  async createProject(\n    orgId: CreateProjectData['path']['orgId'],\n    body: CreateProjectData['body']\n  ) {\n    return unwrapApiResult(\n      await createProject({\n        path: { orgId },\n        body: {\n          ...body,\n          defaultLocale: sharedApi.resolveCanonicalLocale(body.defaultLocale),\n        },\n        client: getClient(),\n      })\n    );\n  },\n\n  // ponytail: duplicates core/src/translate/getOrphanedFiles.ts batching +\n  // intersection; delete one copy when utils/gt.ts is removed.\n  async getOrphanedFiles(branchId: string, fileIds: string[]) {\n    const request = async (batch: string[]) =>\n      unwrapApiResult(\n        await getOrphanedFiles({\n          body: { branchId, fileIds: batch },\n          client: getClient(),\n        })\n      );\n\n    if (fileIds.length === 0) return request([]);\n\n    const results = await processBatches(fileIds, async (batch) => [\n      await request(batch),\n    ]);\n    const orphanedFiles = new Map(\n      results[0].orphanedFiles.map((file) => [file.fileId, file])\n    );\n    for (const result of results.slice(1)) {\n      const batchFileIds = new Set(\n        result.orphanedFiles.map((file) => file.fileId)\n      );\n      for (const fileId of orphanedFiles.keys()) {\n        if (!batchFileIds.has(fileId)) orphanedFiles.delete(fileId);\n      }\n    }\n    return { orphanedFiles: [...orphanedFiles.values()] };\n  },\n\n  async processFileMoves(\n    moves: ProcessFileMovesData['body']['moves'],\n    options: Pick<ProcessFileMovesData['body'], 'branchId'>\n  ) {\n    const result = await processBatches(moves, async (batch) => {\n      const response = unwrapApiResult(\n        await processFileMoves({\n          body: { branchId: options.branchId, moves: batch },\n          client: getClient(),\n        })\n      );\n      return response.results;\n    });\n    const succeeded = result.filter(({ success }) => success).length;\n\n    return {\n      results: result,\n      summary: {\n        total: moves.length,\n        succeeded,\n        failed: result.length - succeeded,\n      },\n    };\n  },\n};\n\nexport type ApiClient = typeof api;\n"],"mappings":"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"}
+{"version":3,"file":"api.js","names":[],"sources":["../../src/utils/api.ts"],"sourcesContent":["import type { CustomMapping } from '@generaltranslation/format/types';\nimport type { ApiClientConfig } from 'generaltranslation/api';\nimport { createGtApiAdapter } from 'generaltranslation/internal';\n\nconst {\n  configure: configureSharedApi,\n  getClient: _getClient,\n  loadJobStatuses,\n  loadProjectInfo,\n  ...sharedApi\n} = createGtApiAdapter();\n\nexport function configureApiClient(\n  config: ApiClientConfig & { customMapping?: CustomMapping }\n): void {\n  configureSharedApi(config);\n}\n\n// CLI keeps the raw service views: unaliased project locales and nullable\n// job errors, plus per-request cancellation for polling.\nexport const api = {\n  ...sharedApi,\n\n  async checkJobStatus(jobIds: string[], signal?: AbortSignal) {\n    return loadJobStatuses(jobIds, { signal });\n  },\n\n  async getProjectInfo(timeoutMs: number) {\n    return loadProjectInfo(undefined, timeoutMs);\n  },\n};\n\nexport type ApiClient = typeof api;\n"],"mappings":";;AAIA,MAAM,EACJ,WAAW,oBACX,WAAW,YACX,iBACA,iBACA,GAAG,cACD,oBAAoB;AAExB,SAAgB,mBACd,QACM;AACN,oBAAmB,OAAO;;AAK5B,MAAa,MAAM;CACjB,GAAG;CAEH,MAAM,eAAe,QAAkB,QAAsB;AAC3D,SAAO,gBAAgB,QAAQ,EAAE,QAAQ,CAAC;;CAG5C,MAAM,eAAe,WAAmB;AACtC,SAAO,gBAAgB,KAAA,GAAW,UAAU;;CAE/C"}

package/dist/utils/credentials.d.ts

@@ -1,16 +1,43 @@
 import { Settings, SupportedFrameworks } from '../types/index.js';
-type Credentials = {
-    apiKeys: ApiKey[];
+export type Credentials = {
+    apiKey: string;
     projectId: string;
 };
-type ApiKey = {
-    key: string;
-    type: 'development' | 'production';
+/** Names of the runtime variables init writes for this framework. */
+export declare function getDevelopmentEnvNames(framework?: SupportedFrameworks): {
+    projectId: string;
+    devApiKey: string;
+};
+/**
+ * Whether the project already has a runtime key: the framework's development
+ * key, or an explicit production key for server runtimes (gt-next, gt-node).
+ * Browser frameworks only read their prefixed key, so there `settings.apiKey`
+ * is tooling auth alone. `settings.projectId` already resolves every
+ * framework prefix. Login is checked separately.
+ */
+export declare function areCredentialsSet(settings: Pick<Settings, 'projectId' | 'apiKey'>, framework?: SupportedFrameworks): boolean;
+/**
+ * Where .env.local content lives and its mode. Follows an existing symlink so
+ * its referent is replaced, never the link itself; anything but a regular
+ * file (dangling link, directory) fails before any write.
+ */
+declare function resolveEnvFile(envFile: string): Promise<{
+    target: string;
+    mode: number;
+} | undefined>;
+type GitExposure = 'no-repository' | 'tracked' | 'ignored' | 'unignored';
+type CredentialsEnvFile = {
+    envFile: string;
+    existing: Awaited<ReturnType<typeof resolveEnvFile>>;
+    exposure: GitExposure;
 };
-export declare function retrieveCredentials(settings: Settings, keyType: 'development' | 'production' | 'all'): Promise<Credentials>;
-export declare function generateCredentialsSession(url: string, keyType: 'development' | 'production' | 'all'): Promise<{
-    sessionId: string;
-}>;
-export declare function areCredentialsSet(): string | undefined;
+/**
+ * Everything that must hold before credentials may be saved to .env.local,
+ * so callers can fail before minting a key: the path is a regular file (or a
+ * link to one) or absent, and neither it nor a link's referent is tracked by
+ * Git. A referent inside any worktree must already be ignored there; only
+ * .env.local itself gets an ignore rule added, by setCredentials.
+ */
+export declare function inspectCredentialsEnvFile(cwd?: string): Promise<CredentialsEnvFile>;
 export declare function setCredentials(credentials: Credentials, framework?: SupportedFrameworks, cwd?: string): Promise<void>;
 export {};