mq-bridge 0.3.9 → 0.4.0

package/README.md

@@ -153,12 +153,57 @@ that ack each batch individually (NATS JetStream, AMQP, MQTT) accept any order.
 > source position (Kafka `partition:offset`, NATS `stream_sequence`, AMQP delivery
 > tag) and makes a natural primary key; source cursor fields are also available in
 > `message.metadata` (`mqb.src.kafka_topic`/`mqb.src.kafka_offset`, `mqb.src.nats_subject`/`mqb.src.nats_stream_sequence`,
-> `mqb.src.amqp_routing_key`/`mqb.src.amqp_delivery_tag`) when you opt in via the
-> `MQB_SOURCE_METADATA=1` environment variable (off by default). Keep `batchSize × per-record cost` under
+> `mqb.src.amqp_routing_key`/`mqb.src.amqp_delivery_tag`) when its Kafka, NATS, or
+> AMQP source config sets `source_metadata: true` (off by default). Keep `batchSize × per-record cost` under
 > the smallest broker ack deadline (JetStream `AckWait`, AMQP prefetch/timeout, MQTT
 > inflight) or raise it in config. **Kafka has no per-message nack:** `nack` there
 > leaves the offset unadvanced, so redelivery happens on the next run/rebalance.
 
+## Custom endpoints and middleware
+
+Register a JS object as an endpoint, and use its name in any route config —
+useful when a system has a good Node SDK but no Rust one.
+
+```js
+const mqb = require("mq-bridge");
+
+mqb.registerEndpoint("pulsar", (routeName, config) => ({
+  async receiveBatch(maxMessages) {
+    // [] = nothing right now; throw mqb.EndOfStream when the source is done
+    return await pullFrom(config.url, config.topic, maxMessages);
+  },
+  async commit(dispositions) {},   // optional: one "ack"/"nack" per message
+  async close() {},
+}));
+
+const route = mqb.Route.fromConfig({
+  input: { pulsar: { url: "pulsar://localhost:6650", topic: "orders" } },
+  output: { file: { path: "orders.jsonl" } },
+}, "ingest");
+route.start();
+```
+
+Implement `sendBatch(messages)` instead of `receiveBatch` for an output. A
+middleware works the same way via `registerMiddleware`, with `onReceive` /
+`onSend` hooks that return one slot per input message (`null` drops it).
+
+Because the endpoint runs in JavaScript, **keep the event loop free** while the
+route is running — `route.join()` straight after `stop()` blocks the very
+dispatch the endpoint needs. Yield first:
+
+```js
+route.stop();
+await new Promise((r) => setTimeout(r, 50));
+route.join();
+```
+
+A registered endpoint also keeps the process alive. Once the routes using it
+have stopped, `unregisterEndpoint(name)` (or `unregisterMiddleware(name)`)
+releases it so the process can exit on its own — unlike `process.exit()`, which
+skips pending flushes and `close()` hooks.
+
+**Full guide, including the Rust path:** [EXTENDING.md](../../docs/EXTENDING.md).
+
 ## Logging
 
 By default the Rust core's internal `tracing` events go nowhere. Call

package/index.d.ts

@@ -151,4 +151,109 @@ export function initLogging(
   level?: string | null,
 ): void;
 
