@lingo.dev/_sdk 0.10.2 → 0.12.0

package/build/index.cjs

@@ -10,11 +10,13 @@ var engineParamsSchema = _zod2.default.object({
 }).passthrough();
 var payloadSchema = _zod2.default.record(_zod2.default.string(), _zod2.default.any());
 var referenceSchema = _zod2.default.record(__spec.localeCodeSchema, payloadSchema);
+var hintsSchema = _zod2.default.record(_zod2.default.string(), _zod2.default.array(_zod2.default.string()));
 var localizationParamsSchema = _zod2.default.object({
   sourceLocale: _zod2.default.union([__spec.localeCodeSchema, _zod2.default.null()]),
   targetLocale: __spec.localeCodeSchema,
   fast: _zod2.default.boolean().optional(),
-  reference: referenceSchema.optional()
+  reference: referenceSchema.optional(),
+  hints: hintsSchema.optional()
 });
 var LingoDotDevEngine = class {
   
@@ -48,7 +50,7 @@ var LingoDotDevEngine = class {
       const processedPayloadChunk = await this.localizeChunk(
         finalParams.sourceLocale,
         finalParams.targetLocale,
-        { data: chunk, reference: params.reference },
+        { data: chunk, reference: params.reference, hints: params.hints },
         workflowId,
         params.fast || false,
         signal
@@ -85,7 +87,8 @@ var LingoDotDevEngine = class {
             target: targetLocale
           },
           data: payload.data,
-          reference: payload.reference
+          reference: payload.reference,
+          hints: payload.hints
         },
         null,
         2
@@ -217,6 +220,26 @@ var LingoDotDevEngine = class {
     );
     return responses;
   }
+  /**
+   * Localize an array of strings
+   * @param strings - An array of strings to be localized
+   * @param params - Localization parameters:
+   *   - sourceLocale: The source language code (e.g., 'en')
+   *   - targetLocale: The target language code (e.g., 'es')
+   *   - fast: Optional boolean to enable fast mode (faster for bigger batches)
+   * @returns An array of localized strings in the same order
+   */
+  async localizeStringArray(strings, params) {
+    const mapped = strings.reduce(
+      (acc, str, i) => {
+        acc[`item_${i}`] = str;
+        return acc;
+      },
+      {}
+    );
+    const result = await this.localizeObject(mapped, params);
+    return Object.values(result);
+  }
   /**
    * Localize a chat sequence while preserving speaker names
    * @param chat - Array of chat messages, each with 'name' and 'text' properties

package/build/index.d.cts

@@ -23,16 +23,19 @@ declare const localizationParamsSchema: Z.ZodObject<{
     targetLocale: Z.ZodEffects<Z.ZodString, string, string>;
     fast: Z.ZodOptional<Z.ZodBoolean>;
     reference: Z.ZodOptional<Z.ZodRecord<Z.ZodEffects<Z.ZodString, string, string>, Z.ZodRecord<Z.ZodString, Z.ZodAny>>>;
+    hints: Z.ZodOptional<Z.ZodRecord<Z.ZodString, Z.ZodArray<Z.ZodString, "many">>>;
 }, "strip", Z.ZodTypeAny, {
     sourceLocale: string | null;
     targetLocale: string;
     fast?: boolean | undefined;
     reference?: Record<string, Record<string, any>> | undefined;
+    hints?: Record<string, string[]> | undefined;
 }, {
     sourceLocale: string | null;
     targetLocale: string;
     fast?: boolean | undefined;
     reference?: Record<string, Record<string, any>> | undefined;
+    hints?: Record<string, string[]> | undefined;
 }>;
 /**
  * LingoDotDevEngine class for interacting with the LingoDotDev API
@@ -118,6 +121,16 @@ declare class LingoDotDevEngine {
         targetLocales: LocaleCode[];
         fast?: boolean;
     }, signal?: AbortSignal): Promise<string[]>;
+    /**
+     * Localize an array of strings
+     * @param strings - An array of strings to be localized
+     * @param params - Localization parameters:
+     *   - sourceLocale: The source language code (e.g., 'en')
+     *   - targetLocale: The target language code (e.g., 'es')
+     *   - fast: Optional boolean to enable fast mode (faster for bigger batches)
+     * @returns An array of localized strings in the same order
+     */
+    localizeStringArray(strings: string[], params: Z.infer<typeof localizationParamsSchema>): Promise<string[]>;
     /**
      * Localize a chat sequence while preserving speaker names
      * @param chat - Array of chat messages, each with 'name' and 'text' properties

package/build/index.d.ts

@@ -23,16 +23,19 @@ declare const localizationParamsSchema: Z.ZodObject<{
     targetLocale: Z.ZodEffects<Z.ZodString, string, string>;
     fast: Z.ZodOptional<Z.ZodBoolean>;
     reference: Z.ZodOptional<Z.ZodRecord<Z.ZodEffects<Z.ZodString, string, string>, Z.ZodRecord<Z.ZodString, Z.ZodAny>>>;
+    hints: Z.ZodOptional<Z.ZodRecord<Z.ZodString, Z.ZodArray<Z.ZodString, "many">>>;
 }, "strip", Z.ZodTypeAny, {
     sourceLocale: string | null;
     targetLocale: string;
     fast?: boolean | undefined;
     reference?: Record<string, Record<string, any>> | undefined;
+    hints?: Record<string, string[]> | undefined;
 }, {
     sourceLocale: string | null;
     targetLocale: string;
     fast?: boolean | undefined;
     reference?: Record<string, Record<string, any>> | undefined;
+    hints?: Record<string, string[]> | undefined;
 }>;
 /**
  * LingoDotDevEngine class for interacting with the LingoDotDev API
@@ -118,6 +121,16 @@ declare class LingoDotDevEngine {
         targetLocales: LocaleCode[];
         fast?: boolean;
     }, signal?: AbortSignal): Promise<string[]>;
+    /**
+     * Localize an array of strings
+     * @param strings - An array of strings to be localized
+     * @param params - Localization parameters:
+     *   - sourceLocale: The source language code (e.g., 'en')
+     *   - targetLocale: The target language code (e.g., 'es')
+     *   - fast: Optional boolean to enable fast mode (faster for bigger batches)
+     * @returns An array of localized strings in the same order
+     */
+    localizeStringArray(strings: string[], params: Z.infer<typeof localizationParamsSchema>): Promise<string[]>;
     /**
      * Localize a chat sequence while preserving speaker names
      * @param chat - Array of chat messages, each with 'name' and 'text' properties

package/build/index.mjs

@@ -10,11 +10,13 @@ var engineParamsSchema = Z.object({
 }).passthrough();
 var payloadSchema = Z.record(Z.string(), Z.any());
 var referenceSchema = Z.record(localeCodeSchema, payloadSchema);
+var hintsSchema = Z.record(Z.string(), Z.array(Z.string()));
 var localizationParamsSchema = Z.object({
   sourceLocale: Z.union([localeCodeSchema, Z.null()]),
   targetLocale: localeCodeSchema,
   fast: Z.boolean().optional(),
-  reference: referenceSchema.optional()
+  reference: referenceSchema.optional(),
+  hints: hintsSchema.optional()
 });
 var LingoDotDevEngine = class {
   config;
@@ -48,7 +50,7 @@ var LingoDotDevEngine = class {
       const processedPayloadChunk = await this.localizeChunk(
         finalParams.sourceLocale,
         finalParams.targetLocale,
-        { data: chunk, reference: params.reference },
+        { data: chunk, reference: params.reference, hints: params.hints },
         workflowId,
         params.fast || false,
         signal
@@ -85,7 +87,8 @@ var LingoDotDevEngine = class {
             target: targetLocale
           },
           data: payload.data,
-          reference: payload.reference
+          reference: payload.reference,
+          hints: payload.hints
         },
         null,
         2
@@ -217,6 +220,26 @@ var LingoDotDevEngine = class {
     );
     return responses;
   }
+  /**
+   * Localize an array of strings
+   * @param strings - An array of strings to be localized
+   * @param params - Localization parameters:
+   *   - sourceLocale: The source language code (e.g., 'en')
+   *   - targetLocale: The target language code (e.g., 'es')
+   *   - fast: Optional boolean to enable fast mode (faster for bigger batches)
+   * @returns An array of localized strings in the same order
+   */
+  async localizeStringArray(strings, params) {
+    const mapped = strings.reduce(
+      (acc, str, i) => {
+        acc[`item_${i}`] = str;
+        return acc;
+      },
+      {}
+    );
+    const result = await this.localizeObject(mapped, params);
+    return Object.values(result);
+  }
   /**
    * Localize a chat sequence while preserving speaker names
    * @param chat - Array of chat messages, each with 'name' and 'text' properties

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_sdk",
-  "version": "0.10.2",
+  "version": "0.12.0",
   "description": "Lingo.dev JS SDK",
   "private": false,
   "publishConfig": {
@@ -21,7 +21,7 @@
     "@paralleldrive/cuid2": "^2.2.2",
     "jsdom": "^25.0.1",
     "zod": "^3.25.76",
-    "@lingo.dev/_spec": "0.39.3"
+    "@lingo.dev/_spec": "0.40.0"
   },
   "devDependencies": {
     "@types/jsdom": "^21.1.7",
@@ -31,7 +31,8 @@
   },
   "scripts": {
     "dev": "tsup --watch",
-    "build": "tsc --noEmit && tsup",
+    "build": "pnpm typecheck && tsup",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run"
   }
 }