@dronedeploy/rocos-js-sdk 3.0.28 → 3.0.30

package/cjs/constants/api.d.ts

@@ -122,9 +122,12 @@ export declare const API_DD_INTEGRATION_ISSUES_URL = "https://{url}/projects/{pr
 export declare const API_DD_INTEGRATION_LOCATIONS_URL = "https://{url}/projects/{projectId}/dd/locations";
 export declare const API_DD_INTEGRATION_LEVELS_URL = "https://{url}/projects/{projectId}/dd/levels";
 export declare const API_GRAPHS_MAPS_URL = "https://{url}/graphs/projects/{projectId}/maps";
+export declare const API_GRAPHS_MAPS_NEW_URL = "https://{url}/graphs/projects/{projectId}/maps/new";
 export declare const API_GRAPHS_MAPS_DEPLOYED_URL = "https://{url}/graphs/projects/{projectId}/maps/deployed?callsign={callsign}";
 export declare const API_GRAPHS_MAPS_MERGE_URL = "https://{url}/graphs/projects/{projectId}/maps/merge";
 export declare const API_GRAPHS_MAP_ID_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}";
+export declare const API_GRAPHS_MAP_CONTENT_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/content";
+export declare const API_GRAPHS_MAP_METADATA_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/metadata";
 export declare const API_GRAPHS_MAPS_COPY_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/copy";
 export declare const API_GRAPHS_MAPS_DEPLOY_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/deploy";
 export declare const API_GRAPHS_MAPS_GEOJSON_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/geojson";

package/cjs/constants/api.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.API_PROJECT_ROBOT_EVENT_URL = exports.API_PROJECT_ROBOT_REGISTER_URL = exports.API_PROJECT_ROBOT_DEFINITION_URL = exports.API_PROJECT_ROBOT_ATTRIBUTES_URL = exports.API_PROJECT_ROBOT_ID_URL = exports.API_ACCOUNT_ROBOT_URL = exports.API_PROJECT_ROBOT_URL = exports.API_PROJECT_MAPPED_ASSET_PATH_URL = exports.API_PROJECT_MAPPED_ASSETS_PATH_URL = exports.API_PROJECT_MISSION_ASSET_PATH_URL = exports.API_PROJECT_MISSION_ASSETS_PATH_URL = exports.API_PROJECT_FLOW_ASSET_PATH_URL = exports.API_PROJECT_ROBOT_ASSET_PATH_URL = exports.API_PROJECT_ASSET_INTEGRATION_PATH_URL = exports.API_PROJECT_ASSET_INTEGRATIONS_PATH_URL = exports.API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL = exports.API_PROJECT_ASSET_PROFILES_SYNC_DEFINITION_PATH_URL = exports.API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL = exports.API_PROJECT_ASSET_PATH_URL = exports.API_PROJECT_ASSET_URL = exports.API_PROJECT_USERS_URL = exports.API_PROJECT_ID_URL = exports.API_PROJECT_URL = exports.API_ACCOUNT_EXTERNAL_PROJECTS_URL = exports.API_ACCOUNT_PROJECT_APPLICATION_ID_URL = exports.API_ACCOUNT_PROJECT_APPLICATION_URL = exports.API_ACCOUNT_PROJECT_USER_ID_URL = exports.API_ACCOUNT_PROJECT_USER_URL = exports.API_ACCOUNT_PROJECT_ID_URL = exports.API_ACCOUNT_PROJECT_URL = exports.API_SERVER_TIME_URL = exports.API_ACCOUNT_SETTINGS_URL = exports.API_AUTH_USER_ACCOUNT_USER_ID_URL = exports.API_AUTH_USER_ACCOUNT_USER_URL = exports.API_ACCOUNT_ACTIVATE_URL = exports.API_ACCOUNT_ID_URL = exports.API_ACCOUNT_URL = exports.API_USER_PAT_TOKEN_URL = exports.API_USER_PAT_URL = exports.API_USER_VERIFY_EMAIL_URL = exports.API_USER_INVITATION_CHECK_URL = exports.API_USER_INVITATION_ACCEPT_URL = exports.API_USER_INVITATION_URL = exports.API_USER_PASSWORD_FORGOT_URL = exports.API_OTP_AUTH_URL = exports.API_OTP_URL = exports.API_USER_TOKEN_URL = exports.API_USER_URL = exports.API_ADMIN_USER_INVITATION_URL = exports.API_APPLICATION_AUTH_URL = void 0;
 exports.API_PROJECT_STREAM_DATA_URL = exports.API_PROJECT_STREAM_ID_URL = exports.API_PROJECT_STREAM_URL = exports.API_PROJECT_GROUP_TYPE_OWNER_OVERRIDE_URL = exports.API_PROJECT_GROUP_TYPE_OWNER_ID_URL = exports.API_PROJECT_GROUP_TYPE_VERSION_URL = exports.API_PROJECT_GROUP_TYPE_CONFIG_URL = exports.API_PROJECT_GROUP_TYPE_PUBLISH_URL = exports.API_PROJECT_GROUP_TYPE_ID_URL = exports.API_PROJECT_GROUP_TYPE_URL = exports.API_PROJECT_ENVIRONMENT_URL = exports.API_PROJECT_DEFINITION_LIBRARY = exports.API_PROJECT_DEFINITION_IMPORT_LIBRARY = exports.API_PROJECT_DEFINITION_IMPORT = exports.API_PROJECT_DEFINITION_EXPORT = exports.API_PROJECT_DEFINITION_GAMEPAD_URL = exports.API_PROJECT_DEFINITION_TRIGGER_URL = exports.API_PROJECT_DEFINITION_BUTTON_URL = exports.API_PROJECT_DEFINITION_ACTION_URL = exports.API_PROJECT_DEFINITION_EVENT_URL = exports.API_PROJECT_DEFINITION_COMMAND2_URL = exports.API_PROJECT_DEFINITION_COMMAND_URL = exports.API_PROJECT_DEFINITION_AGENT_URL = exports.API_PROJECT_DEFINITION_SETTING_URL = exports.API_PROJECT_DEFINITION_BLOB_URL = exports.API_PROJECT_DEFINITION_DASHBOARD_URL = exports.API_PROJECT_DEFINITION_COPY_URL = exports.API_PROJECT_DEFINITION_STREAM_URL = exports.API_PROJECT_DEFINITION_ID_URL = exports.API_PROJECT_DEFINITION_URL = exports.API_PROJECT_VROBOT_DEPLOY_URL = exports.API_PROJECT_VROBOT_DETAILS_URL = exports.API_PROJECT_COLLECTION_DOCS_URL = exports.API_PROJECT_COLLECTION_ID_URL = exports.API_PROJECT_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_DASHBOARD_WIDGET_URL = exports.API_PROJECT_DASHBOARD_ID_URL = exports.API_PROJECT_DASHBOARD_URL = exports.API_PROJECT_OPERATION_ID_URL = exports.API_PROJECT_OPERATION_URL = exports.API_PROJECT_ROBOT_CONFIGS_CONNECTION_URL = exports.API_PROJECT_ROBOT_CONFIGS_CONNECTIONS_URL = exports.API_PROJECT_ROBOT_GAMEPAD_URL = exports.API_PROJECT_ROBOT_TRIGGER_URL = exports.API_PROJECT_ROBOT_BUTTON_URL = exports.API_PROJECT_ROBOT_COMMAND2_URL = exports.API_PROJECT_ROBOT_COMMAND_URL = exports.API_PROJECT_ROBOT_AGENT_URL = exports.API_PROJECT_ROBOT_SETTING_URL = exports.API_PROJECT_ROBOT_EVENT_HISTORY_URL = void 0;
