@strav/http 0.2.7 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strav/http",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
   "description": "HTTP layer for the Strav framework — router, server, middleware, authentication, sessions, validation, and views",
   "license": "MIT",
@@ -36,8 +36,8 @@
     "./providers/*": "./src/providers/*.ts"
   },
   "peerDependencies": {
-    "@strav/kernel": "0.2.6",
-    "@strav/database": "0.2.6"
+    "@strav/kernel": "0.2.8",
+    "@strav/database": "0.2.8"
   },
   "dependencies": {
     "@vue/compiler-sfc": "^3.5.28",

package/src/http/context.ts

@@ -67,6 +67,22 @@ export default class Context {
     return this._subdomain
   }
 
+  /**
+   * Get the full origin (protocol + host) of the current request.
+   * Uses the X-Forwarded-Proto header if present (common behind proxies),
+   * otherwise determines from the request URL.
+   */
+  getOrigin(): string {
+    // Check for forwarded protocol (when behind proxy/load balancer)
+    const forwardedProto = this.headers.get('x-forwarded-proto')
+    const protocol = forwardedProto ? `${forwardedProto}:` : this.url.protocol
+
+    // Get host from header (includes port if non-standard)
+    const host = this.headers.get('host') || this.url.host
+
+    return `${protocol}//${host}`
+  }
+
   /** Shorthand for reading a single request header. */
   header(name: string): string | null {
     return this.headers.get(name)

package/src/http/index.ts

@@ -8,7 +8,7 @@ export { compose } from './middleware.ts'
 export { serializeCookie, parseCookies, withCookie, clearCookie } from './cookie.ts'
 export { rateLimit, MemoryStore } from './rate_limit.ts'
 export { Resource } from './resource.ts'
-export { route, routeUrl } from './route_helper.ts'
+export { route, routeUrl, routeFullUrl } from './route_helper.ts'
 export type { Handler, Middleware, Next } from './middleware.ts'
 export type { GroupOptions, WebSocketHandlers, WebSocketData, RouteDefinition } from './router.ts'
 export type { CookieOptions } from './cookie.ts'

package/src/http/route_helper.ts

@@ -1,5 +1,7 @@
 import { router } from './index.ts'
 import type { RouteDefinition } from './router.ts'
+import { app } from '@strav/kernel/core/application'
+import Configuration from '@strav/kernel/config/configuration'
 
 export interface RouteOptions extends Omit<RequestInit, 'body'> {
   params?: Record<string, any>
@@ -131,4 +133,62 @@ export async function route(
  */
 export function routeUrl(name: string, params?: Record<string, any>): string {
   return router.generateUrl(name, params)
+}
+
+/**
+ * Generate a full URL (with protocol and domain) for a named route.
+ *
+ * Uses the APP_URL from configuration if set, otherwise constructs from
+ * the current request context (requires passing the context).
+ *
+ * @example
+ * // With APP_URL configured
+ * const resetUrl = routeFullUrl('auth.password.reset', { token: 'abc123' })
+ * // Returns 'https://example.com/auth/password-reset?token=abc123'
+ *
+ * // With request context
+ * const profileUrl = routeFullUrl('users.profile', { id: 456 }, ctx)
+ * // Returns 'https://example.com/users/456'
+ *
+ * // Override the base URL
+ * const apiUrl = routeFullUrl('api.users', {}, null, 'https://api.example.com')
+ * // Returns 'https://api.example.com/api/users'
+ */
+export function routeFullUrl(
+  name: string,
+  params?: Record<string, any>,
+  context?: { getOrigin(): string } | null,
+  baseUrl?: string
+): string {
+  const path = routeUrl(name, params)
+
+  // Use provided base URL if given
+  if (baseUrl) {
+    return baseUrl.replace(/\/$/, '') + path
+  }
+
+  // Try to get app_url from config
+  const config = app.resolve(Configuration)
+  const appUrl = config.get('http.app_url') as string | undefined
+
+  if (appUrl) {
+    return appUrl.replace(/\/$/, '') + path
+  }
+
+  // Fall back to context origin
+  if (context) {
+    return context.getOrigin() + path
+  }
+
+  // If no context and no config, construct from http config
+  const protocol = config.get('http.secure', false) ? 'https' : 'http'
+  const domain = config.get('http.domain', 'localhost') as string
+  const port = config.get('http.port', 3000) as number
+
+  // Only include port if non-standard
+  const includePort = (protocol === 'http' && port !== 80) ||
+                      (protocol === 'https' && port !== 443)
+  const host = includePort ? `${domain}:${port}` : domain
+
+  return `${protocol}://${host}${path}`
 }

package/src/index.ts

@@ -6,4 +6,9 @@ export * from './auth/index.ts'
 export * from './providers/index.ts'
 
 // Route helpers for named route invocation
-export { route, routeUrl } from './http/route_helper.ts'
+export { route, routeUrl, routeFullUrl } from './http/route_helper.ts'
+
+// Middleware exports for cross-package functionality
+export { httpCache } from './middleware/http_cache.ts'
+export { i18n } from './middleware/i18n.ts'
+export { requestLogger } from './middleware/request_logger.ts'