@decohere/data 0.0.1-dev.125 → 0.0.1-dev.5

package/package.json

@@ -1,25 +1,9 @@
 {
   "name": "@decohere/data",
-  "version": "0.0.1-dev.125",
-  "description": "Data access for Decohere apps: repositories, request-scoped units of work and database bootstrap",
-  "keywords": [
-    "typescript",
-    "data-access",
-    "repository",
-    "unit-of-work",
-    "decohere"
-  ],
-  "homepage": "https://github.com/typesmiths/decohere/tree/main/projects/data/data#readme",
-  "bugs": {
-    "url": "https://github.com/typesmiths/decohere/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/typesmiths/decohere.git",
-    "directory": "projects/data/data"
-  },
+  "version": "0.0.1-dev.5",
+  "description": "",
   "license": "ISC",
-  "author": "Typesmiths",
+  "author": "",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -33,8 +17,8 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/core": "0.0.1-dev.125",
-    "@decohere/crucible": "0.0.1-dev.125"
+    "@decohere/di": "0.0.1-dev.5",
+    "@decohere/core": "0.0.1-dev.5"
   },
   "devDependencies": {}
 }

package/src/connection-info.ts

@@ -0,0 +1,55 @@
+export type Dialect = "postgresql" | "tsql";
+export type Provider = "postgres" | "mssql";
+
+/**
+ * How the server checks who connects, named as in pg_hba.conf.
+ * - `password` (default): every role signs in with a password.
+ * - `trust`: the server lets every connection in, so no role has a password. For a local dev
+ *   server only; refused outside development.
+ */
+export type DatabaseAuth = "password" | "trust";
+
+/**
+ * Datasource connection settings.
+ *
+ * Privilege model (three roles — see CU-869eh3065):
+ * - **username/password** — runtime app role (DML only in production).
+ * - **migrateUsername/migratePassword** — migration/DDL role (CI/deploy only; not on API pods).
+ * - **adminUser/adminPassword** — bootstrap role (`CREATEDB`/`CREATEROLE`, not superuser);
+ *   used only when `bootstrap` is enabled (explicit or auto in development).
+ */
+export type ConnectionInfo = {
+	name: string;
+	provider: Provider;
+	dialect?: Dialect;
+	host: string;
+	database: string;
+	port: number;
+	synchronize: boolean;
+	seed: boolean;
+	/** Runtime app role (TypeORM connection). */
+	username: string;
+	/** Required unless `auth` is `trust`. */
+	password?: string;
+	/** Defaults to `password`. `trust` must be declared: a missing password never implies it. */
+	auth?: DatabaseAuth;
+	/**
+	 * Schema this data source's tables live in (default `public`). Bootstrap creates it when
+	 * missing and grants the app role access to it.
+	 */
+	schema?: string;
+	/**
+	 * When true, run prepareDatabase (create DB + roles) at API startup.
+	 * When false, never bootstrap (production default).
+	 * When omitted, bootstrap only if NODE_ENV is development/dev and admin creds are set.
+	 */
+	bootstrap?: boolean;
+	/** Bootstrap / provisioner role — must not be the runtime app user. */
+	adminUser?: string;
+	/** Required to bootstrap unless `auth` is `trust`. */
+	adminPassword?: string;
+	/** Optional migration role for DDL; default privileges grant DML to the app user. */
+	migrateUsername?: string;
+	/** Required with `migrateUsername` when bootstrapping, unless `auth` is `trust`. */
+	migratePassword?: string;
+};

package/src/data-provider.ts

@@ -0,0 +1,17 @@
+import type { Constructable } from "@decohere/core/reflection";
+import type { Entity } from "./data.types.js";
+
+export interface IUnitOfWork {
+	commit(): unknown;
+	beginTransaction(): Promise<void>;
+	/** Roll back anything unfinished and release the connection; prefer this over sync dispose. */
+	[Symbol.asyncDispose](): Promise<void>;
+	[Symbol.dispose](): void;
+}
+
+export interface IDataProvider {
+	findById<T extends Entity>(entity: Constructable<T>, key: string | number): Promise<T>;
+	save<T>(entity: T): Promise<T>;
+	delete<T>(entity: T);
+	all<T>(entity: Constructable): Promise<T[]>;
+}

package/{types/src/data.types.d.ts → src/data.types.ts}

@@ -1,8 +1,10 @@
 import type { Dialect } from "./connection-info.js";
+
 export interface Entity {
-    id: number | string;
+	id: number | string;
 }
+
 export type LogQuery = {
-    dialect: Dialect;
-    statement: string;
+	dialect: Dialect;
+	statement: string;
 };

package/src/database.config.ts

@@ -0,0 +1,5 @@
+import type { ConnectionInfo } from "./connection-info.js";
+
+export class DatabaseConfig {
+	public dataSources: ConnectionInfo[] = [];
+}

package/src/error.ts

@@ -0,0 +1,2 @@
+export class DataError extends Error {}
+export class DataConfigurationError extends Error {}

