@headless-lms/core 0.1.0

package/dist/automations/catalog.js

@@ -0,0 +1,224 @@
+import { assetEvents } from "../assets/events.js";
+import { entitlementEvents } from "../entitlements/events.js";
+import { contentEvents } from "../content/events.js";
+import { discussionEvents } from "../discussion/events.js";
+import { identityEvents } from "../identity/events.js";
+import { integrationEvents } from "../integrations/events.js";
+import { organizationEvents } from "../organizations/events.js";
+import { progressEvents } from "../progress/events.js";
+//#region src/automations/catalog.ts
+/** Every EmailTemplateId — a missing key here is a compile error, kept exhaustive by construction. */
+const ALL_EMAIL_TEMPLATE_IDS = {
+	magicLink: true,
+	studentInvite: true,
+	memberInvite: true,
+	passwordReset: true,
+	emailVerification: true,
+	accessGranted: true,
+	accessRevoked: true,
+	courseCompleted: true
+};
+function catalogActions() {
+	return [{
+		type: "sendEmail",
+		description: "Send a transactional email using a built-in template.",
+		inputSchema: {
+			type: "object",
+			required: ["template"],
+			properties: { template: { enum: Object.keys(ALL_EMAIL_TEMPLATE_IDS) } }
+		},
+		source: "system"
+	}];
+}
+function catalogTriggers() {
+	return [
+		{
+			type: identityEvents.userCreated.type,
+			description: "a user was created"
+		},
+		{
+			type: identityEvents.userUpdated.type,
+			description: "a user was updated"
+		},
+		{
+			type: organizationEvents.organizationCreated.type,
+			description: "an organization was created"
+		},
+		{
+			type: organizationEvents.organizationUpdated.type,
+			description: "an organization was updated"
+		},
+		{
+			type: organizationEvents.organizationDeleted.type,
+			description: "an organization was deleted"
+		},
+		{
+			type: organizationEvents.orgUserLinked.type,
+			description: "a user was linked to an organization"
+		},
+		{
+			type: organizationEvents.orgUserDeleted.type,
+			description: "a user was removed from an organization"
+		},
+		{
+			type: organizationEvents.inviteCreated.type,
+			description: "an invite was created or re-issued"
+		},
+		{
+			type: organizationEvents.inviteAccepted.type,
+			description: "an invite was accepted"
+		},
+		{
+			type: organizationEvents.studentCreated.type,
+			description: "a student was created"
+		},
+		{
+			type: organizationEvents.studentDeleted.type,
+			description: "a student was deleted"
+		},
+		{
+			type: organizationEvents.studentLinked.type,
+			description: "a pending student was linked to an auth account"
+		},
+		{
+			type: contentEvents.courseCreated.type,
+			description: "a course was created"
+		},
+		{
+			type: contentEvents.courseUpdated.type,
+			description: "a course was updated"
+		},
+		{
+			type: contentEvents.courseDeleted.type,
+			description: "a course was deleted"
+		},
+		{
+			type: contentEvents.moduleCreated.type,
+			description: "a course module was created"
+		},
+		{
+			type: contentEvents.moduleUpdated.type,
+			description: "a course module was updated"
+		},
+		{
+			type: contentEvents.moduleDeleted.type,
+			description: "a course module was deleted"
+		},
+		{
+			type: contentEvents.modulesReordered.type,
+			description: "course modules were reordered"
+		},
+		{
+			type: contentEvents.activityCreated.type,
+			description: "a course activity was created"
+		},
+		{
+			type: contentEvents.activityUpdated.type,
+			description: "a course activity was updated"
+		},
+		{
+			type: contentEvents.activityDeleted.type,
+			description: "a course activity was deleted"
+		},
+		{
+			type: contentEvents.activitiesReordered.type,
+			description: "course activities were reordered"
+		},
+		{
+			type: contentEvents.downloadCreated.type,
+			description: "a download was created"
+		},
+		{
+			type: contentEvents.downloadUpdated.type,
+			description: "a download was updated"
+		},
+		{
+			type: contentEvents.downloadDeleted.type,
+			description: "a download was deleted"
+		},
+		{
+			type: contentEvents.downloadAssetAdded.type,
+			description: "a download asset was added"
+		},
+		{
+			type: contentEvents.downloadAssetRemoved.type,
+			description: "a download asset was removed"
+		},
+		{
+			type: contentEvents.downloadAssetRenamed.type,
+			description: "a download asset was renamed"
+		},
+		{
+			type: contentEvents.downloadAssetsReordered.type,
+			description: "download assets were reordered"
+		},
+		{
+			type: entitlementEvents.entitlementCreated.type,
+			description: "a student was granted access to content"
+		},
+		{
+			type: entitlementEvents.entitlementUpdated.type,
+			description: "an entitlement's status or expiry changed"
+		},
+		{
+			type: entitlementEvents.entitlementDeleted.type,
+			description: "a student's access to content was revoked"
+		},
+		{
+			type: entitlementEvents.entitlementExpired.type,
+			description: "an entitlement passed its expiry"
+		},
+		{
+			type: progressEvents.progressStarted.type,
+			description: "a student started a progress record"
+		},
+		{
+			type: progressEvents.progressCompleted.type,
+			description: "a student completed a progress record"
+		},
+		{
+			type: integrationEvents.connectionCreated.type,
+			description: "an integration connection was established"
+		},
+		{
+			type: integrationEvents.connectionUpdated.type,
+			description: "an integration connection changed"
+		},
+		{
+			type: integrationEvents.connectionRemoved.type,
+			description: "an integration connection was removed"
+		},
+		{
+			type: discussionEvents.commentCreated.type,
+			description: "a comment was created"
+		},
+		{
+			type: discussionEvents.commentPublished.type,
+			description: "a comment was published"
+		},
+		{
+			type: discussionEvents.commentRemoved.type,
+			description: "a comment was removed"
+		},
+		{
+			type: discussionEvents.commentReported.type,
+			description: "a comment was reported"
+		},
+		{
+			type: assetEvents.assetCreated.type,
+			description: "an asset upload was requested"
+		},
+		{
+			type: assetEvents.assetReady.type,
+			description: "an asset was confirmed ready"
+		},
+		{
+			type: assetEvents.assetDeleted.type,
+			description: "an asset was deleted"
+		}
+	];
+}
+//#endregion
+export { ALL_EMAIL_TEMPLATE_IDS, catalogActions, catalogTriggers };
+
+//# sourceMappingURL=catalog.js.map

