@holo-js/notifications 0.2.5 → 0.3.0

package/dist/{chunk-INGM2JYY.mjs → chunk-4KUFKBEW.mjs}

@@ -1,5 +1,4 @@
 // src/contracts.ts
-import { defineNotificationsConfig } from "@holo-js/config";
 var HOLO_NOTIFICATION_DEFINITION_MARKER = /* @__PURE__ */ Symbol.for("holo-js.notifications.definition");
 var BUILT_IN_NOTIFICATION_CHANNELS = ["email", "database", "broadcast"];
 function isObject(value) {
@@ -117,7 +116,6 @@ var notificationsInternals = {
 };
 
 export {
-  defineNotificationsConfig,
   isNotificationDefinition,
   normalizeNotificationDefinition,
   defineNotification,

package/dist/chunk-ZZH7Q6TC.mjs

@@ -0,0 +1,45 @@
+// src/config.ts
+import { registerConfigNormalizer } from "@holo-js/config/registry";
+var DEFAULT_NOTIFICATIONS_TABLE = "notifications";
+var holoNotificationsDefaults = Object.freeze({
+  table: DEFAULT_NOTIFICATIONS_TABLE,
+  queue: Object.freeze({
+    connection: void 0,
+    queue: void 0,
+    afterCommit: false
+  })
+});
+function normalizeOptionalString(value, label) {
+  if (typeof value === "undefined") {
+    return void 0;
+  }
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`[@holo-js/notifications] ${label} must be a non-empty string when provided.`);
+  }
+  return normalized;
+}
+function defineNotificationsConfig(config) {
+  return Object.freeze({ ...config });
+}
+function normalizeNotificationsConfig(config = {}) {
+  return Object.freeze({
+    table: normalizeOptionalString(config.table, "Notifications table") ?? DEFAULT_NOTIFICATIONS_TABLE,
+    queue: Object.freeze({
+      connection: normalizeOptionalString(config.queue?.connection, "Notifications queue connection"),
+      queue: normalizeOptionalString(config.queue?.queue, "Notifications queue name"),
+      afterCommit: config.queue?.afterCommit === true
+    })
+  });
+}
+registerConfigNormalizer({
+  name: "notifications",
+  normalize: normalizeNotificationsConfig
+});
+
+export {
+  DEFAULT_NOTIFICATIONS_TABLE,
+  holoNotificationsDefaults,
+  defineNotificationsConfig,
+  normalizeNotificationsConfig
+};

package/dist/config.d.ts

@@ -0,0 +1,27 @@
+interface HoloNotificationsConfig {
+    readonly table?: string;
+    readonly queue?: {
+        readonly connection?: string;
+        readonly queue?: string;
+        readonly afterCommit?: boolean;
+    };
+}
+declare module '@holo-js/config' {
+    interface HoloConfigRegistry {
+        notifications: NormalizedHoloNotificationsConfig;
+    }
+}
+interface NormalizedHoloNotificationsConfig {
+    readonly table: string;
+    readonly queue: {
+        readonly connection?: string;
+        readonly queue?: string;
+        readonly afterCommit: boolean;
+    };
+}
+declare const DEFAULT_NOTIFICATIONS_TABLE = "notifications";
+declare const holoNotificationsDefaults: Readonly<NormalizedHoloNotificationsConfig>;
+declare function defineNotificationsConfig<const TConfig extends HoloNotificationsConfig>(config: TConfig): Readonly<TConfig>;
+declare function normalizeNotificationsConfig(config?: HoloNotificationsConfig): NormalizedHoloNotificationsConfig;
+
+export { DEFAULT_NOTIFICATIONS_TABLE, type HoloNotificationsConfig, type NormalizedHoloNotificationsConfig, defineNotificationsConfig, holoNotificationsDefaults, normalizeNotificationsConfig };

package/dist/config.mjs

@@ -0,0 +1,12 @@
+import {
+  DEFAULT_NOTIFICATIONS_TABLE,
+  defineNotificationsConfig,
+  holoNotificationsDefaults,
+  normalizeNotificationsConfig
+} from "./chunk-ZZH7Q6TC.mjs";
+export {
+  DEFAULT_NOTIFICATIONS_TABLE,
+  defineNotificationsConfig,
+  holoNotificationsDefaults,
+  normalizeNotificationsConfig
+};

package/dist/contracts.d.ts

