@stackwright-pro/openapi 0.3.0-alpha.5 → 0.3.0-alpha.6

package/dist/index.d.mts

@@ -110,6 +110,8 @@ interface OpenAPIConfig {
         slug_field: string;
         /** HTTP method for this collection endpoint — defaults to 'GET' */
         method?: string;
+        /** Transport protocol — 'websocket' collections are skipped during prebuild */
+        transport?: string;
         /** Optional filters */
         filters?: Record<string, unknown>;
     }>;

package/dist/index.d.ts

@@ -110,6 +110,8 @@ interface OpenAPIConfig {
         slug_field: string;
         /** HTTP method for this collection endpoint — defaults to 'GET' */
         method?: string;
+        /** Transport protocol — 'websocket' collections are skipped during prebuild */
+        transport?: string;
         /** Optional filters */
         filters?: Record<string, unknown>;
     }>;

package/dist/index.js

@@ -45,8 +45,18 @@ var OpenAPIParser = class {
         await SwaggerParser__default.default.validate(api);
       }
       let document;
+      let dereferenced = false;
       if (dereference) {
-        document = await SwaggerParser__default.default.dereference(api);
+        try {
+          document = await SwaggerParser__default.default.dereference(api);
+          dereferenced = true;
+        } catch {
+          console.warn(
+            `[OpenAPIParser] Warning: Could not fully dereference "${specPath}" (dangling $ref or circular ref). Proceeding without full dereferencing \u2014 some schema references may not resolve.`
+          );
+          document = api;
+          dereferenced = false;
+        }
       } else {
         document = api;
       }
@@ -54,7 +64,7 @@ var OpenAPIParser = class {
       return {
         document,
         version,
-        dereferenced: dereference
+        dereferenced
       };
     } catch (error) {
       throw this.enhanceError(error, specPath);
@@ -2841,6 +2851,23 @@ var OpenAPIPlugin = class {
   async processIntegration(config, projectRoot) {
     const { name, spec, auth, mockUrl, collections, endpoints, actions } = config;
     console.log(`  - Processing integration: ${name}`);
+    const httpCollections = (collections || []).filter((c) => {
+      if (c.transport === "websocket") {
+        console.warn(
+          `    > Skipping collection "${c.endpoint}" (transport: websocket \u2014 not yet supported)`
+        );
+        return false;
+      }
+      return true;
+    });
+    const hasEndpoints = endpoints && (endpoints.include?.length || endpoints.exclude?.length);
+    const hasActions = actions && actions.length > 0;
+    if (httpCollections.length === 0 && !hasEndpoints && !hasActions) {
+      console.log(
+        "    > No HTTP endpoints or REST collections found \u2014 skipping (WebSocket-only integration not yet supported)"
+      );
+      return;
+    }
     const specPath = spec.startsWith("http") ? spec : path2__default.default.resolve(projectRoot, spec);
     const parser = new OpenAPIParser();
     const { document } = await parser.parse(specPath);
@@ -2859,13 +2886,13 @@ var OpenAPIPlugin = class {
     fs2__default.default.mkdirSync(outputDir, { recursive: true });
     const schemaMapping = await this.generateSchemas(
       document,
-      collections || [],
+      httpCollections,
       outputDir,
       name,
       endpointFilter
     );
-    await this.generateTypes(document, collections || [], outputDir, name);
-    if (collections && collections.length > 0) {
+    await this.generateTypes(document, httpCollections, outputDir, name);
+    if (httpCollections.length > 0) {
       await this.generateProvider(document, config, outputDir, name);
     }
     await this.generateClient(document, outputDir, name, schemaMapping, endpointFilter);