@lingo.dev/_sdk 0.7.16 → 0.7.18

package/build/index.cjs

@@ -9,16 +9,17 @@ var engineParamsSchema = _zod2.default.object({
   idealBatchItemSize: _zod2.default.number().int().gt(0).lte(2500).default(250)
 }).passthrough();
 var payloadSchema = _zod2.default.record(_zod2.default.string(), _zod2.default.any());
+var referenceSchema = _zod2.default.record(__spec.localeCodeSchema, payloadSchema);
 var localizationParamsSchema = _zod2.default.object({
   sourceLocale: __spec.localeCodeSchema,
   targetLocale: __spec.localeCodeSchema,
-  fast: _zod2.default.boolean().optional()
+  fast: _zod2.default.boolean().optional(),
+  reference: referenceSchema.optional()
 });
-var referenceSchema = _zod2.default.record(__spec.localeCodeSchema, payloadSchema);
-var ReplexicaEngine = class {
+var LingoDotDevEngine = class {
   
   /**
-   * Create a new ReplexicaEngine instance
+   * Create a new LingoDotDevEngine instance
    * @param config - Configuration options for the Engine
    */
   constructor(config) {
@@ -28,12 +29,11 @@ var ReplexicaEngine = class {
    * Localize content using the Lingo.dev API
    * @param payload - The content to be localized
    * @param params - Localization parameters including source/target locales and fast mode option
-   * @param reference - Optional reference translations to maintain consistency
    * @param progressCallback - Optional callback function to report progress (0-100)
    * @returns Localized content
    * @internal
    */
-  async _localizeRaw(payload, params, reference, progressCallback) {
+  async _localizeRaw(payload, params, progressCallback) {
     const finalPayload = payloadSchema.parse(payload);
     const finalParams = localizationParamsSchema.parse(params);
     const chunkedPayload = this.extractPayloadChunks(finalPayload);
@@ -45,7 +45,7 @@ var ReplexicaEngine = class {
       const processedPayloadChunk = await this.localizeChunk(
         finalParams.sourceLocale,
         finalParams.targetLocale,
-        { data: chunk, reference },
+        { data: chunk, reference: params.reference },
         workflowId,
         params.fast || false
       );
@@ -145,7 +145,7 @@ var ReplexicaEngine = class {
    * @returns A new object with the same structure but localized string values
    */
   async localizeObject(obj, params, progressCallback) {
-    return this._localizeRaw(obj, params, void 0, progressCallback);
+    return this._localizeRaw(obj, params, progressCallback);
   }
   /**
    * Localize a single text string
@@ -158,7 +158,7 @@ var ReplexicaEngine = class {
    * @returns The localized text string
    */
   async localizeText(text, params, progressCallback) {
-    const response = await this._localizeRaw({ text }, params, void 0, progressCallback);
+    const response = await this._localizeRaw({ text }, params, progressCallback);
     return response.text || "";
   }
   /**
@@ -193,7 +193,7 @@ var ReplexicaEngine = class {
    * @returns Array of localized chat messages with preserved structure
    */
   async localizeChat(chat, params, progressCallback) {
-    const localized = await this._localizeRaw({ chat }, params, void 0, progressCallback);
+    const localized = await this._localizeRaw({ chat }, params, progressCallback);
     return Object.entries(localized).map(([key, value]) => ({
       name: chat[parseInt(key.split("_")[1])].name,
       text: value
@@ -274,7 +274,7 @@ var ReplexicaEngine = class {
     };
     Array.from(document.head.childNodes).filter((n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _10 => _10.textContent, 'optionalAccess', _11 => _11.trim, 'call', _12 => _12()])).forEach(processNode);
     Array.from(document.body.childNodes).filter((n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _13 => _13.textContent, 'optionalAccess', _14 => _14.trim, 'call', _15 => _15()])).forEach(processNode);
-    const localizedContent = await this._localizeRaw(extractedContent, params, void 0, progressCallback);
+    const localizedContent = await this._localizeRaw(extractedContent, params, progressCallback);
     document.documentElement.setAttribute("lang", params.targetLocale);
     Object.entries(localizedContent).forEach(([path, value]) => {
       const [nodePath, attribute] = path.split("#");
@@ -321,6 +321,20 @@ var ReplexicaEngine = class {
     return jsonResponse.locale;
   }
 };
+var ReplexicaEngine = class extends LingoDotDevEngine {
+  constructor(config) {
+    super(config);
+    console.warn("ReplexicaEngine is deprecated. Please use LingoDotDevEngine instead.");
+  }
+};
+var LingoEngine = class extends LingoDotDevEngine {
+  constructor(config) {
+    super(config);
+    console.warn("LingoEngine is deprecated. Please use LingoDotDevEngine instead.");
+  }
+};
+
+
 
 
-exports.ReplexicaEngine = ReplexicaEngine;
+exports.LingoDotDevEngine = LingoDotDevEngine; exports.LingoEngine = LingoEngine; exports.ReplexicaEngine = ReplexicaEngine;

package/build/index.d.cts

@@ -22,25 +22,27 @@ declare const localizationParamsSchema: Z.ZodObject<{
     sourceLocale: Z.ZodEffects<Z.ZodString, string, string>;
     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>>>;
 }, "strip", Z.ZodTypeAny, {
     sourceLocale: string;
     targetLocale: string;
     fast?: boolean | undefined;
+    reference?: Record<string, Record<string, any>> | undefined;
 }, {
     sourceLocale: string;
     targetLocale: string;
     fast?: boolean | undefined;
+    reference?: Record<string, Record<string, any>> | undefined;
 }>;
-declare const referenceSchema: Z.ZodRecord<Z.ZodEffects<Z.ZodString, string, string>, Z.ZodRecord<Z.ZodString, Z.ZodAny>>;
 /**
- * ReplexicaEngine class for interacting with the Lingo.dev API
+ * LingoDotDevEngine class for interacting with the LingoDotDev API
  * A powerful localization engine that supports various content types including
  * plain text, objects, chat sequences, and HTML documents.
  */
-declare class ReplexicaEngine {
-    private config;
+declare class LingoDotDevEngine {
+    protected config: Z.infer<typeof engineParamsSchema>;
     /**
-     * Create a new ReplexicaEngine instance
+     * Create a new LingoDotDevEngine instance
      * @param config - Configuration options for the Engine
      */
     constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
@@ -48,12 +50,11 @@ declare class ReplexicaEngine {
      * Localize content using the Lingo.dev API
      * @param payload - The content to be localized
      * @param params - Localization parameters including source/target locales and fast mode option
-     * @param reference - Optional reference translations to maintain consistency
      * @param progressCallback - Optional callback function to report progress (0-100)
      * @returns Localized content
      * @internal
      */
-    _localizeRaw(payload: Z.infer<typeof payloadSchema>, params: Z.infer<typeof localizationParamsSchema>, reference?: Z.infer<typeof referenceSchema>, progressCallback?: (progress: number, sourceChunk: Record<string, string>, processedChunk: Record<string, string>) => void): Promise<Record<string, string>>;
+    _localizeRaw(payload: Z.infer<typeof payloadSchema>, params: Z.infer<typeof localizationParamsSchema>, progressCallback?: (progress: number, sourceChunk: Record<string, string>, processedChunk: Record<string, string>) => void): Promise<Record<string, string>>;
     /**
      * Localize a single chunk of content
      * @param sourceLocale - Source locale
@@ -146,5 +147,17 @@ declare class ReplexicaEngine {
      */
     recognizeLocale(text: string): Promise<LocaleCode>;
 }
+/**
+ * @deprecated Use LingoDotDevEngine instead. This class is maintained for backwards compatibility.
+ */
+declare class ReplexicaEngine extends LingoDotDevEngine {
+    constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
+}
+/**
+ * @deprecated Use LingoDotDevEngine instead. This class is maintained for backwards compatibility.
+ */
+declare class LingoEngine extends LingoDotDevEngine {
+    constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
+}
 
-export { ReplexicaEngine };
+export { LingoDotDevEngine, LingoEngine, ReplexicaEngine };

package/build/index.d.ts

@@ -22,25 +22,27 @@ declare const localizationParamsSchema: Z.ZodObject<{
     sourceLocale: Z.ZodEffects<Z.ZodString, string, string>;
     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>>>;
 }, "strip", Z.ZodTypeAny, {
     sourceLocale: string;
     targetLocale: string;
     fast?: boolean | undefined;
+    reference?: Record<string, Record<string, any>> | undefined;
 }, {
     sourceLocale: string;
     targetLocale: string;
     fast?: boolean | undefined;
+    reference?: Record<string, Record<string, any>> | undefined;
 }>;
-declare const referenceSchema: Z.ZodRecord<Z.ZodEffects<Z.ZodString, string, string>, Z.ZodRecord<Z.ZodString, Z.ZodAny>>;
 /**
- * ReplexicaEngine class for interacting with the Lingo.dev API
+ * LingoDotDevEngine class for interacting with the LingoDotDev API
  * A powerful localization engine that supports various content types including
  * plain text, objects, chat sequences, and HTML documents.
  */
-declare class ReplexicaEngine {
-    private config;
+declare class LingoDotDevEngine {
+    protected config: Z.infer<typeof engineParamsSchema>;
     /**
-     * Create a new ReplexicaEngine instance
+     * Create a new LingoDotDevEngine instance
      * @param config - Configuration options for the Engine
      */
     constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
@@ -48,12 +50,11 @@ declare class ReplexicaEngine {
      * Localize content using the Lingo.dev API
      * @param payload - The content to be localized
      * @param params - Localization parameters including source/target locales and fast mode option
-     * @param reference - Optional reference translations to maintain consistency
      * @param progressCallback - Optional callback function to report progress (0-100)
      * @returns Localized content
      * @internal
      */
-    _localizeRaw(payload: Z.infer<typeof payloadSchema>, params: Z.infer<typeof localizationParamsSchema>, reference?: Z.infer<typeof referenceSchema>, progressCallback?: (progress: number, sourceChunk: Record<string, string>, processedChunk: Record<string, string>) => void): Promise<Record<string, string>>;
+    _localizeRaw(payload: Z.infer<typeof payloadSchema>, params: Z.infer<typeof localizationParamsSchema>, progressCallback?: (progress: number, sourceChunk: Record<string, string>, processedChunk: Record<string, string>) => void): Promise<Record<string, string>>;
     /**
      * Localize a single chunk of content
      * @param sourceLocale - Source locale
@@ -146,5 +147,17 @@ declare class ReplexicaEngine {
      */
     recognizeLocale(text: string): Promise<LocaleCode>;
 }
+/**
+ * @deprecated Use LingoDotDevEngine instead. This class is maintained for backwards compatibility.
+ */
+declare class ReplexicaEngine extends LingoDotDevEngine {
+    constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
+}
+/**
+ * @deprecated Use LingoDotDevEngine instead. This class is maintained for backwards compatibility.
+ */
+declare class LingoEngine extends LingoDotDevEngine {
+    constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
+}
 
-export { ReplexicaEngine };
+export { LingoDotDevEngine, LingoEngine, ReplexicaEngine };

package/build/index.mjs

@@ -9,16 +9,17 @@ var engineParamsSchema = Z.object({
   idealBatchItemSize: Z.number().int().gt(0).lte(2500).default(250)
 }).passthrough();
 var payloadSchema = Z.record(Z.string(), Z.any());
+var referenceSchema = Z.record(localeCodeSchema, payloadSchema);
 var localizationParamsSchema = Z.object({
   sourceLocale: localeCodeSchema,
   targetLocale: localeCodeSchema,
-  fast: Z.boolean().optional()
+  fast: Z.boolean().optional(),
+  reference: referenceSchema.optional()
 });
-var referenceSchema = Z.record(localeCodeSchema, payloadSchema);
-var ReplexicaEngine = class {
+var LingoDotDevEngine = class {
   config;
   /**
-   * Create a new ReplexicaEngine instance
+   * Create a new LingoDotDevEngine instance
    * @param config - Configuration options for the Engine
    */
   constructor(config) {
@@ -28,12 +29,11 @@ var ReplexicaEngine = class {
    * Localize content using the Lingo.dev API
    * @param payload - The content to be localized
    * @param params - Localization parameters including source/target locales and fast mode option
-   * @param reference - Optional reference translations to maintain consistency
    * @param progressCallback - Optional callback function to report progress (0-100)
    * @returns Localized content
    * @internal
    */
-  async _localizeRaw(payload, params, reference, progressCallback) {
+  async _localizeRaw(payload, params, progressCallback) {
     const finalPayload = payloadSchema.parse(payload);
     const finalParams = localizationParamsSchema.parse(params);
     const chunkedPayload = this.extractPayloadChunks(finalPayload);
@@ -45,7 +45,7 @@ var ReplexicaEngine = class {
       const processedPayloadChunk = await this.localizeChunk(
         finalParams.sourceLocale,
         finalParams.targetLocale,
-        { data: chunk, reference },
+        { data: chunk, reference: params.reference },
         workflowId,
         params.fast || false
       );
@@ -145,7 +145,7 @@ var ReplexicaEngine = class {
    * @returns A new object with the same structure but localized string values
    */
   async localizeObject(obj, params, progressCallback) {
-    return this._localizeRaw(obj, params, void 0, progressCallback);
+    return this._localizeRaw(obj, params, progressCallback);
   }
   /**
    * Localize a single text string
@@ -158,7 +158,7 @@ var ReplexicaEngine = class {
    * @returns The localized text string
    */
   async localizeText(text, params, progressCallback) {
-    const response = await this._localizeRaw({ text }, params, void 0, progressCallback);
+    const response = await this._localizeRaw({ text }, params, progressCallback);
     return response.text || "";
   }
   /**
@@ -193,7 +193,7 @@ var ReplexicaEngine = class {
    * @returns Array of localized chat messages with preserved structure
    */
   async localizeChat(chat, params, progressCallback) {
-    const localized = await this._localizeRaw({ chat }, params, void 0, progressCallback);
+    const localized = await this._localizeRaw({ chat }, params, progressCallback);
     return Object.entries(localized).map(([key, value]) => ({
       name: chat[parseInt(key.split("_")[1])].name,
       text: value
@@ -274,7 +274,7 @@ var ReplexicaEngine = class {
     };
     Array.from(document.head.childNodes).filter((n) => n.nodeType === 1 || n.nodeType === 3 && n.textContent?.trim()).forEach(processNode);
     Array.from(document.body.childNodes).filter((n) => n.nodeType === 1 || n.nodeType === 3 && n.textContent?.trim()).forEach(processNode);
-    const localizedContent = await this._localizeRaw(extractedContent, params, void 0, progressCallback);
+    const localizedContent = await this._localizeRaw(extractedContent, params, progressCallback);
     document.documentElement.setAttribute("lang", params.targetLocale);
     Object.entries(localizedContent).forEach(([path, value]) => {
       const [nodePath, attribute] = path.split("#");
@@ -321,6 +321,20 @@ var ReplexicaEngine = class {
     return jsonResponse.locale;
   }
 };
+var ReplexicaEngine = class extends LingoDotDevEngine {
+  constructor(config) {
+    super(config);
+    console.warn("ReplexicaEngine is deprecated. Please use LingoDotDevEngine instead.");
+  }
+};
+var LingoEngine = class extends LingoDotDevEngine {
+  constructor(config) {
+    super(config);
+    console.warn("LingoEngine is deprecated. Please use LingoDotDevEngine instead.");
+  }
+};
 export {
+  LingoDotDevEngine,
+  LingoEngine,
   ReplexicaEngine
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_sdk",
-  "version": "0.7.16",
+  "version": "0.7.18",
   "description": "Lingo.dev JS SDK",
   "private": false,
   "publishConfig": {
@@ -23,7 +23,7 @@
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
     "zod": "^3.24.1",
-    "@lingo.dev/_spec": "0.25.0"
+    "@lingo.dev/_spec": "0.25.1"
   },
   "devDependencies": {
     "@types/jsdom": "^21.1.7",