@temboplus/afloat 0.1.7 → 0.1.9

package/esm/src/features/auth/manager.d.ts

@@ -9,6 +9,8 @@ export declare class AfloatAuth {
     private store;
     /** The token handler implementation */
     private tokenHandler;
+    /** client AfloatAuth instance */
+    private static _instance;
     /**
      * Private constructor to prevent direct instantiation.
      * @param {AuthStore} store - The auth store implementation to use
@@ -16,25 +18,28 @@ export declare class AfloatAuth {
      */
     private constructor();
     /**
-     * Initializes AfloatAuth for client-side use.
-     * This should be called once at application startup in client environments.
-     * @returns {AfloatAuth} The singleton instance configured for client-side
+     * Gets or creates the client-side singleton instance of AfloatAuth.
+     * This getter will automatically initialize the client instance if it hasn't been created yet.
+     * For server-side usage, use initializeServer() instead.
+     *
+     * @returns {AfloatAuth} The client-side singleton instance
+     * @example
+     * // Client-side usage
+     * const auth = AfloatAuth.instance;
+     *
+     * // Server-side usage (don't use .instance)
+     * const serverAuth = await AfloatAuth.initializeServer(token);
      */
-    static initializeClient(): AfloatAuth;
+    static get instance(): AfloatAuth;
     /**
-     * Creates a new instance of AfloatAuth configured for server-side use.
-     * Initializes the user by fetching necessary data using the provided token.
+     * Creates a new server-side instance of AfloatAuth.
+     * Unlike the client-side instance getter, this creates a new instance each time.
+     *
      * @param {string} token - Authentication token
-     * @returns {Promise<AfloatAuth>} A new instance configured for server-side
+     * @returns {Promise<AfloatAuth>} A new server-side instance
      * @throws {Error} If token is invalid or required data cannot be fetched
      */
     static initializeServer(token: string): Promise<AfloatAuth>;
-    /**
-     * Gets the singleton instance of AfloatAuth.
-     * @throws {Error} If AfloatAuth hasn't been initialized
-     * @returns {AfloatAuth} The singleton instance
-     */
-    static get instance(): AfloatAuth;
     /**
      * Gets the authentication repository instance.
      * @private

package/esm/src/features/auth/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAY7D;;;GAGG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;OAIG;IACH,OAAO;IAKP;;;;OAIG;WACW,gBAAgB,IAAI,UAAU;IAQ5C;;;;;;OAMG;WACiB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBxE;;;;OAIG;IACH,WAAkB,QAAQ,IAAI,UAAU,CAOvC;IAED;;;;OAIG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAI1C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,cAAc;CAIvB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAU7D;;;GAGG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAe;IAEnC,iCAAiC;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2B;IACnD;;;;OAIG;IACH,OAAO;IAKP;;;;;;;;;;;;OAYG;IACH,WAAkB,QAAQ,IAAI,UAAU,CAKvC;IAED;;;;;;;OAOG;WACiB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBxE;;;;OAIG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAI1C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,cAAc;CAIvB"}

package/esm/src/features/auth/manager.js

@@ -3,7 +3,6 @@ import { createClientStore, useClientUser, } from "./storage/client_store.js";
 import { ClientTokenHandler } from "./storage/client_token_handler.js";
 import { ServerStore } from "./storage/server_store.js";
 import { ServerTokenHandler } from "./storage/server_token_handler.js";
-let _instance = null;
 /**
  * Main authentication class that works in both client and server environments.
  * Provides authentication functionality and user management.
@@ -33,19 +32,27 @@ export class AfloatAuth {
         this.tokenHandler = tokenHandler;
     }
     /**
-     * Initializes AfloatAuth for client-side use.
-     * This should be called once at application startup in client environments.
-     * @returns {AfloatAuth} The singleton instance configured for client-side
+     * Gets or creates the client-side singleton instance of AfloatAuth.
+     * This getter will automatically initialize the client instance if it hasn't been created yet.
+     * For server-side usage, use initializeServer() instead.
+     *
+     * @returns {AfloatAuth} The client-side singleton instance
+     * @example
+     * // Client-side usage
+     * const auth = AfloatAuth.instance;
+     *
+     * // Server-side usage (don't use .instance)
+     * const serverAuth = await AfloatAuth.initializeServer(token);
      */
-    static initializeClient() {
-        _instance = new AfloatAuth(createClientStore(), ClientTokenHandler.instance);
-        return _instance;
+    static get instance() {
+        return AfloatAuth._instance || (AfloatAuth._instance = new AfloatAuth(createClientStore(), ClientTokenHandler.instance));
     }
     /**
-     * Creates a new instance of AfloatAuth configured for server-side use.
-     * Initializes the user by fetching necessary data using the provided token.
+     * Creates a new server-side instance of AfloatAuth.
+     * Unlike the client-side instance getter, this creates a new instance each time.
+     *
      * @param {string} token - Authentication token
-     * @returns {Promise<AfloatAuth>} A new instance configured for server-side
+     * @returns {Promise<AfloatAuth>} A new server-side instance
      * @throws {Error} If token is invalid or required data cannot be fetched
      */
     static async initializeServer(token) {
@@ -59,8 +66,7 @@ export class AfloatAuth {
             const user = await tokenHandler.constructUser();
             store.setUser(user);
             // Create and initialize auth instance
-            _instance = new AfloatAuth(store, tokenHandler);
-            return _instance;
+            return new AfloatAuth(store, tokenHandler);
         }
         catch (error) {
             if (error instanceof Error) {
@@ -69,17 +75,6 @@ export class AfloatAuth {
             throw new Error("Failed to initialize server auth");
         }
     }
-    /**
-     * Gets the singleton instance of AfloatAuth.
-     * @throws {Error} If AfloatAuth hasn't been initialized
-     * @returns {AfloatAuth} The singleton instance
-     */
-    static get instance() {
-        if (_instance === null) {
-            throw new Error("AfloatAuth not initialized. Call initializeClient() or initializeServer() first");
-        }
-        return _instance;
-    }
     /**
      * Gets the authentication repository instance.
      * @private
@@ -159,3 +154,10 @@ export class AfloatAuth {
         this.tokenHandler.clearToken();
     }
 }
+/** client AfloatAuth instance */
+Object.defineProperty(AfloatAuth, "_instance", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: null
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A JavaScript/TypeScript package providing common utilities and logic shared across all Temboplus-Afloat Projects",
   "repository": {
     "type": "git",

package/script/src/features/auth/manager.d.ts

@@ -9,6 +9,8 @@ export declare class AfloatAuth {
     private store;
     /** The token handler implementation */
     private tokenHandler;
+    /** client AfloatAuth instance */
+    private static _instance;
     /**
      * Private constructor to prevent direct instantiation.
      * @param {AuthStore} store - The auth store implementation to use
@@ -16,25 +18,28 @@ export declare class AfloatAuth {
      */
     private constructor();
     /**
-     * Initializes AfloatAuth for client-side use.
-     * This should be called once at application startup in client environments.
-     * @returns {AfloatAuth} The singleton instance configured for client-side
+     * Gets or creates the client-side singleton instance of AfloatAuth.
+     * This getter will automatically initialize the client instance if it hasn't been created yet.
+     * For server-side usage, use initializeServer() instead.
+     *
+     * @returns {AfloatAuth} The client-side singleton instance
+     * @example
+     * // Client-side usage
+     * const auth = AfloatAuth.instance;
+     *
+     * // Server-side usage (don't use .instance)
+     * const serverAuth = await AfloatAuth.initializeServer(token);
      */
-    static initializeClient(): AfloatAuth;
+    static get instance(): AfloatAuth;
     /**
-     * Creates a new instance of AfloatAuth configured for server-side use.
-     * Initializes the user by fetching necessary data using the provided token.
+     * Creates a new server-side instance of AfloatAuth.
+     * Unlike the client-side instance getter, this creates a new instance each time.
+     *
      * @param {string} token - Authentication token
-     * @returns {Promise<AfloatAuth>} A new instance configured for server-side
+     * @returns {Promise<AfloatAuth>} A new server-side instance
      * @throws {Error} If token is invalid or required data cannot be fetched
      */
     static initializeServer(token: string): Promise<AfloatAuth>;
-    /**
-     * Gets the singleton instance of AfloatAuth.
-     * @throws {Error} If AfloatAuth hasn't been initialized
-     * @returns {AfloatAuth} The singleton instance
-     */
-    static get instance(): AfloatAuth;
     /**
      * Gets the authentication repository instance.
      * @private

package/script/src/features/auth/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAY7D;;;GAGG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;OAIG;IACH,OAAO;IAKP;;;;OAIG;WACW,gBAAgB,IAAI,UAAU;IAQ5C;;;;;;OAMG;WACiB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBxE;;;;OAIG;IACH,WAAkB,QAAQ,IAAI,UAAU,CAOvC;IAED;;;;OAIG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAI1C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,cAAc;CAIvB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAU7D;;;GAGG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAe;IAEnC,iCAAiC;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2B;IACnD;;;;OAIG;IACH,OAAO;IAKP;;;;;;;;;;;;OAYG;IACH,WAAkB,QAAQ,IAAI,UAAU,CAKvC;IAED;;;;;;;OAOG;WACiB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwBxE;;;;OAIG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAI1C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,cAAc;CAIvB"}

package/script/src/features/auth/manager.js

@@ -6,7 +6,6 @@ const client_store_js_1 = require("./storage/client_store.js");
 const client_token_handler_js_1 = require("./storage/client_token_handler.js");
 const server_store_js_1 = require("./storage/server_store.js");
 const server_token_handler_js_1 = require("./storage/server_token_handler.js");
-let _instance = null;
 /**
  * Main authentication class that works in both client and server environments.
  * Provides authentication functionality and user management.
@@ -36,19 +35,27 @@ class AfloatAuth {
         this.tokenHandler = tokenHandler;
     }
     /**
-     * Initializes AfloatAuth for client-side use.
-     * This should be called once at application startup in client environments.
-     * @returns {AfloatAuth} The singleton instance configured for client-side
+     * Gets or creates the client-side singleton instance of AfloatAuth.
+     * This getter will automatically initialize the client instance if it hasn't been created yet.
+     * For server-side usage, use initializeServer() instead.
+     *
+     * @returns {AfloatAuth} The client-side singleton instance
+     * @example
+     * // Client-side usage
+     * const auth = AfloatAuth.instance;
+     *
+     * // Server-side usage (don't use .instance)
+     * const serverAuth = await AfloatAuth.initializeServer(token);
      */
-    static initializeClient() {
-        _instance = new AfloatAuth((0, client_store_js_1.createClientStore)(), client_token_handler_js_1.ClientTokenHandler.instance);
-        return _instance;
+    static get instance() {
+        return AfloatAuth._instance || (AfloatAuth._instance = new AfloatAuth((0, client_store_js_1.createClientStore)(), client_token_handler_js_1.ClientTokenHandler.instance));
     }
     /**
-     * Creates a new instance of AfloatAuth configured for server-side use.
-     * Initializes the user by fetching necessary data using the provided token.
+     * Creates a new server-side instance of AfloatAuth.
+     * Unlike the client-side instance getter, this creates a new instance each time.
+     *
      * @param {string} token - Authentication token
-     * @returns {Promise<AfloatAuth>} A new instance configured for server-side
+     * @returns {Promise<AfloatAuth>} A new server-side instance
      * @throws {Error} If token is invalid or required data cannot be fetched
      */
     static async initializeServer(token) {
@@ -62,8 +69,7 @@ class AfloatAuth {
             const user = await tokenHandler.constructUser();
             store.setUser(user);
             // Create and initialize auth instance
-            _instance = new AfloatAuth(store, tokenHandler);
-            return _instance;
+            return new AfloatAuth(store, tokenHandler);
         }
         catch (error) {
             if (error instanceof Error) {
@@ -72,17 +78,6 @@ class AfloatAuth {
             throw new Error("Failed to initialize server auth");
         }
     }
-    /**
-     * Gets the singleton instance of AfloatAuth.
-     * @throws {Error} If AfloatAuth hasn't been initialized
-     * @returns {AfloatAuth} The singleton instance
-     */
-    static get instance() {
-        if (_instance === null) {
-            throw new Error("AfloatAuth not initialized. Call initializeClient() or initializeServer() first");
-        }
-        return _instance;
-    }
     /**
      * Gets the authentication repository instance.
      * @private
@@ -163,3 +158,10 @@ class AfloatAuth {
     }
 }
 exports.AfloatAuth = AfloatAuth;
+/** client AfloatAuth instance */
+Object.defineProperty(AfloatAuth, "_instance", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: null
+});