@automate.ax/integration-contracts 0.150.0 → 0.150.2

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;
+    normalizeObservedKitSchema(record.outputSchema);
+    normalizeObservedKitSchema(record.outputWireSchema);
+}
 const OPERATIONS = operationData.operations;
 const VALIDATOR = new Validator({
     $defs: operationData.definitions,
@@ -41,3 +48,97 @@ export function kitOperationOutputSchema(key) {
 }
 /** Provider-native component schemas used for schema-guided key mapping. */
 export const KIT_WIRE_DEFINITIONS = operationData.wireDefinitions;
+/**
+ * Accepts successful Kit response variants omitted from its OpenAPI metadata.
+ *
+ * @param value Generated operation metadata.
+ */
+function normalizeObservedKitSchema(value) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            normalizeObservedKitSchema(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",
+            "emailTemplateId",
+            "email_template_id",
+            "endCursor",
+            "end_cursor",
+            "startCursor",
+            "start_cursor",
+            "valueHtml",
+            "value_html",
+        ]) {
+            const property = propertyRecord[name];
+            if (typeof property !== "object" ||
+                property === null ||
+                isNullableSchema(property)) {
+                continue;
+            }
+            propertyRecord[name] = { anyOf: [property, { type: "null" }] };
+        }
+        removeSpuriousCategoryRequirement(propertyRecord.fields);
+        acceptAllSubscribersFilter(record, propertyRecord);
+    }
+    for (const child of Object.values(record))
+        normalizeObservedKitSchema(child);
+}
+/**
+ * Removes a concrete example key incorrectly promoted into map requirements.
+ *
+ * @param value Generated map schema.
+ */
+function removeSpuriousCategoryRequirement(value) {
+    if (typeof value !== "object" || value === null)
+        return;
+    const record = value;
+    if (!("additionalProperties" in record) || !Array.isArray(record.required)) {
+        return;
+    }
+    record.required = record.required.filter((name) => name !== "category");
+}
+/**
+ * Accepts Kit's provider-native condition for an unfiltered broadcast.
+ *
+ * @param schema Generated condition schema.
+ * @param properties Generated condition properties.
+ */
+function acceptAllSubscribersFilter(schema, properties) {
+    const type = properties.type;
+    if (typeof type !== "object" ||
+        type === null ||
+        !("ids" in properties) ||
+        !Array.isArray(schema.required)) {
+        return;
+    }
+    const enumValues = type.enum;
+    if (!Array.isArray(enumValues) ||
+        enumValues.length !== 2 ||
+        !enumValues.includes("segment") ||
+        !enumValues.includes("tag")) {
+        return;
+    }
+    ;
+    type.enum = [...enumValues, "all_subscribers"];
+    schema.required = schema.required.filter((name) => name !== "ids");
+}
+/**
+ * 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

@@ -4,6 +4,8 @@ import type { KitOperationKey } from "./operation-manifest.js";
 type Operation<TKey extends KitOperationKey> = TKey extends keyof KitOperationMap ? KitOperationMap[TKey] : never;
 /** Converts absent generated operation sections into intersection identities. */
 type InputPart<TValue> = [NonNullable<TValue>] extends [never] ? unknown : NonNullable<TValue>;
+/** Converts generated empty JSON objects into intersection identities. */
+type JsonBodyPart<TValue> = TValue extends Record<string, never> ? unknown : TValue;
 type Parameters<TOperation, TLocation extends string> = TOperation extends {
     parameters?: infer TParameters;
 } ? TLocation extends keyof NonNullable<TParameters> ? InputPart<NonNullable<TParameters>[TLocation]> : unknown : unknown;
@@ -12,7 +14,7 @@ type JsonBody<TOperation> = TOperation extends {
     requestBody?: infer TBody;
 } ? [NonNullable<TBody>] extends [never] ? unknown : NonNullable<TBody> extends {
     content: infer TContent;
-} ? "application/json" extends keyof TContent ? TContent["application/json"] : unknown : unknown : unknown;
+} ? "application/json" extends keyof TContent ? JsonBodyPart<TContent["application/json"]> : unknown : unknown : unknown;
 /** Extracts the JSON response body from one generated response. */
 type JsonResponse<TResponse> = TResponse extends {
     content: infer TContent;
@@ -28,6 +30,21 @@ 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" | "emailTemplateId" | "endCursor" | "startCursor" | "valueHtml";
+/** Generated broadcast filter shape extended with Kit's unfiltered variant. */
+type BroadcastSubscriberFilterCondition = {
+    ids: number[];
+    type: "segment" | "tag";
+};
+type NormalizeObservedKitObject<TValue extends object> = {
+    [TKey in keyof TValue]: NormalizeObservedKitOutput<TValue[TKey]> | (TKey extends ObservedNullableField ? null : never);
+};
+/** Applies response variants observed in Kit but omitted from its OpenAPI. */
+type NormalizeObservedKitOutput<TValue> = TValue extends readonly (infer TItem)[] ? NormalizeObservedKitOutput<TItem>[] : TValue extends BroadcastSubscriberFilterCondition ? NormalizeObservedKitObject<TValue> | {
+    ids?: never;
+    type: "all_subscribers";
+} : TValue extends object ? NormalizeObservedKitObject<TValue> : 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 +54,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<NormalizeObservedKitOutput<SuccessResponse<Operation<TKey>>>>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.150.0",
+  "version": "0.150.2",
   "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.2",
     "@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>
+  normalizeObservedKitSchema(record.outputSchema)
+  normalizeObservedKitSchema(record.outputWireSchema)
+}
 const OPERATIONS = operationData.operations as unknown as Record<
   KitOperationKey,
   KitRuntimeOperation
