update InstallAppRequest type to new format

CHANGELOG.md

@@ -7,6 +7,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Added
 ### Fixed
 ### Changed
+- Change `InstallAppRequest` type to adhere to the new format that includes the `roles_settings` field and removes
+the `membrane_proofs` field as membrane proofs are now specified as part of the `roles_settings`.
 ### Removed
 
 ## 2024-11-21: v0.19.0-dev.5
@@ -24,7 +26,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## 2024-11-12: v0.19.0-dev.2
 ### Added
 - AppWebsocket calls to interact with countersigning sessions, i.e. `GetCountersigningSessionState` as well as `AbandonCountersigningSession` and `PublishCountersigningSession` when a session could not be resolved automatically. Countersigning is an unstable feature which must explicitly be enabled in Holochain.
- 
+
 ## 2024-10-28: v0.19.0-dev.1
 ### Added
 - Bring back a websocket reconnection automation for Admin and App websockets. When either of them is closed and a new request made, it will attempt to reconnect using the same app authentication token that was used to initially authenticate the websocket. A specific `InvalidTokenError` is returned if that fails.

docs/client.dnamodifiersopt.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [DnaModifiersOpt](./client.dnamodifiersopt.md)
+
+## DnaModifiersOpt type
+
+**Signature:**
+
+```typescript
+export type DnaModifiersOpt = {
+    network_seed?: NetworkSeed;
+    properties?: Uint8Array;
+    origin_time?: Timestamp;
+    quantum_time?: Duration;
+};
+```
+**References:** [NetworkSeed](./client.networkseed.md)<!-- -->, [Timestamp](./client.timestamp.md)<!-- -->, [Duration](./client.duration.md)
+

docs/client.installapprequest.md

@@ -11,10 +11,10 @@
 export type InstallAppRequest = {
     agent_key?: AgentPubKey;
     installed_app_id?: InstalledAppId;
-    membrane_proofs: MemproofMap;
     network_seed?: NetworkSeed;
+    roles_settings?: RoleSettingsMap;
     ignore_genesis_failure?: boolean;
 } & AppBundleSource;
 ```
-**References:** [AgentPubKey](./client.agentpubkey.md)<!-- -->, [InstalledAppId](./client.installedappid.md)<!-- -->, [MemproofMap](./client.memproofmap.md)<!-- -->, [NetworkSeed](./client.networkseed.md)<!-- -->, [AppBundleSource](./client.appbundlesource.md)
+**References:** [AgentPubKey](./client.agentpubkey.md)<!-- -->, [InstalledAppId](./client.installedappid.md)<!-- -->, [NetworkSeed](./client.networkseed.md)<!-- -->, [RoleSettingsMap](./client.rolesettingsmap.md)<!-- -->, [AppBundleSource](./client.appbundlesource.md)
 

docs/client.md

@@ -1862,6 +1862,15 @@ This type is meant to be opaque
 
 
 
+</td></tr>
+<tr><td>
+
+[DnaModifiersOpt](./client.dnamodifiersopt.md)
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 
@@ -2718,6 +2727,25 @@ If the key could not be deleted from all cells, the call [RevokeAgentKeyRequest]
 
 
 
+</td></tr>
+<tr><td>
+
+[RoleSettings](./client.rolesettings.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[RoleSettingsMap](./client.rolesettingsmap.md)
+
+
+</td><td>
+
+
+
 </td></tr>
 <tr><td>
 

docs/client.memproofmap.md

@@ -9,8 +9,8 @@
 
 ```typescript
 export type MemproofMap = {
-    [key: string]: MembraneProof;
+    [key: RoleName]: MembraneProof;
 };
 ```
-**References:** [MembraneProof](./client.membraneproof.md)
+**References:** [RoleName](./client.rolename.md)<!-- -->, [MembraneProof](./client.membraneproof.md)
 

docs/client.rolesettings.md

@@ -0,0 +1,20 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [RoleSettings](./client.rolesettings.md)
+
+## RoleSettings type
+
+**Signature:**
+
+```typescript
+export type RoleSettings = {
+    type: "UseExisting";
+    cell_id: CellId;
+} | {
+    type: "Provisioned";
+    membrane_proof?: MembraneProof;
+    modifiers?: DnaModifiersOpt;
+};
+```
+**References:** [CellId](./client.cellid.md)<!-- -->, [MembraneProof](./client.membraneproof.md)<!-- -->, [DnaModifiersOpt](./client.dnamodifiersopt.md)
+

docs/client.rolesettingsmap.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/client](./client.md) &gt; [RoleSettingsMap](./client.rolesettingsmap.md)
+
+## RoleSettingsMap type
+
+
+**Signature:**
+
+```typescript
+export type RoleSettingsMap = {
+    [key: RoleName]: RoleSettings;
+};
+```
+**References:** [RoleName](./client.rolename.md)<!-- -->, [RoleSettings](./client.rolesettings.md)
+

src/api/admin/types.ts

@@ -156,7 +156,30 @@ export type MembraneProof = Uint8Array;
 /**
  * @public
  */
-export type MemproofMap = { [key: string]: MembraneProof };
+export type MemproofMap = { [key: RoleName]: MembraneProof };
+
+/**
+ * @public
+ */
+export type RoleSettingsMap = { [key: RoleName]: RoleSettings };
+
+export type RoleSettings =
+  | {
+      type: "UseExisting";
+      cell_id: CellId;
+    }
+  | {
+      type: "Provisioned";
+      membrane_proof?: MembraneProof;
+      modifiers?: DnaModifiersOpt;
+    };
+
+export type DnaModifiersOpt = {
+  network_seed?: NetworkSeed;
+  properties?: Uint8Array;
+  origin_time?: Timestamp;
+  quantum_time?: Duration;
+};
 
 /**
  * @public
@@ -477,18 +500,17 @@ export type InstallAppRequest = {
    */
   installed_app_id?: InstalledAppId;
 
-  /**
-   * Include proof-of-membrane-membership data for cells that require it,
-   * keyed by the CellNick specified in the app bundle manifest.
-   */
-  membrane_proofs: MemproofMap;
-
   /**
    * Optional global network seed override.  If set will override the network seed value for all
    * DNAs in the bundle.
    */
   network_seed?: NetworkSeed;
 
+  /**
+   * Specify role specific settings or modifiers that will override any settings in the dna manifest.
+   */
+  roles_settings?: RoleSettingsMap;
+
   /**
    * Optional: If app installation fails due to genesis failure, normally the app will be immediately uninstalled.
    * When this flag is set, the app is left installed with empty cells intact. This can be useful for