-exports.API_PROJECT_WORKFLOW_IMPORT_URL = exports.API_PROJECT_WORKFLOW_EXPORT_URL = exports.API_PROJECT_WORKFLOW_AFFECTED_URL = exports.API_PROJECT_ROBOT_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_PROFILE_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_ROBOT_NO_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_ROBOT_DEPLOYMENTS_URL = exports.API_PROJECT_WORKFLOW_ASSET_ID_URL = exports.API_PROJECT_WORKFLOW_ASSET_URL = exports.API_PROJECT_WORKFLOW_ID_URL = exports.API_PROJECT_WORKFLOW_URL = exports.API_GRAPHS_ASSETS_URL = exports.API_GRAPHS_ASSETS_UPLOAD_URL = exports.API_GRAPHS_TARGETS_URL = exports.API_GRAPHS_TARGET_UPLOAD_URL = exports.API_GRAPHS_OBSERVATION_KEYS_URL = exports.API_GRAPHS_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA = exports.API_GRAPHS_MAPS_GEOJSON_URL = exports.API_GRAPHS_MAPS_DEPLOY_URL = exports.API_GRAPHS_MAPS_COPY_URL = exports.API_GRAPHS_MAP_ID_URL = exports.API_GRAPHS_MAPS_MERGE_URL = exports.API_GRAPHS_MAPS_DEPLOYED_URL = exports.API_GRAPHS_MAPS_URL = exports.API_DD_INTEGRATION_LEVELS_URL = exports.API_DD_INTEGRATION_LOCATIONS_URL = exports.API_DD_INTEGRATION_ISSUES_URL = exports.API_DD_INTEGRATION_OVERLAYS_URL = exports.API_DD_INTEGRATION_PLAN_BY_ID_URL = exports.API_DD_INTEGRATION_PLANS_URL = exports.API_SPOTTY_URL = exports.API_PROJECT_SCHEDULES_URL = exports.API_SOURCE_ID_URL = exports.API_SOURCE_URL = exports.API_SOURCE_SCHEMA_URL = exports.API_TEMPLATE_EXPORTER_URL = exports.API_TEMPLATE_PROVISION_ID_URL = exports.API_TEMPLATE_PROVISION_URL = exports.API_TEMPLATE_DEPLOY_URL = exports.API_PROJECT_PROFILE_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_PROFILE_DASHBOARD_ID_URL = exports.API_PROJECT_PROFILE_DASHBOARD_URL = exports.API_PROJECT_CALLSIGN_STREAM_URL = exports.API_PROJECT_ROBOT_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_ROBOT_DASHBOARD_ID_URL = exports.API_PROJECT_ROBOT_DASHBOARD_URL = exports.API_PROJECT_STREAM_CALLSIGN_URL = void 0;
-exports.API_PROJECT_ROBOT_TAG_URL = exports.API_PROJECT_PROFILE_TAG_URL = exports.API_PROJECT_PROFILE_TAGS_URL = exports.API_PROJECT_TAG_ROBOTS_URL = exports.API_PROJECT_ROBOT_TAGS_URL = exports.API_DEVICE_CREDENTIALS_AUTH_URL = exports.API_DEVICE_CREDENTIALS_URL = exports.API_LINKED_PROJECT_URL = void 0;
+exports.API_PROJECT_ROBOT_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_PROFILE_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_ROBOT_NO_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_ROBOT_DEPLOYMENTS_URL = exports.API_PROJECT_WORKFLOW_ASSET_ID_URL = exports.API_PROJECT_WORKFLOW_ASSET_URL = exports.API_PROJECT_WORKFLOW_ID_URL = exports.API_PROJECT_WORKFLOW_URL = exports.API_GRAPHS_ASSETS_URL = exports.API_GRAPHS_ASSETS_UPLOAD_URL = exports.API_GRAPHS_TARGETS_URL = exports.API_GRAPHS_TARGET_UPLOAD_URL = exports.API_GRAPHS_OBSERVATION_KEYS_URL = exports.API_GRAPHS_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA = exports.API_GRAPHS_MAPS_GEOJSON_URL = exports.API_GRAPHS_MAPS_DEPLOY_URL = exports.API_GRAPHS_MAPS_COPY_URL = exports.API_GRAPHS_MAP_METADATA_URL = exports.API_GRAPHS_MAP_CONTENT_URL = exports.API_GRAPHS_MAP_ID_URL = exports.API_GRAPHS_MAPS_MERGE_URL = exports.API_GRAPHS_MAPS_DEPLOYED_URL = exports.API_GRAPHS_MAPS_NEW_URL = exports.API_GRAPHS_MAPS_URL = exports.API_DD_INTEGRATION_LEVELS_URL = exports.API_DD_INTEGRATION_LOCATIONS_URL = exports.API_DD_INTEGRATION_ISSUES_URL = exports.API_DD_INTEGRATION_OVERLAYS_URL = exports.API_DD_INTEGRATION_PLAN_BY_ID_URL = exports.API_DD_INTEGRATION_PLANS_URL = exports.API_SPOTTY_URL = exports.API_PROJECT_SCHEDULES_URL = exports.API_SOURCE_ID_URL = exports.API_SOURCE_URL = exports.API_SOURCE_SCHEMA_URL = exports.API_TEMPLATE_EXPORTER_URL = exports.API_TEMPLATE_PROVISION_ID_URL = exports.API_TEMPLATE_PROVISION_URL = exports.API_TEMPLATE_DEPLOY_URL = exports.API_PROJECT_PROFILE_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_PROFILE_DASHBOARD_ID_URL = exports.API_PROJECT_PROFILE_DASHBOARD_URL = exports.API_PROJECT_CALLSIGN_STREAM_URL = exports.API_PROJECT_ROBOT_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_ROBOT_DASHBOARD_ID_URL = exports.API_PROJECT_ROBOT_DASHBOARD_URL = exports.API_PROJECT_STREAM_CALLSIGN_URL = void 0;
+exports.API_PROJECT_ROBOT_TAG_URL = exports.API_PROJECT_PROFILE_TAG_URL = exports.API_PROJECT_PROFILE_TAGS_URL = exports.API_PROJECT_TAG_ROBOTS_URL = exports.API_PROJECT_ROBOT_TAGS_URL = exports.API_DEVICE_CREDENTIALS_AUTH_URL = exports.API_DEVICE_CREDENTIALS_URL = exports.API_LINKED_PROJECT_URL = exports.API_PROJECT_WORKFLOW_IMPORT_URL = exports.API_PROJECT_WORKFLOW_EXPORT_URL = exports.API_PROJECT_WORKFLOW_AFFECTED_URL = void 0;
 exports.API_APPLICATION_AUTH_URL = 'https://{url}/applications/auth';
 exports.API_ADMIN_USER_INVITATION_URL = 'https://{url}/admin/users/invitations';
 exports.API_USER_URL = 'https://{url}/users';
