@scalar/workspace-store 0.54.4 → 0.55.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @scalar/workspace-store
 
+## 0.55.0
+
+### Minor Changes
+
+- [#9568](https://github.com/scalar/scalar/pull/9568): Add AsyncAPI protocol and server pickers to the sidebar (like the multi-document picker) that filter the navigation down to the operations reachable over the selected protocol/server
+- [#8519](https://github.com/scalar/scalar/pull/8519): refactor: extract the code example block into `@scalar/blocks/code-example`. `api-client`, `api-client-react`, and `api-reference` now import `CodeExample`, `findClient`, `generateClientOptions`, and the related helpers from the new package. `workspace-store` exports `isParamDisabled` with an optional `defaultDisabled` argument.
+
+  **Breaking (`@scalar/api-client`):** the `@scalar/api-client/blocks/operation-code-sample` and `@scalar/api-client/v2/blocks/operation-code-sample` export paths have been removed. Import from `@scalar/blocks/code-example` instead, and use the renamed `CodeExample` / `CodeExampleProps` (previously `OperationCodeSample` / `OperationCodeSampleProps`).
+
+- [#9543](https://github.com/scalar/scalar/pull/9543): Add the `x-scalar-links` OpenAPI extension to render extra named links (like a privacy policy or imprint) next to the contact, license and terms of service links in the introduction.
+
+### Patch Changes
+
+- [#9583](https://github.com/scalar/scalar/pull/9583): Serialize array values inside `deepObject` query parameters with the trailing bracket convention (`filter[ids][]=1&filter[ids][]=2`) instead of collapsing them into a single comma-joined value
+- [#9548](https://github.com/scalar/scalar/pull/9548): Keep request and response example pickers in sync across operations. Selecting an example (e.g. "Use case 1") now selects the example with the same key on every other operation that defines it, mirroring how the programming-language selection already syncs. Operations that do not have a matching example keep their current selection.
+
+## 0.54.5
+
+### Patch Changes
+
+- [#9549](https://github.com/scalar/scalar/pull/9549): Preserve `$ref` reference objects when coercing schemas, so unresolved chunk references (from the server-side workspace store) survive instead of being dropped. This is a prerequisite for resolving lazily-loaded chunks transitively (an operation chunk can now reference component chunks).
+
 ## 0.54.4
 
 ### Patch Changes

package/dist/channel-example/build-connection-url.d.ts

@@ -14,6 +14,13 @@ export type BuildConnectionUrlInput = {
  * Extracts default values of variables defined on an AsyncAPI Server Object.
  */
 export declare const getAsyncApiServerVariables: (server: AsyncApiServerObject | null) => Record<string, string>;
+/**
+ * Normalizes an AsyncAPI `protocol` for comparison: trimmed and lowercased.
+ *
+ * Returns `undefined` when the protocol is missing or blank, so callers can treat
+ * "no protocol" distinctly instead of comparing against an empty string.
+ */
+export declare const normalizeProtocol: (protocol: string | undefined) => string | undefined;
 /** Maps AsyncAPI `server.protocol` to a URL scheme (MVP: ws and wss). */
 export declare const getUrlSchemeFromProtocol: (protocol: string) => string;
 export declare const isWebSocketProtocol: (protocol: string) => protocol is AsyncApiWebSocketProtocol;

package/dist/channel-example/build-connection-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-connection-url.d.ts","sourceRoot":"","sources":["../../src/channel-example/build-connection-url.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,4BAA4B,CAAA;AAInC,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,wBAAyB,CAAA;AAElE,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAA;AAErF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC,CAAA;CACjF,CAAA;AAQD;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,oBAAoB,GAAG,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAYrG,CAAA;AAoBD,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,KAAG,MAAuC,CAAA;AAEnG,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,QAAQ,IAAI,yBAC0B,CAAA;AAE7F;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,oBAAoB,EAC5B,uBAAuB,uBAAuB,CAAC,sBAAsB,CAAC,KACrE,MAYF,CAAA;AAaD,0FAA0F;AAC1F,eAAO,MAAM,eAAe,GAC1B,SAAS,qBAAqB,EAC9B,YAAY,uBAAuB,GAAG,IAAI,KACzC,uBAAuB,GAAG,SAa5B,CAAA;AA0FD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,uBAAuB,GAAG,SAAS,EAC9C,kBAAkB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACvC,eAoBF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,wFAOhC,uBAAuB,KAAG,MAkB5B,CAAA"}
+{"version":3,"file":"build-connection-url.d.ts","sourceRoot":"","sources":["../../src/channel-example/build-connection-url.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,4BAA4B,CAAA;AAInC,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,wBAAyB,CAAA;AAElE,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAA;AAErF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC,CAAA;CACjF,CAAA;AAQD;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,oBAAoB,GAAG,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAYrG,CAAA;AAoBD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAGzE,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,KAAG,MAAuC,CAAA;AAEnG,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,QAAQ,IAAI,yBAC0B,CAAA;AAE7F;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,oBAAoB,EAC5B,uBAAuB,uBAAuB,CAAC,sBAAsB,CAAC,KACrE,MAYF,CAAA;AAaD,0FAA0F;AAC1F,eAAO,MAAM,eAAe,GAC1B,SAAS,qBAAqB,EAC9B,YAAY,uBAAuB,GAAG,IAAI,KACzC,uBAAuB,GAAG,SAa5B,CAAA;AA0FD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,uBAAuB,GAAG,SAAS,EAC9C,kBAAkB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACvC,eAoBF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,wFAOhC,uBAAuB,KAAG,MAkB5B,CAAA"}

package/dist/channel-example/build-connection-url.js

@@ -33,6 +33,16 @@ const substituteTemplate = (template, options) => {
     }
     return result;
 };
+/**
+ * Normalizes an AsyncAPI `protocol` for comparison: trimmed and lowercased.
+ *
+ * Returns `undefined` when the protocol is missing or blank, so callers can treat
+ * "no protocol" distinctly instead of comparing against an empty string.
+ */
+export const normalizeProtocol = (protocol) => {
+    const normalized = protocol?.trim().toLowerCase();
+    return normalized ? normalized : undefined;
+};
 /** Maps AsyncAPI `server.protocol` to a URL scheme (MVP: ws and wss). */
 export const getUrlSchemeFromProtocol = (protocol) => protocol.trim().toLowerCase();
 export const isWebSocketProtocol = (protocol) => ASYNCAPI_WEBSOCKET_PROTOCOLS.includes(protocol.trim().toLowerCase());

package/dist/channel-example/get-async-api-protocols.d.ts

@@ -0,0 +1,86 @@
+import type { AsyncApiDocument, AsyncApiOperationObject } from '@scalar/types/asyncapi/3.1';
+/** Sentinel used by the protocol and server pickers to mean "don't filter". */
+export declare const ALL: "all";
+/** A single protocol option for the picker (e.g. `{ id: 'mqtt', label: 'MQTT' }`). */
+export type AsyncApiProtocolOption = {
+    /** The normalized protocol id (lowercase), or {@link ALL}. */
+    id: string;
+    /** Human-friendly label shown in the dropdown. */
+    label: string;
+};
+/**
+ * Builds the protocol options for the picker from a document's servers.
+ *
+ * Always prepends an "All protocols" entry so the picker can clear the filter,
+ * matching how the document picker always offers every document. Protocols are
+ * de-duplicated and sorted alphabetically for a stable order.
+ */
+export declare const getAsyncApiProtocols: (document: AsyncApiDocument) => AsyncApiProtocolOption[];
+/** A single server option for the picker (e.g. `{ id: 'mqtt-prod', label: 'mqtt-prod (mqtt)' }`). */
+export type AsyncApiServerOption = {
+    /** The server name (its key in `document.servers`), or {@link ALL}. */
+    id: string;
+    /** Human-friendly label: the server name, suffixed with its protocol when known. */
+    label: string;
+};
+/**
+ * Builds the server options for the picker from a document's servers.
+ *
+ * Like {@link getAsyncApiProtocols}, always prepends an "All servers" entry so the
+ * filter can be cleared. Each option is labelled with the server name and its
+ * protocol so the picker reads as `mqtt-prod (mqtt)`.
+ */
+export declare const getAsyncApiServerOptions: (document: AsyncApiDocument) => AsyncApiServerOption[];
+/**
+ * Document-level lookups the per-operation reachability check needs.
+ *
+ * Building this once per filter pass (instead of recomputing it for every operation)
+ * keeps sidebar filtering at O(operations + servers) rather than O(operations × servers).
+ */
+export type AsyncApiReachabilityContext = {
+    /** Normalized protocol of every named server, keyed by server name. */
+    serverProtocols: Map<string, string>;
+    /** Every server name declared on the document. */
+    allServerNames: Set<string>;
+};
+/** Precomputes the document-level data shared across every operation in a filter pass. */
+export declare const createReachabilityContext: (document: AsyncApiDocument) => AsyncApiReachabilityContext;
+/** The servers (and the protocols they speak) a single operation is reachable through. */
+export type OperationReachability = {
+    /** Server names the operation's channel can be reached through. */
+    serverNames: Set<string>;
+    /** Protocols those servers use. */
+    protocols: Set<string>;
+};
+/**
+ * Resolves the servers and protocols a single operation is reachable over.
+ *
+ * Resolves the operation's channel once, then intersects the channel's servers
+ * (or all servers, when the channel pins none) with the document's servers. The
+ * shared {@link AsyncApiReachabilityContext} is built once per filter pass; a fresh
+ * one is created when called standalone.
+ */
+export declare const getOperationReachability: (document: AsyncApiDocument, operation: AsyncApiOperationObject, context?: AsyncApiReachabilityContext) => OperationReachability;
+/**
+ * Returns the set of protocols an operation is reachable over.
+ */
+export declare const getOperationProtocols: (document: AsyncApiDocument, operation: AsyncApiOperationObject, context?: AsyncApiReachabilityContext) => Set<string>;
+/**
+ * Returns the names of the servers an operation is reachable through.
+ */
+export declare const getOperationServerNames: (document: AsyncApiDocument, operation: AsyncApiOperationObject, context?: AsyncApiReachabilityContext) => Set<string>;
+/**
+ * Whether an operation should be shown for the currently selected protocol.
+ *
+ * Selecting {@link ALL} (or nothing) matches every operation; otherwise the
+ * operation is kept only when one of its channel's servers uses that protocol.
+ */
+export declare const operationMatchesProtocol: (document: AsyncApiDocument, operation: AsyncApiOperationObject, protocol: string | undefined, context?: AsyncApiReachabilityContext) => boolean;
+/**
+ * Whether an operation should be shown for the currently selected server.
+ *
+ * Selecting {@link ALL} (or nothing) matches every operation; otherwise the
+ * operation is kept only when its channel is reachable through that server.
+ */
+export declare const operationMatchesServer: (document: AsyncApiDocument, operation: AsyncApiOperationObject, serverName: string | undefined, context?: AsyncApiReachabilityContext) => boolean;
+//# sourceMappingURL=get-async-api-protocols.d.ts.map

package/dist/channel-example/get-async-api-protocols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-async-api-protocols.d.ts","sourceRoot":"","sources":["../../src/channel-example/get-async-api-protocols.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAQ3F,+EAA+E;AAC/E,eAAO,MAAM,GAAG,EAAG,KAAc,CAAA;AAEjC,sFAAsF;AACtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAmBD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,gBAAgB,KAAG,sBAAsB,EAQvF,CAAA;AAED,qGAAqG;AACrG,MAAM,MAAM,oBAAoB,GAAG;IACjC,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAA;IACV,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,gBAAgB,KAAG,oBAAoB,EAOzF,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,uEAAuE;IACvE,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,kDAAkD;IAClD,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC5B,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB,GAAI,UAAU,gBAAgB,KAAG,2BAGrE,CAAA;AAEF,0FAA0F;AAC1F,MAAM,MAAM,qBAAqB,GAAG;IAClC,mEAAmE;IACnE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB,mCAAmC;IACnC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACvB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,EAClC,UAAS,2BAAiE,KACzE,qBAiBF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,EAClC,UAAU,2BAA2B,KACpC,GAAG,CAAC,MAAM,CAAqE,CAAA;AAElF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,EAClC,UAAU,2BAA2B,KACpC,GAAG,CAAC,MAAM,CAAuE,CAAA;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,EAClC,UAAU,MAAM,GAAG,SAAS,EAC5B,UAAU,2BAA2B,KACpC,OAMF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,EAClC,YAAY,MAAM,GAAG,SAAS,EAC9B,UAAU,2BAA2B,KACpC,OAMF,CAAA"}

package/dist/channel-example/get-async-api-protocols.js

@@ -0,0 +1,110 @@
+import { objectEntries } from '@scalar/helpers/object/object-entries';
+import { objectKeys } from '@scalar/helpers/object/object-keys';
+import { getResolvedRef } from '../helpers/get-resolved-ref.js';
+import { normalizeProtocol } from './build-connection-url.js';
+import { resolveOperationChannel } from './resolve-operation-channel.js';
+import { getChannelServerNames } from './servers.js';
+/** Sentinel used by the protocol and server pickers to mean "don't filter". */
+export const ALL = 'all';
+/**
+ * Returns the protocol of every named server, keyed by server name.
+ * References are resolved so a `$ref`-only server still contributes its protocol.
+ */
+const getServerProtocols = (document) => {
+    const protocols = new Map();
+    for (const [name, serverNode] of objectEntries(document.servers ?? {})) {
+        const protocol = normalizeProtocol(getResolvedRef(serverNode).protocol);
+        if (protocol) {
+            protocols.set(name, protocol);
+        }
+    }
+    return protocols;
+};
+/**
+ * Builds the protocol options for the picker from a document's servers.
+ *
+ * Always prepends an "All protocols" entry so the picker can clear the filter,
+ * matching how the document picker always offers every document. Protocols are
+ * de-duplicated and sorted alphabetically for a stable order.
+ */
+export const getAsyncApiProtocols = (document) => {
+    const unique = new Set(getServerProtocols(document).values());
+    const options = [...unique]
+        .sort((a, b) => a.localeCompare(b))
+        .map((protocol) => ({ id: protocol, label: protocol.toUpperCase() }));
+    return [{ id: ALL, label: 'All protocols' }, ...options];
+};
+/**
+ * Builds the server options for the picker from a document's servers.
+ *
+ * Like {@link getAsyncApiProtocols}, always prepends an "All servers" entry so the
+ * filter can be cleared. Each option is labelled with the server name and its
+ * protocol so the picker reads as `mqtt-prod (mqtt)`.
+ */
+export const getAsyncApiServerOptions = (document) => {
+    const options = objectEntries(document.servers ?? {}).map(([name, serverNode]) => {
+        const protocol = normalizeProtocol(getResolvedRef(serverNode).protocol);
+        return { id: name, label: protocol ? `${name} (${protocol})` : name };
+    });
+    return [{ id: ALL, label: 'All servers' }, ...options];
+};
+/** Precomputes the document-level data shared across every operation in a filter pass. */
+export const createReachabilityContext = (document) => ({
+    serverProtocols: getServerProtocols(document),
+    allServerNames: new Set(objectKeys(document.servers ?? {})),
+});
+/**
+ * Resolves the servers and protocols a single operation is reachable over.
+ *
+ * Resolves the operation's channel once, then intersects the channel's servers
+ * (or all servers, when the channel pins none) with the document's servers. The
+ * shared {@link AsyncApiReachabilityContext} is built once per filter pass; a fresh
+ * one is created when called standalone.
+ */
+export const getOperationReachability = (document, operation, context = createReachabilityContext(document)) => {
+    const channel = resolveOperationChannel(document, operation)?.channel ?? null;
+    const channelServerNames = getChannelServerNames(document, channel);
+    // A channel without declared servers is reachable on every server.
+    const serverNames = channelServerNames
+        ? new Set([...channelServerNames].filter((name) => context.allServerNames.has(name)))
+        : new Set(context.allServerNames);
+    const protocols = new Set();
+    for (const [name, protocol] of context.serverProtocols) {
+        if (serverNames.has(name)) {
+            protocols.add(protocol);
+        }
+    }
+    return { serverNames, protocols };
+};
+/**
+ * Returns the set of protocols an operation is reachable over.
+ */
+export const getOperationProtocols = (document, operation, context) => getOperationReachability(document, operation, context).protocols;
+/**
+ * Returns the names of the servers an operation is reachable through.
+ */
+export const getOperationServerNames = (document, operation, context) => getOperationReachability(document, operation, context).serverNames;
+/**
+ * Whether an operation should be shown for the currently selected protocol.
+ *
+ * Selecting {@link ALL} (or nothing) matches every operation; otherwise the
+ * operation is kept only when one of its channel's servers uses that protocol.
+ */
+export const operationMatchesProtocol = (document, operation, protocol, context) => {
+    if (!protocol || protocol === ALL) {
+        return true;
+    }
+    return getOperationProtocols(document, operation, context).has(protocol);
+};
+/**
+ * Whether an operation should be shown for the currently selected server.
+ *
+ * Selecting {@link ALL} (or nothing) matches every operation; otherwise the
+ * operation is kept only when its channel is reachable through that server.
+ */
+export const operationMatchesServer = (document, operation, serverName, context) => {
+    if (!serverName || serverName === ALL) {
+        return true;
+    }
+    return getOperationServerNames(document, operation, context).has(serverName);
+};

package/dist/channel-example/index.d.ts

@@ -2,6 +2,8 @@ export type { AsyncApiWebSocketProtocol, BuildConnectionUrlInput } from './build
 export { ASYNCAPI_WEBSOCKET_PROTOCOLS, buildAsyncApiServerBaseUrl, buildConnectionUrl, buildWsQueryParams, getAsyncApiServerVariables, getUrlSchemeFromProtocol, isWebSocketProtocol, mergeWsBindings, } from './build-connection-url.js';
 export type { ChannelMessageEntry } from './get-all-channel-messages.js';
 export { getAllChannelMessages } from './get-all-channel-messages.js';
+export type { AsyncApiProtocolOption, AsyncApiReachabilityContext, AsyncApiServerOption, OperationReachability, } from './get-async-api-protocols.js';
+export { ALL, createReachabilityContext, getAsyncApiProtocols, getAsyncApiServerOptions, getOperationProtocols, getOperationReachability, getOperationServerNames, operationMatchesProtocol, operationMatchesServer, } from './get-async-api-protocols.js';
 export { getAsyncApiSecurityRequirements } from './get-asyncapi-security-requirements.js';
 export { getChannelConnectionContext } from './get-channel-connection-context.js';
 export { getChannelConnectionSecurityRequirements } from './get-channel-connection-security.js';

package/dist/channel-example/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel-example/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChG,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,EAAE,wCAAwC,EAAE,MAAM,mCAAmC,CAAA;AAC5F,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,YAAY,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACzE,YAAY,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel-example/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChG,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,GAAG,EACH,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,EAAE,wCAAwC,EAAE,MAAM,mCAAmC,CAAA;AAC5F,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,YAAY,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AAC/E,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACzE,YAAY,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

package/dist/channel-example/index.js

@@ -1,5 +1,6 @@
 export { ASYNCAPI_WEBSOCKET_PROTOCOLS, buildAsyncApiServerBaseUrl, buildConnectionUrl, buildWsQueryParams, getAsyncApiServerVariables, getUrlSchemeFromProtocol, isWebSocketProtocol, mergeWsBindings, } from './build-connection-url.js';
 export { getAllChannelMessages } from './get-all-channel-messages.js';
+export { ALL, createReachabilityContext, getAsyncApiProtocols, getAsyncApiServerOptions, getOperationProtocols, getOperationReachability, getOperationServerNames, operationMatchesProtocol, operationMatchesServer, } from './get-async-api-protocols.js';
 export { getAsyncApiSecurityRequirements } from './get-asyncapi-security-requirements.js';
 export { getChannelConnectionContext } from './get-channel-connection-context.js';
 export { getChannelConnectionSecurityRequirements } from './get-channel-connection-security.js';

package/dist/channel-example/servers.d.ts

@@ -25,6 +25,13 @@ export type AsyncApiServerEntry = {
     /** Whether this server uses a WebSocket protocol (`ws` / `wss`). */
     isWebSocket: boolean;
 };
+/**
+ * Collects the names of `document.servers` entries that the channel is restricted to.
+ *
+ * Returns `undefined` when the channel does not declare `servers`, signaling that every
+ * top-level server is allowed.
+ */
+export declare const getChannelServerNames: (document: AsyncApiDocument, channel: AsyncApiChannelObject | null) => Set<string> | undefined;
 /**
  * Returns a normalized list of AsyncAPI servers with computed base `url` and optional `connectionUrl`.
  */

package/dist/channel-example/servers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../../src/channel-example/servers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,KAAK,uBAAuB,EAI7B,MAAM,wCAAwC,CAAA;AAI/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACtC,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,oBAAoB,CAAC,EAAE,uBAAuB,CAAC,sBAAsB,CAAC,CAAA;IACtE,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,oBAAoB,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAA;IACX,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAA;CACrB,CAAA;AA+BD;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,gBAAgB,EAC1B,UAAS,yBAA8B,KACtC,mBAAmB,EA8CrB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,SAAS,mBAAmB,EAAE,EAC9B,aAAa,uBAAuB,GAAG,IAAI,KAC1C,mBAAmB,GAAG,IAYxB,CAAA"}
+{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../../src/channel-example/servers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,KAAK,uBAAuB,EAI7B,MAAM,wCAAwC,CAAA;AAI/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACtC,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,oBAAoB,CAAC,EAAE,uBAAuB,CAAC,sBAAsB,CAAC,CAAA;IACtE,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,oBAAoB,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAA;IACX,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAA;CACrB,CAAA;AAOD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,gBAAgB,EAC1B,SAAS,qBAAqB,GAAG,IAAI,KACpC,GAAG,CAAC,MAAM,CAAC,GAAG,SAahB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,gBAAgB,EAC1B,UAAS,yBAA8B,KACtC,mBAAmB,EA8CrB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,SAAS,mBAAmB,EAAE,EAC9B,aAAa,uBAAuB,GAAG,IAAI,KAC1C,mBAAmB,GAAG,IAYxB,CAAA"}

package/dist/channel-example/servers.js

@@ -11,7 +11,7 @@ const getServerNameFromRef = (ref) => getNameFromRef(ref, ['servers']);
  * Returns `undefined` when the channel does not declare `servers`, signaling that every
  * top-level server is allowed.
  */
-const getChannelServerNames = (document, channel) => {
+export const getChannelServerNames = (document, channel) => {
     if (!channel?.servers) {
         return undefined;
     }