Skip to content

Release v6.6.67 - #910

Merged
alexpmule merged 11 commits into
masterfrom
build/6.6.67-prep
Aug 26, 2026
Merged

Release v6.6.67#910
alexpmule merged 11 commits into
masterfrom
build/6.6.67-prep

Conversation

@alexpmule

@alexpmule alexpmule commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Updated Components

  • @api-components/amf-helper-mixin 4.5.36 → 4.5.38
  • @api-components/api-navigation 4.3.22 → 4.3.24
  • @api-components/api-summary 4.6.16 → 4.6.21
  • @api-components/api-documentation 6.1.8 → 6.1.9
    • transitively pulls in @api-components/api-body-document 4.4.15 → 4.4.17, @api-components/api-type-document 4.2.44 → 4.2.46, @api-components/api-method-documentation 5.2.31 → 5.2.33, @api-components/api-endpoint-documentation → 6.1.5
  • amf-client-js collapsed to a single 5.12.0 across the tree, and @api-components/api-model-generator adopted at 0.4.0

All of the above carry OAS 3.1/3.2 rendering fixes for TD-0333486 (webhooks, if/then/else, additionalProperties, QUERY/COPY/MOVE, SSE):

  • api-type-document 4.2.46 renders JSON Schema 2020-12 if/then/else conditional branches (previously collapsed to a generic "Any" badge).
  • api-summary 4.6.21 renders a separate Webhooks section for top-level OAS 3.1/3.2 webhooks.
  • api-endpoint-documentation 6.1.5 renders the OAS 3.2 method-label colors (QUERY/COPY/MOVE) in the endpoint overview.

Also includes:

  • Two new demo fixtures (oas31-webhooks, oas32-query-sse) wired into all demo apps (element, standalone, themed/anypoint, themed/dark).
  • amf-client-js deduped to a single 5.12.0. The demo model generator (@api-components/api-model-generator) previously pulled its own nested 5.11.x copy while the top-level devDependency resolved separately, so the tree carried two AMF builds. An overrides reference ("amf-client-js": "$amf-client-js") forces the nested copy to dedupe to the top-level devDependency, so demo model generation and the demo parsing-server run one AMF version and the generated OAS 3.1/3.2 @graph models stay consistent. amf-client-js/api-model-generator are devDependencies (demo/model generation only) and do not ship in the runtime bundle.
  • Fixes .npmrc missing the @api-components registry override, which was silently falling back to a proxy override instead of the public registry.
  • Hides the "Try it" request/response panel for OAS 3.1/3.2 webhook operations, in both layouts:
    • narrow layout: the tryit-requested handler no longer switches to the request page for a webhook selection, and the "Try it" button is suppressed via noTryIt.
    • wide layout (api-console-app): the inline request panel, which rendered unconditionally for any selected method, is now suppressed for webhooks too.
    • Webhooks have no invokable URL (the API calls the consumer, not the other way around), so the panel doesn't apply — this was previously showing a broken/nonsensical panel for webhook operations.

Supersedes #909 — its commits are already merged into this branch.

Related Tickets

  • W-23973253 — API Console v6 release
  • TD-0333486 — OAS 3.1/3.2 support in API Console v6

Screenshots

OAS 3.1 - Webhooks - if/then/else:

Screen.Recording.2026-08-26.at.11.36.31.AM.mov

OAS 3.2 - QUERY Method + SSE ItemSchema mapping:

Screen.Recording.2026-08-26.at.11.37.46.AM.mov

Bump amf-client-js ^5.4.4 -> ^5.11.7902 and @api-components/api-model-generator
^0.2.14 -> ^0.3.1 so the console's model-generation path runs on an AMF line
that understands OAS 3.1 (webhooks, if/then/else) and OAS 3.2 (QUERY, SSE).

The generator was pinned to a nested amf-client-js 4.7.8 that predates OAS
3.1/3.2 support; without bumping it, generating 3.1/3.2 fixtures fails. This
is the enabling dependency step for TD-0333486 (rendering work lands
separately). Verified: rollup build succeeds; AMF 5.11.x parses 3.1/3.2 specs
and emits webhooks as a `webhooks` collection of EndPoint nodes (sibling to
`endpoint`), plus QUERY method and text/event-stream SSE.

