@an5/orm 1.0.7 → 1.0.9

package/README.md

@@ -1,104 +1,145 @@
 # @an5/orm
 
-SQL Server ORM. Proxy client. CRUD. Vector search. Middleware. Raw queries. Transactions.
+The Schema, Code Generator, and Migration Toolkit for the AN5 ecosystem.
+
+## Overview
+
+`@an5/orm` provides core schema parsing, multi-language code generation (TypeScript, Python, .NET C#, Golang), database introspection (`pull`), schema deployment (`push`), and automated database migrations.
+
+Runtime database connections, query building, transactions, and multi-database drivers (MSSQL, PostgreSQL, MySQL, SQLite, Google Sheets) are powered by **[@an5/adapters](https://github.com/an5ORM/an5/tree/main/an5Adapters)**.
 
 ## Features
 
--   **Proxy Client.** Model access. `db.modelName` syntax.
--   **CRUD.** `findMany`, `findFirst`, `findUnique`, `create`, `update`, `delete`, `upsert`.
--   **Advanced Queries.** OR/AND, nested relations, aggregates, `groupBy`.
--   **Vector Search.** Native SQL Server `VECTOR_DISTANCE`. In-memory fallback.
--   **Middleware.** Hook ORM operations: logging, auth, validation.
--   **Raw Queries.** `$queryRaw`, `$executeRaw`. Auto `NOLOCK`.
--   **Transactions.** `$transaction`. Rollback support.
--   **Schema Generator.** Parse `.an5` files. Generate TypeScript/Python/.NET code.
+- **Schema Definition:** Define models and relationships using concise `.an5` syntax with native database types.
+- **Multi-Language Generator:** Generate typed clients and entity models for TypeScript, Python, .NET (C#), and Golang.
+- **Database Introspection (`db:pull`):** Inspect an existing database schema and generate matching `.an5` models.
+- **Direct Schema Push (`db:push`):** Synchronize `.an5` schema definitions directly to the database.
+- **Automated Migrations (`db:migrate`):** Diff schema against database, generate up/down migration SQL scripts, apply, rollback, and check migration status.
+- **Seeding & Cleanup:** Generic runner for project seed scripts (`seed.ts`/`seed.js`) and database cleanup.
+- **Seamless Adapter Integration:** Built-in connection support via `@an5/adapters`.
 
 ## Quick Start
 
 ### Installation
 
-#### TypeScript / Node.js
 ```bash
-npm install @an5/orm
+npm install @an5/orm @an5/adapters
 ```
 
-#### Python
-```bash
-pip install an5-orm
+### Configuration
+
+Create `an5Orm.config.js` in your project root:
+
+```javascript
+module.exports = {
+  // Schema directory (default: 'an5Schema')
+  schemaDir: 'an5Schema',
+
+  // Generated client outputs
+  outputs: {
+    typescript: {
+      outputDir: 'an5Client/typescript',
+      metadataFile: 'an5Client/typescript/an5Metadata.ts',
+    },
+    python: {
+      outputDir: 'an5Client/python',
+      metadataFile: 'an5Client/python/an5_metadata.py',
+    },
+    dotnet: {
+      outputDir: 'an5Client/dotnet',
+    },
+    golang: {
+      outputDir: 'an5Client/golang',
+    },
+  },
+
+  // Database pull options
+  pull: {
+    exclude: ['^__', '^sys\\.', '^migrations'],
+    preserveRelations: true,
+  },
+};
 ```
 
-### Configuration
+Configure your environment variables in `.env`:
 
-```bash
-cp .env.example .env
-# Edit .env. Set DATABASE_URL.
+```env
+DATABASE_URL=sqlserver://localhost:1433;database=mydb;user=sa;password=Secret123!;encrypt=false
 ```
 
-### Development Commands
+### CLI Commands
 
 ```bash
-# Generate code from schema
-npx an5 generate
+# Generate client code from .an5 schemas
+npm run generate
 
-# Push schema to database
-npx an5 db:push
+# Push schema directly to database
+npm run db:push
 
-# Pull schema from database
-npx an5 db:pull
+# Pull database schema into .an5 files
+npm run db:pull
 
-# Seed database
-npx an5 db:seed
+# Check schema diff
+npm run db:migrate diff
 
-# Compare schema with database
-npx an5 db:migrate diff
+# Generate new migration script
+npm run db:migrate:generate
 
-# Run tests
-npm test
+# Apply pending migrations
+npm run db:migrate:apply
+
+# Rollback last migration
+npm run db:migrate:rollback
+
+# View migration status
+npm run db:migrate:status
+
+# Run database seed script
+npm run db:seed
+
+# Clean up database tables
+npm run db:cleanup
 ```
 
-## Usage
+## Runtime Database Usage (via `@an5/adapters`)
+
+To connect to your database and perform queries, use `@an5/adapters`:
 
 ```typescript
-import { An5ORM } from '@an5/orm';
+import { createAn5Adapter } from '@an5/adapters';
+
+const db = createAn5Adapter({
+  connectionString: process.env.DATABASE_URL!,
+});
 
-const db = new An5ORM();
+// Connect to database
+await db.$connect();
 
-// CRUD Operations
+// Model operations
 const users = await db.user.findMany({
   where: { email: { contains: '@example.com' } },
   orderBy: { createdAt: 'desc' },
   take: 10,
 });
 
-const user = await db.user.create({
-  data: { email: 'john@example.com', name: 'John' },
-});
-
-// Relations
-const orders = await db.user.findMany({
-  include: { orders: true },
-});
-
-// Vector Search
-const similar = await db.document.vectorSearch({
-  vector: [0.1, 0.2, 0.3],
-  take: 5,
-  distanceMetric: 'cosine',
+// Create record
+const newUser = await db.user.create({
+  data: {
+    email: 'alex@example.com',
+    name: 'Alex',
+  },
 });
 
 // Transactions
 await db.$transaction(async (tx) => {
-  const user = await tx.user.create({ data: { email: 'jane@example.com' } });
-  await tx.order.create({ data: { userId: user.id, total: 100 } });
+  await tx.exec('UPDATE Users SET active = 1 WHERE id = @p_0', { p_0: 'u1' });
 });
 
-// Raw Queries
-const results = await db.$queryRaw`SELECT * FROM users WHERE id = ${id}`;
+// Disconnect
+await db.$disconnect();
 ```
 
-## Schema Definition
-
-Schema files: `.an5`. Path: `an5Schema/`. SQL Server types.
+## Schema Definition (`.an5`)
 
 ```an5
 model User {
@@ -121,33 +162,6 @@ model Order {
 }
 ```
 
-## Supported SQL Server Types
-
-Type mapping: `.an5` to TypeScript.
-
-| Schema Type | TypeScript |
-|-------------|------------|
-| `NVARCHAR(n)`, `VARCHAR(n)`, `CHAR(n)`, `TEXT` | `string` |
-| `INT`, `SMALLINT`, `TINYINT`, `FLOAT`, `REAL`, `DECIMAL`, `NUMERIC` | `number` |
-| `BIGINT` | `number \| bigint` |
-| `BIT` | `boolean` |
-| `DATETIME`, `DATETIME2`, `DATE`, `TIME` | `Date` |
-| `UNIQUEIDENTIFIER` | `string` |
-| `VARBINARY`, `BINARY`, `IMAGE` | `Buffer` |
-
-## Testing
-
-```bash
-# Unit tests
-node test/unit.test.js
-
-# Generator tests
-node test/generator.test.js
-
-# Smoke test
-npm test
-```
-
 ## License
 
 MIT

package/dist/an5Metadata.d.ts

@@ -0,0 +1,10 @@
+import type { RelationDef } from "./metadata";
+export declare const modelToTable: Record<string, string>;
+export declare const modelDescriptions: Record<string, string | undefined>;
+export declare const modelFields: Record<string, Record<string, {
+    ts: string;
+    sql: string;
+    description?: string;
+}>>;
+export declare const relationMap: Record<string, Record<string, RelationDef>>;
+//# sourceMappingURL=an5Metadata.d.ts.map

package/dist/an5Metadata.js

@@ -0,0 +1,93 @@
+"use strict";
+// This file is auto-generated. Do not edit directly.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relationMap = exports.modelFields = exports.modelDescriptions = exports.modelToTable = void 0;
+exports.modelToTable = {
+    EmbeddingConfig: "[dbo].[embeddingconfigs]",
+    embeddingConfig: "[dbo].[embeddingconfigs]",
+    EmbeddingConfigs: "[dbo].[embeddingconfigs]",
+    embeddingConfigs: "[dbo].[embeddingconfigs]",
+    embedding_config: "[dbo].[embeddingconfigs]",
+    embedding_configs: "[dbo].[embeddingconfigs]",
+    LlmConfig: "[dbo].[llmconfigs]",
+    llmConfig: "[dbo].[llmconfigs]",
+    LlmConfigs: "[dbo].[llmconfigs]",
+    llmConfigs: "[dbo].[llmconfigs]",
+    llm_config: "[dbo].[llmconfigs]",
+    llm_configs: "[dbo].[llmconfigs]",
+    User: "[dbo].[users]",
+    user: "[dbo].[users]",
+    Users: "[dbo].[users]",
+    users: "[dbo].[users]",
+    Order: "[dbo].[orders]",
+    order: "[dbo].[orders]",
+    Orders: "[dbo].[orders]",
+    orders: "[dbo].[orders]",
+};
+exports.modelDescriptions = {
+    EmbeddingConfig: "Embedding provider configuration. Stores API keys and model settings for RAG features.",
+    embeddingConfig: "Embedding provider configuration. Stores API keys and model settings for RAG features.",
+    EmbeddingConfigs: "Embedding provider configuration. Stores API keys and model settings for RAG features.",
+    embeddingConfigs: "Embedding provider configuration. Stores API keys and model settings for RAG features.",
+    embedding_config: "Embedding provider configuration. Stores API keys and model settings for RAG features.",
+    embedding_configs: "Embedding provider configuration. Stores API keys and model settings for RAG features.",
+    LlmConfig: "LLM provider configuration. Stores API keys and model settings for AI features.",
+    llmConfig: "LLM provider configuration. Stores API keys and model settings for AI features.",
+    LlmConfigs: "LLM provider configuration. Stores API keys and model settings for AI features.",
+    llmConfigs: "LLM provider configuration. Stores API keys and model settings for AI features.",
+    llm_config: "LLM provider configuration. Stores API keys and model settings for AI features.",
+    llm_configs: "LLM provider configuration. Stores API keys and model settings for AI features.",
+    User: "Represents a registered user in the database.",
+    user: "Represents a registered user in the database.",
+    Users: "Represents a registered user in the database.",
+    users: "Represents a registered user in the database.",
+    Order: "Represents a customer order in the system.",
+    order: "Represents a customer order in the system.",
+    Orders: "Represents a customer order in the system.",
+    orders: "Represents a customer order in the system.",
+};
+exports.modelFields = {
+    EmbeddingConfig: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "Embedding provider: openai, cohere, custom" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the embedding service" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. text-embedding-3-small" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    embeddingConfig: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "Embedding provider: openai, cohere, custom" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the embedding service" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. text-embedding-3-small" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    EmbeddingConfigs: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "Embedding provider: openai, cohere, custom" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the embedding service" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. text-embedding-3-small" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    embeddingConfigs: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "Embedding provider: openai, cohere, custom" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the embedding service" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. text-embedding-3-small" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    embedding_config: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "Embedding provider: openai, cohere, custom" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the embedding service" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. text-embedding-3-small" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    embedding_configs: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "Embedding provider: openai, cohere, custom" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the embedding service" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. text-embedding-3-small" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    LlmConfig: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "LLM provider: openai, gemini, custom, azure" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the LLM provider" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. gpt-4o, gemini-2.5-flash" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    llmConfig: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "LLM provider: openai, gemini, custom, azure" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the LLM provider" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. gpt-4o, gemini-2.5-flash" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    LlmConfigs: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "LLM provider: openai, gemini, custom, azure" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the LLM provider" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. gpt-4o, gemini-2.5-flash" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    llmConfigs: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "LLM provider: openai, gemini, custom, azure" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the LLM provider" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. gpt-4o, gemini-2.5-flash" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    llm_config: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "LLM provider: openai, gemini, custom, azure" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the LLM provider" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. gpt-4o, gemini-2.5-flash" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    llm_configs: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key" }, provider: { ts: "string", sql: "NVARCHAR(100)", description: "LLM provider: openai, gemini, custom, azure" }, apiKey: { ts: "string", sql: "NVARCHAR(4000)", description: "API key for the LLM provider" }, model: { ts: "string?", sql: "NVARCHAR(500)", description: "Model name, e.g. gpt-4o, gemini-2.5-flash" }, endpoint: { ts: "string?", sql: "NVARCHAR(2000)", description: "Custom endpoint URL" }, isActive: { ts: "boolean", sql: "BIT", description: "Whether this config is active" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Creation timestamp" }, updatedAt: { ts: "Date", sql: "DATETIME2", description: "Last update timestamp" } },
+    User: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the User table (auto-generated UUID)" }, email: { ts: "string", sql: "NVARCHAR(255)", description: "Unique email address used for login and notifications" }, name: { ts: "string?", sql: "NVARCHAR(255)", description: "Display name of the user" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Timestamp when the user profile was created" } },
+    user: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the User table (auto-generated UUID)" }, email: { ts: "string", sql: "NVARCHAR(255)", description: "Unique email address used for login and notifications" }, name: { ts: "string?", sql: "NVARCHAR(255)", description: "Display name of the user" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Timestamp when the user profile was created" } },
+    Users: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the User table (auto-generated UUID)" }, email: { ts: "string", sql: "NVARCHAR(255)", description: "Unique email address used for login and notifications" }, name: { ts: "string?", sql: "NVARCHAR(255)", description: "Display name of the user" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Timestamp when the user profile was created" } },
+    users: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the User table (auto-generated UUID)" }, email: { ts: "string", sql: "NVARCHAR(255)", description: "Unique email address used for login and notifications" }, name: { ts: "string?", sql: "NVARCHAR(255)", description: "Display name of the user" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "Timestamp when the user profile was created" } },
+    Order: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the Order table (auto-generated UUID)" }, userId: { ts: "string", sql: "NVARCHAR(1000)", description: "Foreign key linking to the User model who placed the order" }, total: { ts: "number", sql: "INT", description: "Total cost amount of the order" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "The date and time when the order was created." } },
+    order: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the Order table (auto-generated UUID)" }, userId: { ts: "string", sql: "NVARCHAR(1000)", description: "Foreign key linking to the User model who placed the order" }, total: { ts: "number", sql: "INT", description: "Total cost amount of the order" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "The date and time when the order was created." } },
+    Orders: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the Order table (auto-generated UUID)" }, userId: { ts: "string", sql: "NVARCHAR(1000)", description: "Foreign key linking to the User model who placed the order" }, total: { ts: "number", sql: "INT", description: "Total cost amount of the order" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "The date and time when the order was created." } },
+    orders: { id: { ts: "string", sql: "NVARCHAR(1000)", description: "Primary key for the Order table (auto-generated UUID)" }, userId: { ts: "string", sql: "NVARCHAR(1000)", description: "Foreign key linking to the User model who placed the order" }, total: { ts: "number", sql: "INT", description: "Total cost amount of the order" }, createdAt: { ts: "Date", sql: "DATETIME2", description: "The date and time when the order was created." } },
+};
+exports.relationMap = {
+    EmbeddingConfig: {},
+    embeddingConfig: {},
+    EmbeddingConfigs: {},
+    embeddingConfigs: {},
+    embedding_config: {},
+    embedding_configs: {},
+    LlmConfig: {},
+    llmConfig: {},
+    LlmConfigs: {},
+    llmConfigs: {},
+    llm_config: {},
+    llm_configs: {},
+    User: {},
+    user: {},
+    Users: {},
+    users: {},
+    Order: {},
+    order: {},
+    Orders: {},
+    orders: {},
+};
+//# sourceMappingURL=an5Metadata.js.map

