@sdk-it/core 0.19.1 → 0.21.0

package/dist/lib/file-system.js

@@ -0,0 +1,139 @@
+import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { dirname, extname, isAbsolute, join, normalize } from "node:path";
+async function getFile(filePath) {
+  if (await exist(filePath)) {
+    return readFile(filePath, "utf-8");
+  }
+  return null;
+}
+async function exist(file) {
+  return stat(file).then(() => true).catch(() => false);
+}
+async function readFolder(path, recursive = false) {
+  if (!await exist(path)) {
+    return [];
+  }
+  const entries = await readdir(path, { withFileTypes: true });
+  const results = [];
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      if (recursive) {
+        const subFiles = await readFolder(join(path, entry.name), true);
+        for (const sub of subFiles) {
+          results.push(`${entry.name}/${sub}`);
+        }
+      }
+    } else {
+      results.push(entry.name);
+    }
+  }
+  return results;
+}
+async function writeFiles(dir, contents) {
+  await Promise.all(
+    Object.entries(contents).map(async ([file, content]) => {
+      if (content === null) {
+        return;
+      }
+      const filePath = isAbsolute(file) ? file : join(dir, file);
+      await mkdir(dirname(filePath), { recursive: true });
+      if (typeof content === "string") {
+        await writeFile(filePath, content, "utf-8");
+      } else {
+        if (content.ignoreIfExists) {
+          if (!await exist(filePath)) {
+            await writeFile(filePath, content.content, "utf-8");
+          }
+        } else {
+          await writeFile(filePath, content.content, "utf-8");
+        }
+      }
+    })
+  );
+}
+async function getFolderExports(folder, readFolder2, includeExtension = true, extensions = ["ts"], ignore = () => false) {
+  const files = await readFolder2(folder);
+  const exports = [];
+  for (const file of files) {
+    if (ignore(file)) {
+      continue;
+    }
+    if (file.isFolder) {
+      if (await exist(`${file.filePath}/index.ts`)) {
+        exports.push(
+          `export * from './${file.fileName}/index${includeExtension ? ".ts" : ""}';`
+        );
+      }
+    } else if (file.fileName !== "index.ts" && extensions.includes(getExt(file.fileName))) {
+      exports.push(
+        `export * from './${includeExtension ? file.fileName : file.fileName.replace(extname(file.fileName), "")}';`
+      );
+    }
+  }
+  return exports.join("\n");
+}
+async function getFolderExportsV2(folder, readFolder2, options = {
+  extensions: "ts",
+  ignore: () => false,
+  includeExtension: true,
+  exportSyntax: "export * from "
+}) {
+  options.includeExtension ??= true;
+  if (!await exist(folder)) {
+    return "";
+  }
+  const files = await readFolder2(folder);
+  const exports = [];
+  for (const file of files) {
+    if (options.ignore?.(file)) {
+      continue;
+    }
+    if (file.isFolder) {
+      if (await exist(`${file.filePath}/index.${options.extensions}`)) {
+        exports.push(
+          `${options.exportSyntax} './${file.fileName}/index${options.includeExtension ? `.${options.extensions}` : ""}';`
+        );
+      }
+    } else if (file.fileName !== `index.${options.extensions}` && options.extensions.includes(getExt(file.fileName))) {
+      exports.push(
+        `${options.exportSyntax} './${options.includeExtension ? file.fileName : file.fileName.replace(extname(file.fileName), "")}';`
+      );
+    }
+  }
+  return exports.join("\n");
+}
+const getExt = (fileName) => {
+  if (!fileName) {
+    return "";
+  }
+  const lastDot = fileName.lastIndexOf(".");
+  if (lastDot === -1) {
+    return "";
+  }
+  const ext = fileName.slice(lastDot + 1).split("/").filter(Boolean).join("");
+  if (ext === fileName) {
+    return "";
+  }
+  return ext || "txt";
+};
+function addLeadingSlash(path) {
+  return normalize(join("/", path));
+}
+function removeTrialingSlashes(path, keepLastOne = false) {
+  while (path.endsWith("/")) {
+    path = path.slice(0, -1);
+  }
+  return path + (keepLastOne ? "/" : "");
+}
+export {
+  addLeadingSlash,
+  exist,
+  getExt,
+  getFile,
+  getFolderExports,
+  getFolderExportsV2,
+  readFolder,
+  removeTrialingSlashes,
+  writeFiles
+};
+//# sourceMappingURL=file-system.js.map

