@mapped/schema-graph-react-apollo 2.3.2 → 2.3.5

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']>;
 };
 
@@ -1982,9 +2059,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 +2077,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 +2105,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 +4997,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 +7561,7 @@ export enum EntityTypeKeyInput {
   OpcuaDevice = 'OPCUA_DEVICE',
   OpcuaNode = 'OPCUA_NODE',
   OpcuaObject = 'OPCUA_OBJECT',
+  OpcuaProperty = 'OPCUA_PROPERTY',
   OpcuaServer = 'OPCUA_SERVER',
   OpcuaVariable = 'OPCUA_VARIABLE',
   Opening = 'OPENING',
@@ -8764,7 +8862,6 @@ export type FloorLevelIdentity = FloorLevelIdentityModel & Identity & {
   /** The stored type of this identity, for example SpaceCode or Name_Identity. This is the exactType to give Query.entity when looking an entity up by identity. */
   exactType?: Maybe<Scalars['String']>;
   id?: Maybe<Scalars['String']>;
-  mappingKey?: Maybe<Scalars['String']>;
   scope?: Maybe<ScopeKey>;
   scopeId?: Maybe<Scalars['String']>;
   value?: Maybe<Scalars['String']>;
@@ -8777,7 +8874,6 @@ export type FloorLevelIdentityModel = {
   /** The stored type of this identity, for example SpaceCode or Name_Identity. This is the exactType to give Query.entity when looking an entity up by identity. */
   exactType?: Maybe<Scalars['String']>;
   id?: Maybe<Scalars['String']>;
-  mappingKey?: Maybe<Scalars['String']>;
   scope?: Maybe<ScopeKey>;
   scopeId?: Maybe<Scalars['String']>;
   value?: Maybe<Scalars['String']>;
@@ -10214,6 +10310,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']>;
@@ -10233,6 +10335,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>;
@@ -10247,6 +10351,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>>>;
@@ -10287,6 +10393,12 @@ export type HeartbeatHasPrimBindingArgs = {
 };
 
 
+export type HeartbeatHasUpstreamHeartbeatArgs = {
+  filter?: Maybe<HeartbeatFilter>;
+  transitive?: Maybe<Scalars['Boolean']>;
+};
+
+
 export type HeartbeatIsBilledToArgs = {
   filter?: Maybe<AccountFilter>;
 };
@@ -10317,6 +10429,11 @@ export type HeartbeatIsPointOfArgs = {
 };
 
 
+export type HeartbeatIsUpstreamHeartbeatOfArgs = {
+  filter?: Maybe<HeartbeatFilter>;
+};
+
+
 export type HeartbeatSeriesArgs = {
   endTime?: Maybe<Scalars['DateTime']>;
   latest?: Maybe<Scalars['Boolean']>;
@@ -10728,6 +10845,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 */
@@ -11949,7 +12072,6 @@ export type NameIdentity = Identity & NameIdentityModel & {
   /** The stored type of this identity, for example SpaceCode or Name_Identity. This is the exactType to give Query.entity when looking an entity up by identity. */
   exactType?: Maybe<Scalars['String']>;
   id?: Maybe<Scalars['String']>;
-  mappingKey?: Maybe<Scalars['String']>;
   scope?: Maybe<ScopeKey>;
   scopeId?: Maybe<Scalars['String']>;
   value?: Maybe<Scalars['String']>;
@@ -11962,7 +12084,6 @@ export type NameIdentityModel = {
   /** The stored type of this identity, for example SpaceCode or Name_Identity. This is the exactType to give Query.entity when looking an entity up by identity. */
   exactType?: Maybe<Scalars['String']>;
   id?: Maybe<Scalars['String']>;
-  mappingKey?: Maybe<Scalars['String']>;
   scope?: Maybe<ScopeKey>;
   scopeId?: Maybe<Scalars['String']>;
   value?: Maybe<Scalars['String']>;

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",
@@ -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,
@@ -58382,18 +58428,6 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
-          {
-            "name": "mappingKey",
-            "description": null,
-            "args": [],
-            "type": {
-              "kind": "SCALAR",
-              "name": "String",
-              "ofType": null
-            },
-            "isDeprecated": false,
-            "deprecationReason": null
-          },
           {
             "name": "scope",
             "description": null,
@@ -58516,18 +58550,6 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
-          {
-            "name": "mappingKey",
-            "description": null,
-            "args": [],
-            "type": {
-              "kind": "SCALAR",
-              "name": "String",
-              "ofType": null
-            },
-            "isDeprecated": false,
-            "deprecationReason": null
-          },
           {
             "name": "scope",
             "description": null,
@@ -68966,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",
@@ -69344,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,
@@ -69642,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,
@@ -73147,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",
@@ -79162,18 +79368,6 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
-          {
-            "name": "mappingKey",
-            "description": null,
-            "args": [],
-            "type": {
-              "kind": "SCALAR",
-              "name": "String",
-              "ofType": null
-            },
-            "isDeprecated": false,
-            "deprecationReason": null
-          },
           {
             "name": "scope",
             "description": null,
@@ -79296,18 +79490,6 @@
             "isDeprecated": false,
             "deprecationReason": null
           },
-          {
-            "name": "mappingKey",
-            "description": null,
-            "args": [],
-            "type": {
-              "kind": "SCALAR",
-              "name": "String",
-              "ofType": null
-            },
-            "isDeprecated": false,
-            "deprecationReason": null
-          },
           {
             "name": "scope",
             "description": null,

package/package.json

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