@palettelab/cli 0.3.25 → 0.3.27

package/README.md

@@ -195,6 +195,10 @@ internal platform parity checks with `pltt dev --platform`.
 
 ## App-Owned Data, Migrations, And Python Backends
 
+For a detailed Python backend SDK guide with route examples, app-owned data,
+migrations, Data Rooms, config, secrets, lifecycle hooks, and hosted sandbox
+testing, see [Python Backend SDK Developer Guide](./docs/python-backend-sdk.md).
+
 Palette apps can own their own Python backend, database tables, migrations, and
 organization-scoped data. The generated database template uses this structure:
 
@@ -267,7 +271,7 @@ 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.data_rooms` gives backend access to Palette Data Rooms without importing platform internals.
-- `ctx.has_permission("...")` checks declared permissions.
+- `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.
@@ -290,6 +294,14 @@ async def sync_invoices(ctx: PluginContext = Depends(get_plugin_context)):
         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"")}
 ```
 
@@ -358,13 +370,19 @@ By default this starts:
 
 - A small local app shell on the first available port starting at http://localhost:3000
 - A local FastAPI backend runner on the first available port starting at http://localhost:8000
-- A mock Palette platform context for `usePlatform()`, toasts, org/user data, and authenticated API calls
+- A mock Palette platform context for `usePlatform()`, OS language, toasts, org/user data, and authenticated API calls
 - A plugin-local SQLite database under `.palette/dev/` when `capabilities.database` or `database` is enabled
 
 Your frontend entry is bundled and watched. Your backend entry is loaded under
 `/api/v1/plugins/<your-id>/*` with a dev `PluginContext`, so normal SDK calls
 work without Docker or platform source.
 
+The simulator also provides the same language fields that Palette OS provides:
+`language`, `fallbackLanguage`, `supportedLanguages`, and `setLanguage()`.
+Generated frontend templates include app-owned `frontend/src/translations.ts`
+files wired through `usePluginTranslations()`, so apps can switch when the OS
+language changes without storing copy in the platform.
+
 For Python apps with database tables, `ctx.db` is an async SQLAlchemy session in
 local dev. The simulator imports `backend/api/models.py` when present and creates
 tables from `palette_sdk.db.PluginBase.metadata`. Production installs still use
@@ -487,7 +505,7 @@ If no publish ID is provided, the CLI uses `.palette/last-publish.json` when ava
 Fetch or stream telemetry events for a plugin.
 
 ```bash
-pltt logs hello-sdk --env staging
+pltt logs my-plugin --env staging
 pltt logs --tail 100
 pltt logs --follow
 pltt logs --json

package/backend-sdk/palette_sdk/__init__.py

@@ -51,4 +51,4 @@ __all__ = [
     "route_permission_issues",
 ]
 
-__version__ = "0.1.5"
+__version__ = "0.1.6"

package/backend-sdk/palette_sdk/data_rooms.py

@@ -108,3 +108,20 @@ class DataRoomsClient:
 
     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/db/alembic_env.py

@@ -11,8 +11,10 @@ invokes Alembic:
   - ``PALETTE_PLUGIN_ID``  — plugin id; determines the target schema
                              (``app_<sanitized_id>``) and version table schema.
   - ``PALETTE_DB_URL``     — SQLAlchemy async URL for the plugin's DB.
-  - ``PALETTE_PLUGIN_ROLE`` (optional) — role the migration should run as;
-                             defaults to the connecting user (so DDL works).
+  - ``PALETTE_PLUGIN_ROLE`` (optional) — schema-limited role the migration
+                             should run as; the hosted platform sets this to
+                             ``plugin_migrator_<sanitized_id>``. Local/manual
+                             runs default to the connecting user.
 
 Plugin devs running ``alembic upgrade head`` locally without those vars get
 a helpful error rather than a scribbled-on main DB.

package/backend-sdk/palette_sdk/plugin_context.py

@@ -45,6 +45,12 @@ class PluginContext:
     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)
 

package/backend-sdk/pyproject.toml

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