@@ -128,9 +128,12 @@ exports.API_DD_INTEGRATION_ISSUES_URL = 'https://{url}/projects/{projectId}/dd/i
 exports.API_DD_INTEGRATION_LOCATIONS_URL = 'https://{url}/projects/{projectId}/dd/locations';
 exports.API_DD_INTEGRATION_LEVELS_URL = 'https://{url}/projects/{projectId}/dd/levels';
 exports.API_GRAPHS_MAPS_URL = 'https://{url}/graphs/projects/{projectId}/maps';
+exports.API_GRAPHS_MAPS_NEW_URL = 'https://{url}/graphs/projects/{projectId}/maps/new';
 exports.API_GRAPHS_MAPS_DEPLOYED_URL = 'https://{url}/graphs/projects/{projectId}/maps/deployed?callsign={callsign}';
 exports.API_GRAPHS_MAPS_MERGE_URL = 'https://{url}/graphs/projects/{projectId}/maps/merge';
 exports.API_GRAPHS_MAP_ID_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}';
+exports.API_GRAPHS_MAP_CONTENT_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/content';
+exports.API_GRAPHS_MAP_METADATA_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/metadata';
 exports.API_GRAPHS_MAPS_COPY_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/copy';
 exports.API_GRAPHS_MAPS_DEPLOY_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/deploy';
 exports.API_GRAPHS_MAPS_GEOJSON_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/geojson';

