@relq/orm 0.1.2 → 0.1.4

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Yuniq Solutions
+Copyright (c) 2019-present Yuniq Solutions
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,236 +1,45 @@
-<p align="center">
-  <!-- <img src="https://relq.dev/logo.svg" alt="Relq" width="280" /> -->
-  <h1 align="center">Relq ORM</h1>
-</p>
-
-<p align="center">
-  <b>The runtime engine for Relq.</b><br/>
-  Query, mutate, and transact with end-to-end type inference across PostgreSQL, SQLite, and MySQL.
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@relq/orm"><img src="https://img.shields.io/npm/v/@relq/orm.svg" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/@relq/orm"><img src="https://img.shields.io/npm/dm/@relq/orm.svg" alt="npm downloads" /></a>
-  <a href="https://github.com/yuniqsolutions/relq/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@relq/orm.svg" alt="license" /></a>
-</p>
-
-<p align="center">
-  <a href="https://relq.dev/docs">Documentation</a> &bull;
-  <a href="https://relq.dev/docs/getting-started">Getting Started</a> &bull;
+<div align="center">
+  <a href="https://relq.io">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://relq.io/logo-dark.svg" />
+      <img alt="Relq" src="https://relq.io/logo-light.svg" width="140" />
+    </picture>
+  </a>
+  <h3><code>@relq/orm</code></h3>
+  <p>The runtime engine for Relq.<br/><strong>End-to-end type inference. Every query. Every dialect.</strong></p>
+  <a href="https://relq.io/docs">Docs</a>
+  <span>&nbsp;&middot;&nbsp;</span>
+  <a href="https://relq.io/docs/getting-started">Get Started</a>
+  <span>&nbsp;&middot;&nbsp;</span>
   <a href="https://github.com/yuniqsolutions/relq">GitHub</a>
-</p>
-
----
-
-## Install
-
-```bash
-npm install @relq/orm
-# Schema definition & CLI (dev dependency)
-npm install -D @relq/kit
-```
-
-## Quick Start
-
-```typescript
-import { Relq } from '@relq/orm'
-import { schema } from './db/schema'
-
-const db = new Relq(schema, 'postgres', {
-  host: 'localhost',
-  database: 'myapp',
-  user: 'postgres',
-  password: 'password',
-})
-
-await db.initialize()
-```
-
-## Queries
-
-Every query is fully typed. Column names, return types, and conditions are all inferred from your schema.
-
-### Select
-
-```typescript
-// All columns
-const users = await db.table.users.select().all()
-
-// Specific columns — return type narrows automatically
-const names = await db.table.users
-  .select('id', 'name', 'email')
-  .where(q => q.equal('status', 'active'))
-  .orderBy('createdAt', 'DESC')
-  .limit(10)
-  .all()
-
-// Single row
-const user = await db.table.users
-  .select()
-  .where(q => q.equal('id', userId))
-  .get()
-```
-
-### Insert
-
-```typescript
-// Single row
-await db.table.users
-  .insert({ name: 'Alice', email: 'alice@example.com' })
-  .returning('*')
-  .run()
-
-// Bulk insert with upsert
-await db.table.users
-  .insert(batchOfUsers)
-  .onConflict('email')
-  .doUpdate({ name: 'excluded.name', updatedAt: PG.now() })
-  .run()
-```
-
-### Update
-
-```typescript
-await db.table.users
-  .update({ status: 'inactive', updatedAt: PG.now() })
-  .where(q => q.equal('id', userId))
-  .returning('id', 'status')
-  .run()
-```
-
-### Delete
-
-```typescript
-await db.table.users
-  .delete()
-  .where(q => q.equal('id', userId))
-  .returning('*')
-  .run()
-```
-
-### Count
-
-```typescript
-const total = await db.table.users.count().get()
-
-const grouped = await db.table.users
-  .count()
-  .group('active', q => q.equal('status', 'active'))
-  .group('inactive', q => q.equal('status', 'inactive'))
-  .get()
-// { active: 142, inactive: 37 }
-```
-
-## Joins
-
-Type-safe joins with automatic foreign key detection.
-
-```typescript
-const orders = await db.table.orders
-  .select('id', 'total')
-  .join('users')
-  .select('name', 'email')
-  .where(q => q.gte('total', 100))
-  .all()
-// Array<{ id, total, users: { name, email } }>
-```
-
-## Computed Columns & Aggregates
-
-```typescript
-const report = await db.table.users
-  .select('id', 'name')
-  .include((a, t) => ({
-    orderCount: a.count(t.orders.id),
-    totalSpent: a.sum(t.orders.amount),
-  }))
-  .all()
-// Array<{ id, name, orderCount: number, totalSpent: number }>
-```
+  <span>&nbsp;&middot;&nbsp;</span>
+  <a href="https://discord.gg/relq">Discord</a>
+</div>
 
