@cartridge/controller-wasm 0.3.13 → 0.3.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartridge/controller-wasm",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "Wasm bindings for Cartridge Controller and Session Account",
   "type": "module",
   "main": "./pkg-controller/account_wasm.js",

package/pkg-controller/account_wasm.d.ts

@@ -93,6 +93,8 @@ export enum ErrorCode {
   SessionRefreshRequired = 142,
   ManualExecutionRequired = 143,
   ForbiddenEntrypoint = 144,
+  GasAmountTooHigh = 145,
+  ApproveExecutionRequired = 146,
 }
 export interface JsCall {
     contractAddress: JsFelt;
@@ -253,7 +255,7 @@ export class CartridgeAccount {
   registerSessionCalldata(policies: Policy[], expires_at: bigint, public_key: JsFelt): Promise<any>;
   upgrade(new_class_hash: JsFelt): Promise<JsCall>;
   register(register: JsRegister): Promise<JsRegisterResponse>;
-  createSession(policies: Policy[], expires_at: bigint): Promise<AuthorizedSession | undefined>;
+  createSession(policies: Policy[], expires_at: bigint, authorize_user_execution?: boolean | null): Promise<AuthorizedSession | undefined>;
   skipSession(policies: Policy[]): Promise<void>;
   addOwner(owner?: Signer | null, signer_input?: JsAddSignerInput | null, rp_id?: string | null): Promise<void>;
   removeOwner(signer: JsRemoveSignerInput): Promise<void>;
@@ -329,7 +331,35 @@ export class ControllerFactory {
   free(): void;
   [Symbol.dispose](): void;
   static fromStorage(app_id: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
-  static login(app_id: string, username: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, owner: Owner, cartridge_api_url: string, session_expires_at_s: bigint, is_controller_registered?: boolean | null): Promise<LoginResult>;
+  /**
+   * Login to an existing controller account.
+   *
+   * # Parameters
+   *
+   * * `create_wildcard_session` - Whether to create a wildcard session on login. Defaults to `true`
+   *   for backward compatibility. Set to `false` when using the `register_session` flow where
+   *   specific policies will be registered instead of using a wildcard session.
+   *
+   * # Returns
+   *
+   * Returns a `LoginResult` containing:
+   * * `account` - The controller account
+   * * `session` - Optional session (Some if `create_wildcard_session` is true, None otherwise)
+   *
+   * # Testing
+   *
+   * The core logic is tested in the SDK layer:
+   * * `account_sdk::tests::session_test::test_wildcard_session_creation` - Tests session creation
+   * * `account_sdk::tests::session_test::test_login_with_wildcard_session_and_execute` - Tests login with session + execution
+   * * `account_sdk::tests::session_test::test_login_without_session_can_still_execute` - Tests login without session + execution
+   *
+   * The WASM layer is a thin wrapper that:
+   * 1. Converts WASM types to SDK types
+   * 2. Calls `Controller::new` and optionally `create_wildcard_session`
+   * 3. Handles WebAuthn signer updates when multiple signers are present
+   * 4. Registers the session with Cartridge API if requested
+   */
+  static login(app_id: string, username: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, owner: Owner, cartridge_api_url: string, session_expires_at_s: bigint, is_controller_registered?: boolean | null, create_wildcard_session?: boolean | null): Promise<LoginResult>;
   /**
    * This should only be used with webauthn signers
    */