@rebasepro/studio 0.0.1-canary.3263433 → 0.0.1-canary.4829d6e

package/LICENSE

@@ -1,114 +1,22 @@
-Business Source License 1.1
+MIT License
 
-Parameters
+Copyright (c) 2026 Rebase
 
-Licensor:             Rebase S.L.
-Licensed Work:        Rebase CMS packages:
-                      cli
-                      collection_editor
-                      collection_editor_firebase
-                      data_enhancement
-                      data_export
-                      data_export
-                      editor
-                      rebase_cloud
-                      schema_inference
-                      user_management
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-                      The Licensed Work is (c) 2024 Rebase S.L
-Additional Use Grant: You may make use of the Licensed Work, provided that
-                      you may not use the Licensed Work for a CMS Data Enhancement
-                      Service.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-                      A “CMS package” is a commercial offering that
-                      allows third parties (other than your employees and
-                      contractors) to access the functionality of the
-                      Licensed Work by using software to extend the base features of
-                      content management system controlled by such third parties.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
-Change Date:         Four years from the date the Licensed Work is published.
-
-Change License:      MIT
-
-For information about alternative licensing arrangements for the Software,
-please visit: https://rebase.pro
-
-Notice
-
-The Business Source License (this document, or the “License”) is not an Open
-Source license. However, the Licensed Work will eventually be made available
-under an Open Source License, as stated in this License.
-
-License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
-“Business Source License” is a trademark of MariaDB Corporation Ab.
-
------------------------------------------------------------------------------
-
-Business Source License 1.1
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph
-above terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works
-of the Licensed Work, are subject to this License. This License applies
-separately for each version of the Licensed Work and the Change Date may vary
-for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or
-modified form from a third party, the terms and conditions set forth in this
-License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of
-Licensor or its affiliates (provided that you may use a trademark or logo of
-Licensor as expressly required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
-AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
-EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
-TITLE.
-
-MariaDB hereby grants you permission to use this License’s text to license
-your works, and to refer to it using the trademark “Business Source License”,
-as long as you comply with the Covenants of Licensor below.
-
-Covenants of Licensor
-
-In consideration of the right to use this License’s text and the “Business
-Source License” name and trademark, Licensor covenants to MariaDB, and to all
-other recipients of the licensed work to be provided by Licensor:
-
-1. To specify as the Change License the GPL Version 2.0 or any later version,
-   or a license that is compatible with GPL Version 2.0 or a later version,
-   where “compatible” means that software provided under the Change License can
-   be included in a program with software provided under GPL Version 2.0 or a
-   later version. Licensor may specify additional Change Licenses without
-   limitation.
-
-2. To either: (a) specify an additional grant of rights to use that does not
-   impose any additional restriction on the right granted in this License, as
-   the Additional Use Grant; or (b) insert the text “None”.
-
-3. To specify a Change Date.
-
-4. Not to modify this License in any other way.

package/README.md

@@ -1,159 +1,92 @@
-# Rebase Collection Editor Plugin
+# @rebasepro/studio
 
-This plugin enables creating and managing Firestore collections directly from your Rebase interface. It adds a visual
-collection editor that allows you to create, edit, and delete collections without writing code.
+Developer tools layer for Rebase — provides 9 lazy-loaded tools (SQL Console, JS Console, RLS Editor, Storage, Cron Jobs, Schema Visualizer, Branches, API Explorer, Logs Explorer) plus a customizable home page.
 
 ## Installation
 
 ```bash
-npm install @rebasepro/collection_editor
-# or
-yarn add @rebasepro/collection_editor
+pnpm add @rebasepro/studio
 ```
 
-For Firebase integration, also install:
-
-```bash
-npm install @rebasepro/collection_editor_firebase
-# or
-yarn add @rebasepro/collection_editor_firebase
-```
-
-## Features
-
-- Create and edit collections through a visual interface
-- Define properties, validations, and display options
-- Organize collections with groups and subcollections
-- Merge UI-defined collections with code-defined collections
-- Persist collection configurations in Firestore
-- Control permissions for collection editing operations
-
-## Basic Usage
-
-```tsx
-import React from "react";
-import { RebaseCMS } from "@rebasepro/admin";
-import { useFirestoreCollectionsConfigController } from "@rebasepro/collection_editor_firebase";
-
-export default function App() {
-    // Controller to save collection configs in Firestore
-    const collectionConfigController = useFirestoreCollectionsConfigController({
-        firebaseApp
-    });
-    
-    return <RebaseCMS
-        name={"My CMS"}
-        authentication={myAuthenticator}
-        firebaseConfig={firebaseConfig}
-        collectionEditor={{
-            collectionConfigController
-        }}
-    />;
-}
-```
-
-## Advanced Configuration
-
-You can customize collection editor behavior with these options using the `collectionEditor` prop on `RebaseCMS`:
-
-```tsx
-<RebaseCMS
-    collectionEditor={{
-        collectionConfigController, // Required: controller that handles persistence
-        
-        // Define permissions for collection operations
-        configPermissions: ({ user }) => ({
-            createCollections: user.roles?.includes("admin") ?? false,
-            editCollections: user.roles?.includes("admin") ?? false,
-            deleteCollections: user.roles?.includes("admin") ?? false
-        }),
-        
-        // Prevent these group names from being used
-        reservedGroups: ["admin", "system"],
-        
-        // Optional custom view to add to the editor
-        extraView: {
-            View: MyCustomView,
-            icon: <CustomIcon />
-        },
-        
-        // Function to infer collection structure from existing data
-        collectionInference: async ({ path }) => {
-            // Return inferred schema based on data at path
-        },
-        
-        // Function to get sample data for a collection
-        getData: async (path, parentPaths) => {
-            // Return sample data for the specified path
-        },
-        
-        // Track collection editor events
-        onAnalyticsEvent: (event, params) => {
-            console.log("Collection editor event:", event, params);
-        },
-        
-        // Include introduction widget when no collections exist
-        includeIntroView: true
-    }}
-/>
+### Peer Dependencies
+
+- `react` >= 19.0.0
+- `react-dom` >= 19.0.0
+- `react-router` ^7.0.0
+- `react-router-dom` ^7.0.0
+- `@rebasepro/admin` (optional)
+
+## What This Package Does
+
+`@rebasepro/studio` registers a set of developer tools into the Rebase CMS. The `<RebaseStudio>` component renders nothing visible — it declaratively registers tool views into the Rebase registry. Each tool (Monaco-based editors, xyflow graph, etc.) is lazy-loaded so it stays out of the initial bundle.
+
+## Available Tools
+
+| Slug | Name | Group | Description |
+|---|---|---|---|
+| `sql` | SQL Console | Database | Execute raw SQL queries |
+| `js` | JS Console | Compute | Run JavaScript in a live sandbox |
+| `rls` | RLS Policies | Database | Configure Row Level Security |
+| `storage` | Storage | Storage | Browse and manage files |
+| `cron` | Cron Jobs | Compute | Monitor scheduled tasks |
+| `schema-visualizer` | Schema Visualizer | Database | Interactive database ERD |
+| `branches` | Branches | Database | Create and manage database branches |
+| `api` | API Explorer | API | Interactive API docs and testing |
+| `logs` | Logs Explorer | Database | Real-time system and query logs |
+
+All 9 tools are enabled by default. The `schema` tool (collection editor) is auto-injected by the CMS when `collectionEditor` is enabled — it is **not** registered here.
+
+## Key Exports
+
+| Export | Type | Description |
+|---|---|---|
+| `RebaseStudio` | Component | Main entry point — registers tools into the Rebase registry |
+| `StudioHomePage` | Component | Default home page with tool cards and SDK quick-start snippet |
+| `StudioBridgeProvider` | Component | Re-exported from `@rebasepro/app` |
+| `StudioBridgeContext` | Context | Re-exported from `@rebasepro/app` |
+| `useStudioCollectionRegistry` | Hook | Access the collection registry |
+| `useStudioSidePanelController` | Hook | Control the side snapshot panel |
+| `useStudioUrlController` | Hook | URL state management |
+| `useStudioNavigationState` | Hook | Navigation state |
+| `useStudioBreadcrumbs` | Hook | Breadcrumb management |
+| `StudioBridge` | Type | Bridge interface type |
+| `BreadcrumbEntry` | Type | Single breadcrumb item |
+| `BreadcrumbsController` | Type | Breadcrumb controller interface |
+
+Individual tools (e.g. `SQLEditor`, `SchemaVisualizer`) are **not** re-exported from the barrel to preserve code splitting. Use deep imports if needed:
+
+```typescript
+import { SQLEditor } from "@rebasepro/studio/components/SQLEditor/SQLEditor";
 ```
 
-## Integration with Code-Defined Collections
-
-You can combine collections defined in code with those created in the UI:
+## Quick Start
 
 ```tsx
-import { mergeCollections } from "@rebasepro/admin/collection_editor";
-
+import { RebaseStudio } from "@rebasepro/studio";
 
-const collectionsBuilder = useCallback(() => {
-    // Collections defined in code
-    const codeCollections = [productsCollection, ordersCollection];
-    
-    // Merge with collections from the editor UI
-    return mergeCollections(codeCollections, collectionConfigController.collections ?? []);
-}, [collectionConfigController.collections]);
+// Inside your Rebase app — enable all 9 tools (default)
+<RebaseStudio />
 
-const navigationController = useBuildNavigationStateController({
-    collections: collectionsBuilder,
-    // Other options
-});
-```
-
-## Firestore Configuration Controller
-
-To persist collections in Firestore:
+// Or pick specific tools
+<RebaseStudio tools={["sql", "rls", "storage", "api"]} />
 
-```tsx
-const collectionConfigController = useFirestoreCollectionsConfigController({
-    firebaseApp,
-    
-    // Optional: specify where to save configs (default: "__REBASE/config/collections")
-    configPath: "custom/config/path",
-    
-    // Optional: define permissions for collections
-    permissions: ({ user }) => ({
-        // Your permissions logic
-    }),
-    
-    // Optional: custom property configurations
-    propertyConfigs: [
-        // Custom property types
-    ]
-});
+// Custom home page
+<RebaseStudio homePage={<MyCustomHomePage />} />
 ```
 
-## Additional Notes
-
-- Collections created through the editor are stored in Firestore and loaded dynamically
-- The plugin automatically adds UI elements for creating and managing collections
-- For a complete solution, consider using alongside other plugins like data import/export
+### StudioHomePage Props
 
-## Related Plugins
+| Prop | Type | Description |
+|---|---|---|
+| `additionalActions` | `ReactNode` | Extra actions in the top-right area |
+| `additionalChildrenStart` | `ReactNode` | Content before the tool grid |
+| `additionalChildrenEnd` | `ReactNode` | Content after the tool grid |
+| `sections` | `HomePageSection[]` | Extra sections appended to the page |
+| `hiddenGroups` | `string[]` | Groups to hide from the home page |
 
-Rebase offers several complementary plugins:
+## Related Packages
 
-- Data Import: Import data from CSV or JSON into Firestore collections
-- Data Export: Export collection data to CSV or JSON formats
-- Data Enhancement: Generate content using AI for your collections
-- Entity History: Track changes to your collection entities
+- `@rebasepro/app` — Bridge, registry, and navigation primitives
+- `@rebasepro/ui` — Component library used by Studio tools
+- `@rebasepro/admin` — The CMS layer (optional peer dep)
+- `@rebasepro/types` — Shared type definitions