db-model-router 1.0.5 → 1.0.6

package/demo/package.json

@@ -1,34 +0,0 @@
-{
-  "name": "demo",
-  "version": "1.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "start": "node app.js",
-    "dev": "nodemon app.js",
-    "migrate": "node commons/migrate.js",
-    "add_migration": "node commons/add_migration.js",
-    "docker:build": "docker build -t app .",
-    "docker:up": "docker compose up -d",
-    "docker:down": "docker compose down"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "module",
-  "dependencies": {
-    "db-model-router": "latest",
-    "dotenv": "latest",
-    "express": "latest",
-    "express-session": "latest",
-    "better-sqlite3": "latest",
-    "express-rate-limit": "latest",
-    "helmet": "latest",
-    "winston": "latest",
-    "swagger-ui-express": "latest"
-  },
-  "devDependencies": {
-    "nodemon": "latest"
-  }
-}

package/demo/routes/addresses.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import addresses from "../models/addresses.js";
-
-const { route } = dbModelRouter;
-
-export default route(addresses);

package/demo/routes/carts/cart_items.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import cart_items from "../../models/cart_items.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent carts via cart_id
-export default route(cart_items, { cart_id: "params.cart_id" });

package/demo/routes/carts.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import carts from "../models/carts.js";
-
-const { route } = dbModelRouter;
-
-export default route(carts);

package/demo/routes/categories.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import categories from "../models/categories.js";
-
-const { route } = dbModelRouter;
-
-export default route(categories);

package/demo/routes/coupons.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import coupons from "../models/coupons.js";
-
-const { route } = dbModelRouter;
-
-export default route(coupons);

package/demo/routes/docs.js

