@analogjs/router 3.0.0-alpha.6 → 3.0.0-alpha.60

package/fesm2022/src.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src.mjs","names":[],"sources":["../../server/actions/src/actions.ts","../../server/actions/src/parse-request-data.ts","../../server/actions/src/validate.ts","../../server/actions/src/define-action.ts","../../server/actions/src/define-server-route.ts","../../server/actions/src/define-page-load.ts"],"sourcesContent":["import type { H3Event, H3EventContext } from 'nitro/h3';\nimport type { $Fetch } from 'nitro/types';\nimport type { NodeContext } from '../../../src/lib/route-types.js';\n\nexport type PageServerAction = {\n  params: H3EventContext['params'];\n  req: NodeContext['req'];\n  res: NonNullable<NodeContext['res']>;\n  fetch: $Fetch;\n  event: H3Event;\n};\n\nexport function fail<T = object>(status: number, errors: T): Response {\n  return new Response(JSON.stringify(errors), {\n    status,\n    headers: {\n      'X-Analog-Errors': 'true',\n    },\n  });\n}\n\nexport function json<T = object>(data: T, config?: ResponseInit): Response {\n  return new Response(JSON.stringify(data), {\n    headers: {\n      'Content-Type': 'application/json; charset=utf-8',\n    },\n    ...config,\n  });\n}\n\nexport function redirect(\n  url: string,\n  config: number | ResponseInit = 302,\n): Response {\n  if (typeof config === 'number') {\n    return new Response(null, {\n      status: config,\n      headers: {\n        Location: `${url}`,\n      },\n    });\n  }\n\n  return new Response(null, {\n    headers: {\n      Location: `${url}`,\n    },\n    ...config,\n  });\n}\n","import { readBody, readFormData, toRequest as h3ToRequest } from 'nitro/h3';\n\ntype RequestEntryValue = string | File;\ntype ParsedRequestValue = RequestEntryValue | RequestEntryValue[];\n\nfunction appendEntry(\n  target: Record<string, ParsedRequestValue>,\n  key: string,\n  value: RequestEntryValue,\n) {\n  const existingValue = target[key];\n\n  if (existingValue === undefined) {\n    target[key] = value;\n    return;\n  }\n\n  if (Array.isArray(existingValue)) {\n    existingValue.push(value);\n    return;\n  }\n\n  target[key] = [existingValue, value];\n}\n\nfunction getRequest(event: { method: string; headers: Headers }): Request {\n  const maybeRequest = (event as unknown as { request?: Request }).request;\n  if (maybeRequest) {\n    return maybeRequest;\n  }\n  return h3ToRequest(event as Parameters<typeof h3ToRequest>[0]);\n}\n\nfunction getContentType(event: { method: string; headers: Headers }): string {\n  const request = getRequest(event);\n\n  return (\n    request.headers.get('content-type') ??\n    event.headers.get('content-type') ??\n    event.headers.get('Content-Type') ??\n    ''\n  );\n}\n\nfunction isJsonContentType(contentType: string): boolean {\n  const mimeType = contentType.split(';', 1)[0]?.trim().toLowerCase() ?? '';\n  return mimeType === 'application/json' || mimeType.endsWith('+json');\n}\n\nfunction isFormContentType(contentType: string): boolean {\n  return (\n    contentType.includes('multipart/form-data') ||\n    contentType.includes('application/x-www-form-urlencoded')\n  );\n}\n\nexport function parseSearchParams(\n  searchParams: URLSearchParams,\n): Record<string, ParsedRequestValue> {\n  const result: Record<string, ParsedRequestValue> = {};\n  searchParams.forEach((value, key) => {\n    appendEntry(result, key, value);\n  });\n  return result;\n}\n\nexport function parseFormData(\n  formData: FormData,\n): Record<string, ParsedRequestValue> {\n  const result: Record<string, ParsedRequestValue> = {};\n  formData.forEach((value, key) => {\n    appendEntry(result, key, value as RequestEntryValue);\n  });\n  return result;\n}\n\nexport async function parseRequestData(event: {\n  method: string;\n  headers: Headers;\n}): Promise<unknown> {\n  const request = getRequest(event);\n  const httpEvent = event as unknown as Parameters<typeof readBody>[0];\n  const h3Event = event as unknown as Parameters<typeof readFormData>[0];\n  const method = event.method.toUpperCase();\n\n  if (method === 'GET' || method === 'HEAD') {\n    const url = new URL(request.url, 'http://localhost');\n    return parseSearchParams(url.searchParams);\n  }\n\n  const contentType = getContentType(event);\n\n  if (isJsonContentType(contentType)) {\n    try {\n      return (await readBody(httpEvent)) ?? {};\n    } catch {\n      try {\n        return await request.json();\n      } catch {\n        return {};\n      }\n    }\n  }\n\n  if (isFormContentType(contentType)) {\n    try {\n      return parseFormData(await readFormData(h3Event));\n    } catch {\n      if (typeof request.formData === 'function') {\n        return parseFormData(await request.formData());\n      }\n\n      return {};\n    }\n  }\n\n  try {\n    return (await readBody(httpEvent)) ?? {};\n  } catch {\n    try {\n      return await request.json();\n    } catch {\n      return {};\n    }\n  }\n}\n","import type { StandardSchemaV1 } from '@standard-schema/spec';\n\n/**\n * Validates unknown input against a Standard Schema.\n *\n * Handles both sync and async `validate` implementations — the Standard\n * Schema spec allows either return shape.\n */\nexport async function validateWithSchema<T extends StandardSchemaV1>(\n  schema: T,\n  data: unknown,\n): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<T>>> {\n  return schema['~standard'].validate(data);\n}\n","import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { H3Event, H3EventContext } from 'nitro/h3';\nimport type { $Fetch } from 'nitro/types';\nimport { fail } from './actions';\nimport { parseRequestData } from './parse-request-data';\nimport { validateWithSchema } from './validate';\n\ntype NodeContext = NonNullable<H3Event['node']>;\ntype OptionalSchema = StandardSchemaV1 | undefined;\ntype InferSchema<\n  TSchema extends OptionalSchema,\n  TFallback,\n> = TSchema extends StandardSchemaV1\n  ? StandardSchemaV1.InferOutput<TSchema>\n  : TFallback;\n\nexport interface DefineActionContext<\n  TSchema extends OptionalSchema = undefined,\n  TParamsSchema extends OptionalSchema = undefined,\n> {\n  data: InferSchema<TSchema, Record<string, unknown>>;\n  params: InferSchema<TParamsSchema, H3EventContext['params']>;\n  req: NodeContext['req'];\n  res: NonNullable<NodeContext['res']>;\n  fetch: $Fetch;\n  event: H3Event;\n}\n\nexport interface DefineActionOptions<\n  TSchema extends OptionalSchema = undefined,\n  TParamsSchema extends OptionalSchema = undefined,\n> {\n  schema?: TSchema;\n  params?: TParamsSchema;\n  handler: (\n    context: DefineActionContext<TSchema, TParamsSchema>,\n  ) => Promise<Response> | Response;\n}\n\n/**\n * Creates a server action handler with Standard Schema input validation.\n *\n * Parses the request body (JSON or FormData) and validates it against the\n * provided schema before invoking the handler. On validation failure,\n * returns `fail(422, issues)` with `StandardSchemaV1.Issue[]`.\n * Repeated form fields are preserved as arrays instead of being collapsed\n * to the last value.\n *\n * @example\n * ```typescript\n * import { defineAction, json } from '@analogjs/router/server/actions';\n * import * as v from 'valibot';\n *\n * const Schema = v.object({\n *   email: v.pipe(v.string(), v.email()),\n * });\n *\n * export const action = defineAction({\n *   schema: Schema,\n *   handler: async ({ data }) => {\n *     // data is typed as { email: string }\n *     return json({ ok: true });\n *   },\n * });\n * ```\n */\nexport function defineAction<\n  TSchema extends OptionalSchema = undefined,\n  TParamsSchema extends OptionalSchema = undefined,\n>(options: DefineActionOptions<TSchema, TParamsSchema>) {\n  type Params = InferSchema<TParamsSchema, H3EventContext['params']>;\n\n  function getParams(\n    params: H3EventContext['params'],\n  ): Params | Record<string, never> {\n    return (params ?? {}) as Params | Record<string, never>;\n  }\n\n  return async (ctx: {\n    params: H3EventContext['params'];\n    req: NodeContext['req'];\n    res: NonNullable<NodeContext['res']>;\n    fetch: $Fetch;\n    event: H3Event;\n  }): Promise<Response> => {\n    const rawParams = getParams(ctx.params);\n\n    if (options.params) {\n      const paramsResult = await validateWithSchema(options.params, rawParams);\n      if (paramsResult.issues) {\n        return fail(422, paramsResult.issues);\n      }\n      return handleValidatedRequest(ctx, options, paramsResult.value as Params);\n    }\n\n    return handleValidatedRequest(ctx, options, rawParams as Params);\n  };\n}\n\nasync function handleValidatedRequest<\n  TSchema extends OptionalSchema = undefined,\n  TParamsSchema extends OptionalSchema = undefined,\n>(\n  ctx: {\n    params: H3EventContext['params'];\n    req: NodeContext['req'];\n    res: NonNullable<NodeContext['res']>;\n    fetch: $Fetch;\n    event: H3Event;\n  },\n  options: DefineActionOptions<TSchema, TParamsSchema>,\n  params: InferSchema<TParamsSchema, H3EventContext['params']>,\n) {\n  type Data = InferSchema<TSchema, Record<string, unknown>>;\n  const body = await parseRequestData(ctx.event);\n\n  let data: unknown = body;\n\n  if (options.schema) {\n    const result = await validateWithSchema(options.schema, body);\n    if (result.issues) {\n      return fail(422, result.issues);\n    }\n    data = result.value;\n  }\n\n  return options.handler({\n    data: data as Data,\n    params,\n    req: ctx.req,\n    res: ctx.res,\n    fetch: ctx.fetch,\n    event: ctx.event,\n  });\n}\n","import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { H3Event } from 'nitro/h3';\nimport { getRequestURL } from 'nitro/h3';\nimport { fail, json } from './actions';\nimport { parseRequestData, parseSearchParams } from './parse-request-data';\nimport { validateWithSchema } from './validate';\n\nexport type DefineServerRouteResult = Response | unknown;\n\nexport interface ServerRouteHandler<\n  TQuery = unknown,\n  TBody = unknown,\n  TResult = unknown,\n> {\n  (event: H3Event): Promise<Response>;\n  readonly _types: {\n    readonly query: TQuery;\n    readonly body: TBody;\n    readonly result: TResult;\n  };\n}\n\nexport type InferRouteQuery<T> =\n  T extends ServerRouteHandler<infer Q, any, any> ? Q : never;\nexport type InferRouteBody<T> =\n  T extends ServerRouteHandler<any, infer B, any> ? B : never;\nexport type InferRouteResult<T> =\n  T extends ServerRouteHandler<any, any, infer R>\n    ? Exclude<R, Response>\n    : never;\n\ntype OptionalSchema = StandardSchemaV1 | undefined;\ntype InferSchema<\n  TSchema extends OptionalSchema,\n  TFallback = unknown,\n> = TSchema extends StandardSchemaV1\n  ? StandardSchemaV1.InferOutput<TSchema>\n  : TFallback;\ntype ResolveDataSchema<\n  TInput extends OptionalSchema,\n  TQuery extends OptionalSchema,\n  TBody extends OptionalSchema,\n> = TInput extends StandardSchemaV1\n  ? StandardSchemaV1.InferOutput<TInput>\n  : TQuery extends StandardSchemaV1\n    ? TBody extends StandardSchemaV1\n      ?\n          | StandardSchemaV1.InferOutput<TQuery>\n          | StandardSchemaV1.InferOutput<TBody>\n      : StandardSchemaV1.InferOutput<TQuery>\n    : TBody extends StandardSchemaV1\n      ? StandardSchemaV1.InferOutput<TBody>\n      : unknown;\n\nexport interface DefineServerRouteContext<\n  TInput extends StandardSchemaV1 | undefined = undefined,\n  TQuery extends StandardSchemaV1 | undefined = undefined,\n  TBody extends StandardSchemaV1 | undefined = undefined,\n  TParams extends StandardSchemaV1 | undefined = undefined,\n> {\n  data: ResolveDataSchema<TInput, TQuery, TBody>;\n  query: InferSchema<TQuery, undefined>;\n  body: InferSchema<TBody, undefined>;\n  params: InferSchema<TParams, H3Event['context']['params']>;\n  event: H3Event;\n}\n\nexport interface DefineServerRouteOptions<\n  TInput extends StandardSchemaV1 | undefined = undefined,\n  TOutput extends StandardSchemaV1 | undefined = undefined,\n  TQuery extends StandardSchemaV1 | undefined = undefined,\n  TBody extends StandardSchemaV1 | undefined = undefined,\n  TParams extends StandardSchemaV1 | undefined = undefined,\n  TResult extends DefineServerRouteResult = DefineServerRouteResult,\n> {\n  input?: TInput;\n  query?: TQuery;\n  body?: TBody;\n  params?: TParams;\n  output?: TOutput;\n  handler: (\n    context: DefineServerRouteContext<TInput, TQuery, TBody, TParams>,\n  ) => Promise<TResult> | TResult;\n}\n\nfunction isDevEnvironment() {\n  return (\n    typeof process !== 'undefined' &&\n    (process.env['NODE_ENV'] === 'development' ||\n      process.env['NODE_ENV'] === 'test')\n  );\n}\n\nfunction warnOnOutputIssues(issues: ReadonlyArray<StandardSchemaV1.Issue>) {\n  console.warn(\n    `[analog] Server route output validation failed:\\n` +\n      issues\n        .map((i) => {\n          const path = i.path\n            ? ` at \"${i.path.map((p) => (typeof p === 'object' ? (p as { key: string }).key : p)).join('.')}\"`\n            : '';\n          return `  - ${i.message}${path}`;\n        })\n        .join('\\n'),\n  );\n}\n\nfunction getRequestUrl(event: H3Event): string {\n  try {\n    return getRequestURL(event).href;\n  } catch {\n    return (event as H3Event & { request: Request }).request.url;\n  }\n}\n\n/**\n * Creates an h3-compatible event handler with Standard Schema validation.\n *\n * - `input` schema validates the request body (POST/PUT/PATCH) or query\n *   params (GET). Returns 422 with `StandardSchemaV1.Issue[]` on failure.\n * - `output` schema validates the response in development only (stripped\n *   in production for zero overhead). Logs a warning on mismatch.\n * - Plain return values are serialized with `json(...)`; raw `Response`\n *   objects are returned unchanged.\n *\n * @example\n * ```typescript\n * import { defineServerRoute } from '@analogjs/router/server/actions';\n * import * as v from 'valibot';\n *\n * const Input = v.object({\n *   name: v.pipe(v.string(), v.minLength(1)),\n *   email: v.pipe(v.string(), v.email()),\n * });\n * const Output = v.object({\n *   id: v.string(),\n *   name: v.string(),\n * });\n *\n * export default defineServerRoute({\n *   input: Input,\n *   output: Output,\n *   handler: async ({ data }) => {\n *     const user = await db.users.create(data);\n *     return user;\n *   },\n * });\n * ```\n */\nexport function defineServerRoute<\n  TInput extends StandardSchemaV1 | undefined = undefined,\n  TOutput extends StandardSchemaV1 | undefined = undefined,\n  TQuery extends StandardSchemaV1 | undefined = undefined,\n  TBody extends StandardSchemaV1 | undefined = undefined,\n  TParams extends StandardSchemaV1 | undefined = undefined,\n  TResult extends DefineServerRouteResult = DefineServerRouteResult,\n>(\n  options: DefineServerRouteOptions<\n    TInput,\n    TOutput,\n    TQuery,\n    TBody,\n    TParams,\n    TResult\n  >,\n): ServerRouteHandler<\n  InferSchema<TQuery, undefined>,\n  InferSchema<TBody, undefined>,\n  TResult\n> {\n  return (async (event: H3Event): Promise<Response> => {\n    const method = event.method.toUpperCase();\n    let data: unknown;\n    let query: unknown;\n    let body: unknown;\n    let params: unknown = event.context?.params ?? {};\n\n    if (options.params) {\n      const paramsResult = await validateWithSchema(options.params, params);\n      if (paramsResult.issues) {\n        return fail(422, paramsResult.issues);\n      }\n      params = paramsResult.value;\n    }\n\n    if (options.input) {\n      data = await parseRequestData(event);\n\n      const inputResult = await validateWithSchema(options.input, data);\n      if (inputResult.issues) {\n        return fail(422, inputResult.issues);\n      }\n      data = inputResult.value;\n    } else {\n      if (options.query) {\n        const url = new URL(getRequestUrl(event), 'http://localhost');\n        const queryResult = await validateWithSchema(\n          options.query,\n          parseSearchParams(url.searchParams),\n        );\n        if (queryResult.issues) {\n          return fail(422, queryResult.issues);\n        }\n        query = queryResult.value;\n      }\n\n      if (options.body && method !== 'GET' && method !== 'HEAD') {\n        body = await parseRequestData(event);\n        const bodyResult = await validateWithSchema(options.body, body);\n        if (bodyResult.issues) {\n          return fail(422, bodyResult.issues);\n        }\n        body = bodyResult.value;\n      }\n\n      if (method === 'GET' || method === 'HEAD') {\n        data = query;\n      } else if (body !== undefined) {\n        data = body;\n      } else {\n        data = query;\n      }\n    }\n\n    const result = await options.handler({\n      data: data as ResolveDataSchema<TInput, TQuery, TBody>,\n      query: query as InferSchema<TQuery, undefined>,\n      body: body as InferSchema<TBody, undefined>,\n      params: params as InferSchema<TParams, H3Event['context']['params']>,\n      event,\n    });\n\n    if (result instanceof Response) {\n      return result;\n    }\n\n    if (options.output && isDevEnvironment()) {\n      const outputResult = await validateWithSchema(options.output, result);\n      if (outputResult.issues) {\n        warnOnOutputIssues(outputResult.issues);\n      }\n    }\n\n    return json(result);\n  }) as ServerRouteHandler<\n    InferSchema<TQuery, undefined>,\n    InferSchema<TBody, undefined>,\n    TResult\n  >;\n}\n","import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { H3Event, H3EventContext } from 'nitro/h3';\nimport { getRequestURL } from 'nitro/h3';\nimport type { $Fetch } from 'nitro/types';\nimport { fail } from './actions';\nimport { parseSearchParams } from './parse-request-data';\nimport { validateWithSchema } from './validate';\n\ntype NodeContext = NonNullable<H3Event['node']>;\ntype OptionalSchema = StandardSchemaV1 | undefined;\ntype InferSchema<\n  TSchema extends OptionalSchema,\n  TFallback,\n> = TSchema extends StandardSchemaV1\n  ? StandardSchemaV1.InferOutput<TSchema>\n  : TFallback;\n\nexport interface PageLoadContext<\n  TParamsSchema extends OptionalSchema = undefined,\n  TQuerySchema extends OptionalSchema = undefined,\n> {\n  params: InferSchema<TParamsSchema, H3EventContext['params']>;\n  query: InferSchema<\n    TQuerySchema,\n    Record<string, string | string[] | undefined>\n  >;\n  req: NodeContext['req'];\n  res: NonNullable<NodeContext['res']>;\n  fetch: $Fetch;\n  event: H3Event;\n}\n\nexport interface DefinePageLoadOptions<\n  TParamsSchema extends OptionalSchema = undefined,\n  TQuerySchema extends OptionalSchema = undefined,\n  TResult = unknown,\n> {\n  params?: TParamsSchema;\n  query?: TQuerySchema;\n  handler: (\n    context: PageLoadContext<TParamsSchema, TQuerySchema>,\n  ) => Promise<TResult> | TResult;\n}\n\n/**\n * Creates a typed page server load function with optional\n * Standard Schema validation for route params and query.\n *\n * Follows the same validation patterns as `defineAction` and\n * `defineServerRoute`: validates before invoking the handler,\n * returns `fail(422, issues)` on validation failure.\n *\n * @example\n * ```typescript\n * // src/app/pages/users/[id].server.ts\n * import { definePageLoad } from '@analogjs/router/server/actions';\n * import * as v from 'valibot';\n *\n * export const routeParamsSchema = v.object({\n *   id: v.pipe(v.string(), v.regex(/^\\d+$/)),\n * });\n *\n * export const load = definePageLoad({\n *   params: routeParamsSchema,\n *   handler: async ({ params, fetch }) => {\n *     // params.id is typed as string (validated)\n *     const user = await fetch(`/api/users/${params.id}`);\n *     return user;\n *   },\n * });\n * ```\n */\nexport function definePageLoad<\n  TParamsSchema extends OptionalSchema = undefined,\n  TQuerySchema extends OptionalSchema = undefined,\n  TResult = unknown,\n>(\n  options: DefinePageLoadOptions<TParamsSchema, TQuerySchema, TResult>,\n): (ctx: {\n  params: H3EventContext['params'];\n  req: NodeContext['req'];\n  res: NonNullable<NodeContext['res']>;\n  fetch: $Fetch;\n  event: H3Event;\n}) => Promise<TResult | Response> {\n  type Params = InferSchema<TParamsSchema, H3EventContext['params']>;\n  type Query = InferSchema<\n    TQuerySchema,\n    Record<string, string | string[] | undefined>\n  >;\n\n  return async (ctx: {\n    params: H3EventContext['params'];\n    req: NodeContext['req'];\n    res: NonNullable<NodeContext['res']>;\n    fetch: $Fetch;\n    event: H3Event;\n  }) => {\n    let params: unknown = ctx.params ?? {};\n\n    let requestUrl: string;\n    try {\n      requestUrl = getRequestURL(ctx.event).href;\n    } catch {\n      requestUrl = (ctx.event as H3Event & { request: Request }).request.url;\n    }\n    const url = new URL(requestUrl, 'http://localhost');\n    let query: unknown = parseSearchParams(url.searchParams);\n\n    // Validate params\n    if (options.params) {\n      const result = await validateWithSchema(options.params, params);\n      if (result.issues) {\n        return fail(422, result.issues);\n      }\n      params = result.value;\n    }\n\n    // Validate query\n    if (options.query) {\n      const result = await validateWithSchema(options.query, query);\n      if (result.issues) {\n        return fail(422, result.issues);\n      }\n      query = result.value;\n    }\n\n    return options.handler({\n      params: params as Params,\n      query: query as Query,\n      req: ctx.req,\n      res: ctx.res,\n      fetch: ctx.fetch,\n      event: ctx.event,\n    });\n  };\n}\n"],"mappings":"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"}

package/i18n/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/analogjs-router-i18n.mjs",
+  "typings": "../types/i18n/src/index.d.ts"
+}

package/package.json

@@ -1,9 +1,54 @@
 {
   "name": "@analogjs/router",
-  "version": "3.0.0-alpha.6",
+  "version": "3.0.0-alpha.60",
   "description": "Filesystem-based routing for Angular",
   "type": "module",
   "author": "Brandon Roberts <robertsbt@gmail.com>",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router.mjs",
+      "default": "./fesm2022/analogjs-router.mjs"
+    },
+    "./content": {
+      "types": "./types/content/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-content.mjs",
+      "default": "./fesm2022/analogjs-router-content.mjs"
+    },
+    "./i18n": {
+      "types": "./types/i18n/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-i18n.mjs",
+      "default": "./fesm2022/analogjs-router-i18n.mjs"
+    },
+    "./server": {
+      "types": "./types/server/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-server.mjs",
+      "default": "./fesm2022/analogjs-router-server.mjs"
+    },
+    "./server/actions": {
+      "types": "./types/server/actions/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-server-actions.mjs",
+      "default": "./fesm2022/analogjs-router-server-actions.mjs"
+    },
+    "./tanstack-query": {
+      "types": "./types/tanstack-query/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-tanstack-query.mjs",
+      "default": "./fesm2022/analogjs-router-tanstack-query.mjs"
+    },
+    "./tanstack-query/server": {
+      "types": "./types/tanstack-query/server/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-tanstack-query-server.mjs",
+      "default": "./fesm2022/analogjs-router-tanstack-query-server.mjs"
+    },
+    "./tokens": {
+      "types": "./types/tokens/src/index.d.ts",
+      "import": "./fesm2022/analogjs-router-tokens.mjs",
+      "default": "./fesm2022/analogjs-router-tokens.mjs"
+    }
+  },
   "keywords": [
     "angular",
     "router",
@@ -24,12 +69,39 @@
     "url": "https://github.com/sponsors/brandonroberts"
   },
   "peerDependencies": {
-    "@analogjs/content": "^3.0.0-alpha.6",
-    "@angular/core": "^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0",
-    "@angular/router": "^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0"
+    "@analogjs/content": "3.0.0-alpha.60",
+    "@standard-schema/spec": "^1.1.0",
+    "@angular/core": "^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/platform-server": "^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/router": "^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@tanstack/angular-query-experimental": ">=5.95.0",
+    "schema-dts": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@analogjs/content": {
+      "optional": true
+    },
+    "@standard-schema/spec": {
+      "optional": true
+    },
+    "@angular/platform-server": {
+      "optional": true
+    },
+    "@tanstack/angular-query-experimental": {
+      "optional": true
+    },
+    "schema-dts": {
+      "optional": true
+    }
   },
   "dependencies": {
-    "tslib": "^2.0.0"
+    "@standard-schema/spec": "^1.1.0",
+    "es-toolkit": "^1.45.1",
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@analogjs/vite-plugin-angular": "3.0.0-alpha.60",
+    "@analogjs/vitest-angular": "3.0.0-alpha.60"
   },
   "ng-update": {
     "packageGroup": [
@@ -49,26 +121,5 @@
   },
   "module": "fesm2022/analogjs-router.mjs",
   "typings": "types/src/index.d.ts",
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./types/src/index.d.ts",
-      "default": "./fesm2022/analogjs-router.mjs"
-    },
-    "./server": {
-      "types": "./types/server/src/index.d.ts",
-      "default": "./fesm2022/analogjs-router-server.mjs"
-    },
-    "./server/actions": {
-      "types": "./types/server/actions/src/index.d.ts",
-      "default": "./fesm2022/analogjs-router-server-actions.mjs"
-    },
-    "./tokens": {
-      "types": "./types/tokens/src/index.d.ts",
-      "default": "./fesm2022/analogjs-router-tokens.mjs"
-    }
-  },
   "sideEffects": false
 }

