@headless-lms/adapter-db 0.1.0

package/dist/repositories/outbox.js

@@ -0,0 +1,56 @@
+import { eventOutbox } from "../schema/outbox.js";
+import { and, asc, eq, isNull, lt, lte, sql } from "drizzle-orm";
+import { noopLogger } from "@headless-lms/core/shared/logger";
+//#region src/repositories/outbox.ts
+/** A message that fails this many dispatches is parked: fetchBatch stops
+*  claiming it, leaving the row (with its last_error) for inspection. */
+const OUTBOX_MAX_ATTEMPTS = 10;
+var DrizzleOutboxAppender = class {
+	tx;
+	logger;
+	constructor(tx, logger = noopLogger) {
+		this.tx = tx;
+		this.logger = logger;
+	}
+	async append(events) {
+		if (events.length === 0) return;
+		await this.tx.insert(eventOutbox).values(events.map((event) => ({
+			type: event.type,
+			orgId: event.orgId,
+			payload: event
+		})));
+	}
+};
+var DrizzleOutboxStore = class {
+	db;
+	logger;
+	constructor(db, logger = noopLogger) {
+		this.db = db;
+		this.logger = logger;
+	}
+	async fetchBatch(limit) {
+		return (await this.db.transaction((tx) => tx.select().from(eventOutbox).where(and(isNull(eventOutbox.processedAt), lte(eventOutbox.nextAttemptAt, /* @__PURE__ */ new Date()), lt(eventOutbox.attempts, 10))).orderBy(asc(eventOutbox.id)).limit(limit).for("update", { skipLocked: true }))).map((row) => ({
+			id: row.id,
+			attempts: row.attempts,
+			payload: {
+				...row.payload,
+				id: row.id,
+				occurredAt: row.createdAt.toISOString()
+			}
+		}));
+	}
+	async markProcessed(id) {
+		await this.db.update(eventOutbox).set({ processedAt: /* @__PURE__ */ new Date() }).where(eq(eventOutbox.id, id));
+	}
+	async markFailed(id, error, nextAttemptAt) {
+		await this.db.update(eventOutbox).set({
+			attempts: sql`${eventOutbox.attempts} + 1`,
+			lastError: error,
+			nextAttemptAt
+		}).where(eq(eventOutbox.id, id));
+	}
+};
+//#endregion
+export { DrizzleOutboxAppender, DrizzleOutboxStore, OUTBOX_MAX_ATTEMPTS };
+
+//# sourceMappingURL=outbox.js.map

