feat(sdk): added new sdk methods localizeStringArray (#1049)

* feat(sdk): add new methods in sdk as localizeSimpleMap and localizeStringArray

* feat(sdk): adds sdk test for new methods

* style(sdk): format sdk using prettier

* feat(sdk): removes unwanted sdk methods localizeSimpleMap and its test

---------

Co-authored-by: Max Prilutskiy <[email protected]>

Author: VAIBHAVSING

.changeset/empty-meals-type.md

@@ -0,0 +1,10 @@
+---
+"@lingo.dev/_sdk": minor
+"@replexica/sdk": minor
+---
+
+Added new methods to the SDK:
+
+1. `localizeStringArray`: Localizes an array of strings while maintaining their order.
+
+Also added comprehensive tests for these methods using Vitest.

packages/sdk/src/index.spec.ts

@@ -91,4 +91,62 @@ describe("ReplexicaEngine", () => {
       );
     });
   });
+
+  describe("localizeStringArray", () => {
+    it("should localize an array of strings and maintain order", async () => {
+      const engine = new LingoDotDevEngine({ apiKey: "test" });
+      const mockLocalizeObject = vi.spyOn(engine, "localizeObject");
+      mockLocalizeObject.mockImplementation(async (obj: any) => {
+        // Simulate translation by adding 'ES:' prefix to all string values
+        return Object.fromEntries(
+          Object.entries(obj).map(([key, value]) => [key, `ES:${value}`]),
+        );
+      });
+
+      const inputArray = ["Hello", "Goodbye", "How are you?"];
+
+      const result = await engine.localizeStringArray(inputArray, {
+        sourceLocale: "en",
+        targetLocale: "es",
+      });
+
+      // Verify the mapped object was passed to localizeObject
+      expect(mockLocalizeObject).toHaveBeenCalledWith(
+        {
+          item_0: "Hello",
+          item_1: "Goodbye",
+          item_2: "How are you?",
+        },
+        {
+          sourceLocale: "en",
+          targetLocale: "es",
+        },
+      );
+
+      // Verify the result maintains the original order
+      expect(result).toEqual(["ES:Hello", "ES:Goodbye", "ES:How are you?"]);
+      expect(result).toHaveLength(3);
+    });
+
+    it("should handle empty array", async () => {
+      const engine = new LingoDotDevEngine({ apiKey: "test" });
+      const mockLocalizeObject = vi.spyOn(engine, "localizeObject");
+      mockLocalizeObject.mockImplementation(async () => ({}));
+
+      const result = await engine.localizeStringArray([], {
+        sourceLocale: "en",
+        targetLocale: "es",
+      });
+
+      expect(mockLocalizeObject).toHaveBeenCalledWith(
+        {},
+        {
+          sourceLocale: "en",
+          targetLocale: "es",
+        },
+      );
+
+      expect(result).toEqual([]);
+    });
+  });
 });

packages/sdk/src/index.ts

@@ -298,6 +298,31 @@ export class LingoDotDevEngine {
     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: string[],
+    params: Z.infer<typeof localizationParamsSchema>,
+  ): Promise<string[]> {
+    const mapped = strings.reduce(
+      (acc, str, i) => {
+        acc[`item_${i}`] = str;
+        return acc;
+      },
+      {} as Record<string, string>,
+    );
+
+    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