@@ -91,3 +97,113 @@ export function kitOperationOutputSchema<TKey extends KitOperationKey>(
 
 /** Provider-native component schemas used for schema-guided key mapping. */
 export const KIT_WIRE_DEFINITIONS = operationData.wireDefinitions
+
+/**
+ * Accepts successful Kit response variants omitted from its OpenAPI metadata.
+ *
+ * @param value Generated operation metadata.
+ */
+function normalizeObservedKitSchema(value: unknown) {
+  if (Array.isArray(value)) {
+    for (const item of value) normalizeObservedKitSchema(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",
+      "emailTemplateId",
+      "email_template_id",
+      "endCursor",
+      "end_cursor",
+      "startCursor",
+      "start_cursor",
+      "valueHtml",
+      "value_html",
+    ]) {
+      const property = propertyRecord[name]
+      if (
+        typeof property !== "object" ||
+        property === null ||
+        isNullableSchema(property)
+      ) {
+        continue
+      }
+      propertyRecord[name] = { anyOf: [property, { type: "null" }] }
+    }
+
+    removeSpuriousCategoryRequirement(propertyRecord.fields)
+    acceptAllSubscribersFilter(record, propertyRecord)
+  }
+
+  for (const child of Object.values(record)) normalizeObservedKitSchema(child)
+}
+
+/**
+ * Removes a concrete example key incorrectly promoted into map requirements.
+ *
+ * @param value Generated map schema.
+ */
+function removeSpuriousCategoryRequirement(value: unknown) {
+  if (typeof value !== "object" || value === null) return
+  const record = value as Record<string, unknown>
+  if (!("additionalProperties" in record) || !Array.isArray(record.required)) {
+    return
+  }
+  record.required = record.required.filter((name) => name !== "category")
+}
+
+/**
+ * Accepts Kit's provider-native condition for an unfiltered broadcast.
+ *
+ * @param schema Generated condition schema.
+ * @param properties Generated condition properties.
+ */
+function acceptAllSubscribersFilter(
+  schema: Record<string, unknown>,
+  properties: Record<string, unknown>,
+) {
+  const type = properties.type
+  if (
+    typeof type !== "object" ||
+    type === null ||
+    !("ids" in properties) ||
+    !Array.isArray(schema.required)
+  ) {
+    return
+  }
+  const enumValues = (type as { enum?: unknown }).enum
+  if (
+    !Array.isArray(enumValues) ||
+    enumValues.length !== 2 ||
+    !enumValues.includes("segment") ||
+    !enumValues.includes("tag")
+  ) {
+    return
+  }
+  ;(type as { enum: unknown[] }).enum = [...enumValues, "all_subscribers"]
+  schema.required = schema.required.filter((name) => name !== "ids")
+}
+
+/**
+ * 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

@@ -10,6 +10,10 @@ type InputPart<TValue> = [NonNullable<TValue>] extends [never]
   ? unknown
   : NonNullable<TValue>
 
+/** Converts generated empty JSON objects into intersection identities. */
+type JsonBodyPart<TValue> =
+  TValue extends Record<string, never> ? unknown : TValue
+
 type Parameters<TOperation, TLocation extends string> = TOperation extends {
   parameters?: infer TParameters
 }
@@ -24,7 +28,7 @@ type JsonBody<TOperation> = TOperation extends { requestBody?: infer TBody }
     ? unknown
     : NonNullable<TBody> extends { content: infer TContent }
       ? "application/json" extends keyof TContent
-        ? TContent["application/json"]
+        ? JsonBodyPart<TContent["application/json"]>
         : unknown
       : unknown
   : unknown
@@ -60,6 +64,39 @@ 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"
+  | "emailTemplateId"
+  | "endCursor"
+  | "startCursor"
+  | "valueHtml"
+
+/** Generated broadcast filter shape extended with Kit's unfiltered variant. */
+type BroadcastSubscriberFilterCondition = {
+  ids: number[]
+  type: "segment" | "tag"
+}
+
+type NormalizeObservedKitObject<TValue extends object> = {
+  [TKey in keyof TValue]:
+    | NormalizeObservedKitOutput<TValue[TKey]>
+    | (TKey extends ObservedNullableField ? null : never)
+}
+
+/** Applies response variants observed in Kit but omitted from its OpenAPI. */
+type NormalizeObservedKitOutput<TValue> =
+  TValue extends readonly (infer TItem)[]
+    ? NormalizeObservedKitOutput<TItem>[]
+    : TValue extends BroadcastSubscriberFilterCondition
+      ?
+          | NormalizeObservedKitObject<TValue>
+          | { ids?: never; type: "all_subscribers" }
+      : TValue extends object
+        ? NormalizeObservedKitObject<TValue>
+        : TValue
+
 /** Flattens one generated operation's path, query, and body fields. */
 type RawKitOperationInput<TKey extends KitOperationKey> = Simplify<
   Parameters<Operation<TKey>, "path"> &
@@ -83,5 +120,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>>
+  NormalizeObservedKitOutput<SuccessResponse<Operation<TKey>>>
 >