@smthrs/platform-node 1.0.0-rc.5 → 1.0.0-rc.7

package/dist/vendor/{chunk-SIR62W3Y.js → chunk-VWSWEUN5.js}

@@ -1,24 +1,24 @@
+import {
+  layer as layer2
+} from "./chunk-NTEWGPPG.js";
+import {
+  layer
+} from "./chunk-423HXGL6.js";
 import {
   persisted,
   stream
-} from "./chunk-GXCHI7BM.js";
-import {
-  layer as layer2
-} from "./chunk-AMQKOQNT.js";
+} from "./chunk-ZVJCBTJG.js";
 import {
   NodeWS
-} from "./chunk-JJ24ARBQ.js";
+} from "./chunk-C3PGUWW5.js";
 import {
   NodeHttpIncomingMessage
-} from "./chunk-J7A4CZDO.js";
-import {
-  layer
-} from "./chunk-VANKHF46.js";
+} from "./chunk-D2ZL4PLZ.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
 
-// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.0-rc.115_effect@4.0.0-rc.115_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeHttpServer.js
+// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeHttpServer.js
 var NodeHttpServer_exports = {};
 __export(NodeHttpServer_exports, {
   layer: () => layer4,
@@ -35,23 +35,25 @@ import * as Config from "effect/Config";
 import * as Context from "effect/Context";
 import * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
 import * as Fiber from "effect/Fiber";
 import { flow } from "effect/Function";
+import * as Cookies from "effect/http/Cookies";
+import * as Etag from "effect/http/Etag";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as HttpEffect from "effect/http/HttpEffect";
+import * as HttpIncomingMessage from "effect/http/HttpIncomingMessage";
+import * as HttpServer from "effect/http/HttpServer";
+import { causeResponse, ClientAbort, HttpServerError, RequestParseError, ResponseError, ServeError } from "effect/http/HttpServerError";
+import * as Request from "effect/http/HttpServerRequest";
+import { HttpServerRequest } from "effect/http/HttpServerRequest";
+import * as Response from "effect/http/HttpServerResponse";
 import * as Latch from "effect/Latch";
 import * as Layer from "effect/Layer";
+import * as NetAddress from "effect/net/NetAddress";
 import * as Scope from "effect/Scope";
+import * as Socket from "effect/socket/Socket";
 import * as Stream from "effect/Stream";
-import * as Cookies from "effect/unstable/http/Cookies";
-import * as Etag from "effect/unstable/http/Etag";
-import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient";
-import * as HttpEffect from "effect/unstable/http/HttpEffect";
-import * as HttpIncomingMessage from "effect/unstable/http/HttpIncomingMessage";
-import * as HttpServer from "effect/unstable/http/HttpServer";
-import { causeResponse, ClientAbort, HttpServerError, RequestParseError, ResponseError, ServeError } from "effect/unstable/http/HttpServerError";
-import * as Request from "effect/unstable/http/HttpServerRequest";
-import { HttpServerRequest } from "effect/unstable/http/HttpServerRequest";
-import * as NetAddress from "effect/unstable/net/NetAddress";
-import * as Socket from "effect/unstable/socket/Socket";
 import * as Http from "node:http";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
@@ -111,11 +113,10 @@ var make2 = /* @__PURE__ */ Effect.fnUntraced(function* (evaluate, options) {
         middleware,
         scope: scope3
       });
-      yield* Scope.addFinalizerExit(serveScope, () => {
+      yield* Scope.addFinalizerExit(serveScope, () => Effect.ensuring(preemptiveShutdown, Effect.sync(() => {
         server.off("request", handler);
         server.off("upgrade", upgradeHandler);
-        return preemptiveShutdown;
-      });
+      })));
       server.on("request", handler);
       server.on("upgrade", upgradeHandler);
     })
