@zlink-systems/zlink 0.17.3

package/native/src/addon_core_api.h

@@ -0,0 +1,110 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
+#pragma once
+
+#include "addon_common_api.h"
+
+napi_value version (napi_env env, napi_callback_info info);
+napi_value errno_value (napi_env env, napi_callback_info info);
+napi_value strerror_value (napi_env env, napi_callback_info info);
+napi_value has (napi_env env, napi_callback_info info);
+napi_value proxy (napi_env env, napi_callback_info info);
+napi_value sleep (napi_env env, napi_callback_info info);
+napi_value message_from_buffer (napi_env env, napi_callback_info info);
+napi_value message_allocate (napi_env env, napi_callback_info info);
+napi_value message_frame_data (napi_env env, napi_callback_info info);
+napi_value message_frame_copy_data (napi_env env, napi_callback_info info);
+napi_value message_frame_size (napi_env env, napi_callback_info info);
+napi_value message_frame_close (napi_env env, napi_callback_info info);
+
+napi_value ctx_new (napi_env env, napi_callback_info info);
+napi_value ctx_shutdown (napi_env env, napi_callback_info info);
+napi_value ctx_term (napi_env env, napi_callback_info info);
+napi_value ctx_setopt (napi_env env, napi_callback_info info);
+napi_value ctx_getopt (napi_env env, napi_callback_info info);
+napi_value ctx_getopt_data (napi_env env, napi_callback_info info);
+napi_value ctx_recalculate_auto_hwm (napi_env env, napi_callback_info info);
+napi_value ctx_get_auto_hwm_budget_snapshot (napi_env env, napi_callback_info info);
+napi_value ctx_reset_auto_hwm_budget_metrics (napi_env env, napi_callback_info info);
+
+napi_value socket_new (napi_env env, napi_callback_info info);
+napi_value socket_close (napi_env env, napi_callback_info info);
+napi_value test_begin_held_routed_multipart (napi_env env, napi_callback_info info);
+napi_value test_end_held_routed_multipart (napi_env env, napi_callback_info info);
+napi_value test_run_send_close_stress (napi_env env, napi_callback_info info);
+napi_value socket_bind (napi_env env, napi_callback_info info);
+napi_value socket_unbind (napi_env env, napi_callback_info info);
+napi_value socket_connect (napi_env env, napi_callback_info info);
+napi_value socket_disconnect (napi_env env, napi_callback_info info);
+napi_value socket_disconnect_rid (napi_env env, napi_callback_info info);
+napi_value socket_set_tls_server (napi_env env, napi_callback_info info);
+napi_value socket_set_tls_client (napi_env env, napi_callback_info info);
+napi_value socket_publish (napi_env env, napi_callback_info info);
+napi_value socket_try_publish (napi_env env, napi_callback_info info);
+napi_value socket_recv_message (napi_env env, napi_callback_info info);
+napi_value socket_try_recv_message (napi_env env, napi_callback_info info);
+napi_value socket_subscribe_message (napi_env env, napi_callback_info info);
+napi_value socket_try_subscribe_message (napi_env env, napi_callback_info info);
+napi_value socket_subscription_event (napi_env env, napi_callback_info info);
+napi_value socket_try_subscription_event (napi_env env, napi_callback_info info);
+napi_value subscription_at (napi_env env, napi_callback_info info);
+napi_value socket_stream_recv_packet (napi_env env, napi_callback_info info);
+napi_value socket_setopt (napi_env env, napi_callback_info info);
+napi_value socket_getopt (napi_env env, napi_callback_info info);
+napi_value socket_set_receive_flow_state (napi_env env, napi_callback_info info);
+napi_value socket_set_subscription (napi_env env, napi_callback_info info);
+napi_value socket_unset_subscription (napi_env env, napi_callback_info info);
+napi_value handle_set_routing_id (napi_env env, napi_callback_info info);
+napi_value handle_get_routing_id (napi_env env, napi_callback_info info);
+napi_value socket_submit_send (napi_env env, napi_callback_info info);
+napi_value socket_submit_request (napi_env env, napi_callback_info info);
+napi_value socket_request_sync (napi_env env, napi_callback_info info);
+napi_value socket_completion_recv (napi_env env, napi_callback_info info);
+napi_value test_completion_close_count (napi_env env, napi_callback_info info);
+napi_value socket_reply (napi_env env, napi_callback_info info);
+napi_value router_recv_message (napi_env env, napi_callback_info info);
+napi_value router_try_recv_message (napi_env env, napi_callback_info info);
+
+napi_value monitor_open (napi_env env, napi_callback_info info);
+napi_value monitor_recv (napi_env env, napi_callback_info info);
+napi_value monitor_try_recv (napi_env env, napi_callback_info info);
+napi_value monitor_status (napi_env env, napi_callback_info info);
+napi_value monitor_close (napi_env env, napi_callback_info info);
+
+napi_value poller_new (napi_env env, napi_callback_info info);
+napi_value poller_destroy (napi_env env, napi_callback_info info);
+napi_value poller_size (napi_env env, napi_callback_info info);
+napi_value poller_add (napi_env env, napi_callback_info info);
+napi_value poller_modify (napi_env env, napi_callback_info info);
+napi_value poller_remove (napi_env env, napi_callback_info info);
+napi_value poller_add_fd (napi_env env, napi_callback_info info);
+napi_value poller_modify_fd (napi_env env, napi_callback_info info);
+napi_value poller_remove_fd (napi_env env, napi_callback_info info);
+napi_value poller_add_timer (napi_env env, napi_callback_info info);
+napi_value poller_remove_timer (napi_env env, napi_callback_info info);
+napi_value poller_wait (napi_env env, napi_callback_info info);
+napi_value poll_events_new (napi_env env, napi_callback_info info);
+napi_value poll_events_destroy (napi_env env, napi_callback_info info);
+napi_value poll_events_source_kind (napi_env env, napi_callback_info info);
+napi_value poll_events_slot (napi_env env, napi_callback_info info);
+napi_value poll_events_revents (napi_env env, napi_callback_info info);
+napi_value poll_events_fd (napi_env env, napi_callback_info info);
+napi_value poller_wait_into (napi_env env, napi_callback_info info);
+napi_value socket_readable_watch_start (napi_env env, napi_callback_info info);
+napi_value socket_readable_watch_stop (napi_env env, napi_callback_info info);
+
+napi_value timer_new (napi_env env, napi_callback_info info);
+napi_value timer_destroy (napi_env env, napi_callback_info info);
+napi_value timer_start (napi_env env, napi_callback_info info);
+napi_value timer_stop (napi_env env, napi_callback_info info);
+napi_value timer_recv (napi_env env, napi_callback_info info);
+
+napi_value stopwatch_start (napi_env env, napi_callback_info info);
+napi_value stopwatch_intermediate (napi_env env, napi_callback_info info);
+napi_value stopwatch_stop (napi_env env, napi_callback_info info);
+napi_value atomic_counter_new (napi_env env, napi_callback_info info);
+napi_value atomic_counter_set (napi_env env, napi_callback_info info);
+napi_value atomic_counter_inc (napi_env env, napi_callback_info info);
+napi_value atomic_counter_dec (napi_env env, napi_callback_info info);
+napi_value atomic_counter_value (napi_env env, napi_callback_info info);
+napi_value atomic_counter_destroy (napi_env env, napi_callback_info info);

