@reveldigital/mcp-graphql-proxy 1.16.0 → 1.18.0

package/src/types/schema.graphql

@@ -499,6 +499,34 @@ type AuditEvent {
   geoLocation: String
 }
 
+"Result from a batch row create mutation."
+type BatchCreateDataTableRowsResult {
+  "Whether the overall operation was successful."
+  success: Boolean!
+  "Per-row results."
+  results: [BatchRowResultModel]
+  "Error message if the operation failed."
+  error: String
+}
+
+"Result from a batch row delete mutation."
+type BatchDeleteDataTableRowsResult {
+  "Whether the overall operation was successful."
+  success: Boolean!
+  "Number of rows successfully deleted."
+  deletedCount: Int!
+  "Per-row results."
+  results: [BatchRowResultModel]
+  "Error message if the operation failed."
+  error: String
+}
+
+type BatchRowResultModel {
+  rowId: String
+  success: Boolean!
+  error: String
+}
+
 """
 Represents Bluetooth Low Energy (BLE) beacon configuration for a device.
 Beacons enable proximity-based interactions, allowing mobile devices to detect nearby digital signage
@@ -624,6 +652,73 @@ type CreateMediaResult {
   error: String
 }
 
+type DataTableColumnModel {
+  id: String
+  name: String!
+  key: String!
+  type: ColumnType!
+  required: Boolean!
+  sortable: Boolean!
+  options: [String]
+  default: JSON
+}
+
+type DataTableDetail {
+  id: String
+  name: String
+  description: String
+  columns: [DataTableColumnModel]
+  groupId: String
+  rowCount: Int!
+  cacheTtlSeconds: Int
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
+type DataTableListResponse {
+  data: [DataTableSummary]
+  continuationToken: String
+}
+
+"Result from a data table create or update mutation."
+type DataTableMutationResult {
+  "Whether the operation was successful."
+  success: Boolean!
+  "The created or updated data table."
+  table: DataTableDetail
+  "Error message if the operation failed."
+  error: String
+}
+
+type DataTableRowModel {
+  id: String
+  sortOrder: Int!
+  data: [JSON]
+  updatedAt: DateTime!
+}
+
+"Result from a data table row create or update mutation."
+type DataTableRowMutationResult {
+  "Whether the operation was successful."
+  success: Boolean!
+  "The created or updated row."
+  row: DataTableRowModel
+  "Error message if the operation failed."
+  error: String
+  "Validation errors if the row data failed schema validation."
+  validationErrors: [String]
+}
+
+type DataTableSummary {
+  id: String
+  name: String
+  description: String
+  columnCount: Int!
+  rowCount: Int!
+  groupId: String
+  updatedAt: DateTime!
+}
+
 "Result from a delete operation."
 type DeleteResult {
   "Whether the operation was successful."
@@ -753,6 +848,25 @@ type Group {
   children: [Group]
 }
 
+"Result from an import rows mutation."
+type ImportDataTableRowsResult {
+  "Whether the overall operation was successful."
+  success: Boolean!
+  "Number of rows successfully imported."
+  successCount: Int!
+  "Number of rows that failed to import."
+  errorCount: Int!
+  "Per-row import errors."
+  errors: [ImportRowErrorModel]
+  "Error message if the overall operation failed."
+  error: String
+}
+
+type ImportRowErrorModel {
+  lineNumber: Int!
+  error: String
+}
+
 type KeyValuePairOfStringAndObject {
   key: String!
 }
@@ -852,6 +966,49 @@ type Module {
 }
 
 type Mutation @authorize {
+  """
+  Create a new data table with the specified column schema.
+  Example: Create a menu board table with columns for item name, price, description, and image.
+  """
+  createDataTable(input: CreateDataTableInput): DataTableMutationResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  """
+  Update an existing data table definition. Only provided fields are changed.
+  Example: Add a new "calories" column to a menu board table.
+  """
+  updateDataTable(input: UpdateDataTableInput): DataTableMutationResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  "Delete a data table and all its rows."
+  deleteDataTable(tableId: String): DeleteResult @authorize(policy: "DataTables_Delete") @cost(weight: "10")
+  """
+  Create a new row in a data table.
+  Example: Add a new menu item to a menu board table.
+  """
+  createDataTableRow(input: CreateDataTableRowInput): DataTableRowMutationResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  """
+  Update an existing row in a data table (partial update — only provided keys are changed).
+  Example: Update the price of a menu item.
+  """
+  updateDataTableRow(input: UpdateDataTableRowInput): DataTableRowMutationResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  "Delete a row from a data table."
+  deleteDataTableRow(tableId: String rowId: String): DeleteResult @authorize(policy: "DataTables_Delete") @cost(weight: "10")
+  """
+  Batch create multiple rows in a data table (max 100 rows per call).
+  Example: Bulk-load menu items into a table from an external data source.
+  """
+  batchCreateDataTableRows(input: BatchCreateDataTableRowsInput): BatchCreateDataTableRowsResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  "Batch delete multiple rows from a data table (max 100 row IDs per call)."
+  batchDeleteDataTableRows(input: BatchDeleteDataTableRowsInput): BatchDeleteDataTableRowsResult @authorize(policy: "DataTables_Delete") @cost(weight: "10")
+  """
+  Import rows from CSV content into a data table.
+  Example: Import a spreadsheet of menu items. Use replace mode to overwrite all existing rows.
+  """
+  importDataTableRows(input: ImportDataTableRowsInput): ImportDataTableRowsResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  "Reorder rows in a data table by specifying the desired row ID sequence."
+  reorderDataTableRows(input: ReorderDataTableRowsInput): DeleteResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
+  """
+  Roll back a row to a previous version, creating a new version for the rollback action.
+  Example: Undo an accidental price change by restoring a previous version.
+  """
+  rollbackDataTableRow(input: RollbackDataTableRowInput): RollbackDataTableRowResult @authorize(policy: "DataTables_Edit") @cost(weight: "10")
   """
   Send commands to a specific device.
   Commands are dispatched via Azure SignalR, FCM, Pusher, and legacy SignalR channels