package/tanstack-query/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/analogjs-router-tanstack-query.mjs",
+  "typings": "../types/tanstack-query/src/index.d.ts"
+}

package/tanstack-query/server/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../../fesm2022/analogjs-router-tanstack-query-server.mjs",
+  "typings": "../../types/tanstack-query/server/src/index.d.ts"
+}

package/types/content/src/index.d.ts

@@ -0,0 +1,4 @@
+export { withContentRoutes } from './lib/with-content-routes';
+export { ANALOG_CONTENT_ROUTE_FILES, createContentRoutes } from './lib/routes';
+export type { Files } from './lib/routes';
+export { injectDebugContentRoutes } from './lib/debug/routes';

package/types/content/src/lib/debug/routes.d.ts

@@ -0,0 +1,10 @@
+import { InjectionToken } from '@angular/core';
+import { Route } from '@angular/router';
+export declare const DEBUG_CONTENT_ROUTES: InjectionToken<(Route & DebugRoute)[]>;
+export type DebugRoute = {
+    path: string;
+    filename: string;
+    isLayout: boolean;
+    children?: DebugRoute[];
+};
+export declare function injectDebugContentRoutes(): (Route & DebugRoute)[];

package/types/{src → content/src}/lib/markdown-helpers.d.ts

@@ -1,2 +1,2 @@
-import { RouteExport } from './models';
+import type { RouteExport } from '../../../src/lib/models';
 export declare function toMarkdownModule(markdownFileFactory: () => Promise<string>): () => Promise<RouteExport>;

