@kardoe/quickback 0.5.15 → 0.6.0

package/dist/commands/mcp.js

@@ -0,0 +1,330 @@
+/**
+ * MCP Server command — starts a stdio-based MCP server
+ *
+ * Exposes Quickback documentation and project context to any MCP-compatible AI tool
+ * (Claude Desktop, Cursor, VS Code Copilot, Windsurf, etc.)
+ *
+ * Usage:
+ *   quickback mcp              # Start stdio MCP server
+ *
+ * Configuration (claude_desktop_config.json or .cursor/mcp.json):
+ *   {
+ *     "mcpServers": {
+ *       "quickback": {
+ *         "command": "npx",
+ *         "args": ["@kardoe/quickback", "mcp"]
+ *       }
+ *     }
+ *   }
+ */
+import { DOCS, TOPIC_LIST } from "../docs/content.js";
+import { promises as fs } from "fs";
+import { join } from "path";
+export async function mcp() {
+    const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const { z } = await import("zod");
+    const server = new McpServer({
+        name: "quickback",
+        version: "1.0.0",
+    });
+    // --- Documentation Resources ---
+    // Each doc topic is available as a readable resource
+    for (const topic of TOPIC_LIST) {
+        const doc = DOCS[topic];
+        if (!doc)
+            continue;
+        server.resource(topic, `quickback://docs/${topic}`, { description: doc.title, mimeType: "text/markdown" }, async () => ({
+            contents: [
+                {
+                    uri: `quickback://docs/${topic}`,
+                    text: `# ${doc.title}\n\n${doc.content}`,
+                    mimeType: "text/markdown",
+                },
+            ],
+        }));
+    }
+    // --- Documentation Tools ---
+    server.tool("list_topics", "List all available Quickback documentation topics", {}, async () => {
+        const grouped = {};
+        for (const topic of TOPIC_LIST) {
+            const section = topic.split("/")[0];
+            if (!grouped[section])
+                grouped[section] = [];
+            grouped[section].push(topic);
+        }
+        let output = "# Quickback Documentation Topics\n\n";
+        for (const [section, topics] of Object.entries(grouped)) {
+            output += `## ${section}\n`;
+            for (const t of topics) {
+                const doc = DOCS[t];
+                output += `- **${t}** — ${doc?.title || t}\n`;
+            }
+            output += "\n";
+        }
+        return { content: [{ type: "text", text: output }] };
+    });
+    server.tool("get_doc", "Get a specific Quickback documentation topic by key. Supports fuzzy suffix matching (e.g., 'firewall' matches 'compiler/definitions/firewall').", { topic: z.string().describe("Topic key or short name (e.g., 'firewall', 'compiler/definitions/firewall')") }, async ({ topic }) => {
+        // Exact match first
+        let resolved = DOCS[topic] ? topic : null;
+        // Fuzzy suffix match
+        if (!resolved) {
+            const matches = TOPIC_LIST.filter((t) => t === topic || t.endsWith(`/${topic}`));
+            if (matches.length === 1) {
+                resolved = matches[0];
+            }
+            else if (matches.length > 1) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Ambiguous topic "${topic}". Did you mean one of:\n${matches.map((m) => `- ${m}`).join("\n")}`,
+                        },
+                    ],
+                };
+            }
+        }
+        if (!resolved || !DOCS[resolved]) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Topic "${topic}" not found. Use list_topics to see all available topics.`,
+                    },
+                ],
+            };
+        }
+        const doc = DOCS[resolved];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `# ${doc.title}\n\n${doc.content}`,
+                },
+            ],
+        };
+    });
+    server.tool("search_docs", "Search Quickback documentation content by keyword. Returns matching topics with relevant excerpts.", { query: z.string().describe("Search query (case-insensitive)") }, async ({ query }) => {
+        const lower = query.toLowerCase();
+        const results = [];
+        for (const topic of TOPIC_LIST) {
+            const doc = DOCS[topic];
+            if (!doc)
+                continue;
+            const content = doc.content.toLowerCase();
+            const title = doc.title.toLowerCase();
+            if (content.includes(lower) || title.includes(lower)) {
+                // Extract excerpt around first match
+                const idx = content.indexOf(lower);
+                const start = Math.max(0, idx - 100);
+                const end = Math.min(content.length, idx + lower.length + 100);
+                const excerpt = (start > 0 ? "..." : "") +
+                    doc.content.substring(start, end).replace(/\n/g, " ") +
+                    (end < content.length ? "..." : "");
+                results.push({ topic, title: doc.title, excerpt });
+            }
+        }
+        if (results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No results found for "${query}".`,
+                    },
+                ],
+            };
+        }
+        let output = `# Search results for "${query}" (${results.length} matches)\n\n`;
+        for (const r of results.slice(0, 20)) {
+            output += `## ${r.topic}\n**${r.title}**\n${r.excerpt}\n\n`;
+        }
+        if (results.length > 20) {
+            output += `\n*...and ${results.length - 20} more results*\n`;
+        }
+        return { content: [{ type: "text", text: output }] };
+    });
+    // --- Project-Aware Tools ---
+    server.tool("read_config", "Read the current project's quickback.config.ts file. Returns the raw TypeScript source.", {}, async () => {
+        const configPath = await findProjectFile([
+            "quickback/quickback.config.ts",
+            "quickback.config.ts",
+        ]);
+        if (!configPath) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No quickback.config.ts found. Not in a Quickback project directory.",
+                    },
+                ],
+            };
+        }
+        const source = await fs.readFile(configPath, "utf-8");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `# quickback.config.ts\n\n\`\`\`typescript\n${source}\n\`\`\``,
+                },
+            ],
+        };
+    });
+    server.tool("list_features", "List all features defined in the current Quickback project. Shows feature directories and their table definition files.", {}, async () => {
+        const featuresDir = await findProjectDir([
+            "quickback/features",
+            "features",
+        ]);
+        if (!featuresDir) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No features directory found. Not in a Quickback project directory.",
+                    },
+                ],
+            };
+        }
+        const entries = await fs.readdir(featuresDir, { withFileTypes: true });
+        const features = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const featureDir = join(featuresDir, entry.name);
+            const files = await fs.readdir(featureDir);
+            features.push({
+                name: entry.name,
+                files: files.filter((f) => f.endsWith(".ts")),
+            });
+        }
+        if (features.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Features directory exists but contains no feature definitions.",
+                    },
+                ],
+            };
+        }
+        let output = `# Project Features (${features.length})\n\n`;
+        for (const f of features) {
+            output += `## ${f.name}/\n`;
+            for (const file of f.files) {
+                output += `- ${file}\n`;
+            }
+            output += "\n";
+        }
+        return { content: [{ type: "text", text: output }] };
+    });
+    server.tool("read_feature", "Read the source code of a specific feature. Returns all .ts files in the feature directory.", {
+        feature: z.string().describe("Feature name (directory name under quickback/features/)"),
+    }, async ({ feature }) => {
+        const featuresDir = await findProjectDir([
+            "quickback/features",
+            "features",
+        ]);
+        if (!featuresDir) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No features directory found. Not in a Quickback project directory.",
+                    },
+                ],
+            };
+        }
+        const featureDir = join(featuresDir, feature);
+        try {
+            await fs.access(featureDir);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Feature "${feature}" not found. Use list_features to see available features.`,
+                    },
+                ],
+            };
+        }
+        const files = (await fs.readdir(featureDir)).filter((f) => f.endsWith(".ts"));
+        let output = `# Feature: ${feature}\n\n`;
+        for (const file of files) {
+            const source = await fs.readFile(join(featureDir, file), "utf-8");
+            output += `## ${file}\n\n\`\`\`typescript\n${source}\n\`\`\`\n\n`;
+        }
+        // Check for handlers/ subdirectory
+        const handlersDir = join(featureDir, "handlers");
+        try {
+            const handlerFiles = (await fs.readdir(handlersDir)).filter((f) => f.endsWith(".ts"));
+            for (const file of handlerFiles) {
+                const source = await fs.readFile(join(handlersDir, file), "utf-8");
+                output += `## handlers/${file}\n\n\`\`\`typescript\n${source}\n\`\`\`\n\n`;
+            }
+        }
+        catch {
+            // No handlers directory
+        }
+        return { content: [{ type: "text", text: output }] };
+    });
+    server.tool("read_schema_registry", "Read the project's compiled schema-registry.json. Contains full metadata about all tables, columns, security rules, views, and actions.", {}, async () => {
+        const registryPath = await findProjectFile([
+            "src/schema-registry.json",
+            "dist/schema-registry.json",
+            "schema-registry.json",
+        ]);
+        if (!registryPath) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No schema-registry.json found. Run 'quickback compile' to generate it.",
+                    },
+                ],
+            };
+        }
+        const content = await fs.readFile(registryPath, "utf-8");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `# Schema Registry\n\n\`\`\`json\n${content}\n\`\`\``,
+                },
+            ],
+        };
+    });
+    // --- Helpers ---
+    async function findProjectFile(candidates) {
+        const cwd = process.cwd();
+        for (const candidate of candidates) {
+            const full = join(cwd, candidate);
+            try {
+                await fs.access(full);
+                return full;
+            }
+            catch {
+                // Not found, try next
+            }
+        }
+        return null;
+    }
+    async function findProjectDir(candidates) {
+        const cwd = process.cwd();
+        for (const candidate of candidates) {
+            const full = join(cwd, candidate);
+            try {
+                const stat = await fs.stat(full);
+                if (stat.isDirectory())
+                    return full;
+            }
+            catch {
+                // Not found, try next
+            }
+        }
+        return null;
+    }
+    // --- Start Server ---
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}

