@headless-lms/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mdwt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/assets/events.d.ts

@@ -0,0 +1,81 @@
+import { EventOf, EventOfValues, RuntimeEventDefinition, VersionedDomainEvent } from "../shared/events.js";
+import "../shared/ports.js";
+//#region src/assets/events.d.ts
+declare const assetEvents: {
+  assetCreated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    key: string;
+    kind: "video" | "download" | "content";
+    filename: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "ready";
+    uploadedBy: string;
+    createdAt: Date;
+  }, "asset.created", 1>, {
+    orgId: string;
+    id: string;
+    key: string;
+    kind: "video" | "download" | "content";
+    filename: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "ready";
+    uploadedBy: string;
+    createdAt: unknown;
+  }>;
+  assetReady: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    key: string;
+    kind: "video" | "download" | "content";
+    filename: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "ready";
+    uploadedBy: string;
+    createdAt: Date;
+  }, "asset.ready", 1>, {
+    orgId: string;
+    id: string;
+    key: string;
+    kind: "video" | "download" | "content";
+    filename: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "ready";
+    uploadedBy: string;
+    createdAt: unknown;
+  }>;
+  assetDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    key: string;
+    kind: "video" | "download" | "content";
+    filename: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "ready";
+    uploadedBy: string;
+    createdAt: Date;
+  }, "asset.deleted", 1>, {
+    orgId: string;
+    id: string;
+    key: string;
+    kind: "video" | "download" | "content";
+    filename: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "ready";
+    uploadedBy: string;
+    createdAt: unknown;
+  }>;
+};
+type AssetCreated = EventOf<typeof assetEvents.assetCreated>;
+type AssetReady = EventOf<typeof assetEvents.assetReady>;
+type AssetDeleted = EventOf<typeof assetEvents.assetDeleted>;
+type AssetEvent = EventOfValues<typeof assetEvents>;
+//#endregion
+export { AssetCreated, AssetDeleted, AssetEvent, AssetReady, assetEvents };
+//# sourceMappingURL=events.d.ts.map

package/dist/assets/events.js

@@ -0,0 +1,24 @@
+import { assetSchema } from "../types/schemas/assets.js";
+import { defineEvent } from "../shared/events.js";
+//#region src/assets/events.ts
+const assetEvents = {
+	assetCreated: defineEvent({
+		type: "asset.created",
+		version: 1,
+		data: assetSchema
+	}),
+	assetReady: defineEvent({
+		type: "asset.ready",
+		version: 1,
+		data: assetSchema
+	}),
+	assetDeleted: defineEvent({
+		type: "asset.deleted",
+		version: 1,
+		data: assetSchema
+	})
+};
+//#endregion
+export { assetEvents };
+
+//# sourceMappingURL=events.js.map

package/dist/assets/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../src/assets/events.ts"],"sourcesContent":["import { assetSchema } from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nexport const assetEvents = {\n  assetCreated: defineEvent({\n    type: 'asset.created',\n    version: 1,\n    data: assetSchema,\n  }),\n  assetReady: defineEvent({\n    type: 'asset.ready',\n    version: 1,\n    data: assetSchema,\n  }),\n  assetDeleted: defineEvent({\n    type: 'asset.deleted',\n    version: 1,\n    data: assetSchema,\n  }),\n};\n\nexport type AssetCreated = EventOf<typeof assetEvents.assetCreated>;\nexport type AssetReady = EventOf<typeof assetEvents.assetReady>;\nexport type AssetDeleted = EventOf<typeof assetEvents.assetDeleted>;\nexport type AssetEvent = EventOfValues<typeof assetEvents>;\n"],"mappings":";;;AAGA,MAAa,cAAc;CACzB,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,YAAY,YAAY;EACtB,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;AACH"}

package/dist/assets/index.d.ts

