alepha 0.18.2 → 0.18.3

package/dist/api/notifications/index.d.ts

@@ -1,6 +1,9 @@
 import * as alepha from "alepha";
 import { Alepha, KIND, Primitive, Static, StaticEncode, TObject } from "alepha";
 import * as alepha_api_jobs0 from "alepha/api/jobs";
+import { JobService } from "alepha/api/jobs";
+import * as alepha_server0 from "alepha/server";
+import * as alepha_orm0 from "alepha/orm";
 import { EmailProvider } from "alepha/email";
 import * as alepha_logger0 from "alepha/logger";
 import { SmsProvider } from "alepha/sms";
@@ -88,7 +91,19 @@ declare class NotificationSenderService {
   protected readonly log: alepha_logger0.Logger;
   protected readonly emailProvider: EmailProvider;
   protected readonly smsProvider: SmsProvider;
-  send(payload: NotificationPayload): Promise<void>;
+  send(payload: NotificationPayload): Promise<{
+    type: "email";
+    to: string;
+    subject: string;
+    body: string;
+    message?: undefined;
+  } | {
+    type: "sms";
+    to: string;
+    message: string;
+    subject?: undefined;
+    body?: undefined;
+  } | undefined>;
   renderSms(payload: NotificationPayload): {
     to: string;
     message: string;
@@ -116,6 +131,28 @@ declare class NotificationSenderService {
 //#region ../../src/api/notifications/jobs/NotificationJobs.d.ts
 declare class NotificationJobs {
   protected readonly notificationSenderService: NotificationSenderService;
+  protected readonly executions: alepha_orm0.Repository<alepha.TObject<{
+    id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+    createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    jobName: alepha.TString;
+    key: alepha.TOptional<alepha.TUnion<[alepha.TNull, alepha.TString]>>;
+    payload: alepha.TOptional<alepha.TRecord<"^.*$", alepha.TAny>>;
+    status: alepha_orm0.PgAttr<alepha.TUnsafe<"pending" | "scheduled" | "retrying" | "running" | "completed" | "failed" | "dead" | "cancelled">, typeof alepha_orm0.PG_DEFAULT>;
+    priority: alepha_orm0.PgAttr<alepha.TInteger, typeof alepha_orm0.PG_DEFAULT>;
+    attempt: alepha_orm0.PgAttr<alepha.TInteger, typeof alepha_orm0.PG_DEFAULT>;
+    maxAttempts: alepha_orm0.PgAttr<alepha.TInteger, typeof alepha_orm0.PG_DEFAULT>;
+    scheduledAt: alepha.TOptional<alepha.TString>;
+    startedAt: alepha.TOptional<alepha.TString>;
+    completedAt: alepha.TOptional<alepha.TString>;
+    result: alepha.TOptional<alepha.TRecord<"^.*$", alepha.TAny>>;
+    error: alepha.TOptional<alepha.TString>;
+    workerId: alepha.TOptional<alepha.TString>;
+    triggeredBy: alepha.TOptional<alepha.TString>;
+    triggeredByName: alepha.TOptional<alepha.TString>;
+    cancelledBy: alepha.TOptional<alepha.TString>;
+    cancelledByName: alepha.TOptional<alepha.TString>;
+  }>>;
   readonly sendNotification: alepha_api_jobs0.JobPrimitive<alepha.TObject<{
     type: alepha.TUnsafe<"email" | "sms">;
     template: alepha.TString;
@@ -127,6 +164,99 @@ declare class NotificationJobs {
   }>>;
 }
 //#endregion
+//#region ../../src/api/notifications/controllers/AdminNotificationController.d.ts
+declare class AdminNotificationController {
+  protected readonly url: string;
+  protected readonly group: string;
+  protected readonly jobService: JobService;
+  protected readonly notificationJobs: NotificationJobs;
+  protected get jobName(): string;
+  readonly findNotifications: alepha_server0.ActionPrimitiveFn<{
+    query: alepha.TObject<{
+      page: alepha.TOptional<alepha.TInteger>;
+      size: alepha.TOptional<alepha.TInteger>;
+      sort: alepha.TOptional<alepha.TString>;
+      status: alepha.TOptional<alepha.TUnsafe<"pending" | "scheduled" | "retrying" | "running" | "completed" | "failed" | "dead" | "cancelled">>;
+    }>;
+    response: alepha.TPage<alepha.TObject<{
+      id: alepha.TString;
+      createdAt: alepha.TString;
+      status: alepha.TString;
+      template: alepha.TOptional<alepha.TString>;
+      type: alepha.TOptional<alepha.TString>;
+      contact: alepha.TOptional<alepha.TString>;
+      category: alepha.TOptional<alepha.TString>;
+      critical: alepha.TOptional<alepha.TBoolean>;
+      sensitive: alepha.TOptional<alepha.TBoolean>;
+      startedAt: alepha.TOptional<alepha.TString>;
+      completedAt: alepha.TOptional<alepha.TString>;
+      error: alepha.TOptional<alepha.TString>;
+    }>>;
+  }>;
+  readonly getNotification: alepha_server0.ActionPrimitiveFn<{
+    params: alepha.TObject<{
+      id: alepha.TString;
+    }>;
+    response: alepha.TObject<{
+      id: alepha.TString;
+      createdAt: alepha.TString;
+      status: alepha.TString;
+      template: alepha.TOptional<alepha.TString>;
+      type: alepha.TOptional<alepha.TString>;
+      contact: alepha.TOptional<alepha.TString>;
+      category: alepha.TOptional<alepha.TString>;
+      critical: alepha.TOptional<alepha.TBoolean>;
+      sensitive: alepha.TOptional<alepha.TBoolean>;
+      startedAt: alepha.TOptional<alepha.TString>;
+      completedAt: alepha.TOptional<alepha.TString>;
+      error: alepha.TOptional<alepha.TString>;
+      variables: alepha.TOptional<alepha.TRecord<"^.*$", alepha.TAny>>;
+      rendered: alepha.TOptional<alepha.TRecord<"^.*$", alepha.TAny>>;
+      logs: alepha.TOptional<alepha.TArray<alepha.TObject<{
+        level: alepha.TUnsafe<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+        message: alepha.TString;
+        service: alepha.TString;
+        module: alepha.TString;
+        context: alepha.TOptional<alepha.TString>;
+        app: alepha.TOptional<alepha.TString>;
+        data: alepha.TOptional<alepha.TAny>;
+        timestamp: alepha.TNumber;
+      }>>>;
+    }>;
+  }>;
+  protected toResource(exec: Record<string, unknown>): {
+    id: unknown;
+    createdAt: unknown;
+    status: unknown;
+    template: unknown;
+    type: unknown;
+    contact: unknown;
+    category: unknown;
+    critical: unknown;
+    sensitive: unknown;
+    startedAt: unknown;
+    completedAt: unknown;
+    error: unknown;
+  };
+  protected toDetailResource(exec: Record<string, unknown>): {
+    variables: unknown;
+    rendered: unknown;
+    logs: unknown;
+    id: unknown;
+    createdAt: unknown;
+    status: unknown;
+    template: unknown;
+    type: unknown;
+    contact: unknown;
+    category: unknown;
+    critical: unknown;
+    sensitive: unknown;
+    startedAt: unknown;
+    completedAt: unknown;
+    error: unknown;
+  };
+}
+//#endregion
 //#region ../../src/api/notifications/schemas/notificationContactPreferencesSchema.d.ts
 declare const notificationContactPreferencesSchema: alepha.TObject<{
   language: alepha.TOptional<alepha.TString>;
@@ -144,6 +274,61 @@ declare const notificationContactSchema: alepha.TObject<{
 }>;
 type NotificationContact = Static<typeof notificationContactSchema>;
 //#endregion
+//#region ../../src/api/notifications/schemas/notificationDetailResourceSchema.d.ts
+declare const notificationDetailResourceSchema: alepha.TObject<{
+  id: alepha.TString;
+  createdAt: alepha.TString;
+  status: alepha.TString;
+  template: alepha.TOptional<alepha.TString>;
+  type: alepha.TOptional<alepha.TString>;
+  contact: alepha.TOptional<alepha.TString>;
+  category: alepha.TOptional<alepha.TString>;
+  critical: alepha.TOptional<alepha.TBoolean>;
+  sensitive: alepha.TOptional<alepha.TBoolean>;
+  startedAt: alepha.TOptional<alepha.TString>;
+  completedAt: alepha.TOptional<alepha.TString>;
+  error: alepha.TOptional<alepha.TString>;
+  variables: alepha.TOptional<alepha.TRecord<"^.*$", alepha.TAny>>;
+  rendered: alepha.TOptional<alepha.TRecord<"^.*$", alepha.TAny>>;
+  logs: alepha.TOptional<alepha.TArray<alepha.TObject<{
+    level: alepha.TUnsafe<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+    message: alepha.TString;
+    service: alepha.TString;
+    module: alepha.TString;
+    context: alepha.TOptional<alepha.TString>;
+    app: alepha.TOptional<alepha.TString>;
+    data: alepha.TOptional<alepha.TAny>;
+    timestamp: alepha.TNumber;
+  }>>>;
+}>;
+type NotificationDetailResource = Static<typeof notificationDetailResourceSchema>;
+//#endregion
+//#region ../../src/api/notifications/schemas/notificationQuerySchema.d.ts
+declare const notificationQuerySchema: alepha.TObject<{
+  page: alepha.TOptional<alepha.TInteger>;
+  size: alepha.TOptional<alepha.TInteger>;
+  sort: alepha.TOptional<alepha.TString>;
+  status: alepha.TOptional<alepha.TUnsafe<"pending" | "scheduled" | "retrying" | "running" | "completed" | "failed" | "dead" | "cancelled">>;
+}>;
+type NotificationQuery = Static<typeof notificationQuerySchema>;
+//#endregion
+//#region ../../src/api/notifications/schemas/notificationResourceSchema.d.ts
+declare const notificationResourceSchema: alepha.TObject<{
+  id: alepha.TString;
+  createdAt: alepha.TString;
+  status: alepha.TString;
+  template: alepha.TOptional<alepha.TString>;
+  type: alepha.TOptional<alepha.TString>;
+  contact: alepha.TOptional<alepha.TString>;
+  category: alepha.TOptional<alepha.TString>;
+  critical: alepha.TOptional<alepha.TBoolean>;
+  sensitive: alepha.TOptional<alepha.TBoolean>;
+  startedAt: alepha.TOptional<alepha.TString>;
+  completedAt: alepha.TOptional<alepha.TString>;
+  error: alepha.TOptional<alepha.TString>;
+}>;
+type NotificationResource = Static<typeof notificationResourceSchema>;
+//#endregion
 //#region ../../src/api/notifications/index.d.ts
 /**
  * User notification management.
@@ -158,5 +343,5 @@ type NotificationContact = Static<typeof notificationContactSchema>;
  */
 declare const AlephaApiNotifications: alepha.Service<alepha.Module>;
 //#endregion
-export { $notification, AlephaApiNotifications, NotificationContact, NotificationContactPreferences, NotificationJobs, NotificationMessage, NotificationPayload, NotificationPrimitive, NotificationPrimitiveOptions, NotificationPushOptions, NotificationSenderService, notificationContactPreferencesSchema, notificationContactSchema, notificationPayloadSchema };
+export { $notification, AdminNotificationController, AlephaApiNotifications, NotificationContact, NotificationContactPreferences, NotificationDetailResource, NotificationJobs, NotificationMessage, NotificationPayload, NotificationPrimitive, NotificationPrimitiveOptions, NotificationPushOptions, NotificationQuery, NotificationResource, NotificationSenderService, notificationContactPreferencesSchema, notificationContactSchema, notificationDetailResourceSchema, notificationPayloadSchema, notificationQuerySchema, notificationResourceSchema };
 //# sourceMappingURL=index.d.ts.map

package/dist/api/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/schemas/notificationPayloadSchema.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/schemas/notificationContactSchema.ts","../../../src/api/notifications/index.ts"],"mappings":";;;;;;;;;;;;;;;;AAuCA;;;;;;;;;;;;;;;;;;;;;cAAa,aAAA;EAAA,WAA2B,OAAA,EAAO,OAAA,EACpC,4BAAA,CAA6B,CAAA,IAAE,qBAAA,CAAA,CAAA;EAAA;;UAKzB,4BAAA,WAAuC,OAAA,UAC9C,mBAAA,CAAoB,CAAA;EAC5B,IAAA;EACA,WAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA;EACA,YAAA;IAAA,CAEG,IAAA,WAAe,mBAAA,CAAoB,CAAA;EAAA;EAEtC,MAAA,EAAQ,CAAA;AAAA;AAAA,cAKG,qBAAA,WAAgC,OAAA,UAAiB,SAAA,CAC5D,4BAAA,CAA6B,CAAA;EAAA,mBAEV,gBAAA,EAAgB,gBAAA;EAAA,IAExB,IAAA,CAAA;EAIE,IAAA,CAAK,OAAA,EAAS,uBAAA,CAAwB,CAAA,IAAE,OAAA;EAoC9C,SAAA,CAAU,OAAA,EAAS,OAAA,CAAQ,4BAAA,CAA6B,CAAA;AAAA;AAAA,UAShD,uBAAA,WAAkC,OAAA;EACjD,SAAA,EAAW,YAAA,CAAa,CAAA;EACxB,OAAA;AAAA;AAAA,UAGe,mBAAA,WAA8B,OAAA;EAC7C,KAAA;IACE,OAAA;IACA,IAAA,aAAiB,SAAA,EAAW,MAAA,CAAO,CAAA;EAAA;EAErC,GAAA;IACE,OAAA,aAAoB,SAAA,EAAW,MAAA,CAAO,CAAA;EAAA;AAAA;;;cC5H7B,yBAAA,SAAyB,OAAA;QAQpC,MAAA,CAAA,OAAA;;;;;;;;KAEU,mBAAA,GAAsB,MAAA,QAAc,yBAAA;;;cCLnC,yBAAA;EAAA,mBACQ,MAAA,EAAM,MAAA;EAAA,mBACN,GAAA,EADM,cAAA,CACH,MAAA;EAAA,mBACH,aAAA,EAAa,aAAA;EAAA,mBACb,WAAA,EAAW,WAAA;EAEjB,IAAA,CAAK,OAAA,EAAS,mBAAA,GAAmB,OAAA;EAwBvC,SAAA,CAAU,OAAA,EAAS,mBAAA;;;;EAkBnB,WAAA,CAAY,OAAA,EAAS,mBAAA;;;;;YAmBlB,IAAA,CAAK,OAAA,EAAS,mBAAA;mDAAmB,MAAA,CAAA,WAAA;;;;;;;;;;;;;;;cCrEhC,gBAAA;EAAA,mBACQ,yBAAA,EAAyB,yBAAA;EAAA,SAI5B,gBAAA,EAAgB,gBAAA,CAAA,YAAA,QAAA,OAAA;UAJY,MAAA,CAAA,OAAA;;;;;;;;;;;cCJjC,oCAAA,SAAoC,OAAA;6BAG/C,MAAA,CAAA,OAAA;;;KAEU,8BAAA,GAAiC,MAAA,QACpC,oCAAA;;;cCNI,yBAAA,SAAyB,OAAA;0BAMpC,MAAA,CAAA,OAAA;;;;;;KAEU,mBAAA,GAAsB,MAAA,QAAc,yBAAA;;;;;;AL6BhD;;;;;;;;cMZa,sBAAA,EAAsB,MAAA,CAAA,OAAA,CAOjC,MAAA,CAPiC,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/schemas/notificationPayloadSchema.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/controllers/AdminNotificationController.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/schemas/notificationContactSchema.ts","../../../src/api/notifications/schemas/notificationDetailResourceSchema.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/schemas/notificationResourceSchema.ts","../../../src/api/notifications/index.ts"],"mappings":"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"}

package/dist/api/notifications/index.js

@@ -1,7 +1,10 @@
 import { $inject, $module, Alepha, AlephaError, KIND, Primitive, createPrimitive, t } from "alepha";
-import { $job } from "alepha/api/jobs";
+import { $job, JobService, jobExecutionEntity } from "alepha/api/jobs";
+import { $secure } from "alepha/security";
+import { $action } from "alepha/server";
+import { $repository, pageQuerySchema } from "alepha/orm";
 import { EmailProvider } from "alepha/email";
-import { $logger } from "alepha/logger";
+import { $logger, logEntrySchema } from "alepha/logger";
 import { SmsProvider } from "alepha/sms";
 
 //#region ../../src/api/notifications/schemas/notificationPayloadSchema.ts
@@ -92,18 +95,31 @@ var NotificationSenderService = class {
 			contact: payload.contact
 		});
 		if (payload.type === "email") {
-			await this.emailProvider.send(this.renderEmail(payload));
+			const rendered = this.renderEmail(payload);
+			await this.emailProvider.send(rendered);
 			this.log.info("Email notification sent", {
 				template: payload.template,
 				contact: payload.contact
 			});
+			return {
+				type: "email",
+				to: rendered.to,
+				subject: rendered.subject,
+				body: rendered.body
+			};
 		}
 		if (payload.type === "sms") {
-			await this.smsProvider.send(this.renderSms(payload));
+			const rendered = this.renderSms(payload);
+			await this.smsProvider.send(rendered);
 			this.log.info("SMS notification sent", {
 				template: payload.template,
 				contact: payload.contact
 			});
+			return {
+				type: "sms",
+				to: rendered.to,
+				message: rendered.message
+			};
 		}
 	}
 	renderSms(payload) {
@@ -142,6 +158,7 @@ var NotificationSenderService = class {
 //#region ../../src/api/notifications/jobs/NotificationJobs.ts
 var NotificationJobs = class {
 	notificationSenderService = $inject(NotificationSenderService);
+	executions = $repository(jobExecutionEntity);
 	sendNotification = $job({
 		schema: notificationPayloadSchema,
 		retry: {
@@ -156,9 +173,123 @@ var NotificationJobs = class {
 		timeout: [30, "seconds"],
 		concurrency: 5,
 		handler: async ({ items }) => {
-			for (const item of items) await this.notificationSenderService.send(item.payload);
+			for (const item of items) {
+				const rendered = await this.notificationSenderService.send(item.payload);
+				if (rendered) await this.executions.updateById(item.id, { result: rendered });
+			}
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/api/notifications/schemas/notificationResourceSchema.ts
+const notificationResourceSchema = t.object({
+	id: t.uuid(),
+	createdAt: t.datetime(),
+	status: t.text(),
+	template: t.optional(t.text()),
+	type: t.optional(t.text()),
+	contact: t.optional(t.text()),
+	category: t.optional(t.text()),
+	critical: t.optional(t.boolean()),
+	sensitive: t.optional(t.boolean()),
+	startedAt: t.optional(t.datetime()),
+	completedAt: t.optional(t.datetime()),
+	error: t.optional(t.text())
+});
+
+//#endregion
+//#region ../../src/api/notifications/schemas/notificationDetailResourceSchema.ts
+const notificationDetailResourceSchema = t.extend(notificationResourceSchema, {
+	variables: t.optional(t.record(t.text(), t.any())),
+	rendered: t.optional(t.record(t.text(), t.any())),
+	logs: t.optional(t.array(logEntrySchema))
+}, {
+	title: "NotificationDetailResource",
+	description: "A notification resource with rendered content and logs."
+});
+
+//#endregion
+//#region ../../src/api/notifications/schemas/notificationQuerySchema.ts
+const notificationQuerySchema = t.extend(pageQuerySchema, { status: t.optional(t.enum([
+	"pending",
+	"scheduled",
+	"retrying",
+	"running",
+	"completed",
+	"failed",
+	"dead",
+	"cancelled"
+])) });
+
+//#endregion
+//#region ../../src/api/notifications/controllers/AdminNotificationController.ts
+var AdminNotificationController = class {
+	url = "/notifications";
+	group = "admin:notifications";
+	jobService = $inject(JobService);
+	notificationJobs = $inject(NotificationJobs);
+	get jobName() {
+		return this.notificationJobs.sendNotification.name;
+	}
+	findNotifications = $action({
+		path: this.url,
+		group: this.group,
+		use: [$secure({ permissions: ["admin:notification:read"] })],
+		schema: {
+			query: notificationQuerySchema,
+			response: t.page(notificationResourceSchema)
+		},
+		handler: async ({ query }) => {
+			const result = await this.jobService.findExecutions({
+				...query,
+				job: this.jobName
+			});
+			return {
+				...result,
+				content: result.content.map((exec) => this.toResource(exec))
+			};
+		}
+	});
+	getNotification = $action({
+		path: `${this.url}/:id`,
+		group: this.group,
+		use: [$secure({ permissions: ["admin:notification:read"] })],
+		schema: {
+			params: t.object({ id: t.uuid() }),
+			response: notificationDetailResourceSchema
+		},
+		handler: async ({ params }) => {
+			const detail = await this.jobService.getExecution(params.id);
+			return this.toDetailResource(detail);
 		}
 	});
+	toResource(exec) {
+		const payload = exec.payload ?? {};
+		return {
+			id: exec.id,
+			createdAt: exec.createdAt,
+			status: exec.status,
+			template: payload.template,
+			type: payload.type,
+			contact: payload.contact,
+			category: payload.category,
+			critical: payload.critical,
+			sensitive: payload.sensitive,
+			startedAt: exec.startedAt,
+			completedAt: exec.completedAt,
+			error: exec.error
+		};
+	}
+	toDetailResource(exec) {
+		const payload = exec.payload ?? {};
+		return {
+			...this.toResource(exec),
+			variables: payload.variables,
+			rendered: exec.result,
+			logs: exec.logs
+		};
+	}
 };
 
 //#endregion
@@ -194,12 +325,16 @@ const notificationContactSchema = t.object({
 const AlephaApiNotifications = $module({
 	name: "alepha.api.notifications",
 	primitives: [$notification],
-	services: [NotificationSenderService, NotificationJobs],
+	services: [
+		NotificationSenderService,
+		NotificationJobs,
+		AdminNotificationController
+	],
 	register: (alepha) => {
-		alepha.with(NotificationSenderService).with(NotificationJobs);
+		alepha.with(NotificationSenderService).with(NotificationJobs).with(AdminNotificationController);
 	}
 });
 
 //#endregion
-export { $notification, AlephaApiNotifications, NotificationJobs, NotificationPrimitive, NotificationSenderService, notificationContactPreferencesSchema, notificationContactSchema, notificationPayloadSchema };
+export { $notification, AdminNotificationController, AlephaApiNotifications, NotificationJobs, NotificationPrimitive, NotificationSenderService, notificationContactPreferencesSchema, notificationContactSchema, notificationDetailResourceSchema, notificationPayloadSchema, notificationQuerySchema, notificationResourceSchema };
 //# sourceMappingURL=index.js.map

package/dist/api/notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/notifications/schemas/notificationPayloadSchema.ts","../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/schemas/notificationContactSchema.ts","../../../src/api/notifications/index.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\n\nexport const notificationPayloadSchema = t.object({\n  type: t.enum([\"email\", \"sms\"]),\n  template: t.text(),\n  contact: t.text(),\n  variables: t.optional(t.record(t.text(), t.any())),\n  category: t.optional(t.text()),\n  critical: t.optional(t.boolean()),\n  sensitive: t.optional(t.boolean()),\n});\n\nexport type NotificationPayload = Static<typeof notificationPayloadSchema>;\n","import {\n  $inject,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type StaticEncode,\n  type TObject,\n} from \"alepha\";\nimport { NotificationJobs } from \"../jobs/NotificationJobs.ts\";\n\n/**\n * Creates a notification primitive for managing email/SMS notification templates.\n *\n * Provides type-safe, reusable notification templates with multi-language support,\n * variable substitution, and categorization for different notification channels.\n *\n * @example\n * ```ts\n * class NotificationTemplates {\n *   welcomeEmail = $notification({\n *     name: \"welcome-email\",\n *     category: \"onboarding\",\n *     schema: t.object({ username: t.text(), activationLink: t.text() }),\n *     email: {\n *       subject: \"Welcome to our platform!\",\n *       body: (vars) => `Hello ${vars.username}, click: ${vars.activationLink}`\n *     }\n *   });\n *\n *   async sendWelcome(user: User) {\n *     await this.welcomeEmail.push({\n *       variables: { username: user.name, activationLink: generateLink() },\n *       contact: user.email\n *     });\n *   }\n * }\n * ```\n */\nexport const $notification = <T extends TObject>(\n  options: NotificationPrimitiveOptions<T>,\n) => createPrimitive(NotificationPrimitive<T>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPrimitiveOptions<T extends TObject>\n  extends NotificationMessage<T> {\n  name?: string;\n  description?: string;\n  category?: string;\n  critical?: boolean;\n  sensitive?: boolean;\n  translations?: {\n    // e.g., \"en\", \"fr\", even \"en-US\"\n    [lang: string]: NotificationMessage<T>;\n  };\n  schema: T;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class NotificationPrimitive<T extends TObject> extends Primitive<\n  NotificationPrimitiveOptions<T>\n> {\n  protected readonly notificationJobs = $inject(NotificationJobs);\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  public async push(options: NotificationPushOptions<T>) {\n    const pushOpts = this.options.critical\n      ? ({ priority: \"critical\" } as const)\n      : undefined;\n\n    if (this.options.email) {\n      await this.notificationJobs.sendNotification.push(\n        {\n          type: \"email\",\n          template: this.name,\n          contact: options.contact,\n          variables: options.variables as Record<string, unknown>,\n          category: this.options.category,\n          critical: this.options.critical,\n          sensitive: this.options.sensitive,\n        },\n        pushOpts,\n      );\n    }\n\n    if (this.options.sms) {\n      await this.notificationJobs.sendNotification.push(\n        {\n          type: \"sms\",\n          template: this.name,\n          contact: options.contact,\n          variables: options.variables as Record<string, unknown>,\n          category: this.options.category,\n          critical: this.options.critical,\n          sensitive: this.options.sensitive,\n        },\n        pushOpts,\n      );\n    }\n  }\n\n  public configure(options: Partial<NotificationPrimitiveOptions<T>>) {\n    Object.assign(this.options, options);\n  }\n}\n\n$notification[KIND] = NotificationPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPushOptions<T extends TObject> {\n  variables: StaticEncode<T>;\n  contact: string;\n}\n\nexport interface NotificationMessage<T extends TObject> {\n  email?: {\n    subject: string;\n    body: string | ((variables: Static<T>) => string);\n  };\n  sms?: {\n    message: string | ((variables: Static<T>) => string);\n  };\n}\n","import { $inject, Alepha, AlephaError } from \"alepha\";\nimport { EmailProvider } from \"alepha/email\";\nimport { $logger } from \"alepha/logger\";\nimport { SmsProvider } from \"alepha/sms\";\nimport { $notification } from \"../primitives/$notification.ts\";\nimport type { NotificationPayload } from \"../schemas/notificationPayloadSchema.ts\";\n\nexport class NotificationSenderService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly emailProvider = $inject(EmailProvider);\n  protected readonly smsProvider = $inject(SmsProvider);\n\n  public async send(payload: NotificationPayload) {\n    this.log.debug(\"Processing notification\", {\n      type: payload.type,\n      template: payload.template,\n      contact: payload.contact,\n    });\n\n    if (payload.type === \"email\") {\n      await this.emailProvider.send(this.renderEmail(payload));\n      this.log.info(\"Email notification sent\", {\n        template: payload.template,\n        contact: payload.contact,\n      });\n    }\n\n    if (payload.type === \"sms\") {\n      await this.smsProvider.send(this.renderSms(payload));\n      this.log.info(\"SMS notification sent\", {\n        template: payload.template,\n        contact: payload.contact,\n      });\n    }\n  }\n\n  public renderSms(payload: NotificationPayload) {\n    const { variables, contact, template } = this.load(payload);\n\n    const sms = template.options.sms;\n    if (!sms) {\n      throw new AlephaError(\n        `Notification template ${payload.template} has no sms defined`,\n      );\n    }\n\n    const message =\n      typeof sms.message === \"function\"\n        ? sms.message(variables as any)\n        : sms.message;\n\n    return { to: contact, message };\n  }\n\n  public renderEmail(payload: NotificationPayload) {\n    const { variables, contact, template } = this.load(payload);\n\n    const email = template.options.email;\n    if (!email) {\n      throw new AlephaError(\n        `Notification template ${payload.template} has no email defined`,\n      );\n    }\n\n    const subject = email.subject;\n    const body =\n      typeof email.body === \"function\"\n        ? email.body(variables as any)\n        : email.body;\n\n    return { to: contact, subject, body };\n  }\n\n  protected load(payload: NotificationPayload) {\n    const variables = payload.variables || {};\n    const contact = payload.contact;\n    const template = this.alepha\n      .primitives($notification)\n      .find((it) => it.name === payload.template);\n\n    if (!template) {\n      throw new AlephaError(\n        `No notification template found for ${payload.template}`,\n      );\n    }\n\n    return { template, variables, contact };\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $job } from \"alepha/api/jobs\";\nimport { notificationPayloadSchema } from \"../schemas/notificationPayloadSchema.ts\";\nimport { NotificationSenderService } from \"../services/NotificationSenderService.ts\";\n\nexport class NotificationJobs {\n  protected readonly notificationSenderService = $inject(\n    NotificationSenderService,\n  );\n\n  public readonly sendNotification = $job({\n    schema: notificationPayloadSchema,\n    retry: {\n      retries: 3,\n      backoff: {\n        initial: [5, \"seconds\"],\n        factor: 4,\n        max: [10, \"minutes\"],\n        jitter: true,\n      },\n    },\n    timeout: [30, \"seconds\"],\n    concurrency: 5,\n    handler: async ({ items }) => {\n      for (const item of items) {\n        await this.notificationSenderService.send(item.payload);\n      }\n    },\n  });\n}\n","import { type Static, t } from \"alepha\";\n\nexport const notificationContactPreferencesSchema = t.object({\n  language: t.optional(t.text()),\n  exclude: t.array(t.text()),\n});\n\nexport type NotificationContactPreferences = Static<\n  typeof notificationContactPreferencesSchema\n>;\n","import { type Static, t } from \"alepha\";\n\nexport const notificationContactSchema = t.object({\n  email: t.optional(t.email()),\n  phoneNumber: t.optional(t.e164()),\n  firstName: t.optional(t.shortText()),\n  lastName: t.optional(t.text({ size: \"short\" })),\n  language: t.optional(t.bcp47()),\n});\n\nexport type NotificationContact = Static<typeof notificationContactSchema>;\n","import { $module } from \"alepha\";\nimport { NotificationJobs } from \"./jobs/NotificationJobs.ts\";\nimport { $notification } from \"./primitives/$notification.ts\";\nimport { NotificationSenderService } from \"./services/NotificationSenderService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./jobs/NotificationJobs.ts\";\nexport * from \"./primitives/$notification.ts\";\nexport * from \"./schemas/notificationContactPreferencesSchema.ts\";\nexport * from \"./schemas/notificationContactSchema.ts\";\nexport * from \"./schemas/notificationPayloadSchema.ts\";\nexport * from \"./services/NotificationSenderService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * User notification management.\n *\n * **Features:**\n * - Notification definitions\n * - Email/SMS notification sending\n * - Job-based delivery with retry and tracking\n * - User preferences\n *\n * @module alepha.api.notifications\n */\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  primitives: [$notification],\n  services: [NotificationSenderService, NotificationJobs],\n  register: (alepha) => {\n    alepha.with(NotificationSenderService).with(NotificationJobs);\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/notifications/schemas/notificationPayloadSchema.ts","../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/schemas/notificationResourceSchema.ts","../../../src/api/notifications/schemas/notificationDetailResourceSchema.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/controllers/AdminNotificationController.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/schemas/notificationContactSchema.ts","../../../src/api/notifications/index.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\n\nexport const notificationPayloadSchema = t.object({\n  type: t.enum([\"email\", \"sms\"]),\n  template: t.text(),\n  contact: t.text(),\n  variables: t.optional(t.record(t.text(), t.any())),\n  category: t.optional(t.text()),\n  critical: t.optional(t.boolean()),\n  sensitive: t.optional(t.boolean()),\n});\n\nexport type NotificationPayload = Static<typeof notificationPayloadSchema>;\n","import {\n  $inject,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type StaticEncode,\n  type TObject,\n} from \"alepha\";\nimport { NotificationJobs } from \"../jobs/NotificationJobs.ts\";\n\n/**\n * Creates a notification primitive for managing email/SMS notification templates.\n *\n * Provides type-safe, reusable notification templates with multi-language support,\n * variable substitution, and categorization for different notification channels.\n *\n * @example\n * ```ts\n * class NotificationTemplates {\n *   welcomeEmail = $notification({\n *     name: \"welcome-email\",\n *     category: \"onboarding\",\n *     schema: t.object({ username: t.text(), activationLink: t.text() }),\n *     email: {\n *       subject: \"Welcome to our platform!\",\n *       body: (vars) => `Hello ${vars.username}, click: ${vars.activationLink}`\n *     }\n *   });\n *\n *   async sendWelcome(user: User) {\n *     await this.welcomeEmail.push({\n *       variables: { username: user.name, activationLink: generateLink() },\n *       contact: user.email\n *     });\n *   }\n * }\n * ```\n */\nexport const $notification = <T extends TObject>(\n  options: NotificationPrimitiveOptions<T>,\n) => createPrimitive(NotificationPrimitive<T>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPrimitiveOptions<T extends TObject>\n  extends NotificationMessage<T> {\n  name?: string;\n  description?: string;\n  category?: string;\n  critical?: boolean;\n  sensitive?: boolean;\n  translations?: {\n    // e.g., \"en\", \"fr\", even \"en-US\"\n    [lang: string]: NotificationMessage<T>;\n  };\n  schema: T;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class NotificationPrimitive<T extends TObject> extends Primitive<\n  NotificationPrimitiveOptions<T>\n> {\n  protected readonly notificationJobs = $inject(NotificationJobs);\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  public async push(options: NotificationPushOptions<T>) {\n    const pushOpts = this.options.critical\n      ? ({ priority: \"critical\" } as const)\n      : undefined;\n\n    if (this.options.email) {\n      await this.notificationJobs.sendNotification.push(\n        {\n          type: \"email\",\n          template: this.name,\n          contact: options.contact,\n          variables: options.variables as Record<string, unknown>,\n          category: this.options.category,\n          critical: this.options.critical,\n          sensitive: this.options.sensitive,\n        },\n        pushOpts,\n      );\n    }\n\n    if (this.options.sms) {\n      await this.notificationJobs.sendNotification.push(\n        {\n          type: \"sms\",\n          template: this.name,\n          contact: options.contact,\n          variables: options.variables as Record<string, unknown>,\n          category: this.options.category,\n          critical: this.options.critical,\n          sensitive: this.options.sensitive,\n        },\n        pushOpts,\n      );\n    }\n  }\n\n  public configure(options: Partial<NotificationPrimitiveOptions<T>>) {\n    Object.assign(this.options, options);\n  }\n}\n\n$notification[KIND] = NotificationPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPushOptions<T extends TObject> {\n  variables: StaticEncode<T>;\n  contact: string;\n}\n\nexport interface NotificationMessage<T extends TObject> {\n  email?: {\n    subject: string;\n    body: string | ((variables: Static<T>) => string);\n  };\n  sms?: {\n    message: string | ((variables: Static<T>) => string);\n  };\n}\n","import { $inject, Alepha, AlephaError } from \"alepha\";\nimport { EmailProvider } from \"alepha/email\";\nimport { $logger } from \"alepha/logger\";\nimport { SmsProvider } from \"alepha/sms\";\nimport { $notification } from \"../primitives/$notification.ts\";\nimport type { NotificationPayload } from \"../schemas/notificationPayloadSchema.ts\";\n\nexport class NotificationSenderService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly emailProvider = $inject(EmailProvider);\n  protected readonly smsProvider = $inject(SmsProvider);\n\n  public async send(payload: NotificationPayload) {\n    this.log.debug(\"Processing notification\", {\n      type: payload.type,\n      template: payload.template,\n      contact: payload.contact,\n    });\n\n    if (payload.type === \"email\") {\n      const rendered = this.renderEmail(payload);\n      await this.emailProvider.send(rendered);\n      this.log.info(\"Email notification sent\", {\n        template: payload.template,\n        contact: payload.contact,\n      });\n      return {\n        type: \"email\" as const,\n        to: rendered.to,\n        subject: rendered.subject,\n        body: rendered.body,\n      };\n    }\n\n    if (payload.type === \"sms\") {\n      const rendered = this.renderSms(payload);\n      await this.smsProvider.send(rendered);\n      this.log.info(\"SMS notification sent\", {\n        template: payload.template,\n        contact: payload.contact,\n      });\n      return {\n        type: \"sms\" as const,\n        to: rendered.to,\n        message: rendered.message,\n      };\n    }\n  }\n\n  public renderSms(payload: NotificationPayload) {\n    const { variables, contact, template } = this.load(payload);\n\n    const sms = template.options.sms;\n    if (!sms) {\n      throw new AlephaError(\n        `Notification template ${payload.template} has no sms defined`,\n      );\n    }\n\n    const message =\n      typeof sms.message === \"function\"\n        ? sms.message(variables as any)\n        : sms.message;\n\n    return { to: contact, message };\n  }\n\n  public renderEmail(payload: NotificationPayload) {\n    const { variables, contact, template } = this.load(payload);\n\n    const email = template.options.email;\n    if (!email) {\n      throw new AlephaError(\n        `Notification template ${payload.template} has no email defined`,\n      );\n    }\n\n    const subject = email.subject;\n    const body =\n      typeof email.body === \"function\"\n        ? email.body(variables as any)\n        : email.body;\n\n    return { to: contact, subject, body };\n  }\n\n  protected load(payload: NotificationPayload) {\n    const variables = payload.variables || {};\n    const contact = payload.contact;\n    const template = this.alepha\n      .primitives($notification)\n      .find((it) => it.name === payload.template);\n\n    if (!template) {\n      throw new AlephaError(\n        `No notification template found for ${payload.template}`,\n      );\n    }\n\n    return { template, variables, contact };\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $job, jobExecutionEntity } from \"alepha/api/jobs\";\nimport { $repository } from \"alepha/orm\";\nimport { notificationPayloadSchema } from \"../schemas/notificationPayloadSchema.ts\";\nimport { NotificationSenderService } from \"../services/NotificationSenderService.ts\";\n\nexport class NotificationJobs {\n  protected readonly notificationSenderService = $inject(\n    NotificationSenderService,\n  );\n  protected readonly executions = $repository(jobExecutionEntity);\n\n  public readonly sendNotification = $job({\n    schema: notificationPayloadSchema,\n    retry: {\n      retries: 3,\n      backoff: {\n        initial: [5, \"seconds\"],\n        factor: 4,\n        max: [10, \"minutes\"],\n        jitter: true,\n      },\n    },\n    timeout: [30, \"seconds\"],\n    concurrency: 5,\n    handler: async ({ items }) => {\n      for (const item of items) {\n        const rendered = await this.notificationSenderService.send(\n          item.payload,\n        );\n        if (rendered) {\n          await this.executions.updateById(item.id, {\n            result: rendered as Record<string, unknown>,\n          });\n        }\n      }\n    },\n  });\n}\n","import { type Static, t } from \"alepha\";\n\nexport const notificationResourceSchema = t.object({\n  id: t.uuid(),\n  createdAt: t.datetime(),\n  status: t.text(),\n  template: t.optional(t.text()),\n  type: t.optional(t.text()),\n  contact: t.optional(t.text()),\n  category: t.optional(t.text()),\n  critical: t.optional(t.boolean()),\n  sensitive: t.optional(t.boolean()),\n  startedAt: t.optional(t.datetime()),\n  completedAt: t.optional(t.datetime()),\n  error: t.optional(t.text()),\n});\n\nexport type NotificationResource = Static<typeof notificationResourceSchema>;\n","import { type Static, t } from \"alepha\";\nimport { logEntrySchema } from \"alepha/logger\";\nimport { notificationResourceSchema } from \"./notificationResourceSchema.ts\";\n\nexport const notificationDetailResourceSchema = t.extend(\n  notificationResourceSchema,\n  {\n    variables: t.optional(t.record(t.text(), t.any())),\n    rendered: t.optional(t.record(t.text(), t.any())),\n    logs: t.optional(t.array(logEntrySchema)),\n  },\n  {\n    title: \"NotificationDetailResource\",\n    description: \"A notification resource with rendered content and logs.\",\n  },\n);\n\nexport type NotificationDetailResource = Static<\n  typeof notificationDetailResourceSchema\n>;\n","import { type Static, t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const notificationQuerySchema = t.extend(pageQuerySchema, {\n  status: t.optional(\n    t.enum([\n      \"pending\",\n      \"scheduled\",\n      \"retrying\",\n      \"running\",\n      \"completed\",\n      \"failed\",\n      \"dead\",\n      \"cancelled\",\n    ]),\n  ),\n});\n\nexport type NotificationQuery = Static<typeof notificationQuerySchema>;\n","import { $inject, t } from \"alepha\";\nimport { JobService } from \"alepha/api/jobs\";\nimport { $secure } from \"alepha/security\";\nimport { $action } from \"alepha/server\";\nimport { NotificationJobs } from \"../jobs/NotificationJobs.ts\";\nimport { notificationDetailResourceSchema } from \"../schemas/notificationDetailResourceSchema.ts\";\nimport { notificationQuerySchema } from \"../schemas/notificationQuerySchema.ts\";\nimport { notificationResourceSchema } from \"../schemas/notificationResourceSchema.ts\";\n\nexport class AdminNotificationController {\n  protected readonly url: string = \"/notifications\";\n  protected readonly group: string = \"admin:notifications\";\n  protected readonly jobService = $inject(JobService);\n  protected readonly notificationJobs = $inject(NotificationJobs);\n\n  protected get jobName(): string {\n    return this.notificationJobs.sendNotification.name;\n  }\n\n  public readonly findNotifications = $action({\n    path: this.url,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:notification:read\"] })],\n    schema: {\n      query: notificationQuerySchema,\n      response: t.page(notificationResourceSchema),\n    },\n    handler: async ({ query }) => {\n      const result = await this.jobService.findExecutions({\n        ...query,\n        job: this.jobName,\n      });\n      return {\n        ...result,\n        content: result.content.map((exec) => this.toResource(exec)),\n      } as any;\n    },\n  });\n\n  public readonly getNotification = $action({\n    path: `${this.url}/:id`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:notification:read\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      response: notificationDetailResourceSchema,\n    },\n    handler: async ({ params }) => {\n      const detail = await this.jobService.getExecution(params.id);\n      return this.toDetailResource(detail) as any;\n    },\n  });\n\n  protected toResource(exec: Record<string, unknown>) {\n    const payload = (exec.payload ?? {}) as Record<string, unknown>;\n    return {\n      id: exec.id,\n      createdAt: exec.createdAt,\n      status: exec.status,\n      template: payload.template,\n      type: payload.type,\n      contact: payload.contact,\n      category: payload.category,\n      critical: payload.critical,\n      sensitive: payload.sensitive,\n      startedAt: exec.startedAt,\n      completedAt: exec.completedAt,\n      error: exec.error,\n    };\n  }\n\n  protected toDetailResource(exec: Record<string, unknown>) {\n    const payload = (exec.payload ?? {}) as Record<string, unknown>;\n    return {\n      ...this.toResource(exec),\n      variables: payload.variables,\n      rendered: exec.result,\n      logs: exec.logs,\n    };\n  }\n}\n","import { type Static, t } from \"alepha\";\n\nexport const notificationContactPreferencesSchema = t.object({\n  language: t.optional(t.text()),\n  exclude: t.array(t.text()),\n});\n\nexport type NotificationContactPreferences = Static<\n  typeof notificationContactPreferencesSchema\n>;\n","import { type Static, t } from \"alepha\";\n\nexport const notificationContactSchema = t.object({\n  email: t.optional(t.email()),\n  phoneNumber: t.optional(t.e164()),\n  firstName: t.optional(t.shortText()),\n  lastName: t.optional(t.text({ size: \"short\" })),\n  language: t.optional(t.bcp47()),\n});\n\nexport type NotificationContact = Static<typeof notificationContactSchema>;\n","import { $module } from \"alepha\";\nimport { AdminNotificationController } from \"./controllers/AdminNotificationController.ts\";\nimport { NotificationJobs } from \"./jobs/NotificationJobs.ts\";\nimport { $notification } from \"./primitives/$notification.ts\";\nimport { NotificationSenderService } from \"./services/NotificationSenderService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/AdminNotificationController.ts\";\nexport * from \"./jobs/NotificationJobs.ts\";\nexport * from \"./primitives/$notification.ts\";\nexport * from \"./schemas/notificationContactPreferencesSchema.ts\";\nexport * from \"./schemas/notificationContactSchema.ts\";\nexport * from \"./schemas/notificationDetailResourceSchema.ts\";\nexport * from \"./schemas/notificationPayloadSchema.ts\";\nexport * from \"./schemas/notificationQuerySchema.ts\";\nexport * from \"./schemas/notificationResourceSchema.ts\";\nexport * from \"./services/NotificationSenderService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * User notification management.\n *\n * **Features:**\n * - Notification definitions\n * - Email/SMS notification sending\n * - Job-based delivery with retry and tracking\n * - User preferences\n *\n * @module alepha.api.notifications\n */\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  primitives: [$notification],\n  services: [\n    NotificationSenderService,\n    NotificationJobs,\n    AdminNotificationController,\n  ],\n  register: (alepha) => {\n    alepha\n      .with(NotificationSenderService)\n      .with(NotificationJobs)\n      .with(AdminNotificationController);\n  },\n});\n"],"mappings":"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"}

package/dist/api/parameters/index.d.ts

@@ -18,12 +18,15 @@ import "drizzle-orm/sqlite-core";
 /**
  * Transforms a TObject schema for insert operations.
  * All default properties at the root level are made optional.
+ * Generated columns are excluded entirely.
  *
  * @example
- * Before: { name: string; age: number(default=0); }
+ * Before: { name: string; age: number(default=0); fullName: generated }
  * After:  { name: string; age?: number; }
  */
-type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends {
+type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"] as T["properties"][K] extends {
+  [PG_GENERATED]: any;
+} ? never : K]: T["properties"][K] extends {
   [PG_DEFAULT]: any;
 } | {
   "~optional": true;
@@ -33,13 +36,15 @@ type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"]]:
 /**
  * Transforms a TObject schema for update operations.
  * All optional properties at the root level are made nullable (i.e., `T | null`).
- * This allows an API endpoint to explicitly accept `null` to clear an optional field in the database.
+ * Generated columns are excluded entirely.
  *
  * @example
- * Before: { name?: string; age: number; }
+ * Before: { name?: string; age: number; fullName: generated }
  * After:  { name?: string | null; age: number; }
  */
-type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
+type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"] as T["properties"][K] extends {
+  [PG_GENERATED]: any;
+} ? never : K]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
 //#endregion
 //#region ../../src/orm/core/primitives/$entity.d.ts
 interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
@@ -68,6 +73,10 @@ interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
      * Custom name for the index. If not provided, generates name automatically.
      */
     name?: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
   } | {
     /**
      * Multiple columns for composite index (order matters for query optimization).
@@ -81,6 +90,10 @@ interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
      * Custom name for the index. If not provided, generates name automatically.
      */
     name?: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
   })[];
   /**
    * Foreign key constraints to maintain referential integrity.
@@ -184,6 +197,7 @@ declare const PG_VERSION: unique symbol;
 declare const PG_IDENTITY: unique symbol;
 declare const PG_ENUM: unique symbol;
 declare const PG_REF: unique symbol;
+declare const PG_GENERATED: unique symbol;
 /**
  * @deprecated Use `PG_IDENTITY` instead.
  */
@@ -198,6 +212,7 @@ type PgSymbols = {
   [PG_IDENTITY]: PgIdentityOptions;
   [PG_REF]: PgRefOptions;
   [PG_ENUM]: PgEnumOptions;
+  [PG_GENERATED]: PgGeneratedOptions;
   /**
    * @deprecated Use `PG_IDENTITY` instead.
    */
@@ -213,6 +228,18 @@ interface PgEnumOptions {
   name?: string;
   description?: string;
 }
+interface PgGeneratedOptions {
+  /**
+   * SQL expression for the generated column.
+   */
+  expression: SQL;
+  /**
+   * Storage mode for the generated column.
+   * - `"stored"` — value is computed on write and stored on disk (default for PostgreSQL).
+   * - `"virtual"` — value is computed on read (default for SQLite).
+   */
+  mode?: "stored" | "virtual";
+}
 interface PgRefOptions {
   ref: () => {
     name: string;
@@ -230,6 +257,35 @@ interface PgRefOptions {
  */
 type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
 //#endregion
+//#region ../../src/orm/core/schemas/databaseEnvSchema.d.ts
+/**
+ * Base database environment schema.
+ *
+ * Defines the `DATABASE_URL` connection string used by all ORM providers
+ * to determine the database driver and connection target.
+ *
+ * Supported URL formats:
+ * - `sqlite://:memory:` or `sqlite://./path/to/db` — SQLite (Node.js or Bun)
+ * - `postgres://user:password@host:port/database` — PostgreSQL (Node.js or Bun)
+ * - `pglite://:memory:` or `pglite://./path` — PGlite (embedded Postgres)
+ * - `d1://BINDING_NAME` — Cloudflare D1
+ * - `hyperdrive://BINDING_NAME` — Cloudflare Hyperdrive
+ */
+declare const databaseEnvSchema: alepha.TObject<{
+  DATABASE_URL: alepha.TOptional<alepha.TString>;
+  /**
+   * Enable or disable push-based schema synchronization (drizzle-kit push).
+   *
+   * Defaults to `true` in development and test, `false` in production.
+   * Set to `false` in development to skip automatic schema sync
+   * (e.g. when managing migrations manually).
+   */
+  DATABASE_SYNC: alepha.TOptional<alepha.TBoolean>;
+}>;
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof databaseEnvSchema>> {}
+} //# sourceMappingURL=databaseEnvSchema.d.ts.map
+//#endregion
 //#region ../../src/api/parameters/entities/parameters.d.ts
 /**
  * Configuration parameter entity for versioned configuration management.