generaltranslation 9.4.2 → 9.5.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # generaltranslation
 
+## 9.5.0
+
+### Minor Changes
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`78e3a57`](https://github.com/generaltranslation/gt/commit/78e3a57c19caffe8fbce2e9bc74e573071d662e8) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Expose diagnostics through the public `generaltranslation/diagnostics` subpath and fail fast with a diagnostic when an unsupported model provider would otherwise be forwarded and rejected by the server. Migrate the CLI to the diagnostics subpath and API version export, and report invalid model-provider settings with the validation diagnostic.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`c734b08`](https://github.com/generaltranslation/gt/commit/c734b084f0a50d1b2787c86ec790403f88803650) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Add `gt login`, `gt logout`, and `gt whoami`. Login uses openid-client with the seeded public `gt-cli` client, S256 PKCE and a loopback callback against the General Translation dashboard. When `--no-browser` is set or the loopback listener cannot bind, login uses device authorization with a displayed verification code. Device polling and retries follow openid-client policy (not blanket network/all-5xx retries). Signed identity tokens are validated before saving per-server credentials in `$XDG_STATE_HOME/gt/credentials.json` (default `~/.local/state/gt/credentials.json`, 0600); refresh preserves the validated account identity. Obsolete pre-release logins require `gt login` again without resetting other servers' entries. Login requests a token for the project's configured `baseUrl` (`GT_API_URL` overrides), records that resource with the credentials, and the CLI refuses to send a login issued for a different API instead of letting the server reject it. The API client and core request path accept a refreshable user-token provider, used only when no API key is configured — an explicit API key always wins. The former development-key rejection is gone; every `gtx-` key is just a key with its own permissions.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`322e927`](https://github.com/generaltranslation/gt/commit/322e9279b7efb17faf220e626a5a3696efc5d863) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Route the `GT` project and file methods through the generated OpenAPI SDK while preserving their published signatures. Requests now use the SDK's idempotency-aware retry policy, so POST requests are no longer retried automatically after network errors or server failures; rate-limit (429) responses are still retried for every method. Remove the stale `deduped` field from uploaded font results because the server has never returned it.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`d5649a4`](https://github.com/generaltranslation/gt/commit/d5649a4d9711c3f752a1706348398935bf44e8e1) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Expose `translate` and `translateMany` on the shared tooling API adapter used by the CLI and Sanity, sharing the `GT`/`GTRuntime` preparation and wire path. Translation requests now honor a configured custom `fetch`, `apiVersion` and `timeoutMs` (`0` is a literal zero, `false` disables the runtime timer) instead of silently dropping them. Translation still performs no generic retries even when the adapter configures a management `retryPolicy`, and the positional class timeout keeps its existing behavior, where `0` selects the default. Cancellation from a caller signal or custom `fetch` now propagates its original `AbortError` across class and adapter translation instead of being reported as an SDK timeout; the timeout diagnostic is raised only when the runtime-owned timer caused the abort.
+
+### Patch Changes
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`87fa5b1`](https://github.com/generaltranslation/gt/commit/87fa5b17cc2dcd265bc96ab77259e4bc4a6c987f) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - `gt auth` and the `gt init` wizard no longer ask for a key type; `-t/--key-type` is removed. There is one kind of project API key, and its permissions are checked by the server. The wizard now saves only the project ID and the framework-prefixed `GT_DEV_API_KEY` that enables hot reload and runtime translation in development; it no longer writes `GT_API_KEY`, which belongs in your hosting environment (production runtime translation) or CI secrets, and both commands print that guidance. `gt init` signs you in (`gt login`) first when no API key is configured, so the CLI translates as you. On the `GT` and `GTRuntime` constructors, `devApiKey` is deprecated in favor of `apiKey`.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`0e87e42`](https://github.com/generaltranslation/gt/commit/0e87e42ac5d93a1c9ee1f5993d074d4c9a4ae387) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Mark logger and model-provider initializers as pure so downstream bundlers can remove them when unused, keeping constant-only imports such as `libraryDefaultLocale` small.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`370c31f`](https://github.com/generaltranslation/gt/commit/370c31f975cd1d2bfa9609ea1827c2900f812665) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Adopt the enriched OpenAPI contract types for runtime translations, download metadata, and action types.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`052d499`](https://github.com/generaltranslation/gt/commit/052d499556f3dcf7c6801d2ba91399783608e70b) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - `gt init` sets up development credentials without the dashboard wizard. After signing in (or with an explicit `GT_API_KEY`), it lists the projects you can access and lets you pick one, or creates a new project in an organization where you can create projects. It then mints a development key limited to `project:translations:generate` and saves the project ID and that key to `.env.local` under the names your framework expects (for example `NEXT_PUBLIC_`, `VITE_`, `GATSBY_`, `REACT_APP_`, `REDWOOD_ENV_`). Existing `.env.local` lines, comments, and any `GT_API_KEY` are preserved; rerunning replaces only those two variables. A project ID already in `gt.config.json` or the environment is used directly, and setup is skipped when a runtime key for it is already configured. `--config` and `--src` now reach the config written by `gt init`. The shared API adapter gains paginated `listProjects` and `listOrgs` plus `createProjectApiKey`.
+
+- [#2205](https://github.com/generaltranslation/gt/pull/2205) [`abc7fea`](https://github.com/generaltranslation/gt/commit/abc7feaeb8be41709178d34db550d7af36c809af) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Consolidate CLI and Sanity request construction on the shared core API adapter, which now owns `createProject` and exposes raw project-info and job-status loaders for compatibility facades.
+
+- Updated dependencies [[`c734b08`](https://github.com/generaltranslation/gt/commit/c734b084f0a50d1b2787c86ec790403f88803650), [`08e6d82`](https://github.com/generaltranslation/gt/commit/08e6d82df8f02045f43bfcc87b35e9a4ae4a9f69)]:
+  - @generaltranslation/api@0.4.0
+
+## 9.4.3
+
+### Patch Changes
+
+- Updated dependencies [[`fde2f0e`](https://github.com/generaltranslation/gt/commit/fde2f0efd4d875b502b1d0bbe5d672abc4babc69)]:
+  - @generaltranslation/api@0.3.2
+
 ## 9.4.2
 
 ### Patch Changes

package/README.md

@@ -13,7 +13,8 @@
 
 # generaltranslation
 
-Core library for General Translation. Used internally by `gt-react` and `gt-next`.
+Core translation, locale, and formatting library for General Translation. Used by
+`gt-react`, `gt-next`, and other GT integrations.
 
 ## Installation
 

package/dist/{ApiError-BcjcnTAr.cjs → ApiError-BCjEo_CM.cjs}

@@ -15,4 +15,4 @@ Object.defineProperty(exports, "ApiError", {
 	}
 });
 
-//# sourceMappingURL=ApiError-BcjcnTAr.cjs.map
+//# sourceMappingURL=ApiError-BCjEo_CM.cjs.map

package/dist/{ApiError-BcjcnTAr.cjs.map → ApiError-BCjEo_CM.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ApiError-BcjcnTAr.cjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU"}
+{"version":3,"file":"ApiError-BCjEo_CM.cjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU"}

package/dist/{ApiError-CUKcz3YS.mjs → ApiError-DxWKM0Xt.mjs}

@@ -10,4 +10,4 @@ var ApiError = class extends Error {
 //#endregion
 export { ApiError as t };
 
-//# sourceMappingURL=ApiError-CUKcz3YS.mjs.map
+//# sourceMappingURL=ApiError-DxWKM0Xt.mjs.map

package/dist/{ApiError-CUKcz3YS.mjs.map → ApiError-DxWKM0Xt.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ApiError-CUKcz3YS.mjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU"}
+{"version":3,"file":"ApiError-DxWKM0Xt.mjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU"}

package/dist/adapter/createGtApi.d.ts

@@ -1,19 +1,170 @@
-import { createApiClient, type ApiClientConfig, type AwaitJobsOptions, type CreateBranchData, type DownloadFilesData, type EnqueueFileTranslationsData, type GenerateProjectContextData, type GetFileInfoData, type UploadSourceFilesData, type UploadTranslationsData } from '@generaltranslation/api';
+import { createApiClient, type ApiClientConfig, type AwaitJobsOptions, type CreateBranchData, type CreateProjectApiKeyData, type CreateProjectData, type CreateTagData, type DownloadFilesData, type EnqueueFileTranslationsData, type GenerateProjectContextData, type GetBranchInfoData, type GetFileInfoData, type GetTranslationJobInfoResponse, type GetTranslationStatusData, type ProcessFileMovesData, type PublishFilesData, type SubmitUserEditDiffsData, type UploadAssetsData, type UploadSourceFilesData, type UploadTranslationsData } from '@generaltranslation/api';
 import type { CustomMapping } from '@generaltranslation/format/types';
 import type { DownloadedFile } from '../types-dir/api/downloadFileBatch';
+import type { TranslateManyEntry, TranslateOptions } from '../types-dir/api/entry';
+import type { TranslateManyResult, TranslationResult } from '../types';
 export type GtApiAdapterConfig = ApiClientConfig & {
     customMapping?: CustomMapping;
 };
-export declare function createGtApiAdapter(defaultConfig?: ApiClientConfig): {
-    configure: (config: GtApiAdapterConfig) => void;
-    getClient: () => ReturnType<typeof createApiClient>;
-    getClientConfig: () => ApiClientConfig;
+export declare function createGtApiAdapter(defaultConfig?: GtApiAdapterConfig): {
+    configure: (nextConfig: GtApiAdapterConfig) => void;
+    getClient: (timeoutMs?: number) => ReturnType<typeof createApiClient>;
     resolveAliasLocale(locale: string): string;
     resolveCanonicalLocale(locale: string): string;
+    translate: (source: TranslateManyEntry, options: string | TranslateOptions, timeoutMs?: number | false) => Promise<TranslationResult>;
+    translateMany: {
+        (sources: TranslateManyEntry[], options: string | TranslateOptions, timeoutMs?: number | false): Promise<TranslateManyResult>;
+        (sources: Record<string, TranslateManyEntry>, options: string | TranslateOptions, timeoutMs?: number | false): Promise<Record<string, TranslationResult>>;
+    };
+    queryBranchData(body: GetBranchInfoData["body"]): Promise<{
+        branches: Array<import("@generaltranslation/api").Branch>;
+        defaultBranch: import("@generaltranslation/api").Branch & ({
+            [key: string]: unknown;
+        } | null);
+    }>;
     createBranch(body: CreateBranchData["body"]): Promise<{
         branch: import("@generaltranslation/api").Branch;
     }>;
-    queryFileData(body: GetFileInfoData["body"]): Promise<{
+    processFileMoves(moves: ProcessFileMovesData["body"]["moves"], options?: Pick<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;
+        }>;
+    }>;
+    setupProject(files: GenerateProjectContextData["body"]["files"], options?: Omit<GenerateProjectContextData["body"], "files"> & {
+        timeoutMs?: number;
+    }): Promise<{
+        status: "completed";
+    } | {
+        setupJobId: string;
+        status: "queued";
+    }>;
+    loadJobStatuses: (jobIds: readonly string[], options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }) => Promise<GetTranslationJobInfoResponse>;
+    checkJobStatus(jobIds: string[], timeoutMs?: number): Promise<{
+        jobId: string;
+        status: GetTranslationJobInfoResponse[number]["status"];
+        error?: {
+            message: string;
+        };
+    }[]>;
+    awaitJobs(jobIds: readonly string[], options?: AwaitJobsOptions): Promise<{
+        jobs: {
+            jobId: string;
+            status: GetTranslationJobInfoResponse[number]["status"];
+            error?: {
+                message: string;
+            };
+        }[];
+        complete: boolean;
+    }>;
+    enqueueFiles(files: 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<{
+        tag: {
+            id: string;
+            tagId: string;
+            message: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    publishFiles(files: PublishFilesData["body"]["files"]): Promise<{
+        results: Array<{
+            fileId: string;
+            versionId: string;
+            locale?: string;
+            branchId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    submitUserEditDiffs(body: SubmitUserEditDiffsData["body"], options?: {
+        timeout?: number;
+    }): Promise<{
+        filesProcessed: number;
+        entriesReceived: number;
+        message: string;
+    }[]>;
+    createProject(orgId: CreateProjectData["path"]["orgId"], body: CreateProjectData["body"]): Promise<{
+        project: {
+            id: string;
+            name: string;
+            orgId: string;
+            defaultLocale: string;
+        };
+    }>;
+    /** Every project the configured credentials can read. */
+    listProjects(): Promise<{
+        id: string;
+        name: string;
+        orgId: string;
+        orgName: string;
+    }[]>;
+    /** Organizations where the signed-in user can create projects; user tokens only. */
+    listOrgs(): Promise<{
+        id: string;
+        name: string;
+    }[]>;
+    createProjectApiKey(projectId: CreateProjectApiKeyData["path"]["projectId"], body: CreateProjectApiKeyData["body"]): Promise<{
+        apiKey: {
+            id: string;
+            name: string;
+            key: string;
+            projectId: string;
+            type: "production";
+        };
+    }>;
+    loadProjectInfo: (projectId?: string, timeoutMs?: number) => Promise<{
+        id: string;
+        name: string;
+        orgId: string;
+        defaultLocale: string;
+        currentLocales: Array<string>;
+        autoApprove: boolean;
+    }>;
+    getProjectInfo(projectId?: string, timeoutMs?: number): Promise<{
+        defaultLocale: string;
+        currentLocales: string[];
+        id: string;
+        name: string;
+        orgId: string;
+        autoApprove: boolean;
+    }>;
+    queryFileData(body: GetFileInfoData["body"], timeoutMs?: number): Promise<{
         translatedFiles: {
             locale: string;
             branchId: string;
@@ -41,38 +192,46 @@ export declare function createGtApiAdapter(defaultConfig?: ApiClientConfig): {
             publishedAt: string | null;
         }[];
     }>;
-    downloadFileBatch(files: DownloadFilesData["body"]): Promise<{
+    querySourceFile(path: GetTranslationStatusData["path"], query?: 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: DownloadFilesData["body"], options?: {
+        timeout?: number;
+    }): Promise<{
         files: DownloadedFile[];
         count: number;
         pending: {
+            locale: string;
             branchId: string;
             fileId: string;
-            locale: string;
             versionId: string;
         }[];
     }>;
-    setupProject(files: GenerateProjectContextData["body"]["files"], options?: Omit<GenerateProjectContextData["body"], "files">): Promise<{
-        status: "completed";
-    } | {
-        setupJobId: string;
-        status: "queued";
-    }>;
-    enqueueFiles(files: 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: UploadSourceFilesData["body"]["data"][number]["source"];
     }>, options: {
         sourceLocale: string;
+        timeout?: number;
     }): Promise<{
         uploadedFiles: {
             branchId: string;
@@ -84,9 +243,19 @@ export declare function createGtApiAdapter(defaultConfig?: ApiClientConfig): {
             locale?: string;
         }[];
     }>;
-    awaitJobs(jobIds: readonly string[], options?: AwaitJobsOptions): Promise<import("@generaltranslation/api").AwaitJobsResult>;
+    uploadFonts(fonts: UploadAssetsData["body"]["assets"], options?: {
+        timeout?: number;
+    }): Promise<{
+        assets: {
+            id: string;
+            assetKey: string;
+            fileName: string;
+        }[];
+        count: number;
+    }>;
     uploadTranslations(files: UploadTranslationsData["body"]["data"], options: {
         sourceLocale: string;
+        timeout?: number;
     }): Promise<{
         uploadedFiles: {
             branchId: string;