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

package/dist/index.mjs

@@ -92,6 +92,19 @@ var OpenAPIParser = class {
 };
 
 // src/parser/SchemaResolver.ts
+var SUPPORTED_CONTENT_TYPES = [
+  "application/json",
+  "application/geo+json",
+  // GeoJSON (ORS, mapping APIs)
+  "application/vnd.api+json",
+  // JSON:API
+  "application/ld+json",
+  // JSON-LD
+  "application/problem+json",
+  // RFC 7807 problem details
+  "*/*"
+  // wildcard fallback
+];
 var SchemaResolver = class {
   /**
    * @param document - Fully dereferenced OpenAPI document. Pass the result of
@@ -124,16 +137,19 @@ var SchemaResolver = class {
     const extractSchema = (responseCode) => {
       const response = responses[responseCode];
       if (!response) return void 0;
-      const content = response.content?.["application/json"];
-      const schema = content?.schema;
-      if (!schema) return void 0;
-      if ("$ref" in schema) {
-        console.warn(
-          `[SchemaResolver] Unresolved $ref in schema for ${path3}. Ensure the document is fully dereferenced before passing to SchemaResolver.`
-        );
+      for (const contentType of SUPPORTED_CONTENT_TYPES) {
+        const content = response.content?.[contentType];
+        if (!content?.schema) continue;
+        const schema = content.schema;
+        if ("$ref" in schema) {
+          console.warn(
+            `[SchemaResolver] Unresolved $ref in schema for ${path3}. Ensure the document is fully dereferenced before passing to SchemaResolver.`
+          );
+          return schema;
+        }
         return schema;
       }
-      return schema;
+      return void 0;
     };
     const preferred = extractSchema(preferredResponseCode);
     if (preferred) return preferred;
@@ -544,9 +560,12 @@ var CollectionProviderGenerator = class {
     const resolver = new SchemaResolver(this.document);
     const schema = resolver.getResponseSchema(endpoint, method);
     if (!schema) {
-      throw new Error(`No response schema found for ${method.toUpperCase()} ${endpoint}`);
+      console.warn(
+        `    > No response schema found for ${method.toUpperCase()} ${endpoint} \u2014 falling back to z.unknown()`
+      );
     }
-    const isArray = schema.type === "array";
+    const isArray = schema != null ? schema.type === "array" : false;
+    const unknownFallback = schema == null;
     const schemaName = `${this.capitalize(collectionName)}Schema`;
     const params = {
       providerName,
@@ -557,6 +576,7 @@ var CollectionProviderGenerator = class {
       baseUrl,
       schemaName,
       isArray,
+      unknownFallback,
       bare
     };
     if (auth !== void 0) {
@@ -578,13 +598,17 @@ var CollectionProviderGenerator = class {
       auth,
       schemaName,
       isArray,
+      unknownFallback,
       bare
     } = params;
     const authHeader = this.generateAuthHeader(auth);
     const arraySchemaName = `${schemaName.replace(/Schema$/, "")}ArraySchema`;
-    const validationSchema = isArray ? arraySchemaName : schemaName;
-    const imports = bare ? "" : `import type { CollectionProvider, CollectionItem } from '@stackwright/collections';
-import { ${isArray ? arraySchemaName : schemaName}} } from './schemas';
+    const validationSchema = unknownFallback ? "z.unknown()" : isArray ? arraySchemaName : schemaName;
+    const imports = bare ? "" : unknownFallback ? `import type { CollectionProvider, CollectionItem } from '@stackwright/collections';
+import { z } from 'zod';
+
+` : `import type { CollectionProvider, CollectionItem } from '@stackwright/collections';
+import { ${isArray ? arraySchemaName : schemaName} } from './schemas';
 
 `;
     return `${imports}/**
@@ -648,7 +672,7 @@ export class ${providerName} implements CollectionProvider {
    * Get a single item by slug
    */
   async get(slug: string): Promise<CollectionItem | null> {
-    ${this.generateGetMethod(endpoint, slugField, isArray, collectionName, schemaName)}
+    ${this.generateGetMethod(endpoint, slugField, isArray, collectionName, schemaName, unknownFallback)}
   }
 
   /**
@@ -684,7 +708,8 @@ export class ${providerName} implements CollectionProvider {
   /**
    * Generate get method implementation
    */
-  generateGetMethod(endpoint, slugField, isArray, collectionName, schemaName) {
+  generateGetMethod(endpoint, slugField, isArray, collectionName, schemaName, unknownFallback = false) {
+    const validationExpr = unknownFallback ? "z.unknown()" : schemaName;
     if (endpoint.includes("{id}") || endpoint.includes(":id")) {
       const detailEndpoint = endpoint.replace("{id}", "${slug}").replace(":id", "${slug}");
       return `const url = \`\${this.baseUrl}${detailEndpoint}\`;
@@ -702,7 +727,7 @@ export class ${providerName} implements CollectionProvider {
     }
 
     const data = await response.json();
-    const validated = ${schemaName}.parse(data);
+    const validated = ${validationExpr}.parse(data);
     
     return this.toCollectionItem(validated);`;
     } else {