apexrest 1.2.0 → 1.3.0

package/dist/resources/blueprints/crm.yaml

@@ -0,0 +1,172 @@
+{
+  "schemaVersion": 1,
+  "application": {
+    "mode": "extend",
+    "compatibilityProfile": "profile:apex261-ut261-mmd3102",
+    "preserve": {
+      "authentication": true,
+      "authorization": true,
+      "unmanagedSource": true
+    }
+  },
+  "entities": {
+    "Customer": {
+      "read": {
+        "kind": "oracle-table",
+        "object": "CMP_CUSTOMERS",
+        "key": [
+          "id"
+        ],
+        "fields": {
+          "id": {
+            "column": "CUSTOMER_ID",
+            "type": "integer",
+            "nullable": false
+          },
+          "name": {
+            "column": "CUSTOMER_NAME",
+            "type": "string",
+            "nullable": false,
+            "maxLength": 200
+          },
+          "status": {
+            "column": "STATUS",
+            "type": "string",
+            "nullable": false,
+            "maxLength": 16
+          },
+          "version": {
+            "column": "ROW_VERSION",
+            "type": "integer",
+            "nullable": false
+          }
+        }
+      },
+      "authorization": {
+        "readContract": "project:customer-access",
+        "writeContract": "project:customer-access"
+      },
+      "capabilities": {
+        "optimisticLock": {
+          "field": "version"
+        }
+      }
+    }
+  },
+  "commands": {
+    "SaveCustomer": {
+      "kind": "oracle-procedure",
+      "package": "CMP_CUSTOMER_API",
+      "procedure": "SAVE_CUSTOMER",
+      "signatureRef": "project:save-customer",
+      "transaction": "caller-owned",
+      "inputs": {
+        "P_CUSTOMER_ID": {
+          "from": "record.id",
+          "mode": "in-out"
+        },
+        "P_CUSTOMER_NAME": {
+          "from": "record.name",
+          "mode": "in"
+        },
+        "P_STATUS": {
+          "from": "record.status",
+          "mode": "in"
+        },
+        "P_EXPECTED_VERSION": {
+          "from": "record.version",
+          "mode": "in"
+        }
+      },
+      "outputs": {
+        "recordKey": {
+          "from": "P_CUSTOMER_ID"
+        },
+        "recordVersion": {
+          "from": "P_ROW_VERSION"
+        }
+      },
+      "errorContract": "project:customer-errors",
+      "authorizationContract": "project:customer-access"
+    }
+  },
+  "contracts": {
+    "project:customer-access": {
+      "schemaVersion": 1,
+      "kind": "authorization",
+      "rowPredicate": "OWNER_NAME = :APP_USER",
+      "expression": "apex_authorization.is_authorized('CMP_CUSTOMER_WRITE')",
+      "provenance": "Isolated CRM fixture; server-owned APEX identity; live qualification pending"
+    },
+    "project:save-customer": {
+      "schemaVersion": 1,
+      "kind": "command",
+      "transaction": "caller-owned",
+      "parameters": {
+        "P_CUSTOMER_ID": {
+          "mode": "in-out",
+          "type": "NUMBER"
+        },
+        "P_CUSTOMER_NAME": {
+          "mode": "in",
+          "type": "VARCHAR2"
+        },
+        "P_STATUS": {
+          "mode": "in",
+          "type": "VARCHAR2"
+        },
+        "P_EXPECTED_VERSION": {
+          "mode": "in",
+          "type": "NUMBER"
+        },
+        "P_ROW_VERSION": {
+          "mode": "out",
+          "type": "NUMBER"
+        }
+      },
+      "provenance": "fixture API source; caller owns transaction"
+    },
+    "project:customer-errors": {
+      "schemaVersion": 1,
+      "kind": "errors",
+      "provenance": "-20001 authorization, -20002 validation, -20003 optimistic conflict; generic client messages"
+    }
+  },
+  "blocks": {
+    "CustomerList": {
+      "use": "block:crud/report-dialog@1.0.0",
+      "parameters": {
+        "title": "Customers",
+        "createEnabled": true,
+        "editEnabled": true,
+        "editableFields": [
+          "name",
+          "status"
+        ]
+      },
+      "bindings": {
+        "records": "entity:Customer",
+        "saveRecord": "command:SaveCustomer"
+      }
+    },
+    "CustomerSummary": {
+      "use": "block:analytics/status-summary@1.0.0",
+      "parameters": {
+        "title": "Customer status",
+        "groupField": "status"
+      },
+      "bindings": {
+        "records": "entity:Customer"
+      }
+    }
+  },
+  "connections": [
+    {
+      "from": "CustomerList.events.saved",
+      "to": "CustomerSummary.actions.refresh",
+      "behavior": {
+        "coalesce": true
+      }
+    }
+  ]
+}

package/dist/resources/blueprints/index.json

@@ -0,0 +1,12 @@
+[
+  {
+    "id": "blueprint:crm@1.0.0",
+    "title": "CRM Customers / Клієнти",
+    "path": "crm.yaml"
+  },
+  {
+    "id": "blueprint:service-desk@1.0.0",
+    "title": "Service Desk / Сервісна служба",
+    "path": "service-desk.yaml"
+  }
+]

package/dist/resources/blueprints/service-desk.yaml

