@scalar/workspace-store 0.67.2 → 0.68.1

package/dist/request-example/context/security/extract-security-scheme-secrets.js

@@ -1,5 +1,6 @@
 import { isObject } from '@scalar/helpers/object/is-object';
 import { objectEntries } from '@scalar/helpers/object/object-entries';
+import { isSecretFieldCleared } from '@scalar/workspace-store/helpers/auth-secret-fields';
 /**
  * Maps x-scalar-secret fields to their corresponding input field names.
  * This allows us to fall back to config values when auth store secrets are not available.
@@ -14,24 +15,30 @@ const SECRET_TO_INPUT_FIELD_MAP = {
     'x-scalar-secret-auth-url': 'authorizationUrl',
     'x-scalar-secret-token-url': 'tokenUrl',
 };
-const mergeFlowSecrets = (properties, configSecrets, authStoreSecrets = {}, oauth2RedirectUri) => Object.fromEntries(properties.map((property) => {
-    // Redirect URI is the only OAuth secret where an explicit empty value from
-    // store must be preserved. Other secrets use falsy fallback behavior for backwards-compatibility
-    // with config defaults when the casted auth store value is an empty string.
-    const authStoreValue = typeof authStoreSecrets[property] === 'string' ? authStoreSecrets[property] : undefined;
-    const configValue = typeof configSecrets[property] === 'string' ? configSecrets[property] : undefined;
-    const configInputValue = typeof configSecrets[SECRET_TO_INPUT_FIELD_MAP[property]] === 'string'
-        ? configSecrets[SECRET_TO_INPUT_FIELD_MAP[property]]
-        : undefined;
-    // oauth2RedirectUri (top-level config option) is used as a global fallback for the redirect URI,
-    // applied only when neither the auth store nor per-scheme config have a value. This ensures
-    // the configured redirect URI persists when switching between documents with the same OAuth config,
-    // because each document starts with no stored redirect URI (authStoreValue === undefined).
-    const value = property === 'x-scalar-secret-redirect-uri'
-        ? (authStoreValue ?? configValue ?? configInputValue ?? oauth2RedirectUri ?? '')
-        : authStoreValue || configValue || configInputValue || '';
-    return [property, value];
-}));
+const mergeFlowSecrets = (properties, configSecrets, authStoreSecrets = {}, oauth2RedirectUri) => {
+    const clearedFields = properties.filter((property) => isSecretFieldCleared(authStoreSecrets, property));
+    const values = Object.fromEntries(properties.map((property) => {
+        // Preserve explicit clears, while legacy schema-filled empties still inherit defaults.
+        const authStoreValue = typeof authStoreSecrets[property] === 'string' ? authStoreSecrets[property] : undefined;
+        const configValue = typeof configSecrets[property] === 'string' ? configSecrets[property] : undefined;
+        const configInputValue = typeof configSecrets[SECRET_TO_INPUT_FIELD_MAP[property]] === 'string'
+            ? configSecrets[SECRET_TO_INPUT_FIELD_MAP[property]]
+            : undefined;
+        // oauth2RedirectUri (top-level config option) is used as a global fallback for the redirect URI,
+        // applied only when neither the auth store nor per-scheme config have a value. This ensures
+        // the configured redirect URI persists when switching between documents with the same OAuth config,
+        // because each document starts with no stored redirect URI (authStoreValue === undefined).
+        const value = property === 'x-scalar-secret-redirect-uri' || isSecretFieldCleared(authStoreSecrets, property)
+            ? (authStoreValue ?? configValue ?? configInputValue ?? oauth2RedirectUri ?? '')
+            : authStoreValue || configValue || configInputValue || '';
+        return [property, value];
+    }));
+    return { ...values, ...(clearedFields.length ? { 'x-scalar-secret-cleared-fields': clearedFields } : {}) };
+};
+const storedSecret = (secrets, field) => {
+    const value = secrets && Reflect.get(secrets, field);
+    return typeof value === 'string' && (value || isSecretFieldCleared(secrets ?? {}, field)) ? value : undefined;
+};
 /** Secret extensions are not part of the strict scheme types, so they are read the same way the OAuth flows read theirs */
 const documentSecret = (scheme, property) => {
     const value = property in scheme ? Reflect.get(scheme, property) : undefined;
@@ -151,10 +158,8 @@ scheme, authStore, name, documentSlug, oauth2RedirectUri) => {
         const storeSecrets = secrets?.type === 'apiKey' ? secrets : undefined;
         return {
             ...scheme,
-            'x-scalar-secret-token': storeSecrets?.['x-scalar-secret-token'] ||
-                documentSecret(scheme, 'x-scalar-secret-token') ||
-                scheme.value ||
-                '',
+            'x-scalar-secret-token': storedSecret(storeSecrets, 'x-scalar-secret-token') ??
+                (documentSecret(scheme, 'x-scalar-secret-token') || scheme.value || ''),
         };
     }
     // Handle HTTP Auth security schemes (e.g., Basic, Bearer)