@@ -0,0 +1,7 @@
+import { Page } from "../types/shared.js";
+import { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import { AssetCreated, AssetDeleted, AssetEvent, AssetReady, assetEvents } from "./events.js";
+import "./model.js";
+import { AssetsRepository, AssetsService } from "./ports.js";
+import { AssetsServiceImpl } from "./service.js";
+export { type Asset, type AssetCreated, type AssetDeleted, type AssetEvent, type AssetKind, type AssetReady, type AssetStatus, type AssetsQuery, type AssetsRepository, type AssetsService, AssetsServiceImpl, type DownloadTicket, type Page, type RequestUploadInput, type UploadTicket, assetEvents };

package/dist/assets/index.js

@@ -0,0 +1,3 @@
+import { assetEvents } from "./events.js";
+import { AssetsServiceImpl } from "./service.js";
+export { AssetsServiceImpl, assetEvents };

package/dist/assets/model.d.ts

@@ -0,0 +1,4 @@
+import { Page } from "../types/shared.js";
+import { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import "../types/index.js";
+export type { Asset, AssetKind, AssetStatus, AssetsQuery, DownloadTicket, Page, RequestUploadInput, UploadTicket };

package/dist/assets/model.js

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

package/dist/assets/ports.d.ts

@@ -0,0 +1,34 @@
+import { Page } from "../types/shared.js";
+import { Asset, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
+import "./model.js";
+//#region src/assets/ports.d.ts
+interface AssetsService {
+  /** Register an asset and return a presigned URL to upload its bytes. */
+  requestUpload(orgId: string, input: RequestUploadInput): Promise<UploadTicket>;
+  /** After upload, capture size/content-type from storage and mark ready. */
+  confirm(orgId: string, id: string): Promise<Asset | null>;
+  list(orgId: string, query: AssetsQuery): Promise<Page<Asset>>;
+  get(orgId: string, id: string): Promise<Asset | null>;
+  /** Short-lived presigned URL to download/serve the asset. `expiresInSeconds`
+   *  overrides the adapter default — entitled delivery passes its own. */
+  requestDownload(orgId: string, id: string, filename?: string, expiresInSeconds?: number): Promise<DownloadTicket | null>;
+  /** Remove the object from storage and the registry. */
+  remove(orgId: string, id: string): Promise<boolean>;
+}
+interface AssetsRepository {
+  insert(orgId: string, asset: Asset): Promise<Asset>;
+  list(orgId: string, query: AssetsQuery): Promise<Page<Asset>>;
+  /** Scoped to the org — returns null if the asset belongs to another org. */
+  findById(orgId: string, id: string): Promise<Asset | null>;
+  update(id: string, patch: Partial<Pick<Asset, 'size' | 'contentType' | 'status'>>): Promise<Asset | null>;
+  delete(id: string): Promise<boolean>;
+}
+interface AssetsWriteScope {
+  assets: AssetsRepository;
+  outbox: OutboxAppender;
+}
+type AssetsUnitOfWork = UnitOfWork<AssetsWriteScope>;
+//#endregion
+export { AssetsRepository, AssetsService, AssetsUnitOfWork, AssetsWriteScope };
+//# sourceMappingURL=ports.d.ts.map

package/dist/assets/ports.js

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

package/dist/assets/service.d.ts

@@ -0,0 +1,29 @@
+import { Page } from "../types/shared.js";
+import { Logger, ObjectStorage } from "../types/ports.js";
+import { Asset, AssetsQuery, DownloadTicket, RequestUploadInput, UploadTicket } from "../types/schemas/assets.js";
+import "../shared/ports.js";
+import "./model.js";
+import { AssetsRepository, AssetsService, AssetsUnitOfWork } from "./ports.js";
+//#region src/assets/service.d.ts
+type AssetsServiceParams = {
+  storage: ObjectStorage;
+  repo: AssetsRepository;
+  uow: AssetsUnitOfWork;
+  logger?: Logger;
+};
+declare class AssetsServiceImpl implements AssetsService {
+  private readonly storage;
+  private readonly repo;
+  private readonly uow;
+  private readonly logger;
+  constructor(params: AssetsServiceParams);
+  requestUpload(orgId: string, input: RequestUploadInput): Promise<UploadTicket>;
+  confirm(orgId: string, id: string): Promise<Asset | null>;
+  list(orgId: string, query: AssetsQuery): Promise<Page<Asset>>;
+  get(orgId: string, id: string): Promise<Asset | null>;
+  requestDownload(orgId: string, id: string, filename?: string, expiresInSeconds?: number): Promise<DownloadTicket | null>;
+  remove(orgId: string, id: string): Promise<boolean>;
+}
+//#endregion
+export { AssetsServiceImpl, AssetsServiceParams };
+//# sourceMappingURL=service.d.ts.map

package/dist/assets/service.js

@@ -0,0 +1,130 @@
+import { assetEvents } from "./events.js";
+import { genId } from "../shared/id.js";
+import { noopLogger } from "../shared/logger.js";
+//#region src/assets/service.ts
+function orgPrefix(orgId) {
+	return `org/${orgId}/`;
+}
+function sanitizeFilename(filename) {
+	return (filename.split(/[\\/]/).pop() ?? "file").replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 120) || "file";
+}
+var AssetsServiceImpl = class {
+	storage;
+	repo;
+	uow;
+	logger;
+	constructor(params) {
+		this.storage = params.storage;
+		this.repo = params.repo;
+		this.uow = params.uow;
+		this.logger = params.logger ?? noopLogger;
+	}
+	async requestUpload(orgId, input) {
+		const id = genId("asset");
+		const key = `${orgPrefix(orgId)}${input.kind}/${id}/${sanitizeFilename(input.filename)}`;
+		const presigned = await this.storage.presignUpload({
+			key,
+			contentType: input.contentType
+		});
+		const asset = await this.uow.run(async ({ assets, outbox }) => {
+			const asset = await assets.insert(orgId, {
+				orgId,
+				id,
+				key,
+				kind: input.kind,
+				filename: input.filename,
+				contentType: input.contentType,
+				size: 0,
+				status: "pending",
+				uploadedBy: input.uploadedBy,
+				createdAt: /* @__PURE__ */ new Date()
+			});
+			await outbox.append([assetEvents.assetCreated.make({
+				orgId,
+				data: asset
+			})]);
+			return asset;
+		});
+		this.logger.info("asset upload requested", {
+			orgId,
+			assetId: id,
+			kind: input.kind
+		});
+		return {
+			asset,
+			uploadUrl: presigned.url,
+			method: "PUT",
+			expiresInSeconds: presigned.expiresInSeconds,
+			headers: presigned.headers
+		};
+	}
+	async confirm(orgId, id) {
+		const asset = await this.repo.findById(orgId, id);
+		if (!asset) return null;
+		const stat = await this.storage.stat(asset.key);
+		if (!stat) {
+			this.logger.debug("asset not yet uploaded", {
+				orgId,
+				assetId: id
+			});
+			return asset;
+		}
+		const updated = await this.uow.run(async ({ assets, outbox }) => {
+			const updated = await assets.update(id, {
+				size: stat.size,
+				contentType: stat.contentType ?? asset.contentType,
+				status: "ready"
+			});
+			if (updated) await outbox.append([assetEvents.assetReady.make({
+				orgId,
+				data: updated
+			})]);
+			return updated;
+		});
+		this.logger.info("asset confirmed", {
+			orgId,
+			assetId: id
+		});
+		return updated;
+	}
+	list(orgId, query) {
+		return this.repo.list(orgId, query);
+	}
+	get(orgId, id) {
+		return this.repo.findById(orgId, id);
+	}
+	async requestDownload(orgId, id, filename, expiresInSeconds) {
+		const asset = await this.repo.findById(orgId, id);
+		if (!asset) return null;
+		return {
+			url: await this.storage.presignDownload({
+				key: asset.key,
+				downloadFilename: filename ?? asset.filename,
+				...expiresInSeconds === void 0 ? {} : { expiresInSeconds }
+			}),
+			asset
+		};
+	}
+	async remove(orgId, id) {
+		const asset = await this.repo.findById(orgId, id);
+		if (!asset) return false;
+		await this.storage.remove(asset.key);
+		const deleted = await this.uow.run(async ({ assets, outbox }) => {
+			const deleted = await assets.delete(id);
+			if (deleted) await outbox.append([assetEvents.assetDeleted.make({
+				orgId,
+				data: asset
+			})]);
+			return deleted;
+		});
+		this.logger.info("asset removed", {
+			orgId,
+			assetId: id
+		});
+		return deleted;
+	}
+};
+//#endregion
+export { AssetsServiceImpl };
+
+//# sourceMappingURL=service.js.map

package/dist/assets/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../src/assets/service.ts"],"sourcesContent":["// assets context — service. Owns org-scoped key construction and the asset\n// lifecycle (register → upload → confirm → serve → remove); delegates the\n// actual object operations to the ObjectStorage port. Org isolation is enforced\n// by scoping every lookup to the caller's org (cross-org reads return null).\nimport { genId } from '../shared/id.js';\nimport type { Logger, ObjectStorage } from '../shared/ports.js';\nimport type {\n  Asset,\n  AssetsQuery,\n  DownloadTicket,\n  Page,\n  RequestUploadInput,\n  UploadTicket,\n} from './model.js';\nimport type { AssetsRepository, AssetsService, AssetsUnitOfWork } from './ports.js';\nimport { noopLogger } from '../shared/logger.js';\nimport { assetEvents } from './events.js';\n\nfunction orgPrefix(orgId: string): string {\n  return `org/${orgId}/`;\n}\n\nfunction sanitizeFilename(filename: string): string {\n  const base = filename.split(/[\\\\/]/).pop() ?? 'file';\n  return base.replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 120) || 'file';\n}\n\nexport type AssetsServiceParams = {\n  storage: ObjectStorage;\n  repo: AssetsRepository;\n  uow: AssetsUnitOfWork;\n  logger?: Logger;\n};\n\nexport class AssetsServiceImpl implements AssetsService {\n  private readonly storage: ObjectStorage;\n  private readonly repo: AssetsRepository;\n  private readonly uow: AssetsUnitOfWork;\n  private readonly logger: Logger;\n\n  constructor(params: AssetsServiceParams) {\n    this.storage = params.storage;\n    this.repo = params.repo;\n    this.uow = params.uow;\n    this.logger = params.logger ?? noopLogger;\n  }\n\n  async requestUpload(orgId: string, input: RequestUploadInput): Promise<UploadTicket> {\n    const id = genId('asset');\n    const key = `${orgPrefix(orgId)}${input.kind}/${id}/${sanitizeFilename(input.filename)}`;\n    const presigned = await this.storage.presignUpload({ key, contentType: input.contentType });\n    const asset = await this.uow.run(async ({ assets, outbox }) => {\n      const asset = await assets.insert(orgId, {\n        orgId,\n        id,\n        key,\n        kind: input.kind,\n        filename: input.filename,\n        contentType: input.contentType,\n        size: 0,\n        status: 'pending',\n        uploadedBy: input.uploadedBy,\n        createdAt: new Date(),\n      });\n      await outbox.append([assetEvents.assetCreated.make({ orgId, data: asset })]);\n      return asset;\n    });\n    this.logger.info('asset upload requested', { orgId, assetId: id, kind: input.kind });\n    return {\n      asset,\n      uploadUrl: presigned.url,\n      method: 'PUT',\n      expiresInSeconds: presigned.expiresInSeconds,\n      headers: presigned.headers,\n    };\n  }\n\n  async confirm(orgId: string, id: string): Promise<Asset | null> {\n    const asset = await this.repo.findById(orgId, id);\n    if (!asset) {\n      return null;\n    }\n    const stat = await this.storage.stat(asset.key);\n    if (!stat) {\n      this.logger.debug('asset not yet uploaded', { orgId, assetId: id });\n      return asset; // not uploaded yet — stays pending\n    }\n    const updated = await this.uow.run(async ({ assets, outbox }) => {\n      const updated = await assets.update(id, {\n        size: stat.size,\n        contentType: stat.contentType ?? asset.contentType,\n        status: 'ready',\n      });\n      if (updated) {\n        await outbox.append([assetEvents.assetReady.make({ orgId, data: updated })]);\n      }\n      return updated;\n    });\n    this.logger.info('asset confirmed', { orgId, assetId: id });\n    return updated;\n  }\n\n  list(orgId: string, query: AssetsQuery): Promise<Page<Asset>> {\n    return this.repo.list(orgId, query);\n  }\n\n  get(orgId: string, id: string): Promise<Asset | null> {\n    return this.repo.findById(orgId, id);\n  }\n\n  async requestDownload(\n    orgId: string,\n    id: string,\n    filename?: string,\n    expiresInSeconds?: number,\n  ): Promise<DownloadTicket | null> {\n    const asset = await this.repo.findById(orgId, id);\n    if (!asset) {\n      return null;\n    }\n    const url = await this.storage.presignDownload({\n      key: asset.key,\n      downloadFilename: filename ?? asset.filename,\n      ...(expiresInSeconds === undefined ? {} : { expiresInSeconds }),\n    });\n    return { url, asset };\n  }\n\n  async remove(orgId: string, id: string): Promise<boolean> {\n    const asset = await this.repo.findById(orgId, id);\n    if (!asset) {\n      return false;\n    }\n    await this.storage.remove(asset.key);\n    const deleted = await this.uow.run(async ({ assets, outbox }) => {\n      const deleted = await assets.delete(id);\n      if (deleted) {\n        await outbox.append([assetEvents.assetDeleted.make({ orgId, data: asset })]);\n      }\n      return deleted;\n    });\n    this.logger.info('asset removed', { orgId, assetId: id });\n    return deleted;\n  }\n}\n"],"mappings":"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"}

package/dist/automations/actions.d.ts

@@ -0,0 +1,24 @@
+import { DomainEvent } from "../types/shared.js";
+import { EmailTemplateId, EmailTemplateParams } from "../types/email-templates.js";
+import { AutomationAction } from "../types/schemas/automations.js";
+import "../types/index.js";
+import "../shared/ports.js";
+import { Mailer, MailerLookups } from "../shared/mailer.js";
+import "./model.js";
+//#region src/automations/actions.d.ts
+interface SendEmailDerivation<K extends EmailTemplateId> {
+  /** The only event type this template's params can be derived from. */
+  trigger: string;
+  /** Undefined = the recipient or content behind the event's ids cannot be resolved. */
+  derive(event: DomainEvent, lookups: MailerLookups): Promise<{
+    to: string;
+    params: EmailTemplateParams[K];
+  } | undefined>;
+}
+type SendEmailDerivations = { [K in EmailTemplateId]?: SendEmailDerivation<K>; };
+declare const SEND_EMAIL_DERIVATIONS: SendEmailDerivations;
+/** Throws on any failure — the engine owns retry policy and failure bookkeeping. */
+declare function executeAction(action: AutomationAction, event: DomainEvent, mailer: Pick<Mailer, 'send'>, lookups: MailerLookups): Promise<void>;
+//#endregion
+export { SEND_EMAIL_DERIVATIONS, executeAction };
+//# sourceMappingURL=actions.d.ts.map

package/dist/automations/actions.js

@@ -0,0 +1,59 @@
+import { entitlementEvents } from "../entitlements/events.js";
+import { ALL_EMAIL_TEMPLATE_IDS } from "./catalog.js";
+//#region src/automations/actions.ts
+const SEND_EMAIL_DERIVATIONS = {
+	accessGranted: {
+		trigger: "entitlement.created",
+		derive: async (event, lookups) => {
+			const result = entitlementEvents.entitlementCreated.safeParse(event);
+			if (!result.success) return;
+			const entitlement = result.data.data;
+			const [to, content] = await Promise.all([lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId), lookups.contentInfo(entitlement.orgId, entitlement.contentId)]);
+			if (!to || !content) return;
+			return {
+				to,
+				params: {
+					contentTitle: content.title,
+					contentId: content.id
+				}
+			};
+		}
+	},
+	accessRevoked: {
+		trigger: "entitlement.deleted",
+		derive: async (event, lookups) => {
+			const result = entitlementEvents.entitlementDeleted.safeParse(event);
+			if (!result.success) return;
+			const entitlement = result.data.data;
+			const [to, content] = await Promise.all([lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId), lookups.contentInfo(entitlement.orgId, entitlement.contentId)]);
+			if (!to || !content) return;
+			return {
+				to,
+				params: { contentTitle: content.title }
+			};
+		}
+	}
+};
+function isEmailTemplateId(value) {
+	return typeof value === "string" && value in ALL_EMAIL_TEMPLATE_IDS;
+}
+/** Throws on any failure — the engine owns retry policy and failure bookkeeping. */
+async function executeAction(action, event, mailer, lookups) {
+	switch (action.type) {
+		case "sendEmail": {
+			const template = action.input["template"];
+			if (!isEmailTemplateId(template)) throw new Error(`sendEmail: unknown template "${String(template)}"`);
+			const derivation = SEND_EMAIL_DERIVATIONS[template];
+			if (!derivation || derivation.trigger !== event.type) throw new Error(`sendEmail: template "${template}" cannot be derived from event "${event.type}"`);
+			const derived = await derivation.derive(event, lookups);
+			if (!derived) throw new Error(`sendEmail: event "${event.type}" is missing the data required to derive template "${template}"`);
+			await mailer.send(derived.to, template, derived.params);
+			return;
+		}
+		default: throw new Error(`unknown automation action type "${action.type}"`);
+	}
+}
+//#endregion
+export { SEND_EMAIL_DERIVATIONS, executeAction };
+
+//# sourceMappingURL=actions.js.map