@@ -1,18 +0,0 @@
-import express from "express";
-import swaggerUi from "swagger-ui-express";
-import { readFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const spec = JSON.parse(readFileSync(join(__dirname, "../openapi.json"), "utf8"));
-
-const router = express.Router();
-
-router.use("/", swaggerUi.serve);
-router.get("/", swaggerUi.setup(spec, {
-  customSiteTitle: "API Documentation",
-  customCss: ".swagger-ui .topbar { display: none }",
-}));
-
-export default router;

package/demo/routes/health.js

@@ -1,35 +0,0 @@
-import express from "express";
-
-const router = express.Router();
-
-/**
- * GET /health
- * Returns server health status, uptime, memory, and database connectivity.
- */
-router.get("/", async (req, res) => {
-  const health = {
-    status: "ok",
-    timestamp: new Date().toISOString(),
-    uptime: process.uptime(),
-    memory: process.memoryUsage(),
-    db: { connected: false },
-  };
-
-  try {
-    if (global.db && typeof global.db.query === "function") {
-      await global.db.query("SELECT NOW()");
-      health.db.connected = true;
-    } else if (global.db && typeof global.db.get === "function") {
-      // NoSQL adapters (mongodb, redis, dynamodb)
-      health.db.connected = true;
-    }
-  } catch (err) {
-    health.status = "degraded";
-    health.db.error = err.message;
-  }
-
-  const statusCode = health.status === "ok" ? 200 : 503;
-  res.status(statusCode).json(health);
-});
-
-export default router;

package/demo/routes/index.js

@@ -1,39 +0,0 @@
-import express from "express";
-
-const router = express.Router();
-
-import addressesRoute from "./addresses.js";
-import cartsRoute from "./carts.js";
-import categoriesRoute from "./categories.js";
-import couponsRoute from "./coupons.js";
-import ordersRoute from "./orders.js";
-import productsRoute from "./products.js";
-import usersRoute from "./users.js";
-import wishlistsRoute from "./wishlists.js";
-import product_imagesChildRoute from "./products/product_images.js";
-import product_variantsChildRoute from "./products/product_variants.js";
-import product_reviewsChildRoute from "./products/product_reviews.js";
-import cart_itemsChildRoute from "./carts/cart_items.js";
-import order_itemsChildRoute from "./orders/order_items.js";
-import paymentsChildRoute from "./orders/payments.js";
-import shipmentsChildRoute from "./orders/shipments.js";
-import docsRoute from "./docs.js";
-
-router.use("/docs", docsRoute);
-router.use("/addresses", addressesRoute);
-router.use("/carts", cartsRoute);
-router.use("/categories", categoriesRoute);
-router.use("/coupons", couponsRoute);
-router.use("/orders", ordersRoute);
-router.use("/products", productsRoute);
-router.use("/users", usersRoute);
-router.use("/wishlists", wishlistsRoute);
-router.use("/products/:product_id/product_images", product_imagesChildRoute);
-router.use("/products/:product_id/product_variants", product_variantsChildRoute);
-router.use("/products/:product_id/product_reviews", product_reviewsChildRoute);
-router.use("/carts/:cart_id/cart_items", cart_itemsChildRoute);
-router.use("/orders/:order_id/order_items", order_itemsChildRoute);
-router.use("/orders/:order_id/payments", paymentsChildRoute);
-router.use("/orders/:order_id/shipments", shipmentsChildRoute);
-
-export default router;

package/demo/routes/orders/order_items.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import order_items from "../../models/order_items.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent orders via order_id
-export default route(order_items, { order_id: "params.order_id" });

package/demo/routes/orders/payments.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import payments from "../../models/payments.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent orders via order_id
-export default route(payments, { order_id: "params.order_id" });

package/demo/routes/orders/shipments.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import shipments from "../../models/shipments.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent orders via order_id
-export default route(shipments, { order_id: "params.order_id" });

package/demo/routes/orders.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import orders from "../models/orders.js";
-
-const { route } = dbModelRouter;
-
-export default route(orders);

package/demo/routes/products/product_images.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import product_images from "../../models/product_images.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent products via product_id
-export default route(product_images, { product_id: "params.product_id" });

package/demo/routes/products/product_reviews.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import product_reviews from "../../models/product_reviews.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent products via product_id
-export default route(product_reviews, { product_id: "params.product_id" });

package/demo/routes/products/product_variants.js

@@ -1,7 +0,0 @@
-import dbModelRouter from "db-model-router";
-import product_variants from "../../models/product_variants.js";
-
-const { route } = dbModelRouter;
-
-// Child route: scoped by parent products via product_id
-export default route(product_variants, { product_id: "params.product_id" });

package/demo/routes/products.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import products from "../models/products.js";
-
-const { route } = dbModelRouter;
-
-export default route(products);

package/demo/routes/users.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import users from "../models/users.js";
-
-const { route } = dbModelRouter;
-
-export default route(users);

package/demo/routes/wishlists.js

@@ -1,6 +0,0 @@
-import dbModelRouter from "db-model-router";
-import wishlists from "../models/wishlists.js";
-
-const { route } = dbModelRouter;
-
-export default route(wishlists);

package/src/cli/commands/generate-llm-docs.js

@@ -1,418 +0,0 @@
-"use strict";
-
-/**
- * LLM Docs Generator
- *
- * Generates two documentation files optimized for LLM consumption:
- * - llms.txt: ultra-compact CLI reference (≤200 lines)
- * - docs/llm.md: full reference with examples, schema definition, route contract, etc.
- */
-
-const ADAPTERS = [
-  "mysql",
-  "postgres",
-  "sqlite3",
-  "mongodb",
-  "mssql",
-  "cockroachdb",
-  "oracle",
-  "redis",
-  "dynamodb",
-];
-
-const FRAMEWORKS = ["express", "ultimate-express"];
-
-const SUBCOMMANDS = ["init", "inspect", "generate", "doctor", "diff"];
-
-const UNIVERSAL_FLAGS = [
-  "--yes",
-  "--json",
-  "--dry-run",
-  "--no-install",
-  "--help",
-];
-
-const ADAPTER_CAPABILITIES = {
-  mysql: { sql: true, transactions: true, migrations: true, streaming: false },
-  postgres: {
-    sql: true,
-    transactions: true,
-    migrations: true,
-    streaming: false,
-  },
-  sqlite3: {
-    sql: true,
-    transactions: true,
-    migrations: true,
-    streaming: false,
-  },
-  mongodb: {
-    sql: false,
-    transactions: false,
-    migrations: false,
-    streaming: false,
-  },
-  mssql: { sql: true, transactions: true, migrations: true, streaming: false },
-  cockroachdb: {
-    sql: true,
-    transactions: true,
-    migrations: true,
-    streaming: false,
-  },
-  oracle: { sql: true, transactions: true, migrations: true, streaming: false },
-  redis: {
-    sql: false,
-    transactions: false,
-    migrations: false,
-    streaming: false,
-  },
-  dynamodb: {
-    sql: false,
-    transactions: false,
-    migrations: false,
-    streaming: false,
-  },
-};
-
-/**
- * Generate the content for llms.txt — ultra-compact CLI reference (≤200 lines).
- * @returns {string}
- */
-function generateLlmsTxt() {
-  const lines = [
-    "# db-model-router — LLM Quick Reference",
-    "",
-    "## Schema File: dbmr.schema.json",
-    '{ "adapter": "<adapter>", "framework": "<framework>", "tables": { "<name>": { "columns": { "<col>": "<rule>" }, "pk": "<col>", "unique": ["<col>"], "softDelete": "<col>" } }, "relationships": [{ "parent": "<t>", "child": "<t>", "foreignKey": "<col>" }], "options": {} }',
-    "",
-    "Adapters: " + ADAPTERS.join(", "),
-    "Frameworks: " + FRAMEWORKS.join(", "),
-    'Column rules: (required|)?(string|integer|numeric|boolean|object) e.g. "required|string"',
-    "",
-    "## Universal Flags",
-    UNIVERSAL_FLAGS.join("  "),
-    "",
-    "## Commands",
-    "",
-    "### init",
-    "Scaffold a new project.",
-    "  --from <schema>   Read config from schema file",
-    "  --framework <fw>  Framework (express|ultimate-express)",
-    "  --database <db>   Adapter name",
-    "Example: db-model-router init --from dbmr.schema.json --yes --no-install",
-    "",
-    "### inspect",
-    "Introspect a live database and produce a schema file.",
-    "  --type <adapter>  Database adapter",
-    "  --env <path>      Path to .env file",
-    "  --out <path>      Output path (default: dbmr.schema.json)",
-    "  --tables <list>   Comma-separated table filter",
-    "Example: db-model-router inspect --type sqlite3 --env .env --out schema.json",
-    "",
-    "### generate",
-    "Generate code artifacts from schema.",
-    "  --from <schema>   Schema file (default: dbmr.schema.json)",
-    "  --models          Generate model files only",
-    "  --routes          Generate route files only",
-    "  --openapi         Generate OpenAPI spec only",
-    "  --tests           Generate test files only",
-    "  --llm-docs        Generate LLM documentation only",
-    "Example: db-model-router generate --from dbmr.schema.json",
-    "Example: db-model-router generate --models --dry-run",
-    "",
-    "### doctor",
-    "Validate schema, check dependencies, verify file sync.",
-    "  --from <schema>   Schema file (default: dbmr.schema.json)",
-    "Example: db-model-router doctor --from dbmr.schema.json --json",
-    "",
-    "### diff",
-    "Preview changes between schema and generated files.",
-    "  --from <schema>   Schema file (default: dbmr.schema.json)",
-    "Example: db-model-router diff --from dbmr.schema.json",
-    "",
-    "## Route Contract (per table)",
-    "GET    /api/<table>/        List (page, size, sort, select_columns)",
-    "POST   /api/<table>/        Bulk insert",
-    "PUT    /api/<table>/        Bulk update",
-    "DELETE /api/<table>/        Bulk delete",
-    "GET    /api/<table>/:id     Get by ID",
-    "POST   /api/<table>/:id     Insert one",
-    "PUT    /api/<table>/:id     Update one",
-    "PATCH  /api/<table>/:id     Partial update one",
-    "DELETE /api/<table>/:id     Delete one",
-    "",
-    "## Generated Files",
-    "models/<table>.js           Model with CRUD operations",
-    "routes/<table>.js           Express route handlers",
-    "routes/<child>_child_of_<parent>.js  Child route",
-    "routes/index.js             Route mounting index",
-    "test/<table>.test.js        CRUD endpoint tests",
-    "openapi.json                OpenAPI 3.0 spec",
-    "llms.txt                    This file",
-    "docs/llm.md                 Full LLM reference",
-  ];
-
-  return lines.join("\n") + "\n";
-}
-
-/**
- * Generate the content for docs/llm.md — full LLM reference.
- * @returns {string}
- */
-function generateLlmMd() {
-  const sections = [];
-
-  // Title
-  sections.push("# db-model-router — LLM Reference");
-  sections.push("");
-
-  // Installation
-  sections.push("## Installation");
-  sections.push("");
-  sections.push("```bash");
-  sections.push("npm install db-model-router");
-  sections.push("```");
-  sections.push("");
-
-  // Workflow
-  sections.push("## Canonical Schema-Driven Workflow");
-  sections.push("");
-  sections.push("1. Create or inspect a `dbmr.schema.json` schema file");
-  sections.push(
-    "2. Run `db-model-router generate --from dbmr.schema.json` to generate all artifacts",
-  );
-  sections.push(
-    "3. Run `db-model-router doctor` to validate schema and check sync",
-  );
-  sections.push(
-    "4. Run `db-model-router diff` to preview changes before regenerating",
-  );
-  sections.push("5. Edit the schema file and repeat from step 2");
-  sections.push("");
-
-  // Schema Definition
-  sections.push("## Schema Definition");
-  sections.push("");
-  sections.push(
-    "The `dbmr.schema.json` file is the single source of truth for your project.",
-  );
-  sections.push("");
-  sections.push("```json");
-  sections.push(
-    JSON.stringify(
-      {
-        adapter: "<adapter>",
-        framework: "<framework>",
-        tables: {
-          "<table_name>": {
-            columns: {
-              "<column_name>": "<column_rule>",
-            },
-            pk: "<primary_key_column>",
-            unique: ["<column_name>"],
-            softDelete: "<column_name>",
-            timestamps: {
-              created_at: "<column_name>",
-              modified_at: "<column_name>",
-            },
-          },
-        },
-        relationships: [
-          { parent: "<table>", child: "<table>", foreignKey: "<column>" },
-        ],
-        options: {},
-      },
-      null,
-      2,
-    ),
-  );
-  sections.push("```");
-  sections.push("");
-  sections.push("### Adapters");
-  sections.push("");
-  sections.push("| Adapter | Description |");
-  sections.push("|---------|-------------|");
-  for (const a of ADAPTERS) {
-    sections.push(`| ${a} | ${a} database adapter |`);
-  }
-  sections.push("");
-  sections.push("### Frameworks");
-  sections.push("");
-  sections.push("| Framework | Description |");
-  sections.push("|-----------|-------------|");
-  for (const f of FRAMEWORKS) {
-    sections.push(`| ${f} | ${f} HTTP framework |`);
-  }
-  sections.push("");
-  sections.push("### Column Rules");
-  sections.push("");
-  sections.push(
-    "Column rules use pipe-delimited tokens: `(required|)?(string|integer|numeric|boolean|object)`",
-  );
-  sections.push("");
-  sections.push(
-    'Examples: `"required|string"`, `"integer"`, `"required|boolean"`, `"object"`',
-  );
-  sections.push("");
-
-  // CLI Commands
-  sections.push("## CLI Commands");
-  sections.push("");
-  sections.push(
-    "All commands support universal flags: " +
-      UNIVERSAL_FLAGS.map((f) => "`" + f + "`").join(", "),
-  );
-  sections.push("");
-
-  // init
-  sections.push("### init");
-  sections.push("");
-  sections.push("Scaffold a new project from a schema file or interactively.");
-  sections.push("");
-  sections.push("```bash");
-  sections.push("# From schema file, non-interactive");
-  sections.push(
-    "db-model-router init --from dbmr.schema.json --yes --no-install",
-  );
-  sections.push("");
-  sections.push("# Interactive with defaults");
-  sections.push(
-    "db-model-router init --framework express --database sqlite3 --yes",
-  );
-  sections.push("");
-  sections.push("# Dry run to preview");
-  sections.push("db-model-router init --from dbmr.schema.json --dry-run");
-  sections.push("```");
-  sections.push("");
-  sections.push("| Flag | Description |");
-  sections.push("|------|-------------|");
-  sections.push("| `--from <path>` | Read config from schema file |");
-  sections.push(
-    "| `--framework <fw>` | Framework: express, ultimate-express |",
-  );
-  sections.push("| `--database <db>` | Adapter name |");
-  sections.push("");
-
-  // inspect
-  sections.push("### inspect");
-  sections.push("");
-  sections.push("Introspect a live database and produce a schema file.");
-  sections.push("");
-  sections.push("```bash");
-  sections.push(
-    "db-model-router inspect --type postgres --env .env --out dbmr.schema.json",
-  );
-  sections.push(
-    "db-model-router inspect --type sqlite3 --tables users,posts --json",
-  );
-  sections.push("```");
-  sections.push("");
-  sections.push("| Flag | Description |");
-  sections.push("|------|-------------|");
-  sections.push("| `--type <adapter>` | Database adapter to use |");
-  sections.push("| `--env <path>` | Path to .env file |");
-  sections.push("| `--out <path>` | Output file (default: dbmr.schema.json) |");
-  sections.push("| `--tables <list>` | Comma-separated table filter |");
-  sections.push("");
-
-  // generate
-  sections.push("### generate");
-  sections.push("");
-  sections.push("Generate code artifacts from the schema file.");
-  sections.push("");
-  sections.push("```bash");
-  sections.push("# Generate all artifacts");
-  sections.push("db-model-router generate --from dbmr.schema.json");
-  sections.push("");
-  sections.push("# Generate only models");
-  sections.push("db-model-router generate --models");
-  sections.push("");
-  sections.push("# Generate only routes");
-  sections.push("db-model-router generate --routes");
-  sections.push("");
-  sections.push("# Preview with dry-run");
-  sections.push("db-model-router generate --dry-run --json");
-  sections.push("");
-  sections.push("# Generate LLM docs only");
-  sections.push("db-model-router generate --llm-docs");
-  sections.push("```");
-  sections.push("");
-  sections.push("| Flag | Description |");
-  sections.push("|------|-------------|");
-  sections.push(
-    "| `--from <path>` | Schema file (default: dbmr.schema.json) |",
-  );
-  sections.push("| `--models` | Generate model files only |");
-  sections.push("| `--routes` | Generate route files only |");
-  sections.push("| `--openapi` | Generate OpenAPI spec only |");
-  sections.push("| `--tests` | Generate test files only |");
-  sections.push("| `--llm-docs` | Generate LLM documentation only |");
-  sections.push("");
-
-  // doctor
-  sections.push("### doctor");
-  sections.push("");
-  sections.push(
-    "Validate schema, check dependencies, and verify generated files are in sync.",
-  );
-  sections.push("");
-  sections.push("```bash");
-  sections.push("db-model-router doctor --from dbmr.schema.json");
-  sections.push("db-model-router doctor --json");
-  sections.push("```");
-  sections.push("");
-
-  // diff
-  sections.push("### diff");
-  sections.push("");
-  sections.push(
-    "Preview changes between the schema and currently generated files.",
-  );
-  sections.push("");
-  sections.push("```bash");
-  sections.push("db-model-router diff --from dbmr.schema.json");
-  sections.push("db-model-router diff --json");
-  sections.push("```");
-  sections.push("");
-
-  // Route Contract
-  sections.push("## Route Contract");
-  sections.push("");
-  sections.push("Each table generates 9 endpoints:");
-  sections.push("");
-  sections.push("| Method | Path | Description |");
-  sections.push("|--------|------|-------------|");
-  sections.push(
-    "| GET | `/api/<table>/` | List with pagination (page, size, sort, select_columns) |",
-  );
-  sections.push("| POST | `/api/<table>/` | Bulk insert |");
-  sections.push("| PUT | `/api/<table>/` | Bulk update |");
-  sections.push("| DELETE | `/api/<table>/` | Bulk delete |");
-  sections.push(
-    "| GET | `/api/<table>/:id` | Get single record by primary key |",
-  );
-  sections.push("| POST | `/api/<table>/:id` | Insert single record |");
-  sections.push("| PUT | `/api/<table>/:id` | Update single record |");
-  sections.push(
-    "| PATCH | `/api/<table>/:id` | Partial update single record |",
-  );
-  sections.push("| DELETE | `/api/<table>/:id` | Delete single record |");
-  sections.push("");
-
-  // Adapter Capability Matrix
-  sections.push("## Adapter Capability Matrix");
-  sections.push("");
-  sections.push("| Adapter | SQL | Transactions | Migrations | Streaming |");
-  sections.push("|---------|-----|--------------|------------|-----------|");
-  for (const [adapter, caps] of Object.entries(ADAPTER_CAPABILITIES)) {
-    const yn = (v) => (v ? "Yes" : "No");
-    sections.push(
-      `| ${adapter} | ${yn(caps.sql)} | ${yn(caps.transactions)} | ${yn(caps.migrations)} | ${yn(caps.streaming)} |`,
-    );
-  }
-  sections.push("");
-
-  return sections.join("\n") + "\n";
-}
-
-module.exports = { generateLlmsTxt, generateLlmMd };