@_linked/translation 0.8.0 → 0.8.2

package/lib/esm/shapes/TranslationRevision.d.ts

@@ -11,7 +11,7 @@ import { TranslationKeyVersion } from './TranslationKeyVersion.js';
  * (`status`, `decidedAt`, `decidedBy`).
  */
 export declare class TranslationRevision extends Shape {
-    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
     /** IRI of the owning Application (same app-scoping law as Key/Unit). */
     get ofApplication(): string;
     /** The key, NOT the unit — revisions can exist before any unit does. */

package/lib/esm/shapes/TranslationUnit.d.ts

@@ -8,7 +8,7 @@ import { TranslationKeyVersion } from './TranslationKeyVersion.js';
  * provenance — that a bare literal cannot hold.
  */
 export declare class TranslationUnit extends Shape {
-    static targetClass: import("@_linked/core/utils/NodeReference").NodeReferenceValue;
+    static targetClass: import("@_linked/core/utils/NodeReference.js").NodeReferenceValue;
     /** IRI of the owning Application (explicitly app-scoped per Plan 014 AD-I). */
     get ofApplication(): string;
     get ofKey(): TranslationKey;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@_linked/translation",
   "description": "LINKED translation management — graph-native i18n keys + units, Tolgee-compatible client, CDN delivery.",
-  "version": "0.8.0",
-  "packageManager": "npm@12.1.0",
+  "version": "0.8.2",
+  "packageManager": "npm@12.2.0",
   "linkedPackage": true,
   "type": "module",
   "main": "lib/esm/index.js",
@@ -90,11 +90,11 @@
     }
   },
   "dependencies": {
-    "@_linked/core": "^2.22.8",
-    "@_linked/server-utils": "^1.9.0",
-    "@formatjs/icu-messageformat-parser": "3.5.20",
+    "@_linked/core": "^2.36.1",
+    "@_linked/server-utils": "^1.14.0",
+    "@formatjs/icu-messageformat-parser": "3.5.21",
     "fflate": "^0.8.2",
-    "intl-messageformat": "12.1.2"
+    "intl-messageformat": "12.1.3"
   },
   "peerDependencies": {
     "react": "*",
@@ -121,6 +121,6 @@
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "typescript": "5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^5.0.0"
   }
 }

package/src/authorization.ts

@@ -1,3 +1,5 @@
+import { sharedState } from '@_linked/core/utils/sharedState';
+
 export type TranslationAuthoringAction =
   | 'manage'
   | 'review'
@@ -16,7 +18,11 @@ export type TranslationAuthorizationResolver = (
   request: TranslationAuthorizationRequest,
 ) => Promise<boolean>;
 