package/dist/lib/file-system.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/file-system.ts"],
+  "sourcesContent": ["import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';\nimport { dirname, extname, isAbsolute, join, normalize } from 'node:path';\n\nexport async function getFile(filePath: string) {\n  if (await exist(filePath)) {\n    return readFile(filePath, 'utf-8');\n  }\n  return null;\n}\n\nexport async function exist(file: string): Promise<boolean> {\n  return stat(file)\n    .then(() => true)\n    .catch(() => false);\n}\n\nexport async function readFolder(\n  path: string,\n  recursive = false,\n): Promise<string[]> {\n  if (!(await exist(path))) {\n    return [];\n  }\n  const entries = await readdir(path, { withFileTypes: true });\n  const results: string[] = [];\n  for (const entry of entries) {\n    if (entry.isDirectory()) {\n      if (recursive) {\n        const subFiles = await readFolder(join(path, entry.name), true);\n        for (const sub of subFiles) {\n          results.push(`${entry.name}/${sub}`);\n        }\n      }\n    } else {\n      results.push(entry.name);\n    }\n  }\n  return results;\n}\n\nexport type WriteContent = Record<\n  string,\n  null | string | { content: string; ignoreIfExists?: boolean }\n>;\n\nexport type ReadFolderFn = (\n  folder: string,\n) => Promise<{ filePath: string; fileName: string; isFolder: boolean }[]>;\nexport type Writer = (dir: string, contents: WriteContent) => Promise<void>;\n\nexport async function writeFiles(dir: string, contents: WriteContent) {\n  await Promise.all(\n    Object.entries(contents).map(async ([file, content]) => {\n      if (content === null) {\n        return;\n      }\n      const filePath = isAbsolute(file) ? file : join(dir, file);\n      await mkdir(dirname(filePath), { recursive: true });\n      if (typeof content === 'string') {\n        await writeFile(filePath, content, 'utf-8');\n      } else {\n        if (content.ignoreIfExists) {\n          if (!(await exist(filePath))) {\n            await writeFile(filePath, content.content, 'utf-8');\n          }\n        } else {\n          await writeFile(filePath, content.content, 'utf-8');\n        }\n      }\n    }),\n  );\n}\n\n/**\n * @deprecated use getFolderExportsV2 instead\n */\nexport async function getFolderExports(\n  folder: string,\n  readFolder: ReadFolderFn,\n  includeExtension = true,\n  extensions = ['ts'],\n  ignore: (config: {\n    filePath: string;\n    fileName: string;\n    isFolder: boolean;\n  }) => boolean = () => false,\n) {\n  const files = await readFolder(folder);\n  const exports: string[] = [];\n  for (const file of files) {\n    if (ignore(file)) {\n      continue;\n    }\n    if (file.isFolder) {\n      if (await exist(`${file.filePath}/index.ts`)) {\n        exports.push(\n          `export * from './${file.fileName}/index${includeExtension ? '.ts' : ''}';`,\n        );\n      }\n    } else if (\n      file.fileName !== 'index.ts' &&\n      extensions.includes(getExt(file.fileName))\n    ) {\n      exports.push(\n        `export * from './${includeExtension ? file.fileName : file.fileName.replace(extname(file.fileName), '')}';`,\n      );\n    }\n  }\n  return exports.join('\\n');\n}\n\nexport async function getFolderExportsV2(\n  folder: string,\n  readFolder: ReadFolderFn,\n  options: {\n    includeExtension?: boolean;\n    extensions: string;\n    ignore?: (fileInfo: {\n      filePath: string;\n      fileName: string;\n      isFolder: boolean;\n    }) => boolean;\n    exportSyntax: string;\n  } = {\n    extensions: 'ts',\n    ignore: () => false,\n    includeExtension: true,\n    exportSyntax: 'export * from ',\n  },\n) {\n  options.includeExtension ??= true;\n  if (!(await exist(folder))) {\n    return '';\n  }\n  const files = await readFolder(folder);\n  const exports: string[] = [];\n  for (const file of files) {\n    if (options.ignore?.(file)) {\n      continue;\n    }\n    if (file.isFolder) {\n      if (await exist(`${file.filePath}/index.${options.extensions}`)) {\n        exports.push(\n          `${options.exportSyntax} './${file.fileName}/index${\n            options.includeExtension ? `.${options.extensions}` : ''\n          }';`,\n        );\n      }\n    } else if (\n      file.fileName !== `index.${options.extensions}` &&\n      options.extensions.includes(getExt(file.fileName))\n    ) {\n      exports.push(\n        `${options.exportSyntax} './${options.includeExtension ? file.fileName : file.fileName.replace(extname(file.fileName), '')}';`,\n      );\n    }\n  }\n  return exports.join('\\n');\n}\n\nexport const getExt = (fileName?: string) => {\n  if (!fileName) {\n    return ''; // shouldn't happen as there will always be a file name\n  }\n  const lastDot = fileName.lastIndexOf('.');\n  if (lastDot === -1) {\n    return '';\n  }\n  const ext = fileName\n    .slice(lastDot + 1)\n    .split('/')\n    .filter(Boolean)\n    .join('');\n  if (ext === fileName) {\n    // files that have no extension\n    return '';\n  }\n  return ext || 'txt';\n};\n\nexport function addLeadingSlash(path: string) {\n  return normalize(join('/', path));\n}\n\nexport function removeTrialingSlashes(path: string, keepLastOne = false) {\n  while (path.endsWith('/')) {\n    path = path.slice(0, -1);\n  }\n  return path + (keepLastOne ? '/' : '');\n}\n"],
+  "mappings": "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",
+  "names": ["readFolder"]
+}

package/dist/lib/paths.d.ts

@@ -1,5 +1,5 @@
 import type { OperationObject, PathsObject } from 'openapi3-ts/oas31';
-import { $types } from './deriver.ts';
+import { $types } from './deriver.js';
 export type Method = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'trace' | 'head';
 export declare const methods: readonly ["get", "post", "put", "patch", "delete", "trace", "head"];
 export type SemanticSource = 'query' | 'queries' | 'body' | 'params' | 'headers';

package/dist/lib/paths.js

