@headless-lms/core 0.2.0 → 0.4.0

package/dist/shared/mailer.js

@@ -1,4 +1,26 @@
 //#region src/shared/mailer.ts
+var EmailRejectedError = class extends Error {
+	status;
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+		this.name = "EmailRejectedError";
+	}
+};
+function isEmailRejected(err) {
+	return err instanceof Error && err.name === "EmailRejectedError";
+}
+var EmailRenderError = class extends Error {
+	template;
+	constructor(template, cause) {
+		super(`email template ${template} failed to render: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+		this.template = template;
+		this.name = "EmailRenderError";
+	}
+};
+function isEmailRenderError(err) {
+	return err instanceof Error && err.name === "EmailRenderError";
+}
 var Mailer = class {
 	templates;
 	email;
@@ -9,10 +31,15 @@ var Mailer = class {
 		this.ctx = ctx;
 	}
 	async send(to, id, params, ctx) {
-		const content = await this.templates.render(id, {
-			...this.ctx,
-			...ctx
-		}, params);
+		let content;
+		try {
+			content = await this.templates.render(id, {
+				...this.ctx,
+				...ctx
+			}, params);
+		} catch (err) {
+			throw new EmailRenderError(id, err);
+		}
 		await this.email.send({
 			to,
 			subject: content.subject,
@@ -22,6 +49,6 @@ var Mailer = class {
 	}
 };
 //#endregion
-export { Mailer };
+export { EmailRejectedError, EmailRenderError, Mailer, isEmailRejected, isEmailRenderError };
 
 //# sourceMappingURL=mailer.js.map

package/dist/shared/mailer.js.map

@@ -1 +1 @@
-{"version":3,"file":"mailer.js","names":[],"sources":["../../src/shared/mailer.ts"],"sourcesContent":["// Composes a TemplateRenderer with an EmailSender: callers name a template,\n// the mailer resolves content and hands it to the transport.\nimport type {\n  EmailSender,\n  EmailTemplateId,\n  EmailTemplateParams,\n  TemplateContext,\n  TemplateRenderer,\n} from './ports.js';\nimport type { ContentType } from '../types/schemas/content.js';\n\n/** Resolves the recipient/content details a template needs when the\n *  triggering event carries only row ids. Wired by the app layer. */\nexport interface MailerLookups {\n  orgUserEmail(orgId: string, orgUserId: string): Promise<string | null>;\n  contentInfo(\n    orgId: string,\n    contentId: string,\n  ): Promise<{ id: string; title: string; type: ContentType } | null>;\n}\n\nexport class Mailer {\n  constructor(\n    private readonly templates: TemplateRenderer,\n    private readonly email: EmailSender,\n    private readonly ctx: TemplateContext,\n  ) {}\n\n  async send<K extends EmailTemplateId>(\n    to: string,\n    id: K,\n    params: EmailTemplateParams[K],\n    ctx?: Partial<TemplateContext>,\n  ): Promise<void> {\n    const content = await this.templates.render(id, { ...this.ctx, ...ctx }, params);\n    await this.email.send({ to, subject: content.subject, text: content.text, html: content.html });\n  }\n}\n"],"mappings":";AAqBA,IAAa,SAAb,MAAoB;CAEC;CACA;CACA;CAHnB,YACE,WACA,OACA,KACA;EAHiB,KAAA,YAAA;EACA,KAAA,QAAA;EACA,KAAA,MAAA;CAChB;CAEH,MAAM,KACJ,IACA,IACA,QACA,KACe;EACf,MAAM,UAAU,MAAM,KAAK,UAAU,OAAO,IAAI;GAAE,GAAG,KAAK;GAAK,GAAG;EAAI,GAAG,MAAM;EAC/E,MAAM,KAAK,MAAM,KAAK;GAAE;GAAI,SAAS,QAAQ;GAAS,MAAM,QAAQ;GAAM,MAAM,QAAQ;EAAK,CAAC;CAChG;AACF"}
+{"version":3,"file":"mailer.js","names":[],"sources":["../../src/shared/mailer.ts"],"sourcesContent":["// Composes a TemplateRenderer with an EmailSender: callers name a template,\n// the mailer resolves content and hands it to the transport.\nimport type {\n  EmailSender,\n  EmailTemplateId,\n  EmailTemplateParams,\n  TemplateContext,\n  TemplateRenderer,\n} from './ports.js';\nimport type { ContentType } from '../types/schemas/content.js';\n\n/** Resolves the recipient/content details a template needs when the\n *  triggering event carries only row ids. Wired by the app layer. */\nexport interface MailerLookups {\n  orgUserPerson(\n    orgId: string,\n    orgUserId: string,\n  ): Promise<{ userId: string; email: string } | null>;\n  contentInfo(\n    orgId: string,\n    contentId: string,\n  ): Promise<{ id: string; title: string; type: ContentType } | null>;\n}\n\nexport class EmailRejectedError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n  ) {\n    super(message);\n    this.name = 'EmailRejectedError';\n  }\n}\n\nexport function isEmailRejected(err: unknown): err is EmailRejectedError {\n  return err instanceof Error && err.name === 'EmailRejectedError';\n}\n\nexport class EmailRenderError extends Error {\n  constructor(\n    readonly template: string,\n    cause: unknown,\n  ) {\n    super(\n      `email template ${template} failed to render: ${cause instanceof Error ? cause.message : String(cause)}`,\n      { cause },\n    );\n    this.name = 'EmailRenderError';\n  }\n}\n\nexport function isEmailRenderError(err: unknown): err is EmailRenderError {\n  return err instanceof Error && err.name === 'EmailRenderError';\n}\n\nexport class Mailer {\n  constructor(\n    private readonly templates: TemplateRenderer,\n    private readonly email: EmailSender,\n    private readonly ctx: TemplateContext,\n  ) {}\n\n  async send<K extends EmailTemplateId>(\n    to: string,\n    id: K,\n    params: EmailTemplateParams[K],\n    ctx?: Partial<TemplateContext>,\n  ): Promise<void> {\n    let content: Awaited<ReturnType<TemplateRenderer['render']>>;\n    try {\n      content = await this.templates.render(id, { ...this.ctx, ...ctx }, params);\n    } catch (err) {\n      throw new EmailRenderError(id, err);\n    }\n    await this.email.send({ to, subject: content.subject, text: content.text, html: content.html });\n  }\n}\n"],"mappings":";AAwBA,IAAa,qBAAb,cAAwC,MAAM;CAGjC;CAFX,YACE,SACA,QACA;EACA,MAAM,OAAO;EAFJ,KAAA,SAAA;EAGT,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,gBAAgB,KAAyC;CACvE,OAAO,eAAe,SAAS,IAAI,SAAS;AAC9C;AAEA,IAAa,mBAAb,cAAsC,MAAM;CAE/B;CADX,YACE,UACA,OACA;EACA,MACE,kBAAkB,SAAS,qBAAqB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KACrG,EAAE,MAAM,CACV;EANS,KAAA,WAAA;EAOT,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,mBAAmB,KAAuC;CACxE,OAAO,eAAe,SAAS,IAAI,SAAS;AAC9C;AAEA,IAAa,SAAb,MAAoB;CAEC;CACA;CACA;CAHnB,YACE,WACA,OACA,KACA;EAHiB,KAAA,YAAA;EACA,KAAA,QAAA;EACA,KAAA,MAAA;CAChB;CAEH,MAAM,KACJ,IACA,IACA,QACA,KACe;EACf,IAAI;EACJ,IAAI;GACF,UAAU,MAAM,KAAK,UAAU,OAAO,IAAI;IAAE,GAAG,KAAK;IAAK,GAAG;GAAI,GAAG,MAAM;EAC3E,SAAS,KAAK;GACZ,MAAM,IAAI,iBAAiB,IAAI,GAAG;EACpC;EACA,MAAM,KAAK,MAAM,KAAK;GAAE;GAAI,SAAS,QAAQ;GAAS,MAAM,QAAQ;GAAM,MAAM,QAAQ;EAAK,CAAC;CAChG;AACF"}

package/dist/shared/network.d.ts

@@ -0,0 +1,10 @@
+//#region src/shared/network.d.ts
+/** True when `address` is an IP literal; brackets and an IPv6 zone are allowed. */
+declare function isIpLiteral(address: string): boolean;
+/** True only for an IP literal routable on the public internet; anything unparseable is not public. */
+declare function isPublicIp(address: string): boolean;
+/** False for localhost names and for IP literals outside the public internet. */
+declare function isPublicHostname(hostname: string): boolean;
+//#endregion
+export { isIpLiteral, isPublicHostname, isPublicIp };
+//# sourceMappingURL=network.d.ts.map

package/dist/shared/network.js

@@ -0,0 +1,211 @@
+//#region src/shared/network.ts
+const NON_PUBLIC_IPV4 = [
+	[ipv4Number([
+		0,
+		0,
+		0,
+		0
+	]), 8],
+	[ipv4Number([
+		10,
+		0,
+		0,
+		0
+	]), 8],
+	[ipv4Number([
+		100,
+		64,
+		0,
+		0
+	]), 10],
+	[ipv4Number([
+		127,
+		0,
+		0,
+		0
+	]), 8],
+	[ipv4Number([
+		169,
+		254,
+		0,
+		0
+	]), 16],
+	[ipv4Number([
+		172,
+		16,
+		0,
+		0
+	]), 12],
+	[ipv4Number([
+		192,
+		0,
+		0,
+		0
+	]), 24],
+	[ipv4Number([
+		192,
+		0,
+		2,
+		0
+	]), 24],
+	[ipv4Number([
+		192,
+		88,
+		99,
+		0
+	]), 24],
+	[ipv4Number([
+		192,
+		168,
+		0,
+		0
+	]), 16],
+	[ipv4Number([
+		198,
+		18,
+		0,
+		0
+	]), 15],
+	[ipv4Number([
+		198,
+		51,
+		100,
+		0
+	]), 24],
+	[ipv4Number([
+		203,
+		0,
+		113,
+		0
+	]), 24],
+	[ipv4Number([
+		224,
+		0,
+		0,
+		0
+	]), 4],
+	[ipv4Number([
+		240,
+		0,
+		0,
+		0
+	]), 4]
+];
+function ipv4Number(octets) {
+	return (octets[0] << 24 | octets[1] << 16 | octets[2] << 8 | octets[3]) >>> 0;
+}
+function parseIpv4(value) {
+	const parts = value.split(".");
+	if (parts.length !== 4 || !parts.every((part) => /^\d{1,3}$/.test(part))) return null;
+	const octets = parts.map(Number);
+	return octets.every((octet) => octet <= 255) ? octets : null;
+}
+function parseHextets(part) {
+	if (part === "") return [];
+	const groups = part.split(":");
+	const hextets = [];
+	for (const [i, group] of groups.entries()) if (i === groups.length - 1 && group.includes(".")) {
+		const octets = parseIpv4(group);
+		if (!octets) return null;
+		hextets.push(octets[0] << 8 | octets[1], octets[2] << 8 | octets[3]);
+	} else if (/^[0-9a-f]{1,4}$/i.test(group)) hextets.push(parseInt(group, 16));
+	else return null;
+	return hextets;
+}
+function parseIpv6(value) {
+	const halves = value.split("%")[0].split("::");
+	if (halves.length > 2) return null;
+	const head = parseHextets(halves[0]);
+	const tail = halves.length === 2 ? parseHextets(halves[1]) : [];
+	if (!head || !tail) return null;
+	const missing = 8 - head.length - tail.length;
+	if (halves.length === 2 ? missing < 1 : missing !== 0) return null;
+	return [
+		...head,
+		...new Array(missing).fill(0),
+		...tail
+	].flatMap((hextet) => [hextet >> 8, hextet & 255]);
+}
+function isPublicIpv4(octets) {
+	const address = ipv4Number(octets);
+	return NON_PUBLIC_IPV4.every(([network, bits]) => {
+		const mask = bits === 0 ? 0 : -1 << 32 - bits >>> 0;
+		return (address & mask) >>> 0 !== network;
+	});
+}
+function startsWith(bytes, prefix) {
+	return prefix.every((byte, i) => bytes[i] === byte);
+}
+function isPublicIpv6(bytes) {
+	if (bytes.slice(0, 10).every((b) => b === 0)) {
+		const mapped = bytes[10] === 255 && bytes[11] === 255;
+		const compatible = bytes[10] === 0 && bytes[11] === 0;
+		return (mapped || compatible) && isPublicIpv4(bytes.slice(12));
+	}
+	if (startsWith(bytes, [
+		0,
+		100,
+		255,
+		155,
+		0,
+		0,
+		0,
+		0,
+		0,
+		0,
+		0,
+		0
+	])) return isPublicIpv4(bytes.slice(12));
+	if (startsWith(bytes, [32, 2])) return isPublicIpv4(bytes.slice(2, 6));
+	const [first = 0, second = 0] = bytes;
+	return !((first & 254) === 252 || first === 254 && (second & 128) === 128 || first === 255 || startsWith(bytes, [
+		0,
+		100,
+		255,
+		155,
+		0,
+		1
+	]) || startsWith(bytes, [
+		1,
+		0,
+		0,
+		0,
+		0,
+		0,
+		0,
+		0
+	]) || startsWith(bytes, [
+		32,
+		1,
+		13,
+		184
+	]) || startsWith(bytes, [
+		32,
+		1,
+		0,
+		0
+	]));
+}
+/** True when `address` is an IP literal; brackets and an IPv6 zone are allowed. */
+function isIpLiteral(address) {
+	const bare = address.replace(/^\[(.*)\]$/, "$1");
+	return parseIpv4(bare) !== null || parseIpv6(bare) !== null;
+}
+/** True only for an IP literal routable on the public internet; anything unparseable is not public. */
+function isPublicIp(address) {
+	const bare = address.replace(/^\[(.*)\]$/, "$1");
+	const v4 = parseIpv4(bare);
+	if (v4) return isPublicIpv4(v4);
+	const v6 = parseIpv6(bare);
+	return v6 !== null && isPublicIpv6(v6);
+}
+/** False for localhost names and for IP literals outside the public internet. */
+function isPublicHostname(hostname) {
+	const host = hostname.toLowerCase().replace(/\.$/, "");
+	if (host === "localhost" || host.endsWith(".localhost")) return false;
+	return isIpLiteral(host) ? isPublicIp(host) : true;
+}
+//#endregion
+export { isIpLiteral, isPublicHostname, isPublicIp };
+
+//# sourceMappingURL=network.js.map

package/dist/shared/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","names":[],"sources":["../../src/shared/network.ts"],"sourcesContent":["const NON_PUBLIC_IPV4: ReadonlyArray<readonly [number, number]> = [\n  [ipv4Number([0, 0, 0, 0]), 8],\n  [ipv4Number([10, 0, 0, 0]), 8],\n  [ipv4Number([100, 64, 0, 0]), 10],\n  [ipv4Number([127, 0, 0, 0]), 8],\n  [ipv4Number([169, 254, 0, 0]), 16],\n  [ipv4Number([172, 16, 0, 0]), 12],\n  [ipv4Number([192, 0, 0, 0]), 24],\n  [ipv4Number([192, 0, 2, 0]), 24],\n  [ipv4Number([192, 88, 99, 0]), 24],\n  [ipv4Number([192, 168, 0, 0]), 16],\n  [ipv4Number([198, 18, 0, 0]), 15],\n  [ipv4Number([198, 51, 100, 0]), 24],\n  [ipv4Number([203, 0, 113, 0]), 24],\n  [ipv4Number([224, 0, 0, 0]), 4],\n  [ipv4Number([240, 0, 0, 0]), 4],\n];\n\nfunction ipv4Number(octets: number[]): number {\n  return ((octets[0]! << 24) | (octets[1]! << 16) | (octets[2]! << 8) | octets[3]!) >>> 0;\n}\n\nfunction parseIpv4(value: string): number[] | null {\n  const parts = value.split('.');\n  if (parts.length !== 4 || !parts.every((part) => /^\\d{1,3}$/.test(part))) {\n    return null;\n  }\n  const octets = parts.map(Number);\n  return octets.every((octet) => octet <= 255) ? octets : null;\n}\n\nfunction parseHextets(part: string): number[] | null {\n  if (part === '') {\n    return [];\n  }\n  const groups = part.split(':');\n  const hextets: number[] = [];\n  for (const [i, group] of groups.entries()) {\n    if (i === groups.length - 1 && group.includes('.')) {\n      const octets = parseIpv4(group);\n      if (!octets) {\n        return null;\n      }\n      hextets.push((octets[0]! << 8) | octets[1]!, (octets[2]! << 8) | octets[3]!);\n    } else if (/^[0-9a-f]{1,4}$/i.test(group)) {\n      hextets.push(parseInt(group, 16));\n    } else {\n      return null;\n    }\n  }\n  return hextets;\n}\n\nfunction parseIpv6(value: string): number[] | null {\n  const address = value.split('%')[0]!;\n  const halves = address.split('::');\n  if (halves.length > 2) {\n    return null;\n  }\n  const head = parseHextets(halves[0]!);\n  const tail = halves.length === 2 ? parseHextets(halves[1]!) : [];\n  if (!head || !tail) {\n    return null;\n  }\n  const missing = 8 - head.length - tail.length;\n  if (halves.length === 2 ? missing < 1 : missing !== 0) {\n    return null;\n  }\n  const hextets = [...head, ...new Array<number>(missing).fill(0), ...tail];\n  return hextets.flatMap((hextet) => [hextet >> 8, hextet & 0xff]);\n}\n\nfunction isPublicIpv4(octets: number[]): boolean {\n  const address = ipv4Number(octets);\n  return NON_PUBLIC_IPV4.every(([network, bits]) => {\n    const mask = bits === 0 ? 0 : (~0 << (32 - bits)) >>> 0;\n    return (address & mask) >>> 0 !== network;\n  });\n}\n\nfunction startsWith(bytes: number[], prefix: number[]): boolean {\n  return prefix.every((byte, i) => bytes[i] === byte);\n}\n\nfunction isPublicIpv6(bytes: number[]): boolean {\n  if (bytes.slice(0, 10).every((b) => b === 0)) {\n    const mapped = bytes[10] === 0xff && bytes[11] === 0xff;\n    const compatible = bytes[10] === 0 && bytes[11] === 0;\n    return (mapped || compatible) && isPublicIpv4(bytes.slice(12));\n  }\n  if (startsWith(bytes, [0x00, 0x64, 0xff, 0x9b, 0, 0, 0, 0, 0, 0, 0, 0])) {\n    return isPublicIpv4(bytes.slice(12));\n  }\n  if (startsWith(bytes, [0x20, 0x02])) {\n    return isPublicIpv4(bytes.slice(2, 6));\n  }\n  const [first = 0, second = 0] = bytes;\n  return !(\n    (first & 0xfe) === 0xfc ||\n    (first === 0xfe && (second & 0x80) === 0x80) ||\n    first === 0xff ||\n    startsWith(bytes, [0x00, 0x64, 0xff, 0x9b, 0x00, 0x01]) ||\n    startsWith(bytes, [0x01, 0x00, 0, 0, 0, 0, 0, 0]) ||\n    startsWith(bytes, [0x20, 0x01, 0x0d, 0xb8]) ||\n    startsWith(bytes, [0x20, 0x01, 0x00, 0x00])\n  );\n}\n\n/** True when `address` is an IP literal; brackets and an IPv6 zone are allowed. */\nexport function isIpLiteral(address: string): boolean {\n  const bare = address.replace(/^\\[(.*)\\]$/, '$1');\n  return parseIpv4(bare) !== null || parseIpv6(bare) !== null;\n}\n\n/** True only for an IP literal routable on the public internet; anything unparseable is not public. */\nexport function isPublicIp(address: string): boolean {\n  const bare = address.replace(/^\\[(.*)\\]$/, '$1');\n  const v4 = parseIpv4(bare);\n  if (v4) {\n    return isPublicIpv4(v4);\n  }\n  const v6 = parseIpv6(bare);\n  return v6 !== null && isPublicIpv6(v6);\n}\n\n/** False for localhost names and for IP literals outside the public internet. */\nexport function isPublicHostname(hostname: string): boolean {\n  const host = hostname.toLowerCase().replace(/\\.$/, '');\n  if (host === 'localhost' || host.endsWith('.localhost')) {\n    return false;\n  }\n  return isIpLiteral(host) ? isPublicIp(host) : true;\n}\n"],"mappings":"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"}

package/dist/shared/notification-categories.d.ts

@@ -0,0 +1,16 @@
+import { NotificationCategory, NotificationTypeDeclaration } from "../types/notifications.js";
+import "../types/index.js";
+import { NotificationTypeRegistry } from "./ports.js";
+import { ValidationProblem } from "./errors.js";
+//#region src/shared/notification-categories.d.ts
+type CategoryListScope = 'org' | 'community';
+declare function coversListScope(declaration: Pick<NotificationTypeDeclaration, 'scopes'>, listScope: CategoryListScope): boolean;
+declare function typesForList(types: Pick<NotificationTypeRegistry, 'list'>, listScope: CategoryListScope): Pick<NotificationTypeDeclaration, 'type' | 'scopes' | 'reasons'>[];
+declare function categoryListProblems(categories: NotificationCategory[], listScope: CategoryListScope, types: Pick<NotificationTypeRegistry, 'get'>, configured: string[]): ValidationProblem[];
+declare function assertValidCategoryList(categories: NotificationCategory[], listScope: CategoryListScope, types: Pick<NotificationTypeRegistry, 'get'>, configured: string[]): void;
+declare function channelOrder(configured: string[]): string[];
+declare function offeringConfigured(categories: NotificationCategory[], configured: string[]): NotificationCategory[];
+declare function storedCategoryList(value: unknown): NotificationCategory[] | null;
+//#endregion
+export { CategoryListScope, assertValidCategoryList, categoryListProblems, channelOrder, coversListScope, offeringConfigured, storedCategoryList, typesForList };
+//# sourceMappingURL=notification-categories.d.ts.map

package/dist/shared/notification-categories.js

@@ -0,0 +1,94 @@
+import { notificationCategoryListSchema } from "../types/schemas/notifications.js";
+import { ValidationError } from "./errors.js";
+//#region src/shared/notification-categories.ts
+const LIST_SCOPES = {
+	org: ["org"],
+	community: [
+		"community",
+		"space",
+		"chat"
+	]
+};
+function coversListScope(declaration, listScope) {
+	return declaration.scopes.some((scope) => LIST_SCOPES[listScope].includes(scope));
+}
+function typesForList(types, listScope) {
+	return types.list().filter((declaration) => coversListScope(declaration, listScope));
+}
+function categoryListProblems(categories, listScope, types, configured) {
+	const problems = [];
+	const problem = (path, message) => problems.push({
+		path,
+		message
+	});
+	const keys = /* @__PURE__ */ new Set();
+	const covered = /* @__PURE__ */ new Set();
+	categories.forEach((category, index) => {
+		const at = `categories[${index}]`;
+		if (keys.has(category.key)) problem(`${at}.key`, `the key ${category.key} is used by an earlier category`);
+		keys.add(category.key);
+		const pairs = [];
+		category.covers.forEach((cover, coverIndex) => {
+			const coverAt = `${at}.covers[${coverIndex}]`;
+			const declaration = types.get(cover.type);
+			if (!declaration) {
+				problem(`${coverAt}.type`, `${cover.type} is not a notification type`);
+				return;
+			}
+			if (!coversListScope(declaration, listScope)) problem(`${coverAt}.type`, `${cover.type} cannot be in the ${listScope} list`);
+			cover.reasons.forEach((reason, reasonIndex) => {
+				if (!declaration.reasons.includes(reason)) problem(`${coverAt}.reasons[${reasonIndex}]`, `${cover.type} does not allow the reason ${reason}`);
+				pairs.push(`${cover.type}:${reason}`);
+			});
+			if (category.perSpace === true && !declaration.scopes.includes("space")) problem(`${coverAt}.type`, `${cover.type} cannot occur in a space, so it cannot be per space`);
+		});
+		if (Object.keys(category.channels).length === 0) problem(`${at}.channels`, "the category offers no channel");
+		for (const channel of Object.keys(category.channels)) if (!configured.includes(channel)) problem(`${at}.channels.${channel}`, `the channel ${channel} is not configured`);
+		if (category.perSpace === true && listScope === "org") problem(`${at}.perSpace`, "only a community list can have a per-space category");
+		if (category.spaceDefaults !== void 0) {
+			if (category.perSpace !== true) problem(`${at}.spaceDefaults`, "spaceDefaults needs perSpace");
+			for (const [spaceId, channels] of Object.entries(category.spaceDefaults)) for (const channel of Object.keys(channels)) if (!(channel in category.channels)) problem(`${at}.spaceDefaults.${spaceId}.${channel}`, `spaceDefaults for ${spaceId} names the channel ${channel}, which the category does not offer`);
+		}
+		if (pairs.length > 0 && pairs.every((pair) => covered.has(pair))) problem(`${at}.covers`, "earlier categories already cover everything it covers");
+		for (const pair of pairs) covered.add(pair);
+	});
+	return problems;
+}
+function assertValidCategoryList(categories, listScope, types, configured) {
+	const problems = categoryListProblems(categories, listScope, types, configured);
+	if (problems.length > 0) throw new ValidationError(problems);
+}
+const LEADING_CHANNELS = [
+	"inApp",
+	"email",
+	"push"
+];
+function channelOrder(configured) {
+	return [...LEADING_CHANNELS.filter((channel) => configured.includes(channel)), ...configured.filter((channel) => !LEADING_CHANNELS.includes(channel))];
+}
+function inOrder(values, order) {
+	return Object.fromEntries(order.filter((channel) => channel in values).map((channel) => [channel, values[channel]]));
+}
+function offeringConfigured(categories, configured) {
+	const order = channelOrder(configured);
+	return categories.flatMap((category) => {
+		const channels = inOrder(category.channels, order);
+		if (Object.keys(channels).length === 0) return [];
+		const { spaceDefaults, ...rest } = category;
+		return [{
+			...rest,
+			channels,
+			...spaceDefaults !== void 0 && { spaceDefaults: Object.fromEntries(Object.entries(spaceDefaults).map(([spaceId, values]) => [spaceId, inOrder(values, Object.keys(channels))])) }
+		}];
+	});
+}
+function storedCategoryList(value) {
+	if (value === null || value === void 0) return null;
+	const parsed = notificationCategoryListSchema.safeParse(value);
+	if (!parsed.success) throw new Error(`stored notification categories are invalid: ${parsed.error.message}`);
+	return parsed.data;
+}
+//#endregion
+export { assertValidCategoryList, categoryListProblems, channelOrder, coversListScope, offeringConfigured, storedCategoryList, typesForList };
+
+//# sourceMappingURL=notification-categories.js.map

package/dist/shared/notification-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-categories.js","names":[],"sources":["../../src/shared/notification-categories.ts"],"sourcesContent":["import type { NotificationCategory, NotificationTypeDeclaration, Scope } from '../types/index.js';\nimport { notificationCategoryListSchema } from '../types/schemas/notifications.js';\nimport { ValidationError, type ValidationProblem } from './errors.js';\nimport type { NotificationTypeRegistry } from './ports.js';\n\nexport type CategoryListScope = 'org' | 'community';\n\nconst LIST_SCOPES: Record<CategoryListScope, Scope[]> = {\n  org: ['org'],\n  community: ['community', 'space', 'chat'],\n};\n\nexport function coversListScope(\n  declaration: Pick<NotificationTypeDeclaration, 'scopes'>,\n  listScope: CategoryListScope,\n): boolean {\n  return declaration.scopes.some((scope) => LIST_SCOPES[listScope].includes(scope));\n}\n\nexport function typesForList(\n  types: Pick<NotificationTypeRegistry, 'list'>,\n  listScope: CategoryListScope,\n): Pick<NotificationTypeDeclaration, 'type' | 'scopes' | 'reasons'>[] {\n  return types.list().filter((declaration) => coversListScope(declaration, listScope));\n}\n\nexport function categoryListProblems(\n  categories: NotificationCategory[],\n  listScope: CategoryListScope,\n  types: Pick<NotificationTypeRegistry, 'get'>,\n  configured: string[],\n): ValidationProblem[] {\n  const problems: ValidationProblem[] = [];\n  const problem = (path: string, message: string) => problems.push({ path, message });\n  const keys = new Set<string>();\n  const covered = new Set<string>();\n  categories.forEach((category, index) => {\n    const at = `categories[${index}]`;\n    if (keys.has(category.key)) {\n      problem(`${at}.key`, `the key ${category.key} is used by an earlier category`);\n    }\n    keys.add(category.key);\n    const pairs: string[] = [];\n    category.covers.forEach((cover, coverIndex) => {\n      const coverAt = `${at}.covers[${coverIndex}]`;\n      const declaration = types.get(cover.type);\n      if (!declaration) {\n        problem(`${coverAt}.type`, `${cover.type} is not a notification type`);\n        return;\n      }\n      if (!coversListScope(declaration, listScope)) {\n        problem(`${coverAt}.type`, `${cover.type} cannot be in the ${listScope} list`);\n      }\n      cover.reasons.forEach((reason, reasonIndex) => {\n        if (!declaration.reasons.includes(reason)) {\n          problem(\n            `${coverAt}.reasons[${reasonIndex}]`,\n            `${cover.type} does not allow the reason ${reason}`,\n          );\n        }\n        pairs.push(`${cover.type}:${reason}`);\n      });\n      if (category.perSpace === true && !declaration.scopes.includes('space')) {\n        problem(\n          `${coverAt}.type`,\n          `${cover.type} cannot occur in a space, so it cannot be per space`,\n        );\n      }\n    });\n    if (Object.keys(category.channels).length === 0) {\n      problem(`${at}.channels`, 'the category offers no channel');\n    }\n    for (const channel of Object.keys(category.channels)) {\n      if (!configured.includes(channel)) {\n        problem(`${at}.channels.${channel}`, `the channel ${channel} is not configured`);\n      }\n    }\n    if (category.perSpace === true && listScope === 'org') {\n      problem(`${at}.perSpace`, 'only a community list can have a per-space category');\n    }\n    if (category.spaceDefaults !== undefined) {\n      if (category.perSpace !== true) {\n        problem(`${at}.spaceDefaults`, 'spaceDefaults needs perSpace');\n      }\n      for (const [spaceId, channels] of Object.entries(category.spaceDefaults)) {\n        for (const channel of Object.keys(channels)) {\n          if (!(channel in category.channels)) {\n            problem(\n              `${at}.spaceDefaults.${spaceId}.${channel}`,\n              `spaceDefaults for ${spaceId} names the channel ${channel}, which the category does not offer`,\n            );\n          }\n        }\n      }\n    }\n    if (pairs.length > 0 && pairs.every((pair) => covered.has(pair))) {\n      problem(`${at}.covers`, 'earlier categories already cover everything it covers');\n    }\n    for (const pair of pairs) {\n      covered.add(pair);\n    }\n  });\n  return problems;\n}\n\nexport function assertValidCategoryList(\n  categories: NotificationCategory[],\n  listScope: CategoryListScope,\n  types: Pick<NotificationTypeRegistry, 'get'>,\n  configured: string[],\n): void {\n  const problems = categoryListProblems(categories, listScope, types, configured);\n  if (problems.length > 0) {\n    throw new ValidationError(problems);\n  }\n}\n\nconst LEADING_CHANNELS = ['inApp', 'email', 'push'];\n\nexport function channelOrder(configured: string[]): string[] {\n  return [\n    ...LEADING_CHANNELS.filter((channel) => configured.includes(channel)),\n    ...configured.filter((channel) => !LEADING_CHANNELS.includes(channel)),\n  ];\n}\n\nfunction inOrder<T>(values: Record<string, T>, order: string[]): Record<string, T> {\n  return Object.fromEntries(\n    order.filter((channel) => channel in values).map((channel) => [channel, values[channel]!]),\n  );\n}\n\nexport function offeringConfigured(\n  categories: NotificationCategory[],\n  configured: string[],\n): NotificationCategory[] {\n  const order = channelOrder(configured);\n  return categories.flatMap((category) => {\n    const channels = inOrder(category.channels, order);\n    if (Object.keys(channels).length === 0) {\n      return [];\n    }\n    const { spaceDefaults, ...rest } = category;\n    return [\n      {\n        ...rest,\n        channels,\n        ...(spaceDefaults !== undefined && {\n          spaceDefaults: Object.fromEntries(\n            Object.entries(spaceDefaults).map(([spaceId, values]) => [\n              spaceId,\n              inOrder(values, Object.keys(channels)),\n            ]),\n          ),\n        }),\n      },\n    ];\n  });\n}\n\nexport function storedCategoryList(value: unknown): NotificationCategory[] | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  const parsed = notificationCategoryListSchema.safeParse(value);\n  if (!parsed.success) {\n    throw new Error(`stored notification categories are invalid: ${parsed.error.message}`);\n  }\n  return parsed.data;\n}\n"],"mappings":"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"}

package/dist/shared/notification-settings.d.ts

@@ -0,0 +1,14 @@
+import { NotificationCategory, StoredSetting } from "../types/notifications.js";
+import "../types/index.js";
+//#region src/shared/notification-settings.d.ts
+type ChannelSource = 'locked' | 'space' | 'community' | 'spaceDefault' | 'default';
+interface ResolvedChannel {
+  channel: string;
+  enabled: boolean;
+  source: ChannelSource;
+  locked: boolean;
+}
+declare function resolveChannels(category: NotificationCategory, settings: StoredSetting[], spaceId: string | null, configured: string[]): ResolvedChannel[];
+//#endregion
+export { ChannelSource, ResolvedChannel, resolveChannels };
+//# sourceMappingURL=notification-settings.d.ts.map

package/dist/shared/notification-settings.js

@@ -0,0 +1,61 @@
+//#region src/shared/notification-settings.ts
+function resolveChannels(category, settings, spaceId, configured) {
+	const perSpace = category.perSpace === true;
+	const ownSettings = settings.filter((s) => s.category === category.key);
+	const resolved = [];
+	for (const channel of configured) {
+		const offered = category.channels[channel];
+		if (!offered) continue;
+		if (offered.locked) {
+			resolved.push({
+				channel,
+				enabled: offered.default,
+				source: "locked",
+				locked: true
+			});
+			continue;
+		}
+		const forChannel = ownSettings.filter((s) => s.channel === channel);
+		const spaceSetting = perSpace && spaceId !== null ? forChannel.find((s) => s.spaceId === spaceId) : void 0;
+		if (spaceSetting) {
+			resolved.push({
+				channel,
+				enabled: spaceSetting.enabled,
+				source: "space",
+				locked: false
+			});
+			continue;
+		}
+		const communitySetting = forChannel.find((s) => s.spaceId === null);
+		if (communitySetting) {
+			resolved.push({
+				channel,
+				enabled: communitySetting.enabled,
+				source: "community",
+				locked: false
+			});
+			continue;
+		}
+		const spaceDefault = perSpace && spaceId !== null ? category.spaceDefaults?.[spaceId]?.[channel] : void 0;
+		if (spaceDefault !== void 0) {
+			resolved.push({
+				channel,
+				enabled: spaceDefault,
+				source: "spaceDefault",
+				locked: false
+			});
+			continue;
+		}
+		resolved.push({
+			channel,
+			enabled: offered.default,
+			source: "default",
+			locked: false
+		});
+	}
+	return resolved;
+}
+//#endregion
+export { resolveChannels };
+
+//# sourceMappingURL=notification-settings.js.map

package/dist/shared/notification-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-settings.js","names":[],"sources":["../../src/shared/notification-settings.ts"],"sourcesContent":["import type { NotificationCategory, StoredSetting } from '../types/index.js';\n\nexport type ChannelSource = 'locked' | 'space' | 'community' | 'spaceDefault' | 'default';\n\nexport interface ResolvedChannel {\n  channel: string;\n  enabled: boolean;\n  source: ChannelSource;\n  locked: boolean;\n}\n\nexport function resolveChannels(\n  category: NotificationCategory,\n  settings: StoredSetting[],\n  spaceId: string | null,\n  configured: string[],\n): ResolvedChannel[] {\n  const perSpace = category.perSpace === true;\n  const ownSettings = settings.filter((s) => s.category === category.key);\n  const resolved: ResolvedChannel[] = [];\n  for (const channel of configured) {\n    const offered = category.channels[channel];\n    if (!offered) {\n      continue;\n    }\n    if (offered.locked) {\n      resolved.push({ channel, enabled: offered.default, source: 'locked', locked: true });\n      continue;\n    }\n    const forChannel = ownSettings.filter((s) => s.channel === channel);\n    const spaceSetting =\n      perSpace && spaceId !== null ? forChannel.find((s) => s.spaceId === spaceId) : undefined;\n    if (spaceSetting) {\n      resolved.push({ channel, enabled: spaceSetting.enabled, source: 'space', locked: false });\n      continue;\n    }\n    const communitySetting = forChannel.find((s) => s.spaceId === null);\n    if (communitySetting) {\n      resolved.push({\n        channel,\n        enabled: communitySetting.enabled,\n        source: 'community',\n        locked: false,\n      });\n      continue;\n    }\n    const spaceDefault =\n      perSpace && spaceId !== null ? category.spaceDefaults?.[spaceId]?.[channel] : undefined;\n    if (spaceDefault !== undefined) {\n      resolved.push({ channel, enabled: spaceDefault, source: 'spaceDefault', locked: false });\n      continue;\n    }\n    resolved.push({ channel, enabled: offered.default, source: 'default', locked: false });\n  }\n  return resolved;\n}\n"],"mappings":";AAWA,SAAgB,gBACd,UACA,UACA,SACA,YACmB;CACnB,MAAM,WAAW,SAAS,aAAa;CACvC,MAAM,cAAc,SAAS,QAAQ,MAAM,EAAE,aAAa,SAAS,GAAG;CACtE,MAAM,WAA8B,CAAC;CACrC,KAAK,MAAM,WAAW,YAAY;EAChC,MAAM,UAAU,SAAS,SAAS;EAClC,IAAI,CAAC,SACH;EAEF,IAAI,QAAQ,QAAQ;GAClB,SAAS,KAAK;IAAE;IAAS,SAAS,QAAQ;IAAS,QAAQ;IAAU,QAAQ;GAAK,CAAC;GACnF;EACF;EACA,MAAM,aAAa,YAAY,QAAQ,MAAM,EAAE,YAAY,OAAO;EAClE,MAAM,eACJ,YAAY,YAAY,OAAO,WAAW,MAAM,MAAM,EAAE,YAAY,OAAO,IAAI,KAAA;EACjF,IAAI,cAAc;GAChB,SAAS,KAAK;IAAE;IAAS,SAAS,aAAa;IAAS,QAAQ;IAAS,QAAQ;GAAM,CAAC;GACxF;EACF;EACA,MAAM,mBAAmB,WAAW,MAAM,MAAM,EAAE,YAAY,IAAI;EAClE,IAAI,kBAAkB;GACpB,SAAS,KAAK;IACZ;IACA,SAAS,iBAAiB;IAC1B,QAAQ;IACR,QAAQ;GACV,CAAC;GACD;EACF;EACA,MAAM,eACJ,YAAY,YAAY,OAAO,SAAS,gBAAgB,QAAQ,GAAG,WAAW,KAAA;EAChF,IAAI,iBAAiB,KAAA,GAAW;GAC9B,SAAS,KAAK;IAAE;IAAS,SAAS;IAAc,QAAQ;IAAgB,QAAQ;GAAM,CAAC;GACvF;EACF;EACA,SAAS,KAAK;GAAE;GAAS,SAAS,QAAQ;GAAS,QAAQ;GAAW,QAAQ;EAAM,CAAC;CACvF;CACA,OAAO;AACT"}

package/dist/shared/ports.d.ts

@@ -1,7 +1,8 @@
-import { DomainEvent, NewDomainEvent } from "../types/shared.js";
+import { DomainEvent, JsonValue, NewDomainEvent } from "../types/shared.js";
 import { EventDefinition } from "../types/events.js";
 import { EmailMessage, EmailSender, Logger, ObjectStorage, PresignDownloadInput, PresignedUpload, StoredObjectInfo } from "../types/ports.js";
 import { EmailContent, EmailTemplateId, EmailTemplateParams, TemplateContext, TemplateRenderer } from "../types/email-templates.js";
+import { ChannelRecipient, DeliveryResult, NotificationCategory, NotificationTypeDeclaration, PushDevice, PushMessage, StoredNotification } from "../types/notifications.js";
 import "../types/index.js";
 import { EventOf, EventOfValues, InvalidDomainEventError, RuntimeEventDefinition, defineEvent, eventIdSchema, eventJsonValueSchema, eventMetadataSchema } from "./events.js";
 //#region src/shared/ports.d.ts
@@ -57,6 +58,51 @@ interface CredentialStore {
   /** Permanently delete stored secrets (e.g. disconnect). */
   destroy(orgId: string, ref: string): Promise<void>;
 }
+interface NotificationTypeRegistry {
+  list(): Pick<NotificationTypeDeclaration, 'type' | 'scopes' | 'reasons'>[];
+  get(type: string): NotificationTypeDeclaration | undefined;
+  defaults(scope: 'org' | 'community'): NotificationCategory[];
+}
+interface NotificationChannel {
+  key: string;
+  recipient(orgId: string, userId: string): Promise<ChannelRecipient | null>;
+  deliver(notification: StoredNotification, to: ChannelRecipient): Promise<DeliveryResult>;
+}
+interface ChannelRegistry {
+  list(): string[];
+  get(key: string): NotificationChannel | undefined;
+}
+interface NotificationCategoryService {
+  get(orgId: string, scopeId: string): Promise<{
+    categories: NotificationCategory[];
+    source: 'default' | 'stored';
+  }>;
+  replace(orgId: string, scopeId: string, categories: NotificationCategory[]): Promise<{
+    categories: NotificationCategory[];
+    source: 'stored';
+  }>;
+  reset(orgId: string, scopeId: string): Promise<void>;
+  defaults(): NotificationCategory[];
+}
+interface PushSender {
+  send(devices: PushDevice[], message: PushMessage): Promise<DeliveryResult>;
+}
+interface ScheduledJob {
+  job: string;
+  run(payload: JsonValue, fire: {
+    id: string;
+    startedAt: Date;
+  }): Promise<void>;
+}
+interface RecurringJob {
+  job: string;
+  cron: string;
+}
+interface Scheduler {
+  registerJobs(handlers: ScheduledJob[], recurring: RecurringJob[]): void;
+  at(job: string, runAt: Date, key: string, payload: JsonValue): Promise<void>;
+  cancel(job: string, key: string): Promise<void>;
+}
 //#endregion
-export { Clock, CredentialStore, type DomainEvent, type EmailContent, type EmailMessage, type EmailSender, type EmailTemplateId, type EmailTemplateParams, EventBus, type EventDefinition, type EventOf, type EventOfValues, InvalidDomainEventError, type Logger, type NewDomainEvent, type ObjectStorage, OutboxAppender, OutboxMessage, OutboxRelay, OutboxStore, type PresignDownloadInput, type PresignedUpload, type RuntimeEventDefinition, type StoredObjectInfo, type TemplateContext, type TemplateRenderer, UnitOfWork, defineEvent, eventIdSchema, eventJsonValueSchema, eventMetadataSchema };
+export { type ChannelRecipient, ChannelRegistry, Clock, CredentialStore, type DeliveryResult, type DomainEvent, type EmailContent, type EmailMessage, type EmailSender, type EmailTemplateId, type EmailTemplateParams, EventBus, type EventDefinition, type EventOf, type EventOfValues, InvalidDomainEventError, type JsonValue, type Logger, type NewDomainEvent, type NotificationCategory, NotificationCategoryService, NotificationChannel, type NotificationTypeDeclaration, NotificationTypeRegistry, type ObjectStorage, OutboxAppender, OutboxMessage, OutboxRelay, OutboxStore, type PresignDownloadInput, type PresignedUpload, type PushDevice, type PushMessage, PushSender, RecurringJob, type RuntimeEventDefinition, ScheduledJob, Scheduler, type StoredNotification, type StoredObjectInfo, type TemplateContext, type TemplateRenderer, UnitOfWork, defineEvent, eventIdSchema, eventJsonValueSchema, eventMetadataSchema };
 //# sourceMappingURL=ports.d.ts.map

package/dist/shared/settings.d.ts

@@ -5,7 +5,8 @@ interface SettingsRecord {
   value?: Record<string, unknown>;
 }
 declare enum SettingsNamespace {
-  content = "content"
+  content = "content",
+  organizations = "organizations"
 }
 interface SettingsRepository {
   /** Rows for the given scopes, optionally narrowed to one namespace. */

package/dist/shared/settings.js

@@ -1,6 +1,7 @@
 //#region src/shared/settings.ts
 let SettingsNamespace = /* @__PURE__ */ function(SettingsNamespace) {
 	SettingsNamespace["content"] = "content";
+	SettingsNamespace["organizations"] = "organizations";
 	return SettingsNamespace;
 }({});
 var SettingsService = class {

package/dist/shared/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","names":[],"sources":["../../src/shared/settings.ts"],"sourcesContent":["// Cross-cutting settings: storage, scoping and resolution for every domain's\n// configuration. Not a bounded context: it is a leaf every context may import, and it imports\n// no context.\n\nexport interface SettingsRecord {\n  namespace: string;\n  scopeId: string;\n  value?: Record<string, unknown>;\n}\n\nexport enum SettingsNamespace {\n  content = 'content',\n}\n\nexport interface SettingsRepository {\n  /** Rows for the given scopes, optionally narrowed to one namespace. */\n  find(orgId: string, scopeId: string, namespace?: string): Promise<SettingsRecord[]>;\n  /** Deep-merges the patch into the row's value, inserting when absent. Nested\n   *  objects merge key by key; arrays and scalars are replaced outright. */\n  patch(orgId: string, namespace: string, scopeId: string, value: unknown): Promise<SettingsRecord>;\n}\n\nexport class SettingsService {\n  constructor(private readonly repo: SettingsRepository) {}\n\n  async get<T>(\n    orgId: string,\n    namespace: string,\n    scopeId: string,\n    defaultIfNull?: T,\n  ): Promise<T | undefined> {\n    const rows = await this.repo.find(orgId, scopeId, namespace);\n    return (rows[0]?.value as T) ?? defaultIfNull;\n  }\n\n  async patch<T>(orgId: string, namespace: string, scopeId: string, value: unknown): Promise<T> {\n    const row = await this.repo.patch(orgId, namespace, scopeId, value);\n    return row.value as T;\n  }\n}\n"],"mappings":";AAUA,IAAY,oBAAL,yBAAA,mBAAA;CACL,kBAAA,aAAA;;AACF,EAAA,CAAA,CAAA;AAUA,IAAa,kBAAb,MAA6B;CACE;CAA7B,YAAY,MAA2C;EAA1B,KAAA,OAAA;CAA2B;CAExD,MAAM,IACJ,OACA,WACA,SACA,eACwB;EAExB,QAAQ,MADW,KAAK,KAAK,KAAK,OAAO,SAAS,SAAS,EAAA,CAC9C,EAAE,EAAE,SAAe;CAClC;CAEA,MAAM,MAAS,OAAe,WAAmB,SAAiB,OAA4B;EAE5F,QAAO,MADW,KAAK,KAAK,MAAM,OAAO,WAAW,SAAS,KAAK,EAAA,CACvD;CACb;AACF"}
+{"version":3,"file":"settings.js","names":[],"sources":["../../src/shared/settings.ts"],"sourcesContent":["// Cross-cutting settings: storage, scoping and resolution for every domain's\n// configuration. Not a bounded context: it is a leaf every context may import, and it imports\n// no context.\n\nexport interface SettingsRecord {\n  namespace: string;\n  scopeId: string;\n  value?: Record<string, unknown>;\n}\n\nexport enum SettingsNamespace {\n  content = 'content',\n  organizations = 'organizations',\n}\n\nexport interface SettingsRepository {\n  /** Rows for the given scopes, optionally narrowed to one namespace. */\n  find(orgId: string, scopeId: string, namespace?: string): Promise<SettingsRecord[]>;\n  /** Deep-merges the patch into the row's value, inserting when absent. Nested\n   *  objects merge key by key; arrays and scalars are replaced outright. */\n  patch(orgId: string, namespace: string, scopeId: string, value: unknown): Promise<SettingsRecord>;\n}\n\nexport class SettingsService {\n  constructor(private readonly repo: SettingsRepository) {}\n\n  async get<T>(\n    orgId: string,\n    namespace: string,\n    scopeId: string,\n    defaultIfNull?: T,\n  ): Promise<T | undefined> {\n    const rows = await this.repo.find(orgId, scopeId, namespace);\n    return (rows[0]?.value as T) ?? defaultIfNull;\n  }\n\n  async patch<T>(orgId: string, namespace: string, scopeId: string, value: unknown): Promise<T> {\n    const row = await this.repo.patch(orgId, namespace, scopeId, value);\n    return row.value as T;\n  }\n}\n"],"mappings":";AAUA,IAAY,oBAAL,yBAAA,mBAAA;CACL,kBAAA,aAAA;CACA,kBAAA,mBAAA;;AACF,EAAA,CAAA,CAAA;AAUA,IAAa,kBAAb,MAA6B;CACE;CAA7B,YAAY,MAA2C;EAA1B,KAAA,OAAA;CAA2B;CAExD,MAAM,IACJ,OACA,WACA,SACA,eACwB;EAExB,QAAQ,MADW,KAAK,KAAK,KAAK,OAAO,SAAS,SAAS,EAAA,CAC9C,EAAE,EAAE,SAAe;CAClC;CAEA,MAAM,MAAS,OAAe,WAAmB,SAAiB,OAA4B;EAE5F,QAAO,MADW,KAAK,KAAK,MAAM,OAAO,WAAW,SAAS,KAAK,EAAA,CACvD;CACb;AACF"}

package/dist/types/assets.d.ts

@@ -1,2 +1,2 @@
-import { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "./schemas/assets.js";
-export type { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket };
+import { Asset, AssetKind, AssetSource, AssetStatus, AssetUrls, AssetView, AssetsQuery, RequestUploadInput, UploadTicket } from "./schemas/assets.js";
+export type { Asset, AssetKind, AssetSource, AssetStatus, AssetUrls, AssetView, AssetsQuery, RequestUploadInput, UploadTicket };