package/types/content/src/lib/routes.d.ts

@@ -0,0 +1,8 @@
+import type { Route } from '@angular/router';
+import type { RouteExport } from '../../../src/lib/models';
+/**
+ * This variable reference is replaced with a glob of all content routes.
+ */
+export declare const ANALOG_CONTENT_ROUTE_FILES: {};
+export type Files = Record<string, () => Promise<RouteExport | string>>;
+export declare function createContentRoutes(files: Files, debug?: boolean): Route[];

package/types/content/src/lib/with-content-routes.d.ts

@@ -0,0 +1,2 @@
+import { type RouterFeatures } from '@angular/router';
+export declare function withContentRoutes(): RouterFeatures;

package/types/i18n/src/index.d.ts

@@ -0,0 +1 @@
+export { provideI18n, I18nConfig, injectSwitchLocale, loadTranslationsRuntime, } from './provide-i18n';

package/types/i18n/src/provide-i18n.d.ts

@@ -0,0 +1,92 @@
+import { EnvironmentProviders, Type } from '@angular/core';
+/**
+ * Configuration for runtime i18n support.
+ *
+ * `defaultLocale` and `locales` are optional when the platform plugin
+ * is configured with `i18n` in `vite.config.ts` — the values are
+ * injected as build-time globals automatically.
+ */
+export interface I18nConfig {
+    /**
+     * The default locale to use when no locale is detected.
+     * If omitted, reads from the platform plugin's `i18n.defaultLocale`.
+     */
+    defaultLocale?: string;
+    /**
+     * List of supported locale identifiers.
+     * If omitted, reads from the platform plugin's `i18n.locales`.
+     */
+    locales?: string[];
+    /**
+     * A function that returns translations for a given locale.
+     * The returned record maps message IDs to translated strings.
+     */
+    loader: (locale: string) => Promise<Record<string, string>> | Record<string, string>;
+}
+/**
+ * Fully resolved i18n config with all required fields.
+ */
+export type ResolvedI18nConfig = Required<I18nConfig>;
+/**
+ * Resolves the full i18n config by merging explicit values with
+ * build-time globals injected by the platform plugin.
+ */
+export declare function resolveI18nConfig(config: I18nConfig): Required<I18nConfig>;
+/**
+ * Provides runtime i18n support using Angular's $localize.
+ *
+ * This provider:
+ * 1. Detects the active locale from the URL or falls back to the default.
+ * 2. Makes the current locale available via the LOCALE injection token.
+ * 3. Loads translations for the active locale at startup using $localize.
+ *
+ * Works in both SSR and client-only modes. On the client, locale is detected
+ * from `window.location.pathname`. On the server, locale is detected from
+ * the request in `provideServerContext()` and provided at the platform level;
+ * this function does not shadow it.
+ *
+ * When the platform plugin is configured with `i18n` in `vite.config.ts`,
+ * `defaultLocale` and `locales` are injected automatically — only
+ * `loader` is required:
+ *
+ * ```typescript
+ * provideI18n({
+ *   loader: (locale) => import(`./i18n/${locale}.json`),
+ * })
+ * ```
+ */
+export declare function provideI18n(config: I18nConfig): EnvironmentProviders;
+export declare function detectClientLocale(config: ResolvedI18nConfig): string;
+/**
+ * Loads translations for the given locale and registers them with $localize.
+ *
+ * Always clears any previously loaded translations first so that switching
+ * between locales in a single SSR process does not mix translation maps.
+ */
+export declare function initI18n(config: ResolvedI18nConfig, locale?: string): Promise<void>;
+/**
+ * Loads translations into the global $localize translation map.
+ *
+ * Uses `@angular/localize`'s `loadTranslations` when available so that
+ * each translation string is parsed into the `{text, messageParts,
+ * placeholderNames}` shape that `$localize.translate` expects. Falls back
+ * to writing raw strings only as a last resort (in which case lookups
+ * will not succeed — the fallback exists to keep error messages useful
+ * for users who have not installed `@angular/localize`).
+ *
+ * Requires `@angular/localize/init` to be imported in the application
+ * entry point so that `globalThis.$localize` is defined.
+ */
+export declare function loadTranslationsRuntime(translations: Record<string, string>): Promise<void>;
+/** @internal — exported for tests; not re-exported from the package entry. */
+export declare function clearTranslationsRuntime(): Promise<void>;
+/** @internal */
+export declare function ɵregisterI18nComponentDef(typeOrDef: Type<any> | any): void;
+/** @internal */
+export declare function ɵresetI18nComponentDefCache(): void;
+/** @internal */
+export declare function getI18nComponentDefRegistrySize(): number;
+/** @internal */
+export declare function clearI18nComponentDefRegistry(): void;
+export declare function injectSwitchLocale(): (targetLocale: string) => void;
+export declare function replaceLocaleInPath(pathname: string, targetLocale: string, locales: string[]): string;

