@mapped/schema-graph-react-apollo 2.3.3 → 2.3.7

package/dist/index.d.ts

@@ -600,6 +600,28 @@ export type BaCnetVendorIdModel = {
   value?: Maybe<Scalars['String']>;
 };
 
+/**
+ * A background job. `params` is free-form JSON. For connector entity jobs it is:
+ *
+ * ```json
+ * { "params": { "buildingId": "BLDG8R2nW3kq" } }
+ * ```
+ *
+ * for `importEntities/<connectorId>/<sourceType>`, and
+ *
+ * ```json
+ * {
+ *   "connectorId": "CON…",
+ *   "sourceType": "room",
+ *   "commitMessage": "Rename floor 2 rooms",
+ *   "rules": { "typescript": "<base64>", "javascript": "<base64>" },
+ *   "noEntityChanges": true,
+ *   "redispatchedEntities": 12
+ * }
+ * ```
+ *
+ * for `mergeEntities/<connectorId>/<sourceType>`. `noEntityChanges` is present only on a save that changed no entity, such as a rule-only save. `redispatchedEntities` is present only when the merge picked up rows a failed merge left behind.
+ */
 export type BaseJob = {
   __typename?: 'BaseJob';
   completedAt?: Maybe<Scalars['DateTime']>;
@@ -609,6 +631,7 @@ export type BaseJob = {
   id?: Maybe<Scalars['String']>;
   name?: Maybe<Scalars['String']>;
   orgId?: Maybe<Scalars['String']>;
+  /** Free-form JSON the job was started with; see the examples in the type description. */
   params?: Maybe<Scalars['GraphQLJSON']>;
   parentResourceId?: Maybe<Scalars['String']>;
   percentageComplete?: Maybe<Scalars['Int']>;
@@ -1694,9 +1717,39 @@ export type ConnectorDeleteResponse = {
   _?: Maybe<Scalars['String']>;
 };
 
+/**
+ * One row of a connector's entities namespace: an entity the connector imported from its source system, staged until a merge writes it to the graph.
+ *
+ * `context` is free-form JSON. It holds the connector's own read-only source data, plus, on `previewConnectorEntities` responses only, a reserved `__preview` bucket the server computes for each row:
+ *
+ * ```json
+ * {
+ *   "area": 42.5,
+ *   "number": "B1-204",
+ *   "__preview": {
+ *     "tags": ["selected", "updated", "firstSeen"],
+ *     "fields": {
+ *       "name":  { "display": "DEFAULT", "diverged": true },
+ *       "floor": { "display": "RULE", "graphCheck": "UNRESOLVED" }
+ *     },
+ *     "selection": { "display": "SETTLED" },
+ *     "selectable": true,
+ *     "missingRequired": [],
+ *     "duplicateUnique": [],
+ *     "removedFields": ["legacyCode"],
+ *     "contextChanged": true,
+ *     "baseTypeChanged": true,
+ *     "rulesError": { "scope": "entity", "message": "Cannot read properties of undefined", "line": 3, "column": 12 }
+ *   }
+ * }
+ * ```
+ *
+ * `tags` values: `selected`, `added`, `updated`, `deleted`, `missing`, `unresolved`, `firstSeen`. `display` values, in precedence order: `CONFLICT`, `RULE`, `UNSAVED`, `DEFAULT`, `SETTLED`. `diverged`, `removedFields`, `contextChanged` and `baseTypeChanged` appear only when true or non-empty, and say why an `updated` row changed. `rulesError` appears only when the merge rule failed for the row: `scope` is `entity` for this row only, or `rule` for the whole rule, on every row. Keys starting with `__` are reserved for the platform.
+ */
 export type ConnectorEntity = {
   __typename?: 'ConnectorEntity';
   baseType?: Maybe<ConnectorEntityBaseType>;
+  /** Free-form JSON from the connector, plus the server-computed `__preview` bucket on preview responses; see the example in the type description. */
   context?: Maybe<Scalars['GraphQLJSON']>;
   /** @deprecated Field no longer supported */
   exactType?: Maybe<EntityTypeKey>;
@@ -1743,12 +1796,20 @@ export enum ConnectorEntityChangeKindInput {
   Updated = 'UPDATED'
 }
 
+/**
+ * A typed column of an entity. `options` is free-form JSON owned by the connector SDK. Today it carries the allow-list of target types for an `ENTITY_REF` field:
+ *
+ * ```json
+ * { "allowedTypes": ["Floor", "Building"] }
+ * ```
+ */
 export type ConnectorEntityField = {
   __typename?: 'ConnectorEntityField';
   defaultValue?: Maybe<ConnectorEntityFieldValue>;
   hidden?: Maybe<Scalars['Boolean']>;
   label?: Maybe<Scalars['String']>;
   name?: Maybe<Scalars['String']>;
+  /** Free-form JSON; see the example in the type description. */
   options?: Maybe<Scalars['GraphQLJSON']>;
   readOnly?: Maybe<Scalars['Boolean']>;
   relationship?: Maybe<ConnectorEntityFieldRelationship>;
@@ -1758,11 +1819,19 @@ export type ConnectorEntityField = {
   value?: Maybe<ConnectorEntityFieldValue>;
 };
 
+/**
+ * A typed column of an entity. `options` is free-form JSON owned by the connector SDK. Today it carries the allow-list of target types for an `ENTITY_REF` field:
+ *
+ * ```json
+ * { "allowedTypes": ["Floor", "Building"] }
+ * ```
+ */
 export type ConnectorEntityFieldInput = {
   defaultValue?: Maybe<ConnectorEntityFieldValueInput>;
   hidden?: Maybe<Scalars['Boolean']>;
   label?: Maybe<Scalars['String']>;
   name?: Maybe<Scalars['String']>;
+  /** Free-form JSON; see the example in the type description. */
   options?: Maybe<Scalars['GraphQLJSON']>;
   readOnly?: Maybe<Scalars['Boolean']>;
   relationship?: Maybe<ConnectorEntityFieldRelationshipInput>;
@@ -1855,8 +1924,16 @@ export type ConnectorEntityGetRulesDeclarationTypesResponse = {
   declarationTypes?: Maybe<Scalars['String']>;
 };
 
+/**
+ * Starts an import job for one namespace. `params` is free-form JSON passed verbatim to the connector's import function; its keys are whatever the connector declares as import parameters:
+ *
+ * ```json
+ * { "buildingId": "BLDG8R2nW3kq", "includeArchived": false }
+ * ```
+ */
 export type ConnectorEntityImportRequestInput = {
   namespace?: Maybe<ConnectorEntityNamespaceInput>;
+  /** Free-form JSON passed verbatim to the connector; see the example in the type description. */
   params?: Maybe<Scalars['GraphQLJSON']>;
 };
 
@@ -1865,13 +1942,119 @@ export type ConnectorEntityImportResponse = {
   job?: Maybe<BaseJob>;
 };
 
+/**
+ * Narrows the entities of one namespace. `previewConnectorEntities` (as `list.filter`) is the searchable listing; `listConnectorEntities` rejects a non-blank `searchQuery` with `UNIMPLEMENTED`.
+ *
+ * | Field | `listConnectorEntities` | `previewConnectorEntities` |
+ * |---|---|---|
+ * | `id` | `eq` / `in` | `eq` / `in` |
+ * | `refId`, `mappingKey` | `eq` / `in` | ignored; use `searchQuery` |
+ * | `mergingState` | the first of `eq`, `in`, `ne` that is set | `eq`, `in` and `ne` together, against the state the entity would have after this save |
+ * | `lastChangeDate` | every operator set, so `gte` + `lte` is a closed range; an entity never merged matches no bound | same |
+ * | `lastChangeKind` | the first of `eq`, `in`, `ne` that is set | same |
+ * | `searchQuery` | rejected | the grammar below |
+ *
+ * **searchQuery**
+ *
+ * Up to three parts, separated by whitespace, in any order, all combined with AND. Canonical order:
+ *
+ * ```text
+ * #tags gridv1:TOKEN free text
+ * ```
+ *
+ * **Free text**
+ *
+ * - Split on whitespace; every word must appear, as a case-insensitive substring, somewhere in the entity. Word order does not matter.
+ * - Searched: `refId`, the `exactType` and `baseType` names, every `context` value, and every field value of any type (displayed, default and saved), including an entity reference's readable parts.
+ * - Platform ids (`id`, `mappedId`, `mappingKey`, `legacyMappingKey`, and the ids inside an entity reference) match only a word of 8 or more characters: a pasted id finds its entity, a short word such as `2` never matches every entity through a shared id prefix.
+ * - Never searched: `sourceType`, context keys starting with `__`, field slugs, labels and `options`, boolean values, and platform state such as `mergingState` (use the hashtags).
+ *
+ * **Hashtags**
+ *
+ * Case-insensitive and whitespace-bounded; several are combined with AND. Each keeps the entities carrying that tag in `context.__preview.tags`:
+ *
+ * - `#selected`: selected after this save.
+ * - `#added`: this save adds it to the graph.
+ * - `#updated`: already in the graph, and its values change (by a user, a rule, or the source system since its last merge).
+ * - `#deleted`: a user or a rule unselected it, so this save deletes it from the graph; never a missing entity.
+ * - `#missing`: merged, but the source system no longer reports it, so every save deletes it; never tagged `deleted`.
+ * - `#firstSeen`: first imported after the namespace's last save, selected or not; none until the namespace has been saved or merged once.
+ * - `#unresolved`: added or updated, with an entity reference pointing at nothing in the graph. It runs the graph check: if the check cannot complete, the request fails with `ABORTED` (retry) or `RESOURCE_EXHAUSTED` (too many references) instead of returning an empty page.
+ *
+ * Any other `#word`, and a tag glued to another word (`abc#added`), is free text.
+ *
+ * **Grid token**
+ *
+ * A column filter and sort, at most one per query: `gridv1:` followed by the unpadded base64url encoding of this JSON (MUI X DataGrid's filter and sort models; other keys are ignored, both models are optional):
+ *
+ * ```json
+ * {
+ *   "filterModel": {
+ *     "items": [{ "field": "floor", "operator": ">=", "value": 2 }],
+ *     "logicOperator": "and"
+ *   },
+ *   "sortModel": [{ "field": "name", "sort": "asc" }]
+ * }
+ * ```
+ *
+ * - `logicOperator` is `and` (the default) or `or`, over a flat list of items. `sort` is `asc`, `desc`, or `null` (ignored).
+ * - `field` is a field slug, `@` followed by a context key (non-string values compare as their JSON), or one of the reserved keys `refId`, `mappingKey`, `mappedId`, `legacyMappingKey`. A field slug the namespace does not declare is ignored; a context key starting with `__` is rejected.
+ * - Columns compare as numbers (`FLOOR_LEVEL` fields), by presence only (`ENTITY_REF` fields, whose names are resolved client-side; not sortable), or as text (every other field and key). Operators:
+ *
+ * ```text
+ * operator                                  text  number  entity reference
+ * contains, doesNotContain                  yes   -       -
+ * equals, =, is / doesNotEqual, !=, not     yes   yes     -
+ * startsWith, endsWith                      yes   -       -
+ * isEmpty, isNotEmpty                       yes   yes     yes
+ * isAnyOf (value is an array)               yes   yes     -
+ * >, >=, <, <=                              -     yes     -
+ * ```
+ *
+ * - Values compare against the displayed value (after rules and unsaved edits). Text equality and `isAnyOf` ignore case and accents; `contains`, `startsWith` and `endsWith` ignore case only. Blank text counts as empty. An item with no usable value (missing, blank, `NaN`, an empty array) is ignored.
+ * - Sort keys apply in order: natural order ("Room 2" before "Room 10"), case-insensitive, empty values last in both directions, ties broken by entity `id`.
+ * - Filters and sorts the listing before pagination; never changes the counts.
+ * - Limits, counted before ignored fields are dropped: 50 filter items, 200 `isAnyOf` values summed over the whole query, 10 sort keys, and a 32 KiB encoded payload.
+ * - A second token, an unknown `gridvN` version, a payload that is not base64url JSON of this shape, an unknown operator, an operator the column cannot take, a sort on an entity reference, or a limit exceeded fails with `INVALID_ARGUMENT` and a message starting `Invalid grid query:`.
+ *
+ * **Example**
+ *
+ * For a namespace with fields `floor` (`FLOOR_LEVEL`), `building` (`ENTITY_REF`) and `name` (`NAME`): entities this save adds, on floor 2 or above, whose `department` context is IT or Facilities, with a building set, containing "lobby", sorted by name.
+ *
+ * ```text
+ * #added gridv1:eyJmaWx0ZXJNb2RlbCI6eyJpdGVtcyI6W3siZmllbGQiOiJmbG9vciIsIm9wZXJhdG9yIjoiPj0iLCJ2YWx1ZSI6Mn0seyJmaWVsZCI6IkBkZXBhcnRtZW50Iiwib3BlcmF0b3IiOiJpc0FueU9mIiwidmFsdWUiOlsiSVQiLCJGYWNpbGl0aWVzIl19LHsiZmllbGQiOiJidWlsZGluZyIsIm9wZXJhdG9yIjoiaXNOb3RFbXB0eSJ9XSwibG9naWNPcGVyYXRvciI6ImFuZCJ9LCJzb3J0TW9kZWwiOlt7ImZpZWxkIjoibmFtZSIsInNvcnQiOiJhc2MifV19 lobby
+ * ```
+ *
+ * The token decodes to:
+ *
+ * ```json
+ * {
+ *   "filterModel": {
+ *     "items": [
+ *       { "field": "floor", "operator": ">=", "value": 2 },
+ *       { "field": "@department", "operator": "isAnyOf", "value": ["IT", "Facilities"] },
+ *       { "field": "building", "operator": "isNotEmpty" }
+ *     ],
+ *     "logicOperator": "and"
+ *   },
+ *   "sortModel": [{ "field": "name", "sort": "asc" }]
+ * }
+ * ```
+ */
 export type ConnectorEntityListFilterInput = {
+  /** Entity ids to keep, by eq or in. */
   id?: Maybe<IdFilterExpressionInput>;
+  /** When a merge last changed the entity in the graph; every operator set applies, so gte with lte is a closed range, and an entity never merged matches no bound. */
   lastChangeDate?: Maybe<TimestampFilterExpressionInput>;
+  /** What the last merge did to the entity; only the first operator set among eq, in and ne applies. */
   lastChangeKind?: Maybe<ConnectorEntityChangeKindFilterExpressionInput>;
+  /** Mapping keys to keep, by eq or in; applied by listConnectorEntities only, previewConnectorEntities ignores it. */
   mappingKey?: Maybe<IdFilterExpressionInput>;
+  /** Merging states to keep; listConnectorEntities applies the first operator set among eq, in and ne, previewConnectorEntities applies all of them to the state the entity would have after the save. */
   mergingState?: Maybe<ConnectorEntityMergingStateFilterExpressionInput>;
+  /** Source-system ids to keep, by eq or in; applied by listConnectorEntities only, previewConnectorEntities ignores it. */
   refId?: Maybe<IdFilterExpressionInput>;
+  /** Free text, hashtag filters and an optional grid filter and sort token, honoured by previewConnectorEntities only (listConnectorEntities rejects it); see the type description for the grammar and an example. */
   searchQuery?: Maybe<Scalars['String']>;
 };
 
@@ -1982,9 +2165,17 @@ export type ConnectorEntityMigrationEntity = {
   legacyMappingKey?: Maybe<Scalars['String']>;
 };
 
+/**
+ * A legacy graph node the connector no longer owns after a migration, recorded for review. `data` is free-form JSON derived from the legacy place mapping:
+ *
+ * ```json
+ * { "name": "Room 204", "floor": "2", "sourceId": "ROOM-204" }
+ * ```
+ */
 export type ConnectorEntityMigrationOrphan = {
   __typename?: 'ConnectorEntityMigrationOrphan';
-  data?: Maybe<Scalars['GeoJSON']>;
+  /** Free-form JSON derived from the legacy place mapping; see the example in the type description. */
+  data?: Maybe<Scalars['GraphQLJSON']>;
   exactType?: Maybe<EntityTypeKey>;
   legacyMappingKey?: Maybe<Scalars['String']>;
 };
@@ -1992,6 +2183,7 @@ export type ConnectorEntityMigrationOrphan = {
 export type ConnectorEntityMigrationState = {
   __typename?: 'ConnectorEntityMigrationState';
   configHash?: Maybe<Scalars['String']>;
+  /** Free-form JSON copy of the connector's configuration taken when the migration committed. */
   configSnapshot?: Maybe<Scalars['GraphQLJSON']>;
   counts?: Maybe<ConnectorEntityMigrationCounts>;
   error?: Maybe<Scalars['String']>;
@@ -2019,12 +2211,22 @@ export type ConnectorEntityPrepareMigrationRequestInput = {
   connectorId?: Maybe<Scalars['String']>;
 };
 
+/** Counts for the whole namespace of what a save would do, independent of any listing filter. */
 export type ConnectorEntityPreviewCounts = {
   __typename?: 'ConnectorEntityPreviewCounts';
+  /** Entities this save adds to the graph. */
   added?: Maybe<Scalars['Int']>;
+  /** Entities a user or a rule unselected, which this save deletes from the graph; excludes missing. */
   deleted?: Maybe<Scalars['Int']>;
+  /** Entities first imported after the namespace's last save, selected or not; 0 until the namespace has been saved or merged once. */
+  firstSeen?: Maybe<Scalars['Int']>;
+  /** Merged entities the source system no longer reports, which every save deletes from the graph. */
+  missing?: Maybe<Scalars['Int']>;
+  /** Entities selected after this save. */
   selected?: Maybe<Scalars['Int']>;
+  /** Entities with an entity reference pointing at nothing in the graph; computed only with the FULL counts mode. */
   unresolved?: Maybe<Scalars['Int']>;
+  /** Entities already in the graph whose values change — by a user, a rule, or the source system since the entity's last merge. */
   updated?: Maybe<Scalars['Int']>;
 };
 
@@ -4901,6 +5103,7 @@ export enum EntityTypeKey {
   OpcuaDevice = 'OPCUA_DEVICE',
   OpcuaNode = 'OPCUA_NODE',
   OpcuaObject = 'OPCUA_OBJECT',
+  OpcuaProperty = 'OPCUA_PROPERTY',
   OpcuaServer = 'OPCUA_SERVER',
   OpcuaVariable = 'OPCUA_VARIABLE',
   Opening = 'OPENING',
@@ -7464,6 +7667,7 @@ export enum EntityTypeKeyInput {
   OpcuaDevice = 'OPCUA_DEVICE',
   OpcuaNode = 'OPCUA_NODE',
   OpcuaObject = 'OPCUA_OBJECT',
+  OpcuaProperty = 'OPCUA_PROPERTY',
   OpcuaServer = 'OPCUA_SERVER',
   OpcuaVariable = 'OPCUA_VARIABLE',
   Opening = 'OPENING',
@@ -10212,6 +10416,12 @@ export type HasProviderEdge = Edge & {
   node?: Maybe<GraphNode>;
 };
 
+export type HasUpstreamHeartbeatEdge = Edge & {
+  __typename?: 'HasUpstreamHeartbeatEdge';
+  mappingKey?: Maybe<Scalars['String']>;
+  node?: Maybe<GraphNode>;
+};
+
 export type Heartbeat = GraphNode & {
   __typename?: 'Heartbeat';
   connectedDataSourceId?: Maybe<Scalars['String']>;
@@ -10231,6 +10441,8 @@ export type Heartbeat = GraphNode & {
   hasPrimBindingEdges?: Maybe<Array<Maybe<HasPrimBindingEdge>>>;
   hasPropertyContributedFrom?: Maybe<Array<Maybe<HeartbeatHasPropertyContributedFromUnion>>>;
   hasPropertyContributedFromEdges?: Maybe<Array<Maybe<HeartbeatHasPropertyContributedFromEdge>>>;
+  hasUpstreamHeartbeat?: Maybe<Array<Maybe<Heartbeat>>>;
+  hasUpstreamHeartbeatEdges?: Maybe<Array<Maybe<HasUpstreamHeartbeatEdge>>>;
   id: Scalars['String'];
   identities?: Maybe<Array<Maybe<HeartbeatIdentityUnion>>>;
   isBilledTo?: Maybe<Account>;
@@ -10245,6 +10457,8 @@ export type Heartbeat = GraphNode & {
   isPartOfEdges?: Maybe<Array<Maybe<IsPartOfEdge>>>;
   isPointOf?: Maybe<Array<Maybe<IsPointOfUnion>>>;
   isPointOfEdges?: Maybe<Array<Maybe<IsPointOfEdge>>>;
+  isUpstreamHeartbeatOf?: Maybe<Array<Maybe<Heartbeat>>>;
+  isUpstreamHeartbeatOfEdges?: Maybe<Array<Maybe<IsUpstreamHeartbeatOfEdge>>>;
   mappingKey?: Maybe<Scalars['String']>;
   name?: Maybe<Scalars['String']>;
   series?: Maybe<Array<Maybe<TimeseriesRow>>>;
@@ -10285,6 +10499,12 @@ export type HeartbeatHasPrimBindingArgs = {
 };
 
 
+export type HeartbeatHasUpstreamHeartbeatArgs = {
+  filter?: Maybe<HeartbeatFilter>;
+  transitive?: Maybe<Scalars['Boolean']>;
+};
+
+
 export type HeartbeatIsBilledToArgs = {
   filter?: Maybe<AccountFilter>;
 };
@@ -10315,6 +10535,11 @@ export type HeartbeatIsPointOfArgs = {
 };
 
 
+export type HeartbeatIsUpstreamHeartbeatOfArgs = {
+  filter?: Maybe<HeartbeatFilter>;
+};
+
+
 export type HeartbeatSeriesArgs = {
   endTime?: Maybe<Scalars['DateTime']>;
   latest?: Maybe<Scalars['Boolean']>;
@@ -10726,6 +10951,12 @@ export type IsServedByEdge = Edge & {
   node?: Maybe<GraphNode>;
 };
 
+export type IsUpstreamHeartbeatOfEdge = Edge & {
+  __typename?: 'IsUpstreamHeartbeatOfEdge';
+  mappingKey?: Maybe<Scalars['String']>;
+  node?: Maybe<GraphNode>;
+};
+
 
 
 /** Job interface - base type for all job types */

package/dist/index.js

@@ -2028,6 +2028,7 @@ var EntityTypeKey = /* @__PURE__ */ ((EntityTypeKey2) => {
   EntityTypeKey2["OpcuaDevice"] = "OPCUA_DEVICE";
   EntityTypeKey2["OpcuaNode"] = "OPCUA_NODE";
   EntityTypeKey2["OpcuaObject"] = "OPCUA_OBJECT";
+  EntityTypeKey2["OpcuaProperty"] = "OPCUA_PROPERTY";
   EntityTypeKey2["OpcuaServer"] = "OPCUA_SERVER";
   EntityTypeKey2["OpcuaVariable"] = "OPCUA_VARIABLE";
   EntityTypeKey2["Opening"] = "OPENING";
@@ -4586,6 +4587,7 @@ var EntityTypeKeyInput = /* @__PURE__ */ ((EntityTypeKeyInput2) => {
   EntityTypeKeyInput2["OpcuaDevice"] = "OPCUA_DEVICE";
   EntityTypeKeyInput2["OpcuaNode"] = "OPCUA_NODE";
   EntityTypeKeyInput2["OpcuaObject"] = "OPCUA_OBJECT";
+  EntityTypeKeyInput2["OpcuaProperty"] = "OPCUA_PROPERTY";
   EntityTypeKeyInput2["OpcuaServer"] = "OPCUA_SERVER";
   EntityTypeKeyInput2["OpcuaVariable"] = "OPCUA_VARIABLE";
   EntityTypeKeyInput2["Opening"] = "OPENING";

package/mapped.schema.json

@@ -5206,7 +5206,7 @@
       {
         "kind": "OBJECT",
         "name": "BaseJob",
-        "description": null,
+        "description": "A background job. `params` is free-form JSON. For connector entity jobs it is:\n\n```json\n{ \"params\": { \"buildingId\": \"BLDG8R2nW3kq\" } }\n```\n\nfor `importEntities/<connectorId>/<sourceType>`, and\n\n```json\n{\n  \"connectorId\": \"CON…\",\n  \"sourceType\": \"room\",\n  \"commitMessage\": \"Rename floor 2 rooms\",\n  \"rules\": { \"typescript\": \"<base64>\", \"javascript\": \"<base64>\" },\n  \"noEntityChanges\": true,\n  \"redispatchedEntities\": 12\n}\n```\n\nfor `mergeEntities/<connectorId>/<sourceType>`. `noEntityChanges` is present only on a save that changed no entity, such as a rule-only save. `redispatchedEntities` is present only when the merge picked up rows a failed merge left behind.",
         "fields": [
           {
             "name": "completedAt",
@@ -5294,7 +5294,7 @@
           },
           {
             "name": "params",
-            "description": null,
+            "description": "Free-form JSON the job was started with; see the examples in the type description.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -12738,7 +12738,7 @@
       {
         "kind": "OBJECT",
         "name": "ConnectorEntity",
-        "description": null,
+        "description": "One row of a connector's entities namespace: an entity the connector imported from its source system, staged until a merge writes it to the graph.\n\n`context` is free-form JSON. It holds the connector's own read-only source data, plus, on `previewConnectorEntities` responses only, a reserved `__preview` bucket the server computes for each row:\n\n```json\n{\n  \"area\": 42.5,\n  \"number\": \"B1-204\",\n  \"__preview\": {\n    \"tags\": [\"selected\", \"updated\", \"firstSeen\"],\n    \"fields\": {\n      \"name\":  { \"display\": \"DEFAULT\", \"diverged\": true },\n      \"floor\": { \"display\": \"RULE\", \"graphCheck\": \"UNRESOLVED\" }\n    },\n    \"selection\": { \"display\": \"SETTLED\" },\n    \"selectable\": true,\n    \"missingRequired\": [],\n    \"duplicateUnique\": [],\n    \"removedFields\": [\"legacyCode\"],\n    \"contextChanged\": true,\n    \"baseTypeChanged\": true,\n    \"rulesError\": { \"scope\": \"entity\", \"message\": \"Cannot read properties of undefined\", \"line\": 3, \"column\": 12 }\n  }\n}\n```\n\n`tags` values: `selected`, `added`, `updated`, `deleted`, `missing`, `unresolved`, `firstSeen`. `display` values, in precedence order: `CONFLICT`, `RULE`, `UNSAVED`, `DEFAULT`, `SETTLED`. `diverged`, `removedFields`, `contextChanged` and `baseTypeChanged` appear only when true or non-empty, and say why an `updated` row changed. `rulesError` appears only when the merge rule failed for the row: `scope` is `entity` for this row only, or `rule` for the whole rule, on every row. Keys starting with `__` are reserved for the platform.",
         "fields": [
           {
             "name": "baseType",
@@ -12754,7 +12754,7 @@
           },
           {
             "name": "context",
-            "description": null,
+            "description": "Free-form JSON from the connector, plus the server-computed `__preview` bucket on preview responses; see the example in the type description.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -13089,7 +13089,7 @@
       {
         "kind": "OBJECT",
         "name": "ConnectorEntityField",
-        "description": null,
+        "description": "A typed column of an entity. `options` is free-form JSON owned by the connector SDK. Today it carries the allow-list of target types for an `ENTITY_REF` field:\n\n```json\n{ \"allowedTypes\": [\"Floor\", \"Building\"] }\n```",
         "fields": [
           {
             "name": "defaultValue",
@@ -13141,7 +13141,7 @@
           },
           {
             "name": "options",
-            "description": null,
+            "description": "Free-form JSON; see the example in the type description.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -13232,7 +13232,7 @@
       {
         "kind": "INPUT_OBJECT",
         "name": "ConnectorEntityFieldInput",
-        "description": null,
+        "description": "A typed column of an entity. `options` is free-form JSON owned by the connector SDK. Today it carries the allow-list of target types for an `ENTITY_REF` field:\n\n```json\n{ \"allowedTypes\": [\"Floor\", \"Building\"] }\n```",
         "fields": null,
         "inputFields": [
           {
@@ -13285,7 +13285,7 @@
           },
           {
             "name": "options",
-            "description": null,
+            "description": "Free-form JSON; see the example in the type description.",
             "type": {
               "kind": "SCALAR",
               "name": "GraphQLJSON",
@@ -13906,7 +13906,7 @@
       {
         "kind": "INPUT_OBJECT",
         "name": "ConnectorEntityImportRequestInput",
-        "description": null,
+        "description": "Starts an import job for one namespace. `params` is free-form JSON passed verbatim to the connector's import function; its keys are whatever the connector declares as import parameters:\n\n```json\n{ \"buildingId\": \"BLDG8R2nW3kq\", \"includeArchived\": false }\n```",
         "fields": null,
         "inputFields": [
           {
@@ -13923,7 +13923,7 @@
           },
           {
             "name": "params",
-            "description": null,
+            "description": "Free-form JSON passed verbatim to the connector; see the example in the type description.",
             "type": {
               "kind": "SCALAR",
               "name": "GraphQLJSON",
@@ -13964,12 +13964,12 @@
       {
         "kind": "INPUT_OBJECT",
         "name": "ConnectorEntityListFilterInput",
-        "description": null,
+        "description": "Narrows the entities of one namespace. `previewConnectorEntities` (as `list.filter`) is the searchable listing; `listConnectorEntities` rejects a non-blank `searchQuery` with `UNIMPLEMENTED`.\n\n| Field | `listConnectorEntities` | `previewConnectorEntities` |\n|---|---|---|\n| `id` | `eq` / `in` | `eq` / `in` |\n| `refId`, `mappingKey` | `eq` / `in` | ignored; use `searchQuery` |\n| `mergingState` | the first of `eq`, `in`, `ne` that is set | `eq`, `in` and `ne` together, against the state the entity would have after this save |\n| `lastChangeDate` | every operator set, so `gte` + `lte` is a closed range; an entity never merged matches no bound | same |\n| `lastChangeKind` | the first of `eq`, `in`, `ne` that is set | same |\n| `searchQuery` | rejected | the grammar below |\n\n**searchQuery**\n\nUp to three parts, separated by whitespace, in any order, all combined with AND. Canonical order:\n\n```text\n#tags gridv1:TOKEN free text\n```\n\n**Free text**\n\n- Split on whitespace; every word must appear, as a case-insensitive substring, somewhere in the entity. Word order does not matter.\n- Searched: `refId`, the `exactType` and `baseType` names, every `context` value, and every field value of any type (displayed, default and saved), including an entity reference's readable parts.\n- Platform ids (`id`, `mappedId`, `mappingKey`, `legacyMappingKey`, and the ids inside an entity reference) match only a word of 8 or more characters: a pasted id finds its entity, a short word such as `2` never matches every entity through a shared id prefix.\n- Never searched: `sourceType`, context keys starting with `__`, field slugs, labels and `options`, boolean values, and platform state such as `mergingState` (use the hashtags).\n\n**Hashtags**\n\nCase-insensitive and whitespace-bounded; several are combined with AND. Each keeps the entities carrying that tag in `context.__preview.tags`:\n\n- `#selected`: selected after this save.\n- `#added`: this save adds it to the graph.\n- `#updated`: already in the graph, and its values change (by a user, a rule, or the source system since its last merge).\n- `#deleted`: a user or a rule unselected it, so this save deletes it from the graph; never a missing entity.\n- `#missing`: merged, but the source system no longer reports it, so every save deletes it; never tagged `deleted`.\n- `#firstSeen`: first imported after the namespace's last save, selected or not; none until the namespace has been saved or merged once.\n- `#unresolved`: added or updated, with an entity reference pointing at nothing in the graph. It runs the graph check: if the check cannot complete, the request fails with `ABORTED` (retry) or `RESOURCE_EXHAUSTED` (too many references) instead of returning an empty page.\n\nAny other `#word`, and a tag glued to another word (`abc#added`), is free text.\n\n**Grid token**\n\nA column filter and sort, at most one per query: `gridv1:` followed by the unpadded base64url encoding of this JSON (MUI X DataGrid's filter and sort models; other keys are ignored, both models are optional):\n\n```json\n{\n  \"filterModel\": {\n    \"items\": [{ \"field\": \"floor\", \"operator\": \">=\", \"value\": 2 }],\n    \"logicOperator\": \"and\"\n  },\n  \"sortModel\": [{ \"field\": \"name\", \"sort\": \"asc\" }]\n}\n```\n\n- `logicOperator` is `and` (the default) or `or`, over a flat list of items. `sort` is `asc`, `desc`, or `null` (ignored).\n- `field` is a field slug, `@` followed by a context key (non-string values compare as their JSON), or one of the reserved keys `refId`, `mappingKey`, `mappedId`, `legacyMappingKey`. A field slug the namespace does not declare is ignored; a context key starting with `__` is rejected.\n- Columns compare as numbers (`FLOOR_LEVEL` fields), by presence only (`ENTITY_REF` fields, whose names are resolved client-side; not sortable), or as text (every other field and key). Operators:\n\n```text\noperator                                  text  number  entity reference\ncontains, doesNotContain                  yes   -       -\nequals, =, is / doesNotEqual, !=, not     yes   yes     -\nstartsWith, endsWith                      yes   -       -\nisEmpty, isNotEmpty                       yes   yes     yes\nisAnyOf (value is an array)               yes   yes     -\n>, >=, <, <=                              -     yes     -\n```\n\n- Values compare against the displayed value (after rules and unsaved edits). Text equality and `isAnyOf` ignore case and accents; `contains`, `startsWith` and `endsWith` ignore case only. Blank text counts as empty. An item with no usable value (missing, blank, `NaN`, an empty array) is ignored.\n- Sort keys apply in order: natural order (\"Room 2\" before \"Room 10\"), case-insensitive, empty values last in both directions, ties broken by entity `id`.\n- Filters and sorts the listing before pagination; never changes the counts.\n- Limits, counted before ignored fields are dropped: 50 filter items, 200 `isAnyOf` values summed over the whole query, 10 sort keys, and a 32 KiB encoded payload.\n- A second token, an unknown `gridvN` version, a payload that is not base64url JSON of this shape, an unknown operator, an operator the column cannot take, a sort on an entity reference, or a limit exceeded fails with `INVALID_ARGUMENT` and a message starting `Invalid grid query:`.\n\n**Example**\n\nFor a namespace with fields `floor` (`FLOOR_LEVEL`), `building` (`ENTITY_REF`) and `name` (`NAME`): entities this save adds, on floor 2 or above, whose `department` context is IT or Facilities, with a building set, containing \"lobby\", sorted by name.\n\n```text\n#added gridv1:eyJmaWx0ZXJNb2RlbCI6eyJpdGVtcyI6W3siZmllbGQiOiJmbG9vciIsIm9wZXJhdG9yIjoiPj0iLCJ2YWx1ZSI6Mn0seyJmaWVsZCI6IkBkZXBhcnRtZW50Iiwib3BlcmF0b3IiOiJpc0FueU9mIiwidmFsdWUiOlsiSVQiLCJGYWNpbGl0aWVzIl19LHsiZmllbGQiOiJidWlsZGluZyIsIm9wZXJhdG9yIjoiaXNOb3RFbXB0eSJ9XSwibG9naWNPcGVyYXRvciI6ImFuZCJ9LCJzb3J0TW9kZWwiOlt7ImZpZWxkIjoibmFtZSIsInNvcnQiOiJhc2MifV19 lobby\n```\n\nThe token decodes to:\n\n```json\n{\n  \"filterModel\": {\n    \"items\": [\n      { \"field\": \"floor\", \"operator\": \">=\", \"value\": 2 },\n      { \"field\": \"@department\", \"operator\": \"isAnyOf\", \"value\": [\"IT\", \"Facilities\"] },\n      { \"field\": \"building\", \"operator\": \"isNotEmpty\" }\n    ],\n    \"logicOperator\": \"and\"\n  },\n  \"sortModel\": [{ \"field\": \"name\", \"sort\": \"asc\" }]\n}\n```",
         "fields": null,
         "inputFields": [
           {
             "name": "id",
-            "description": null,
+            "description": "Entity ids to keep, by eq or in.",
             "type": {
               "kind": "INPUT_OBJECT",
               "name": "IDFilterExpressionInput",
@@ -13981,7 +13981,7 @@
           },
           {
             "name": "lastChangeDate",
-            "description": null,
+            "description": "When a merge last changed the entity in the graph; every operator set applies, so gte with lte is a closed range, and an entity never merged matches no bound.",
             "type": {
               "kind": "INPUT_OBJECT",
               "name": "TimestampFilterExpressionInput",
@@ -13993,7 +13993,7 @@
           },
           {
             "name": "lastChangeKind",
-            "description": null,
+            "description": "What the last merge did to the entity; only the first operator set among eq, in and ne applies.",
             "type": {
               "kind": "INPUT_OBJECT",
               "name": "ConnectorEntityChangeKindFilterExpressionInput",
@@ -14005,7 +14005,7 @@
           },
           {
             "name": "mappingKey",
-            "description": null,
+            "description": "Mapping keys to keep, by eq or in; applied by listConnectorEntities only, previewConnectorEntities ignores it.",
             "type": {
               "kind": "INPUT_OBJECT",
               "name": "IDFilterExpressionInput",
@@ -14017,7 +14017,7 @@
           },
           {
             "name": "mergingState",
-            "description": null,
+            "description": "Merging states to keep; listConnectorEntities applies the first operator set among eq, in and ne, previewConnectorEntities applies all of them to the state the entity would have after the save.",
             "type": {
               "kind": "INPUT_OBJECT",
               "name": "ConnectorEntityMergingStateFilterExpressionInput",
@@ -14029,7 +14029,7 @@
           },
           {
             "name": "refId",
-            "description": null,
+            "description": "Source-system ids to keep, by eq or in; applied by listConnectorEntities only, previewConnectorEntities ignores it.",
             "type": {
               "kind": "INPUT_OBJECT",
               "name": "IDFilterExpressionInput",
@@ -14041,7 +14041,7 @@
           },
           {
             "name": "searchQuery",
-            "description": null,
+            "description": "Free text, hashtag filters and an optional grid filter and sort token, honoured by previewConnectorEntities only (listConnectorEntities rejects it); see the type description for the grammar and an example.",
             "type": {
               "kind": "SCALAR",
               "name": "String",
@@ -14779,15 +14779,15 @@
       {
         "kind": "OBJECT",
         "name": "ConnectorEntityMigrationOrphan",
-        "description": null,
+        "description": "A legacy graph node the connector no longer owns after a migration, recorded for review. `data` is free-form JSON derived from the legacy place mapping:\n\n```json\n{ \"name\": \"Room 204\", \"floor\": \"2\", \"sourceId\": \"ROOM-204\" }\n```",
         "fields": [
           {
             "name": "data",
-            "description": null,
+            "description": "Free-form JSON derived from the legacy place mapping; see the example in the type description.",
             "args": [],
             "type": {
               "kind": "SCALAR",
-              "name": "GeoJSON",
+              "name": "GraphQLJSON",
               "ofType": null
             },
             "isDeprecated": false,
@@ -14842,7 +14842,7 @@
           },
           {
             "name": "configSnapshot",
-            "description": null,
+            "description": "Free-form JSON copy of the connector's configuration taken when the migration committed.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -15032,11 +15032,11 @@
       {
         "kind": "OBJECT",
         "name": "ConnectorEntityPreviewCounts",
-        "description": null,
+        "description": "Counts for the whole namespace of what a save would do, independent of any listing filter.",
         "fields": [
           {
             "name": "added",
-            "description": null,
+            "description": "Entities this save adds to the graph.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -15048,7 +15048,31 @@
           },
           {
             "name": "deleted",
-            "description": null,
+            "description": "Entities a user or a rule unselected, which this save deletes from the graph; excludes missing.",
+            "args": [],
+            "type": {
+              "kind": "SCALAR",
+              "name": "Int",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "firstSeen",
+            "description": "Entities first imported after the namespace's last save, selected or not; 0 until the namespace has been saved or merged once.",
+            "args": [],
+            "type": {
+              "kind": "SCALAR",
+              "name": "Int",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "missing",
+            "description": "Merged entities the source system no longer reports, which every save deletes from the graph.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -15060,7 +15084,7 @@
           },
           {
             "name": "selected",
-            "description": null,
+            "description": "Entities selected after this save.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -15072,7 +15096,7 @@
           },
           {
             "name": "unresolved",
-            "description": null,
+            "description": "Entities with an entity reference pointing at nothing in the graph; computed only with the FULL counts mode.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -15084,7 +15108,7 @@
           },
           {
             "name": "updated",
-            "description": null,
+            "description": "Entities already in the graph whose values change — by a user, a rule, or the source system since the entity's last merge.",
             "args": [],
             "type": {
               "kind": "SCALAR",
@@ -22560,6 +22584,11 @@
             "name": "HasProviderEdge",
             "ofType": null
           },
+          {
+            "kind": "OBJECT",
+            "name": "HasUpstreamHeartbeatEdge",
+            "ofType": null
+          },
           {
             "kind": "OBJECT",
             "name": "HostsEdge",
@@ -22680,6 +22709,11 @@
             "name": "IsServedByEdge",
             "ofType": null
           },
+          {
+            "kind": "OBJECT",
+            "name": "IsUpstreamHeartbeatOfEdge",
+            "ofType": null
+          },
           {
             "kind": "OBJECT",
             "name": "ManufacturedByEdge",
@@ -34768,6 +34802,12 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
+          {
+            "name": "OPCUA_PROPERTY",
+            "description": null,
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
           {
             "name": "OPCUA_SERVER",
             "description": null,
@@ -50148,6 +50188,12 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
+          {
+            "name": "OPCUA_PROPERTY",
+            "description": null,
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
           {
             "name": "OPCUA_SERVER",
             "description": null,
@@ -68942,6 +68988,47 @@
         "enumValues": null,
         "possibleTypes": null
       },
+      {
+        "kind": "OBJECT",
+        "name": "HasUpstreamHeartbeatEdge",
+        "description": null,
+        "fields": [
+          {
+            "name": "mappingKey",
+            "description": null,
+            "args": [],
+            "type": {
+              "kind": "SCALAR",
+              "name": "String",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "node",
+            "description": null,
+            "args": [],
+            "type": {
+              "kind": "INTERFACE",
+              "name": "GraphNode",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "inputFields": null,
+        "interfaces": [
+          {
+            "kind": "INTERFACE",
+            "name": "Edge",
+            "ofType": null
+          }
+        ],
+        "enumValues": null,
+        "possibleTypes": null
+      },
       {
         "kind": "OBJECT",
         "name": "Heartbeat",
@@ -69320,6 +69407,63 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
+          {
+            "name": "hasUpstreamHeartbeat",
+            "description": null,
+            "args": [
+              {
+                "name": "filter",
+                "description": null,
+                "type": {
+                  "kind": "INPUT_OBJECT",
+                  "name": "HeartbeatFilter",
+                  "ofType": null
+                },
+                "defaultValue": null,
+                "isDeprecated": false,
+                "deprecationReason": null
+              },
+              {
+                "name": "transitive",
+                "description": null,
+                "type": {
+                  "kind": "SCALAR",
+                  "name": "Boolean",
+                  "ofType": null
+                },
+                "defaultValue": "false",
+                "isDeprecated": false,
+                "deprecationReason": null
+              }
+            ],
+            "type": {
+              "kind": "LIST",
+              "name": null,
+              "ofType": {
+                "kind": "OBJECT",
+                "name": "Heartbeat",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "hasUpstreamHeartbeatEdges",
+            "description": null,
+            "args": [],
+            "type": {
+              "kind": "LIST",
+              "name": null,
+              "ofType": {
+                "kind": "OBJECT",
+                "name": "HasUpstreamHeartbeatEdge",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
           {
             "name": "id",
             "description": null,
@@ -69618,6 +69762,51 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
+          {
+            "name": "isUpstreamHeartbeatOf",
+            "description": null,
+            "args": [
+              {
+                "name": "filter",
+                "description": null,
+                "type": {
+                  "kind": "INPUT_OBJECT",
+                  "name": "HeartbeatFilter",
+                  "ofType": null
+                },
+                "defaultValue": null,
+                "isDeprecated": false,
+                "deprecationReason": null
+              }
+            ],
+            "type": {
+              "kind": "LIST",
+              "name": null,
+              "ofType": {
+                "kind": "OBJECT",
+                "name": "Heartbeat",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "isUpstreamHeartbeatOfEdges",
+            "description": null,
+            "args": [],
+            "type": {
+              "kind": "LIST",
+              "name": null,
+              "ofType": {
+                "kind": "OBJECT",
+                "name": "IsUpstreamHeartbeatOfEdge",
+                "ofType": null
+              }
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
           {
             "name": "mappingKey",
             "description": null,
@@ -73123,6 +73312,47 @@
         "enumValues": null,
         "possibleTypes": null
       },
+      {
+        "kind": "OBJECT",
+        "name": "IsUpstreamHeartbeatOfEdge",
+        "description": null,
+        "fields": [
+          {
+            "name": "mappingKey",
+            "description": null,
+            "args": [],
+            "type": {
+              "kind": "SCALAR",
+              "name": "String",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          },
+          {
+            "name": "node",
+            "description": null,
+            "args": [],
+            "type": {
+              "kind": "INTERFACE",
+              "name": "GraphNode",
+              "ofType": null
+            },
+            "isDeprecated": false,
+            "deprecationReason": null
+          }
+        ],
+        "inputFields": null,
+        "interfaces": [
+          {
+            "kind": "INTERFACE",
+            "name": "Edge",
+            "ofType": null
+          }
+        ],
+        "enumValues": null,
+        "possibleTypes": null
+      },
       {
         "kind": "SCALAR",
         "name": "JSONLD",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapped/schema-graph-react-apollo",
-  "version": "2.3.3",
+  "version": "2.3.7",
   "license": "MIT",
   "description": "Mapped Graph TypeScript typings for react-apollo",
   "repository": {