@webpieces/openapi-generator 0.0.1

package/src/manifest/JsonReader.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonReader = void 0;
+const OpenApiGenerationError_1 = require("../OpenApiGenerationError");
+/**
+ * A narrowing reader over ONE parsed JSON object.
+ *
+ * ## Why this class exists at all
+ *
+ * `JSON.parse` returns something with no shape, and a loader that passed that shapelessness around
+ * would spread it over every method that touches the manifest. Concentrating it HERE means the rest
+ * of the package deals only in `string`, `JsonReader` and the manifest classes — and it means the
+ * "this value came off disk and has not been checked yet" state exists in exactly one file, where a
+ * reader can see every check that state is subjected to.
+ *
+ * ## Every miss is a HARD FAILURE naming the field
+ *
+ * There is deliberately no defaulting of anything a reader would notice. A published document quietly
+ * missing a section is indistinguishable, from the outside, from an API that genuinely has no error
+ * contract — so a mistyped `errors` must stop the run rather than silently publish less.
+ */
+class JsonReader {
+    entries;
+    where;
+    constructor(
+    // webpieces-disable no-any-unknown -- parsed JSON is genuinely shapeless until the accessors below narrow it; this is the ONE place that state exists
+    entries, 
+    /** The file this came from, so every failure names something somebody can open. */
+    where) {
+        this.entries = entries;
+        this.where = where;
+    }
+    /** Parse a whole file. */
+    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what keeps unchecked JSON out of every other file
+    static parseFile(text, where) {
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- re-thrown as the ONE error type of this package, with its cure
+        try {
+            // webpieces-disable no-any-unknown -- JSON.parse's result, before anything has narrowed it
+            const parsed = JSON.parse(text);
+            return JsonReader.of(parsed, where, 'the manifest');
+        }
+        catch (err) {
+            //const error = toError(err);
+            if (err instanceof OpenApiGenerationError_1.OpenApiGenerationError) {
+                throw err;
+            }
+            throw new OpenApiGenerationError_1.OpenApiGenerationError(`not valid JSON: ${err instanceof Error ? err.message : String(err)}`, where, 'Fix the JSON syntax. The manifest is read before anything else runs.');
+        }
+    }
+    /** One already-parsed value that must be an object. */
+    // webpieces-disable no-any-unknown -- the value has not been narrowed yet; that is this method's job
+    // webpieces-disable no-function-outside-class -- static factory of this class
+    static of(value, where, what) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            throw new OpenApiGenerationError_1.OpenApiGenerationError(`${what} is not a JSON object`, where, 'Write it as a JSON object — one `{ ... }` with named fields.');
+        }
+        return new JsonReader(new Map(Object.entries(value)), where);
+    }
+    has(field) {
+        return this.entries.get(field) !== undefined;
+    }
+    /** A required, non-empty string. */
+    string(field) {
+        const value = this.optionalString(field);
+        if (value === undefined) {
+            throw new OpenApiGenerationError_1.OpenApiGenerationError(`'${field}' is missing or is not a non-empty string`, this.where, `Give "${field}" a value; an empty one publishes a document nobody can identify.`);
+        }
+        return value;
+    }
+    optionalString(field) {
+        // webpieces-disable no-any-unknown -- the raw entry, narrowed on the next line
+        const value = this.entries.get(field);
+        return typeof value === 'string' && value !== '' ? value : undefined;
+    }
+    /** An array of strings, empty when the field is absent. */
+    strings(field) {
+        // webpieces-disable no-any-unknown -- the raw entry, narrowed below
+        const value = this.entries.get(field);
+        if (value === undefined) {
+            return [];
+        }
+        // webpieces-disable no-any-unknown -- element of a not-yet-narrowed array
+        if (!Array.isArray(value) || value.some((each) => typeof each !== 'string')) {
+            throw new OpenApiGenerationError_1.OpenApiGenerationError(`'${field}' is not an array of strings`, this.where, `Write "${field}" as a JSON array of strings, or leave it out.`);
+        }
+        return value;
+    }
+    /** A nested object, or undefined when the field is absent. */
+    object(field) {
+        // webpieces-disable no-any-unknown -- the raw entry, narrowed by `of`
+        const value = this.entries.get(field);
+        return value === undefined ? undefined : JsonReader.of(value, this.where, `'${field}'`);
+    }
+    /** An array of objects, empty when the field is absent. */
+    objects(field) {
+        // webpieces-disable no-any-unknown -- the raw entry, narrowed below
+        const value = this.entries.get(field);
+        if (value === undefined) {
+            return [];
+        }
+        if (!Array.isArray(value)) {
+            throw new OpenApiGenerationError_1.OpenApiGenerationError(`'${field}' is not an array`, this.where, `Write "${field}" as a JSON array, or leave it out.`);
+        }
+        // webpieces-disable no-any-unknown -- element of a not-yet-narrowed array
+        return value.map((each) => JsonReader.of(each, this.where, `an entry of '${field}'`));
+    }
+}
+exports.JsonReader = JsonReader;
+//# sourceMappingURL=JsonReader.js.map

