@headless-lms/adapter-db 0.1.0

package/dist/schema/progress.d.ts

@@ -0,0 +1,166 @@
+//#region src/schema/progress.d.ts
+declare const progressRecords: import("drizzle-orm/pg-core").PgTableWithColumns<{
+  name: "progress_records";
+  schema: undefined;
+  columns: {
+    orgId: import("drizzle-orm/pg-core").PgColumn<{
+      name: "org_id";
+      tableName: "progress_records";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    id: import("drizzle-orm/pg-core").PgColumn<{
+      name: "id";
+      tableName: "progress_records";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: true;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    orgUserId: import("drizzle-orm/pg-core").PgColumn<{
+      name: "org_user_id";
+      tableName: "progress_records";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    targetType: import("drizzle-orm/pg-core").PgColumn<{
+      name: "target_type";
+      tableName: "progress_records";
+      dataType: "string";
+      columnType: "PgText";
+      data: "course" | "module" | "activity";
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: ["activity", "module", "course"];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    targetId: import("drizzle-orm/pg-core").PgColumn<{
+      name: "target_id";
+      tableName: "progress_records";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    startedAt: import("drizzle-orm/pg-core").PgColumn<{
+      name: "started_at";
+      tableName: "progress_records";
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    position: import("drizzle-orm/pg-core").PgColumn<{
+      name: "position";
+      tableName: "progress_records";
+      dataType: "json";
+      columnType: "PgJsonb";
+      data: import("@headless-lms/core/types").JsonValue;
+      driverParam: unknown;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      $type: import("@headless-lms/core/types").JsonValue;
+    }>;
+    completedAt: import("drizzle-orm/pg-core").PgColumn<{
+      name: "completed_at";
+      tableName: "progress_records";
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+      name: "updated_at";
+      tableName: "progress_records";
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
+//#endregion
+export { progressRecords };
+//# sourceMappingURL=progress.d.ts.map

package/dist/schema/progress.js

@@ -0,0 +1,30 @@
+import { orgUsers, organizations } from "./organizations.js";
+import { foreignKey, jsonb, pgTable, primaryKey, text, timestamp, unique } from "drizzle-orm/pg-core";
+import { genId } from "@headless-lms/core/shared/id";
+//#region src/schema/progress.ts
+const progressRecords = pgTable("progress_records", {
+	orgId: text("org_id").notNull().references(() => organizations.id),
+	id: text("id").notNull().$defaultFn(() => genId("progress")),
+	orgUserId: text("org_user_id").notNull(),
+	targetType: text("target_type", { enum: [
+		"activity",
+		"module",
+		"course"
+	] }).notNull(),
+	targetId: text("target_id").notNull(),
+	startedAt: timestamp("started_at", { withTimezone: true }).notNull().defaultNow(),
+	position: jsonb("position").$type(),
+	completedAt: timestamp("completed_at", { withTimezone: true }),
+	updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow().$onUpdate(() => /* @__PURE__ */ new Date())
+}, (t) => ({
+	pk: primaryKey({ columns: [t.orgId, t.id] }),
+	targetUq: unique().on(t.orgId, t.orgUserId, t.targetType, t.targetId),
+	orgUserFk: foreignKey({
+		columns: [t.orgId, t.orgUserId],
+		foreignColumns: [orgUsers.orgId, orgUsers.id]
+	})
+}));
+//#endregion
+export { progressRecords };
+
+//# sourceMappingURL=progress.js.map

package/dist/schema/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","names":[],"sources":["../../src/schema/progress.ts"],"sourcesContent":["// progress tables — one progress record per org user per target (activity,\n// module, or course). Tracks lifecycle: started_at on open, position\n// (typed resume payload) as the player reports it, completed_at when the rule is\n// satisfied (null = in progress). Target is denormalized (type + id, no FK) so a\n// record survives structure edits. Percentage and resume are derived on read;\n// nothing here is a stored percentage.\nimport {\n  pgTable,\n  text,\n  jsonb,\n  timestamp,\n  primaryKey,\n  unique,\n  foreignKey,\n} from 'drizzle-orm/pg-core';\nimport type { ProgressRecord } from '@headless-lms/core/schemas';\nimport { genId } from '@headless-lms/core/shared/id';\nimport { organizations, orgUsers } from './organizations.js';\nimport type { Expect, NoDrift } from './drift.js';\n\nexport const progressRecords = pgTable(\n  'progress_records',\n  {\n    orgId: text('org_id')\n      .notNull()\n      .references(() => organizations.id),\n    id: text('id')\n      .notNull()\n      .$defaultFn(() => genId('progress')),\n    orgUserId: text('org_user_id').notNull(),\n    targetType: text('target_type', {\n      enum: ['activity', 'module', 'course'],\n    }).notNull(),\n    targetId: text('target_id').notNull(),\n    startedAt: timestamp('started_at', { withTimezone: true }).notNull().defaultNow(),\n    position: jsonb('position').$type<ProgressRecord['position']>(), // opaque typed payload; service interprets per target type\n    completedAt: timestamp('completed_at', { withTimezone: true }), // null = in progress\n    updatedAt: timestamp('updated_at', { withTimezone: true })\n      .notNull()\n      .defaultNow()\n      .$onUpdate(() => new Date()),\n  },\n  (t) => ({\n    pk: primaryKey({ columns: [t.orgId, t.id] }),\n    targetUq: unique().on(t.orgId, t.orgUserId, t.targetType, t.targetId),\n    // The one org user reference the schema previously left unenforced.\n    orgUserFk: foreignKey({\n      columns: [t.orgId, t.orgUserId],\n      foreignColumns: [orgUsers.orgId, orgUsers.id],\n    }),\n  }),\n);\n\ntype _ProgressRecordsDrift = Expect<NoDrift<typeof progressRecords.$inferSelect, ProgressRecord>>;\n"],"mappings":";;;;AAoBA,MAAa,kBAAkB,QAC7B,oBACA;CACE,OAAO,KAAK,QAAQ,CAAC,CAClB,QAAQ,CAAC,CACT,iBAAiB,cAAc,EAAE;CACpC,IAAI,KAAK,IAAI,CAAC,CACX,QAAQ,CAAC,CACT,iBAAiB,MAAM,UAAU,CAAC;CACrC,WAAW,KAAK,aAAa,CAAC,CAAC,QAAQ;CACvC,YAAY,KAAK,eAAe,EAC9B,MAAM;EAAC;EAAY;EAAU;CAAQ,EACvC,CAAC,CAAC,CAAC,QAAQ;CACX,UAAU,KAAK,WAAW,CAAC,CAAC,QAAQ;CACpC,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW;CAChF,UAAU,MAAM,UAAU,CAAC,CAAC,MAAkC;CAC9D,aAAa,UAAU,gBAAgB,EAAE,cAAc,KAAK,CAAC;CAC7D,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,CAAC,CACvD,QAAQ,CAAC,CACT,WAAW,CAAC,CACZ,gCAAgB,IAAI,KAAK,CAAC;AAC/B,IACC,OAAO;CACN,IAAI,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;CAC3C,UAAU,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ;CAEpE,WAAW,WAAW;EACpB,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS;EAC9B,gBAAgB,CAAC,SAAS,OAAO,SAAS,EAAE;CAC9C,CAAC;AACH,EACF"}

package/dist/schema/settings.d.ts

@@ -0,0 +1,115 @@
+//#region src/schema/settings.d.ts
+declare const settings: import("drizzle-orm/pg-core").PgTableWithColumns<{
+  name: "settings";
+  schema: undefined;
+  columns: {
+    orgId: import("drizzle-orm/pg-core").PgColumn<{
+      name: "org_id";
+      tableName: "settings";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    namespace: import("drizzle-orm/pg-core").PgColumn<{
+      name: "namespace";
+      tableName: "settings";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    scopeId: import("drizzle-orm/pg-core").PgColumn<{
+      name: "scope_id";
+      tableName: "settings";
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    value: import("drizzle-orm/pg-core").PgColumn<{
+      name: "value";
+      tableName: "settings";
+      dataType: "json";
+      columnType: "PgJsonb";
+      data: Record<string, import("@headless-lms/core/types").JsonValue>;
+      driverParam: unknown;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      $type: Record<string, import("@headless-lms/core/types").JsonValue>;
+    }>;
+    createdAt: import("drizzle-orm/pg-core").PgColumn<{
+      name: "created_at";
+      tableName: "settings";
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+      name: "updated_at";
+      tableName: "settings";
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
+//#endregion
+export { settings };
+//# sourceMappingURL=settings.d.ts.map

package/dist/schema/settings.js

@@ -0,0 +1,19 @@
+import { organizations } from "./organizations.js";
+import { jsonb, pgTable, primaryKey, text, timestamp } from "drizzle-orm/pg-core";
+//#region src/schema/settings.ts
+const settings = pgTable("settings", {
+	orgId: text("org_id").notNull().references(() => organizations.id),
+	namespace: text("namespace").notNull(),
+	scopeId: text("scope_id").notNull(),
+	value: jsonb("value").$type().notNull().default({}),
+	createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+	updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow().$onUpdate(() => /* @__PURE__ */ new Date())
+}, (t) => ({ pk: primaryKey({ columns: [
+	t.orgId,
+	t.namespace,
+	t.scopeId
+] }) }));
+//#endregion
+export { settings };
+
+//# sourceMappingURL=settings.js.map

package/dist/schema/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","names":[],"sources":["../../src/schema/settings.ts"],"sourcesContent":["// settings — cross-cutting configuration store. One row per\n// (org, namespace, scope): the namespace names the domain that owns and\n// interprets the values; the scope is the id the settings attach to (an org id\n// for org-wide defaults, otherwise any entity id — a course, an activity, …).\n//\n// Deliberately NOT bound to any domain: no FK to content or anywhere else, so\n// settings never learns what it is scoping. Rows orphaned by a deleted entity\n// are purged off that domain's *.deleted event, not by cascade.\nimport { pgTable, text, jsonb, timestamp, primaryKey } from 'drizzle-orm/pg-core';\nimport type { Setting } from '@headless-lms/core/schemas';\nimport { organizations } from './organizations.js';\nimport type { Expect, NoDrift } from './drift.js';\n\nexport const settings = pgTable(\n  'settings',\n  {\n    orgId: text('org_id')\n      .notNull()\n      .references(() => organizations.id),\n    // The owning domain: 'content', 'discussion', … Values are validated and\n    // interpreted by that domain, never here.\n    namespace: text('namespace').notNull(),\n    // Org-scoped rows carry the org id, so the column is never null and the\n    // natural key can be the primary key.\n    scopeId: text('scope_id').notNull(),\n    value: jsonb('value').$type<Setting['value']>().notNull().default({}),\n    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n    updatedAt: timestamp('updated_at', { withTimezone: true })\n      .notNull()\n      .defaultNow()\n      .$onUpdate(() => new Date()),\n  },\n  (t) => ({\n    pk: primaryKey({ columns: [t.orgId, t.namespace, t.scopeId] }),\n  }),\n);\n\ntype _SettingsDrift = Expect<NoDrift<typeof settings.$inferSelect, Setting>>;\n"],"mappings":";;;AAaA,MAAa,WAAW,QACtB,YACA;CACE,OAAO,KAAK,QAAQ,CAAC,CAClB,QAAQ,CAAC,CACT,iBAAiB,cAAc,EAAE;CAGpC,WAAW,KAAK,WAAW,CAAC,CAAC,QAAQ;CAGrC,SAAS,KAAK,UAAU,CAAC,CAAC,QAAQ;CAClC,OAAO,MAAM,OAAO,CAAC,CAAC,MAAwB,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;CACpE,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW;CAChF,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,CAAC,CACvD,QAAQ,CAAC,CACT,WAAW,CAAC,CACZ,gCAAgB,IAAI,KAAK,CAAC;AAC/B,IACC,OAAO,EACN,IAAI,WAAW,EAAE,SAAS;CAAC,EAAE;CAAO,EAAE;CAAW,EAAE;AAAO,EAAE,CAAC,EAC/D,EACF"}

package/dist/unit-of-work.d.ts

@@ -0,0 +1,13 @@
+import { Tx } from "./client.js";
+import { NodePgDatabase } from "drizzle-orm/node-postgres";
+import { UnitOfWork } from "@headless-lms/core/shared/ports";
+//#region src/unit-of-work.d.ts
+declare class DrizzleUnitOfWork<Scope> implements UnitOfWork<Scope> {
+  private readonly db;
+  private readonly makeScope;
+  constructor(db: NodePgDatabase, makeScope: (tx: Tx) => Scope);
+  run<T>(fn: (scope: Scope) => Promise<T>): Promise<T>;
+}
+//#endregion
+export { DrizzleUnitOfWork };
+//# sourceMappingURL=unit-of-work.d.ts.map

package/dist/unit-of-work.js

@@ -0,0 +1,16 @@
+//#region src/unit-of-work.ts
+var DrizzleUnitOfWork = class {
+	db;
+	makeScope;
+	constructor(db, makeScope) {
+		this.db = db;
+		this.makeScope = makeScope;
+	}
+	run(fn) {
+		return this.db.transaction((tx) => fn(this.makeScope(tx)));
+	}
+};
+//#endregion
+export { DrizzleUnitOfWork };
+
+//# sourceMappingURL=unit-of-work.js.map

package/dist/unit-of-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-of-work.js","names":[],"sources":["../src/unit-of-work.ts"],"sourcesContent":["import type { NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport type { UnitOfWork } from '@headless-lms/core/shared/ports';\nimport type { Tx } from './client.js';\n\nexport class DrizzleUnitOfWork<Scope> implements UnitOfWork<Scope> {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly makeScope: (tx: Tx) => Scope,\n  ) {}\n\n  run<T>(fn: (scope: Scope) => Promise<T>): Promise<T> {\n    return this.db.transaction((tx) => fn(this.makeScope(tx)));\n  }\n}\n"],"mappings":";AAIA,IAAa,oBAAb,MAAmE;CAE9C;CACA;CAFnB,YACE,IACA,WACA;EAFiB,KAAA,KAAA;EACA,KAAA,YAAA;CAChB;CAEH,IAAO,IAA8C;EACnD,OAAO,KAAK,GAAG,aAAa,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC,CAAC;CAC3D;AACF"}