@pptb/types 1.0.11 → 1.0.12

package/dataverseAPI.d.ts

@@ -380,6 +380,56 @@ declare namespace DataverseAPI {
          * const result = await dataverseAPI.queryData('$filter=statecode eq 0', 'secondary');
          */
         queryData: (odataQuery: string, connectionTarget?: "primary" | "secondary") => Promise<{ value: Record<string, unknown>[] }>;
+
+        /**
+         * Create multiple records in Dataverse
+         *
+         * @param entityLogicalName - Logical name of the entity (e.g., 'account', 'contact')
+         * @param records - Array of record data to create, including the "@odata.type" property for each record
+         * @param connectionTarget - Optional connection target for multi-connection tools ('primary' or 'secondary'). Defaults to 'primary'.
+         * @returns Array of strings representing the created record IDs
+         *
+         * @example
+         * const results = await dataverseAPI.createMultiple('account', [
+         *     { name: 'Contoso Ltd', "@odata.type": "Microsoft.Dynamics.CRM.account" },
+         *     { name: 'Fabrikam Inc', "@odata.type": "Microsoft.Dynamics.CRM.account" }
+         * ]);
+         */
+        createMultiple: (entityLogicalName: string, records: Record<string, unknown>[], connectionTarget?: "primary" | "secondary") => Promise<string[]>;
+
+        /**
+         * Update multiple records in Dataverse
+         * @param entityLogicalName - Logical name of the entity
+         * @param records - Array of record data to update, each including the "id" property and the "odata.type" property
+         * @param connectionTarget - Optional connection target for multi-connection tools ('primary' or 'secondary'). Defaults to 'primary'.
+         *
+         * @example
+         * await dataverseAPI.updateMultiple('account', [
+         *     { accountid: 'guid-1', name: 'Updated Name 1', "@odata.type": "Microsoft.Dynamics.CRM.account" },
+         *     { accountid: 'guid-2', name: 'Updated Name 2', "@odata.type": "Microsoft.Dynamics.CRM.account" }
+         * ]);
+         */
+        updateMultiple: (entityLogicalName: string, records: Record<string, unknown>[], connectionTarget?: "primary" | "secondary") => Promise<void>;
+         * Gets the Dataverse entity set (collection) name for the specified table.
+         *
+         * This is typically used when building OData queries where the collection name
+         * (entity set name) is required instead of the logical table name.
+         *
+         * Note: This is a utility method that applies pluralization rules and does not
+         * require an active connection to Dataverse.
+         *
+         * @param entityLogicalName - The logical name of the Dataverse table (for example, "account").
+         * @returns The corresponding entity set name (for example, "accounts").
+         *
+         * @example
+         * const entitySetName = await dataverseAPI.getEntitySetName('account');
+         * console.log(entitySetName); // Output: "accounts"
+         *
+         * @example
+         * const entitySetName = await dataverseAPI.getEntitySetName('opportunity');
+         * console.log(entitySetName); // Output: "opportunities"
+         */
+        getEntitySetName: (entityLogicalName: string) => Promise<string>;
     }
 }
 

package/package.json

@@ -1,22 +1,22 @@
 {
-  "name": "@pptb/types",
-  "version": "1.0.11",
-  "description": "TypeScript type definitions for Power Platform Tool Box API",
-  "main": "index.d.ts",
-  "types": "index.d.ts",
-  "keywords": [
-    "powerplatform",
-    "pptb",
-    "toolbox",
-    "types",
-    "typescript",
-    "dataverse"
-  ],
-  "author": "Power Platform Tool Box",
-  "license": "GPL-3.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/PowerPlatformToolBox/desktop-app.git",
-    "directory": "packages"
-  }
-}
+    "name": "@pptb/types",
+    "version": "1.0.12",
+    "description": "TypeScript type definitions for Power Platform Tool Box API",
+    "main": "index.d.ts",
+    "types": "index.d.ts",
+    "keywords": [
+        "powerplatform",
+        "pptb",
+        "toolbox",
+        "types",
+        "typescript",
+        "dataverse"
+    ],
+    "author": "Power Platform Tool Box",
+    "license": "GPL-3.0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/PowerPlatformToolBox/desktop-app.git",
+        "directory": "packages"
+    }
+}

package/toolboxAPI.d.ts

@@ -65,6 +65,11 @@ declare namespace ToolBoxAPI {
         tenantId?: string;
         createdAt: string;
         lastUsedAt?: string;
+        /**
+         * @deprecated isActive is a legacy field that is no longer persisted.
+         * It may be present in older tool code but should not be relied upon.
+         * Use the connection context provided by the ToolBox API instead.
+         */
         isActive?: boolean;
     }