@@ -1,5 +1,4 @@
-import { NormalizedHoloNotificationsConfig } from '@holo-js/config';
-export { defineNotificationsConfig } from '@holo-js/config';
+import { NormalizedHoloNotificationsConfig } from './config.js';
 
 type NotificationJsonPrimitive = string | number | boolean | null;
 type NotificationJsonValue = NotificationJsonPrimitive | readonly NotificationJsonValue[] | {
@@ -179,6 +178,7 @@ interface NotificationDispatchInput<TNotification extends NotificationDefinition
 }
 interface NotificationRuntimeBindings {
     readonly config?: NormalizedHoloNotificationsConfig;
+    readonly deferAfterCommit?: (callback: () => Promise<void>) => boolean;
     readonly mailer?: NotificationMailSender;
     readonly broadcaster?: NotificationBroadcaster;
     readonly store?: NotificationStore;

package/dist/contracts.mjs

@@ -1,15 +1,13 @@
 import {
   createAnonymousNotificationTarget,
   defineNotification,
-  defineNotificationsConfig,
   isNotificationDefinition,
   normalizeNotificationDefinition,
   notificationsInternals
-} from "./chunk-INGM2JYY.mjs";
+} from "./chunk-4KUFKBEW.mjs";
 export {
   createAnonymousNotificationTarget,
   defineNotification,
-  defineNotificationsConfig,
   isNotificationDefinition,
   normalizeNotificationDefinition,
   notificationsInternals

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-import { NotificationChannel, NotificationBuildContext, AnonymousNotificationTarget, NotificationBroadcastRoute, NotificationDatabaseRoute, NotificationEmailRoute, NotificationDatabaseMessage, NotificationRecord, NotificationRuntimeBindings, InferNotificationNotifiable, NotificationDefinition, PendingNotificationDispatch, NotificationDispatchResult, PendingAnonymousNotification, NotificationChannelName, NotificationRouteFor, NotificationDispatchTarget, NotificationDelayValue, NotificationSendContext, NotificationDispatchInput, NotificationDispatchOptions, NotificationQueueOptions, RegisteredNotificationChannel, RegisterNotificationChannelOptions } from './contracts.js';
+import { NotificationDelayValue, NotificationChannel, NotificationBuildContext, AnonymousNotificationTarget, NotificationBroadcastRoute, NotificationDatabaseRoute, NotificationEmailRoute, NotificationDatabaseMessage, NotificationRecord, NotificationRuntimeBindings, InferNotificationNotifiable, NotificationDefinition, PendingNotificationDispatch, NotificationDispatchResult, PendingAnonymousNotification, NotificationChannelName, NotificationRouteFor, NotificationDispatchTarget, NotificationSendContext, NotificationDispatchInput, NotificationDispatchOptions, NotificationQueueOptions, RegisteredNotificationChannel, RegisterNotificationChannelOptions } from './contracts.js';
 export { BuiltInNotificationChannelRegistry, HoloNotificationChannelRegistry, InferNotificationChannels, NotificationBroadcastMessage, NotificationBroadcaster, NotificationBuildFactories, NotificationChannelDispatchResult, NotificationContext, NotificationDelayResolver, NotificationJsonValue, NotificationMailMessage, NotificationMailSender, NotificationPayloadFor, NotificationQueueResolver, NotificationResultFor, NotificationStore, defineNotification, isNotificationDefinition, normalizeNotificationDefinition, notificationsInternals } from './contracts.js';
-import { HoloNotificationsConfig } from '@holo-js/config';
-export { HoloNotificationsConfig, NormalizedHoloNotificationsConfig } from '@holo-js/config';
+export { HoloNotificationsConfig, NormalizedHoloNotificationsConfig, defineNotificationsConfig, holoNotificationsDefaults, normalizeNotificationsConfig } from './config.js';
+
+declare function normalizeOptionalNotificationString(value: string, label: string): string;
+declare function normalizeOptionalNotificationString(value: string | undefined, label: string): string | undefined;
+declare function normalizeNotificationDelay(value: NotificationDelayValue, label: string): NotificationDelayValue;
 
 type RouteResolver = (notifiable: unknown) => unknown;
 type BuiltInChannelDefinition = NotificationChannel & {
@@ -22,19 +25,20 @@ declare function resolveBroadcastRouteFromNotifiable(notifiable: unknown): Notif
 declare function normalizeNotificationRecord(route: NotificationDatabaseRoute, payload: NotificationDatabaseMessage, notificationType: string | undefined): NotificationRecord;
 declare function normalizeNotificationRecordIds(ids: readonly string[]): readonly string[];
 
-declare function normalizeOptionalString(value: string, label: string): string;
-declare function normalizeOptionalString(value: string | undefined, label: string): string | undefined;
-declare function normalizeDelayValue(value: NotificationDelayValue, label: string): NotificationDelayValue;
 declare function getRuntimeBindings(): NotificationRuntimeBindings;
 type RuntimeState = {
     bindings?: NotificationRuntimeBindings;
+    projectRoot?: string;
+    pluginNames?: readonly string[];
     loadQueueModule?: () => Promise<QueueModule>;
-    loadDbModule?: () => Promise<DbModule | null>;
+};
+type ResolvedTargetChannels = {
+    readonly target: ResolvedTarget;
+    readonly channels: readonly string[];
 };
 declare function getRuntimeState(): RuntimeState;
 declare function getDispatchHandler(): typeof dispatchNotifications;
 declare function loadQueueModule(): Promise<QueueModule>;
-declare function loadDbModule(): Promise<DbModule | null>;
 type MutableDispatchOptions = {
     connection?: string;
     queue?: string;
@@ -76,18 +80,6 @@ type QueueModule = {
         name: string;
     }): void;
 };
-type DbModule = {
-    connectionAsyncContext: {
-        getActive(): {
-            connection: {
-                getScope(): {
-                    kind: string;
-                };
-                afterCommit(callback: () => Promise<void>): void;
-            };
-        } | undefined;
-    };
-};
 type QueuedNotificationDeliveryPayload = Readonly<{
     readonly channel: string;
     readonly anonymous: boolean;
@@ -110,7 +102,7 @@ declare function createQueuedDeliveryPayload(context: NotificationSendContext):
 declare function runQueuedNotificationDelivery(payload: QueuedNotificationDeliveryPayload): Promise<unknown>;
 declare function ensureNotificationsQueueJobRegistered(queueModule?: QueueModule): Promise<QueueModule>;
 declare function dispatchQueuedNotificationChannel(context: NotificationSendContext, plan: ResolvedChannelPlan): Promise<void>;
-declare function deferDispatchUntilCommit(input: NotificationDispatchInput, targets: readonly ResolvedTarget[], notification: NotificationDefinition): Promise<NotificationDispatchResult | null>;
+declare function deferDispatchUntilCommit(input: NotificationDispatchInput, notification: NotificationDefinition, targetChannels: readonly ResolvedTargetChannels[]): Promise<NotificationDispatchResult | null>;
 declare function dispatchNotifications(input: NotificationDispatchInput, execution?: DispatchExecutionOptions): Promise<NotificationDispatchResult>;
 declare class PendingDispatch<TResult = NotificationDispatchResult> implements PendingNotificationDispatch<TResult> {
     #private;
@@ -164,7 +156,7 @@ declare const notificationsRuntimeInternals: {
     HOLO_NOTIFICATIONS_DELIVER_JOB: string;
     AnonymousNotificationBuilder: typeof AnonymousNotificationBuilder;
     PendingDispatch: typeof PendingDispatch;
-    builtInChannels: Readonly<Record<"email" | "database" | "broadcast", BuiltInChannelDefinition>>;
+    builtInChannels: Readonly<Record<"database" | "email" | "broadcast", BuiltInChannelDefinition>>;
     createBuildContext: typeof createBuildContext;
     createNotificationContext: typeof createNotificationContext;
     createQueuedDeliveryPayload: typeof createQueuedDeliveryPayload;
@@ -179,15 +171,14 @@ declare const notificationsRuntimeInternals: {
     getNotificationChannel: typeof getNotificationChannel;
     isAnonymousTarget: typeof isAnonymousTarget;
     isObject: typeof isObject;
-    loadDbModule: typeof loadDbModule;
     loadQueueModule: typeof loadQueueModule;
     normalizeBroadcastRouteFromValue: typeof normalizeBroadcastRouteFromValue;
     normalizeDatabaseRouteFromValue: typeof normalizeDatabaseRouteFromValue;
-    normalizeDelayValue: typeof normalizeDelayValue;
+    normalizeDelayValue: typeof normalizeNotificationDelay;
     normalizeEmailRouteFromValue: typeof normalizeEmailRouteFromValue;
     normalizeNotificationRecord: typeof normalizeNotificationRecord;
     normalizeNotificationRecordIds: typeof normalizeNotificationRecordIds;
-    normalizeOptionalString: typeof normalizeOptionalString;
+    normalizeOptionalString: typeof normalizeOptionalNotificationString;
     resolveBroadcastRouteFromNotifiable: typeof resolveBroadcastRouteFromNotifiable;
     resolveChannelDispatchPlan: typeof resolveChannelDispatchPlan;
     resolveChannels: typeof resolveChannels;
@@ -199,7 +190,6 @@ declare const notificationsRuntimeInternals: {
     resolveRoute: typeof resolveRoute;
     runQueuedNotificationDelivery: typeof runQueuedNotificationDelivery;
     resolveTargets: typeof resolveTargets;
-    setDbModuleLoader(loader: (() => Promise<DbModule | null>) | undefined): void;
     setQueueModuleLoader(loader: (() => Promise<QueueModule>) | undefined): void;
 };
 
@@ -214,7 +204,9 @@ declare const notificationRegistryInternals: {
     normalizeChannelName: typeof normalizeChannelName;
 };
 
-declare function defineNotificationsConfig<const TConfig extends HoloNotificationsConfig>(config: TConfig): Readonly<TConfig>;
+declare function loadNotificationPluginChannels(projectRoot?: string, pluginNames?: readonly string[]): Promise<void>;
+declare function resetNotificationPluginChannels(): void;
+
 declare const notifications: Readonly<{
     deleteNotifications: typeof deleteNotifications;
     listNotifications: typeof listNotifications;
@@ -226,4 +218,4 @@ declare const notifications: Readonly<{
     unreadNotifications: typeof unreadNotifications;
 }>;
 
-export { AnonymousNotificationTarget, InferNotificationNotifiable, NotificationBroadcastRoute, NotificationBuildContext, NotificationChannel, NotificationChannelName, NotificationDatabaseMessage, NotificationDatabaseRoute, NotificationDefinition, NotificationDelayValue, NotificationDispatchInput, NotificationDispatchOptions, NotificationDispatchResult, NotificationDispatchTarget, NotificationEmailRoute, NotificationQueueOptions, NotificationRecord, NotificationRouteFor, NotificationRuntimeBindings, NotificationSendContext, PendingAnonymousNotification, PendingNotificationDispatch, RegisterNotificationChannelOptions, RegisteredNotificationChannel, configureNotificationsRuntime, notifications as default, defineNotificationsConfig, deleteNotifications, getNotificationsRuntime, getNotificationsRuntimeBindings, getRegisteredNotificationChannel, listNotifications, listRegisteredNotificationChannels, markNotificationsAsRead, markNotificationsAsUnread, notificationRegistryInternals, notificationsRuntimeInternals, notify, notifyMany, notifyUsing, registerNotificationChannel, resetNotificationChannelRegistry, resetNotificationsRuntime, unreadNotifications };
+export { AnonymousNotificationTarget, InferNotificationNotifiable, NotificationBroadcastRoute, NotificationBuildContext, NotificationChannel, NotificationChannelName, NotificationDatabaseMessage, NotificationDatabaseRoute, NotificationDefinition, NotificationDelayValue, NotificationDispatchInput, NotificationDispatchOptions, NotificationDispatchResult, NotificationDispatchTarget, NotificationEmailRoute, NotificationQueueOptions, NotificationRecord, NotificationRouteFor, NotificationRuntimeBindings, NotificationSendContext, PendingAnonymousNotification, PendingNotificationDispatch, RegisterNotificationChannelOptions, RegisteredNotificationChannel, configureNotificationsRuntime, notifications as default, deleteNotifications, getNotificationsRuntime, getNotificationsRuntimeBindings, getRegisteredNotificationChannel, listNotifications, listRegisteredNotificationChannels, loadNotificationPluginChannels, markNotificationsAsRead, markNotificationsAsUnread, notificationRegistryInternals, notificationsRuntimeInternals, notify, notifyMany, notifyUsing, registerNotificationChannel, resetNotificationChannelRegistry, resetNotificationPluginChannels, resetNotificationsRuntime, unreadNotifications };

package/dist/index.mjs

@@ -1,13 +1,15 @@
+import {
+  defineNotificationsConfig,
+  holoNotificationsDefaults,
+  normalizeNotificationsConfig
+} from "./chunk-ZZH7Q6TC.mjs";
 import {
   createAnonymousNotificationTarget,
   defineNotification,
   isNotificationDefinition,
   normalizeNotificationDefinition,
   notificationsInternals
-} from "./chunk-INGM2JYY.mjs";
-
-// src/runtime.ts
-import { holoNotificationsDefaults } from "@holo-js/config";
+} from "./chunk-4KUFKBEW.mjs";
 
 // src/registry.ts
 function normalizeChannelName(value) {
@@ -39,6 +41,9 @@ function registerNotificationChannel(name, channel, options = {}) {
 function getRegisteredNotificationChannel(name) {
   return getRegistry().get(normalizeChannelName(name));
 }
+function unregisterNotificationChannel(name) {
+  return getRegistry().delete(normalizeChannelName(name));
+}
 function listRegisteredNotificationChannels() {
   return Object.freeze([...getRegistry().values()]);
 }
@@ -50,6 +55,105 @@ var notificationRegistryInternals = {
   normalizeChannelName
 };
 
+// src/plugins.ts
+import {
+  loadHoloPluginContributionModules,
+  loadHoloPluginDefinitions
+} from "@holo-js/kernel";
+var loadedProjectRoots = /* @__PURE__ */ new Set();
+var registeredPluginChannels = /* @__PURE__ */ new Map();
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function resolveNotificationChannel(moduleValue, packageName, channelName) {
+  const candidate = isRecord(moduleValue) && typeof moduleValue.default !== "undefined" ? moduleValue.default : isRecord(moduleValue) && typeof moduleValue.channel !== "undefined" ? moduleValue.channel : moduleValue;
+  if (!isRecord(candidate) || typeof candidate.send !== "function") {
+    throw new Error(`[@holo-js/notifications] Plugin ${packageName} notification channel "${channelName}" must export send().`);
+  }
+  return {
+    send: candidate.send,
+    ...typeof candidate.validateRoute === "function" ? { validateRoute: candidate.validateRoute } : {}
+  };
+}
+async function loadNotificationPluginChannels(projectRoot = process.cwd(), pluginNames = []) {
+  if (loadedProjectRoots.has(projectRoot)) {
+    return;
+  }
+  const plugins = await loadHoloPluginDefinitions(projectRoot, pluginNames);
+  const contributions = await loadHoloPluginContributionModules(
+    projectRoot,
+    plugins,
+    "notifications",
+    "channels"
+  );
+  for (const contribution of contributions) {
+    const previous = getRegisteredNotificationChannel(contribution.name);
+    const channel = resolveNotificationChannel(contribution.module, contribution.plugin.packageName, contribution.name);
+    registerNotificationChannel(
+      contribution.name,
+      channel,
+      { replaceExisting: true }
+    );
+    const registered = getRegisteredNotificationChannel(contribution.name);
+    if (registered) {
+      const existingPluginChannel = registeredPluginChannels.get(registered.name);
+      registeredPluginChannels.set(registered.name, {
+        channel,
+        previous: existingPluginChannel ? existingPluginChannel.previous : previous?.channel
+      });
+    }
+  }
+  loadedProjectRoots.add(projectRoot);
+}
+function resetNotificationPluginChannels() {
+  for (const [channelName, registered] of registeredPluginChannels) {
+    if (getRegisteredNotificationChannel(channelName)?.channel !== registered.channel) {
+      continue;
+    }
+    unregisterNotificationChannel(channelName);
+    if (registered.previous) {
+      registerNotificationChannel(channelName, registered.previous, { replaceExisting: true });
+    }
+  }
+  loadedProjectRoots.clear();
+  registeredPluginChannels.clear();
+}
+
+// src/queueOptions.ts
+function normalizeOptionalNotificationString(value, label) {
+  if (typeof value === "undefined") return void 0;
+  const normalized = value.trim();
+  if (!normalized) throw new Error(`[@holo-js/notifications] ${label} must be a non-empty string.`);
+  return normalized;
+}
+function normalizeNotificationDelay(value, label) {
+  if (typeof value === "number") {
+    if (!Number.isFinite(value) || value < 0) {
+      throw new Error(`[@holo-js/notifications] ${label} must be a finite number greater than or equal to 0.`);
+    }
+    return value;
+  }
+  if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
+    throw new Error(`[@holo-js/notifications] ${label} dates must be valid Date instances.`);
+  }
+  return value;
+}
+function normalizeOptionalBoolean(value, label) {
+  if (typeof value === "undefined") return void 0;
+  if (typeof value !== "boolean") throw new Error(`[@holo-js/notifications] ${label} must be a boolean.`);
+  return value;
+}
+function normalizeNotificationQueueOptions(value) {
+  if (typeof value === "undefined") return void 0;
+  const afterCommit = normalizeOptionalBoolean(value.afterCommit, "Notification queue afterCommit");
+  return Object.freeze({
+    connection: normalizeOptionalNotificationString(value.connection, "Notification queue connection"),
+    queue: normalizeOptionalNotificationString(value.queue, "Notification queue name"),
+    ...typeof value.delay === "undefined" ? {} : { delay: normalizeNotificationDelay(value.delay, "Notification queue delay") },
+    ...typeof afterCommit === "undefined" ? {} : { afterCommit }
+  });
+}
+
 // src/runtime-channels.ts
 import { randomUUID } from "crypto";
 function isObject(value) {
@@ -250,48 +354,9 @@ function createBuiltInChannels(getBindings) {
 
 // src/runtime.ts
 var HOLO_NOTIFICATIONS_DELIVER_JOB = "holo.notifications.deliver";
-function normalizeOptionalString(value, label) {
-  if (typeof value === "undefined") {
-    return void 0;
-  }
-  const normalized = value.trim();
-  if (!normalized) {
-    throw new Error(`[@holo-js/notifications] ${label} must be a non-empty string.`);
-  }
-  return normalized;
-}
-function normalizeDelayValue(value, label) {
-  if (typeof value === "number") {
-    if (!Number.isFinite(value) || value < 0) {
-      throw new Error(`[@holo-js/notifications] ${label} must be a finite number greater than or equal to 0.`);
-    }
-    return value;
-  }
-  if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
-    throw new Error(`[@holo-js/notifications] ${label} dates must be valid Date instances.`);
-  }
-  return value;
-}
-function normalizeOptionalBoolean(value, label) {
-  if (typeof value === "undefined") {
-    return void 0;
-  }
-  if (typeof value !== "boolean") {
-    throw new Error(`[@holo-js/notifications] ${label} must be a boolean.`);
-  }
-  return value;
-}
-function normalizeQueueOptions(value) {
-  if (typeof value === "undefined") {
-    return void 0;
-  }
-  return Object.freeze({
-    connection: normalizeOptionalString(value.connection, "Notification queue connection"),
-    queue: normalizeOptionalString(value.queue, "Notification queue name"),
-    ...typeof value.delay === "undefined" ? {} : { delay: normalizeDelayValue(value.delay, "Notification queue delay") },
-    ...typeof normalizeOptionalBoolean(value.afterCommit, "Notification queue afterCommit") === "undefined" ? {} : { afterCommit: value.afterCommit }
-  });
-}
+var normalizeOptionalString = normalizeOptionalNotificationString;
+var normalizeDelayValue = normalizeNotificationDelay;
+var normalizeQueueOptions = normalizeNotificationQueueOptions;
 function getRuntimeBindings() {
   return getRuntimeState().bindings ?? {};
 }
@@ -328,27 +393,6 @@ async function loadQueueModule() {
     throw error;
   }
 }
-async function loadDbModule() {
-  const override = getRuntimeState().loadDbModule;
-  if (override) {
-    try {
-      return await override();
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
-        return null;
-      }
-      throw error;
-    }
-  }
-  try {
-    return await dynamicImport("@holo-js/db");
-  } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
-      return null;
-    }
-    throw error;
-  }
-}
 var builtInChannels = createBuiltInChannels(getRuntimeBindings);
 function getNotificationChannel(name) {
   const registered = getRegisteredNotificationChannel(name)?.channel;
@@ -389,7 +433,15 @@ function resolveTargets(target) {
     notifiable: target.value
   })]);
 }
