cxtms 1.9.27 → 1.9.29

package/package.json

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

package/schemas/schema.graphql

@@ -5515,6 +5515,10 @@ type commodity {
   allTagNames: [String!]! @cost(weight: "10")
   "Gets only the tags directly assigned to this commodity"
   directTagNames: [String!]! @cost(weight: "10")
+  lastTrackingEvent(
+    eventDefinitionName: String
+    orderBy: String
+  ): trackingEvent @cost(weight: "10")
 }
 
 type commodityStatus {

package/skills/cxtms-developer/ref-entity-commodity.md

@@ -119,6 +119,7 @@ Field names as used in workflow expressions: `{{ entity.description }}`, `{{ ent
 | `getRelatedOrder(filter)` | `Order` | First related order |
 | `getCommodityTrackingNumber(idPropertyName)` | `TrackingNumber` | Lookup |
 | `getCommodityAttachments(filter)` | `[Attachment]` | |
+| `lastTrackingEvent(eventDefinitionName, orderBy?)` | `TrackingEvent` | Most recent tracking event. Resolved via batched DataLoader. `orderBy` is accepted for backward compatibility but **ignored** — ordering is always `COALESCE(EventDate, Created) DESC, TrackingEventId DESC`. |
 | `changeHistory(startDate, endDate, maxResults)` | `[ChangeHistory]` | Audit trail |
 
 ## Container/Child Pattern (Self-Referencing)

package/skills/cxtms-developer/ref-entity-order.md

@@ -108,7 +108,7 @@ These are virtual fields that filter `orderEntities` by type:
 | `getCharge(chargeDescription)` | `Charge` | Single charge by description |
 | `getChargesByChargeType(chargeType)` | `[Charge]` | Charges filtered by type |
 | `getOrderSummary(weightUnit, volumeUnit, dimensionsUnit)` | `OrderSummary` | |
-| `lastTrackingEvent(eventDefinitionName)` | `TrackingEvent` | Most recent |
+| `lastTrackingEvent(eventDefinitionName, orderBy?)` | `TrackingEvent` | Most recent tracking event. Resolved via batched DataLoader. `orderBy` is accepted for backward compatibility but **ignored** — ordering is always `COALESCE(EventDate, Created) DESC, TrackingEventId DESC`. |
 | `businessDays(path: String!)` | `int?` | Business days from the date at `path` to today, using the org's business calendar. `path` is a dot-separated property path on the order (e.g. `"customValues.leg.pickup.scheduledAt"`). Returns `null` if path doesn't resolve or value isn't a parseable date. |
 | `attachmentsSummary` | `OrderAttachmentSummaryGqlDto` | `.totalCount` (int), `.hasAny` (bool) — batched DataLoader, backed by DB view |
 | `notesSummary` | `OrderNoteSummaryGqlDto` | `.totalCount` (int), `.hasAny` (bool) — batched DataLoader, backed by DB view |