package/types/server/actions/src/define-action.d.ts

@@ -0,0 +1,54 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event, H3EventContext } from 'nitro/h3';
+import type { $Fetch } from 'nitro/types';
+type NodeContext = NonNullable<H3Event['node']>;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+export interface DefineActionContext<TSchema extends OptionalSchema = undefined, TParamsSchema extends OptionalSchema = undefined> {
+    data: InferSchema<TSchema, Record<string, unknown>>;
+    params: InferSchema<TParamsSchema, H3EventContext['params']>;
+    req: NodeContext['req'];
+    res: NonNullable<NodeContext['res']>;
+    fetch: $Fetch;
+    event: H3Event;
+}
+export interface DefineActionOptions<TSchema extends OptionalSchema = undefined, TParamsSchema extends OptionalSchema = undefined> {
+    schema?: TSchema;
+    params?: TParamsSchema;
+    handler: (context: DefineActionContext<TSchema, TParamsSchema>) => Promise<Response> | Response;
+}
+/**
+ * Creates a server action handler with Standard Schema input validation.
+ *
+ * Parses the request body (JSON or FormData) and validates it against the
+ * provided schema before invoking the handler. On validation failure,
+ * returns `fail(422, issues)` with `StandardSchemaV1.Issue[]`.
+ * Repeated form fields are preserved as arrays instead of being collapsed
+ * to the last value.
+ *
+ * @example
+ * ```typescript
+ * import { defineAction, json } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * const Schema = v.object({
+ *   email: v.pipe(v.string(), v.email()),
+ * });
+ *
+ * export const action = defineAction({
+ *   schema: Schema,
+ *   handler: async ({ data }) => {
+ *     // data is typed as { email: string }
+ *     return json({ ok: true });
+ *   },
+ * });
+ * ```
+ */
+export declare function defineAction<TSchema extends OptionalSchema = undefined, TParamsSchema extends OptionalSchema = undefined>(options: DefineActionOptions<TSchema, TParamsSchema>): (ctx: {
+    params: H3EventContext["params"];
+    req: NodeContext["req"];
+    res: NonNullable<NodeContext["res"]>;
+    fetch: $Fetch;
+    event: H3Event;
+}) => Promise<Response>;
+export {};

