@arkstack/database 0.1.2 → 0.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toneflix Technologies Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,3 @@
 # @arkstack/database
 
-Database integration package for Arkstack, providing a unified interface for database clients, connection management, and query execution.
+Database module for Arkstack, providing core database integration and data layer features.

package/dist/ValidatorDBDriver-DUvJ-_jF.js

@@ -0,0 +1,18 @@
+import { DB } from "arkormx";
+import { IDatabaseDriver } from "kanun";
+//#region src/ValidatorDBDriver.ts
+var ValidatorDBDriver = class extends IDatabaseDriver {
+	async exists({ table, column, value, ignore }) {
+		try {
+			const query = DB.table(table).where({ [column]: value });
+			if (ignore) query.whereNot({ [column]: ignore });
+			return await query.exists();
+		} catch {
+			return false;
+		}
+	}
+};
+//#endregion
+export { ValidatorDBDriver as t };
+
+//# sourceMappingURL=ValidatorDBDriver-DUvJ-_jF.js.map

package/dist/ValidatorDBDriver-DUvJ-_jF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidatorDBDriver-DUvJ-_jF.js","names":[],"sources":["../src/ValidatorDBDriver.ts"],"sourcesContent":["import { IDatabaseDriver, ValidationDatabaseExistsInput } from 'kanun'\n\nimport { DB } from 'arkormx'\n\nexport class ValidatorDBDriver extends IDatabaseDriver {\n    async exists ({ table, column, value, ignore }: ValidationDatabaseExistsInput) {\n        try {\n            const query = DB.table<{ id: string }>(table).where({ [column]: value })\n\n            if (ignore) {\n                query.whereNot({ [column]: ignore })\n            }\n\n            return await query.exists()\n        } catch {\n            return false\n        }\n    }\n}"],"mappings":";;;AAIA,IAAa,oBAAb,cAAuC,gBAAgB;CACnD,MAAM,OAAQ,EAAE,OAAO,QAAQ,OAAO,UAAyC;EAC3E,IAAI;GACA,MAAM,QAAQ,GAAG,MAAsB,MAAM,CAAC,MAAM,GAAG,SAAS,OAAO,CAAC;GAExE,IAAI,QACA,MAAM,SAAS,GAAG,SAAS,QAAQ,CAAC;GAGxC,OAAO,MAAM,MAAM,QAAQ;UACvB;GACJ,OAAO"}

package/dist/commands/MakeFactoryCommand.js

@@ -0,0 +1,15 @@
+import { t as Rebuilder } from "./Rebuilder-DMFg_sP7.js";
+import { CliApp, MakeFactoryCommand as MakeFactoryCommand$1 } from "arkormx";
+//#region src/commands/MakeFactoryCommand.ts
+var MakeFactoryCommand = class extends MakeFactoryCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		const name = this.argument("name");
+		const handle = super.handle();
+		Rebuilder.build(this.app, `${str(name.replace(/Factory$/, "")).append("Factory").pascal()}`, "factories");
+		return handle;
+	}
+};
+//#endregion
+export { MakeFactoryCommand };

package/dist/commands/MakeMigrationCommand.js

@@ -0,0 +1,15 @@
+import { t as Rebuilder } from "./Rebuilder-DMFg_sP7.js";
+import { CliApp, MakeMigrationCommand as MakeMigrationCommand$1 } from "arkormx";
+//#region src/commands/MakeMigrationCommand.ts
+var MakeMigrationCommand = class extends MakeMigrationCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		const name = this.argument("name");
+		const handle = super.handle();
+		Rebuilder.build(this.app, name, "migrations");
+		return handle;
+	}
+};
+//#endregion
+export { MakeMigrationCommand };

package/dist/commands/MakeModelCommand.js

@@ -0,0 +1,15 @@
+import { t as Rebuilder } from "./Rebuilder-DMFg_sP7.js";
+import { CliApp, MakeModelCommand as MakeModelCommand$1 } from "arkormx";
+//#region src/commands/MakeModelCommand.ts
+var MakeModelCommand = class extends MakeModelCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		const name = this.argument("name");
+		const handle = super.handle();
+		Rebuilder.build(this.app, str(name.replace(/Model$/, "")).pascal().toString(), "models");
+		return handle;
+	}
+};
+//#endregion
+export { MakeModelCommand };

package/dist/commands/MakeSeederCommand.js

