@contrail/extensions-sdk 1.0.26 → 1.0.27

package/lib/apps/plan.d.ts

@@ -6,7 +6,8 @@ export declare enum PlanCommand {
     ADD_PLACEHOLDERS = "plan:add_placeholders",
     ADD_PLACEHOLDERS_WITH_ITEMS = "plan:add_placeholders_with_items",
     GET_PLACEHOLDERS = "plan:get_placeholders",
-    GET_VIEW_STATE = "plan:get_view_state"
+    GET_VIEW_STATE = "plan:get_view_state",
+    ASSIGN_ITEMS = "plan:assign_items"
 }
 /**
  * A row on a plan. Beyond the item linkage below, properties are the org-configured
@@ -34,6 +35,13 @@ export interface AddPlaceholdersOptions {
  * - `selected` — only the currently selected rows
  */
 export declare type PlanPlaceholderScope = 'all' | 'filtered' | 'displayed' | 'selected';
+/** Assigns one existing item to one existing placeholder row. */
+export interface PlaceholderItemAssignment {
+    /** The row to assign onto. */
+    placeholderId: string;
+    /** The item to assign — an item family or an item option. */
+    itemId: string;
+}
 export interface GetPlaceholdersOptions {
     /** Defaults to `all`. */
     scope?: PlanPlaceholderScope;
@@ -108,6 +116,20 @@ export declare class PlanApp {
      * Reading is always permitted, including on a view-only plan.
      */
     static getViewState(): Promise<PlanViewState>;
+    /**
+     * Assigns existing items to existing placeholder rows.
+     *
+     * Runs the plan's own item-assignment pipeline, so the item's properties are mapped onto the
+     * row, the project item is created if needed, and carryover is applied — the same work the grid
+     * does when a user drops an item onto a row. Rows appear updated immediately and the change is
+     * broadcast to other users.
+     *
+     * Use this to fill placeholders that already carry attribution; to create new rows instead, see
+     * {@link addPlaceholders}.
+     *
+     * Requires the plan to be editable.
+     */
+    static assignItems(assignments: Array<PlaceholderItemAssignment>): Promise<void>;
     /**
      * Creates new rows on the plan from property data, and returns them.
      *

package/lib/apps/plan.js

@@ -21,6 +21,7 @@ var PlanCommand;
     PlanCommand["ADD_PLACEHOLDERS_WITH_ITEMS"] = "plan:add_placeholders_with_items";
     PlanCommand["GET_PLACEHOLDERS"] = "plan:get_placeholders";
     PlanCommand["GET_VIEW_STATE"] = "plan:get_view_state";
+    PlanCommand["ASSIGN_ITEMS"] = "plan:assign_items";
 })(PlanCommand = exports.PlanCommand || (exports.PlanCommand = {}));
 class PlanApp {
     static getCurrentPlan() {
@@ -144,6 +145,32 @@ class PlanApp {
             return viewState;
         });
     }
+    /**
+     * Assigns existing items to existing placeholder rows.
+     *
+     * Runs the plan's own item-assignment pipeline, so the item's properties are mapped onto the
+     * row, the project item is created if needed, and carryover is applied — the same work the grid
+     * does when a user drops an item onto a row. Rows appear updated immediately and the change is
+     * broadcast to other users.
+     *
+     * Use this to fill placeholders that already carry attribution; to create new rows instead, see
+     * {@link addPlaceholders}.
+     *
+     * Requires the plan to be editable.
+     */
+    static assignItems(assignments) {
+        return __awaiter(this, void 0, void 0, function* () {
+            PlanApp.validatePlanContext();
+            if (!(assignments === null || assignments === void 0 ? void 0 : assignments.length)) {
+                return;
+            }
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToHost({
+                command: PlanCommand.ASSIGN_ITEMS,
+                data: { assignments },
+            });
+            PlanApp.validateAndReturnResults(results);
+        });
+    }
     /**
      * Creates new rows on the plan from property data, and returns them.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/extensions-sdk",
-  "version": "1.0.26",
+  "version": "1.0.27",
   "description": "Client library for interfacing with VibeIQ's services and apps from an extension.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",