@bunary/core 0.0.5 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @bunary/core
 
-Foundation module for the Bunary framework — configuration, environment helpers, and shared utilities.
+Foundation for the Bunary framework: config (defineConfig, createConfig), environment (env, isDev, isProd, isTest). Full reference: [docs/index.md](./docs/index.md).
 
 ## Installation
 
@@ -8,63 +8,17 @@ Foundation module for the Bunary framework — configuration, environment helper
 bun add @bunary/core
 ```
 
-## Usage
-
-### Environment Variables
-
-```typescript
-import { env, isDev, isProd, isTest } from '@bunary/core';
-
-// Get environment variable with automatic type coercion
-const port = env('PORT', 3000);        // Returns number
-const debug = env('DEBUG', false);     // Returns boolean
-const name = env('APP_NAME', 'myapp'); // Returns string
-
-// Environment detection
-if (isDev()) {
-  console.log('Running in development mode');
-}
-```
-
-### Configuration
+## Quick start
 
 ```typescript
-import { defineConfig } from '@bunary/core';
+import { env, createConfig, defineConfig } from "@bunary/core";
 
-export default defineConfig({
-  app: {
-    name: 'MyApp',
-    env: 'development',
-    debug: true,
-  },
-});
+const port = env("PORT", 3000);
+const configStore = createConfig(defineConfig({ app: { name: "MyApp", env: "development", debug: true } }));
+export default configStore.get();
 ```
 
-## API
-
-### `env<T>(key: string, defaultValue?: T): T`
-
-Get an environment variable with optional default and automatic type coercion.
-
-### `isDev(): boolean`
-
-Returns `true` if `NODE_ENV` is `"development"` or not set.
-
-### `isProd(): boolean`
-
-Returns `true` if `NODE_ENV` is `"production"`.
-
-### `isTest(): boolean`
-
-Returns `true` if `NODE_ENV` is `"test"`.
-
-### `defineConfig(config: BunaryConfig): BunaryConfig`
-
-Type-safe configuration helper with defaults.
-
-## Requirements
-
-- Bun ≥1.0.0
+For API details, see [docs/index.md](./docs/index.md).
 
 ## License
 

package/dist/config.d.ts

@@ -1,4 +1,33 @@
 import type { BunaryConfig } from "./types";
+/**
+ * Instance-scoped configuration container.
+ *
+ * This replaces global mutable config and allows multiple independent app instances
+ * to exist in the same process.
+ */
+export interface BunaryConfigStore {
+    /** Set the current config for this instance */
+    set: (config: BunaryConfig) => void;
+    /** Get the current config for this instance */
+    get: () => BunaryConfig;
+    /** Clear the current config for this instance (useful for tests) */
+    clear: () => void;
+}
+/**
+ * Create an isolated Bunary config store.
+ *
+ * @param initial - Optional initial config to set
+ * @returns A config store with get/set/clear methods
+ *
+ * @example
+ * ```ts
+ * import { createConfig, defineConfig } from "@bunary/core";
+ *
+ * const config = createConfig(defineConfig({ app: { name: "MyApp" } }));
+ * const current = config.get();
+ * ```
+ */
+export declare function createConfig(initial?: BunaryConfig): BunaryConfigStore;
 /**
  * Define Bunary configuration with type safety
  *

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAU5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAmB/D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAS5C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,GAAG,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACpC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,YAAY,CAAC;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAiBtE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAiB/D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAI9C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/index.d.ts

@@ -2,8 +2,8 @@
  * @bunary/core
  * Foundation module for Bunary - config, environment, and app helpers
  */
-export { defineConfig, getBunaryConfig, clearBunaryConfig } from "./config";
+export { clearBunaryConfig, createConfig, defineConfig, getBunaryConfig, } from "./config";
 export { Environment, type EnvironmentType } from "./constants";
 export { env, isDev, isProd, isTest } from "./environment";
-export type { BunaryConfig, AppConfig, OrmConfig } from "./types";
+export type { AppConfig, BunaryConfig, OrmConfig } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -6,34 +6,6 @@ var Environment = {
   TEST: "test"
 };
 
-// src/config.ts
-var globalBunaryConfig = null;
-globalThis.__bunaryCoreConfig = {
-  getConfig: () => globalBunaryConfig
-};
-function defineConfig(config) {
-  const validated = {
-    app: {
-      name: config.app.name,
-      env: config.app.env ?? Bun.env.NODE_ENV ?? Environment.DEVELOPMENT,
-      debug: config.app.debug ?? Bun.env.DEBUG === "true"
-    }
-  };
-  if (config.orm) {
-    validated.orm = config.orm;
-  }
-  globalBunaryConfig = validated;
-  return validated;
-}
-function getBunaryConfig() {
-  if (!globalBunaryConfig) {
-    throw new Error("Bunary configuration not set. Call defineConfig() first.");
-  }
-  return globalBunaryConfig;
-}
-function clearBunaryConfig() {
-  globalBunaryConfig = null;
-}
 // src/environment.ts
 function env(key, defaultValue) {
   const value = Bun.env[key];
@@ -58,6 +30,52 @@ function isProd() {
 function isTest() {
   return Bun.env.NODE_ENV === Environment.TEST;
 }
+
+// src/config.ts
+function normalizeEnv(value) {
+  if (value === Environment.DEVELOPMENT)
+    return Environment.DEVELOPMENT;
+  if (value === Environment.PRODUCTION)
+    return Environment.PRODUCTION;
+  if (value === Environment.TEST)
+    return Environment.TEST;
+  return Environment.DEVELOPMENT;
+}
+function createConfig(initial) {
+  let current = initial ? defineConfig(initial) : null;
+  return {
+    set: (config) => {
+      current = defineConfig(config);
+    },
+    get: () => {
+      if (!current) {
+        throw new Error("Bunary configuration not set. Call set() first.");
+      }
+      return current;
+    },
+    clear: () => {
+      current = null;
+    }
+  };
+}
+function defineConfig(config) {
+  const rawEnv = config.app.env ?? Bun.env.NODE_ENV;
+  const validated = {
+    app: {
+      name: config.app.name,
+      env: normalizeEnv(rawEnv),
+      debug: config.app.debug ?? env("DEBUG", false)
+    }
+  };
+  if (config.orm) {
+    validated.orm = config.orm;
+  }
+  return validated;
+}
+function getBunaryConfig() {
+  throw new Error("Global Bunary configuration has been removed. Create an instance config store with createConfig() and call store.get().");
+}
+function clearBunaryConfig() {}
 export {
   isTest,
   isProd,
@@ -65,6 +83,7 @@ export {
   getBunaryConfig,
   env,
   defineConfig,
+  createConfig,
   clearBunaryConfig,
   Environment
 };

package/dist/types.d.ts

@@ -27,6 +27,13 @@ export interface OrmConfig {
             password: string;
             database: string;
         };
+        postgres?: {
+            host: string;
+            port?: number;
+            user: string;
+            password: string;
+            database: string;
+        };
     };
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;QACtC,MAAM,CAAC,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,KAAK,CAAC,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;QACtC,MAAM,CAAC,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,KAAK,CAAC,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,oDAAoD;IACpD,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunary/core",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "Foundation module for Bunary - config, environment, and app helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
     "bun": ">=1.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
+    "@biomejs/biome": "^2.3.13",
     "bun-types": "latest"
   }
 }