langsys-js-typescript 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.2.1 - 2026-06-11
+
+### Changed
+
+- **Migrated off the deprecated API routes onto the current endpoints.** No public API change — the same `t()`, `<Phrase>`, and `<Translate>` usage now talks to:
+    - Reads: `GET /translations?project_id=…&locale=…` (was the deprecated `GET /projects/{id}/translations`).
+    - Writes: `POST /translatable-items` with a unified `{ project_id, translatable_items: [{ type: 'phrase' | 'content_block', … }] }` body (was the deprecated `POST /projects/{id}/tokens` and `POST /projects/{id}/content-blocks`).
+- Missing-phrase registration now chunks into batches of 200 to respect the `/translatable-items` per-request cap.
+- Added `LangsysAppAPI.createTranslatableItems()` as the single write entry point for both phrases and content blocks.
+
 ## 0.1.0 - 2026-05-19
 
 Initial public release. Framework-agnostic TypeScript SDK for the Langsys Translation Manager — the foundation that `langsys-js-svelte` (and future framework-specific bindings) build on.

package/dist/index.d.mts

@@ -511,6 +511,12 @@ declare class LangsysAppAPIClass {
     setBaseUrl(url: string): void;
     validate(config: iLangsysConfig): Promise<ResponseObject>;
     getTranslations(locale: string): Promise<ResponseObject>;
+    /**
+     * Register phrases and/or content blocks via the current unified endpoint.
+     * Each item carries `type: 'phrase' | 'content_block'`. Replaces the
+     * deprecated `projects/{id}/tokens` and `projects/{id}/content-blocks` routes.
+     */
+    createTranslatableItems(items: Array<Record<string, unknown>>): Promise<ResponseObject>;
     post(path: string, data?: Record<string, unknown>): Promise<ResponseObject>;
     get(path: string, data?: Record<string, unknown>): Promise<ResponseObject>;
     delete(path: string, data?: Record<string, unknown>): Promise<ResponseObject>;

package/dist/index.d.ts

@@ -511,6 +511,12 @@ declare class LangsysAppAPIClass {
     setBaseUrl(url: string): void;
     validate(config: iLangsysConfig): Promise<ResponseObject>;
     getTranslations(locale: string): Promise<ResponseObject>;
+    /**
+     * Register phrases and/or content blocks via the current unified endpoint.
+     * Each item carries `type: 'phrase' | 'content_block'`. Replaces the
+     * deprecated `projects/{id}/tokens` and `projects/{id}/content-blocks` routes.
+     */
+    createTranslatableItems(items: Array<Record<string, unknown>>): Promise<ResponseObject>;
     post(path: string, data?: Record<string, unknown>): Promise<ResponseObject>;
     get(path: string, data?: Record<string, unknown>): Promise<ResponseObject>;
     delete(path: string, data?: Record<string, unknown>): Promise<ResponseObject>;

package/dist/index.js

@@ -93,7 +93,18 @@ var LangsysAppAPIClass = class {
     return await this.get("authorize-project/[projectid]");
   }
   async getTranslations(locale) {
-    return await this.get("projects/[projectid]/translations", { locale });
+    return await this.get("translations", { project_id: this.config.projectid, locale });
+  }
+  /**
+   * Register phrases and/or content blocks via the current unified endpoint.
+   * Each item carries `type: 'phrase' | 'content_block'`. Replaces the
+   * deprecated `projects/{id}/tokens` and `projects/{id}/content-blocks` routes.
+   */
+  async createTranslatableItems(items) {
+    return await this.post("translatable-items", {
+      project_id: this.config.projectid,
+      translatable_items: items
+    });
   }
   async post(path, data = {}) {
     return await this.send("POST", path, data);
@@ -480,20 +491,23 @@ var Translations = class {
     if (!this.missingTokens.length) return false;
     this.debug.log("CREATE MISSING TOKENS", this.missingTokens);
     try {
-      const tokensForApi = this.missingTokens.map((tokenObj) => ({
-        projectid: tokenObj.projectid,
-        token: tokenObj.token,
+      const phraseItems = this.missingTokens.map((tokenObj) => ({
+        type: "phrase",
+        phrase: tokenObj.token,
         category: tokenObj.category || null
       }));
-      const response = await LangsysAppAPI.post("projects/[projectid]/tokens", {
-        tokens: tokensForApi
-      });
-      if (!response.status) {
-        if (response.errors) {
-          this.debug.log("TOKEN UPDATE FAIL", this.missingTokens);
-          this.debug.error("Error updating project tokens", response.errors);
+      const BATCH_SIZE = 200;
+      for (let offset = 0; offset < phraseItems.length; offset += BATCH_SIZE) {
+        const response = await LangsysAppAPI.createTranslatableItems(
+          phraseItems.slice(offset, offset + BATCH_SIZE)
+        );
+        if (!response.status) {
+          if (response.errors) {
+            this.debug.log("TOKEN UPDATE FAIL", this.missingTokens);
+            this.debug.error("Error updating project tokens", response.errors);
+          }
+          return false;
         }
-        return false;
       }
       this.missingTokens.forEach((tokenObj) => {
         const lookupCat = tokenObj.category || "__uncategorized__";
@@ -1048,10 +1062,16 @@ async function registerContentBlock(contentBlock) {
     return { status: true };
   }
   try {
-    const response = await LangsysAppAPI.post(
-      "projects/[projectid]/content-blocks",
-      contentBlock
-    );
+    const response = await LangsysAppAPI.createTranslatableItems([
+      {
+        type: "content_block",
+        custom_id: contentBlock.custom_id,
+        category: contentBlock.category,
+        content: contentBlock.content,
+        label: contentBlock.label,
+        phrases: contentBlock.tokens.map((phrase) => ({ phrase }))
+      }
+    ]);
     if (!response.status) {
       logger.error("Could not save content block", response.errors);
       return { status: false, errors: response.errors };