-let resolver: TranslationAuthorizationResolver | undefined;
+// On globalThis so a second copy of this module sees the resolver the host configured on the
+// first; a copy that cannot see it would deny every author.
+const state = sharedState('@_linked/translation', 'authorization', () => ({
+  resolver: undefined as TranslationAuthorizationResolver | undefined,
+}));
 
 /**
  * Host hook: the host decides who may read and author an app's translations
@@ -29,7 +35,7 @@ let resolver: TranslationAuthorizationResolver | undefined;
 export function configureTranslationAuthorization(
   next?: TranslationAuthorizationResolver,
 ): void {
-  resolver = next;
+  state.resolver = next;
 }
 
 /**
@@ -39,6 +45,7 @@ export function configureTranslationAuthorization(
 export async function canAuthorTranslation(
   request: TranslationAuthorizationRequest,
 ): Promise<boolean> {
+  const resolver = state.resolver;
   if (!resolver) return false;
   try {
     return (await resolver(request)) === true;

package/src/exchange.ts

@@ -1,3 +1,4 @@
+import { sharedState } from '@_linked/core/utils/sharedState';
 import type { MessageFormat } from './core/messages.js';
 import { canonicalLanguageTag } from './key-version.js';
 import type { TranslationState } from './records.js';
@@ -131,7 +132,11 @@ const EXCHANGE_STATES = new Set<TranslationState>([
   'reviewed',
   'stale',
 ]);
-const adapters = new Map<TranslationFormat, TranslationFormatAdapter>();
+// On globalThis so an adapter the host registers on one copy of this module is found by
+// another copy.
+const { adapters } = sharedState('@_linked/translation', 'exchange', () => ({
+  adapters: new Map<TranslationFormat, TranslationFormatAdapter>(),
+}));
 
 function record(value: unknown, label: string): Record<string, unknown> {
   if (!value || typeof value !== 'object' || Array.isArray(value)) {
@@ -402,7 +407,11 @@ export function isConfirmedBuildDeclaration(
 export function registerTranslationFormatAdapter(
   adapter: TranslationFormatAdapter,
 ): void {
-  if (adapters.has(adapter.format)) {
+  const registered = adapters.get(adapter.format);
+  // The registry is process-wide, so the same adapter registered again (by a second copy of
+  // the host module that registers it) is not a conflict; a different adapter for the format is.
+  if (registered === adapter) return;
+  if (registered) {
     throw new Error(
       `Translation format adapter "${adapter.format}" is already registered.`,
     );

package/src/mt.ts

@@ -8,6 +8,7 @@
  * SDK imports — concrete providers live with the host application and are
  * registered at boot.
  */