@@ -0,0 +1,15 @@
+import { t as Rebuilder } from "./Rebuilder-DMFg_sP7.js";
+import { CliApp, MakeSeederCommand as MakeSeederCommand$1 } from "arkormx";
+//#region src/commands/MakeSeederCommand.ts
+var MakeSeederCommand = class extends MakeSeederCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		const name = this.argument("name");
+		const handle = super.handle();
+		Rebuilder.build(this.app, `${str(name.replace(/Seeder$/, "")).append("Seeder").pascal()}`, "seeders");
+		return handle;
+	}
+};
+//#endregion
+export { MakeSeederCommand };

package/dist/commands/MigrateCommand.js

@@ -0,0 +1,11 @@
+import { CliApp, MigrateCommand as MigrateCommand$1 } from "arkormx";
+//#region src/commands/MigrateCommand.ts
+var MigrateCommand = class extends MigrateCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		return super.handle();
+	}
+};
+//#endregion
+export { MigrateCommand };

package/dist/commands/MigrateFreshCommand.js

@@ -0,0 +1,11 @@
+import { CliApp, MigrateFreshCommand as MigrateFreshCommand$1 } from "arkormx";
+//#region src/commands/MigrateFreshCommand.ts
+var MigrateFreshCommand = class extends MigrateFreshCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		return super.handle();
+	}
+};
+//#endregion
+export { MigrateFreshCommand };

package/dist/commands/MigrateRollbackCommand.js

@@ -0,0 +1,11 @@
+import { CliApp, MigrateRollbackCommand as MigrateRollbackCommand$1 } from "arkormx";
+//#region src/commands/MigrateRollbackCommand.ts
+var MigrateRollbackCommand = class extends MigrateRollbackCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		return super.handle();
+	}
+};
+//#endregion
+export { MigrateRollbackCommand };

package/dist/commands/MigrationHistoryCommand.js

@@ -0,0 +1,11 @@
+import { CliApp, MigrationHistoryCommand as MigrationHistoryCommand$1 } from "arkormx";
+//#region src/commands/MigrationHistoryCommand.ts
+var MigrationHistoryCommand = class extends MigrationHistoryCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		return super.handle();
+	}
+};
+//#endregion
+export { MigrationHistoryCommand };

package/dist/commands/ModelsSyncCommand.js

@@ -0,0 +1,11 @@
+import { CliApp, ModelsSyncCommand as ModelsSyncCommand$1 } from "arkormx";
+//#region src/commands/ModelsSyncCommand.ts
+var ModelsSyncCommand = class extends ModelsSyncCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		return super.handle();
+	}
+};
+//#endregion
+export { ModelsSyncCommand };

package/dist/commands/Rebuilder-DMFg_sP7.js

