@cartridge/connector 0.13.11 → 0.13.13

package/.turbo/turbo-build$colon$deps.log

@@ -1,5 +1,5 @@
 
-> @cartridge/connector@0.13.11 build:deps /home/runner/work/controller/controller/packages/connector
+> @cartridge/connector@0.13.13 build:deps /home/runner/work/controller/controller/packages/connector
 > tsup --dts-resolve
 
 CLI Building entry: src/controller.ts, src/index.ts, src/session.ts
@@ -9,15 +9,15 @@
 CLI Target: esnext
 CLI Cleaning output folder
 ESM Build start
-ESM dist/controller.js     2.06 KB
-ESM dist/index.js          2.91 KB
+ESM dist/controller.js     2.12 KB
+ESM dist/index.js          2.96 KB
 ESM dist/session.js        916.00 B
-ESM dist/controller.js.map 4.31 KB
-ESM dist/index.js.map      5.99 KB
+ESM dist/controller.js.map 4.42 KB
+ESM dist/index.js.map      6.10 KB
 ESM dist/session.js.map    1.73 KB
-ESM ⚡️ Build success in 61ms
+ESM ⚡️ Build success in 70ms
 DTS Build start
-DTS ⚡️ Build success in 5112ms
-DTS dist/index.d.ts      290.00 B
-DTS dist/controller.d.ts 1.10 KB
+DTS ⚡️ Build success in 6111ms
+DTS dist/index.d.ts      270.00 B
+DTS dist/controller.d.ts 1.08 KB
 DTS dist/session.d.ts    476.00 B

package/README.md

@@ -0,0 +1,49 @@
+# @cartridge/connector
+
+Cartridge Controller connector for `starknet-react` and other StarkNet wallet libraries.
+
+## Why this package needs to be instantiated
+
+The Cartridge Controller is iframe-based and requires per-app configuration (chains, paymaster, preset, etc.).
+Unlike browser-extension wallets, it cannot auto-inject itself at page load — the dapp must construct it once at app startup.
+
+When `ControllerConnector` is instantiated, it:
+
+- Sets `window.starknet_controller` so legacy `window.starknet_*` discovery finds it.
+- Calls `@wallet-standard/wallet`'s `registerWallet(...)` so any wallet-standard consumer (e.g. `starknet-start` via `@starknet-io/get-starknet-core`) discovers it through the standard event channel.
+
+After that, discovery and disconnect work without further setup.
+
+## Integration paths
+
+### `starknet-react` v5
+
+```ts
+import ControllerConnector from "@cartridge/connector";
+import { StarknetConfig, publicProvider } from "@starknet-react/core";
+
+const connectors = [new ControllerConnector(options)];
+
+<StarknetConfig connectors={connectors} provider={publicProvider()}>
+  <App />
+</StarknetConfig>;
+```
+
+### `starknet-start` (`@starknet-react/start`)
+
+Instantiate `ControllerConnector` once at app startup with your config.
+You don't need to pass it anywhere — the constructor side effect registers Cartridge with starknet-start's discovery.
+
+```ts
+import ControllerConnector from "@cartridge/connector";
+
+new ControllerConnector(options);
+```
+
+For `recommendedWallets` lists, use `id: "controller"`.
+
+### Vanilla `get-starknet` / wallet-standard
+
+Same pattern — instantiating `ControllerConnector` registers the wallet via `@wallet-standard/wallet`.
+
+`controller.asWalletStandard()` is also exposed on the underlying `ControllerProvider` for callers that want the `WalletWithStarknetFeatures` wrapper directly without going through discovery.

package/dist/controller.d.ts

@@ -1,4 +1,4 @@
-import * as _starknet_io_get_starknet_wallet_standard_features from '@starknet-io/get-starknet-wallet-standard/features';
+import * as _starknet_io_get_starknet_core from '@starknet-io/get-starknet-core';
 import * as ControllerProvider from '@cartridge/controller';
 import ControllerProvider__default, { ControllerOptions, ConnectOptions } from '@cartridge/controller';
 import { InjectedConnector, Connector } from '@starknet-react/core';
