sf-plugin-cms 0.1.0

package/lib/generated/operations.js

@@ -0,0 +1,317 @@
+// Generated by scripts/generate-openapi.mjs. Do not edit.
+export const SELECTED_OPERATIONS = [
+    {
+        "localKey": "channel.get",
+        "method": "GET",
+        "operationId": "getManagedContentChannel",
+        "parameters": [
+            {
+                "location": "path",
+                "name": "channelId",
+                "required": true,
+                "type": "string"
+            }
+        ],
+        "path": "/connect/cms/channels/{channelId}",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "content.create",
+        "method": "POST",
+        "operationId": "postManagedContentDocumentCreate",
+        "parameters": [],
+        "path": "/connect/cms/contents",
+        "requestBodyMediaTypes": [
+            "application/json",
+            "multipart/form-data"
+        ],
+        "requestBodyPresent": true,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "content.get",
+        "method": "GET",
+        "operationId": "getManagedContentDocument",
+        "parameters": [
+            {
+                "location": "path",
+                "name": "contentKeyOrId",
+                "required": true,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "contentVersion",
+                "required": false,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "language",
+                "required": false,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "variantVersion",
+                "required": false,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "version",
+                "required": false,
+                "type": "string"
+            }
+        ],
+        "path": "/connect/cms/contents/{contentKeyOrId}",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "variant.create",
+        "method": "POST",
+        "operationId": "postManagedContentVariantCreate",
+        "parameters": [],
+        "path": "/connect/cms/contents/variants",
+        "requestBodyMediaTypes": [
+            "application/json"
+        ],
+        "requestBodyPresent": true,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "variant.delete",
+        "method": "DELETE",
+        "operationId": "deleteManagedContentVariant",
+        "parameters": [
+            {
+                "location": "path",
+                "name": "variantId",
+                "required": true,
+                "type": "string"
+            }
+        ],
+        "path": "/connect/cms/contents/variants/{variantId}",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "variant.get",
+        "method": "GET",
+        "operationId": "getManagedContentVariant",
+        "parameters": [
+            {
+                "location": "path",
+                "name": "variantId",
+                "required": true,
+                "type": "string"
+            }
+        ],
+        "path": "/connect/cms/contents/variants/{variantId}",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "workspace.channel.list",
+        "method": "GET",
+        "operationId": "getManagedContentSpaceChannels",
+        "parameters": [
+            {
+                "location": "path",
+                "name": "contentSpaceId",
+                "required": true,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "page",
+                "required": false,
+                "type": "integer"
+            },
+            {
+                "location": "query",
+                "name": "pageSize",
+                "required": false,
+                "type": "integer"
+            }
+        ],
+        "path": "/connect/cms/spaces/{contentSpaceId}/channels",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "workspace.get",
+        "method": "GET",
+        "operationId": "getManagedContentSpace",
+        "parameters": [
+            {
+                "location": "path",
+                "name": "contentSpaceId",
+                "required": true,
+                "type": "string"
+            }
+        ],
+        "path": "/connect/cms/spaces/{contentSpaceId}",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "workspace.list",
+        "method": "GET",
+        "operationId": "getManagedContentSpaceCollection",
+        "parameters": [
+            {
+                "location": "query",
+                "name": "nameFragment",
+                "required": false,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "page",
+                "required": false,
+                "type": "integer"
+            },
+            {
+                "location": "query",
+                "name": "pageSize",
+                "required": false,
+                "type": "integer"
+            }
+        ],
+        "path": "/connect/cms/spaces",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    },
+    {
+        "localKey": "workspace.variant.search",
+        "method": "GET",
+        "operationId": "getManagedContentSearchItems",
+        "parameters": [
+            {
+                "location": "query",
+                "name": "contentSpaceOrFolderIds",
+                "required": true,
+                "type": "string-array"
+            },
+            {
+                "location": "query",
+                "name": "contentTypeFQN",
+                "required": false,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "languages",
+                "required": false,
+                "type": "string-array"
+            },
+            {
+                "location": "query",
+                "name": "page",
+                "required": false,
+                "type": "integer"
+            },
+            {
+                "location": "query",
+                "name": "pageSize",
+                "required": false,
+                "type": "integer"
+            },
+            {
+                "location": "query",
+                "name": "queryTerm",
+                "required": true,
+                "type": "string"
+            },
+            {
+                "location": "query",
+                "name": "scope",
+                "required": false,
+                "type": "string"
+            }
+        ],
+        "path": "/connect/cms/items/search",
+        "requestBodyMediaTypes": [],
+        "requestBodyPresent": false,
+        "responses": [
+            {
+                "mediaTypes": [
+                    "application/json"
+                ],
+                "status": "200"
+            }
+        ]
+    }
+];
+//# sourceMappingURL=operations.js.map

