chore: avoid a circular dep

Author: maxholman

lib/ApiLowLevel.ts

@@ -0,0 +1,15 @@
+import { Construct, type IConstruct } from 'constructs';
+import type { Api } from './api.js';
+
+export class ApiLowLevel extends Construct {
+  public static of(c: IConstruct): Api {
+    const { scope } = c.node;
+
+    if (!scope) {
+      // Api is the only construct without a scope.
+      return c as Api;
+    }
+
+    return ApiLowLevel.of(scope);
+  }
+}

lib/api.ts

@@ -1,6 +1,7 @@
 import { Construct, type IConstruct } from 'constructs';
 import type { JSONSchema7 } from 'json-schema';
 import type { OpenAPIV3_1 } from 'openapi-types';
+import { ApiLowLevel } from './ApiLowLevel.js';
 import { Parameter } from './parameter.js';
 import { Path } from './path.js';
 import { Reference } from './reference.js';
@@ -19,7 +20,7 @@ export interface ApiOptions {
   info: OpenAPIV3_1.InfoObject;
 }
 
-export class Api extends Construct {
+export class Api extends ApiLowLevel {
   private options: ApiOptions;
 
   constructor(options: ApiOptions) {
@@ -29,17 +30,6 @@ export class Api extends Construct {
     this.options = options;
   }
 
-  public static of(c: IConstruct): Api {
-    const { scope } = c.node;
-
-    if (!scope) {
-      // Api is the only construct without a scope.
-      return c as Api;
-    }
-
-    return Api.of(scope);
-  }
-
   public synth() {
     return {
       openapi: this.options.openapi,

lib/reference.ts

@@ -1,7 +1,7 @@
 import { Construct } from 'constructs';
 import type { OpenAPIV3_1 } from 'openapi-types';
+import { ApiLowLevel } from './ApiLowLevel.js';
 import { Schema } from './schema.js';
-import { Api } from './api.js';
 
 type Target = Schema; // | Parameter;
 
@@ -10,7 +10,8 @@ export class Reference<T extends Target> extends Construct {
 
   constructor(target: T, id: string) {
     super(target, id);
-    this.schema = new Schema(Api.of(this), id, {
+    // NOTE: Api.of causes a circular dependency
+    this.schema = new Schema(ApiLowLevel.of(this), id, {
       // NOTE: synth because refs are not valid as #/component/schemas
       // if it did, we could use referenceObject here instead
       schema: target.synth(),