package/dist/cursor/quickback.mdc

@@ -0,0 +1,235 @@
+---
+description: Quickback API engine - use when defining tables, schemas, security (Firewall, Access, Guards, Masking), actions, views, validation, or deploying Quickback projects
+globs: quickback/**/*.ts
+---
+
+# Quickback
+
+Quickback is two things:
+
+1. **Compiler** — Transforms declarative TypeScript definitions into secure, production-ready APIs
+2. **Stack** — A Supabase alternative running entirely on Cloudflare (D1, R2, KV, Durable Objects, Queues, Workers AI)
+
+The output is standard TypeScript (Hono, Drizzle, Better Auth) running on your own infrastructure.
+
+## Project Structure
+
+```
+my-app/
+├── quickback/
+│   ├── quickback.config.ts
+│   └── features/
+│       └── {feature-name}/
+│           ├── {table}.ts        # Schema + security (defineTable)
+│           ├── actions.ts        # Custom actions (optional)
+│           └── handlers/         # Action handlers (optional)
+└── ...
+```
+
+## quickback.config.ts
+
+```typescript
+import { defineConfig, defineRuntime, defineDatabase, defineAuth } from '@quickback/compiler';
+
+export default defineConfig({
+  name: "my-saas-app",
+  providers: {
+    runtime: defineRuntime("cloudflare"),
+    database: defineDatabase("cloudflare-d1"),
+    auth: defineAuth("better-auth"),
+  },
+});
+```
+
+## Automatic Audit Fields
+
+Quickback auto-injects: `createdAt`, `modifiedAt`, `deletedAt`, `createdBy`, `modifiedBy`, `deletedBy`. Do NOT define these in schemas.
+
+## defineTable() — Schema + Security
+
+Each feature file exports a Drizzle table and a `defineTable()` default export with security config:
+
+```typescript
+import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
+import { defineTable } from "@quickback/compiler";
+
+export const todos = sqliteTable("todos", {
+  id: integer("id").primaryKey(),
+  title: text("title").notNull(),
+  description: text("description"),
+  completed: integer("completed", { mode: "boolean" }).default(false),
+  userId: text("user_id").notNull(),
+  organizationId: text("organization_id").notNull(),
+});
+
+export default defineTable(todos, {
+  firewall: { organization: {}, owner: {} },
+  crud: {
+    list: { access: { roles: ["member", "admin"] } },
+    get: { access: { roles: ["member", "admin"] } },
+    create: { access: { roles: ["member", "admin"] } },
+    update: { access: { roles: ["admin"] } },
+    delete: { access: { roles: ["admin"] }, mode: "soft" },
+  },
+  guards: {
+    createable: ["title", "description", "completed"],
+    updatable: ["title", "description", "completed"],
+  },
+  masking: {
+    userId: { type: "redact", show: { roles: ["admin"] } },
+  },
+});
+```
+
+## Four Security Layers
+
+Every request passes through: `Request → Firewall → Access → Guards → Database → Masking → Response`
+
+### 1. Firewall — Data Isolation
+
+Auto WHERE clauses for tenant isolation:
+
+```typescript
+firewall: {
+  organization: {},          // WHERE organizationId = ctx.activeOrgId
+  owner: {},                 // AND userId = ctx.userId
+  team: {},                  // WHERE teamId = ctx.activeTeamId
+  softDelete: {},            // AND deletedAt IS NULL
+  exception: true,           // No filtering (public)
+}
+```
+
+### 2. Access — Permission Checks
+
+Role-based and record-based (deny by default):
+
+```typescript
+crud: {
+  list: { access: { roles: ['member'] } },
+  update: {
+    access: {
+      or: [
+        { roles: ['admin'] },
+        { record: { createdBy: { equals: '$ctx.userId' } } },
+      ],
+    },
+  },
+}
+```
+
+Operators: `equals`, `notEquals`, `in`, `notIn`, `greaterThan`, `lessThan`
+Context: `$ctx.userId`, `$ctx.activeOrgId`, `$ctx.roles`
+
+### 3. Guards — Field Protection
+
+```typescript
+guards: {
+  createable: ['name', 'description'],
+  updatable: ['description'],
+  immutable: ['invoiceNumber'],
+  protected: { status: ['approve'] },  // Only via named actions
+}
+```
+
+### 4. Masking — PII Redaction
+
+```typescript
+masking: {
+  ssn: { type: 'ssn', show: { roles: ['admin'] } },
+  email: { type: 'email', show: { roles: ['admin'], or: 'owner' } },
+}
+```
+
+Types: `email`, `phone`, `ssn`, `creditCard`, `name`, `redact`, `custom`
+
+## Views — Column Projections
+
+```typescript
+views: {
+  summary: { fields: ['id', 'name'], access: { roles: ['member'] } },
+  full: { fields: ['id', 'name', 'phone', 'ssn'], access: { roles: ['admin'] } },
+}
+```
+
+## Validation
+
+```typescript
+validation: {
+  name: { minLength: 1, maxLength: 100 },
+  capacity: { min: 1, max: 1000 },
+  roomType: { enum: ['meeting', 'conference'] },
+  email: { email: true },
+}
+```
+
+## Actions — Custom Business Logic
+
+Separate `actions.ts` file:
+
+```typescript
+import { todos } from './todos';
+import { defineActions } from '@quickback/compiler';
+import { z } from 'zod';
+
+export default defineActions(todos, {
+  complete: {
+    description: "Mark todo as complete",
+    input: z.object({ completedAt: z.string().datetime().optional() }),
+    guard: { roles: ["member", "admin"] },
+    execute: async ({ db, record, ctx, input }) => {
+      await db.update(todos).set({ completed: true }).where(eq(todos.id, record.id));
+      return { success: true };
+    },
+  },
+});
+```
+
+Record-based: `POST /api/v1/{resource}/:id/{action}`
+Standalone: `standalone: true`, custom `path` and `method`
+
+## CMS Layouts
+
+```typescript
+layouts: {
+  default: {
+    sections: [
+      { label: "Details", columns: 2, fields: ["name", "email"] },
+      { label: "Notes", collapsed: true, fields: ["notes"] },
+    ],
+  },
+}
+```
+
+## API Reference
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/v1/{resource}` | List |
+| `GET` | `/api/v1/{resource}/:id` | Get |
+| `POST` | `/api/v1/{resource}` | Create |
+| `PATCH` | `/api/v1/{resource}/:id` | Update |
+| `DELETE` | `/api/v1/{resource}/:id` | Delete |
+
+Query params: `?limit=50&offset=0`, `?status=active`, `?sort=-createdAt`, `?fields=id,name`, `?search=text`
+Filter operators: `.gt`, `.gte`, `.lt`, `.lte`, `.ne`, `.like`, `.in`
+
+## Database Dialects
+
+| Stack | Import | Table Function |
+|-------|--------|----------------|
+| Cloudflare D1 / SQLite | `drizzle-orm/sqlite-core` | `sqliteTable` |
+| Supabase / PostgreSQL | `drizzle-orm/pg-core` | `pgTable` |
+
+## CLI Commands
+
+```bash
+quickback create <template> <name>   # Create project
+quickback compile                     # Compile definitions
+quickback docs [topic]                # Show documentation
+quickback claude install              # Install Claude Code skill
+quickback cursor install              # Install Cursor rules
+```
+
+## Full Documentation
+
+https://docs.quickback.dev

package/dist/docs/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/docs/content.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA6ZzC,CAAC;AAEF,eAAO,MAAM,UAAU,UAwGtB,CAAC"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/docs/content.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAiazC,CAAC;AAEF,eAAO,MAAM,UAAU,UAyGtB,CAAC"}