package/lib/generated/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/generated/operations.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC;QACE,UAAU,EAAE,aAAa;QACzB,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,0BAA0B;QACzC,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,MAAM,EAAE,mCAAmC;QAC3C,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,MAAM;QAChB,aAAa,EAAE,kCAAkC;QACjD,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,uBAAuB;QAC/B,uBAAuB,EAAE;YACvB,kBAAkB;YAClB,qBAAqB;SACtB;QACD,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,aAAa;QACzB,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,2BAA2B;QAC1C,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,MAAM,EAAE,wCAAwC;QAChD,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,MAAM;QAChB,aAAa,EAAE,iCAAiC;QAChD,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,gCAAgC;QACxC,uBAAuB,EAAE;YACvB,kBAAkB;SACnB;QACD,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,QAAQ;QAClB,aAAa,EAAE,6BAA6B;QAC5C,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,MAAM,EAAE,4CAA4C;QACpD,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE,EAAE;gBAChB,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,aAAa;QACzB,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,0BAA0B;QACzC,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,MAAM,EAAE,4CAA4C;QACpD,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,wBAAwB;QACpC,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,gCAAgC;QAC/C,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,SAAS;aAClB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,SAAS;aAClB;SACF;QACD,MAAM,EAAE,+CAA+C;QACvD,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,eAAe;QAC3B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,wBAAwB;QACvC,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,MAAM,EAAE,sCAAsC;QAC9C,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,gBAAgB;QAC5B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,kCAAkC;QACjD,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,cAAc;gBACtB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,SAAS;aAClB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,SAAS;aAClB;SACF;QACD,MAAM,EAAE,qBAAqB;QAC7B,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,UAAU,EAAE,0BAA0B;QACtC,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,8BAA8B;QAC7C,YAAY,EAAE;YACZ;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,yBAAyB;gBACjC,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,cAAc;aACvB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,cAAc;aACvB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,SAAS;aAClB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,SAAS;aAClB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,QAAQ;aACjB;YACD;gBACE,UAAU,EAAE,OAAO;gBACnB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,MAAM,EAAE,2BAA2B;QACnC,uBAAuB,EAAE,EAAE;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE;YACX;gBACE,YAAY,EAAE;oBACZ,kBAAkB;iBACnB;gBACD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;CACO,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+export { default as GetChannel } from './commands/cms/get/channel.js';
+export { default as GetContent } from './commands/cms/get/content.js';
+export { default as GetVariant } from './commands/cms/get/variant.js';
+export { default as GetWorkspace } from './commands/cms/get/workspace.js';
+export { default as Info } from './commands/cms/info.js';
+export { default as ListChannel } from './commands/cms/list/channel.js';
+export { default as ListWorkspace } from './commands/cms/list/workspace.js';
+export { executeWorkspaceImport, loadWorkspaceExport, planWorkspaceImport, type CreatedParentRecord, type DestinationWorkspace, type ExecuteWorkspaceImportOptions, type LoadedWorkspaceExport, type WorkspaceImportGroupPlan, type WorkspaceImportItem, type WorkspaceImportPlan, type WorkspaceImportResult, type WorkspaceImportRunReport, } from './services/import-workspace.js';

package/lib/index.js

@@ -0,0 +1,9 @@
+export { default as GetChannel } from './commands/cms/get/channel.js';
+export { default as GetContent } from './commands/cms/get/content.js';
+export { default as GetVariant } from './commands/cms/get/variant.js';
+export { default as GetWorkspace } from './commands/cms/get/workspace.js';
+export { default as Info } from './commands/cms/info.js';
+export { default as ListChannel } from './commands/cms/list/channel.js';
+export { default as ListWorkspace } from './commands/cms/list/workspace.js';
+export { executeWorkspaceImport, loadWorkspaceExport, planWorkspaceImport, } from './services/import-workspace.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GAUpB,MAAM,gCAAgC,CAAC"}

package/lib/openapi/generate.d.ts

