vention-storage 0.5.2__tar.gz → 0.6__tar.gz

{vention_storage-0.5.2 → vention_storage-0.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: vention-storage
-Version: 0.5.2
+Version: 0.6
 Summary: A framework for storing and managing component and application data for machine apps.
 License: Proprietary
 Author: VentionCo
@@ -8,10 +8,9 @@ Requires-Python: >=3.10,<3.11
 Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
-Requires-Dist: fastapi (==0.121.1)
 Requires-Dist: python-multipart (>=0.0.20,<0.0.21)
 Requires-Dist: sqlmodel (==0.0.27)
-Requires-Dist: uvicorn (>=0.35.0,<0.36.0)
+Requires-Dist: vention-communication (>=0.2.2,<0.3.0)
 Description-Content-Type: text/markdown
 
 # Vention Storage
@@ -35,8 +34,8 @@ A framework for storing and managing component and application data with persist
 - Strong typing & validation via SQLModel
 - Lifecycle hooks before/after insert, update, delete
 - Soft delete with `deleted_at` fields
-- REST API generation with Create, Read, Update, Delete + audit
-- Health & monitoring endpoints (audit log, schema diagram)
+- ConnectRPC bundle generation with Create, Read, Update, Delete + audit
+- Health & monitoring actions (audit log, schema diagram)
 - Batch operations for insert/delete
 - Session management with smart reuse & transactions
 - Bootstrap system for one-command setup
@@ -51,7 +50,7 @@ Vention Storage is a component-based persistence layer for machine apps:
 - **ModelAccessor** → Strongly-typed Create, Read, Update, Delete interface for your SQLModel classes
 - **Hooks** → Functions that run before/after Create, Read, Update, Delete operations
 - **AuditLog** → Automatically records all data mutations
-- **Routers** → Auto-generated FastAPI endpoints for Create, Read, Update, Delete + database management
+- **RpcBundle** → Auto-generated ConnectRPC bundle with Create, Read, Update, Delete + database management actions
 
 ## ⚙️ Installation & Setup
 
@@ -76,15 +75,16 @@ pip install sqlalchemy-schemadisplay
 
 ## 🚀 Quickstart Tutorial
 
-Define a model, bootstrap storage, and get full Create, Read, Update, Delete endpoints in minutes:
+Define a model, bootstrap storage, and get full Create, Read, Update, Delete RPC actions in minutes:
 
 ```python
 from datetime import datetime
 from typing import Optional
 from sqlmodel import Field, SQLModel
-from fastapi import FastAPI
+from communication.app import VentionApp
 from storage.bootstrap import bootstrap
 from storage.accessor import ModelAccessor
+from storage.vention_communication import build_storage_bundle
 
 class User(SQLModel, table=True):
     id: Optional[int] = Field(default=None, primary_key=True)
@@ -92,18 +92,27 @@ class User(SQLModel, table=True):
     email: str
     deleted_at: Optional[datetime] = Field(default=None, index=True)
 
-app = FastAPI()
-user_accessor = ModelAccessor(User, "users")
-
+# Initialize database
 bootstrap(
-    app,
-    accessors=[user_accessor],
     database_url="sqlite:///./my_app.db",
     create_tables=True
 )
+
+# Create accessor
+user_accessor = ModelAccessor(User, "users")
+
+# Build RPC bundle and add to app
+app = VentionApp(name="my-app")
+storage_bundle = build_storage_bundle(
+    accessors=[user_accessor],
+    max_records_per_model=100,
+    enable_db_actions=True
+)
+app.add_bundle(storage_bundle)
+app.finalize()
 ```
 
-➡️ You now have Create, Read, Update, Delete, audit, backup, and CSV endpoints at `/users` and `/db`.
+➡️ You now have Create, Read, Update, Delete, audit, backup, and CSV actions available via ConnectRPC.
 
 ## 🛠 How-to Guides
 
@@ -115,35 +124,46 @@ bootstrap(
 
 product_accessor = ModelAccessor(Product, "products")
 
-bootstrap(
-    app,
+# Build bundle with multiple accessors
+storage_bundle = build_storage_bundle(
     accessors=[user_accessor, product_accessor],
-    database_url="sqlite:///./my_app.db",
-    create_tables=True,
     max_records_per_model=100,
-    enable_db_router=True
+    enable_db_actions=True
 )
+app.add_bundle(storage_bundle)
 ```
 
 ### Export to CSV
 
 ```python
-response = requests.get("http://localhost:8000/db/export.zip")
+# Using ConnectRPC client
+from communication.client import ConnectClient
+
+client = ConnectClient("http://localhost:8000")
+response = await client.call("Database_ExportZip", {})
 with open("backup.zip", "wb") as f:
-    f.write(response.content)
+    f.write(response.data)
 ```
 
 ### Backup & Restore
 
 ```python
 # Backup
-r = requests.get("http://localhost:8000/db/backup.sqlite")
-with open("backup.sqlite", "wb") as f: f.write(r.content)
+backup_response = await client.call("Database_BackupSqlite", {})
+with open(backup_response.filename, "wb") as f:
+    f.write(backup_response.data)
 
 # Restore
 with open("backup.sqlite", "rb") as f:
-    files = {"file": ("backup.sqlite", f, "application/x-sqlite3")}
-    requests.post("http://localhost:8000/db/restore", files=files)
+    restore_response = await client.call(
+        "Database_RestoreSqlite",
+        {
+            "bytes": f.read(),
+            "filename": "backup.sqlite",
+            "integrity_check": True,
+            "dry_run": False
+        }
+    )
 ```
 
 ### Use Lifecycle Hooks
@@ -190,52 +210,73 @@ user_accessor.restore(user.id, actor="admin")
 ```
 
 
-### Using the REST API
+### Using ConnectRPC Client
 
-Once bootstrapped, each `ModelAccessor` automatically exposes full CRUD endpoints.
+Once the bundle is added to your `VentionApp`, each `ModelAccessor` automatically exposes full CRUD actions via ConnectRPC.
 
-Example: interacting with the `/users` API.
+Example: interacting with the `Users` RPC actions.
 
 ```typescript
-import axios from "axios";
+import { createPromiseClient } from "@connectrpc/connect";
+import { createConnectTransport } from "@connectrpc/connect-web";
 
-const api = axios.create({
-  baseURL: "http://localhost:8000", // your backend url
-  headers: { "X-User": "operator" }, // used in audit logs
+const transport = createConnectTransport({
+  baseUrl: "http://localhost:8000",
 });
 
+const client = createPromiseClient(YourServiceClient, transport);
+
 // Create
 export async function createUser(name: string, email: string) {
-  const res = await api.post("/users/", { name, email });
-  return res.data;
+  const res = await client.usersCreateRecord({
+    record: { name, email },
+    actor: "operator"
+  });
+  return res.record;
 }
 
 // Read
 export async function getUser(id: number) {
-  const res = await api.get(`/users/${id}`);
-  return res.data;
+  const res = await client.usersGetRecord({
+    recordId: id,
+    includeDeleted: false
+  });
+  return res.record;
 }
 
 // Update
 export async function updateUser(id: number, name: string) {
-  const res = await api.put(`/users/${id}`, { name });
-  return res.data;
+  const res = await client.usersUpdateRecord({
+    recordId: id,
+    record: { name },
+    actor: "operator"
+  });
+  return res.record;
 }
 
 // Delete (soft delete if model supports deleted_at)
 export async function deleteUser(id: number) {
-  await api.delete(`/users/${id}`);
+  await client.usersDeleteRecord({
+    recordId: id,
+    actor: "operator"
+  });
 }
 
 // Restore
 export async function restoreUser(id: number) {
-  await api.post(`/users/${id}/restore`);
+  const res = await client.usersRestoreRecord({
+    recordId: id,
+    actor: "operator"
+  });
+  return res.record;
 }
 
 // List
 export async function listUsers() {
-  const res = await api.get("/users/");
-  return res.data;
+  const res = await client.usersListRecords({
+    includeDeleted: false
+  });
+  return res.records;
 }
 ```
 
@@ -246,20 +287,36 @@ export async function listUsers() {
 
 ```python
 def bootstrap(
-    app: FastAPI,
     *,
-    accessors: Iterable[ModelAccessor[Any]],
     database_url: Optional[str] = None,
     create_tables: bool = True,
-    max_records_per_model: Optional[int] = 5,
-    enable_db_router: bool = True,
 ) -> None
 ```
 
+Initialize the database engine and optionally create tables. This function performs environment setup only.
+
+### build_storage_bundle
+
+```python
+def build_storage_bundle(
+    *,
+    accessors: Sequence[ModelAccessor[Any]],
+    max_records_per_model: Optional[int] = 5,
+    enable_db_actions: bool = True,
+) -> RpcBundle
+```
+
+Build a ConnectRPC RpcBundle exposing CRUD and database utilities. Returns an `RpcBundle` that can be added to a `VentionApp` using `app.add_bundle()`.
+
 ### ModelAccessor
 
 ```python
-ModelAccessor(model: Type[ModelType], component_name: str)
+ModelAccessor(
+    model: Type[ModelType],
+    component_name: str,
+    *,
+    enable_auditing: bool = True,
+)
 ```
 
 **Read**
@@ -284,10 +341,8 @@ ModelAccessor(model: Type[ModelType], component_name: str)
 - `@accessor.before_delete()`
 - `@accessor.after_delete()`
 
-### Routers
-
-- `build_crud_router(accessor, max_records=100) -> APIRouter`
-- `build_db_router(audit_default_limit=100, audit_max_limit=1000) -> APIRouter`
+**Parameters**
+- `enable_auditing`: If `False`, disables audit logging for this accessor. Useful for models that shouldn't be audited (e.g., audit logs themselves). Defaults to `True`.
 
 ### Database Helpers
 

{vention_storage-0.5.2 → vention_storage-0.6}/README.md

@@ -19,8 +19,8 @@ A framework for storing and managing component and application data with persist
 - Strong typing & validation via SQLModel
 - Lifecycle hooks before/after insert, update, delete
 - Soft delete with `deleted_at` fields
-- REST API generation with Create, Read, Update, Delete + audit
-- Health & monitoring endpoints (audit log, schema diagram)
+- ConnectRPC bundle generation with Create, Read, Update, Delete + audit
+- Health & monitoring actions (audit log, schema diagram)
 - Batch operations for insert/delete
 - Session management with smart reuse & transactions
 - Bootstrap system for one-command setup
@@ -35,7 +35,7 @@ Vention Storage is a component-based persistence layer for machine apps:
 - **ModelAccessor** → Strongly-typed Create, Read, Update, Delete interface for your SQLModel classes
 - **Hooks** → Functions that run before/after Create, Read, Update, Delete operations
 - **AuditLog** → Automatically records all data mutations
-- **Routers** → Auto-generated FastAPI endpoints for Create, Read, Update, Delete + database management
+- **RpcBundle** → Auto-generated ConnectRPC bundle with Create, Read, Update, Delete + database management actions
 
 ## ⚙️ Installation & Setup
 
@@ -60,15 +60,16 @@ pip install sqlalchemy-schemadisplay
 
 ## 🚀 Quickstart Tutorial
 
-Define a model, bootstrap storage, and get full Create, Read, Update, Delete endpoints in minutes:
+Define a model, bootstrap storage, and get full Create, Read, Update, Delete RPC actions in minutes:
 
 ```python
 from datetime import datetime
 from typing import Optional
 from sqlmodel import Field, SQLModel
-from fastapi import FastAPI
+from communication.app import VentionApp
 from storage.bootstrap import bootstrap
 from storage.accessor import ModelAccessor
+from storage.vention_communication import build_storage_bundle
 
 class User(SQLModel, table=True):
     id: Optional[int] = Field(default=None, primary_key=True)
@@ -76,18 +77,27 @@ class User(SQLModel, table=True):
     email: str
     deleted_at: Optional[datetime] = Field(default=None, index=True)
 
-app = FastAPI()
-user_accessor = ModelAccessor(User, "users")
-
+# Initialize database
 bootstrap(
-    app,
-    accessors=[user_accessor],
     database_url="sqlite:///./my_app.db",
     create_tables=True
 )
+
+# Create accessor
+user_accessor = ModelAccessor(User, "users")
+
+# Build RPC bundle and add to app
+app = VentionApp(name="my-app")
+storage_bundle = build_storage_bundle(
+    accessors=[user_accessor],
+    max_records_per_model=100,
+    enable_db_actions=True
+)
+app.add_bundle(storage_bundle)
+app.finalize()
 ```
 
-➡️ You now have Create, Read, Update, Delete, audit, backup, and CSV endpoints at `/users` and `/db`.
+➡️ You now have Create, Read, Update, Delete, audit, backup, and CSV actions available via ConnectRPC.
 
 ## 🛠 How-to Guides
 
@@ -99,35 +109,46 @@ bootstrap(
 
 product_accessor = ModelAccessor(Product, "products")
 
-bootstrap(
-    app,
+# Build bundle with multiple accessors
+storage_bundle = build_storage_bundle(
     accessors=[user_accessor, product_accessor],
-    database_url="sqlite:///./my_app.db",
-    create_tables=True,
     max_records_per_model=100,
-    enable_db_router=True
+    enable_db_actions=True
 )
+app.add_bundle(storage_bundle)
 ```
 
 ### Export to CSV
 
 ```python
-response = requests.get("http://localhost:8000/db/export.zip")
+# Using ConnectRPC client
+from communication.client import ConnectClient
+
+client = ConnectClient("http://localhost:8000")
+response = await client.call("Database_ExportZip", {})
 with open("backup.zip", "wb") as f:
-    f.write(response.content)
+    f.write(response.data)
 ```
 
 ### Backup & Restore
 
 ```python
 # Backup
-r = requests.get("http://localhost:8000/db/backup.sqlite")
-with open("backup.sqlite", "wb") as f: f.write(r.content)
+backup_response = await client.call("Database_BackupSqlite", {})
+with open(backup_response.filename, "wb") as f:
+    f.write(backup_response.data)
 
 # Restore
 with open("backup.sqlite", "rb") as f:
-    files = {"file": ("backup.sqlite", f, "application/x-sqlite3")}
-    requests.post("http://localhost:8000/db/restore", files=files)
+    restore_response = await client.call(
+        "Database_RestoreSqlite",
+        {
+            "bytes": f.read(),
+            "filename": "backup.sqlite",
+            "integrity_check": True,
+            "dry_run": False
+        }
+    )
 ```
 
 ### Use Lifecycle Hooks
@@ -174,52 +195,73 @@ user_accessor.restore(user.id, actor="admin")
 ```
 
 
-### Using the REST API
+### Using ConnectRPC Client
 
-Once bootstrapped, each `ModelAccessor` automatically exposes full CRUD endpoints.
+Once the bundle is added to your `VentionApp`, each `ModelAccessor` automatically exposes full CRUD actions via ConnectRPC.
 
-Example: interacting with the `/users` API.
+Example: interacting with the `Users` RPC actions.
 
 ```typescript
-import axios from "axios";
+import { createPromiseClient } from "@connectrpc/connect";
+import { createConnectTransport } from "@connectrpc/connect-web";
 
-const api = axios.create({
-  baseURL: "http://localhost:8000", // your backend url
-  headers: { "X-User": "operator" }, // used in audit logs
+const transport = createConnectTransport({
+  baseUrl: "http://localhost:8000",
 });
 
+const client = createPromiseClient(YourServiceClient, transport);
+
 // Create
 export async function createUser(name: string, email: string) {
-  const res = await api.post("/users/", { name, email });
-  return res.data;
+  const res = await client.usersCreateRecord({
+    record: { name, email },
+    actor: "operator"
+  });
+  return res.record;
 }
 
 // Read
 export async function getUser(id: number) {
-  const res = await api.get(`/users/${id}`);
-  return res.data;
+  const res = await client.usersGetRecord({
+    recordId: id,
+    includeDeleted: false
+  });
+  return res.record;
 }
 
 // Update
 export async function updateUser(id: number, name: string) {
-  const res = await api.put(`/users/${id}`, { name });
-  return res.data;
+  const res = await client.usersUpdateRecord({
+    recordId: id,
+    record: { name },
+    actor: "operator"
+  });
+  return res.record;
 }
 
 // Delete (soft delete if model supports deleted_at)
 export async function deleteUser(id: number) {
-  await api.delete(`/users/${id}`);
+  await client.usersDeleteRecord({
+    recordId: id,
+    actor: "operator"
+  });
 }
 
 // Restore
 export async function restoreUser(id: number) {
-  await api.post(`/users/${id}/restore`);
+  const res = await client.usersRestoreRecord({
+    recordId: id,
+    actor: "operator"
+  });
+  return res.record;
 }
 
 // List
 export async function listUsers() {
-  const res = await api.get("/users/");
-  return res.data;
+  const res = await client.usersListRecords({
+    includeDeleted: false
+  });
+  return res.records;
 }
 ```
 
@@ -230,20 +272,36 @@ export async function listUsers() {
 
 ```python
 def bootstrap(
-    app: FastAPI,
     *,
-    accessors: Iterable[ModelAccessor[Any]],
     database_url: Optional[str] = None,
     create_tables: bool = True,
-    max_records_per_model: Optional[int] = 5,
-    enable_db_router: bool = True,
 ) -> None
 ```
 
+Initialize the database engine and optionally create tables. This function performs environment setup only.
+
+### build_storage_bundle
+
+```python
+def build_storage_bundle(
+    *,
+    accessors: Sequence[ModelAccessor[Any]],
+    max_records_per_model: Optional[int] = 5,
+    enable_db_actions: bool = True,
+) -> RpcBundle
+```
+
+Build a ConnectRPC RpcBundle exposing CRUD and database utilities. Returns an `RpcBundle` that can be added to a `VentionApp` using `app.add_bundle()`.
+
 ### ModelAccessor
 
 ```python
-ModelAccessor(model: Type[ModelType], component_name: str)
+ModelAccessor(
+    model: Type[ModelType],
+    component_name: str,
+    *,
+    enable_auditing: bool = True,
+)
 ```
 
 **Read**
@@ -268,10 +326,8 @@ ModelAccessor(model: Type[ModelType], component_name: str)
 - `@accessor.before_delete()`
 - `@accessor.after_delete()`
 
-### Routers
-
-- `build_crud_router(accessor, max_records=100) -> APIRouter`
-- `build_db_router(audit_default_limit=100, audit_max_limit=1000) -> APIRouter`
+**Parameters**
+- `enable_auditing`: If `False`, disables audit logging for this accessor. Useful for models that shouldn't be audited (e.g., audit logs themselves). Defaults to `True`.
 
 ### Database Helpers
 

{vention_storage-0.5.2 → vention_storage-0.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "vention-storage"
-version = "0.5.2"
+version = "0.6"
 description = "A framework for storing and managing component and application data for machine apps."
 authors = [ "VentionCo" ]
 readme = "README.md"
@@ -10,16 +10,9 @@ packages = [{ include = "storage", from = "src" }]
 [tool.poetry.dependencies]
 sqlmodel = "0.0.27"
 python = ">=3.10,<3.11"
-fastapi = "0.121.1"
-uvicorn = "^0.35.0"
 python-multipart = "^0.0.20"
+vention-communication= "^0.2.2"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.3.4"
-ruff = "^0.8.0"
-
-[build-system] 
-requires = [ 
-"poetry-core>=1.0.0,<2.0.0"
-] 
-build-backend = "poetry.core.masonry.api"
+ruff = "^0.8.0"