package/types/server/actions/src/define-api-route.d.ts

@@ -0,0 +1,57 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event } from 'nitro/h3';
+export type DefineApiRouteResult = Response | unknown;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback = unknown> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+type ResolveDataSchema<TInput extends OptionalSchema, TQuery extends OptionalSchema, TBody extends OptionalSchema> = TInput extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TInput> : TQuery extends StandardSchemaV1 ? TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TQuery> | StandardSchemaV1.InferOutput<TBody> : StandardSchemaV1.InferOutput<TQuery> : TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TBody> : unknown;
+export interface DefineApiRouteContext<TInput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined> {
+    data: ResolveDataSchema<TInput, TQuery, TBody>;
+    query: InferSchema<TQuery, undefined>;
+    body: InferSchema<TBody, undefined>;
+    params: InferSchema<TParams, H3Event['context']['params']>;
+    event: H3Event;
+}
+export interface DefineApiRouteOptions<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineApiRouteResult = DefineApiRouteResult> {
+    input?: TInput;
+    query?: TQuery;
+    body?: TBody;
+    params?: TParams;
+    output?: TOutput;
+    handler: (context: DefineApiRouteContext<TInput, TQuery, TBody, TParams>) => Promise<TResult> | TResult;
+}
+/**
+ * Creates an h3-compatible event handler with Standard Schema validation.
+ *
+ * - `input` schema validates the request body (POST/PUT/PATCH) or query
+ *   params (GET). Returns 422 with `StandardSchemaV1.Issue[]` on failure.
+ * - `output` schema validates the response in development only (stripped
+ *   in production for zero overhead). Logs a warning on mismatch.
+ * - Plain return values are serialized with `json(...)`; raw `Response`
+ *   objects are returned unchanged.
+ *
+ * @example
+ * ```typescript
+ * import { defineApiRoute } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * const Input = v.object({
+ *   name: v.pipe(v.string(), v.minLength(1)),
+ *   email: v.pipe(v.string(), v.email()),
+ * });
+ * const Output = v.object({
+ *   id: v.string(),
+ *   name: v.string(),
+ * });
+ *
+ * export default defineApiRoute({
+ *   input: Input,
+ *   output: Output,
+ *   handler: async ({ data }) => {
+ *     const user = await db.users.create(data);
+ *     return user;
+ *   },
+ * });
+ * ```
+ */
+export declare function defineApiRoute<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineApiRouteResult = DefineApiRouteResult>(options: DefineApiRouteOptions<TInput, TOutput, TQuery, TBody, TParams, TResult>): (event: H3Event) => Promise<Response>;
+export {};

package/types/server/actions/src/define-page-load.d.ts

@@ -0,0 +1,55 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event, H3EventContext } from 'nitro/h3';
+import type { $Fetch } from 'nitro/types';
+type NodeContext = NonNullable<H3Event['node']>;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+export interface PageLoadContext<TParamsSchema extends OptionalSchema = undefined, TQuerySchema extends OptionalSchema = undefined> {
+    params: InferSchema<TParamsSchema, H3EventContext['params']>;
+    query: InferSchema<TQuerySchema, Record<string, string | string[] | undefined>>;
+    req: NodeContext['req'];
+    res: NonNullable<NodeContext['res']>;
+    fetch: $Fetch;
+    event: H3Event;
+}
+export interface DefinePageLoadOptions<TParamsSchema extends OptionalSchema = undefined, TQuerySchema extends OptionalSchema = undefined, TResult = unknown> {
+    params?: TParamsSchema;
+    query?: TQuerySchema;
+    handler: (context: PageLoadContext<TParamsSchema, TQuerySchema>) => Promise<TResult> | TResult;
+}
+/**
+ * Creates a typed page server load function with optional
+ * Standard Schema validation for route params and query.
+ *
+ * Follows the same validation patterns as `defineAction` and
+ * `defineServerRoute`: validates before invoking the handler,
+ * returns `fail(422, issues)` on validation failure.
+ *
+ * @example
+ * ```typescript
+ * // src/app/pages/users/[id].server.ts
+ * import { definePageLoad } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * export const routeParamsSchema = v.object({
+ *   id: v.pipe(v.string(), v.regex(/^\d+$/)),
+ * });
+ *
+ * export const load = definePageLoad({
+ *   params: routeParamsSchema,
+ *   handler: async ({ params, fetch }) => {
+ *     // params.id is typed as string (validated)
+ *     const user = await fetch(`/api/users/${params.id}`);
+ *     return user;
+ *   },
+ * });
+ * ```
+ */
+export declare function definePageLoad<TParamsSchema extends OptionalSchema = undefined, TQuerySchema extends OptionalSchema = undefined, TResult = unknown>(options: DefinePageLoadOptions<TParamsSchema, TQuerySchema, TResult>): (ctx: {
+    params: H3EventContext['params'];
+    req: NodeContext['req'];
+    res: NonNullable<NodeContext['res']>;
+    fetch: $Fetch;
+    event: H3Event;
+}) => Promise<TResult | Response>;
+export {};

