feat: improve client route type safety and add changeset entry

- Extract ApiRouteType from ApiRoutes keys for type-safe route resolution
- Add 'discovery' route to client fallback map
- Remove 'as any' type casting in client route access
- Add changeset entry documenting all discovery routing changes

Agent-Logs-Url: https://github.com/objectstack-ai/spec/sessions/283e383b-284b-40fe-af98-c11f61a4c8a8

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>

Author: Copilot

.changeset/discovery-route-consistency.md

@@ -0,0 +1,30 @@
+---
+"@objectstack/spec": minor
+"@objectstack/client": minor
+"@objectstack/runtime": patch
+"@objectstack/express": patch
+"@objectstack/fastify": patch
+"@objectstack/hono": patch
+"@objectstack/nestjs": patch
+"@objectstack/nextjs": patch
+"@objectstack/nuxt": patch
+"@objectstack/sveltekit": patch
+---
+
+Fix discovery API endpoint routing and protocol consistency.
+
+**Discovery route standardization:**
+- All adapters (Express, Fastify, Hono, NestJS, Next.js, Nuxt, SvelteKit) now mount the discovery endpoint at `{prefix}/discovery` instead of `{prefix}` root.
+- `.well-known/objectstack` redirects now point to `{prefix}/discovery`.
+- Client `connect()` fallback URL changed from `/api/v1` to `/api/v1/discovery`.
+- Runtime dispatcher handles both `/discovery` (standard) and `/` (legacy) for backward compatibility.
+
+**Schema & route alignment:**
+- Added `storage` (service: `file-storage`) and `feed` (service: `data`) routes to `DEFAULT_DISPATCHER_ROUTES`.
+- Added `feed` and `discovery` fields to `ApiRoutesSchema`.
+- Unified `GetDiscoveryResponseSchema` with `DiscoverySchema` as single source of truth.
+- Client `getRoute('feed')` fallback updated from `/api/v1/data` to `/api/v1/feed`.
+
+**Type safety:**
+- Extracted `ApiRouteType` from `ApiRoutes` keys for type-safe client route resolution.
+- Removed `as any` type casting in client route access.

packages/client/src/index.ts

@@ -87,9 +87,17 @@ import {
   SubscribeResponse,
   UnsubscribeResponse,
   WellKnownCapabilities,
+  ApiRoutes,
 } from '@objectstack/spec/api';
 import { Logger, createLogger } from '@objectstack/core';
 
+/**
+ * Route types that the client can resolve.
+ * Covers all keys from `ApiRoutes` (the discovery schema) plus
+ * client-specific virtual routes (`views`, `permissions`).
+ */
+export type ApiRouteType = keyof ApiRoutes | 'views' | 'permissions';
+
 export interface ClientConfig {
   baseUrl: string;
   token?: string;
@@ -1677,16 +1685,18 @@ export class ObjectStackClient {
    * Get the conventional route path for a given API endpoint type
    * ObjectStack uses standard conventions: /api/v1/data, /api/v1/meta, /api/v1/ui
    */
-  private getRoute(type: 'data' | 'metadata' | 'ui' | 'auth' | 'analytics' | 'storage' | 'automation' | 'packages' | 'permissions' | 'realtime' | 'workflow' | 'views' | 'notifications' | 'ai' | 'i18n' | 'feed'): string {
+  private getRoute(type: ApiRouteType): string {
     // 1. Use discovered routes if available
-    if (this.discoveryInfo?.routes && (this.discoveryInfo.routes as any)[type]) {
-        return (this.discoveryInfo.routes as any)[type];
+    const routes = this.discoveryInfo?.routes;
+    if (routes && type in routes) {
+        return routes[type as keyof ApiRoutes] as string;
     }
 
     // 2. Fallback to conventions
-    const routeMap: Record<string, string> = {
+    const routeMap: Record<ApiRouteType, string> = {
       data: '/api/v1/data',
       metadata: '/api/v1/meta',
+      discovery: '/api/v1/discovery',
       ui: '/api/v1/ui',
       auth: '/api/v1/auth',
       analytics: '/api/v1/analytics',
@@ -1701,6 +1711,7 @@ export class ObjectStackClient {
       ai: '/api/v1/ai',
       i18n: '/api/v1/i18n',
       feed: '/api/v1/feed',
+      graphql: '/graphql',
     };
 
     return routeMap[type] || `/api/v1/${type}`;