@cxtms/cx-schema 1.9.254 → 1.9.255

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxtms/cx-schema",
-  "version": "1.9.254",
+  "version": "1.9.255",
   "description": "Schema validation package for CXTMS YAML modules",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/schemas/workflows/tasks/transmission.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Transmission Tasks",
-  "description": "Create, update, and delete transmission records linked to orders",
+  "description": "Create, update, and delete transmission records linked to orders or addressed to contacts",
   "type": "object",
   "properties": {
     "task": {
@@ -55,7 +55,11 @@
             "orderIds": {
               "type": ["array", "string"],
               "items": { "type": ["integer", "string"] },
-              "description": "Order IDs to link (required for Create, at least one)"
+              "description": "Optional order IDs to link"
+            },
+            "contactId": {
+              "type": ["integer", "string", "null"],
+              "description": "Partner contact used for delivery and channel defaults"
             },
             "channel": {
               "type": "string",
@@ -145,7 +149,31 @@
             },
             "payloadRef": {
               "type": ["string", "null"],
-              "description": "Reference to stored payload (e.g. blob URI)"
+              "description": "Reference to a stored payload; mutually exclusive with payload"
+            },
+            "payload": {
+              "description": "JSON, text, or binary/base64 payload uploaded to storage"
+            },
+            "payloadContentType": {
+              "type": ["string", "null"],
+              "description": "Content type override for payload"
+            },
+            "attachments": {
+              "type": ["array", "string", "null"],
+              "description": "Attachment inputs; each uses exactly one source",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "attachmentId": { "type": ["integer", "string", "null"] },
+                  "attachmentGuid": { "type": ["string", "null"], "format": "uuid" },
+                  "url": { "type": ["string", "null"] },
+                  "data": { "description": "Raw bytes or base64 data" },
+                  "fileName": { "type": ["string", "null"] },
+                  "contentType": { "type": ["string", "null"] },
+                  "metadata": { "type": ["object", "string", "null"] }
+                },
+                "additionalProperties": false
+              }
             },
             "scheduledAt": {
               "type": ["string", "null"],

package/skills/cxtms-workflow-builder/ref-entity.md

@@ -479,11 +479,11 @@ Output `result`: `{ added, updated, skipped, failed, total, errors[] }`.
 
 | Task | Description |
 |------|-------------|
-| `Transmission/Create` | Create transmission record linked to orders |
+| `Transmission/Create` | Create a transmission, optionally linked to orders or addressed to a contact |
 | `Transmission/Update` | Update transmission fields (dynamic) |
 | `Transmission/Delete` | Delete transmission record |
 
-Records inbound/outbound message transmissions (EDI, API, Email, Webhook) linked to orders.
+Records inbound/outbound message transmissions (EDI, API, Email, Webhook). Contact-addressed outbound records can carry stored payloads and attachments and are queued for delivery.
 
 ```yaml
 - task: "Transmission/Create@1"
@@ -492,14 +492,10 @@ Records inbound/outbound message transmissions (EDI, API, Email, Webhook) linked
     organizationId: "{{ int organizationId }}"
     transmission:
       orderIds: "{{ orderIds }}"
-      channel: "EDI"
-      direction: "Outbound"
+      contactId: "{{ int partnerContactId }}"
       messageType: "214"
-      sender: "{{ senderISA }}"
-      receiver: "{{ receiverISA }}"
-      status: "Pending"
-      endpoint: "{{ endpoint }}"
-      protocol: "SFTP"
+      payload: "{{ orderPayload }}"
+      payloadContentType: "application/json"
   outputs:
     - name: transmission
       mapping: "transmission"
@@ -527,12 +523,14 @@ Records inbound/outbound message transmissions (EDI, API, Email, Webhook) linked
       mapping: "success"
 ```
 
-**Create inputs:** `organizationId` (int, required), `transmission` object — `orderIds` (required, at least one), `channel`, `direction` (Inbound/Outbound), `messageType`, `sender`, `receiver`, `status`, `endpoint`, `protocol`, `correlationId` (auto-generated if omitted), `parentId`, `httpStatus`, `byteSize`, `retryCount`, `maxRetries`, `nextRetryAt`, `errorCode`, `errorMessage`, `customValues`, `headers`, `payloadRef`, `scheduledAt`, `startedAt`, `completedAt`, `durationMs`.
+**Create inputs:** `organizationId` (int, required), `transmission` object — optional `orderIds`; `contactId`; `channel` (required without `contactId`); `direction` (Inbound/Outbound, defaults to Outbound); `messageType`, `sender`, `receiver`, `status`, `endpoint`, `protocol`, `correlationId` (auto-generated if omitted), `parentId`, `httpStatus`, `byteSize`, `retryCount`, `maxRetries`, `nextRetryAt`, `errorCode`, `errorMessage`, `customValues`, `headers`, `payloadRef`, `payload`, `payloadContentType`, `attachments`, `scheduledAt`, `startedAt`, `completedAt`, `durationMs`. `payload` and `payloadRef` are mutually exclusive. Each attachment uses exactly one of `attachmentId`, `attachmentGuid`, `url`, or `data`; URL/data entries require `fileName`.
 
 **Create outputs:** `transmission` (full TransmissionDto).
 **Update inputs:** `organizationId`, `transmissionId`, `transmission` (dynamic partial fields).
 **Delete outputs:** `success` (boolean).
 
+Contact-addressed transmissions with a supported transport are queued through the outbox. Transmission entity triggers expose decoded `entity.payload` (within the server preload limit) and `entity.attachments` with download URLs.
+
 **Status enum:** Pending, InProgress, Sent, Received, Delivered, Acknowledged, Rejected, Error, RetryScheduled, Cancelled, Expired, Accepted.
 
 ## Accounting Transaction (Additional)