package/dist/automations/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","names":[],"sources":["../../src/automations/catalog.ts"],"sourcesContent":["// automations context — the code-owned catalogs `availableActions()` and\n// `availableTriggers()` serve: built-in action definitions and the domain\n// event types automations may react to.\nimport type { EmailTemplateId } from '../types/index.js';\nimport { assetEvents } from '../assets/index.js';\nimport { contentEvents } from '../content/index.js';\nimport { discussionEvents } from '../discussion/index.js';\nimport { entitlementEvents } from '../entitlements/index.js';\nimport { identityEvents } from '../identity/index.js';\nimport { integrationEvents } from '../integrations/index.js';\nimport { organizationEvents } from '../organizations/index.js';\nimport { progressEvents } from '../progress/index.js';\nimport type { AvailableActions, AvailableTriggers } from './types.js';\n\n/** Every EmailTemplateId — a missing key here is a compile error, kept exhaustive by construction. */\nexport const ALL_EMAIL_TEMPLATE_IDS: Record<EmailTemplateId, true> = {\n  magicLink: true,\n  studentInvite: true,\n  memberInvite: true,\n  passwordReset: true,\n  emailVerification: true,\n  accessGranted: true,\n  accessRevoked: true,\n  courseCompleted: true,\n};\n\nexport function catalogActions(): AvailableActions {\n  return [\n    {\n      type: 'sendEmail',\n      description: 'Send a transactional email using a built-in template.',\n      inputSchema: {\n        type: 'object',\n        required: ['template'],\n        properties: {\n          template: { enum: Object.keys(ALL_EMAIL_TEMPLATE_IDS) },\n        },\n      },\n      source: 'system',\n    },\n  ];\n}\n\nexport function catalogTriggers(): AvailableTriggers['triggers'] {\n  return [\n    { type: identityEvents.userCreated.type, description: 'a user was created' },\n    { type: identityEvents.userUpdated.type, description: 'a user was updated' },\n    { type: organizationEvents.organizationCreated.type, description: 'an organization was created' },\n    { type: organizationEvents.organizationUpdated.type, description: 'an organization was updated' },\n    { type: organizationEvents.organizationDeleted.type, description: 'an organization was deleted' },\n    { type: organizationEvents.orgUserLinked.type, description: 'a user was linked to an organization' },\n    { type: organizationEvents.orgUserDeleted.type, description: 'a user was removed from an organization' },\n    { type: organizationEvents.inviteCreated.type, description: 'an invite was created or re-issued' },\n    { type: organizationEvents.inviteAccepted.type, description: 'an invite was accepted' },\n    { type: organizationEvents.studentCreated.type, description: 'a student was created' },\n    { type: organizationEvents.studentDeleted.type, description: 'a student was deleted' },\n    { type: organizationEvents.studentLinked.type, description: 'a pending student was linked to an auth account' },\n    { type: contentEvents.courseCreated.type, description: 'a course was created' },\n    { type: contentEvents.courseUpdated.type, description: 'a course was updated' },\n    { type: contentEvents.courseDeleted.type, description: 'a course was deleted' },\n    { type: contentEvents.moduleCreated.type, description: 'a course module was created' },\n    { type: contentEvents.moduleUpdated.type, description: 'a course module was updated' },\n    { type: contentEvents.moduleDeleted.type, description: 'a course module was deleted' },\n    { type: contentEvents.modulesReordered.type, description: 'course modules were reordered' },\n    { type: contentEvents.activityCreated.type, description: 'a course activity was created' },\n    { type: contentEvents.activityUpdated.type, description: 'a course activity was updated' },\n    { type: contentEvents.activityDeleted.type, description: 'a course activity was deleted' },\n    { type: contentEvents.activitiesReordered.type, description: 'course activities were reordered' },\n    { type: contentEvents.downloadCreated.type, description: 'a download was created' },\n    { type: contentEvents.downloadUpdated.type, description: 'a download was updated' },\n    { type: contentEvents.downloadDeleted.type, description: 'a download was deleted' },\n    { type: contentEvents.downloadAssetAdded.type, description: 'a download asset was added' },\n    { type: contentEvents.downloadAssetRemoved.type, description: 'a download asset was removed' },\n    { type: contentEvents.downloadAssetRenamed.type, description: 'a download asset was renamed' },\n    { type: contentEvents.downloadAssetsReordered.type, description: 'download assets were reordered' },\n    { type: entitlementEvents.entitlementCreated.type, description: 'a student was granted access to content' },\n    { type: entitlementEvents.entitlementUpdated.type, description: \"an entitlement's status or expiry changed\" },\n    { type: entitlementEvents.entitlementDeleted.type, description: \"a student's access to content was revoked\" },\n    { type: entitlementEvents.entitlementExpired.type, description: 'an entitlement passed its expiry' },\n    { type: progressEvents.progressStarted.type, description: 'a student started a progress record' },\n    { type: progressEvents.progressCompleted.type, description: 'a student completed a progress record' },\n    { type: integrationEvents.connectionCreated.type, description: 'an integration connection was established' },\n    { type: integrationEvents.connectionUpdated.type, description: \"an integration connection changed\" },\n    { type: integrationEvents.connectionRemoved.type, description: 'an integration connection was removed' },\n    { type: discussionEvents.commentCreated.type, description: 'a comment was created' },\n    { type: discussionEvents.commentPublished.type, description: 'a comment was published' },\n    { type: discussionEvents.commentRemoved.type, description: 'a comment was removed' },\n    { type: discussionEvents.commentReported.type, description: 'a comment was reported' },\n    { type: assetEvents.assetCreated.type, description: 'an asset upload was requested' },\n    { type: assetEvents.assetReady.type, description: 'an asset was confirmed ready' },\n    { type: assetEvents.assetDeleted.type, description: 'an asset was deleted' },\n  ];\n}\n"],"mappings":"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"}

