@palettelab/sdk 0.1.15 → 0.1.17

package/README.md

@@ -257,6 +257,32 @@ The CLI reads that config in `pltt dev`, `pltt test`, `pltt package`, and
 `NEXT_PUBLIC_*` environment variables, and path aliases from
 `frontend/tsconfig.json`.
 
+## Palette App Router
+
+For OS-native routed apps, set `frontend.framework` to `palette-app` and point
+`frontend.entry` at `frontend/app`. The CLI scans app-directory UI files and
+still publishes one safe browser bundle.
+
+```json
+{
+  "frontend": {
+    "entry": "./frontend/app",
+    "sandbox": true,
+    "framework": "palette-app"
+  }
+}
+```
+
+Supported UI files are `layout.tsx`, `page.tsx`, `loading.tsx`, `error.tsx`,
+and `not-found.tsx`. Static routes, route groups, `[id]`, `[...slug]`, and
+`[[...slug]]` are supported. Use `Link`, `useRouter`, `usePathname`,
+`useSearchParams`, and `useParams` from `@palettelab/sdk`, or use the
+`next/link` and `next/navigation` compatibility imports in `palette-app`
+projects.
+
+Server-side Next features are intentionally not part of this mode. Put APIs,
+database access, permissions, and secrets in the plugin backend.
+
 ## Palette Client
 
 Use `createPaletteClient()` when an app needs common Palette OS services without
