@bunary/core 0.0.1 → 0.0.2

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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAW/D"}

package/dist/environment.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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<T extends string | number | boolean | undefined>(key: string, defaultValue?: T): T extends undefined ? string | undefined : T;
+/**
+ * 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":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EACjE,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,SAAS,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,CAAC,CAqB9C;AAED;;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,8 @@
+/**
+ * @bunary/core
+ * Foundation module for Bunary - config, environment, and app helpers
+ */
+export { defineConfig } from "./config";
+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,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,42 @@
+// @bun
+// src/config.ts
+function defineConfig(config) {
+  return {
+    app: {
+      name: config.app.name,
+      env: config.app.env ?? Bun.env.NODE_ENV ?? "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";
+  }
+  if (typeof defaultValue === "number") {
+    const num = Number(value);
+    return Number.isNaN(num) ? defaultValue : num;
+  }
+  return value;
+}
+function isDev() {
+  return Bun.env.NODE_ENV === "development" || !Bun.env.NODE_ENV;
+}
+function isProd() {
+  return Bun.env.NODE_ENV === "production";
+}
+function isTest() {
+  return Bun.env.NODE_ENV === "test";
+}
+export {
+  isTest,
+  isProd,
+  isDev,
+  env,
+  defineConfig
+};

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * App configuration
+ */
+export interface AppConfig {
+    /** Application name */
+    name: string;
+    /** Environment: development, production, test */
+    env?: "development" | "production" | "test";
+    /** 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;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,GAAG,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;IAC5C,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.2",
+  "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"
+  }
 }