splitit-payments-sdk 1.0.7 → 2.0.11

package/src/client.ts

@@ -1,12 +1,11 @@
 /**
- * splitit-web-api-v3Lib
+ * splitit-web-api-v4Lib
  *
  * This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
  */
 
 import { createAuthProviderFromConfig } from './authProvider.js';
-import { OAuth2ProductionManager } from './oAuth2ProductionManager.js';
-import { OAuth2SandboxManager } from './oAuth2SandboxManager.js';
+import { OAuth2Manager } from './oAuth2Manager.js';
 import {
   AuthParams,
   ClientInterface,
@@ -36,8 +35,7 @@ export class Client implements ClientInterface {
   private _timeout: number;
   private _retryConfig: RetryConfiguration;
   private _requestBuilderFactory: SdkRequestBuilderFactory;
-  public oAuth2SandboxManager?: OAuth2SandboxManager;
-  public oAuth2ProductionManager?: OAuth2ProductionManager;
+  public oAuth2Manager?: OAuth2Manager;
 
   constructor(config?: Partial<Configuration>) {
     this._config = {
@@ -54,11 +52,7 @@ export class Client implements ClientInterface {
         : this._config.timeout;
     this._requestBuilderFactory = createRequestHandlerFactory(
       (server) => getBaseUri(server, this._config),
-      createAuthProviderFromConfig(
-        this._config,
-        () => this.oAuth2SandboxManager,
-        () => this.oAuth2ProductionManager
-      ),
+      createAuthProviderFromConfig(this._config, () => this.oAuth2Manager),
       new HttpClient(AbortError, {
         timeout: this._timeout,
         clientConfigOverrides: this._config.unstable_httpClientOptions,
@@ -69,15 +63,9 @@ export class Client implements ClientInterface {
       [withErrorHandlers, withUserAgent, withAuthenticationByDefault],
       this._retryConfig
     );
-    if (this._config.oAuth2SandboxCredentials) {
-      this.oAuth2SandboxManager = new OAuth2SandboxManager(
-        this._config.oAuth2SandboxCredentials,
-        this
-      );
-    }
-    if (this._config.oAuth2ProductionCredentials) {
-      this.oAuth2ProductionManager = new OAuth2ProductionManager(
-        this._config.oAuth2ProductionCredentials,
+    if (this._config.oAuth2Credentials) {
+      this.oAuth2Manager = new OAuth2Manager(
+        this._config.oAuth2Credentials,
         this
       );
     }
@@ -93,6 +81,28 @@ export class Client implements ClientInterface {
   public withConfiguration(config: Partial<Configuration>) {
     return new Client({ ...this._config, ...config });
   }
+
+  /**
+   * Create a client instance from a JSON configuration string
+   * @param jsonConfig - JSON string containing the configuration
+   * @returns A new Client instance
+   */
+  public static fromJsonConfig(jsonConfig: string): Client {
+    return new Client(Configuration.fromJsonConfig(jsonConfig));
+  }
+
+  /**
+   * Create a client instance from environment variables
+   * @param envVariables - Optional object containing environment variables
+   * @returns A new Client instance
+   */
+  public static fromEnvironment(
+    envVariables?: Record<string, string | undefined>
+  ): Client {
+    return new Client(
+      Configuration.fromEnvironment(envVariables || process.env)
+    );
+  }
 }
 
 function createHttpClientAdapter(client: HttpClient): HttpClientInterface {
@@ -102,25 +112,19 @@ function createHttpClientAdapter(client: HttpClient): HttpClientInterface {
 }
 
 function getBaseUri(server: Server = 'default', config: Configuration): string {
-  if (config.environment === Environment.Production) {
+  if (config.environment === Environment.Sandbox) {
     if (server === 'default') {
-      return 'https://web-api-v3.sandbox.splitit.com/';
+      return 'https://orch-api.sandbox.splitit.com';
     }
     if (server === 'access token server') {
       return 'https://id.sandbox.splitit.com/connect';
     }
-    if (server === 'access token server1') {
-      return 'https://id.splitit.com/connect';
-    }
   }
-  if (config.environment === Environment.Environment2) {
+  if (config.environment === Environment.Production) {
     if (server === 'default') {
-      return 'https://web-api-v3.splitit.com/';
+      return 'https://orch-api.splitit.com';
     }
     if (server === 'access token server') {
-      return 'https://id.sandbox.splitit.com/connect';
-    }
-    if (server === 'access token server1') {
       return 'https://id.splitit.com/connect';
     }
   }
@@ -165,5 +169,5 @@ function withUserAgent(rb: SdkRequestBuilder) {
 }
 
 function withAuthenticationByDefault(rb: SdkRequestBuilder) {
-  rb.authenticate([{ oAuth2Sandbox: true }, { oAuth2Production: true }]);
+  rb.authenticate([{ oAuth2: true, apiKey: true }]);
 }

package/src/clientAdapter.ts

@@ -1,5 +1,5 @@
 /**
- * splitit-web-api-v3Lib
+ * splitit-web-api-v4Lib
  *
  * This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
  */

package/src/clientInterface.ts

@@ -1,5 +1,5 @@
 /**
- * splitit-web-api-v3Lib
+ * splitit-web-api-v4Lib
  *
  * This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
  */
@@ -18,7 +18,7 @@ export type SdkRequestBuilderFactory = RequestBuilderFactory<
 
 export type SdkRequestBuilder = ReturnType<SdkRequestBuilderFactory>;
 
-export type Server = 'default' | 'access token server' | 'access token server1';
+export type Server = 'default' | 'access token server';
 
 export type AuthParams = ReturnType<
   typeof createAuthProviderFromConfig

package/src/configuration.ts

@@ -1,43 +1,48 @@
 /**
- * splitit-web-api-v3Lib
+ * splitit-web-api-v4Lib
  *
  * This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
  */
 
 import { HttpClientOptions } from './clientAdapter.js';
-import { OAuthScopeOAuth2ProductionEnum } from './models/oAuthScopeOAuth2ProductionEnum.js';
-import { OAuthScopeOAuth2SandboxEnum } from './models/oAuthScopeOAuth2SandboxEnum.js';
+import {
+  OAuthScopeOAuth2Enum,
+  oAuthScopeOAuth2EnumSchema,
+} from './models/oAuthScopeOAuth2Enum.js';
 import { OAuthToken } from './models/oAuthToken.js';
-import { OAuth2ProductionManager } from './oAuth2ProductionManager.js';
-import { OAuth2SandboxManager } from './oAuth2SandboxManager.js';
+import { OAuth2Manager } from './oAuth2Manager.js';
+import {
+  anyOf,
+  array,
+  boolean,
+  literal,
+  number,
+  object,
+  optional,
+  Schema,
+  string,
+  stringEnum,
+  validateAndMap,
+} from './schema.js';
 
 /** An interface for all configuration parameters required by the SDK. */
 export interface Configuration {
   timeout: number;
   environment: Environment;
-  oAuth2SandboxCredentials?: {
+  oAuth2Credentials?: {
     oAuthClientId: string;
     oAuthClientSecret: string;
     oAuthToken?: OAuthToken;
-    oAuthScopes?: OAuthScopeOAuth2SandboxEnum[];
+    oAuthScopes?: OAuthScopeOAuth2Enum[];
     oAuthTokenProvider?: (
       lastOAuthToken: OAuthToken | undefined,
-      authManager: OAuth2SandboxManager
+      authManager: OAuth2Manager
     ) => Promise<OAuthToken>;
     oAuthOnTokenUpdate?: (token: OAuthToken) => void;
     oAuthClockSkew?: number;
   };
-  oAuth2ProductionCredentials?: {
-    oAuthClientId: string;
-    oAuthClientSecret: string;
-    oAuthToken?: OAuthToken;
-    oAuthScopes?: OAuthScopeOAuth2ProductionEnum[];
-    oAuthTokenProvider?: (
-      lastOAuthToken: OAuthToken | undefined,
-      authManager: OAuth2ProductionManager
-    ) => Promise<OAuthToken>;
-    oAuthOnTokenUpdate?: (token: OAuthToken) => void;
-    oAuthClockSkew?: number;
+  apiKeyCredentials?: {
+    'X-Splitit-Api-Key': string;
   };
   httpClientOptions?: Partial<HttpClientOptions>;
   unstable_httpClientOptions?: any;
@@ -45,6 +50,181 @@ export interface Configuration {
 
 /** Environments available for API */
 export enum Environment {
-  Production = 'production',
-  Environment2 = 'environment2',
+  Sandbox = 'Sandbox',
+  Production = 'Production',
 }
+
+export namespace Configuration {
+  export function fromJsonConfig(jsonConfig: string): Partial<Configuration> {
+    const configurationObject = JSON.parse(jsonConfig);
+    const result = validateAndMap(jsonConfig, configurationObject);
+
+    if (result.errors) {
+      throw new Error(
+        'Invalid configuration provided. Please check the following errors:\n' +
+          result.errors.map((e: any) => e.message).join('\n')
+      );
+    }
+
+    return result.result;
+  }
+
+  export function fromEnvironment(
+    envVariables: Record<string, string | undefined>
+  ): Partial<Configuration> {
+    const config: any = {};
+
+    config.timeout = envVariables.TIMEOUT;
+    config.environment = envVariables.ENVIRONMENT;
+
+    if (
+      envVariables.O_AUTH_2_O_AUTH_CLIENT_ID &&
+      envVariables.O_AUTH_2_O_AUTH_CLIENT_SECRET
+    ) {
+      config.oAuth2Credentials = {
+        oAuthClientId: envVariables.O_AUTH_2_O_AUTH_CLIENT_ID,
+        oAuthClientSecret: envVariables.O_AUTH_2_O_AUTH_CLIENT_SECRET,
+        oAuthToken: envVariables.O_AUTH_2_O_AUTH_TOKEN,
+        oAuthScopes: envVariables.O_AUTH_2_O_AUTH_SCOPES,
+        oAuthClockSkew: envVariables.O_AUTH_2_O_AUTH_CLOCK_SKEW,
+      };
+    }
+
+    if (envVariables.API_KEY_X_SPLITIT_API_KEY) {
+      config.apiKeyCredentials = {
+        'X-Splitit-Api-Key': envVariables.API_KEY_X_SPLITIT_API_KEY,
+      };
+    }
+
+    config.httpClientOptions = {
+      timeout: envVariables.TIMEOUT,
+      retryConfig: {
+        retryOnTimeout: envVariables.RETRY_ON_TIMEOUT,
+        retryInterval: envVariables.RETRY_INTERVAL,
+        maxNumberOfRetries: envVariables.MAX_NUMBER_OF_RETRIES,
+        maximumRetryWaitTime: envVariables.MAX_RETRY_WAIT_TIME,
+        backoffFactor: envVariables.RETRY_BACKOFF_FACTOR,
+        httpStatusCodesToRetry: envVariables.HTTP_STATUS_CODES_TO_RETRY?.split(
+          ','
+        ).map((s) => s.trim()),
+        httpMethodsToRetry: envVariables.HTTP_METHODS_TO_RETRY?.split(
+          ','
+        ).map((s) => s.trim()),
+      },
+    };
+
+    if (envVariables.PROXY_ADDRESS) {
+      config.httpClientOptions.proxySettings = {
+        address: envVariables.PROXY_ADDRESS,
+        port: envVariables.PROXY_PORT,
+      };
+
+      if (
+        envVariables.PROXY_AUTH_USERNAME &&
+        envVariables.PROXY_AUTH_PASSWORD
+      ) {
+        config.httpClientOptions.proxySettings.auth = {
+          username: envVariables.PROXY_AUTH_USERNAME,
+          password: envVariables.PROXY_AUTH_PASSWORD,
+        };
+      }
+    }
+
+    const result = validateAndMap(config, configurationSchema);
+
+    if (result.errors) {
+      throw new Error(
+        'Invalid configuration provided. Please check the following errors:\n' +
+          result.errors.map((e: any) => e.message).join('\n')
+      );
+    }
+
+    return result.result;
+  }
+}
+
+const configurationSchema: Schema<Partial<Configuration>> = object({
+  timeout: ['timeout', optional(number())],
+  environment: ['environment', optional(stringEnum(Environment))],
+  oAuth2Credentials: [
+    'oAuth2Credentials',
+    optional(
+      object({
+        oAuthClientId: ['oAuthClientId', string()],
+        oAuthClientSecret: ['oAuthClientSecret', string()],
+        oAuthScopes: [
+          'oAuthScopes',
+          optional(array(oAuthScopeOAuth2EnumSchema)),
+        ],
+        oAuthClockSkew: ['oAuthClockSkew', optional(number())],
+      })
+    ),
+  ],
+  apiKeyCredentials: [
+    'apiKeyCredentials',
+    optional(object({ 'X-Splitit-Api-Key': ['X-Splitit-Api-Key', string()] })),
+  ],
+  httpClientOptions: [
+    'httpClientOptions',
+    optional(
+      object({
+        timeout: ['timeout', optional(number())],
+        retryConfig: [
+          'retryConfig',
+          optional(
+            object({
+              maxNumberOfRetries: ['maxNumberOfRetries', optional(number())],
+              retryOnTimeout: ['retryOnTimeout', optional(boolean())],
+              retryInterval: ['retryInterval', optional(number())],
+              maximumRetryWaitTime: [
+                'maximumRetryWaitTime',
+                optional(number()),
+              ],
+              backoffFactor: ['backoffFactor', optional(number())],
+              httpStatusCodesToRetry: [
+                'httpStatusCodesToRetry',
+                optional(array(number())),
+              ],
+              httpMethodsToRetry: [
+                'httpMethodsToRetry',
+                optional(
+                  array(
+                    anyOf([
+                      literal('GET'),
+                      literal('DELETE'),
+                      literal('HEAD'),
+                      literal('OPTIONS'),
+                      literal('POST'),
+                      literal('PUT'),
+                      literal('PATCH'),
+                      literal('LINK'),
+                      literal('UNLINK'),
+                    ])
+                  )
+                ),
+              ],
+            })
+          ),
+        ],
+        proxySettings: [
+          'proxySettings',
+          optional(
+            object({
+              address: ['address', string()],
+              port: ['port', optional(number())],
+              auth: [
+                'auth',
+                optional(
+                  object({
+                    username: ['username', string()],
+                    password: ['password', string()],
+                  })
+                ),
+              ],
+            })
+          ),
+        ],
+      })
+    ),
+  ],
+});

package/src/controllers/baseController.ts

@@ -1,5 +1,5 @@
 /**
- * splitit-web-api-v3Lib
+ * splitit-web-api-v4Lib
  *
  * This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
  */