@bunary/core 0.0.1 → 0.0.3

package/README.md

@@ -0,0 +1,71 @@
+# @bunary/core
+
+Foundation module for the Bunary framework — configuration, environment helpers, and shared utilities.
+
+## Installation
+
+```bash
+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
+
+```typescript
+import { defineConfig } from '@bunary/core';
+
+export default defineConfig({
+  app: {
+    name: 'MyApp',
+    env: 'development',
+    debug: true,
+  },
+});
+```
+
+## 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
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+import type { BunaryConfig } from "./types";
+/**
+ * Define Bunary configuration with type safety
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@bunary/core";
+ *
+ * export default defineConfig({
+ *   app: {
+ *     name: "MyApp",
+ *     env: "development",
+ *   },
+ * });
+ * ```
+ */
+export declare function defineConfig(config: BunaryConfig): BunaryConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAW/D"}

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Application environment constants
+ */
+export declare const Environment: {
+    readonly DEVELOPMENT: "development";
+    readonly PRODUCTION: "production";
+    readonly TEST: "test";
+};
+export type EnvironmentType = (typeof Environment)[keyof typeof Environment];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Environment helpers using Bun.env
+ */
+/**
+ * Get an environment variable with optional default and automatic type coercion
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if not set (also determines return type)
+ * @returns The environment variable value, coerced to match defaultValue type
+ * @example
+ * ```ts
+ * const port = env('PORT', 3000);     // Returns number
+ * const debug = env('DEBUG', false);  // Returns boolean
+ * const name = env('APP_NAME', 'app'); // Returns string
+ * const secret = env('SECRET');        // Returns string | undefined
+ * ```
+ */
+export declare function env(key: string): string | undefined;
+export declare function env(key: string, defaultValue: string): string;
+export declare function env(key: string, defaultValue: number): number;
+export declare function env(key: string, defaultValue: boolean): boolean;
+/**
+ * Check if running in development mode
+ */
+export declare function isDev(): boolean;
+/**
+ * Check if running in production mode
+ */
+export declare function isProd(): boolean;
+/**
+ * Check if running in test mode
+ */
+export declare function isTest(): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACrD,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;AAC/D,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;AAC/D,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC;AAuBjE;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @bunary/core
+ * Foundation module for Bunary - config, environment, and app helpers
+ */
+export { defineConfig } from "./config";
+export { Environment, type EnvironmentType } from "./constants";
+export { env, isDev, isProd, isTest } from "./environment";
+export type { BunaryConfig, AppConfig } from "./types";
+//# 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;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,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,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+// @bun
+// src/constants.ts
+var Environment = {
+  DEVELOPMENT: "development",
+  PRODUCTION: "production",
+  TEST: "test"
+};
+
+// src/config.ts
+function defineConfig(config) {
+  return {
+    app: {
+      name: config.app.name,
+      env: config.app.env ?? Bun.env.NODE_ENV ?? Environment.DEVELOPMENT,
+      debug: config.app.debug ?? Bun.env.DEBUG === "true"
+    }
+  };
+}
+// src/environment.ts
+function env(key, defaultValue) {
+  const value = Bun.env[key];
+  if (value === undefined) {
+    return defaultValue;
+  }
+  if (typeof defaultValue === "boolean") {
+    return value === "true" || value === "1" || value === "yes";
+  }
+  if (typeof defaultValue === "number") {
+    const num = Number(value);
+    return Number.isNaN(num) ? defaultValue : num;
+  }
+  return value;
+}
+function isDev() {
+  return Bun.env.NODE_ENV === Environment.DEVELOPMENT || !Bun.env.NODE_ENV;
+}
+function isProd() {
+  return Bun.env.NODE_ENV === Environment.PRODUCTION;
+}
+function isTest() {
+  return Bun.env.NODE_ENV === Environment.TEST;
+}
+export {
+  isTest,
+  isProd,
+  isDev,
+  env,
+  defineConfig,
+  Environment
+};

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+import type { EnvironmentType } from "./constants.js";
+/**
+ * App configuration
+ */
+export interface AppConfig {
+    /** Application name */
+    name: string;
+    /** Environment: development, production, test */
+    env?: EnvironmentType;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * Root Bunary configuration
+ */
+export interface BunaryConfig {
+    app: AppConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,SAAS,CAAC;CAChB"}

package/package.json

@@ -1,10 +1,40 @@
 {
   "name": "@bunary/core",
-  "version": "0.0.1",
-  "description": "",
-  "main": "index.js",
-  "keywords": ["bunary", "core"],
-  "author": "paul@mylocahost.com",
+  "version": "0.0.3",
+  "description": "Foundation module for Bunary - config, environment, and app helpers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun && bunx tsc -p tsconfig.build.json",
+    "typecheck": "bunx tsc --noEmit",
+    "test": "bun test",
+    "lint": "bunx biome check ./src"
+  },
+  "keywords": [
+    "bunary",
+    "bun",
+    "backend",
+    "framework",
+    "config"
+  ],
+  "author": "Paul Radford",
   "license": "MIT",
-  "type": "commonjs"
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "bun-types": "latest"
+  }
 }