@@ -0,0 +1,237 @@
+import { $types } from "./deriver.js";
+const methods = [
+  "get",
+  "post",
+  "put",
+  "patch",
+  "delete",
+  "trace",
+  "head"
+];
+const semanticSourceToOpenAPI = {
+  queries: "query",
+  query: "query",
+  headers: "header",
+  params: "path"
+};
+class Paths {
+  #commonZodImport;
+  #onOperation;
+  #operations = [];
+  constructor(config) {
+    this.#commonZodImport = config.commonZodImport;
+    this.#onOperation = config.onOperation;
+  }
+  addPath(name, path, method, contentType, selectors, responses, sourceFile, tags, description) {
+    const responsesObject = this.#responseItemToResponses(responses);
+    this.#operations.push({
+      name,
+      path: this.#tunePath(path),
+      sourceFile,
+      contentType,
+      method,
+      selectors,
+      responses: responsesObject,
+      tags,
+      description
+    });
+    return this;
+  }
+  #responseItemToResponses(responses) {
+    const responsesObject = {};
+    for (const item of responses) {
+      const ct = item.contentType;
+      const schema = item.response ? toSchema(item.response) : {};
+      if (!responsesObject[item.statusCode]) {
+        responsesObject[item.statusCode] = {
+          description: `Response for ${item.statusCode}`,
+          content: ct !== "empty" ? {
+            [ct]: ct === "application/octet-stream" ? { schema: { type: "string", format: "binary" } } : { schema }
+          } : void 0,
+          headers: item.headers.length ? item.headers.reduce((acc, current) => {
+            const headers = typeof current === "string" ? { [current]: [] } : current;
+            return Object.entries(headers).reduce(
+              (subAcc, [key, value]) => {
+                const header = {
+                  [key]: {
+                    schema: {
+                      type: "string",
+                      enum: value.length ? value : void 0
+                    }
+                  }
+                };
+                return { ...subAcc, ...header };
+              },
+              acc
+            );
+          }, {}) : void 0
+        };
+      } else {
+        if (!responsesObject[item.statusCode].content[ct]) {
+          responsesObject[item.statusCode].content[ct] = { schema };
+        } else {
+          const existing = responsesObject[item.statusCode].content[ct].schema;
+          if (existing.oneOf) {
+            if (!existing.oneOf.find(
+              (it) => JSON.stringify(it) === JSON.stringify(schema)
+            )) {
+              existing.oneOf.push(schema);
+            }
+          } else if (JSON.stringify(existing) !== JSON.stringify(schema)) {
+            responsesObject[item.statusCode].content[ct].schema = {
+              oneOf: [existing, schema]
+            };
+          }
+        }
+      }
+    }
+    return responsesObject;
+  }
+  async #selectosToParameters(selectors) {
+    const parameters = [];
+    const bodySchemaProps = {};
+    for (const selector of selectors) {
+      if (selector.source === "body") {
+        bodySchemaProps[selector.name] = {
+          required: selector.required,
+          schema: await evalZod(selector.against, this.#commonZodImport)
+        };
+        continue;
+      }
+      const parameter = {
+        in: semanticSourceToOpenAPI[selector.source],
+        name: selector.name,
+        required: selector.required,
+        schema: await evalZod(selector.against, this.#commonZodImport)
+      };
+      parameters.push(parameter);
+    }
+    return { parameters, bodySchemaProps };
+  }
+  async getPaths() {
+    const operations = {};
+    for (const operation of this.#operations) {
+      const { path, method, selectors } = operation;
+      const { parameters, bodySchemaProps } = await this.#selectosToParameters(selectors);
+      const bodySchema = {};
+      const required = [];
+      for (const [key, value] of Object.entries(bodySchemaProps)) {
+        if (value.required) {
+          required.push(key);
+        }
+        bodySchema[key] = value.schema;
+      }
+      const operationObject = {
+        operationId: operation.name,
+        parameters,
+        tags: operation.tags,
+        description: operation.description,
+        requestBody: Object.keys(bodySchema).length ? {
+          required: required.length ? true : false,
+          content: {
+            [operation.contentType || "application/json"]: {
+              schema: {
+                required: required.length ? required : void 0,
+                type: "object",
+                properties: bodySchema
+              }
+            }
+          }
+        } : void 0,
+        responses: Object.keys(operation.responses).length === 0 ? void 0 : operation.responses
+      };
+      if (!operations[path]) {
+        operations[path] = {};
+      }
+      operations[path][method] = operationObject;
+      if (this.#onOperation) {
+        const paths = this.#onOperation?.(
+          operation.sourceFile,
+          method,
+          path,
+          operationObject
+        );
+        Object.assign(operations, paths ?? {});
+      }
+    }
+    return operations;
+  }
+  /**
+   * Converts Express/Node.js style path parameters (/path/:param) to OpenAPI style (/path/{param})
+   */
+  #tunePath(path) {
+    return path.replace(/:([^/]+)/g, "{$1}");
+  }
+}
+async function evalZod(schema, commonZodImport) {
+  const lines = [
+    `import { createRequire } from "node:module";`,
+    `const filename = "${import.meta.url}";`,
+    `const require = createRequire(filename);`,
+    `const z = require("zod");`,
+    commonZodImport ? `const commonZod = require('${commonZodImport}');` : "",
+    `const {zodToJsonSchema} = require('zod-to-json-schema');`,
+    `const schema = ${schema.replace(".optional()", "").replaceAll("instanceof(File)", "string().base64()")};`,
+    `const jsonSchema = zodToJsonSchema(schema, {
+      $refStrategy: 'root',
+      basePath: ['#', 'components', 'schemas'],
+      target: 'jsonSchema7',
+      base64Strategy: 'format:binary',
+  });`,
+    `export default jsonSchema;`
+  ];
+  const base64 = Buffer.from(lines.join("\n")).toString("base64");
+  return import(`data:text/javascript;base64,${base64}`).then((mod) => mod.default).then(({ $schema, ...result }) => result);
+}
+function toSchema(data) {
+  if (data === null || data === void 0) {
+    return { type: "any" };
+  } else if (typeof data === "string") {
+    const isRef = data.startsWith("#");
+    if (isRef) {
+      return { $ref: data };
+    }
+    return { type: data };
+  } else if (data.kind === "literal") {
+    return { enum: [data.value], type: data[$types][0] };
+  } else if (data.kind === "record") {
+    return {
+      type: "object",
+      additionalProperties: toSchema(data[$types][0])
+    };
+  } else if (data.kind === "array") {
+    const items = data[$types].map(toSchema);
+    return { type: "array", items: data[$types].length ? items[0] : {} };
+  } else if (data.kind === "union") {
+    return { anyOf: data[$types].map(toSchema) };
+  } else if (data.kind === "intersection") {
+    return { allOf: data[$types].map(toSchema) };
+  } else if ($types in data) {
+    return data[$types].map(toSchema)[0] ?? {};
+  } else {
+    const props = {};
+    const required = [];
+    for (const [key, value] of Object.entries(data)) {
+      props[key] = toSchema(value);
+      if (!value.optional) {
+        required.push(key);
+      }
+    }
+    return {
+      type: "object",
+      properties: props,
+      required,
+      additionalProperties: false
+    };
+  }
+}
+function isHttpMethod(name) {
+  return ["get", "post", "put", "delete", "patch"].includes(name);
+}
+export {
+  Paths,
+  isHttpMethod,
+  methods,
+  toSchema
+};
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/paths.ts"],
+  "sourcesContent": ["import type {\n  HeadersObject,\n  OperationObject,\n  ParameterObject,\n  PathsObject,\n  ResponseObject,\n  ResponsesObject,\n  SchemaObject,\n} from 'openapi3-ts/oas31';\n\nimport { $types } from './deriver.js';\n\nexport type Method =\n  | 'get'\n  | 'post'\n  | 'put'\n  | 'patch'\n  | 'delete'\n  | 'trace'\n  | 'head';\nexport const methods = [\n  'get',\n  'post',\n  'put',\n  'patch',\n  'delete',\n  'trace',\n  'head',\n] as const;\nexport type SemanticSource =\n  | 'query'\n  | 'queries'\n  | 'body'\n  | 'params'\n  | 'headers';\n\nconst semanticSourceToOpenAPI = {\n  queries: 'query',\n  query: 'query',\n  headers: 'header',\n  params: 'path',\n} as const;\nexport interface Selector {\n  name: string;\n  select: string;\n  against: string;\n  source: SemanticSource;\n  nullable: boolean;\n  required: boolean;\n}\n\nexport interface ResponseItem {\n  statusCode: string;\n  response?: DateType;\n  contentType: string;\n  headers: (string | Record<string, string[]>)[];\n}\n\nexport type OnOperation = (\n  sourceFile: string,\n  method: Method,\n  path: string,\n  operation: OperationObject,\n) => PathsObject;\nexport class Paths {\n  #commonZodImport?: string;\n  #onOperation?: OnOperation;\n  #operations: Array<{\n    sourceFile: string;\n    name: string;\n    path: string;\n    method: Method;\n    selectors: Selector[];\n    responses: ResponsesObject;\n    contentType?: string;\n    tags?: string[];\n    description?: string;\n  }> = [];\n\n  constructor(config: { commonZodImport?: string; onOperation?: OnOperation }) {\n    this.#commonZodImport = config.commonZodImport;\n    this.#onOperation = config.onOperation;\n  }\n\n  addPath(\n    name: string,\n    path: string,\n    method: Method,\n    contentType: string | undefined,\n    selectors: Selector[],\n    responses: ResponseItem[],\n    sourceFile: string,\n    tags?: string[],\n    description?: string,\n  ) {\n    const responsesObject = this.#responseItemToResponses(responses);\n\n    this.#operations.push({\n      name,\n      path: this.#tunePath(path),\n      sourceFile,\n      contentType: contentType,\n      method,\n      selectors,\n      responses: responsesObject,\n      tags,\n      description,\n    });\n    return this;\n  }\n\n  #responseItemToResponses(responses: ResponseItem[]): ResponsesObject {\n    const responsesObject: ResponsesObject = {};\n    for (const item of responses) {\n      const ct = item.contentType;\n      const schema = item.response ? toSchema(item.response) : {};\n      if (!responsesObject[item.statusCode]) {\n        responsesObject[item.statusCode] = {\n          description: `Response for ${item.statusCode}`,\n          content:\n            ct !== 'empty'\n              ? {\n                  [ct]:\n                    ct === 'application/octet-stream'\n                      ? { schema: { type: 'string', format: 'binary' } }\n                      : { schema },\n                }\n              : undefined,\n          headers: item.headers.length\n            ? item.headers.reduce<HeadersObject>((acc, current) => {\n                const headers =\n                  typeof current === 'string' ? { [current]: [] } : current;\n                return Object.entries(headers).reduce<HeadersObject>(\n                  (subAcc, [key, value]) => {\n                    const header: HeadersObject = {\n                      [key]: {\n                        schema: {\n                          type: 'string',\n                          enum: value.length ? value : undefined,\n                        },\n                      },\n                    };\n                    return { ...subAcc, ...header };\n                  },\n                  acc,\n                );\n              }, {})\n            : undefined,\n        } satisfies ResponseObject;\n      } else {\n        if (!responsesObject[item.statusCode].content[ct]) {\n          responsesObject[item.statusCode].content[ct] = { schema };\n        } else {\n          const existing = responsesObject[item.statusCode].content[ct]\n            .schema as SchemaObject;\n          if (existing.oneOf) {\n            if (\n              !existing.oneOf.find(\n                (it) => JSON.stringify(it) === JSON.stringify(schema),\n              )\n            ) {\n              existing.oneOf.push(schema);\n            }\n          } else if (JSON.stringify(existing) !== JSON.stringify(schema)) {\n            responsesObject[item.statusCode].content[ct].schema = {\n              oneOf: [existing, schema],\n            };\n          }\n        }\n      }\n    }\n    return responsesObject;\n  }\n\n  async #selectosToParameters(selectors: Selector[]) {\n    const parameters: ParameterObject[] = [];\n    const bodySchemaProps: Record<\n      string,\n      { required: boolean; schema: SchemaObject }\n    > = {};\n    for (const selector of selectors) {\n      if (selector.source === 'body') {\n        bodySchemaProps[selector.name] = {\n          required: selector.required,\n          schema: await evalZod(selector.against, this.#commonZodImport),\n        };\n        continue;\n      }\n\n      const parameter: ParameterObject = {\n        in: semanticSourceToOpenAPI[selector.source],\n        name: selector.name,\n        required: selector.required,\n        schema: await evalZod(selector.against, this.#commonZodImport),\n      };\n      parameters.push(parameter);\n    }\n    return { parameters, bodySchemaProps };\n  }\n\n  async getPaths() {\n    const operations: PathsObject = {};\n    for (const operation of this.#operations) {\n      const { path, method, selectors } = operation;\n      const { parameters, bodySchemaProps } =\n        await this.#selectosToParameters(selectors);\n      const bodySchema: Record<string, SchemaObject> = {};\n      const required: string[] = [];\n      for (const [key, value] of Object.entries(bodySchemaProps)) {\n        if (value.required) {\n          required.push(key);\n        }\n        bodySchema[key] = value.schema;\n      }\n      const operationObject: OperationObject = {\n        operationId: operation.name,\n        parameters,\n        tags: operation.tags,\n        description: operation.description,\n        requestBody: Object.keys(bodySchema).length\n          ? {\n              required: required.length ? true : false,\n              content: {\n                [operation.contentType || 'application/json']: {\n                  schema: {\n                    required: required.length ? required : undefined,\n                    type: 'object',\n                    properties: bodySchema,\n                  },\n                },\n              },\n            }\n          : undefined,\n        responses:\n          Object.keys(operation.responses).length === 0\n            ? undefined\n            : operation.responses,\n      };\n      if (!operations[path]) {\n        operations[path] = {};\n      }\n      operations[path][method] = operationObject;\n      if (this.#onOperation) {\n        const paths = this.#onOperation?.(\n          operation.sourceFile,\n          method,\n          path,\n          operationObject,\n        );\n        Object.assign(operations, paths ?? {});\n      }\n    }\n    return operations;\n  }\n\n  /**\n   * Converts Express/Node.js style path parameters (/path/:param) to OpenAPI style (/path/{param})\n   */\n  #tunePath(path: string): string {\n    return path.replace(/:([^/]+)/g, '{$1}');\n  }\n}\n\nasync function evalZod(schema: string, commonZodImport?: string) {\n  // https://github.com/nodejs/node/issues/51956\n  const lines = [\n    `import { createRequire } from \"node:module\";`,\n    `const filename = \"${import.meta.url}\";`,\n    `const require = createRequire(filename);`,\n    `const z = require(\"zod\");`,\n    commonZodImport ? `const commonZod = require('${commonZodImport}');` : '',\n    `const {zodToJsonSchema} = require('zod-to-json-schema');`,\n    `const schema = ${schema.replace('.optional()', '').replaceAll('instanceof(File)', 'string().base64()')};`,\n    `const jsonSchema = zodToJsonSchema(schema, {\n      $refStrategy: 'root',\n      basePath: ['#', 'components', 'schemas'],\n      target: 'jsonSchema7',\n      base64Strategy: 'format:binary',\n  });`,\n    `export default jsonSchema;`,\n  ];\n\n  const base64 = Buffer.from(lines.join('\\n')).toString('base64');\n  return import(`data:text/javascript;base64,${base64}`)\n    .then((mod) => mod.default)\n    .then(({ $schema, ...result }) => result);\n}\n\ninterface DateType {\n  [$types]: any[];\n  kind: string;\n  optional: boolean;\n  value?: string;\n}\n\nexport function toSchema(data: DateType | string | null | undefined): any {\n  if (data === null || data === undefined) {\n    return { type: 'any' };\n  } else if (typeof data === 'string') {\n    const isRef = data.startsWith('#');\n    if (isRef) {\n      return { $ref: data };\n    }\n    return { type: data };\n  } else if (data.kind === 'literal') {\n    return { enum: [data.value], type: data[$types][0] };\n  } else if (data.kind === 'record') {\n    return {\n      type: 'object',\n      additionalProperties: toSchema(data[$types][0]),\n    };\n  } else if (data.kind === 'array') {\n    const items = data[$types].map(toSchema);\n    return { type: 'array', items: data[$types].length ? items[0] : {} };\n  } else if (data.kind === 'union') {\n    return { anyOf: data[$types].map(toSchema) };\n  } else if (data.kind === 'intersection') {\n    return { allOf: data[$types].map(toSchema) };\n  } else if ($types in data) {\n    return data[$types].map(toSchema)[0] ?? {};\n  } else {\n    const props: Record<string, unknown> = {};\n    const required: string[] = [];\n    for (const [key, value] of Object.entries(data)) {\n      props[key] = toSchema(value as any);\n      if (!(value as any).optional) {\n        required.push(key);\n      }\n    }\n    return {\n      type: 'object',\n      properties: props,\n      required,\n      additionalProperties: false,\n    };\n  }\n}\n\nexport function isHttpMethod(name: string): name is Method {\n  return ['get', 'post', 'put', 'delete', 'patch'].includes(name);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/program.js

@@ -0,0 +1,75 @@
+import debug from "debug";
+import { dirname, join } from "node:path";
+import ts from "typescript";
+const logger = debug("january:client");
+function parseTsConfig(tsconfigPath) {
+  logger(`Using TypeScript version: ${ts.version}`);
+  const configContent = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
+  if (configContent.error) {
+    console.error(
+      `Failed to read tsconfig file:`,
+      ts.formatDiagnosticsWithColorAndContext([configContent.error], {
+        getCanonicalFileName: (path) => path,
+        getCurrentDirectory: ts.sys.getCurrentDirectory,
+        getNewLine: () => ts.sys.newLine
+      })
+    );
+    throw new Error("Failed to parse tsconfig.json");
+  }
+  const parsed = ts.parseJsonConfigFileContent(
+    configContent.config,
+    ts.sys,
+    dirname(tsconfigPath)
+  );
+  if (parsed.errors.length > 0) {
+    console.error(
+      `Errors found in tsconfig.json:`,
+      ts.formatDiagnosticsWithColorAndContext(parsed.errors, {
+        getCanonicalFileName: (path) => path,
+        getCurrentDirectory: ts.sys.getCurrentDirectory,
+        getNewLine: () => ts.sys.newLine
+      })
+    );
+    throw new Error("Failed to parse tsconfig.json");
+  }
+  return parsed;
+}
+function getProgram(tsconfigPath) {
+  const tsConfigParseResult = parseTsConfig(tsconfigPath);
+  logger(`Parsing tsconfig`);
+  return ts.createProgram({
+    options: {
+      ...tsConfigParseResult.options,
+      noEmit: true,
+      incremental: true,
+      tsBuildInfoFile: join(dirname(tsconfigPath), "./.tsbuildinfo")
+      // not working atm
+    },
+    rootNames: tsConfigParseResult.fileNames,
+    projectReferences: tsConfigParseResult.projectReferences,
+    configFileParsingDiagnostics: tsConfigParseResult.errors
+  });
+}
+function getPropertyAssignment(node, name) {
+  if (ts.isObjectLiteralExpression(node)) {
+    return node.properties.filter((prop) => ts.isPropertyAssignment(prop)).find((prop) => prop.name.getText() === name);
+  }
+  return void 0;
+}
+function isCallExpression(node, name) {
+  return ts.isCallExpression(node) && node.expression && ts.isIdentifier(node.expression) && node.expression.text === name;
+}
+function isInterfaceType(type) {
+  if (type.isClassOrInterface()) {
+    return !!(type.symbol.flags & ts.SymbolFlags.Interface);
+  }
+  return false;
+}
+export {
+  getProgram,
+  getPropertyAssignment,
+  isCallExpression,
+  isInterfaceType,
+  parseTsConfig
+};
+//# sourceMappingURL=program.js.map

package/dist/lib/program.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/program.ts"],
+  "sourcesContent": ["import debug from 'debug';\nimport { dirname, join } from 'node:path';\nimport ts from 'typescript';\n\nconst logger = debug('january:client');\n\nexport function parseTsConfig(tsconfigPath: string) {\n  logger(`Using TypeScript version: ${ts.version}`);\n  const configContent = ts.readConfigFile(tsconfigPath, ts.sys.readFile);\n\n  if (configContent.error) {\n    console.error(\n      `Failed to read tsconfig file:`,\n      ts.formatDiagnosticsWithColorAndContext([configContent.error], {\n        getCanonicalFileName: (path) => path,\n        getCurrentDirectory: ts.sys.getCurrentDirectory,\n        getNewLine: () => ts.sys.newLine,\n      }),\n    );\n    throw new Error('Failed to parse tsconfig.json');\n  }\n\n  const parsed = ts.parseJsonConfigFileContent(\n    configContent.config,\n    ts.sys,\n    dirname(tsconfigPath),\n  );\n\n  if (parsed.errors.length > 0) {\n    console.error(\n      `Errors found in tsconfig.json:`,\n      ts.formatDiagnosticsWithColorAndContext(parsed.errors, {\n        getCanonicalFileName: (path) => path,\n        getCurrentDirectory: ts.sys.getCurrentDirectory,\n        getNewLine: () => ts.sys.newLine,\n      }),\n    );\n    throw new Error('Failed to parse tsconfig.json');\n  }\n  return parsed;\n}\nexport function getProgram(tsconfigPath: string) {\n  const tsConfigParseResult = parseTsConfig(tsconfigPath);\n  logger(`Parsing tsconfig`);\n  return ts.createProgram({\n    options: {\n      ...tsConfigParseResult.options,\n      noEmit: true,\n      incremental: true,\n      tsBuildInfoFile: join(dirname(tsconfigPath), './.tsbuildinfo'), // not working atm\n    },\n    rootNames: tsConfigParseResult.fileNames,\n    projectReferences: tsConfigParseResult.projectReferences,\n    configFileParsingDiagnostics: tsConfigParseResult.errors,\n  });\n}\nexport function getPropertyAssignment(node: ts.Node, name: string) {\n  if (ts.isObjectLiteralExpression(node)) {\n    return node.properties\n      .filter((prop) => ts.isPropertyAssignment(prop))\n      .find((prop) => prop.name!.getText() === name);\n  }\n  return undefined;\n}\nexport function isCallExpression(\n  node: ts.Node,\n  name: string,\n): node is ts.CallExpression {\n  return (\n    ts.isCallExpression(node) &&\n    node.expression &&\n    ts.isIdentifier(node.expression) &&\n    node.expression.text === name\n  );\n}\n\nexport function isInterfaceType(type: ts.Type): boolean {\n  if (type.isClassOrInterface()) {\n    // Check if it's an interface\n    return !!(type.symbol.flags & ts.SymbolFlags.Interface);\n  }\n  return false;\n}\n"],
+  "mappings": "AAAA,OAAO,WAAW;AAClB,SAAS,SAAS,YAAY;AAC9B,OAAO,QAAQ;AAEf,MAAM,SAAS,MAAM,gBAAgB;AAE9B,SAAS,cAAc,cAAsB;AAClD,SAAO,6BAA6B,GAAG,OAAO,EAAE;AAChD,QAAM,gBAAgB,GAAG,eAAe,cAAc,GAAG,IAAI,QAAQ;AAErE,MAAI,cAAc,OAAO;AACvB,YAAQ;AAAA,MACN;AAAA,MACA,GAAG,qCAAqC,CAAC,cAAc,KAAK,GAAG;AAAA,QAC7D,sBAAsB,CAAC,SAAS;AAAA,QAChC,qBAAqB,GAAG,IAAI;AAAA,QAC5B,YAAY,MAAM,GAAG,IAAI;AAAA,MAC3B,CAAC;AAAA,IACH;AACA,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAEA,QAAM,SAAS,GAAG;AAAA,IAChB,cAAc;AAAA,IACd,GAAG;AAAA,IACH,QAAQ,YAAY;AAAA,EACtB;AAEA,MAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,YAAQ;AAAA,MACN;AAAA,MACA,GAAG,qCAAqC,OAAO,QAAQ;AAAA,QACrD,sBAAsB,CAAC,SAAS;AAAA,QAChC,qBAAqB,GAAG,IAAI;AAAA,QAC5B,YAAY,MAAM,GAAG,IAAI;AAAA,MAC3B,CAAC;AAAA,IACH;AACA,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AACA,SAAO;AACT;AACO,SAAS,WAAW,cAAsB;AAC/C,QAAM,sBAAsB,cAAc,YAAY;AACtD,SAAO,kBAAkB;AACzB,SAAO,GAAG,cAAc;AAAA,IACtB,SAAS;AAAA,MACP,GAAG,oBAAoB;AAAA,MACvB,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,iBAAiB,KAAK,QAAQ,YAAY,GAAG,gBAAgB;AAAA;AAAA,IAC/D;AAAA,IACA,WAAW,oBAAoB;AAAA,IAC/B,mBAAmB,oBAAoB;AAAA,IACvC,8BAA8B,oBAAoB;AAAA,EACpD,CAAC;AACH;AACO,SAAS,sBAAsB,MAAe,MAAc;AACjE,MAAI,GAAG,0BAA0B,IAAI,GAAG;AACtC,WAAO,KAAK,WACT,OAAO,CAAC,SAAS,GAAG,qBAAqB,IAAI,CAAC,EAC9C,KAAK,CAAC,SAAS,KAAK,KAAM,QAAQ,MAAM,IAAI;AAAA,EACjD;AACA,SAAO;AACT;AACO,SAAS,iBACd,MACA,MAC2B;AAC3B,SACE,GAAG,iBAAiB,IAAI,KACxB,KAAK,cACL,GAAG,aAAa,KAAK,UAAU,KAC/B,KAAK,WAAW,SAAS;AAE7B;AAEO,SAAS,gBAAgB,MAAwB;AACtD,MAAI,KAAK,mBAAmB,GAAG;AAE7B,WAAO,CAAC,EAAE,KAAK,OAAO,QAAQ,GAAG,YAAY;AAAA,EAC/C;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/ref.d.ts

@@ -1,4 +1,4 @@
-import type { OpenAPIObject, ParameterObject, ReferenceObject, RequestBodyObject, SchemaObject } from 'openapi3-ts/oas31';
+import type { HeaderObject, OpenAPIObject, ParameterObject, ReferenceObject, RequestBodyObject, SchemaObject } from 'openapi3-ts/oas31';
 export declare function isRef(obj: any): obj is ReferenceObject;
 export declare function notRef(obj: any): obj is SchemaObject;
 export declare function cleanRef(ref: string): string;
@@ -7,5 +7,6 @@ export declare function parseRef(ref: string): {
     namespace: string;
     path: string;
 };
-export declare function followRef<T extends SchemaObject | ParameterObject | RequestBodyObject = SchemaObject>(spec: OpenAPIObject, ref: string): T;
+export declare function followRef<T extends SchemaObject | HeaderObject | ParameterObject | ReferenceObject | RequestBodyObject = SchemaObject>(spec: OpenAPIObject, ref: string): T;
+export declare function distillRef<T extends SchemaObject | HeaderObject | ParameterObject | ReferenceObject | RequestBodyObject = SchemaObject>(spec: OpenAPIObject, ref: string): T;
 //# sourceMappingURL=ref.d.ts.map

package/dist/lib/ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/lib/ref.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,eAAe,CAEtD;AACD,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAEpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,UAEnC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM;;;;EASnC;AACD,wBAAgB,SAAS,CACvB,CAAC,SAAS,YAAY,GAAG,eAAe,GAAG,iBAAiB,GAAG,YAAY,EAC3E,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAOrC"}
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/lib/ref.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAI3B,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,eAAe,CAEtD;AACD,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAEpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,UAEnC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM;;;;EASnC;AACD,wBAAgB,SAAS,CACvB,CAAC,SACG,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,eAAe,GACf,iBAAiB,GAAG,YAAY,EACpC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAOrC;AACD,wBAAgB,UAAU,CACxB,CAAC,SACG,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,eAAe,GACf,iBAAiB,GAAG,YAAY,EACpC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CA8CrC"}

package/dist/lib/ref.js

@@ -0,0 +1,83 @@
+import { get } from "lodash-es";
+import { isEmpty } from "./utils.js";
+function isRef(obj) {
+  return obj && "$ref" in obj;
+}
+function notRef(obj) {
+  return !isRef(obj);
+}
+function cleanRef(ref) {
+  return ref.replace(/^#\//, "");
+}
+function parseRef(ref) {
+  const parts = ref.split("/");
+  const [model] = parts.splice(-1);
+  const [namespace] = parts.splice(-1);
+  return {
+    model,
+    namespace,
+    path: cleanRef(parts.join("/"))
+  };
+}
+function followRef(spec, ref) {
+  const pathParts = cleanRef(ref).split("/");
+  const entry = get(spec, pathParts);
+  if (entry && "$ref" in entry) {
+    return followRef(spec, entry.$ref);
+  }
+  return entry;
+}
+function distillRef(spec, ref) {
+  const def = followRef(spec, ref);
+  if (!def) {
+    return def;
+  }
+  if ("properties" in def) {
+    def.properties ??= {};
+    for (const key in def.properties) {
+      const prop = def.properties[key];
+      if (isRef(prop)) {
+        def.properties[key] = distillRef(spec, prop.$ref);
+      }
+    }
+  }
+  if ("items" in def) {
+    if (isRef(def.items)) {
+      def.items = distillRef(spec, def.items.$ref);
+    }
+  }
+  if ("allOf" in def && !isEmpty(def.allOf)) {
+    def.allOf = def.allOf.map((item) => {
+      if (isRef(item)) {
+        return distillRef(spec, item.$ref);
+      }
+      return item;
+    });
+  }
+  if ("oneOf" in def && !isEmpty(def.oneOf)) {
+    def.oneOf = def.oneOf.map((item) => {
+      if (isRef(item)) {
+        return distillRef(spec, item.$ref);
+      }
+      return item;
+    });
+  }
+  if ("anyOf" in def && !isEmpty(def.anyOf)) {
+    def.anyOf = def.anyOf.map((item) => {
+      if (isRef(item)) {
+        return distillRef(spec, item.$ref);
+      }
+      return item;
+    });
+  }
+  return def;
+}
+export {
+  cleanRef,
+  distillRef,
+  followRef,
+  isRef,
+  notRef,
+  parseRef
+};
+//# sourceMappingURL=ref.js.map

package/dist/lib/ref.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/ref.ts"],
+  "sourcesContent": ["import { get } from 'lodash-es';\nimport type {\n  HeaderObject,\n  OpenAPIObject,\n  ParameterObject,\n  ReferenceObject,\n  RequestBodyObject,\n  SchemaObject,\n} from 'openapi3-ts/oas31';\n\nimport { isEmpty } from './utils.js';\n\nexport function isRef(obj: any): obj is ReferenceObject {\n  return obj && '$ref' in obj;\n}\nexport function notRef(obj: any): obj is SchemaObject {\n  return !isRef(obj);\n}\n\nexport function cleanRef(ref: string) {\n  return ref.replace(/^#\\//, '');\n}\n\nexport function parseRef(ref: string) {\n  const parts = ref.split('/');\n  const [model] = parts.splice(-1);\n  const [namespace] = parts.splice(-1);\n  return {\n    model,\n    namespace,\n    path: cleanRef(parts.join('/')),\n  };\n}\nexport function followRef<\n  T extends\n    | SchemaObject\n    | HeaderObject\n    | ParameterObject\n    | ReferenceObject\n    | RequestBodyObject = SchemaObject,\n>(spec: OpenAPIObject, ref: string): T {\n  const pathParts = cleanRef(ref).split('/');\n  const entry = get(spec, pathParts) as T | ReferenceObject;\n  if (entry && '$ref' in entry) {\n    return followRef<T>(spec, entry.$ref!);\n  }\n  return entry;\n}\nexport function distillRef<\n  T extends\n    | SchemaObject\n    | HeaderObject\n    | ParameterObject\n    | ReferenceObject\n    | RequestBodyObject = SchemaObject,\n>(spec: OpenAPIObject, ref: string): T {\n  const def = followRef<T>(spec, ref);\n  if (!def) {\n    return def;\n  }\n\n  if ('properties' in def) {\n    def.properties ??= {};\n    for (const key in def.properties) {\n      const prop = def.properties[key];\n      if (isRef(prop)) {\n        def.properties[key] = distillRef(spec, prop.$ref);\n      }\n    }\n  }\n  if ('items' in def) {\n    if (isRef(def.items)) {\n      def.items = distillRef<SchemaObject>(spec, def.items.$ref);\n    }\n  }\n  if ('allOf' in def && !isEmpty(def.allOf)) {\n    def.allOf = def.allOf.map((item) => {\n      if (isRef(item)) {\n        return distillRef<SchemaObject>(spec, item.$ref);\n      }\n      return item;\n    });\n  }\n  if ('oneOf' in def && !isEmpty(def.oneOf)) {\n    def.oneOf = def.oneOf.map((item) => {\n      if (isRef(item)) {\n        return distillRef<SchemaObject>(spec, item.$ref);\n      }\n      return item;\n    });\n  }\n  if ('anyOf' in def && !isEmpty(def.anyOf)) {\n    def.anyOf = def.anyOf.map((item) => {\n      if (isRef(item)) {\n        return distillRef<SchemaObject>(spec, item.$ref);\n      }\n      return item;\n    });\n  }\n\n  return def;\n}\n"],
+  "mappings": "AAAA,SAAS,WAAW;AAUpB,SAAS,eAAe;AAEjB,SAAS,MAAM,KAAkC;AACtD,SAAO,OAAO,UAAU;AAC1B;AACO,SAAS,OAAO,KAA+B;AACpD,SAAO,CAAC,MAAM,GAAG;AACnB;AAEO,SAAS,SAAS,KAAa;AACpC,SAAO,IAAI,QAAQ,QAAQ,EAAE;AAC/B;AAEO,SAAS,SAAS,KAAa;AACpC,QAAM,QAAQ,IAAI,MAAM,GAAG;AAC3B,QAAM,CAAC,KAAK,IAAI,MAAM,OAAO,EAAE;AAC/B,QAAM,CAAC,SAAS,IAAI,MAAM,OAAO,EAAE;AACnC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAM,SAAS,MAAM,KAAK,GAAG,CAAC;AAAA,EAChC;AACF;AACO,SAAS,UAOd,MAAqB,KAAgB;AACrC,QAAM,YAAY,SAAS,GAAG,EAAE,MAAM,GAAG;AACzC,QAAM,QAAQ,IAAI,MAAM,SAAS;AACjC,MAAI,SAAS,UAAU,OAAO;AAC5B,WAAO,UAAa,MAAM,MAAM,IAAK;AAAA,EACvC;AACA,SAAO;AACT;AACO,SAAS,WAOd,MAAqB,KAAgB;AACrC,QAAM,MAAM,UAAa,MAAM,GAAG;AAClC,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,MAAI,gBAAgB,KAAK;AACvB,QAAI,eAAe,CAAC;AACpB,eAAW,OAAO,IAAI,YAAY;AAChC,YAAM,OAAO,IAAI,WAAW,GAAG;AAC/B,UAAI,MAAM,IAAI,GAAG;AACf,YAAI,WAAW,GAAG,IAAI,WAAW,MAAM,KAAK,IAAI;AAAA,MAClD;AAAA,IACF;AAAA,EACF;AACA,MAAI,WAAW,KAAK;AAClB,QAAI,MAAM,IAAI,KAAK,GAAG;AACpB,UAAI,QAAQ,WAAyB,MAAM,IAAI,MAAM,IAAI;AAAA,IAC3D;AAAA,EACF;AACA,MAAI,WAAW,OAAO,CAAC,QAAQ,IAAI,KAAK,GAAG;AACzC,QAAI,QAAQ,IAAI,MAAM,IAAI,CAAC,SAAS;AAClC,UAAI,MAAM,IAAI,GAAG;AACf,eAAO,WAAyB,MAAM,KAAK,IAAI;AAAA,MACjD;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AACA,MAAI,WAAW,OAAO,CAAC,QAAQ,IAAI,KAAK,GAAG;AACzC,QAAI,QAAQ,IAAI,MAAM,IAAI,CAAC,SAAS;AAClC,UAAI,MAAM,IAAI,GAAG;AACf,eAAO,WAAyB,MAAM,KAAK,IAAI;AAAA,MACjD;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AACA,MAAI,WAAW,OAAO,CAAC,QAAQ,IAAI,KAAK,GAAG;AACzC,QAAI,QAAQ,IAAI,MAAM,IAAI,CAAC,SAAS;AAClC,UAAI,MAAM,IAAI,GAAG;AACf,eAAO,WAAyB,MAAM,KAAK,IAAI;AAAA,MACjD;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO;AACT;",
+  "names": []
+}