@palettelab/sdk 0.1.9 → 0.1.11

package/dist/index.mjs

@@ -86,7 +86,10 @@ function createSandboxBridge(platform) {
   return {
     apiFetch: platform.apiFetch,
     navigate: platform.navigate,
-    showToast: platform.showToast
+    showToast: platform.showToast,
+    getLanguage: () => platform.language ?? "en",
+    setLanguage: platform.setLanguage ?? (() => {
+    })
   };
 }
 function isSandboxRuntime() {
@@ -160,6 +163,11 @@ function createMockPlatformContext(overrides = {}) {
     orgs: [],
     agents: [],
     permissions: [],
+    language: "en",
+    fallbackLanguage: "en",
+    supportedLanguages: ["en", "ko"],
+    setLanguage: () => {
+    },
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
@@ -177,6 +185,10 @@ function withPluginProvider(element, platform = {}) {
 
 // src/data-rooms.ts
 var DataRoomClient = class {
+  matchesName(actual, expected, options = {}) {
+    if (options.caseSensitive) return actual === expected;
+    return actual.localeCompare(expected, void 0, { sensitivity: "accent" }) === 0;
+  }
   async list() {
     const res = await apiFetch("/api/v1/data-rooms");
     return res.json();
@@ -196,6 +208,50 @@ var DataRoomClient = class {
     const res = await apiFetch(`/api/v1/data-rooms/${roomId}/folders/${folderId}`);
     return res.json();
   }
+  async findRoomByName(name, options = {}) {
+    const rooms = await this.list();
+    return rooms.find((room) => this.matchesName(room.name, name, options)) ?? null;
+  }
+  async requireRoomByName(name, options = {}) {
+    const room = await this.findRoomByName(name, options);
+    if (!room) throw new Error(`Data Room not found: ${name}`);
+    return room;
+  }
+  async ensureRoom(name, description) {
+    return await this.findRoomByName(name) ?? this.create({ name, description });
+  }
+  async createFolder(roomId, input) {
+    const res = await apiFetch(`/api/v1/data-rooms/${roomId}/folders`, {
+      method: "POST",
+      body: JSON.stringify({
+        name: input.name,
+        parent_folder_id: input.parentFolderId ?? null
+      })
+    });
+    return res.json();
+  }
+  async findFolderByName(roomId, name, options = {}) {
+    const contents = options.parentFolderId ? await this.folder(roomId, options.parentFolderId) : await this.get(roomId);
+    return contents.folders.find((folder) => this.matchesName(folder.name, name, options)) ?? null;
+  }
+  async ensureFolder(roomId, name, options = {}) {
+    return await this.findFolderByName(roomId, name, options) ?? this.createFolder(roomId, { name, parentFolderId: options.parentFolderId ?? null });
+  }
+  async resolveFolderPath(roomId, path, options = {}) {
+    const parts = Array.isArray(path) ? path : path.split("/").map((part) => part.trim()).filter(Boolean);
+    let parentFolderId = null;
+    let current = null;
+    for (const part of parts) {
+      current = options.create ? await this.ensureFolder(roomId, part, { ...options, parentFolderId }) : await this.findFolderByName(roomId, part, { ...options, parentFolderId });
+      if (!current) return null;
+      parentFolderId = current.id;
+    }
+    return current;
+  }
+  async findFileByName(roomId, name, options = {}) {
+    const contents = options.folderId ? await this.folder(roomId, options.folderId) : await this.get(roomId);
+    return contents.files.find((file) => this.matchesName(file.original_filename, name, options)) ?? null;
+  }
   async requestUpload(roomId, file, options = {}) {
     const res = await apiFetch(`/api/v1/data-rooms/${roomId}/files/request-upload`, {
       method: "POST",
@@ -333,14 +389,77 @@ function createPaletteClient(ctx) {
   };
 }
 
+// src/i18n.ts
+import { useCallback } from "react";
+function normalizePaletteLanguage(language, fallback = "en") {
+  const trimmed = language?.trim().toLowerCase();
+  if (!trimmed) return fallback;
+  return trimmed.split("-")[0] || fallback;
+}
+function languageCandidates(language, fallbackLanguage = "en") {
+  const candidates = [
+    language,
+    normalizePaletteLanguage(language, fallbackLanguage),
+    fallbackLanguage,
+    normalizePaletteLanguage(fallbackLanguage, "en"),
+    "en"
+  ].filter(Boolean);
+  return Array.from(new Set(candidates));
+}
+function getValue(dictionary, key) {
+  if (!dictionary) return void 0;
+  let current = dictionary;
+  for (const part of key.split(".")) {
+    if (current === null || typeof current !== "object" || Array.isArray(current)) return void 0;
+    current = current[part];
+  }
+  if (typeof current === "string" || typeof current === "number" || typeof current === "boolean" || current === null) {
+    return current;
+  }
+  return void 0;
+}
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(/\{\{?\s*([a-zA-Z0-9_.-]+)\s*\}?\}/g, (match, key) => {
+    const value = values[key];
+    return value === void 0 || value === null ? match : String(value);
+  });
+}
+function translate(resources, key, options = {}) {
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage, "en");
+  for (const language of languageCandidates(options.language, fallbackLanguage)) {
+    const value = getValue(resources[language], key);
+    if (value !== void 0) {
+      return interpolate(String(value ?? ""), options.values);
+    }
+  }
+  return interpolate(options.defaultValue ?? key, options.values);
+}
+function usePluginTranslations(resources, options = {}) {
+  const platform = usePlatform();
+  const language = normalizePaletteLanguage(platform.language, options.fallbackLanguage ?? platform.fallbackLanguage);
+  const fallbackLanguage = normalizePaletteLanguage(options.fallbackLanguage ?? platform.fallbackLanguage, "en");
+  const t = useCallback(
+    (key, values, defaultValue) => translate(resources, key, { language, fallbackLanguage, values, defaultValue }),
+    [fallbackLanguage, language, resources]
+  );
+  return {
+    language,
+    fallbackLanguage,
+    supportedLanguages: platform.supportedLanguages,
+    setLanguage: platform.setLanguage,
+    t
+  };
+}
+
 // src/hooks/use-plugin-tasks.ts
-import { useCallback, useEffect, useState } from "react";
+import { useCallback as useCallback2, useEffect, useState } from "react";
 function usePluginTasks(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
   const [tasks, setTasks] = useState([]);
   const [stats, setStats] = useState(null);
   const [loading, setLoading] = useState(true);
-  const fetchTasks = useCallback(async () => {
+  const fetchTasks = useCallback2(async () => {
     try {
       const params = new URLSearchParams();
       if (agentId) params.set("agent_id", String(agentId));
@@ -349,7 +468,7 @@ function usePluginTasks(agentId) {
     } catch {
     }
   }, [apiFetch2, agentId]);
-  const fetchStats = useCallback(async () => {
+  const fetchStats = useCallback2(async () => {
     try {
       const res = await apiFetch2("/api/v1/tasks/stats");
       setStats(await res.json());
@@ -360,7 +479,7 @@ function usePluginTasks(agentId) {
     setLoading(true);
     Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
   }, [fetchTasks, fetchStats]);
-  const createTask = useCallback(async (payload) => {
+  const createTask = useCallback2(async (payload) => {
     const res = await apiFetch2("/api/v1/tasks", {
       method: "POST",
       body: JSON.stringify(payload)
@@ -369,7 +488,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const updateTask = useCallback(async (taskId, payload) => {
+  const updateTask = useCallback2(async (taskId, payload) => {
     const res = await apiFetch2(`/api/v1/tasks/${taskId}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
@@ -378,7 +497,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const deleteTask = useCallback(async (taskId) => {
+  const deleteTask = useCallback2(async (taskId) => {
     await apiFetch2(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
     await Promise.all([fetchTasks(), fetchStats()]);
   }, [apiFetch2, fetchTasks, fetchStats]);
@@ -386,12 +505,12 @@ function usePluginTasks(agentId) {
 }
 
 // src/hooks/use-plugin-data-rooms.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect2, useState as useState2 } from "react";
 function usePluginDataRooms() {
   const { apiFetch: apiFetch2 } = usePlatform();
   const [rooms, setRooms] = useState2([]);
   const [loading, setLoading] = useState2(true);
-  const fetchRooms = useCallback2(async () => {
+  const fetchRooms = useCallback3(async () => {
     try {
       const res = await apiFetch2("/api/v1/data-rooms");
       setRooms(await res.json());
@@ -402,7 +521,7 @@ function usePluginDataRooms() {
     setLoading(true);
     fetchRooms().finally(() => setLoading(false));
   }, [fetchRooms]);
-  const fetchFolder = useCallback2(async (roomId, folderId) => {
+  const fetchFolder = useCallback3(async (roomId, folderId) => {
     const path = folderId ? `/api/v1/data-rooms/${roomId}/folders/${folderId}` : `/api/v1/data-rooms/${roomId}`;
     const res = await apiFetch2(path);
     return res.json();
@@ -411,7 +530,7 @@ function usePluginDataRooms() {
 }
 
 // src/hooks/use-plugin-chat.ts
-import { useCallback as useCallback3, useRef, useState as useState3 } from "react";
+import { useCallback as useCallback4, useRef, useState as useState3 } from "react";
 function usePluginChat(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
   const [threads, setThreads] = useState3([]);
@@ -419,11 +538,11 @@ function usePluginChat(agentId) {
   const [streaming, setStreaming] = useState3(false);
   const [activeThreadId, setActiveThreadId] = useState3(null);
   const abortRef = useRef(null);
-  const fetchThreads = useCallback3(async () => {
+  const fetchThreads = useCallback4(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`);
     setThreads(await res.json());
   }, [apiFetch2, agentId]);
-  const createThread = useCallback3(async () => {
+  const createThread = useCallback4(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
     const thread = await res.json();
     setActiveThreadId(thread.id);
@@ -431,13 +550,13 @@ function usePluginChat(agentId) {
     await fetchThreads();
     return thread;
   }, [apiFetch2, agentId, fetchThreads]);
-  const fetchMessages = useCallback3(async (threadId) => {
+  const fetchMessages = useCallback4(async (threadId) => {
     const res = await apiFetch2(`/api/v1/chat/threads/${threadId}/messages`);
     const msgs = await res.json();
     setMessages(msgs);
     setActiveThreadId(threadId);
   }, [apiFetch2]);
-  const sendMessage = useCallback3(async (threadId, content) => {
+  const sendMessage = useCallback4(async (threadId, content) => {
     setStreaming(true);
     abortRef.current = new AbortController();
     const userMsg = {
@@ -505,7 +624,7 @@ function usePluginChat(agentId) {
       abortRef.current = null;
     }
   }, []);
-  const stopStreaming = useCallback3(() => {
+  const stopStreaming = useCallback4(() => {
     abortRef.current?.abort();
   }, []);
   return {
@@ -542,12 +661,15 @@ export {
   hasPermission,
   isPaletteApiError,
   isSandboxRuntime,
+  normalizePaletteLanguage,
   setBaseUrl,
+  translate,
   updateInstallConfig,
   uploadToSignedUrl,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
   usePluginTasks,
+  usePluginTranslations,
   withPluginProvider
 };

package/dist/{plugin-o-qmdCBl.d.mts → plugin-DZRaxKt3.d.mts}

@@ -67,6 +67,8 @@ interface AgentConfig {
     notes: string | null;
 }
 
+/** BCP-47 language tag used by Palette OS and plugin translation helpers */
+type PaletteLanguage = string;
 /** App store category */
 type AppCategory = "All" | "Productivity" | "Design" | "Marketing" | "Analytics";
 /** Plugin manifest — corresponds to palette-plugin.json */
@@ -149,6 +151,14 @@ interface PlatformContext {
     orgs: OrgSummary[];
     /** Available agents */
     agents: Agent[];
+    /** Current Palette OS language, normalized for plugin translation lookup */
+    language: PaletteLanguage;
+    /** Fallback language used when a plugin does not provide a key for language */
+    fallbackLanguage: PaletteLanguage;
+    /** Languages available in the current Palette OS environment */
+    supportedLanguages: PaletteLanguage[];
+    /** Update the Palette OS language preference */
+    setLanguage: (language: PaletteLanguage) => void;
     /** API fetch helper with auth handling */
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
@@ -163,4 +173,4 @@ interface PluginComponentProps {
     platform: PlatformContext;
 }
 
-export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PluginAgentDefinition as d, PluginComponentProps as e, PluginManifest as f, PluginToolDefinition as g };
+export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteLanguage as d, PluginAgentDefinition as e, PluginComponentProps as f, PluginManifest as g, PluginToolDefinition as h };

package/dist/{plugin-o-qmdCBl.d.ts → plugin-DZRaxKt3.d.ts}

@@ -67,6 +67,8 @@ interface AgentConfig {
     notes: string | null;
 }
 
+/** BCP-47 language tag used by Palette OS and plugin translation helpers */
+type PaletteLanguage = string;
 /** App store category */
 type AppCategory = "All" | "Productivity" | "Design" | "Marketing" | "Analytics";
 /** Plugin manifest — corresponds to palette-plugin.json */
@@ -149,6 +151,14 @@ interface PlatformContext {
     orgs: OrgSummary[];
     /** Available agents */
     agents: Agent[];
+    /** Current Palette OS language, normalized for plugin translation lookup */
+    language: PaletteLanguage;
+    /** Fallback language used when a plugin does not provide a key for language */
+    fallbackLanguage: PaletteLanguage;
+    /** Languages available in the current Palette OS environment */
+    supportedLanguages: PaletteLanguage[];
+    /** Update the Palette OS language preference */
+    setLanguage: (language: PaletteLanguage) => void;
     /** API fetch helper with auth handling */
     apiFetch: (path: string, init?: RequestInit) => Promise<Response>;
     /** Navigate to a platform route */
@@ -163,4 +173,4 @@ interface PluginComponentProps {
     platform: PlatformContext;
 }
 
-export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PluginAgentDefinition as d, PluginComponentProps as e, PluginManifest as f, PluginToolDefinition as g };
+export type { Agent as A, OrgSummary as O, PlatformContext as P, User as U, AgentConfig as a, AppCategory as b, AuthContextValue as c, PaletteLanguage as d, PluginAgentDefinition as e, PluginComponentProps as f, PluginManifest as g, PluginToolDefinition as h };

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, P as PlatformContext, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition, U as User } from '../plugin-o-qmdCBl.mjs';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteLanguage, P as PlatformContext, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition, U as User } from '../plugin-DZRaxKt3.mjs';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, D as DataRoom, b as DataRoomFile, a as DataRoomFolder, e as DataRoomPermission, T as Task, f as TaskAgentSnippet, g as TaskCreatePayload, h as TaskPriority, i as TaskStats, j as TaskStatus, k as TaskType, l as TaskUpdatePayload } from '../data-room-Dtd9LLHf.mjs';
 
 interface AgentResource {

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, P as PlatformContext, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition, U as User } from '../plugin-o-qmdCBl.js';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, O as OrgSummary, d as PaletteLanguage, P as PlatformContext, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition, U as User } from '../plugin-DZRaxKt3.js';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, D as DataRoom, b as DataRoomFile, a as DataRoomFolder, e as DataRoomPermission, T as Task, f as TaskAgentSnippet, g as TaskCreatePayload, h as TaskPriority, i as TaskStats, j as TaskStatus, k as TaskType, l as TaskUpdatePayload } from '../data-room-Dtd9LLHf.js';
 
 interface AgentResource {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palettelab/sdk",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Palette Platform SDK for building plugins and apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",