package/src/inject-unit-of-work.ts

@@ -0,0 +1,7 @@
+import { inject } from "@decohere/di/decorators";
+
+export const DEFAULT_DATA_SOURCE = Symbol("DEFAULT_DATA_SOURCE");
+
+export function injectUnitOfWork(key?: string) {
+	return inject(key ?? DEFAULT_DATA_SOURCE);
+}

package/src/repository.ts

@@ -0,0 +1,28 @@
+import type { Constructable } from "@decohere/core/reflection";
+import type { Entity } from "./data.types.js";
+import type { IDataProvider } from "./data-provider.js";
+
+export interface IRepository<T> {
+	find(key: string): Promise<T>;
+}
+
+export abstract class Repository<T extends Entity> implements IRepository<T> {
+	protected abstract readonly provider: IDataProvider;
+	protected abstract readonly type: Constructable<T>;
+
+	public find(key: string | number): Promise<T> {
+		return this.provider.findById(this.type, key);
+	}
+
+	public save(entity: T): Promise<T> {
+		return this.provider.save(entity);
+	}
+
+	public async delete(entity: T) {
+		await this.provider.delete(entity);
+	}
+
+	public async all(): Promise<T[]> {
+		return this.provider.all(this.type);
+	}
+}

package/{types/src/transaction.d.ts → src/transaction.ts}

@@ -1,3 +1,3 @@
 export interface ITransaction {
-    commit(): any;
+	commit();
 }

package/LICENSE

@@ -1,15 +0,0 @@
-ISC License
-
-Copyright (c) 2025-2026 Typesmiths
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/commonjs/src/connection-info.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/commonjs/src/data-provider.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/commonjs/src/data.types.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/commonjs/src/database.config.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "DatabaseConfig", {
-    enumerable: true,
-    get: function() {
-        return DatabaseConfig;
-    }
-});
-class DatabaseConfig {
-    dataSources = [];
-}

package/commonjs/src/error.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get DataConfigurationError () {
-        return DataConfigurationError;
-    },
-    get DataError () {
-        return DataError;
-    }
-});
-class DataError extends Error {
-}
-class DataConfigurationError extends Error {
-}

package/commonjs/src/index.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./connection-info.js"), exports);
-_export_star(require("./data.types.js"), exports);
-_export_star(require("./data-provider.js"), exports);
-_export_star(require("./database.config.js"), exports);
-_export_star(require("./error.js"), exports);
-_export_star(require("./inject-unit-of-work.js"), exports);
-_export_star(require("./repository.js"), exports);
-_export_star(require("./transaction.js"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/commonjs/src/inject-unit-of-work.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get DEFAULT_DATA_SOURCE () {
-        return DEFAULT_DATA_SOURCE;
-    },
-    get injectUnitOfWork () {
-        return injectUnitOfWork;
-    }
-});
-const _decorators = require("@decohere/crucible/decorators");
-const DEFAULT_DATA_SOURCE = Symbol("DEFAULT_DATA_SOURCE");
-function injectUnitOfWork(key) {
-    return (0, _decorators.inject)(key ?? DEFAULT_DATA_SOURCE);
-}

package/commonjs/src/repository.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "Repository", {
-    enumerable: true,
-    get: function() {
-        return Repository;
-    }
-});
-class Repository {
-    find(key) {
-        return this.provider.findById(this.type, key);
-    }
-    save(entity) {
-        return this.provider.save(entity);
-    }
-    async delete(entity) {
-        await this.provider.delete(entity);
-    }
-    async all() {
-        return this.provider.all(this.type);
-    }
-}

package/commonjs/src/transaction.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/es6/src/connection-info.js

@@ -1,9 +0,0 @@
-/**
- * Datasource connection settings.
- *
- * Privilege model (three roles):
- * - **username/password** — runtime app role (DML only in production).
- * - **migrateUsername/migratePassword** — migration/DDL role (CI/deploy only; not on API pods).
- * - **adminUser/adminPassword** — bootstrap role (`CREATEDB`/`CREATEROLE`, not superuser);
- *   used only when `bootstrap` is enabled (explicit or auto in development).
- */ export { };

package/es6/src/data-provider.js

@@ -1 +0,0 @@
-export { };

package/es6/src/data.types.js

@@ -1 +0,0 @@
-export { };

package/es6/src/database.config.js

@@ -1,3 +0,0 @@
-export class DatabaseConfig {
-    dataSources = [];
-}

package/es6/src/error.js

@@ -1,4 +0,0 @@
-export class DataError extends Error {
-}
-export class DataConfigurationError extends Error {
-}

package/es6/src/inject-unit-of-work.js

@@ -1,5 +0,0 @@
-import { inject } from "@decohere/crucible/decorators";
-export const DEFAULT_DATA_SOURCE = Symbol("DEFAULT_DATA_SOURCE");
-export function injectUnitOfWork(key) {
-    return inject(key ?? DEFAULT_DATA_SOURCE);
-}

package/es6/src/repository.js