package/native/src/addon_core_options.cc

@@ -0,0 +1,119 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
+#include "addon_core_options.h"
+
+int set_socket_option (void *sock, int32_t opt, const void *data, size_t len)
+{
+    switch (opt) {
+        case ZLINK_ROUTER_OPT_MANDATORY:
+            return zlink_set_router_option (sock, ZLINK_ROUTER_OPT_MANDATORY, data, len);
+        case ZLINK_ROUTER_OPT_PROBE:
+            return zlink_set_router_option (sock, ZLINK_ROUTER_OPT_PROBE, data, len);
+        case ZLINK_ROUTER_OPT_CONNECT_ROUTING_ID:
+            return zlink_set_router_option (sock, ZLINK_ROUTER_OPT_CONNECT_ROUTING_ID, data, len);
+        case ZLINK_ROUTER_OPT_REQUEST_TIMEOUT_MS:
+            return zlink_set_router_option (sock, ZLINK_ROUTER_OPT_REQUEST_TIMEOUT_MS, data, len);
+        case ZLINK_ROUTER_OPT_WEIGHT:
+            return zlink_set_router_option (sock, ZLINK_ROUTER_OPT_WEIGHT, data, len);
+        case ZLINK_DEALER_OPT_PROBE:
+            return zlink_set_dealer_option (sock, ZLINK_DEALER_OPT_PROBE, data, len);
+        case ZLINK_DEALER_OPT_REQUEST_TIMEOUT_MS:
+            return zlink_set_dealer_option (sock, ZLINK_DEALER_OPT_REQUEST_TIMEOUT_MS, data, len);
+        case ZLINK_DEALER_OPT_WEIGHT:
+            return zlink_set_dealer_option (sock, ZLINK_DEALER_OPT_WEIGHT, data, len);
+        case ZLINK_STREAM_OPT_NOTIFY:
+            return zlink_set_stream_option (sock, ZLINK_STREAM_OPT_NOTIFY, data, len);
+        case ZLINK_STREAM_OPT_RECV_MODE:
+            return zlink_set_stream_option (sock, ZLINK_STREAM_OPT_RECV_MODE, data, len);
+        case ZLINK_PUB_OPT_VERBOSE:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_VERBOSE, data, len);
+        case ZLINK_PUB_OPT_VERBOSER:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_VERBOSER, data, len);
+        case ZLINK_PUB_OPT_MANUAL:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_MANUAL, data, len);
+        case ZLINK_PUB_OPT_MANUAL_LAST_VALUE:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_MANUAL_LAST_VALUE, data, len);
+        case ZLINK_PUB_OPT_NODROP:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_NODROP, data, len);
+        case ZLINK_PUB_OPT_WELCOME_MSG:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_WELCOME_MSG, data, len);
+        case ZLINK_PUB_OPT_TOPICS_COUNT:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_TOPICS_COUNT, data, len);
+        case ZLINK_PUB_OPT_APPROVE_SUBSCRIBE:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_APPROVE_SUBSCRIBE, data, len);
+        case ZLINK_PUB_OPT_REJECT_SUBSCRIBE:
+            return zlink_set_pub_option (sock, ZLINK_PUB_OPT_REJECT_SUBSCRIBE, data, len);
+        case ZLINK_SUB_OPT_TOPICS_COUNT:
+            return zlink_set_sub_option (sock, ZLINK_SUB_OPT_TOPICS_COUNT, data, len);
+        default:
+            return zlink_set_option (sock, static_cast<zlink_option_t> (opt), data, len);
+    }
+}
+
+int get_socket_option (void *sock, int32_t opt, void *data, size_t *len)
+{
+    switch (opt) {
+        case ZLINK_ROUTER_OPT_MANDATORY:
+            return zlink_get_router_option (sock, ZLINK_ROUTER_OPT_MANDATORY, data, len);
+        case ZLINK_ROUTER_OPT_PROBE:
+            return zlink_get_router_option (sock, ZLINK_ROUTER_OPT_PROBE, data, len);
+        case ZLINK_ROUTER_OPT_CONNECT_ROUTING_ID:
+            return zlink_get_router_option (sock, ZLINK_ROUTER_OPT_CONNECT_ROUTING_ID, data, len);
+        case ZLINK_ROUTER_OPT_REQUEST_TIMEOUT_MS:
+            return zlink_get_router_option (sock, ZLINK_ROUTER_OPT_REQUEST_TIMEOUT_MS, data, len);
+        case ZLINK_ROUTER_OPT_WEIGHT:
+            return zlink_get_router_option (sock, ZLINK_ROUTER_OPT_WEIGHT, data, len);
+        case ZLINK_DEALER_OPT_PROBE:
+            return zlink_get_dealer_option (sock, ZLINK_DEALER_OPT_PROBE, data, len);
+        case ZLINK_DEALER_OPT_REQUEST_TIMEOUT_MS:
+            return zlink_get_dealer_option (sock, ZLINK_DEALER_OPT_REQUEST_TIMEOUT_MS, data, len);
+        case ZLINK_DEALER_OPT_WEIGHT:
+            return zlink_get_dealer_option (sock, ZLINK_DEALER_OPT_WEIGHT, data, len);
+        case ZLINK_STREAM_OPT_NOTIFY:
+            return zlink_get_stream_option (sock, ZLINK_STREAM_OPT_NOTIFY, data, len);
+        case ZLINK_STREAM_OPT_RECV_MODE:
+            return zlink_get_stream_option (sock, ZLINK_STREAM_OPT_RECV_MODE, data, len);
+        case ZLINK_PUB_OPT_VERBOSE:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_VERBOSE, data, len);
+        case ZLINK_PUB_OPT_VERBOSER:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_VERBOSER, data, len);
+        case ZLINK_PUB_OPT_MANUAL:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_MANUAL, data, len);
+        case ZLINK_PUB_OPT_MANUAL_LAST_VALUE:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_MANUAL_LAST_VALUE, data, len);
+        case ZLINK_PUB_OPT_NODROP:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_NODROP, data, len);
+        case ZLINK_PUB_OPT_WELCOME_MSG:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_WELCOME_MSG, data, len);
+        case ZLINK_PUB_OPT_TOPICS_COUNT:
+            return zlink_get_pub_option (sock, ZLINK_PUB_OPT_TOPICS_COUNT, data, len);
+        case ZLINK_SUB_OPT_TOPICS_COUNT:
+            return zlink_get_sub_option (sock, ZLINK_SUB_OPT_TOPICS_COUNT, data, len);
+        default:
+            return zlink_get_option (sock, static_cast<zlink_option_t> (opt), data, len);
+    }
+}
+
+size_t initial_getopt_buffer_len (int32_t opt)
+{
+    switch (opt) {
+        case ZLINK_ROUTER_OPT_CONNECT_ROUTING_ID:
+            return 255;
+        case ZLINK_OPT_LAST_ENDPOINT:
+        case ZLINK_OPT_TLS_CERT:
+        case ZLINK_OPT_TLS_KEY:
+        case ZLINK_OPT_TLS_CA:
+        case ZLINK_OPT_TLS_HOSTNAME:
+        case ZLINK_OPT_TLS_PASSWORD:
+        case ZLINK_OPT_BINDTODEVICE:
+        case ZLINK_OPT_ZMP_METADATA:
+            return 256;
+        case ZLINK_OPT_MAXMSGSIZE:
+            return sizeof (int64_t);
+        case ZLINK_OPT_SNDHWM:
+        case ZLINK_OPT_RCVHWM:
+            return sizeof (uint64_t);
+        default:
+            return sizeof (int);
+    }
+}