+/** Throw from {@link CustomEndpoint.receiveBatch} to end the route cleanly. */
+export class EndOfStream extends Error {
+  constructor(message?: string);
+}
+
+/** One message disposition reported to {@link CustomEndpoint.commit}. */
+export type Disposition = "ack" | "nack";
+
+/** What a {@link registerEndpoint} factory returns. */
+export interface CustomEndpoint {
+  /**
+   * Read up to `maxMessages`. Return `null` or `[]` when nothing is available
+   * right now (the route backs off and retries; under `exit_on_empty` this is
+   * the drain signal), or throw {@link EndOfStream} when the source is done.
+   */
+  receiveBatch?(
+    maxMessages: number,
+  ):
+    | Promise<Iterable<Message | Buffer | Uint8Array | string | JsonValue> | null>
+    | Iterable<Message | Buffer | Uint8Array | string | JsonValue>
+    | null;
+  /** Called once per received batch, with one disposition per message. */
+  commit?(dispositions: Disposition[]): Promise<void> | void;
+  /** Publish a batch. Throw to fail it; set `err.retryable` to have it retried. */
+  sendBatch?(messages: Message[]): Promise<void> | void;
+  /** Called when the route releases the endpoint. */
+  close?(): Promise<void> | void;
+}
+
+/**
+ * Register a custom endpoint implemented in JavaScript under `name`, making it
+ * usable as an endpoint type in route configs — either as `{ pulsar: {...} }`
+ * or explicitly as `{ custom: { name: "pulsar", config: {...} } }`.
+ *
+ * `factory` is called once per route leg. The returned object must implement
+ * `receiveBatch` to be usable as an input and/or `sendBatch` to be usable as an
+ * output. Register before starting a route that names it; registering the same
+ * name twice throws and preserves the first factory.
+ */
+export function registerEndpoint(
+  name: string,
+  factory: (
+    routeName: string,
+    config: Record<string, JsonValue>,
+  ) => CustomEndpoint | Promise<CustomEndpoint>,
+): void;
+
+/** Unregister a custom endpoint after all routes using it have stopped. */
+export function unregisterEndpoint(name: string): boolean;
+
+/**
+ * Load a native endpoint plugin and register the endpoint it provides.
+ *
+ * `path` is the compiled plugin library shipped by an endpoint package (for
+ * example `mq-bridge-pulsar`), which normally exposes its own `register()`
+ * helper that resolves the bundled file and calls this. Returns the registered
+ * endpoint name, usable as a route's endpoint type.
+ *
+ * Call once, before starting routes; loading the same file again is a no-op. A
+ * plugin is native code with the same privileges as the Node process.
+ */
+export function loadEndpointPlugin(path: string): string;
+
+/** Resolves the native library in an mq-bridge plugin package directory. */
+export function pluginLibraryPath(packageDirectory: string): string;
+
+/** Resolves and loads the native library in an mq-bridge plugin package. */
+export function loadPluginPackage(packageDirectory: string): string;
+
+/** Standard exports for a thin JavaScript plugin package entry point. */
+export function definePluginPackage(packageDirectory: string): {
+  ENDPOINT_NAME: string;
+  libraryPath(): string;
+  register(): string;
+};
+
+/** What a {@link registerMiddleware} factory returns. */
+export interface CustomMiddleware {
+  /** Applies on an input endpoint, after the source produced the batch. */
+  onReceive?(messages: Message[]): Promise<(Message | null)[]> | (Message | null)[];
+  /** Applies on an output endpoint, before the sink receives the batch. */
+  onSend?(messages: Message[]): Promise<(Message | null)[]> | (Message | null)[];
+}
+
+/**
+ * Register a custom middleware implemented in JavaScript under `name`, usable in
+ * any endpoint's `middlewares` list as `{ custom: { name, config: {...} } }`.
+ *
+ * `factory` is called once per endpoint the middleware is attached to. A side
+ * the returned object does not implement passes through untouched. Both hooks
+ * must return one item per input message — a `Message` to keep it (possibly
+ * rewritten) or `null` to drop it — which is what keeps acknowledgements aligned
+ * with the source batch.
+ */
+export function registerMiddleware(
+  name: string,
+  factory: (
+    routeName: string,
+    config: Record<string, JsonValue>,
+  ) => CustomMiddleware | Promise<CustomMiddleware>,
+): void;
+
+/** Unregister custom middleware after all routes using it have stopped. */
+export function unregisterMiddleware(name: string): boolean;
+
 export const version: string;

package/index.js

@@ -1,5 +1,7 @@
 "use strict";
 
+const fs = require("node:fs");
+const path = require("node:path");
 const native = require("./native.js");
 
 class Message {
@@ -216,6 +218,185 @@ class Route {
   }
 }
 
