feat(db): add @atomcms/db package skeleton + mysql2/drizzle client

packages/db/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@atomcms/db",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "db:pull": "drizzle-kit pull"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.38.0",
+    "mysql2": "^3.11.0"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.30.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}

packages/db/src/client.ts

@@ -0,0 +1,16 @@
+import { drizzle, type MySql2Database } from "drizzle-orm/mysql2";
+import mysql from "mysql2/promise";
+import * as schema from "./schema/index.js";
+
+export type Database = MySql2Database<typeof schema>;
+
+/**
+ * Creates a Drizzle client backed by a mysql2 pool.
+ * The connection targets the LIVE emulator-owned database; this layer
+ * only ever reads/writes data — it never runs migrations.
+ */
+export function createDb(databaseUrl: string): { db: Database; pool: mysql.Pool } {
+  const pool = mysql.createPool(databaseUrl);
+  const db = drizzle(pool, { schema, mode: "default" });
+  return { db, pool };
+}

packages/db/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "rootDir": "src", "outDir": "dist" },
+  "include": ["src"]
+}

packages/db/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+// Local config so Vitest does not walk up into the parent Laravel repo's
+// vite.config.js (this monorepo is nested inside the Laravel project).
+export default defineConfig({
+  test: {
+    environment: "node",
+  },
+});