package/dist/automations/events.d.ts

@@ -0,0 +1,264 @@
+import { DomainEvent, JsonValue } from "../types/shared.js";
+import { EventOf, EventOfValues, RuntimeEventDefinition, VersionedDomainEvent } from "../shared/events.js";
+import "../shared/ports.js";
+//#region src/automations/events.d.ts
+declare const automationEvents: {
+  automationCreated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, JsonValue>;
+    }[];
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+  }, "automation.created", 1>, {
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, unknown>;
+    }[];
+    enabled: boolean;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }>;
+  automationUpdated: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, JsonValue>;
+    }[];
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+  }, "automation.updated", 1>, {
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, unknown>;
+    }[];
+    enabled: boolean;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }>;
+  automationDeleted: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, JsonValue>;
+    }[];
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+  }, "automation.deleted", 1>, {
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, unknown>;
+    }[];
+    enabled: boolean;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }>;
+  automationEnabled: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, JsonValue>;
+    }[];
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+  }, "automation.enabled", 1>, {
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, unknown>;
+    }[];
+    enabled: boolean;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }>;
+  automationDisabled: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, JsonValue>;
+    }[];
+    enabled: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+  }, "automation.disabled", 1>, {
+    orgId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    trigger: string;
+    actions: {
+      type: string;
+      input: Record<string, unknown>;
+    }[];
+    enabled: boolean;
+    createdAt: unknown;
+    updatedAt: unknown;
+  }>;
+  runStarted: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    automationId: string;
+    trigger: string;
+    eventId: string;
+    event: DomainEvent<unknown, string, number>;
+    status: "running" | "completed" | "failed";
+    actionResults: {
+      index: number;
+      type: string;
+      status: "completed" | "failed";
+      error?: string | undefined;
+    }[];
+    startedAt: Date;
+    finishedAt: Date | null;
+  }, "automation.run.started", 1>, {
+    orgId: string;
+    id: string;
+    automationId: string;
+    trigger: string;
+    eventId: string;
+    event: unknown;
+    status: "running" | "completed" | "failed";
+    actionResults: {
+      index: number;
+      type: string;
+      status: "completed" | "failed";
+      error?: string | undefined;
+    }[];
+    startedAt: unknown;
+    finishedAt: unknown;
+  }>;
+  runCompleted: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    automationId: string;
+    trigger: string;
+    eventId: string;
+    event: DomainEvent<unknown, string, number>;
+    status: "running" | "completed" | "failed";
+    actionResults: {
+      index: number;
+      type: string;
+      status: "completed" | "failed";
+      error?: string | undefined;
+    }[];
+    startedAt: Date;
+    finishedAt: Date | null;
+  }, "automation.run.completed", 1>, {
+    orgId: string;
+    id: string;
+    automationId: string;
+    trigger: string;
+    eventId: string;
+    event: unknown;
+    status: "running" | "completed" | "failed";
+    actionResults: {
+      index: number;
+      type: string;
+      status: "completed" | "failed";
+      error?: string | undefined;
+    }[];
+    startedAt: unknown;
+    finishedAt: unknown;
+  }>;
+  runFailed: RuntimeEventDefinition<VersionedDomainEvent<{
+    orgId: string;
+    id: string;
+    automationId: string;
+    trigger: string;
+    eventId: string;
+    event: DomainEvent<unknown, string, number>;
+    status: "running" | "completed" | "failed";
+    actionResults: {
+      index: number;
+      type: string;
+      status: "completed" | "failed";
+      error?: string | undefined;
+    }[];
+    startedAt: Date;
+    finishedAt: Date | null;
+  }, "automation.run.failed", 1>, {
+    orgId: string;
+    id: string;
+    automationId: string;
+    trigger: string;
+    eventId: string;
+    event: unknown;
+    status: "running" | "completed" | "failed";
+    actionResults: {
+      index: number;
+      type: string;
+      status: "completed" | "failed";
+      error?: string | undefined;
+    }[];
+    startedAt: unknown;
+    finishedAt: unknown;
+  }>;
+  actionFailed: RuntimeEventDefinition<VersionedDomainEvent<{
+    index: number;
+    type: string;
+    status: "completed" | "failed";
+    error?: string | undefined;
+  }, "automation.action.failed", 1>, {
+    index: number;
+    type: string;
+    status: "completed" | "failed";
+    error?: string | undefined;
+  }>;
+};
+type AutomationCreated = EventOf<typeof automationEvents.automationCreated>;
+type AutomationUpdated = EventOf<typeof automationEvents.automationUpdated>;
+type AutomationDeleted = EventOf<typeof automationEvents.automationDeleted>;
+type AutomationEnabled = EventOf<typeof automationEvents.automationEnabled>;
+type AutomationDisabled = EventOf<typeof automationEvents.automationDisabled>;
+type AutomationRunStarted = EventOf<typeof automationEvents.runStarted>;
+type AutomationRunCompleted = EventOf<typeof automationEvents.runCompleted>;
+type AutomationRunFailed = EventOf<typeof automationEvents.runFailed>;
+type AutomationActionFailed = EventOf<typeof automationEvents.actionFailed>;
+type AutomationEvent = EventOfValues<typeof automationEvents>;
+//#endregion
+export { AutomationActionFailed, AutomationCreated, AutomationDeleted, AutomationDisabled, AutomationEnabled, AutomationEvent, AutomationRunCompleted, AutomationRunFailed, AutomationRunStarted, AutomationUpdated, automationEvents };
+//# sourceMappingURL=events.d.ts.map