package/native/src/addon_core_options.h

@@ -0,0 +1,9 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
+#pragma once
+
+#include "addon_common_api.h"
+
+int set_socket_option (void *sock, int32_t opt, const void *data, size_t len);
+int get_socket_option (void *sock, int32_t opt, void *data, size_t *len);
+size_t initial_getopt_buffer_len (int32_t opt);

package/native/src/addon_exports.cc

@@ -0,0 +1,151 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
+#include "addon_exports.h"
+
+#include "addon_core_api.h"
+
+#define ZLINK_METHOD(js_name, native_fn)                                                           \
+    {                                                                                              \
+        js_name, 0, native_fn, 0, 0, 0, napi_default, 0                                            \
+    }
+
+static void
+define_exports (napi_env env, napi_value exports, napi_property_descriptor *descs, size_t count)
+{
+    napi_define_properties (env, exports, count, descs);
+}
+
+static void release_send_success (napi_env env, void *data, void *)
+{
+    napi_delete_reference (env, static_cast<napi_ref> (data));
+}
+
+void define_core_exports (napi_env env, napi_value exports)
+{
+    napi_property_descriptor descs[] = {
+      ZLINK_METHOD ("version", version),
+      ZLINK_METHOD ("errno", errno_value),
+      ZLINK_METHOD ("strerror", strerror_value),
+      ZLINK_METHOD ("has", has),
+      ZLINK_METHOD ("proxy", proxy),
+      ZLINK_METHOD ("sleep", sleep),
+      ZLINK_METHOD ("messageFromBuffer", message_from_buffer),
+      ZLINK_METHOD ("messageAllocate", message_allocate),
+      ZLINK_METHOD ("messageFrameData", message_frame_data),
+      ZLINK_METHOD ("messageFrameCopyData", message_frame_copy_data),
+      ZLINK_METHOD ("messageFrameSize", message_frame_size),
+      ZLINK_METHOD ("messageFrameClose", message_frame_close),
+      ZLINK_METHOD ("ctxNew", ctx_new),
+      ZLINK_METHOD ("ctxShutdown", ctx_shutdown),
+      ZLINK_METHOD ("ctxTerm", ctx_term),
+      ZLINK_METHOD ("ctxSetOpt", ctx_setopt),
+      ZLINK_METHOD ("ctxGetOpt", ctx_getopt),
+      ZLINK_METHOD ("ctxGetOptData", ctx_getopt_data),
+      ZLINK_METHOD ("ctxRecalculateAutoHwm", ctx_recalculate_auto_hwm),
+      ZLINK_METHOD ("ctxGetAutoHwmBudgetSnapshot", ctx_get_auto_hwm_budget_snapshot),
+      ZLINK_METHOD ("ctxResetAutoHwmBudgetMetrics", ctx_reset_auto_hwm_budget_metrics),
+      ZLINK_METHOD ("socketNew", socket_new),
+      ZLINK_METHOD ("socketClose", socket_close),
+      ZLINK_METHOD ("socketBind", socket_bind),
+      ZLINK_METHOD ("socketUnbind", socket_unbind),
+      ZLINK_METHOD ("socketConnect", socket_connect),
+      ZLINK_METHOD ("socketDisconnect", socket_disconnect),
+      ZLINK_METHOD ("socketDisconnectRid", socket_disconnect_rid),
+      ZLINK_METHOD ("socketSetTlsServer", socket_set_tls_server),
+      ZLINK_METHOD ("socketSetTlsClient", socket_set_tls_client),
+      ZLINK_METHOD ("socketPublish", socket_publish),
+      ZLINK_METHOD ("socketTryPublish", socket_try_publish),
+      ZLINK_METHOD ("socketRecvMessage", socket_recv_message),
+      ZLINK_METHOD ("socketRecvMessageNoWait", socket_try_recv_message),
+      ZLINK_METHOD ("socketSubscribeMessage", socket_subscribe_message),
+      ZLINK_METHOD ("socketTrySubscribeMessage", socket_try_subscribe_message),
+      ZLINK_METHOD ("socketSubscriptionEvent", socket_subscription_event),
+      ZLINK_METHOD ("socketTrySubscriptionEvent", socket_try_subscription_event),
+      ZLINK_METHOD ("subscriptionAt", subscription_at),
+      ZLINK_METHOD ("socketStreamRecvPacket", socket_stream_recv_packet),
+      ZLINK_METHOD ("socketSetOpt", socket_setopt),
+      ZLINK_METHOD ("socketGetOpt", socket_getopt),
+      ZLINK_METHOD ("socketSetReceiveFlowState", socket_set_receive_flow_state),
+      ZLINK_METHOD ("socketSetSubscription", socket_set_subscription),
+      ZLINK_METHOD ("socketUnsetSubscription", socket_unset_subscription),
+      ZLINK_METHOD ("handleSetRoutingId", handle_set_routing_id),
+      ZLINK_METHOD ("handleGetRoutingId", handle_get_routing_id),
+      ZLINK_METHOD ("socketSubmitSend", socket_submit_send),
+      ZLINK_METHOD ("socketSubmitRequest", socket_submit_request),
+      ZLINK_METHOD ("socketRequestSync", socket_request_sync),
+      ZLINK_METHOD ("socketCompletionRecv", socket_completion_recv),
+      ZLINK_METHOD ("socketReadableWatchStart", socket_readable_watch_start),
+      ZLINK_METHOD ("socketReadableWatchStop", socket_readable_watch_stop),
+      ZLINK_METHOD ("testCompletionCloseCount", test_completion_close_count),
+      ZLINK_METHOD ("socketReply", socket_reply),
+      ZLINK_METHOD ("routerRecvMessage", router_recv_message),
+      ZLINK_METHOD ("routerRecvMessageNoWait", router_try_recv_message),
+      ZLINK_METHOD ("monitorOpen", monitor_open),
+      ZLINK_METHOD ("monitorRecv", monitor_recv),
+      ZLINK_METHOD ("monitorRecvNoWait", monitor_try_recv),
+      ZLINK_METHOD ("monitorStatus", monitor_status),
+      ZLINK_METHOD ("monitorClose", monitor_close),
+      ZLINK_METHOD ("pollerNew", poller_new),
+      ZLINK_METHOD ("pollerDestroy", poller_destroy),
+      ZLINK_METHOD ("pollerSize", poller_size),
+      ZLINK_METHOD ("pollerAdd", poller_add),
+      ZLINK_METHOD ("pollerModify", poller_modify),
+      ZLINK_METHOD ("pollerRemove", poller_remove),
+      ZLINK_METHOD ("pollerAddFd", poller_add_fd),
+      ZLINK_METHOD ("pollerModifyFd", poller_modify_fd),
+      ZLINK_METHOD ("pollerRemoveFd", poller_remove_fd),
+      ZLINK_METHOD ("pollerAddTimer", poller_add_timer),
+      ZLINK_METHOD ("pollerRemoveTimer", poller_remove_timer),
+      ZLINK_METHOD ("pollerWait", poller_wait),
+      ZLINK_METHOD ("pollEventsNew", poll_events_new),
+      ZLINK_METHOD ("pollEventsDestroy", poll_events_destroy),
+      ZLINK_METHOD ("pollEventsSourceKind", poll_events_source_kind),
+      ZLINK_METHOD ("pollEventsSlot", poll_events_slot),
+      ZLINK_METHOD ("pollEventsRevents", poll_events_revents),
+      ZLINK_METHOD ("pollEventsFd", poll_events_fd),
+      ZLINK_METHOD ("pollerWaitInto", poller_wait_into),
+      ZLINK_METHOD ("timerNew", timer_new),
+      ZLINK_METHOD ("timerDestroy", timer_destroy),
+      ZLINK_METHOD ("timerStart", timer_start),
+      ZLINK_METHOD ("timerStop", timer_stop),
+      ZLINK_METHOD ("timerRecv", timer_recv),
+      ZLINK_METHOD ("stopwatchStart", stopwatch_start),
+      ZLINK_METHOD ("stopwatchIntermediate", stopwatch_intermediate),
+      ZLINK_METHOD ("stopwatchStop", stopwatch_stop),
+      ZLINK_METHOD ("atomicCounterNew", atomic_counter_new),
+      ZLINK_METHOD ("atomicCounterSet", atomic_counter_set),
+      ZLINK_METHOD ("atomicCounterInc", atomic_counter_inc),
+      ZLINK_METHOD ("atomicCounterDec", atomic_counter_dec),
+      ZLINK_METHOD ("atomicCounterValue", atomic_counter_value),
+      ZLINK_METHOD ("atomicCounterDestroy", atomic_counter_destroy),
+    };
+    // The native function owns its immutable inline-success result. Each Node
+    // environment has its own function/reference; no process-global V8 handles.
+    napi_value success;
+    napi_create_object (env, &success);
+    set_int64_property (env, success, "result", ZLINK_SUBMIT_OK);
+    set_int64_property (env, success, "nativeErrno", 0);
+    set_uint64_bigint_property (env, success, "completionId", 0);
+    napi_object_freeze (env, success);
+    napi_ref success_ref;
+    napi_create_reference (env, success, 1, &success_ref);
+    for (size_t index = 0; index < sizeof (descs) / sizeof (*descs); ++index) {
+        if (strcmp (descs[index].utf8name, "socketSubmitSend") == 0)
+            descs[index].data = success_ref;
+    }
+    define_exports (env, exports, descs, sizeof (descs) / sizeof (*descs));
+    napi_value send_function;
+    napi_get_named_property (env, exports, "socketSubmitSend", &send_function);
+    napi_add_finalizer (
+      env, send_function, success_ref, release_send_success, NULL, NULL);
+
+    if (getenv ("ZLINK_NODE_TEST_HOOKS")) {
+        napi_property_descriptor test_descs[] = {
+          ZLINK_METHOD ("testBeginHeldRoutedMultipart", test_begin_held_routed_multipart),
+          ZLINK_METHOD ("testEndHeldRoutedMultipart", test_end_held_routed_multipart),
+          ZLINK_METHOD ("testRunSendCloseStress", test_run_send_close_stress),
+        };
+        define_exports (
+          env, exports, test_descs, sizeof (test_descs) / sizeof (*test_descs));
+    }
+}

