@docupace/ihub-config 1.1.22 → 1.1.24-admin.0

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

@@ -32,6 +32,8 @@ interface IDateRangeField {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
+  validation: GenericFieldValidation
+
 }
 
 type InputField implements IField & IRowElement & IElement {
@@ -101,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
@@ -116,7 +148,7 @@ type PhoneField implements IField & IRowElement & IElement {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type DateField implements IField & IRowElement & IElement {
@@ -135,7 +167,7 @@ type DateField implements IField & IRowElement & IElement {
   disabledCondition: String
   minDate: String # e.q. "now" or "2025-03-20"
   maxDate: String # e.q. "now" or "2025-03-20"
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type DateRangeField implements IDateRangeField & IRowElement & IElement {
@@ -154,6 +186,7 @@ type DateRangeField implements IDateRangeField & IRowElement & IElement {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
+  validation: GenericFieldValidation
 }
 
 type SelectField implements IField & IRowElement & IElement {
@@ -178,7 +211,7 @@ type SelectField implements IField & IRowElement & IElement {
   excludeId: Boolean
   helperText: String
   autoSelectSingleOption: Boolean
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type ToggleField implements IField & IRowElement & IElement {
@@ -200,7 +233,7 @@ type ToggleField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   linkedFields: [String!]
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type BooleanField implements IField & IRowElement & IElement {
@@ -218,7 +251,7 @@ type BooleanField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   linkedFields: [String!]
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type ChipSelectWithInputField implements IField & IRowElement & IElement {
@@ -262,7 +295,7 @@ type CustomField implements IField & IRowElement & IElement {
   excludeFromQueryInput: Boolean
   visibilityCondition: String
   disabledCondition: String
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type StatusChipField implements IField & IRowElement & IElement {
@@ -271,7 +304,7 @@ type StatusChipField implements IField & IRowElement & IElement {
   label: String
   name: String!
   path: String!
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type CheckboxGroupValue {
@@ -299,9 +332,19 @@ enum FieldValueType {
   Float
 }
 
-type FieldValidation {
+type GenericFieldValidation {
+    custom : CustomFieldValidation
+}
+
+type CustomFieldValidation {
   expression: String
   message: String
+  """
+  Paths of other fields this expression reads. When one of these fields changes, this
+  field's validation is re-triggered so its error state stays in sync without requiring
+  the user to re-touch this field directly.
+  """
+  dependentPaths: [String!]
 }
 
 type StringValidationRule {
@@ -333,11 +376,13 @@ type InputValidation {
   format: [FormatValidationRule!]
   min: FloatValidationRule
   max: FloatValidationRule
+  custom: CustomFieldValidation
 }
 
 type ChipSelectValidation {
   compatibleWith: CompatibleWithRule
   uniqueInList: UniqueInListRule
+  custom : CustomFieldValidation
 }
 
 type CompatibleWithRule {

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
@@ -56,7 +68,7 @@ type ListFieldRule implements IFieldRule {
   requiredCondition: String
   availabilityCondition: String # maps to visibilityCondition on UI
   validationRules: [ListFieldValidationRule!]
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }
 
 type ListFieldValidationRule {
@@ -100,5 +112,5 @@ type DateFieldRule implements IFieldRule {
   availabilityCondition: String # maps to visibilityCondition on UI
   minDate: String # e.q. "now" or "2025-03-20"
   maxDate: String # e.q. "now" or "2025-03-20"
-  validation: FieldValidation
+  validation: GenericFieldValidation
 }

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,17 @@ 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!]
+}
+
+"""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 +102,8 @@ enum TablePinnedPosition {
 
 type Toolbar {
   columns: ToolbarColumns
+  configureColumns: ToolbarColumns
+  configureFilters: ToolbarColumns
 }
 
 type ToolbarColumns {
@@ -170,12 +183,16 @@ 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
 }
 
 type ColumnFilter {

package/package.json

@@ -1,25 +1,9 @@
 {
   "name": "@docupace/ihub-config",
-  "version": "1.1.22",
+  "version": "1.1.24-admin.0",
   "description": "Reusable config GraphQL extension and standalone server",
   "main": "./dist/index.js",
   "type": "module",
-  "scripts": {
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "start:dev": "cross-env NODE_ENV=development tsx watch --clear-screen --no-cache src/server.ts --log-level debug | pino-pretty",
-    "start": "node dist/server.js",
-    "build:code": "tsc -p tsconfig.json",
-    "build:assets": "cpx \"model/**/*.yaml\" ./dist/model && cpx \"model/**/*.graphql\" ./dist/model",
-    "build": "rimraf dist && pnpm lint && pnpm build:code && pnpm build:assets",
-    "watch": "tsc -p tsconfig.json --watch",
-    "start:build": "rimraf dist && pnpm build:esm && pnpm build:assets && node dist/server.js",
-    "codegen": "graphql-codegen --config codegen.ts",
-    "lint": "eslint \"src/**/*.{js,jsx,ts,tsx}\" \"tests/**/*.{js,jsx,ts,tsx}\"",
-    "lint:fix": "eslint --fix \"src/**/*.{js,jsx,ts,tsx}\" \"tests/**/*.{js,jsx,ts,tsx}\"",
-    "prepublishOnly": "pnpm build && pnpm test",
-    "sonar": "bash sonar.sh"
-  },
   "keywords": [
     "graphql",
     "config",
@@ -29,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",
@@ -46,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",
@@ -67,7 +53,6 @@
     "tsx": "^4.11.2",
     "typescript": "^5.3.3"
   },
-  "packageManager": "pnpm@10.30.3",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
@@ -77,5 +62,20 @@
   ],
   "imports": {
     "#module-format": "./dist/lib/module-format.esm.js"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "start:dev": "cross-env NODE_ENV=development tsx watch --clear-screen --no-cache src/server.ts --log-level debug | pino-pretty",
+    "start": "node dist/server.js",
+    "build:code": "tsc -p tsconfig.json",
+    "build:assets": "cpx \"model/**/*.yaml\" ./dist/model && cpx \"model/**/*.graphql\" ./dist/model",
+    "build": "rimraf dist && pnpm lint && pnpm build:code && pnpm build:assets",
+    "watch": "tsc -p tsconfig.json --watch",
+    "start:build": "rimraf dist && pnpm build:esm && pnpm build:assets && node dist/server.js",
+    "codegen": "graphql-codegen --config codegen.ts",
+    "lint": "eslint \"src/**/*.{js,jsx,ts,tsx}\" \"tests/**/*.{js,jsx,ts,tsx}\"",
+    "lint:fix": "eslint --fix \"src/**/*.{js,jsx,ts,tsx}\" \"tests/**/*.{js,jsx,ts,tsx}\"",
+    "sonar": "bash sonar.sh"
   }
-}
+}