@ereo/core 0.1.6

package/README.md

@@ -0,0 +1,99 @@
+# @ereo/core
+
+Core framework package for EreoJS providing the application container, request context, plugin system, caching, environment variables, and type definitions.
+
+## Installation
+
+```bash
+bun add @ereo/core
+```
+
+## Quick Start
+
+```typescript
+import { createApp, defineConfig, definePlugin } from '@ereo/core';
+
+// Create application with configuration
+const app = createApp({
+  config: defineConfig({
+    server: {
+      port: 3000,
+      hostname: 'localhost',
+    },
+  }),
+});
+
+// Define a custom plugin
+const analyticsPlugin = definePlugin({
+  name: 'analytics',
+  setup(context) {
+    console.log('Analytics initialized in', context.mode, 'mode');
+  },
+});
+
+// Register the plugin
+app.use(analyticsPlugin);
+
+// Start the server
+await app.start();
+```
+
+## Key Features
+
+- **Application Container** - Create and configure EreoJS applications with `createApp` and `defineConfig`
+- **Request Context** - Access request-scoped data with `createContext`, `getContext`, and `attachContext`
+- **Plugin System** - Extend functionality with `definePlugin` and `composePlugins`
+- **Environment Variables** - Type-safe env management with schema builders (`env.string()`, `env.number()`, etc.)
+- **Unified Cache Interface** - Flexible caching with `createCache`, `createTaggedCache`, and tag-based invalidation
+- **Full TypeScript Support** - Comprehensive type definitions for routes, loaders, actions, middleware, and more
+
+## Environment Variables
+
+```typescript
+import { env, setupEnv, typedEnv } from '@ereo/core';
+
+// Define environment schema
+const envSchema = {
+  DATABASE_URL: env.string().required(),
+  PORT: env.port().default(3000),
+  DEBUG: env.boolean().default(false),
+  NODE_ENV: env.enum(['development', 'production', 'test']).default('development'),
+};
+
+// Validate and load environment
+const result = await setupEnv('.', envSchema, 'development');
+
+if (result.valid) {
+  // Access typed environment variables
+  const port = typedEnv.PORT; // number
+}
+```
+
+## Caching
+
+```typescript
+import { createTaggedCache } from '@ereo/core';
+
+const cache = createTaggedCache({ maxSize: 1000 });
+
+// Set with tags for grouped invalidation
+await cache.set('user:123', userData, {
+  ttl: 3600,
+  tags: ['users', 'user:123']
+});
+
+// Invalidate all entries with a tag
+await cache.invalidateTag('users');
+```
+
+## Documentation
+
+For full documentation, visit [https://ereojs.dev/docs/core](https://ereojs.dev/docs/core)
+
+## Part of EreoJS
+
+This package is part of the [EreoJS](https://github.com/ereojs/ereo) monorepo - a modern full-stack framework built for Bun.
+
+## License
+
+MIT

package/dist/app.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @ereo/core - Application Container
+ *
+ * The main application class that ties together routing, plugins,
+ * and request handling.
+ */
+import type { Application, ApplicationOptions, FrameworkConfig, Plugin, Route, RouteMatch, MiddlewareHandler } from './types';
+import { PluginRegistry } from './plugin';
+/**
+ * Create a new EreoJS application.
+ */
+export declare function createApp(options?: ApplicationOptions): EreoApp;
+/**
+ * Define framework configuration with type safety.
+ */
+export declare function defineConfig(config: FrameworkConfig): FrameworkConfig;
+/**
+ * The main EreoJS application class.
+ */
+export declare class EreoApp implements Application {
+    readonly config: FrameworkConfig;
+    routes: Route[];
+    plugins: Plugin[];
+    private pluginRegistry;
+    private middlewares;
+    private routeMatcher;
+    constructor(options?: ApplicationOptions);
+    /**
+     * Deep merge configuration objects.
+     */
+    private mergeConfig;
+    /**
+     * Register a plugin.
+     */
+    use(plugin: Plugin): this;
+    /**
+     * Register middleware.
+     */
+    middleware(handler: MiddlewareHandler): this;
+    /**
+     * Set the route matcher function.
+     * This is typically provided by @ereo/router.
+     */
+    setRouteMatcher(matcher: (pathname: string) => RouteMatch | null): void;
+    /**
+     * Set routes directly.
+     */
+    setRoutes(routes: Route[]): void;
+    /**
+     * Initialize all plugins.
+     */
+    private initializePlugins;
+    /**
+     * Handle an incoming request.
+     */
+    handle(request: Request): Promise<Response>;
+    /**
+     * Run middleware chain.
+     */
+    private runMiddleware;
+    /**
+     * Handle a route request.
+     */
+    private handleRoute;
+    /**
+     * Handle errors.
+     */
+    private handleError;
+    /**
+     * Start development server.
+     * This is typically called by @ereo/cli.
+     */
+    dev(): Promise<void>;
+    /**
+     * Build for production.
+     */
+    build(): Promise<void>;
+    /**
+     * Start production server.
+     */
+    start(): Promise<void>;
+    /**
+     * Get the plugin registry for advanced usage.
+     */
+    getPluginRegistry(): PluginRegistry;
+}
+/**
+ * Type guard to check if a value is an EreoApp.
+ */
+export declare function isEreoApp(value: unknown): value is EreoApp;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,MAAM,EACN,KAAK,EACL,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAsB1C;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAErE;AAED;;GAEG;AACH,qBAAa,OAAQ,YAAW,WAAW;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,KAAK,EAAE,CAAM;IACrB,OAAO,EAAE,MAAM,EAAE,CAAM;IAEvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,YAAY,CAA0D;gBAElE,OAAO,GAAE,kBAAuB;IAc5C;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAK5C;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,GAAG,IAAI;IAIvE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAIhC;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBjD;;OAEG;YACW,aAAa;IAkB3B;;OAEG;YACW,WAAW;IAgFzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAS1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,iBAAiB,IAAI,cAAc;CAGpC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}

package/dist/cache.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @ereo/core - Unified Cache Interface
+ *
+ * A unified cache adapter interface for the EreoJS framework.
+ * All cache implementations should implement CacheAdapter for interoperability.
+ */
+/**
+ * Options for cache set operations.
+ */
+export interface CacheSetOptions {
+    /** Time to live in seconds */
+    ttl?: number;
+    /** Cache tags for grouped invalidation */
+    tags?: string[];
+}
+/**
+ * Base cache adapter interface.
+ * All cache implementations in EreoJS should implement this interface.
+ *
+ * @example
+ * // Using a cache adapter
+ * const cache: CacheAdapter = createCache();
+ *
+ * await cache.set('user:123', userData, { ttl: 3600, tags: ['users'] });
+ * const user = await cache.get<User>('user:123');
+ * await cache.delete('user:123');
+ */
+export interface CacheAdapter {
+    /**
+     * Get a value from the cache.
+     * @param key - Cache key
+     * @returns The cached value, or undefined if not found or expired
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * Set a value in the cache.
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param options - Cache options (ttl, tags)
+     */
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    /**
+     * Delete a value from the cache.
+     * @param key - Cache key
+     * @returns true if the key was deleted, false if it didn't exist
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if a key exists in the cache.
+     * @param key - Cache key
+     * @returns true if the key exists and is not expired
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clear all entries from the cache.
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Extended cache adapter with tag-based invalidation support.
+ * Use this interface when you need to invalidate groups of cached items.
+ *
+ * @example
+ * const cache: TaggedCache = createCache({ tagged: true });
+ *
+ * // Store items with tags
+ * await cache.set('post:1', post1, { tags: ['posts', 'user:alice'] });
+ * await cache.set('post:2', post2, { tags: ['posts', 'user:bob'] });
+ *
+ * // Invalidate all posts
+ * await cache.invalidateTag('posts');
+ *
+ * // Invalidate by user
+ * await cache.invalidateTags(['user:alice']);
+ */
+export interface TaggedCache extends CacheAdapter {
+    /**
+     * Invalidate all cache entries with a specific tag.
+     * @param tag - Tag to invalidate
+     */
+    invalidateTag(tag: string): Promise<void>;
+    /**
+     * Invalidate all cache entries with any of the specified tags.
+     * @param tags - Array of tags to invalidate
+     */
+    invalidateTags(tags: string[]): Promise<void>;
+    /**
+     * Get all cache keys associated with a specific tag.
+     * @param tag - Tag to look up
+     * @returns Array of cache keys with this tag
+     */
+    getByTag(tag: string): Promise<string[]>;
+}
+/**
+ * Options for creating a cache instance.
+ */
+export interface CacheOptions {
+    /** Maximum number of entries to store */
+    maxSize?: number;
+    /** Default TTL for entries in seconds */
+    defaultTtl?: number;
+    /** Enable tag support */
+    tagged?: boolean;
+}
+/**
+ * Default in-memory cache implementation.
+ * Implements both CacheAdapter and TaggedCache interfaces.
+ */
+export declare class MemoryCacheAdapter implements TaggedCache {
+    private readonly cache;
+    private readonly tagIndex;
+    private readonly maxSize;
+    private readonly defaultTtl?;
+    constructor(options?: CacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    invalidateTag(tag: string): Promise<void>;
+    invalidateTags(tags: string[]): Promise<void>;
+    getByTag(tag: string): Promise<string[]>;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): {
+        size: number;
+        tags: number;
+    };
+    /**
+     * Get all keys in the cache.
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Check if an entry is expired.
+     */
+    private isExpired;
+}
+/**
+ * Create a new cache instance.
+ *
+ * @param options - Cache configuration options
+ * @returns A CacheAdapter (or TaggedCache if tagged option is true)
+ *
+ * @example
+ * // Simple cache
+ * const cache = createCache();
+ *
+ * // Cache with size limit
+ * const limitedCache = createCache({ maxSize: 1000 });
+ *
+ * // Cache with default TTL
+ * const ttlCache = createCache({ defaultTtl: 3600 });
+ *
+ * // Tagged cache for invalidation
+ * const taggedCache = createCache({ tagged: true });
+ */
+export declare function createCache(options?: CacheOptions): CacheAdapter;
+/**
+ * Create a tagged cache instance with invalidation support.
+ *
+ * @param options - Cache configuration options
+ * @returns A TaggedCache instance
+ */
+export declare function createTaggedCache(options?: Omit<CacheOptions, 'tagged'>): TaggedCache;
+/**
+ * Check if a cache adapter supports tag operations.
+ */
+export declare function isTaggedCache(cache: CacheAdapter): cache is TaggedCache;
+/**
+ * Wrap any object with get/set methods to conform to CacheAdapter interface.
+ * Useful for adapting existing cache implementations.
+ *
+ * @param impl - Object with cache-like methods
+ * @returns A conformant CacheAdapter
+ *
+ * @example
+ * // Adapt a simple Map-based cache
+ * const mapCache = new Map();
+ * const adapter = wrapCacheAdapter({
+ *   get: async (key) => mapCache.get(key),
+ *   set: async (key, value) => { mapCache.set(key, value); },
+ *   delete: async (key) => mapCache.delete(key),
+ *   has: async (key) => mapCache.has(key),
+ *   clear: async () => mapCache.clear(),
+ * });
+ */
+export declare function wrapCacheAdapter(impl: {
+    get: <T>(key: string) => Promise<T | undefined> | T | undefined;
+    set: <T>(key: string, value: T, options?: CacheSetOptions) => Promise<void> | void;
+    delete: (key: string) => Promise<boolean> | boolean;
+    has: (key: string) => Promise<boolean> | boolean;
+    clear: () => Promise<void> | void;
+}): CacheAdapter;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,YAAiB;IAKhC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAe3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAclC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiB9C;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO1C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B;;OAEG;IACH,OAAO,CAAC,SAAS;CAQlB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,WAAW,CAErF;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,IAAI,WAAW,CASvE;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAChE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnF,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACpD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACjD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnC,GAAG,YAAY,CAkBf"}

package/dist/context.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @ereo/core - Request Context
+ *
+ * Web Standards-based request context that travels through the request lifecycle.
+ * Provides cache control, key-value storage, and response header management.
+ */
+import type { AppContext, CacheControl } from './types';
+/**
+ * Create a new request context for handling a request.
+ * Each request gets its own isolated context.
+ */
+export declare function createContext(request: Request): RequestContext;
+/**
+ * Request-scoped context that provides:
+ * - Cache control configuration
+ * - Key-value storage for passing data between middleware/loaders
+ * - Response headers management
+ */
+export declare class RequestContext implements AppContext {
+    readonly url: URL;
+    readonly env: Record<string, string | undefined>;
+    readonly responseHeaders: Headers;
+    private store;
+    private cacheOptions;
+    private cacheTags;
+    constructor(request: Request);
+    /**
+     * Cache control for the current request.
+     * Allows setting explicit caching with tags for invalidation.
+     */
+    readonly cache: CacheControl;
+    /**
+     * Get a value from the context store.
+     * Useful for sharing data between middleware and loaders.
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set a value in the context store.
+     * Values are scoped to the current request only.
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * Check if a key exists in the context store.
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a key from the context store.
+     */
+    delete(key: string): boolean;
+    /**
+     * Build Cache-Control header value from options.
+     */
+    buildCacheControlHeader(): string | null;
+    /**
+     * Apply cache control and other context headers to a response.
+     */
+    applyToResponse(response: Response): Response;
+}
+/**
+ * Type guard to check if a value is a RequestContext.
+ */
+export declare function isRequestContext(value: unknown): value is RequestContext;
+export declare function attachContext(request: Request, context: RequestContext): void;
+export declare function getContext(request: Request): RequestContext | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAE9D;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,SAAS,CAAgB;gBAErB,OAAO,EAAE,OAAO;IAM5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAS1B;IAEF;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,uBAAuB,IAAI,MAAM,GAAG,IAAI;IAuBxC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;CAyB9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE7E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAEvE"}

package/dist/env.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @ereo/core - Environment Variable Management
+ *
+ * Type-safe environment variable handling with validation,
+ * .env file loading, and runtime access.
+ */
+/** Supported environment variable types */
+export type EnvType = 'string' | 'number' | 'boolean' | 'json' | 'array';
+/** Environment variable schema definition */
+export interface EnvSchema<T = unknown> {
+    type: EnvType;
+    required?: boolean;
+    default?: T;
+    description?: string;
+    /** Validation function */
+    validate?: (value: T) => boolean | string;
+    /** Transform function */
+    transform?: (value: string) => T;
+    /** Mark as public (exposed to client) */
+    public?: boolean;
+}
+/** Type-safe schema builder */
+export interface EnvSchemaBuilder<T> {
+    /** Mark as required (no default) */
+    required(): EnvSchemaBuilder<T>;
+    /** Set default value */
+    default(value: T): EnvSchemaBuilder<T>;
+    /** Add description */
+    description(desc: string): EnvSchemaBuilder<T>;
+    /** Add validation */
+    validate(fn: (value: T) => boolean | string): EnvSchemaBuilder<T>;
+    /** Mark as public (exposed to client) */
+    public(): EnvSchemaBuilder<T>;
+    /** Get the schema definition */
+    _schema: EnvSchema<T>;
+}
+/** Parsed environment configuration */
+export interface ParsedEnv {
+    [key: string]: string | number | boolean | unknown[] | Record<string, unknown> | null;
+}
+/** Environment validation result */
+export interface EnvValidationResult {
+    valid: boolean;
+    errors: EnvValidationError[];
+    warnings: string[];
+    env: ParsedEnv;
+}
+/** Environment validation error */
+export interface EnvValidationError {
+    key: string;
+    message: string;
+    expected?: string;
+    received?: string;
+}
+/** Environment config for defineConfig */
+export interface EnvConfig {
+    [key: string]: EnvSchemaBuilder<unknown>;
+}
+/**
+ * Environment variable schema builders.
+ * Use these to define your environment variables in ereo.config.ts.
+ *
+ * @example
+ * import { env } from '@ereo/core';
+ *
+ * export default defineConfig({
+ *   env: {
+ *     DATABASE_URL: env.string().required(),
+ *     PORT: env.number().default(3000),
+ *     DEBUG: env.boolean().default(false),
+ *     ALLOWED_ORIGINS: env.array().default([]),
+ *   },
+ * });
+ */
+export declare const env: {
+    /** String environment variable */
+    string(): EnvSchemaBuilder<string>;
+    /** Number environment variable */
+    number(): EnvSchemaBuilder<number>;
+    /** Boolean environment variable */
+    boolean(): EnvSchemaBuilder<boolean>;
+    /** JSON environment variable (parses as object) */
+    json<T = Record<string, unknown>>(): EnvSchemaBuilder<T>;
+    /** Array environment variable (comma-separated) */
+    array(): EnvSchemaBuilder<string[]>;
+    /** Enum environment variable (restricted values) */
+    enum<T extends string>(values: readonly T[]): EnvSchemaBuilder<T>;
+    /** URL environment variable */
+    url(): EnvSchemaBuilder<string>;
+    /** Port environment variable (1-65535) */
+    port(): EnvSchemaBuilder<number>;
+};
+/**
+ * Parse a .env file content into key-value pairs.
+ */
+export declare function parseEnvFile(content: string): Record<string, string>;
+/**
+ * Load environment variables from .env files.
+ * Priority (highest to lowest):
+ * 1. process.env (already set)
+ * 2. .env.local (never committed)
+ * 3. .env.[mode].local
+ * 4. .env.[mode]
+ * 5. .env
+ */
+export declare function loadEnvFiles(root: string, mode?: 'development' | 'production' | 'test'): Promise<Record<string, string>>;
+/**
+ * Validate and parse environment variables against a schema.
+ */
+export declare function validateEnv(schema: EnvConfig, rawEnv: Record<string, string | undefined>): EnvValidationResult;
+/**
+ * Initialize the environment with validated values.
+ * Called during app startup.
+ */
+export declare function initializeEnv(validatedEnv: ParsedEnv): void;
+/**
+ * Get an environment variable.
+ * Returns undefined if not set (and no default).
+ */
+export declare function getEnv<T = string>(key: string): T | undefined;
+/**
+ * Get an environment variable or throw if not set.
+ */
+export declare function requireEnv<T = string>(key: string): T;
+/**
+ * Get all environment variables.
+ */
+export declare function getAllEnv(): Readonly<ParsedEnv>;
+/**
+ * Get public environment variables (safe for client).
+ */
+export declare function getPublicEnv(schema: EnvConfig): ParsedEnv;
+/**
+ * Complete environment initialization.
+ * Loads .env files and validates against schema.
+ */
+export declare function setupEnv(root: string, schema: EnvConfig, mode?: 'development' | 'production' | 'test'): Promise<EnvValidationResult>;
+/**
+ * Generate TypeScript type definitions for environment variables.
+ */
+export declare function generateEnvTypes(schema: EnvConfig): string;
+/**
+ * Module augmentation target for environment types.
+ * Generated by the CLI during development.
+ */
+export interface EnvTypes {
+}
+/**
+ * Type-safe environment variable accessor.
+ * Use after defining env schema in ereo.config.ts.
+ *
+ * @example
+ * const dbUrl = typedEnv.DATABASE_URL; // TypeScript knows this is string
+ */
+export declare const typedEnv: EnvTypes;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @ereo/core
+ *
+ * Core framework package providing the application container,
+ * request context, plugin system, and type definitions.
+ */
+export { createApp, defineConfig, EreoApp, isEreoApp } from './app';
+export { createContext, RequestContext, isRequestContext, attachContext, getContext, } from './context';
+export { PluginRegistry, definePlugin, composePlugins, securityHeadersPlugin, isPlugin, } from './plugin';
+export { env, parseEnvFile, loadEnvFiles, validateEnv, initializeEnv, getEnv, requireEnv, getAllEnv, getPublicEnv, setupEnv, generateEnvTypes, typedEnv, } from './env';
+export { MemoryCacheAdapter, createCache, createTaggedCache, isTaggedCache, wrapCacheAdapter, } from './cache';
+export type { CacheAdapter, TaggedCache, CacheSetOptions, CacheOptions as CacheAdapterOptions, } from './cache';
+export type { EnvType, EnvSchema, EnvSchemaBuilder, ParsedEnv, EnvValidationResult, EnvValidationError, EnvConfig, EnvTypes, } from './env';
+export type { BuildTarget, ServerConfig, BuildConfig, FrameworkConfig, MiddlewareReference, RenderMode, PrerenderConfig, StreamingConfig, CSRConfig, RenderConfig, IslandStrategy, IslandsConfig, RouteCacheConfig, ProgressiveConfig, RouteCompositionConfig, AuthConfig, DevConfig, ErrorConfig, RuntimeConfig, RouteVariant, RouteConfig, RouteModuleWithConfig, ParamValidationSchema, SearchParamValidationSchema, ParamValidator, Plugin, PluginContext, DevServer, Route, RouteParams, RouteMatch, RouteModule, RouteHandle, LoaderArgs, ActionArgs, LoaderFunction, ActionFunction, LoaderData, MetaArgs, MetaDescriptor, MetaFunction, HeadersArgs, HeadersFunction, RouteComponentProps, RouteErrorComponentProps, 
+/** @deprecated Use RouteErrorComponentProps instead */
+ErrorBoundaryProps, NextFunction, MiddlewareHandler, Middleware, CacheOptions, CacheControl, AppContext, Application, ApplicationOptions, HydrationStrategy, IslandProps, MaybePromise, DeepPartial, InferLoaderData, InferActionData, RouteTypes, RouteTypeDefinition, TypedRoutes, RouteParamsFor, LoaderDataFor, SearchParamsFor, HashParamsFor, ContextFor, ActionDataFor, HandleFor, HasLoader, HasAction, RouteData, } from './types';
+export type { InferParams, HasParams, ParamNames, IsOptionalParam, IsCatchAllParam, BuildPath, ValidateParams, StaticPrefix, IsStaticPath, ParentPath, PathMatches, PossiblePaths, BrandedPath, UnbrandPath, ParsedSegment, ParseSegment, ParsePathSegments, SplitPath, ExtractParams, } from './types/path-parser';
+//# 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,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,UAAU,GACX,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,QAAQ,GACT,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,GAAG,EACH,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,MAAM,EACN,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,QAAQ,GACT,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,IAAI,mBAAmB,GACpC,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,QAAQ,GACT,MAAM,OAAO,CAAC;AAGf,YAAY,EAEV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EAGf,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EAGd,MAAM,EACN,aAAa,EACb,SAAS,EAGT,KAAK,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EAGX,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EAGV,QAAQ,EACR,cAAc,EACd,YAAY,EAGZ,WAAW,EACX,eAAe,EAGf,mBAAmB,EACnB,wBAAwB;AACxB,uDAAuD;AACvD,kBAAkB,EAGlB,YAAY,EACZ,iBAAiB,EACjB,UAAU,EAGV,YAAY,EACZ,YAAY,EAGZ,UAAU,EAGV,WAAW,EACX,kBAAkB,EAGlB,iBAAiB,EACjB,WAAW,EAGX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EAGf,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,EACb,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,eAAe,EACf,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,aAAa,GACd,MAAM,qBAAqB,CAAC"}