@@ -420,6 +446,16 @@ const config = await getInstallConfig("my-plugin")
 await updateInstallConfig("my-plugin", { ...config, enabled: true })
 ```
 
+Plugins can also read and start Palette-managed third-party connections declared
+in `palette-plugin.json`:
+
+```ts
+import { getConnections, startConnection } from "@palettelab/sdk"
+
+const connections = await getConnections("my-plugin")
+await startConnection("my-plugin", "google_calendar")
+```
+
 ## Sandbox Bridge
 
 Appstore plugin frontends run inside an iframe sandbox by default. Use `createSandboxBridge` when you need to explicitly call host-proxied APIs from sandbox runtime code.

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-UV46q1mU.mjs';
+import { P as PlatformContext } from '../plugin-dpLzOtF6.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-UV46q1mU.js';
+import { P as PlatformContext } from '../plugin-dpLzOtF6.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-Bu5EQGYo.mjs';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-DsfTFnZb.mjs';
 import 'react';
-import '../plugin-UV46q1mU.mjs';
+import '../plugin-dpLzOtF6.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-BDVWt7DE.js';
+export { P as PlatformCtx, u as usePlatform, e as usePluginChat, f as usePluginDataRooms, g as usePluginTasks, h as usePluginTranslations } from '../index-D0i35Hem.js';
 import 'react';
-import '../plugin-UV46q1mU.js';
+import '../plugin-dpLzOtF6.js';
 import '../data-room-Dtd9LLHf.js';

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

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-UV46q1mU.js';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-dpLzOtF6.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-Bu5EQGYo.d.mts → index-DsfTFnZb.d.mts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { d as PaletteLanguage, P as PlatformContext } from './plugin-UV46q1mU.mjs';
+import { d as PaletteLanguage, P as PlatformContext } from './plugin-dpLzOtF6.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,11 @@
-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 { P as PlatformContext, O as OrgSummary, U as User } from './plugin-dpLzOtF6.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 PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition } from './plugin-dpLzOtF6.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-Bu5EQGYo.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-DsfTFnZb.mjs';
+export { Link, PaletteAppRoute, PaletteAppRouter, notFound, useParams, usePathname, useRouter, useSearchParams } from './router/index.mjs';
 export { PluginProvider } from './components/index.mjs';
 import 'react/jsx-runtime';
 
@@ -53,6 +54,31 @@ type InstallConfig = Record<string, unknown>;
 declare function getInstallConfig(pluginId: string): Promise<InstallConfig>;
 declare function updateInstallConfig(pluginId: string, config: InstallConfig): Promise<InstallConfig>;
 
+type ConnectionStatusValue = "available" | "connected" | "expiring" | "failed" | "missing";
+interface ConnectionStatus {
+    id: string;
+    provider: string;
+    label: string;
+    auth: "oauth2" | "api_key";
+    scopes: string[];
+    required: boolean;
+    status: ConnectionStatusValue;
+    account_label?: string | null;
+    granted_scopes: string[];
+    expires_at?: string | null;
+    connected_at?: string | null;
+    last_error?: string | null;
+}
+interface ConnectionAuthStart {
+    connection_id: string;
+    authorize_url: string;
+    mode: "oauth2" | "mock";
+}
+declare function getConnections(pluginId: string): Promise<ConnectionStatus[]>;
+declare function startConnection(pluginId: string, connectionId: string): Promise<ConnectionAuthStart>;
+declare function disconnectConnection(pluginId: string, connectionId: string): Promise<void>;
+declare function requireConnection(pluginId: string, connectionId: string): Promise<ConnectionStatus>;
+
 declare function createMockPlatformContext(overrides?: Partial<PlatformContext>): PlatformContext;
 declare function withPluginProvider(element: ReactElement, platform?: Partial<PlatformContext>): ReactElement;
 
@@ -195,6 +221,12 @@ declare function createPaletteClient(ctx?: PlatformContext): {
         get: (pluginId?: string) => Promise<InstallConfig>;
         update: (values: Record<string, unknown>, pluginId?: string) => Promise<InstallConfig>;
     };
+    connections: {
+        list: (pluginId?: string) => Promise<ConnectionStatus[]>;
+        connect: (connectionId: string, pluginId?: string) => Promise<ConnectionAuthStart>;
+        disconnect: (connectionId: string, pluginId?: string) => Promise<void>;
+        require: (connectionId: string, pluginId?: string) => Promise<ConnectionStatus>;
+    };
     permissions: {
         has: (permission: string) => boolean;
         hasAny: (permissions: string[]) => boolean;
@@ -212,4 +244,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, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, 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, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, requireConnection, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-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 { P as PlatformContext, O as OrgSummary, U as User } from './plugin-dpLzOtF6.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 PluginConnectionDefinition, h as PluginManifest, i as PluginToolDefinition } from './plugin-dpLzOtF6.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-BDVWt7DE.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-D0i35Hem.js';
+export { Link, PaletteAppRoute, PaletteAppRouter, notFound, useParams, usePathname, useRouter, useSearchParams } from './router/index.js';
 export { PluginProvider } from './components/index.js';
 import 'react/jsx-runtime';
 
@@ -53,6 +54,31 @@ type InstallConfig = Record<string, unknown>;
 declare function getInstallConfig(pluginId: string): Promise<InstallConfig>;
 declare function updateInstallConfig(pluginId: string, config: InstallConfig): Promise<InstallConfig>;
 
+type ConnectionStatusValue = "available" | "connected" | "expiring" | "failed" | "missing";
+interface ConnectionStatus {
+    id: string;
+    provider: string;
+    label: string;
+    auth: "oauth2" | "api_key";
+    scopes: string[];
+    required: boolean;
+    status: ConnectionStatusValue;
+    account_label?: string | null;
+    granted_scopes: string[];
+    expires_at?: string | null;
+    connected_at?: string | null;
+    last_error?: string | null;
+}
+interface ConnectionAuthStart {
+    connection_id: string;
+    authorize_url: string;
+    mode: "oauth2" | "mock";
+}
+declare function getConnections(pluginId: string): Promise<ConnectionStatus[]>;
+declare function startConnection(pluginId: string, connectionId: string): Promise<ConnectionAuthStart>;
+declare function disconnectConnection(pluginId: string, connectionId: string): Promise<void>;
+declare function requireConnection(pluginId: string, connectionId: string): Promise<ConnectionStatus>;
+
 declare function createMockPlatformContext(overrides?: Partial<PlatformContext>): PlatformContext;
 declare function withPluginProvider(element: ReactElement, platform?: Partial<PlatformContext>): ReactElement;
 
@@ -195,6 +221,12 @@ declare function createPaletteClient(ctx?: PlatformContext): {
         get: (pluginId?: string) => Promise<InstallConfig>;
         update: (values: Record<string, unknown>, pluginId?: string) => Promise<InstallConfig>;
     };
+    connections: {
+        list: (pluginId?: string) => Promise<ConnectionStatus[]>;
+        connect: (connectionId: string, pluginId?: string) => Promise<ConnectionAuthStart>;
+        disconnect: (connectionId: string, pluginId?: string) => Promise<void>;
+        require: (connectionId: string, pluginId?: string) => Promise<ConnectionStatus>;
+    };
     permissions: {
         has: (permission: string) => boolean;
         hasAny: (permissions: string[]) => boolean;
@@ -212,4 +244,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, type OrgInviteMemberInput, type OrgInviteMemberResponse, type OrgMember, type OrgMemberRole, OrgSummary, OrganizationClient, PaletteApiError, type PaletteClient, PlatformContext, type SandboxBridge, StorageClient, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, errorFromResponse, getBaseUrl, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, setBaseUrl, updateInstallConfig, uploadToSignedUrl, withPluginProvider };
+export { type ConnectionAuthStart, type ConnectionStatus, type ConnectionStatusValue, 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, type StorageUploadOptions, type StorageUploadProgress, type StorageUploadResult, type StorageUploadState, User, UserClient, apiFetch, apiUpload, createMockPlatformContext, createPaletteClient, createSandboxBridge, dataRooms, disconnectConnection, errorFromResponse, getBaseUrl, getConnections, getInstallConfig, hasAllPermissions, hasAnyPermission, hasPermission, isPaletteApiError, isSandboxRuntime, requireConnection, setBaseUrl, startConnection, updateInstallConfig, uploadToSignedUrl, withPluginProvider };