+/** Throw this from `receiveBatch` to tell the route the source is finished. */
+class EndOfStream extends Error {
+  constructor(message = "end of stream") {
+    super(message);
+    this.name = "EndOfStream";
+  }
+}
+
+/**
+ * Register a custom endpoint implemented in JavaScript under `name`, making it
+ * usable as an endpoint type in route configs — either as `{ pulsar: {...} }`
+ * or explicitly as `{ custom: { name: "pulsar", config: {...} } }`.
+ *
+ * `factory(routeName, config)` is called once per route leg and returns an
+ * object implementing `receiveBatch(maxMessages)` to be usable as an input
+ * and/or `sendBatch(messages)` to be usable as an output, plus optional
+ * `commit(dispositions)` and `close()`. All of them may be async.
+ *
+ * `receiveBatch` returns an array of `Message`/Buffer/string values, or
+ * `null`/`[]` when nothing is available right now; throw `EndOfStream` to end
+ * the route. `commit` receives one `"ack"`/`"nack"` per message in the batch.
+ * Set `err.retryable = true` on a thrown error to have it retried.
+ */
+function registerEndpoint(name, factory) {
+  if (typeof factory !== "function") {
+    throw new TypeError("factory must be callable as factory(routeName, config)");
+  }
+  // The instance table lives here because JS objects cannot cross to Rust;
+  // native code refers to each instance by the id it allocated.
+  const instances = new Map();
+
+  native.registerEndpointDispatch(name, async (error, call) => {
+    if (error) {
+      throw error;
+    }
+    try {
+      return await dispatchEndpointCall(instances, factory, call);
+    } catch (err) {
+      if (err instanceof EndOfStream) {
+        return { endOfStream: true };
+      }
+      return errorReply(err);
+    }
+  });
+}
+
+/** Unregister a custom endpoint after all routes using it have stopped. */
+function unregisterEndpoint(name) {
+  return native.unregisterEndpointDispatch(name);
+}
+
+/**
+ * Report a thrown error back to Rust. `retryable` stays `undefined` unless the
+ * host set it explicitly — collapsing it to `false` would classify every
+ * ordinary error as permanent and stop the route instead of reconnecting.
+ */
+function errorReply(err) {
+  return {
+    error: String((err && err.stack) || err),
+    retryable: typeof err?.retryable === "boolean" ? err.retryable : undefined,
+  };
+}
+
+/**
+ * Register a custom middleware implemented in JavaScript under `name`, usable in
+ * any endpoint's `middlewares` list as
+ * `{ custom: { name, config: {...} } }`.
+ *
+ * `factory(routeName, config)` is called once per endpoint the middleware is
+ * attached to and returns an object implementing `onReceive(messages)` (applies
+ * on an input endpoint) and/or `onSend(messages)` (applies on an output
+ * endpoint). A side the object does not implement passes through untouched.
+ *
+ * Both hooks take the batch and must return one item per input message: a
+ * `Message` (kept, possibly rewritten) or `null` to drop it. Keeping the length
+ * fixed is what lets acknowledgements stay aligned with the source batch.
+ */
+function registerMiddleware(name, factory) {
+  if (typeof factory !== "function") {
+    throw new TypeError("factory must be callable as factory(routeName, config)");
+  }
+  const instances = new Map();
+
+  native.registerMiddlewareDispatch(name, async (error, call) => {
+    if (error) {
+      throw error;
+    }
+    try {
+      return await dispatchEndpointCall(instances, factory, call);
+    } catch (err) {
+      return errorReply(err);
+    }
+  });
+}
+
+/** Unregister a custom middleware after all routes using it have stopped. */
+function unregisterMiddleware(name) {
+  return native.unregisterMiddlewareDispatch(name);
+}
+
+async function dispatchEndpointCall(instances, factory, call) {
+  if (call.op === "create") {
+    const instance = await factory(call.routeName, call.config ?? {});
+    instances.set(call.instance, instance);
+    return {
+      consumer: typeof instance?.receiveBatch === "function",
+      publisher: typeof instance?.sendBatch === "function",
+      onReceive: typeof instance?.onReceive === "function",
+      onSend: typeof instance?.onSend === "function",
+    };
+  }
+
+  const instance = instances.get(call.instance);
+  if (!instance) {
+    // `close` is also sent when the native side drops the endpoint, which can
+    // race a close that already happened; that is not an error.
+    if (call.op === "close") {
+      return {};
+    }
+    throw new Error(`unknown endpoint instance ${call.instance}`);
+  }
+
+  switch (call.op) {
+    case "receive": {
+      const batch = await instance.receiveBatch(call.maxMessages);
+      if (batch == null) {
+        return { messages: [] };
+      }
+      return { messages: Array.from(batch, toNativeEndpointMessage) };
+    }
+    case "commit": {
+      if (typeof instance.commit === "function") {
+        await instance.commit(call.dispositions ?? []);
+      }
+      return {};
+    }
+    case "send": {
+      const messages = (call.messages ?? []).map(Message._fromNative);
+      await instance.sendBatch(messages);
+      return {};
+    }
+    case "onReceive":
+    case "onSend": {
+      const hook = call.op === "onReceive" ? instance.onReceive : instance.onSend;
+      const messages = (call.messages ?? []).map(Message._fromNative);
+      const result = await hook.call(instance, messages);
+      return {
+        filtered: Array.from(result ?? [], (item) =>
+          item == null ? null : toNativeEndpointMessage(item),
+        ),
+      };
+    }
+    case "close": {
+      instances.delete(call.instance);
+      if (typeof instance.close === "function") {
+        await instance.close();
+      }
+      return {};
+    }
+    default:
+      throw new Error(`unknown endpoint op '${call.op}'`);
+  }
+}
+
+/** Accepts what an endpoint may yield: a Message, a Buffer, or a string. */
+function toNativeEndpointMessage(item) {
+  if (item instanceof Message) {
+    return item._native;
+  }
+  if (typeof item === "string") {
+    return native.createMessage(Buffer.from(item), null, null);
+  }
+  if (Buffer.isBuffer(item) || item instanceof Uint8Array) {
+    return native.createMessage(Buffer.from(item), null, null);
+  }
+  // Anything else: treat as JSON, matching the Python binding.
+  return native.messageFromJson(item, null, null);
+}
+
 function configSchema() {
   if (typeof native.configSchema !== "function") {
     throw new Error(
@@ -229,12 +410,78 @@ function initLogging(callback, level = null) {
   return native.initLogging(callback, level);
 }
 
+function loadEndpointPlugin(pluginPath) {
+  return native.loadEndpointPlugin(pluginPath);
+}
+
+function pluginPlatformTag(platform = process.platform, arch = process.arch) {
+  const normalizedArch = arch === "x86_64" ? "x64" : arch === "aarch64" ? "arm64" : arch;
+  const suffix = platform === "linux" ? "-gnu" : platform === "win32" ? "-msvc" : "";
+  return `${platform}-${normalizedArch}${suffix}`;
+}
+
+function readPluginManifest(packageDirectory) {
+  const root = path.resolve(packageDirectory);
+  const manifestPath = path.join(root, "mq-bridge-plugin.json");
+  if (!fs.existsSync(manifestPath)) {
+    throw new Error(`mq-bridge plugin manifest not found: ${manifestPath}`);
+  }
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+  if (typeof manifest.name !== "string" || typeof manifest.library !== "string") {
+    throw new Error(`${manifestPath} must contain string fields 'name' and 'library'`);
+  }
+  return { root, manifest };
+}
+
+function pluginLibraryPath(packageDirectory) {
+  const { root, manifest } = readPluginManifest(packageDirectory);
+  const fileName = process.platform === "win32"
+    ? `${manifest.library}.dll`
+    : process.platform === "darwin"
+      ? `lib${manifest.library}.dylib`
+      : `lib${manifest.library}.so`;
+  const candidates = [
+    path.join(root, "prebuilds", pluginPlatformTag(), fileName),
+    path.join(root, fileName),
+  ];
+  const library = candidates.find((candidate) => fs.existsSync(candidate));
+  if (library) {
+    return library;
+  }
+  throw new Error(
+    `no native library for ${pluginPlatformTag()} in mq-bridge plugin package ${root}; ` +
+      `looked in ${candidates.join(", ")}`,
+  );
+}
+
+function loadPluginPackage(packageDirectory) {
+  return loadEndpointPlugin(pluginLibraryPath(packageDirectory));
+}
+
+function definePluginPackage(packageDirectory) {
+  const { manifest } = readPluginManifest(packageDirectory);
+  return {
+    ENDPOINT_NAME: manifest.name,
+    libraryPath: () => pluginLibraryPath(packageDirectory),
+    register: () => loadPluginPackage(packageDirectory),
+  };
+}
+
 module.exports = {
   Message,
   Publisher,
   Consumer,
   Route,
+  EndOfStream,
   configSchema,
   initLogging,
+  definePluginPackage,
+  loadEndpointPlugin,
+  loadPluginPackage,
+  pluginLibraryPath,
+  registerEndpoint,
+  registerMiddleware,
+  unregisterEndpoint,
+  unregisterMiddleware,
   version: native.VERSION,
 };

package/native.d.ts

@@ -171,6 +171,54 @@ export declare function configSchema(): JsonValue
 
 export declare function createMessage(payload: Buffer, metadata?: Record<string, string> | undefined | null, id?: string | undefined | null): NativeMessage
 
+/**
+ * One operation on a JS endpoint instance. A single dispatch callback per
+ * registered name carries all of them: JS objects are not `Send`, so the
+ * instance table lives on the JS side and Rust refers to instances by id.
+ */
+export interface EndpointCall {
+  /** `create` | `receive` | `commit` | `send` | `close`. */
+  op: string
+  /** Identifies the endpoint instance the op applies to. */
+  instance: number
+  routeName: string
+  /** The endpoint's config block. `create` only. */
+  config?: JsonValue
+  /** `receive` only. */
+  maxMessages?: number
+  /** `send` only. */
+  messages?: Array<NativeMessage>
+  /** `commit` only: one `"ack"`/`"nack"` per message in the batch. */
+  dispositions?: Array<string>
+}
+
+/**
+ * What the JS dispatcher reports back. Failures come back as a populated
+ * `error` rather than a rejected promise, so the retryable flag survives.
+ */
+export interface EndpointReply {
+  /** `receive` only. Absent or empty means "nothing right now". */
+  messages?: Array<NativeMessage>
+  /** `receive` only: the source is finished, so the route can stop. */
+  endOfStream?: boolean
+  /** `create` only: whether the instance implements `receiveBatch`. */
+  consumer?: boolean
+  /** `create` only: whether the instance implements `sendBatch`. */
+  publisher?: boolean
+  /** `create` only: whether the instance implements `onReceive`. */
+  onReceive?: boolean
+  /** `create` only: whether the instance implements `onSend`. */
+  onSend?: boolean
+  /** `onReceive`/`onSend` only: one slot per input message, `null` for dropped. */
+  filtered?: Array<NativeMessage | undefined | null>
+  error?: string
+  /**
+   * Whether `error` should be retried. When absent, consumer errors are retried
+   * as connection failures while publisher errors are non-retryable.
+   */
+  retryable?: boolean
+}
+
 /**
  * Route the library's internal `tracing` events into a JS callback so the host
  * logger (console, pino, winston, …) owns output. Call once at startup. `level`
@@ -181,6 +229,19 @@ export declare function createMessage(payload: Buffer, metadata?: Record<string,
  */
 export declare function initLogging(callback: (record: LogRecord) => void, level?: string | undefined | null): void
 
+/**
+ * Load a native endpoint plugin and register the endpoint it provides.
+ *
+ * `path` is the compiled plugin library shipped by an endpoint package (for
+ * example `mq-bridge-pulsar`); those packages expose a `register()` helper that
+ * resolves the bundled file and calls this. Returns the registered endpoint
+ * name, usable as a route's endpoint type.
+ *
+ * Call once, before starting routes. Loading the same file again is a no-op.
+ * A plugin is native code with the same privileges as the Node process.
+ */
+export declare function loadEndpointPlugin(path: string): string
+
 /** One library log event, delivered to the `initLogging` callback. */
 export interface LogRecord {
   /** `error` / `warn` / `info` / `debug` / `trace`. */
@@ -209,4 +270,22 @@ export interface PollBatch {
   token?: number
 }
 
+/**
+ * Register a JS endpoint dispatcher under `name`. Called by the `registerEndpoint`
+ * wrapper in `index.js`, which owns the instance table — do not call directly.
+ */
+export declare function registerEndpointDispatch(name: string, dispatch: ((err: Error | null, arg: EndpointCall) => Promise<EndpointReply>)): void
+
+/**
+ * Register a JS middleware dispatcher under `name`. Called by the
+ * `registerMiddleware` wrapper in `index.js` — do not call directly.
+ */
+export declare function registerMiddlewareDispatch(name: string, dispatch: ((err: Error | null, arg: EndpointCall) => Promise<EndpointReply>)): void
+
+/** Unregister a JS endpoint dispatcher after all routes using it have stopped. */
+export declare function unregisterEndpointDispatch(name: string): boolean
+
+/** Unregister a JS middleware dispatcher after all routes using it have stopped. */
+export declare function unregisterMiddlewareDispatch(name: string): boolean
+
 export const version: string

package/native.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-android-arm64')
         const bindingPackageVersion = require('mq-bridge-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-android-arm-eabi')
         const bindingPackageVersion = require('mq-bridge-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-win32-x64-gnu')
         const bindingPackageVersion = require('mq-bridge-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-win32-x64-msvc')
         const bindingPackageVersion = require('mq-bridge-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-win32-ia32-msvc')
         const bindingPackageVersion = require('mq-bridge-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-win32-arm64-msvc')
         const bindingPackageVersion = require('mq-bridge-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('mq-bridge-darwin-universal')
       const bindingPackageVersion = require('mq-bridge-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-darwin-x64')
         const bindingPackageVersion = require('mq-bridge-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-darwin-arm64')
         const bindingPackageVersion = require('mq-bridge-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-freebsd-x64')
         const bindingPackageVersion = require('mq-bridge-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-freebsd-arm64')
         const bindingPackageVersion = require('mq-bridge-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-x64-musl')
           const bindingPackageVersion = require('mq-bridge-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-x64-gnu')
           const bindingPackageVersion = require('mq-bridge-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-arm64-musl')
           const bindingPackageVersion = require('mq-bridge-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-arm64-gnu')
           const bindingPackageVersion = require('mq-bridge-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-arm-musleabihf')
           const bindingPackageVersion = require('mq-bridge-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-arm-gnueabihf')
           const bindingPackageVersion = require('mq-bridge-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-loong64-musl')
           const bindingPackageVersion = require('mq-bridge-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-loong64-gnu')
           const bindingPackageVersion = require('mq-bridge-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-riscv64-musl')
           const bindingPackageVersion = require('mq-bridge-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('mq-bridge-linux-riscv64-gnu')
           const bindingPackageVersion = require('mq-bridge-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-linux-ppc64-gnu')
         const bindingPackageVersion = require('mq-bridge-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-linux-s390x-gnu')
         const bindingPackageVersion = require('mq-bridge-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-openharmony-arm64')
         const bindingPackageVersion = require('mq-bridge-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-openharmony-x64')
         const bindingPackageVersion = require('mq-bridge-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('mq-bridge-openharmony-arm')
         const bindingPackageVersion = require('mq-bridge-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.3.9' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.3.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.4.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.4.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -593,8 +593,13 @@ module.exports.Route = nativeBinding.Route
 module.exports.configSchema = nativeBinding.configSchema
 module.exports.createMessage = nativeBinding.createMessage
 module.exports.initLogging = nativeBinding.initLogging
+module.exports.loadEndpointPlugin = nativeBinding.loadEndpointPlugin
 module.exports.messageFromJson = nativeBinding.messageFromJson
 module.exports.messageJson = nativeBinding.messageJson
 module.exports.messageText = nativeBinding.messageText
+module.exports.registerEndpointDispatch = nativeBinding.registerEndpointDispatch
+module.exports.registerMiddlewareDispatch = nativeBinding.registerMiddlewareDispatch
+module.exports.unregisterEndpointDispatch = nativeBinding.unregisterEndpointDispatch
+module.exports.unregisterMiddlewareDispatch = nativeBinding.unregisterMiddlewareDispatch
 module.exports.version = nativeBinding.version
 module.exports.VERSION = nativeBinding.VERSION

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mq-bridge",
-  "version": "0.3.9",
+  "version": "0.4.0",
   "description": "Node.js bindings for mq-bridge",
   "license": "MIT",
   "repository": {
@@ -10,11 +10,15 @@
   },
   "main": "index.js",
   "types": "index.d.ts",
+  "bin": {
+    "mq-bridge-package-plugin": "plugin-packaging.mjs"
+  },
   "files": [
     "index.js",
     "index.d.ts",
     "native.js",
-    "native.d.ts"
+    "native.d.ts",
+    "plugin-packaging.mjs"
   ],
   "napi": {
     "binaryName": "mq_bridge_node",
@@ -39,11 +43,11 @@
     "artifacts": "napi artifacts"
   },
   "optionalDependencies": {
-    "mq-bridge-darwin-x64": "0.3.9",
-    "mq-bridge-darwin-arm64": "0.3.9",
-    "mq-bridge-linux-x64-gnu": "0.3.9",
-    "mq-bridge-linux-arm64-gnu": "0.3.9",
-    "mq-bridge-win32-x64-msvc": "0.3.9"
+    "mq-bridge-darwin-x64": "0.4.0",
+    "mq-bridge-darwin-arm64": "0.4.0",
+    "mq-bridge-linux-x64-gnu": "0.4.0",
+    "mq-bridge-linux-arm64-gnu": "0.4.0",
+    "mq-bridge-win32-x64-msvc": "0.4.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.0.0"

package/plugin-packaging.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+
+function option(name, fallback) {
+  const index = process.argv.indexOf(name);
+  return index === -1 ? fallback : process.argv[index + 1];
+}
+
+const root = path.resolve(option("--root", process.cwd()));
+const packageDirectory = path.resolve(root, option("--package", "node"));
+const manifestPath = path.join(packageDirectory, "mq-bridge-plugin.json");
+const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+if (typeof manifest.library !== "string") {
+  throw new Error(`${manifestPath} must contain a string field 'library'`);
+}
+
+const suffix = process.platform === "linux" ? "-gnu" : process.platform === "win32" ? "-msvc" : "";
+const target = `${process.platform}-${process.arch}${suffix}`;
+const fileName = process.platform === "win32"
+  ? `${manifest.library}.dll`
+  : process.platform === "darwin"
+    ? `lib${manifest.library}.dylib`
+    : `lib${manifest.library}.so`;
+
+execFileSync("cargo", ["build", "--release"], { cwd: root, stdio: "inherit" });
+const library = path.join(root, "target", "release", fileName);
+if (!fs.existsSync(library)) {
+  throw new Error(`cargo produced no plugin library at ${library}`);
+}
+
+const targetDirectory = path.join(packageDirectory, "prebuilds", target);
+fs.mkdirSync(targetDirectory, { recursive: true });
+fs.copyFileSync(library, path.join(targetDirectory, fileName));
+console.log(`staged ${fileName} for ${target}`);
+
+if (process.argv.includes("--pack")) {
+  const output = path.resolve(root, option("--out", "npm"));
+  fs.mkdirSync(output, { recursive: true });
+  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+  execFileSync(npm, ["pack", packageDirectory, "--pack-destination", output], {
+    stdio: "inherit",
+  });
+}