@celigo/api-specs 0.2.178 → 0.2.179

package/dist/export.yml

@@ -8025,11 +8025,13 @@ components:
           It defines how data is extracted from Salesforce,
           either through queries or real-time events.
         - |-
-          Always set `type` on new Salesforce exports (`soql` or `distributed`) —
-          the form always writes it. It is absent only from legacy real-time
-          exports created before the field existed, and file/byId retrievals
-          (`id` + `sObjectType`, no `soql` object) carry `type: soql` without a
-          `soql` object.
+          Set `type` on every Salesforce export you create (`soql` or `distributed`).
+          Never read its absence on an existing export as a defect: a listener saved
+          from the integrator.io form carries no `salesforce.type` and the platform
+          fires it without the field, and file/byId retrievals (`id` + `sObjectType`,
+          no `soql` object) carry `type: soql` without a `soql` object. A listener
+          that never creates a job is diagnosed from `distributed` (below), not from
+          this field.
         - |-
           ## SALESFORCE EXPORT MODES
 
@@ -8061,8 +8063,10 @@ components:
             Required fields: type, soql.query
             Optional fields: api, includeDeletedRecords, bulk (when api="bulk")
 
-          - For Distributed exports (type="distributed"):
-            Required fields: type, distributed configuration
+          - For Distributed exports (real-time listeners):
+            Set type="distributed" with the distributed object and sObjectType when creating one.
+            A listener saved from the integrator.io form carries the distributed object and
+            sObjectType with no type, and the platform fires it — a valid listener, not a missing field.
             Optional fields: distributed.referencedFields, distributed.qualifier
 
           - For Blob exports (when export.type="blob"):
@@ -8078,7 +8082,10 @@ components:
 
               This field determines the core operating mode of the Salesforce export:
 
-              - REQUIRED for all Salesforce exports
+              - Set it on every Salesforce export you create; a listener saved from the
+                integrator.io form carries none and the platform fires it without the
+                field, so an absent `type` beside a `distributed` object is the normal
+                shape of a form-saved listener, not a missing setting
               - Controls which additional configuration objects must be provided
               - Affects how the export appears and functions in the flow builder UI
               - Cannot be changed after creation without significant reconfiguration
@@ -8573,7 +8580,7 @@ components:
                 - SELECT Id, Name, (SELECT Id, FirstName, LastName FROM Contacts) FROM Account
         distributed:
           type: object
-          description: Real-time listener configuration; required when `type` is `distributed` and not used otherwise. Records reach the flow only when an Apex trigger on `sObjectType` in the connected org calls the Celigo package (`integrator_da__.RealTimeExporter.processExport()`) — no scheduling or manual execution is involved. Integration Apps create their triggers at installation; for a custom flow the customer deploys the trigger in Salesforce, starting from the code the export page shows under Required trigger.
+          description: 'Real-time listener configuration — the object that makes an export a listener. Set it, with `type: distributed`, when creating one; a listener saved from the integrator.io form carries it with no `type`, and the platform fires it either way. Not used on SOQL or file exports. Records reach the flow only when an Apex trigger on `sObjectType` in the connected org calls the Celigo package (`integrator_da__.RealTimeExporter.processExport()`) — no scheduling or manual execution is involved. Integration Apps create their triggers at installation; for a custom flow the customer deploys the trigger in Salesforce, starting from the code the export page shows under Required trigger.'
           x-celigo-ai-guidance:
             - |-
               After creating a listener on a custom flow, relay what the Help Center's "Listen for real-time data
@@ -8588,6 +8595,12 @@ components:
               Help Center's trigger requirement in the connected org: an active Apex trigger on the object whose
               code calls `integrator_da__.RealTimeExporter`, and the Celigo package reachable through the
               connection (`GET /v1/connections/{_id}/distributed`, documented in this spec set).
+            - |-
+              Two things are never why a listener does not fire. The export preview cannot run a listener:
+              it validates the body as a SOQL export and answers 422 `missing_required_field` for
+              `soql.query` (and for `type` when the listener carries none) before the connection is used,
+              so a failed preview is expected, not a configuration defect. And an absent `salesforce.type`
+              is the normal shape of a listener saved from the integrator.io form (see `type`).
           properties:
             referencedFields:
               type:

package/dist/tool.yml

@@ -33046,11 +33046,13 @@ components:
           It defines how data is extracted from Salesforce,
           either through queries or real-time events.
         - |-
-          Always set `type` on new Salesforce exports (`soql` or `distributed`) —
-          the form always writes it. It is absent only from legacy real-time
-          exports created before the field existed, and file/byId retrievals
-          (`id` + `sObjectType`, no `soql` object) carry `type: soql` without a
-          `soql` object.
+          Set `type` on every Salesforce export you create (`soql` or `distributed`).
+          Never read its absence on an existing export as a defect: a listener saved
+          from the integrator.io form carries no `salesforce.type` and the platform
+          fires it without the field, and file/byId retrievals (`id` + `sObjectType`,
+          no `soql` object) carry `type: soql` without a `soql` object. A listener
+          that never creates a job is diagnosed from `distributed` (below), not from
+          this field.
         - |-
           ## SALESFORCE EXPORT MODES
 
@@ -33082,8 +33084,10 @@ components:
             Required fields: type, soql.query
             Optional fields: api, includeDeletedRecords, bulk (when api="bulk")
 
-          - For Distributed exports (type="distributed"):
-            Required fields: type, distributed configuration
+          - For Distributed exports (real-time listeners):
+            Set type="distributed" with the distributed object and sObjectType when creating one.
+            A listener saved from the integrator.io form carries the distributed object and
+            sObjectType with no type, and the platform fires it — a valid listener, not a missing field.
             Optional fields: distributed.referencedFields, distributed.qualifier
 
           - For Blob exports (when export.type="blob"):
@@ -33099,7 +33103,10 @@ components:
 
               This field determines the core operating mode of the Salesforce export:
 
-              - REQUIRED for all Salesforce exports
+              - Set it on every Salesforce export you create; a listener saved from the
+                integrator.io form carries none and the platform fires it without the
+                field, so an absent `type` beside a `distributed` object is the normal
+                shape of a form-saved listener, not a missing setting
               - Controls which additional configuration objects must be provided
               - Affects how the export appears and functions in the flow builder UI
               - Cannot be changed after creation without significant reconfiguration
@@ -33594,7 +33601,7 @@ components:
                 - SELECT Id, Name, (SELECT Id, FirstName, LastName FROM Contacts) FROM Account
         distributed:
           type: object
-          description: Real-time listener configuration; required when `type` is `distributed` and not used otherwise. Records reach the flow only when an Apex trigger on `sObjectType` in the connected org calls the Celigo package (`integrator_da__.RealTimeExporter.processExport()`) — no scheduling or manual execution is involved. Integration Apps create their triggers at installation; for a custom flow the customer deploys the trigger in Salesforce, starting from the code the export page shows under Required trigger.
+          description: 'Real-time listener configuration — the object that makes an export a listener. Set it, with `type: distributed`, when creating one; a listener saved from the integrator.io form carries it with no `type`, and the platform fires it either way. Not used on SOQL or file exports. Records reach the flow only when an Apex trigger on `sObjectType` in the connected org calls the Celigo package (`integrator_da__.RealTimeExporter.processExport()`) — no scheduling or manual execution is involved. Integration Apps create their triggers at installation; for a custom flow the customer deploys the trigger in Salesforce, starting from the code the export page shows under Required trigger.'
           x-celigo-ai-guidance:
             - |-
               After creating a listener on a custom flow, relay what the Help Center's "Listen for real-time data
@@ -33609,6 +33616,12 @@ components:
               Help Center's trigger requirement in the connected org: an active Apex trigger on the object whose
               code calls `integrator_da__.RealTimeExporter`, and the Celigo package reachable through the
               connection (`GET /v1/connections/{_id}/distributed`, documented in this spec set).
+            - |-
+              Two things are never why a listener does not fire. The export preview cannot run a listener:
+              it validates the body as a SOQL export and answers 422 `missing_required_field` for
+              `soql.query` (and for `type` when the listener carries none) before the connection is used,
+              so a failed preview is expected, not a configuration defect. And an absent `salesforce.type`
+              is the normal shape of a listener saved from the integrator.io form (see `type`).
           properties:
             referencedFields:
               type:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.178",
+  "version": "0.2.179",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,7 +1,7 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "d78b4324",
+		"iasCommit": "9951106d",
 		"generatedAt": "2026-10-22"
 	},
 	"roots": {