-## Transactions
-
-```typescript
-const result = await db.transaction(async tx => {
-  const user = await tx.table.users
-    .insert({ name: 'Bob', email: 'bob@example.com' })
-    .returning('*')
-    .run()
-
-  await tx.table.logs
-    .insert({ userId: user.id, action: 'signup' })
-    .run()
-
-  return user
-})
-```
+<br />
 
-## Pagination
+<div align="center">
+  <a href="https://www.npmjs.com/package/@relq/orm"><img src="https://img.shields.io/npm/v/@relq/orm?style=flat&color=3178c6&label=npm" alt="npm" /></a>
+  <a href="https://www.npmjs.com/package/@relq/orm"><img src="https://img.shields.io/npm/dm/@relq/orm?style=flat" alt="downloads" /></a>
+  <a href="https://github.com/yuniqsolutions/relq/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@relq/orm?style=flat" alt="license" /></a>
+  <a href="https://www.typescriptlang.org"><img src="https://img.shields.io/badge/TypeScript-100%25-3178c6?style=flat" alt="typescript" /></a>
+</div>
 
-```typescript
-const page = await db.table.posts
-  .select()
-  .orderBy('createdAt', 'DESC')
-  .pagination({ page: 2, perPage: 20 })
-
-// page.data — the rows
-// page.pagination.total — total count
-// page.pagination.totalPages
-// page.pagination.hasNext / hasPrev
-```
-
-## Cursor Iteration
-
-Process large datasets without loading everything into memory.
-
-```typescript
-await db.table.events
-  .select()
-  .where(q => q.gte('createdAt', startDate))
-  .each(async (event, index) => {
-    await processEvent(event)
-  })
-```
+---
 
-## Pub/Sub
+`@relq/orm` is the runtime query engine. You write `db.table.users.select('id', 'email')` and TypeScript knows the return type is `{ id: string; email: string }[]`. Change a column in your schema and every query updates instantly. No codegen. No CLI-generated types.
 
-Real-time notifications over PostgreSQL `LISTEN/NOTIFY`.
+Supports **11 PostgreSQL dialects** (PostgreSQL, Supabase, Neon, AlloyDB, Aurora, Citus, Timescale, Nile, CockroachDB, YugabyteDB, AWS DSQL) and **3 MySQL dialects** (MySQL, MariaDB, PlanetScale).
 
-```typescript
-await db.subscribe<{ userId: string }>('user_events', payload => {
-  console.log('New event for', payload.userId)
-})
-```
+Each dialect only exposes the features it supports. TypeScript enforces this — you cannot call `subscribe()` on AWS DSQL or `setTenant()` on standard PostgreSQL.
 
-## Raw SQL
+### Install
 
-Escape hatch when you need it.
-
-```typescript
-const results = await db.raw('SELECT * FROM users WHERE id = $1', userId)
+```bash
+npm install @relq/orm
+npm install -D @relq/kit    # schema definition + CLI
 ```
 
-## Supported Dialects
-
-| Dialect | Status |
-|---------|--------|
-| PostgreSQL | Stable |
-| Nile (multi-tenant) | Stable |
-| CockroachDB | Stable |
-| AWS Aurora DSQL | Stable |
-| SQLite | Coming soon |
-| Turso (libSQL) | Coming soon |
-| MySQL | Coming soon |
-| PlanetScale | Coming soon |
-
-## Ecosystem
-
-| Package | Purpose |
-|---------|---------|
-| **@relq/orm** | Runtime — queries, mutations, transactions |
-| **@relq/kit** | Tooling — schema definition, CLI, migrations |
-| **@relq/zod** | Validation — Zod schema generation *(coming soon)* |
-
-## License
+### Documentation
 
-[MIT](https://github.com/yuniqsolutions/relq/blob/main/LICENSE)
+Visit [relq.io/docs](https://relq.io/docs) for the full API reference, guides, and examples.

package/dist/cjs/addon/cursor.cjs

@@ -367,9 +367,10 @@ var require_postgres_interval = __commonJS((exports2, module2) => {
 
 // node_modules/postgres-bytea/index.js
 var require_postgres_bytea = __commonJS((exports2, module2) => {
+  var bufferFrom = Buffer.from || Buffer;
   module2.exports = function parseBytea(input) {
     if (/^\\x/.test(input)) {
-      return new Buffer(input.substr(2), "hex");
+      return bufferFrom(input.substr(2), "hex");
     }
     var output = "";
     var i = 0;
@@ -393,7 +394,7 @@ var require_postgres_bytea = __commonJS((exports2, module2) => {
         }
       }
     }
-    return new Buffer(output, "binary");
+    return bufferFrom(output, "binary");
   };
 });
 
@@ -1461,7 +1462,7 @@ var require_pg_cursor = __commonJS((exports2, module2) => {
   module2.exports = Cursor;
 });
 
-// src/orm/utils/addon/pg/cursor.ts
+// src/orm/pg/utils/addon/pg/cursor.ts
 var exports_cursor = {};
 __export(exports_cursor, {
   default: () => esm_default