@@ -162,18 +167,12 @@ scheme, authStore, name, documentSlug, oauth2RedirectUri) => {
         const storeSecrets = secrets?.type === 'http' ? secrets : undefined;
         return {
             ...scheme,
-            'x-scalar-secret-token': storeSecrets?.['x-scalar-secret-token'] ||
-                documentSecret(scheme, 'x-scalar-secret-token') ||
-                scheme.token ||
-                '',
-            'x-scalar-secret-username': storeSecrets?.['x-scalar-secret-username'] ||
-                documentSecret(scheme, 'x-scalar-secret-username') ||
-                scheme.username ||
-                '',
-            'x-scalar-secret-password': storeSecrets?.['x-scalar-secret-password'] ||
-                documentSecret(scheme, 'x-scalar-secret-password') ||
-                scheme.password ||
-                '',
+            'x-scalar-secret-token': storedSecret(storeSecrets, 'x-scalar-secret-token') ??
+                (documentSecret(scheme, 'x-scalar-secret-token') || scheme.token || ''),
+            'x-scalar-secret-username': storedSecret(storeSecrets, 'x-scalar-secret-username') ??
+                (documentSecret(scheme, 'x-scalar-secret-username') || scheme.username || ''),
+            'x-scalar-secret-password': storedSecret(storeSecrets, 'x-scalar-secret-password') ??
+                (documentSecret(scheme, 'x-scalar-secret-password') || scheme.password || ''),
         };
     }
     // Handle OAuth2 security schemes and all supported flows

package/dist/server.d.ts

