hs-playlib 0.2.0 → 0.3.0

package/dist/src/index.js

@@ -24,7 +24,7 @@ __exportStar(require("./payments/generated/proto"), exports);
 // ---------------------------------------------------------------------------
 // Domain namespaces — runtime values
 // Usage: import { payments, payment_methods, configs } from '@juspay/connector-service-sdk';
-//        const identity: configs.IClientIdentity = { ... };
+//        const config: configs.IConnectorConfig = { ... };
 //        const client = new ConnectorClient(identity);
 // ---------------------------------------------------------------------------
 //# sourceMappingURL=index.js.map

package/dist/src/payments/_generated_connector_client_flows.d.ts

@@ -2,49 +2,49 @@ import { ConnectorClient as _ConnectorClientBase } from "./connector_client";
 import { types } from "./generated/proto";
 export declare class CustomerClient extends _ConnectorClientBase {
     /** CustomerService.Create — Create customer record in the payment processor system. Stores customer details for future payment operations without re-sending personal information. */
-    create(requestMsg: types.ICustomerServiceCreateRequest, options?: types.IConfigOptions | null): Promise<types.CustomerServiceCreateResponse>;
+    create(requestMsg: types.ICustomerServiceCreateRequest, options?: types.IRequestConfig | null): Promise<types.CustomerServiceCreateResponse>;
 }
 export declare class EventClient extends _ConnectorClientBase {
     /** EventService.HandleEvent — Process webhook notifications from connectors. Translates connector events into standardized responses for asynchronous payment state updates. */
-    handleEvent(requestMsg: types.IEventServiceHandleRequest, options?: types.IConfigOptions | null): Promise<types.EventServiceHandleResponse>;
+    handleEvent(requestMsg: types.IEventServiceHandleRequest, options?: types.IRequestConfig | null): Promise<types.EventServiceHandleResponse>;
 }
 export declare class MerchantAuthenticationClient extends _ConnectorClientBase {
     /** MerchantAuthenticationService.CreateAccessToken — Generate short-lived connector authentication token. Provides secure credentials for connector API access without storing secrets client-side. */
-    createAccessToken(requestMsg: types.IMerchantAuthenticationServiceCreateAccessTokenRequest, options?: types.IConfigOptions | null): Promise<types.MerchantAuthenticationServiceCreateAccessTokenResponse>;
+    createAccessToken(requestMsg: types.IMerchantAuthenticationServiceCreateAccessTokenRequest, options?: types.IRequestConfig | null): Promise<types.MerchantAuthenticationServiceCreateAccessTokenResponse>;
     /** MerchantAuthenticationService.CreateSessionToken — Create session token for payment processing. Maintains session state across multiple payment operations for improved security and tracking. */
-    createSessionToken(requestMsg: types.IMerchantAuthenticationServiceCreateSessionTokenRequest, options?: types.IConfigOptions | null): Promise<types.MerchantAuthenticationServiceCreateSessionTokenResponse>;
+    createSessionToken(requestMsg: types.IMerchantAuthenticationServiceCreateSessionTokenRequest, options?: types.IRequestConfig | null): Promise<types.MerchantAuthenticationServiceCreateSessionTokenResponse>;
 }
 export declare class PaymentMethodAuthenticationClient extends _ConnectorClientBase {
     /** PaymentMethodAuthenticationService.Authenticate — Execute 3DS challenge or frictionless verification. Authenticates customer via bank challenge or behind-the-scenes verification for fraud prevention. */
-    authenticate(requestMsg: types.IPaymentMethodAuthenticationServiceAuthenticateRequest, options?: types.IConfigOptions | null): Promise<types.PaymentMethodAuthenticationServiceAuthenticateResponse>;
+    authenticate(requestMsg: types.IPaymentMethodAuthenticationServiceAuthenticateRequest, options?: types.IRequestConfig | null): Promise<types.PaymentMethodAuthenticationServiceAuthenticateResponse>;
     /** PaymentMethodAuthenticationService.PostAuthenticate — Validate authentication results with the issuing bank. Processes bank's authentication decision to determine if payment can proceed. */
-    postAuthenticate(requestMsg: types.IPaymentMethodAuthenticationServicePostAuthenticateRequest, options?: types.IConfigOptions | null): Promise<types.PaymentMethodAuthenticationServicePostAuthenticateResponse>;
+    postAuthenticate(requestMsg: types.IPaymentMethodAuthenticationServicePostAuthenticateRequest, options?: types.IRequestConfig | null): Promise<types.PaymentMethodAuthenticationServicePostAuthenticateResponse>;
     /** PaymentMethodAuthenticationService.PreAuthenticate — Initiate 3DS flow before payment authorization. Collects device data and prepares authentication context for frictionless or challenge-based verification. */
-    preAuthenticate(requestMsg: types.IPaymentMethodAuthenticationServicePreAuthenticateRequest, options?: types.IConfigOptions | null): Promise<types.PaymentMethodAuthenticationServicePreAuthenticateResponse>;
+    preAuthenticate(requestMsg: types.IPaymentMethodAuthenticationServicePreAuthenticateRequest, options?: types.IRequestConfig | null): Promise<types.PaymentMethodAuthenticationServicePreAuthenticateResponse>;
 }
 export declare class PaymentMethodClient extends _ConnectorClientBase {
     /** PaymentMethodService.Tokenize — Tokenize payment method for secure storage. Replaces raw card details with secure token for one-click payments and recurring billing. */
-    tokenize(requestMsg: types.IPaymentMethodServiceTokenizeRequest, options?: types.IConfigOptions | null): Promise<types.PaymentMethodServiceTokenizeResponse>;
+    tokenize(requestMsg: types.IPaymentMethodServiceTokenizeRequest, options?: types.IRequestConfig | null): Promise<types.PaymentMethodServiceTokenizeResponse>;
 }
 export declare class PaymentClient extends _ConnectorClientBase {
     /** PaymentService.Authorize — Authorize a payment amount on a payment method. This reserves funds without capturing them, essential for verifying availability before finalizing. */
-    authorize(requestMsg: types.IPaymentServiceAuthorizeRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceAuthorizeResponse>;
+    authorize(requestMsg: types.IPaymentServiceAuthorizeRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceAuthorizeResponse>;
     /** PaymentService.Capture — Finalize an authorized payment transaction. Transfers reserved funds from customer to merchant account, completing the payment lifecycle. */
-    capture(requestMsg: types.IPaymentServiceCaptureRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceCaptureResponse>;
+    capture(requestMsg: types.IPaymentServiceCaptureRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceCaptureResponse>;
     /** PaymentService.CreateOrder — Initialize an order in the payment processor system. Sets up payment context before customer enters card details for improved authorization rates. */
-    createOrder(requestMsg: types.IPaymentServiceCreateOrderRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceCreateOrderResponse>;
+    createOrder(requestMsg: types.IPaymentServiceCreateOrderRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceCreateOrderResponse>;
     /** PaymentService.Get — Retrieve current payment status from the payment processor. Enables synchronization between your system and payment processors for accurate state tracking. */
-    get(requestMsg: types.IPaymentServiceGetRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceGetResponse>;
+    get(requestMsg: types.IPaymentServiceGetRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceGetResponse>;
     /** PaymentService.Refund — Initiate a refund to customer's payment method. Returns funds for returns, cancellations, or service adjustments after original payment. */
-    refund(requestMsg: types.IPaymentServiceRefundRequest, options?: types.IConfigOptions | null): Promise<types.RefundResponse>;
+    refund(requestMsg: types.IPaymentServiceRefundRequest, options?: types.IRequestConfig | null): Promise<types.RefundResponse>;
     /** PaymentService.Reverse — Reverse a captured payment before settlement. Recovers funds after capture but before bank settlement, used for corrections or cancellations. */
-    reverse(requestMsg: types.IPaymentServiceReverseRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceReverseResponse>;
+    reverse(requestMsg: types.IPaymentServiceReverseRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceReverseResponse>;
     /** PaymentService.SetupRecurring — Setup a recurring payment instruction for future payments/ debits. This could be for SaaS subscriptions, monthly bill payments, insurance payments and similar use cases. */
-    setupRecurring(requestMsg: types.IPaymentServiceSetupRecurringRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceSetupRecurringResponse>;
+    setupRecurring(requestMsg: types.IPaymentServiceSetupRecurringRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceSetupRecurringResponse>;
     /** PaymentService.Void — Cancel an authorized payment before capture. Releases held funds back to customer, typically used when orders are cancelled or abandoned. */
-    void(requestMsg: types.IPaymentServiceVoidRequest, options?: types.IConfigOptions | null): Promise<types.PaymentServiceVoidResponse>;
+    void(requestMsg: types.IPaymentServiceVoidRequest, options?: types.IRequestConfig | null): Promise<types.PaymentServiceVoidResponse>;
 }
 export declare class RecurringPaymentClient extends _ConnectorClientBase {
     /** RecurringPaymentService.Charge — Charge using an existing stored recurring payment instruction. Processes repeat payments for subscriptions or recurring billing without collecting payment details. */
-    charge(requestMsg: types.IRecurringPaymentServiceChargeRequest, options?: types.IConfigOptions | null): Promise<types.RecurringPaymentServiceChargeResponse>;
+    charge(requestMsg: types.IRecurringPaymentServiceChargeRequest, options?: types.IRequestConfig | null): Promise<types.RecurringPaymentServiceChargeResponse>;
 }

package/dist/src/payments/connector_client.d.ts

@@ -14,19 +14,19 @@
 import { types } from "./generated/proto";
 export declare class ConnectorClient {
     private uniffi;
-    private identity;
+    private config;
     private defaults;
     private dispatcher;
     /**
-     * Initialize the client with mandatory identity and overridable defaults.
+     * Initialize the client with mandatory config and optional request defaults.
      *
-     * @param identity - Non-overridable (Connector, Auth).
-     * @param defaults - Overridable behavioral settings (Environment, Http).
+     * @param config - Immutable connector identity and environment (Connector, Auth, Environment).
+     * @param defaults - Optional per-request defaults (Http, Vault).
      * @param libPath - optional path to the UniFFI shared library.
      */
-    constructor(identity: types.IClientIdentity, defaults?: types.IConfigOptions, libPath?: string);
+    constructor(config: types.IConnectorConfig, defaults?: types.IRequestConfig, libPath?: string);
     /**
-     * Merges request-level options with client defaults.
+     * Merges request-level options with client defaults. Environment comes from config (immutable).
      */
     private _resolveConfig;
     /**
@@ -36,10 +36,10 @@ export declare class ConnectorClient {
      * @param requestMsg - Protobuf request message object.
      * @param options - Optional ConfigOptions override (Environment, Http).
      */
-    _executeFlow(flow: string, requestMsg: object, options?: types.IConfigOptions | null, reqTypeName?: string, resTypeName?: string): Promise<unknown>;
+    _executeFlow(flow: string, requestMsg: object, options?: types.IRequestConfig | null, reqTypeName?: string, resTypeName?: string): Promise<unknown>;
     /**
      * Execute a single-step flow directly via FFI (no HTTP round-trip).
      * Used for inbound flows like webhook processing where the connector sends data to us.
      */
-    _executeDirect(flow: string, requestMsg: object, options?: types.IConfigOptions | null, reqTypeName?: string, resTypeName?: string): Promise<unknown>;
+    _executeDirect(flow: string, requestMsg: object, options?: types.IRequestConfig | null, reqTypeName?: string, resTypeName?: string): Promise<unknown>;
 }

package/dist/src/payments/connector_client.js

@@ -21,32 +21,31 @@ const proto_1 = require("./generated/proto");
 const v2 = proto_1.types;
 class ConnectorClient {
     uniffi;
-    identity;
+    config;
     defaults;
     dispatcher;
     /**
-     * Initialize the client with mandatory identity and overridable defaults.
+     * Initialize the client with mandatory config and optional request defaults.
      *
-     * @param identity - Non-overridable (Connector, Auth).
-     * @param defaults - Overridable behavioral settings (Environment, Http).
+     * @param config - Immutable connector identity and environment (Connector, Auth, Environment).
+     * @param defaults - Optional per-request defaults (Http, Vault).
      * @param libPath - optional path to the UniFFI shared library.
      */
-    constructor(identity, defaults = {}, libPath) {
+    constructor(config, defaults = {}, libPath) {
         this.uniffi = new uniffi_client_1.UniffiClient(libPath);
-        this.identity = proto_1.types.ClientIdentity.create(identity);
+        this.config = proto_1.types.ConnectorConfig.create(config);
         this.defaults = defaults;
-        if (identity.connector === undefined) {
-            throw new http_client_1.ConnectorError("Connector is required in ClientIdentity", 400, "CLIENT_INITIALIZATION");
+        if (config.connector === undefined) {
+            throw new http_client_1.ConnectorError("Connector is required in ConnectorConfig", 400, "CLIENT_INITIALIZATION");
         }
         // Instance-level cache: create the primary connection pool at startup
         this.dispatcher = (0, http_client_1.createDispatcher)(defaults.http || {});
     }
     /**
-     * Merges request-level options with client defaults.
+     * Merges request-level options with client defaults. Environment comes from config (immutable).
      */
     _resolveConfig(overrides) {
         const opt = overrides || {};
-        const environment = opt.environment ?? this.defaults.environment ?? proto_1.types.Environment.SANDBOX;
         const clientHttp = this.defaults.http || {};
         const overrideHttp = opt.http || {};
         const http = {
@@ -58,9 +57,9 @@ class ConnectorClient {
             caCert: overrideHttp.caCert ?? clientHttp.caCert,
         };
         const ffi = proto_1.types.FfiOptions.create({
-            environment,
-            connector: this.identity.connector,
-            auth: this.identity.auth,
+            environment: this.config.environment ?? proto_1.types.Environment.SANDBOX,
+            connector: this.config.connector,
+            auth: this.config.auth,
         });
         return { ffi, http };
     }

package/dist/src/payments/generated/proto.d.ts

@@ -18392,8 +18392,8 @@ export namespace types {
     }
 
     /**
-     * ConnectorAuth message with oneof containing all 70 auth types
-     * Ordered to match Connector enum order
+     * ConnectorAuth message with oneof containing all auth types.
+     * Comment above each field (e.g. "// PAYPAL = 62") is the Connector enum value from this file;
      */
     class ConnectorAuth implements IConnectorAuth {
 
@@ -27115,27 +27115,30 @@ export namespace types {
         PRODUCTION = 1
     }
 
-    /** Properties of a ClientIdentity. */
-    interface IClientIdentity {
+    /** Properties of a ConnectorConfig. */
+    interface IConnectorConfig {
 
         /** The connector to use for all requests (Immutable) */
         connector?: (types.Connector|null);
 
         /** Mandatory authentication for the connector (Immutable) */
         auth?: (types.IConnectorAuth|null);
+
+        /** Primary deployment environment (Immutable) */
+        environment?: (types.Environment|null);
     }
 
     /**
-     * Non-overridable identity parameters for the ConnectorClient.
+     * Immutable parameters for the ConnectorClient.
      * Passed as the FIRST parameter during client creation.
      */
-    class ClientIdentity implements IClientIdentity {
+    class ConnectorConfig implements IConnectorConfig {
 
         /**
-         * Constructs a new ClientIdentity.
+         * Constructs a new ConnectorConfig.
          * @param [properties] Properties to set
          */
-        constructor(properties?: types.IClientIdentity);
+        constructor(properties?: types.IConnectorConfig);
 
         /** The connector to use for all requests (Immutable) */
         public connector: types.Connector;
@@ -27143,51 +27146,51 @@ export namespace types {
         /** Mandatory authentication for the connector (Immutable) */
         public auth?: (types.IConnectorAuth|null);
 
+        /** Primary deployment environment (Immutable) */
+        public environment: types.Environment;
+
         /**
-         * Creates a new ClientIdentity instance using the specified properties.
+         * Creates a new ConnectorConfig instance using the specified properties.
          * @param [properties] Properties to set
-         * @returns ClientIdentity instance
+         * @returns ConnectorConfig instance
          */
-        public static create(properties?: types.IClientIdentity): types.ClientIdentity;
+        public static create(properties?: types.IConnectorConfig): types.ConnectorConfig;
 
         /**
-         * Encodes the specified ClientIdentity message. Does not implicitly {@link types.ClientIdentity.verify|verify} messages.
-         * @param message ClientIdentity message or plain object to encode
+         * Encodes the specified ConnectorConfig message. Does not implicitly {@link types.ConnectorConfig.verify|verify} messages.
+         * @param message ConnectorConfig message or plain object to encode
          * @param [writer] Writer to encode to
          * @returns Writer
          */
-        public static encode(message: types.IClientIdentity, writer?: $protobuf.Writer): $protobuf.Writer;
+        public static encode(message: types.IConnectorConfig, writer?: $protobuf.Writer): $protobuf.Writer;
 
         /**
-         * Decodes a ClientIdentity message from the specified reader or buffer.
+         * Decodes a ConnectorConfig message from the specified reader or buffer.
          * @param reader Reader or buffer to decode from
          * @param [length] Message length if known beforehand
-         * @returns ClientIdentity
+         * @returns ConnectorConfig
          * @throws {Error} If the payload is not a reader or valid buffer
          * @throws {$protobuf.util.ProtocolError} If required fields are missing
          */
-        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): types.ClientIdentity;
+        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): types.ConnectorConfig;
 
         /**
-         * Verifies a ClientIdentity message.
+         * Verifies a ConnectorConfig message.
          * @param message Plain object to verify
          * @returns `null` if valid, otherwise the reason why it is not
          */
         public static verify(message: { [k: string]: any }): (string|null);
 
         /**
-         * Gets the default type url for ClientIdentity
+         * Gets the default type url for ConnectorConfig
          * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
          * @returns The default type url
          */
         public static getTypeUrl(typeUrlPrefix?: string): string;
     }
 
-    /** Properties of a ConfigOptions. */
-    interface IConfigOptions {
-
-        /** Deployment environment */
-        environment?: (types.Environment|null);
+    /** Properties of a RequestConfig. */
+    interface IRequestConfig {
 
         /** HTTP and transport configuration */
         http?: (types.IHttpConfig|null);
@@ -27196,21 +27199,14 @@ export namespace types {
         vault?: (types.IVaultOptions|null);
     }
 
-    /**
-     * Overridable parameters for the SDK behavior.
-     * Used as the SECOND parameter in initialization (defaults)
-     * and as the parameter for request-level overrides.
-     */
-    class ConfigOptions implements IConfigOptions {
+    /** Overridable parameters for individual SDK calls. */
+    class RequestConfig implements IRequestConfig {
 
         /**
-         * Constructs a new ConfigOptions.
+         * Constructs a new RequestConfig.
          * @param [properties] Properties to set
          */
-        constructor(properties?: types.IConfigOptions);
-
-        /** Deployment environment */
-        public environment?: (types.Environment|null);
+        constructor(properties?: types.IRequestConfig);
 
         /** HTTP and transport configuration */
         public http?: (types.IHttpConfig|null);
@@ -27219,39 +27215,39 @@ export namespace types {
         public vault?: (types.IVaultOptions|null);
 
         /**
-         * Creates a new ConfigOptions instance using the specified properties.
+         * Creates a new RequestConfig instance using the specified properties.
          * @param [properties] Properties to set
-         * @returns ConfigOptions instance
+         * @returns RequestConfig instance
          */
-        public static create(properties?: types.IConfigOptions): types.ConfigOptions;
+        public static create(properties?: types.IRequestConfig): types.RequestConfig;
 
         /**
-         * Encodes the specified ConfigOptions message. Does not implicitly {@link types.ConfigOptions.verify|verify} messages.
-         * @param message ConfigOptions message or plain object to encode
+         * Encodes the specified RequestConfig message. Does not implicitly {@link types.RequestConfig.verify|verify} messages.
+         * @param message RequestConfig message or plain object to encode
          * @param [writer] Writer to encode to
          * @returns Writer
          */
-        public static encode(message: types.IConfigOptions, writer?: $protobuf.Writer): $protobuf.Writer;
+        public static encode(message: types.IRequestConfig, writer?: $protobuf.Writer): $protobuf.Writer;
 
         /**
-         * Decodes a ConfigOptions message from the specified reader or buffer.
+         * Decodes a RequestConfig message from the specified reader or buffer.
          * @param reader Reader or buffer to decode from
          * @param [length] Message length if known beforehand
-         * @returns ConfigOptions
+         * @returns RequestConfig
          * @throws {Error} If the payload is not a reader or valid buffer
          * @throws {$protobuf.util.ProtocolError} If required fields are missing
          */
-        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): types.ConfigOptions;
+        public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): types.RequestConfig;
 
         /**
-         * Verifies a ConfigOptions message.
+         * Verifies a RequestConfig message.
          * @param message Plain object to verify
          * @returns `null` if valid, otherwise the reason why it is not
          */
         public static verify(message: { [k: string]: any }): (string|null);
 
         /**
-         * Gets the default type url for ConfigOptions
+         * Gets the default type url for RequestConfig
          * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
          * @returns The default type url
          */
@@ -27280,10 +27276,7 @@ export namespace types {
         caCert?: (types.ICaCert|null);
     }
 
-    /**
-     * HTTP transport configuration.
-     * Flattened for cleaner access and merging logic across SDKs.
-     */
+    /** HTTP transport configuration. */
     class HttpConfig implements IHttpConfig {
 
         /**
@@ -27545,10 +27538,10 @@ export namespace types {
     /** Properties of a FfiOptions. */
     interface IFfiOptions {
 
-        /** Environment context for config lookup */
+        /** Resolved environment context */
         environment?: (types.Environment|null);
 
-        /** Connector context for logic selection */
+        /** Resolved connector context */
         connector?: (types.Connector|null);
 
         /** Credentials needed to build auth headers/payloads */
@@ -27564,10 +27557,10 @@ export namespace types {
          */
         constructor(properties?: types.IFfiOptions);
 
-        /** Environment context for config lookup */
+        /** Resolved environment context */
         public environment: types.Environment;
 
-        /** Connector context for logic selection */
+        /** Resolved connector context */
         public connector: types.Connector;
 
         /** Credentials needed to build auth headers/payloads */

package/dist/src/payments/generated/proto.js

@@ -54652,8 +54652,8 @@ $root.types = (function() {
         /**
          * Constructs a new ConnectorAuth.
          * @memberof types
-         * @classdesc ConnectorAuth message with oneof containing all 70 auth types
-         * Ordered to match Connector enum order
+         * @classdesc ConnectorAuth message with oneof containing all auth types.
+         * Comment above each field (e.g. "// PAYPAL = 62") is the Connector enum value from this file;
          * @implements IConnectorAuth
          * @constructor
          * @param {types.IConnectorAuth=} [properties] Properties to set
@@ -80657,26 +80657,27 @@ $root.types = (function() {
         return values;
     })();
 
-    types.ClientIdentity = (function() {
+    types.ConnectorConfig = (function() {
 
         /**
-         * Properties of a ClientIdentity.
+         * Properties of a ConnectorConfig.
          * @memberof types
-         * @interface IClientIdentity
+         * @interface IConnectorConfig
          * @property {types.Connector|null} [connector] The connector to use for all requests (Immutable)
          * @property {types.IConnectorAuth|null} [auth] Mandatory authentication for the connector (Immutable)
+         * @property {types.Environment|null} [environment] Primary deployment environment (Immutable)
          */
 
         /**
-         * Constructs a new ClientIdentity.
+         * Constructs a new ConnectorConfig.
          * @memberof types
-         * @classdesc Non-overridable identity parameters for the ConnectorClient.
+         * @classdesc Immutable parameters for the ConnectorClient.
          * Passed as the FIRST parameter during client creation.
-         * @implements IClientIdentity
+         * @implements IConnectorConfig
          * @constructor
-         * @param {types.IClientIdentity=} [properties] Properties to set
+         * @param {types.IConnectorConfig=} [properties] Properties to set
          */
-        function ClientIdentity(properties) {
+        function ConnectorConfig(properties) {
             if (properties)
                 for (var keys = Object.keys(properties), i = 0; i < keys.length; ++i)
                     if (properties[keys[i]] != null)
@@ -80686,65 +80687,75 @@ $root.types = (function() {
         /**
          * The connector to use for all requests (Immutable)
          * @member {types.Connector} connector
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @instance
          */
-        ClientIdentity.prototype.connector = 0;
+        ConnectorConfig.prototype.connector = 0;
 
         /**
          * Mandatory authentication for the connector (Immutable)
          * @member {types.IConnectorAuth|null|undefined} auth
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @instance
          */
-        ClientIdentity.prototype.auth = null;
+        ConnectorConfig.prototype.auth = null;
 
         /**
-         * Creates a new ClientIdentity instance using the specified properties.
+         * Primary deployment environment (Immutable)
+         * @member {types.Environment} environment
+         * @memberof types.ConnectorConfig
+         * @instance
+         */
+        ConnectorConfig.prototype.environment = 0;
+
+        /**
+         * Creates a new ConnectorConfig instance using the specified properties.
          * @function create
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @static
-         * @param {types.IClientIdentity=} [properties] Properties to set
-         * @returns {types.ClientIdentity} ClientIdentity instance
+         * @param {types.IConnectorConfig=} [properties] Properties to set
+         * @returns {types.ConnectorConfig} ConnectorConfig instance
          */
-        ClientIdentity.create = function create(properties) {
-            return new ClientIdentity(properties);
+        ConnectorConfig.create = function create(properties) {
+            return new ConnectorConfig(properties);
         };
 
         /**
-         * Encodes the specified ClientIdentity message. Does not implicitly {@link types.ClientIdentity.verify|verify} messages.
+         * Encodes the specified ConnectorConfig message. Does not implicitly {@link types.ConnectorConfig.verify|verify} messages.
          * @function encode
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @static
-         * @param {types.IClientIdentity} message ClientIdentity message or plain object to encode
+         * @param {types.IConnectorConfig} message ConnectorConfig message or plain object to encode
          * @param {$protobuf.Writer} [writer] Writer to encode to
          * @returns {$protobuf.Writer} Writer
          */
-        ClientIdentity.encode = function encode(message, writer) {
+        ConnectorConfig.encode = function encode(message, writer) {
             if (!writer)
                 writer = $Writer.create();
             if (message.connector != null && Object.hasOwnProperty.call(message, "connector"))
                 writer.uint32(/* id 1, wireType 0 =*/8).int32(message.connector);
             if (message.auth != null && Object.hasOwnProperty.call(message, "auth"))
                 $root.types.ConnectorAuth.encode(message.auth, writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim();
+            if (message.environment != null && Object.hasOwnProperty.call(message, "environment"))
+                writer.uint32(/* id 3, wireType 0 =*/24).int32(message.environment);
             return writer;
         };
 
         /**
-         * Decodes a ClientIdentity message from the specified reader or buffer.
+         * Decodes a ConnectorConfig message from the specified reader or buffer.
          * @function decode
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @static
          * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
          * @param {number} [length] Message length if known beforehand
-         * @returns {types.ClientIdentity} ClientIdentity
+         * @returns {types.ConnectorConfig} ConnectorConfig
          * @throws {Error} If the payload is not a reader or valid buffer
          * @throws {$protobuf.util.ProtocolError} If required fields are missing
          */
-        ClientIdentity.decode = function decode(reader, length, error) {
+        ConnectorConfig.decode = function decode(reader, length, error) {
             if (!(reader instanceof $Reader))
                 reader = $Reader.create(reader);
-            var end = length === undefined ? reader.len : reader.pos + length, message = new $root.types.ClientIdentity();
+            var end = length === undefined ? reader.len : reader.pos + length, message = new $root.types.ConnectorConfig();
             while (reader.pos < end) {
                 var tag = reader.uint32();
                 if (tag === error)
@@ -80758,6 +80769,10 @@ $root.types = (function() {
                         message.auth = $root.types.ConnectorAuth.decode(reader, reader.uint32());
                         break;
                     }
+                case 3: {
+                        message.environment = reader.int32();
+                        break;
+                    }
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -80767,14 +80782,14 @@ $root.types = (function() {
         };
 
         /**
-         * Verifies a ClientIdentity message.
+         * Verifies a ConnectorConfig message.
          * @function verify
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @static
          * @param {Object.<string,*>} message Plain object to verify
          * @returns {string|null} `null` if valid, otherwise the reason why it is not
          */
-        ClientIdentity.verify = function verify(message) {
+        ConnectorConfig.verify = function verify(message) {
             if (typeof message !== "object" || message === null)
                 return "object expected";
             if (message.connector != null && message.hasOwnProperty("connector"))
@@ -80899,162 +80914,147 @@ $root.types = (function() {
                 if (error)
                     return "auth." + error;
             }
+            if (message.environment != null && message.hasOwnProperty("environment"))
+                switch (message.environment) {
+                default:
+                    return "environment: enum value expected";
+                case 0:
+                case 1:
+                    break;
+                }
             return null;
         };
 
         /**
-         * Gets the default type url for ClientIdentity
+         * Gets the default type url for ConnectorConfig
          * @function getTypeUrl
-         * @memberof types.ClientIdentity
+         * @memberof types.ConnectorConfig
          * @static
          * @param {string} [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
          * @returns {string} The default type url
          */
-        ClientIdentity.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
+        ConnectorConfig.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
             if (typeUrlPrefix === undefined) {
                 typeUrlPrefix = "type.googleapis.com";
             }
-            return typeUrlPrefix + "/types.ClientIdentity";
+            return typeUrlPrefix + "/types.ConnectorConfig";
         };
 
-        return ClientIdentity;
+        return ConnectorConfig;
     })();
 
-    types.ConfigOptions = (function() {
+    types.RequestConfig = (function() {
 
         /**
-         * Properties of a ConfigOptions.
+         * Properties of a RequestConfig.
          * @memberof types
-         * @interface IConfigOptions
-         * @property {types.Environment|null} [environment] Deployment environment
+         * @interface IRequestConfig
          * @property {types.IHttpConfig|null} [http] HTTP and transport configuration
          * @property {types.IVaultOptions|null} [vault] Vault configuration options (Placeholder)
          */
 
         /**
-         * Constructs a new ConfigOptions.
+         * Constructs a new RequestConfig.
          * @memberof types
-         * @classdesc Overridable parameters for the SDK behavior.
-         * Used as the SECOND parameter in initialization (defaults)
-         * and as the parameter for request-level overrides.
-         * @implements IConfigOptions
+         * @classdesc Overridable parameters for individual SDK calls.
+         * @implements IRequestConfig
          * @constructor
-         * @param {types.IConfigOptions=} [properties] Properties to set
+         * @param {types.IRequestConfig=} [properties] Properties to set
          */
-        function ConfigOptions(properties) {
+        function RequestConfig(properties) {
             if (properties)
                 for (var keys = Object.keys(properties), i = 0; i < keys.length; ++i)
                     if (properties[keys[i]] != null)
                         this[keys[i]] = properties[keys[i]];
         }
 
-        /**
-         * Deployment environment
-         * @member {types.Environment|null|undefined} environment
-         * @memberof types.ConfigOptions
-         * @instance
-         */
-        ConfigOptions.prototype.environment = null;
-
         /**
          * HTTP and transport configuration
          * @member {types.IHttpConfig|null|undefined} http
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @instance
          */
-        ConfigOptions.prototype.http = null;
+        RequestConfig.prototype.http = null;
 
         /**
          * Vault configuration options (Placeholder)
          * @member {types.IVaultOptions|null|undefined} vault
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @instance
          */
-        ConfigOptions.prototype.vault = null;
+        RequestConfig.prototype.vault = null;
 
         // OneOf field names bound to virtual getters and setters
         var $oneOfFields;
 
         // Virtual OneOf for proto3 optional field
-        Object.defineProperty(ConfigOptions.prototype, "_environment", {
-            get: $util.oneOfGetter($oneOfFields = ["environment"]),
-            set: $util.oneOfSetter($oneOfFields)
-        });
-
-        // Virtual OneOf for proto3 optional field
-        Object.defineProperty(ConfigOptions.prototype, "_http", {
+        Object.defineProperty(RequestConfig.prototype, "_http", {
             get: $util.oneOfGetter($oneOfFields = ["http"]),
             set: $util.oneOfSetter($oneOfFields)
         });
 
         // Virtual OneOf for proto3 optional field
-        Object.defineProperty(ConfigOptions.prototype, "_vault", {
+        Object.defineProperty(RequestConfig.prototype, "_vault", {
             get: $util.oneOfGetter($oneOfFields = ["vault"]),
             set: $util.oneOfSetter($oneOfFields)
         });
 
         /**
-         * Creates a new ConfigOptions instance using the specified properties.
+         * Creates a new RequestConfig instance using the specified properties.
          * @function create
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @static
-         * @param {types.IConfigOptions=} [properties] Properties to set
-         * @returns {types.ConfigOptions} ConfigOptions instance
+         * @param {types.IRequestConfig=} [properties] Properties to set
+         * @returns {types.RequestConfig} RequestConfig instance
          */
-        ConfigOptions.create = function create(properties) {
-            return new ConfigOptions(properties);
+        RequestConfig.create = function create(properties) {
+            return new RequestConfig(properties);
         };
 
         /**
-         * Encodes the specified ConfigOptions message. Does not implicitly {@link types.ConfigOptions.verify|verify} messages.
+         * Encodes the specified RequestConfig message. Does not implicitly {@link types.RequestConfig.verify|verify} messages.
          * @function encode
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @static
-         * @param {types.IConfigOptions} message ConfigOptions message or plain object to encode
+         * @param {types.IRequestConfig} message RequestConfig message or plain object to encode
          * @param {$protobuf.Writer} [writer] Writer to encode to
          * @returns {$protobuf.Writer} Writer
          */
-        ConfigOptions.encode = function encode(message, writer) {
+        RequestConfig.encode = function encode(message, writer) {
             if (!writer)
                 writer = $Writer.create();
-            if (message.environment != null && Object.hasOwnProperty.call(message, "environment"))
-                writer.uint32(/* id 1, wireType 0 =*/8).int32(message.environment);
             if (message.http != null && Object.hasOwnProperty.call(message, "http"))
-                $root.types.HttpConfig.encode(message.http, writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim();
+                $root.types.HttpConfig.encode(message.http, writer.uint32(/* id 1, wireType 2 =*/10).fork()).ldelim();
             if (message.vault != null && Object.hasOwnProperty.call(message, "vault"))
-                $root.types.VaultOptions.encode(message.vault, writer.uint32(/* id 3, wireType 2 =*/26).fork()).ldelim();
+                $root.types.VaultOptions.encode(message.vault, writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim();
             return writer;
         };
 
         /**
-         * Decodes a ConfigOptions message from the specified reader or buffer.
+         * Decodes a RequestConfig message from the specified reader or buffer.
          * @function decode
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @static
          * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
          * @param {number} [length] Message length if known beforehand
-         * @returns {types.ConfigOptions} ConfigOptions
+         * @returns {types.RequestConfig} RequestConfig
          * @throws {Error} If the payload is not a reader or valid buffer
          * @throws {$protobuf.util.ProtocolError} If required fields are missing
          */
-        ConfigOptions.decode = function decode(reader, length, error) {
+        RequestConfig.decode = function decode(reader, length, error) {
             if (!(reader instanceof $Reader))
                 reader = $Reader.create(reader);
-            var end = length === undefined ? reader.len : reader.pos + length, message = new $root.types.ConfigOptions();
+            var end = length === undefined ? reader.len : reader.pos + length, message = new $root.types.RequestConfig();
             while (reader.pos < end) {
                 var tag = reader.uint32();
                 if (tag === error)
                     break;
                 switch (tag >>> 3) {
                 case 1: {
-                        message.environment = reader.int32();
-                        break;
-                    }
-                case 2: {
                         message.http = $root.types.HttpConfig.decode(reader, reader.uint32());
                         break;
                     }
-                case 3: {
+                case 2: {
                         message.vault = $root.types.VaultOptions.decode(reader, reader.uint32());
                         break;
                     }
@@ -81067,27 +81067,17 @@ $root.types = (function() {
         };
 
         /**
-         * Verifies a ConfigOptions message.
+         * Verifies a RequestConfig message.
          * @function verify
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @static
          * @param {Object.<string,*>} message Plain object to verify
          * @returns {string|null} `null` if valid, otherwise the reason why it is not
          */
-        ConfigOptions.verify = function verify(message) {
+        RequestConfig.verify = function verify(message) {
             if (typeof message !== "object" || message === null)
                 return "object expected";
             var properties = {};
-            if (message.environment != null && message.hasOwnProperty("environment")) {
-                properties._environment = 1;
-                switch (message.environment) {
-                default:
-                    return "environment: enum value expected";
-                case 0:
-                case 1:
-                    break;
-                }
-            }
             if (message.http != null && message.hasOwnProperty("http")) {
                 properties._http = 1;
                 {
@@ -81108,21 +81098,21 @@ $root.types = (function() {
         };
 
         /**
-         * Gets the default type url for ConfigOptions
+         * Gets the default type url for RequestConfig
          * @function getTypeUrl
-         * @memberof types.ConfigOptions
+         * @memberof types.RequestConfig
          * @static
          * @param {string} [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
          * @returns {string} The default type url
          */
-        ConfigOptions.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
+        RequestConfig.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
             if (typeUrlPrefix === undefined) {
                 typeUrlPrefix = "type.googleapis.com";
             }
-            return typeUrlPrefix + "/types.ConfigOptions";
+            return typeUrlPrefix + "/types.RequestConfig";
         };
 
-        return ConfigOptions;
+        return RequestConfig;
     })();
 
     types.HttpConfig = (function() {
@@ -81143,7 +81133,6 @@ $root.types = (function() {
          * Constructs a new HttpConfig.
          * @memberof types
          * @classdesc HTTP transport configuration.
-         * Flattened for cleaner access and merging logic across SDKs.
          * @implements IHttpConfig
          * @constructor
          * @param {types.IHttpConfig=} [properties] Properties to set
@@ -81877,8 +81866,8 @@ $root.types = (function() {
          * Properties of a FfiOptions.
          * @memberof types
          * @interface IFfiOptions
-         * @property {types.Environment|null} [environment] Environment context for config lookup
-         * @property {types.Connector|null} [connector] Connector context for logic selection
+         * @property {types.Environment|null} [environment] Resolved environment context
+         * @property {types.Connector|null} [connector] Resolved connector context
          * @property {types.IConnectorAuth|null} [auth] Credentials needed to build auth headers/payloads
          */
 
@@ -81898,7 +81887,7 @@ $root.types = (function() {
         }
 
         /**
-         * Environment context for config lookup
+         * Resolved environment context
          * @member {types.Environment} environment
          * @memberof types.FfiOptions
          * @instance
@@ -81906,7 +81895,7 @@ $root.types = (function() {
         FfiOptions.prototype.environment = 0;
 
         /**
-         * Connector context for logic selection
+         * Resolved connector context
          * @member {types.Connector} connector
          * @memberof types.FfiOptions
          * @instance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hs-playlib",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Hyperswitch Payments SDK — Node.js client for connector integrations via UniFFI FFI",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",