package/src/manifest/JsonReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonReader.js","sourceRoot":"","sources":["../../../../../../packages/docs/openapi-generator/src/manifest/JsonReader.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenApiGenerationError } from '../OpenApiGenerationError';\n\n/**\n * A narrowing reader over ONE parsed JSON object.\n *\n * ## Why this class exists at all\n *\n * `JSON.parse` returns something with no shape, and a loader that passed that shapelessness around\n * would spread it over every method that touches the manifest. Concentrating it HERE means the rest\n * of the package deals only in `string`, `JsonReader` and the manifest classes — and it means the\n * \"this value came off disk and has not been checked yet\" state exists in exactly one file, where a\n * reader can see every check that state is subjected to.\n *\n * ## Every miss is a HARD FAILURE naming the field\n *\n * There is deliberately no defaulting of anything a reader would notice. A published document quietly\n * missing a section is indistinguishable, from the outside, from an API that genuinely has no error\n * contract — so a mistyped `errors` must stop the run rather than silently publish less.\n */\nexport class JsonReader {\n    private constructor(\n        // webpieces-disable no-any-unknown -- parsed JSON is genuinely shapeless until the accessors below narrow it; this is the ONE place that state exists\n        private readonly entries: ReadonlyMap<string, unknown>,\n        /** The file this came from, so every failure names something somebody can open. */\n        readonly where: string,\n    ) {}\n\n    /** Parse a whole file. */\n    // webpieces-disable no-function-outside-class -- static factory; the private constructor is what keeps unchecked JSON out of every other file\n    static parseFile(text: string, where: string): JsonReader {\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- re-thrown as the ONE error type of this package, with its cure\n        try {\n            // webpieces-disable no-any-unknown -- JSON.parse's result, before anything has narrowed it\n            const parsed: unknown = JSON.parse(text);\n            return JsonReader.of(parsed, where, 'the manifest');\n        } catch (err: unknown) {\n            //const error = toError(err);\n            if (err instanceof OpenApiGenerationError) {\n                throw err;\n            }\n            throw new OpenApiGenerationError(\n                `not valid JSON: ${err instanceof Error ? err.message : String(err)}`,\n                where,\n                'Fix the JSON syntax. The manifest is read before anything else runs.',\n            );\n        }\n    }\n\n    /** One already-parsed value that must be an object. */\n    // webpieces-disable no-any-unknown -- the value has not been narrowed yet; that is this method's job\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    private static of(value: unknown, where: string, what: string): JsonReader {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            throw new OpenApiGenerationError(\n                `${what} is not a JSON object`,\n                where,\n                'Write it as a JSON object — one `{ ... }` with named fields.',\n            );\n        }\n        return new JsonReader(new Map(Object.entries(value)), where);\n    }\n\n    has(field: string): boolean {\n        return this.entries.get(field) !== undefined;\n    }\n\n    /** A required, non-empty string. */\n    string(field: string): string {\n        const value = this.optionalString(field);\n        if (value === undefined) {\n            throw new OpenApiGenerationError(\n                `'${field}' is missing or is not a non-empty string`,\n                this.where,\n                `Give \"${field}\" a value; an empty one publishes a document nobody can identify.`,\n            );\n        }\n        return value;\n    }\n\n    optionalString(field: string): string | undefined {\n        // webpieces-disable no-any-unknown -- the raw entry, narrowed on the next line\n        const value: unknown = this.entries.get(field);\n        return typeof value === 'string' && value !== '' ? value : undefined;\n    }\n\n    /** An array of strings, empty when the field is absent. */\n    strings(field: string): readonly string[] {\n        // webpieces-disable no-any-unknown -- the raw entry, narrowed below\n        const value: unknown = this.entries.get(field);\n        if (value === undefined) {\n            return [];\n        }\n        // webpieces-disable no-any-unknown -- element of a not-yet-narrowed array\n        if (!Array.isArray(value) || value.some((each: unknown) => typeof each !== 'string')) {\n            throw new OpenApiGenerationError(\n                `'${field}' is not an array of strings`,\n                this.where,\n                `Write \"${field}\" as a JSON array of strings, or leave it out.`,\n            );\n        }\n        return value as readonly string[];\n    }\n\n    /** A nested object, or undefined when the field is absent. */\n    object(field: string): JsonReader | undefined {\n        // webpieces-disable no-any-unknown -- the raw entry, narrowed by `of`\n        const value: unknown = this.entries.get(field);\n        return value === undefined ? undefined : JsonReader.of(value, this.where, `'${field}'`);\n    }\n\n    /** An array of objects, empty when the field is absent. */\n    objects(field: string): readonly JsonReader[] {\n        // webpieces-disable no-any-unknown -- the raw entry, narrowed below\n        const value: unknown = this.entries.get(field);\n        if (value === undefined) {\n            return [];\n        }\n        if (!Array.isArray(value)) {\n            throw new OpenApiGenerationError(\n                `'${field}' is not an array`,\n                this.where,\n                `Write \"${field}\" as a JSON array, or leave it out.`,\n            );\n        }\n        // webpieces-disable no-any-unknown -- element of a not-yet-narrowed array\n        return value.map((each: unknown) =>\n            JsonReader.of(each, this.where, `an entry of '${field}'`),\n        );\n    }\n}\n"]}

package/src/manifest/ManifestLoader.d.ts

@@ -0,0 +1,20 @@
+import { OpenApiManifest } from './OpenApiManifest';
+/**
+ * Read `openapi.manifest.json` into {@link OpenApiManifest}.
+ *
+ * It deals only in {@link JsonReader}, which is where the "came off disk, not yet checked" state is
+ * concentrated — so nothing in this file, or anywhere downstream, handles an unnarrowed value.
+ *
+ * Every rejection is a HARD FAILURE naming the field. A published document quietly missing a section
+ * is indistinguishable, from outside, from an API that genuinely has no error contract.
+ */
+export declare class ManifestLoader {
+    /** @param manifestPath absolute path to `openapi.manifest.json`. */
+    load(manifestPath: string): OpenApiManifest;
+    private servers;
+    private apis;
+    private errors;
+    private responseHeaders;
+    /** A manifest-relative path, resolved against the manifest's own directory. */
+    resolve(manifestPath: string, relative: string): string;
+}

package/src/manifest/ManifestLoader.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManifestLoader = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("node:fs"));
+const path = tslib_1.__importStar(require("node:path"));
+const OpenApiGenerationError_1 = require("../OpenApiGenerationError");
+const JsonReader_1 = require("./JsonReader");
+const OpenApiManifest_1 = require("./OpenApiManifest");
+/** The only `kind` an api entry may declare. Anything else is a typo, and typos are refused. */
+const WEBHOOK = 'webhook';
+/**
+ * Read `openapi.manifest.json` into {@link OpenApiManifest}.
+ *
+ * It deals only in {@link JsonReader}, which is where the "came off disk, not yet checked" state is
+ * concentrated — so nothing in this file, or anywhere downstream, handles an unnarrowed value.
+ *
+ * Every rejection is a HARD FAILURE naming the field. A published document quietly missing a section
+ * is indistinguishable, from outside, from an API that genuinely has no error contract.
+ */
+class ManifestLoader {
+    /** @param manifestPath absolute path to `openapi.manifest.json`. */
+    load(manifestPath) {
+        if (!fs.existsSync(manifestPath)) {
+            throw new OpenApiGenerationError_1.OpenApiGenerationError('no manifest at this path', manifestPath, 'Pass --manifest pointing at an openapi.manifest.json that exists.');
+        }
+        const raw = JsonReader_1.JsonReader.parseFile(fs.readFileSync(manifestPath, 'utf8'), manifestPath);
+        return new OpenApiManifest_1.OpenApiManifest(raw.string('title'), raw.string('version'), this.servers(raw), raw.optionalString('descriptionFile'), this.apis(raw), raw.strings('securitySchemeNames'), this.errors(raw), this.responseHeaders(raw));
+    }
+    servers(raw) {
+        return raw
+            .objects('servers')
+            .map((server) => new OpenApiManifest_1.ServerEntry(server.string('url'), server.optionalString('description')));
+    }
+    apis(raw) {
+        const entries = raw
+            .objects('apis')
+            .map((api) => new OpenApiManifest_1.ApiEntry(api.string('entry'), api.string('tag'), api.optionalString('kind')));
+        if (entries.length === 0) {
+            throw new OpenApiGenerationError_1.OpenApiGenerationError("'apis' is empty", raw.where, 'List at least one contract; a document with no operations publishes nothing.');
+        }
+        for (const entry of entries) {
+            if (entry.kind !== undefined && entry.kind !== WEBHOOK) {
+                throw new OpenApiGenerationError_1.OpenApiGenerationError(`unknown api kind '${entry.kind}' on '${entry.entry}'`, raw.where, `The only declared kind is "${WEBHOOK}". Leave it out for an ordinary contract.`);
+            }
+        }
+        return entries;
+    }
+    errors(raw) {
+        const errors = raw.object('errors');
+        if (errors === undefined) {
+            return undefined;
+        }
+        return new OpenApiManifest_1.ErrorsEntry(errors.string('entry'), errors.string('type'), errors
+            .objects('responses')
+            .map((response) => new OpenApiManifest_1.ErrorResponseEntry(response.string('status'), response.string('description'))));
+    }
+    responseHeaders(raw) {
+        return raw
+            .objects('responseHeaders')
+            .map((header) => new OpenApiManifest_1.ResponseHeaderEntry(header.string('entry'), header.string('nameConstant'), header.optionalString('description')));
+    }
+    /** A manifest-relative path, resolved against the manifest's own directory. */
+    resolve(manifestPath, relative) {
+        return path.resolve(path.dirname(manifestPath), relative);
+    }
+}
+exports.ManifestLoader = ManifestLoader;
+//# sourceMappingURL=ManifestLoader.js.map

package/src/manifest/ManifestLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestLoader.js","sourceRoot":"","sources":["../../../../../../packages/docs/openapi-generator/src/manifest/ManifestLoader.ts"],"names":[],"mappings":";;;;AAAA,oDAA8B;AAC9B,wDAAkC;AAClC,sEAAmE;AACnE,6CAA0C;AAC1C,uDAO2B;AAE3B,gGAAgG;AAChG,MAAM,OAAO,GAAG,SAAS,CAAC;AAE1B;;;;;;;;GAQG;AACH,MAAa,cAAc;IACvB,oEAAoE;IACpE,IAAI,CAAC,YAAoB;QACrB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,+CAAsB,CAC5B,0BAA0B,EAC1B,YAAY,EACZ,mEAAmE,CACtE,CAAC;QACN,CAAC;QACD,MAAM,GAAG,GAAG,uBAAU,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;QACtF,OAAO,IAAI,iCAAe,CACtB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EACnB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EACjB,GAAG,CAAC,cAAc,CAAC,iBAAiB,CAAC,EACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EACd,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAChB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAC5B,CAAC;IACN,CAAC;IAEO,OAAO,CAAC,GAAe;QAC3B,OAAO,GAAG;aACL,OAAO,CAAC,SAAS,CAAC;aAClB,GAAG,CACA,CAAC,MAAkB,EAAE,EAAE,CACnB,IAAI,6BAAW,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAClF,CAAC;IACV,CAAC;IAEO,IAAI,CAAC,GAAe;QACxB,MAAM,OAAO,GAAG,GAAG;aACd,OAAO,CAAC,MAAM,CAAC;aACf,GAAG,CACA,CAAC,GAAe,EAAE,EAAE,CAChB,IAAI,0BAAQ,CACR,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EACnB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EACjB,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAC7B,CACR,CAAC;QACN,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,+CAAsB,CAC5B,iBAAiB,EACjB,GAAG,CAAC,KAAK,EACT,8EAA8E,CACjF,CAAC;QACN,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrD,MAAM,IAAI,+CAAsB,CAC5B,qBAAqB,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,KAAK,GAAG,EACtD,GAAG,CAAC,KAAK,EACT,8BAA8B,OAAO,2CAA2C,CACnF,CAAC;YACN,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,GAAe;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,6BAAW,CAClB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EACtB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM;aACD,OAAO,CAAC,WAAW,CAAC;aACpB,GAAG,CACA,CAAC,QAAoB,EAAE,EAAE,CACrB,IAAI,oCAAkB,CAClB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EACzB,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CACjC,CACR,CACR,CAAC;IACN,CAAC;IAEO,eAAe,CAAC,GAAe;QACnC,OAAO,GAAG;aACL,OAAO,CAAC,iBAAiB,CAAC;aAC1B,GAAG,CACA,CAAC,MAAkB,EAAE,EAAE,CACnB,IAAI,qCAAmB,CACnB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EACtB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,EAC7B,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CACvC,CACR,CAAC;IACV,CAAC;IAED,+EAA+E;IAC/E,OAAO,CAAC,YAAoB,EAAE,QAAgB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACJ;AAnGD,wCAmGC","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { OpenApiGenerationError } from '../OpenApiGenerationError';\nimport { JsonReader } from './JsonReader';\nimport {\n    ApiEntry,\n    ErrorResponseEntry,\n    ErrorsEntry,\n    OpenApiManifest,\n    ResponseHeaderEntry,\n    ServerEntry,\n} from './OpenApiManifest';\n\n/** The only `kind` an api entry may declare. Anything else is a typo, and typos are refused. */\nconst WEBHOOK = 'webhook';\n\n/**\n * Read `openapi.manifest.json` into {@link OpenApiManifest}.\n *\n * It deals only in {@link JsonReader}, which is where the \"came off disk, not yet checked\" state is\n * concentrated — so nothing in this file, or anywhere downstream, handles an unnarrowed value.\n *\n * Every rejection is a HARD FAILURE naming the field. A published document quietly missing a section\n * is indistinguishable, from outside, from an API that genuinely has no error contract.\n */\nexport class ManifestLoader {\n    /** @param manifestPath absolute path to `openapi.manifest.json`. */\n    load(manifestPath: string): OpenApiManifest {\n        if (!fs.existsSync(manifestPath)) {\n            throw new OpenApiGenerationError(\n                'no manifest at this path',\n                manifestPath,\n                'Pass --manifest pointing at an openapi.manifest.json that exists.',\n            );\n        }\n        const raw = JsonReader.parseFile(fs.readFileSync(manifestPath, 'utf8'), manifestPath);\n        return new OpenApiManifest(\n            raw.string('title'),\n            raw.string('version'),\n            this.servers(raw),\n            raw.optionalString('descriptionFile'),\n            this.apis(raw),\n            raw.strings('securitySchemeNames'),\n            this.errors(raw),\n            this.responseHeaders(raw),\n        );\n    }\n\n    private servers(raw: JsonReader): readonly ServerEntry[] {\n        return raw\n            .objects('servers')\n            .map(\n                (server: JsonReader) =>\n                    new ServerEntry(server.string('url'), server.optionalString('description')),\n            );\n    }\n\n    private apis(raw: JsonReader): readonly ApiEntry[] {\n        const entries = raw\n            .objects('apis')\n            .map(\n                (api: JsonReader) =>\n                    new ApiEntry(\n                        api.string('entry'),\n                        api.string('tag'),\n                        api.optionalString('kind'),\n                    ),\n            );\n        if (entries.length === 0) {\n            throw new OpenApiGenerationError(\n                \"'apis' is empty\",\n                raw.where,\n                'List at least one contract; a document with no operations publishes nothing.',\n            );\n        }\n        for (const entry of entries) {\n            if (entry.kind !== undefined && entry.kind !== WEBHOOK) {\n                throw new OpenApiGenerationError(\n                    `unknown api kind '${entry.kind}' on '${entry.entry}'`,\n                    raw.where,\n                    `The only declared kind is \"${WEBHOOK}\". Leave it out for an ordinary contract.`,\n                );\n            }\n        }\n        return entries;\n    }\n\n    private errors(raw: JsonReader): ErrorsEntry | undefined {\n        const errors = raw.object('errors');\n        if (errors === undefined) {\n            return undefined;\n        }\n        return new ErrorsEntry(\n            errors.string('entry'),\n            errors.string('type'),\n            errors\n                .objects('responses')\n                .map(\n                    (response: JsonReader) =>\n                        new ErrorResponseEntry(\n                            response.string('status'),\n                            response.string('description'),\n                        ),\n                ),\n        );\n    }\n\n    private responseHeaders(raw: JsonReader): readonly ResponseHeaderEntry[] {\n        return raw\n            .objects('responseHeaders')\n            .map(\n                (header: JsonReader) =>\n                    new ResponseHeaderEntry(\n                        header.string('entry'),\n                        header.string('nameConstant'),\n                        header.optionalString('description'),\n                    ),\n            );\n    }\n\n    /** A manifest-relative path, resolved against the manifest's own directory. */\n    resolve(manifestPath: string, relative: string): string {\n        return path.resolve(path.dirname(manifestPath), relative);\n    }\n}\n"]}

package/src/manifest/OpenApiManifest.d.ts

@@ -0,0 +1,116 @@
+/**
+ * `openapi.manifest.json`, as CLASSES.
+ *
+ * ## What is allowed in here, and what is not
+ *
+ * The manifest carries exactly what is **not a property of the code**, and nothing else. Every field
+ * below is a product decision, a deployment fact, or a NAME pointing at something the code owns:
+ *
+ * - `title`, `version` — product decisions.
+ * - `servers[]` — a deployment fact.
+ * - `descriptionFile` — a teaching decision.
+ * - `apis[]` — which contracts, in the order the published sidebar shows them.
+ * - `securitySchemeNames[]` — the published scheme KEYS only. Everything else about the schemes, and
+ *   the AND-ed `security` requirement, is DERIVED from the contract's own `@WpAuthApiKey`. A
+ *   `components.securitySchemes` block here would be a second copy of header names the running
+ *   server never reads, and nothing could contradict it.
+ * - `errors` — the document-wide failure contract, with the BODY read from a real TS type so the
+ *   published shape cannot drift from the one on the wire.
+ * - `responseHeaders[]` — declared by `nameConstant` naming an exported const, never by a literal.
+ *
+ * Anything a renderer could read off the source instead belongs in the source.
+ *
+ * ## The ORDER of `apis[]` is published navigation
+ *
+ * It is rendered into `tags[]` in that order, and a docs theme builds its sidebar from `tags[]`.
+ * Alphabetising this array is not a cleanup; it reorders partner-facing navigation.
+ */
+export declare class ServerEntry {
+    readonly url: string;
+    readonly description: string | undefined;
+    constructor(url: string, description: string | undefined);
+}
+/** One contract file the generator reads. */
+export declare class ApiEntry {
+    /** Path to the contract `.ts`, relative to the manifest's own directory. */
+    readonly entry: string;
+    /** The tag every operation of this contract carries — and one `tags[]` entry, in order. */
+    readonly tag: string;
+    /**
+     * `webhook` moves the contract into the top-level `webhooks:` block: these are calls WE
+     * make to a partner's server, not routes on ours.
+     *
+     * DECLARED, never sniffed from a `*WebhookApi` filename. A name convention would hide a
+     * partner-visible decision inside a rename, and a rename is the one edit nobody reviews for
+     * contract impact.
+     */
+    readonly kind: string | undefined;
+    constructor(
+    /** Path to the contract `.ts`, relative to the manifest's own directory. */
+    entry: string, 
+    /** The tag every operation of this contract carries — and one `tags[]` entry, in order. */
+    tag: string, 
+    /**
+     * `webhook` moves the contract into the top-level `webhooks:` block: these are calls WE
+     * make to a partner's server, not routes on ours.
+     *
+     * DECLARED, never sniffed from a `*WebhookApi` filename. A name convention would hide a
+     * partner-visible decision inside a rename, and a rename is the one edit nobody reviews for
+     * contract impact.
+     */
+    kind: string | undefined);
+    isWebhook(): boolean;
+}
+/** One status code of the document-wide failure contract. */
+export declare class ErrorResponseEntry {
+    readonly status: string;
+    readonly description: string;
+    constructor(status: string, description: string);
+}
+/**
+ * The document-wide failure contract.
+ *
+ * Document-wide and not per-operation on purpose: per-operation codes would be a second hand-written
+ * list to keep in step with the handlers, and stating them once tells a partner the truth — any
+ * operation can fail these ways.
+ */
+export declare class ErrorsEntry {
+    /** The `.ts` file declaring the error body, relative to the manifest. */
+    readonly entry: string;
+    /** The exported TYPE name of the body. Read with the compiler, so it cannot drift. */
+    readonly type: string;
+    readonly responses: readonly ErrorResponseEntry[];
+    constructor(
+    /** The `.ts` file declaring the error body, relative to the manifest. */
+    entry: string, 
+    /** The exported TYPE name of the body. Read with the compiler, so it cannot drift. */
+    type: string, responses: readonly ErrorResponseEntry[]);
+}
+/**
+ * One response header every operation carries.
+ *
+ * `nameConstant` names an exported `const` in `entry`, and the generator FOLDS it. A literal here
+ * would be a copy of the header name that a rename leaves silently stale — and JSON cannot import,
+ * so naming the constant is the only way for this file to point at the one the server actually
+ * writes. Failing to fold it is a HARD FAILURE for the same reason.
+ */
+export declare class ResponseHeaderEntry {
+    readonly entry: string;
+    readonly nameConstant: string;
+    readonly description: string | undefined;
+    constructor(entry: string, nameConstant: string, description: string | undefined);
+}
+export declare class OpenApiManifest {
+    readonly title: string;
+    readonly version: string;
+    readonly servers: readonly ServerEntry[];
+    /** A markdown preamble, relative to the manifest. Rendered into `info.description`. */
+    readonly descriptionFile: string | undefined;
+    readonly apis: readonly ApiEntry[];
+    readonly securitySchemeNames: readonly string[];
+    readonly errors: ErrorsEntry | undefined;
+    readonly responseHeaders: readonly ResponseHeaderEntry[];
+    constructor(title: string, version: string, servers: readonly ServerEntry[], 
+    /** A markdown preamble, relative to the manifest. Rendered into `info.description`. */
+    descriptionFile: string | undefined, apis: readonly ApiEntry[], securitySchemeNames: readonly string[], errors: ErrorsEntry | undefined, responseHeaders: readonly ResponseHeaderEntry[]);
+}

package/src/manifest/OpenApiManifest.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenApiManifest = exports.ResponseHeaderEntry = exports.ErrorsEntry = exports.ErrorResponseEntry = exports.ApiEntry = exports.ServerEntry = void 0;
+/**
+ * `openapi.manifest.json`, as CLASSES.
+ *
+ * ## What is allowed in here, and what is not
+ *
+ * The manifest carries exactly what is **not a property of the code**, and nothing else. Every field
+ * below is a product decision, a deployment fact, or a NAME pointing at something the code owns:
+ *
+ * - `title`, `version` — product decisions.
+ * - `servers[]` — a deployment fact.
+ * - `descriptionFile` — a teaching decision.
+ * - `apis[]` — which contracts, in the order the published sidebar shows them.
+ * - `securitySchemeNames[]` — the published scheme KEYS only. Everything else about the schemes, and
+ *   the AND-ed `security` requirement, is DERIVED from the contract's own `@WpAuthApiKey`. A
+ *   `components.securitySchemes` block here would be a second copy of header names the running
+ *   server never reads, and nothing could contradict it.
+ * - `errors` — the document-wide failure contract, with the BODY read from a real TS type so the
+ *   published shape cannot drift from the one on the wire.
+ * - `responseHeaders[]` — declared by `nameConstant` naming an exported const, never by a literal.
+ *
+ * Anything a renderer could read off the source instead belongs in the source.
+ *
+ * ## The ORDER of `apis[]` is published navigation
+ *
+ * It is rendered into `tags[]` in that order, and a docs theme builds its sidebar from `tags[]`.
+ * Alphabetising this array is not a cleanup; it reorders partner-facing navigation.
+ */
+class ServerEntry {
+    url;
+    description;
+    constructor(url, description) {
+        this.url = url;
+        this.description = description;
+    }
+}
+exports.ServerEntry = ServerEntry;
+/** One contract file the generator reads. */
+class ApiEntry {
+    entry;
+    tag;
+    kind;
+    constructor(
+    /** Path to the contract `.ts`, relative to the manifest's own directory. */
+    entry, 
+    /** The tag every operation of this contract carries — and one `tags[]` entry, in order. */
+    tag, 
+    /**
+     * `webhook` moves the contract into the top-level `webhooks:` block: these are calls WE
+     * make to a partner's server, not routes on ours.
+     *
+     * DECLARED, never sniffed from a `*WebhookApi` filename. A name convention would hide a
+     * partner-visible decision inside a rename, and a rename is the one edit nobody reviews for
+     * contract impact.
+     */
+    kind) {
+        this.entry = entry;
+        this.tag = tag;
+        this.kind = kind;
+    }
+    isWebhook() {
+        return this.kind === 'webhook';
+    }
+}
+exports.ApiEntry = ApiEntry;
+/** One status code of the document-wide failure contract. */
+class ErrorResponseEntry {
+    status;
+    description;
+    constructor(status, description) {
+        this.status = status;
+        this.description = description;
+    }
+}
+exports.ErrorResponseEntry = ErrorResponseEntry;
+/**
+ * The document-wide failure contract.
+ *
+ * Document-wide and not per-operation on purpose: per-operation codes would be a second hand-written
+ * list to keep in step with the handlers, and stating them once tells a partner the truth — any
+ * operation can fail these ways.
+ */
+class ErrorsEntry {
+    entry;
+    type;
+    responses;
+    constructor(
+    /** The `.ts` file declaring the error body, relative to the manifest. */
+    entry, 
+    /** The exported TYPE name of the body. Read with the compiler, so it cannot drift. */
+    type, responses) {
+        this.entry = entry;
+        this.type = type;
+        this.responses = responses;
+    }
+}
+exports.ErrorsEntry = ErrorsEntry;
+/**
+ * One response header every operation carries.
+ *
+ * `nameConstant` names an exported `const` in `entry`, and the generator FOLDS it. A literal here
+ * would be a copy of the header name that a rename leaves silently stale — and JSON cannot import,
+ * so naming the constant is the only way for this file to point at the one the server actually
+ * writes. Failing to fold it is a HARD FAILURE for the same reason.
+ */
+class ResponseHeaderEntry {
+    entry;
+    nameConstant;
+    description;
+    constructor(entry, nameConstant, description) {
+        this.entry = entry;
+        this.nameConstant = nameConstant;
+        this.description = description;
+    }
+}
+exports.ResponseHeaderEntry = ResponseHeaderEntry;
+class OpenApiManifest {
+    title;
+    version;
+    servers;
+    descriptionFile;
+    apis;
+    securitySchemeNames;
+    errors;
+    responseHeaders;
+    constructor(title, version, servers, 
+    /** A markdown preamble, relative to the manifest. Rendered into `info.description`. */
+    descriptionFile, apis, securitySchemeNames, errors, responseHeaders) {
+        this.title = title;
+        this.version = version;
+        this.servers = servers;
+        this.descriptionFile = descriptionFile;
+        this.apis = apis;
+        this.securitySchemeNames = securitySchemeNames;
+        this.errors = errors;
+        this.responseHeaders = responseHeaders;
+    }
+}
+exports.OpenApiManifest = OpenApiManifest;
+//# sourceMappingURL=OpenApiManifest.js.map

package/src/manifest/OpenApiManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiManifest.js","sourceRoot":"","sources":["../../../../../../packages/docs/openapi-generator/src/manifest/OpenApiManifest.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,WAAW;IAEP;IACA;IAFb,YACa,GAAW,EACX,WAA+B;QAD/B,QAAG,GAAH,GAAG,CAAQ;QACX,gBAAW,GAAX,WAAW,CAAoB;IACzC,CAAC;CACP;AALD,kCAKC;AAED,6CAA6C;AAC7C,MAAa,QAAQ;IAGJ;IAEA;IASA;IAbb;IACI,4EAA4E;IACnE,KAAa;IACtB,2FAA2F;IAClF,GAAW;IACpB;;;;;;;OAOG;IACM,IAAwB;QAXxB,UAAK,GAAL,KAAK,CAAQ;QAEb,QAAG,GAAH,GAAG,CAAQ;QASX,SAAI,GAAJ,IAAI,CAAoB;IAClC,CAAC;IAEJ,SAAS;QACL,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;IACnC,CAAC;CACJ;AApBD,4BAoBC;AAED,6DAA6D;AAC7D,MAAa,kBAAkB;IAEd;IACA;IAFb,YACa,MAAc,EACd,WAAmB;QADnB,WAAM,GAAN,MAAM,CAAQ;QACd,gBAAW,GAAX,WAAW,CAAQ;IAC7B,CAAC;CACP;AALD,gDAKC;AAED;;;;;;GAMG;AACH,MAAa,WAAW;IAGP;IAEA;IACA;IALb;IACI,yEAAyE;IAChE,KAAa;IACtB,sFAAsF;IAC7E,IAAY,EACZ,SAAwC;QAHxC,UAAK,GAAL,KAAK,CAAQ;QAEb,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAA+B;IAClD,CAAC;CACP;AARD,kCAQC;AAED;;;;;;;GAOG;AACH,MAAa,mBAAmB;IAEf;IACA;IACA;IAHb,YACa,KAAa,EACb,YAAoB,EACpB,WAA+B;QAF/B,UAAK,GAAL,KAAK,CAAQ;QACb,iBAAY,GAAZ,YAAY,CAAQ;QACpB,gBAAW,GAAX,WAAW,CAAoB;IACzC,CAAC;CACP;AAND,kDAMC;AAED,MAAa,eAAe;IAEX;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IATb,YACa,KAAa,EACb,OAAe,EACf,OAA+B;IACxC,uFAAuF;IAC9E,eAAmC,EACnC,IAAyB,EACzB,mBAAsC,EACtC,MAA+B,EAC/B,eAA+C;QAR/C,UAAK,GAAL,KAAK,CAAQ;QACb,YAAO,GAAP,OAAO,CAAQ;QACf,YAAO,GAAP,OAAO,CAAwB;QAE/B,oBAAe,GAAf,eAAe,CAAoB;QACnC,SAAI,GAAJ,IAAI,CAAqB;QACzB,wBAAmB,GAAnB,mBAAmB,CAAmB;QACtC,WAAM,GAAN,MAAM,CAAyB;QAC/B,oBAAe,GAAf,eAAe,CAAgC;IACzD,CAAC;CACP;AAZD,0CAYC","sourcesContent":["/**\n * `openapi.manifest.json`, as CLASSES.\n *\n * ## What is allowed in here, and what is not\n *\n * The manifest carries exactly what is **not a property of the code**, and nothing else. Every field\n * below is a product decision, a deployment fact, or a NAME pointing at something the code owns:\n *\n * - `title`, `version` — product decisions.\n * - `servers[]` — a deployment fact.\n * - `descriptionFile` — a teaching decision.\n * - `apis[]` — which contracts, in the order the published sidebar shows them.\n * - `securitySchemeNames[]` — the published scheme KEYS only. Everything else about the schemes, and\n *   the AND-ed `security` requirement, is DERIVED from the contract's own `@WpAuthApiKey`. A\n *   `components.securitySchemes` block here would be a second copy of header names the running\n *   server never reads, and nothing could contradict it.\n * - `errors` — the document-wide failure contract, with the BODY read from a real TS type so the\n *   published shape cannot drift from the one on the wire.\n * - `responseHeaders[]` — declared by `nameConstant` naming an exported const, never by a literal.\n *\n * Anything a renderer could read off the source instead belongs in the source.\n *\n * ## The ORDER of `apis[]` is published navigation\n *\n * It is rendered into `tags[]` in that order, and a docs theme builds its sidebar from `tags[]`.\n * Alphabetising this array is not a cleanup; it reorders partner-facing navigation.\n */\nexport class ServerEntry {\n    constructor(\n        readonly url: string,\n        readonly description: string | undefined,\n    ) {}\n}\n\n/** One contract file the generator reads. */\nexport class ApiEntry {\n    constructor(\n        /** Path to the contract `.ts`, relative to the manifest's own directory. */\n        readonly entry: string,\n        /** The tag every operation of this contract carries — and one `tags[]` entry, in order. */\n        readonly tag: string,\n        /**\n         * `webhook` moves the contract into the top-level `webhooks:` block: these are calls WE\n         * make to a partner's server, not routes on ours.\n         *\n         * DECLARED, never sniffed from a `*WebhookApi` filename. A name convention would hide a\n         * partner-visible decision inside a rename, and a rename is the one edit nobody reviews for\n         * contract impact.\n         */\n        readonly kind: string | undefined,\n    ) {}\n\n    isWebhook(): boolean {\n        return this.kind === 'webhook';\n    }\n}\n\n/** One status code of the document-wide failure contract. */\nexport class ErrorResponseEntry {\n    constructor(\n        readonly status: string,\n        readonly description: string,\n    ) {}\n}\n\n/**\n * The document-wide failure contract.\n *\n * Document-wide and not per-operation on purpose: per-operation codes would be a second hand-written\n * list to keep in step with the handlers, and stating them once tells a partner the truth — any\n * operation can fail these ways.\n */\nexport class ErrorsEntry {\n    constructor(\n        /** The `.ts` file declaring the error body, relative to the manifest. */\n        readonly entry: string,\n        /** The exported TYPE name of the body. Read with the compiler, so it cannot drift. */\n        readonly type: string,\n        readonly responses: readonly ErrorResponseEntry[],\n    ) {}\n}\n\n/**\n * One response header every operation carries.\n *\n * `nameConstant` names an exported `const` in `entry`, and the generator FOLDS it. A literal here\n * would be a copy of the header name that a rename leaves silently stale — and JSON cannot import,\n * so naming the constant is the only way for this file to point at the one the server actually\n * writes. Failing to fold it is a HARD FAILURE for the same reason.\n */\nexport class ResponseHeaderEntry {\n    constructor(\n        readonly entry: string,\n        readonly nameConstant: string,\n        readonly description: string | undefined,\n    ) {}\n}\n\nexport class OpenApiManifest {\n    constructor(\n        readonly title: string,\n        readonly version: string,\n        readonly servers: readonly ServerEntry[],\n        /** A markdown preamble, relative to the manifest. Rendered into `info.description`. */\n        readonly descriptionFile: string | undefined,\n        readonly apis: readonly ApiEntry[],\n        readonly securitySchemeNames: readonly string[],\n        readonly errors: ErrorsEntry | undefined,\n        readonly responseHeaders: readonly ResponseHeaderEntry[],\n    ) {}\n}\n"]}