ptech-shell-dev 1.6.7 → 1.7.0

package/dist/index.d.ts

@@ -79,15 +79,17 @@ type ServiceRegisterMode = 'if-missing' | 'always';
 type StandaloneInitOptions = {
     /**
      * API base URL when running standalone.
-     * Example: http://localhost:4000
+     * @default 'http://localhost:4000'
      */
     apiBase?: string;
     /**
      * Default language for standalone.
+     * @default 'vi'
      */
     lang?: Lang;
     /**
      * Seed user for standalone. (Optional)
+     * @default { id: 'dev', name: 'Dev User' }
      */
     user?: User | null;
     /**
@@ -116,8 +118,30 @@ type StandaloneInitOptions = {
      * - always: replace any existing service for the token.
      */
     registerMode?: ServiceRegisterMode;
+    /**
+     * Default path for standalone navigation service.
+     * @default '/standalone'
+     */
+    navigationPath?: string;
+    /**
+     * Feature flags seed for standalone config service.
+     * Merged with built-in defaults.
+     */
+    featureFlags?: Record<string, boolean>;
+    /**
+     * Runtime config overrides for standalone config service.
+     */
+    runtimeConfig?: {
+        envName?: string;
+        apiBase?: string;
+    };
 };
 
+/**
+ * Creates all standalone service instances without registering them.
+ * Useful for testing or when you need direct access to services.
+ */
+declare function createTestServices(options?: StandaloneInitOptions): StandaloneServices;
 /**
  * Initialize "safe defaults" so a remote app can run standalone without the host.
  *
@@ -125,6 +149,21 @@ type StandaloneInitOptions = {
  * But if host doesn't (or remote is standalone), this provides mocks.
  */
 declare function initStandaloneServices(options?: StandaloneInitOptions): void;
