@keetanetwork/keetanet-client 0.10.3 → 0.10.4

package/README.md

@@ -0,0 +1,7 @@
+KeetaNet SDK Implementation in JavaScript
+=========================================
+
+This package implements KeetaNet Client SDK in JavaScript
+
+See the [Getting Started](docs/GETTING-STARTED.md) Guide for more
+information on first steps with the KeetaNet SDK.

package/client/builder.d.ts

@@ -4,18 +4,41 @@ import type { AdjustMethod, BlockHash } from '../lib/block';
 import { Block } from '../lib/block';
 import type { AccountInfo } from '../lib/ledger/types';
 import type { AcceptedPermissionTypes } from '../lib/permissions';
-import Permissions from '../lib/permissions';
+import type { UserClient } from '.';
+import { Permissions } from '../lib/permissions';
 type GetPrevFunction = (acct: GenericAccount | string) => Promise<BlockHash | string | null | undefined>;
 interface AccountSignerOptions {
     account: GenericAccount;
     signer: Account;
 }
+/** @expandType GetPrevFunction */
 interface RenderOptions {
     network: bigint;
     getPrevious: GetPrevFunction;
 }
+/** @useDeclaredType */
 type BuilderBlockOptions = Partial<AccountSignerOptions>;
-export type BuilderOptions = Partial<AccountSignerOptions> & Pick<AccountSignerOptions, 'signer'>;
+/**
+ * Either a UserClient or an object with a client and network
+ *
+ * @example
+ * ```typescript
+ * const userClient = UserClient.fromNetwork('test');
+ * const config: UserClientOrClientAndNetwork = userClient;
+ * const alternativeConfig: UserClientOrClientAndNetwork = {
+ *     client: userClient.client,
+ *     network: userClient.network
+ * };
+ * ```
+ */
+type UserClientOrClientAndNetwork = Pick<UserClient, 'client' | 'network'> | Pick<UserClient, 'client' | 'network' | 'head' | 'publishBuilder'>;
+/** @expand */
+export type BuilderOptions = Partial<AccountSignerOptions> & Pick<AccountSignerOptions, 'signer'> & {
+    /**
+     * User Client or object with a client and network
+     */
+    userClient?: UserClientOrClientAndNetwork;
+};
 type PerAccount<T> = {
     [accountPubKey: string]: T;
 };
@@ -89,11 +112,24 @@ export interface AccountSignerOptionsJSON {
     account: string;
     signer: string;
 }
+/**
+ * @expand
+ */
 export interface AllPendingJSON {
+    /**
+     * Blocks which have been rendered
+     */
     renderedBlocks: string[];
+    /**
+     * Blocks which have not been rendered
+     */
     nonRendered: [AccountSignerOptionsJSON, PendingOperationsJSON][];
 }
+/** @expand */
 export interface ComputeBlocksResponse {
+    /**
+     * Blocks which have been computed
+     */
     blocks: Block[];
 }
 export declare class PendingAccount<AccountType extends AccountKeyAlgorithm = AccountKeyAlgorithm> {
@@ -114,6 +150,10 @@ export declare class UserClientBuilder {
     get defaultOptions(): BuilderOptions;
     updateAccounts(accountOptions: Partial<AccountSignerOptions>): void;
     clone(): Promise<UserClientBuilder>;
+    publish(): Promise<Awaited<ReturnType<UserClient['publishBuilder']>>>;
+    publish(client?: UserClientOrClientAndNetwork): Promise<Awaited<ReturnType<UserClient['publishBuilder']>>>;
+    computeBlocks(): Promise<ComputeBlocksResponse>;
+    computeBlocks(client?: UserClientOrClientAndNetwork): Promise<ComputeBlocksResponse>;
     computeBlocks(renderOptions: RenderOptions): Promise<ComputeBlocksResponse>;
     send(recipient: AccountOrPending, amount: bigint, token: TokenOrPending, external?: string, options?: BuilderBlockOptions): void;
     receive(from: AccountOrPending, amount: bigint, token: TokenOrPending, exact?: boolean, forward?: GenericAccount, options?: BuilderBlockOptions): void;

package/client/client_common_tests.d.ts

@@ -5,7 +5,7 @@ import { AccountKeyAlgorithm } from '../lib/account';
 import type Account from '../lib/account';
 import { UserClient } from '.';
 import { toJSONSerializable } from '../lib/utils/conversion';
-import KeetaError from '../lib/error';
+import { KeetaNetError as KeetaError } from '../lib/error';
 export type ClientParams = {
     ip?: string;
     port?: number;