@palettelab/sdk 0.1.9 → 0.1.11

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-o-qmdCBl.mjs';
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition } from './plugin-o-qmdCBl.mjs';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-DZRaxKt3.mjs';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteLanguage, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition } from './plugin-DZRaxKt3.mjs';
 import { D as DataRoom, a as DataRoomFolder, b as DataRoomFile } from './data-room-Dtd9LLHf.mjs';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, 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';
 export { AgentResource, ResourcesByGroup } from './types/index.mjs';
 import { ReactElement } from 'react';
-export { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks } from './hooks/index.mjs';
+export { P as PlatformCtx, T as TranslateOptions, a as TranslationDictionary, b as TranslationPrimitive, c as TranslationResources, d as TranslationValues, U as UsePluginTranslationsOptions, n as normalizePaletteLanguage, t as translate, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from './index-BL37Z-Ns.mjs';
 export { PluginProvider } from './components/index.mjs';
 import 'react/jsx-runtime';
 
@@ -43,8 +43,10 @@ type SandboxBridge = {
     apiFetch: PlatformContext["apiFetch"];
     navigate: (path: string) => void;
     showToast: (message: string, type?: ToastType) => void;
+    getLanguage: () => PlatformContext["language"];
+    setLanguage: PlatformContext["setLanguage"];
 };
-declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast">): SandboxBridge;
+declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage">>): SandboxBridge;
 declare function isSandboxRuntime(): boolean;
 
 type InstallConfig = Record<string, unknown>;
@@ -63,7 +65,14 @@ interface DataRoomUploadOptions {
     folderId?: number | null;
     contentType?: string;
 }
+interface FindByNameOptions {
+    caseSensitive?: boolean;
+}
+interface EnsureFolderOptions extends FindByNameOptions {
+    parentFolderId?: number | null;
+}
 declare class DataRoomClient {
+    private matchesName;
     list(): Promise<DataRoom[]>;
     create(input: {
         name: string;
@@ -71,6 +80,21 @@ declare class DataRoomClient {
     }): Promise<DataRoom>;
     get(roomId: number): Promise<DataRoomContents>;
     folder(roomId: number, folderId: number): Promise<DataRoomContents>;
+    findRoomByName(name: string, options?: FindByNameOptions): Promise<DataRoom | null>;
+    requireRoomByName(name: string, options?: FindByNameOptions): Promise<DataRoom>;
+    ensureRoom(name: string, description?: string | null): Promise<DataRoom>;
+    createFolder(roomId: number, input: {
+        name: string;
+        parentFolderId?: number | null;
+    }): Promise<DataRoomFolder>;
+    findFolderByName(roomId: number, name: string, options?: EnsureFolderOptions): Promise<DataRoomFolder | null>;
+    ensureFolder(roomId: number, name: string, options?: EnsureFolderOptions): Promise<DataRoomFolder>;
+    resolveFolderPath(roomId: number, path: string | string[], options?: FindByNameOptions & {
+        create?: boolean;
+    }): Promise<DataRoomFolder | null>;
+    findFileByName(roomId: number, name: string, options?: FindByNameOptions & {
+        folderId?: number | null;
+    }): Promise<DataRoomFile | null>;
     requestUpload(roomId: number, file: File, options?: DataRoomUploadOptions): Promise<{
         upload_url: string;
         blob_path: string;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-o-qmdCBl.js';
-export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PluginAgentDefinition, e as PluginComponentProps, f as PluginManifest, g as PluginToolDefinition } from './plugin-o-qmdCBl.js';
+import { P as PlatformContext, O as OrgSummary, U as User } from './plugin-DZRaxKt3.js';
+export { A as Agent, a as AgentConfig, b as AppCategory, c as AuthContextValue, d as PaletteLanguage, e as PluginAgentDefinition, f as PluginComponentProps, g as PluginManifest, h as PluginToolDefinition } from './plugin-DZRaxKt3.js';
 import { D as DataRoom, a as DataRoomFolder, b as DataRoomFile } from './data-room-Dtd9LLHf.js';
 export { C as ChatAttachment, c as ChatMessage, d as ChatThread, 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';
 export { AgentResource, ResourcesByGroup } from './types/index.js';
 import { ReactElement } from 'react';
-export { PlatformCtx, usePlatform, usePluginChat, usePluginDataRooms, usePluginTasks } from './hooks/index.js';
+export { P as PlatformCtx, T as TranslateOptions, a as TranslationDictionary, b as TranslationPrimitive, c as TranslationResources, d as TranslationValues, U as UsePluginTranslationsOptions, n as normalizePaletteLanguage, t as translate, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from './index-DEvPH60n.js';
 export { PluginProvider } from './components/index.js';
 import 'react/jsx-runtime';
 
@@ -43,8 +43,10 @@ type SandboxBridge = {
     apiFetch: PlatformContext["apiFetch"];
     navigate: (path: string) => void;
     showToast: (message: string, type?: ToastType) => void;
+    getLanguage: () => PlatformContext["language"];
+    setLanguage: PlatformContext["setLanguage"];
 };
-declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast">): SandboxBridge;
+declare function createSandboxBridge(platform: Pick<PlatformContext, "apiFetch" | "navigate" | "showToast"> & Partial<Pick<PlatformContext, "language" | "setLanguage">>): SandboxBridge;
 declare function isSandboxRuntime(): boolean;
 
 type InstallConfig = Record<string, unknown>;
@@ -63,7 +65,14 @@ interface DataRoomUploadOptions {
     folderId?: number | null;
     contentType?: string;
 }
+interface FindByNameOptions {
+    caseSensitive?: boolean;
+}
+interface EnsureFolderOptions extends FindByNameOptions {
+    parentFolderId?: number | null;
+}
 declare class DataRoomClient {
+    private matchesName;
     list(): Promise<DataRoom[]>;
     create(input: {
         name: string;
@@ -71,6 +80,21 @@ declare class DataRoomClient {
     }): Promise<DataRoom>;
     get(roomId: number): Promise<DataRoomContents>;
     folder(roomId: number, folderId: number): Promise<DataRoomContents>;
+    findRoomByName(name: string, options?: FindByNameOptions): Promise<DataRoom | null>;
+    requireRoomByName(name: string, options?: FindByNameOptions): Promise<DataRoom>;
+    ensureRoom(name: string, description?: string | null): Promise<DataRoom>;
+    createFolder(roomId: number, input: {
+        name: string;
+        parentFolderId?: number | null;
+    }): Promise<DataRoomFolder>;
+    findFolderByName(roomId: number, name: string, options?: EnsureFolderOptions): Promise<DataRoomFolder | null>;
+    ensureFolder(roomId: number, name: string, options?: EnsureFolderOptions): Promise<DataRoomFolder>;
+    resolveFolderPath(roomId: number, path: string | string[], options?: FindByNameOptions & {
+        create?: boolean;
+    }): Promise<DataRoomFolder | null>;
+    findFileByName(roomId: number, name: string, options?: FindByNameOptions & {
+        folderId?: number | null;
+    }): Promise<DataRoomFile | null>;
     requestUpload(roomId: number, file: File, options?: DataRoomUploadOptions): Promise<{
         upload_url: string;
         blob_path: string;

package/dist/index.js

@@ -41,13 +41,16 @@ __export(src_exports, {
   hasPermission: () => hasPermission,
   isPaletteApiError: () => isPaletteApiError,
   isSandboxRuntime: () => isSandboxRuntime,
+  normalizePaletteLanguage: () => normalizePaletteLanguage,
   setBaseUrl: () => setBaseUrl,
+  translate: () => translate,
   updateInstallConfig: () => updateInstallConfig,
   uploadToSignedUrl: () => uploadToSignedUrl,
   usePlatform: () => usePlatform,
   usePluginChat: () => usePluginChat,
   usePluginDataRooms: () => usePluginDataRooms,
   usePluginTasks: () => usePluginTasks,
+  usePluginTranslations: () => usePluginTranslations,
   withPluginProvider: () => withPluginProvider
 });
 module.exports = __toCommonJS(src_exports);
@@ -140,7 +143,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() {
@@ -214,6 +220,11 @@ function createMockPlatformContext(overrides = {}) {
     orgs: [],
     agents: [],
     permissions: [],
+    language: "en",
+    fallbackLanguage: "en",
+    supportedLanguages: ["en", "ko"],
+    setLanguage: () => {
+    },
     apiFetch: async () => new Response(JSON.stringify({}), { status: 200 }),
     navigate: () => {
     },
@@ -231,6 +242,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();
@@ -250,6 +265,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",
@@ -387,14 +446,77 @@ function createPaletteClient(ctx) {
   };
 }
 
-// src/hooks/use-plugin-tasks.ts
+// src/i18n.ts
 var import_react3 = require("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 = (0, import_react3.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
+var import_react4 = require("react");
 function usePluginTasks(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [tasks, setTasks] = (0, import_react3.useState)([]);
-  const [stats, setStats] = (0, import_react3.useState)(null);
-  const [loading, setLoading] = (0, import_react3.useState)(true);
-  const fetchTasks = (0, import_react3.useCallback)(async () => {
+  const [tasks, setTasks] = (0, import_react4.useState)([]);
+  const [stats, setStats] = (0, import_react4.useState)(null);
+  const [loading, setLoading] = (0, import_react4.useState)(true);
+  const fetchTasks = (0, import_react4.useCallback)(async () => {
     try {
       const params = new URLSearchParams();
       if (agentId) params.set("agent_id", String(agentId));
@@ -403,18 +525,18 @@ function usePluginTasks(agentId) {
     } catch {
     }
   }, [apiFetch2, agentId]);
-  const fetchStats = (0, import_react3.useCallback)(async () => {
+  const fetchStats = (0, import_react4.useCallback)(async () => {
     try {
       const res = await apiFetch2("/api/v1/tasks/stats");
       setStats(await res.json());
     } catch {
     }
   }, [apiFetch2]);
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     setLoading(true);
     Promise.all([fetchTasks(), fetchStats()]).finally(() => setLoading(false));
   }, [fetchTasks, fetchStats]);
-  const createTask = (0, import_react3.useCallback)(async (payload) => {
+  const createTask = (0, import_react4.useCallback)(async (payload) => {
     const res = await apiFetch2("/api/v1/tasks", {
       method: "POST",
       body: JSON.stringify(payload)
@@ -423,7 +545,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const updateTask = (0, import_react3.useCallback)(async (taskId, payload) => {
+  const updateTask = (0, import_react4.useCallback)(async (taskId, payload) => {
     const res = await apiFetch2(`/api/v1/tasks/${taskId}`, {
       method: "PATCH",
       body: JSON.stringify(payload)
@@ -432,7 +554,7 @@ function usePluginTasks(agentId) {
     await Promise.all([fetchTasks(), fetchStats()]);
     return task;
   }, [apiFetch2, fetchTasks, fetchStats]);
-  const deleteTask = (0, import_react3.useCallback)(async (taskId) => {
+  const deleteTask = (0, import_react4.useCallback)(async (taskId) => {
     await apiFetch2(`/api/v1/tasks/${taskId}`, { method: "DELETE" });
     await Promise.all([fetchTasks(), fetchStats()]);
   }, [apiFetch2, fetchTasks, fetchStats]);
@@ -440,23 +562,23 @@ function usePluginTasks(agentId) {
 }
 
 // src/hooks/use-plugin-data-rooms.ts
-var import_react4 = require("react");
+var import_react5 = require("react");
 function usePluginDataRooms() {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [rooms, setRooms] = (0, import_react4.useState)([]);
-  const [loading, setLoading] = (0, import_react4.useState)(true);
-  const fetchRooms = (0, import_react4.useCallback)(async () => {
+  const [rooms, setRooms] = (0, import_react5.useState)([]);
+  const [loading, setLoading] = (0, import_react5.useState)(true);
+  const fetchRooms = (0, import_react5.useCallback)(async () => {
     try {
       const res = await apiFetch2("/api/v1/data-rooms");
       setRooms(await res.json());
     } catch {
     }
   }, [apiFetch2]);
-  (0, import_react4.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     setLoading(true);
     fetchRooms().finally(() => setLoading(false));
   }, [fetchRooms]);
-  const fetchFolder = (0, import_react4.useCallback)(async (roomId, folderId) => {
+  const fetchFolder = (0, import_react5.useCallback)(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();
@@ -465,19 +587,19 @@ function usePluginDataRooms() {
 }
 
 // src/hooks/use-plugin-chat.ts
-var import_react5 = require("react");
+var import_react6 = require("react");
 function usePluginChat(agentId) {
   const { apiFetch: apiFetch2 } = usePlatform();
-  const [threads, setThreads] = (0, import_react5.useState)([]);
-  const [messages, setMessages] = (0, import_react5.useState)([]);
-  const [streaming, setStreaming] = (0, import_react5.useState)(false);
-  const [activeThreadId, setActiveThreadId] = (0, import_react5.useState)(null);
-  const abortRef = (0, import_react5.useRef)(null);
-  const fetchThreads = (0, import_react5.useCallback)(async () => {
+  const [threads, setThreads] = (0, import_react6.useState)([]);
+  const [messages, setMessages] = (0, import_react6.useState)([]);
+  const [streaming, setStreaming] = (0, import_react6.useState)(false);
+  const [activeThreadId, setActiveThreadId] = (0, import_react6.useState)(null);
+  const abortRef = (0, import_react6.useRef)(null);
+  const fetchThreads = (0, import_react6.useCallback)(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`);
     setThreads(await res.json());
   }, [apiFetch2, agentId]);
-  const createThread = (0, import_react5.useCallback)(async () => {
+  const createThread = (0, import_react6.useCallback)(async () => {
     const res = await apiFetch2(`/api/v1/chat/${agentId}/threads`, { method: "POST" });
     const thread = await res.json();
     setActiveThreadId(thread.id);
@@ -485,13 +607,13 @@ function usePluginChat(agentId) {
     await fetchThreads();
     return thread;
   }, [apiFetch2, agentId, fetchThreads]);
-  const fetchMessages = (0, import_react5.useCallback)(async (threadId) => {
+  const fetchMessages = (0, import_react6.useCallback)(async (threadId) => {
     const res = await apiFetch2(`/api/v1/chat/threads/${threadId}/messages`);
     const msgs = await res.json();
     setMessages(msgs);
     setActiveThreadId(threadId);
   }, [apiFetch2]);
-  const sendMessage = (0, import_react5.useCallback)(async (threadId, content) => {
+  const sendMessage = (0, import_react6.useCallback)(async (threadId, content) => {
     setStreaming(true);
     abortRef.current = new AbortController();
     const userMsg = {
@@ -559,7 +681,7 @@ function usePluginChat(agentId) {
       abortRef.current = null;
     }
   }, []);
-  const stopStreaming = (0, import_react5.useCallback)(() => {
+  const stopStreaming = (0, import_react6.useCallback)(() => {
     abortRef.current?.abort();
   }, []);
   return {
@@ -597,12 +719,15 @@ function usePluginChat(agentId) {
   hasPermission,
   isPaletteApiError,
   isSandboxRuntime,
+  normalizePaletteLanguage,
   setBaseUrl,
+  translate,
   updateInstallConfig,
   uploadToSignedUrl,
   usePlatform,
   usePluginChat,
   usePluginDataRooms,
   usePluginTasks,
+  usePluginTranslations,
   withPluginProvider
 });