@@ -143,12 +144,11 @@ var makeUpgradeHandler = (lazyWss, httpEffect, options) => {
   return Effect.withFiber((parent) => {
     const services = parent.context;
     return Effect.succeed(function handler(nodeRequest, socket, head) {
-      let upgraded = false;
       let nodeResponse_ = void 0;
       const nodeResponse = () => {
         if (nodeResponse_ === void 0) {
           nodeResponse_ = new Http.ServerResponse(nodeRequest);
-          if (upgraded) {
+          if (request.upgraded || socket.destroyed) {
             nodeResponse_.end();
           } else {
             nodeResponse_.assignSocket(socket);
@@ -159,11 +159,23 @@ var makeUpgradeHandler = (lazyWss, httpEffect, options) => {
         }
         return nodeResponse_;
       };
-      const upgradeEffect = Socket.fromWebSocket(Effect.flatMap(lazyWss, (wss) => Effect.acquireRelease(Effect.callback((resume) => wss.handleUpgrade(nodeRequest, socket, head, (ws) => {
-        upgraded = true;
-        resume(Effect.succeed(ws));
-      })), (ws) => Effect.sync(() => ws.close()))));
-      const context = Context.add(services, HttpServerRequest, new ServerRequestImpl(nodeRequest, nodeResponse, upgradeEffect));
+      const upgradeEffect = Socket.fromWebSocket(Effect.flatMap(lazyWss, (wss) => Effect.acquireRelease(Effect.callback((resume) => {
+        const onClose = () => resume(Effect.fail(new Socket.SocketError({
+          reason: new Socket.SocketOpenError({
+            kind: "Unknown",
+            cause: new Error("The socket closed before the upgrade")
+          })
+        })));
+        if (socket.destroyed) return onClose();
+        socket.once("close", onClose);
+        wss.handleUpgrade(nodeRequest, socket, head, (ws) => {
+          socket.off("close", onClose);
+          request.upgraded = true;
+          resume(Effect.succeed(ws));
+        });
+      }), (ws, exit) => Effect.sync(() => ws.close(closeCode(exit))))));
+      const request = new ServerRequestImpl(nodeRequest, nodeResponse, upgradeEffect);
+      const context = Context.add(services, HttpServerRequest, request);
       const fiber = Fiber.runIn(Effect.runForkWith(context)(handledApp), options.scope);
       socket.on("error", () => {
       });
@@ -179,6 +191,7 @@ var ServerRequestImpl = class _ServerRequestImpl extends NodeHttpIncomingMessage
   [Request.TypeId];
   response;
   upgradeEffect;
+  upgraded = false;
   url;
   headersOverride;
   constructor(source, response, upgradeEffect, url = source.url, headersOverride, remoteAddressOverride) {
@@ -257,7 +270,14 @@ var layerTest = /* @__PURE__ */ HttpServer.layerTestClient.pipe(/* @__PURE__ */
 })))), /* @__PURE__ */ Layer.provideMerge(/* @__PURE__ */ layer4(Http.createServer, {
   port: 0
 })));
+var closeCode = (exit) => Exit.isSuccess(exit) ? 1e3 : Cause.hasInterruptsOnly(exit.cause) ? 1001 : 1011;
+var upgradedResponse = /* @__PURE__ */ Response.empty({
+  status: 101
+});
 var handleResponse = (request, response) => {
+  if (request.upgraded) {
+    return Effect.succeed(upgradedResponse);
+  }
   const nodeResponse = request.resolvedResponse;
   if (nodeResponse.writableEnded) {
     return Effect.void;

package/dist/vendor/{chunk-MBSKBQ5D.js → chunk-WPZDL2D7.js}

@@ -2,7 +2,7 @@ import {
   __export
 } from "./chunk-MLKGABMK.js";
 
-// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.0-rc.115_effect@4.0.0-rc.115_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeHttpServerRequest.js
+// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeHttpServerRequest.js
 var NodeHttpServerRequest_exports = {};
 __export(NodeHttpServerRequest_exports, {
   toIncomingMessage: () => toIncomingMessage,

package/dist/vendor/chunk-YDY5P7GL.js

@@ -0,0 +1,20 @@
+import {
+  layer,
+  layerConfig,
+  make
+} from "./chunk-ADP5LRUF.js";
+import {
+  __export
+} from "./chunk-MLKGABMK.js";
+
+// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeDns.js
+var NodeDns_exports = {};
+__export(NodeDns_exports, {
+  layer: () => layer,
+  layerConfig: () => layerConfig,
+  make: () => make
+});
+
+export {
+  NodeDns_exports
+};

package/dist/vendor/{chunk-FNZOJHSV.js → chunk-YFD4QFIL.js}

@@ -1,23 +1,23 @@
 import {
   layerClientProtocol,
   layerSocketServer
-} from "./chunk-Y35ZAO5U.js";
-import {
-  layer
-} from "./chunk-VZBDV3TV.js";
+} from "./chunk-6FSJ2PMW.js";
 import {
   Dispatcher,
   layerUndiciNoDispatcher,
   makeDispatcher
-} from "./chunk-KOZMM5PZ.js";
+} from "./chunk-UPIQ52FQ.js";
+import {
+  layer
+} from "./chunk-PU7QVYND.js";
 import {
   layer as layer2
-} from "./chunk-M32LDTW7.js";
+} from "./chunk-VIWU4EBF.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
 
-// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.0-rc.115_effect@4.0.0-rc.115_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeClusterSocket.js
+// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeClusterSocket.js
 var NodeClusterSocket_exports = {};
 __export(NodeClusterSocket_exports, {
   layer: () => layer7,
@@ -26,19 +26,19 @@ __export(NodeClusterSocket_exports, {
   layerK8sHttpClient: () => layerK8sHttpClient,
   layerSocketServer: () => layerSocketServer
 });
+import * as K8sHttpClient from "effect/cluster/K8sHttpClient";
+import * as MessageStorage from "effect/cluster/MessageStorage";
+import * as RunnerHealth from "effect/cluster/RunnerHealth";
+import * as Runners from "effect/cluster/Runners";
+import * as RunnerStorage from "effect/cluster/RunnerStorage";
+import * as ShardingConfig from "effect/cluster/ShardingConfig";
+import * as SocketRunner from "effect/cluster/SocketRunner";
+import * as SqlMessageStorage from "effect/cluster/SqlMessageStorage";
+import * as SqlRunnerStorage from "effect/cluster/SqlRunnerStorage";
 import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
 import * as Layer from "effect/Layer";
-import * as K8sHttpClient from "effect/unstable/cluster/K8sHttpClient";
-import * as MessageStorage from "effect/unstable/cluster/MessageStorage";
-import * as RunnerHealth from "effect/unstable/cluster/RunnerHealth";
-import * as Runners from "effect/unstable/cluster/Runners";
-import * as RunnerStorage from "effect/unstable/cluster/RunnerStorage";
-import * as ShardingConfig from "effect/unstable/cluster/ShardingConfig";
-import * as SocketRunner from "effect/unstable/cluster/SocketRunner";
-import * as SqlMessageStorage from "effect/unstable/cluster/SqlMessageStorage";
-import * as SqlRunnerStorage from "effect/unstable/cluster/SqlRunnerStorage";
-import * as RpcSerialization from "effect/unstable/rpc/RpcSerialization";
+import * as RpcSerialization from "effect/rpc/RpcSerialization";
 var layer7 = (options) => {
   const layer8 = options?.clientOnly ? Layer.provide(SocketRunner.layerClientOnly, layerClientProtocol) : Layer.provide(SocketRunner.layer, [layerSocketServer, layerClientProtocol]);
   const runnerHealth = options?.clientOnly ? Layer.empty : options?.runnerHealth === "k8s" ? RunnerHealth.layerK8s(options.runnerHealthK8s).pipe(Layer.provide(layerK8sHttpClient)) : RunnerHealth.layerPing.pipe(Layer.provide(Runners.layerRpc), Layer.provide(layerClientProtocol));

package/dist/vendor/{chunk-GXCHI7BM.js → chunk-ZVJCBTJG.js}

@@ -1,15 +1,15 @@
 import {
   make
-} from "./chunk-2Y7WC4KU.js";
+} from "./chunk-QHR2RC5M.js";
 import {
   fromReadable,
   toUint8Array
-} from "./chunk-XH4U3JSV.js";
+} from "./chunk-RQH5DSBA.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
 
-// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.0-rc.115_effect@4.0.0-rc.115_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeMultipart.js
+// ../../../../node_modules/.pnpm/@effect+platform-node@4.0.4_effect@4.0.4_redis@6.2.1_@opentelemetry+api@1.9.1_/node_modules/@effect/platform-node/dist/NodeMultipart.js
 var NodeMultipart_exports = {};
 __export(NodeMultipart_exports, {
   fileToReadable: () => fileToReadable,
@@ -17,10 +17,10 @@ __export(NodeMultipart_exports, {
   stream: () => stream
 });
 import * as Effect from "effect/Effect";
+import * as Multipart from "effect/http/Multipart";
+import * as MultipartParser from "effect/http/MultipartParser";
 import * as Inspectable from "effect/Inspectable";
 import * as Stream from "effect/Stream";
-import * as Multipart from "effect/unstable/http/Multipart";
-import * as MultipartParser from "effect/unstable/http/MultipartParser";
 import * as NFS from "node:fs";
 import * as NodeStreamP from "node:stream/promises";
 var stream = (source, headers) => Multipart.makeConfig(headers).pipe(Effect.map((config) => fromReadable({

package/dist/vendor/cjs/node/NodeAddressResolver.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `NodeAddressResolver` module provides the Node.js `AddressResolver`
+ * service for Effect programs.
+ *
+ * IPv6 literals with a named zone such as `fe80::1%eth0` get their scope ID
+ * from `os.networkInterfaces()`, listed each time a named zone is resolved.
+ *
+ * @stability experimental
+ * @since 4.0.0
+ */
+/**
+ * @stability experimental
+ * @since 4.0.0
+ */
+export * from "../node-shared/NodeAddressResolver.js";
+//# sourceMappingURL=NodeAddressResolver.d.ts.map

package/dist/vendor/cjs/node/NodeAddressResolver.js

@@ -0,0 +1 @@
+module.exports = require("../../node/NodeAddressResolver.js")

package/dist/vendor/cjs/node/NodeChildProcessSpawner.d.ts

@@ -1,6 +1,7 @@
 /**
  * Node.js implementation of `ChildProcessSpawner`.
  *
+ * @stability unstable
  * @since 4.0.0
  */
 export * from "../node-shared/NodeChildProcessSpawner.js";

package/dist/vendor/cjs/node/NodeClusterHttp.d.ts

@@ -1,32 +1,21 @@
-/**
- * Node.js HTTP and WebSocket layers for Effect Cluster runners.
- *
- * The main `layer` builds a sharding layer for HTTP or WebSocket transport,
- * choosing serialization, runner health checks, runner storage, message
- * storage, and optional client-only mode from the supplied options.
- * `layerHttpServer` provides the Node HTTP server used by cluster runners, and
- * this module re-exports the Kubernetes HTTP client layer used by runner health
- * checks.
- *
- * @since 4.0.0
- */
+import * as MessageStorage from "effect/cluster/MessageStorage";
+import * as Runners from "effect/cluster/Runners";
+import * as RunnerStorage from "effect/cluster/RunnerStorage";
+import type { Sharding } from "effect/cluster/Sharding";
+import * as ShardingConfig from "effect/cluster/ShardingConfig";
 import type * as Config from "effect/Config";
+import type * as Etag from "effect/http/Etag";
+import type { HttpPlatform } from "effect/http/HttpPlatform";
+import type { HttpServer } from "effect/http/HttpServer";
+import type { ServeError } from "effect/http/HttpServerError";
 import * as Layer from "effect/Layer";
-import * as MessageStorage from "effect/unstable/cluster/MessageStorage";
-import * as Runners from "effect/unstable/cluster/Runners";
-import * as RunnerStorage from "effect/unstable/cluster/RunnerStorage";
-import type { Sharding } from "effect/unstable/cluster/Sharding";
-import * as ShardingConfig from "effect/unstable/cluster/ShardingConfig";
-import type * as Etag from "effect/unstable/http/Etag";
-import type { HttpPlatform } from "effect/unstable/http/HttpPlatform";
-import type { HttpServer } from "effect/unstable/http/HttpServer";
-import type { ServeError } from "effect/unstable/http/HttpServerError";
-import type { SqlClient } from "effect/unstable/sql/SqlClient";
+import type { SqlClient } from "effect/sql/SqlClient";
 import type { NodeServices } from "./NodeServices.ts";
 export { 
 /**
  * Provides the Kubernetes HTTP client layer used by Kubernetes runner health checks.
  *
+ * @stability unstable
  * @category re-exports
  * @since 4.0.0
  */
@@ -36,6 +25,7 @@ layerK8sHttpClient } from "./NodeClusterSocket.ts";
  * transport, RPC serialization, message storage, runner health checks, and
  * optional client-only mode.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -56,6 +46,7 @@ export declare const layer: <const ClientOnly extends boolean = false, const Sto
  * Provides the HTTP server and Node HTTP services used by cluster runners,
  * listening on `ShardingConfig.runnerListenAddress` or `runnerAddress`.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node/NodeClusterSocket.d.ts

@@ -8,25 +8,27 @@
  * Kubernetes-aware Undici dispatcher and HTTP client layers for runner health
  * checks.
  *
+ * @stability unstable
  * @since 4.0.0
  */
 import { layerClientProtocol, layerSocketServer } from "../node-shared/NodeClusterSocket.js";
+import * as K8sHttpClient from "effect/cluster/K8sHttpClient";
+import * as MessageStorage from "effect/cluster/MessageStorage";
+import * as Runners from "effect/cluster/Runners";
+import * as RunnerStorage from "effect/cluster/RunnerStorage";
+import type { Sharding } from "effect/cluster/Sharding";
+import * as ShardingConfig from "effect/cluster/ShardingConfig";
 import type { ConfigError } from "effect/Config";
 import * as Layer from "effect/Layer";
-import * as K8sHttpClient from "effect/unstable/cluster/K8sHttpClient";
-import * as MessageStorage from "effect/unstable/cluster/MessageStorage";
-import * as Runners from "effect/unstable/cluster/Runners";
-import * as RunnerStorage from "effect/unstable/cluster/RunnerStorage";
-import type { Sharding } from "effect/unstable/cluster/Sharding";
-import * as ShardingConfig from "effect/unstable/cluster/ShardingConfig";
-import type * as SocketServer from "effect/unstable/socket/SocketServer";
-import type { SqlClient } from "effect/unstable/sql/SqlClient";
+import type * as SocketServer from "effect/socket/SocketServer";
+import type { SqlClient } from "effect/sql/SqlClient";
 import * as NodeHttpClient from "./NodeHttpClient.ts";
 export { 
 /**
  * Provides the cluster `RpcClientProtocol` using the shared socket client
  * implementation.
  *
+ * @stability unstable
  * @category re-exports
  * @since 4.0.0
  */
@@ -35,6 +37,7 @@ layerClientProtocol,
  * Provides the socket server used by Node cluster runners through the shared
  * socket server implementation.
  *
+ * @stability unstable
  * @category re-exports
  * @since 4.0.0
  */
@@ -44,6 +47,7 @@ layerSocketServer };
  * serialization, message storage, runner health checks, and optional
  * client-only mode.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -64,6 +68,7 @@ export declare const layer: <const ClientOnly extends boolean = false, const Sto
  * account CA certificate when it is available and falling back to the default
  * dispatcher otherwise.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -72,6 +77,7 @@ export declare const layerDispatcherK8s: Layer.Layer<NodeHttpClient.Dispatcher>;
  * Provides a `K8sHttpClient` backed by the Undici HTTP client and the
  * Kubernetes-aware dispatcher.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node/NodeCrypto.d.ts

@@ -3,6 +3,7 @@ import type * as Layer from "effect/Layer";
 /**
  * Layer that provides the Node.js Crypto service implementation.
  *
+ * @stability unstable
  * @category layers
  * @since 1.0.0
  */

package/dist/vendor/cjs/node/NodeDatagramSocket.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @stability experimental
+ * @since 4.0.0
+ */
+/**
+ * @stability experimental
+ * @since 4.0.0
+ */
+export * from "../node-shared/NodeDatagramSocket.js";
+//# sourceMappingURL=NodeDatagramSocket.d.ts.map

package/dist/vendor/cjs/node/NodeDatagramSocket.js

@@ -0,0 +1 @@
+module.exports = require("../../node/NodeDatagramSocket.js")

package/dist/vendor/cjs/node/NodeDns.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The `NodeDns` module provides the Node.js `Dns` service for Effect programs.
+ *
+ * Address lookups use the operating system resolver through `dns.lookup`, so
+ * they also read the hosts file. Record queries and reverse lookups share one
+ * `dns.Resolver`. Node.js cannot cancel a single query or address lookup, so
+ * interrupting one discards its result but lets the underlying work finish: a
+ * query runs until it is answered or times out, and a `getaddrinfo` call keeps
+ * a libuv thread pool worker busy until it returns.
+ *
+ * @stability experimental
+ * @since 4.0.0
+ */
+export type { 
+/**
+ * Options for the Node.js `Dns` service: name servers, timeout, and tries
+ * for record queries and reverse lookups.
+ *
+ * @stability experimental
+ * @category re-exports
+ * @since 4.0.0
+ */
+Options } from "../node-shared/NodeDns.js";
+export { 
+/**
+ * Layer that provides the Node.js `Dns` service using the system resolver
+ * configuration.
+ *
+ * @stability experimental
+ * @category re-exports
+ * @since 4.0.0
+ */
+layer, 
+/**
+ * Creates a layer that provides the Node.js `Dns` service with options read
+ * from configuration.
+ *
+ * @stability experimental
+ * @category re-exports
+ * @since 4.0.0
+ */
+layerConfig, 
+/**
+ * Creates a Node.js `Dns` service whose resolver lives as long as the scope.
+ *
+ * @stability experimental
+ * @category re-exports
+ * @since 4.0.0
+ */
+make } from "../node-shared/NodeDns.js";
+//# sourceMappingURL=NodeDns.d.ts.map

package/dist/vendor/cjs/node/NodeDns.js

@@ -0,0 +1 @@
+module.exports = require("../../node/NodeDns.js")

package/dist/vendor/cjs/node/NodeFileSystem.d.ts

@@ -3,6 +3,7 @@ import type * as Layer from "effect/Layer";
 /**
  * Provides the `FileSystem` service backed by Node filesystem APIs.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */