@celigo/api-specs 0.2.195 → 0.2.197

package/dist/asynchelper.yml

@@ -875,7 +875,9 @@ components:
             - statusMapping
             - departmentCodes
         hardCodedValue:
-          type: string
+          type:
+            - string
+            - 'null'
           description: |
             Constant written to the destination instead of an extracted value. On a primitive
             array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -883,6 +885,8 @@ components:
             On an `object` it must be a JSON object string and on an `objectarray` a JSON array
             string (an object string becomes one element); the save parses it and refuses non-JSON
             or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+            JSON `null` writes the destination field as null; it is what the mapper saves for its
+            hard-coded "Use null as default value" choice.
           examples:
             - USD
             - A,B
@@ -1969,7 +1973,9 @@ components:
               - statusMapping
               - departmentCodes
           hardCodedValue:
-            type: string
+            type:
+              - string
+              - 'null'
             description: |
               Constant written to the destination instead of an extracted value. On a primitive
               array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -1977,6 +1983,8 @@ components:
               On an `object` it must be a JSON object string and on an `objectarray` a JSON array
               string (an object string becomes one element); the save parses it and refuses non-JSON
               or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+              JSON `null` writes the destination field as null; it is what the mapper saves for its
+              hard-coded "Use null as default value" choice.
             examples:
               - USD
               - A,B

package/dist/export.yml

@@ -5908,9 +5908,13 @@ components:
           type: string
           description: |-
             Bearer token that a system pushing data into this export sends as
-            `Authorization: Bearer <token>`. Optional — most distributed listeners (NetSuite,
-            Salesforce real-time) use no token. Write-only and stored encrypted; treat it as a
-            sensitive credential.
+            `Authorization: Bearer <token>`. Optional — Salesforce real-time listeners use no token.
+            For a NetSuite listener the platform generates it when the export is saved as a listener,
+            writes it to the listener's registration record in NetSuite, and generates a new one only
+            when a save re-creates the listener (a `type` change back to `distributed`) — never on a
+            flow toggle or another `PUT`; a client sets and keeps a value itself only for a system of
+            its own that pushes to the export's data endpoint. Stored encrypted and returned masked;
+            treat it as a sensitive credential.
           format: password
           examples:
             - eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
@@ -11242,6 +11246,16 @@ components:
               `netsuite.type: distributed`. Saving it creates a user event script deployment on the
               record type that runs after submit, so records arrive only when NetSuite saves one and
               `POST /v1/exports/preview` cannot sample it.
+            - |-
+              Saving the listener also registers it in NetSuite (the SuiteApp's record for this export,
+              holding its record type, contexts, types, qualifier, endpoint URL and token); a `PUT` that
+              keeps the export a listener re-pushes those fields, leaves the token as it is, and sets
+              the registration's disabled state from the body's `distributed.disabled` (omitted means
+              inactive). A `PUT` that changes `type` to a scheduled value leaves that
+              registration in place and active — NetSuite keeps queuing qualifying saves for an export
+              that no longer listens — so remove or disable the listener's flow rather than converting
+              the step in place, and never treat the conversion as reversible without re-checking
+              `distributed.disabled` afterwards.
           properties:
             recordType:
               type: string
@@ -11315,15 +11329,26 @@ components:
             disabled:
               type: boolean
               description: |-
-                When true, the listener's NetSuite deployment is inactive and record saves no longer
-                trigger the export. Maintained by the platform as the flow is disabled and re-enabled;
-                re-enabling the flow re-registers the deployment. A listener is created disabled, and
-                a flow created already enabled leaves it that way until a flow update sets
-                `disabled: false`, which activates it within seconds.
+                When true, the listener's NetSuite registration is inactive and record saves no longer
+                trigger the export. The platform keeps it in step with the flow — enabling the flow sets
+                it false within seconds, disabling or deleting the flow sets it true — and every save
+                that leaves the export a listener (a create, a `PUT` that keeps it a listener, a `PUT`
+                that makes it `distributed` again after another type) applies the body's value, an
+                omitted field meaning true: a listener is created disabled, a flow created already
+                enabled leaves it so until a flow update sets `disabled: false`, and a `PUT` that omits
+                the field inactivates it.
               x-celigo-ai-guidance:
                 - |-