package/dist/an5Orm.d.ts

@@ -1,4 +1,61 @@
-type ExecutorFn = (queryText: string, params?: Record<string, any>) => Promise<any[]>;
+import { An5Adapter } from "@an5/adapters";
+import { An5Metadata } from "./metadata";
+type ExecutorFn = ((queryText: string, params?: Record<string, any>) => Promise<any[]>) & {
+    executeRaw?: (queryText: string, params?: Record<string, any>) => Promise<number>;
+    transaction?: <R>(fn: (txExecutor: ExecutorFn) => Promise<R>, options?: {
+        timeout?: number;
+    }) => Promise<R>;
+    beginTransaction?: () => Promise<InteractiveTransactionExecutor>;
+};
+type InteractiveTransactionExecutor = {
+    executor: ExecutorFn;
+    commit: () => Promise<void>;
+    rollback: () => Promise<void>;
+};
+export declare class TableClient<T = any> {
+    private modelName;
+    private executor;
+    private orm;
+    constructor(modelName: string, tableName: string, executor: ExecutorFn, orm: An5ORM);
+    private tableName;
+    private executeRaw;
+    findMany(args?: any): Promise<T[]>;
+    findFirst(args?: any): Promise<T | null>;
+    findUnique(args?: any): Promise<T | null>;
+    count(args?: any): Promise<number>;
+    private scopedRelationWhere;
+    private handleNestedWrites;
+    create(args: any): Promise<T>;
+    update(args: any): Promise<T>;
+    updateMany(args: any): Promise<{
+        count: number;
+    }>;
+    delete(args: any): Promise<T>;
+    deleteMany(args?: any): Promise<{
+        count: number;
+    }>;
+    vectorSearch(args: {
+        vector: number[];
+        take?: number;
+        where?: any;
+        include?: any;
+        vectorField?: string;
+        distanceMetric?: 'cosine' | 'euclidean' | 'dot';
+        vectorElementType?: 'float32' | 'float16' | 'uint8';
+    }): Promise<(T & {
+        distance: number;
+    })[]>;
+    createMany(args: {
+        data: any[];
+        skipDuplicates?: boolean;
+    }): Promise<{
+        count: number;
+    }>;
+    aggregate(args: any): Promise<any>;
+    groupBy(args: any): Promise<any[]>;
+    private sequentialUpsert;
+    upsert(args: any): Promise<T>;
+}
 export interface MiddlewareParams {
     model?: string;
     action: string;
@@ -7,12 +64,44 @@ export interface MiddlewareParams {
 }
 export type MiddlewareNext = (params: MiddlewareParams) => Promise<any>;
 export type Middleware = (params: MiddlewareParams, next: MiddlewareNext) => Promise<any>;
+export declare class ViewClient<T = any> {
+    viewName: string;
+    rawTableName: string;
+    executor: ExecutorFn;
+    orm?: An5ORM | undefined;
+    private tableClient;
+    constructor(viewName: string, rawTableName: string, executor: ExecutorFn, orm?: An5ORM | undefined);
+    findMany(args?: any): Promise<T[]>;
+    findFirst(args?: any): Promise<T | null>;
+    findUnique(args?: any): Promise<T | null>;
+    count(args?: any): Promise<number>;
+    aggregate(args?: any): Promise<any>;
+    groupBy(args?: any): Promise<any[]>;
+    vectorSearch(args: any): Promise<T[]>;
+    create(): Promise<never>;
+    createMany(): Promise<never>;
+    update(): Promise<never>;
+    updateMany(): Promise<never>;
+    delete(): Promise<never>;
+    deleteMany(): Promise<never>;
+    upsert(): Promise<never>;
+}
 export declare class An5ORM {
-    private customExecutor?;
+    private readonly inTransaction;
+    private transactionControl?;
     [key: string]: any;
     private middlewares;
-    constructor(customExecutor?: ExecutorFn | undefined);
+    readonly metadata: An5Metadata;
+    private customExecutor?;
+    constructor(customExecutor?: ExecutorFn | An5Adapter | any, metadata?: An5Metadata, inTransaction?: boolean, transactionControl?: Pick<InteractiveTransactionExecutor, "commit" | "rollback"> | undefined);
+    table(name: string): TableClient;
+    view(name: string): ViewClient;
+    $view(name: string): ViewClient;
+    $queryProc<T = any>(procName: string, params?: Record<string, any> | any[]): Promise<T[]>;
+    $executeProc(procName: string, params?: Record<string, any> | any[]): Promise<number>;
+    $queryFunction<T = any>(fnName: string, params?: Record<string, any> | any[]): Promise<T[]>;
     $use(middleware: Middleware): void;
+    parseWhere(modelName: string, where: any, params: Record<string, any>, prefix?: string): string;
     _executeMiddleware(params: MiddlewareParams, finalAction: (params: MiddlewareParams) => Promise<any>): Promise<any>;
     $connect(): Promise<void>;
     $disconnect(): Promise<void>;
@@ -23,6 +112,9 @@ export declare class An5ORM {
     $transaction<R>(fn: ((tx: any) => Promise<R>) | Promise<any>[], options?: {
         timeout?: number;
     }): Promise<any>;
+    $begin(): Promise<any>;
+    $commit(): Promise<void>;
+    $rollback(): Promise<void>;
 }
 export declare const an5Orm: An5ORM;
 export default an5Orm;