dsqlbase 0.0.1 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# dsqlbase
+
+## 0.1.0
+
+### Minor Changes
+
+- 66d5d93: **Query client and schema migration runner:**
+
+  Added:
+  - schema objects definition support for `namespace`, `table`, `domain`, and `sequence`;
+  - schema migrations runner via introspection -> reconcile;
+  - model client with crud operations factories for `create`, `findOne`, `findMany`, `update`, `delete`;
+  - sql tag with filter expressions, `sql.in, sql.eq, ...`;
+
+### Patch Changes
+
+- @dsqlbase/client@0.1.0
+- @dsqlbase/core@0.1.0
+- @dsqlbase/schema@0.1.0

package/README.md

@@ -0,0 +1,86 @@
+<div align="center">
+  <h3><strong>dsqlbase</strong></h3>
+  <p>Schema, query, and migration toolkit for AWS Aurora DSQL.</p>
+</div>
+
+---
+
+> [!CAUTION]
+> dsqlbase is in early-stage development and not suited for production environments.
+> Features may change at any time, without prior notice.
+
+dsqlbase is an ORM and migration toolkit purpose-built for [Aurora DSQL](https://aws.amazon.com/rds/aurora/dsql/). It treats DSQL's distributed-database constraints (no foreign keys, no in-place column changes, async-only index builds, etc.) as first-class — refusing unsupported DDL up front and emitting DSQL-shaped SQL by default. See the [project README](https://github.com/slsdotdev/dsqlbase#readme) for the longer motivation.
+
+## Install
+
+```bash
+npm install dsqlbase
+```
+
+## Quickstart
+
+```ts
+// schema.ts
+import { table, uuid, text, datetime, relations, hasMany, belongsTo } from "dsqlbase/schema";
+
+export const teams = table("teams", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  name: text("name").notNull(),
+  createdAt: datetime("created_at").notNull().defaultNow(),
+});
+
+export const projects = table("projects", {
+  id: uuid("id").primaryKey().defaultRandom(),
+  teamId: uuid("team_id").notNull(),
+  name: text("name").notNull(),
+});
+
+export const teamRelations = relations(teams, {
+  projects: hasMany(projects, {
+    from: [teams.columns.id],
+    to: [projects.columns.teamId],
+  }),
+});
+
+export const projectRelations = relations(projects, {
+  team: belongsTo(teams, {
+    from: [projects.columns.teamId],
+    to: [teams.columns.id],
+  }),
+});
+```
+
+```ts
+// client.ts
+import { createClient, type Session, type SQLStatement } from "dsqlbase";
+import * as schema from "./schema";
+import { Pool } from "pg";
+
+const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+
+const session: Session = {
+  async execute<T = unknown>(query: SQLStatement): Promise<T[]> {
+    const result = await pool.query(query.text, [...query.params]);
+    return result.rows as T[];
+  },
+};
+
+export const dsql = createClient({ schema, session });
+
+// Use it
+const recent = await dsql.projects.findMany({
+  orderBy: { name: "asc" },
+  limit: 10,
+  join: { team: true },
+});
+```
+
+## Links
+
+- [Repository & full docs](https://github.com/slsdotdev/dsqlbase#readme)
+- [Issues](https://github.com/slsdotdev/dsqlbase/issues)
+- [Contributing](https://github.com/slsdotdev/dsqlbase/blob/main/CONTRIBUTING.md)
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export {};
+export { sql, SQLQuery } from "@dsqlbase/core";
+export type { Session, SQLStatement } from "@dsqlbase/core";
+export { createClient, type ClientOptions, type DSQLClient } from "@dsqlbase/client";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
-export {};
+export { sql, SQLQuery } from "@dsqlbase/core";
+export { createClient } from "@dsqlbase/client";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAuC,MAAM,kBAAkB,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+export { array, bigint, bool, boolean, bytea, char, date, datetime, decimal, double, duration, float4, float8, identity, int, int2, int4, int8, interval, json, numeric, real, smallint, text, time, timestamp, uuid, varchar, domain, namespace, sequence, schema, table, relations, belongsTo, hasMany, hasOne, type DateColumnOptions, type DateTimeColumnOptions, type IdentityColumnOptions, type IntervalColumnOptions, type TimeColumnOptions, type DateValueType, type Duration, } from "@dsqlbase/schema/definition";
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,OAAO,EAEP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EAEL,SAAS,EACT,SAAS,EACT,OAAO,EACP,MAAM,EAEN,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,6BAA6B,CAAC"}

package/dist/schema.js

@@ -0,0 +1,8 @@
+export { 
+// Columns
+array, bigint, bool, boolean, bytea, char, date, datetime, decimal, double, duration, float4, float8, identity, int, int2, int4, int8, interval, json, numeric, real, smallint, text, time, timestamp, uuid, varchar, 
+// Objects
+domain, namespace, sequence, schema, table, 
+// Relations
+relations, belongsTo, hasMany, hasOne, } from "@dsqlbase/schema/definition";
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO;AACL,UAAU;AACV,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,OAAO;AACP,UAAU;AACV,MAAM,EACN,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK;AACL,YAAY;AACZ,SAAS,EACT,SAAS,EACT,OAAO,EACP,MAAM,GASP,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsqlbase",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Query client and schema definition for distributed SQL databases",
   "sideEffects": false,
   "type": "module",
@@ -39,16 +39,19 @@
     ".": {
       "default": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./*": {
+      "default": "./dist/*.js",
+      "types": "./dist/*.d.ts"
     }
   },
   "scripts": {
     "build": "tsc -b",
-    "test": "vitest run",
     "lint": "eslint src --ext .ts"
   },
   "dependencies": {
-    "@dsqlbase/core": "^0.0.1",
-    "@dsqlbase/schema": "^0.0.1",
-    "@dsqlbase/client": "^0.0.1"
+    "@dsqlbase/core": "^0.1.0",
+    "@dsqlbase/schema": "^0.1.0",
+    "@dsqlbase/client": "^0.1.0"
   }
 }