-                  Pause a listener by disabling its flow, not by setting this field. A listener that has
+                  Pause or resume a listener by disabling or enabling its flow; the field follows. Every
+                  `PUT` of a listener on an enabled flow must carry `disabled: false` — an omitted field or
+                  a stale `true` inactivates the NetSuite registration while the flow stays enabled (the
+                  UI never hits this because it writes back the document it read). A listener that has
                   stopped firing is re-registered by disabling and re-enabling the flow.
+                - |-
+                  A `PUT` that changes `type` back to `distributed` after the export was another type
+                  re-creates the listener: send `disabled: false` when the flow is enabled, or it comes
+                  back inactive until a follow-up `PUT` with `disabled: false` or a disable and re-enable
+                  of the flow activates it.
             executionType:
               type: array
               description: |-
@@ -12936,7 +12961,9 @@ components:
             - statusMapping
             - departmentCodes
         hardCodedValue:
-          type: string
+          type:
+            - string
+            - 'null'
           description: |
             Constant written to the destination instead of an extracted value. On a primitive
             array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -12944,6 +12971,8 @@ components:
             On an `object` it must be a JSON object string and on an `objectarray` a JSON array
             string (an object string becomes one element); the save parses it and refuses non-JSON
             or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+            JSON `null` writes the destination field as null; it is what the mapper saves for its
+            hard-coded "Use null as default value" choice.
           examples:
             - USD
             - A,B
@@ -14030,7 +14059,9 @@ components:
               - statusMapping
               - departmentCodes
           hardCodedValue:
-            type: string
+            type:
+              - string
+              - 'null'
             description: |
               Constant written to the destination instead of an extracted value. On a primitive
               array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -14038,6 +14069,8 @@ components:
               On an `object` it must be a JSON object string and on an `objectarray` a JSON array
               string (an object string becomes one element); the save parses it and refuses non-JSON
               or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+              JSON `null` writes the destination field as null; it is what the mapper saves for its
+              hard-coded "Use null as default value" choice.
             examples:
               - USD
               - A,B

package/dist/import.yml

@@ -13247,7 +13247,9 @@ components:
             - statusMapping
             - departmentCodes
         hardCodedValue:
-          type: string
+          type:
+            - string
+            - 'null'
           description: |
             Constant written to the destination instead of an extracted value. On a primitive
             array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -13255,6 +13257,8 @@ components:
             On an `object` it must be a JSON object string and on an `objectarray` a JSON array
             string (an object string becomes one element); the save parses it and refuses non-JSON
             or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+            JSON `null` writes the destination field as null; it is what the mapper saves for its
+            hard-coded "Use null as default value" choice.
           examples:
             - USD
             - A,B
@@ -14341,7 +14345,9 @@ components:
               - statusMapping
               - departmentCodes
           hardCodedValue:
-            type: string
+            type:
+              - string
+              - 'null'
             description: |
               Constant written to the destination instead of an extracted value. On a primitive
               array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -14349,6 +14355,8 @@ components:
               On an `object` it must be a JSON object string and on an `objectarray` a JSON array
               string (an object string becomes one element); the save parses it and refuses non-JSON
               or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+              JSON `null` writes the destination field as null; it is what the mapper saves for its
+              hard-coded "Use null as default value" choice.
             examples:
               - USD
               - A,B

package/dist/tool.yml

@@ -3919,7 +3919,9 @@ components:
             - statusMapping
             - departmentCodes
         hardCodedValue:
-          type: string
+          type:
+            - string
+            - 'null'
           description: |
             Constant written to the destination instead of an extracted value. On a primitive
             array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -3927,6 +3929,8 @@ components:
             On an `object` it must be a JSON object string and on an `objectarray` a JSON array
             string (an object string becomes one element); the save parses it and refuses non-JSON
             or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+            JSON `null` writes the destination field as null; it is what the mapper saves for its
+            hard-coded "Use null as default value" choice.
           examples:
             - USD
             - A,B
@@ -5013,7 +5017,9 @@ components:
               - statusMapping
               - departmentCodes
           hardCodedValue:
-            type: string
+            type:
+              - string
+              - 'null'
             description: |
               Constant written to the destination instead of an extracted value. On a primitive
               array (`stringarray`, `numberarray`, `booleanarray`) the string is split on commas,