package/dist/repositories/outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.js","names":[],"sources":["../../src/repositories/outbox.ts"],"sourcesContent":["import { and, asc, eq, isNull, lt, lte, sql } from 'drizzle-orm';\nimport type { NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport type {\n  DomainEvent,\n  NewDomainEvent,\n  OutboxAppender,\n  OutboxMessage,\n  OutboxStore,\n  Logger,\n} from '@headless-lms/core/shared/ports';\nimport { noopLogger } from '@headless-lms/core/shared/logger';\nimport type { EventOutbox } from '@headless-lms/core/schemas';\nimport type { DbExecutor } from '../client.js';\nimport { eventOutbox } from '../schema/outbox.js';\n\n/** A message that fails this many dispatches is parked: fetchBatch stops\n *  claiming it, leaving the row (with its last_error) for inspection. */\nexport const OUTBOX_MAX_ATTEMPTS = 10;\n\nexport class DrizzleOutboxAppender implements OutboxAppender {\n  constructor(\n    private readonly tx: DbExecutor,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async append<E extends NewDomainEvent>(events: E[]): Promise<void> {\n    if (events.length === 0) {\n      return;\n    }\n    await this.tx.insert(eventOutbox).values(\n      events.map((event) => ({\n        type: event.type,\n        orgId: event.orgId,\n        payload: event as unknown as EventOutbox['payload'],\n      })),\n    );\n  }\n}\n\nexport class DrizzleOutboxStore implements OutboxStore {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async fetchBatch(limit: number): Promise<OutboxMessage[]> {\n    const rows = await this.db.transaction((tx) =>\n      tx\n        .select()\n        .from(eventOutbox)\n        .where(\n          and(\n            isNull(eventOutbox.processedAt),\n            lte(eventOutbox.nextAttemptAt, new Date()),\n            lt(eventOutbox.attempts, OUTBOX_MAX_ATTEMPTS),\n          ),\n        )\n        .orderBy(asc(eventOutbox.id))\n        .limit(limit)\n        .for('update', { skipLocked: true }),\n    );\n    return rows.map((row) => ({\n      id: row.id,\n      attempts: row.attempts,\n      payload: {\n        ...row.payload,\n        id: row.id,\n        occurredAt: row.createdAt.toISOString(),\n      } as unknown as DomainEvent,\n    }));\n  }\n\n  async markProcessed(id: string): Promise<void> {\n    await this.db\n      .update(eventOutbox)\n      .set({ processedAt: new Date() })\n      .where(eq(eventOutbox.id, id));\n  }\n\n  async markFailed(id: string, error: string, nextAttemptAt: Date): Promise<void> {\n    await this.db\n      .update(eventOutbox)\n      .set({\n        attempts: sql`${eventOutbox.attempts} + 1`,\n        lastError: error,\n        nextAttemptAt,\n      })\n      .where(eq(eventOutbox.id, id));\n  }\n}\n"],"mappings":";;;;;;AAiBA,MAAa,sBAAsB;AAEnC,IAAa,wBAAb,MAA6D;CAExC;CACA;CAFnB,YACE,IACA,SAAkC,YAClC;EAFiB,KAAA,KAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,OAAiC,QAA4B;EACjE,IAAI,OAAO,WAAW,GACpB;EAEF,MAAM,KAAK,GAAG,OAAO,WAAW,CAAC,CAAC,OAChC,OAAO,KAAK,WAAW;GACrB,MAAM,MAAM;GACZ,OAAO,MAAM;GACb,SAAS;EACX,EAAE,CACJ;CACF;AACF;AAEA,IAAa,qBAAb,MAAuD;CAElC;CACA;CAFnB,YACE,IACA,SAAkC,YAClC;EAFiB,KAAA,KAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,WAAW,OAAyC;EAgBxD,QAAO,MAfY,KAAK,GAAG,aAAa,OACtC,GACG,OAAO,CAAC,CACR,KAAK,WAAW,CAAC,CACjB,MACC,IACE,OAAO,YAAY,WAAW,GAC9B,IAAI,YAAY,+BAAe,IAAI,KAAK,CAAC,GACzC,GAAG,YAAY,UAAA,EAA6B,CAC9C,CACF,CAAC,CACA,QAAQ,IAAI,YAAY,EAAE,CAAC,CAAC,CAC5B,MAAM,KAAK,CAAC,CACZ,IAAI,UAAU,EAAE,YAAY,KAAK,CAAC,CACvC,EAAA,CACY,KAAK,SAAS;GACxB,IAAI,IAAI;GACR,UAAU,IAAI;GACd,SAAS;IACP,GAAG,IAAI;IACP,IAAI,IAAI;IACR,YAAY,IAAI,UAAU,YAAY;GACxC;EACF,EAAE;CACJ;CAEA,MAAM,cAAc,IAA2B;EAC7C,MAAM,KAAK,GACR,OAAO,WAAW,CAAC,CACnB,IAAI,EAAE,6BAAa,IAAI,KAAK,EAAE,CAAC,CAAC,CAChC,MAAM,GAAG,YAAY,IAAI,EAAE,CAAC;CACjC;CAEA,MAAM,WAAW,IAAY,OAAe,eAAoC;EAC9E,MAAM,KAAK,GACR,OAAO,WAAW,CAAC,CACnB,IAAI;GACH,UAAU,GAAG,GAAG,YAAY,SAAS;GACrC,WAAW;GACX;EACF,CAAC,CAAC,CACD,MAAM,GAAG,YAAY,IAAI,EAAE,CAAC;CACjC;AACF"}

package/dist/repositories/pg-errors.d.ts

@@ -0,0 +1,11 @@
+//#region src/repositories/pg-errors.d.ts
+/**
+ * Postgres unique_violation (23505).
+ *
+ * The node-postgres driver sometimes wraps the original error (e.g. behind
+ * `cause`), so both levels are checked.
+ */
+declare function isUniqueViolation(err: unknown): boolean;
+//#endregion
+export { isUniqueViolation };
+//# sourceMappingURL=pg-errors.d.ts.map

package/dist/repositories/pg-errors.js

@@ -0,0 +1,15 @@
+//#region src/repositories/pg-errors.ts
+/**
+* Postgres unique_violation (23505).
+*
+* The node-postgres driver sometimes wraps the original error (e.g. behind
+* `cause`), so both levels are checked.
+*/
+function isUniqueViolation(err) {
+	if (err?.code === "23505") return true;
+	return (err?.cause)?.code === "23505";
+}
+//#endregion
+export { isUniqueViolation };
+
+//# sourceMappingURL=pg-errors.js.map

package/dist/repositories/pg-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-errors.js","names":[],"sources":["../../src/repositories/pg-errors.ts"],"sourcesContent":["/**\n * Postgres unique_violation (23505).\n *\n * The node-postgres driver sometimes wraps the original error (e.g. behind\n * `cause`), so both levels are checked.\n */\nexport function isUniqueViolation(err: unknown): boolean {\n  const code = (err as { code?: unknown } | undefined)?.code;\n  if (code === '23505') {\n    return true;\n  }\n  const cause = (err as { cause?: unknown } | undefined)?.cause;\n  const causeCode = (cause as { code?: unknown } | undefined)?.code;\n  return causeCode === '23505';\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,kBAAkB,KAAuB;CAEvD,IADc,KAAwC,SACzC,SACX,OAAO;CAIT,QAFe,KAAyC,MAAA,EACK,SACxC;AACvB"}

package/dist/repositories/progress.d.ts

@@ -0,0 +1,18 @@
+import { NodePgDatabase } from "drizzle-orm/node-postgres";
+import { Logger } from "@headless-lms/core/shared/ports";
+import { ProgressRecord, ProgressRepository, ProgressTarget } from "@headless-lms/core/progress";
+//#region src/repositories/progress.d.ts
+declare class DrizzleProgressRepository implements ProgressRepository {
+  private readonly db;
+  private readonly logger;
+  constructor(db: NodePgDatabase, logger?: Logger);
+  insert(orgId: string, record: ProgressRecord): Promise<ProgressRecord | null>;
+  findByTarget(orgId: string, target: ProgressTarget): Promise<ProgressRecord | null>;
+  findByTargets(orgId: string, orgUserId: string, targetIds: string[], opts?: {
+    forUpdate?: boolean;
+  }): Promise<ProgressRecord[]>;
+  update(orgId: string, id: string, patch: Partial<Pick<ProgressRecord, 'position' | 'completedAt'>>): Promise<ProgressRecord | null>;
+}
+//#endregion
+export { DrizzleProgressRepository };
+//# sourceMappingURL=progress.d.ts.map

package/dist/repositories/progress.js

@@ -0,0 +1,59 @@
+import { progressRecords } from "../schema/progress.js";
+import { and, eq, inArray } from "drizzle-orm";
+import { noopLogger } from "@headless-lms/core/shared/logger";
+//#region src/repositories/progress.ts
+function toRecord(row) {
+	return {
+		id: row.id,
+		orgId: row.orgId,
+		orgUserId: row.orgUserId,
+		targetType: row.targetType,
+		targetId: row.targetId,
+		startedAt: row.startedAt,
+		position: row.position ?? null,
+		completedAt: row.completedAt,
+		updatedAt: row.updatedAt
+	};
+}
+var DrizzleProgressRepository = class {
+	db;
+	logger;
+	constructor(db, logger = noopLogger) {
+		this.db = db;
+		this.logger = logger;
+	}
+	async insert(orgId, record) {
+		const [row] = await this.db.insert(progressRecords).values({
+			id: record.id,
+			orgId,
+			orgUserId: record.orgUserId,
+			targetType: record.targetType,
+			targetId: record.targetId,
+			startedAt: new Date(record.startedAt),
+			position: record.position ?? null,
+			completedAt: record.completedAt ? new Date(record.completedAt) : null,
+			updatedAt: new Date(record.updatedAt)
+		}).onConflictDoNothing().returning();
+		return row ? toRecord(row) : null;
+	}
+	async findByTarget(orgId, target) {
+		const [row] = await this.db.select().from(progressRecords).where(and(eq(progressRecords.orgId, orgId), eq(progressRecords.orgUserId, target.orgUserId), eq(progressRecords.targetType, target.targetType), eq(progressRecords.targetId, target.targetId))).limit(1);
+		return row ? toRecord(row) : null;
+	}
+	async findByTargets(orgId, orgUserId, targetIds, opts) {
+		if (targetIds.length === 0) return [];
+		const base = this.db.select().from(progressRecords).where(and(eq(progressRecords.orgId, orgId), eq(progressRecords.orgUserId, orgUserId), inArray(progressRecords.targetId, targetIds)));
+		return (opts?.forUpdate ? await base.orderBy(progressRecords.id).for("update") : await base).map(toRecord);
+	}
+	async update(orgId, id, patch) {
+		const [row] = await this.db.update(progressRecords).set({
+			..."position" in patch ? { position: patch.position ?? null } : {},
+			..."completedAt" in patch ? { completedAt: patch.completedAt ? new Date(patch.completedAt) : null } : {}
+		}).where(and(eq(progressRecords.orgId, orgId), eq(progressRecords.id, id))).returning();
+		return row ? toRecord(row) : null;
+	}
+};
+//#endregion
+export { DrizzleProgressRepository };
+
+//# sourceMappingURL=progress.js.map

package/dist/repositories/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","names":[],"sources":["../../src/repositories/progress.ts"],"sourcesContent":["// progress — Drizzle repository (implements the core outbound port).\nimport { and, eq, inArray } from 'drizzle-orm';\nimport type { NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport type {\n  ProgressRecord,\n  ProgressRepository,\n  ProgressTarget,\n  ProgressTargetType,\n} from '@headless-lms/core/progress';\nimport { progressRecords } from '../schema/progress.js';\nimport type { Logger } from '@headless-lms/core/shared/ports';\nimport { noopLogger } from '@headless-lms/core/shared/logger';\n\ntype Row = typeof progressRecords.$inferSelect;\n\nfunction toRecord(row: Row): ProgressRecord {\n  return {\n    id: row.id,\n    orgId: row.orgId,\n    orgUserId: row.orgUserId,\n    targetType: row.targetType as ProgressTargetType,\n    targetId: row.targetId,\n    startedAt: row.startedAt,\n    position: row.position ?? null,\n    completedAt: row.completedAt,\n    updatedAt: row.updatedAt,\n  };\n}\n\nexport class DrizzleProgressRepository implements ProgressRepository {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async insert(orgId: string, record: ProgressRecord): Promise<ProgressRecord | null> {\n    const [row] = await this.db\n      .insert(progressRecords)\n      .values({\n        id: record.id,\n        orgId,\n        orgUserId: record.orgUserId,\n        targetType: record.targetType,\n        targetId: record.targetId,\n        startedAt: new Date(record.startedAt),\n        position: record.position ?? null,\n        completedAt: record.completedAt ? new Date(record.completedAt) : null,\n        updatedAt: new Date(record.updatedAt),\n      })\n      .onConflictDoNothing()\n      .returning();\n    return row ? toRecord(row) : null;\n  }\n\n  async findByTarget(orgId: string, target: ProgressTarget): Promise<ProgressRecord | null> {\n    const [row] = await this.db\n      .select()\n      .from(progressRecords)\n      .where(\n        and(\n          eq(progressRecords.orgId, orgId),\n          eq(progressRecords.orgUserId, target.orgUserId),\n          eq(progressRecords.targetType, target.targetType),\n          eq(progressRecords.targetId, target.targetId),\n        ),\n      )\n      .limit(1);\n    return row ? toRecord(row) : null;\n  }\n\n  async findByTargets(\n    orgId: string,\n    orgUserId: string,\n    targetIds: string[],\n    opts?: { forUpdate?: boolean },\n  ): Promise<ProgressRecord[]> {\n    if (targetIds.length === 0) {\n      return [];\n    }\n    const base = this.db\n      .select()\n      .from(progressRecords)\n      .where(\n        and(\n          eq(progressRecords.orgId, orgId),\n          eq(progressRecords.orgUserId, orgUserId),\n          inArray(progressRecords.targetId, targetIds),\n        ),\n      );\n    // Deterministic lock order prevents deadlock between overlapping reports.\n    const rows = opts?.forUpdate\n      ? await base.orderBy(progressRecords.id).for('update')\n      : await base;\n    return rows.map(toRecord);\n  }\n\n  async update(\n    orgId: string,\n    id: string,\n    patch: Partial<Pick<ProgressRecord, 'position' | 'completedAt'>>,\n  ): Promise<ProgressRecord | null> {\n    const [row] = await this.db\n      .update(progressRecords)\n      .set({\n        ...('position' in patch ? { position: patch.position ?? null } : {}),\n        ...('completedAt' in patch\n          ? { completedAt: patch.completedAt ? new Date(patch.completedAt) : null }\n          : {}),\n      })\n      .where(and(eq(progressRecords.orgId, orgId), eq(progressRecords.id, id)))\n      .returning();\n    return row ? toRecord(row) : null;\n  }\n}\n"],"mappings":";;;;AAeA,SAAS,SAAS,KAA0B;CAC1C,OAAO;EACL,IAAI,IAAI;EACR,OAAO,IAAI;EACX,WAAW,IAAI;EACf,YAAY,IAAI;EAChB,UAAU,IAAI;EACd,WAAW,IAAI;EACf,UAAU,IAAI,YAAY;EAC1B,aAAa,IAAI;EACjB,WAAW,IAAI;CACjB;AACF;AAEA,IAAa,4BAAb,MAAqE;CAEhD;CACA;CAFnB,YACE,IACA,SAAkC,YAClC;EAFiB,KAAA,KAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,OAAO,OAAe,QAAwD;EAClF,MAAM,CAAC,OAAO,MAAM,KAAK,GACtB,OAAO,eAAe,CAAC,CACvB,OAAO;GACN,IAAI,OAAO;GACX;GACA,WAAW,OAAO;GAClB,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,WAAW,IAAI,KAAK,OAAO,SAAS;GACpC,UAAU,OAAO,YAAY;GAC7B,aAAa,OAAO,cAAc,IAAI,KAAK,OAAO,WAAW,IAAI;GACjE,WAAW,IAAI,KAAK,OAAO,SAAS;EACtC,CAAC,CAAC,CACD,oBAAoB,CAAC,CACrB,UAAU;EACb,OAAO,MAAM,SAAS,GAAG,IAAI;CAC/B;CAEA,MAAM,aAAa,OAAe,QAAwD;EACxF,MAAM,CAAC,OAAO,MAAM,KAAK,GACtB,OAAO,CAAC,CACR,KAAK,eAAe,CAAC,CACrB,MACC,IACE,GAAG,gBAAgB,OAAO,KAAK,GAC/B,GAAG,gBAAgB,WAAW,OAAO,SAAS,GAC9C,GAAG,gBAAgB,YAAY,OAAO,UAAU,GAChD,GAAG,gBAAgB,UAAU,OAAO,QAAQ,CAC9C,CACF,CAAC,CACA,MAAM,CAAC;EACV,OAAO,MAAM,SAAS,GAAG,IAAI;CAC/B;CAEA,MAAM,cACJ,OACA,WACA,WACA,MAC2B;EAC3B,IAAI,UAAU,WAAW,GACvB,OAAO,CAAC;EAEV,MAAM,OAAO,KAAK,GACf,OAAO,CAAC,CACR,KAAK,eAAe,CAAC,CACrB,MACC,IACE,GAAG,gBAAgB,OAAO,KAAK,GAC/B,GAAG,gBAAgB,WAAW,SAAS,GACvC,QAAQ,gBAAgB,UAAU,SAAS,CAC7C,CACF;EAKF,QAHa,MAAM,YACf,MAAM,KAAK,QAAQ,gBAAgB,EAAE,CAAC,CAAC,IAAI,QAAQ,IACnD,MAAM,KAAA,CACE,IAAI,QAAQ;CAC1B;CAEA,MAAM,OACJ,OACA,IACA,OACgC;EAChC,MAAM,CAAC,OAAO,MAAM,KAAK,GACtB,OAAO,eAAe,CAAC,CACvB,IAAI;GACH,GAAI,cAAc,QAAQ,EAAE,UAAU,MAAM,YAAY,KAAK,IAAI,CAAC;GAClE,GAAI,iBAAiB,QACjB,EAAE,aAAa,MAAM,cAAc,IAAI,KAAK,MAAM,WAAW,IAAI,KAAK,IACtE,CAAC;EACP,CAAC,CAAC,CACD,MAAM,IAAI,GAAG,gBAAgB,OAAO,KAAK,GAAG,GAAG,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,CACxE,UAAU;EACb,OAAO,MAAM,SAAS,GAAG,IAAI;CAC/B;AACF"}

package/dist/repositories/settings.d.ts

@@ -0,0 +1,22 @@
+import { NodePgDatabase } from "drizzle-orm/node-postgres";
+import { Logger } from "@headless-lms/core/types";
+import { SettingsRecord, SettingsRepository } from "@headless-lms/core/shared/settings";
+//#region src/repositories/settings.d.ts
+/**
+ * Recursive merge of a partial patch into a stored value: a patch cannot
+ * clobber sibling keys at any depth, only the leaves it names. Arrays and
+ * scalars are replaced outright — merging arrays element-wise has no meaning
+ * for settings, and null is a value a caller may legitimately store.
+ * Exported for tests.
+ */
+declare function deepMerge(base: unknown, patch: unknown): unknown;
+declare class DrizzleSettingsRepository implements SettingsRepository {
+  private readonly db;
+  private readonly logger;
+  constructor(db: NodePgDatabase, logger?: Logger);
+  find(orgId: string, scopeId: string, namespace?: string): Promise<SettingsRecord[]>;
+  patch(orgId: string, namespace: string, scopeId: string, patch: Record<string, unknown>): Promise<SettingsRecord>;
+}
+//#endregion
+export { DrizzleSettingsRepository, deepMerge };
+//# sourceMappingURL=settings.d.ts.map

package/dist/repositories/settings.js

@@ -0,0 +1,73 @@
+import { settings } from "../schema/settings.js";
+import { and, eq } from "drizzle-orm";
+import { noopLogger } from "@headless-lms/core/shared/logger";
+//#region src/repositories/settings.ts
+function toRecord(row) {
+	return {
+		namespace: row.namespace,
+		scopeId: row.scopeId,
+		value: row.value
+	};
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Recursive merge of a partial patch into a stored value: a patch cannot
+* clobber sibling keys at any depth, only the leaves it names. Arrays and
+* scalars are replaced outright — merging arrays element-wise has no meaning
+* for settings, and null is a value a caller may legitimately store.
+* Exported for tests.
+*/
+function deepMerge(base, patch) {
+	if (!isPlainObject(base) || !isPlainObject(patch)) return patch;
+	const merged = { ...base };
+	for (const [key, value] of Object.entries(patch)) merged[key] = key in base ? deepMerge(base[key], value) : value;
+	return merged;
+}
+var DrizzleSettingsRepository = class {
+	db;
+	logger;
+	constructor(db, logger = noopLogger) {
+		this.db = db;
+		this.logger = logger;
+	}
+	async find(orgId, scopeId, namespace) {
+		const baseConditions = [eq(settings.orgId, orgId), eq(settings.scopeId, scopeId)];
+		const where = namespace ? and(...baseConditions, eq(settings.namespace, namespace)) : and(...baseConditions);
+		return (await this.db.select().from(settings).where(where)).map(toRecord);
+	}
+	async patch(orgId, namespace, scopeId, patch) {
+		const key = and(eq(settings.orgId, orgId), eq(settings.namespace, namespace), eq(settings.scopeId, scopeId));
+		const row = await this.db.transaction(async (tx) => {
+			let [existing] = await tx.select().from(settings).where(key).for("update");
+			if (!existing) {
+				const [inserted] = await tx.insert(settings).values({
+					orgId,
+					namespace,
+					scopeId,
+					value: patch
+				}).onConflictDoNothing().returning();
+				if (inserted) return inserted;
+				[existing] = await tx.select().from(settings).where(key).for("update");
+				if (!existing) throw new Error("settings patch: row vanished mid-transaction");
+			}
+			const [updated] = await tx.update(settings).set({
+				value: deepMerge(existing.value, patch),
+				updatedAt: /* @__PURE__ */ new Date()
+			}).where(key).returning();
+			return updated;
+		});
+		if (!row) throw new Error("settings patch returned no row");
+		this.logger.debug("settings.patch", {
+			orgId,
+			namespace,
+			scopeId
+		});
+		return toRecord(row);
+	}
+};
+//#endregion
+export { DrizzleSettingsRepository, deepMerge };
+
+//# sourceMappingURL=settings.js.map

package/dist/repositories/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","names":[],"sources":["../../src/repositories/settings.ts"],"sourcesContent":["import { and, eq } from 'drizzle-orm';\nimport type { Setting } from '@headless-lms/core/schemas';\nimport type { NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport type { SettingsRecord, SettingsRepository } from '@headless-lms/core/shared/settings';\nimport { settings } from '../schema/settings.js';\nimport type { Logger } from '@headless-lms/core/types';\nimport { noopLogger } from '@headless-lms/core/shared/logger';\n\ntype Row = typeof settings.$inferSelect;\n\nfunction toRecord(row: Row): SettingsRecord {\n  return {\n    namespace: row.namespace,\n    scopeId: row.scopeId,\n    value: row.value,\n  };\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Recursive merge of a partial patch into a stored value: a patch cannot\n * clobber sibling keys at any depth, only the leaves it names. Arrays and\n * scalars are replaced outright — merging arrays element-wise has no meaning\n * for settings, and null is a value a caller may legitimately store.\n * Exported for tests.\n */\nexport function deepMerge(base: unknown, patch: unknown): unknown {\n  if (!isPlainObject(base) || !isPlainObject(patch)) {\n    return patch;\n  }\n  const merged: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(patch)) {\n    merged[key] = key in base ? deepMerge(base[key], value) : value;\n  }\n  return merged;\n}\n\nexport class DrizzleSettingsRepository implements SettingsRepository {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async find(orgId: string, scopeId: string, namespace?: string): Promise<SettingsRecord[]> {\n    const baseConditions = [eq(settings.orgId, orgId), eq(settings.scopeId, scopeId)];\n    const where = namespace\n      ? and(...baseConditions, eq(settings.namespace, namespace))\n      : and(...baseConditions);\n\n    const rows = await this.db.select().from(settings).where(where);\n    return rows.map(toRecord);\n  }\n\n  async patch(\n    orgId: string,\n    namespace: string,\n    scopeId: string,\n    patch: Record<string, unknown>,\n  ): Promise<SettingsRecord> {\n    const key = and(\n      eq(settings.orgId, orgId),\n      eq(settings.namespace, namespace),\n      eq(settings.scopeId, scopeId),\n    );\n\n    // The merge happens in JS, so the read and the write must be one atomic\n    // unit or concurrent patches would clobber each other's sibling keys:\n    // SELECT ... FOR UPDATE holds the row for the rest of the transaction.\n    const row = await this.db.transaction(async (tx) => {\n      let [existing] = await tx.select().from(settings).where(key).for('update');\n\n      if (!existing) {\n        const [inserted] = await tx\n          .insert(settings)\n          .values({ orgId, namespace, scopeId, value: patch as Setting['value'] })\n          .onConflictDoNothing()\n          .returning();\n        if (inserted) {\n          return inserted;\n        }\n        // Lost the race: a concurrent transaction inserted the row and has\n        // committed by the time onConflictDoNothing returned. Take the lock\n        // and merge onto what it wrote.\n        [existing] = await tx.select().from(settings).where(key).for('update');\n        if (!existing) {\n          throw new Error('settings patch: row vanished mid-transaction');\n        }\n      }\n\n      const [updated] = await tx\n        .update(settings)\n        .set({ value: deepMerge(existing.value, patch) as Setting['value'], updatedAt: new Date() })\n        .where(key)\n        .returning();\n      return updated;\n    });\n\n    if (!row) {\n      throw new Error('settings patch returned no row');\n    }\n    this.logger.debug('settings.patch', { orgId, namespace, scopeId });\n    return toRecord(row);\n  }\n}\n"],"mappings":";;;;AAUA,SAAS,SAAS,KAA0B;CAC1C,OAAO;EACL,WAAW,IAAI;EACf,SAAS,IAAI;EACb,OAAO,IAAI;CACb;AACF;AAEA,SAAS,cAAc,OAAkD;CACvE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;;;;;AASA,SAAgB,UAAU,MAAe,OAAyB;CAChE,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,KAAK,GAC9C,OAAO;CAET,MAAM,SAAkC,EAAE,GAAG,KAAK;CAClD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,OAAO,OAAO,OAAO,OAAO,UAAU,KAAK,MAAM,KAAK,IAAI;CAE5D,OAAO;AACT;AAEA,IAAa,4BAAb,MAAqE;CAEhD;CACA;CAFnB,YACE,IACA,SAAkC,YAClC;EAFiB,KAAA,KAAA;EACA,KAAA,SAAA;CAChB;CAEH,MAAM,KAAK,OAAe,SAAiB,WAA+C;EACxF,MAAM,iBAAiB,CAAC,GAAG,SAAS,OAAO,KAAK,GAAG,GAAG,SAAS,SAAS,OAAO,CAAC;EAChF,MAAM,QAAQ,YACV,IAAI,GAAG,gBAAgB,GAAG,SAAS,WAAW,SAAS,CAAC,IACxD,IAAI,GAAG,cAAc;EAGzB,QAAO,MADY,KAAK,GAAG,OAAO,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,MAAM,KAAK,EAAA,CAClD,IAAI,QAAQ;CAC1B;CAEA,MAAM,MACJ,OACA,WACA,SACA,OACyB;EACzB,MAAM,MAAM,IACV,GAAG,SAAS,OAAO,KAAK,GACxB,GAAG,SAAS,WAAW,SAAS,GAChC,GAAG,SAAS,SAAS,OAAO,CAC9B;EAKA,MAAM,MAAM,MAAM,KAAK,GAAG,YAAY,OAAO,OAAO;GAClD,IAAI,CAAC,YAAY,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ;GAEzE,IAAI,CAAC,UAAU;IACb,MAAM,CAAC,YAAY,MAAM,GACtB,OAAO,QAAQ,CAAC,CAChB,OAAO;KAAE;KAAO;KAAW;KAAS,OAAO;IAA0B,CAAC,CAAC,CACvE,oBAAoB,CAAC,CACrB,UAAU;IACb,IAAI,UACF,OAAO;IAKT,CAAC,YAAY,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ;IACrE,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,8CAA8C;GAElE;GAEA,MAAM,CAAC,WAAW,MAAM,GACrB,OAAO,QAAQ,CAAC,CAChB,IAAI;IAAE,OAAO,UAAU,SAAS,OAAO,KAAK;IAAuB,2BAAW,IAAI,KAAK;GAAE,CAAC,CAAC,CAC3F,MAAM,GAAG,CAAC,CACV,UAAU;GACb,OAAO;EACT,CAAC;EAED,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,gCAAgC;EAElD,KAAK,OAAO,MAAM,kBAAkB;GAAE;GAAO;GAAW;EAAQ,CAAC;EACjE,OAAO,SAAS,GAAG;CACrB;AACF"}

package/dist/repositories/students.d.ts

@@ -0,0 +1,15 @@
+import { NodePgDatabase } from "drizzle-orm/node-postgres";
+import { Logger } from "@headless-lms/core/shared/ports";
+import { Page, Student, StudentsQuery, StudentsReportRepository } from "@headless-lms/core/reporting/students";
+//#region src/repositories/students.d.ts
+declare class DrizzleStudentsRepository implements StudentsReportRepository {
+  private readonly db;
+  private readonly logger;
+  constructor(db: NodePgDatabase, logger?: Logger);
+  list(orgId: string, query: StudentsQuery): Promise<Page<Student>>;
+  findById(orgId: string, id: string): Promise<Student | null>;
+  private resolveOrder;
+}
+//#endregion
+export { DrizzleStudentsRepository };
+//# sourceMappingURL=students.d.ts.map

package/dist/repositories/students.js

@@ -0,0 +1,83 @@
+import { users } from "../schema/identity.js";
+import { orgUsers } from "../schema/organizations.js";
+import { entitlements } from "../schema/entitlements.js";
+import "../schema/index.js";
+import { user } from "../schema/better-auth.js";
+import { orgUserProfileColumns } from "./org-user-profile.js";
+import { and, asc, desc, eq, ilike, or, sql } from "drizzle-orm";
+import { noopLogger } from "@headless-lms/core/shared/logger";
+import { STUDENT_ROLE } from "@headless-lms/core/organizations";
+//#region src/repositories/students.ts
+const entitlementCountExpr = sql`count(${entitlements.id})`;
+const avgProgressExpr = sql`0`;
+function toStudent(row) {
+	return {
+		id: row.id,
+		email: row.email,
+		image: row.image ?? null,
+		firstName: row.firstName,
+		lastName: row.lastName,
+		status: row.status,
+		entitlementCount: Number(row.entitlementCount),
+		avgProgress: Number(row.avgProgress),
+		joinedAt: row.createdAt.toISOString(),
+		lastActiveAt: null
+	};
+}
+var DrizzleStudentsRepository = class {
+	db;
+	logger;
+	constructor(db, logger = noopLogger) {
+		this.db = db;
+		this.logger = logger;
+	}
+	async list(orgId, query) {
+		const filters = [eq(orgUsers.orgId, orgId), eq(orgUsers.role, STUDENT_ROLE)];
+		const q = query.search?.trim();
+		if (q) {
+			const like = `%${q}%`;
+			filters.push(or(ilike(users.firstName, like), ilike(users.lastName, like), ilike(users.email, like)));
+		}
+		const where = and(...filters);
+		const [totals] = await this.db.select({ total: sql`count(*)` }).from(orgUsers).innerJoin(users, eq(users.id, orgUsers.userId)).where(where);
+		return {
+			rows: (await this.db.select({
+				...orgUserProfileColumns,
+				status: orgUsers.status,
+				createdAt: orgUsers.createdAt,
+				entitlementCount: entitlementCountExpr,
+				avgProgress: avgProgressExpr
+			}).from(orgUsers).leftJoin(entitlements, and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id))).innerJoin(users, eq(users.id, orgUsers.userId)).leftJoin(user, eq(user.id, users.externalId)).where(where).groupBy(orgUsers.orgId, orgUsers.id, orgUsers.status, users.email, users.firstName, users.lastName, user.image).orderBy(...this.resolveOrder(query.sort)).limit(query.pageSize).offset((query.page - 1) * query.pageSize)).map(toStudent),
+			total: Number(totals?.total ?? 0),
+			page: query.page,
+			pageSize: query.pageSize
+		};
+	}
+	async findById(orgId, id) {
+		const [row] = await this.db.select({
+			...orgUserProfileColumns,
+			status: orgUsers.status,
+			createdAt: orgUsers.createdAt,
+			entitlementCount: entitlementCountExpr,
+			avgProgress: avgProgressExpr
+		}).from(orgUsers).leftJoin(entitlements, and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id))).innerJoin(users, eq(users.id, orgUsers.userId)).leftJoin(user, eq(user.id, users.externalId)).where(and(eq(orgUsers.orgId, orgId), eq(orgUsers.id, id), eq(orgUsers.role, STUDENT_ROLE))).groupBy(orgUsers.orgId, orgUsers.id, orgUsers.status, users.email, users.firstName, users.lastName, user.image).limit(1);
+		return row ? toStudent(row) : null;
+	}
+	resolveOrder(sort) {
+		const descending = sort?.startsWith("-") ?? false;
+		const field = sort ? descending ? sort.slice(1) : sort : "firstName";
+		const dir = descending ? desc : asc;
+		switch (field) {
+			case "email": return [dir(users.email)];
+			case "entitlementCount": return [dir(entitlementCountExpr)];
+			case "avgProgress": return [dir(avgProgressExpr)];
+			case "joinedAt": return [dir(orgUsers.createdAt)];
+			case "lastName": return [dir(users.lastName), dir(users.firstName)];
+			default: return [dir(users.firstName), dir(users.lastName)];
+		}
+	}
+};
+//#endregion
+export { DrizzleStudentsRepository };
+
+//# sourceMappingURL=students.js.map

package/dist/repositories/students.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"students.js","names":[],"sources":["../../src/repositories/students.ts"],"sourcesContent":["// students — Drizzle repository (implements the core outbound port).\n// A read-model over org users + entitlements: a \"student\" row in the report is\n// any org_users row with role 'student', with or without entitlements. Rooted at\n// `org_users` and scoped by its org, with entitlements LEFT JOINed in for the\n// aggregated count. Name/email come from the identity `users` row (INNER, since\n// user_id is NOT NULL); the avatar comes from the better-auth `user` table,\n// LEFT JOINed via that same identity row.\nimport { and, asc, desc, eq, ilike, or, sql, type SQL } from 'drizzle-orm';\nimport type { NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport type {\n  Page,\n  Student,\n  StudentsQuery,\n  StudentsReportRepository,\n} from '@headless-lms/core/reporting/students';\nimport { orgUsers, users, entitlements } from '../schema/index.js';\nimport { STUDENT_ROLE } from '@headless-lms/core/organizations';\nimport { user } from '../schema/better-auth.js';\nimport type { OrgUserStatus } from '@headless-lms/core/types';\nimport type { Logger } from '@headless-lms/core/shared/ports';\nimport { noopLogger } from '@headless-lms/core/shared/logger';\nimport { orgUserProfileColumns } from './org-user-profile.js';\n\nconst entitlementCountExpr = sql<number>`count(${entitlements.id})`;\n// Completion now lives in the progress domain; the students report no longer\n// derives a percentage from entitlements. Placeholder until wired to progress.\nconst avgProgressExpr = sql<number>`0`;\n\ninterface StudentRow {\n  id: string;\n  email: string;\n  image: string | null;\n  firstName: string | null;\n  lastName: string | null;\n  status: OrgUserStatus;\n  createdAt: Date;\n  entitlementCount: number;\n  avgProgress: number;\n}\n\nfunction toStudent(row: StudentRow): Student {\n  return {\n    id: row.id,\n    email: row.email,\n    image: row.image ?? null,\n    firstName: row.firstName,\n    lastName: row.lastName,\n    status: row.status,\n    entitlementCount: Number(row.entitlementCount),\n    avgProgress: Number(row.avgProgress),\n    joinedAt: row.createdAt.toISOString(),\n    lastActiveAt: null,\n  };\n}\n\nexport class DrizzleStudentsRepository implements StudentsReportRepository {\n  constructor(\n    private readonly db: NodePgDatabase,\n    private readonly logger: Logger = noopLogger,\n  ) {}\n\n  async list(orgId: string, query: StudentsQuery): Promise<Page<Student>> {\n    // Staff share this table now — the role filter is what keeps them out of\n    // the students report.\n    const filters: SQL[] = [eq(orgUsers.orgId, orgId), eq(orgUsers.role, STUDENT_ROLE)];\n    const q = query.search?.trim();\n    if (q) {\n      const like = `%${q}%`;\n      filters.push(\n        or(\n          ilike(users.firstName, like),\n          ilike(users.lastName, like),\n          ilike(users.email, like),\n        )!,\n      );\n    }\n    const where = and(...filters);\n\n    const [totals] = await this.db\n      .select({ total: sql<number>`count(*)` })\n      .from(orgUsers)\n      .innerJoin(users, eq(users.id, orgUsers.userId))\n      .where(where);\n\n    const rows = await this.db\n      .select({\n        ...orgUserProfileColumns,\n        status: orgUsers.status,\n        createdAt: orgUsers.createdAt,\n        entitlementCount: entitlementCountExpr,\n        avgProgress: avgProgressExpr,\n      })\n      .from(orgUsers)\n      .leftJoin(\n        entitlements,\n        and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id)),\n      )\n      .innerJoin(users, eq(users.id, orgUsers.userId))\n      .leftJoin(user, eq(user.id, users.externalId))\n      .where(where)\n      // Group by the full composite PK (orgId, id): grouping by id alone gives\n      // Postgres no functional dependency for the other students columns.\n      .groupBy(\n        orgUsers.orgId,\n        orgUsers.id,\n        orgUsers.status,\n        users.email,\n        users.firstName,\n        users.lastName,\n        user.image,\n      )\n      .orderBy(...this.resolveOrder(query.sort))\n      .limit(query.pageSize)\n      .offset((query.page - 1) * query.pageSize);\n\n    return {\n      rows: rows.map(toStudent),\n      total: Number(totals?.total ?? 0),\n      page: query.page,\n      pageSize: query.pageSize,\n    };\n  }\n\n  async findById(orgId: string, id: string): Promise<Student | null> {\n    const [row] = await this.db\n      .select({\n        ...orgUserProfileColumns,\n        status: orgUsers.status,\n        createdAt: orgUsers.createdAt,\n        entitlementCount: entitlementCountExpr,\n        avgProgress: avgProgressExpr,\n      })\n      .from(orgUsers)\n      .leftJoin(\n        entitlements,\n        and(eq(entitlements.orgId, orgUsers.orgId), eq(entitlements.orgUserId, orgUsers.id)),\n      )\n      .innerJoin(users, eq(users.id, orgUsers.userId))\n      .leftJoin(user, eq(user.id, users.externalId))\n      .where(and(eq(orgUsers.orgId, orgId), eq(orgUsers.id, id), eq(orgUsers.role, STUDENT_ROLE)))\n      .groupBy(\n        orgUsers.orgId,\n        orgUsers.id,\n        orgUsers.status,\n        users.email,\n        users.firstName,\n        users.lastName,\n        user.image,\n      )\n      .limit(1);\n    return row ? toStudent(row) : null;\n  }\n\n  private resolveOrder(sort?: string): SQL[] {\n    const descending = sort?.startsWith('-') ?? false;\n    const field = sort ? (descending ? sort.slice(1) : sort) : 'firstName';\n    const dir = descending ? desc : asc;\n    switch (field) {\n      case 'email':\n        return [dir(users.email)];\n      case 'entitlementCount':\n        return [dir(entitlementCountExpr)];\n      case 'avgProgress':\n        return [dir(avgProgressExpr)];\n      case 'joinedAt':\n        return [dir(orgUsers.createdAt)];\n      case 'lastName':\n        return [dir(users.lastName), dir(users.firstName)];\n      case 'firstName':\n      default:\n        return [dir(users.firstName), dir(users.lastName)];\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/schema/assets.d.ts

@@ -0,0 +1,181 @@
+//#region src/schema/assets.d.ts
+declare const assets: import("drizzle-orm/pg-core").PgTableWithColumns<{
+  name: "assets";
+  schema: undefined;
+  columns: {
+    orgId: import("drizzle-orm/pg-core").PgColumn<{
+      name: "org_id";
+      tableName: "assets";
+      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: "assets";
+      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;
+    }, {}, {}>;
+    key: import("drizzle-orm/pg-core").PgColumn<{
+      name: "key";
+      tableName: "assets";
+      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;
+    }, {}, {}>;
+    kind: import("drizzle-orm/pg-core").PgColumn<{
+      name: "kind";
+      tableName: "assets";
+      dataType: "string";
+      columnType: "PgText";
+      data: "download" | "video" | "content";
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: ["video", "download", "content"];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    filename: import("drizzle-orm/pg-core").PgColumn<{
+      name: "filename";
+      tableName: "assets";
+      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;
+    }, {}, {}>;
+    contentType: import("drizzle-orm/pg-core").PgColumn<{
+      name: "content_type";
+      tableName: "assets";
+      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;
+    }, {}, {}>;
+    size: import("drizzle-orm/pg-core").PgColumn<{
+      name: "size";
+      tableName: "assets";
+      dataType: "number";
+      columnType: "PgBigInt53";
+      data: number;
+      driverParam: string | number;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    status: import("drizzle-orm/pg-core").PgColumn<{
+      name: "status";
+      tableName: "assets";
+      dataType: "string";
+      columnType: "PgText";
+      data: "pending" | "ready";
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: ["pending", "ready"];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    uploadedBy: import("drizzle-orm/pg-core").PgColumn<{
+      name: "uploaded_by";
+      tableName: "assets";
+      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;
+    }, {}, {}>;
+    createdAt: import("drizzle-orm/pg-core").PgColumn<{
+      name: "created_at";
+      tableName: "assets";
+      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 { assets };
+//# sourceMappingURL=assets.d.ts.map

package/dist/schema/assets.js

@@ -0,0 +1,24 @@
+import { organizations } from "./organizations.js";
+import { bigint, pgTable, primaryKey, text, timestamp } from "drizzle-orm/pg-core";
+import { genId } from "@headless-lms/core/shared/id";
+//#region src/schema/assets.ts
+const assets = pgTable("assets", {
+	orgId: text("org_id").notNull().references(() => organizations.id),
+	id: text("id").notNull().$defaultFn(() => genId("asset")),
+	key: text("key").notNull(),
+	kind: text("kind", { enum: [
+		"video",
+		"download",
+		"content"
+	] }).notNull(),
+	filename: text("filename").notNull(),
+	contentType: text("content_type").notNull(),
+	size: bigint("size", { mode: "number" }).notNull().default(0),
+	status: text("status", { enum: ["pending", "ready"] }).notNull().default("pending"),
+	uploadedBy: text("uploaded_by").notNull(),
+	createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => ({ pk: primaryKey({ columns: [t.orgId, t.id] }) }));
+//#endregion
+export { assets };
+
+//# sourceMappingURL=assets.js.map

package/dist/schema/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","names":[],"sources":["../../src/schema/assets.ts"],"sourcesContent":["// assets table — the org's media library. Org-scoped: composite (org_id, id) PK\n// with org_id → organizations.id, mirroring the multi-tenant table shape.\nimport { pgTable, text, bigint, timestamp, primaryKey } from 'drizzle-orm/pg-core';\nimport type { Asset } from '@headless-lms/core/schemas';\nimport { genId } from '@headless-lms/core/shared/id';\nimport { organizations } from './organizations.js';\nimport type { Expect, NoDrift } from './drift.js';\n\nexport const assets = pgTable(\n  'assets',\n  {\n    orgId: text('org_id')\n      .notNull()\n      .references(() => organizations.id),\n    id: text('id')\n      .notNull()\n      .$defaultFn(() => genId('asset')),\n    key: text('key').notNull(),\n    kind: text('kind', { enum: ['video', 'download', 'content'] }).notNull(),\n    filename: text('filename').notNull(),\n    contentType: text('content_type').notNull(),\n    // Bytes; bigint because media files exceed int4. 0 until upload confirmed.\n    size: bigint('size', { mode: 'number' }).notNull().default(0),\n    status: text('status', { enum: ['pending', 'ready'] })\n      .notNull()\n      .default('pending'),\n    uploadedBy: text('uploaded_by').notNull(),\n    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),\n  },\n  (t) => ({ pk: primaryKey({ columns: [t.orgId, t.id] }) }),\n);\n\ntype _AssetsDrift = Expect<NoDrift<typeof assets.$inferSelect, Asset>>;\n"],"mappings":";;;;AAQA,MAAa,SAAS,QACpB,UACA;CACE,OAAO,KAAK,QAAQ,CAAC,CAClB,QAAQ,CAAC,CACT,iBAAiB,cAAc,EAAE;CACpC,IAAI,KAAK,IAAI,CAAC,CACX,QAAQ,CAAC,CACT,iBAAiB,MAAM,OAAO,CAAC;CAClC,KAAK,KAAK,KAAK,CAAC,CAAC,QAAQ;CACzB,MAAM,KAAK,QAAQ,EAAE,MAAM;EAAC;EAAS;EAAY;CAAS,EAAE,CAAC,CAAC,CAAC,QAAQ;CACvE,UAAU,KAAK,UAAU,CAAC,CAAC,QAAQ;CACnC,aAAa,KAAK,cAAc,CAAC,CAAC,QAAQ;CAE1C,MAAM,OAAO,QAAQ,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;CAC5D,QAAQ,KAAK,UAAU,EAAE,MAAM,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC,CACnD,QAAQ,CAAC,CACT,QAAQ,SAAS;CACpB,YAAY,KAAK,aAAa,CAAC,CAAC,QAAQ;CACxC,WAAW,UAAU,cAAc,EAAE,cAAc,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW;AAClF,IACC,OAAO,EAAE,IAAI,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EACzD"}