@palettelab/cli 0.3.24 → 0.3.26

package/README.md

@@ -266,12 +266,45 @@ Backend SDK features for app-owned data:
 
 - `PluginContext` exposes `user_id`, `organization_id`, `plugin_id`, `permissions`, `config`, `storage`, and `ctx.db`.
 - `ctx.repo(Model)` gives org-safe CRUD helpers for app tables.
-- `ctx.has_permission("...")` checks declared permissions.
+- `ctx.data_rooms` gives backend access to Palette Data Rooms without importing platform internals.
+- `ctx.has_permission("...")`, `ctx.has_any_permission([...])`, and `ctx.has_all_permissions([...])` check declared permissions.
 - `ctx.config_value("key")` and `ctx.require_config("key")` read app install/config values.
 - `ctx.secret("KEY")` reads app secrets from config or environment variables.
 - `LifecycleHooks` lets apps define install/update/enable/disable/uninstall hooks.
 - `OrgScopedTable` and `PluginBase` keep app data inside the plugin schema model set.
 
+Python backend Data Room example:
+
+```python
+@router.post("/sync-invoices", dependencies=[require_permission("data_rooms:write")])
+async def sync_invoices(ctx: PluginContext = Depends(get_plugin_context)):
+    room = await ctx.data_rooms.ensure_room("Finance")
+    folder = await ctx.data_rooms.resolve_folder_path(
+        room["id"],
+        "Clients/Acme/Invoices",
+        create=True,
+    )
+    file = await ctx.data_rooms.find_file_by_name(
+        room["id"],
+        "jan.pdf",
+        folder_id=folder["id"] if folder else None,
+    )
+    content = await ctx.data_rooms.read_file_bytes(file["id"]) if file else None
+    if folder:
+        await ctx.data_rooms.upload_file(
+            room["id"],
+            "summary.txt",
+            b"Generated by my app",
+            folder_id=folder["id"],
+            content_type="text/plain",
+        )
+    return {"room": room, "folder": folder, "bytes": len(content or b"")}
+```
+
+The npm `@palettelab/sdk` package is for frontend JavaScript/React apps.
+Python backend code uses `palette_sdk`, which is embedded in the CLI for
+local dev/tests and injected by the hosted Palette runtime.
+
 Lifecycle example:
 
 ```python

package/backend-sdk/palette_sdk/__init__.py

@@ -2,6 +2,7 @@
 
 from palette_sdk.plugin_router import PluginRouter
 from palette_sdk.plugin_context import PluginContext, get_plugin_context
+from palette_sdk.data_rooms import DataRoomsClient
 from palette_sdk.repository import OrgRepository
 from palette_sdk.lifecycle import LifecycleHooks
 from palette_sdk.tool_definition import ToolDefinition
@@ -26,6 +27,7 @@ __all__ = [
     "PluginRouter",
     "PluginContext",
     "get_plugin_context",
+    "DataRoomsClient",
     "OrgRepository",
     "LifecycleHooks",
     "ToolDefinition",
@@ -49,4 +51,4 @@ __all__ = [
     "route_permission_issues",
 ]
 
-__version__ = "0.1.4"
+__version__ = "0.1.6"

package/backend-sdk/palette_sdk/data_rooms.py

@@ -0,0 +1,127 @@
+"""Backend Data Room helpers for plugin Python code."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class DataRoomsClient:
+    """Thin wrapper around the platform-injected Data Room service.
+
+    In production/hosted sandbox the platform injects the service into
+    `PluginContext`. In local unit tests, pass a fake service with the same
+    async methods.
+    """
+
+    def __init__(self, service: Any = None):
+        self._service = service
+
+    def _require_service(self) -> Any:
+        if self._service is None:
+            raise RuntimeError(
+                "Data Room service is not available in this runtime. "
+                "Run inside Palette OS/hosted sandbox or inject a fake service in tests."
+            )
+        return self._service
+
+    async def list(self) -> list[dict[str, Any]]:
+        return await self._require_service().list_rooms()
+
+    async def create(self, name: str, description: str | None = None) -> dict[str, Any]:
+        return await self._require_service().create_room(name, description)
+
+    async def find_room_by_name(self, name: str, *, case_sensitive: bool = False) -> dict[str, Any] | None:
+        return await self._require_service().find_room_by_name(name, case_sensitive=case_sensitive)
+
+    async def require_room_by_name(self, name: str, *, case_sensitive: bool = False) -> dict[str, Any]:
+        room = await self.find_room_by_name(name, case_sensitive=case_sensitive)
+        if room is None:
+            raise LookupError(f"Data Room not found: {name}")
+        return room
+
+    async def ensure_room(self, name: str, description: str | None = None) -> dict[str, Any]:
+        return await self._require_service().ensure_room(name, description)
+
+    async def contents(self, room_id: int, folder_id: int | None = None) -> dict[str, Any]:
+        return await self._require_service().contents(room_id, folder_id)
+
+    async def create_folder(
+        self,
+        room_id: int,
+        name: str,
+        parent_folder_id: int | None = None,
+    ) -> dict[str, Any]:
+        return await self._require_service().create_folder(room_id, name, parent_folder_id)
+
+    async def find_folder_by_name(
+        self,
+        room_id: int,
+        name: str,
+        *,
+        parent_folder_id: int | None = None,
+        case_sensitive: bool = False,
+    ) -> dict[str, Any] | None:
+        return await self._require_service().find_folder_by_name(
+            room_id,
+            name,
+            parent_folder_id=parent_folder_id,
+            case_sensitive=case_sensitive,
+        )
+
+    async def ensure_folder(
+        self,
+        room_id: int,
+        name: str,
+        parent_folder_id: int | None = None,
+    ) -> dict[str, Any]:
+        return await self._require_service().ensure_folder(room_id, name, parent_folder_id)
+
+    async def resolve_folder_path(
+        self,
+        room_id: int,
+        path: str | list[str],
+        *,
+        create: bool = False,
+        case_sensitive: bool = False,
+    ) -> dict[str, Any] | None:
+        return await self._require_service().resolve_folder_path(
+            room_id,
+            path,
+            create=create,
+            case_sensitive=case_sensitive,
+        )
+
+    async def find_file_by_name(
+        self,
+        room_id: int,
+        name: str,
+        *,
+        folder_id: int | None = None,
+        case_sensitive: bool = False,
+    ) -> dict[str, Any] | None:
+        return await self._require_service().find_file_by_name(
+            room_id,
+            name,
+            folder_id=folder_id,
+            case_sensitive=case_sensitive,
+        )
+
+    async def read_file_bytes(self, file_id: int) -> bytes:
+        return await self._require_service().read_file_bytes(file_id)
+
+    async def upload_file(
+        self,
+        room_id: int,
+        filename: str,
+        content: bytes,
+        *,
+        folder_id: int | None = None,
+        content_type: str | None = None,
+    ) -> dict[str, Any]:
+        return await self._require_service().upload_file(
+            room_id,
+            filename,
+            content,
+            folder_id=folder_id,
+            content_type=content_type,
+        )

package/backend-sdk/palette_sdk/plugin_context.py

@@ -10,6 +10,8 @@ from typing import Any
 from fastapi import Depends, Request
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from palette_sdk.data_rooms import DataRoomsClient
+
 
 @dataclass
 class PluginContext:
@@ -36,12 +38,19 @@ class PluginContext:
     plugin_id: str = ""
     permissions: list[str] = field(default_factory=list)
     storage: Any = None  # Platform storage service injected at runtime
+    data_rooms: DataRoomsClient = field(default_factory=DataRoomsClient)
     config: dict[str, Any] = field(default_factory=dict)
     logger: logging.Logger = field(default_factory=lambda: logging.getLogger("palette_sdk.plugin"))
 
     def has_permission(self, permission: str) -> bool:
         return permission in self.permissions
 
+    def has_any_permission(self, permissions: list[str] | tuple[str, ...] | set[str]) -> bool:
+        return any(permission in self.permissions for permission in permissions)
+
+    def has_all_permissions(self, permissions: list[str] | tuple[str, ...] | set[str]) -> bool:
+        return all(permission in self.permissions for permission in permissions)
+
     def config_value(self, key: str, default: Any = None) -> Any:
         return self.config.get(key, default)
 
@@ -84,6 +93,7 @@ async def get_plugin_context(request: Request) -> PluginContext:
         plugin_id=getattr(state, "plugin_id", ""),
         permissions=getattr(state, "plugin_permissions", []),
         storage=getattr(state, "storage", None),
+        data_rooms=DataRoomsClient(getattr(state, "data_rooms", None)),
         config=getattr(state, "plugin_config", {}),
         logger=getattr(state, "plugin_logger", logging.getLogger(f"palette_sdk.plugin.{getattr(state, 'plugin_id', 'unknown')}")),
     )

package/backend-sdk/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "palette-sdk"
-version = "0.1.4"
+version = "0.1.6"
 description = "Palette Platform SDK for building backend plugins"
 readme = "README.md"
 requires-python = ">=3.12"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palettelab/cli",
-  "version": "0.3.24",
+  "version": "0.3.26",
   "description": "Developer CLI for building Palette platform plugins — no platform source access required.",
   "bin": {
     "pltt": "bin/pltt.js"

package/template-fallback/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "description": "A Palette platform plugin",
   "dependencies": {
-    "@palettelab/sdk": "^0.1.9"
+    "@palettelab/sdk": "^0.1.10"
   },
   "devDependencies": {
     "typescript": "^5.0.0",

package/template-fallback/templates/dashboard/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "private": true,
   "dependencies": {
-    "@palettelab/sdk": "^0.1.9",
+    "@palettelab/sdk": "^0.1.10",
     "react": "^19.0.0"
   }
 }

package/template-fallback/templates/database/package.json

@@ -2,5 +2,5 @@
   "name": "my-db-plugin",
   "version": "1.0.0",
   "private": true,
-  "dependencies": { "@palettelab/sdk": "^0.1.9", "react": "^19.0.0" }
+  "dependencies": { "@palettelab/sdk": "^0.1.10", "react": "^19.0.0" }
 }

package/template-fallback/templates/external-service/package.json

@@ -2,5 +2,5 @@
   "name": "my-external-svc",
   "version": "1.0.0",
   "private": true,
-  "dependencies": { "@palettelab/sdk": "^0.1.9", "react": "^19.0.0" }
+  "dependencies": { "@palettelab/sdk": "^0.1.10", "react": "^19.0.0" }
 }

package/template-fallback/templates/frontend-only/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "private": true,
   "dependencies": {
-    "@palettelab/sdk": "^0.1.9",
+    "@palettelab/sdk": "^0.1.10",
     "react": "^19.0.0"
   }
 }