package/cjs/models/index.d.ts

@@ -48,6 +48,7 @@ export * from './IToken';
 export * from './IWidget';
 export * from './IWidgetLineGroup';
 export * from './maps/Map';
+export * from './maps/MapContent';
 export * from './maps/Panorama';
 export * from './message';
 export * from './params/ICallerParams';

package/cjs/models/index.js

@@ -64,6 +64,7 @@ __exportStar(require("./IToken"), exports);
 __exportStar(require("./IWidget"), exports);
 __exportStar(require("./IWidgetLineGroup"), exports);
 __exportStar(require("./maps/Map"), exports);
+__exportStar(require("./maps/MapContent"), exports);
 __exportStar(require("./maps/Panorama"), exports);
 __exportStar(require("./message"), exports);
 __exportStar(require("./params/ICallerParams"), exports);

package/cjs/models/maps/MapContent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Canonical JSON representation of a robot map's graph content.
+ *
+ * This is the body shape returned by `GET /graphs/projects/{projectId}/maps/{mapId}`
+ * and accepted by `PUT /graphs/projects/{projectId}/maps/{mapId}/content`. Distinct
+ * from {@link Map} (the listing/metadata model returned by `list()`).
+ */
+export interface MapContent {
+    nodes: Record<string, MapContentNode>;
+    edges: Record<string, MapContentEdge>;
+}
+export interface MapContentNode {
+    id: string;
+    type: string;
+    edges: Record<string, unknown>;
+    data: Record<string, unknown>;
+    externalData?: Record<string, unknown>;
+}
+export interface MapContentEdge {
+    id: string;
+    from: string;
+    to: string;
+    type: string;
+    data: Record<string, unknown>;
+    externalData?: Record<string, unknown>;
+}

package/cjs/models/maps/MapContent.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/services/MapService.d.ts