+/**
+ * Create a preset factory with default options baked in.
+ * Useful for projects that want consistent defaults across remotes.
+ *
+ * @example
+ * // In a shared config file:
+ * export const initHrmServices = createDevPreset({
+ *   apiBase: 'http://localhost:5000',
+ *   lang: 'en',
+ * });
+ *
+ * // In each remote's bootstrap:
+ * initHrmServices({ user: { id: 'admin', name: 'Admin' } });
+ */
+declare function createDevPreset(defaults: StandaloneInitOptions): (overrides?: StandaloneInitOptions) => void;
 
 type CreateStandaloneApiClientOptions = {
     apiBase: string;
@@ -376,4 +415,4 @@ declare function createRequestContextService(options?: CreateRequestContextServi
  */
 declare function createStandaloneUserService(seedUser: User | null): UserService;
 
-export { ApiError, type CreateMsalUserServiceOptions, type CreateReactRouterNavigationAdapterOptions, type CreateStandaloneApiClientOptions, type CreateStandaloneObservabilityServiceOptions, type CreateStandaloneRealtimeServiceOptions, type MsalBrowserInstanceLike, type ObservabilityTelemetryEvent, type ObservabilityTelemetrySink, type ReactRouterCreateHrefFunctionLike, type ReactRouterLocationLike, type ReactRouterNavigateFunctionLike, type ReactRouterNavigationAdapter, type ReactRouterNavigationCapabilities, type RealtimeReconnectOptions, type RealtimeTransport, type RealtimeTransportConnectContext, type ServiceRegisterMode, type StandaloneInitOptions, type StandaloneServices, type UiApiError, createMsalUserService, createReactRouterNavigationAdapter, createRequestContextService, createStandaloneApiClient, createStandaloneI18nService, createStandaloneRealtimeService, createStandaloneUserService, initStandaloneServices, isApiError, mapApiErrorToUiError };
+export { ApiError, type CreateMsalUserServiceOptions, type CreateReactRouterNavigationAdapterOptions, type CreateStandaloneApiClientOptions, type CreateStandaloneObservabilityServiceOptions, type CreateStandaloneRealtimeServiceOptions, type MsalBrowserInstanceLike, type ObservabilityTelemetryEvent, type ObservabilityTelemetrySink, type ReactRouterCreateHrefFunctionLike, type ReactRouterLocationLike, type ReactRouterNavigateFunctionLike, type ReactRouterNavigationAdapter, type ReactRouterNavigationCapabilities, type RealtimeReconnectOptions, type RealtimeTransport, type RealtimeTransportConnectContext, type ServiceRegisterMode, type StandaloneInitOptions, type StandaloneServices, type UiApiError, createDevPreset, createMsalUserService, createReactRouterNavigationAdapter, createRequestContextService, createStandaloneApiClient, createStandaloneI18nService, createStandaloneRealtimeService, createStandaloneUserService, createTestServices, initStandaloneServices, isApiError, mapApiErrorToUiError };

package/dist/index.js

@@ -354,6 +354,15 @@ function normalizeRetryOptions(input, defaultRetryOptions) {
 function shouldRetryResponse(response, retry) {
   return retry.retryOnStatuses.has(response.status);
 }
+async function disposeRetryResponse(response) {
+  if (!response.body || typeof response.body.cancel !== "function") {
+    return;
+  }
+  try {
+    await response.body.cancel();
+  } catch {
+  }
+}
 function shouldRetryError(error) {
   return error.isNetworkError && error.code !== "aborted";
 }
@@ -541,6 +550,7 @@ async function executeRaw(requestOptions, options) {
       );
       syncResponseContext(response, options);
       if (retry && shouldUseRetry && attempt < maxAttempts && shouldRetryResponse(response, retry)) {
+        await disposeRetryResponse(response);
         const delayMs = computeRetryDelayMs(attempt, retry);
         await sleep(delayMs, requestOptions.signal);
         continue;
@@ -1079,14 +1089,13 @@ import {
 } from "ptech-shell-sdk";
 var DEFAULT_PERMISSIONS = listPermissionsByRole(USER_ROLES.authenticated);
 function createStandalonePermissionService(initialPermissions = DEFAULT_PERMISSIONS) {
-  const listeners = /* @__PURE__ */ new Set();
   const permissions = new Set(initialPermissions);
   return {
     can: (permission) => permissions.has(permission),
     list: () => Array.from(permissions.values()),
-    subscribe: (listener) => {
-      listeners.add(listener);
-      return () => listeners.delete(listener);
+    subscribe: () => {
+      return () => {
+      };
     }
   };
 }
@@ -1121,8 +1130,8 @@ function createNoopTransport() {
   let disconnectListener;
   return {
     start: async () => {
-      messageListener = messageListener;
-      disconnectListener = disconnectListener;
+      void messageListener;
+      void disconnectListener;
     },
     stop: async () => void 0,
     onMessage: (listener) => {
@@ -1169,6 +1178,7 @@ function createStandaloneRealtimeService(options = {}) {
   let unbindMessage;
   let unbindDisconnect;
   let inFlightStart = null;
+  let lifecycleVersion = 0;
   function emitStateChanged() {
     for (const listener of listeners) {
       listener();
@@ -1259,6 +1269,7 @@ function createStandaloneRealtimeService(options = {}) {
       return inFlightStart;
     }
     inFlightStart = (async () => {
+      const startVersion = lifecycleVersion;
       stopRequested = false;
       clearReconnectTimer();
       setState(activeAttempt > 0 ? "reconnecting" : "connecting");
@@ -1271,6 +1282,14 @@ function createStandaloneRealtimeService(options = {}) {
           traceId: context.traceId,
           correlationId: context.correlationId
         });
+        if (stopRequested || startVersion !== lifecycleVersion) {
+          try {
+            await nextTransport.stop();
+          } catch {
+          }
+          setState("disconnected");
+          return;
+        }
         transport = nextTransport;
         await bindTransportListeners(nextTransport);
         activeAttempt = 0;
@@ -1278,6 +1297,10 @@ function createStandaloneRealtimeService(options = {}) {
       } catch {
         transport = null;
         unbindTransportListeners();
+        if (stopRequested || startVersion !== lifecycleVersion) {
+          setState("disconnected");
+          return;
+        }
         scheduleReconnect();
       }
     })();
@@ -1288,6 +1311,7 @@ function createStandaloneRealtimeService(options = {}) {
     }
   }
   async function stopInternal() {
+    lifecycleVersion += 1;
     stopRequested = true;
     clearReconnectTimer();
     const current = transport;
@@ -1460,23 +1484,13 @@ function createStandaloneSharedStateService() {
         return;
       }
       const listeners = requestListenersByKey.get(request.key);
-      if (!listeners || listeners.size === 0) {
-        throw new Error(
-          `No owner request handler for key "${request.key}". Owner is "${current.owner}".`
-        );
-      }
-      let handled = false;
-      for (const sub of listeners) {
-        if (sub.owner === current.owner) {
-          handled = true;
-          sub.listener(request);
-        }
-      }
-      if (!handled) {
+      const ownerListener = listeners?.get(current.owner);
+      if (!ownerListener) {
         throw new Error(
           `Owner "${current.owner}" has no active request handler for key "${request.key}".`
         );
       }
+      ownerListener(request);
     },
     subscribeKey: (key, listener) => {
       let listeners = listenersByKey.get(key);
@@ -1496,17 +1510,18 @@ function createStandaloneSharedStateService() {
     subscribeRequests: (key, owner, listener) => {
       let listeners = requestListenersByKey.get(key);
       if (!listeners) {
-        listeners = /* @__PURE__ */ new Set();
+        listeners = /* @__PURE__ */ new Map();
         requestListenersByKey.set(key, listeners);
       }
-      const sub = {
-        owner,
-        listener
-      };
-      listeners.add(sub);
+      listeners.set(owner, listener);
       return () => {
         const current = requestListenersByKey.get(key);
-        current?.delete(sub);
+        if (!current) {
+          return;
+        }
+        if (current.get(owner) === listener) {
+          current.delete(owner);
+        }
         if (current && current.size === 0) {
           requestListenersByKey.delete(key);
         }
@@ -1579,7 +1594,7 @@ function createStandaloneUserService(seedUser) {
 }
 
 // src/initStandaloneServices.ts
-function initStandaloneServices(options = {}) {
+function createTestServices(options = {}) {
   const {
     apiBase = "http://localhost:4000",
     lang = "vi",
@@ -1587,25 +1602,26 @@ function initStandaloneServices(options = {}) {
     observability: observabilityConfig = {},
     observabilityOptions,
     realtime: realtimeOptions,
-    customize,
-    registerMode = "if-missing"
+    navigationPath = "/standalone",
+    featureFlags = {},
+    runtimeConfig = {}
   } = options;
   const userService = createStandaloneUserService(user ?? null);
   const notificationService = createStandaloneNotificationService();
   const requestContext = createRequestContextService();
-  const services = {
+  return {
     i18n: createStandaloneI18nService(lang),
     userService,
     apiClient: createStandaloneApiClient({
       apiBase,
-      userService,
+      getUserService: () => getService(TOKENS.userService) ?? userService,
       notificationService,
       requestContext
     }),
-    navigation: createStandaloneNavigationService("/standalone"),
+    navigation: createStandaloneNavigationService(navigationPath),
     configService: createStandaloneConfigService(
-      { [FEATURE_FLAGS2.uiExperimental]: true },
-      { envName: "standalone", apiBase }
+      { [FEATURE_FLAGS2.uiExperimental]: true, ...featureFlags },
+      { envName: runtimeConfig.envName ?? "standalone", apiBase: runtimeConfig.apiBase ?? apiBase }
     ),
     permissionService: createStandalonePermissionService(),
     sharedState: createStandaloneSharedStateService(),
@@ -1622,6 +1638,10 @@ function initStandaloneServices(options = {}) {
     notification: notificationService,
     analytics: createStandaloneAnalyticsService()
   };
+}
+function initStandaloneServices(options = {}) {
+  const { customize, registerMode = "if-missing" } = options;
+  const services = createTestServices(options);
   customize?.(services);
   services.sharedState.ensureKey(SHARED_STATE_KEYS.x, "host", 0);
   services.sharedState.subscribeRequests(SHARED_STATE_KEYS.x, "host", (request) => {
@@ -1633,42 +1653,30 @@ function initStandaloneServices(options = {}) {
       data: { nextValue: request.nextValue, reason: request.reason ?? "" }
     });
   });
-  if (registerMode === "always" || !getService(TOKENS.i18n)) {
-    registerService(TOKENS.i18n, services.i18n);
-  }
-  if (registerMode === "always" || !getService(TOKENS.userService)) {
-    registerService(TOKENS.userService, services.userService);
-  }
-  if (registerMode === "always" || !getService(TOKENS.apiClient)) {
-    registerService(TOKENS.apiClient, services.apiClient);
-  }
-  if (registerMode === "always" || !getService(TOKENS.navigation)) {
-    registerService(TOKENS.navigation, services.navigation);
-  }
-  if (registerMode === "always" || !getService(TOKENS.configService)) {
-    registerService(TOKENS.configService, services.configService);
-  }
-  if (registerMode === "always" || !getService(TOKENS.permissionService)) {
-    registerService(TOKENS.permissionService, services.permissionService);
-  }
-  if (registerMode === "always" || !getService(TOKENS.sharedState)) {
-    registerService(TOKENS.sharedState, services.sharedState);
-  }
-  if (registerMode === "always" || !getService(TOKENS.requestContext)) {
-    registerService(TOKENS.requestContext, services.requestContext);
-  }
-  if (registerMode === "always" || !getService(TOKENS.realtime)) {
-    registerService(TOKENS.realtime, services.realtime);
-  }
-  if (registerMode === "always" || !getService(TOKENS.observability)) {
-    registerService(TOKENS.observability, services.observability);
-  }
-  if (registerMode === "always" || !getService(TOKENS.notification)) {
-    registerService(TOKENS.notification, services.notification);
-  }
-  if (registerMode === "always" || !getService(TOKENS.analytics)) {
-    registerService(TOKENS.analytics, services.analytics);
-  }
+  const tokenServiceMap = [
+    [TOKENS.i18n, services.i18n],
+    [TOKENS.userService, services.userService],
+    [TOKENS.apiClient, services.apiClient],
+    [TOKENS.navigation, services.navigation],
+    [TOKENS.configService, services.configService],
+    [TOKENS.permissionService, services.permissionService],
+    [TOKENS.sharedState, services.sharedState],
+    [TOKENS.requestContext, services.requestContext],
+    [TOKENS.realtime, services.realtime],
+    [TOKENS.observability, services.observability],
+    [TOKENS.notification, services.notification],
+    [TOKENS.analytics, services.analytics]
+  ];
+  for (const [token, service] of tokenServiceMap) {
+    if (registerMode === "always" || !getService(token)) {
+      registerService(token, service);
+    }
+  }
+}
+function createDevPreset(defaults) {
+  return (overrides) => {
+    initStandaloneServices({ ...defaults, ...overrides });
+  };
 }
 
 // src/services/apiErrorMapper.ts
@@ -2074,6 +2082,8 @@ function createReactRouterNavigationAdapter(options = {}) {
     syncFromRouter: (location, action, capabilities) => {
       const normalizedLocation = normalizeLocation(location);
       const runtimeIndex = capabilities?.historyIndex ?? resolveWindowHistoryIndex();
+      let canGoBack = capabilities?.canGoBack;
+      let canGoForward = capabilities?.canGoForward;
       if (typeof runtimeIndex === "number" && Number.isInteger(runtimeIndex)) {
         currentIndex = runtimeIndex;
         if (runtimeIndex > maxIndex) {
@@ -2082,11 +2092,13 @@ function createReactRouterNavigationAdapter(options = {}) {
       } else if (action === "PUSH") {
         currentIndex += 1;
         maxIndex = currentIndex;
-      } else if (action === "POP" && currentIndex > 0) {
-        currentIndex -= 1;
+      } else if (action === "POP") {
+        const hasHistoryContext = snapshot.canGoBack || snapshot.canGoForward;
+        canGoBack ??= hasHistoryContext;
+        canGoForward ??= hasHistoryContext;
       }
-      const canGoBack = capabilities?.canGoBack ?? currentIndex > 0;
-      const canGoForward = capabilities?.canGoForward ?? currentIndex < maxIndex;
+      canGoBack ??= currentIndex > 0;
+      canGoForward ??= currentIndex < maxIndex;
       setSnapshot({
         action,
         location: normalizedLocation,
@@ -2150,6 +2162,7 @@ function hasSnapshotChanged(previous, nextValue) {
 }
 export {
   ApiError,
+  createDevPreset,
   createMsalUserService,
   createReactRouterNavigationAdapter,
   createRequestContextService,
@@ -2157,6 +2170,7 @@ export {
   createStandaloneI18nService,
   createStandaloneRealtimeService,
   createStandaloneUserService,
+  createTestServices,
   initStandaloneServices,
   isApiError,
   mapApiErrorToUiError

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "ptech-shell-dev",
-   "version": "1.6.7",
-  "description": "Standalone/mock shell service implementations for Module Federation apps.",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --out-dir dist --clean",
-    "dev": "tsup src/index.ts --format esm --dts --out-dir dist --watch",
-    "test": "npm run build && node --test tests/*.test.mjs",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "ptech-shell-sdk": "^1.6.5"
-  },
+{
+  "name": "ptech-shell-dev",
+   "version": "1.7.0",
+  "description": "Standalone/mock shell service implementations for Module Federation apps.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --out-dir dist --clean",
+    "dev": "tsup src/index.ts --format esm --dts --out-dir dist --watch",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ptech-shell-sdk": "^1.7.0"
+  },
   "peerDependencies": {
     "react": ">=18"
   },
   "devDependencies": {
-    "@types/react": "^19.2.13 ",
+    "@types/react": "^19.2.13",
     "react": "^19.2.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
-  "keywords": [
-    "micro-frontend",
-    "module-federation",
-    "shell",
-    "standalone",
-    "mock"
-  ],
-  "license": "MIT"
-}
+  "keywords": [
+    "micro-frontend",
+    "module-federation",
+    "shell",
+    "standalone",
+    "mock"
+  ],
+  "license": "MIT"
+}