langsys-js-typescript 0.2.0 → 0.2.2

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

@@ -239,6 +239,14 @@ declare class Translations {
     private missingToken;
     private scheduleTokenFlush;
     setup(config: iLangsysConfig): void;
+    /**
+     * Record that a locale's catalog is already present without fetching —
+     * e.g. after an SSR handoff seeds `sTranslations` + `currentlyLoadedLocale`.
+     * This primes the same `lastLoaded` cache `change()` consults, so the first
+     * settle for that locale is a cache hit (no redundant fetch) while every
+     * later switch *to* it still flows through `change()` normally.
+     */
+    markLoaded(locale: string): void;
     /**
      * React to a user-locale change. Fetches translations if we haven't
      * loaded this locale within the last 60s (or if forced).
@@ -511,6 +519,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

@@ -239,6 +239,14 @@ declare class Translations {
     private missingToken;
     private scheduleTokenFlush;
     setup(config: iLangsysConfig): void;
+    /**
+     * Record that a locale's catalog is already present without fetching —
+     * e.g. after an SSR handoff seeds `sTranslations` + `currentlyLoadedLocale`.
+     * This primes the same `lastLoaded` cache `change()` consults, so the first
+     * settle for that locale is a cache hit (no redundant fetch) while every
+     * later switch *to* it still flows through `change()` normally.
+     */
+    markLoaded(locale: string): void;
     /**
      * React to a user-locale change. Fetches translations if we haven't
      * loaded this locale within the last 60s (or if forced).
@@ -511,6 +519,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);
@@ -431,6 +442,18 @@ var Translations = class {
       this.debug.log(`SSR environment detected - using '${strategy}' token strategy`);
     }
   }
+  /**
+   * Record that a locale's catalog is already present without fetching —
+   * e.g. after an SSR handoff seeds `sTranslations` + `currentlyLoadedLocale`.
+   * This primes the same `lastLoaded` cache `change()` consults, so the first
+   * settle for that locale is a cache hit (no redundant fetch) while every
+   * later switch *to* it still flows through `change()` normally.
+   */
+  markLoaded(locale) {
+    if (!locale) return;
+    this.locale = locale;
+    this.lastLoaded[locale] = (/* @__PURE__ */ new Date()).getTime() / 1e3;
+  }
   /**
    * React to a user-locale change. Fetches translations if we haven't
    * loaded this locale within the last 60s (or if forced).
@@ -480,20 +503,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__";
@@ -642,12 +668,14 @@ var LangsysAppClass = class {
       this.debug.log("Populated sTranslations with initial data for locale:", initialTranslationsLocale);
     }
     this.Translations.setup(this.config);
+    if (initialTranslations2 && initialTranslationsLocale) {
+      this.Translations.markLoaded(initialTranslationsLocale);
+    }
     this.config.sUserLocale.subscribe((locale) => {
       if (!validateResponse.status) return;
       this.getLocalesData(locale);
       this.debug.log("SUBSCRIBING TO USER LOCALE STORE");
-      const skipFetch = initialTranslationsLocale === locale && !!initialTranslations2;
-      this.translationsLoadingPromise = this.Translations.change(locale, false, skipFetch);
+      this.translationsLoadingPromise = this.Translations.change(locale, false);
     });
     return validateResponse;
   }
@@ -1048,10 +1076,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 };