@@ -5021,6 +5027,8 @@ components:
               On an `object` it must be a JSON object string and on an `objectarray` a JSON array
               string (an object string becomes one element); the save parses it and refuses non-JSON
               or the wrong shape with 422, and an array row with a constant needs no `buildArrayHelper`.
+              JSON `null` writes the destination field as null; it is what the mapper saves for its
+              hard-coded "Use null as default value" choice.
             examples:
               - USD
               - A,B
@@ -31221,9 +31229,13 @@ components:
           type: string
           description: |-
             Bearer token that a system pushing data into this export sends as
-            `Authorization: Bearer <token>`. Optional — most distributed listeners (NetSuite,
-            Salesforce real-time) use no token. Write-only and stored encrypted; treat it as a
-            sensitive credential.
+            `Authorization: Bearer <token>`. Optional — Salesforce real-time listeners use no token.
+            For a NetSuite listener the platform generates it when the export is saved as a listener,
+            writes it to the listener's registration record in NetSuite, and generates a new one only
+            when a save re-creates the listener (a `type` change back to `distributed`) — never on a
+            flow toggle or another `PUT`; a client sets and keeps a value itself only for a system of
+            its own that pushes to the export's data endpoint. Stored encrypted and returned masked;
+            treat it as a sensitive credential.
           format: password
           examples:
             - eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
@@ -36555,6 +36567,16 @@ components:
               `netsuite.type: distributed`. Saving it creates a user event script deployment on the
               record type that runs after submit, so records arrive only when NetSuite saves one and
               `POST /v1/exports/preview` cannot sample it.
+            - |-
+              Saving the listener also registers it in NetSuite (the SuiteApp's record for this export,
+              holding its record type, contexts, types, qualifier, endpoint URL and token); a `PUT` that
+              keeps the export a listener re-pushes those fields, leaves the token as it is, and sets
+              the registration's disabled state from the body's `distributed.disabled` (omitted means
+              inactive). A `PUT` that changes `type` to a scheduled value leaves that
+              registration in place and active — NetSuite keeps queuing qualifying saves for an export
+              that no longer listens — so remove or disable the listener's flow rather than converting
+              the step in place, and never treat the conversion as reversible without re-checking
+              `distributed.disabled` afterwards.
           properties:
             recordType:
               type: string
@@ -36628,15 +36650,26 @@ components:
             disabled:
               type: boolean
               description: |-
-                When true, the listener's NetSuite deployment is inactive and record saves no longer
-                trigger the export. Maintained by the platform as the flow is disabled and re-enabled;
-                re-enabling the flow re-registers the deployment. A listener is created disabled, and
-                a flow created already enabled leaves it that way until a flow update sets
-                `disabled: false`, which activates it within seconds.
+                When true, the listener's NetSuite registration is inactive and record saves no longer
+                trigger the export. The platform keeps it in step with the flow — enabling the flow sets
+                it false within seconds, disabling or deleting the flow sets it true — and every save
+                that leaves the export a listener (a create, a `PUT` that keeps it a listener, a `PUT`
+                that makes it `distributed` again after another type) applies the body's value, an
+                omitted field meaning true: a listener is created disabled, a flow created already
+                enabled leaves it so until a flow update sets `disabled: false`, and a `PUT` that omits
+                the field inactivates it.
               x-celigo-ai-guidance:
                 - |-
-                  Pause a listener by disabling its flow, not by setting this field. A listener that has
+                  Pause or resume a listener by disabling or enabling its flow; the field follows. Every
+                  `PUT` of a listener on an enabled flow must carry `disabled: false` — an omitted field or
+                  a stale `true` inactivates the NetSuite registration while the flow stays enabled (the
+                  UI never hits this because it writes back the document it read). A listener that has
                   stopped firing is re-registered by disabling and re-enabling the flow.
+                - |-
+                  A `PUT` that changes `type` back to `distributed` after the export was another type
+                  re-creates the listener: send `disabled: false` when the flow is enabled, or it comes
+                  back inactive until a follow-up `PUT` with `disabled: false` or a disable and re-enable
+                  of the flow activates it.
             executionType:
               type: array
               description: |-

package/package.json

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