@zeroxsolutions/db 9.2.0 → 9.3.1

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## 9.3.1 (2026-09-29)
+
+This was a version bump only for @zeroxsolutions/db to align it with other projects, there were no code changes.
+
+## 9.3.0 (2026-09-28)
+
+### 🚀 Features
+
+- **db:** read a table's relationship names off the schema ([2a8045f](https://github.com/zeroxsolutions/zeroxsolutions/commit/2a8045f))
+
+### ❤️ Thank You
+
+- Claude Opus 5.5 (1M context)
+- Lương Văn Tú
+
 ## 9.2.0 (2026-09-28)
 
 ### 🚀 Features

package/README.md

@@ -387,6 +387,10 @@ const condition = buildFilterConditions({
 `columnResolver` answers `equals` and `in` - the only two operators a relationship filter grants -
 comparing the id against the column it closes over, and throws on any other operator.
 
+- `relationshipsOf(schema, '<table export>')` - the relations the schema declares on that table, as the map
+  `permitsFor(schema, { relationships })` takes, so a relationship filter names a relation the schema holds.
+  Throws on a key that is no table export (a table's SQL name is not one).
+
 ### Order Builder
 
 ```ts

package/dist/utils/index.d.ts

@@ -3,5 +3,6 @@ export * from './constants.js';
 export * from './filter.js';
 export * from './include.js';
 export * from './omit.js';
+export * from './relationships.js';
 export * from './table-query.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -3,4 +3,5 @@ export * from './constants.js';
 export * from './filter.js';
 export * from './include.js';
 export * from './omit.js';
+export * from './relationships.js';
 export * from './table-query.js';

package/dist/utils/relationships.d.ts

@@ -0,0 +1,14 @@
+import { type ExtractTablesWithRelations } from 'drizzle-orm';
+/** The relation names a schema declares on one table, as the map `permitsFor` takes for its relationship filters. */
+export type RelationshipsOf<TSchema extends Record<string, unknown>, K extends keyof ExtractTablesWithRelations<TSchema>> = {
+    readonly [R in keyof ExtractTablesWithRelations<TSchema>[K]['relations'] & string]: Record<never, never>;
+};
+/**
+ * The relations `schema` declares on the table exported as `table`, read the way `drizzle({ schema })` reads them, so a
+ * relation added to the schema is a relationship a permit list can name without a second list to edit.
+ *
+ * @param table - the table's EXPORT name in `schema`, not its SQL name
+ * @throws Error when `table` is no table export of `schema`
+ */
+export declare function relationshipsOf<TSchema extends Record<string, unknown>, K extends keyof ExtractTablesWithRelations<TSchema> & string>(schema: TSchema, table: K): RelationshipsOf<TSchema, K>;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/utils/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/utils/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8D,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE1H,qHAAqH;AACrH,MAAM,MAAM,eAAe,CACzB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,MAAM,0BAA0B,CAAC,OAAO,CAAC,IACjD;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;CAAE,CAAC;AAEjH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,MAAM,0BAA0B,CAAC,OAAO,CAAC,GAAG,MAAM,EAC5D,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAKxD"}

package/dist/utils/relationships.js

@@ -0,0 +1,15 @@
+import { createTableRelationsHelpers, extractTablesRelationalConfig } from 'drizzle-orm';
+/**
+ * The relations `schema` declares on the table exported as `table`, read the way `drizzle({ schema })` reads them, so a
+ * relation added to the schema is a relationship a permit list can name without a second list to edit.
+ *
+ * @param table - the table's EXPORT name in `schema`, not its SQL name
+ * @throws Error when `table` is no table export of `schema`
+ */
+export function relationshipsOf(schema, table) {
+    const { tables } = extractTablesRelationalConfig(schema, createTableRelationsHelpers);
+    const config = Object.hasOwn(tables, table) ? tables[table] : undefined;
+    if (!config)
+        throw new Error(`"${table}" is no table export of the schema.`);
+    return Object.fromEntries(Object.keys(config.relations).map((name) => [name, {}]));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroxsolutions/db",
-  "version": "9.2.0",
+  "version": "9.3.1",
   "description": "Generic Drizzle toolkit - the id column and audit timestamps a table takes, a base repository, the unit-of-work and transactional outbox impls, and the filter/sort/pagination query helpers, for PostgreSQL (postgres-js) and Cloudflare D1; ships no domain schema. Shared across ZeroXSolutions services.",
   "private": false,
   "type": "module",
@@ -37,8 +37,8 @@
   "dependencies": {
     "tslib": "^2.3.0",
     "uuid": "^14.0.1",
-    "@zeroxsolutions/cosmic": "0.3.4",
-    "@zeroxsolutions/query": "0.7.0"
+    "@zeroxsolutions/query": "0.7.1",
+    "@zeroxsolutions/cosmic": "0.3.4"
   },
   "peerDependencies": {
     "@testcontainers/postgresql": "^12.1.0",