@cxtms/cx-schema 1.8.1 → 1.9.0

package/templates/module-configuration.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Configuration Module
-# Generated by cx-cli create module --template configuration
+# Generated by cxtms create module --template configuration
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,103 +8,37 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} configuration module"
-  application: CargoXplorer
-  fileName: "{{fileName}}"
+  application: System
 
 components:
-  - name: {{displayNameNoSpaces}}/Configuration
+  - name: Configurations/{{displayNameNoSpaces}}
     displayName:
-      en-US: "{{displayName}}"
+      en-US: "{{displayName}} Config"
+    platforms:
+      - web
     layout:
-      component: form
-      name: {{name}}Form
+      component: layout
+      name: {{displayNameNoSpaces}}ConfigLayout
       props:
+        cols: 1
         title:
-          en-US: "{{displayName}}"
-        queries:
-          - name: getConfiguration
-            query:
-              command: |
-                query GetConfiguration($organizationId: Int!) {
-                  configuration(organizationId: $organizationId) {
-                    settingName
-                    maxRetries
-                    enableNotifications
-                  }
-                }
-              variables:
-                organizationId: "\{{organizationId}}"
-        initialValues:
-          fromQuery:
-            name: getConfiguration
-            path: configuration
-          append:
-            settingName: "Default Setting"
-            maxRetries: 3
-            enableNotifications: true
-        validationSchema:
-          settingName:
-            type: string
-            required: true
-          maxRetries:
-            type: number
-            required: true
-          enableNotifications:
-            type: boolean
-        onSubmit:
-          - type: mutation
-            props:
-              command: |
-                mutation SaveConfiguration($organizationId: Int!, $input: ConfigurationInput!) {
-                  saveConfiguration(organizationId: $organizationId, input: $input) {
-                    success
-                  }
-                }
-              variables:
-                organizationId: "\{{organizationId}}"
-                input: "\{{formValues}}"
-          - type: notification
-            props:
-              message:
-                en-US: "{{displayName}} saved successfully"
-              severity: success
+          en-US: "{{displayName}} Configuration"
+        icon: Create
+        permission: System/OrganizationConfigs/Update
       children:
         - component: field
-          name: settingName
-          props:
-            label:
-              en-US: "Setting Name"
-            type: text
-            required: true
-        - component: field
-          name: maxRetries
-          props:
-            label:
-              en-US: "Max Retries"
-            type: number
-        - component: field
-          name: enableNotifications
+          name: customValues.enabled
           props:
-            label:
-              en-US: "Enable Notifications"
             type: checkbox
+            label:
+              en-US: "Enable {{displayName}}"
 
-routes:
-  - name: configuration
-    path: /{{name}}
-    component: {{displayNameNoSpaces}}/Configuration
-    props:
-      title:
-        en-US: "{{displayName}}"
-
-permissions:
-  - name: "{{displayNameNoSpaces}}/View"
-    displayName:
-      en-US: "View {{displayName}}"
-    roles:
-      - Admin
-  - name: "{{displayNameNoSpaces}}/Edit"
+configurations:
+  - configName: "apps.{{name}}"
     displayName:
-      en-US: "Edit {{displayName}}"
-    roles:
-      - Admin
+      en-US: "{{displayName}}"
+    description:
+      en-US: "{{displayName}} configuration"
+    component: "Configurations/{{displayNameNoSpaces}}"
+    defaultValue:
+      enabled: false

package/templates/module-form.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Form Module
-# Generated by cx-cli create module --template form
+# Generated by cxtms create module --template form
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} module"
-  application: CargoXplorer
-  fileName: "{{fileName}}"
+  application: System
+  filePath: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/Detail

package/templates/module-grid.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Module
-# Generated by cx-cli create module --template grid
+# Generated by cxtms create module --template grid
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} module"
-  application: CargoXplorer
-  fileName: "{{fileName}}"
+  application: System
+  filePath: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/List

package/templates/module-select.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Select Module
-# Generated by cx-cli create module --template select
+# Generated by cxtms create module --template select
 
 module:
   name: "{{displayNameNoSpaces}}"
@@ -8,8 +8,8 @@ module:
     en-US: "{{displayName}}"
   description:
     en-US: "{{displayName}} async select component"