package/native/src/addon_exports.h

@@ -0,0 +1,7 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
+#pragma once
+
+#include "addon_common_api.h"
+
+void define_core_exports (napi_env env, napi_value exports);

package/native/src/addon_message_parts.h

@@ -0,0 +1,67 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+
+#pragma once
+
+#include "addon_common_api.h"
+
+inline void copy_routing_id (zlink_routing_id_t *out, const zlink_routing_id_t *in)
+{
+    if (!out)
+        return;
+    if (in)
+        memcpy (out, in, sizeof (*out));
+    else
+        memset (out, 0, sizeof (*out));
+}
+
+inline bool parse_routing_id_value (napi_env env,
+                                    napi_value value,
+                                    zlink_routing_id_t *routing_id)
+{
+    void *data = NULL;
+    size_t len = 0;
+    if (napi_get_buffer_info (env, value, &data, &len) != napi_ok) {
+        napi_throw_type_error (env, NULL, "routingId must be Buffer");
+        return false;
+    }
+    if (len == 0 || len > sizeof (routing_id->data)) {
+        napi_throw_range_error (env, NULL, "routingId length must be 1..255 bytes");
+        return false;
+    }
+    memset (routing_id, 0, sizeof (*routing_id));
+    routing_id->size = static_cast<uint8_t> (len);
+    memcpy (routing_id->data, data, len);
+    return true;
+}
+
+inline void close_recv_parts (zlink_msg_t *parts, size_t part_count)
+{
+    if (!parts)
+        return;
+    zlink_multipart_close (parts, part_count);
+}
+
+template <typename Submit>
+inline int submit_msg_parts (zlink_msg_t *parts, size_t part_count, Submit submit)
+{
+    if (!parts || part_count == 0) {
+        errno = EFAULT;
+        return ZLINK_SUBMIT_INVALID_ARGUMENT;
+    }
+
+    for (size_t i = 0; i < part_count; ++i) {
+        const bool is_final = i + 1u == part_count;
+        const zlink_part_flag_t part_flag = is_final ? ZLINK_PART_FINAL : ZLINK_PART_MORE;
+        int rc = submit (&parts[i], part_flag, is_final);
+        if (rc != ZLINK_SUBMIT_OK) {
+            // Core consumes the attempted native part even when the record is
+            // rejected. Release the empty attempted slot and every untouched
+            // later slot in this staging copy; the JavaScript Message owners
+            // remain separate and untouched.
+            zlink_multipart_close (parts, part_count);
+            return rc;
+        }
+    }
+
+    return ZLINK_SUBMIT_OK;
+}