@@ -0,0 +1,62 @@
+import { createRequire } from "node:module";
+import { readFile, writeFile } from "node:fs/promises";
+import { Logger } from "@arkstack/common";
+import { globSync } from "node:fs";
+import { join } from "node:path";
+//#region src/extensions/Rebuilder.ts
+var Rebuilder = class Rebuilder {
+	app;
+	constructor(app) {
+		this.app = app;
+	}
+	static async build(app, name, type = "models") {
+		try {
+			const inst = new Rebuilder(app);
+			const dir = inst.paths()[type] ?? join(process.cwd(), "src", type);
+			let outputPath = join(dir, `${name}.${inst.resolveOutputExt()}`);
+			if (type === "migrations") outputPath = globSync(`${join(dir, inst.date())}*_${name}.ts`, {
+				cwd: process.cwd(),
+				withFileTypes: false
+			}).sort().at(-1);
+			const content = inst.content(await readFile(outputPath, "utf8"), type);
+			await writeFile(outputPath, content, "utf8");
+		} catch (error) {
+			Logger.error(error.message, false);
+		}
+	}
+	paths() {
+		return this.app.getConfig("paths") ?? {};
+	}
+	content(content, type) {
+		const replacement = {
+			models: [/import\s*{\s*Model\s*}\s*from\s*['"]\s*arkormx\s*['"]\s*;?/g, "import { Model } from '@arkstack/database'\n\n"],
+			seeders: [/import\s*{\s*Seeder\s*}\s*from\s*['"]\s*arkormx\s*['"]\s*;?/g, "import { Seeder } from '@arkstack/database'\n\n"],
+			factories: [/import\s*{\s*ModelFactory\s*}\s*from\s*['"]\s*arkormx\s*['"]\s*;?/g, "import { ModelFactory } from '@arkstack/database'\n"],
+			migrations: [/import\s*{\s*(.*?)\s*}\s*from\s*['"]\s*arkormx\s*['"]\s*;?/g, (_, val) => `import { ${val.trim()} } from '@arkstack/database'\n\n`]
+		}[type];
+		return content.replace(replacement[0], replacement[1]);
+	}
+	resolveOutputExt() {
+		const preferred = this.app.getConfig("outputExt") === "js" ? "js" : "ts";
+		if (preferred === "ts" && !this.hasTypeScriptInstalled()) return "js";
+		return preferred;
+	}
+	hasTypeScriptInstalled() {
+		try {
+			createRequire(import.meta.url).resolve("typescript", { paths: [process.cwd()] });
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	date() {
+		const now = /* @__PURE__ */ new Date();
+		return [
+			now.getFullYear(),
+			String(now.getMonth() + 1).padStart(2, "0"),
+			String(now.getDate()).padStart(2, "0")
+		].join("");
+	}
+};
+//#endregion
+export { Rebuilder as t };

package/dist/commands/SeedCommand.js

@@ -0,0 +1,11 @@
+import { CliApp, SeedCommand as SeedCommand$1 } from "arkormx";
+//#region src/commands/SeedCommand.ts
+var SeedCommand = class extends SeedCommand$1 {
+	async handle() {
+		this.app.command = this;
+		this.app = new CliApp();
+		return super.handle();
+	}
+};
+//#endregion
+export { SeedCommand };

package/dist/index.d.ts

@@ -1,21 +1,33 @@
-//#region src/index.d.ts
-interface AdapterFactoryOptions {
-  connectionString: string;
-}
-interface DatabaseAdapterFactory<TAdapter> {
-  (options: AdapterFactoryOptions): TAdapter;
-}
-interface DatabaseClientFactory<TAdapter, TClient> {
-  (options: {
-    adapter: TAdapter;
-  }): TClient;
-}
-interface CreateDatabaseClientOptions<TAdapter, TClient> {
-  connectionString?: string;
-  createAdapter: DatabaseAdapterFactory<TAdapter>;
-  createClient: DatabaseClientFactory<TAdapter, TClient>;
+import { DB as DB$1, FactoryAttributes, Migration as Migration$1, Model as Model$1, ModelAttributes, ModelAttributesOf, ModelFactory as ModelFactory$1, ModelQuerySchemaLike, SchemaBuilder as SchemaBuilder$1, Seeder as Seeder$1 } from "arkormx";
+import { IDatabaseDriver, ValidationDatabaseExistsInput } from "kanun";
+
+//#region src/extensions/DB.d.ts
+declare class DB extends DB$1 {}
+//#endregion
+//#region src/extensions/Factory.d.ts
+declare abstract class ModelFactory<TModel, TAttributes extends FactoryAttributes = Partial<ModelAttributes<TModel>>> extends ModelFactory$1<TModel, TAttributes> {}
+//#endregion
+//#region src/extensions/Migration.d.ts
+declare abstract class Migration extends Migration$1 {}
+//#endregion
+//#region src/extensions/Model.d.ts
+declare abstract class Model<TSchema extends ModelQuerySchemaLike | Record<string, unknown> | string = Record<string, any>, TAttributes extends Record<string, unknown> = ModelAttributesOf<TSchema>> extends Model$1<TSchema, TAttributes> {}
+//#endregion
+//#region src/extensions/SchemaBuilder.d.ts
+declare class SchemaBuilder extends SchemaBuilder$1 {}
+//#endregion
+//#region src/extensions/Seeder.d.ts
+declare abstract class Seeder extends Seeder$1 {}
+//#endregion
+//#region src/ValidatorDBDriver.d.ts
+declare class ValidatorDBDriver extends IDatabaseDriver {
+  exists({
+    table,
+    column,
+    value,
+    ignore
+  }: ValidationDatabaseExistsInput): Promise<boolean>;
 }
-declare const createDatabaseClient: <TAdapter, TClient>(options: CreateDatabaseClientOptions<TAdapter, TClient>) => TClient;
 //#endregion
-export { AdapterFactoryOptions, CreateDatabaseClientOptions, DatabaseAdapterFactory, DatabaseClientFactory, createDatabaseClient };
+export { DB, Migration, Model, ModelFactory, SchemaBuilder, Seeder, ValidatorDBDriver };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,10 +1,23 @@
-//#region src/index.ts
-const createDatabaseClient = (options) => {
-	const connectionString = options.connectionString ?? process.env.DATABASE_URL ?? "";
-	const adapter = options.createAdapter({ connectionString });
-	return options.createClient({ adapter });
-};
-
+import { t as ValidatorDBDriver } from "./ValidatorDBDriver-DUvJ-_jF.js";
+import { DB as DB$1, Migration as Migration$1, Model as Model$1, ModelFactory as ModelFactory$1, SchemaBuilder as SchemaBuilder$1, Seeder as Seeder$1 } from "arkormx";
+//#region src/extensions/DB.ts
+var DB = class extends DB$1 {};
+//#endregion
+//#region src/extensions/Factory.ts
+var ModelFactory = class extends ModelFactory$1 {};
+//#endregion
+//#region src/extensions/Migration.ts
+var Migration = class extends Migration$1 {};
+//#endregion
+//#region src/extensions/Model.ts
+var Model = class extends Model$1 {};
 //#endregion
-export { createDatabaseClient };
+//#region src/extensions/SchemaBuilder.ts
+var SchemaBuilder = class extends SchemaBuilder$1 {};
+//#endregion
+//#region src/extensions/Seeder.ts
+var Seeder = class extends Seeder$1 {};
+//#endregion
+export { DB, Migration, Model, ModelFactory, SchemaBuilder, Seeder, ValidatorDBDriver };
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export interface AdapterFactoryOptions {\n    connectionString: string;\n}\n\nexport interface DatabaseAdapterFactory<TAdapter> {\n    (options: AdapterFactoryOptions): TAdapter;\n}\n\nexport interface DatabaseClientFactory<TAdapter, TClient> {\n    (options: { adapter: TAdapter }): TClient;\n}\n\nexport interface CreateDatabaseClientOptions<TAdapter, TClient> {\n    connectionString?: string;\n    createAdapter: DatabaseAdapterFactory<TAdapter>;\n    createClient: DatabaseClientFactory<TAdapter, TClient>;\n}\n\nexport const createDatabaseClient = <TAdapter, TClient> (\n    options: CreateDatabaseClientOptions<TAdapter, TClient>,\n): TClient => {\n    const connectionString = options.connectionString ?? process.env.DATABASE_URL ?? ''\n    const adapter = options.createAdapter({ connectionString })\n\n    return options.createClient({ adapter })\n}\n"],"mappings":";AAkBA,MAAa,wBACT,YACU;CACV,MAAM,mBAAmB,QAAQ,oBAAoB,QAAQ,IAAI,gBAAgB;CACjF,MAAM,UAAU,QAAQ,cAAc,EAAE,kBAAkB,CAAC;AAE3D,QAAO,QAAQ,aAAa,EAAE,SAAS,CAAC"}
+{"version":3,"file":"index.js","names":["BaseDB","BaseModelFactory","BaseMigration","BaseModel","BaseSchemaBuilder","BaseSeeder"],"sources":["../src/extensions/DB.ts","../src/extensions/Factory.ts","../src/extensions/Migration.ts","../src/extensions/Model.ts","../src/extensions/SchemaBuilder.ts","../src/extensions/Seeder.ts"],"sourcesContent":["import { DB as BaseDB } from 'arkormx'\n\nexport class DB extends BaseDB {\n}","import { ModelFactory as BaseModelFactory, FactoryAttributes, ModelAttributes } from 'arkormx'\n\nexport abstract class ModelFactory<TModel, TAttributes extends FactoryAttributes = Partial<ModelAttributes<TModel>>> extends BaseModelFactory<TModel, TAttributes> {\n}","import { Migration as BaseMigration } from 'arkormx'\n\nexport abstract class Migration extends BaseMigration {\n}","import { Model as BaseModel, ModelAttributesOf, ModelQuerySchemaLike } from 'arkormx'\n\nexport abstract class Model<TSchema extends ModelQuerySchemaLike | Record<string, unknown> | string = Record<string, any>, TAttributes extends Record<string, unknown> = ModelAttributesOf<TSchema>> extends BaseModel<TSchema, TAttributes> {\n}","import { SchemaBuilder as BaseSchemaBuilder } from 'arkormx'\n\nexport class SchemaBuilder extends BaseSchemaBuilder {\n}","import { Seeder as BaseSeeder } from 'arkormx'\n\nexport abstract class Seeder extends BaseSeeder {\n}"],"mappings":";;;AAEA,IAAa,KAAb,cAAwBA,KAAO;;;ACA/B,IAAsB,eAAtB,cAA6HC,eAAsC;;;ACAnK,IAAsB,YAAtB,cAAwCC,YAAc;;;ACAtD,IAAsB,QAAtB,cAA6MC,QAAgC;;;ACA7O,IAAa,gBAAb,cAAmCC,gBAAkB;;;ACArD,IAAsB,SAAtB,cAAqCC,SAAW"}

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/setup.js

@@ -0,0 +1,11 @@
+import { t as ValidatorDBDriver } from "./ValidatorDBDriver-DUvJ-_jF.js";
+import { Validator } from "kanun";
+import { CoreRouter } from "clear-router/core";
+import { clearRouterPlugin } from "@arkormx/plugin-clear-router";
+//#region src/setup.ts
+CoreRouter.use(clearRouterPlugin);
+Validator.useDatabase(new ValidatorDBDriver());
+//#endregion
+export {};
+
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","names":[],"sources":["../src/setup.ts"],"sourcesContent":["import { CoreRouter } from 'clear-router/core'\nimport { Validator } from 'kanun'\nimport { ValidatorDBDriver } from './ValidatorDBDriver'\nimport { clearRouterPlugin } from '@arkormx/plugin-clear-router'\n\nCoreRouter.use(clearRouterPlugin)\nValidator.useDatabase(new ValidatorDBDriver())"],"mappings":";;;;;AAKA,WAAW,IAAI,kBAAkB;AACjC,UAAU,YAAY,IAAI,mBAAmB,CAAA"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@arkstack/database",
-  "version": "0.1.2",
+  "version": "0.5.1",
   "type": "module",
-  "description": "Database package for Arkstack providing database-specific implementations of core Arkstack features such as routing, middleware, and database integration.",
+  "description": "Database module for Arkstack, providing core database integration and data layer features.",
   "homepage": "https://arkstack.toneflix.net",
   "repository": {
     "type": "git",
@@ -11,16 +11,16 @@
   },
   "keywords": [
     "database",
-    "integration",
-    "client",
-    "connection",
-    "query",
-    "execution",
-    "arkstack",
+    "arkorm",
+    "models",
+    "eloquent",
     "prisma",
-    "typeorm",
-    "mongoose",
-    "sequelize"
+    "kysely",
+    "mysql",
+    "mariadb",
+    "sql",
+    "postgresql",
+    "h3ravel"
   ],
   "files": [
     "dist"
@@ -30,10 +30,32 @@
   },
   "exports": {
     ".": "./dist/index.js",
+    "./MakeFactoryCommand": "./dist/commands/MakeFactoryCommand.js",
+    "./MakeMigrationCommand": "./dist/commands/MakeMigrationCommand.js",
+    "./MakeModelCommand": "./dist/commands/MakeModelCommand.js",
+    "./MakeSeederCommand": "./dist/commands/MakeSeederCommand.js",
+    "./MigrateCommand": "./dist/commands/MigrateCommand.js",
+    "./MigrateFreshCommand": "./dist/commands/MigrateFreshCommand.js",
+    "./MigrateRollbackCommand": "./dist/commands/MigrateRollbackCommand.js",
+    "./MigrationHistoryCommand": "./dist/commands/MigrationHistoryCommand.js",
+    "./ModelsSyncCommand": "./dist/commands/ModelsSyncCommand.js",
+    "./SeedCommand": "./dist/commands/SeedCommand.js",
+    "./setup": "./dist/setup.js",
     "./package.json": "./package.json"
   },
+  "peerDependencies": {
+    "kanun": "^1.1.0",
+    "clear-router": "^2.6.4"
+  },
+  "dependencies": {
+    "@arkormx/plugin-clear-router": "^0.1.9",
+    "arkormx": "^2.0.11",
+    "@arkstack/common": "^0.5.1",
+    "@arkstack/contract": "^0.5.1"
+  },
   "scripts": {
-    "build": "tsdown --config-loader unconfig",
-    "version:patch": "pnpm version patch --no-git-tag-version"
+    "build": "tsdown --config-loader unrun",
+    "test": "vitest",
+    "version:patch": "pnpm version patch"
   }
 }