@b9g/platform 0.1.11 → 0.1.13

package/README.md

@@ -213,7 +213,7 @@ const platform = new CloudflarePlatform({
 
 ### Re-exports from @b9g/filesystem
 
-- `BucketStorage`, `Bucket`, `BucketFactory`, `CustomBucketStorage`
+- `DirectoryStorage`, `Directory`, `DirectoryFactory`, `CustomDirectoryStorage`
 
 ### Re-exports from @b9g/cache
 

package/package.json

@@ -1,28 +1,34 @@
 {
   "name": "@b9g/platform",
-  "version": "0.1.11",
-  "description": "ServiceWorker-first universal deployment platform. Write ServiceWorker apps once, deploy anywhere (Node/Bun/Cloudflare). Registry-based multi-app orchestration.",
+  "version": "0.1.13",
+  "description": "The portable meta-framework built on web standards.",
   "keywords": [
-    "serviceworker",
+    "service-worker",
     "universal",
     "deployment",
     "platform",
-    "registry",
     "node",
     "bun",
     "cloudflare",
     "workers",
+    "cache",
+    "framework",
+    "meta-framework",
+    "esbuild",
     "shovel"
   ],
   "dependencies": {
-    "@b9g/async-context": "^0.1.4",
-    "@b9g/cache": "^0.1.5",
+    "@b9g/async-context": "^0.2.0-beta.0",
+    "@b9g/cache": "^0.2.0-beta.0",
     "@b9g/filesystem": "^0.1.7",
+    "@b9g/zen": "^0.1.6",
     "@logtape/logtape": "^1.2.0"
   },
   "devDependencies": {
-    "@b9g/libuild": "^0.1.18",
-    "bun-types": "latest"
+    "@b9g/libuild": "^0.1.20",
+    "@b9g/node-webworker": "^0.2.0-beta.1",
+    "@b9g/platform-bun": "^0.1.10",
+    "@b9g/platform-node": "^0.1.12"
   },
   "peerDependencies": {
     "@logtape/file": "^1.0.0",
@@ -57,14 +63,6 @@
       "import": "./src/index.js"
     },
     "./package.json": "./package.json",
-    "./worker-pool": {
-      "types": "./src/worker-pool.d.ts",
-      "import": "./src/worker-pool.js"
-    },
-    "./worker-pool.js": {
-      "types": "./src/worker-pool.d.ts",
-      "import": "./src/worker-pool.js"
-    },
     "./runtime": {
       "types": "./src/runtime.d.ts",
       "import": "./src/runtime.js"
@@ -73,22 +71,6 @@
       "types": "./src/runtime.d.ts",
       "import": "./src/runtime.js"
     },
-    "./config": {
-      "types": "./src/config.d.ts",
-      "import": "./src/config.js"
-    },
-    "./config.js": {
-      "types": "./src/config.d.ts",
-      "import": "./src/config.js"
-    },
-    "./cookie-store": {
-      "types": "./src/cookie-store.d.ts",
-      "import": "./src/cookie-store.js"
-    },
-    "./cookie-store.js": {
-      "types": "./src/cookie-store.d.ts",
-      "import": "./src/cookie-store.js"
-    },
     "./index": {
       "types": "./src/index.d.ts",
       "import": "./src/index.js"
@@ -97,13 +79,15 @@
       "types": "./src/index.d.ts",
       "import": "./src/index.js"
     },
-    "./single-threaded": {
-      "types": "./src/single-threaded.d.ts",
-      "import": "./src/single-threaded.js"
+    "./globals.d.ts": "./src/globals.d.ts",
+    "./shovel-config.d.ts": "./src/shovel-config.d.ts",
+    "./config": {
+      "types": "./src/config.d.ts",
+      "import": "./src/config.js"
     },
-    "./single-threaded.js": {
-      "types": "./src/single-threaded.d.ts",
-      "import": "./src/single-threaded.js"
+    "./config.js": {
+      "types": "./src/config.d.ts",
+      "import": "./src/config.js"
     }
   }
 }

package/src/config.d.ts

@@ -1,172 +1,24 @@
+/// <reference path="./globals.d.ts" />
+/// <reference path="./shovel-config.d.ts" />
 /**
- * Configuration expression parser
+ * Config Validation Utilities
  *
- * Embeddable JavaScript-like expressions for JSON config:
- * - ALL_CAPS = env var reference (e.g., NODE_ENV, PORT)
- * - Everything else = string literal (kebab-case, URLs, camelCase, PascalCase)
- * - Quoted strings = explicit strings (escape hatch)
- * - JavaScript keywords: true, false, null, undefined
- * - Operators: ||, &&, ===, !==, ==, !=, ? :, !
- * - No eval - uses recursive descent parser
- *
- * Examples:
- *   "PORT || 3000"
- *   "NODE_ENV === production ? redis : memory"
- *   "REDIS_URL || redis://localhost:6379"
- *   "S3_BUCKET || my-bucket-name"
- *   "BASE_PATH || ./uploads"
- */
-import { Cache } from "@b9g/cache";
-/**
- * Parse a configuration expression with the DSL
- */
-export declare function parseConfigExpr(expr: string, env?: Record<string, string | undefined>, options?: {
-    strict?: boolean;
-}): any;
-/**
- * Process a config value (handles nested objects/arrays)
- */
-export declare function processConfigValue(value: any, env?: Record<string, string | undefined>, options?: {
-    strict?: boolean;
-}): any;
-/**
- * Match a name against config patterns
- *
- * Priority:
- * 1. Exact match: "sessions" matches "sessions"
- * 2. Prefix patterns: "api-*" matches "api-v1", "api-v2" (longest first)
- * 3. Catch-all: "*" matches everything
- *
- * Examples:
- *   matchPattern("sessions", {"sessions": {...}, "*": {...}})  → sessions config
- *   matchPattern("api-v1", {"api-*": {...}, "*": {...}})       → api-* config
- *   matchPattern("random", {"*": {...}})                        → * config
- */
-export declare function matchPattern<T>(name: string, config: Record<string, T>): T | undefined;
-export interface CacheConfig {
-    provider?: string | number;
-    url?: string | number;
-    maxEntries?: string | number;
-    TTL?: string | number;
-}
-export interface BucketConfig {
-    provider?: string | number;
-    path?: string | number;
-    bucket?: string | number;
-    region?: string | number;
-    endpoint?: string | number;
-}
-/** Log level for filtering */
-export type LogLevel = "debug" | "info" | "warning" | "error";
-/** Sink configuration */
-export interface SinkConfig {
-    provider: string;
-    /** Provider-specific options (path, maxSize, etc.) */
-    [key: string]: any;
-}
-/** Per-category logging configuration */
-export interface CategoryLoggingConfig {
-    level?: LogLevel;
-    sinks?: SinkConfig[];
-}
-export interface LoggingConfig {
-    /** Default log level. Defaults to "info" */
-    level?: LogLevel;
-    /** Default sinks. Defaults to console */
-    sinks?: SinkConfig[];
-    /** Per-category config (inherits from top-level, can override level and/or sinks) */
-    categories?: Record<string, CategoryLoggingConfig>;
-}
-export interface ShovelConfig {
-    platform?: string;
-    port?: number | string;
-    host?: string;
-    workers?: number | string;
-    logging?: LoggingConfig;
-    caches?: Record<string, CacheConfig>;
-    buckets?: Record<string, BucketConfig>;
-}
-/** Processed logging config with all defaults applied */
-export interface ProcessedLoggingConfig {
-    level: LogLevel;
-    sinks: SinkConfig[];
-    categories: Record<string, CategoryLoggingConfig>;
-}
-export interface ProcessedShovelConfig {
-    platform?: string;
-    port: number;
-    host: string;
-    workers: number;
-    logging: ProcessedLoggingConfig;
-    caches: Record<string, CacheConfig>;
-    buckets: Record<string, BucketConfig>;
-}
-/**
- * Load Shovel configuration from shovel.json or package.json
- * Priority: shovel.json > package.json "shovel" field > defaults
- * @param cwd - Current working directory (must be provided by runtime adapter)
+ * Helpers for validating config objects at runtime.
  */
-export declare function loadConfig(cwd: string): ProcessedShovelConfig;
 /**
- * Configure LogTape logging based on Shovel config.
- * Call this in both main thread and workers.
- *
- * @param loggingConfig - The logging configuration from ProcessedShovelConfig.logging
- * @param options - Additional options
- * @param options.reset - Whether to reset existing LogTape config (default: true)
- * @param options.cwd - Working directory for resolving relative paths
- */
-export declare function configureLogging(loggingConfig: ProcessedLoggingConfig, options?: {
-    reset?: boolean;
-    cwd?: string;
-}): Promise<void>;
-/**
- * Get cache config for a specific cache name (with pattern matching)
+ * Error thrown when config validation fails
  */
-export declare function getCacheConfig(config: ProcessedShovelConfig, name: string): CacheConfig;
-/**
- * Get bucket config for a specific bucket name (with pattern matching)
- */
-export declare function getBucketConfig(config: ProcessedShovelConfig, name: string): BucketConfig;
-export interface BucketFactoryOptions {
-    /** Base directory for path resolution (entrypoint directory) - REQUIRED */
-    baseDir: string;
-    /** Shovel configuration for overrides */
-    config?: ProcessedShovelConfig;
+export declare class ConfigValidationError extends Error {
+    readonly path: string;
+    readonly issue: "undefined" | "NaN";
+    constructor(path: string, issue: "undefined" | "NaN");
 }
 /**
- * Creates a bucket factory function for CustomBucketStorage.
- * Lazily imports bucket implementations.
- *
- * Provider resolution:
- * 1. "node" -> built-in NodeBucket (default)
- * 2. "memory" -> built-in MemoryBucket
- * 3. "s3" -> @b9g/filesystem-s3 (blessed module)
- * 4. Any other string -> treated as a module name (e.g., "my-custom-bucket")
- *
- * Custom bucket modules must export a class that:
- * - Implements FileSystemDirectoryHandle
- * - Has constructor(name: string, options?: object)
- */
-export declare function createBucketFactory(options: BucketFactoryOptions): (name: string) => Promise<FileSystemDirectoryHandle>;
-export interface CacheFactoryOptions {
-    /** Shovel configuration for cache settings */
-    config?: ProcessedShovelConfig;
-    /** Default provider when not specified in config. Defaults to "memory". */
-    defaultProvider?: string;
-}
-/**
- * Creates a cache factory function for CustomCacheStorage.
- * Lazily imports cache implementations.
- *
- * Provider resolution:
- * 1. "memory" -> built-in MemoryCache
- * 2. "redis" -> @b9g/cache-redis (blessed module)
- * 3. "cloudflare" -> native Cloudflare caches.open(name)
- * 4. Any other string -> treated as a module name (e.g., "my-custom-cache")
+ * Validate that a config object has no undefined or NaN values.
+ * Call this at runtime to fail fast on missing env vars.
  *
- * Custom cache modules must export a class that:
- * - Extends Cache (from @b9g/cache)
- * - Has constructor(name: string, options?: object)
+ * @param config - The config object to validate
+ * @param path - Current path for error messages (used in recursion)
+ * @throws ConfigValidationError if any value is undefined or NaN
  */
-export declare function createCacheFactory(options?: CacheFactoryOptions): (name: string) => Promise<Cache>;
+export declare function validateConfig(config: Record<string, unknown>, path?: string): void;