@cxtms/cx-schema 1.9.10 → 1.9.11

package/package.json

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

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

@@ -73,7 +73,9 @@ PK: `id` (int, auto). Scoped per organization.
 | `placeName` | `string` | Place/city name |
 | `stateCode` | `string?` | FK to State |
 | `accuracy` | `AccuracyTypes?` | 1=Region, 2=Municipality, 3=Neighborhood, 4=Place, 5=Street, 6=Centroid |
-| `timeZone` | `string?` | IANA timezone ID (e.g., `America/Chicago`) |
+| `timeZone` | `string?` | IANA timezone ID (e.g., `America/Chicago`). GraphQL auto-resolves from GPS coordinates when not stored |
+| `longitude` | `double?` | From Location.X (GraphQL computed) |
+| `latitude` | `double?` | From Location.Y (GraphQL computed) |
 | `customValues` | `Dictionary` | jsonb |
 | `location` | `Point?` | WGS 84 (SRID 4326). X=longitude, Y=latitude |
 

package/skills/cxtms-workflow-builder/SKILL.md

@@ -214,6 +214,8 @@ collection: "Activity?.Step?.output?.items?"
 url: "{{ config?.baseUrl? }}"
 ```
 
+**Engine-level null safety for object inputs**: Task inputs resolved as complex objects (e.g., `headers`, `columnMappings`, configuration objects) are automatically null-safe at the engine level. If an optional object input is omitted from YAML, the engine returns `null` instead of throwing — no `?` suffix needed on the YAML key itself. The `?` operator is still required in template expressions and NCalc paths that reference those objects.
+
 **When `?` is NOT needed** (guaranteed system variables):
 `organizationId`, `currentUserId`, `executionId`, `workflowId`, `triggerType`, `eventType`, `position`, `entityName`, `entityId`, `entity`, `entity.*`, `data`, `changes`, `inputs.*`, `exception.message`, `item` (foreach current), `item.*`, `index`, `iteration`
 

package/skills/cxtms-workflow-builder/ref-expressions-template.md

@@ -147,6 +147,8 @@ Used in `collection:` (foreach), `mapping:` (outputs), and variable resolution.
 |---------|-------------|---------|
 | `a.b.c` | Dot-separated nested path | `order.customer.name` |
 | `prop?` | Optional access (null if missing) | `order.customer?.name?` |
+
+> **Note**: Object-type task inputs (e.g., `headers`, `columnMappings`) are automatically null-safe at the engine level. Omitting an optional object input from YAML returns `null` without errors. The `?` suffix remains required in template expression paths and NCalc conditions.
 | `list[0]` | Array index | `items[0]` |
 | `list[^1]` | Index from end (last item) | `items[^1]` |
 | `list[*]` | Flatten/wildcard (all items) | `containers[*].commodities` |