TD-0333486
Adds two demo specs and registers them in the model manifest and demo
app picker so the console has real OAS 3.1/3.2 models to render against:

- oas31-webhooks.yaml: top-level webhooks + allOf/if-then-else/oneOf/anyOf
- oas32-query-sse.yaml: QUERY method + text/event-stream (SSE) via itemSchema

Both parse with conforms:true under AMF 5.11.x. Generated models are
build artifacts (demo/models/*.json, gitignored), produced by
generate-model once api-model-generator republishes with OAS 3.1/3.2
support (api-components/api-model-generator#20).

W-23748889 (parent W-23735927).
Bumps @api-components/api-model-generator ^0.3.1 -> ^0.4.0, which
exposes OAS31/OAS32 in getConfiguration and pulls amf-client-js
5.11.12531. Generates the OAS 3.1/3.2 demo models added in 68dde60.
Updates @api-components/api-navigation ^4.3.20 -> ^4.3.22 and raises
the minimum Node.js engine requirement from >=10.0.0 to >=18.0.0.
…ocument 4.2.44

amf 5.11.x emits API models in flattened @graph form. The AmfHelperMixin
'amf' setter expands them internally, but the raw @graph model is not
navigable by the _compute* helpers — passing it to _computeApi returns
undefined, breaking every lookup helper in test/amf-loader.js.

- Add an expand() helper that sets the model on the helper element and
  returns the expanded model, then navigate the expanded model in
  lookupWebApi, lookupEndpoint, lookupSecurity, lookupType,
  lookupDocumentation and lookupEncodes.
- Bump transitive @api-components/api-type-document 4.2.43 -> 4.2.44
  (nullable/nil main-example fix) via lockfile only; it stays deduped.

Console suite: 469 passing, 0 failed, 2 skipped (Node 18, Playwright/Chromium).

@W-23748889
Refreshes @api-components/* to their latest published versions
(amf-helper-mixin 4.5.38, api-navigation 4.3.24, api-summary 4.6.20,
api-documentation 6.1.9), which transitively pull in api-body-document
4.4.17, api-type-document 4.2.45 and api-method-documentation 5.2.33
with OAS 3.1/3.2 rendering fixes for TD-0333486.

Fixes .npmrc missing the @api-components registry override, which was
silently falling back to a local proxy override instead of the public
registry. Adds the OAS 3.1/3.2 demo fixtures (oas31-webhooks,
oas32-query-sse) to the standalone, themed/anypoint and themed/dark
demo apps — they were already wired into the element demo.
@alexpmule
alexpmule requested a review from a team as a code owner August 25, 2026 20:02
alexpmule and others added 2 commits August 25, 2026 17:46
Webhooks have no invokable URL (the API calls the consumer, not the
other way around), so the request/response panel doesn't apply. Fixes
both the narrow-layout tryit-requested handler and the wide-layout
inline panel, which rendered unconditionally for any selected method
regardless of webhook status.
Update package-lock to pick up the published component fixes for TD-0333486: api-type-document 4.2.46 (if/then/else conditional schema rendering), api-summary 4.6.21 (separate Webhooks section), and api-endpoint-documentation 6.1.5 (QUERY/COPY/MOVE method-label colors in the endpoint overview).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alexpmule
alexpmule requested a review from dfmacias August 26, 2026 14:44
alexpmule and others added 2 commits August 26, 2026 12:27
api-model-generator@0.4.0 pinned amf-client-js exactly at 5.11.12531 while the console's direct devDep resolved to 5.12.0, leaving two AMF copies in the tree — the demo parsing-server and the model generator parsed with different AMF versions, risking @graph shape drift for OAS 3.1/3.2 models. Pin the direct devDep to ^5.12.0 and add a $-referenced override so the nested copy dedupes to a single 5.12.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Cover previously-untested parent-level OAS 3.1/3.2 behavior: webhook try-it gating (_isWebhookOperation, narrow + wide layout), if/then/else conditional schemas render (not collapsed to Any), and QUERY method label + teal color. 20 tests, green on chromium + firefox. SSE badge (v7-only) and COPY/MOVE (no fixture; not parsed by amf 5.11 from OAS 3.2) intentionally excluded.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alexpmule
alexpmule merged commit 685acfb into master Aug 26, 2026
3 checks passed
@alexpmule
alexpmule deleted the build/6.6.67-prep branch August 26, 2026 16:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants