@zmeel/server 0.3.1

package/dist/services/plugin-event-bus.d.ts

@@ -0,0 +1,149 @@
+/**
+ * PluginEventBus — typed in-process event bus for the zmeel plugin system.
+ *
+ * Responsibilities:
+ * - Deliver core domain events to subscribing plugin workers (server-side).
+ * - Apply `EventFilter` server-side so filtered-out events never reach the handler.
+ * - Namespace plugin-emitted events as `plugin.<pluginId>.<eventName>`.
+ * - Guard the core namespace: plugins may not emit events with the `plugin.` prefix.
+ * - Isolate subscriptions per plugin — a plugin cannot enumerate or interfere with
+ *   another plugin's subscriptions.
+ * - Support wildcard subscriptions via prefix matching (e.g. `plugin.acme.linear.*`).
+ *
+ * The bus operates in-process. In the full out-of-process architecture the host
+ * calls `bus.emit()` after receiving events from the DB/queue layer, and the bus
+ * forwards to handlers that proxy the call to the relevant worker process via IPC.
+ * That IPC layer is separate; this module only handles routing and filtering.
+ *
+ * @see PLUGIN_SPEC.md §16 — Event System
+ * @see PLUGIN_SPEC.md §16.1 — Event Filtering
+ * @see PLUGIN_SPEC.md §16.2 — Plugin-to-Plugin Events
+ */
+import type { PluginEventType } from "@zmeel/shared";
+import type { PluginEvent, EventFilter } from "@zmeel/plugin-sdk";
+/**
+ * Creates and returns a new `PluginEventBus` instance.
+ *
+ * A single bus instance should be shared across the server process. Each
+ * plugin interacts with the bus through a scoped handle obtained via
+ * {@link PluginEventBus.forPlugin}.
+ *
+ * @example
+ * ```ts
+ * const bus = createPluginEventBus();
+ *
+ * // Give the Linear plugin a scoped handle
+ * const linearBus = bus.forPlugin("acme.linear");
+ *
+ * // Subscribe from the plugin's perspective
+ * linearBus.subscribe("issue.created", async (event) => {
+ *   // handle event
+ * });
+ *
+ * // Emit a core domain event (called by the host, not the plugin)
+ * await bus.emit({
+ *   eventId: "evt-1",
+ *   eventType: "issue.created",
+ *   occurredAt: new Date().toISOString(),
+ *   entityId: "iss-1",
+ *   entityType: "issue",
+ *   payload: { title: "Fix login bug", projectId: "proj-1" },
+ * });
+ * ```
+ */
+export declare function createPluginEventBus(): PluginEventBus;
+/**
+ * Result returned from `emit()`. Handler errors are collected and returned
+ * rather than thrown so a single misbehaving plugin cannot block delivery to
+ * other plugins.
+ */
+export interface PluginEventBusEmitResult {
+    /** Errors thrown by individual handlers, keyed by the plugin that failed. */
+    errors: Array<{
+        pluginId: string;
+        error: unknown;
+    }>;
+}
+/**
+ * The full event bus — held by the host process.
+ *
+ * Call `forPlugin(id)` to obtain a `ScopedPluginEventBus` for each plugin worker.
+ */
+export interface PluginEventBus {
+    /**
+     * Emit a typed domain event to all matching subscribers.
+     *
+     * Called by the host when a domain event occurs (e.g. from the DB layer or
+     * message queue). All registered subscriptions across all plugins are checked.
+     */
+    emit(event: PluginEvent): Promise<PluginEventBusEmitResult>;
+    /**
+     * Get a scoped handle for a specific plugin worker.
+     *
+     * The scoped handle isolates the plugin's subscriptions and enforces the
+     * plugin namespace on outbound events.
+     */
+    forPlugin(pluginId: string): ScopedPluginEventBus;
+    /**
+     * Remove all subscriptions for a plugin (called on worker shutdown/uninstall).
+     */
+    clearPlugin(pluginId: string): void;
+    /**
+     * Return the total number of active subscriptions, or the count for a
+     * specific plugin if `pluginId` is provided.
+     */
+    subscriptionCount(pluginId?: string): number;
+}
+/**
+ * A plugin-scoped view of the event bus. Handed to the plugin worker (or its
+ * host-side proxy) during initialisation.
+ *
+ * Plugins use this to:
+ * 1. Subscribe to domain events (with optional server-side filter).
+ * 2. Emit plugin-namespaced events for other plugins to consume.
+ *
+ * Note: `subscribe` overloads mirror the `PluginEventsClient.on()` interface
+ * from the SDK. `emit` intentionally returns `PluginEventBusEmitResult` rather
+ * than `void` so the host layer can inspect handler errors; the SDK-facing
+ * `PluginEventsClient.emit()` wraps this and returns `void`.
+ */
+export interface ScopedPluginEventBus {
+    /**
+     * Subscribe to a core domain event or a plugin-namespaced event.
+     *
+     * **Pattern syntax:**
+     * - Exact match: `"issue.created"` — receives only that event type.
+     * - Wildcard suffix: `"plugin.acme.linear.*"` — receives all events emitted by
+     *   the `acme.linear` plugin. The `*` is supported only as a trailing token after
+     *   a `.` separator; no other glob syntax is supported.
+     * - Top-level plugin wildcard: `"plugin.*"` — receives all plugin-emitted events
+     *   regardless of which plugin emitted them.
+     *
+     * Wildcards apply only to the `plugin.*` namespace. Core domain events must be
+     * subscribed to by exact name (e.g. `"issue.created"`, not `"issue.*"`).
+     *
+     * An optional `EventFilter` can be passed as the second argument to perform
+     * server-side pre-filtering; filtered-out events are never delivered to the handler.
+     */
+    subscribe(eventPattern: PluginEventType | `plugin.${string}`, fn: (event: PluginEvent) => Promise<void>): void;
+    subscribe(eventPattern: PluginEventType | `plugin.${string}`, filter: EventFilter, fn: (event: PluginEvent) => Promise<void>): void;
+    /**
+     * Emit a plugin-namespaced event. The bus automatically prepends
+     * `plugin.<pluginId>.` to the `name`, so passing `"sync-done"` from plugin
+     * `"acme.linear"` produces the event type `"plugin.acme.linear.sync-done"`.
+     *
+     * @param name  Bare event name (e.g. `"sync-done"`). Must be non-empty and
+     *   must not include the `plugin.` prefix — the bus adds that automatically.
+     * @param companyId  UUID of the company this event belongs to.
+     * @param payload  Arbitrary JSON-serializable data to attach to the event.
+     *
+     * @throws {Error} if `name` is empty or whitespace-only.
+     * @throws {Error} if `name` starts with `"plugin."` (namespace spoofing guard).
+     */
+    emit(name: string, companyId: string, payload: unknown): Promise<PluginEventBusEmitResult>;
+    /**
+     * Remove all subscriptions registered by this plugin.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=plugin-event-bus.d.ts.map

package/dist/services/plugin-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-event-bus.d.ts","sourceRoot":"","sources":["../../src/services/plugin-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA+FlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAyJrD;AAMD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,6EAA6E;IAC7E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAElD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CACP,YAAY,EAAE,eAAe,GAAG,UAAU,MAAM,EAAE,EAClD,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACxC,IAAI,CAAC;IACR,SAAS,CACP,YAAY,EAAE,eAAe,GAAG,UAAU,MAAM,EAAE,EAClD,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACxC,IAAI,CAAC;IAER;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE3F;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/services/plugin-event-bus.js

@@ -0,0 +1,258 @@
+/**
+ * PluginEventBus — typed in-process event bus for the zmeel plugin system.
+ *
+ * Responsibilities:
+ * - Deliver core domain events to subscribing plugin workers (server-side).
+ * - Apply `EventFilter` server-side so filtered-out events never reach the handler.
+ * - Namespace plugin-emitted events as `plugin.<pluginId>.<eventName>`.
+ * - Guard the core namespace: plugins may not emit events with the `plugin.` prefix.
+ * - Isolate subscriptions per plugin — a plugin cannot enumerate or interfere with
+ *   another plugin's subscriptions.
+ * - Support wildcard subscriptions via prefix matching (e.g. `plugin.acme.linear.*`).
+ *
+ * The bus operates in-process. In the full out-of-process architecture the host
+ * calls `bus.emit()` after receiving events from the DB/queue layer, and the bus
+ * forwards to handlers that proxy the call to the relevant worker process via IPC.
+ * That IPC layer is separate; this module only handles routing and filtering.
+ *
+ * @see PLUGIN_SPEC.md §16 — Event System
+ * @see PLUGIN_SPEC.md §16.1 — Event Filtering
+ * @see PLUGIN_SPEC.md §16.2 — Plugin-to-Plugin Events
+ */
+// ---------------------------------------------------------------------------
+// Pattern matching helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the event type matches the subscription pattern.
+ *
+ * Matching rules:
+ * - Exact match: `"issue.created"` matches `"issue.created"`.
+ * - Wildcard suffix: `"plugin.acme.*"` matches any event type that starts with
+ *   `"plugin.acme."`. The wildcard `*` is only supported as a trailing token.
+ *
+ * No full glob syntax is supported — only trailing `*` after a `.` separator.
+ */
+function matchesPattern(eventType, pattern) {
+    if (pattern === eventType)
+        return true;
+    // Trailing wildcard: "plugin.foo.*" → prefix is "plugin.foo."
+    if (pattern.endsWith(".*")) {
+        const prefix = pattern.slice(0, -1); // remove the trailing "*", keep the "."
+        return eventType.startsWith(prefix);
+    }
+    return false;
+}
+/**
+ * Returns true if the event passes all fields of the filter.
+ * A `null` or empty filter object passes all events.
+ *
+ * **Resolution strategy per field:**
+ *
+ * - `projectId` — checked against `event.entityId` when `entityType === "project"`,
+ *   otherwise against `payload.projectId`. This covers both direct project events
+ *   (e.g. `project.created`) and secondary events that embed a project reference in
+ *   their payload (e.g. `issue.created` with `payload.projectId`).
+ *
+ * - `companyId` — always resolved from `payload.companyId`. Core domain events that
+ *   belong to a company embed the company ID in their payload.
+ *
+ * - `agentId` — checked against `event.entityId` when `entityType === "agent"`,
+ *   otherwise against `payload.agentId`. Covers both direct agent lifecycle events
+ *   (e.g. `agent.created`) and run-level events with `payload.agentId` (e.g.
+ *   `agent.run.started`).
+ *
+ * Multiple filter fields are ANDed — all specified fields must match.
+ */
+function passesFilter(event, filter) {
+    if (!filter)
+        return true;
+    const payload = event.payload;
+    if (filter.projectId !== undefined) {
+        const projectId = event.entityType === "project"
+            ? event.entityId
+            : (typeof payload?.projectId === "string" ? payload.projectId : undefined);
+        if (projectId !== filter.projectId)
+            return false;
+    }
+    if (filter.companyId !== undefined) {
+        if (event.companyId !== filter.companyId)
+            return false;
+    }
+    if (filter.agentId !== undefined) {
+        const agentId = event.entityType === "agent"
+            ? event.entityId
+            : (typeof payload?.agentId === "string" ? payload.agentId : undefined);
+        if (agentId !== filter.agentId)
+            return false;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Event bus factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates and returns a new `PluginEventBus` instance.
+ *
+ * A single bus instance should be shared across the server process. Each
+ * plugin interacts with the bus through a scoped handle obtained via
+ * {@link PluginEventBus.forPlugin}.
+ *
+ * @example
+ * ```ts
+ * const bus = createPluginEventBus();
+ *
+ * // Give the Linear plugin a scoped handle
+ * const linearBus = bus.forPlugin("acme.linear");
+ *
+ * // Subscribe from the plugin's perspective
+ * linearBus.subscribe("issue.created", async (event) => {
+ *   // handle event
+ * });
+ *
+ * // Emit a core domain event (called by the host, not the plugin)
+ * await bus.emit({
+ *   eventId: "evt-1",
+ *   eventType: "issue.created",
+ *   occurredAt: new Date().toISOString(),
+ *   entityId: "iss-1",
+ *   entityType: "issue",
+ *   payload: { title: "Fix login bug", projectId: "proj-1" },
+ * });
+ * ```
+ */
+export function createPluginEventBus() {
+    // Subscription registry: pluginKey → list of subscriptions
+    const registry = new Map();
+    /**
+     * Retrieve or create the subscription list for a plugin.
+     */
+    function subsFor(pluginId) {
+        let subs = registry.get(pluginId);
+        if (!subs) {
+            subs = [];
+            registry.set(pluginId, subs);
+        }
+        return subs;
+    }
+    /**
+     * Emit an event envelope to all matching subscribers across all plugins.
+     *
+     * Subscribers are called concurrently (Promise.all). Each handler's errors
+     * are caught individually and collected in the returned `errors` array so a
+     * single misbehaving plugin cannot interrupt delivery to other plugins.
+     */
+    async function emit(event) {
+        const errors = [];
+        const promises = [];
+        for (const [pluginId, subs] of registry) {
+            for (const sub of subs) {
+                if (!matchesPattern(event.eventType, sub.eventPattern))
+                    continue;
+                if (!passesFilter(event, sub.filter))
+                    continue;
+                // Use Promise.resolve().then() so that synchronous throws from handlers
+                // are also caught inside the promise chain. Calling
+                // Promise.resolve(syncThrowingFn()) does NOT catch sync throws — the
+                // throw escapes before Promise.resolve() can wrap it. Using .then()
+                // ensures the call is deferred into the microtask queue where all
+                // exceptions become rejections. Each .catch() swallows the rejection
+                // and records it — the promise always resolves, so Promise.all never rejects.
+                promises.push(Promise.resolve().then(() => sub.handler(event)).catch((error) => {
+                    errors.push({ pluginId, error });
+                }));
+            }
+        }
+        await Promise.all(promises);
+        return { errors };
+    }
+    /**
+     * Remove all subscriptions for a plugin (e.g. on worker shutdown or uninstall).
+     */
+    function clearPlugin(pluginId) {
+        registry.delete(pluginId);
+    }
+    /**
+     * Return a scoped handle for a specific plugin. The handle exposes only the
+     * plugin's own subscription list and enforces the plugin namespace on `emit`.
+     */
+    function forPlugin(pluginId) {
+        return {
+            /**
+             * Subscribe to a core domain event or a plugin-namespaced event.
+             *
+             * For wildcard subscriptions use a trailing `.*` pattern, e.g.
+             * `"plugin.acme.linear.*"`.
+             *
+             * Requires the `events.subscribe` capability (capability enforcement is
+             * done by the host layer before calling this method).
+             */
+            subscribe(eventPattern, fnOrFilter, maybeFn) {
+                let filter = null;
+                let handler;
+                if (typeof fnOrFilter === "function") {
+                    handler = fnOrFilter;
+                }
+                else {
+                    filter = fnOrFilter;
+                    if (!maybeFn)
+                        throw new Error("Handler function is required when a filter is provided");
+                    handler = maybeFn;
+                }
+                subsFor(pluginId).push({ eventPattern, filter, handler });
+            },
+            /**
+             * Emit a plugin-namespaced event. The event type is automatically
+             * prefixed with `plugin.<pluginId>.` so:
+             * - `emit("sync-done", payload)` becomes `"plugin.acme.linear.sync-done"`.
+             *
+             * Requires the `events.emit` capability (enforced by the host layer).
+             *
+             * @throws {Error} if `name` already contains the `plugin.` prefix
+             *   (prevents cross-namespace spoofing).
+             */
+            async emit(name, companyId, payload) {
+                if (!name || name.trim() === "") {
+                    throw new Error(`Plugin "${pluginId}" must provide a non-empty event name.`);
+                }
+                if (!companyId || companyId.trim() === "") {
+                    throw new Error(`Plugin "${pluginId}" must provide a companyId when emitting events.`);
+                }
+                if (name.startsWith("plugin.")) {
+                    throw new Error(`Plugin "${pluginId}" must not include the "plugin." prefix when emitting events. ` +
+                        `Emit the bare event name (e.g. "sync-done") and the bus will namespace it automatically.`);
+                }
+                const eventType = `plugin.${pluginId}.${name}`;
+                const event = {
+                    eventId: crypto.randomUUID(),
+                    eventType,
+                    companyId,
+                    occurredAt: new Date().toISOString(),
+                    actorType: "plugin",
+                    actorId: pluginId,
+                    payload,
+                };
+                return emit(event);
+            },
+            /** Remove all subscriptions registered by this plugin. */
+            clear() {
+                clearPlugin(pluginId);
+            },
+        };
+    }
+    return {
+        emit,
+        forPlugin,
+        clearPlugin,
+        /** Expose subscription count for a plugin (useful for tests and diagnostics). */
+        subscriptionCount(pluginId) {
+            if (pluginId !== undefined) {
+                return registry.get(pluginId)?.length ?? 0;
+            }
+            let total = 0;
+            for (const subs of registry.values())
+                total += subs.length;
+            return total;
+        },
+    };
+}
+//# sourceMappingURL=plugin-event-bus.js.map

package/dist/services/plugin-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-event-bus.js","sourceRoot":"","sources":["../../src/services/plugin-event-bus.ts"],"names":[],"mappings":"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"}

package/dist/services/plugin-host-service-cleanup.d.ts

@@ -0,0 +1,14 @@
+import type { PluginLifecycleManager } from "./plugin-lifecycle.js";
+type LifecycleLike = Pick<PluginLifecycleManager, "on" | "off">;
+export interface PluginWorkerRuntimeEvent {
+    type: "plugin.worker.crashed" | "plugin.worker.restarted";
+    pluginId: string;
+}
+export interface PluginHostServiceCleanupController {
+    handleWorkerEvent(event: PluginWorkerRuntimeEvent): void;
+    disposeAll(): void;
+    teardown(): void;
+}
+export declare function createPluginHostServiceCleanup(lifecycle: LifecycleLike, disposers: Map<string, () => void>): PluginHostServiceCleanupController;
+export {};
+//# sourceMappingURL=plugin-host-service-cleanup.d.ts.map

package/dist/services/plugin-host-service-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-host-service-cleanup.d.ts","sourceRoot":"","sources":["../../src/services/plugin-host-service-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,KAAK,aAAa,GAAG,IAAI,CAAC,sBAAsB,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,uBAAuB,GAAG,yBAAyB,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kCAAkC;IACjD,iBAAiB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACzD,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,GACjC,kCAAkC,CAwCpC"}

package/dist/services/plugin-host-service-cleanup.js

@@ -0,0 +1,37 @@
+export function createPluginHostServiceCleanup(lifecycle, disposers) {
+    const runDispose = (pluginId, remove = false) => {
+        const dispose = disposers.get(pluginId);
+        if (!dispose)
+            return;
+        dispose();
+        if (remove) {
+            disposers.delete(pluginId);
+        }
+    };
+    const handleWorkerStopped = ({ pluginId }) => {
+        runDispose(pluginId);
+    };
+    const handlePluginUnloaded = ({ pluginId }) => {
+        runDispose(pluginId, true);
+    };
+    lifecycle.on("plugin.worker_stopped", handleWorkerStopped);
+    lifecycle.on("plugin.unloaded", handlePluginUnloaded);
+    return {
+        handleWorkerEvent(event) {
+            if (event.type === "plugin.worker.crashed") {
+                runDispose(event.pluginId);
+            }
+        },
+        disposeAll() {
+            for (const dispose of disposers.values()) {
+                dispose();
+            }
+            disposers.clear();
+        },
+        teardown() {
+            lifecycle.off("plugin.worker_stopped", handleWorkerStopped);
+            lifecycle.off("plugin.unloaded", handlePluginUnloaded);
+        },
+    };
+}
+//# sourceMappingURL=plugin-host-service-cleanup.js.map

package/dist/services/plugin-host-service-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-host-service-cleanup.js","sourceRoot":"","sources":["../../src/services/plugin-host-service-cleanup.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,8BAA8B,CAC5C,SAAwB,EACxB,SAAkC;IAElC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,MAAM,GAAG,KAAK,EAAE,EAAE;QACtD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,EAAE,CAAC;QACV,IAAI,MAAM,EAAE,CAAC;YACX,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,mBAAmB,GAAG,CAAC,EAAE,QAAQ,EAAwB,EAAE,EAAE;QACjE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG,CAAC,EAAE,QAAQ,EAAwB,EAAE,EAAE;QAClE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;IAEF,SAAS,CAAC,EAAE,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IAEtD,OAAO;QACL,iBAAiB,CAAC,KAAK;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBAC3C,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,UAAU;YACR,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzC,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAED,QAAQ;YACN,SAAS,CAAC,GAAG,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,CAAC;YAC5D,SAAS,CAAC,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/plugin-host-services.d.ts

@@ -0,0 +1,13 @@
+import type { Db } from "@zmeel/db";
+import type { HostServices } from "@zmeel/plugin-sdk";
+import type { PluginEventBus } from "./plugin-event-bus.js";
+/**
+ * Flush all buffered log entries to the database in a single batch insert per
+ * unique db instance. Errors are swallowed with a console.error fallback so
+ * flushing never crashes the process.
+ */
+export declare function flushPluginLogBuffer(): Promise<void>;
+export declare function buildHostServices(db: Db, pluginId: string, pluginKey: string, eventBus: PluginEventBus, notifyWorker?: (method: string, params: unknown) => void): HostServices & {
+    dispose(): void;
+};
+//# sourceMappingURL=plugin-host-services.d.ts.map

package/dist/services/plugin-host-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-host-services.d.ts","sourceRoot":"","sources":["../../src/services/plugin-host-services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EACV,YAAY,EAQb,MAAM,mBAAmB,CAAC;AAiB3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAwV5D;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkC1D;AA4BD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GACvD,YAAY,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CA4rBpC"}