@objectstack/plugin-audit 7.2.1 → 7.4.0

package/dist/index.d.mts

@@ -18,11 +18,43 @@ declare class AuditPlugin implements Plugin {
     start(ctx: PluginContext): Promise<void>;
 }
 
+/**
+ * Minimal structural view of `NotificationService.emit` (ADR-0030). Declared
+ * locally so plugin-audit takes no runtime dependency on service-messaging — it
+ * resolves whatever object is registered under the `messaging` service at hook
+ * time and routes collaboration notifications through the single ingress.
+ */
+interface MessagingEmitSurface {
+    emit(input: {
+        topic: string;
+        audience: string[];
+        payload?: Record<string, unknown>;
+        severity?: 'info' | 'warning' | 'critical';
+        dedupKey?: string;
+        source?: {
+            object: string;
+            id: string;
+        };
+        actorId?: string;
+        organizationId?: string;
+    }): Promise<unknown>;
+}
+/** Options for {@link installAuditWriters}. */
+interface AuditWriterOptions {
+    /**
+     * Lazily resolve the messaging service so collaboration `@mention` /
+     * assignment notifications go through the ADR-0030 single ingress rather than
+     * writing `sys_notification` directly. Returns `undefined` when messaging is
+     * not installed — those notifications are then skipped (no pipeline, no bell),
+     * matching the `notify` node's degradation.
+     */
+    getMessaging?(): MessagingEmitSurface | undefined;
+}
 /**
  * Install audit + activity writers on the given engine. Idempotent per
  * `packageId` — calling twice with the same id replaces the previous
  * registration.
  */
-declare function installAuditWriters(engine: any, packageId?: string): void;
+declare function installAuditWriters(engine: any, packageId?: string, opts?: AuditWriterOptions): void;
 
 export { AuditPlugin, installAuditWriters };

package/dist/index.d.ts

@@ -18,11 +18,43 @@ declare class AuditPlugin implements Plugin {
     start(ctx: PluginContext): Promise<void>;
 }
 
+/**
+ * Minimal structural view of `NotificationService.emit` (ADR-0030). Declared
+ * locally so plugin-audit takes no runtime dependency on service-messaging — it
+ * resolves whatever object is registered under the `messaging` service at hook
+ * time and routes collaboration notifications through the single ingress.
+ */
+interface MessagingEmitSurface {
+    emit(input: {
+        topic: string;
+        audience: string[];
+        payload?: Record<string, unknown>;
+        severity?: 'info' | 'warning' | 'critical';
+        dedupKey?: string;
+        source?: {
+            object: string;
+            id: string;
+        };
+        actorId?: string;
+        organizationId?: string;
+    }): Promise<unknown>;
+}
+/** Options for {@link installAuditWriters}. */
+interface AuditWriterOptions {
+    /**
+     * Lazily resolve the messaging service so collaboration `@mention` /
+     * assignment notifications go through the ADR-0030 single ingress rather than
+     * writing `sys_notification` directly. Returns `undefined` when messaging is
+     * not installed — those notifications are then skipped (no pipeline, no bell),
+     * matching the `notify` node's degradation.
+     */
+    getMessaging?(): MessagingEmitSurface | undefined;
+}
 /**
  * Install audit + activity writers on the given engine. Idempotent per
  * `packageId` — calling twice with the same id replaces the previous
  * registration.
  */
-declare function installAuditWriters(engine: any, packageId?: string): void;
+declare function installAuditWriters(engine: any, packageId?: string, opts?: AuditWriterOptions): void;
 
 export { AuditPlugin, installAuditWriters };