@automate.ax/integration-contracts 0.150.1 → 0.150.2

package/dist/kit/schemas.js

@@ -8,8 +8,8 @@ for (const operation of Object.values(operationData.operations)) {
     if (typeof operation !== "object" || operation === null)
         continue;
     const record = operation;
-    normalizeObservedKitNulls(record.outputSchema);
-    normalizeObservedKitNulls(record.outputWireSchema);
+    normalizeObservedKitSchema(record.outputSchema);
+    normalizeObservedKitSchema(record.outputWireSchema);
 }
 const OPERATIONS = operationData.operations;
 const VALIDATOR = new Validator({
@@ -49,15 +49,14 @@ 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.
+ * Accepts successful Kit response variants omitted from its OpenAPI metadata.
  *
  * @param value Generated operation metadata.
  */
-function normalizeObservedKitNulls(value) {
+function normalizeObservedKitSchema(value) {
     if (Array.isArray(value)) {
         for (const item of value)
-            normalizeObservedKitNulls(item);
+            normalizeObservedKitSchema(item);
         return;
     }
     if (typeof value !== "object" || value === null)
@@ -69,10 +68,14 @@ function normalizeObservedKitNulls(value) {
         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" ||
@@ -82,9 +85,50 @@ function normalizeObservedKitNulls(value) {
             }
             propertyRecord[name] = { anyOf: [property, { type: "null" }] };
         }
+        removeSpuriousCategoryRequirement(propertyRecord.fields);
+        acceptAllSubscribersFilter(record, propertyRecord);
     }
     for (const child of Object.values(record))
-        normalizeObservedKitNulls(child);
+        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.

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;
@@ -29,11 +31,20 @@ type EncodableValue<TValue> = unknown extends TValue ? Encodable : TValue extend
     [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;
+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. */
@@ -43,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<NormalizeObservedKitNulls<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.1",
+  "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.1",
+    "@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

@@ -35,8 +35,8 @@ const operationData = KIT_OPENAPI_DATA as {
 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)
+  normalizeObservedKitSchema(record.outputSchema)
+  normalizeObservedKitSchema(record.outputWireSchema)
 }
 const OPERATIONS = operationData.operations as unknown as Record<
   KitOperationKey,
@@ -99,14 +99,13 @@ export function kitOperationOutputSchema<TKey extends KitOperationKey>(
 export const KIT_WIRE_DEFINITIONS = operationData.wireDefinitions
 
 /**
- * Accepts nullable fields observed in successful Kit responses but omitted from
- * the provider's OpenAPI nullability metadata.
+ * Accepts successful Kit response variants omitted from its OpenAPI metadata.
  *
  * @param value Generated operation metadata.
  */
-function normalizeObservedKitNulls(value: unknown) {
+function normalizeObservedKitSchema(value: unknown) {
   if (Array.isArray(value)) {
-    for (const item of value) normalizeObservedKitNulls(item)
+    for (const item of value) normalizeObservedKitSchema(item)
     return
   }
   if (typeof value !== "object" || value === null) return
@@ -118,10 +117,14 @@ function normalizeObservedKitNulls(value: 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 (
@@ -133,9 +136,58 @@ function normalizeObservedKitNulls(value: unknown) {
       }
       propertyRecord[name] = { anyOf: [property, { type: "null" }] }
     }
+
+    removeSpuriousCategoryRequirement(propertyRecord.fields)
+    acceptAllSubscribersFilter(record, propertyRecord)
   }
 
-  for (const child of Object.values(record)) normalizeObservedKitNulls(child)
+  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")
 }
 
 /**

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
@@ -61,18 +65,37 @@ type EncodableValue<TValue> = unknown extends TValue
         : 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
+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<
@@ -97,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<
-  NormalizeObservedKitNulls<SuccessResponse<Operation<TKey>>>
+  NormalizeObservedKitOutput<SuccessResponse<Operation<TKey>>>
 >