@docupace/ihub-config 1.1.23 → 1.1.24-admin.1

package/dist/types/graphql.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../src/types/graphql.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,4CAAqB,CAAA;IACrB,wCAAiB,CAAA;IACjB,yDAAkC,CAAA;AACpC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AA0dD,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,6BAAW,CAAA;AACb,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAkVD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA2ZD,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,yCAAmB,CAAA;AACrB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAwBD,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,oCAAa,CAAA;IACb,sCAAe,CAAA;AACjB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../src/types/graphql.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,4CAAqB,CAAA;IACrB,wCAAiB,CAAA;IACjB,yDAAkC,CAAA;AACpC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAseD,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,6BAAW,CAAA;AACb,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAkVD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA2ZD,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,qCAAe,CAAA;IACf,yCAAmB,CAAA;AACrB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAwBD,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,oCAAa,CAAA;IACb,sCAAe,CAAA;AACjB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}

package/model/graphs/config/fields.graphql

@@ -103,6 +103,36 @@ type ControlGroup implements IRowElement & IElement {
   fields: [Fields!]!
 }
 
+# Renders the currently-linked records of a multi-valued reference attribute
+# (`path`) as a table (`columns`, reusing Table's Column config), with a quick
+# typeahead (`search`, reusing Table's SimpleSearch/QuerySelectOptions config)
+# to find and add records of `dataType`, and a delete affordance per row.
+# `rowMenuItems` (reusing Table's MenuItem config) adds further per-row actions,
+# e.g. an `action: "details"` item with a `url` to navigate to that record's own
+# details page.
+type ReferenceTable implements IField & IRowElement & IElement {
+  cols: Int
+  defaultValue: String
+  disabledCondition: String
+  excludeFromQueryInput: Boolean
+  hidden: Boolean
+  label: String
+  name: String!
+  path: String!
+  readonly: Boolean
+  required: Boolean
+  requiredCondition: String
+  skipQuery: Boolean
+  visibilityCondition: String
+  dataType: String!
+  columns: [Column!]!
+  search: SimpleSearch
+  addLabel: String
+  confirmDelete: Boolean
+  maxRows: Int
+  rowMenuItems: [MenuItem!]
+}
+
 type PhoneField implements IField & IRowElement & IElement {
   cols: Int
   defaultValue: String

package/model/graphs/config/menu.graphql

@@ -25,6 +25,12 @@ type MenuItem implements IMenuItem {
     visibilityCondition: String
     disabledCondition: String
     config: JSON
+    """
+    Child menu items. When present, this item acts as a collapsible group
+    header rather than a navigable leaf (consumers should treat a MenuItem
+    with `items` and no `url` as a group).
+    """
+    items: [MenuItem!]
 }
 
 type ActionButton implements IMenuItem {

package/model/graphs/config/page.graphql

@@ -250,8 +250,15 @@ type Viewer {
 }
 
 type Breadcrumb {
-  label: String!
+  label: String
   path: String
   isLabelExpression: Boolean
   isPathExpression: Boolean
+  """
+  Dot-notation paths (e.g. "name", "folder.title") to try, in order, against
+  the already-fetched page record to compute the breadcrumb label. Used only
+  when `isLabelExpression` is not set. If none of the paths resolve to a
+  non-empty value, the client falls back to the record's `id`.
+  """
+  valuePaths: [String!]
 }

package/model/graphs/config/query.graphql

@@ -1,6 +1,14 @@
 
 type PageQuery {
-    getPageConfig(path: String, context: JSON): Page
+    """
+    impersonateRoleId / impersonateGeneral: preview this page's config as
+    someone else would see it — either a specific role (impersonateRoleId)
+    or the site default with no role/personal override at all
+    (impersonateGeneral) — restricted to admins by the host's identity
+    resolution (see docupace-graphql-server's resolveCurrentIdentity), which
+    throws for a non-admin caller.
+    """
+    getPageConfig(path: String, context: JSON, impersonateRoleId: ID, impersonateGeneral: Boolean): Page
     getAIConfig(path: String, context: JSON): JSON
 }
 

package/model/graphs/config/rules.graphql

@@ -15,7 +15,7 @@ type RuleGroup {
   validationRules: [ValidationRule!]
 }
 
-union ValidationRule = ArrayTotalRule
+union ValidationRule = ArrayTotalRule | ArrayCountRule
 
 type ArrayTotalRule {
   name: String
@@ -37,6 +37,18 @@ type ArrayTotalRule {
   emptyIsValid: Boolean
 }
 
+"""Validates that the combined count of entries across multiple collections does not exceed a maximum."""
+type ArrayCountRule {
+  name: String
+  message: String!
+
+  """Paths to the collections whose combined count should be validated."""
+  paths: [String!]!
+
+  """Maximum combined number of entries across all specified paths."""
+  maxCount: Int!
+}
+
 interface IFieldRule {
   defaultValue: String
   messageLabel: String

package/model/graphs/config/selectOptions.graphql

@@ -9,6 +9,7 @@ type SelectOptionsFilter {
 type QuerySelectOptions implements ISelectOptions {
     type: String
     labelProp: String # defaults to "name" in ui
+    labelExpression: String # JS expression evaluated against each option (e.g. "`${option.name} (${option.internalId})`"); takes precedence over labelProp when set
     valueProp: String # defaults to "id" in ui
     queryName: String!
     variableDefinitions: JSON

package/model/graphs/config/table.graphql

@@ -34,6 +34,19 @@ interface ITable  {
     expandable: Expandable
     totals: [TotalsItem!]
     config: JSON
+    configPath: String
+    configurableAttributes: [ConfigurableAttribute!]
+    """Admin-defined columns not present in this table's own base `columns`, available to add via the Configure Columns dialog. Site/tenant-scoped catalog — see `$.predefinedColumns` under `configurableAttributes`."""
+    predefinedColumns: [Column!]
+    """Admin-defined filter criteria not present in this table's own base `filter.criteria`, available to add via the Configure Filters dialog. Site/tenant-scoped catalog — see `$.predefinedFilters` under `configurableAttributes`."""
+    predefinedFilters: [TableCriteria!]
+}
+
+"""One overridable sub-element of a config object identified by `configPath` — see the parent's own `configPath` field for how the two combine (`${configPath}#${configSubPath}`)."""
+type ConfigurableAttribute {
+  name: String!         # e.g. "columns", "filter" — matches the field name on the parent type
+  configPath: String!   # copy of the parent object's own configPath, for convenience
+  configSubPath: String! # JSONPath relative to the parent object, e.g. "$.columns"
 }
 
 type TotalsItem {
@@ -91,6 +104,8 @@ enum TablePinnedPosition {
 
 type Toolbar {
   columns: ToolbarColumns
+  configureColumns: ToolbarColumns
+  configureFilters: ToolbarColumns
 }
 
 type ToolbarColumns {
@@ -157,6 +172,11 @@ type TableCriteria {
     selectOptions: ISelectOptions
     min: Float
     max: Float
+    visible: Boolean
+    """Set when this criterion was added by `$ref`-referencing a predefined/base criterion (e.g. `"#$.predefinedFilters[?(@.name=='status')]"`) rather than being copied inline — see the config-path override merge in `config-service.ts`. Clients that re-save this criterion unchanged should keep sending the same `$ref` (as this value) rather than flattening it into a full copy."""
+    ref: String
+    """True when this criterion would still be present (by name) without the current scope's own override — i.e. from a broader layer (a role/site override, or the table's own base template `filter.criteria`). Drives hide-vs-delete in the Configure Filters editor: "remove" must hide (`visible: false`) an inherited criterion, since deleting it from the override would just have it reappear from the broader layer on the next read; a non-inherited criterion (only ever added by this scope's own override) can be deleted outright. Computed fresh on every read in `config-service.ts`'s `applyConfigPathOverride`, never persisted."""
+    inherited: Boolean
 }
 
 enum TableFilterVariant {
@@ -170,12 +190,18 @@ type Column {
     visible: Boolean
     paths: [String!]
     expression: String
+    """Which predefined formatter (if any) generated `expression` — e.g. `"commaList"`, `"custom"` — see `EXPRESSION_FORMATTERS`/`CUSTOM_FORMATTER_ID` in docupace-ui-main's `expressionGeneration.ts`. Absent for the raw/no-formatting default, which stores neither this nor `expression` at all. Without this field, a column's `expression` round-trips but the formatter that produced it doesn't, so the Configure Columns editor can't tell "built from a known formatter" apart from "hand-authored custom script" on reload and always falls back to showing the latter."""
+    formatterName: String
     component: String
     sortable: Boolean
     flex: Float
     pinned: TablePinnedPosition
     config: JSON
     filter: ColumnFilter
+    """Set when this column was added by `$ref`-referencing a predefined/base column (e.g. `"#$.predefinedColumns[?(@.name=='email')]"`) rather than being copied inline — see the config-path override merge in `config-service.ts`. Clients that re-save this column unchanged should keep sending the same `$ref` (as this value) rather than flattening it into a full copy."""
+    ref: String
+    """True when this column would still be present (by name) without the current scope's own override — i.e. from a broader layer (a role/site override, or the table's own base template `columns`). Drives hide-vs-delete in the Configure Columns editor — see `TableCriteria.inherited`'s doc comment for the full reasoning, identical here."""
+    inherited: Boolean
 }
 
 type ColumnFilter {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docupace/ihub-config",
-  "version": "1.1.23",
+  "version": "1.1.24-admin.1",
   "description": "Reusable config GraphQL extension and standalone server",
   "main": "./dist/index.js",
   "type": "module",
@@ -13,12 +13,13 @@
   "license": "ISC",
   "dependencies": {
     "@docupace/ihub-cache": "1.0.1",
-    "@docupace/ihub-core": "0.0.114-alpha.1",
+    "@docupace/ihub-core": "2.0.3-admin.2",
     "axios": "^1.13.5",
     "cross-env": "^7.0.3",
     "dotenv": "^16.4.1",
-    "graphql": "^16.8.1",
+    "graphql": "^16.14.0",
     "js-yaml": "^4.1.0",
+    "jsonpath": "^1.1.1",
     "lodash": "^4.17.21",
     "pino": "^10.3.1",
     "rimraf": "^6.1.3",
@@ -30,6 +31,7 @@
     "@graphql-codegen/typescript-resolvers": "4.0.6",
     "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
+    "@types/jsonpath": "^0.2.4",
     "@types/lodash": "^4.17.7",
     "@types/node": "^20.10.6",
     "@typescript-eslint/eslint-plugin": "^7.10.0",