@elsium-ai/core 0.1.6 → 0.2.0

package/README.md

@@ -0,0 +1,54 @@
+# @elsium-ai/core
+
+Core types, schemas, errors, and utilities for [ElsiumAI](https://github.com/elsium-ai/elsium-ai).
+
+[![npm](https://img.shields.io/npm/v/@elsium-ai/core.svg)](https://www.npmjs.com/package/@elsium-ai/core)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/elsium-ai/elsium-ai/blob/main/LICENSE)
+
+## Install
+
+```bash
+npm install @elsium-ai/core
+```
+
+## What's Inside
+
+- **Types** — `CompletionRequest`, `LLMResponse`, `Message`, `Middleware`, and all shared interfaces
+- **Circuit Breaker** — Detects failing providers, stops sending traffic, auto-recovers
+- **Request Dedup** — Identical in-flight calls coalesce into one API request
+- **Policy Engine** — Declarative rules to deny by model, cost, token count, or content pattern
+- **Graceful Shutdown** — Drains in-flight operations before process exit
+- **Retry with Backoff** — Exponential backoff with jitter
+- **Logger** — Structured logging with levels and context
+- **Config** — Type-safe environment variable access via `env()`
+
+## Usage
+
+```typescript
+import {
+  createCircuitBreaker,
+  createPolicySet,
+  modelAccessPolicy,
+  costLimitPolicy,
+  policyMiddleware,
+  env,
+} from '@elsium-ai/core'
+
+// Circuit breaker
+const cb = createCircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 30_000 })
+const result = await cb.execute(() => fetchFromProvider())
+
+// Policy engine
+const policies = createPolicySet([
+  modelAccessPolicy(['claude-sonnet-4-6', 'gpt-4o']),
+  costLimitPolicy(5.00),
+])
+```
+
+## Part of ElsiumAI
+
+This package is the foundation layer of the [ElsiumAI](https://github.com/elsium-ai/elsium-ai) framework. See the [full documentation](https://github.com/elsium-ai/elsium-ai) for guides and examples.
+
+## License
+
+[MIT](https://github.com/elsium-ai/elsium-ai/blob/main/LICENSE)

package/dist/index.js

@@ -1,4 +1,3 @@
-// @bun
 // src/errors.ts
 class ElsiumError extends Error {
   code;
@@ -124,7 +123,7 @@ function tryCatchSync(fn) {
   }
 }
 // src/utils.ts
-import { randomBytes } from "crypto";
+import { randomBytes } from "node:crypto";
 function cryptoHex(bytes) {
   return randomBytes(bytes).toString("hex");
 }
@@ -617,7 +616,7 @@ function createCircuitBreaker(config) {
   };
 }
 // src/dedup.ts
-import { createHash } from "crypto";
+import { createHash } from "node:crypto";
 function createDedup(config) {
   const ttlMs = config?.ttlMs ?? 5000;
   const maxEntries = config?.maxEntries ?? 1000;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsium-ai/core",
-	"version": "0.1.6",
+	"version": "0.2.0",
 	"description": "Core types, schemas, errors, and utilities for ElsiumAI",
 	"license": "MIT",
 	"author": "Eric Utrera <ebutrera9103@gmail.com>",
@@ -22,14 +22,13 @@
 		"dist"
 	],
 	"scripts": {
-		"build": "bun build ./src/index.ts --outdir ./dist --target bun && bun x tsc -p tsconfig.build.json --emitDeclarationOnly",
+		"build": "bun build ./src/index.ts --outdir ./dist --target node && bun x tsc -p tsconfig.build.json --emitDeclarationOnly",
 		"dev": "bun --watch src/index.ts"
 	},
 	"dependencies": {
 		"zod": "^3.24.0"
 	},
 	"devDependencies": {
-		"bun-types": "^1.3.0",
 		"typescript": "^5.7.0"
 	}
 }