@rebasepro/plugin-ai 0.0.1-canary.4829d6e

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Rebase
+
+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 above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+

package/README.md

@@ -0,0 +1,81 @@
+# @rebasepro/plugin-ai
+
+AI-powered data autofill and text autocomplete plugin for Rebase.
+
+## Installation
+
+```bash
+pnpm add @rebasepro/plugin-ai
+```
+
+**Peer dependencies:** `react >= 19.0.0`, `react-dom >= 19.0.0`, `react-router >= 6.28.0`, `react-router-dom >= 6.28.0`
+
+## What This Package Does
+
+This plugin adds AI-powered capabilities to the Rebase admin panel:
+
+- **Form autofill** — An "Enhance" action button injected into snapshot forms that uses AI to suggest and fill field values based on collection schema and existing data.
+- **Editor autocomplete** — A streaming text autocomplete controller for rich text editors, powered by an AI backend.
+
+It registers as a standard `RebasePlugin`, injecting UI slots and providers automatically.
+
+## Key Exports
+
+| Export | Type | Description |
+|---|---|---|
+| `useDataEnhancementPlugin` | Hook | Creates the plugin. Returns a `RebasePlugin` to pass to your app's `plugins` array |
+| `DataEnhancementPluginProps` | Type | Configuration options for the plugin |
+| `useEditorAIController` | Hook | Returns an `EditorAIController` with a streaming `autocomplete` method for rich text editors |
+
+### `DataEnhancementPluginProps`
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | Built-in default key | API key for the data enhancement service |
+| `getConfigForPath` | `(props: { path, collection, user }) => boolean` | — | Return `false` to disable enhancement for specific paths |
+| `host` | `string` | — | Custom API host (development only) |
+
+## Quick Start
+
+```tsx
+import { useDataEnhancementPlugin } from "@rebasepro/plugin-ai";
+
+// In your app setup:
+const dataEnhancementPlugin = useDataEnhancementPlugin({
+    getConfigForPath: ({ path, collection }) => {
+        // Disable for certain collections
+        return collection.name !== "system_logs";
+    }
+});
+
+// Pass to your Rebase app:
+<RebaseFirebaseApp
+    plugins={[dataEnhancementPlugin]}
+    // ...other props
+/>
+```
+
+### Editor AI Autocomplete
+
+```tsx
+import { useEditorAIController } from "@rebasepro/plugin-ai";
+
+const aiController = useEditorAIController({
+    getAuthToken: () => firebaseUser.getIdToken()
+});
+
+// Use in a rich text editor:
+await aiController.autocomplete(
+    "The quick brown",   // text before cursor
+    " over the fence",   // text after cursor
+    (delta) => {         // streaming callback
+        appendText(delta);
+    }
+);
+```
+
+## Related Packages
+
+- `@rebasepro/admin` — The admin panel this plugin extends
+- `@rebasepro/app` — Core framework providing the plugin system
+- `@rebasepro/types` — Shared types (`RebasePlugin`, `CollectionConfig`, etc.)

package/dist/api.d.ts

@@ -0,0 +1,34 @@
+import { EnhancedDataResult, InputProperty, SamplePromptsResult } from "./types/data_enhancement_controller";
+import { EntityValues } from "@rebasepro/types";
+export declare function enhanceDataAPIStream<M extends Record<string, unknown>>(props: {
+    apiKey: string;
+    entityId?: string | number;
+    entityName: string;
+    entityDescription?: string;
+    propertyKey?: string;
+    propertyInstructions?: string;
+    values: EntityValues<M>;
+    path: string;
+    properties: Record<string, InputProperty>;
+    instructions?: string;
+    firebaseToken: string;
+    onUpdate: (suggestions: Record<string, string | number>) => void;
+    onUpdateDelta: (propertyKey: string, partialValue: string) => void;
+    onError: (error: Error) => void;
+    onEnd: (result: EnhancedDataResult) => void;
+    host?: string;
+}): Promise<void>;
+export declare function fetchEntityPromptSuggestion<M extends object>(props: {
+    input?: string;
+    entityName: string;
+    firebaseToken: string;
+    apiKey: string;
+    host?: string;
+}): Promise<SamplePromptsResult>;
+export declare function autocompleteStream(props: {
+    firebaseToken: string;
+    textBefore?: string;
+    textAfter: string;
+    host?: string;
+    onUpdate: (delta: string) => void;
+}): Promise<string>;

package/dist/components/DataEnhancementControllerProvider.d.ts

@@ -0,0 +1,14 @@
+import React, { PropsWithChildren } from "react";
+import { DataEnhancementController } from "../types/data_enhancement_controller";
+import { CollectionConfig, PluginFormActionProps } from "@rebasepro/types";
+type DataEnhancementControllerProviderProps = {
+    apiKey: string;
+    getConfigForPath?: (props: {
+        path: string;
+        collection: CollectionConfig;
+    }) => boolean;
+    host?: string;
+};
+export declare const useDataEnhancementController: () => DataEnhancementController;
+export declare function DataEnhancementControllerProvider({ apiKey, getConfigForPath, children, host, path, collection, formContext }: PropsWithChildren<DataEnhancementControllerProviderProps & PluginFormActionProps>): React.JSX.Element;
+export {};

package/dist/components/FormEnhanceAction.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import { PluginFormActionProps } from "@rebasepro/types";
+export declare function FormEnhanceAction({ entityId, path, status, collection, formContext, openEntityMode }: PluginFormActionProps): React.JSX.Element | null;

package/dist/editor/useEditorAIController.d.ts

@@ -0,0 +1,4 @@
+import { EditorAIController } from "@rebasepro/admin";
+export declare function useEditorAIController({ getAuthToken }: {
+    getAuthToken?: () => Promise<string>;
+}): EditorAIController;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { useDataEnhancementPlugin } from "./useDataEnhancementPlugin";
+export type { DataEnhancementPluginProps } from "./useDataEnhancementPlugin";
+export * from "./editor/useEditorAIController";