@m3rcena/eco 14.28.1-dev.0 → 14.28.1

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to `@m3rcena/eco` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+---
+
+## [14.28.1] - 2026-11-05
+
+### 🚀 Enhancements & Compatibility
+
+#### Added
+- **Discord.js v14.28.1 Compatibility**:
+  - Full compatibility with Discord.js `14.28.1` and `Events.ClientReady` lifecycle.
+- **Zero-Dependency Native SQLite Storage (`SqliteEcoStorage`)**:
+  - Built-in persistent storage adapter utilizing Node.js 22+ native `node:sqlite` DatabaseSync with WAL journal mode.
+  - Automatic table initialization for `eco_accounts` and `eco_kv`.
+- **Enterprise Prisma ORM Adapter (`PrismaEcoStorage`)**:
+  - Auto-migrating Prisma storage with auto-schema injection and raw SQL fallbacks for PostgreSQL, MySQL, and SQLite.
+  - Schema migration helpers (`PRISMA_ECO_MODEL`, `applyPrismaEcoModel`).
+- **Rust-Style Submodule Resolver & Local Hosting**:
+  - Local-first Git submodule detection via `@m3rcena/eco/resolver`.
+  - Zero-config runtime interception flag via `@m3rcena/eco/register`.
+  - Standalone CLI host service via `@m3rcena/eco/host` (`hostEco`).
+- **Terminal Update Notifier**:
+  - Symmetrical terminal notification box with semver comparison (`checkPackageUpdates`).
+- **Strongly-Typed Event Emitter**:
+  - Comprehensive TypeScript definition for all `EcoEvents` parameters across `on`, `once`, and `off`.
+- **Synchronized with `@m3rcena/bridge` v14.28.1**:
+  - Full real-time bi-directional action dispatching, debit card REST streaming, and presence-filtered audio cues.
+
+---
+
 ## [14.28.0] - 2026-11-01
 
 ### Added

package/DOCUMENTATION.md

