@tablecraft/adapter-next 0.1.0-beta.1

package/README.md

@@ -0,0 +1,53 @@
+# @tablecraft/adapter-next
+
+Next.js App Router adapter for [TableCraft](https://github.com/your-org/tablecraft).
+
+## Install
+
+```bash
+bun add @tablecraft/engine @tablecraft/adapter-next
+```
+
+## Usage
+
+### Dynamic route (multiple tables)
+
+```ts
+// app/api/data/[table]/route.ts
+import { createNextHandler } from '@tablecraft/adapter-next';
+import { db } from '@/db';
+import * as schema from '@/db/schema';
+import { configs } from '@/tablecraft.config';
+
+const handler = createNextHandler({
+  db,
+  schema,
+  configs,
+  getContext: async (request) => {
+    // Extract from session, JWT, etc.
+    return { tenantId: 'tenant_123', user: { id: '1', roles: ['admin'] } };
+  },
+});
+
+export const GET = handler;
+```
+
+### Single route (one table)
+
+```ts
+// app/api/users/route.ts
+import { createNextRouteHandler } from '@tablecraft/adapter-next';
+
+export const GET = createNextRouteHandler({
+  db,
+  schema,
+  config: usersConfig,
+});
+```
+
+### Query from the client
+
+```
+GET /api/data/users?page=1&pageSize=25&sort=-createdAt&filter[status]=active&search=john
+GET /api/data/orders?export=csv
+```

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+import { TableConfig, ConfigInput, EngineContext } from '@tablecraft/engine';
+export interface NextHandlerOptions {
+    db: unknown;
+    schema: Record<string, unknown>;
+    configs: ConfigInput[] | Record<string, ConfigInput>;
+    /**
+     * Extract context (tenantId, user, etc.) from the incoming request.
+     * Called on every request before the query runs.
+     */
+    getContext?: (request: Request) => EngineContext | Promise<EngineContext>;
+    /**
+     * Override built-in access check with your own logic.
+     * Return true to allow, false to deny.
+     */
+    checkAccess?: (config: TableConfig, context: EngineContext, request: Request) => boolean | Promise<boolean>;
+}
+/**
+ * Creates a Next.js App Router GET handler for dynamic `[table]` routes.
+ *
+ * @example
+ * ```ts
+ * // app/api/data/[table]/route.ts
+ * import { createNextHandler } from '@tablecraft/adapter-next';
+ * import { db } from '@/db';
+ * import * as schema from '@/db/schema';
+ * import { configs } from '@/tablecraft.config';
+ *
+ * const handler = createNextHandler({ db, schema, configs });
+ * export const GET = handler;
+ * ```
+ */
+export declare function createNextHandler(options: NextHandlerOptions): (request: Request, routeContext: {
+    params: Promise<{
+        table: string;
+    }> | {
+        table: string;
+    };
+}) => Promise<Response>;
+/**
+ * Creates a handler for a single, known table (no dynamic route needed).
+ *
+ * @example
+ * ```ts
+ * // app/api/users/route.ts
+ * import { createNextRouteHandler } from '@tablecraft/adapter-next';
+ * export const GET = createNextRouteHandler({ db, schema, config: usersConfig });
+ * ```
+ */
+export declare function createNextRouteHandler(options: {
+    db: unknown;
+    schema: Record<string, unknown>;
+    config: ConfigInput;
+    getContext?: (request: Request) => EngineContext | Promise<EngineContext>;
+    checkAccess?: (config: TableConfig, context: EngineContext, request: Request) => boolean | Promise<boolean>;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1E;;;OAGG;IACH,WAAW,CAAC,EAAE,CACZ,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,KACb,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,IAQzD,SAAS,OAAO,EAChB,cAAc;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,KACvE,OAAO,CAAC,QAAQ,CAAC,CA2FrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1E,WAAW,CAAC,EAAE,CACZ,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,KACb,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,IAY2B,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAQ/D"}

package/dist/index.js

@@ -0,0 +1,122 @@
+import { createEngines, parseRequest, checkAccess as defaultCheckAccess, getExportMeta, } from '@tablecraft/engine';
+/**
+ * Creates a Next.js App Router GET handler for dynamic `[table]` routes.
+ *
+ * @example
+ * ```ts
+ * // app/api/data/[table]/route.ts
+ * import { createNextHandler } from '@tablecraft/adapter-next';
+ * import { db } from '@/db';
+ * import * as schema from '@/db/schema';
+ * import { configs } from '@/tablecraft.config';
+ *
+ * const handler = createNextHandler({ db, schema, configs });
+ * export const GET = handler;
+ * ```
+ */
+export function createNextHandler(options) {
+    const engines = createEngines({
+        db: options.db,
+        schema: options.schema,
+        configs: options.configs,
+    });
+    return async function GET(request, routeContext) {
+        try {
+            // Resolve params (Next.js 15 makes params async)
+            const resolved = await Promise.resolve(routeContext.params);
+            const tableName = resolved.table;
+            // ─── Metadata endpoint: GET /api/data/users/_meta ───
+            if (tableName.endsWith('/_meta') || tableName.endsWith('_meta')) {
+                const actualName = tableName.replace(/\/?_meta$/, '');
+                const engine = engines[actualName];
+                if (!engine) {
+                    return Response.json({ error: `Unknown resource '${actualName}'` }, { status: 404 });
+                }
+                const context = options.getContext
+                    ? await options.getContext(request)
+                    : {};
+                const metadata = engine.getMetadata(context);
+                return Response.json(metadata);
+            }
+            const engine = engines[tableName];
+            if (!engine) {
+                return Response.json({ error: `Unknown resource '${tableName}'` }, { status: 404 });
+            }
+            const config = engine.getConfig();
+            // --- Context ---
+            const context = options.getContext
+                ? await options.getContext(request)
+                : {};
+            // --- Access control ---
+            const hasAccess = options.checkAccess
+                ? await options.checkAccess(config, context, request)
+                : defaultCheckAccess(config, context);
+            if (!hasAccess) {
+                return Response.json({ error: 'Forbidden' }, { status: 403 });
+            }
+            // --- Parse URL ---
+            const url = new URL(request.url);
+            const params = parseRequest(url.searchParams);
+            // --- Export mode ---
+            if (params.export) {
+                const allowed = config.export?.formats ?? ['csv', 'json'];
+                const enabled = config.export?.enabled ?? true;
+                if (!enabled || !allowed.includes(params.export)) {
+                    return Response.json({ error: `Export format '${params.export}' is not allowed` }, { status: 400 });
+                }
+                const body = await engine.exportData(params, context);
+                const { contentType, filename } = getExportMeta(tableName, params.export);
+                return new Response(body, {
+                    status: 200,
+                    headers: {
+                        'Content-Type': contentType,
+                        'Content-Disposition': `attachment; filename="${filename}"`,
+                    },
+                });
+            }
+            // --- Normal query ---
+            const result = await engine.query(params, context);
+            return Response.json(result, {
+                status: 200,
+                headers: {
+                    'X-Total-Count': String(result.meta.total),
+                },
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Internal server error';
+            console.error('[tablecraft/next]', err);
+            return Response.json({ error: message }, { status: 500 });
+        }
+    };
+}
+/**
+ * Creates a handler for a single, known table (no dynamic route needed).
+ *
+ * @example
+ * ```ts
+ * // app/api/users/route.ts
+ * import { createNextRouteHandler } from '@tablecraft/adapter-next';
+ * export const GET = createNextRouteHandler({ db, schema, config: usersConfig });
+ * ```
+ */
+export function createNextRouteHandler(options) {
+    const { db, schema, config, getContext, checkAccess } = options;
+    // Reuse the multi-table handler with a single config
+    const handler = createNextHandler({
+        db,
+        schema,
+        configs: [config],
+        getContext,
+        checkAccess,
+    });
+    return async function GET(request) {
+        // Simulate the dynamic route param
+        // We resolve the name from the config input
+        const resolvedConfig = 'toConfig' in config
+            ? config.toConfig()
+            : config;
+        return handler(request, { params: { table: resolvedConfig.name } });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@tablecraft/adapter-next",
+  "version": "0.1.0-beta.1",
+  "description": "Next.js App Router adapter for TableCraft",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun run --bun tsc",
+    "dev": "bun run --bun tsc --watch",
+    "test": "vitest",
+    "typecheck": "bun run --bun tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@tablecraft/engine": ">=0.1.0-beta.1",
+    "next": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@tablecraft/engine": "workspace:*",
+    "@types/node": "^25.2.2",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "keywords": [
+    "tablecraft",
+    "nextjs",
+    "adapter",
+    "next"
+  ],
+  "license": "MIT"
+}