chore: move initialization into class methods, limit singleton use

docs/js-client-sdk.eppojsclient.instance.md

@@ -4,6 +4,8 @@
 
 ## EppoJSClient.instance property
 
+@<!-- -->deprecated. use `getInstance()` instead.
+
 **Signature:**
 
 ```typescript

docs/js-client-sdk.eppojsclient.md

@@ -72,6 +72,8 @@ boolean
 
 </td><td>
 
+@<!-- -->deprecated. use `getInstance()` instead.
+
 
 </td></tr>
 </tbody></table>

docs/js-client-sdk.getinstance.md

@@ -9,11 +9,11 @@ Used to access a singleton SDK client instance. Use the method after calling ini
 **Signature:**
 
 ```typescript
-export declare function getInstance(): EppoClient;
+export declare function getInstance(): EppoJSClient;
 ```
 **Returns:**
 
-EppoClient
+[EppoJSClient](./js-client-sdk.eppojsclient.md)
 
 a singleton client instance
 

docs/js-client-sdk.init.md

@@ -4,12 +4,12 @@
 
 ## init() function
 
-Initializes the Eppo client with configuration parameters. This method should be called once on application startup. If an initialization is in process, calling `init` will return the in-progress `Promise<EppoClient>`<!-- -->. Once the initialization completes, calling `init` again will kick off the initialization routine (if `forceReinitialization` is `true`<!-- -->).
+Initializes the Eppo client with configuration parameters. This method should be called once on application startup.
 
 **Signature:**
 
 ```typescript
-export declare function init(config: IClientConfig): Promise<EppoClient>;
+export declare function init(config: IClientConfig): Promise<EppoJSClient>;
 ```
 
 ## Parameters
@@ -49,5 +49,5 @@ client configuration
 </tbody></table>
 **Returns:**
 
-Promise&lt;EppoClient&gt;
+Promise&lt;[EppoJSClient](./js-client-sdk.eppojsclient.md)<!-- -->&gt;
 

docs/js-client-sdk.md

@@ -120,7 +120,7 @@ Used to access a singleton SDK precomputed client instance. Use the method after
 
 </td><td>
 
-Initializes the Eppo client with configuration parameters. This method should be called once on application startup. If an initialization is in process, calling `init` will return the in-progress `Promise<EppoClient>`<!-- -->. Once the initialization completes, calling `init` again will kick off the initialization routine (if `forceReinitialization` is `true`<!-- -->).
+Initializes the Eppo client with configuration parameters. This method should be called once on application startup.
 
 
 </td></tr>

js-client-sdk.api.md

@@ -84,10 +84,13 @@ export class EppoJSClient extends EppoClient {
     getStringAssignment(flagKey: string, subjectKey: string, subjectAttributes: Record<string, AttributeType>, defaultValue: string): string;
     // (undocumented)
     getStringAssignmentDetails(flagKey: string, subjectKey: string, subjectAttributes: Record<string, AttributeType>, defaultValue: string): IAssignmentDetails<string>;
+    // @internal (undocumented)
+    init(config: Omit<IClientConfig, 'forceReinitialize'>): Promise<EppoJSClient>;
     // (undocumented)
     static initialized: boolean;
-    // (undocumented)
     static instance: EppoJSClient;
+    // @internal (undocumented)
+    offlineInit(config: IClientConfigSync): void;
 }
 
 // @public
@@ -116,7 +119,7 @@ export { Flag }
 export function getConfigUrl(apiKey: string, baseUrl?: string): URL;
 
 // @public
-export function getInstance(): EppoClient;
+export function getInstance(): EppoJSClient;
 
 // @public
 export function getPrecomputedInstance(): EppoPrecomputedClient;
@@ -169,7 +172,7 @@ export interface IClientConfigSync {
 }
 
 // @public
-export function init(config: IClientConfig): Promise<EppoClient>;
+export function init(config: IClientConfig): Promise<EppoJSClient>;
 
 // @public
 export interface IPrecomputedClientConfig extends IBaseRequestConfig {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eppo/js-client-sdk",
-  "version": "3.9.8",
+  "version": "3.10.0",
   "description": "Eppo SDK for client-side JavaScript applications",
   "main": "dist/index.js",
   "files": [