@@ -8,7 +8,7 @@
 > - **[Stocks, Heists, Pets & Loot Crates](https://github.com/M3rcena/m3rcena-eco/wiki/Stocks-Heists-and-Pets)**
 > - **[Dashboard Bridge Integration](https://github.com/M3rcena/m3rcena-eco/wiki/Bridge-Integration)**
 
-Welcome to the definitive documentation for **`@m3rcena/eco`** (v14.28.0) — the ultimate enterprise-grade Discord.js v14 economy, progression, career, stock market, and casino engine.
+Welcome to the definitive documentation for **`@m3rcena/eco`** (v14.28.1) — the ultimate enterprise-grade Discord.js v14 economy, progression, career, stock market, and casino engine.
 
 ---
 

package/README.md

@@ -4,7 +4,9 @@
   <p><strong>The ultimate enterprise-grade Discord.js v14 economy, progression, stock market, and casino engine.</strong></p>
   <p>
     <a href="https://www.npmjs.com/package/@m3rcena/eco"><img src="https://img.shields.io/npm/v/@m3rcena/eco.svg?style=flat-square" alt="NPM Version" /></a>
-    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg?style=flat-square" alt="Node Support" /></a>
+    <img src="https://img.shields.io/badge/discord.js-v14.28.1-5865F2?style=flat-square&logo=discord" alt="discord.js v14.28.1" />
+    <img src="https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg?style=flat-square&logo=node.js" alt="Node Support" />
+    <img src="https://img.shields.io/badge/TypeScript-7.0-blue?style=flat-square&logo=typescript" alt="TypeScript" />
     <a href="https://github.com/M3rcena/m3rcena-eco/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg?style=flat-square" alt="License" /></a>
     <a href="https://github.com/M3rcena/m3rcena-eco/wiki"><img src="https://img.shields.io/badge/Wiki-Documentation-purple.svg?style=flat-square" alt="Eco Wiki Documentation" /></a>
   </p>
@@ -30,19 +32,69 @@
 - 🎰 **Casino & Gambling Suite**: Components V2 interactive Blackjack table (Hit, Stand, Double Down), Coinflip, Roulette, Crash multiplier rockets, Dice, and Slots.
 - 🏢 **Passive Business Enterprises**: Buy and upgrade companies (Lemonade Stands, Coffee Chains, Off-World Mining) with employee hiring and offline profit accumulation.
 - 🏆 **Interactive Leaderboards**: Paginated top rankings with metric selection (`Net Worth`, `Wallet`, `Bank`, `Level`, `Streaks`).
+- 💾 **Native SQLite & Enterprise Prisma Storage**: Built-in zero-dependency local SQLite (`node:sqlite` WAL mode via `SqliteEcoStorage`) and auto-migrating Prisma ORM adapter (`PrismaEcoStorage`).
+- 🦀 **Rust-Style Submodule Resolver**: Install and host via Git submodules locally with zero npm dependencies or transparently fall back to npm (`@m3rcena/eco/resolver`, `@m3rcena/eco/register`, `@m3rcena/eco/host`).
 - 🌐 **Dashboard Bridge**: Native integration with `@m3rcena/bridge` for real-time WebSocket syncing and presence-filtered audio cues (`coin_drop`, `win`, `purchase`, `rob_siren`).
+- 🤖 **Discord.js v14.28.1 Ready**: Fully compatible with the latest Discord.js updates and `clientReady` lifecycle.
 - ⚡ **Next-Gen Performance**: Dual ESM/CJS, TypeScript 7.0 definitions, zero bloat, and sub-millisecond execution.
 
 ---
 
 ## 📦 Installation
 
+### Option A: Standard NPM Installation
+
 ```bash
+# npm
 npm install @m3rcena/eco @m3rcena/bridge @napi-rs/canvas discord.js
+
+# pnpm
+pnpm add @m3rcena/eco @m3rcena/bridge @napi-rs/canvas discord.js
+
+# yarn
+yarn add @m3rcena/eco @m3rcena/bridge @napi-rs/canvas discord.js
 ```
 
 > **Note**: Requires Node.js **22.0.0+** (LTS 22, 24, 26). Node 20 is EOL and unsupported.
 
+### Option B: Local Git Submodule (Rust-Style Resolver)
+
+You can vendor and host `@m3rcena/eco` locally via Git submodules without needing to publish or pull from npm:
+
+```bash
+git submodule add https://github.com/M3rcena/m3rcena-eco.git submodules/m3rcena-eco
+```
+
+Add auto-registration at the top of your app entrypoint:
+```typescript
+import "@m3rcena/eco/register";
+```
+
+Or run standalone hosting:
+```bash
+npx tsx @m3rcena/eco/host --port 5124
+```
+
+---
+
+## 💾 Database Handlers & Persistence
+
+`@m3rcena/eco` supports native SQLite WAL mode, Prisma ORM, and JSON file storage:
+
+```typescript
+import {
+  EcoManager,
+  SqliteEcoStorage,   // Zero-dependency SQLite (WAL mode)
+  PrismaEcoStorage,   // PostgreSQL / MySQL / SQLite via Prisma ORM
+  JsonEcoStorage,     // Lightweight JSON file storage
+} from "@m3rcena/eco";
+
+// Zero-dependency SQLite with WAL journal mode:
+const eco = new EcoManager({
+  storage: new SqliteEcoStorage("./data/economy.sqlite"),
+});
+```
+
 ---
 
 ## 🚀 Quick Example

package/dist/{host-3dAloQHW.cjs → host-Bmld-WtZ.cjs}

@@ -159,9 +159,12 @@ var SqliteEcoStorage = class {
 	dbPath;
 	constructor(options = "./eco.sqlite") {
 		const rawPath = typeof options === "string" ? options : options.path || "./eco.sqlite";
-		this.dbPath = node_path.default.resolve(process.cwd(), rawPath);
-		const dir = node_path.default.dirname(this.dbPath);
-		if (!node_fs.default.existsSync(dir)) node_fs.default.mkdirSync(dir, { recursive: true });
+		if (rawPath === ":memory:") this.dbPath = ":memory:";
+		else {
+			this.dbPath = node_path.default.resolve(process.cwd(), rawPath);
+			const dir = node_path.default.dirname(this.dbPath);
+			if (!node_fs.default.existsSync(dir)) node_fs.default.mkdirSync(dir, { recursive: true });
+		}
 		this.db = new node_sqlite.DatabaseSync(this.dbPath);
 		if (typeof options === "object" ? options.walMode ?? true : true) try {
 			this.db.exec("PRAGMA journal_mode = WAL;");
@@ -4393,6 +4396,103 @@ var RenderMarketChart = class {
 		return canvas.toBuffer("image/png");
 	}
 };
+// src/utils/Notifier.ts
+/**
+* @m3rcena/eco
+* Terminal update notification box utility.
+*
+* @copyright 2026 M3rcena Development. All rights reserved.
+* @license Apache-2.0
+*/
+const yellow = (s) => `\x1b[33m${s}\x1b[39m`;
+const green = (s) => `\x1b[32m${s}\x1b[39m`;
+const red = (s) => `\x1b[31m${s}\x1b[39m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[39m`;
+const ECO_VERSION = "14.28.1";
+/**
+* Strips ANSI color escape codes to compute visible string length.
+*/
+function stripAnsi(str) {
+	return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "");
+}
+/**
+* Renders an array of text messages inside a styled terminal box.
+*/
+function boxConsole(messages) {
+	const stripped = messages.map((m) => stripAnsi(m));
+	const maxLen = Math.max(...stripped.map((s) => s.length)) + 8;
+	const line = yellow("─".repeat(maxLen));
+	console.log(yellow("┌") + line + yellow("┐"));
+	console.log(yellow("│") + " ".repeat(maxLen) + yellow("│"));
+	for (let i = 0; i < messages.length; i++) {
+		const padTotal = maxLen - stripped[i].length;
+		const padLeft = Math.floor(padTotal / 2);
+		const padRight = padTotal - padLeft;
+		console.log(yellow("│") + " ".repeat(padLeft) + messages[i] + " ".repeat(padRight) + yellow("│"));
+	}
+	console.log(yellow("│") + " ".repeat(maxLen) + yellow("│"));
+	console.log(yellow("└") + line + yellow("┘"));
+}
+/**
+* Compares two semantic version strings.
+* Returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2.
+*/
+function compareSemver(v1, v2) {
+	const clean1 = v1.replace(/^v/, "").split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
+	const clean2 = v2.replace(/^v/, "").split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
+	for (let i = 0; i < Math.max(clean1.length, clean2.length); i++) {
+		const num1 = clean1[i] || 0;
+		const num2 = clean2[i] || 0;
+		if (num1 > num2) return 1;
+		if (num1 < num2) return -1;
+	}
+	return 0;
+}
+/**
+* Fetches the latest published version of `@m3rcena/eco` from the npm registry.
+*/
+async function fetchLatestVersion() {
+	try {
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), 3500);
+		timer.unref?.();
+		const res = await fetch("https://registry.npmjs.org/@m3rcena/eco/latest", {
+			signal: controller.signal,
+			headers: { "User-Agent": "@m3rcena/eco-update-notifier" }
+		});
+		clearTimeout(timer);
+		if (res.ok) {
+			const data = await res.json();
+			return typeof data.version === "string" ? data.version : null;
+		}
+	} catch {
+		try {
+			const { exec } = await import("child_process");
+			const { promisify } = await import("util");
+			const { stdout } = await promisify(exec)("npm show @m3rcena/eco version", { timeout: 3500 });
+			return stdout.trim() || null;
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+/**
+* Checks if a newer version of `@m3rcena/eco` is available and logs the notification box.
+*/
+async function checkPackageUpdates(currentVersion = ECO_VERSION, disabled) {
+	if (disabled) return;
+	try {
+		const latest = await fetchLatestVersion();
+		if (!latest) return;
+		if (compareSemver(currentVersion, latest) < 0) boxConsole([
+			`New ${green("version")} of ${yellow("@m3rcena/eco")} is available!`,
+			`${red(currentVersion)} -> ${green(latest)}`,
+			`Registry: ${cyan("https://www.npmjs.com/package/@m3rcena/eco")}`,
+			`Run ${green(`npm i @m3rcena/eco@${latest}`)} to update!`
+		]);
+	} catch {}
+}
 // src/bridge/EcoBridgeRouter.ts
 /**
 * @m3rcena/eco
@@ -4408,7 +4508,7 @@ var EcoBridgeRouter = class {
 	name = "economy";
 	basePath = "/api/eco";
 	description = "Universal economy engine, financial banking, loans, taxes, stock market, and debit card rendering.";
-	version = "14.28.0";
+	version = ECO_VERSION;
 	eco;
 	constructor(eco) {
 		this.eco = eco;
@@ -4981,103 +5081,6 @@ var EcoWekyConnector = class extends node_events.EventEmitter {
 		return this.activeWagers.get(wagerId);
 	}
 };
-// src/utils/Notifier.ts
-/**
-* @m3rcena/eco
-* Terminal update notification box utility.
-*
-* @copyright 2026 M3rcena Development. All rights reserved.
-* @license Apache-2.0
-*/
-const yellow = (s) => `\x1b[33m${s}\x1b[39m`;
-const green = (s) => `\x1b[32m${s}\x1b[39m`;
-const red = (s) => `\x1b[31m${s}\x1b[39m`;
-const cyan = (s) => `\x1b[36m${s}\x1b[39m`;
-const ECO_VERSION = "14.28.0";
-/**
-* Strips ANSI color escape codes to compute visible string length.
-*/
-function stripAnsi(str) {
-	return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "");
-}
-/**
-* Renders an array of text messages inside a styled terminal box.
-*/
-function boxConsole(messages) {
-	const stripped = messages.map((m) => stripAnsi(m));
-	const maxLen = Math.max(...stripped.map((s) => s.length)) + 8;
-	const line = yellow("─".repeat(maxLen));
-	console.log(yellow("┌") + line + yellow("┐"));
-	console.log(yellow("│") + " ".repeat(maxLen) + yellow("│"));
-	for (let i = 0; i < messages.length; i++) {
-		const padTotal = maxLen - stripped[i].length;
-		const padLeft = Math.floor(padTotal / 2);
-		const padRight = padTotal - padLeft;
-		console.log(yellow("│") + " ".repeat(padLeft) + messages[i] + " ".repeat(padRight) + yellow("│"));
-	}
-	console.log(yellow("│") + " ".repeat(maxLen) + yellow("│"));
-	console.log(yellow("└") + line + yellow("┘"));
-}
-/**
-* Compares two semantic version strings.
-* Returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2.
-*/
-function compareSemver(v1, v2) {
-	const clean1 = v1.replace(/^v/, "").split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
-	const clean2 = v2.replace(/^v/, "").split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
-	for (let i = 0; i < Math.max(clean1.length, clean2.length); i++) {
-		const num1 = clean1[i] || 0;
-		const num2 = clean2[i] || 0;
-		if (num1 > num2) return 1;
-		if (num1 < num2) return -1;
-	}
-	return 0;
-}
-/**
-* Fetches the latest published version of `@m3rcena/eco` from the npm registry.
-*/
-async function fetchLatestVersion() {
-	try {
-		const controller = new AbortController();
-		const timer = setTimeout(() => controller.abort(), 3500);
-		timer.unref?.();
-		const res = await fetch("https://registry.npmjs.org/@m3rcena/eco/latest", {
-			signal: controller.signal,
-			headers: { "User-Agent": "@m3rcena/eco-update-notifier" }
-		});
-		clearTimeout(timer);
-		if (res.ok) {
-			const data = await res.json();
-			return typeof data.version === "string" ? data.version : null;
-		}
-	} catch {
-		try {
-			const { exec } = await import("child_process");
-			const { promisify } = await import("util");
-			const { stdout } = await promisify(exec)("npm show @m3rcena/eco version", { timeout: 3500 });
-			return stdout.trim() || null;
-		} catch {
-			return null;
-		}
-	}
-	return null;
-}
-/**
-* Checks if a newer version of `@m3rcena/eco` is available and logs the notification box.
-*/
-async function checkPackageUpdates(currentVersion = ECO_VERSION, disabled) {
-	if (disabled) return;
-	try {
-		const latest = await fetchLatestVersion();
-		if (!latest) return;
-		if (compareSemver(currentVersion, latest) < 0) boxConsole([
-			`New ${green("version")} of ${yellow("@m3rcena/eco")} is available!`,
-			`${red(currentVersion)} -> ${green(latest)}`,
-			`Registry: ${cyan("https://www.npmjs.com/package/@m3rcena/eco")}`,
-			`Run ${green(`npm i @m3rcena/eco@${latest}`)} to update!`
-		]);
-	} catch {}
-}
 // src/EcoManager.ts
 /**
 * @m3rcena/eco
@@ -5792,7 +5795,7 @@ async function hostEco(options = {}) {
 				status: "healthy",
 				package: "@m3rcena/eco",
 				mode: "local-submodule-host",
-				version: "14.28.0",
+				version: ECO_VERSION,
 				database: "SQLite",
 				dbPath,
 				uptime: process.uptime()
@@ -6157,4 +6160,4 @@ Object.defineProperty(exports, "stripAnsi", {
 	}
 });
 
-//# sourceMappingURL=host-3dAloQHW.cjs.map
+//# sourceMappingURL=host-Bmld-WtZ.cjs.map