-  application: CargoXplorer
-  fileName: "{{fileName}}"
+  application: System
+  filePath: "{{fileName}}"
 
 components:
   - name: {{displayNameNoSpaces}}/Select

package/templates/module.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Module
-# Generated by cx-cli create module
+# Generated by cxtms create module
 
 module:
   name: "{{name}}"
@@ -8,7 +8,8 @@ module:
   description: "{{displayName}} module"
   icon: "folder"
   version: "1.0"
-  fileName: "{{fileName}}"
+  application: System
+  filePath: "{{fileName}}"
 
 entities:
   - name: {{name}}

package/templates/workflow-api-tracking.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template api-tracking
+# Generated by cxtms create workflow --template api-tracking
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-basic.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template basic
+# Generated by cxtms create workflow --template basic
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-document.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template document
+# Generated by cxtms create workflow --template document
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-entity-trigger.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template entity-trigger
+# Generated by cxtms create workflow --template entity-trigger
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-ftp-edi.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template ftp-edi
+# Generated by cxtms create workflow --template ftp-edi
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-ftp-tracking.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template ftp-tracking
+# Generated by cxtms create workflow --template ftp-tracking
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-mcp-tool.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template mcp-tool
+# Generated by cxtms create workflow --template mcp-tool
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-public-api.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template public-api
+# Generated by cxtms create workflow --template public-api
 #
 # This workflow exposes a public REST API endpoint.
 # The api section defines the route, method, authentication, and OpenAPI metadata.

package/templates/workflow-scheduled.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template scheduled
+# Generated by cxtms create workflow --template scheduled
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-utility.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template utility
+# Generated by cxtms create workflow --template utility
 
 workflow:
   workflowId: "{{uuid}}"

package/templates/workflow-webhook.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow --template webhook
+# Generated by cxtms create workflow --template webhook
 #
 # Endpoint: POST /api/v2/orgs/{organizationId}/webhooks/{workflowId}
 # The endpoint is anonymous (no auth token required) and rate-limited (10/sec, 100/min per IP).

package/templates/workflow.yaml

@@ -1,5 +1,5 @@
 # {{displayName}} Workflow
-# Generated by cx-cli create workflow
+# Generated by cxtms create workflow
 
 workflow:
   workflowId: "{{uuid}}"

package/.claude/skills/cx-workflow/ref-expressions.md

