@ayinza_dev/i18n-config 1.5.0 → 1.5.1

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { I18nConfig, I18nInitOptions, FormattersConfig, LocaleMapping, Pars
 export { I18nFormatters } from "./formatters.js";
 export { useFormatting, useI18n } from "./hooks.js";
 export { createI18nextParserConfig } from "./parser-config.js";
-export { createTranslationSnapshot, collectNewTranslationKeys, handleNewTranslationKeys, publishTranslationOverrides, } from "./parser-hooks.js";
+export { createTranslationSnapshot, collectNewTranslationKeys, handleNewTranslationKeys, publishTranslationOverrides, resolveSourcePushUrl, resolveOverridePushUrl, TRANSLATE_SEND_PATH, ADMIN_TRANSLATIONS_PATH, } from "./parser-hooks.js";
 export type { PublishTranslationOverridesOptions } from "./parser-hooks.js";
 export { useTranslation, Trans, Translation } from "react-i18next";
 export { type TFunction } from "i18next";

package/dist/index.js

@@ -2,6 +2,6 @@ export { initializeI18n, getI18nInstance, getFormatters, defaultConfig, createI1
 export { I18nFormatters } from "./formatters.js";
 export { useFormatting, useI18n } from "./hooks.js";
 export { createI18nextParserConfig } from "./parser-config.js";
-export { createTranslationSnapshot, collectNewTranslationKeys, handleNewTranslationKeys, publishTranslationOverrides, } from "./parser-hooks.js";
+export { createTranslationSnapshot, collectNewTranslationKeys, handleNewTranslationKeys, publishTranslationOverrides, resolveSourcePushUrl, resolveOverridePushUrl, TRANSLATE_SEND_PATH, ADMIN_TRANSLATIONS_PATH, } from "./parser-hooks.js";
 // Re-export commonly used utilities from react-i18next
 export { useTranslation, Trans, Translation } from "react-i18next";

package/dist/parser-hooks.d.ts

@@ -1,4 +1,27 @@
 import type { NewKeyPayload, ParserPushConfig, TranslationSnapshot } from "./types.js";
+/**
+ * Localization-service endpoint paths, appended to the API base URL
+ * (`VITE_LOCALIZATION_API_BASE_URL`, e.g. `https://…/api/v1`). Owning them here is
+ * the single source of truth so no consumer hardcodes (and mis-types) the paths —
+ * the override route in particular lives under `/l10n/admin/translations`, NOT the
+ * bare `/admin/translations`.
+ */
+export declare const TRANSLATE_SEND_PATH = "/l10n/translate/send";
+export declare const ADMIN_TRANSLATIONS_PATH = "/l10n/admin/translations";
+/**
+ * Build the source-key registration URL (POST) from an API base URL — the
+ * `pushUrl` for {@link handleNewTranslationKeys}.
+ *
+ * @example resolveSourcePushUrl("https://loc/api/v1") // ".../api/v1/l10n/translate/send"
+ */
+export declare const resolveSourcePushUrl: (apiBaseUrl: string) => string;
+/**
+ * Build the human-override collection URL from an API base URL — the `pushUrl`
+ * for {@link publishTranslationOverrides}, which appends `/{locale}` per request.
+ *
+ * @example resolveOverridePushUrl("https://loc/api/v1") // ".../api/v1/l10n/admin/translations"
+ */
+export declare const resolveOverridePushUrl: (apiBaseUrl: string) => string;
 export interface CreateTranslationSnapshotOptions {
     locale: string;
     namespaces: Record<string, Record<string, unknown>>;
@@ -36,7 +59,7 @@ export interface PublishTranslationOverridesOptions {
 }
 /**
  * Publish curated translation overrides for a locale to the localization
- * service's upsert endpoint (`PUT /admin/translations/{locale}`). Any Ayinza
+ * service's upsert endpoint (`PUT /l10n/admin/translations/{locale}`). Any Ayinza
  * product uses this to correct its own catalog (e.g. replacing garbled machine
  * translations); the service marks the rows human-authoritative so the MT
  * sweep never re-manufactures them.

package/dist/parser-hooks.js

@@ -1,3 +1,27 @@
+/**
+ * Localization-service endpoint paths, appended to the API base URL
+ * (`VITE_LOCALIZATION_API_BASE_URL`, e.g. `https://…/api/v1`). Owning them here is
+ * the single source of truth so no consumer hardcodes (and mis-types) the paths —
+ * the override route in particular lives under `/l10n/admin/translations`, NOT the
+ * bare `/admin/translations`.
+ */
+export const TRANSLATE_SEND_PATH = "/l10n/translate/send";
+export const ADMIN_TRANSLATIONS_PATH = "/l10n/admin/translations";
+const stripTrailingSlashes = (url) => url.replace(/\/+$/, "");
+/**
+ * Build the source-key registration URL (POST) from an API base URL — the
+ * `pushUrl` for {@link handleNewTranslationKeys}.
+ *
+ * @example resolveSourcePushUrl("https://loc/api/v1") // ".../api/v1/l10n/translate/send"
+ */
+export const resolveSourcePushUrl = (apiBaseUrl) => `${stripTrailingSlashes(apiBaseUrl)}${TRANSLATE_SEND_PATH}`;
+/**
+ * Build the human-override collection URL from an API base URL — the `pushUrl`
+ * for {@link publishTranslationOverrides}, which appends `/{locale}` per request.
+ *
+ * @example resolveOverridePushUrl("https://loc/api/v1") // ".../api/v1/l10n/admin/translations"
+ */
+export const resolveOverridePushUrl = (apiBaseUrl) => `${stripTrailingSlashes(apiBaseUrl)}${ADMIN_TRANSLATIONS_PATH}`;
 const formatValue = (value) => {
     if (value === undefined || value === null) {
         return "";
@@ -79,7 +103,7 @@ const headersToRecord = (headers) => {
 /**
  * Send a `{ data: { translations, category? } }` catalog payload to the
  * localization-service. Shared by the source-key push (POST /translate/send)
- * and the override publish (PUT /admin/translations/{locale}).
+ * and the override publish (PUT /l10n/admin/translations/{locale}).
  */
 const sendCatalogPayload = async (options) => {
     const { url, method, translations, pushConfig, requestInit } = options;
@@ -143,7 +167,7 @@ export const handleNewTranslationKeys = async (options) => {
 };
 /**
  * Publish curated translation overrides for a locale to the localization
- * service's upsert endpoint (`PUT /admin/translations/{locale}`). Any Ayinza
+ * service's upsert endpoint (`PUT /l10n/admin/translations/{locale}`). Any Ayinza
  * product uses this to correct its own catalog (e.g. replacing garbled machine
  * translations); the service marks the rows human-authoritative so the MT
  * sweep never re-manufactures them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ayinza_dev/i18n-config",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",