@@ -1147,6 +1304,20 @@ type Query @authorize {
   List of audit events
   """
   auditEvent("Filter by user ID (encrypted)" userId: String "Filter by event type" eventType: String "Filter by HTTP method (GET, POST, PUT, DELETE, etc.)" httpMethod: String "Filter by controller name" controllerName: String "Filter by action name" actionName: String "Filter events after this date" startDate: DateTime "Filter events before this date" endDate: DateTime "Filter by IP address" ipAddress: String "Filter by HTTP response code" responseCode: String "Maximum number of items to return" limit: Int where: AuditEventFilterInput @cost(weight: "10") order: [AuditEventSortInput!] @cost(weight: "10")): [AuditEvent!]! @authorize(policy: "AuditEventsOwnerOnly") @cost(weight: "10")
+  "Lists data tables in the account, with optional group filtering."
+  dataTables("Optional group ID to filter by" groupId: String "Number of tables per page (default 50)" pageSize: Int! = 50 "Token for fetching the next page" continuationToken: String): DataTableListResponse @authorize(policy: "DataTables_View") @cost(weight: "10")
+  "Gets a single data table definition by ID, including column schema."
+  dataTable("The data table ID" tableId: String): DataTableDetail @authorize(policy: "DataTables_View") @cost(weight: "10")
+  "Lists rows in a data table, with optional filtering, sorting, and field selection."
+  dataTableRows("The data table ID" tableId: String "Optional filter as a JSON string (e.g., {\"status\":\"active\"})" filter: String "Column key to sort by" sort: String "Sort direction: \"asc\" or \"desc\"" sortDir: String = "asc" "Number of rows per page (default 50)" pageSize: Int! = 50 "Token for fetching the next page" continuationToken: String "Comma-separated list of column keys to return" fields: String): RowListResponse @authorize(policy: "DataTables_View") @cost(weight: "10")
+  "Gets a single row by ID."
+  dataTableRow("The data table ID" tableId: String "The row ID" rowId: String): DataTableRowModel @authorize(policy: "DataTables_View") @cost(weight: "10")
+  "Exports all rows from a data table as a CSV string."
+  exportDataTableRows("The data table ID" tableId: String): String @authorize(policy: "DataTables_View") @cost(weight: "10")
+  "Lists version history for a row (newest first)."
+  dataTableRowVersions("The data table ID" tableId: String "The row ID" rowId: String "Number of versions per page (default 25)" pageSize: Int! = 25 "Token for fetching the next page" continuationToken: String): VersionListResponse @authorize(policy: "DataTables_View") @cost(weight: "10")
+  "Gets a specific version snapshot of a row."
+  dataTableRowVersion("The data table ID" tableId: String "The row ID" rowId: String "The version number to retrieve" version: Int!): RowVersionModel @authorize(policy: "DataTables_View") @cost(weight: "10")
   device(id: [String!] groupId: [String!] groupName: [String!] deviceTypeId: [String!] includeSnap: Boolean orgId: String limit: Int where: DeviceFilterInput @cost(weight: "10") order: [DeviceSortInput!] @cost(weight: "10")): [Device] @authorize(policy: "Devices_View") @cost(weight: "10")
   deviceGroups(id: String tree: Boolean limit: Int where: GroupFilterInput @cost(weight: "10") order: [GroupSortInput!] @cost(weight: "10")): [Group] @authorize(policy: "Devices_View") @cost(weight: "10")
   """
@@ -1184,6 +1355,36 @@ type ResourcePermission {
   canDelete: Boolean!
 }
 
+"Result from a rollback mutation."
+type RollbackDataTableRowResult {
+  "Whether the rollback was successful."
+  success: Boolean!
+  "The new version number after rollback."
+  newVersion: Int!
+  "The restored row data."
+  restoredRow: DataTableRowModel
+  "Error message if the rollback failed."
+  error: String
+}
+
+type RowListResponse {
+  data: [DataTableRowModel]
+  totalCount: Int!
+  continuationToken: String
+}
+
+type RowVersionModel {
+  id: String
+  rowId: String
+  version: Int!
+  action: String
+  data: [JSON]
+  changedFields: [String]
+  previousValues: [JSON]
+  changedBy: String
+  timestamp: DateTime!
+}
+
 type Schedule {
   "The schedule id"
   id: String
@@ -1412,6 +1613,12 @@ type User {
   isTwoFactor: Boolean
 }
 
+type VersionListResponse {
+  data: [RowVersionModel]
+  totalCount: Int!
+  continuationToken: String
+}
+
 "Aggregated audience metrics for a device over a time period"
 input AdHawkAudienceMetricsFilterInput {
   and: [AdHawkAudienceMetricsFilterInput!]
@@ -2442,6 +2649,22 @@ input AuditEventSortInput {
   geoLocation: SortEnumType @cost(weight: "10")
 }
 
+"Input for batch creating rows."
+input BatchCreateDataTableRowsInput {
+  "The table ID to add rows to."
+  tableId: String
+  "Row data objects to create (max 100)."
+  rows: [[JSON]]
+}
+
+"Input for batch deleting rows."
+input BatchDeleteDataTableRowsInput {
+  "The table ID containing the rows."
+  tableId: String
+  "Row IDs to delete (max 100)."
+  rowIds: [String]
+}
+
 """
 Represents Bluetooth Low Energy (BLE) beacon configuration for a device.
 Beacons enable proximity-based interactions, allowing mobile devices to detect nearby digital signage
@@ -2680,6 +2903,28 @@ input ConditionTypeOperationFilterInput {
   nin: [ConditionType!] @cost(weight: "10")
 }
 
+"Input for creating a new data table."
+input CreateDataTableInput {
+  "Table name (max 100 characters)."
+  name: String
+  "Optional table description (max 500 characters)."
+  description: String
+  "Optional group ID for organizing tables."
+  groupId: String
+  "Column definitions (at least one required)."
+  columns: [DataTableColumnInput]
+  "Optional cache TTL in seconds for gadget\/player reads."
+  cacheTtlSeconds: Int
+}
+
+"Input for creating a row in a data table."
+input CreateDataTableRowInput {
+  "The table ID to add the row to."
+  tableId: String
+  "Row data as a JSON object. Keys must match column keys defined in the table schema."
+  data: [JSON]
+}
+
 "Input for creating a media asset by downloading from a URL."
 input CreateMediaFromUrlInput {
   "URL to download the media file from."
@@ -2698,6 +2943,26 @@ input CreateMediaFromUrlInput {
   endDate: DateTime
 }
 
+"Column definition for creating or updating a data table."
+input DataTableColumnInput {
+  "Column ID (only needed when updating existing columns)."
+  id: String
+  "Display name for the column."
+  name: String
+  "Unique key used in row data objects."
+  key: String
+  "Data type of the column."
+  type: ColumnType!
+  "Whether a value is required for this column."
+  required: Boolean!
+  "Whether the column supports sorting."
+  sortable: Boolean!
+  "Allowed values for Select-type columns."
+  options: [String]
+  "Default value for the column."
+  default: JSON
+}
+
 input DateTimeOperationFilterInput {
   eq: DateTime @cost(weight: "10")
   neq: DateTime @cost(weight: "10")
@@ -2991,6 +3256,16 @@ input GroupSortInput {
   organizationCount: SortEnumType @cost(weight: "10")
 }
 
+"Input for importing rows from CSV content."
+input ImportDataTableRowsInput {
+  "The table ID to import rows into."
+  tableId: String
+  "Raw CSV content (header row + data rows)."
+  csvContent: String
+  "When true, replaces all existing rows. When false (default), appends to existing rows."
+  replace: Boolean!
+}
+
 input IntOperationFilterInput {
   eq: Int @cost(weight: "10")
   neq: Int @cost(weight: "10")
@@ -3490,6 +3765,14 @@ input PlaylistTypeOperationFilterInput {
   nin: [PlaylistType!] @cost(weight: "10")
 }
 
+"Input for reordering rows in a data table."
+input ReorderDataTableRowsInput {
+  "The table ID containing the rows."
+  tableId: String
+  "Row IDs in the desired display order."
+  rowIds: [String]
+}
+
 "Input for reordering sources within a playlist."
 input ReorderPlaylistSourcesInput {
   "The playlist ID."
@@ -3498,6 +3781,16 @@ input ReorderPlaylistSourcesInput {
   sourceIds: [String]
 }
 
+"Input for rolling back a row to a previous version."
+input RollbackDataTableRowInput {
+  "The table ID containing the row."
+  tableId: String
+  "The row ID to roll back."
+  rowId: String
+  "The version number to restore."
+  version: Int!
+}
+
 input ScheduleDeviceFilterInput {
   and: [ScheduleDeviceFilterInput!]
   or: [ScheduleDeviceFilterInput!]
@@ -3876,6 +4169,37 @@ input TemplateSortInput {
   orientation: SortEnumType @cost(weight: "10")
 }
 
+"""
+Input for updating an existing data table definition.
+Only provided fields are changed.
+"""
+input UpdateDataTableInput {
+  "The table ID to update."
+  tableId: String
+  "New table name. Null leaves unchanged."
+  name: String
+  "New description. Null leaves unchanged."
+  description: String
+  "New group ID. Null leaves unchanged."
+  groupId: String
+  "Updated column definitions. Null leaves unchanged."
+  columns: [DataTableColumnInput]
+  "New cache TTL in seconds. Null leaves unchanged."
+  cacheTtlSeconds: Int
+}
+
+"Input for updating an existing row (partial update)."
+input UpdateDataTableRowInput {
+  "The table ID containing the row."
+  tableId: String
+  "The row ID to update."
+  rowId: String
+  "Partial row data. Only provided keys are updated."
+  data: [JSON]
+  "Optional ETag for optimistic concurrency. Pass the row's current ETag to prevent conflicting writes."
+  eTag: String
+}
+
 "Input for updating media metadata."
 input UpdateMediaInput {
   "The media ID to update."
@@ -4034,6 +4358,19 @@ enum ApplyPolicy {
   VALIDATION
 }
 
+enum ColumnType {
+  STRING
+  NUMBER
+  BOOLEAN
+  DATE
+  SELECT
+  MEDIA
+  URL
+  RICH_TEXT
+  TIME
+  HIDDEN
+}
+
 enum ConditionOperator {
   AND
   OR
@@ -4432,5 +4769,7 @@ scalar DateTime @specifiedBy(url: "https:\/\/www.graphql-scalars.com\/date-time"
 "The `Decimal` scalar type represents a decimal floating-point number."
 scalar Decimal
 
+scalar JSON
+
 "The `Long` scalar type represents non-fractional signed whole 64-bit numeric values. Long can represent values between -(2^63) and 2^63 - 1."
 scalar Long