@@ -8,6 +8,7 @@ declare class ControllerConnector extends InjectedConnector {
     constructor(options?: ControllerOptions);
     disconnect(): Promise<void>;
     username(): Promise<string> | undefined;
+    credits(): Promise<number> | undefined;
     lookupUsername(username: string): Promise<ControllerProvider.HeadlessUsernameLookupResult>;
     isReady(): boolean;
     delegateAccount(): Promise<string | null>;
@@ -18,7 +19,7 @@ declare class ControllerConnector extends InjectedConnector {
         chainId?: bigint;
     }>;
     static fromConnectors(connectors: Connector[]): ControllerConnector;
-    asWalletStandard(): _starknet_io_get_starknet_wallet_standard_features.WalletWithStarknetFeatures;
+    asWalletStandard(): _starknet_io_get_starknet_core.WalletWithStarknetFeatures;
 }
 
 export { ControllerConnector as default };

package/dist/controller.js

@@ -26,6 +26,9 @@ var ControllerConnector = class extends InjectedConnector {
   username() {
     return this.controller.username();
   }
+  credits() {
+    return this.controller.credits();
+  }
   lookupUsername(username) {
     return this.controller.lookupUsername(username);
   }

package/dist/controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/controller.ts"],"sourcesContent":["import ControllerProvider, {\n  ConnectOptions,\n  ControllerOptions,\n} from \"@cartridge/controller\";\nimport { Connector, InjectedConnector } from \"@starknet-react/core\";\n\nexport default class ControllerConnector extends InjectedConnector {\n  public controller: ControllerProvider;\n\n  constructor(options: ControllerOptions = {}) {\n    let controller: ControllerProvider;\n\n    if (typeof window !== \"undefined\" && (window as any).starknet_controller) {\n      console.warn(\n        \"ControllerConnector was instantiated multiple times. \" +\n          \"Reusing existing controller to prevent errors. \" +\n          \"To fix, create the connector at the module level instead of inside a React component.\",\n      );\n      controller = (window as any).starknet_controller;\n    } else {\n      controller = new ControllerProvider(options);\n    }\n\n    super({ options: { id: controller.id, name: controller.name } });\n    this.controller = controller;\n  }\n\n  async disconnect() {\n    await this.controller.disconnect();\n    try {\n      await super.disconnect();\n    } catch {\n      // Best-effort: starknet-react may call disconnect even when the injected wallet isn't present.\n    }\n  }\n\n  username() {\n    return this.controller.username();\n  }\n\n  lookupUsername(username: string) {\n    return this.controller.lookupUsername(username);\n  }\n\n  isReady(): boolean {\n    return this.controller.isReady();\n  }\n\n  async delegateAccount() {\n    return await this.controller.delegateAccount();\n  }\n\n  async connect(args?: { chainIdHint?: bigint } & ConnectOptions) {\n    const { chainIdHint, ...connectOptions } = args ?? {};\n    const controllerArgs =\n      args && Object.keys(connectOptions).length > 0\n        ? (connectOptions as ConnectOptions)\n        : undefined;\n\n    const account = await this.controller.connect(controllerArgs);\n    if (!account) {\n      throw new Error(\"Failed to connect controller\");\n    }\n\n    // Ensure the injected wallet instance used by starknet-react (window.starknet_controller)\n    // always points at the same ControllerProvider instance this connector wraps.\n    if (typeof window !== \"undefined\") {\n      (window as any).starknet_controller = this.controller;\n    }\n\n    const data = await super.connect({ chainIdHint });\n\n    // `@starknet-react/core` updates its state from the `account` returned here.\n    // Use the authoritative address from `controller.connect()` to avoid edge cases\n    // where the injected wallet request returns an empty/undefined account.\n    return { ...data, account: account.address };\n  }\n\n  static fromConnectors(connectors: Connector[]): ControllerConnector {\n    const connector = connectors.find((c) => c.id === \"controller\");\n    if (!connector) {\n      throw new Error(\"Controller connector not found\");\n    }\n    return connector as ControllerConnector;\n  }\n\n  asWalletStandard() {\n    return this.controller.asWalletStandard();\n  }\n}\n"],"mappings":";AAAA,OAAO,wBAGA;AACP,SAAoB,yBAAyB;AAE7C,IAAqB,sBAArB,cAAiD,kBAAkB;AAAA,EAC1D;AAAA,EAEP,YAAY,UAA6B,CAAC,GAAG;AAC3C,QAAI;AAEJ,QAAI,OAAO,WAAW,eAAgB,OAAe,qBAAqB;AACxE,cAAQ;AAAA,QACN;AAAA,MAGF;AACA,mBAAc,OAAe;AAAA,IAC/B,OAAO;AACL,mBAAa,IAAI,mBAAmB,OAAO;AAAA,IAC7C;AAEA,UAAM,EAAE,SAAS,EAAE,IAAI,WAAW,IAAI,MAAM,WAAW,KAAK,EAAE,CAAC;AAC/D,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,aAAa;AACjB,UAAM,KAAK,WAAW,WAAW;AACjC,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AAAA,EAEA,eAAe,UAAkB;AAC/B,WAAO,KAAK,WAAW,eAAe,QAAQ;AAAA,EAChD;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AAAA,EAEA,MAAM,kBAAkB;AACtB,WAAO,MAAM,KAAK,WAAW,gBAAgB;AAAA,EAC/C;AAAA,EAEA,MAAM,QAAQ,MAAkD;AAC9D,UAAM,EAAE,aAAa,GAAG,eAAe,IAAI,QAAQ,CAAC;AACpD,UAAM,iBACJ,QAAQ,OAAO,KAAK,cAAc,EAAE,SAAS,IACxC,iBACD;AAEN,UAAM,UAAU,MAAM,KAAK,WAAW,QAAQ,cAAc;AAC5D,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAIA,QAAI,OAAO,WAAW,aAAa;AACjC,MAAC,OAAe,sBAAsB,KAAK;AAAA,IAC7C;AAEA,UAAM,OAAO,MAAM,MAAM,QAAQ,EAAE,YAAY,CAAC;AAKhD,WAAO,EAAE,GAAG,MAAM,SAAS,QAAQ,QAAQ;AAAA,EAC7C;AAAA,EAEA,OAAO,eAAe,YAA8C;AAClE,UAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,YAAY;AAC9D,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,mBAAmB;AACjB,WAAO,KAAK,WAAW,iBAAiB;AAAA,EAC1C;AACF;","names":[]}
+{"version":3,"sources":["../src/controller.ts"],"sourcesContent":["import ControllerProvider, {\n  ConnectOptions,\n  ControllerOptions,\n} from \"@cartridge/controller\";\nimport { Connector, InjectedConnector } from \"@starknet-react/core\";\n\nexport default class ControllerConnector extends InjectedConnector {\n  public controller: ControllerProvider;\n\n  constructor(options: ControllerOptions = {}) {\n    let controller: ControllerProvider;\n\n    if (typeof window !== \"undefined\" && (window as any).starknet_controller) {\n      console.warn(\n        \"ControllerConnector was instantiated multiple times. \" +\n          \"Reusing existing controller to prevent errors. \" +\n          \"To fix, create the connector at the module level instead of inside a React component.\",\n      );\n      controller = (window as any).starknet_controller;\n    } else {\n      controller = new ControllerProvider(options);\n    }\n\n    super({ options: { id: controller.id, name: controller.name } });\n    this.controller = controller;\n  }\n\n  async disconnect() {\n    await this.controller.disconnect();\n    try {\n      await super.disconnect();\n    } catch {\n      // Best-effort: starknet-react may call disconnect even when the injected wallet isn't present.\n    }\n  }\n\n  username() {\n    return this.controller.username();\n  }\n\n  credits() {\n    return this.controller.credits();\n  }\n\n  lookupUsername(username: string) {\n    return this.controller.lookupUsername(username);\n  }\n\n  isReady(): boolean {\n    return this.controller.isReady();\n  }\n\n  async delegateAccount() {\n    return await this.controller.delegateAccount();\n  }\n\n  async connect(args?: { chainIdHint?: bigint } & ConnectOptions) {\n    const { chainIdHint, ...connectOptions } = args ?? {};\n    const controllerArgs =\n      args && Object.keys(connectOptions).length > 0\n        ? (connectOptions as ConnectOptions)\n        : undefined;\n\n    const account = await this.controller.connect(controllerArgs);\n    if (!account) {\n      throw new Error(\"Failed to connect controller\");\n    }\n\n    // Ensure the injected wallet instance used by starknet-react (window.starknet_controller)\n    // always points at the same ControllerProvider instance this connector wraps.\n    if (typeof window !== \"undefined\") {\n      (window as any).starknet_controller = this.controller;\n    }\n\n    const data = await super.connect({ chainIdHint });\n\n    // `@starknet-react/core` updates its state from the `account` returned here.\n    // Use the authoritative address from `controller.connect()` to avoid edge cases\n    // where the injected wallet request returns an empty/undefined account.\n    return { ...data, account: account.address };\n  }\n\n  static fromConnectors(connectors: Connector[]): ControllerConnector {\n    const connector = connectors.find((c) => c.id === \"controller\");\n    if (!connector) {\n      throw new Error(\"Controller connector not found\");\n    }\n    return connector as ControllerConnector;\n  }\n\n  asWalletStandard() {\n    return this.controller.asWalletStandard();\n  }\n}\n"],"mappings":";AAAA,OAAO,wBAGA;AACP,SAAoB,yBAAyB;AAE7C,IAAqB,sBAArB,cAAiD,kBAAkB;AAAA,EAC1D;AAAA,EAEP,YAAY,UAA6B,CAAC,GAAG;AAC3C,QAAI;AAEJ,QAAI,OAAO,WAAW,eAAgB,OAAe,qBAAqB;AACxE,cAAQ;AAAA,QACN;AAAA,MAGF;AACA,mBAAc,OAAe;AAAA,IAC/B,OAAO;AACL,mBAAa,IAAI,mBAAmB,OAAO;AAAA,IAC7C;AAEA,UAAM,EAAE,SAAS,EAAE,IAAI,WAAW,IAAI,MAAM,WAAW,KAAK,EAAE,CAAC;AAC/D,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,aAAa;AACjB,UAAM,KAAK,WAAW,WAAW;AACjC,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AAAA,EAEA,UAAU;AACR,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AAAA,EAEA,eAAe,UAAkB;AAC/B,WAAO,KAAK,WAAW,eAAe,QAAQ;AAAA,EAChD;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AAAA,EAEA,MAAM,kBAAkB;AACtB,WAAO,MAAM,KAAK,WAAW,gBAAgB;AAAA,EAC/C;AAAA,EAEA,MAAM,QAAQ,MAAkD;AAC9D,UAAM,EAAE,aAAa,GAAG,eAAe,IAAI,QAAQ,CAAC;AACpD,UAAM,iBACJ,QAAQ,OAAO,KAAK,cAAc,EAAE,SAAS,IACxC,iBACD;AAEN,UAAM,UAAU,MAAM,KAAK,WAAW,QAAQ,cAAc;AAC5D,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAIA,QAAI,OAAO,WAAW,aAAa;AACjC,MAAC,OAAe,sBAAsB,KAAK;AAAA,IAC7C;AAEA,UAAM,OAAO,MAAM,MAAM,QAAQ,EAAE,YAAY,CAAC;AAKhD,WAAO,EAAE,GAAG,MAAM,SAAS,QAAQ,QAAQ;AAAA,EAC7C;AAAA,EAEA,OAAO,eAAe,YAA8C;AAClE,UAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,YAAY;AAC9D,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,mBAAmB;AACjB,WAAO,KAAK,WAAW,iBAAiB;AAAA,EAC1C;AACF;","names":[]}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { default as ControllerConnector } from './controller.js';
 export { default as SessionConnector } from './session.js';
