@meshtrade/api-web 1.30.0 → 1.31.0

package/dist/meshtrade/trading/limit_order/v1/service_web_meshts.js

@@ -7,28 +7,87 @@ exports.LimitOrderServiceWeb = void 0;
 const connect_1 = require("@connectrpc/connect");
 const connect_web_1 = require("@connectrpc/connect-web");
 const service_pb_1 = require("./service_pb");
-const config_1 = require("../../../common/config");
-const validation_1 = require("../../../common/validation");
-const connectInterceptors_1 = require("../../../common/connectInterceptors");
+const service_pb_2 = require("./service_pb");
+const config_1 = require("../../../config");
+const protovalidate_1 = require("@bufbuild/protovalidate");
+const interceptors_1 = require("../../../interceptors");
 /**
  * Web client for interacting with the meshtrade.trading.limit_order.v1 limit order v1 API resource service.
- * Uses Connect-ES with gRPC-Web transport for browser-compatible gRPC communication.
+ * Uses Connect-ES with gRPC-Web transport for browser-based communication.
+ *
+ * Supports flexible authentication modes using functional options pattern:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new LimitOrderServiceWeb(
+ *      WithServerUrl("http://localhost:10000")
+ *    );
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new LimitOrderServiceWeb(
+ *      WithAPIKey("your-api-key"),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js frontend with user session):
+ *    ```typescript
+ *    const client = new LimitOrderServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 4. **JWT with Group Context** (user session with specific group):
+ *    ```typescript
+ *    const client = new LimitOrderServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * Available options:
+ * - `WithAPIKey(key)` - API key authentication (mutually exclusive with JWT)
+ * - `WithJWTAccessToken(token)` - JWT authentication (mutually exclusive with API key)
+ * - `WithGroup(group)` - Group context (optional, works with both auth modes)
+ * - `WithServerUrl(url)` - Custom server URL (optional, defaults to production)
  */
 class LimitOrderServiceWeb {
     /**
      * Constructs an instance of LimitOrderServiceWeb.
-     * @param {ConfigOpts} [config] - Optional configuration for the client.
-     * @param {Interceptor[]} [interceptors] - For internal use by `withGroup`.
+     *
+     * Uses functional options pattern for flexible configuration:
+     * - `WithAPIKey(key)` - API key authentication
+     * - `WithJWTAccessToken(token)` - JWT authentication
+     * - `WithGroup(group)` - Group context (optional)
+     * - `WithServerUrl(url)` - Custom server URL (optional)
+     *
+     * @param {...ClientOption} opts - Variable number of configuration options
      */
-    constructor(config, interceptors) {
-        this._config = (0, config_1.getConfigFromOpts)(config);
-        this._interceptors = interceptors || [];
-        // Create the gRPC-Web transport with interceptors
+    constructor(...opts) {
+        // Build configuration from options
+        this._config = (0, config_1.buildConfigFromOptions)(...opts);
+        // Initialize validator for request validation
+        this._validator = (0, protovalidate_1.createValidator)();
+        this._interceptors = [];
+        this._interceptors.push((0, interceptors_1.createLoggingInterceptor)());
+        if (this._config.apiKey) {
+            this._interceptors.push((0, interceptors_1.createApiKeyInterceptor)(this._config.apiKey));
+        }
+        if (this._config.jwtToken) {
+            this._interceptors.push((0, interceptors_1.createJwtInterceptor)(this._config.jwtToken));
+        }
+        if (this._config.group) {
+            this._interceptors.push((0, interceptors_1.createGroupInterceptor)(this._config.group));
+        }
+        // Create the gRPC-Web transport for browser with interceptors
         const transport = (0, connect_web_1.createGrpcWebTransport)({
             baseUrl: this._config.apiServerURL,
             interceptors: this._interceptors,
-            // Enable credentials (cookies) for cross-origin requests
-            fetch: (input, init) => globalThis.fetch(input, { ...init, credentials: 'include' }),
         });
         // Construct the Connect-ES client
         this._client = (0, connect_1.createClient)(service_pb_1.LimitOrderService, transport);
@@ -37,26 +96,36 @@ class LimitOrderServiceWeb {
      * Returns a new client instance configured to send the specified group
      * resource name in the request headers for subsequent API calls.
      *
+     * This method creates a new client with the same authentication configuration
+     * but with the group context updated to the specified value.
+     *
+     * **Compatibility**: Works with all authentication modes:
+     * - **API key auth**: Creates new client with API key + new group
+     * - **JWT auth**: Creates new client with JWT + new group
+     * - **No auth**: Creates new client with standalone group interceptor
+     *
      * @param {string} group - The operating group context to inject into the request
      *                         in the format `groups/{ulid}` where {ulid} is a 26-character ULID.
      *                         Example: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
      * @returns {LimitOrderServiceWeb} A new, configured instance of the client.
-     * @throws {Error} If the group format is invalid (validation occurs in createGroupInterceptor)
+     * @throws {Error} If the group format is invalid
      */
     withGroup(group) {
-        // Check if a group interceptor already exists.
-        // Group interceptors are identified by having a 'groupContext' property
-        const hasGroupInterceptor = this._interceptors.some((interceptor) => interceptor.groupContext !== undefined);
-        if (hasGroupInterceptor) {
-            throw new Error("Attempted to set group context twice. A group has already been set for this client instance.");
-        }
-        // Create a new interceptor for the group context
-        const groupInterceptor = (0, connectInterceptors_1.createGroupInterceptor)(group);
-        // Return a new client instance with the existing interceptors plus the new one
-        return new LimitOrderServiceWeb(this._config, [
-            ...this._interceptors,
-            groupInterceptor,
-        ]);
+        // Build new options array with existing auth and updated group
+        const newOpts = [];
+        // Add server URL
+        newOpts.push((0, config_1.WithServerUrl)(this._config.apiServerURL));
+        // Add authentication (preserve existing mode)
+        if (this._config.apiKey) {
+            newOpts.push((0, config_1.WithAPIKey)(this._config.apiKey));
+        }
+        else if (this._config.jwtToken) {
+            newOpts.push((0, config_1.WithJWTAccessToken)(this._config.jwtToken));
+        }
+        // Add the new group
+        newOpts.push((0, config_1.WithGroup)(group));
+        // Return a new client instance with updated configuration
+        return new LimitOrderServiceWeb(...newOpts);
     }
     /**
      * Creates a new limit order.
@@ -65,7 +134,14 @@ class LimitOrderServiceWeb {
      */
     createLimitOrder(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.CreateLimitOrderRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.createLimitOrder(request);
     }
     /**
@@ -75,7 +151,14 @@ class LimitOrderServiceWeb {
      */
     cancelLimitOrder(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.CancelLimitOrderRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.cancelLimitOrder(request);
     }
     /**
@@ -85,7 +168,14 @@ class LimitOrderServiceWeb {
      */
     getLimitOrder(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.GetLimitOrderRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.getLimitOrder(request);
     }
     /**
@@ -95,7 +185,14 @@ class LimitOrderServiceWeb {
      */
     getLimitOrderByExternalReference(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.GetLimitOrderByExternalReferenceRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.getLimitOrderByExternalReference(request);
     }
     /**
@@ -105,7 +202,14 @@ class LimitOrderServiceWeb {
      */
     listLimitOrders(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.ListLimitOrdersRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.listLimitOrders(request);
     }
     /**
@@ -115,7 +219,14 @@ class LimitOrderServiceWeb {
      */
     searchLimitOrders(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.SearchLimitOrdersRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.searchLimitOrders(request);
     }
     /**
@@ -134,7 +245,14 @@ class LimitOrderServiceWeb {
      */
     monitorLimitOrder(request) {
         // Validate request before initiating stream
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.MonitorLimitOrderRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.monitorLimitOrder(request);
     }
 }

package/dist/meshtrade/trading/market_order/v1/service_web_meshts.d.ts

@@ -1,30 +1,85 @@
-import { Interceptor } from "@connectrpc/connect";
 import { GetMarketOrderRequest } from "./service_pb";
 import { MarketOrder } from "./market_order_pb";
-import { ConfigOpts } from "../../../common/config";
+import { ClientOption } from "../../../config";
 /**
  * Web client for interacting with the meshtrade.trading.market_order.v1 market order v1 API resource service.
- * Uses Connect-ES with gRPC-Web transport for browser-compatible gRPC communication.
+ * Uses Connect-ES with gRPC-Web transport for browser-based communication.
+ *
+ * Supports flexible authentication modes using functional options pattern:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithServerUrl("http://localhost:10000")
+ *    );
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithAPIKey("your-api-key"),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js frontend with user session):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 4. **JWT with Group Context** (user session with specific group):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * Available options:
+ * - `WithAPIKey(key)` - API key authentication (mutually exclusive with JWT)
+ * - `WithJWTAccessToken(token)` - JWT authentication (mutually exclusive with API key)
+ * - `WithGroup(group)` - Group context (optional, works with both auth modes)
+ * - `WithServerUrl(url)` - Custom server URL (optional, defaults to production)
  */
 export declare class MarketOrderServiceWeb {
     private _client;
     private readonly _config;
     private readonly _interceptors;
+    private readonly _validator;
     /**
      * Constructs an instance of MarketOrderServiceWeb.
-     * @param {ConfigOpts} [config] - Optional configuration for the client.
-     * @param {Interceptor[]} [interceptors] - For internal use by `withGroup`.
+     *
+     * Uses functional options pattern for flexible configuration:
+     * - `WithAPIKey(key)` - API key authentication
+     * - `WithJWTAccessToken(token)` - JWT authentication
+     * - `WithGroup(group)` - Group context (optional)
+     * - `WithServerUrl(url)` - Custom server URL (optional)
+     *
+     * @param {...ClientOption} opts - Variable number of configuration options
      */
-    constructor(config?: ConfigOpts, interceptors?: Interceptor[]);
+    constructor(...opts: ClientOption[]);
     /**
      * Returns a new client instance configured to send the specified group
      * resource name in the request headers for subsequent API calls.
      *
+     * This method creates a new client with the same authentication configuration
+     * but with the group context updated to the specified value.
+     *
+     * **Compatibility**: Works with all authentication modes:
+     * - **API key auth**: Creates new client with API key + new group
+     * - **JWT auth**: Creates new client with JWT + new group
+     * - **No auth**: Creates new client with standalone group interceptor
+     *
      * @param {string} group - The operating group context to inject into the request
      *                         in the format `groups/{ulid}` where {ulid} is a 26-character ULID.
      *                         Example: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
      * @returns {MarketOrderServiceWeb} A new, configured instance of the client.
-     * @throws {Error} If the group format is invalid (validation occurs in createGroupInterceptor)
+     * @throws {Error} If the group format is invalid
      */
     withGroup(group: string): MarketOrderServiceWeb;
     /**

package/dist/meshtrade/trading/market_order/v1/service_web_meshts.js

@@ -7,28 +7,87 @@ exports.MarketOrderServiceWeb = void 0;
 const connect_1 = require("@connectrpc/connect");
 const connect_web_1 = require("@connectrpc/connect-web");
 const service_pb_1 = require("./service_pb");
-const config_1 = require("../../../common/config");
-const validation_1 = require("../../../common/validation");
-const connectInterceptors_1 = require("../../../common/connectInterceptors");
+const service_pb_2 = require("./service_pb");
+const config_1 = require("../../../config");
+const protovalidate_1 = require("@bufbuild/protovalidate");
+const interceptors_1 = require("../../../interceptors");
 /**
  * Web client for interacting with the meshtrade.trading.market_order.v1 market order v1 API resource service.
- * Uses Connect-ES with gRPC-Web transport for browser-compatible gRPC communication.
+ * Uses Connect-ES with gRPC-Web transport for browser-based communication.
+ *
+ * Supports flexible authentication modes using functional options pattern:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithServerUrl("http://localhost:10000")
+ *    );
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithAPIKey("your-api-key"),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js frontend with user session):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 4. **JWT with Group Context** (user session with specific group):
+ *    ```typescript
+ *    const client = new MarketOrderServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * Available options:
+ * - `WithAPIKey(key)` - API key authentication (mutually exclusive with JWT)
+ * - `WithJWTAccessToken(token)` - JWT authentication (mutually exclusive with API key)
+ * - `WithGroup(group)` - Group context (optional, works with both auth modes)
+ * - `WithServerUrl(url)` - Custom server URL (optional, defaults to production)
  */
 class MarketOrderServiceWeb {
     /**
      * Constructs an instance of MarketOrderServiceWeb.
-     * @param {ConfigOpts} [config] - Optional configuration for the client.
-     * @param {Interceptor[]} [interceptors] - For internal use by `withGroup`.
+     *
+     * Uses functional options pattern for flexible configuration:
+     * - `WithAPIKey(key)` - API key authentication
+     * - `WithJWTAccessToken(token)` - JWT authentication
+     * - `WithGroup(group)` - Group context (optional)
+     * - `WithServerUrl(url)` - Custom server URL (optional)
+     *
+     * @param {...ClientOption} opts - Variable number of configuration options
      */
-    constructor(config, interceptors) {
-        this._config = (0, config_1.getConfigFromOpts)(config);
-        this._interceptors = interceptors || [];
-        // Create the gRPC-Web transport with interceptors
+    constructor(...opts) {
+        // Build configuration from options
+        this._config = (0, config_1.buildConfigFromOptions)(...opts);
+        // Initialize validator for request validation
+        this._validator = (0, protovalidate_1.createValidator)();
+        this._interceptors = [];
+        this._interceptors.push((0, interceptors_1.createLoggingInterceptor)());
+        if (this._config.apiKey) {
+            this._interceptors.push((0, interceptors_1.createApiKeyInterceptor)(this._config.apiKey));
+        }
+        if (this._config.jwtToken) {
+            this._interceptors.push((0, interceptors_1.createJwtInterceptor)(this._config.jwtToken));
+        }
+        if (this._config.group) {
+            this._interceptors.push((0, interceptors_1.createGroupInterceptor)(this._config.group));
+        }
+        // Create the gRPC-Web transport for browser with interceptors
         const transport = (0, connect_web_1.createGrpcWebTransport)({
             baseUrl: this._config.apiServerURL,
             interceptors: this._interceptors,
-            // Enable credentials (cookies) for cross-origin requests
-            fetch: (input, init) => globalThis.fetch(input, { ...init, credentials: 'include' }),
         });
         // Construct the Connect-ES client
         this._client = (0, connect_1.createClient)(service_pb_1.MarketOrderService, transport);
@@ -37,26 +96,36 @@ class MarketOrderServiceWeb {
      * Returns a new client instance configured to send the specified group
      * resource name in the request headers for subsequent API calls.
      *
+     * This method creates a new client with the same authentication configuration
+     * but with the group context updated to the specified value.
+     *
+     * **Compatibility**: Works with all authentication modes:
+     * - **API key auth**: Creates new client with API key + new group
+     * - **JWT auth**: Creates new client with JWT + new group
+     * - **No auth**: Creates new client with standalone group interceptor
+     *
      * @param {string} group - The operating group context to inject into the request
      *                         in the format `groups/{ulid}` where {ulid} is a 26-character ULID.
      *                         Example: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
      * @returns {MarketOrderServiceWeb} A new, configured instance of the client.
-     * @throws {Error} If the group format is invalid (validation occurs in createGroupInterceptor)
+     * @throws {Error} If the group format is invalid
      */
     withGroup(group) {
-        // Check if a group interceptor already exists.
-        // Group interceptors are identified by having a 'groupContext' property
-        const hasGroupInterceptor = this._interceptors.some((interceptor) => interceptor.groupContext !== undefined);
-        if (hasGroupInterceptor) {
-            throw new Error("Attempted to set group context twice. A group has already been set for this client instance.");
+        // Build new options array with existing auth and updated group
+        const newOpts = [];
+        // Add server URL
+        newOpts.push((0, config_1.WithServerUrl)(this._config.apiServerURL));
+        // Add authentication (preserve existing mode)
+        if (this._config.apiKey) {
+            newOpts.push((0, config_1.WithAPIKey)(this._config.apiKey));
+        }
+        else if (this._config.jwtToken) {
+            newOpts.push((0, config_1.WithJWTAccessToken)(this._config.jwtToken));
         }
-        // Create a new interceptor for the group context
-        const groupInterceptor = (0, connectInterceptors_1.createGroupInterceptor)(group);
-        // Return a new client instance with the existing interceptors plus the new one
-        return new MarketOrderServiceWeb(this._config, [
-            ...this._interceptors,
-            groupInterceptor,
-        ]);
+        // Add the new group
+        newOpts.push((0, config_1.WithGroup)(group));
+        // Return a new client instance with updated configuration
+        return new MarketOrderServiceWeb(...newOpts);
     }
     /**
      * Retrieves a market order.
@@ -65,7 +134,14 @@ class MarketOrderServiceWeb {
      */
     getMarketOrder(request) {
         // Validate request
-        (0, validation_1.validateRequest)(request);
+        const result = this._validator.validate(service_pb_2.GetMarketOrderRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
         return this._client.getMarketOrder(request);
     }
 }

package/dist/meshtrade/wallet/account/v1/account_pb.d.ts

@@ -40,6 +40,14 @@ export type Account = Message<"meshtrade.wallet.account.v1.Account"> & {
      * @generated from field: string owner = 2;
      */
     owner: string;
+    /**
+     *
+     * Ownership hiearchy of groups that have access to this resource in the format groups/{group_id}.
+     * System set on creation.
+     *
+     * @generated from field: repeated string owners = 3;
+     */
+    owners: string[];
     /**
      *
      * The Unique Mesh Account Number for simplified account identification.

package/dist/meshtrade/wallet/account/v1/account_pb.js

@@ -14,7 +14,7 @@ const ledger_pb_1 = require("../../../type/v1/ledger_pb");
 /**
  * Describes the file meshtrade/wallet/account/v1/account.proto.
  */
-exports.file_meshtrade_wallet_account_v1_account = (0, codegenv2_1.fileDesc)("CiltZXNodHJhZGUvd2FsbGV0L2FjY291bnQvdjEvYWNjb3VudC5wcm90bxIbbWVzaHRyYWRlLndhbGxldC5hY2NvdW50LnYxIqAGCgdBY2NvdW50EroBCgRuYW1lGAEgASgJQqsBukinAboBowEKFG5hbWUuZm9ybWF0Lm9wdGlvbmFsEjVuYW1lIG11c3QgYmUgZW1wdHkgb3IgaW4gdGhlIGZvcm1hdCBhY2NvdW50cy97VUxJRHYyfRpUc2l6ZSh0aGlzKSA9PSAwIHx8IHRoaXMubWF0Y2hlcygnXmFjY291bnRzL1swMTIzNDU2Nzg5QUJDREVGR0hKS01OUFFSU1RWV1hZWl17MjZ9JCcpEksKBW93bmVyGAIgASgJQjy6SDnIAQFyNDIvXmdyb3Vwcy9bMDEyMzQ1Njc4OUFCQ0RFRkdISktNTlBRUlNUVldYWVpdezI2fSSYASESowEKBm51bWJlchgFIAEoCUKSAbpIjgG6AYoBChZudW1iZXIuZm9ybWF0Lm9wdGlvbmFsEkBudW1iZXIgbXVzdCBiZSBlbXB0eSBvciBhIDctZGlnaXQgYWNjb3VudCBudW1iZXIgc3RhcnRpbmcgd2l0aCAxGi5zaXplKHRoaXMpID09IDAgfHwgdGhpcy5tYXRjaGVzKCdeMVswLTldezZ9JCcpEhsKCWxlZGdlcl9pZBgGIAEoCUIIukgFcgMY/wESOAoGbGVkZ2VyGAcgASgOMhkubWVzaHRyYWRlLnR5cGUudjEuTGVkZ2VyQg26SArIAQGCAQQQASAAEiMKDGRpc3BsYXlfbmFtZRgIIAEoCUINukgKyAEBcgUQARj/ARI6ChZsaXZlX2RhdGFfcmV0cmlldmVkX2F0GAkgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI4CgVzdGF0ZRgKIAEoDjIpLm1lc2h0cmFkZS53YWxsZXQuYWNjb3VudC52MS5BY2NvdW50U3RhdGUSNgoIYmFsYW5jZXMYCyADKAsyJC5tZXNodHJhZGUud2FsbGV0LmFjY291bnQudjEuQmFsYW5jZRI7CgtzaWduYXRvcmllcxgMIAMoCzImLm1lc2h0cmFkZS53YWxsZXQuYWNjb3VudC52MS5TaWduYXRvcnkilAEKEkluc3RydW1lbnRNZXRhRGF0YRIMCgRuYW1lGAEgASgJEjwKBHR5cGUYAiABKA4yLi5tZXNodHJhZGUuc3R1ZGlvLmluc3RydW1lbnQudjEuSW5zdHJ1bWVudFR5cGUSMgoEdW5pdBgDIAEoDjIkLm1lc2h0cmFkZS5zdHVkaW8uaW5zdHJ1bWVudC52MS5Vbml0IoIBCgdCYWxhbmNlEikKBmFtb3VudBgBIAEoCzIZLm1lc2h0cmFkZS50eXBlLnYxLkFtb3VudBJMChNpbnN0cnVtZW50X21ldGFkYXRhGAIgASgLMi8ubWVzaHRyYWRlLndhbGxldC5hY2NvdW50LnYxLkluc3RydW1lbnRNZXRhRGF0YSI+CglTaWduYXRvcnkSFAoMZGlzcGxheV9uYW1lGAEgASgJEhsKCWxlZGdlcl9pZBgCIAEoCUIIukgFcgMY/wEqXwoMQWNjb3VudFN0YXRlEh0KGUFDQ09VTlRfU1RBVEVfVU5TUEVDSUZJRUQQABIYChRBQ0NPVU5UX1NUQVRFX0NMT1NFRBABEhYKEkFDQ09VTlRfU1RBVEVfT1BFThACQl4KImNvLm1lc2h0cmFkZS5hcGkud2FsbGV0LmFjY291bnQudjFaOGdpdGh1Yi5jb20vbWVzaHRyYWRlL2FwaS9nby93YWxsZXQvYWNjb3VudC92MTthY2NvdW50X3YxYgZwcm90bzM", [validate_pb_1.file_buf_validate_validate, wkt_1.file_google_protobuf_timestamp, instrument_type_pb_1.file_meshtrade_studio_instrument_v1_instrument_type, unit_pb_1.file_meshtrade_studio_instrument_v1_unit, amount_pb_1.file_meshtrade_type_v1_amount, ledger_pb_1.file_meshtrade_type_v1_ledger]);
+exports.file_meshtrade_wallet_account_v1_account = (0, codegenv2_1.fileDesc)("CiltZXNodHJhZGUvd2FsbGV0L2FjY291bnQvdjEvYWNjb3VudC5wcm90bxIbbWVzaHRyYWRlLndhbGxldC5hY2NvdW50LnYxIvAGCgdBY2NvdW50EroBCgRuYW1lGAEgASgJQqsBukinAboBowEKFG5hbWUuZm9ybWF0Lm9wdGlvbmFsEjVuYW1lIG11c3QgYmUgZW1wdHkgb3IgaW4gdGhlIGZvcm1hdCBhY2NvdW50cy97VUxJRHYyfRpUc2l6ZSh0aGlzKSA9PSAwIHx8IHRoaXMubWF0Y2hlcygnXmFjY291bnRzL1swMTIzNDU2Nzg5QUJDREVGR0hKS01OUFFSU1RWV1hZWl17MjZ9JCcpEksKBW93bmVyGAIgASgJQjy6SDnIAQFyNDIvXmdyb3Vwcy9bMDEyMzQ1Njc4OUFCQ0RFRkdISktNTlBRUlNUVldYWVpdezI2fSSYASESTgoGb3duZXJzGAMgAygJQj66SDuSATgiNnI0Mi9eZ3JvdXBzL1swMTIzNDU2Nzg5QUJDREVGR0hKS01OUFFSU1RWV1hZWl17MjZ9JJgBIRKjAQoGbnVtYmVyGAUgASgJQpIBukiOAboBigEKFm51bWJlci5mb3JtYXQub3B0aW9uYWwSQG51bWJlciBtdXN0IGJlIGVtcHR5IG9yIGEgNy1kaWdpdCBhY2NvdW50IG51bWJlciBzdGFydGluZyB3aXRoIDEaLnNpemUodGhpcykgPT0gMCB8fCB0aGlzLm1hdGNoZXMoJ14xWzAtOV17Nn0kJykSGwoJbGVkZ2VyX2lkGAYgASgJQgi6SAVyAxj/ARI4CgZsZWRnZXIYByABKA4yGS5tZXNodHJhZGUudHlwZS52MS5MZWRnZXJCDbpICsgBAYIBBBABIAASIwoMZGlzcGxheV9uYW1lGAggASgJQg26SArIAQFyBRABGP8BEjoKFmxpdmVfZGF0YV9yZXRyaWV2ZWRfYXQYCSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjgKBXN0YXRlGAogASgOMikubWVzaHRyYWRlLndhbGxldC5hY2NvdW50LnYxLkFjY291bnRTdGF0ZRI2CghiYWxhbmNlcxgLIAMoCzIkLm1lc2h0cmFkZS53YWxsZXQuYWNjb3VudC52MS5CYWxhbmNlEjsKC3NpZ25hdG9yaWVzGAwgAygLMiYubWVzaHRyYWRlLndhbGxldC5hY2NvdW50LnYxLlNpZ25hdG9yeSKUAQoSSW5zdHJ1bWVudE1ldGFEYXRhEgwKBG5hbWUYASABKAkSPAoEdHlwZRgCIAEoDjIuLm1lc2h0cmFkZS5zdHVkaW8uaW5zdHJ1bWVudC52MS5JbnN0cnVtZW50VHlwZRIyCgR1bml0GAMgASgOMiQubWVzaHRyYWRlLnN0dWRpby5pbnN0cnVtZW50LnYxLlVuaXQiggEKB0JhbGFuY2USKQoGYW1vdW50GAEgASgLMhkubWVzaHRyYWRlLnR5cGUudjEuQW1vdW50EkwKE2luc3RydW1lbnRfbWV0YWRhdGEYAiABKAsyLy5tZXNodHJhZGUud2FsbGV0LmFjY291bnQudjEuSW5zdHJ1bWVudE1ldGFEYXRhIj4KCVNpZ25hdG9yeRIUCgxkaXNwbGF5X25hbWUYASABKAkSGwoJbGVkZ2VyX2lkGAIgASgJQgi6SAVyAxj/ASpfCgxBY2NvdW50U3RhdGUSHQoZQUNDT1VOVF9TVEFURV9VTlNQRUNJRklFRBAAEhgKFEFDQ09VTlRfU1RBVEVfQ0xPU0VEEAESFgoSQUNDT1VOVF9TVEFURV9PUEVOEAJCXgoiY28ubWVzaHRyYWRlLmFwaS53YWxsZXQuYWNjb3VudC52MVo4Z2l0aHViLmNvbS9tZXNodHJhZGUvYXBpL2dvL3dhbGxldC9hY2NvdW50L3YxO2FjY291bnRfdjFiBnByb3RvMw", [validate_pb_1.file_buf_validate_validate, wkt_1.file_google_protobuf_timestamp, instrument_type_pb_1.file_meshtrade_studio_instrument_v1_instrument_type, unit_pb_1.file_meshtrade_studio_instrument_v1_unit, amount_pb_1.file_meshtrade_type_v1_amount, ledger_pb_1.file_meshtrade_type_v1_ledger]);
 /**
  * Describes the message meshtrade.wallet.account.v1.Account.
  * Use `create(AccountSchema)` to create a new message.

package/dist/meshtrade/wallet/account/v1/service_web_meshts.d.ts

@@ -1,30 +1,85 @@
-import { Interceptor } from "@connectrpc/connect";
 import { AddSignatoriesToAccountRequest, AddSignatoriesToAccountResponse, CreateAccountRequest, GetAccountByNumberRequest, GetAccountRequest, ListAccountsRequest, ListAccountsResponse, OpenAccountRequest, OpenAccountResponse, RemoveSignatoriesFromAccountRequest, RemoveSignatoriesFromAccountResponse, SearchAccountsRequest, SearchAccountsResponse, UpdateAccountRequest } from "./service_pb";
 import { Account } from "./account_pb";
-import { ConfigOpts } from "../../../common/config";
+import { ClientOption } from "../../../config";
 /**
  * Web client for interacting with the meshtrade.wallet.account.v1 account v1 API resource service.
- * Uses Connect-ES with gRPC-Web transport for browser-compatible gRPC communication.
+ * Uses Connect-ES with gRPC-Web transport for browser-based communication.
+ *
+ * Supports flexible authentication modes using functional options pattern:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new AccountServiceWeb(
+ *      WithServerUrl("http://localhost:10000")
+ *    );
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new AccountServiceWeb(
+ *      WithAPIKey("your-api-key"),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js frontend with user session):
+ *    ```typescript
+ *    const client = new AccountServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 4. **JWT with Group Context** (user session with specific group):
+ *    ```typescript
+ *    const client = new AccountServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * Available options:
+ * - `WithAPIKey(key)` - API key authentication (mutually exclusive with JWT)
+ * - `WithJWTAccessToken(token)` - JWT authentication (mutually exclusive with API key)
+ * - `WithGroup(group)` - Group context (optional, works with both auth modes)
+ * - `WithServerUrl(url)` - Custom server URL (optional, defaults to production)
  */
 export declare class AccountServiceWeb {
     private _client;
     private readonly _config;
     private readonly _interceptors;
+    private readonly _validator;
     /**
      * Constructs an instance of AccountServiceWeb.
-     * @param {ConfigOpts} [config] - Optional configuration for the client.
-     * @param {Interceptor[]} [interceptors] - For internal use by `withGroup`.
+     *
+     * Uses functional options pattern for flexible configuration:
+     * - `WithAPIKey(key)` - API key authentication
+     * - `WithJWTAccessToken(token)` - JWT authentication
+     * - `WithGroup(group)` - Group context (optional)
+     * - `WithServerUrl(url)` - Custom server URL (optional)
+     *
+     * @param {...ClientOption} opts - Variable number of configuration options
      */
-    constructor(config?: ConfigOpts, interceptors?: Interceptor[]);
+    constructor(...opts: ClientOption[]);
     /**
      * Returns a new client instance configured to send the specified group
      * resource name in the request headers for subsequent API calls.
      *
+     * This method creates a new client with the same authentication configuration
+     * but with the group context updated to the specified value.
+     *
+     * **Compatibility**: Works with all authentication modes:
+     * - **API key auth**: Creates new client with API key + new group
+     * - **JWT auth**: Creates new client with JWT + new group
+     * - **No auth**: Creates new client with standalone group interceptor
+     *
      * @param {string} group - The operating group context to inject into the request
      *                         in the format `groups/{ulid}` where {ulid} is a 26-character ULID.
      *                         Example: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
      * @returns {AccountServiceWeb} A new, configured instance of the client.
-     * @throws {Error} If the group format is invalid (validation occurs in createGroupInterceptor)
+     * @throws {Error} If the group format is invalid
      */
     withGroup(group: string): AccountServiceWeb;
     /**