@@ -1,272 +0,0 @@
-# Variable References & Expressions
-
-There are **two distinct syntaxes** for referencing variables, used in different contexts.
-
-## Template Expressions: `{{ path }}` (in step inputs)
-
-Used in step `inputs` values. Resolves variable paths from scoped variables.
-
-```yaml
-inputs:
-  orderId: "{{ inputs.orderId }}"                    # Simple reference
-  url: "{{ chopinConfig.baseUrl }}/api/v1"           # String interpolation
-  order: "{{ Data.GetOrder.order }}"                 # Raw object (single {{ }})
-  name: "Order {{ Data.GetOrder.order.orderNumber }}" # String interpolation (multiple)
-```
-
-**Key behavior**: A single `{{ path }}` returns the **raw object** (preserving type). Multiple `{{ }}` in a string returns string interpolation (each resolved value is `.ToString()`).
-
-### Type Converters (prefix in {{ }})
-
-```yaml
-organizationId: "{{ int organizationId }}"
-amount: "{{ decimal totalAmount }}"
-isActive: "{{ bool isActive }}"
-flag: "{{ boolOrFalse someFlag }}"        # null -> false
-flagOn: "{{ boolOrTrue someFlag }}"       # null -> true
-notes: "{{ emptyIfNull notes }}"          # null -> ""
-notes: "{{ nullIfEmpty notes }}"          # "" or whitespace -> null
-config: "{{ fromJson configJsonString }}" # JSON string -> dict/array
-payload: "{{ toJson someObject }}"        # object -> JSON string
-name: "{{ trim value }}"
-search: "{{ luceneString query }}"        # escape & quote for Lucene
-```
-
-| Converter | Returns | Null handling |
-|-----------|---------|---------------|
-| `string` | `string` | null. Reads `Stream` to string if value is Stream |
-| `int` | `int` | Throws on null |
-| `decimal` | `decimal` | Throws on null |
-| `bool` | `bool` | Throws on null |
-| `boolOrFalse` | `bool` | `false` if null |
-| `boolOrTrue` | `bool` | `true` if null |
-| `datetime` | `DateTime` | Throws on null |
-| `emptyIfNull` | same type | `""` if null, `0` for int?, `0m` for decimal? |
-| `nullIfEmpty` | same type | `null` if empty/whitespace string or empty collection |
-| `luceneString` | `string` | null |
-| `transliterate` | `string` | null (Unicode -> ASCII via Unidecode) |
-| `transliterateUa` | `string` | null (Ukrainian-specific rules) |
-| `fromJson` | `dict` or `array` | null. Empty string -> empty dict |
-| `toJson` | `string` | `""` if null |
-| `trim` | `string` | null |
-| `toLocalTime` | `string` | null. Function-style: `{{ toLocalTime datePath 'timezoneId' 'format?' }}` |
-
-### Value Directives (in YAML input mappings)
-
-**`expression`** -- Evaluate NCalc expression as a value:
-```yaml
-amount:
-  expression: "[price] * [quantity]"
-```
-
-**`coalesce`** -- First non-null value from a list:
-```yaml
-displayName:
-  coalesce:
-    - "{{ customer.name? }}"
-    - "{{ customer.email? }}"
-    - "Unknown"
-```
-
-**`foreach`** (value context) -- Transform collections inline:
-```yaml
-commodities:
-  foreach: "sourceCommodities"
-  item: "item"                             # default: "item"
-  conditions: "[item.isActive] = true"     # optional NCalc filter per item
-  continueOnError: false                   # optional, skip errors
-  mapping:                                 # dict -> List<dict>, string -> List<object>
-    name: "{{ item.name }}"
-    quantity: "{{ item.qty }}"
-```
-
-**`switch`** (value context) -- Value-based switch (case-insensitive match):
-```yaml
-perLb:
-  switch: "{{ contact.commissionTier }}"
-  cases:
-    "tier1": "{{ rate.customValues.commission_per_lb_tier1 }}"
-    "tier2": "{{ rate.customValues.commission_per_lb_tier2 }}"
-  default: "0"
-```
-
-**`extends`** -- Extend/merge an existing object or array:
-```yaml
-orderData:
-  extends: "{{ existingOrder }}"           # base object or array
-  defaultIfNull: {}                        # fallback if extends is null
-  mapping:                                 # dict: merge overrides. array: append items
-    status: "Updated"
-    notes: "{{ newNotes }}"
-```
-
-**`resolve`** -- Entity ID lookup by querying a GraphQL collection:
-```yaml
-customerId:
-  resolve:
-    entity: "Contact"                        # Entity type (auto-pluralized for query)
-    filter: "name={{ customerName }}"        # Lucene filter (template-parsed)
-    field: "contactId"                       # Field to return (default: <entity>Id)
-```
-Results are batched and cached per unique `entity|filter|field` combination by `ResolvePreProcessor` before step execution. Cache misses return `null`. Useful inside `foreach` mappings where many items reference the same entity — only one query per unique filter value.
-
-**`$raw`** -- Prevent template parsing (pass as-is):
-```yaml
-template:
-  $raw: "This {{ won't }} be parsed"
-```
-
-**`$eval`** -- Parse JSON string then evaluate as template:
-```yaml
-dynamicConfig:
-  $eval: "{{ configJsonString }}"
-```
-
-**`decrypt`** / **`encrypt`** -- AES-CBC encryption (optional key/IV, has defaults):
-```yaml
-apiKey:
-  decrypt:
-    encryptedValue: "{{ encryptedApiKey }}"
-    key: "{{ encryptionKey }}"             # optional Base64 AES key
-    initializationVector: "{{ iv }}"       # optional Base64 IV
-```
-
----
-
-## NCalc Expressions: `[variable]` (in conditions and expression directives)
-
-Used in `conditions[].expression`, `switch` case `when`, and `expression:` value directives. Variables use **square bracket** `[name]` syntax.
-
-```yaml
-conditions:
-  - expression: "[status] = 'Active' AND [amount] > 100"
-  - expression: "isNullOrEmpty([Data.GetOrder.order?]) = false"
-  - expression: "any([changes], [each.key] = 'Status') = true"
-```
-
-**Parameter resolution rules**:
-- Empty strings are converted to `null` (so `""` is treated as no value)
-- Numeric strings are auto-converted to `decimal` when needed (e.g., `[price] > 100` works even if price is the string `"150"`)
-- Dot paths resolve deep: `[Activity.Step.output.nested.field]`
-- Optional suffix `?` prevents errors: `[order.customer?.name?]`
-
-### Operators
-
-| Type | Operators |
-|------|-----------|
-| Comparison | `=`, `!=`, `<>`, `<`, `>`, `<=`, `>=` |
-| Logical | `AND`, `OR`, `NOT` (also `&&`, `\|\|`, `!`) |
-| Arithmetic | `+`, `-`, `*`, `/`, `%` |
-| Ternary | `if(condition, trueVal, falseVal)` |
-| Membership | `in(value, val1, val2, ...)` |
-
-### Iterator Variables
-
-Functions use two iterator variable names:
-- **`[each.*]`** -- used by: `any`, `all`, `sum`, `join` (3-arg)
-- **`[item.*]`** -- used by: `first`, `last`, `groupBy`
-
-### Collection Functions
-
-| Function | Description |
-|----------|-------------|
-| `any([items], [each.prop] = 'val')` | True if any item matches expression. Without expression: checks if collection contains the value |
-| `all([items], [each.prop] > 0)` | True if all items match. Returns `false` for null/empty collections |
-| `count([items])` | Count items in list or JToken. Returns `0` for non-collections |
-| `sum([items], [each.amount])` | Sum values as `decimal`. Optional `[each.*]` accessor. Skips nulls |
-| `first([items])` or `first([items], [item.name])` | First item or evaluate expression on first item. Returns `""` if empty |
-| `last([items])` or `last([items], [item.name])` | Last item or evaluate expression on last item. Returns `""` if empty |
-| `distinct([items])` | Remove duplicates. Uses deep comparison for dictionaries |
-| `reverse([items])` | Reverse collection or string |
-| `contains([source], 'needle')` | String contains, JArray contains, list contains, or dict key/value contains |
-| `removeEmpty([items])` | Remove null and whitespace-only items |
-| `concat([list1], [list2], ...)` | Concatenate multiple collections into flat list. Variadic args. Skips nulls |
-| `groupBy([items], [item.cat])` | Group by one or more key expressions. Returns `[{key, items}]`. Multi-key: keys joined with `\|` |
-| `join([items], [each.name], ',')` | Join collection with `[each.*]` accessor and separator (3-arg) |
-| `join([items], ',')` | Join collection directly with separator (2-arg) |
-| `split([str], ' ')` | Split string by first character of separator. Returns `List<string>` |
-| `elementAt([items], 0)` | Get element at index (zero-based) from list |
-
-### String Functions
-
-| Function | Description |
-|----------|-------------|
-| `isNullOrEmpty([var])` | True if null, empty string, or empty list |
-| `length([var])` | String length or collection count. `0` for null strings and non-collections |
-| `lower([name])` / `upper([code])` | Case conversion. Handles string, JToken, any `.ToString()` |
-| `left([code], 3)` / `right([code], 3)` | Left/right N characters. Returns full string if shorter than N |
-| `substring([str], 0, 5)` | Extract substring starting at position for given length |
-| `replace([str], 'old', 'new')` | String replacement. Returns null if any arg is null |
-| `trim([value])` | Trim whitespace. Returns `""` for null |
-| `format('{0}-{1}', [prefix], [id])` | String.Format style. Variadic args. Returns null if format is null |
-| `base64([value])` / `fromBase64([encoded])` | Base64 encode/decode. Handles string, byte[], JToken |
-| `bool([value])` | Convert to boolean: null->`false`, empty string->`false`, "true"/"false"->parsed, non-zero number->`true`, any object->`true` |
-| `transliterate([value])` | Unicode to ASCII (Unidecode). Returns `""` for null |
-| `transliterateUa([value])` | Ukrainian-specific transliteration. Returns `""` for null |
-| `parseAddress([address])` | Parse address -> `{StreetNumber, StreetName}`. Handles US and EU formats |
-
-### Date Functions
-
-| Function | Description |
-|----------|-------------|
-| `parseDate([str])` | Parse date string to DateTime. Supports common formats (ISO, US, etc.) |
-| `now()` | Current UTC `DateTime` |
-| `now('yyyy-MM-dd', 'en-US')` | Formatted current time as string |
-| `addDays([date], 30)` | Add days (decimal, can be negative). Accepts DateTime, DateTimeOffset, string |
-| `addHours([date], 2)` | Add hours (decimal, can be negative). Same type handling |
-| `formatDate([date], 'dd/MM/yyyy', 'en-US')` | Format date with culture. Accepts DateTime or string |
-| `dateFromUnix([unixTime])` | Unix timestamp (seconds) -> `DateTimeOffset`. Accepts int, long, decimal, string |
-| `dateToUtc([date])` or `dateToUtc([date], 'en-US')` | Convert to UTC. Optional culture for string parsing |
-| `toLocalTime([date], 'America/Chicago')` | Convert UTC date to local time in IANA timezone. Returns `DateTimeOffset`. Null-safe |
-
-### Business Date Math (in Lucene filter expressions)
-
-The filter engine (`FilterBy`) supports business-aware date math units in Lucene date expressions:
-
-| Unit | Aliases | Description |
-|------|---------|-------------|
-| `BHOUR` | `BHOURS` | Add/subtract business hours (respects weekly schedule + holidays) |
-| `BDAY` | `BDAYS` | Add/subtract business days (skips non-working days) |
-
-**Usage**: These units are used in **Lucene filter strings** (not NCalc expressions). They require an `IBusinessDateMathResolver` and are resolved via the organization's business calendar.
-
-```
-dueDate: [NOW TO NOW+3BDAYS]
-pickupDate: [* TO NOW-8BHOURS]
-```
-
-The resolver loads `CalendarBusinessHour` (weekly schedule) and `CalendarAvailabilityBlock` (holidays) for the organization's `business`-type calendar, then walks through working time segments to compute the target date.
-
-### Math Functions (NCalc built-in)
-
-`Abs(x)`, `Ceiling(x)`, `Floor(x)`, `Round(x, decimals)`, `Min(x, y)`, `Max(x, y)`, `Pow(x, y)`, `Sqrt(x)`, `Truncate(x)`
-
-Custom: `ceiling([value])` -- same as `Ceiling` but handles type conversion to double.
-
-### Domain Functions
-
-| Function | Description |
-|----------|-------------|
-| `convertWeight([weight], 'Kg', 'Lb')` | Weight unit conversion. Returns `decimal` rounded to 5 places |
-| `convertDimension([length], 'Cm', 'In')` | Dimension unit conversion. Returns `decimal` rounded to 3 places |
-
----
-
-## Property Path Syntax (in collection, mapping, variable paths)
-
-Used in `collection:` (foreach), `mapping:` (outputs), and variable resolution.
-
-| Pattern | Description | Example |
-|---------|-------------|---------|
-| `a.b.c` | Dot-separated nested path | `order.customer.name` |
-| `prop?` | Optional access (null if missing) | `order.customer?.name?` |
-| `list[0]` | Array index | `items[0]` |
-| `list[^1]` | Index from end (last item) | `items[^1]` |
-| `list[*]` | Flatten/wildcard (all items) | `containers[*].commodities` |
-| `list[**]` | Recursive flatten (all depths) | `containerCommodities[**]` |
-| `list[-1]` | Depth filter (leaves only) | `tree[**][-1]` |
-| `list[condition]` | Filter by condition | `items[status=Active]` |
-| `dict['key']` | Dictionary key access | `customValues['myField']` |
-| `list[*].{f1 f2}` | Field selector (projection) | `items[*].{name description}` |
-| `list[*].{alias:source}` | Field selector with alias | `items[*].{id:commodityId}` |
-| `list[*].{alias:_.parent}` | Field selector referencing parent | `items[*].{parentId:_.orderId}` |