@palettelab/sdk 0.1.11 → 0.1.13

package/README.md

@@ -201,6 +201,28 @@ function App() {
 The same context is available in `pltt dev`, so local development and OS runtime
 use the same translation path.
 
+## Next-Compatible Apps
+
+The Palette appstore runtime loads plugin frontends as native React modules. If
+an app wants a Next-style config file, set `frontend.framework` in
+`palette-plugin.json` and place the config at `frontend/next.config.ts`.
+
+```json
+{
+  "frontend": {
+    "entry": "./frontend/src/index.tsx",
+    "sandbox": true,
+    "framework": "next",
+    "config": "./frontend/next.config.ts"
+  }
+}
+```
+
+The CLI reads that config in `pltt dev`, `pltt test`, `pltt package`, and
+`pltt publish`. In native mode it supports `env` values from Next config,
+`NEXT_PUBLIC_*` environment variables, and path aliases from
+`frontend/tsconfig.json`.
+
 ## Palette Client
 
 Use `createPaletteClient()` when an app needs common Palette OS services without
@@ -226,7 +248,7 @@ function App() {
 Included clients:
 
 - `palette.user.current()` and `palette.user.updateProfile()`
-- `palette.organization.currentId()`, `currentRole()`, and `listMine()`
+- `palette.organization.currentId()`, `currentRole()`, `listMine()`, `listMembers()`, `getMember()`, `getMemberByEmail()`, `inviteMember()`, and `updateMemberRole()`
 - `palette.dataRooms.list()`, `create()`, `get()`, `folder()`, `createFolder()`, `ensureFolder()`, `findRoomByName()`, `findFolderByName()`, `resolveFolderPath()`, `findFileByName()`, and `uploadFile()`
 - `palette.config.get()` and `palette.config.update(values)`, with optional plugin ID override
 - `palette.permissions.has()`, `hasAny()`, and `hasAll()`
@@ -236,6 +258,12 @@ Included clients:
 These helpers are intentionally thin wrappers over platform APIs. Apps can still
 use `apiFetch()` directly for custom backend routes.
 
+Member helpers operate on the active organisation. Use `members:read` for
+listing or looking up members, and `members:write` for invitations or role
+updates. When the runtime provides declared app permissions, these helpers check
+those permissions before calling the platform API. Member deletion/removal is
+intentionally not exposed through the app SDK.
+
 ### Data Room Folders By Name
 
 Apps can create or reuse custom Data Room folders by name:

package/dist/components/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { P as PlatformContext } from '../plugin-DZRaxKt3.mjs';
+import { P as PlatformContext } from '../plugin-UV46q1mU.mjs';
 
 /**
  * Provider that wraps plugin components with the platform context.

package/dist/components/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { P as PlatformContext } from '../plugin-DZRaxKt3.js';
+import { P as PlatformContext } from '../plugin-UV46q1mU.js';
 
 /**
  * Provider that wraps plugin components with the platform context.

package/dist/hooks/index.d.mts

@@ -1,4 +1,4 @@
-export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-BL37Z-Ns.mjs';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-Bu5EQGYo.mjs';
 import 'react';
-import '../plugin-DZRaxKt3.mjs';
+import '../plugin-UV46q1mU.mjs';
 import '../data-room-Dtd9LLHf.mjs';

package/dist/hooks/index.d.ts

@@ -1,4 +1,4 @@
-export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-DEvPH60n.js';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-BDVWt7DE.js';
 import 'react';
-import '../plugin-DZRaxKt3.js';
+import '../plugin-UV46q1mU.js';
 import '../data-room-Dtd9LLHf.js';

package/dist/{index-DEvPH60n.d.ts → index-BDVWt7DE.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-DZRaxKt3.js';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-UV46q1mU.js';
 import { T as Task, i as TaskStats, g as TaskCreatePayload, l as TaskUpdatePayload, D as DataRoom, a as DataRoomFolder, b as DataRoomFile, d as ChatThread, c as ChatMessage } from './data-room-Dtd9LLHf.js';
 
 type TranslationPrimitive = string | number | boolean | null;

package/dist/{index-BL37Z-Ns.d.mts → index-Bu5EQGYo.d.mts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-DZRaxKt3.mjs';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-UV46q1mU.mjs';
 import { T as Task, i as TaskStats, g as TaskCreatePayload, l as TaskUpdatePayload, D as DataRoom, a as DataRoomFolder, b as DataRoomFile, d as ChatThread, c as ChatMessage } from './data-room-Dtd9LLHf.mjs';
 
 type TranslationPrimitive = string | number | boolean | null;

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-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 { P as PlatformContext, O as OrgSummary, U as User } from './plugin-UV46q1mU.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-UV46q1mU.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 { 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 { 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-Bu5EQGYo.mjs';
 export { PluginProvider } from './components/index.mjs';
 import 'react/jsx-runtime';
 
@@ -112,6 +112,24 @@ declare class StorageClient {
     uploadToSignedUrl: typeof uploadToSignedUrl;
 }
 
+type OrgMemberRole = "owner" | "admin" | "member" | "viewer";
+interface OrgMember {
+    id: string;
+    name: string;
+    email: string;
+    role: OrgMemberRole;
+    is_active: boolean;
+    joined_at: string;
+}
+interface OrgInviteMemberInput {
+    email: string;
+    role?: OrgMemberRole;
+}
+interface OrgInviteMemberResponse {
+    message: string;
+    email: string;
+    role: OrgMemberRole;
+}
 declare class UserClient {
     private readonly ctx?;
     constructor(ctx?: PlatformContext | undefined);
@@ -124,9 +142,15 @@ declare class UserClient {
 declare class OrganizationClient {
     private readonly ctx?;
     constructor(ctx?: PlatformContext | undefined);
+    private assertPermission;
     currentId(): number | null;
     currentRole(): string | null;
     listMine(): Promise<OrgSummary[]>;
+    listMembers(): Promise<OrgMember[]>;
+    getMember(userId: string): Promise<OrgMember | null>;
+    getMemberByEmail(email: string): Promise<OrgMember | null>;
+    inviteMember(input: OrgInviteMemberInput): Promise<OrgInviteMemberResponse>;
+    updateMemberRole(userId: string, role: OrgMemberRole): Promise<OrgMember>;
 }
 
 declare function createPaletteClient(ctx?: PlatformContext): {
@@ -155,4 +179,4 @@ declare function hasPermission(ctx: PlatformContext, permission: string): boolea
 declare function hasAnyPermission(ctx: PlatformContext, permissions: string[]): boolean;
 declare function hasAllPermissions(ctx: PlatformContext, permissions: string[]): boolean;
 
-export { DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-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 { P as PlatformContext, O as OrgSummary, U as User } from './plugin-UV46q1mU.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-UV46q1mU.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 { 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 { 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-BDVWt7DE.js';
 export { PluginProvider } from './components/index.js';
 import 'react/jsx-runtime';
 
@@ -112,6 +112,24 @@ declare class StorageClient {
     uploadToSignedUrl: typeof uploadToSignedUrl;
 }
 
+type OrgMemberRole = "owner" | "admin" | "member" | "viewer";
+interface OrgMember {
+    id: string;
+    name: string;
+    email: string;
+    role: OrgMemberRole;
+    is_active: boolean;
+    joined_at: string;
+}
+interface OrgInviteMemberInput {
+    email: string;
+    role?: OrgMemberRole;
+}
+interface OrgInviteMemberResponse {
+    message: string;
+    email: string;
+    role: OrgMemberRole;
+}
 declare class UserClient {
     private readonly ctx?;
     constructor(ctx?: PlatformContext | undefined);
@@ -124,9 +142,15 @@ declare class UserClient {
 declare class OrganizationClient {
     private readonly ctx?;
     constructor(ctx?: PlatformContext | undefined);
+    private assertPermission;
     currentId(): number | null;
     currentRole(): string | null;
     listMine(): Promise<OrgSummary[]>;
+    listMembers(): Promise<OrgMember[]>;
+    getMember(userId: string): Promise<OrgMember | null>;
+    getMemberByEmail(email: string): Promise<OrgMember | null>;
+    inviteMember(input: OrgInviteMemberInput): Promise<OrgInviteMemberResponse>;
+    updateMemberRole(userId: string, role: OrgMemberRole): Promise<OrgMember>;
 }
 
 declare function createPaletteClient(ctx?: PlatformContext): {
@@ -155,4 +179,4 @@ declare function hasPermission(ctx: PlatformContext, permission: string): boolea
 declare function hasAnyPermission(ctx: PlatformContext, permissions: string[]): boolean;
 declare function hasAllPermissions(ctx: PlatformContext, permissions: string[]): boolean;
 
-export { DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { DataRoom, DataRoomClient, type DataRoomContents, DataRoomFile, DataRoomFolder, type DataRoomUploadOptions, type InstallConfig, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };

package/dist/index.js

@@ -395,6 +395,11 @@ var OrganizationClient = class {
   constructor(ctx) {
     this.ctx = ctx;
   }
+  assertPermission(permission) {
+    if (this.ctx?.permissions && !this.ctx.permissions.includes(permission)) {
+      throw new Error(`App does not declare required permission: ${permission}`);
+    }
+  }
   currentId() {
     return this.ctx?.organizationId ?? null;
   }
@@ -406,6 +411,39 @@ var OrganizationClient = class {
     const res = await apiFetch("/api/v1/auth/my-orgs");
     return res.json();
   }
+  async listMembers() {
+    this.assertPermission("members:read");
+    const res = await apiFetch("/api/v1/org/members");
+    return res.json();
+  }
+  async getMember(userId) {
+    const members = await this.listMembers();
+    return members.find((member) => member.id === userId) ?? null;
+  }
+  async getMemberByEmail(email) {
+    const normalizedEmail = email.trim().toLowerCase();
+    const members = await this.listMembers();
+    return members.find((member) => member.email.toLowerCase() === normalizedEmail) ?? null;
+  }
+  async inviteMember(input) {
+    this.assertPermission("members:write");
+    const res = await apiFetch("/api/v1/org/members", {
+      method: "POST",
+      body: JSON.stringify({
+        email: input.email,
+        role: input.role ?? "member"
+      })
+    });
+    return res.json();
+  }
+  async updateMemberRole(userId, role) {
+    this.assertPermission("members:write");
+    const res = await apiFetch(`/api/v1/org/members/${encodeURIComponent(userId)}/role`, {
+      method: "PATCH",
+      body: JSON.stringify({ role })
+    });
+    return res.json();
+  }
 };
 
 // src/palette-client.ts

package/dist/index.mjs

@@ -338,6 +338,11 @@ var OrganizationClient = class {
   constructor(ctx) {
     this.ctx = ctx;
   }
+  assertPermission(permission) {
+    if (this.ctx?.permissions && !this.ctx.permissions.includes(permission)) {
+      throw new Error(`App does not declare required permission: ${permission}`);
+    }
+  }
   currentId() {
     return this.ctx?.organizationId ?? null;
   }
@@ -349,6 +354,39 @@ var OrganizationClient = class {
     const res = await apiFetch("/api/v1/auth/my-orgs");
     return res.json();
   }
+  async listMembers() {
+    this.assertPermission("members:read");
+    const res = await apiFetch("/api/v1/org/members");
+    return res.json();
+  }
+  async getMember(userId) {
+    const members = await this.listMembers();
+    return members.find((member) => member.id === userId) ?? null;
+  }
+  async getMemberByEmail(email) {
+    const normalizedEmail = email.trim().toLowerCase();
+    const members = await this.listMembers();
+    return members.find((member) => member.email.toLowerCase() === normalizedEmail) ?? null;
+  }
+  async inviteMember(input) {
+    this.assertPermission("members:write");
+    const res = await apiFetch("/api/v1/org/members", {
+      method: "POST",
+      body: JSON.stringify({
+        email: input.email,
+        role: input.role ?? "member"
+      })
+    });
+    return res.json();
+  }
+  async updateMemberRole(userId, role) {
+    this.assertPermission("members:write");
+    const res = await apiFetch(`/api/v1/org/members/${encodeURIComponent(userId)}/role`, {
+      method: "PATCH",
+      body: JSON.stringify({ role })
+    });
+    return res.json();
+  }
 };
 
 // src/palette-client.ts

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

@@ -106,6 +106,8 @@ interface PluginManifest {
     frontend?: {
         entry: string;
         sandbox?: boolean;
+        framework?: "react" | "next";
+        config?: string;
     };
     backend?: {
         entry: string;

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

@@ -106,6 +106,8 @@ interface PluginManifest {
     frontend?: {
         entry: string;
         sandbox?: boolean;
+        framework?: "react" | "next";
+        config?: string;
     };
     backend?: {
         entry: string;

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, 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 { 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-UV46q1mU.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, 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 { 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-UV46q1mU.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.11",
+  "version": "0.1.13",
   "description": "Palette Platform SDK for building plugins and apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",