@stacksjs/bun-router 0.0.17 → 0.0.18

package/src/url.ts

@@ -1,131 +0,0 @@
-/**
- * Named-route URL generation
- *
- * A module-level registry of `name → path` populated by both `Router` and
- * `FluentRouter` whenever a route is given a name. `url(name, params)`
- * resolves a registered name into a URL with path parameters substituted
- * and unmatched params appended as a query string.
- */
-
-import process from 'node:process'
-
-const namedRouteRegistry: Map<string, string> = new Map()
-
-/**
- * Register a named-route path. Called by Router/FluentRouter when a route
- * gets a `.name()`.
- */
-export function registerNamedRoute(name: string, path: string): void {
-  namedRouteRegistry.set(name, path)
-}
-
-/**
- * Look up a registered named-route path without parameter substitution.
- * Mostly useful for tests and tooling.
- */
-export function getNamedRoutePath(name: string): string | undefined {
-  return namedRouteRegistry.get(name)
-}
-
-/**
- * Returns a snapshot of every registered named-route. The map itself is not
- * exposed so callers can't mutate the registry.
- */
-export function getNamedRoutes(): ReadonlyMap<string, string> {
-  return new Map(namedRouteRegistry)
-}
-
-/**
- * Clear the registry. Provided for tests; production code should not need it.
- */
-export function clearNamedRoutes(): void {
-  namedRouteRegistry.clear()
-}
-
-export interface UrlOptions {
-  /**
-   * Return a fully-qualified URL using `process.env.APP_URL` (falling back to
-   * `http://localhost`) instead of a path. Defaults to `false`.
-   */
-  absolute?: boolean
-  /**
-   * Override the base used for `absolute: true`. Wins over `APP_URL`.
-   */
-  base?: string
-}
-
-/**
- * Generate a URL for a named route.
- *
- * @example
- * ```ts
- * router.get('/users/{id}', handler).name('users.show')
- *
- * url('users.show', { id: 42 })
- * // → '/users/42'
- *
- * url('users.show', { id: 42, tab: 'profile' })
- * // → '/users/42?tab=profile'
- *
- * url('users.show', { id: 42 }, { absolute: true })
- * // → 'https://app.example/users/42'  (when APP_URL=https://app.example)
- * ```
- */
-export function url(
-  name: string,
-  params: Record<string, string | number | boolean> = {},
-  options: UrlOptions = {},
-): string {
-  const path = namedRouteRegistry.get(name)
-  if (!path) {
-    const known = [...namedRouteRegistry.keys()].sort().join(', ') || '(none registered)'
-    throw new Error(`Named route '${name}' is not defined. Known routes: ${known}`)
-  }
-
-  const consumed = new Set<string>()
-  let resolved = path
-
-  for (const [key, value] of Object.entries(params)) {
-    const required = `{${key}}`
-    const optional = `{${key}?}`
-    const encoded = encodeURIComponent(String(value))
-
-    if (resolved.includes(required)) {
-      resolved = resolved.replaceAll(required, encoded)
-      consumed.add(key)
-    }
-    else if (resolved.includes(optional)) {
-      resolved = resolved.replaceAll(optional, encoded)
-      consumed.add(key)
-    }
-  }
-
-  // Strip any unfilled optional placeholders and tidy the slashes they
-  // leave behind (`/posts/{slug?}` → `/posts`, `/a/{v?}/b` → `/a/b`)
-  if (resolved.includes('?}')) {
-    resolved = resolved.replace(/\{[^}]+\?\}/g, '').replace(/\/{2,}/g, '/')
-    if (resolved.length > 1 && resolved.endsWith('/'))
-      resolved = resolved.slice(0, -1)
-  }
-
-  // Throw on unfilled required placeholders so the caller sees the bug.
-  const missing = resolved.match(/\{([^}?]+)\}/g)
-  if (missing && missing.length > 0)
-    throw new Error(`Missing required params for route '${name}': ${missing.join(', ')}`)
-
-  // Append leftover params as query string.
-  const leftover = Object.entries(params).filter(([k]) => !consumed.has(k))
-  if (leftover.length > 0) {
-    const qs = new URLSearchParams()
-    for (const [k, v] of leftover) qs.set(k, String(v))
-    resolved += `?${qs.toString()}`
-  }
-
-  if (options.absolute) {
-    const base = (options.base ?? process.env.APP_URL ?? 'http://localhost').replace(/\/$/, '')
-    const prefixed = base.startsWith('http') ? base : `https://${base}`
-    return `${prefixed}${resolved.startsWith('/') ? resolved : `/${resolved}`}`
-  }
-
-  return resolved
-}

package/src/utils/index.ts

@@ -1 +0,0 @@
-export * from './query-preservation'

package/src/utils/query-preservation.ts