@@ -0,0 +1,30 @@
+import { type SelectedOperationConfig } from './selected.js';
+type RecordValue = Record<string, unknown>;
+type ParameterLocation = 'path' | 'query';
+type ParameterDescriptor = {
+    location: ParameterLocation;
+    name: string;
+    required: boolean;
+    type: 'boolean' | 'integer' | 'string' | 'string-array';
+};
+export type OperationDescriptor = {
+    localKey: string;
+    method: string;
+    operationId: string;
+    parameters: ParameterDescriptor[];
+    path: string;
+    requestBodyMediaTypes: string[];
+    requestBodyPresent: boolean;
+    responses: Array<{
+        mediaTypes: string[];
+        status: string;
+    }>;
+};
+export type GeneratedOpenApiFiles = {
+    operations: string;
+};
+export declare function buildSelectedOperationDescriptors(document: RecordValue, selections: readonly SelectedOperationConfig[]): OperationDescriptor[];
+export declare function generateSelectedOpenApi(sourcePath: string): Promise<GeneratedOpenApiFiles>;
+export declare function writeSelectedOpenApi(sourcePath: string, outputDirectory: string): Promise<GeneratedOpenApiFiles>;
+export declare function checkSelectedOpenApi(sourcePath: string, outputDirectory: string): Promise<void>;
+export {};

package/lib/openapi/generate.js