package/types/server/actions/src/define-server-route.d.ts

@@ -0,0 +1,68 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { H3Event } from 'nitro/h3';
+export type DefineServerRouteResult = Response | unknown;
+export interface ServerRouteHandler<TQuery = unknown, TBody = unknown, TResult = unknown> {
+    (event: H3Event): Promise<Response>;
+    readonly _types: {
+        readonly query: TQuery;
+        readonly body: TBody;
+        readonly result: TResult;
+    };
+}
+export type InferRouteQuery<T> = T extends ServerRouteHandler<infer Q, any, any> ? Q : never;
+export type InferRouteBody<T> = T extends ServerRouteHandler<any, infer B, any> ? B : never;
+export type InferRouteResult<T> = T extends ServerRouteHandler<any, any, infer R> ? Exclude<R, Response> : never;
+type OptionalSchema = StandardSchemaV1 | undefined;
+type InferSchema<TSchema extends OptionalSchema, TFallback = unknown> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TSchema> : TFallback;
+type ResolveDataSchema<TInput extends OptionalSchema, TQuery extends OptionalSchema, TBody extends OptionalSchema> = TInput extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TInput> : TQuery extends StandardSchemaV1 ? TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TQuery> | StandardSchemaV1.InferOutput<TBody> : StandardSchemaV1.InferOutput<TQuery> : TBody extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TBody> : unknown;
+export interface DefineServerRouteContext<TInput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined> {
+    data: ResolveDataSchema<TInput, TQuery, TBody>;
+    query: InferSchema<TQuery, undefined>;
+    body: InferSchema<TBody, undefined>;
+    params: InferSchema<TParams, H3Event['context']['params']>;
+    event: H3Event;
+}
+export interface DefineServerRouteOptions<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineServerRouteResult = DefineServerRouteResult> {
+    input?: TInput;
+    query?: TQuery;
+    body?: TBody;
+    params?: TParams;
+    output?: TOutput;
+    handler: (context: DefineServerRouteContext<TInput, TQuery, TBody, TParams>) => Promise<TResult> | TResult;
+}
+/**
+ * Creates an h3-compatible event handler with Standard Schema validation.
+ *
+ * - `input` schema validates the request body (POST/PUT/PATCH) or query
+ *   params (GET). Returns 422 with `StandardSchemaV1.Issue[]` on failure.
+ * - `output` schema validates the response in development only (stripped
+ *   in production for zero overhead). Logs a warning on mismatch.
+ * - Plain return values are serialized with `json(...)`; raw `Response`
+ *   objects are returned unchanged.
+ *
+ * @example
+ * ```typescript
+ * import { defineServerRoute } from '@analogjs/router/server/actions';
+ * import * as v from 'valibot';
+ *
+ * const Input = v.object({
+ *   name: v.pipe(v.string(), v.minLength(1)),
+ *   email: v.pipe(v.string(), v.email()),
+ * });
+ * const Output = v.object({
+ *   id: v.string(),
+ *   name: v.string(),
+ * });
+ *
+ * export default defineServerRoute({
+ *   input: Input,
+ *   output: Output,
+ *   handler: async ({ data }) => {
+ *     const user = await db.users.create(data);
+ *     return user;
+ *   },
+ * });
+ * ```
+ */
+export declare function defineServerRoute<TInput extends StandardSchemaV1 | undefined = undefined, TOutput extends StandardSchemaV1 | undefined = undefined, TQuery extends StandardSchemaV1 | undefined = undefined, TBody extends StandardSchemaV1 | undefined = undefined, TParams extends StandardSchemaV1 | undefined = undefined, TResult extends DefineServerRouteResult = DefineServerRouteResult>(options: DefineServerRouteOptions<TInput, TOutput, TQuery, TBody, TParams, TResult>): ServerRouteHandler<InferSchema<TQuery, undefined>, InferSchema<TBody, undefined>, TResult>;
+export {};