@@ -1,4 +1,4 @@
-import { Asset, IBaseService, IRocosSDKConfig, Map, RocosError } from '../models';
+import { Asset, IBaseService, IRocosSDKConfig, Map, MapContent, RocosError } from '../models';
 import { CreateObservation, Observation } from '../models/maps/Panorama';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 /**
@@ -50,7 +50,14 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
      */
     get(projectId: string, mapId: string): Promise<Map>;
     /**
-     * Updates a maps metadata
+     * Updates a map's metadata.
+     *
+     * @deprecated Hits the legacy `PUT /maps/{mapId}` endpoint that only accepts
+     * metadata; the giraffe API is migrating that endpoint toward "PUT the full
+     * resource" semantics (both metadata and content together). Prefer
+     * {@link updateMetadata} for metadata-only changes and {@link updateContent}
+     * for graph-content replacement.
+     *
      * @param projectId Project ID
      * @param mapId Map ID
      * @param options New metadata
@@ -59,6 +66,30 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
         description?: string;
         callsign?: string;
     }): Promise<void>;
+    /**
+     * Updates a map's metadata via the granular `/metadata` endpoint.
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param options New metadata fields. `description` is required by the
+     * backend; sending an empty value returns a 400.
+     */
+    updateMetadata(projectId: string, mapId: string, options: {
+        description: string;
+    }): Promise<void>;
+    /**
+     * Replaces the graph content of an existing cloud map with the supplied
+     * canonical `{ nodes, edges }` payload.
+     *
+     * Server-managed parts (SUMMARY, MAP_INFO identity fields, MAP_INFO
+     * timestamp, content hash) are preserved or recomputed by the backend; a
+     * byte-identical content payload is a no-op on the server (idempotent).
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param content Canonical map content to write
+     */
+    updateContent(projectId: string, mapId: string, content: MapContent): Promise<void>;
     /**
      * Begins uploading a map from the agent
      *
@@ -86,15 +117,36 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
      */
     delete(projectId: string, mapId: string, callsign: string, hash: string): Promise<void>;
     /**
-     * Makes a copy of an uploaded map
+     * Creates a new map with the supplied canonical content.
+     *
+     * The server requires at least one node in the content; an empty `{nodes:{},
+     * edges:{}}` payload is rejected. Server-managed metadata (SUMMARY, MAP_INFO,
+     * hash, timestamp) is created automatically.
      *
      * @param projectId Project ID
-     * @param mapId Map ID
-     * @param options Options to create the new map
+     * @param mapId The mapId to create. Must be unique within the project.
+     * @param content Canonical map content (`{nodes, edges}`).
+     */
+    create(projectId: string, mapId: string, content: MapContent): Promise<void>;
+    /**
+     * Makes a copy of an existing cloud map under a new mapId.
+     *
+     * If `options.name` is omitted, the server picks an available
+     * `<sourceMapId>-copy[-N]` slot. The resolved mapId is returned so the
+     * caller knows where to look for the copy. The write is asynchronous on the
+     * server side - the copy may not be immediately readable via `get()`.
+     *
+     * @param projectId Project ID
+     * @param mapId Source map ID
+     * @param options Optional `name` (new mapId) and `description` for the copy
+     * @returns The mapId assigned to the new copy
      */
     copy(projectId: string, mapId: string, options: {
+        name?: string;
         description?: string;
-    }): Promise<void>;
+    }): Promise<{
+        mapId: string;
+    }>;
     /** Deploy a map from the cloud to a robot
      *
      * @param projectId Project ID

package/cjs/services/MapService.js

@@ -89,7 +89,14 @@ class MapService extends BaseServiceAbstract_1.BaseServiceAbstract {
         }, this.config.insecure), 'Failed to get map.');
     }
     /**
-     * Updates a maps metadata
+     * Updates a map's metadata.
+     *
+     * @deprecated Hits the legacy `PUT /maps/{mapId}` endpoint that only accepts
+     * metadata; the giraffe API is migrating that endpoint toward "PUT the full
+     * resource" semantics (both metadata and content together). Prefer
+     * {@link updateMetadata} for metadata-only changes and {@link updateContent}
+     * for graph-content replacement.
+     *
      * @param projectId Project ID
      * @param mapId Map ID
      * @param options New metadata
@@ -101,6 +108,40 @@ class MapService extends BaseServiceAbstract_1.BaseServiceAbstract {
             mapId,
         }, this.config.insecure), options, 'Failed to update map.');
     }
+    /**
+     * Updates a map's metadata via the granular `/metadata` endpoint.
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param options New metadata fields. `description` is required by the
+     * backend; sending an empty value returns a 400.
+     */
+    async updateMetadata(projectId, mapId, options) {
+        return this.callPut((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_GRAPHS_MAP_METADATA_URL, {
+            url: this.config.url,
+            projectId,
+            mapId,
+        }, this.config.insecure), options, 'Failed to update map metadata.');
+    }
+    /**
+     * Replaces the graph content of an existing cloud map with the supplied
+     * canonical `{ nodes, edges }` payload.
+     *
+     * Server-managed parts (SUMMARY, MAP_INFO identity fields, MAP_INFO
+     * timestamp, content hash) are preserved or recomputed by the backend; a
+     * byte-identical content payload is a no-op on the server (idempotent).
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param content Canonical map content to write
+     */
+    async updateContent(projectId, mapId, content) {
+        return this.callPut((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_GRAPHS_MAP_CONTENT_URL, {
+            url: this.config.url,
+            projectId,
+            mapId,
+        }, this.config.insecure), content, 'Failed to update map content.');
+    }
     /**
      * Begins uploading a map from the agent
      *
@@ -124,11 +165,34 @@ class MapService extends BaseServiceAbstract_1.BaseServiceAbstract {
         }, this.config.insecure), 'Failed to delete map.', callsign ? { callsign, hash } : {});
     }
     /**
-     * Makes a copy of an uploaded map
+     * Creates a new map with the supplied canonical content.
+     *
+     * The server requires at least one node in the content; an empty `{nodes:{},
+     * edges:{}}` payload is rejected. Server-managed metadata (SUMMARY, MAP_INFO,
+     * hash, timestamp) is created automatically.
      *
      * @param projectId Project ID
-     * @param mapId Map ID
-     * @param options Options to create the new map
+     * @param mapId The mapId to create. Must be unique within the project.
+     * @param content Canonical map content (`{nodes, edges}`).
+     */
+    async create(projectId, mapId, content) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_GRAPHS_MAPS_NEW_URL, {
+            url: this.config.url,
+            projectId,
+        }, this.config.insecure), { mapId, map: content }, 'Failed to create map.');
+    }
+    /**
+     * Makes a copy of an existing cloud map under a new mapId.
+     *
+     * If `options.name` is omitted, the server picks an available
+     * `<sourceMapId>-copy[-N]` slot. The resolved mapId is returned so the
+     * caller knows where to look for the copy. The write is asynchronous on the
+     * server side - the copy may not be immediately readable via `get()`.
+     *
+     * @param projectId Project ID
+     * @param mapId Source map ID
+     * @param options Optional `name` (new mapId) and `description` for the copy
+     * @returns The mapId assigned to the new copy
      */
     async copy(projectId, mapId, options) {
         return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_GRAPHS_MAPS_COPY_URL, {

package/esm/constants/api.d.ts

@@ -122,9 +122,12 @@ export declare const API_DD_INTEGRATION_ISSUES_URL = "https://{url}/projects/{pr
 export declare const API_DD_INTEGRATION_LOCATIONS_URL = "https://{url}/projects/{projectId}/dd/locations";
 export declare const API_DD_INTEGRATION_LEVELS_URL = "https://{url}/projects/{projectId}/dd/levels";
 export declare const API_GRAPHS_MAPS_URL = "https://{url}/graphs/projects/{projectId}/maps";
+export declare const API_GRAPHS_MAPS_NEW_URL = "https://{url}/graphs/projects/{projectId}/maps/new";
 export declare const API_GRAPHS_MAPS_DEPLOYED_URL = "https://{url}/graphs/projects/{projectId}/maps/deployed?callsign={callsign}";
 export declare const API_GRAPHS_MAPS_MERGE_URL = "https://{url}/graphs/projects/{projectId}/maps/merge";
 export declare const API_GRAPHS_MAP_ID_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}";
+export declare const API_GRAPHS_MAP_CONTENT_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/content";
+export declare const API_GRAPHS_MAP_METADATA_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/metadata";
 export declare const API_GRAPHS_MAPS_COPY_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/copy";
 export declare const API_GRAPHS_MAPS_DEPLOY_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/deploy";
 export declare const API_GRAPHS_MAPS_GEOJSON_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/geojson";

package/esm/constants/api.js

@@ -122,9 +122,12 @@ export const API_DD_INTEGRATION_ISSUES_URL = 'https://{url}/projects/{projectId}
 export const API_DD_INTEGRATION_LOCATIONS_URL = 'https://{url}/projects/{projectId}/dd/locations';
 export const API_DD_INTEGRATION_LEVELS_URL = 'https://{url}/projects/{projectId}/dd/levels';
 export const API_GRAPHS_MAPS_URL = 'https://{url}/graphs/projects/{projectId}/maps';
+export const API_GRAPHS_MAPS_NEW_URL = 'https://{url}/graphs/projects/{projectId}/maps/new';
 export const API_GRAPHS_MAPS_DEPLOYED_URL = 'https://{url}/graphs/projects/{projectId}/maps/deployed?callsign={callsign}';
 export const API_GRAPHS_MAPS_MERGE_URL = 'https://{url}/graphs/projects/{projectId}/maps/merge';
 export const API_GRAPHS_MAP_ID_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}';