-import '@starknet-io/get-starknet-wallet-standard/features';
+import '@starknet-io/get-starknet-core';
 import '@cartridge/controller';
 import '@starknet-react/core';
 import '@cartridge/controller/session';

package/dist/index.js

@@ -26,6 +26,9 @@ var ControllerConnector = class extends InjectedConnector {
   username() {
     return this.controller.username();
   }
+  credits() {
+    return this.controller.credits();
+  }
   lookupUsername(username) {
     return this.controller.lookupUsername(username);
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/controller.ts","../src/session.ts"],"sourcesContent":["import ControllerProvider, {\n  ConnectOptions,\n  ControllerOptions,\n} from \"@cartridge/controller\";\nimport { Connector, InjectedConnector } from \"@starknet-react/core\";\n\nexport default class ControllerConnector extends InjectedConnector {\n  public controller: ControllerProvider;\n\n  constructor(options: ControllerOptions = {}) {\n    let controller: ControllerProvider;\n\n    if (typeof window !== \"undefined\" && (window as any).starknet_controller) {\n      console.warn(\n        \"ControllerConnector was instantiated multiple times. \" +\n          \"Reusing existing controller to prevent errors. \" +\n          \"To fix, create the connector at the module level instead of inside a React component.\",\n      );\n      controller = (window as any).starknet_controller;\n    } else {\n      controller = new ControllerProvider(options);\n    }\n\n    super({ options: { id: controller.id, name: controller.name } });\n    this.controller = controller;\n  }\n\n  async disconnect() {\n    await this.controller.disconnect();\n    try {\n      await super.disconnect();\n    } catch {\n      // Best-effort: starknet-react may call disconnect even when the injected wallet isn't present.\n    }\n  }\n\n  username() {\n    return this.controller.username();\n  }\n\n  lookupUsername(username: string) {\n    return this.controller.lookupUsername(username);\n  }\n\n  isReady(): boolean {\n    return this.controller.isReady();\n  }\n\n  async delegateAccount() {\n    return await this.controller.delegateAccount();\n  }\n\n  async connect(args?: { chainIdHint?: bigint } & ConnectOptions) {\n    const { chainIdHint, ...connectOptions } = args ?? {};\n    const controllerArgs =\n      args && Object.keys(connectOptions).length > 0\n        ? (connectOptions as ConnectOptions)\n        : undefined;\n\n    const account = await this.controller.connect(controllerArgs);\n    if (!account) {\n      throw new Error(\"Failed to connect controller\");\n    }\n\n    // Ensure the injected wallet instance used by starknet-react (window.starknet_controller)\n    // always points at the same ControllerProvider instance this connector wraps.\n    if (typeof window !== \"undefined\") {\n      (window as any).starknet_controller = this.controller;\n    }\n\n    const data = await super.connect({ chainIdHint });\n\n    // `@starknet-react/core` updates its state from the `account` returned here.\n    // Use the authoritative address from `controller.connect()` to avoid edge cases\n    // where the injected wallet request returns an empty/undefined account.\n    return { ...data, account: account.address };\n  }\n\n  static fromConnectors(connectors: Connector[]): ControllerConnector {\n    const connector = connectors.find((c) => c.id === \"controller\");\n    if (!connector) {\n      throw new Error(\"Controller connector not found\");\n    }\n    return connector as ControllerConnector;\n  }\n\n  asWalletStandard() {\n    return this.controller.asWalletStandard();\n  }\n}\n","import SessionProvider, { SessionOptions } from \"@cartridge/controller/session\";\nimport { Connector, InjectedConnector } from \"@starknet-react/core\";\n\nexport default class SessionConnector extends InjectedConnector {\n  public controller: SessionProvider;\n\n  constructor(options: SessionOptions) {\n    const controller = new SessionProvider(options);\n\n    super({\n      options: {\n        id: controller.id,\n        name: controller.name,\n      },\n    });\n\n    this.controller = controller;\n  }\n\n  async disconnect() {\n    await this.controller.disconnect();\n    try {\n      await super.disconnect();\n    } catch {\n      // Best-effort: disconnect should not throw if the injected wallet isn't available.\n    }\n  }\n\n  static fromConnectors(connectors: Connector[]): SessionConnector {\n    const connector = connectors.find((c) => c.id === \"controller_session\");\n    if (!connector) {\n      throw new Error(\"Session connector not found\");\n    }\n    return connector as SessionConnector;\n  }\n\n  username() {\n    return this.controller.username();\n  }\n}\n"],"mappings":";AAAA,OAAO,wBAGA;AACP,SAAoB,yBAAyB;AAE7C,IAAqB,sBAArB,cAAiD,kBAAkB;AAAA,EAC1D;AAAA,EAEP,YAAY,UAA6B,CAAC,GAAG;AAC3C,QAAI;AAEJ,QAAI,OAAO,WAAW,eAAgB,OAAe,qBAAqB;AACxE,cAAQ;AAAA,QACN;AAAA,MAGF;AACA,mBAAc,OAAe;AAAA,IAC/B,OAAO;AACL,mBAAa,IAAI,mBAAmB,OAAO;AAAA,IAC7C;AAEA,UAAM,EAAE,SAAS,EAAE,IAAI,WAAW,IAAI,MAAM,WAAW,KAAK,EAAE,CAAC;AAC/D,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,aAAa;AACjB,UAAM,KAAK,WAAW,WAAW;AACjC,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AAAA,EAEA,eAAe,UAAkB;AAC/B,WAAO,KAAK,WAAW,eAAe,QAAQ;AAAA,EAChD;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AAAA,EAEA,MAAM,kBAAkB;AACtB,WAAO,MAAM,KAAK,WAAW,gBAAgB;AAAA,EAC/C;AAAA,EAEA,MAAM,QAAQ,MAAkD;AAC9D,UAAM,EAAE,aAAa,GAAG,eAAe,IAAI,QAAQ,CAAC;AACpD,UAAM,iBACJ,QAAQ,OAAO,KAAK,cAAc,EAAE,SAAS,IACxC,iBACD;AAEN,UAAM,UAAU,MAAM,KAAK,WAAW,QAAQ,cAAc;AAC5D,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAIA,QAAI,OAAO,WAAW,aAAa;AACjC,MAAC,OAAe,sBAAsB,KAAK;AAAA,IAC7C;AAEA,UAAM,OAAO,MAAM,MAAM,QAAQ,EAAE,YAAY,CAAC;AAKhD,WAAO,EAAE,GAAG,MAAM,SAAS,QAAQ,QAAQ;AAAA,EAC7C;AAAA,EAEA,OAAO,eAAe,YAA8C;AAClE,UAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,YAAY;AAC9D,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,mBAAmB;AACjB,WAAO,KAAK,WAAW,iBAAiB;AAAA,EAC1C;AACF;;;ACzFA,OAAO,qBAAyC;AAChD,SAAoB,qBAAAA,0BAAyB;AAE7C,IAAqB,mBAArB,cAA8CA,mBAAkB;AAAA,EACvD;AAAA,EAEP,YAAY,SAAyB;AACnC,UAAM,aAAa,IAAI,gBAAgB,OAAO;AAE9C,UAAM;AAAA,MACJ,SAAS;AAAA,QACP,IAAI,WAAW;AAAA,QACf,MAAM,WAAW;AAAA,MACnB;AAAA,IACF,CAAC;AAED,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,aAAa;AACjB,UAAM,KAAK,WAAW,WAAW;AACjC,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,OAAO,eAAe,YAA2C;AAC/D,UAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,oBAAoB;AACtE,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AACF;","names":["InjectedConnector"]}
+{"version":3,"sources":["../src/controller.ts","../src/session.ts"],"sourcesContent":["import ControllerProvider, {\n  ConnectOptions,\n  ControllerOptions,\n} from \"@cartridge/controller\";\nimport { Connector, InjectedConnector } from \"@starknet-react/core\";\n\nexport default class ControllerConnector extends InjectedConnector {\n  public controller: ControllerProvider;\n\n  constructor(options: ControllerOptions = {}) {\n    let controller: ControllerProvider;\n\n    if (typeof window !== \"undefined\" && (window as any).starknet_controller) {\n      console.warn(\n        \"ControllerConnector was instantiated multiple times. \" +\n          \"Reusing existing controller to prevent errors. \" +\n          \"To fix, create the connector at the module level instead of inside a React component.\",\n      );\n      controller = (window as any).starknet_controller;\n    } else {\n      controller = new ControllerProvider(options);\n    }\n\n    super({ options: { id: controller.id, name: controller.name } });\n    this.controller = controller;\n  }\n\n  async disconnect() {\n    await this.controller.disconnect();\n    try {\n      await super.disconnect();\n    } catch {\n      // Best-effort: starknet-react may call disconnect even when the injected wallet isn't present.\n    }\n  }\n\n  username() {\n    return this.controller.username();\n  }\n\n  credits() {\n    return this.controller.credits();\n  }\n\n  lookupUsername(username: string) {\n    return this.controller.lookupUsername(username);\n  }\n\n  isReady(): boolean {\n    return this.controller.isReady();\n  }\n\n  async delegateAccount() {\n    return await this.controller.delegateAccount();\n  }\n\n  async connect(args?: { chainIdHint?: bigint } & ConnectOptions) {\n    const { chainIdHint, ...connectOptions } = args ?? {};\n    const controllerArgs =\n      args && Object.keys(connectOptions).length > 0\n        ? (connectOptions as ConnectOptions)\n        : undefined;\n\n    const account = await this.controller.connect(controllerArgs);\n    if (!account) {\n      throw new Error(\"Failed to connect controller\");\n    }\n\n    // Ensure the injected wallet instance used by starknet-react (window.starknet_controller)\n    // always points at the same ControllerProvider instance this connector wraps.\n    if (typeof window !== \"undefined\") {\n      (window as any).starknet_controller = this.controller;\n    }\n\n    const data = await super.connect({ chainIdHint });\n\n    // `@starknet-react/core` updates its state from the `account` returned here.\n    // Use the authoritative address from `controller.connect()` to avoid edge cases\n    // where the injected wallet request returns an empty/undefined account.\n    return { ...data, account: account.address };\n  }\n\n  static fromConnectors(connectors: Connector[]): ControllerConnector {\n    const connector = connectors.find((c) => c.id === \"controller\");\n    if (!connector) {\n      throw new Error(\"Controller connector not found\");\n    }\n    return connector as ControllerConnector;\n  }\n\n  asWalletStandard() {\n    return this.controller.asWalletStandard();\n  }\n}\n","import SessionProvider, { SessionOptions } from \"@cartridge/controller/session\";\nimport { Connector, InjectedConnector } from \"@starknet-react/core\";\n\nexport default class SessionConnector extends InjectedConnector {\n  public controller: SessionProvider;\n\n  constructor(options: SessionOptions) {\n    const controller = new SessionProvider(options);\n\n    super({\n      options: {\n        id: controller.id,\n        name: controller.name,\n      },\n    });\n\n    this.controller = controller;\n  }\n\n  async disconnect() {\n    await this.controller.disconnect();\n    try {\n      await super.disconnect();\n    } catch {\n      // Best-effort: disconnect should not throw if the injected wallet isn't available.\n    }\n  }\n\n  static fromConnectors(connectors: Connector[]): SessionConnector {\n    const connector = connectors.find((c) => c.id === \"controller_session\");\n    if (!connector) {\n      throw new Error(\"Session connector not found\");\n    }\n    return connector as SessionConnector;\n  }\n\n  username() {\n    return this.controller.username();\n  }\n}\n"],"mappings":";AAAA,OAAO,wBAGA;AACP,SAAoB,yBAAyB;AAE7C,IAAqB,sBAArB,cAAiD,kBAAkB;AAAA,EAC1D;AAAA,EAEP,YAAY,UAA6B,CAAC,GAAG;AAC3C,QAAI;AAEJ,QAAI,OAAO,WAAW,eAAgB,OAAe,qBAAqB;AACxE,cAAQ;AAAA,QACN;AAAA,MAGF;AACA,mBAAc,OAAe;AAAA,IAC/B,OAAO;AACL,mBAAa,IAAI,mBAAmB,OAAO;AAAA,IAC7C;AAEA,UAAM,EAAE,SAAS,EAAE,IAAI,WAAW,IAAI,MAAM,WAAW,KAAK,EAAE,CAAC;AAC/D,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,aAAa;AACjB,UAAM,KAAK,WAAW,WAAW;AACjC,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AAAA,EAEA,UAAU;AACR,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AAAA,EAEA,eAAe,UAAkB;AAC/B,WAAO,KAAK,WAAW,eAAe,QAAQ;AAAA,EAChD;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AAAA,EAEA,MAAM,kBAAkB;AACtB,WAAO,MAAM,KAAK,WAAW,gBAAgB;AAAA,EAC/C;AAAA,EAEA,MAAM,QAAQ,MAAkD;AAC9D,UAAM,EAAE,aAAa,GAAG,eAAe,IAAI,QAAQ,CAAC;AACpD,UAAM,iBACJ,QAAQ,OAAO,KAAK,cAAc,EAAE,SAAS,IACxC,iBACD;AAEN,UAAM,UAAU,MAAM,KAAK,WAAW,QAAQ,cAAc;AAC5D,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAIA,QAAI,OAAO,WAAW,aAAa;AACjC,MAAC,OAAe,sBAAsB,KAAK;AAAA,IAC7C;AAEA,UAAM,OAAO,MAAM,MAAM,QAAQ,EAAE,YAAY,CAAC;AAKhD,WAAO,EAAE,GAAG,MAAM,SAAS,QAAQ,QAAQ;AAAA,EAC7C;AAAA,EAEA,OAAO,eAAe,YAA8C;AAClE,UAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,YAAY;AAC9D,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,gCAAgC;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,mBAAmB;AACjB,WAAO,KAAK,WAAW,iBAAiB;AAAA,EAC1C;AACF;;;AC7FA,OAAO,qBAAyC;AAChD,SAAoB,qBAAAA,0BAAyB;AAE7C,IAAqB,mBAArB,cAA8CA,mBAAkB;AAAA,EACvD;AAAA,EAEP,YAAY,SAAyB;AACnC,UAAM,aAAa,IAAI,gBAAgB,OAAO;AAE9C,UAAM;AAAA,MACJ,SAAS;AAAA,QACP,IAAI,WAAW;AAAA,QACf,MAAM,WAAW;AAAA,MACnB;AAAA,IACF,CAAC;AAED,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,aAAa;AACjB,UAAM,KAAK,WAAW,WAAW;AACjC,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,OAAO,eAAe,YAA2C;AAC/D,UAAM,YAAY,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,oBAAoB;AACtE,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,WAAW,SAAS;AAAA,EAClC;AACF;","names":["InjectedConnector"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartridge/connector",
-  "version": "0.13.11",
+  "version": "0.13.13",
   "description": "Cartridge Controller Connector",
   "repository": {
     "type": "git",
@@ -44,15 +44,15 @@
     "@starknet-react/core": "^5.0.1"
   },
   "dependencies": {
-    "@cartridge/controller": "0.13.11"
+    "@cartridge/controller": "0.13.13"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "2.1.8",
+    "@vitest/coverage-v8": "^3.1.3",
     "prettier": "^3.4.2",
     "tsup": "^8.0.1",
     "typescript": "^5.7.3",
-    "vitest": "2.1.8",
-    "@cartridge/tsconfig": "0.13.11"
+    "vitest": "^3.1.3",
+    "@cartridge/tsconfig": "0.13.13"
   },
   "scripts": {
     "build:deps": "tsup --dts-resolve",

package/src/controller.ts

@@ -38,6 +38,10 @@ export default class ControllerConnector extends InjectedConnector {
     return this.controller.username();
   }
 
+  credits() {
+    return this.controller.credits();
+  }
+
   lookupUsername(username: string) {
     return this.controller.lookupUsername(username);
   }