@@ -0,0 +1,150 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { intakeOpenApi, OpenApiIntakeError } from './intake.js';
+import { SELECTED_OPERATION_CONFIG } from './selected.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readRecord(parent, key, context) {
+    const value = parent[key];
+    if (!isRecord(value))
+        throw new OpenApiIntakeError(`${context}.${key} must be an object`);
+    return value;
+}
+function resolveSchema(document, schema) {
+    const reference = schema.$ref;
+    if (typeof reference !== 'string')
+        return schema;
+    const segments = reference.match(/^#\/components\/schemas\/([^/]+)$/u);
+    if (!segments)
+        throw new OpenApiIntakeError(`unsupported selected schema reference: ${reference}`);
+    const components = readRecord(document, 'components', 'OpenAPI document');
+    const schemas = readRecord(components, 'schemas', 'OpenAPI document.components');
+    return readRecord(schemas, segments[1], 'OpenAPI document.components.schemas');
+}
+function parameterType(schema) {
+    const schemaType = schema.type;
+    if (schemaType === 'boolean' || schemaType === 'integer' || schemaType === 'string') {
+        return schemaType;
+    }
+    if (schemaType === 'array' && isRecord(schema.items) && schema.items.type === 'string') {
+        return 'string-array';
+    }
+    throw new OpenApiIntakeError(`unsupported selected parameter type: ${String(schemaType)}`);
+}
+function collectParameters(document, pathItem, operation) {
+    const combined = [pathItem.parameters, operation.parameters].flatMap((value) => Array.isArray(value) ? value : []);
+    const parameters = new Map();
+    for (const value of combined) {
+        if (!isRecord(value)) {
+            throw new OpenApiIntakeError('selected operation parameter must be an object');
+        }
+        const location = value.in;
+        const name = value.name;
+        const schema = value.schema;
+        if ((location !== 'path' && location !== 'query') ||
+            typeof name !== 'string' ||
+            !isRecord(schema)) {
+            throw new OpenApiIntakeError('selected operation parameter is incomplete');
+        }
+        const type = parameterType(resolveSchema(document, schema));
+        const identity = `${location}:${name}`;
+        if (parameters.has(identity)) {
+            throw new OpenApiIntakeError(`duplicate selected operation parameter: ${identity}`);
+        }
+        parameters.set(identity, {
+            location,
+            name,
+            required: location === 'path' || value.required === true,
+            type,
+        });
+    }
+    return [...parameters.values()].toSorted((left, right) => left.location.localeCompare(right.location) || left.name.localeCompare(right.name));
+}
+function mediaTypes(value) {
+    if (!isRecord(value))
+        return [];
+    return Object.keys(value).toSorted();
+}
+function describeResponses(operation) {
+    const responses = readRecord(operation, 'responses', 'selected operation');
+    return Object.entries(responses)
+        .map(([status, response]) => {
+        if (!isRecord(response)) {
+            throw new OpenApiIntakeError(`selected operation response ${status} must be an object`);
+        }
+        return { mediaTypes: mediaTypes(response.content), status };
+    })
+        .toSorted((left, right) => left.status.localeCompare(right.status));
+}
+export function buildSelectedOperationDescriptors(document, selections) {
+    const localKeys = new Set();
+    const selectedById = new Map();
+    for (const selection of selections) {
+        if (localKeys.has(selection.localKey)) {
+            throw new OpenApiIntakeError(`duplicate selected operation local key: ${selection.localKey}`);
+        }
+        if (selectedById.has(selection.operationId)) {
+            throw new OpenApiIntakeError(`duplicate selected operationId: ${selection.operationId}`);
+        }
+        localKeys.add(selection.localKey);
+        selectedById.set(selection.operationId, selection);
+    }
+    const paths = readRecord(document, 'paths', 'OpenAPI document');
+    const byId = new Map();
+    for (const [operationPath, pathValue] of Object.entries(paths)) {
+        if (!isRecord(pathValue))
+            continue;
+        for (const [method, operationValue] of Object.entries(pathValue)) {
+            if (!isRecord(operationValue) || typeof operationValue.operationId !== 'string')
+                continue;
+            const selection = selectedById.get(operationValue.operationId);
+            if (!selection)
+                continue;
+            if (byId.has(operationValue.operationId)) {
+                throw new OpenApiIntakeError(`selected operation appears more than once: ${operationValue.operationId}`);
+            }
+            byId.set(operationValue.operationId, {
+                localKey: selection.localKey,
+                method: method.toUpperCase(),
+                operationId: operationValue.operationId,
+                parameters: collectParameters(document, pathValue, operationValue),
+                path: operationPath,
+                requestBodyMediaTypes: isRecord(operationValue.requestBody)
+                    ? mediaTypes(operationValue.requestBody.content)
+                    : [],
+                requestBodyPresent: isRecord(operationValue.requestBody),
+                responses: describeResponses(operationValue),
+            });
+        }
+    }
+    for (const { operationId } of selections) {
+        if (!byId.has(operationId)) {
+            throw new OpenApiIntakeError(`selected operation missing: ${operationId}`);
+        }
+    }
+    return [...byId.values()].toSorted((left, right) => left.localKey.localeCompare(right.localKey));
+}
+function emitOperations(descriptors) {
+    return `// Generated by scripts/generate-openapi.mjs. Do not edit.\n\nexport const SELECTED_OPERATIONS = ${JSON.stringify(descriptors, null, 2)} as const;\n\nexport type SelectedOperation = (typeof SELECTED_OPERATIONS)[number];\nexport type SelectedOperationId = SelectedOperation['operationId'];\n`;
+}
+export async function generateSelectedOpenApi(sourcePath) {
+    const intake = await intakeOpenApi(sourcePath);
+    return {
+        operations: emitOperations(buildSelectedOperationDescriptors(intake.document, SELECTED_OPERATION_CONFIG)),
+    };
+}
+export async function writeSelectedOpenApi(sourcePath, outputDirectory) {
+    const generated = await generateSelectedOpenApi(sourcePath);
+    await mkdir(outputDirectory, { recursive: true });
+    await writeFile(path.join(outputDirectory, 'operations.ts'), generated.operations, 'utf8');
+    return generated;
+}
+export async function checkSelectedOpenApi(sourcePath, outputDirectory) {
+    const generated = await generateSelectedOpenApi(sourcePath);
+    const actual = await readFile(path.join(outputDirectory, 'operations.ts'), 'utf8');
+    if (actual !== generated.operations) {
+        throw new OpenApiIntakeError('generated output is stale: operations.ts');
+    }
+}
+//# sourceMappingURL=generate.js.map

package/lib/openapi/generate.js.map

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

package/lib/openapi/intake.d.ts

@@ -0,0 +1,26 @@
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type JsonPrimitive = boolean | null | number | string;
+export type OpenApiOperation = {
+    method: string;
+    operationId: string;
+    path: string;
+};
+export type OpenApiIntake = {
+    byteSize: number;
+    document: {
+        [key: string]: JsonValue;
+    };
+    operationCount: number;
+    operations: OpenApiOperation[];
+    refCount: number;
+    sha256: string;
+    source: string;
+};
+export declare class OpenApiIntakeError extends Error {
+    constructor(message: string);
+}
+export declare function resolveInternalRef(root: unknown, reference: string): unknown;
+export declare function intakeOpenApi(sourcePath: string): Promise<OpenApiIntake>;
+export {};