@kubb/oas 4.15.1 → 4.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/oas",
-  "version": "4.15.1",
+  "version": "4.16.0",
   "description": "OpenAPI Specification (OAS) utilities and helpers for Kubb, providing parsing, normalization, and manipulation of OpenAPI/Swagger schemas.",
   "keywords": [
     "openapi",
@@ -48,15 +48,15 @@
     }
   ],
   "dependencies": {
-    "@redocly/openapi-core": "^2.14.4",
+    "@redocly/openapi-core": "^2.14.5",
     "json-schema-to-ts": "^3.1.1",
     "jsonpointer": "^5.0.1",
     "oas": "^28.8.3",
     "oas-normalize": "^15.7.0",
     "openapi-types": "^12.1.3",
-    "remeda": "^2.33.1",
+    "remeda": "^2.33.2",
     "swagger2openapi": "^7.0.8",
-    "@kubb/core": "4.15.1"
+    "@kubb/core": "4.16.0"
   },
   "devDependencies": {
     "@stoplight/yaml": "^4.3.0",

package/src/index.ts

@@ -2,6 +2,7 @@ export { findSchemaDefinition, matchesMimeType } from 'oas/utils'
 export { Oas } from './Oas.ts'
 export * from './types.ts'
 export {
+  isAllOptional,
   isDiscriminator,
   isNullable,
   isOpenApiV3_1Document,

package/src/utils.ts

@@ -76,6 +76,35 @@ export function isRequired(schema?: SchemaObject): boolean {
   return Array.isArray(schema.required) ? !!schema.required?.length : !!schema.required
 }
 
+// Helper to determine if a schema (and its composed children) has no required fields
+// This prefers structural optionality over top-level optional flag
+type JSONSchemaLike =
+  | {
+      required?: readonly string[]
+      allOf?: readonly unknown[]
+      anyOf?: readonly unknown[]
+      oneOf?: readonly unknown[]
+    }
+  | undefined
+
+//TODO make isAllOptional more like isOptional with better typings
+export function isAllOptional(schema: unknown): boolean {
+  // If completely absent, consider it optional in context of defaults
+  if (!schema) return true
+  // If the entire schema itself is optional, it's safe to default
+  if (isOptional(schema)) return true
+
+  const s = schema as JSONSchemaLike
+  const hasRequired = Array.isArray(s?.required) && s?.required.length > 0
+  if (hasRequired) return false
+
+  const groups = [s?.allOf, s?.anyOf, s?.oneOf].filter((g): g is readonly unknown[] => Array.isArray(g))
+  if (groups.length === 0) return true
+
+  // Be conservative: only when all composed parts are all-optional we treat it as all-optional
+  return groups.every((arr) => arr.every((child) => isAllOptional(child)))
+}
+
 export function isOptional(schema?: SchemaObject): boolean {
   return !isRequired(schema)
 }