package/dist/automations/events.js

@@ -0,0 +1,54 @@
+import { automationActionResultSchema, automationRunSchema, automationSchema } from "../types/schemas/automations.js";
+import { defineEvent } from "../shared/events.js";
+//#region src/automations/events.ts
+const automationEvents = {
+	automationCreated: defineEvent({
+		type: "automation.created",
+		version: 1,
+		data: automationSchema
+	}),
+	automationUpdated: defineEvent({
+		type: "automation.updated",
+		version: 1,
+		data: automationSchema
+	}),
+	automationDeleted: defineEvent({
+		type: "automation.deleted",
+		version: 1,
+		data: automationSchema
+	}),
+	automationEnabled: defineEvent({
+		type: "automation.enabled",
+		version: 1,
+		data: automationSchema
+	}),
+	automationDisabled: defineEvent({
+		type: "automation.disabled",
+		version: 1,
+		data: automationSchema
+	}),
+	runStarted: defineEvent({
+		type: "automation.run.started",
+		version: 1,
+		data: automationRunSchema
+	}),
+	runCompleted: defineEvent({
+		type: "automation.run.completed",
+		version: 1,
+		data: automationRunSchema
+	}),
+	runFailed: defineEvent({
+		type: "automation.run.failed",
+		version: 1,
+		data: automationRunSchema
+	}),
+	actionFailed: defineEvent({
+		type: "automation.action.failed",
+		version: 1,
+		data: automationActionResultSchema
+	})
+};
+//#endregion
+export { automationEvents };
+
+//# sourceMappingURL=events.js.map

