@docupace/ihub-config 1.1.25 → 1.1.26-sync.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;AA6eD,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,6BAAW,CAAA;AACb,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAyVD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA4ZD,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;AA8eD,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,6BAAW,CAAA;AACb,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAyVD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA4ZD,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

@@ -64,12 +64,14 @@ type InputField implements IField & IRowElement & IElement {
   maxRows: Int
   minRows: Int
     # End of text area configuration
+  custom: Boolean
 }
 
 type CustomValidator implements  IRowElement & IElement {
   validationRule: String
   errorMessage: String
   paths: [String!]!
+  custom: Boolean
 }
 
 union Fields = InputField | PhoneField | DateField | DateRangeField | SelectField | ToggleField | BooleanField | TextElement
@@ -93,6 +95,7 @@ type RepeaterField implements IRowElement & IElement {
   validateUnique: Boolean
   duplicateMessage: String
   itemValidation: ItemValidation
+  custom: Boolean
 }
 
 type ControlGroup implements IRowElement & IElement {
@@ -101,6 +104,38 @@ type ControlGroup implements IRowElement & IElement {
   skipId: Boolean
   controlOptions: ISelectOptions!
   fields: [Fields!]!
+  custom: Boolean
+}
+
+# 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!]
+  custom: Boolean
 }
 
 type PhoneField implements IField & IRowElement & IElement {
@@ -119,6 +154,7 @@ type PhoneField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type DateField implements IField & IRowElement & IElement {
@@ -138,6 +174,7 @@ type DateField implements IField & IRowElement & IElement {
   minDate: String # e.q. "now" or "2025-03-20"
   maxDate: String # e.q. "now" or "2025-03-20"
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type DateRangeField implements IDateRangeField & IRowElement & IElement {
@@ -157,6 +194,7 @@ type DateRangeField implements IDateRangeField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type SelectField implements IField & IRowElement & IElement {
@@ -182,6 +220,7 @@ type SelectField implements IField & IRowElement & IElement {
   helperText: String
   autoSelectSingleOption: Boolean
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type ToggleField implements IField & IRowElement & IElement {
@@ -204,6 +243,7 @@ type ToggleField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type BooleanField implements IField & IRowElement & IElement {
@@ -222,6 +262,7 @@ type BooleanField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type ChipSelectWithInputField implements IField & IRowElement & IElement {
@@ -247,6 +288,7 @@ type ChipSelectWithInputField implements IField & IRowElement & IElement {
   disabledCondition: String
   linkedFields: [String!]
   validation: ChipSelectValidation
+  custom: Boolean
 }
 
 type CustomField implements IField & IRowElement & IElement {
@@ -266,6 +308,7 @@ type CustomField implements IField & IRowElement & IElement {
   visibilityCondition: String
   disabledCondition: String
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type StatusChipField implements IField & IRowElement & IElement {
@@ -275,6 +318,7 @@ type StatusChipField implements IField & IRowElement & IElement {
   name: String!
   path: String!
   validation: GenericFieldValidation
+  custom: Boolean
 }
 
 type CheckboxGroupValue {
@@ -295,6 +339,7 @@ type CheckboxGroup implements IRowElement & IElement {
   values: [CheckboxGroupValue!]!
   visibilityCondition: String
   disabledCondition: String
+  custom: Boolean
 }
 
 enum FieldValueType {

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/panel.graphql

@@ -27,4 +27,11 @@ type PanelRow implements IPanelRow {
     title: String
     titleVariant: String
     visibilityCondition: String
+    """
+    Screen Designer: true when this group exists only via the screen layout patch — no
+    counterpart in the raw base config — vs. `false`/absent for a real group (whether or
+    not the patch also overrides some of its properties). See `Tab.custom` for the full
+    reasoning; stamped the same way, one level down the tree.
+    """
+    custom: Boolean
 }

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/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 show up — present by name *and* not hidden — 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 two things in the Configure Filters editor. Hide-vs-delete: "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, while a non-inherited one can be deleted outright. And pin-on-add: re-adding a *non*-inherited criterion must write an explicit `visible: true`, or the broader layer's `visible: false` is inherited per-attribute by the name-keyed merge and the criterion stays invisible however it's re-added. Computed fresh on every read in `config-service.ts`'s `applyConfigPathOverride` against the layers below the identity's own scope tier (`ConfigurationOverrideResult.inheritedSubPaths`), 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 show up — present by name *and* not hidden — 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 and pin-on-add in the Configure Columns editor — see `TableCriteria.inherited`'s doc comment for the full reasoning, identical here."""
+    inherited: Boolean
 }
 
 type ColumnFilter {

package/model/graphs/config/ui-components.graphql

@@ -8,4 +8,5 @@ type TextElement implements IRowElement & IElement {
     valueExpression: String
     variant: String
     visibilityCondition: String
+    custom: Boolean
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docupace/ihub-config",
-  "version": "1.1.25",
+  "version": "1.1.26-sync.0",
   "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",