@automate.ax/integration-contracts 0.150.0 → 0.150.1

package/dist/kit/schemas.js

@@ -4,6 +4,13 @@ import * as z from "zod";
 import { KIT_OPENAPI_DATA } from "./openapi-operations.generated";
 /** Runtime Kit contract narrowed once from the opaque generated payload. */
 const operationData = KIT_OPENAPI_DATA;
+for (const operation of Object.values(operationData.operations)) {
+    if (typeof operation !== "object" || operation === null)
+        continue;
+    const record = operation;
+    normalizeObservedKitNulls(record.outputSchema);
+    normalizeObservedKitNulls(record.outputWireSchema);
+}
 const OPERATIONS = operationData.operations;
 const VALIDATOR = new Validator({
     $defs: operationData.definitions,
@@ -41,3 +48,53 @@ export function kitOperationOutputSchema(key) {
 }
 /** Provider-native component schemas used for schema-guided key mapping. */
 export const KIT_WIRE_DEFINITIONS = operationData.wireDefinitions;
+/**
+ * Accepts nullable fields observed in successful Kit responses but omitted from
+ * the provider's OpenAPI nullability metadata.
+ *
+ * @param value Generated operation metadata.
+ */
+function normalizeObservedKitNulls(value) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            normalizeObservedKitNulls(item);
+        return;
+    }
+    if (typeof value !== "object" || value === null)
+        return;
+    const record = value;
+    const properties = record.properties;
+    if (typeof properties === "object" && properties !== null) {
+        const propertyRecord = properties;
+        for (const name of [
+            "bio",
+            "byline",
+            "endCursor",
+            "end_cursor",
+            "startCursor",
+            "start_cursor",
+        ]) {
+            const property = propertyRecord[name];
+            if (typeof property !== "object" ||
+                property === null ||
+                isNullableSchema(property)) {
+                continue;
+            }
+            propertyRecord[name] = { anyOf: [property, { type: "null" }] };
+        }
+    }
+    for (const child of Object.values(record))
+        normalizeObservedKitNulls(child);
+}
+/**
+ * Returns whether one JSON Schema fragment already accepts null.
+ *
+ * @param value JSON Schema fragment.
+ */
+function isNullableSchema(value) {
+    const anyOf = value.anyOf;
+    return (Array.isArray(anyOf) &&
+        anyOf.some((branch) => typeof branch === "object" &&
+            branch !== null &&
+            branch.type === "null"));
+}

package/dist/kit/types.d.ts