package/dist/automations/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../src/automations/events.ts"],"sourcesContent":["import {\n  automationActionResultSchema,\n  automationRunSchema,\n  automationSchema,\n} from '../types/schemas/index.js';\nimport { defineEvent, type EventOf, type EventOfValues } from '../shared/ports.js';\n\nexport const automationEvents = {\n  automationCreated: defineEvent({\n    type: 'automation.created',\n    version: 1,\n    data: automationSchema,\n  }),\n  automationUpdated: defineEvent({\n    type: 'automation.updated',\n    version: 1,\n    data: automationSchema,\n  }),\n  automationDeleted: defineEvent({\n    type: 'automation.deleted',\n    version: 1,\n    data: automationSchema,\n  }),\n  automationEnabled: defineEvent({\n    type: 'automation.enabled',\n    version: 1,\n    data: automationSchema,\n  }),\n  automationDisabled: defineEvent({\n    type: 'automation.disabled',\n    version: 1,\n    data: automationSchema,\n  }),\n  runStarted: defineEvent({\n    type: 'automation.run.started',\n    version: 1,\n    data: automationRunSchema,\n  }),\n  runCompleted: defineEvent({\n    type: 'automation.run.completed',\n    version: 1,\n    data: automationRunSchema,\n  }),\n  runFailed: defineEvent({\n    type: 'automation.run.failed',\n    version: 1,\n    data: automationRunSchema,\n  }),\n  actionFailed: defineEvent({\n    type: 'automation.action.failed',\n    version: 1,\n    data: automationActionResultSchema,\n  }),\n};\n\nexport type AutomationCreated = EventOf<typeof automationEvents.automationCreated>;\nexport type AutomationUpdated = EventOf<typeof automationEvents.automationUpdated>;\nexport type AutomationDeleted = EventOf<typeof automationEvents.automationDeleted>;\nexport type AutomationEnabled = EventOf<typeof automationEvents.automationEnabled>;\nexport type AutomationDisabled = EventOf<typeof automationEvents.automationDisabled>;\nexport type AutomationRunStarted = EventOf<typeof automationEvents.runStarted>;\nexport type AutomationRunCompleted = EventOf<typeof automationEvents.runCompleted>;\nexport type AutomationRunFailed = EventOf<typeof automationEvents.runFailed>;\nexport type AutomationActionFailed = EventOf<typeof automationEvents.actionFailed>;\nexport type AutomationEvent = EventOfValues<typeof automationEvents>;\n"],"mappings":";;;AAOA,MAAa,mBAAmB;CAC9B,mBAAmB,YAAY;EAC7B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,mBAAmB,YAAY;EAC7B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,mBAAmB,YAAY;EAC7B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,mBAAmB,YAAY;EAC7B,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,oBAAoB,YAAY;EAC9B,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;CACD,WAAW,YAAY;EACrB,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;CACD,cAAc,YAAY;EACxB,MAAM;EACN,SAAS;EACT,MAAM;CACR,CAAC;AACH"}