package/types/server/actions/src/index.d.ts

@@ -1 +1,9 @@
-export { PageServerAction, json, redirect, fail } from './actions';
+export type { PageServerAction } from './actions';
+export { json, redirect, fail } from './actions';
+export { defineAction } from './define-action';
+export type { DefineActionContext, DefineActionOptions } from './define-action';
+export { defineServerRoute } from './define-server-route';
+export type { DefineServerRouteContext, DefineServerRouteOptions, DefineServerRouteResult, ServerRouteHandler, InferRouteQuery, InferRouteBody, InferRouteResult, } from './define-server-route';
+export { definePageLoad } from './define-page-load';
+export type { PageLoadContext, DefinePageLoadOptions, } from './define-page-load';
+export { validateWithSchema } from './validate';

package/types/server/actions/src/parse-request-data.d.ts

@@ -0,0 +1,9 @@
+type RequestEntryValue = string | File;
+type ParsedRequestValue = RequestEntryValue | RequestEntryValue[];
+export declare function parseSearchParams(searchParams: URLSearchParams): Record<string, ParsedRequestValue>;
+export declare function parseFormData(formData: FormData): Record<string, ParsedRequestValue>;
+export declare function parseRequestData(event: {
+    method: string;
+    headers: Headers;
+}): Promise<unknown>;
+export {};

package/types/server/actions/src/validate.d.ts

@@ -0,0 +1,8 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+/**
+ * Validates unknown input against a Standard Schema.
+ *
+ * Handles both sync and async `validate` implementations — the Standard
+ * Schema spec allows either return shape.
+ */
+export declare function validateWithSchema<T extends StandardSchemaV1>(schema: T, data: unknown): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<T>>>;

package/types/server/src/provide-server-context.d.ts

@@ -1,5 +1,5 @@
 import { StaticProvider } from '@angular/core';
-import { ServerInternalFetch, ServerRequest, ServerResponse } from '@analogjs/router/tokens';
+import { ServerInternalFetch, ServerRequest, ServerResponse } from '../../tokens/src/index.js';
 export declare function provideServerContext({ req, res, fetch, }: {
     req: ServerRequest;
     res: ServerResponse;
@@ -9,3 +9,17 @@ export declare function getBaseUrl(req: ServerRequest): string;
 export declare function getRequestProtocol(req: ServerRequest, opts?: {
     xForwardedProto?: boolean;
 }): string;
+/**
+ * Detects the locale from the request URL path prefix or Accept-Language header.
+ * URL prefix takes priority (e.g. /fr/about -> 'fr').
+ */
+export declare function detectLocale(req: ServerRequest): string | undefined;
+/**
+ * Extracts a locale from the first URL path segment if it matches
+ * a BCP 47-like pattern (e.g. 'en', 'en-US', 'zh-Hans-CN').
+ */
+export declare function extractLocaleFromUrl(url: string): string | undefined;
+/**
+ * Parses the Accept-Language header and returns the most preferred language.
+ */
+export declare function parseAcceptLanguage(header: string | undefined): string | undefined;

package/types/server/src/render.d.ts

@@ -1,5 +1,5 @@
 import { ApplicationConfig, Provider, Type } from '@angular/core';
-import type { ServerContext } from '@analogjs/router/tokens';
+import type { ServerContext } from '../../tokens/src/index.js';
 /**
  * Returns a function that accepts the navigation URL,
  * the root HTML, and server context.