@@ -0,0 +1,120 @@
+{
+  "schemaVersion": 1,
+  "application": {
+    "mode": "extend",
+    "compatibilityProfile": "profile:apex261-ut261-mmd3102",
+    "preserve": {
+      "authentication": true,
+      "authorization": true,
+      "unmanagedSource": true
+    }
+  },
+  "entities": {
+    "Ticket": {
+      "read": {
+        "kind": "oracle-table",
+        "object": "CMP_TICKETS",
+        "key": [
+          "id"
+        ],
+        "fields": {
+          "id": {
+            "column": "TICKET_ID",
+            "type": "integer",
+            "nullable": false
+          },
+          "title": {
+            "column": "TITLE",
+            "type": "string",
+            "nullable": false,
+            "maxLength": 200
+          },
+          "status": {
+            "column": "STATUS",
+            "type": "string",
+            "nullable": false,
+            "maxLength": 16
+          },
+          "parentId": {
+            "column": "PARENT_ID",
+            "type": "integer",
+            "nullable": true
+          },
+          "changedAt": {
+            "column": "CHANGED_AT",
+            "type": "timestamp",
+            "nullable": false
+          }
+        }
+      },
+      "authorization": {
+        "readContract": "project:ticket-access"
+      },
+      "capabilities": {}
+    }
+  },
+  "commands": {},
+  "contracts": {
+    "project:ticket-access": {
+      "schemaVersion": 1,
+      "kind": "authorization",
+      "rowPredicate": "OWNER_NAME = :APP_USER",
+      "provenance": "Isolated Service Desk fixture; no live qualification"
+    }
+  },
+  "blocks": {
+    "Tickets": {
+      "use": "block:read/filtered-list@1.0.0",
+      "parameters": {
+        "title": "Service desk tickets",
+        "filterField": "status"
+      },
+      "bindings": {
+        "records": "entity:Ticket"
+      }
+    },
+    "TicketStatus": {
+      "use": "block:analytics/status-summary@1.0.0",
+      "parameters": {
+        "title": "Ticket status",
+        "groupField": "status"
+      },
+      "bindings": {
+        "records": "entity:Ticket"
+      }
+    },
+    "TicketDetail": {
+      "use": "block:read/detail@1.0.0",
+      "parameters": {
+        "title": "Ticket detail",
+        "detailField": "title"
+      },
+      "bindings": {
+        "records": "entity:Ticket"
+      }
+    },
+    "TicketHistory": {
+      "use": "block:read/history@1.0.0",
+      "parameters": {
+        "title": "Ticket history",
+        "groupField": "status",
+        "timeField": "changedAt",
+        "detailField": "title"
+      },
+      "bindings": {
+        "records": "entity:Ticket"
+      }
+    },
+    "TicketLines": {
+      "use": "block:read/master-detail@1.0.0",
+      "parameters": {
+        "title": "Ticket lines",
+        "parentField": "parentId"
+      },
+      "bindings": {
+        "records": "entity:Ticket"
+      }
+    }
+  },
+  "connections": []
+}

package/dist/resources/schemas/composer-allocation.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "page": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "dialog": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "prefix": {
+      "type": "string",
+      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
+    }
+  },
+  "required": [
+    "page",
+    "dialog",
+    "prefix"
+  ],
+  "additionalProperties": false
+}

package/dist/resources/schemas/composer-block.schema.json

@@ -0,0 +1,208 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^block:[a-z0-9-]+\\/[a-z0-9-]+$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-z0-9.-]+)?$"
+    },
+    "kind": {
+      "type": "string",
+      "const": "block"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 180
+    },
+    "aliases": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "maxLength": 128
+      }
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "draft",
+        "experimental",
+        "verified",
+        "deprecated",
+        "revoked"
+      ]
+    },
+    "license": {
+      "type": "string"
+    },
+    "origin": {
+      "type": "string"
+    },
+    "recipeRefs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "properties": {
+        "profileRefs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "profileRefs"
+      ],
+      "additionalProperties": false
+    },
+    "renderer": {
+      "type": "string",
+      "enum": [
+        "report-dialog",
+        "status-summary",
+        "filtered-list",
+        "read-only-detail",
+        "history-timeline",
+        "master-detail"
+      ]
+    },
+    "ports": {
+      "type": "object",
+      "properties": {
+        "inputs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "records",
+              "saveRecord"
+            ]
+          }
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "const": "saved"
+          }
+        }
+      },
+      "required": [
+        "inputs",
+        "outputs"
+      ],
+      "additionalProperties": false
+    },
+    "requires": {
+      "type": "object",
+      "properties": {
+        "blocks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "blocks",
+        "capabilities"
+      ],
+      "additionalProperties": false
+    },
+    "source": {
+      "type": "object",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024
+          }
+        }
+      },
+      "required": [
+        "files"
+      ],
+      "additionalProperties": false
+    },
+    "effects": {
+      "type": "object",
+      "properties": {
+        "local": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "deployment": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "applicationRuntime": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "authentication": {
+          "type": "string",
+          "const": "preserve"
+        }
+      },
+      "required": [
+        "local",
+        "deployment",
+        "applicationRuntime",
+        "authentication"
+      ],
+      "additionalProperties": false
+    },
+    "limitations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "id",
+    "version",
+    "kind",
+    "name",
+    "aliases",
+    "status",
+    "license",
+    "origin",
+    "recipeRefs",
+    "compatibility",
+    "renderer",
+    "ports",
+    "requires",
+    "source",
+    "effects",
+    "limitations"
+  ],
+  "additionalProperties": false
+}