@@ -32,7 +32,8 @@ type CreateServerWorkspaceStoreBase = {
      * exactly what it would have held without this option.
      *
      * `getResolvedDocument()` is unaffected: it carries the whole document and its navigation either
-     * way. AsyncAPI documents are unaffected too, since nothing about them is externalized.
+     * way. AsyncAPI documents externalize their channels, operations, and components; compact mode
+     * moves their navigation children into a chunk too.
      *
      * @default false
      */

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -13,7 +13,8 @@ import { createMagicProxy, getRaw } from '@scalar/json-magic/magic-proxy';
 import { upgrade } from '@scalar/openapi-upgrader';
 import { asyncApiObjectSchema } from '@scalar/schemas/asyncapi/3.1';
 import { coerce } from '@scalar/validation';
-import { CHUNK_INDEX_KEY, buildChunkIndex, chunkRefTemplates, fillChunkRef, navigationHeader, } from './helpers/chunk-index.js';
+import { asyncApiChunkGroups } from './helpers/asyncapi-chunk-groups.js';
+import { CHUNK_INDEX_KEY, buildChunkIndex, chunkRefTemplates, chunkReference, fillChunkRef, navigationHeader, } from './helpers/chunk-index.js';
 import { createChunkWriter } from './helpers/create-chunk-writer.js';
 import { deepClone } from './helpers/deep-clone.js';
 import { encodeChunkName } from './helpers/encode-chunk-name.js';
@@ -277,11 +278,9 @@ export async function createServerWorkspaceStore(workspaceProps) {
     /**
      * Adds an AsyncAPI document to the workspace.
      *
-     * AsyncAPI keeps its content under `channels` and `operations` instead of `paths`, so none of the
-     * OpenAPI externalization applies: there are no path operations to split into chunks, and the
-     * consumers read channels and operations straight off the stored document. The document is
-     * therefore kept whole, and only the AsyncAPI upgrader runs so 1.x/2.x documents reach the 3.x
-     * shape the traversal and renderer expect.
+     * Channels, operations and components become global chunk references. References inside each
+     * chunk retain their document-relative pointers so shared and recursive dependencies resolve
+     * against the same root. The whole document remains available for server rendering.
      *
      * @param document - The AsyncAPI document to process and add
      * @param meta - The document name plus any metadata to merge onto the stored document
@@ -300,9 +299,6 @@ export async function createServerWorkspaceStore(workspaceProps) {
         // shapes like `channels: null` straight through to the browser. Merged rather than assigned, so
         // nothing the schema does not model is dropped.
         mergeObjects(asyncApiDocument, coerce(asyncApiObjectSchema, deepClone(asyncApiDocument)));
-        // Nothing is externalized, so the document owns no chunks. The empty entry keeps `get()` and
-        // chunk generation well defined for the document name.
-        assets[name] = {};
         // Traversed before the spread below: its last act is a top-level `x-scalar-order` write on the
         // document, and a snapshot taken first would both miss it and preserve whatever stale order the
         // input arrived with.
@@ -312,19 +308,73 @@ export async function createServerWorkspaceStore(workspaceProps) {
         // traversal falls back to the map key — so the sidebar reads `planetCreated` where the
         // rendered page reads "Planet Created".
         resolveLocalReferences(asyncApiDocument), navigationOptions ?? workspaceProps.navigationOptions);
-        workspace.documents[name] = {
+        const whole = {
             ...documentMeta,
             ...asyncApiDocument,
             'x-original-aas-version': originalAasVersion,
             [extensions.document.navigation]: navigation,
         };
-        // A document carrying both discriminators is ingested as AsyncAPI here, but `getDocumentType`
-        // checks OpenAPI first — so leaving `openapi` in place would hand an OpenAPI renderer a
-        // navigation tree of channel entries. The document is stored as the type it was read as.
-        delete workspace.documents[name]['openapi'];
-        // Nothing was externalized, so the stored document already is the whole document; it only needs
-        // its references resolving to be rendered from.
-        resolvedDocuments[name] = resolveLocalReferences(workspace.documents[name]);
+        delete whole['openapi'];
+        const options = workspaceProps.mode === 'static'
+            ? { mode: 'static', name }
+            : { mode: 'ssr', name, baseUrl: workspaceProps.baseUrl };
+        const refs = chunkRefTemplates(options);
+        const asyncapi = {};
+        const resolvedComponents = getRaw(getResolvedRef(resolveLocalReferences(asyncApiDocument).components));
+        const groups = asyncApiChunkGroups({ ...asyncApiDocument, components: resolvedComponents });
+        const externalize = (section, entries = {}) => {
+            const chunks = {};
+            const references = Object.entries(entries).map(([key, value]) => {
+                const group = groups.get(`${section}/${key}`);
+                const filename = group ?? key;
+                if (group) {
+                    const values = (chunks[escapeJsonPointer(group)] ??= {});
+                    Object.defineProperty(values, key, { value, enumerable: true, configurable: true, writable: true });
+                }
+                else
+                    Object.defineProperty(chunks, escapeJsonPointer(key), {
+                        value,
+                        enumerable: true,
+                        configurable: true,
+                        writable: true,
+                    });
+                const fragment = group ? `#/${encodeURIComponent(escapeJsonPointer(key))}` : '#';
+                return [
+                    key,
+                    chunkReference(workspaceProps.mode === 'static'
+                        ? `./chunks/${encodeChunkName(name)}/asyncapi/${section}/${encodeChunkName(filename)}.json${fragment}`
+                        : `${workspaceProps.baseUrl}/${name}/asyncapi/${section}/${encodeURIComponent(escapeJsonPointer(filename))}${fragment}`),
+                ];
+            });
+            asyncapi[section] = chunks;
+            return Object.fromEntries(references);
+        };
+        const components = Object.fromEntries(Object.entries(resolvedComponents ?? {}).map(([type, entries]) => [
+            type,
+            type === 'servers' || type === 'securitySchemes'
+                ? entries
+                : externalize(`components-${type}`, entries),
+        ]));
+        asyncapi.models = Object.fromEntries(Object.entries(resolvedComponents?.schemas ?? {}).map(([key, value]) => [escapeJsonPointer(key), value]));
+        const channels = externalize('channels', asyncApiDocument.channels);
+        const operations = externalize('operations', asyncApiDocument.operations);
+        assets[name] = {
+            asyncapi,
+            ...(workspaceProps.compact ? { navigation } : {}),
+        };
+        workspace.documents[name] = {
+            ...whole,
+            components,
+            channels,
+            operations,
+            ...(workspaceProps.compact
+                ? {
+                    [extensions.document.navigation]: navigationHeader(navigation),
+                    [extensions.document.navigationChunk]: fillChunkRef(refs.navigation),
+                }
+                : {}),
+        };
+        resolvedDocuments[name] = resolveLocalReferences(whole);
     };
     /**
      * Adds a new document to the workspace.
@@ -479,11 +529,24 @@ export async function createServerWorkspaceStore(workspaceProps) {
             const basePath = resolve(workspaceProps.directory ?? DEFAULT_ASSETS_FOLDER);
             const writeChunk = await createChunkWriter(basePath);
             await writeChunk([WORKSPACE_FILE_NAME], workspace);
-            for (const [name, { components, operations, navigation }] of Object.entries(assets)) {
+            for (const [name, { components, operations, navigation, asyncapi }] of Object.entries(assets)) {
                 // Only compact documents chunk their navigation; otherwise it stays whole on the document.
                 if (navigation !== undefined) {
                     await writeChunk(['chunks', encodeChunkName(name), 'navigation.json'], navigation);
                 }
+                if (asyncapi) {
+                    for (const [section, entries] of Object.entries(asyncapi)) {
+                        for (const [key, value] of Object.entries(entries)) {
+                            await writeChunk([
+                                'chunks',
+                                encodeChunkName(name),
+                                'asyncapi',
+                                section,
+                                `${encodeChunkName(unescapeJsonPointer(key))}.json`,
+                            ], value);
+                        }
+                    }
+                }
                 if (components) {
                     for (const [type, component] of Object.entries(components)) {
                         for (const [key, value] of Object.entries(component)) {
@@ -526,7 +589,10 @@ export async function createServerWorkspaceStore(workspaceProps) {
                 }
             })();
             // Keep the path segments escaped cuz we store them on the filesystem as escaped sequences
-            const path = parseJsonPointerSegments(pointerPath).map(escapeJsonPointer);
+            const segments = pointerPath.split('/').slice(1);
+            const path = segments[1] === 'asyncapi'
+                ? segments.map((segment) => escapeJsonPointer(decodeURIComponent(segment).replaceAll('~1', '/').replaceAll('~0', '~')))
+                : parseJsonPointerSegments(pointerPath).map(escapeJsonPointer);
             return getValueAtPath(assets, path);
         },
         addDocument,

package/package.json

@@ -16,7 +16,7 @@
     "openapi",
     "scalar"
   ],
-  "version": "0.67.2",
+  "version": "0.68.1",
   "engines": {
     "node": ">=22"
   },
@@ -153,15 +153,15 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@scalar/asyncapi-upgrader": "0.1.14",
-    "@scalar/helpers": "0.16.0",
-    "@scalar/json-magic": "0.15.3",
-    "@scalar/openapi-upgrader": "0.4.1",
-    "@scalar/schemas": "0.12.2",
-    "@scalar/snippetz": "0.10.4",
+    "@scalar/asyncapi-upgrader": "0.1.15",
+    "@scalar/helpers": "0.16.1",
+    "@scalar/json-magic": "0.15.5",
+    "@scalar/openapi-upgrader": "0.4.2",
+    "@scalar/schemas": "0.13.0",
+    "@scalar/snippetz": "0.10.6",
     "@scalar/typebox": "0.1.3",
-    "@scalar/types": "0.22.3",
-    "@scalar/validation": "0.6.5",
+    "@scalar/types": "0.23.0",
+    "@scalar/validation": "0.6.6",
     "js-base64": "^3.9.2",
     "type-fest": "^5.8.0",
     "vue": "^3.5.40",