@real-router/browser-plugin 0.7.0 → 0.9.0

package/src/browser.ts

@@ -1,128 +0,0 @@
-// packages/browser-plugin/modules/browser.ts
-
-import { logger } from "@real-router/logger";
-
-import { LOGGER_CONTEXT } from "./constants";
-import { createRegExpCache, extractPath } from "./url-utils";
-
-import type { Browser, BrowserPluginOptions, URLParseOptions } from "./types";
-import type { State } from "@real-router/core";
-
-/** No-operation cleanup function for fallback browser */
-const NOOP = (): void => {};
-
-const pushState = (state: State, path: string) => {
-  globalThis.history.pushState(state, "", path);
-};
-
-const replaceState = (state: State, path: string) => {
-  globalThis.history.replaceState(state, "", path);
-};
-
-const addPopstateListener: Browser["addPopstateListener"] = (fn) => {
-  globalThis.addEventListener("popstate", fn);
-
-  return () => {
-    globalThis.removeEventListener("popstate", fn);
-  };
-};
-
-const regExpCache = createRegExpCache();
-
-/**
- * Safely encodes/decodes path to normalize URL encoding
- *
- * @param path - Path to normalize
- * @returns Normalized path or original on error
- */
-const safelyEncodePath = (path: string): string => {
-  try {
-    return encodeURI(decodeURI(path));
-  } catch (error) {
-    logger.warn(LOGGER_CONTEXT, `Could not encode path "${path}"`, error);
-
-    return path;
-  }
-};
-
-const getLocation = (opts: BrowserPluginOptions) => {
-  const rawPath = extractPath(
-    globalThis.location.pathname,
-    globalThis.location.hash,
-    opts as URLParseOptions,
-    regExpCache,
-  );
-
-  return safelyEncodePath(rawPath) + globalThis.location.search;
-};
-
-/**
- * Gets current URL hash
- */
-const getHash = () => globalThis.location.hash;
-
-/**
- * Creates a fallback browser for non-browser environments (SSR).
- * Logs warning on first method call to help diagnose misconfiguration.
- *
- * @returns Browser API with no-op implementations
- */
-function createFallbackBrowser(): Browser {
-  let hasWarned = false;
-
-  const warnOnce = (method: string) => {
-    if (!hasWarned) {
-      logger.warn(
-        LOGGER_CONTEXT,
-        `Browser plugin is running in a non-browser environment. ` +
-          `Method "${method}" is a no-op. ` +
-          `This is expected for SSR, but may indicate misconfiguration if you expected browser behavior.`,
-      );
-      hasWarned = true;
-    }
-  };
-
-  return {
-    pushState: () => {
-      warnOnce("pushState");
-    },
-    replaceState: () => {
-      warnOnce("replaceState");
-    },
-    addPopstateListener: () => {
-      warnOnce("addPopstateListener");
-
-      return NOOP;
-    },
-    getLocation: () => {
-      warnOnce("getLocation");
-
-      return "";
-    },
-    getHash: () => {
-      warnOnce("getHash");
-
-      return "";
-    },
-  };
-}
-
-/**
- * Creates browser API abstraction that works in both browser and SSR environments
- *
- * @returns Browser API object
- */
-export function createSafeBrowser(): Browser {
-  const isBrowser =
-    typeof globalThis.window !== "undefined" && !!globalThis.history;
-
-  return isBrowser
-    ? {
-        pushState,
-        replaceState,
-        addPopstateListener,
-        getLocation,
-        getHash,
-      }
-    : createFallbackBrowser();
-}

package/src/popstate-utils.ts

@@ -1,60 +0,0 @@
-import { isStateStrict as isState } from "type-guards";
-
-import type { BrowserPluginOptions, Browser } from "./types";
-import type { PluginApi, State, Params } from "@real-router/core";
-
-/**
- * Extracts route name and params from a popstate event.
- *
- * - If history.state is a valid router state → returns name/params from it
- * - If not (e.g. manually entered URL) → matches current URL against route tree
- * - Returns undefined if no route matches
- *
- * @param evt - PopStateEvent from browser
- * @param api - PluginApi instance
- * @param browser - Browser API instance
- * @param options - Browser plugin options
- * @returns Route identifier or undefined
- */
-export function getRouteFromEvent(
-  evt: PopStateEvent,
-  api: PluginApi,
-  browser: Browser,
-  options: BrowserPluginOptions,
-): { name: string; params: Params } | undefined {
-  if (isState(evt.state)) {
-    return { name: evt.state.name, params: evt.state.params };
-  }
-
-  const state = api.matchPath(browser.getLocation(options));
-
-  return state ? { name: state.name, params: state.params } : undefined;
-}
-
-/**
- * Updates browser state (pushState or replaceState)
- *
- * @param state - Router state
- * @param url - URL to set
- * @param replace - Whether to replace instead of push
- * @param browser - Browser API instance
- */
-export function updateBrowserState(
-  state: State,
-  url: string,
-  replace: boolean,
-  browser: Browser,
-): void {
-  const historyState = {
-    meta: state.meta,
-    name: state.name,
-    params: state.params,
-    path: state.path,
-  };
-
-  if (replace) {
-    browser.replaceState(historyState, url);
-  } else {
-    browser.pushState(historyState, url);
-  }
-}