package/dist/automations/index.d.ts

@@ -0,0 +1,9 @@
+import { Page } from "../types/shared.js";
+import { Automation, AutomationAction, AutomationActionResult, AutomationRun, AutomationRunStatus, AutomationRunsQuery, AutomationTrigger, AvailableAction, AvailableActions, AvailableTriggers, CreateAutomationInput, UpdateAutomationInput } from "../types/schemas/automations.js";
+import { AutomationDispatch, AutomationEngine, AutomationExecutor } from "../types/automations.js";
+import { InvalidTriggerError } from "./model.js";
+import "./types.js";
+import { AutomationActionFailed, AutomationCreated, AutomationDeleted, AutomationDisabled, AutomationEnabled, AutomationEvent, AutomationRunCompleted, AutomationRunFailed, AutomationRunStarted, AutomationUpdated, automationEvents } from "./events.js";
+import { AutomationRunsRepository, AutomationsRepository, AutomationsService, AutomationsUnitOfWork, NewAutomationRun } from "./ports.js";
+import { AutomationsServiceImpl } from "./service.js";
+export { type Automation, type AutomationAction, type AutomationActionFailed, type AutomationActionResult, type AutomationCreated, type AutomationDeleted, type AutomationDisabled, type AutomationDispatch, type AutomationEnabled, type AutomationEngine, type AutomationEvent, type AutomationExecutor, type AutomationRun, type AutomationRunCompleted, type AutomationRunFailed, type AutomationRunStarted, type AutomationRunStatus, type AutomationRunsQuery, type AutomationRunsRepository, type AutomationTrigger, type AutomationUpdated, type AutomationsRepository, type AutomationsService, AutomationsServiceImpl, type AutomationsUnitOfWork, type AvailableAction, type AvailableActions, type AvailableTriggers, type CreateAutomationInput, InvalidTriggerError, type NewAutomationRun, type Page, type UpdateAutomationInput, automationEvents };