package/dist/automations/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","names":[],"sources":["../../src/automations/actions.ts"],"sourcesContent":["// automations context — action runners. `executeAction` maps one\n// AutomationAction against the DomainEvent that triggered its run.\n//\n// SEND_EMAIL_DERIVATIONS is the sendEmail runner's internal derivation table:\n// which (trigger, template) pairings are derivable. A template with no entry\n// (e.g. courseCompleted) makes `executeAction` throw a named error, recorded\n// by the engine as a failed action.\nimport type { EmailTemplateId, EmailTemplateParams } from '../types/index.js';\nimport { entitlementEvents } from '../entitlements/index.js';\nimport type { Mailer, MailerLookups } from '../shared/mailer.js';\nimport type { DomainEvent } from '../shared/ports.js';\nimport type { AutomationAction } from './model.js';\nimport { ALL_EMAIL_TEMPLATE_IDS } from './catalog.js';\n\ninterface SendEmailDerivation<K extends EmailTemplateId> {\n  /** The only event type this template's params can be derived from. */\n  trigger: string;\n  /** Undefined = the recipient or content behind the event's ids cannot be resolved. */\n  derive(\n    event: DomainEvent,\n    lookups: MailerLookups,\n  ): Promise<{ to: string; params: EmailTemplateParams[K] } | undefined>;\n}\n\ntype SendEmailDerivations = { [K in EmailTemplateId]?: SendEmailDerivation<K> };\n\nexport const SEND_EMAIL_DERIVATIONS: SendEmailDerivations = {\n  accessGranted: {\n    trigger: 'entitlement.created',\n    derive: async (event, lookups) => {\n      const result = entitlementEvents.entitlementCreated.safeParse(event);\n      if (!result.success) {\n        return undefined;\n      }\n      const entitlement = result.data.data;\n      const [to, content] = await Promise.all([\n        lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId),\n        lookups.contentInfo(entitlement.orgId, entitlement.contentId),\n      ]);\n      if (!to || !content) {\n        return undefined;\n      }\n      return {\n        to,\n        params: { contentTitle: content.title, contentId: content.id },\n      };\n    },\n  },\n  accessRevoked: {\n    trigger: 'entitlement.deleted',\n    derive: async (event, lookups) => {\n      const result = entitlementEvents.entitlementDeleted.safeParse(event);\n      if (!result.success) {\n        return undefined;\n      }\n      const entitlement = result.data.data;\n      const [to, content] = await Promise.all([\n        lookups.orgUserEmail(entitlement.orgId, entitlement.orgUserId),\n        lookups.contentInfo(entitlement.orgId, entitlement.contentId),\n      ]);\n      if (!to || !content) {\n        return undefined;\n      }\n      return {\n        to,\n        params: { contentTitle: content.title },\n      };\n    },\n  },\n};\n\nfunction isEmailTemplateId(value: unknown): value is EmailTemplateId {\n  return typeof value === 'string' && value in ALL_EMAIL_TEMPLATE_IDS;\n}\n\n/** Throws on any failure — the engine owns retry policy and failure bookkeeping. */\nexport async function executeAction(\n  action: AutomationAction,\n  event: DomainEvent,\n  mailer: Pick<Mailer, 'send'>,\n  lookups: MailerLookups,\n): Promise<void> {\n  switch (action.type) {\n    case 'sendEmail': {\n      const template = action.input['template'];\n      if (!isEmailTemplateId(template)) {\n        throw new Error(`sendEmail: unknown template \"${String(template)}\"`);\n      }\n      const derivation = SEND_EMAIL_DERIVATIONS[template];\n      if (!derivation || derivation.trigger !== event.type) {\n        throw new Error(\n          `sendEmail: template \"${template}\" cannot be derived from event \"${event.type}\"`,\n        );\n      }\n      const derived = await derivation.derive(event, lookups);\n      if (!derived) {\n        throw new Error(\n          `sendEmail: event \"${event.type}\" is missing the data required to derive template \"${template}\"`,\n        );\n      }\n      await mailer.send(derived.to, template, derived.params);\n      return;\n    }\n    default: {\n      throw new Error(`unknown automation action type \"${action.type}\"`);\n    }\n  }\n}\n"],"mappings":";;;AA0BA,MAAa,yBAA+C;CAC1D,eAAe;EACb,SAAS;EACT,QAAQ,OAAO,OAAO,YAAY;GAChC,MAAM,SAAS,kBAAkB,mBAAmB,UAAU,KAAK;GACnE,IAAI,CAAC,OAAO,SACV;GAEF,MAAM,cAAc,OAAO,KAAK;GAChC,MAAM,CAAC,IAAI,WAAW,MAAM,QAAQ,IAAI,CACtC,QAAQ,aAAa,YAAY,OAAO,YAAY,SAAS,GAC7D,QAAQ,YAAY,YAAY,OAAO,YAAY,SAAS,CAC9D,CAAC;GACD,IAAI,CAAC,MAAM,CAAC,SACV;GAEF,OAAO;IACL;IACA,QAAQ;KAAE,cAAc,QAAQ;KAAO,WAAW,QAAQ;IAAG;GAC/D;EACF;CACF;CACA,eAAe;EACb,SAAS;EACT,QAAQ,OAAO,OAAO,YAAY;GAChC,MAAM,SAAS,kBAAkB,mBAAmB,UAAU,KAAK;GACnE,IAAI,CAAC,OAAO,SACV;GAEF,MAAM,cAAc,OAAO,KAAK;GAChC,MAAM,CAAC,IAAI,WAAW,MAAM,QAAQ,IAAI,CACtC,QAAQ,aAAa,YAAY,OAAO,YAAY,SAAS,GAC7D,QAAQ,YAAY,YAAY,OAAO,YAAY,SAAS,CAC9D,CAAC;GACD,IAAI,CAAC,MAAM,CAAC,SACV;GAEF,OAAO;IACL;IACA,QAAQ,EAAE,cAAc,QAAQ,MAAM;GACxC;EACF;CACF;AACF;AAEA,SAAS,kBAAkB,OAA0C;CACnE,OAAO,OAAO,UAAU,YAAY,SAAS;AAC/C;;AAGA,eAAsB,cACpB,QACA,OACA,QACA,SACe;CACf,QAAQ,OAAO,MAAf;EACE,KAAK,aAAa;GAChB,MAAM,WAAW,OAAO,MAAM;GAC9B,IAAI,CAAC,kBAAkB,QAAQ,GAC7B,MAAM,IAAI,MAAM,gCAAgC,OAAO,QAAQ,EAAE,EAAE;GAErE,MAAM,aAAa,uBAAuB;GAC1C,IAAI,CAAC,cAAc,WAAW,YAAY,MAAM,MAC9C,MAAM,IAAI,MACR,wBAAwB,SAAS,kCAAkC,MAAM,KAAK,EAChF;GAEF,MAAM,UAAU,MAAM,WAAW,OAAO,OAAO,OAAO;GACtD,IAAI,CAAC,SACH,MAAM,IAAI,MACR,qBAAqB,MAAM,KAAK,qDAAqD,SAAS,EAChG;GAEF,MAAM,OAAO,KAAK,QAAQ,IAAI,UAAU,QAAQ,MAAM;GACtD;EACF;EACA,SACE,MAAM,IAAI,MAAM,mCAAmC,OAAO,KAAK,EAAE;CAErE;AACF"}

package/dist/automations/catalog.d.ts

@@ -0,0 +1,12 @@
+import { EmailTemplateId } from "../types/email-templates.js";
+import { AvailableActions, AvailableTriggers } from "../types/schemas/automations.js";
+import "../types/index.js";
+import "./types.js";
+//#region src/automations/catalog.d.ts
+/** Every EmailTemplateId — a missing key here is a compile error, kept exhaustive by construction. */
+declare const ALL_EMAIL_TEMPLATE_IDS: Record<EmailTemplateId, true>;
+declare function catalogActions(): AvailableActions;
+declare function catalogTriggers(): AvailableTriggers['triggers'];
+//#endregion
+export { ALL_EMAIL_TEMPLATE_IDS, catalogActions, catalogTriggers };
+//# sourceMappingURL=catalog.d.ts.map