@redocly/client-generator 0.3.7 → 0.4.0

package/lib/generators/php/index.js

@@ -0,0 +1,166 @@
+// The built-in `php` generator — the third non-TypeScript library entry, authored
+// with the language-neutral toolkit only (same dogfooding invariant as python/go,
+// pinned by the guard test). Output is a single PHP >= 8.1 file over the curl
+// extension: promoted-constructor classes with fromArray/toArray hydration, native
+// backed enums, match-based discriminator dispatchers, and a Client over the
+// embedded runtime. Exceptions are the error mode (`errorMode` does not apply).
+import { identifierFor, jsonSuccessSchema, paginationItemSchema, renderReferencePage, sseResponse, } from '@redocly/client-generator';
+import { PhpPrinter } from '@redocly/client-generator/printers/php';
+import { PHP_RUNTIME_SOURCE } from '@redocly/client-generator/runtime-sources';
+import { writeServers } from "./client.js";
+import { phpPaginationLiteral, phpSecurityLiteral } from "./descriptor.js";
+import { hydration, renderPhpModels } from "./models.js";
+import { methodIdents, methodName, PHP, phpString, propertyName } from "./naming.js";
+import { writePhpMethod } from "./operations.js";
+import { writePhpPaginationWrappers } from "./pagination.js";
+import { phpType } from "./types.js";
+export { renderPhpModels } from "./models.js";
+export { phpType } from "./types.js";
+/** Drop the standalone header (<?php, declare, namespace, leading comments) for stitching. */
+function stripPhpHeader(source) {
+    const lines = source.split('\n');
+    let start = 0;
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index].trim();
+        if (line.startsWith('namespace ')) {
+            start = index + 1;
+            break;
+        }
+    }
+    return lines.slice(start).join('\n').trim();
+}
+/** The whole generated file: namespace + models + embedded runtime + operations + Client. */
+export const phpGenerator = ({ model, output, banner, emit, pagination }) => {
+    const printer = new PhpPrinter();
+    const dateType = emit.dateType ?? 'string';
+    const namespace = identifierFor(model.title, { style: 'pascal', reserved: PHP });
+    printer.line('<?php');
+    printer.blank();
+    printer.line(`// Code generated by @redocly/client-generator (php) from ${phpString(model.title)} ${model.version}. DO NOT EDIT.`);
+    printer.line('// Regenerate with `redocly generate-client`. PHP >= 8.1, curl extension — zero Composer dependencies.');
+    printer.blank();
+    printer.line('declare(strict_types=1);');
+    printer.blank();
+    printer.line(`namespace ${namespace};`);
+    printer.blank();
+    printer.line(renderPhpModels(model, dateType));
+    writeServers(printer, model);
+    if (emit.runtime === 'module') {
+        // The runtime file re-declares this same namespace, so the require binds the
+        // exact names the inline stitching would have defined at this position.
+        printer.line('// ─── Runtime (a real file beside this one, written by the same run) ───');
+        printer.line("require_once __DIR__ . '/runtime.php';");
+        printer.blank();
+    }
+    else {
+        printer.line('// ─── Embedded runtime (@redocly/client-generator php runtime) ───');
+        printer.line(stripPhpHeader(PHP_RUNTIME_SOURCE));
+        printer.blank();
+    }
+    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();
+    for (const op of operations) {
+        const spec = pagination?.get(op.name)?.spec;
+        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('{', () => {
+        printer.line('public function __construct(private Config $config)');
+        printer.block('{', () => {
+            printer.block("if ($this->config->serverUrl === '') {", () => {
+                printer.line(`$this->config->serverUrl = ${phpString(emit.serverUrl ?? model.serverUrl ?? '')};`);
+            }, '}');
+        }, '}');
+        printer.blank();
+        for (const op of operations) {
+            const ident = idents.get(op.name);
+            writePhpMethod(printer, op, ident, model, dateType);
+            if (sseResponse(op) === undefined && (op.successResponseHeaders?.length ?? 0) > 0) {
+                writePhpMethod(printer, op, ident, model, dateType, true);
+            }
+            const rule = paginationRules.get(op.name);
+            if (rule === undefined)
+                continue;
+            const success = jsonSuccessSchema(op);
+            const pageHydration = success === undefined ? undefined : hydration(success, '$page', model, dateType);
+            const element = paginationItemSchema(success, rule.items, model);
+            const itemHydration = element === undefined ? undefined : hydration(element, '$item', model, dateType);
+            writePhpPaginationWrappers(printer, op, ident, model, dateType, pageHydration, itemHydration, rule.items, element === undefined ? 'mixed' : phpType(element, model, dateType));
+        }
+    }, '}');
+    const entry = { path: output.path.replace(/\.[^.\\/]+$/, '.php'), content: printer.toString() };
+    if (emit.runtime !== 'module')
+        return [entry];
+    // The runtime, verbatim except its namespace: rewritten to the client's, so one
+    // namespace spans both files and every bare reference resolves unchanged.
+    const header = banner.map((line) => `// ${line}`).join('\n');
+    const runtimeSource = PHP_RUNTIME_SOURCE.replace(/^namespace .*$/m, `namespace ${namespace};`)
+        .replace(/^<\?php\n/, `<?php\n\n${header}\n`)
+        .trimEnd();
+    return [
+        entry,
+        { path: entry.path.replace(/[^\\/]+$/, 'runtime.php'), content: `${runtimeSource}\n` },
+    ];
+};
+/** One idiomatic PHP call per operation — feeds `x-codeSamples` for docs. */
+export function phpSample(op, ctx) {
+    const args = [
+        ...op.pathParams.map((param) => `${phpString(`<${propertyName(param.name)}>`)}`),
+        ...(op.requestBody ? ['$body'] : []),
+        ...(op.queryParams.length > 0
+            ? [`${propertyName(op.queryParams[0].name)}: ${phpString('<value>')}`]
+            : []),
+    ];
+    const namespace = identifierFor(ctx.model.title, { style: 'pascal', reserved: PHP });
+    // The file this run writes, so the snippet requires something that exists.
+    const file = ctx.outputPath.replace(/^.*[\\/]/, '').replace(/\.[^.]+$/, '.php');
+    return {
+        lang: 'php',
+        label: 'PHP SDK',
+        source: `require '${file}';\n\nuse ${namespace}\\{Client, Config};\n\n$client = new Client(new Config());\n$result = $client->${methodIdents(ctx.model).get(op.name) ?? methodName(op)}(${args.join(', ')});\n`,
+    };
+}
+/**
+ * The SDK's own reference page, written when `client.docs` is on. The call snippets come
+ * from `phpSample` — 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 phpDocs = ({ model, output, emit, pagination }) => [
+    {
+        path: output.path.replace(/\.[^.\\/]+$/, '.php.md'),
+        content: renderReferencePage(model, {
+            title: `${model.title} PHP SDK reference`,
+            frontmatter: emit.docsFrontmatter === true,
+            language: {
+                name: 'php',
+                label: 'PHP',
+                fence: 'php',
+                requires: 'The SDK needs the curl extension.',
+            },
+            sample: (op) => phpSample(op, { model, emit, outputPath: output.path }),
+            paginated: new Set(pagination?.keys() ?? []),
+        }),
+    },
+];
+//# sourceMappingURL=index.js.map

package/lib/generators/php/index.js.map

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

package/lib/generators/php/models.d.ts

@@ -0,0 +1,8 @@
+import { type ApiModel, type DateType, type SchemaModel } from '@redocly/client-generator';
+/** Wire value → typed value expression, or undefined when the raw value is already right. */
+export declare function hydration(schema: SchemaModel, expr: string, model: ApiModel, dateType: DateType): string | undefined;
+/** Typed value → wire value expression, or undefined when it serializes as-is. */
+export declare function serialization(schema: SchemaModel, expr: string, model: ApiModel, dateType?: DateType): string | undefined;
+/** Render every named schema: classes (allOf flattened), native enums, union dispatchers. */
+export declare function renderPhpModels(model: ApiModel, dateType?: DateType): string;
+//# sourceMappingURL=models.d.ts.map

package/lib/generators/php/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/generators/php/models.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAMb,KAAK,WAAW,EAGjB,MAAM,2BAA2B,CAAC;AAYnC,6FAA6F;AAC7F,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAGf,QAAQ,EAAE,QAAQ,GACjB,MAAM,GAAG,SAAS,CA0BpB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EACf,QAAQ,GAAE,QAAmB,GAC5B,MAAM,GAAG,SAAS,CA8BpB;AA+FD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAE,QAAmB,GAAG,MAAM,CA2EtF"}

package/lib/generators/php/models.js

@@ -0,0 +1,200 @@
+// The `models` stage: named schemas as promoted-constructor classes with
+// fromArray/toArray hydration, native backed enums, and match-based union
+// dispatchers — plus the wire↔typed value expressions the methods reuse.
+import { deref, discriminatorCases, enumValues, flattenAllOf, uniqueIdentifiers, unwrapNullable, } from '@redocly/client-generator';
+import { PhpPrinter } from '@redocly/client-generator/printers/php';
+import { className, PHP, phpString, propertyName } from "./naming.js";
+import { classify, isDateFormat, phpNullable, phpType } from "./types.js";
+/** True when the named schema renders as an `unmarshalX` union dispatcher. */
+function isDiscriminatedUnion(name, model) {
+    const named = model.schemas.find((candidate) => candidate.name === name);
+    return named !== undefined && discriminatorCases(named.schema, model) !== undefined;
+}
+/** Wire value → typed value expression, or undefined when the raw value is already right. */
+export function hydration(schema, expr, model, 
+// Required on purpose: a defaulted `'string'` let a call site forget it, and the method
+// then returned a raw string where its own signature declared `\DateTimeImmutable`.
+dateType) {
+    const bare = unwrapNullable(schema);
+    if (dateType === 'Date' && bare.kind === 'scalar' && bare.scalar === 'string') {
+        if (isDateFormat(bare))
+            return `new \\DateTimeImmutable(${expr})`;
+    }
+    if (bare.kind === 'omit')
+        return hydration({ kind: 'ref', name: bare.base }, expr, model, dateType);
+    if (bare.kind === 'ref') {
+        const kind = classify(bare.name, model);
+        if (kind === 'class')
+            return `${className(bare.name)}::fromArray(${expr})`;
+        if (kind === 'enum')
+            return `${className(bare.name)}::from(${expr})`;
+        if (isDiscriminatedUnion(bare.name, model))
+            return `unmarshal${className(bare.name)}(${expr})`;
+        const target = deref(bare, model);
+        return target === undefined ? undefined : hydration(target, expr, model, dateType);
+    }
+    if (bare.kind === 'array') {
+        const item = hydration(bare.items, '$item', model, dateType);
+        if (item === undefined)
+            return undefined;
+        return `array_map(static fn ($item) => ${item}, ${expr})`;
+    }
+    if (bare.kind === 'record') {
+        const item = hydration(bare.value, '$item', model, dateType);
+        if (item === undefined)
+            return undefined;
+        return `array_map(static fn ($item) => ${item}, ${expr})`;
+    }
+    return undefined;
+}
+/** Typed value → wire value expression, or undefined when it serializes as-is. */
+export function serialization(schema, expr, model, dateType = 'string') {
+    const bare = unwrapNullable(schema);
+    if (dateType === 'Date' && bare.kind === 'scalar' && bare.scalar === 'string') {
+        // A date-only value must not gain a time component on the way out.
+        if (bare.metadata?.format === 'date')
+            return `${expr}->format('Y-m-d')`;
+        if (bare.metadata?.format === 'date-time') {
+            return `${expr}->format(\\DateTimeInterface::ATOM)`;
+        }
+    }
+    if (bare.kind === 'omit') {
+        return serialization({ kind: 'ref', name: bare.base }, expr, model, dateType);
+    }
+    if (bare.kind === 'ref') {
+        const kind = classify(bare.name, model);
+        if (kind === 'class')
+            return `${expr}->toArray()`;
+        if (kind === 'enum')
+            return `${expr}->value`;
+        // A union value may be a hydrated member instance or a raw (default-case) array.
+        if (isDiscriminatedUnion(bare.name, model)) {
+            return `is_object(${expr}) ? ${expr}->toArray() : ${expr}`;
+        }
+        const target = deref(bare, model);
+        return target === undefined ? undefined : serialization(target, expr, model, dateType);
+    }
+    if (bare.kind === 'array' || bare.kind === 'record') {
+        const inner = bare.kind === 'array' ? bare.items : bare.value;
+        const item = serialization(inner, '$item', model, dateType);
+        if (item === undefined)
+            return undefined;
+        return `array_map(static fn ($item) => ${item}, ${expr})`;
+    }
+    return undefined;
+}
+function writeClass(printer, name, properties, model, dateType, description) {
+    // PHP requires defaulted parameters after required ones.
+    const ordered = [
+        ...properties.filter((property) => property.required),
+        ...properties.filter((property) => !property.required),
+    ];
+    printer.doc(className(name), description);
+    printer.line(`final class ${className(name)}`);
+    printer.block('{', () => {
+        printer.block('public function __construct(', () => {
+            for (const property of ordered) {
+                const type = phpType(property.schema, model, dateType);
+                if (property.required) {
+                    printer.line(`public ${type} ${'$'}${propertyName(property.name)},`);
+                }
+                else {
+                    const nullable = phpNullable(type);
+                    printer.line(`public ${nullable} ${'$'}${propertyName(property.name)} = null,`);
+                }
+            }
+        }, ') {');
+        printer.line('}');
+        printer.blank();
+        printer.line('public static function fromArray(array $data): self');
+        printer.block('{', () => {
+            printer.block('return new self(', () => {
+                for (const property of ordered) {
+                    const raw = `$data[${phpString(property.name)}]`;
+                    const typed = hydration(property.schema, raw, model, dateType);
+                    const php = propertyName(property.name);
+                    if (property.required) {
+                        printer.line(`${php}: ${typed ?? raw},`);
+                    }
+                    else if (typed === undefined) {
+                        printer.line(`${php}: ${raw} ?? null,`);
+                    }
+                    else {
+                        printer.line(`${php}: isset(${raw}) ? ${typed} : null,`);
+                    }
+                }
+            }, ');');
+        }, '}');
+        printer.blank();
+        printer.line('public function toArray(): array');
+        printer.block('{', () => {
+            printer.line('$data = [];');
+            for (const property of ordered) {
+                const value = `$this->${propertyName(property.name)}`;
+                const wire = serialization(property.schema, value, model, dateType) ?? value;
+                if (property.required) {
+                    printer.line(`$data[${phpString(property.name)}] = ${wire};`);
+                }
+                else {
+                    printer.block(`if (${value} !== null) {`, () => {
+                        printer.line(`$data[${phpString(property.name)}] = ${wire};`);
+                    }, '}');
+                }
+            }
+            printer.line('return $data;');
+        }, '}');
+    }, '}');
+    printer.blank();
+}
+/** Render every named schema: classes (allOf flattened), native enums, union dispatchers. */
+export function renderPhpModels(model, dateType = 'string') {
+    const printer = new PhpPrinter();
+    for (const { name, schema } of model.schemas) {
+        const asEnum = enumValues(schema);
+        if (asEnum !== undefined && (asEnum.scalar === 'string' || asEnum.scalar === 'integer')) {
+            const backing = asEnum.scalar === 'string' ? 'string' : 'int';
+            printer.doc(className(name), schema.description);
+            printer.line(`enum ${className(name)}: ${backing}`);
+            printer.block('{', () => {
+                // `1.5` and `15` fold to one pascal name; PHP rejects a duplicate case.
+                const members = uniqueIdentifiers(asEnum.values.map((value) => String(value)), { style: 'pascal', reserved: PHP });
+                asEnum.values.forEach((value, index) => {
+                    const literal = typeof value === 'string' ? phpString(value) : String(value);
+                    printer.line(`case ${members[index]} = ${literal};`);
+                });
+            }, '}');
+            printer.blank();
+            continue;
+        }
+        if (schema.kind === 'object' || schema.kind === 'intersection') {
+            const flat = flattenAllOf(schema, model);
+            if (flat !== undefined) {
+                writeClass(printer, name, flat.properties, model, dateType, flat.description ?? schema.description);
+                continue;
+            }
+        }
+        const cases = discriminatorCases(schema, model);
+        if (cases !== undefined) {
+            const typeName = className(name);
+            const table = cases.cases
+                .map((entry) => `${entry.value} -> ${className(entry.schemaName)}`)
+                .join(', ');
+            printer.line(`/** ${typeName} is a discriminated union (${phpString(cases.property)}): ${table}. */`);
+            printer.line(`function unmarshal${typeName}(array $data): mixed`);
+            printer.block('{', () => {
+                printer.block(`return match ($data[${phpString(cases.property)}] ?? null) {`, () => {
+                    for (const entry of cases.cases) {
+                        printer.line(`${phpString(entry.value)} => ${className(entry.schemaName)}::fromArray($data),`);
+                    }
+                    printer.line('default => $data,');
+                }, '};');
+            }, '}');
+            printer.blank();
+            continue;
+        }
+        // Everything else (plain unions, aliases, records) has no PHP declaration;
+        // references resolve to the underlying type via phpType.
+    }
+    return printer.toString();
+}
+//# sourceMappingURL=models.js.map

package/lib/generators/php/models.js.map

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

package/lib/generators/php/naming.d.ts

@@ -0,0 +1,16 @@
+import { type ApiModel, type OperationModel } from '@redocly/client-generator';
+import { PhpPrinter } from '@redocly/client-generator/printers/php';
+export declare const PHP: ReadonlySet<string>;
+export declare const naming: PhpPrinter;
+export declare function className(name: string): string;
+export declare function propertyName(name: string): string;
+/** `'…'` with backslashes and quotes escaped — safe for any spec-supplied text. */
+export declare function phpString(value: string): string;
+export declare function methodName(op: OperationModel): string;
+/**
+ * The method name for every operation, unique across the client — PHP fatals on a
+ * redeclared method, and two operationIds may camel-case to one name (`get-user`,
+ * `getUser`). Keyed by the IR name, which the sanitizer already made unique.
+ */
+export declare function methodIdents(model: ApiModel): Map<string, string>;
+//# sourceMappingURL=naming.d.ts.map

package/lib/generators/php/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../src/generators/php/naming.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,cAAc,EAGpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEpE,eAAO,MAAM,GAAG,qBAAqB,CAAC;AAGtC,eAAO,MAAM,MAAM,YAAmB,CAAC;AAEvC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjE"}

package/lib/generators/php/naming.js

@@ -0,0 +1,31 @@
+// The `naming` stage: the shared printer/naming instance, the string escaper, and
+// the collision-free class/property/method identifiers every other stage builds on.
+import { identifierFor, RESERVED_WORDS, uniqueIdentifiers, } from '@redocly/client-generator';
+import { PhpPrinter } from '@redocly/client-generator/printers/php';
+export const PHP = RESERVED_WORDS.php;
+// Naming and escaping delegate to the printer — one implementation, one policy.
+export const naming = new PhpPrinter();
+export function className(name) {
+    return naming.typeName(name);
+}
+export function propertyName(name) {
+    return naming.memberName(name);
+}
+/** `'…'` with backslashes and quotes escaped — safe for any spec-supplied text. */
+export function phpString(value) {
+    return naming.string(value);
+}
+export function methodName(op) {
+    return identifierFor(op.name, { style: 'camel', reserved: PHP });
+}
+/**
+ * The method name for every operation, unique across the client — PHP fatals on a
+ * redeclared method, and two operationIds may camel-case to one name (`get-user`,
+ * `getUser`). Keyed by the IR name, which the sanitizer already made unique.
+ */
+export function methodIdents(model) {
+    const operations = model.services.flatMap((service) => service.operations);
+    const names = uniqueIdentifiers(operations.map((op) => op.name), { style: 'camel', reserved: PHP });
+    return new Map(operations.map((op, index) => [op.name, names[index]]));
+}
+//# sourceMappingURL=naming.js.map

package/lib/generators/php/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../src/generators/php/naming.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AAEpF,OAAO,EAEL,aAAa,EAEb,cAAc,EACd,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEpE,MAAM,CAAC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC;AAEtC,gFAAgF;AAChF,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;AAEvC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAkB;IAC3C,OAAO,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,iBAAiB,CAC7B,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAC/B,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAClC,CAAC;IACF,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/lib/generators/php/operations.d.ts

@@ -0,0 +1,21 @@
+import { type ApiModel, type DateType, type OperationModel } from '@redocly/client-generator';
+import type { PhpPrinter } from '@redocly/client-generator/printers/php';
+type MethodArgs = {
+    pathArgs: Array<{
+        php: string;
+        wire: string;
+        type: string;
+    }>;
+    /** `value` is the expression to send: a date object formats itself, everything else is the variable. */
+    queryArgs: Array<{
+        php: string;
+        wire: string;
+        type: string;
+        value: string;
+    }>;
+    signature: string[];
+};
+export declare function methodArgs(op: OperationModel, model: ApiModel, includeBody: boolean, dateType: DateType): MethodArgs;
+export declare function writePhpMethod(printer: PhpPrinter, op: OperationModel, ident: string, model: ApiModel, dateType: DateType, envelope?: boolean): void;
+export {};
+//# sourceMappingURL=operations.d.ts.map

package/lib/generators/php/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/generators/php/operations.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAGb,KAAK,cAAc,EAGpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AASzE,KAAK,UAAU,GAAG;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,wGAAwG;IACxG,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAQF,wBAAgB,UAAU,CACxB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,QAAQ,GACjB,UAAU,CAwCZ;AA+BD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EACnB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,QAAQ,UAAQ,GACf,IAAI,CA8GN"}