@@ -1,14 +0,0 @@
-export class Repository {
-    find(key) {
-        return this.provider.findById(this.type, key);
-    }
-    save(entity) {
-        return this.provider.save(entity);
-    }
-    async delete(entity) {
-        await this.provider.delete(entity);
-    }
-    async all() {
-        return this.provider.all(this.type);
-    }
-}

package/es6/src/transaction.js

@@ -1 +0,0 @@
-export { };

package/types/src/connection-info.d.ts

@@ -1,53 +0,0 @@
-export type Dialect = "postgresql" | "tsql";
-export type Provider = "postgres" | "mssql";
-/**
- * How the server checks who connects, named as in pg_hba.conf.
- * - `password` (default): every role signs in with a password.
- * - `trust`: the server lets every connection in, so no role has a password. For a local dev
- *   server only; refused outside development.
- */
-export type DatabaseAuth = "password" | "trust";
-/**
- * Datasource connection settings.
- *
- * Privilege model (three roles):
- * - **username/password** — runtime app role (DML only in production).
- * - **migrateUsername/migratePassword** — migration/DDL role (CI/deploy only; not on API pods).
- * - **adminUser/adminPassword** — bootstrap role (`CREATEDB`/`CREATEROLE`, not superuser);
- *   used only when `bootstrap` is enabled (explicit or auto in development).
- */
-export type ConnectionInfo = {
-    name: string;
-    provider: Provider;
-    dialect?: Dialect;
-    host: string;
-    database: string;
-    port: number;
-    synchronize: boolean;
-    seed: boolean;
-    /** Runtime app role (TypeORM connection). */
-    username: string;
-    /** Required unless `auth` is `trust`. */
-    password?: string;
-    /** Defaults to `password`. `trust` must be declared: a missing password never implies it. */
-    auth?: DatabaseAuth;
-    /**
-     * Schema this data source's tables live in (default `public`). Bootstrap creates it when
-     * missing and grants the app role access to it.
-     */
-    schema?: string;
-    /**
-     * When true, run prepareDatabase (create DB + roles) at API startup.
-     * When false, never bootstrap (production default).
-     * When omitted, bootstrap only if NODE_ENV is development/dev and admin creds are set.
-     */
-    bootstrap?: boolean;
-    /** Bootstrap / provisioner role — must not be the runtime app user. */
-    adminUser?: string;
-    /** Required to bootstrap unless `auth` is `trust`. */
-    adminPassword?: string;
-    /** Optional migration role for DDL; default privileges grant DML to the app user. */
-    migrateUsername?: string;
-    /** Required with `migrateUsername` when bootstrapping, unless `auth` is `trust`. */
-    migratePassword?: string;
-};

package/types/src/data-provider.d.ts

@@ -1,15 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-import type { Entity } from "./data.types.js";
-export interface IUnitOfWork {
-    commit(): unknown;
-    beginTransaction(): Promise<void>;
-    /** Roll back anything unfinished and release the connection; prefer this over sync dispose. */
-    [Symbol.asyncDispose](): Promise<void>;
-    [Symbol.dispose](): void;
-}
-export interface IDataProvider {
-    findById<T extends Entity>(entity: Constructable<T>, key: string | number): Promise<T>;
-    save<T>(entity: T): Promise<T>;
-    delete<T>(entity: T): any;
-    all<T>(entity: Constructable): Promise<T[]>;
-}

package/types/src/database.config.d.ts

@@ -1,4 +0,0 @@
-import type { ConnectionInfo } from "./connection-info.js";
-export declare class DatabaseConfig {
-    dataSources: ConnectionInfo[];
-}

package/types/src/error.d.ts

@@ -1,4 +0,0 @@
-export declare class DataError extends Error {
-}
-export declare class DataConfigurationError extends Error {
-}

package/types/src/index.d.ts

@@ -1,8 +0,0 @@
-export * from "./connection-info.js";
-export * from "./data.types.js";
-export * from "./data-provider.js";
-export * from "./database.config.js";
-export * from "./error.js";
-export * from "./inject-unit-of-work.js";
-export * from "./repository.js";
-export * from "./transaction.js";

package/types/src/inject-unit-of-work.d.ts

@@ -1,2 +0,0 @@
-export declare const DEFAULT_DATA_SOURCE: unique symbol;
-export declare function injectUnitOfWork(key?: string): (target: object, _propertyKey: string | symbol | undefined, idx: number) => void;

package/types/src/repository.d.ts

@@ -1,14 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-import type { Entity } from "./data.types.js";
-import type { IDataProvider } from "./data-provider.js";
-export interface IRepository<T> {
-    find(key: string): Promise<T>;
-}
-export declare abstract class Repository<T extends Entity> implements IRepository<T> {
-    protected abstract readonly provider: IDataProvider;
-    protected abstract readonly type: Constructable<T>;
-    find(key: string | number): Promise<T>;
-    save(entity: T): Promise<T>;
-    delete(entity: T): Promise<void>;
-    all(): Promise<T[]>;
-}