@an5/orm 1.0.8 → 1.0.9

package/README.md

@@ -1,175 +1,167 @@
-# @an5/orm
-
-SQL Server ORM. Proxy client. CRUD. Vector search. Middleware. Raw queries. Transactions.
-
-## 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.
-
-## Quick Start
-
-### Installation
-
-#### TypeScript / Node.js
-```bash
-npm install @an5/orm
-```
-
-#### Python
-```bash
-pip install an5-orm
-```
-
-### Configuration
-
-```bash
-cp .env.example .env
-# Edit .env. Set DATABASE_URL.
-```
-
-### Development Commands
-
-Run from the `an5Orm/` repository directory (no separate CLI binary is shipped):
-
-```bash
-# Generate client code from schema
-npm run generate
-
-# Push schema to database
-npm run db:push
-
-# Pull schema from database
-npm run db:pull
-
-# Seed database
-npm run db:seed
-
-# Compare schema with database
-npm run db:migrate diff
-
-# Generate migration SQL / show status
-npm run db:migrate:generate
-npm run db:migrate:status
-
-# Run tests
-npm test
-```
-
-## Usage
-
-```typescript
-import { An5ORM } from '@an5/orm';
-
-const db = new An5ORM();
-```
-
-The default executor reads the `DATABASE_URL` environment variable. Schema metadata
-(model→table mapping, relations, field types) is auto-loaded from the ORM's own generated
-metadata file `an5Metadata.ts` (created by `npm run generate`, configured via
-`outputs.typescript.ormMetadataFile`). The ORM owns this metadata locally — it never
-imports from the generated client package (the client is generated *from* the ORM).
-
-To provide metadata explicitly instead:
-
-```typescript
-import { An5ORM } from '@an5/orm';
-import { modelToTable, relationMap, modelFields } from './an5Metadata';
-
-const db = new An5ORM(undefined, { modelToTable, relationMap, modelFields });
-```
-
-// CRUD 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',
-});
-
-// 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 } });
-});
-
-// Raw Queries
-const results = await db.$queryRaw`SELECT * FROM users WHERE id = ${id}`;
-```
-
-## Schema Definition
-
-Schema files: `.an5`. Path: `an5Schema/`. SQL Server types.
-
-```an5
-model User {
-  id        NVARCHAR(1000) @id @default(uuid())
-  email     NVARCHAR(255)  @unique
-  name      NVARCHAR(255)?
-  createdAt DATETIME2      @default(now())
-  orders    Order[]
-
-  @@map("users")
-}
-
-model Order {
-  id        NVARCHAR(1000) @id @default(uuid())
-  userId    NVARCHAR(1000)
-  total     INT            @default(0)
-  user      User           @relation(fields: [userId], references: [id])
-
-  @@map("orders")
-}
-```
-
-## 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
+# @an5/orm
+
+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
+
+- **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
+
+```bash
+npm install @an5/orm @an5/adapters
+```
+
+### 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,
+  },
+};
+```
+
+Configure your environment variables in `.env`:
+
+```env
+DATABASE_URL=sqlserver://localhost:1433;database=mydb;user=sa;password=Secret123!;encrypt=false
+```
+
+### CLI Commands
+
+```bash
+# Generate client code from .an5 schemas
+npm run generate
+
+# Push schema directly to database
+npm run db:push
+
+# Pull database schema into .an5 files
+npm run db:pull
+
+# Check schema diff
+npm run db:migrate diff
+
+# Generate new migration script
+npm run db:migrate:generate
+
+# 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
+```
+
+## Runtime Database Usage (via `@an5/adapters`)
+
+To connect to your database and perform queries, use `@an5/adapters`:
+
+```typescript
+import { createAn5Adapter } from '@an5/adapters';
+
+const db = createAn5Adapter({
+  connectionString: process.env.DATABASE_URL!,
+});
+
+// Connect to database
+await db.$connect();
+
+// Model operations
+const users = await db.user.findMany({
+  where: { email: { contains: '@example.com' } },
+  orderBy: { createdAt: 'desc' },
+  take: 10,
+});
+
+// Create record
+const newUser = await db.user.create({
+  data: {
+    email: 'alex@example.com',
+    name: 'Alex',
+  },
+});
+
+// Transactions
+await db.$transaction(async (tx) => {
+  await tx.exec('UPDATE Users SET active = 1 WHERE id = @p_0', { p_0: 'u1' });
+});
+
+// Disconnect
+await db.$disconnect();
+```
+
+## Schema Definition (`.an5`)
+
+```an5
+model User {
+  id        NVARCHAR(1000) @id @default(uuid())
+  email     NVARCHAR(255)  @unique
+  name      NVARCHAR(255)?
+  createdAt DATETIME2      @default(now())
+  orders    Order[]
+
+  @@map("users")
+}
+
+model Order {
+  id        NVARCHAR(1000) @id @default(uuid())
+  userId    NVARCHAR(1000)
+  total     INT            @default(0)
+  user      User           @relation(fields: [userId], references: [id])
+
+  @@map("orders")
+}
+```
+
+## License
+
+MIT

package/dist/an5Metadata.js

@@ -3,27 +3,91 @@
 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,5 +1,61 @@
+import { An5Adapter } from "@an5/adapters";
 import { An5Metadata } from "./metadata";
-type ExecutorFn = (queryText: string, params?: Record<string, any>) => Promise<any[]>;
+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;
@@ -8,12 +64,42 @@ 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;
     readonly metadata: An5Metadata;
-    constructor(customExecutor?: ExecutorFn | undefined, 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>;
@@ -26,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;