package/dist/automations/index.js

@@ -0,0 +1,4 @@
+import { automationEvents } from "./events.js";
+import { InvalidTriggerError } from "./model.js";
+import { AutomationsServiceImpl } from "./service.js";
+export { AutomationsServiceImpl, InvalidTriggerError, automationEvents };

package/dist/automations/model.d.ts

@@ -0,0 +1,12 @@
+import { Page } from "../types/shared.js";
+import { Automation, AutomationAction, AutomationActionResult, AutomationRun, AutomationRunStatus, AutomationTrigger } from "../types/schemas/automations.js";
+import "../types/index.js";
+//#region src/automations/model.d.ts
+/** Rejected at authoring time: automation.* is reserved to avoid a self-triggering loop. */
+declare class InvalidTriggerError extends Error {
+  readonly trigger: string;
+  constructor(trigger: string);
+}
+//#endregion
+export { type Automation, type AutomationAction, type AutomationActionResult, type AutomationRun, type AutomationRunStatus, type AutomationTrigger, InvalidTriggerError, type Page };
+//# sourceMappingURL=model.d.ts.map

package/dist/automations/model.js

@@ -0,0 +1,14 @@
+//#region src/automations/model.ts
+/** Rejected at authoring time: automation.* is reserved to avoid a self-triggering loop. */
+var InvalidTriggerError = class extends Error {
+	trigger;
+	constructor(trigger) {
+		super(`trigger "${trigger}" is reserved: automations cannot trigger on automation.* events`);
+		this.trigger = trigger;
+		this.name = "InvalidTriggerError";
+	}
+};
+//#endregion
+export { InvalidTriggerError };
+
+//# sourceMappingURL=model.js.map

package/dist/automations/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","names":[],"sources":["../../src/automations/model.ts"],"sourcesContent":["// automations context — domain entities, owned by @headless-lms/core/types; the\n// domain error below is runtime code and stays in core.\nexport type {\n  AutomationTrigger,\n  AutomationAction,\n  Automation,\n  AutomationRunStatus,\n  AutomationActionResult,\n  AutomationRun,\n  Page,\n} from '../types/index.js';\n\n/** Rejected at authoring time: automation.* is reserved to avoid a self-triggering loop. */\nexport class InvalidTriggerError extends Error {\n  constructor(readonly trigger: string) {\n    super(`trigger \"${trigger}\" is reserved: automations cannot trigger on automation.* events`);\n    this.name = 'InvalidTriggerError';\n  }\n}\n"],"mappings":";;AAaA,IAAa,sBAAb,cAAyC,MAAM;CACxB;CAArB,YAAY,SAA0B;EACpC,MAAM,YAAY,QAAQ,iEAAiE;EADxE,KAAA,UAAA;EAEnB,KAAK,OAAO;CACd;AACF"}

