@ereo/data 0.1.6

package/dist/define-route.d.ts

@@ -0,0 +1,354 @@
+/**
+ * @ereo/data - Route Definition Builder
+ *
+ * A builder pattern API that maintains stable type inference through chaining.
+ * Solves TanStack Start's documented limitation where adding `head` breaks loader inference.
+ *
+ * Key features:
+ * - Branded types preserve inference through the entire chain
+ * - Each method returns a new builder with accumulated types
+ * - No inference breakage when adding head/meta/middleware
+ * - Compile-time path parameter inference
+ *
+ * @example
+ * ```typescript
+ * export const route = defineRoute('/users/[id]')
+ *   .loader(async ({ params }) => {
+ *     // params is typed as { id: string }
+ *     return db.user.findUnique({ where: { id: params.id } });
+ *   })
+ *   .action(async ({ body }) => {
+ *     // body is typed based on schema
+ *     return { success: true };
+ *   })
+ *   .head(({ data }) => {
+ *     // data is loader return type - NEVER breaks inference
+ *     return { title: data.name };
+ *   })
+ *   .build();
+ * ```
+ */
+import type { LoaderArgs, ActionArgs, AppContext, RouteParams, CacheOptions, MetaDescriptor, InferParams, RouteConfig } from '@ereo/core';
+/**
+ * Brand symbol for route path type preservation.
+ */
+declare const RouteBrand: unique symbol;
+declare const LoaderBrand: unique symbol;
+declare const ActionBrand: unique symbol;
+/**
+ * Branded path type that preserves the path string through transformations.
+ */
+type BrandedRoutePath<Path extends string> = {
+    readonly [RouteBrand]: Path;
+};
+/**
+ * Branded loader type that preserves return type through transformations.
+ */
+type BrandedLoader<T> = {
+    readonly [LoaderBrand]: T;
+};
+/**
+ * Branded action type that preserves return type through transformations.
+ */
+type BrandedAction<T> = {
+    readonly [ActionBrand]: T;
+};
+/**
+ * Extended loader args with typed params.
+ */
+export interface TypedLoaderArgs<P extends RouteParams = RouteParams> extends LoaderArgs<P> {
+    /** Validated search params (if schema provided) */
+    searchParams?: Record<string, unknown>;
+    /** Validated hash params (if schema provided) */
+    hashParams?: Record<string, unknown>;
+}
+/**
+ * Extended action args with typed body.
+ */
+export interface TypedActionArgs<TBody, P extends RouteParams = RouteParams> extends ActionArgs<P> {
+    /** Parsed and validated body */
+    body: TBody;
+    /** Raw form data (if applicable) */
+    formData?: FormData;
+}
+/**
+ * Head function args with loader data.
+ */
+export interface HeadArgs<TLoaderData, P extends RouteParams = RouteParams> {
+    /** Loader data */
+    data: TLoaderData;
+    /** Route params */
+    params: P;
+    /** Request object */
+    request: Request;
+}
+/**
+ * Meta function args with loader data.
+ */
+export interface TypedMetaArgs<TLoaderData, P extends RouteParams = RouteParams> {
+    /** Loader data */
+    data: TLoaderData;
+    /** Route params */
+    params: P;
+    /** Location info */
+    location: {
+        pathname: string;
+        search: string;
+        hash: string;
+    };
+}
+/**
+ * Head function return type.
+ */
+export interface HeadData {
+    title?: string;
+    description?: string;
+    canonical?: string;
+    robots?: string;
+    openGraph?: {
+        title?: string;
+        description?: string;
+        image?: string;
+        type?: string;
+    };
+    twitter?: {
+        card?: 'summary' | 'summary_large_image' | 'app' | 'player';
+        site?: string;
+        creator?: string;
+    };
+    links?: Array<{
+        rel: string;
+        href: string;
+        [key: string]: string;
+    }>;
+    scripts?: Array<{
+        src?: string;
+        content?: string;
+        type?: string;
+    }>;
+}
+/**
+ * Middleware handler for route-level middleware.
+ */
+export type RouteMiddleware<P extends RouteParams = RouteParams> = (request: Request, context: AppContext, params: P, next: () => Promise<Response>) => Response | Promise<Response>;
+/**
+ * Schema type for validation (compatible with Zod, Yup, etc.).
+ */
+export interface ValidationSchema<T> {
+    parse: (data: unknown) => T;
+    safeParse?: (data: unknown) => {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+/**
+ * Route builder with no loader defined yet.
+ */
+export interface RouteBuilder<Path extends string, Params extends RouteParams = InferParams<Path> extends RouteParams ? InferParams<Path> : RouteParams> extends BrandedRoutePath<Path> {
+    /**
+     * Define the route's data loader.
+     *
+     * @example
+     * .loader(async ({ params }) => {
+     *   return db.user.findUnique({ where: { id: params.id } });
+     * })
+     */
+    loader<TData>(fn: (args: TypedLoaderArgs<Params>) => TData | Promise<TData>): RouteBuilderWithLoader<Path, Params, Awaited<TData>>;
+    /**
+     * Define search params validation schema.
+     * Used for type-safe search param parsing.
+     */
+    searchParams<T>(schema: ValidationSchema<T>): RouteBuilder<Path, Params>;
+    /**
+     * Define hash params validation schema.
+     * This is UNIQUE to Ereo - TanStack has no hash param support.
+     */
+    hashParams<T>(schema: ValidationSchema<T>): RouteBuilder<Path, Params>;
+    /**
+     * Add route-level middleware.
+     */
+    middleware(...handlers: RouteMiddleware<Params>[]): RouteBuilder<Path, Params>;
+    /**
+     * Set route configuration.
+     */
+    configure(config: RouteConfig): RouteBuilder<Path, Params>;
+    /**
+     * Build the route definition (no loader case).
+     */
+    build(): RouteDefinition<Path, Params, never, never, never>;
+}
+/**
+ * Route builder after loader is defined.
+ */
+export interface RouteBuilderWithLoader<Path extends string, Params extends RouteParams, LoaderData> extends BrandedRoutePath<Path>, BrandedLoader<LoaderData> {
+    /**
+     * Define the route's action handler.
+     *
+     * @example
+     * .action(async ({ body, params }) => {
+     *   await db.user.update({ where: { id: params.id }, data: body });
+     *   return { success: true };
+     * })
+     */
+    action<TBody = unknown, TResult = unknown>(fn: (args: TypedActionArgs<TBody, Params>) => TResult | Promise<TResult>, options?: {
+        schema?: ValidationSchema<TBody>;
+    }): RouteBuilderWithLoaderAndAction<Path, Params, LoaderData, Awaited<TResult>, TBody>;
+    /**
+     * Define the head/meta data generator.
+     * CRITICAL: This NEVER breaks loader inference (TanStack limitation solved).
+     *
+     * @example
+     * .head(({ data }) => ({
+     *   title: data.user.name,
+     *   description: data.user.bio,
+     * }))
+     */
+    head(fn: (args: HeadArgs<LoaderData, Params>) => HeadData): RouteBuilderWithLoader<Path, Params, LoaderData>;
+    /**
+     * Define the meta tags generator.
+     * CRITICAL: This NEVER breaks loader inference (TanStack limitation solved).
+     *
+     * @example
+     * .meta(({ data }) => [
+     *   { title: data.user.name },
+     *   { name: 'description', content: data.user.bio },
+     * ])
+     */
+    meta(fn: (args: TypedMetaArgs<LoaderData, Params>) => MetaDescriptor[]): RouteBuilderWithLoader<Path, Params, LoaderData>;
+    /**
+     * Set cache options for the loader.
+     */
+    cache(options: CacheOptions): RouteBuilderWithLoader<Path, Params, LoaderData>;
+    /**
+     * Add route-level middleware.
+     */
+    middleware(...handlers: RouteMiddleware<Params>[]): RouteBuilderWithLoader<Path, Params, LoaderData>;
+    /**
+     * Set route configuration.
+     */
+    configure(config: RouteConfig): RouteBuilderWithLoader<Path, Params, LoaderData>;
+    /**
+     * Build the route definition.
+     */
+    build(): RouteDefinition<Path, Params, LoaderData, never, never>;
+}
+/**
+ * Route builder after both loader and action are defined.
+ */
+export interface RouteBuilderWithLoaderAndAction<Path extends string, Params extends RouteParams, LoaderData, ActionData, ActionBody> extends BrandedRoutePath<Path>, BrandedLoader<LoaderData>, BrandedAction<ActionData> {
+    /**
+     * Define the head/meta data generator.
+     */
+    head(fn: (args: HeadArgs<LoaderData, Params>) => HeadData): RouteBuilderWithLoaderAndAction<Path, Params, LoaderData, ActionData, ActionBody>;
+    /**
+     * Define the meta tags generator.
+     */
+    meta(fn: (args: TypedMetaArgs<LoaderData, Params>) => MetaDescriptor[]): RouteBuilderWithLoaderAndAction<Path, Params, LoaderData, ActionData, ActionBody>;
+    /**
+     * Set cache options for the loader.
+     */
+    cache(options: CacheOptions): RouteBuilderWithLoaderAndAction<Path, Params, LoaderData, ActionData, ActionBody>;
+    /**
+     * Add route-level middleware.
+     */
+    middleware(...handlers: RouteMiddleware<Params>[]): RouteBuilderWithLoaderAndAction<Path, Params, LoaderData, ActionData, ActionBody>;
+    /**
+     * Set route configuration.
+     */
+    configure(config: RouteConfig): RouteBuilderWithLoaderAndAction<Path, Params, LoaderData, ActionData, ActionBody>;
+    /**
+     * Build the route definition.
+     */
+    build(): RouteDefinition<Path, Params, LoaderData, ActionData, ActionBody>;
+}
+/**
+ * Final route definition output.
+ * Contains all the configured handlers and metadata.
+ */
+export interface RouteDefinition<Path extends string, Params extends RouteParams, LoaderData, ActionData, ActionBody> {
+    /** The route path pattern */
+    path: Path;
+    /** Loader function (if defined) */
+    loader?: (args: LoaderArgs<Params>) => Promise<LoaderData>;
+    /** Action function (if defined) */
+    action?: (args: ActionArgs<Params>) => Promise<ActionData>;
+    /** Head data generator */
+    head?: (args: HeadArgs<LoaderData, Params>) => HeadData;
+    /** Meta tags generator */
+    meta?: (args: TypedMetaArgs<LoaderData, Params>) => MetaDescriptor[];
+    /** Route-level middleware */
+    middleware?: RouteMiddleware<Params>[];
+    /** Route configuration */
+    config?: RouteConfig;
+    /** Cache options */
+    cache?: CacheOptions;
+    /** Search params schema */
+    searchParamsSchema?: ValidationSchema<unknown>;
+    /** Hash params schema */
+    hashParamsSchema?: ValidationSchema<unknown>;
+    /** Action body schema */
+    actionBodySchema?: ValidationSchema<ActionBody>;
+    /** Type brands for external type inference */
+    readonly _types: {
+        path: Path;
+        params: Params;
+        loaderData: LoaderData;
+        actionData: ActionData;
+        actionBody: ActionBody;
+    };
+}
+/**
+ * Create a route builder for a given path.
+ *
+ * This is the main entry point for defining type-safe routes.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * export const route = defineRoute('/users/[id]')
+ *   .loader(async ({ params }) => {
+ *     return db.user.findUnique({ where: { id: params.id } });
+ *   })
+ *   .build();
+ *
+ * // With action and head (NEVER breaks inference)
+ * export const route = defineRoute('/posts/[slug]')
+ *   .loader(async ({ params }) => {
+ *     return db.post.findUnique({ where: { slug: params.slug } });
+ *   })
+ *   .action(async ({ body }) => {
+ *     // Handle form submission
+ *     return { success: true };
+ *   })
+ *   .head(({ data }) => ({
+ *     title: data.title,  // Full type inference preserved!
+ *     description: data.excerpt,
+ *   }))
+ *   .build();
+ *
+ * // Export parts for route module
+ * export const { loader, action, meta } = route;
+ * ```
+ */
+export declare function defineRoute<Path extends string>(path: Path): RouteBuilder<Path, InferParams<Path> extends RouteParams ? InferParams<Path> : RouteParams>;
+/**
+ * Extract loader data type from a route definition.
+ */
+export type InferLoaderData<T> = T extends RouteDefinition<infer _Path, infer _Params, infer LoaderData, infer _ActionData, infer _ActionBody> ? LoaderData : never;
+/**
+ * Extract action data type from a route definition.
+ */
+export type InferActionData<T> = T extends RouteDefinition<infer _Path, infer _Params, infer _LoaderData, infer ActionData, infer _ActionBody> ? ActionData : never;
+/**
+ * Extract params type from a route definition.
+ */
+export type InferRouteParams<T> = T extends RouteDefinition<infer _Path, infer Params, infer _LoaderData, infer _ActionData, infer _ActionBody> ? Params : never;
+/**
+ * Extract path type from a route definition.
+ */
+export type InferRoutePath<T> = T extends RouteDefinition<infer Path, infer _Params, infer _LoaderData, infer _ActionData, infer _ActionBody> ? Path : never;
+export {};
+//# sourceMappingURL=define-route.d.ts.map

package/dist/define-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-route.d.ts","sourceRoot":"","sources":["../src/define-route.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @ereo/data
+ *
+ * Data loading and caching for the EreoJS framework.
+ * One pattern, not four - simple and explicit.
+ */
+export { createLoader, defer, isDeferred, resolveDeferred, fetchData, FetchError, serializeLoaderData, parseLoaderData, combineLoaders, clientLoader, } from './loader';
+export type { LoaderOptions, DeferredData } from './loader';
+export { createAction, action, typedAction, jsonAction, parseRequestBody, formDataToObject, coerceValue, redirect, json, error, parseFormData, validateRequired, combineValidators, } from './action';
+export type { ActionOptions, TypedActionOptions, TypedActionArgs, ActionBody, ValidationResult, ActionResult, } from './action';
+export { MemoryCache, getCache, setCache, cached, generateCacheKey, cacheKey, buildCacheControl, parseCacheControl, Cached, createDataCacheAdapter, } from './cache';
+export type { CacheEntry, CacheStorage } from './cache';
+export { revalidateTag, revalidatePath, revalidate, unstable_cache, createRevalidationHandler, tags, onDemandRevalidate, } from './revalidate';
+export type { RevalidateOptions, RevalidateResult } from './revalidate';
+export { createPipeline, dataSource, cachedSource, optionalSource, combinePipelines, formatMetrics, generateMetricsVisualization, } from './pipeline';
+export type { DataSource, PipelineConfig, PipelineResult, PipelineMetrics, LoaderMetrics, ExecutionStep, WaterfallInfo, } from './pipeline';
+export { defineRoute, } from './define-route';
+export type { RouteBuilder, RouteBuilderWithLoader, RouteBuilderWithLoaderAndAction, RouteDefinition, TypedLoaderArgs, TypedActionArgs as RouteTypedActionArgs, HeadArgs, HeadData, TypedMetaArgs, RouteMiddleware, ValidationSchema, InferLoaderData as InferRouteLoaderData, InferActionData as InferRouteActionData, InferRouteParams, InferRoutePath, } from './define-route';
+export { ereoSchema, isEreoSchema, createPaginationParser, createSortParser, createFilterParser, parseBoolean, parseStringArray, parseDate, parseEnum, schemaBuilder, } from './schema-adapters';
+export type { EreoSchema, ZodLikeSchema, ValidationError, InferSchemaOutput, InferSchemaInput, PaginationParams, PaginationSchemaOptions, SortParams, FilterParams, } from './schema-adapters';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,KAAK,EACL,UAAU,EACV,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EACL,YAAY,EACZ,MAAM,EACN,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,EACN,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,EACL,aAAa,EACb,cAAc,EACd,UAAU,EACV,cAAc,EACd,yBAAyB,EACzB,IAAI,EACJ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,+BAA+B,EAC/B,eAAe,EACf,eAAe,EACf,eAAe,IAAI,oBAAoB,EACvC,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,IAAI,oBAAoB,EACvC,eAAe,IAAI,oBAAoB,EACvC,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC"}