+export const API_GRAPHS_MAP_CONTENT_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/content';
+export const API_GRAPHS_MAP_METADATA_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/metadata';
 export const API_GRAPHS_MAPS_COPY_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/copy';
 export const API_GRAPHS_MAPS_DEPLOY_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/deploy';
 export const API_GRAPHS_MAPS_GEOJSON_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/geojson';

package/esm/models/index.d.ts

@@ -48,6 +48,7 @@ export * from './IToken';
 export * from './IWidget';
 export * from './IWidgetLineGroup';
 export * from './maps/Map';
+export * from './maps/MapContent';
 export * from './maps/Panorama';
 export * from './message';
 export * from './params/ICallerParams';

package/esm/models/index.js

@@ -48,6 +48,7 @@ export * from './IToken';
 export * from './IWidget';
 export * from './IWidgetLineGroup';
 export * from './maps/Map';
+export * from './maps/MapContent';
 export * from './maps/Panorama';
 export * from './message';
 export * from './params/ICallerParams';

package/esm/models/maps/MapContent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Canonical JSON representation of a robot map's graph content.
+ *
+ * This is the body shape returned by `GET /graphs/projects/{projectId}/maps/{mapId}`
+ * and accepted by `PUT /graphs/projects/{projectId}/maps/{mapId}/content`. Distinct
+ * from {@link Map} (the listing/metadata model returned by `list()`).
+ */
+export interface MapContent {
+    nodes: Record<string, MapContentNode>;
+    edges: Record<string, MapContentEdge>;
+}
+export interface MapContentNode {
+    id: string;
+    type: string;
+    edges: Record<string, unknown>;
+    data: Record<string, unknown>;
+    externalData?: Record<string, unknown>;
+}
+export interface MapContentEdge {
+    id: string;
+    from: string;
+    to: string;
+    type: string;
+    data: Record<string, unknown>;
+    externalData?: Record<string, unknown>;
+}

