@ecency/sdk 2.3.76 → 2.3.78

package/dist/browser/index.d.ts

@@ -634,8 +634,28 @@ interface AuthContext {
     /** Login method used ('key', 'hivesigner', 'keychain', 'hiveauth') */
     loginType?: string | null;
     /**
-     * Custom broadcast function for platform-specific signing.
-     * @deprecated Use platform adapter's broadcastWithKeychain/broadcastWithHiveAuth instead.
+     * A caller-supplied broadcaster for signing operations that the platform adapter cannot perform.
+     *
+     * NOT deprecated, and not a legacy path. `useBroadcastMutation` reaches it as
+     * `case 'custom'`, the last link of the default fallback chain, and two call
+     * sites in the web app need it because no adapter method fits:
+     *
+     * - `use-login-by-key.ts` grants posting permission DURING login, before the
+     *   user exists to the adapter, so the key comes from a ref instead.
+     * - `wallet-operations-sign.tsx` dispatches on a signing method the user picks
+     *   mid-flow, which is a decision the adapter has no way to know about.
+     *
+     * It carried an `@deprecated` tag pointing at `broadcastWithKeychain`, and
+     * that reading is what went wrong: four SDK mutations treated this as "the
+     * keychain path", checked it, and threw when a caller passed an
+     * `AuthContextV2` that legitimately has no `broadcast`. Every field here is
+     * optional, so V2 satisfies `AuthContext` structurally and the type checker
+     * saw nothing; each site failed only when a real user reached it. Migrated in
+     * #1376.
+     *
+     * So: reach for the adapter when you mean "sign with the user's wallet". Reach
+     * for this only when you are supplying the signing yourself, and never as a
+     * way to detect Keychain.
      */
     broadcast?: (operations: Operation[], authority?: "active" | "posting" | "owner" | "memo") => Promise<unknown>;
 }
@@ -990,7 +1010,7 @@ declare function useBroadcastMutation<T>(mutationKey: MutationKey | undefined, u
     broadcastMode?: BroadcastMode;
 }): _tanstack_react_query.UseMutationResult<unknown, Error, T, unknown>;
 
-declare function broadcastJson<T>(username: string | undefined, id: string, payload: T, auth?: AuthContext): Promise<any>;
+declare function broadcastJson<T>(username: string | undefined, id: string, payload: T, auth?: AuthContextV2): Promise<any>;
 
 /**
  * Delay (ms) before invalidating chain-derived queries after an async
@@ -2255,7 +2275,7 @@ interface CommonPayload$1 {
 type RevokePostingOptions = Pick<UseMutationOptions<unknown, Error, CommonPayload$1>, "onSuccess" | "onError"> & {
     hsCallbackUrl?: string;
 };
-declare function useAccountRevokePosting(username: string | undefined, options: RevokePostingOptions, auth?: AuthContext): _tanstack_react_query.UseMutationResult<unknown, Error, CommonPayload$1, unknown>;
+declare function useAccountRevokePosting(username: string | undefined, options: RevokePostingOptions, auth?: AuthContextV2): _tanstack_react_query.UseMutationResult<string | void | TransactionConfirmation, Error, CommonPayload$1, unknown>;
 
 type SignType = "key" | "keychain" | "hivesigner" | "ecency";
 interface CommonPayload {
@@ -2267,7 +2287,7 @@ interface CommonPayload {
 type UpdateRecoveryOptions = Pick<UseMutationOptions<unknown, Error, CommonPayload>, "onSuccess" | "onError"> & {
     hsCallbackUrl?: string;
 };
-declare function useAccountUpdateRecovery(username: string | undefined, code: string | undefined, options: UpdateRecoveryOptions, auth?: AuthContext): _tanstack_react_query.UseMutationResult<unknown, Error, CommonPayload, unknown>;
+declare function useAccountUpdateRecovery(username: string | undefined, code: string | undefined, options: UpdateRecoveryOptions, auth?: AuthContextV2): _tanstack_react_query.UseMutationResult<string | void | Response | TransactionConfirmation, Error, CommonPayload, unknown>;
 
 interface Payload {
     currentKey: PrivateKey;
@@ -3028,7 +3048,7 @@ declare function useSignOperationByKey(username: string | undefined): _tanstack_
     keyOrSeed: string;
 }, unknown>;
 
-declare function useSignOperationByKeychain(username: string | undefined, auth?: AuthContext, keyType?: "owner" | "active" | "posting" | "memo"): _tanstack_react_query.UseMutationResult<unknown, Error, {
+declare function useSignOperationByKeychain(username: string | undefined, auth?: AuthContextV2, keyType?: "owner" | "active" | "posting" | "memo"): _tanstack_react_query.UseMutationResult<TransactionConfirmation, Error, {
     operation: Operation;
 }, unknown>;