+import { sharedState } from '@_linked/core/utils/sharedState';
 import {
   analyzeMessage,
   compareMessageArguments,
@@ -72,7 +73,11 @@ export interface TranslationMtProvider {
   translateBatch(request: MtBatchRequest): Promise<MtBatchResult[]>;
 }
 
-const providers = new Map<string, TranslationMtProvider>();
+// On globalThis so a provider the host registers on one copy of this module is found by
+// another copy.
+const { providers } = sharedState('@_linked/translation', 'mt', () => ({
+  providers: new Map<string, TranslationMtProvider>(),
+}));
 
 export function registerMtProvider(provider: TranslationMtProvider): void {
   providers.set(provider.key, provider);

package/src/react.tsx

@@ -1,3 +1,4 @@
+import { sharedState } from '@_linked/core/utils/sharedState';
 import {
   languageFallbacks,
   type TranslationLanguageDefinition,
@@ -100,7 +101,11 @@ interface TranslationContextValue {
   dir: 'ltr' | 'rtl';
 }
 
-const TranslationContext = createContext<TranslationContextValue | null>(null);
+// The context object is kept on globalThis: a context created per copy of this module would
+// leave a consumer in one copy blind to a provider from the other (it gets the null default).
+const { TranslationContext } = sharedState('@_linked/translation', 'react.contexts', () => ({
+  TranslationContext: createContext<TranslationContextValue | null>(null),
+}));
 
 export interface TranslationProviderProps {
   children: React.ReactNode;

package/src/shapes/TranslationProvider.ts

@@ -1602,21 +1602,21 @@ export class TranslationProvider extends ShapeProvider {
     }
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listKeys(data: { appId: string }) {
     const actor = this.requireActor();
     await this.requireAccess(actor, { appId: data?.appId }, 'read');
     return listTranslationKeys(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listEntries(data: { appId: string }): Promise<TranslationEntryRecord[]> {
     const actor = this.requireActor();
     await this.requireAccess(actor, { appId: data?.appId }, 'read');
     return listTranslationEntries(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listKeyVersions(data: {
     appId: string;
     key?: string;
@@ -1626,7 +1626,7 @@ export class TranslationProvider extends ShapeProvider {
     return listTranslationKeyVersions(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listMemoryMatches(data: {
     appId: string;
     key: string;
@@ -1637,7 +1637,7 @@ export class TranslationProvider extends ShapeProvider {
     return listTranslationMemoryMatches(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async proposeRevision(data: {
     appId: string;
     key: string;
@@ -1661,7 +1661,7 @@ export class TranslationProvider extends ShapeProvider {
     });
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listProposals(data: {
     appId: string;
     language?: string;
@@ -1682,7 +1682,7 @@ export class TranslationProvider extends ShapeProvider {
     return proposals.filter((_, index) => allowed[index]);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async decideProposal(data: {
     appId: string;
     revisionId: string;
@@ -1706,7 +1706,7 @@ export class TranslationProvider extends ShapeProvider {
     return decideTranslationProposal(data, actor);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listMemory(data: {
     appId: string;
   }): Promise<TranslationMemoryRecord[]> {
@@ -1715,7 +1715,7 @@ export class TranslationProvider extends ShapeProvider {
     return listTranslationMemory(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async pretranslateMemory(data: {
     appId: string;
     language: string;
@@ -1726,7 +1726,7 @@ export class TranslationProvider extends ShapeProvider {
     return pretranslateFromMemory(data, { author: actor });
   }
 
-  @callable('user')
+  @callable('signed-in')
   async applyMemoryMatch(data: {
     appId: string;
     key: string;
@@ -1738,7 +1738,7 @@ export class TranslationProvider extends ShapeProvider {
     return applyTranslationMemoryMatch(data, { author: actor });
   }
 
-  @callable('user')
+  @callable('signed-in')
   async listReleases(data: {
     appId: string;
   }): Promise<TranslationReleaseRecord[]> {
@@ -1747,7 +1747,7 @@ export class TranslationProvider extends ShapeProvider {
     return listTranslationReleases(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async createRelease(
     data: Omit<TranslationReleaseRecord, 'id' | 'createdAt'> & {
       createdAt?: string;
@@ -1758,7 +1758,7 @@ export class TranslationProvider extends ShapeProvider {
     return createTranslationRelease(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async advanceReleaseHotfix(data: {
     id: string;
     expectedSequence: number;
@@ -1772,14 +1772,14 @@ export class TranslationProvider extends ShapeProvider {
     return advanceTranslationReleaseHotfix({ ...data, appId });
   }
 
-  @callable('user')
+  @callable('signed-in')
   async upsertKey(data: TranslationKeyInput): Promise<{ id: string }> {
     const actor = this.requireActor();
     await this.requireAccess(actor, data, 'manage');
     return upsertTranslationKey(data, { createdBy: actor });
   }
 
-  @callable('user')
+  @callable('signed-in')
   async upsertUnit(data: TranslationUnitInput): Promise<{ id: string }> {
     const actor = this.requireActor();
     await this.requireAccess(actor, data, 'review');
@@ -1795,14 +1795,14 @@ export class TranslationProvider extends ShapeProvider {
    * anchors the IRIs. Uniqueness = (term, language) — upsert is
    * delete-then-create on that identity.
    */
-  @callable('user')
+  @callable('signed-in')
   async listGlossary(data: { appId: string }): Promise<GlossaryTermRecord[]> {
     const actor = this.requireActor();
     await this.requireAccess(actor, { appId: data?.appId }, 'read');
     return listGlossaryTerms(data);
   }
 
-  @callable('user')
+  @callable('signed-in')
   async upsertGlossaryTerm(data: {
     appId: string;
     term: string;
@@ -1845,7 +1845,7 @@ export class TranslationProvider extends ShapeProvider {
     return { id };
   }
 
-  @callable('user')
+  @callable('signed-in')
   async deleteGlossaryTerm(data: { appId: string; id: string }): Promise<{ deleted: boolean }> {
     const actor = this.requireActor();
     await this.requireAccess(actor, data, 'manage');
@@ -1860,7 +1860,7 @@ export class TranslationProvider extends ShapeProvider {
   }
 
   /** History for one (key, language) cell — newest first (Plan 017 AD-P). */
-  @callable('user')
+  @callable('signed-in')
   async listRevisions(data: {
     appId: string;
     key: string;