hs-playlib 0.2.0 → 0.4.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 };
     }