-function resolveChannels(notification, target) {
+function resolveRegisteredChannels(channels) {
+  return Object.freeze(channels.map((channel) => {
+    if (!getNotificationChannel(channel)) {
+      throw new Error(`[@holo-js/notifications] Notification channel "${channel}" is not registered.`);
+    }
+    return channel;
+  }));
+}
+function resolveDeclaredChannels(notification, target) {
   const channels = notification.via(target.notifiable, createNotificationContext(target.anonymous));
   if (!Array.isArray(channels)) {
     throw new Error("[@holo-js/notifications] Notification via() must return an array of channel names.");
@@ -398,13 +450,18 @@ function resolveChannels(notification, target) {
     if (typeof channel !== "string") {
       throw new Error(`[@holo-js/notifications] Notification channel at index ${index} must be a string.`);
     }
-    const normalized = normalizeOptionalString(channel, "Notification channel");
-    if (!getNotificationChannel(normalized)) {
-      throw new Error(`[@holo-js/notifications] Notification channel "${normalized}" is not registered.`);
-    }
-    return normalized;
+    return normalizeOptionalString(channel, "Notification channel");
   }));
 }
+function resolveChannels(notification, target) {
+  return resolveRegisteredChannels(resolveDeclaredChannels(notification, target));
+}
+function resolveTargetChannels(notification, targets) {
+  return Object.freeze(targets.map((target) => Object.freeze({
+    target,
+    channels: resolveDeclaredChannels(notification, target)
+  })));
+}
 function resolvePayload(notification, channel, target) {
   const factory = notification.build[channel];
   if (typeof factory !== "function") {
@@ -536,6 +593,10 @@ function createQueuedDeliveryPayload(context) {
   });
 }
 async function runQueuedNotificationDelivery(payload) {
+  if (!getNotificationChannel(payload.channel)) {
+    const state = getRuntimeState();
+    await loadNotificationPluginChannels(state.projectRoot, state.pluginNames);
+  }
   return await deliverResolvedNotificationChannel(Object.freeze({
     channel: payload.channel,
     anonymous: payload.anonymous,
@@ -578,15 +639,14 @@ async function dispatchQueuedNotificationChannel(context, plan) {
   }
   await pending.dispatch();
 }
-async function deferDispatchUntilCommit(input, targets, notification) {
-  const dbModule = await loadDbModule();
-  const active = dbModule?.connectionAsyncContext.getActive()?.connection;
-  if (!active || active.getScope().kind === "root") {
+async function deferDispatchUntilCommit(input, notification, targetChannels) {
+  const deferAfterCommit = getRuntimeBindings().deferAfterCommit;
+  if (!deferAfterCommit) {
     return null;
   }
   const channels = [];
-  for (const target of targets) {
-    for (const channel of resolveChannels(notification, target)) {
+  for (const { target, channels: resolvedChannels } of targetChannels) {
+    for (const channel of resolvedChannels) {
       const plan = resolveChannelDispatchPlan(notification, target, channel, input.options);
       channels.push(Object.freeze({
         channel,
@@ -597,20 +657,23 @@ async function deferDispatchUntilCommit(input, targets, notification) {
       }));
     }
   }
-  active.afterCommit(async () => {
+  const deferred = deferAfterCommit(async () => {
     await dispatchNotifications(input, { allowAfterCommitDeferral: false });
   });
+  if (!deferred) {
+    return null;
+  }
   return Object.freeze({
-    totalTargets: targets.length,
+    totalTargets: targetChannels.length,
     channels: Object.freeze(channels),
     deferred: true
   });
 }
-function shouldDeferDispatchAfterCommit(notification, targets, options) {
+function shouldDeferDispatchAfterCommit(notification, targetChannels, options) {
   if (options.afterCommit) {
     return true;
   }
-  return targets.some((target) => resolveChannels(notification, target).some((channel) => {
+  return targetChannels.some(({ target, channels }) => channels.some((channel) => {
     try {
       return resolveChannelDispatchPlan(notification, target, channel, options).afterCommit;
     } catch {
@@ -621,15 +684,20 @@ function shouldDeferDispatchAfterCommit(notification, targets, options) {
 async function dispatchNotifications(input, execution = {}) {
   const notification = normalizeNotificationDefinition(input.notification);
   const targets = resolveTargets(input.target);
-  if (execution.allowAfterCommitDeferral !== false && shouldDeferDispatchAfterCommit(notification, targets, input.options)) {
-    const deferredResult = await deferDispatchUntilCommit(input, targets, notification);
+  const declaredTargetChannels = resolveTargetChannels(notification, targets);
+  if (hasUnresolvedNotificationChannels(declaredTargetChannels)) {
+    const state = getRuntimeState();
+    await loadNotificationPluginChannels(state.projectRoot, state.pluginNames);
+  }
+  const targetChannels = resolveRegisteredTargetChannels(declaredTargetChannels);
+  if (execution.allowAfterCommitDeferral !== false && shouldDeferDispatchAfterCommit(notification, targetChannels, input.options)) {
+    const deferredResult = await deferDispatchUntilCommit(input, notification, targetChannels);
     if (deferredResult) {
       return deferredResult;
     }
   }
   const results = [];
-  for (const target of targets) {
-    const channels = resolveChannels(notification, target);
+  for (const { target, channels } of targetChannels) {
     for (const channel of channels) {
       try {
         const context = resolveChannelSendContext(notification, channel, target);
@@ -658,6 +726,15 @@ async function dispatchNotifications(input, execution = {}) {
     channels: Object.freeze(results)
   });
 }
+function hasUnresolvedNotificationChannels(targetChannels) {
+  return targetChannels.some(({ channels }) => channels.some((channel) => !getNotificationChannel(channel)));
+}
+function resolveRegisteredTargetChannels(targetChannels) {
+  return Object.freeze(targetChannels.map(({ target, channels }) => Object.freeze({
+    target,
+    channels: resolveRegisteredChannels(channels)
+  })));
+}
 var PendingDispatch = class {
   constructor(target, notification, options = {}) {
     this.target = target;
@@ -738,7 +815,18 @@ var AnonymousNotificationBuilder = class _AnonymousNotificationBuilder {
   }
 };
 function configureNotificationsRuntime(bindings) {
-  getRuntimeState().bindings = bindings;
+  const state = getRuntimeState();
+  if (!bindings) {
+    state.bindings = void 0;
+    state.projectRoot = void 0;
+    state.pluginNames = void 0;
+    return;
+  }
+  const { projectRoot, plugins, ...runtimeBindings } = bindings;
+  state.bindings = runtimeBindings;
+  const normalizedProjectRoot = typeof projectRoot === "string" ? projectRoot.trim() : "";
+  state.projectRoot = normalizedProjectRoot ? normalizedProjectRoot : void 0;
+  state.pluginNames = Object.freeze([...new Set((plugins ?? []).map((plugin) => plugin.trim()).filter((plugin) => plugin.length > 0))]);
 }
 function getNotificationsRuntimeBindings() {
   return getRuntimeBindings();
@@ -746,8 +834,10 @@ function getNotificationsRuntimeBindings() {
 function resetNotificationsRuntime() {
   const state = getRuntimeState();
   state.bindings = void 0;
+  state.projectRoot = void 0;
+  state.pluginNames = void 0;
   state.loadQueueModule = void 0;
-  state.loadDbModule = void 0;
+  resetNotificationPluginChannels();
 }
 function notify(notifiable, notification) {
   return new PendingDispatch({
@@ -810,7 +900,6 @@ var notificationsRuntimeInternals = {
   getNotificationChannel,
   isAnonymousTarget,
   isObject,
-  loadDbModule,
   loadQueueModule,
   normalizeBroadcastRouteFromValue,
   normalizeDatabaseRouteFromValue,
@@ -830,21 +919,12 @@ var notificationsRuntimeInternals = {
   resolveRoute,
   runQueuedNotificationDelivery,
   resolveTargets,
-  setDbModuleLoader(loader) {
-    getRuntimeState().loadDbModule = loader;
-  },
   setQueueModuleLoader(loader) {
     getRuntimeState().loadQueueModule = loader;
   }
 };
 
 // src/index.ts
-import {
-  defineNotificationsConfig as defineBaseNotificationsConfig
-} from "@holo-js/config";
-function defineNotificationsConfig(config) {
-  return defineBaseNotificationsConfig(config);
-}
 var notifications = Object.freeze({
   deleteNotifications,
   listNotifications,
@@ -865,12 +945,15 @@ export {
   getNotificationsRuntime,
   getNotificationsRuntimeBindings,
   getRegisteredNotificationChannel,
+  holoNotificationsDefaults,
   isNotificationDefinition,
   listNotifications,
   listRegisteredNotificationChannels,
+  loadNotificationPluginChannels,
   markNotificationsAsRead,
   markNotificationsAsUnread,
   normalizeNotificationDefinition,
+  normalizeNotificationsConfig,
   notificationRegistryInternals,
   notificationsInternals,
   notificationsRuntimeInternals,
@@ -879,6 +962,7 @@ export {
   notifyUsing,
   registerNotificationChannel,
   resetNotificationChannelRegistry,
+  resetNotificationPluginChannels,
   resetNotificationsRuntime,
   unreadNotifications
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/notifications",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Holo-JS Framework - notification contracts, channels, and fluent dispatch helpers",
   "type": "module",
   "license": "MIT",
@@ -10,6 +10,11 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.mjs",
+      "default": "./dist/config.mjs"
+    },
     "./contracts": {
       "types": "./dist/contracts.d.ts",
       "import": "./dist/contracts.mjs",
@@ -28,16 +33,13 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/config": "^0.2.5"
+    "@holo-js/config": "^0.3.0",
+    "@holo-js/kernel": "^0.3.0"
   },
   "peerDependencies": {
-    "@holo-js/db": "^0.2.5",
-    "@holo-js/queue": "^0.2.5"
+    "@holo-js/queue": "^0.3.0"
   },
   "peerDependenciesMeta": {
-    "@holo-js/db": {
-      "optional": true
-    },
     "@holo-js/queue": {
       "optional": true
     }