@scalar/workspace-store 0.60.0 → 0.61.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @scalar/workspace-store
 
+## 0.61.0
+
+### Minor Changes
+
+- [#10173](https://github.com/scalar/scalar/pull/10173): Support the OpenAPI 3.2 QUERY request method in workspace operations, navigation, server chunks, and request examples.
+
+  Give QUERY a dedicated color tuned to each theme preset in light and dark mode and place it after GET in the method picker. Server chunk extraction also recognizes uppercase method keys while retaining their authored case. QUERY is modeled in the 3.2 schemas only.
+
+- [#9851](https://github.com/scalar/scalar/pull/9851): Validate and coerce OpenAPI documents against the v3.2 schemas so OpenAPI 3.2 fields are preserved in the store instead of being stripped, and type the store (workspace, documents, and navigation) against the v3.2 document. The internal upgrade target stays 3.1, but the public document type now widens to the 3.2 superset (for example `parameter.in` gains `"querystring"`, tags gain `parent`/`kind`/`summary`).
+
+  To keep the v3.2 schema a true superset of 3.1, the `x-scalar-ignore` extension is kept on security schemes (so they can still be hidden from the auth UI), and 3.2 `querystring` parameters are now serialized into the request query string instead of being dropped when building requests.
+
+### Patch Changes
+
+- [#9885](https://github.com/scalar/scalar/pull/9885): Render `$dynamicRef` array items when the binding schema is referenced by name.
+  A response that used `$ref: '#/components/schemas/PaginatedUserResponse'` (rather
+  than an inline `$id`/`$defs` binding) hid the resource's `$dynamicAnchor` behind
+  the `$ref`, so the dynamic scope never grew and the item type rendered empty.
+  `pushDynamicScope` now follows a bare `$ref` to reach the named binding resource.
+- [#9817](https://github.com/scalar/scalar/pull/9817): Resolve relative `externalValue` URLs on example objects against the document origin, so external request and response examples load even when referenced with a relative path
+- [#10068](https://github.com/scalar/scalar/pull/10068): Generate a proper UUID example for version-specific uuid formats (uuid1, uuid3, uuid4, uuid5), so documents from FastAPI/Pydantic get a UUID example instead of an empty one.
+- [#10072](https://github.com/scalar/scalar/pull/10072): Add a "generate example from schema" button to the request body, so the schema-generated fields stay reachable once an operation ships custom examples
+- [#10165](https://github.com/scalar/scalar/pull/10165): Truncate deeply nested examples with an empty value of the declared type — `{}`, `[]`, or a placeholder of the declared primitive — instead of the `[Max Depth Exceeded]` string, so a truncated example no longer contradicts the type its schema declares. A value the schema states outright through `example`, `examples`, `default`, `const` or `enum` wins at that depth, including through a composition wrapper; a property excluded by `mode` is omitted there rather than replaced by a placeholder; and a composition nothing can describe, or a negative constraint, answers with `null`. Only schemas that describe no shape at all keep the sentinel. A schema shared between a deep chain and a shallower position is also no longer served the truncated example.
+- [#10164](https://github.com/scalar/scalar/pull/10164): Serve deprecated response schemas from the mock instead of answering a declared JSON response with an empty body, and generate a deprecated AsyncAPI message payload instead of sending `null`. `getExampleFromSchema` takes a new `includeDeprecated` option for callers that must produce a value satisfying the schema. A declared response header that generates no value is now skipped rather than clearing a header of the same name the mock already set, such as the CORS headers.
+- [#10081](https://github.com/scalar/scalar/pull/10081): Keep the `mutualTLS` security scheme type instead of turning it into an apiKey form, and show read-only authentication guidance for mutual TLS and unsupported browser broker credentials.
+- [#9666](https://github.com/scalar/scalar/pull/9666): Only normalize OpenAPI Reference Objects during bundling, never Schema Objects. `normalizeRefs` used to strip every sibling except `$ref` on any node outside `components/schemas`, which also hit inline schemas. In JSON Schema 2020-12 a `$ref` may legally carry sibling keywords — for example a `$defs`/`$dynamicAnchor` binding that specializes a generic template like `Paginated<T>` — and such schemas appear inline anywhere a schema is allowed (a response's `content.<media>.schema`, an `allOf` branch, …). Dropping those siblings discarded the binding, leaving `$dynamicRef` to resolve to the template's empty fallback and rendering an empty array (for example the `data` array of `GET /planets` in the Scalar Galaxy). Reference Objects are still normalized as before. A new `@scalar/helpers/openapi/is-schema-path` helper detects schema positions.
+- [#9851](https://github.com/scalar/scalar/pull/9851): Preserve mutualTLS security schemes and the default request body view extension in OpenAPI 3.2 document schemas and types.
+
+  Render OpenAPI 3.2 querystring parameters in the query parameters section.
+
+- [#10137](https://github.com/scalar/scalar/pull/10137): Skip Paths Object extension keys so they cannot be mistaken for API paths. Add a regression test with an operation-shaped extension.
+- [#10114](https://github.com/scalar/scalar/pull/10114): Keep chunk filenames inside the output directory and match their references on Windows. Reject existing symlinks below the output root when writing chunks and the workspace manifest.
+- [#10131](https://github.com/scalar/scalar/pull/10131): Copy the example shown in the response card, including named, generated, referenced, and falsy values.
+- [#10194](https://github.com/scalar/scalar/pull/10194): Fix editing server variables supplied through the configuration.
+- [#10140](https://github.com/scalar/scalar/pull/10140): Replace redundant type assertions with compiler-checked annotations, typed accumulators, and existing guards across helpers, API conversion, request handling, and schema rendering.
+
+  Narrow DOM elements and caught errors before accessing their properties. Correct header lookup to include missing values and handle them during PowerShell snippet generation.
+
+  Validate release-note provider responses, represent unresolved references and absent groups in helper return types, and require narrowing merged object values. Preserve AsyncAPI broker credentials separately from HTTP authentication schemes.
+
+- [#10142](https://github.com/scalar/scalar/pull/10142): Send multipart array properties as separate parts with the same field name, applying encoding to each item. Preserve JSON item content types, uploaded files, and array values after form edits, and generate matching code snippets.
+
+  Send JSON form fields without an upload filename and preserve fields and files in request history.
+
+  Rename the RestSharp snippet's internal `getMethod` helper so it no longer clashes with the `getMethod` that Nitro bundles into server builds (the new multipart imports shifted chunking and surfaced the collision).
+
+- [#10199](https://github.com/scalar/scalar/pull/10199): Honor OpenAPI discriminator `defaultMapping` when generating oneOf and anyOf examples with an absent or unmapped discriminating property. Preserve explicit variant selections and prefer explicit and implicit mappings before the fallback.
+
 ## 0.60.0
 
 ### Minor Changes

package/README.md

@@ -95,6 +95,12 @@ const chunk = store.get('#/document-name/components/schemas/Person')
 
 Create a new store in static mode
 
+Static generation treats the real path of the configured output directory as its trusted root,
+so an intentionally symlinked output directory is supported. Existing symbolic links below that
+root, including chunk files and `scalar-workspace.json`, are rejected. Keep the output directory
+and its ancestors under trusted control throughout generation: filesystem checks do not protect
+against an untrusted process concurrently replacing files or directories.
+
 ```ts
 // Create the store
 const store = await createServerWorkspaceStore({

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;;;;;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"}
+{"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,yBACsB,CAAA;AAEzF;;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

@@ -14,7 +14,7 @@ export const getAsyncApiServerVariables = (server) => {
     }
     return objectEntries(server.variables).reduce((acc, [name, variable]) => {
         const resolved = getResolvedRef(variable);
-        if (resolved.default != null) {
+        if (resolved?.default != null) {
             acc[String(name)] = String(resolved.default);
         }
         return acc;
@@ -45,7 +45,7 @@ export const normalizeProtocol = (protocol) => {
 };
 /** 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());
+export const isWebSocketProtocol = (protocol) => ASYNCAPI_WEBSOCKET_PROTOCOLS.some((scheme) => scheme === protocol.trim().toLowerCase());
 /**
  * Builds the server base URL: scheme, host, and optional pathname (no channel address).
  */
@@ -65,7 +65,7 @@ const resolveWsBinding = (bindings) => {
         return undefined;
     }
     const resolved = getResolvedRef(bindings);
-    return resolved.ws;
+    return resolved?.ws;
 };
 /** Merges channel and operation WebSocket bindings; operation fields override channel. */
 export const mergeWsBindings = (channel, operation) => {

package/dist/channel-example/dedupe-requirements.d.ts

@@ -1,4 +1,4 @@
-import type { SecurityRequirementObject } from '../schemas/v3.1/strict/security-requirement.js';
+import type { SecurityRequirementObject } from '../schemas/v3.2/strict/security-requirement.js';
 /**
  * Remove duplicate security requirements, comparing by their JSON shape.
  *

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

@@ -13,7 +13,7 @@ export const ALL = 'all';
 const getServerProtocols = (document) => {
     const protocols = new Map();
     for (const [name, serverNode] of objectEntries(document.servers ?? {})) {
-        const protocol = normalizeProtocol(getResolvedRef(serverNode).protocol);
+        const protocol = normalizeProtocol(getResolvedRef(serverNode)?.protocol);
         if (protocol) {
             protocols.set(name, protocol);
         }
@@ -43,7 +43,7 @@ export const getAsyncApiProtocols = (document) => {
  */
 export const getAsyncApiServerOptions = (document) => {
     const options = objectEntries(document.servers ?? {}).map(([name, serverNode]) => {
-        const protocol = normalizeProtocol(getResolvedRef(serverNode).protocol);
+        const protocol = normalizeProtocol(getResolvedRef(serverNode)?.protocol);
         return { id: name, label: protocol ? `${name} (${protocol})` : name };
     });
     return [{ id: ALL, label: 'All servers' }, ...options];

package/dist/channel-example/get-asyncapi-security-requirements.d.ts

@@ -1,5 +1,5 @@
 import type { AsyncApiDocument, AsyncApiOperationObject, AsyncApiServerObject } from '@scalar/types/asyncapi/3.1';
-import type { SecurityRequirementObject } from '../schemas/v3.1/strict/security-requirement.js';
+import type { SecurityRequirementObject } from '../schemas/v3.2/strict/security-requirement.js';
 /**
  * Converts AsyncAPI security arrays (operation, traits, server) into OpenAPI-style requirement objects.
  */

package/dist/channel-example/get-channel-connection-security.d.ts

@@ -1,5 +1,5 @@
 import type { AsyncApiChannelObject, AsyncApiDocument, AsyncApiServerObject } from '@scalar/types/asyncapi/3.1';
-import type { SecurityRequirementObject } from '../schemas/v3.1/strict/security-requirement.js';
+import type { SecurityRequirementObject } from '../schemas/v3.2/strict/security-requirement.js';
 import type { ChannelOperationSummary } from './get-channel-operations.js';
 /**
  * Merges security requirements from the selected server and all operations on a channel.

package/dist/channel-example/get-channel-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-operations.d.ts","sourceRoot":"","sources":["../../src/channel-example/get-channel-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAO3F,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,uBAAuB,CAAA;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,gBAAgB,EAAE,aAAa,MAAM,KAAG,uBAAuB,EAgB7G,CAAA"}
+{"version":3,"file":"get-channel-operations.d.ts","sourceRoot":"","sources":["../../src/channel-example/get-channel-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAO3F,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,uBAAuB,CAAA;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,gBAAgB,EAAE,aAAa,MAAM,KAAG,uBAAuB,EAkB7G,CAAA"}

package/dist/channel-example/get-channel-operations.js

@@ -8,7 +8,10 @@ export const getChannelOperations = (document, channelName) => {
     const operations = document.operations ?? {};
     return Object.entries(operations)
         .map(([operationName, operationRef]) => {
-        const operation = resolveOperationWithTraits(getResolvedRef(operationRef));
+        const resolvedOperation = getResolvedRef(operationRef);
+        if (!resolvedOperation)
+            return undefined;
+        const operation = resolveOperationWithTraits(resolvedOperation);
         const resolved = resolveOperationChannel(document, operation);
         if (resolved?.channelName !== channelName) {
             return undefined;

package/dist/channel-example/get-channel-parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-parameters.d.ts","sourceRoot":"","sources":["../../src/channel-example/get-channel-parameters.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,4BAA4B,CAAA;AAKnC,MAAM,MAAM,wBAAwB,GAAG;IACrC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;IACpD,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B,CAAA;AA+BD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,qBAAqB,EAC9B,YAAY,uBAAuB,GAAG,IAAI,EAC1C,YAAW,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAM,KACxE,wBAgCF,CAAA"}
+{"version":3,"file":"get-channel-parameters.d.ts","sourceRoot":"","sources":["../../src/channel-example/get-channel-parameters.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,4BAA4B,CAAA;AAKnC,MAAM,MAAM,wBAAwB,GAAG;IACrC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;IACpD,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B,CAAA;AA+BD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,qBAAqB,EAC9B,YAAY,uBAAuB,GAAG,IAAI,EAC1C,YAAW,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAM,KACxE,wBAiCF,CAAA"}

package/dist/channel-example/get-channel-parameters.js

@@ -33,7 +33,9 @@ export const getChannelParameters = (channel, operation, overrides = {}) => {
     const definitions = {};
     if (channel.parameters) {
         for (const [name, parameterRef] of objectEntries(channel.parameters)) {
-            definitions[name] = getResolvedRef(parameterRef);
+            const parameter = getResolvedRef(parameterRef);
+            if (parameter)
+                definitions[name] = parameter;
         }
     }
     const path = { ...overrides.path };

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-channel.d.ts","sourceRoot":"","sources":["../../src/channel-example/resolve-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAIzF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,gBAAgB,EAAE,aAAa,MAAM,KAAG,eAAe,GAAG,SAWlG,CAAA"}
+{"version":3,"file":"resolve-channel.d.ts","sourceRoot":"","sources":["../../src/channel-example/resolve-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAIzF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,gBAAgB,EAAE,aAAa,MAAM,KAAG,eAAe,GAAG,SAYlG,CAAA"}

package/dist/channel-example/resolve-channel.js

@@ -8,6 +8,8 @@ export const resolveChannel = (document, channelName) => {
         return undefined;
     }
     const channel = getResolvedRef(channelNode);
+    if (!channel)
+        return undefined;
     const channelAddress = typeof channel.address === 'string' && channel.address.length > 0 ? channel.address : channelName;
     return { channelName, channel, channelAddress };
 };

package/dist/channel-example/resolve-operation-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-operation-channel.d.ts","sourceRoot":"","sources":["../../src/channel-example/resolve-operation-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAKlH,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAmBD;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,KACjC,wBAAwB,GAAG,SA8B7B,CAAA"}
+{"version":3,"file":"resolve-operation-channel.d.ts","sourceRoot":"","sources":["../../src/channel-example/resolve-operation-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAKlH,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,qBAAqB,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAmBD;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,gBAAgB,EAC1B,WAAW,uBAAuB,KACjC,wBAAwB,GAAG,SAgC7B,CAAA"}

package/dist/channel-example/resolve-operation-channel.js

@@ -24,10 +24,14 @@ export const resolveOperationChannel = (document, operation) => {
     const channelNameFromRef = '$ref' in channelNode ? getChannelNameFromRef(channelNode.$ref) : undefined;
     if (channelNameFromRef && document.channels?.[channelNameFromRef]) {
         const channel = getResolvedRef(document.channels[channelNameFromRef]);
+        if (!channel)
+            return undefined;
         const channelAddress = typeof channel.address === 'string' && channel.address.length > 0 ? channel.address : channelNameFromRef;
         return { channelName: channelNameFromRef, channel, channelAddress };
     }
     const channel = getResolvedRef(channelNode);
+    if (!channel)
+        return undefined;
     const channelName = channelNameFromRef ??
         findChannelName(document, channel) ??
         (typeof channel.address === 'string' && channel.address.length > 0 ? channel.address : undefined);

package/dist/channel-example/resolve-operation-with-traits.js

@@ -1,7 +1,7 @@
 import { getResolvedRef } from '../helpers/get-resolved-ref.js';
 const getTraitSecurity = (traits) => traits.reduce((security, traitRef) => {
     const trait = getResolvedRef(traitRef);
-    return trait.security !== undefined ? trait.security : security;
+    return trait?.security !== undefined ? trait.security : security;
 }, undefined);
 /**
  * Merges operation traits into a single operation view, while keeping operation fields highest priority.
@@ -14,7 +14,7 @@ export const resolveOperationWithTraits = (operation) => {
     const traitSecurity = getTraitSecurity(traits);
     const traitBindings = traits.reduce((accumulated, traitRef) => {
         const trait = getResolvedRef(traitRef);
-        if (!trait.bindings) {
+        if (!trait?.bindings) {
             return accumulated;
         }
         const resolvedTraitBindings = getResolvedRef(trait.bindings);

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;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"}
+{"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,EA+CrB,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

@@ -35,6 +35,8 @@ export const getAsyncApiServers = (document, options = {}) => {
         .filter(([name]) => channelServerNames?.has(name) ?? true)
         .map(([name, serverRef]) => {
         const server = resolveServer(serverRef);
+        if (!server)
+            return undefined;
         const protocol = server.protocol.trim().toLowerCase();
         const isWebSocket = isWebSocketProtocol(protocol);
         const url = buildAsyncApiServerBaseUrl(server, environmentVariables);
@@ -60,7 +62,7 @@ export const getAsyncApiServers = (document, options = {}) => {
         }
         return entry;
     })
-        .filter((entry) => (webSocketOnly ? entry.isWebSocket : true));
+        .filter((entry) => entry !== undefined && (!webSocketOnly || entry.isWebSocket));
 };
 /**
  * Returns the selected AsyncAPI server entry, using `x-scalar-selected-asyncapi-server` on the document.

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

@@ -4,7 +4,7 @@ import type { AuthMeta } from '../events/index.js';
 import type { SecuritySchemeObjectSecret } from '../request-example/builder/security/secret-types.js';
 import type { MergedSecuritySchemes } from '../request-example/context/security/merge-security.js';
 import type { XScalarEnvironment } from '../schemas/extensions/document/x-scalar-environments.js';
-import type { SecurityRequirementObject } from '../schemas/v3.1/strict/security-requirement.js';
+import type { SecurityRequirementObject } from '../schemas/v3.2/strict/security-requirement.js';
 import type { ChannelMessageEntry } from './get-all-channel-messages.js';
 import type { ChannelOperationSummary } from './get-channel-operations.js';
 import type { ChannelParametersContext } from './get-channel-parameters.js';

package/dist/client.d.ts

@@ -5,7 +5,7 @@ import { type AuthStore } from './entities/auth/index.js';
 import { type HistoryStore } from './entities/history/index.js';
 import type { NavigationOptions } from './navigation/get-navigation-options.js';
 import type { InMemoryWorkspace } from './schemas/inmemory-workspace.js';
-import { type OpenApiDocument } from './schemas/v3.1/strict/openapi-document.js';
+import { type OpenApiDocument } from './schemas/v3.2/strict/openapi-document.js';
 import type { DocumentMetaExtensions, Workspace, WorkspaceDocument, WorkspaceDocumentMeta, WorkspaceExtensions, WorkspaceMeta } from './schemas/workspace.js';
 import type { WorkspaceSpecification } from './schemas/workspace-specification/index.js';
 import type { WorkspacePlugin } from './workspace-plugin.js';

package/dist/client.js

@@ -27,9 +27,9 @@ import { createNavigation, traverseAsyncApiDocument } from './navigation/index.j
 import { externalValueResolver, loadingStatus, normalizeAuthSchemes, normalizeRefs, refsEverywhere, removeExtraScalarKeys, restoreOriginalRefs, syncPathParameters, } from './plugins/bundler/index.js';
 import { extensions } from './schemas/extensions.js';
 import { isAsyncApiDocument, isOpenApiDocument } from './schemas/type-guards.js';
-import { generateSchema } from './schemas/v3.1/openapi/index.js';
-import { recursiveRef } from './schemas/v3.1/openapi/reference.js';
-import { OpenAPIDocumentSchema as OpenAPIDocumentSchemaStrict, } from './schemas/v3.1/strict/openapi-document.js';
+import { generateSchema } from './schemas/v3.2/openapi/index.js';
+import { recursiveRef } from './schemas/v3.2/openapi/reference.js';
+import { OpenAPIDocumentSchema as OpenAPIDocumentSchemaStrict, } from './schemas/v3.2/strict/openapi-document.js';
 /**
  * Maximum number of external references and example `externalValue`s fetched at once while bundling
  * a document. Keeps large documents (which can reference thousands of external examples) from opening