@@ -28,6 +28,12 @@ type Simplify<TValue> = {
 type EncodableValue<TValue> = unknown extends TValue ? Encodable : TValue extends undefined | null | boolean | number | string ? TValue : TValue extends readonly (infer TItem)[] ? EncodableValue<TItem>[] : TValue extends object ? keyof TValue extends never ? Record<string, Encodable> : {
     [TKey in keyof TValue]: EncodableValue<TValue[TKey]>;
 } : never;
+/** Fields whose live Kit nullability is missing from its OpenAPI document. */
+type ObservedNullableField = "bio" | "byline" | "endCursor" | "startCursor";
+/** Adds nulls returned by Kit but omitted from its generated OpenAPI types. */
+type NormalizeObservedKitNulls<TValue> = TValue extends readonly (infer TItem)[] ? NormalizeObservedKitNulls<TItem>[] : TValue extends object ? {
+    [TKey in keyof TValue]: NormalizeObservedKitNulls<TValue[TKey]> | (TKey extends ObservedNullableField ? null : never);
+} : TValue;
 /** Flattens one generated operation's path, query, and body fields. */
 type RawKitOperationInput<TKey extends KitOperationKey> = Simplify<Parameters<Operation<TKey>, "path"> & Parameters<Operation<TKey>, "query"> & JsonBody<Operation<TKey>>>;
 /** Preserves operation unions and rejects fields on truly empty inputs. */
@@ -37,5 +43,5 @@ type PublicInput<TValue> = TValue extends unknown ? keyof TValue extends never ?
 /** Flattened camelCase input for one frozen Kit V4 operation. */
 export type KitOperationInput<TKey extends KitOperationKey> = PublicInput<RawKitOperationInput<TKey>>;
 /** CamelCase successful response for one frozen Kit V4 operation. */
-export type KitOperationOutput<TKey extends KitOperationKey> = EncodableValue<SuccessResponse<Operation<TKey>>>;
+export type KitOperationOutput<TKey extends KitOperationKey> = EncodableValue<NormalizeObservedKitNulls<SuccessResponse<Operation<TKey>>>>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.150.0",
+  "version": "0.150.1",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -71,7 +71,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.150.0",
+    "@automate.ax/codec": "0.150.1",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",

package/src/kit/schemas.ts

@@ -32,6 +32,12 @@ const operationData = KIT_OPENAPI_DATA as {
   operations: Record<string, unknown>
   wireDefinitions: Record<string, Record<string, unknown>>
 }
+for (const operation of Object.values(operationData.operations)) {
+  if (typeof operation !== "object" || operation === null) continue
+  const record = operation as Record<string, unknown>
+  normalizeObservedKitNulls(record.outputSchema)
+  normalizeObservedKitNulls(record.outputWireSchema)
+}
 const OPERATIONS = operationData.operations as unknown as Record<
   KitOperationKey,
   KitRuntimeOperation
@@ -91,3 +97,61 @@ export function kitOperationOutputSchema<TKey extends KitOperationKey>(
 
 /** Provider-native component schemas used for schema-guided key mapping. */
 export const KIT_WIRE_DEFINITIONS = operationData.wireDefinitions
+
+/**
+ * Accepts nullable fields observed in successful Kit responses but omitted from
+ * the provider's OpenAPI nullability metadata.
+ *
+ * @param value Generated operation metadata.
+ */
+function normalizeObservedKitNulls(value: unknown) {
+  if (Array.isArray(value)) {
+    for (const item of value) normalizeObservedKitNulls(item)
+    return
+  }
+  if (typeof value !== "object" || value === null) return
+
+  const record = value as Record<string, unknown>
+  const properties = record.properties
+  if (typeof properties === "object" && properties !== null) {
+    const propertyRecord = properties as Record<string, unknown>
+    for (const name of [
+      "bio",
+      "byline",
+      "endCursor",
+      "end_cursor",
+      "startCursor",
+      "start_cursor",
+    ]) {
+      const property = propertyRecord[name]
+      if (
+        typeof property !== "object" ||
+        property === null ||
+        isNullableSchema(property)
+      ) {
+        continue
+      }
+      propertyRecord[name] = { anyOf: [property, { type: "null" }] }
+    }
+  }
+
+  for (const child of Object.values(record)) normalizeObservedKitNulls(child)
+}
+
+/**
+ * Returns whether one JSON Schema fragment already accepts null.
+ *
+ * @param value JSON Schema fragment.
+ */
+function isNullableSchema(value: object) {
+  const anyOf = (value as { anyOf?: unknown }).anyOf
+  return (
+    Array.isArray(anyOf) &&
+    anyOf.some(
+      (branch) =>
+        typeof branch === "object" &&
+        branch !== null &&
+        (branch as { type?: unknown }).type === "null",
+    )
+  )
+}

package/src/kit/types.ts

@@ -60,6 +60,20 @@ type EncodableValue<TValue> = unknown extends TValue
           : { [TKey in keyof TValue]: EncodableValue<TValue[TKey]> }
         : never
 
+/** Fields whose live Kit nullability is missing from its OpenAPI document. */
+type ObservedNullableField = "bio" | "byline" | "endCursor" | "startCursor"
+
+/** Adds nulls returned by Kit but omitted from its generated OpenAPI types. */
+type NormalizeObservedKitNulls<TValue> = TValue extends readonly (infer TItem)[]
+  ? NormalizeObservedKitNulls<TItem>[]
+  : TValue extends object
+    ? {
+        [TKey in keyof TValue]:
+          | NormalizeObservedKitNulls<TValue[TKey]>
+          | (TKey extends ObservedNullableField ? null : never)
+      }
+    : TValue
+
 /** Flattens one generated operation's path, query, and body fields. */
 type RawKitOperationInput<TKey extends KitOperationKey> = Simplify<
   Parameters<Operation<TKey>, "path"> &
@@ -83,5 +97,5 @@ export type KitOperationInput<TKey extends KitOperationKey> = PublicInput<
 
 /** CamelCase successful response for one frozen Kit V4 operation. */
 export type KitOperationOutput<TKey extends KitOperationKey> = EncodableValue<
-  SuccessResponse<Operation<TKey>>
+  NormalizeObservedKitNulls<SuccessResponse<Operation<TKey>>>
 >