@redocly/cli 2.58.0 → 2.58.2

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "mock" 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 mock --update`.
@@ -31,5 +31,5 @@ export default {
   name: 'mock',
   run: mockGenerator,
   requires: ["typescript"],
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "mock" 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 mock --update`.

package/lib/eject-assets/generators/mock/sample.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "mock" 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 mock --update`.

package/lib/eject-assets/generators/mock/values.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "mock" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "mock" 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 mock --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.
@@ -90,33 +90,34 @@ export const phpGenerator: Generator = ({ model, output, banner, emit, paginatio
     if (spec !== undefined) paginationRules.set(op.name, spec);
   }
 
-  printer.block(
-    'const OPERATIONS = [',
-    () => {
-      for (const op of operations) {
-        const id = op.specName ?? op.name;
-        const security = phpSecurityLiteral(op, model);
-        const rule = paginationRules.get(op.name);
-        const fields = [
-          `'id' => ${phpString(id)}`,
-          `'method' => ${phpString(op.method.toUpperCase())}`,
-          `'path' => ${phpString(op.path)}`,
-          ...(security !== undefined ? [`'security' => ${security}`] : []),
-          ...(rule !== undefined ? [`'pagination' => ${phpPaginationLiteral(rule)}`] : []),
-        ];
-        printer.line(`${phpString(id)} => [${fields.join(', ')}],`);
-      }
-    },
-    '];'
-  );
-  printer.blank();
-
   printer.doc('Client', `Client for ${model.title} (${model.version}).`);
   // Not final: PHP test suites mock concrete classes (createMock(Client::class)).
   printer.line('class Client');
   printer.block(
     '{',
     () => {
+      // A class constant, not a file-level one: OPcache preload keeps classes but drops
+      // file-level constants, and the file is never included again once Client exists.
+      printer.block(
+        'public const OPERATIONS = [',
+        () => {
+          for (const op of operations) {
+            const id = op.specName ?? op.name;
+            const security = phpSecurityLiteral(op, model);
+            const rule = paginationRules.get(op.name);
+            const fields = [
+              `'id' => ${phpString(id)}`,
+              `'method' => ${phpString(op.method.toUpperCase())}`,
+              `'path' => ${phpString(op.path)}`,
+              ...(security !== undefined ? [`'security' => ${security}`] : []),
+              ...(rule !== undefined ? [`'pagination' => ${phpPaginationLiteral(rule)}`] : []),
+            ];
+            printer.line(`${phpString(id)} => [${fields.join(', ')}],`);
+          }
+        },
+        '];'
+      );
+      printer.blank();
       printer.line('public function __construct(private Config $config)');
       printer.block(
         '{',
@@ -233,5 +234,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.
@@ -85,7 +85,7 @@ export function methodArgs(
 
 /** The shared prologue: resolve auth, build query/url, merge headers. */
 function writeRequestSetup(printer: PhpPrinter, op: OperationModel, args: MethodArgs): void {
-  printer.line(`$op = OPERATIONS[${phpString(op.specName ?? op.name)}];`);
+  printer.line(`$op = self::OPERATIONS[${phpString(op.specName ?? op.name)}];`);
   printer.line(
     "[$authHeaders, $query, $cookies] = resolveAuth($op['security'] ?? [], $this->config->auth);"
   );

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.
@@ -33,7 +33,7 @@ export function writePhpPaginationWrappers(
   const name = ident;
 
   const writeCall = () => {
-    printer.line(`$op = OPERATIONS[${phpString(op.specName ?? op.name)}];`);
+    printer.line(`$op = self::OPERATIONS[${phpString(op.specName ?? op.name)}];`);
     printer.line('$base = [];');
     for (const { php, wire, value } of args.queryArgs) {
       printer.block(

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "php" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "php" 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 php --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.
@@ -247,5 +247,5 @@ export default {
     "argsStyle": "inputs follow the target language's own idiom",
     "importExt": "the generated file has no relative imports"
   },
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "python" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "python" 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 python --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "swr" 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 swr --update`.
@@ -33,5 +33,5 @@ export default {
   run: swrGenerator,
   requires: ["typescript"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "swr" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "swr" 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 swr --update`.

package/lib/eject-assets/generators/tanstack-query/index.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "tanstack-query" 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 tanstack-query --update`.
@@ -44,5 +44,5 @@ export default {
   run: tanstackQueryGenerator('react'),
   requires: ["typescript"],
   errorModes: ["throw"],
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

package/lib/eject-assets/generators/tanstack-query/render.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "tanstack-query" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "tanstack-query" 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 tanstack-query --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "transformers" 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 transformers --update`.
@@ -42,5 +42,5 @@ export default {
   run: transformersGenerator,
   requires: ["typescript"],
   dateTypes: ["Date"],
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "transformers" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "transformers" 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 transformers --update`.

package/lib/eject-assets/generators/typescript/banner.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.
@@ -97,5 +97,5 @@ export default {
   run: typescriptGenerator,
   sample: typescriptSample,
   docs: typescriptDocs,
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

package/lib/eject-assets/generators/typescript/inline-runtime.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

package/lib/eject-assets/generators/typescript/operation-signature.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

package/lib/eject-assets/generators/typescript/operation-types.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

package/lib/eject-assets/generators/typescript/response-headers.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

package/lib/eject-assets/generators/typescript/type-guards.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "typescript" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "typescript" 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 typescript --update`.

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

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "zod" 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 zod --update`.
@@ -28,5 +28,5 @@ export const zodGenerator: Generator = ({ model, output, banner }) => {
 export default {
   name: 'zod',
   run: zodGenerator,
-  requiresGenerator: '^0.4.21',
+  requiresGenerator: '^0.4.23',
 };

package/lib/eject-assets/generators/zod/schemas.ts

@@ -1,4 +1,4 @@
-// Ejected from @redocly/client-generator@0.4.21 — the built-in "zod" generator.
+// Ejected from @redocly/client-generator@0.4.23 — the built-in "zod" 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 zod --update`.

package/lib/eject-assets/skills/php-generator/SKILL.md

@@ -33,6 +33,11 @@ extension — zero Composer dependencies. The namespace derives from the API tit
   `uniqueIdentifiers(..., { taken: … })`: OpenAPI lets one operation use a name in two
   locations (`id` in the path AND in the query), and PHP rejects a redefined parameter outright. The
   wire name is untouched, so the request is unchanged.
+- **The operation map is a class constant, `Client::OPERATIONS`,** read through
+  `self::OPERATIONS[...]`, never a file-level `const`. OPcache preload keeps classes and
+  functions in shared memory but drops file-level constants, and an autoloader never
+  includes the file again once `Client` exists — so a file-level map is undefined on every
+  request after the first. A class constant is stored with the class.
 - **Naming:** classes PascalCase, properties/methods camelCase via
   `identifierFor(..., RESERVED_WORDS.php)`; reserved words get a trailing underscore.
 - **Enums** are native backed enums (string/int); other scalars stay aliases.