package/esm/models/maps/MapContent.js

@@ -0,0 +1 @@
+export {};

package/esm/services/MapService.d.ts

@@ -1,4 +1,4 @@
-import { Asset, IBaseService, IRocosSDKConfig, Map, RocosError } from '../models';
+import { Asset, IBaseService, IRocosSDKConfig, Map, MapContent, RocosError } from '../models';
 import { CreateObservation, Observation } from '../models/maps/Panorama';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 /**
@@ -50,7 +50,14 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
      */
     get(projectId: string, mapId: string): Promise<Map>;
     /**
-     * Updates a maps metadata
+     * Updates a map's metadata.
+     *
+     * @deprecated Hits the legacy `PUT /maps/{mapId}` endpoint that only accepts
+     * metadata; the giraffe API is migrating that endpoint toward "PUT the full
+     * resource" semantics (both metadata and content together). Prefer
+     * {@link updateMetadata} for metadata-only changes and {@link updateContent}
+     * for graph-content replacement.
+     *
      * @param projectId Project ID
      * @param mapId Map ID
      * @param options New metadata
@@ -59,6 +66,30 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
         description?: string;
         callsign?: string;
     }): Promise<void>;
+    /**
+     * Updates a map's metadata via the granular `/metadata` endpoint.
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param options New metadata fields. `description` is required by the
+     * backend; sending an empty value returns a 400.
+     */
+    updateMetadata(projectId: string, mapId: string, options: {
+        description: string;
+    }): Promise<void>;
+    /**
+     * Replaces the graph content of an existing cloud map with the supplied
+     * canonical `{ nodes, edges }` payload.
+     *
+     * Server-managed parts (SUMMARY, MAP_INFO identity fields, MAP_INFO
+     * timestamp, content hash) are preserved or recomputed by the backend; a
+     * byte-identical content payload is a no-op on the server (idempotent).
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param content Canonical map content to write
+     */
+    updateContent(projectId: string, mapId: string, content: MapContent): Promise<void>;
     /**
      * Begins uploading a map from the agent
      *
@@ -86,15 +117,36 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
      */
     delete(projectId: string, mapId: string, callsign: string, hash: string): Promise<void>;
     /**
-     * Makes a copy of an uploaded map
+     * Creates a new map with the supplied canonical content.
+     *
+     * The server requires at least one node in the content; an empty `{nodes:{},
+     * edges:{}}` payload is rejected. Server-managed metadata (SUMMARY, MAP_INFO,
+     * hash, timestamp) is created automatically.
      *
      * @param projectId Project ID
-     * @param mapId Map ID
-     * @param options Options to create the new map
+     * @param mapId The mapId to create. Must be unique within the project.
+     * @param content Canonical map content (`{nodes, edges}`).
+     */
+    create(projectId: string, mapId: string, content: MapContent): Promise<void>;
+    /**
+     * Makes a copy of an existing cloud map under a new mapId.
+     *
+     * If `options.name` is omitted, the server picks an available
+     * `<sourceMapId>-copy[-N]` slot. The resolved mapId is returned so the
+     * caller knows where to look for the copy. The write is asynchronous on the
+     * server side - the copy may not be immediately readable via `get()`.
+     *
+     * @param projectId Project ID
+     * @param mapId Source map ID
+     * @param options Optional `name` (new mapId) and `description` for the copy
+     * @returns The mapId assigned to the new copy
      */
     copy(projectId: string, mapId: string, options: {
+        name?: string;
         description?: string;
-    }): Promise<void>;
+    }): Promise<{
+        mapId: string;
+    }>;
     /** Deploy a map from the cloud to a robot
      *
      * @param projectId Project ID

package/esm/services/MapService.js

@@ -1,4 +1,4 @@
-import { API_GRAPHS_MAPS_COPY_URL, API_GRAPHS_MAPS_DEPLOYED_URL, API_GRAPHS_MAPS_DEPLOY_URL, API_GRAPHS_MAPS_GEOJSON_URL, API_GRAPHS_MAPS_MERGE_URL, API_GRAPHS_MAPS_URL, API_GRAPHS_MAP_ID_URL, API_GRAPHS_OBSERVATIONS_URL, API_GRAPHS_OBSERVATION_KEYS_URL, API_GRAPHS_PANORAMA, API_GRAPHS_PANORAMA_OBSERVATIONS_URL, } from '../constants/api';
+import { API_GRAPHS_MAPS_COPY_URL, API_GRAPHS_MAPS_DEPLOYED_URL, API_GRAPHS_MAPS_DEPLOY_URL, API_GRAPHS_MAPS_GEOJSON_URL, API_GRAPHS_MAPS_MERGE_URL, API_GRAPHS_MAPS_NEW_URL, API_GRAPHS_MAPS_URL, API_GRAPHS_MAP_CONTENT_URL, API_GRAPHS_MAP_ID_URL, API_GRAPHS_MAP_METADATA_URL, API_GRAPHS_OBSERVATIONS_URL, API_GRAPHS_OBSERVATION_KEYS_URL, API_GRAPHS_PANORAMA, API_GRAPHS_PANORAMA_OBSERVATIONS_URL, } from '../constants/api';
 import { RocosError, errorCodes } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
@@ -86,7 +86,14 @@ export class MapService extends BaseServiceAbstract {
         }, this.config.insecure), 'Failed to get map.');
     }
     /**
-     * Updates a maps metadata
+     * Updates a map's metadata.
+     *
+     * @deprecated Hits the legacy `PUT /maps/{mapId}` endpoint that only accepts
+     * metadata; the giraffe API is migrating that endpoint toward "PUT the full
+     * resource" semantics (both metadata and content together). Prefer
+     * {@link updateMetadata} for metadata-only changes and {@link updateContent}
+     * for graph-content replacement.
+     *
      * @param projectId Project ID
      * @param mapId Map ID
      * @param options New metadata
@@ -98,6 +105,40 @@ export class MapService extends BaseServiceAbstract {
             mapId,
         }, this.config.insecure), options, 'Failed to update map.');
     }
+    /**
+     * Updates a map's metadata via the granular `/metadata` endpoint.
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param options New metadata fields. `description` is required by the
+     * backend; sending an empty value returns a 400.
+     */
+    async updateMetadata(projectId, mapId, options) {
+        return this.callPut(formatServiceUrl(API_GRAPHS_MAP_METADATA_URL, {
+            url: this.config.url,
+            projectId,
+            mapId,
+        }, this.config.insecure), options, 'Failed to update map metadata.');
+    }
+    /**
+     * Replaces the graph content of an existing cloud map with the supplied
+     * canonical `{ nodes, edges }` payload.
+     *
+     * Server-managed parts (SUMMARY, MAP_INFO identity fields, MAP_INFO
+     * timestamp, content hash) are preserved or recomputed by the backend; a
+     * byte-identical content payload is a no-op on the server (idempotent).
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param content Canonical map content to write
+     */
+    async updateContent(projectId, mapId, content) {
+        return this.callPut(formatServiceUrl(API_GRAPHS_MAP_CONTENT_URL, {
+            url: this.config.url,
+            projectId,
+            mapId,
+        }, this.config.insecure), content, 'Failed to update map content.');
+    }
     /**
      * Begins uploading a map from the agent
      *
@@ -121,11 +162,34 @@ export class MapService extends BaseServiceAbstract {
         }, this.config.insecure), 'Failed to delete map.', callsign ? { callsign, hash } : {});
     }
     /**
-     * Makes a copy of an uploaded map
+     * Creates a new map with the supplied canonical content.
+     *
+     * The server requires at least one node in the content; an empty `{nodes:{},
+     * edges:{}}` payload is rejected. Server-managed metadata (SUMMARY, MAP_INFO,
+     * hash, timestamp) is created automatically.
      *
      * @param projectId Project ID
-     * @param mapId Map ID
-     * @param options Options to create the new map
+     * @param mapId The mapId to create. Must be unique within the project.
+     * @param content Canonical map content (`{nodes, edges}`).
+     */
+    async create(projectId, mapId, content) {
+        return this.callPost(formatServiceUrl(API_GRAPHS_MAPS_NEW_URL, {
+            url: this.config.url,
+            projectId,
+        }, this.config.insecure), { mapId, map: content }, 'Failed to create map.');
+    }
+    /**
+     * Makes a copy of an existing cloud map under a new mapId.
+     *
+     * If `options.name` is omitted, the server picks an available
+     * `<sourceMapId>-copy[-N]` slot. The resolved mapId is returned so the
+     * caller knows where to look for the copy. The write is asynchronous on the
+     * server side - the copy may not be immediately readable via `get()`.
+     *
+     * @param projectId Project ID
+     * @param mapId Source map ID
+     * @param options Optional `name` (new mapId) and `description` for the copy
+     * @returns The mapId assigned to the new copy
      */
     async copy(projectId, mapId, options) {
         return this.callPost(formatServiceUrl(API_GRAPHS_MAPS_COPY_URL, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dronedeploy/rocos-js-sdk",
-  "version": "3.0.28",
+  "version": "3.0.30",
   "description": "Javascript SDK for rocos",
   "main": "cjs/index.js",
   "module": "esm/index.js",