@redocly/cli 2.71.2 → 2.72.1

package/lib/chunks/{W7TN2XCW.js → X3FFOCXC.js}

@@ -4,7 +4,7 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{a as c}from"./U2F3JOT2.js";import{h as s,l as a}from"./FAFMGLT6.js";import"./KFQC57GK.js";import{Z as t,fa as e,la as i}from"./FRQHCFKP.js";import"./NEWT5A6S.js";import"./RFWIIJFG.js";async function y({argv:r,config:l,version:d}){let o=s(l,r.residency);try{let n=new a(d);r.verbose&&(e.info(`OAuth client initialized.
+import{a as c}from"./GXILNSWK.js";import{h as s,l as a}from"./FLQQ3VRQ.js";import"./KFQC57GK.js";import{ca as t,ka as e,qa as i}from"./X22IMAJK.js";import"./6RTITFQA.js";import"./RFWIIJFG.js";async function y({argv:r,config:l,version:d}){let o=s(l,r.residency);try{let n=new a(d);r.verbose&&(e.info(`OAuth client initialized.
 `),e.info(`Local credentials file path: ${n.credentialsFilePath}
 `)),await n.login(o,c),e.output(t(`\u2705 Logged in
 

package/lib/chunks/{CRJEY7P3.js → XTI7EXWX.js}

@@ -4,4 +4,4 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{la as p}from"./FRQHCFKP.js";import{spawn as l}from"node:child_process";import{existsSync as a}from"node:fs";import*as s from"node:path";var m=/[\\/](_npx|dlx)[\\/]/;function T(t,r){let o=`credential.${t}/.helper`,e=!m.test(process.argv[1]??"")&&d("redocly")?"redocly":`npx --yes @redocly/cli@${r}`;return[`${o}=`,`${o}=!REDOCLY_SUPPRESS_UPDATE_NOTICE=true ${e} project git-credentials`]}async function P(t,{capture:r=!1}={}){return new Promise((o,i)=>{let e=l("git",t,{stdio:r?["ignore","pipe","ignore"]:"inherit",env:{...process.env,GIT_TERMINAL_PROMPT:"0"}}),c="";e.stdout?.on("data",n=>c+=n.toString()),e.on("error",n=>i(u(n))),e.on("close",n=>o({code:n??1,output:c.trim()}))})}function d(t){let r=process.platform==="win32"?[".cmd",".exe"]:[""];return(process.env.PATH??"").split(s.delimiter).some(o=>o&&r.some(i=>a(s.join(o,t+i))))}function u(t){return t.code==="ENOENT"?new p("git is not installed or not on PATH."):t}export{T as a,P as b};
+import{qa as p}from"./X22IMAJK.js";import{spawn as l}from"node:child_process";import{existsSync as a}from"node:fs";import*as s from"node:path";var m=/[\\/](_npx|dlx)[\\/]/;function T(t,r){let o=`credential.${t}/.helper`,e=!m.test(process.argv[1]??"")&&d("redocly")?"redocly":`npx --yes @redocly/cli@${r}`;return[`${o}=`,`${o}=!REDOCLY_SUPPRESS_NOTIFICATIONS=true ${e} project git-credentials`]}async function x(t,{capture:r=!1}={}){return new Promise((o,i)=>{let e=l("git",t,{stdio:r?["ignore","pipe","ignore"]:"inherit",env:{...process.env,GIT_TERMINAL_PROMPT:"0"}}),c="";e.stdout?.on("data",n=>c+=n.toString()),e.on("error",n=>i(u(n))),e.on("close",n=>o({code:n??1,output:c.trim()}))})}function d(t){let r=process.platform==="win32"?[".cmd",".exe"]:[""];return(process.env.PATH??"").split(s.delimiter).some(o=>o&&r.some(i=>a(s.join(o,t+i))))}function u(t){return t.code==="ENOENT"?new p("git is not installed or not on PATH."):t}export{T as a,x as b};

package/lib/chunks/{BH4FA7AH.js → YA5KTHFN.js}

@@ -4,7 +4,7 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{$ as f,L as D,M as h,N as O,R as C,Y as P,Z as j,_ as S,d as E,da as b,e as x,f as $,fa as o,k as l,la as a,t as u}from"./FRQHCFKP.js";var y=["json","yaml","yml"];import*as i from"node:fs";import{basename as k,dirname as d,extname as g,join as T,resolve as m,relative as R}from"node:path";import*as p from"node:process";import{performance as F}from"perf_hooks";async function te(e,n){let r=!x(e)&&$(n.resolvedConfig.apis)?G(n):await W(e,n),c=r.filter(({path:s})=>!z(s));if(x(c)){for(let{path:s}of c)o.warn(`
+import{Q as D,R as h,S as O,W as C,ba as P,ca as j,d as E,da as S,e as x,ea as f,f as $,ia as b,k as l,ka as o,qa as a,u}from"./X22IMAJK.js";var y=["json","yaml","yml"];import*as i from"node:fs";import{basename as k,dirname as d,extname as g,join as T,resolve as m,relative as R}from"node:path";import*as p from"node:process";import{performance as F}from"perf_hooks";async function te(e,n){let r=!x(e)&&$(n.resolvedConfig.apis)?G(n):await W(e,n),c=r.filter(({path:s})=>!z(s));if(x(c)){for(let{path:s}of c)o.warn(`
 ${q(s)} ${P(`does not exist or is invalid.
 
 `)}`);throw new a("Please provide a valid path.")}if(r.length===0)throw new a("No APIs were provided. Specify an API via the command argument or define one in your config.");return r}function w(e){return e.configPath?d(e.configPath):p.cwd()}function z(e){if(!e.trim())throw new a("Path cannot be empty.");return i.existsSync(e)||u(e)?e:void 0}function G(e){return Object.entries(e.resolvedConfig.apis||{}).map(([n,{root:t,output:r}])=>({path:u(t)?t:m(w(e),t),alias:n,output:r&&m(w(e),r)}))}function N(e,n){let t=w(e),r=e.resolvedConfig.apis?.[n];return r?{path:u(r.root)?r.root:m(t,r.root),alias:n,output:r.output&&m(t,r.output)}:{path:n,alias:Object.entries(e.resolvedConfig.apis||{}).find(([c,s])=>m(t,s.root)===m(n))?.[0]??void 0}}async function W(e,n){let{hasMagic:t,glob:r}=await import("./SJHPKWSD.js");return(await Promise.all(e.map(async c=>t(c)&&!u(c)?(await r(c,{cwd:w(n)})).map(I=>N(n,I)):N(n,c)))).flat()}function L(e){return p.env.NODE_ENV==="test"?"<test>ms":`${Math.ceil(F.now()-e)}ms`}function oe(e,n,t){let r=L(n);o.info(b(`

package/lib/chunks/{Z6GFQV2Y.js → YA6D5EUI.js}

@@ -4,7 +4,7 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{a as q}from"./U2F3JOT2.js";import{A as _,h as H,l as B,v as z,x as K,y as V,z as Z}from"./FAFMGLT6.js";import"./KFQC57GK.js";import{b as J,d as M,e as Y,v as L}from"./BH4FA7AH.js";import{$ as b,S as N,W as v,Y as O,Z as A,_ as j,ba as y,ca as C,da as R,fa as e,k as h,la as w,ma as D,ra as S,ua as g}from"./FRQHCFKP.js";import"./NEWT5A6S.js";import"./RFWIIJFG.js";import{dirname as le}from"node:path";function W(r,t,o,n){n&&e.info(C(v(`
+import{a as q}from"./GXILNSWK.js";import{A as _,h as H,l as B,v as z,x as K,y as V,z as Z}from"./FLQQ3VRQ.js";import"./KFQC57GK.js";import{b as J,d as M,e as Y,v as L}from"./YA5KTHFN.js";import{$ as v,X as N,ba as O,ca as A,da as j,ea as b,ga as y,ha as C,ia as R,k as h,ka as e,qa as w,ra as D,wa as S,za as g}from"./X22IMAJK.js";import"./6RTITFQA.js";import"./RFWIIJFG.js";import{dirname as le}from"node:path";function W(r,t,o,n){n&&e.info(C(v(`
  \u2611\uFE0F  Achieved Level: ${y(o)}
 
 `))),e.output(`<?xml version="1.0" encoding="UTF-8"?>

package/lib/chunks/{HMYFTLS7.js → ZFET6WME.js}

@@ -4,7 +4,7 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{d as L}from"./VJZDR6KS.js";import{b as $,c as w,d as M,f as D,g as q,h as B,i as _,j as F,k as U}from"./L325HIGK.js";import{d as k,f as C,h as P,i as j,m as A}from"./R32HBYOH.js";import{h as T,j as E}from"./DM4EUYBB.js";import{o as f,q as b,r as N,s as I,u as v}from"./5CR6AOLY.js";import{join as x}from"node:path";var d="// Generated by @redocly/client-generator \u2014 do not edit by hand.\n// Source: OpenAPI description. Re-run `redocly generate-client` to update.";function S(e){return e.filter(t=>t.length>0).join(`
+import{e as L}from"./TFPMT2XD.js";import{b as $,c as w,d as M,f as D,g as q,h as B,i as _,j as F,k as U}from"./4QC7OVHI.js";import{h as T,j as E}from"./BZTZIEWS.js";import{d as k,f as C,h as P,i as j,m as A}from"./ZXB5O6JQ.js";import{o as f,q as b,r as N,s as I,u as v}from"./A65OW7M7.js";import{join as x}from"node:path";var d="// Generated by @redocly/client-generator \u2014 do not edit by hand.\n// Source: OpenAPI description. Re-run `redocly generate-client` to update.";function S(e){return e.filter(t=>t.length>0).join(`
 
 `)+`
 `}function O(e){let t=["/**",` * ${j(`${e.title} (v${e.version})`)}`];if(e.description)for(let n of A(j(e.description)))t.push(` * ${n}`.replace(/ +$/,""));return t.push(" */"),t.join(`

package/lib/chunks/{R32HBYOH.js → ZXB5O6JQ.js}

@@ -4,7 +4,7 @@ import { dirname as __pathDirname } from 'node:path';
 const require = __createRequire(import.meta.url);
 var __filename = __fileURLToPath(import.meta.url);
 var __dirname = __pathDirname(__filename);
-import{c as f}from"./5CR6AOLY.js";var u=/^[A-Za-z_$][A-Za-z0-9_$]*$/,o=f.typescript;function m(e){return u.test(e)}function E(e){return u.test(e)&&!o.has(e)}function p(e){let i=e.replace(/[^A-Za-z0-9_$]/g,"_");return(i===""||/^[0-9]/.test(i)||o.has(i))&&(i=`_${i}`),i}var l={"<":"\\u003C",">":"\\u003E","\u2028":"\\u2028","\u2029":"\\u2029"};function s(e){return JSON.stringify(e).replace(/[<>\u2028\u2029]/g,i=>l[i])}function L(e){return u.test(e)&&!o.has(e)?e:s(e)}function S(e,i){let n=p(e),r=n,t=2;for(;i.has(r);)r=`${n}_${t++}`;return i.add(r),r}var _=s;function c(e){if(typeof e=="string")return s(e);if(typeof e=="boolean"||e===null||typeof e=="number")return String(e);if(Array.isArray(e))return`[${e.map(c).join(", ")}]`;let i=Object.entries(e).map(([n,r])=>`${m(n)?n:s(n)}: ${c(r)}`);return i.length===0?"{}":`{ ${i.join(", ")} }`}function x(e){return e.replace(/\*\//g,"*\\/")}function y(e,i){let n=h(e,i);return n.length===0?void 0:n.join(`
+import{c as f}from"./A65OW7M7.js";var u=/^[A-Za-z_$][A-Za-z0-9_$]*$/,o=f.typescript;function m(e){return u.test(e)}function E(e){return u.test(e)&&!o.has(e)}function p(e){let i=e.replace(/[^A-Za-z0-9_$]/g,"_");return(i===""||/^[0-9]/.test(i)||o.has(i))&&(i=`_${i}`),i}var l={"<":"\\u003C",">":"\\u003E","\u2028":"\\u2028","\u2029":"\\u2029"};function s(e){return JSON.stringify(e).replace(/[<>\u2028\u2029]/g,i=>l[i])}function L(e){return u.test(e)&&!o.has(e)?e:s(e)}function S(e,i){let n=p(e),r=n,t=2;for(;i.has(r);)r=`${n}_${t++}`;return i.add(r),r}var _=s;function c(e){if(typeof e=="string")return s(e);if(typeof e=="boolean"||e===null||typeof e=="number")return String(e);if(Array.isArray(e))return`[${e.map(c).join(", ")}]`;let i=Object.entries(e).map(([n,r])=>`${m(n)?n:s(n)}: ${c(r)}`);return i.length===0?"{}":`{ ${i.join(", ")} }`}function x(e){return e.replace(/\*\//g,"*\\/")}function y(e,i){let n=h(e,i);return n.length===0?void 0:n.join(`
 `)}function h(e,i){let n=[];return e&&e.trim()&&n.push(...g($(e))),i&&n.push(...d(i)),n}function d(e){let i=[],n=(r,t)=>{t===void 0?i.push(`@${r}`):i.push(`@${r} ${t}`)};return e.minimum!==void 0&&n("minimum",e.minimum),e.maximum!==void 0&&n("maximum",e.maximum),e.exclusiveMinimum!==void 0&&n("exclusiveMinimum",e.exclusiveMinimum),e.exclusiveMaximum!==void 0&&n("exclusiveMaximum",e.exclusiveMaximum),e.minLength!==void 0&&n("minLength",e.minLength),e.maxLength!==void 0&&n("maxLength",e.maxLength),e.pattern!==void 0&&n("pattern",x(e.pattern)),e.minItems!==void 0&&n("minItems",e.minItems),e.maxItems!==void 0&&n("maxItems",e.maxItems),e.uniqueItems===!0&&n("uniqueItems"),e.format!==void 0&&n("format",e.format),e.deprecated===!0&&n("deprecated"),i}function g(e){let i=0,n=e.length;for(;i<n&&e[i]==="";)i++;for(;n>i&&e[n-1]==="";)n--;return e.slice(i,n)}function C(e){return e[0].toUpperCase()+e.slice(1)}function j(e){let i=e.split(/[-_]/).filter(n=>n.length>0).map((n,r)=>{let t=n.toLowerCase();return r===0?t:t.charAt(0).toUpperCase()+t.slice(1)}).join("");return p(i)}function $(e){return e.replace(/\r\n/g,`
 `).split(`
 `).map(i=>i.trimEnd())}export{m as a,E as b,p as c,s as d,L as e,S as f,_ as g,c as h,x as i,y as j,C as k,j as l,$ as m};

package/lib/eject-assets/AGENTS.md

@@ -106,7 +106,7 @@ discriminated union on `kind`: `scalar`, `array`, `object`, `record`, `ref`,
 | `isNullable(schema)` / `unwrapNullable(schema)`         | Detect and strip `null` union members (`Optional[T]`, pointers, `Option<T>`).                                                        |
 | `enumValues(schema)`                                    | Values plus SCREAMING_SNAKE member-name suggestions.                                                                                 |
 | `headerCoerceType(schema, model)`                       | Response-header coerce hint (`integer`/`number`/`boolean`/`string`) through refs, nullables, and allOf wrappers.                     |
-| `casing` / `identifierFor(name, { style, reserved })`   | camel/pascal/snake/screaming; keyword-safe identifiers (`RESERVED_WORDS.python/go/typescript` shipped).                              |
+| `casing` / `identifierFor(name, { style, reserved })`   | camel/pascal/snake/screaming; keyword-safe identifiers (`RESERVED_WORDS.python/go/php/java/typescript` shipped).                     |
 | `uniqueIdentifiers(names, { style, reserved, taken })`  | The same, made unique among themselves and among names you already took — for a signature that takes one argument per parameter.     |
 | `Printer`                                               | Indentation-aware text builder — no manual whitespace bookkeeping.                                                                   |
 | `docText(description)`                                  | Description as trimmed lines for any comment syntax.                                                                                 |

package/lib/eject-assets/generators/cli/docs.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "cli" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator cli --update`.

package/lib/eject-assets/generators/cli/engine-source.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "cli" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator cli --update`.

package/lib/eject-assets/generators/cli/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "cli" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator cli --update`.
@@ -86,5 +86,5 @@ export default {
   docs: cliDocs,
   requires: ["typescript","zod"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.7.13',
+  requiresGenerator: '^0.8.1',
 };

package/lib/eject-assets/generators/cli/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "cli" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "cli" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator cli --update`.

package/lib/eject-assets/generators/go/client.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/go/descriptor.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/go/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.
@@ -332,5 +332,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.7.13',
+  requiresGenerator: '^0.8.1',
 };

package/lib/eject-assets/generators/go/models.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/go/naming.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/go/operations.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/go/pagination.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/go/types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.7.13 — the built-in "go" generator.
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "go" generator.
 // This file is yours: edit freely; the generated client stays machine-owned and is
 // rebuilt by `redocly generate-client`. Newer generator versions merge in with
 // `redocly eject-generator go --update`.

package/lib/eject-assets/generators/java/client.ts

@@ -0,0 +1,66 @@
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "java" generator.
+// This file is yours: edit freely; the generated client stays machine-owned and is
+// rebuilt by `redocly generate-client`. Newer generator versions merge in with
+// `redocly eject-generator java --update`.
+// The `client` stage: the `Servers` helper class of one static method per
+// declared server.
+
+import {
+  type ApiModel,
+  identifierFor,
+  type ServerModel,
+  serverUrlParts,
+} from '@redocly/client-generator';
+import type { JavaPrinter } from '@redocly/client-generator/printers/java';
+
+import { JAVA, javaString, memberName } from './naming.ts';
+
+/** The server URL as a Java expression: literals concatenated with declared-variable args. */
+function serverUrlExpression(server: ServerModel): string {
+  const parts = serverUrlParts(server).map((part) =>
+    part.kind === 'literal' ? javaString(part.value) : memberName(part.name)
+  );
+  return parts.join(' + ');
+}
+
+/** One static method per declared server; server variables become String arguments. */
+export function writeServers(printer: JavaPrinter, model: ApiModel): void {
+  const servers = model.servers ?? [];
+  if (servers.length === 0) return;
+  const usedNames = new Set<string>();
+  printer.line("/** The declared servers; the description's defaults are in each method's doc. */");
+  printer.block(
+    'public static final class Servers {',
+    () => {
+      servers.forEach((server, index) => {
+        let name = identifierFor(server.description ?? `server${index + 1}`, {
+          style: 'camel',
+          reserved: JAVA,
+        });
+        if (usedNames.has(name)) name = `${name}${index + 1}`;
+        usedNames.add(name);
+        const params = server.variables.map((variable) => `String ${memberName(variable.name)}`);
+        // Java has no default arguments; the spec default lives in the doc comment.
+        const defaults = server.variables
+          .map(
+            (variable) => `${memberName(variable.name)} default: ${javaString(variable.default)}`
+          )
+          .join(', ');
+        if (index > 0) printer.blank();
+        printer.doc(
+          name,
+          `The ${javaString(server.description ?? server.url)} base URL${defaults === '' ? '.' : ` (${defaults}).`}`
+        );
+        printer.block(
+          `public static String ${name}(${params.join(', ')}) {`,
+          () => {
+            printer.line(`return ${serverUrlExpression(server)};`);
+          },
+          '}'
+        );
+      });
+    },
+    '}'
+  );
+  printer.blank();
+}

package/lib/eject-assets/generators/java/descriptor.ts

@@ -0,0 +1,72 @@
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "java" generator.
+// This file is yours: edit freely; the generated client stays machine-owned and is
+// rebuilt by `redocly generate-client`. Newer generator versions merge in with
+// `redocly eject-generator java --update`.
+// The `descriptor` stage: the per-operation `Operation` literal — security
+// OR-alternatives and the pagination spec — and the envelope-header coerce specs.
+
+import {
+  type ApiModel,
+  headerCoerceType,
+  type NeutralPaginationRule,
+  type OperationModel,
+  securityRequirements,
+  uniqueIdentifiers,
+} from '@redocly/client-generator';
+
+import { JAVA, javaString } from './naming.ts';
+
+/** `List.of(List.of(SecuritySpec…))` for the operation's security OR-alternatives. */
+export function javaSecurityLiteral(op: OperationModel, model: ApiModel): string {
+  const alternatives = securityRequirements(op, model).map((alternative) => {
+    const specs = alternative.map((spec) =>
+      spec.kind === 'apiKey'
+        ? `new SecuritySpec(${javaString(spec.scheme)}, "apiKey", ${javaString(spec.name)}, ${javaString(spec.in)})`
+        : `SecuritySpec.of(${javaString(spec.scheme)}, ${javaString(spec.kind)})`
+    );
+    return `List.of(${specs.join(', ')})`;
+  });
+  return `List.of(${alternatives.join(', ')})`;
+}
+
+/** The neutral rule as a `new PaginationSpec(…)` literal, or `null` when the operation does not paginate. */
+export function javaPaginationLiteral(rule: NeutralPaginationRule | undefined): string {
+  if (rule === undefined) return 'null';
+  const field = (value: string | undefined) => (value === undefined ? 'null' : javaString(value));
+  return `new PaginationSpec(${[
+    javaString(rule.style),
+    field(rule.param),
+    field(rule.nextCursor),
+    field(rule.hasMore),
+    field(rule.nextLink),
+    field(rule.limitParam),
+    field(rule.items),
+  ].join(', ')})`;
+}
+
+/**
+ * The operation as the runtime describes it, built where it is used: a table of every
+ * operation in one static initializer would exceed the JVM's method size on a large
+ * description, and the record is a trivial allocation.
+ */
+export function javaOperationLiteral(
+  op: OperationModel,
+  model: ApiModel,
+  rule: NeutralPaginationRule | undefined
+): string {
+  return `new Operation(${javaString(op.specName ?? op.name)}, ${javaString(op.method.toUpperCase())}, ${javaString(op.path)}, ${javaSecurityLiteral(op, model)}, ${javaPaginationLiteral(rule)})`;
+}
+
+/** Declared response headers as runtime coerce specs: `{wire name, camelCase key, type}`. */
+export function envelopeHeaderSpecs(op: OperationModel, model: ApiModel): string {
+  const headers = op.successResponseHeaders ?? [];
+  const keys = uniqueIdentifiers(
+    headers.map((header) => header.name),
+    { style: 'camel', reserved: JAVA }
+  );
+  const specs = headers.map((header, index) => {
+    const type = headerCoerceType(header.schema, model);
+    return `{${javaString(header.name)}, ${javaString(keys[index])}, ${javaString(type)}}`;
+  });
+  return `new String[][] {${specs.join(', ')}}`;
+}

package/lib/eject-assets/generators/java/index.ts

@@ -0,0 +1,245 @@
+// Ejected from @redocly/client-generator@0.8.1 — the built-in "java" generator.
+// This file is yours: edit freely; the generated client stays machine-owned and is
+// rebuilt by `redocly generate-client`. Newer generator versions merge in with
+// `redocly eject-generator java --update`.
+// The built-in `java` generator — the fourth non-TypeScript library entry, authored
+// with the language-neutral toolkit only (same dogfooding invariant as python/go/php,
+// pinned by the guard test). Output is one Java >= 17 file over java.net.http: a public
+// class named after the output stem that nests the records (with fromJson/toJson
+// hydration), wire-backed enums, sealed union interfaces, the embedded runtime, and one
+// typed method per operation. Exceptions are the error mode (`errorMode` does not apply).
+
+import {
+  type CodeSample,
+  type Generator,
+  identifierFor,
+  jsonSuccessSchema,
+  type NeutralPaginationRule,
+  type OperationModel,
+  renderReferencePage,
+  type SampleContext,
+  sseResponse,
+} from '@redocly/client-generator';
+import { JavaPrinter } from '@redocly/client-generator/printers/java';
+import { JAVA_RUNTIME_SOURCE } from '@redocly/client-generator/runtime-sources';
+import { logger } from '@redocly/openapi-core';
+
+import { writeServers } from './client.ts';
+import { writeJavaModels } from './models.ts';
+import {
+  JAVA,
+  javaClassName,
+  javaPackageName,
+  javaString,
+  methodIdents,
+  plainPackageName,
+} from './naming.ts';
+import { paramsClassName, writeJavaMethod, writeParamsClass } from './operations.ts';
+import { writeJavaPaginationWrappers } from './pagination.ts';
+import { javaType } from './types.ts';
+
+export { renderJavaModels } from './models.ts';
+export { javaType } from './types.ts';
+
+/** The `import` lines of the runtime, which the generated file declares for both of them. */
+function runtimeImports(): string[] {
+  return JAVA_RUNTIME_SOURCE.split('\n').filter((line) => line.startsWith('import '));
+}
+
+/**
+ * The runtime's class body — everything between its class line and its closing brace, at
+ * the one-level indent the generated class also uses — for inline embedding.
+ */
+function runtimeBody(): string[] {
+  const lines = JAVA_RUNTIME_SOURCE.split('\n');
+  const start = lines.findIndex((line) => line.startsWith('abstract class Runtime {'));
+  const end = lines.lastIndexOf('}');
+  return lines
+    .slice(start + 1, end)
+    .map((line) => (line.startsWith('    ') ? line.slice(4) : line));
+}
+
+/** The whole generated file: package, imports, and the class nesting models, runtime, and methods. */
+export const javaGenerator: Generator = ({ model, output, banner, emit, pagination }) => {
+  const printer = new JavaPrinter();
+  const dateType = emit.dateType ?? 'string';
+  const className = javaClassName(output.stem, model);
+  const packageName = javaPackageName(model.title);
+  // A package the reader cannot see in the title would surprise the code that imports it.
+  if (packageName !== plainPackageName(model.title)) {
+    logger.warn(
+      `generate-client: the API title ${JSON.stringify(model.title)} cannot be a Java package as is, so the java SDK uses package "${packageName}" — rename the API title in the description to choose another.\n`
+    );
+  }
+  const moduleRuntime = emit.runtime === 'module';
+  const runtimeClass = `${className}Runtime`;
+  const operations = model.services.flatMap((service) => service.operations);
+  const idents = methodIdents(model);
+  // Pagination arrives RESOLVED from the pipeline — one fit-verified answer per run.
+  const paginationRules = new Map<string, NeutralPaginationRule>();
+  for (const op of operations) {
+    const spec = pagination?.get(op.name)?.spec;
+    if (spec !== undefined) paginationRules.set(op.name, spec);
+  }
+
+  printer.line(
+    `// Code generated by @redocly/client-generator (java) from ${javaString(model.title)} ${model.version}. DO NOT EDIT.`
+  );
+  printer.line(
+    '// Regenerate with `redocly generate-client`. Java >= 17, standard library only — zero dependencies.'
+  );
+  printer.blank();
+  printer.line(`package ${packageName};`);
+  printer.blank();
+  for (const line of runtimeImports()) printer.line(line);
+  printer.blank();
+  printer.doc(className, `Client for ${model.title} (${model.version}).`);
+  printer.block(
+    `public final class ${className}${moduleRuntime ? ` extends ${runtimeClass}` : ''} {`,
+    () => {
+      writeJavaModels(printer, model, dateType);
+      writeServers(printer, model);
+      if (!moduleRuntime) {
+        printer.line('// ─── Embedded runtime (@redocly/client-generator java runtime) ───');
+        for (const line of runtimeBody()) printer.line(line);
+        printer.blank();
+      }
+      for (const op of operations) {
+        writeParamsClass(printer, op, idents.get(op.name)!, model, dateType);
+      }
+      printer.line('private final Config config;');
+      printer.blank();
+      printer.block(
+        `public ${className}(Config config) {`,
+        () => {
+          printer.line('this.config = config;');
+          printer.block(
+            'if (config.serverUrl.isEmpty()) {',
+            () => {
+              printer.line(
+                `config.serverUrl = ${javaString(emit.serverUrl ?? model.serverUrl ?? '')};`
+              );
+            },
+            '}'
+          );
+        },
+        '}'
+      );
+      printer.blank();
+      printer.block(
+        `public ${className}() {`,
+        () => {
+          printer.line('this(new Config());');
+        },
+        '}'
+      );
+      printer.blank();
+
+      for (const op of operations) {
+        const ident = idents.get(op.name)!;
+        const rule = paginationRules.get(op.name);
+        writeJavaMethod(printer, op, ident, model, dateType, rule);
+        if (sseResponse(op) === undefined && (op.successResponseHeaders?.length ?? 0) > 0) {
+          writeJavaMethod(printer, op, ident, model, dateType, rule, true);
+        }
+        if (rule !== undefined) {
+          writeJavaPaginationWrappers(printer, op, ident, model, dateType, rule);
+        }
+      }
+    },
+    '}'
+  );
+
+  const entry = {
+    path: output.path.replace(/[^\\/]+$/, `${className}.java`),
+    content: printer.toString(),
+  };
+  if (!moduleRuntime) return [entry];
+  // The runtime as a real file: the same source, as a public base class the client extends,
+  // so every runtime name resolves unqualified in both runtime modes.
+  const header = banner.map((line) => `// ${line}`).join('\n');
+  const runtimeSource = JAVA_RUNTIME_SOURCE.replace(
+    /^abstract class Runtime \{$/m,
+    `public abstract class ${runtimeClass} {`
+  );
+  return [
+    entry,
+    {
+      path: output.path.replace(/[^\\/]+$/, `${runtimeClass}.java`),
+      content: `${header}\npackage ${packageName};\n\n${runtimeSource
+        .replace(/^\/\/.*\n/gm, '')
+        .trimStart()
+        .trimEnd()}\n`,
+    },
+  ];
+};
+
+/** One idiomatic Java call per operation — feeds `x-codeSamples` for docs. */
+export function javaSample(op: OperationModel, ctx: SampleContext): CodeSample {
+  const dateType = ctx.emit.dateType ?? 'string';
+  const stem = ctx.outputPath.replace(/^.*[\\/]/, '').replace(/\.[^.]+$/, '');
+  const className = javaClassName(stem, ctx.model);
+  const ident = methodIdents(ctx.model).get(op.name) ?? identifierFor(op.name, { reserved: JAVA });
+  const args = [
+    ...op.pathParams.map((param) =>
+      javaString(`<${identifierFor(param.name, { reserved: JAVA })}>`)
+    ),
+    ...(op.requestBody ? ['body'] : []),
+    ...(paramsClassName(op, ident, ctx.model) === undefined
+      ? []
+      : [`new ${className}.${paramsClassName(op, ident, ctx.model)}()`]),
+  ];
+  const call = `client.${ident}(${args.join(', ')})`;
+  // The statement matches the return shape: a void method has no result, an SSE method is
+  // iterated, and a typed method binds its result.
+  const statement =
+    sseResponse(op) !== undefined
+      ? `for (var event : ${call}) {\n    System.out.println(event.data());\n}`
+      : jsonSuccessSchema(op) === undefined
+        ? `${call};`
+        : `${javaType(jsonSuccessSchema(op)!, ctx.model, dateType)} result = ${call};`;
+  // The import names the package this run writes, so the snippet compiles as shown.
+  return {
+    lang: 'java',
+    label: 'Java SDK',
+    source: `import ${javaPackageName(ctx.model.title)}.${className};\n\n${className} client = new ${className}(new ${className}.Config());\n${statement}\n`,
+  };
+}
+
+/**
+ * The SDK's own reference page, written when `client.docs` is on. The call snippets come
+ * from `javaSample` — this generator's own hook — so the page can only ever show the syntax
+ * of the SDK beside it, and ejecting this generator takes the page with it.
+ */
+export const javaDocs: Generator = ({ model, output, emit, pagination }) => [
+  {
+    path: output.path.replace(/\.[^.\\/]+$/, '.java.md'),
+    content: renderReferencePage(model, {
+      title: `${model.title} Java SDK reference`,
+      frontmatter: emit.docsFrontmatter === true,
+      language: {
+        name: 'java',
+        label: 'Java',
+        fence: 'java',
+        requires: 'The SDK needs Java 17 or newer and the standard library only.',
+      },
+      sample: (op) => javaSample(op, { model, emit, outputPath: output.path }),
+      paginated: new Set(pagination?.keys() ?? []),
+    }),
+  },
+];
+
+export default {
+  name: 'java',
+  run: javaGenerator,
+  sample: javaSample,
+  docs: javaDocs,
+  errorModes: ["throw"],
+  notApplicable: {
+    "outputMode": "it always emits one self-contained file",
+    "runtime": "the runtime is always embedded in the generated file",
+    "argsStyle": "inputs follow the target language's own idiom",
+    "importExt": "the generated file has no relative imports"
+  },
+  requiresGenerator: '^0.8.1',
+};