package/dist/automations/ports.d.ts

@@ -0,0 +1,56 @@
+import { DomainEvent, Page } from "../types/shared.js";
+import { Automation, AutomationRun, AutomationRunsQuery, AvailableActions, AvailableTriggers, CreateAutomationInput, UpdateAutomationInput } from "../types/schemas/automations.js";
+import { AutomationDispatch, AutomationEngine, AutomationExecutor } from "../types/automations.js";
+import "../types/index.js";
+import { OutboxAppender, UnitOfWork } from "../shared/ports.js";
+import "./model.js";
+import "./types.js";
+//#region src/automations/ports.d.ts
+/** A run row before persistence assigns its id and event_id. */
+type NewAutomationRun = Omit<AutomationRun, 'id' | 'eventId'>;
+interface AutomationsService {
+  /** Matches `event` against enabled automations and dispatches a run per match; never throws. */
+  handle(event: DomainEvent): Promise<void>;
+  /** Built-in action types plus every loaded integration's declared actions. */
+  availableActions(): AvailableActions;
+  /** The domain event types an automation may react to. */
+  availableTriggers(): AvailableTriggers;
+  list(orgId: string): Promise<Automation[]>;
+  get(orgId: string, id: string): Promise<Automation | null>;
+  create(orgId: string, input: CreateAutomationInput): Promise<Automation>;
+  update(orgId: string, id: string, input: UpdateAutomationInput): Promise<Automation | null>;
+  delete(orgId: string, id: string): Promise<boolean>;
+  listRuns(orgId: string, automationId: string, query: AutomationRunsQuery): Promise<Page<AutomationRun>>;
+}
+interface AutomationsRepository {
+  insert(orgId: string, input: CreateAutomationInput): Promise<Automation>;
+  update(orgId: string, id: string, patch: UpdateAutomationInput): Promise<Automation | null>;
+  /** Returns the deleted row (the event snapshot), or null if it didn't exist. */
+  delete(orgId: string, id: string): Promise<Automation | null>;
+  findById(orgId: string, id: string): Promise<Automation | null>;
+  listByOrg(orgId: string): Promise<Automation[]>;
+  /** All rows matching `trigger`, enabled and disabled alike — the service filters to `enabled`. */
+  listByTrigger(orgId: string, trigger: string): Promise<Automation[]>;
+}
+interface AutomationRunsRepository {
+  /** Keyed by (orgId, automationId, event.id); returns `null` if this event was already run for this automation (duplicate). */
+  insert(orgId: string, run: NewAutomationRun): Promise<AutomationRun | null>;
+  recordOutcome(orgId: string, id: string, outcome: {
+    status: AutomationRun['status'];
+    actionResults: AutomationRun['actionResults'];
+    finishedAt: Date;
+  }): Promise<AutomationRun | null>;
+  list(orgId: string, automationId: string, query: AutomationRunsQuery): Promise<Page<AutomationRun>>;
+}
+/** Tx-scoped port bundle for this context's mutating use cases — every member
+ *  is bound to the UnitOfWork's transaction, so the write(s) and the event
+ *  append commit or roll back as one. */
+interface AutomationsTxScope {
+  automations: AutomationsRepository;
+  runs: AutomationRunsRepository;
+  outbox: OutboxAppender;
+}
+type AutomationsUnitOfWork = UnitOfWork<AutomationsTxScope>;
+//#endregion
+export { type AutomationDispatch, type AutomationEngine, type AutomationExecutor, AutomationRunsRepository, AutomationsRepository, AutomationsService, AutomationsTxScope, AutomationsUnitOfWork, NewAutomationRun };
+//# sourceMappingURL=ports.d.ts.map

package/dist/automations/ports.js

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