@cxtms/cx-schema 1.9.253 → 1.9.255

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxtms/cx-schema",
-  "version": "1.9.253",
+  "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-developer/ref-entity-shared.md

@@ -11,9 +11,30 @@
 - PackageType
 - NoteThread
 - Note
+- OrganizationConnection
 
 EntityField, Tag, Attachment, Division, EquipmentType, Equipment, EquipmentStatus, PackageType, Note/NoteThread.
 
+## OrganizationConnection
+
+Application-defined link between two regular organizations. The owner organization is distinct from the two endpoints and is the tenant in which entity workflows run.
+
+| Field | Type | Notes |
+|-------|------|-------|
+| `organizationConnectionId` | `int` | PK |
+| `organizationId` | `int` | Owner/workflow tenant |
+| `sourceOrganizationId` | `int` | First endpoint; must be a regular organization |
+| `targetOrganizationId` | `int` | Second endpoint; must be a different regular organization |
+| `connectionType` | `string` | Required, application-defined, max 50 characters |
+| `isEnabled` | `bool` | Defaults to true |
+| `ediRoutingId` | `string?` | Reserved EDI routing ID, max 15 characters |
+
+**GraphQL:** `organizationConnections(organizationId, filter, search, orderBy)` returns connections where the requested organization is either endpoint. System-admin-only mutations are `linkOrganizations(organizationId, sourceOrganizationId, targetOrganizationId, connectionType)` and `unlinkOrganizations(organizationConnectionId)`. A pair/type combination is unique regardless of endpoint order.
+
+**Entity workflows:** `OrganizationConnection` supports `Added`, `Modified`, and `Deleted` at `Before` and `After` positions in the owner organization. Use `Before Deleted` to veto unlinking when application rules require it.
+
+---
+
 ## EntityField
 
 App-module field metadata used by grids, forms, filters, and entity extensions.

package/skills/cxtms-module-builder/ref-components-forms.md

@@ -359,6 +359,8 @@ Polymorphic form field — renders different input types based on `type` prop.
 
 Password fields receive a stable input id from the field name unless an explicit `id` is provided. This keeps multiple password fields in the same form isolated for browser autocomplete. Use `autoComplete` when a form needs a specific password-manager hint.
 
+For `type: select`, the web renderer forwards the parsed `disabled` value to the underlying select control, so both booleans and template expressions prevent opening or changing the selection.
+
 **Field Types:**
 | Type | Description |
 |------|-------------|

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)