@aws/nx-plugin 1.0.0-rc.4 → 1.0.0-rc.41

package/src/open-api/ts-client/generator.js

@@ -1,39 +1,54 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateOpenApiTsClient = exports.buildOpenApiCodeGenerationData = exports.openApiTsClientGenerator = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const parse_1 = require("../utils/parse");
-const codegen_data_1 = require("../utils/codegen-data");
-const path = tslib_1.__importStar(require("path"));
-const format_1 = require("../../utils/format");
+ */ import { generateFiles, logger } from "@nx/devkit";
+import * as path from "path";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { esmVars } from "../../utils/module-format.js";
+import { buildOpenApiCodeGenData } from "../utils/codegen-data.js";
+import { parseOpenApiSpec } from "../utils/parse.js";
 /**
  * Generates typescript client from an openapi spec
- */
-const openApiTsClientGenerator = async (tree, options) => {
-    const data = await (0, exports.buildOpenApiCodeGenerationData)(tree, options.openApiSpecPath);
-    (0, exports.generateOpenApiTsClient)(tree, data, options.outputPath);
-    await (0, format_1.formatFilesInSubtree)(tree);
+ */ export const openApiTsClientGenerator = async (tree, options)=>{
+    const data = await buildOpenApiCodeGenerationData(tree, options.openApiSpecPath);
+    generateOpenApiTsClient(tree, data, options.outputPath);
+    await formatFilesInSubtree(tree);
 };
-exports.openApiTsClientGenerator = openApiTsClientGenerator;
 /**
  * Build a data structure which can be used to generate code from OpenAPI
- */
-const buildOpenApiCodeGenerationData = async (tree, specPath) => {
-    const spec = await (0, parse_1.parseOpenApiSpec)(tree, specPath);
-    return await (0, codegen_data_1.buildOpenApiCodeGenData)(spec);
+ */ export const buildOpenApiCodeGenerationData = async (tree, specPath)=>{
+    const spec = await parseOpenApiSpec(tree, specPath);
+    warnForUnsupportedFeatures(spec);
+    return buildOpenApiCodeGenData(spec);
+};
+/**
+ * Warn for spec features the generated client does not implement, so their
+ * omission is never silent.
+ */ const warnForUnsupportedFeatures = (spec)=>{
+    if (Object.keys(spec.webhooks ?? {}).length > 0) {
+        logger.warn('OpenAPI webhooks are not supported and no client code is generated for them');
+    }
+    for (const [p, pathItem] of Object.entries(spec.paths ?? {})){
+        for (const [method, op] of Object.entries(pathItem ?? {})){
+            if (typeof op !== 'object' || op === null) continue;
+            const operation = op;
+            if (Object.keys(operation.callbacks ?? {}).length > 0) {
+                logger.warn(`Operation ${method.toUpperCase()} ${p} declares callbacks, which are not supported and are ignored`);
+            }
+            if ((operation.servers ?? []).length > 0) {
+                logger.warn(`Operation ${method.toUpperCase()} ${p} declares operation-level servers, which are ignored — the client always uses its configured url`);
+            }
+        }
+    }
 };
-exports.buildOpenApiCodeGenerationData = buildOpenApiCodeGenerationData;
 /**
  * Generate an OpenAPI typescript client in the target directory
- */
-const generateOpenApiTsClient = (tree, data, outputPath) => {
-    (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files'), outputPath, data);
+ */ export const generateOpenApiTsClient = (tree, data, outputPath)=>{
+    generateFiles(tree, path.join(import.meta.dirname, 'files'), outputPath, {
+        ...data,
+        ...esmVars(tree)
+    });
 };
-exports.generateOpenApiTsClient = generateOpenApiTsClient;
-exports.default = exports.openApiTsClientGenerator;
+export default openApiTsClientGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/open-api/ts-client/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/open-api/ts-client/generator.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,uCAAiD;AAEjD,0CAAkD;AAClD,wDAAgE;AAChE,mDAA6B;AAE7B,+CAA0D;AAE1D;;GAEG;AACI,MAAM,wBAAwB,GAAG,KAAK,EAC3C,IAAU,EACV,OAAuC,EACvC,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,IAAA,sCAA8B,EAC/C,IAAI,EACJ,OAAO,CAAC,eAAe,CACxB,CAAC;IAEF,IAAA,+BAAuB,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAExD,MAAM,IAAA,6BAAoB,EAAC,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAZW,QAAA,wBAAwB,4BAYnC;AAEF;;GAEG;AACI,MAAM,8BAA8B,GAAG,KAAK,EACjD,IAAU,EACV,QAAgB,EAChB,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,IAAA,wBAAgB,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpD,OAAO,MAAM,IAAA,sCAAuB,EAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AANW,QAAA,8BAA8B,kCAMzC;AAEF;;GAEG;AACI,MAAM,uBAAuB,GAAG,CACrC,IAAU,EACV,IAAiB,EACjB,UAAkB,EAClB,EAAE;IACF,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC,CAAC;AANW,QAAA,uBAAuB,2BAMlC;AAEF,kBAAe,gCAAwB,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/open-api/ts-client/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { generateFiles, logger, type Tree } from '@nx/devkit';\nimport * as path from 'path';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { esmVars } from '../../utils/module-format';\nimport { buildOpenApiCodeGenData } from '../utils/codegen-data';\nimport type { CodeGenData } from '../utils/codegen-data/types';\nimport { parseOpenApiSpec } from '../utils/parse';\nimport type { Spec } from '../utils/types';\nimport type { OpenApiTsClientGeneratorSchema } from './schema';\n\n/**\n * Generates typescript client from an openapi spec\n */\nexport const openApiTsClientGenerator = async (\n  tree: Tree,\n  options: OpenApiTsClientGeneratorSchema,\n) => {\n  const data = await buildOpenApiCodeGenerationData(\n    tree,\n    options.openApiSpecPath,\n  );\n\n  generateOpenApiTsClient(tree, data, options.outputPath);\n\n  await formatFilesInSubtree(tree);\n};\n\n/**\n * Build a data structure which can be used to generate code from OpenAPI\n */\nexport const buildOpenApiCodeGenerationData = async (\n  tree: Tree,\n  specPath: string,\n) => {\n  const spec = await parseOpenApiSpec(tree, specPath);\n  warnForUnsupportedFeatures(spec);\n  return buildOpenApiCodeGenData(spec);\n};\n\n/**\n * Warn for spec features the generated client does not implement, so their\n * omission is never silent.\n */\nconst warnForUnsupportedFeatures = (spec: Spec) => {\n  if (Object.keys((spec as { webhooks?: object }).webhooks ?? {}).length > 0) {\n    logger.warn(\n      'OpenAPI webhooks are not supported and no client code is generated for them',\n    );\n  }\n  for (const [p, pathItem] of Object.entries(spec.paths ?? {})) {\n    for (const [method, op] of Object.entries(pathItem ?? {})) {\n      if (typeof op !== 'object' || op === null) continue;\n      const operation = op as {\n        callbacks?: object;\n        servers?: unknown[];\n      };\n      if (Object.keys(operation.callbacks ?? {}).length > 0) {\n        logger.warn(\n          `Operation ${method.toUpperCase()} ${p} declares callbacks, which are not supported and are ignored`,\n        );\n      }\n      if ((operation.servers ?? []).length > 0) {\n        logger.warn(\n          `Operation ${method.toUpperCase()} ${p} declares operation-level servers, which are ignored — the client always uses its configured url`,\n        );\n      }\n    }\n  }\n};\n\n/**\n * Generate an OpenAPI typescript client in the target directory\n */\nexport const generateOpenApiTsClient = (\n  tree: Tree,\n  data: CodeGenData,\n  outputPath: string,\n) => {\n  generateFiles(tree, path.join(import.meta.dirname, 'files'), outputPath, {\n    ...data,\n    ...esmVars(tree),\n  });\n};\n\nexport default openApiTsClientGenerator;\n"],"names":["generateFiles","logger","path","formatFilesInSubtree","esmVars","buildOpenApiCodeGenData","parseOpenApiSpec","openApiTsClientGenerator","tree","options","data","buildOpenApiCodeGenerationData","openApiSpecPath","generateOpenApiTsClient","outputPath","specPath","spec","warnForUnsupportedFeatures","Object","keys","webhooks","length","warn","p","pathItem","entries","paths","method","op","operation","callbacks","toUpperCase","servers","join","dirname"],"mappings":"AAAA;;;CAGC,GACD,SAASA,aAAa,EAAEC,MAAM,QAAmB,aAAa;AAC9D,YAAYC,UAAU,OAAO;AAC7B,SAASC,oBAAoB,QAAQ,wBAAqB;AAC1D,SAASC,OAAO,QAAQ,+BAA4B;AACpD,SAASC,uBAAuB,QAAQ,2BAAwB;AAEhE,SAASC,gBAAgB,QAAQ,oBAAiB;AAIlD;;CAEC,GACD,OAAO,MAAMC,2BAA2B,OACtCC,MACAC;IAEA,MAAMC,OAAO,MAAMC,+BACjBH,MACAC,QAAQG,eAAe;IAGzBC,wBAAwBL,MAAME,MAAMD,QAAQK,UAAU;IAEtD,MAAMX,qBAAqBK;AAC7B,EAAE;AAEF;;CAEC,GACD,OAAO,MAAMG,iCAAiC,OAC5CH,MACAO;IAEA,MAAMC,OAAO,MAAMV,iBAAiBE,MAAMO;IAC1CE,2BAA2BD;IAC3B,OAAOX,wBAAwBW;AACjC,EAAE;AAEF;;;CAGC,GACD,MAAMC,6BAA6B,CAACD;IAClC,IAAIE,OAAOC,IAAI,CAAC,AAACH,KAA+BI,QAAQ,IAAI,CAAC,GAAGC,MAAM,GAAG,GAAG;QAC1EpB,OAAOqB,IAAI,CACT;IAEJ;IACA,KAAK,MAAM,CAACC,GAAGC,SAAS,IAAIN,OAAOO,OAAO,CAACT,KAAKU,KAAK,IAAI,CAAC,GAAI;QAC5D,KAAK,MAAM,CAACC,QAAQC,GAAG,IAAIV,OAAOO,OAAO,CAACD,YAAY,CAAC,GAAI;YACzD,IAAI,OAAOI,OAAO,YAAYA,OAAO,MAAM;YAC3C,MAAMC,YAAYD;YAIlB,IAAIV,OAAOC,IAAI,CAACU,UAAUC,SAAS,IAAI,CAAC,GAAGT,MAAM,GAAG,GAAG;gBACrDpB,OAAOqB,IAAI,CACT,CAAC,UAAU,EAAEK,OAAOI,WAAW,GAAG,CAAC,EAAER,EAAE,4DAA4D,CAAC;YAExG;YACA,IAAI,AAACM,CAAAA,UAAUG,OAAO,IAAI,EAAE,AAAD,EAAGX,MAAM,GAAG,GAAG;gBACxCpB,OAAOqB,IAAI,CACT,CAAC,UAAU,EAAEK,OAAOI,WAAW,GAAG,CAAC,EAAER,EAAE,gGAAgG,CAAC;YAE5I;QACF;IACF;AACF;AAEA;;CAEC,GACD,OAAO,MAAMV,0BAA0B,CACrCL,MACAE,MACAI;IAEAd,cAAcQ,MAAMN,KAAK+B,IAAI,CAAC,YAAYC,OAAO,EAAE,UAAUpB,YAAY;QACvE,GAAGJ,IAAI;QACP,GAAGN,QAAQI,KAAK;IAClB;AACF,EAAE;AAEF,eAAeD,yBAAyB"}

package/src/open-api/ts-client/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/open-api/ts-client/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/open-api/ts-client/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport interface OpenApiTsClientGeneratorSchema {\n  openApiSpecPath: string;\n  outputPath: string;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAED,WAGC"}

package/src/open-api/ts-hooks/files/options-proxy.gen.ts.template

@@ -36,9 +36,14 @@ import type {
 <%_ uniq(allOperations.flatMap((op) => op.result && modelsByName[op.result.type] ? [modelsByName[op.result.type].typescriptType] : [])).forEach((returnTypeModel) => { _%>
   <%- returnTypeModel %>,
 <%_ }); _%>
-} from './types.gen.js';
+<%_ /* Infinite-query cursor types may reference a named model (e.g. an enum),
+      which the cursorType uses but is otherwise not imported. */ _%>
+<%_ uniq(allOperations.flatMap((op) => op.isInfiniteQuery && op.infiniteQueryCursorProperty && modelsByName[op.infiniteQueryCursorProperty.type] ? [modelsByName[op.infiniteQueryCursorProperty.type].typescriptType] : [])).forEach((cursorTypeModel) => { _%>
+  <%- cursorTypeModel %>,
+<%_ }); _%>
+} from './types.gen<% if (esm) { %>.js<% } %>';
 <%_ } _%>
-import { <%- className %> } from './client.gen.js';
+import { <%- className %> } from './client.gen<% if (esm) { %>.js<% } %>';
 
 export interface <%- className %>OptionsProxyConfig {
   client: <%- className %>;

package/src/open-api/ts-hooks/generator.d.ts

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
-import { OpenApiTsHooksGeneratorSchema } from './schema';
-import { CodeGenData } from '../utils/codegen-data/types';
+import { type Tree } from '@nx/devkit';
+import type { CodeGenData } from '../utils/codegen-data/types';
+import type { OpenApiTsHooksGeneratorSchema } from './schema';
 /**
  * Generates typescript hooks from an openapi spec
  */

package/src/open-api/ts-hooks/generator.js

@@ -1,31 +1,27 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateOpenApiTsHooks = exports.openApiTsHooksGenerator = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const generator_1 = require("../ts-client/generator");
-const format_1 = require("../../utils/format");
-const path_1 = tslib_1.__importDefault(require("path"));
+ */ import { generateFiles } from "@nx/devkit";
+import path from "path";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { esmVars } from "../../utils/module-format.js";
+import { buildOpenApiCodeGenerationData, generateOpenApiTsClient } from "../ts-client/generator.js";
 /**
  * Generates typescript hooks from an openapi spec
- */
-const openApiTsHooksGenerator = async (tree, options) => {
-    const data = await (0, generator_1.buildOpenApiCodeGenerationData)(tree, options.openApiSpecPath);
-    (0, generator_1.generateOpenApiTsClient)(tree, data, options.outputPath);
-    (0, exports.generateOpenApiTsHooks)(tree, data, options.outputPath);
-    await (0, format_1.formatFilesInSubtree)(tree);
+ */ export const openApiTsHooksGenerator = async (tree, options)=>{
+    const data = await buildOpenApiCodeGenerationData(tree, options.openApiSpecPath);
+    generateOpenApiTsClient(tree, data, options.outputPath);
+    generateOpenApiTsHooks(tree, data, options.outputPath);
+    await formatFilesInSubtree(tree);
 };
-exports.openApiTsHooksGenerator = openApiTsHooksGenerator;
 /**
  * Generate OpenAPI typescript hooks in the target directory
- */
-const generateOpenApiTsHooks = (tree, data, outputPath) => {
-    (0, devkit_1.generateFiles)(tree, path_1.default.join(__dirname, 'files'), outputPath, data);
+ */ export const generateOpenApiTsHooks = (tree, data, outputPath)=>{
+    generateFiles(tree, path.join(import.meta.dirname, 'files'), outputPath, {
+        ...data,
+        ...esmVars(tree)
+    });
 };
-exports.generateOpenApiTsHooks = generateOpenApiTsHooks;
-exports.default = exports.openApiTsHooksGenerator;
+export default openApiTsHooksGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/open-api/ts-hooks/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/open-api/ts-hooks/generator.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,uCAAiD;AAEjD,sDAGgC;AAChC,+CAA0D;AAC1D,wDAAwB;AAGxB;;GAEG;AACI,MAAM,uBAAuB,GAAG,KAAK,EAC1C,IAAU,EACV,OAAsC,EACtC,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,IAAA,0CAA8B,EAC/C,IAAI,EACJ,OAAO,CAAC,eAAe,CACxB,CAAC;IAEF,IAAA,mCAAuB,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACxD,IAAA,8BAAsB,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvD,MAAM,IAAA,6BAAoB,EAAC,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAbW,QAAA,uBAAuB,2BAalC;AAEF;;GAEG;AACI,MAAM,sBAAsB,GAAG,CACpC,IAAU,EACV,IAAiB,EACjB,UAAkB,EAClB,EAAE;IACF,IAAA,sBAAa,EAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC,CAAC;AANW,QAAA,sBAAsB,0BAMjC;AAEF,kBAAe,+BAAuB,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/open-api/ts-hooks/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { generateFiles, type Tree } from '@nx/devkit';\nimport path from 'path';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { esmVars } from '../../utils/module-format';\nimport {\n  buildOpenApiCodeGenerationData,\n  generateOpenApiTsClient,\n} from '../ts-client/generator';\nimport type { CodeGenData } from '../utils/codegen-data/types';\nimport type { OpenApiTsHooksGeneratorSchema } from './schema';\n\n/**\n * Generates typescript hooks from an openapi spec\n */\nexport const openApiTsHooksGenerator = async (\n  tree: Tree,\n  options: OpenApiTsHooksGeneratorSchema,\n) => {\n  const data = await buildOpenApiCodeGenerationData(\n    tree,\n    options.openApiSpecPath,\n  );\n\n  generateOpenApiTsClient(tree, data, options.outputPath);\n  generateOpenApiTsHooks(tree, data, options.outputPath);\n\n  await formatFilesInSubtree(tree);\n};\n\n/**\n * Generate OpenAPI typescript hooks in the target directory\n */\nexport const generateOpenApiTsHooks = (\n  tree: Tree,\n  data: CodeGenData,\n  outputPath: string,\n) => {\n  generateFiles(tree, path.join(import.meta.dirname, 'files'), outputPath, {\n    ...data,\n    ...esmVars(tree),\n  });\n};\n\nexport default openApiTsHooksGenerator;\n"],"names":["generateFiles","path","formatFilesInSubtree","esmVars","buildOpenApiCodeGenerationData","generateOpenApiTsClient","openApiTsHooksGenerator","tree","options","data","openApiSpecPath","outputPath","generateOpenApiTsHooks","join","dirname"],"mappings":"AAAA;;;CAGC,GACD,SAASA,aAAa,QAAmB,aAAa;AACtD,OAAOC,UAAU,OAAO;AACxB,SAASC,oBAAoB,QAAQ,wBAAqB;AAC1D,SAASC,OAAO,QAAQ,+BAA4B;AACpD,SACEC,8BAA8B,EAC9BC,uBAAuB,QAClB,4BAAyB;AAIhC;;CAEC,GACD,OAAO,MAAMC,0BAA0B,OACrCC,MACAC;IAEA,MAAMC,OAAO,MAAML,+BACjBG,MACAC,QAAQE,eAAe;IAGzBL,wBAAwBE,MAAME,MAAMD,QAAQG,UAAU;IACtDC,uBAAuBL,MAAME,MAAMD,QAAQG,UAAU;IAErD,MAAMT,qBAAqBK;AAC7B,EAAE;AAEF;;CAEC,GACD,OAAO,MAAMK,yBAAyB,CACpCL,MACAE,MACAE;IAEAX,cAAcO,MAAMN,KAAKY,IAAI,CAAC,YAAYC,OAAO,EAAE,UAAUH,YAAY;QACvE,GAAGF,IAAI;QACP,GAAGN,QAAQI,KAAK;IAClB;AACF,EAAE;AAEF,eAAeD,wBAAwB"}

package/src/open-api/ts-hooks/generator.spec.tsx

@@ -2,26 +2,26 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
-import { createTreeUsingTsSolutionSetup } from '../../utils/test';
-import { Spec } from '../utils/types';
-import { openApiTsHooksGenerator } from './generator';
-import { importTypeScriptModule } from '../../utils/js';
-import { waitFor, render, fireEvent } from '@testing-library/react';
+import type { Tree } from '@nx/devkit';
 import {
   QueryClient,
   QueryClientProvider,
-  useQuery,
-  useMutation,
+  type UseInfiniteQueryResult,
+  type UseMutationResult,
+  type UseQueryResult,
   useInfiniteQuery,
-  UseQueryResult,
-  UseInfiniteQueryResult,
-  UseMutationResult,
+  useMutation,
+  useQuery,
 } from '@tanstack/react-query';
-import React from 'react';
-import { Mock } from 'vitest';
-import { PET_STORE_SPEC } from '../ts-client/generator.petstore.spec';
+import { fireEvent, render, waitFor } from '@testing-library/react';
+import type React from 'react';
+import type { Mock } from 'vitest';
+import { importTypeScriptModule } from '../../utils/js';
+import { createTreeUsingTsSolutionSetup } from '../../utils/test';
 import { TypeScriptVerifier } from '../../utils/test/ts.spec';
+import { PET_STORE_SPEC } from '../ts-client/generator.petstore.spec';
+import type { Spec } from '../utils/types';
+import { openApiTsHooksGenerator } from './generator';
 
 describe('openApiTsHooksGenerator', () => {
   let tree: Tree;
@@ -1226,6 +1226,76 @@ describe('openApiTsHooksGenerator', () => {
     );
   });
 
+  it('should import the cursor model when the cursor parameter is a $ref', async () => {
+    // Regression: when the infinite-query cursor parameter is a $ref to a named
+    // schema (e.g. an enum), the options proxy references that model in the
+    // cursor type but must also import it, or the proxy fails to compile.
+    const spec: Spec = {
+      openapi: '3.0.0',
+      info: { title, version: '1.0.0' },
+      paths: {
+        '/records': {
+          get: {
+            ...{ 'x-cursor': 'token' },
+            operationId: 'listRecords',
+            parameters: [
+              {
+                name: 'token',
+                in: 'query',
+                required: false,
+                schema: { $ref: '#/components/schemas/PageToken' },
+              },
+            ],
+            responses: {
+              '200': {
+                description: 'ok',
+                content: {
+                  'application/json': {
+                    schema: {
+                      type: 'object',
+                      required: ['records'],
+                      properties: {
+                        records: { type: 'array', items: { type: 'string' } },
+                      },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+      components: {
+        schemas: {
+          PageToken: { type: 'string', enum: ['a', 'b', 'c'] },
+        },
+      },
+    };
+
+    tree.write('openapi.json', JSON.stringify(spec));
+
+    await openApiTsHooksGenerator(tree, {
+      openApiSpecPath: 'openapi.json',
+      outputPath: 'src/generated',
+    });
+
+    const optionsProxy = tree.read(
+      'src/generated/options-proxy.gen.ts',
+      'utf-8',
+    )!;
+    // The cursor model is used in the cursor type and imported from types.gen.
+    expect(optionsProxy).toContain('PageToken | undefined | null');
+    expect(optionsProxy).toMatch(
+      /import type \{[\s\S]*PageToken,[\s\S]*\} from '\.\/types\.gen\.js'/,
+    );
+
+    validateTypeScript([
+      'src/generated/client.gen.ts',
+      'src/generated/types.gen.ts',
+      'src/generated/options-proxy.gen.ts',
+    ]);
+  });
+
   it('should handle infinite query with custom cursor parameter via object vendor extension', async () => {
     const spec: Spec = {
       openapi: '3.0.0',

package/src/open-api/ts-hooks/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/open-api/ts-hooks/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/open-api/ts-hooks/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport interface OpenApiTsHooksGeneratorSchema {\n  openApiSpecPath: string;\n  outputPath: string;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAED,WAGC"}

package/src/open-api/ts-metadata/generator.d.ts

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
-import { OpenApiTsMetadataGeneratorSchema } from './schema';
-import { CodeGenData } from '../utils/codegen-data/types';
+import { type Tree } from '@nx/devkit';
+import type { CodeGenData } from '../utils/codegen-data/types';
+import type { OpenApiTsMetadataGeneratorSchema } from './schema';
 /**
  * Generates typescript metadata from an openapi spec
  */

package/src/open-api/ts-metadata/generator.js

@@ -1,30 +1,22 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateOpenApiTsMetadata = exports.openApiTsMetadataGenerator = void 0;
-const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const format_1 = require("../../utils/format");
-const path_1 = tslib_1.__importDefault(require("path"));
-const generator_1 = require("../ts-client/generator");
+ */ import { generateFiles } from "@nx/devkit";
+import path from "path";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { buildOpenApiCodeGenerationData } from "../ts-client/generator.js";
 /**
  * Generates typescript metadata from an openapi spec
- */
-const openApiTsMetadataGenerator = async (tree, options) => {
-    const data = await (0, generator_1.buildOpenApiCodeGenerationData)(tree, options.openApiSpecPath);
-    (0, exports.generateOpenApiTsMetadata)(tree, data, options.outputPath);
-    await (0, format_1.formatFilesInSubtree)(tree);
+ */ export const openApiTsMetadataGenerator = async (tree, options)=>{
+    const data = await buildOpenApiCodeGenerationData(tree, options.openApiSpecPath);
+    generateOpenApiTsMetadata(tree, data, options.outputPath);
+    await formatFilesInSubtree(tree);
 };
-exports.openApiTsMetadataGenerator = openApiTsMetadataGenerator;
 /**
  * Generate OpenAPI typescript metadata in the target directory
- */
-const generateOpenApiTsMetadata = (tree, data, outputPath) => {
-    (0, devkit_1.generateFiles)(tree, path_1.default.join(__dirname, 'files'), outputPath, data);
+ */ export const generateOpenApiTsMetadata = (tree, data, outputPath)=>{
+    generateFiles(tree, path.join(import.meta.dirname, 'files'), outputPath, data);
 };
-exports.generateOpenApiTsMetadata = generateOpenApiTsMetadata;
-exports.default = exports.openApiTsMetadataGenerator;
+export default openApiTsMetadataGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/open-api/ts-metadata/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/open-api/ts-metadata/generator.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,uCAAiD;AAEjD,+CAA0D;AAC1D,wDAAwB;AAExB,sDAAwE;AAExE;;GAEG;AACI,MAAM,0BAA0B,GAAG,KAAK,EAC7C,IAAU,EACV,OAAyC,EACzC,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,IAAA,0CAA8B,EAC/C,IAAI,EACJ,OAAO,CAAC,eAAe,CACxB,CAAC;IAEF,IAAA,iCAAyB,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAE1D,MAAM,IAAA,6BAAoB,EAAC,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAZW,QAAA,0BAA0B,8BAYrC;AAEF;;GAEG;AACI,MAAM,yBAAyB,GAAG,CACvC,IAAU,EACV,IAAiB,EACjB,UAAkB,EAClB,EAAE;IACF,IAAA,sBAAa,EAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC,CAAC;AANW,QAAA,yBAAyB,6BAMpC;AAEF,kBAAe,kCAA0B,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/open-api/ts-metadata/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { generateFiles, type Tree } from '@nx/devkit';\nimport path from 'path';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { buildOpenApiCodeGenerationData } from '../ts-client/generator';\nimport type { CodeGenData } from '../utils/codegen-data/types';\nimport type { OpenApiTsMetadataGeneratorSchema } from './schema';\n\n/**\n * Generates typescript metadata from an openapi spec\n */\nexport const openApiTsMetadataGenerator = async (\n  tree: Tree,\n  options: OpenApiTsMetadataGeneratorSchema,\n) => {\n  const data = await buildOpenApiCodeGenerationData(\n    tree,\n    options.openApiSpecPath,\n  );\n\n  generateOpenApiTsMetadata(tree, data, options.outputPath);\n\n  await formatFilesInSubtree(tree);\n};\n\n/**\n * Generate OpenAPI typescript metadata in the target directory\n */\nexport const generateOpenApiTsMetadata = (\n  tree: Tree,\n  data: CodeGenData,\n  outputPath: string,\n) => {\n  generateFiles(\n    tree,\n    path.join(import.meta.dirname, 'files'),\n    outputPath,\n    data,\n  );\n};\n\nexport default openApiTsMetadataGenerator;\n"],"names":["generateFiles","path","formatFilesInSubtree","buildOpenApiCodeGenerationData","openApiTsMetadataGenerator","tree","options","data","openApiSpecPath","generateOpenApiTsMetadata","outputPath","join","dirname"],"mappings":"AAAA;;;CAGC,GACD,SAASA,aAAa,QAAmB,aAAa;AACtD,OAAOC,UAAU,OAAO;AACxB,SAASC,oBAAoB,QAAQ,wBAAqB;AAC1D,SAASC,8BAA8B,QAAQ,4BAAyB;AAIxE;;CAEC,GACD,OAAO,MAAMC,6BAA6B,OACxCC,MACAC;IAEA,MAAMC,OAAO,MAAMJ,+BACjBE,MACAC,QAAQE,eAAe;IAGzBC,0BAA0BJ,MAAME,MAAMD,QAAQI,UAAU;IAExD,MAAMR,qBAAqBG;AAC7B,EAAE;AAEF;;CAEC,GACD,OAAO,MAAMI,4BAA4B,CACvCJ,MACAE,MACAG;IAEAV,cACEK,MACAJ,KAAKU,IAAI,CAAC,YAAYC,OAAO,EAAE,UAC/BF,YACAH;AAEJ,EAAE;AAEF,eAAeH,2BAA2B"}

package/src/open-api/ts-metadata/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/open-api/ts-metadata/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/open-api/ts-metadata/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport interface OpenApiTsMetadataGeneratorSchema {\n  openApiSpecPath: string;\n  outputPath: string;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAED,WAGC"}

package/src/open-api/utils/codegen-data/languages.d.ts

@@ -1,12 +1,10 @@
-import { Model } from './types';
 /**
- * Return the typescript type for the given model
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
  */
+import { type Model } from './types';
 export declare const toTypeScriptType: (property: Model) => string;
 export declare const toTypeScriptName: (name: string) => string;
 export declare const toTypeScriptModelName: (name: string) => string;
-/**
- * Return the python type for a given property
- */
 export declare const toPythonType: (property: Model) => string;
 export declare const toPythonName: (namedEntity: "model" | "property" | "operation", name: string) => string;