@@ -1,201 +0,0 @@
-/**
- * Query Parameter Preservation
- *
- * Automatically preserves specified query parameters across navigation.
- * This is useful for maintaining state like siteId, theme, locale, etc.
- */
-
-export interface QueryPreservationConfig {
-  /**
-   * Whether query preservation is enabled
-   * Default: true when preserve array is non-empty
-   */
-  enabled?: boolean
-
-  /**
-   * Query parameters to preserve across navigation
-   * Example: ['siteId', 'theme', 'locale']
-   */
-  preserve?: string[]
-
-  /**
-   * Query parameters to never preserve (takes precedence over preserve)
-   * Example: ['_t', 'utm_source']
-   */
-  exclude?: string[]
-
-  /**
-   * URL patterns where preservation should apply
-   * Default: all internal links (same origin)
-   * Example: ['/dashboard/*', '/admin/*']
-   */
-  routes?: string[]
-}
-
-/**
- * Default configuration
- */
-export const defaultQueryPreservationConfig: QueryPreservationConfig = {
-  enabled: true,
-  preserve: [],
-  exclude: ['_t', '_cache', 'callback'],
-  routes: [],
-}
-
-/* eslint-disable prefer-const */
-/**
- * Generate the client-side script for query preservation
- * This script intercepts link clicks and preserves specified query params
- */
-export function generateQueryPreservationScript(config: QueryPreservationConfig): string {
-  const { preserve = [], exclude = [], routes = [] } = config
-
-  if (!preserve.length) {
-    return ''
-  }
-
-  // Minified but readable client-side script
-  return `<script data-query-preservation>
-(function(){
-  var preserve = ${JSON.stringify(preserve)};
-  var exclude = ${JSON.stringify(exclude)};
-  var routes = ${JSON.stringify(routes)};
-
-  function shouldPreserve(href) {
-    // Only preserve for same-origin links
-    try {
-      var url = new URL(href, window.location.origin);
-      if (url.origin !== window.location.origin) return false;
-      // Check route patterns if specified
-      if (routes.length) {
-        var path = url.pathname;
-        return routes.some(function(pattern) {
-          if (pattern.endsWith('*')) {
-            return path.startsWith(pattern.slice(0, -1));
-          }
-          // eslint-disable-next-line prefer-template
-          return path === pattern || path.startsWith(pattern + '/');
-        });
-      }
-      return true;
-    }
-catch (e) { return false; }
-  }
-
-  function getPreservedParams() {
-    var current = new URLSearchParams(window.location.search);
-    var preserved = {};
-    preserve.forEach(function(key) {
-      if (current.has(key) && exclude.indexOf(key) === -1) {
-        preserved[key] = current.get(key);
-      }
-    });
-    return preserved;
-  }
-
-  function enhanceUrl(href) {
-    var url = new URL(href, window.location.origin);
-    var preserved = getPreservedParams();
-    Object.keys(preserved).forEach(function(key) {
-      if (!url.searchParams.has(key)) {
-        url.searchParams.set(key, preserved[key]);
-      }
-    });
-    return url.toString();
-  }
-
-  // Intercept all link clicks
-  document.addEventListener('click', function(e) {
-    var link = e.target.closest('a[href]');
-    if (!link) return;
-
-    var href = link.getAttribute('href');
-    if (!href || href.startsWith('#') || href.startsWith('javascript:') ||
-        href.startsWith('mailto:') || href.startsWith('tel:')) return;
-
-    if (!shouldPreserve(href)) return;
-
-    // Check if link already has all preserved params
-    var enhanced = enhanceUrl(href);
-    if (enhanced !== new URL(href, window.location.origin).toString()) {
-      e.preventDefault();
-      window.location.href = enhanced;
-    }
-  });
-
-  // Expose API for programmatic navigation
-  window.__preserveQuery = {
-    enhance: enhanceUrl,
-    getPreserved: getPreservedParams,
-    navigate: function(href) {
-      window.location.href = enhanceUrl(href);
-    }
-  };
-})();
-</script>`
-}
-
-/**
- * Inject the query preservation script into HTML content
- * Inserts before </head> or </body> if </head> not found
- */
-export function injectQueryPreservationScript(
-  html: string,
-  config: QueryPreservationConfig
-): string {
-  if (!config.enabled || !config.preserve?.length) {
-    return html
-  }
-
-  const script = generateQueryPreservationScript(config)
-  if (!script) {
-    return html
-  }
-
-  // Try to inject before </head> for early execution
-  if (html.includes('</head>')) {
-    return html.replace('</head>', `${script}\n</head>`)
-  }
-
-  // Fallback: inject before </body>
-  if (html.includes('</body>')) {
-    return html.replace('</body>', `${script}\n</body>`)
-  }
-
-  // Last resort: append to end
-  return html + script
-}
-
-/**
- * Build a URL with preserved query parameters
- * Server-side utility for generating links
- */
-export function buildUrlWithPreservedParams(
-  path: string,
-  currentUrl: string | URL,
-  config: QueryPreservationConfig,
-  additionalParams?: Record<string, string>
-): string {
-  const current = typeof currentUrl === 'string' ? new URL(currentUrl) : currentUrl
-  const target = new URL(path, current.origin)
-
-  // Preserve specified params from current URL
-  if (config.preserve) {
-    for (const key of config.preserve) {
-      if (current.searchParams.has(key) && !config.exclude?.includes(key)) {
-        if (!target.searchParams.has(key)) {
-          target.searchParams.set(key, current.searchParams.get(key)!)
-        }
-      }
-    }
-  }
-
-  // Add any additional params
-  if (additionalParams) {
-    for (const [key, value] of Object.entries(additionalParams)) {
-      target.searchParams.set(key, value)
-    }
-  }
-
-  return target.pathname + target.search
-}