@apex-stack/data 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andre Corugda
+
+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/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { ApexResource } from '@apex-stack/core';
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { ZodRawShape } from 'zod';
+
+type ApexDb = ReturnType<typeof drizzle>;
+/** Open a SQLite database and wrap it with Drizzle. */
+declare function createDb(path: string): {
+    db: ApexDb;
+    sqlite: Database.Database;
+};
+/**
+ * Apply pending `*.sql` migrations from `dir`, tracked in `_apex_migrations`.
+ * Idempotent: each file runs once, in filename order, inside a transaction.
+ * Returns the names of migrations applied this run.
+ */
+declare function applyMigrations(sqlite: Database.Database, dir: string): string[];
+interface DefineResourceOptions {
+    db: ApexDb;
+    /** A Drizzle table. */
+    table: any;
+    /** Zod raw shape validating the create payload. */
+    insert: ZodRawShape;
+    /** Primary-key column name. Defaults to `id`. */
+    pk?: string;
+}
+/**
+ * Turn one table into a REST + MCP resource: `list`, `get`, and `create` routes,
+ * each also an MCP tool. This is the moat — your data is AI-callable by construction.
+ *   GET  /api/<name>        → list
+ *   GET  /api/<name>/:id    → get
+ *   POST /api/<name>        → create
+ */
+declare function defineResource(name: string, opts: DefineResourceOptions): ApexResource;
+
+export { type ApexDb, type DefineResourceOptions, applyMigrations, createDb, defineResource };

package/dist/index.js

@@ -0,0 +1,111 @@
+// src/index.ts
+import { readdirSync, readFileSync } from "fs";
+import { join } from "path";
+import { defineApexRoute } from "@apex-stack/core";
+import Database from "better-sqlite3";
+import { drizzle } from "drizzle-orm/better-sqlite3";
+import { eq } from "drizzle-orm";
+import { z } from "zod";
+function createDb(path) {
+  const sqlite = new Database(path);
+  sqlite.pragma("journal_mode = WAL");
+  return { db: drizzle(sqlite), sqlite };
+}
+function applyMigrations(sqlite, dir) {
+  sqlite.exec(
+    "CREATE TABLE IF NOT EXISTS _apex_migrations (name TEXT PRIMARY KEY, applied_at TEXT NOT NULL)"
+  );
+  const applied = new Set(
+    sqlite.prepare("SELECT name FROM _apex_migrations").all().map((r) => r.name)
+  );
+  const done = [];
+  for (const file of readdirSync(dir).filter((f) => f.endsWith(".sql")).sort()) {
+    if (applied.has(file)) continue;
+    const sql = readFileSync(join(dir, file), "utf8");
+    const at = (/* @__PURE__ */ new Date()).toISOString();
+    sqlite.transaction(() => {
+      sqlite.exec(sql);
+      sqlite.prepare("INSERT INTO _apex_migrations (name, applied_at) VALUES (?, ?)").run(file, at);
+    })();
+    done.push(file);
+  }
+  return done;
+}
+function defineResource(name, opts) {
+  const { db, table, insert, pk = "id" } = opts;
+  const pkCol = table[pk];
+  const updateShape = { id: z.coerce.number() };
+  for (const [key, schema] of Object.entries(
+    insert
+  )) {
+    updateShape[key] = schema.optional();
+  }
+  return {
+    __apexResource: true,
+    name,
+    routes: [
+      {
+        pathSuffix: "",
+        mcpName: `${name}_list`,
+        route: defineApexRoute({
+          method: "GET",
+          description: `List all ${name}`,
+          mcp: true,
+          handler: () => db.select().from(table).all()
+        })
+      },
+      {
+        pathSuffix: "/:id",
+        mcpName: `${name}_get`,
+        route: defineApexRoute({
+          method: "GET",
+          description: `Get a single ${name} by id`,
+          input: { id: z.coerce.number() },
+          mcp: true,
+          handler: ({ input }) => db.select().from(table).where(eq(pkCol, input.id)).get() ?? null
+        })
+      },
+      {
+        pathSuffix: "",
+        mcpName: `${name}_create`,
+        route: defineApexRoute({
+          method: "POST",
+          description: `Create a ${name}`,
+          input: insert,
+          mcp: true,
+          handler: ({ input }) => db.insert(table).values(input).returning().get()
+        })
+      },
+      {
+        pathSuffix: "/:id",
+        mcpName: `${name}_update`,
+        route: defineApexRoute({
+          method: "PATCH",
+          description: `Update a ${name} by id (partial)`,
+          input: updateShape,
+          mcp: true,
+          handler: ({ input }) => {
+            const { id, ...fields } = input;
+            return db.update(table).set(fields).where(eq(pkCol, id)).returning().get() ?? null;
+          }
+        })
+      },
+      {
+        pathSuffix: "/:id",
+        mcpName: `${name}_delete`,
+        route: defineApexRoute({
+          method: "DELETE",
+          description: `Delete a ${name} by id`,
+          input: { id: z.coerce.number() },
+          mcp: true,
+          handler: ({ input }) => db.delete(table).where(eq(pkCol, input.id)).returning().get() ?? null
+        })
+      }
+    ]
+  };
+}
+export {
+  applyMigrations,
+  createDb,
+  defineResource
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@apex-stack/data",
+  "version": "0.1.1",
+  "description": "Data layer for Apex JS — Drizzle-backed resources that are REST + MCP by default",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "drizzle-orm": "^0.38.0",
+    "zod": "^4.4.3",
+    "@apex-stack/core": "0.1.1"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}