@tablecraft/adapter-elysia 0.1.0-beta.1

package/README.md

@@ -0,0 +1,27 @@
+# @tablecraft/adapter-elysia
+
+Elysia (Bun) adapter for [TableCraft](https://github.com/your-org/tablecraft).
+
+## Install
+
+```bash
+bun add @tablecraft/engine @tablecraft/adapter-elysia
+```
+
+## Usage
+
+```ts
+import { Elysia } from 'elysia';
+import { createElysiaPlugin } from '@tablecraft/adapter-elysia';
+
+const app = new Elysia()
+  .use(createElysiaPlugin({
+    db,
+    schema,
+    configs,
+    getContext: ({ request }) => ({
+      tenantId: request.headers.get('x-tenant-id'),
+    }),
+  }))
+  .listen(3000);
+```

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import { Elysia } from 'elysia';
+import { TableConfig, ConfigInput, EngineContext } from '@tablecraft/engine';
+export interface ElysiaAdapterOptions {
+    db: unknown;
+    schema: Record<string, unknown>;
+    configs: ConfigInput[] | Record<string, ConfigInput>;
+    /**
+     * Extract context from the Elysia context.
+     * Access headers, store, etc.
+     */
+    getContext?: (ctx: {
+        request: Request;
+        store: Record<string, unknown>;
+    }) => EngineContext | Promise<EngineContext>;
+    /**
+     * Override built-in access check with your own logic.
+     */
+    checkAccess?: (config: TableConfig, context: EngineContext, request: Request) => boolean | Promise<boolean>;
+}
+/**
+ * Creates an Elysia plugin with a `/:table` route.
+ */
+export declare function createElysiaPlugin(options: ElysiaAdapterOptions): Elysia<"/api/data", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    api: {
+        data: {
+            ":table": {
+                _meta: {
+                    get: {
+                        body: unknown;
+                        params: {
+                            table: string;
+                        } & {};
+                        query: any;
+                        headers: any;
+                        response: {
+                            200: import("@tablecraft/engine").TableMetadata | {
+                                error: string;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        data: {
+            ":table": {
+                get: {
+                    body: unknown;
+                    params: {
+                        table: string;
+                    } & {};
+                    query: any;
+                    headers: any;
+                    response: {
+                        200: string | import("@tablecraft/engine").EngineResult<Record<string, unknown>> | {
+                            error: string;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+/**
+ * Creates an Elysia handler for a single table.
+ */
+export declare function createElysiaHandler(options: {
+    db: unknown;
+    schema: Record<string, unknown>;
+    config: ConfigInput;
+    getContext?: (ctx: {
+        request: Request;
+        store: Record<string, unknown>;
+    }) => EngineContext | Promise<EngineContext>;
+    checkAccess?: (config: TableConfig, context: EngineContext, request: Request) => boolean | Promise<boolean>;
+}): ({ request, store, set }: {
+    request: Request;
+    store: Record<string, unknown>;
+    set: any;
+}) => Promise<string | import("@tablecraft/engine").EngineResult<Record<string, unknown>> | {
+    error: string;
+}>;
+//# 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,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAML,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,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,GAAG,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnH;;OAEG;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;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4E/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnH,WAAW,CAAC,EAAE,CACZ,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,OAAO,KACb,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,IAIe,yBAAyB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE;;GAqCtG"}

package/dist/index.js

@@ -0,0 +1,100 @@
+import { Elysia } from 'elysia';
+import { createEngines, createTableEngine, parseRequest, checkAccess as defaultCheckAccess, getExportMeta, } from '@tablecraft/engine';
+/**
+ * Creates an Elysia plugin with a `/:table` route.
+ */
+export function createElysiaPlugin(options) {
+    const engines = createEngines({
+        db: options.db,
+        schema: options.schema,
+        configs: options.configs,
+    });
+    return new Elysia({ prefix: '/api/data' }).get('/:table/_meta', async ({ params, request, store, set }) => {
+        const tableName = params.table;
+        const engine = engines[tableName];
+        if (!engine) {
+            set.status = 404;
+            return { error: `Unknown resource '${tableName}'` };
+        }
+        const context = options.getContext
+            ? await options.getContext({ request, store: store })
+            : {};
+        return engine.getMetadata(context);
+    }).get('/:table', async ({ params, request, store, set }) => {
+        const tableName = params.table;
+        const engine = engines[tableName];
+        if (!engine) {
+            set.status = 404;
+            return { error: `Unknown resource '${tableName}'` };
+        }
+        const config = engine.getConfig();
+        const context = options.getContext
+            ? await options.getContext({ request, store: store })
+            : {};
+        const hasAccess = options.checkAccess
+            ? await options.checkAccess(config, context, request)
+            : defaultCheckAccess(config, context);
+        if (!hasAccess) {
+            set.status = 403;
+            return { error: 'Forbidden' };
+        }
+        const url = new URL(request.url);
+        const reqParams = parseRequest(url.searchParams);
+        // Export
+        if (reqParams.export) {
+            const allowed = config.export?.formats ?? ['csv', 'json'];
+            const enabled = config.export?.enabled ?? true;
+            if (!enabled || !allowed.includes(reqParams.export)) {
+                set.status = 400;
+                return { error: `Export format '${reqParams.export}' not allowed` };
+            }
+            const body = await engine.exportData(reqParams, context);
+            const { contentType, filename } = getExportMeta(tableName, reqParams.export);
+            set.headers['Content-Type'] = contentType;
+            set.headers['Content-Disposition'] = `attachment; filename="${filename}"`;
+            return body;
+        }
+        // Query
+        const result = await engine.query(reqParams, context);
+        set.headers['X-Total-Count'] = String(result.meta.total);
+        return result;
+    });
+}
+/**
+ * Creates an Elysia handler for a single table.
+ */
+export function createElysiaHandler(options) {
+    const { db, schema, config, getContext, checkAccess } = options;
+    const engine = createTableEngine({ db, schema, config });
+    return async ({ request, store, set }) => {
+        const context = getContext
+            ? await getContext({ request, store })
+            : {};
+        const actualConfig = engine.getConfig();
+        const hasAccess = checkAccess
+            ? await checkAccess(actualConfig, context, request)
+            : defaultCheckAccess(actualConfig, context);
+        if (!hasAccess) {
+            set.status = 403;
+            return { error: 'Forbidden' };
+        }
+        const url = new URL(request.url);
+        const params = parseRequest(url.searchParams);
+        if (params.export) {
+            const allowed = actualConfig.export?.formats ?? ['csv', 'json'];
+            if (!(actualConfig.export?.enabled ?? true) || !allowed.includes(params.export)) {
+                set.status = 400;
+                return { error: `Export format '${params.export}' not allowed` };
+            }
+            const body = await engine.exportData(params, context);
+            const { contentType, filename } = getExportMeta(actualConfig.name, params.export);
+            set.headers['Content-Type'] = contentType;
+            set.headers['Content-Disposition'] = `attachment; filename="${filename}"`;
+            return body;
+        }
+        const result = await engine.query(params, context);
+        set.headers['X-Total-Count'] = String(result.meta.total);
+        return result;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,WAAW,IAAI,kBAAkB,EACjC,aAAa,GAId,MAAM,oBAAoB,CAAC;AAqB5B;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,MAAM,OAAO,GAAG,aAAa,CAAC;QAC5B,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IAEH,OAAO,IAAI,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,CAC5C,eAAe,EACf,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;QAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,qBAAqB,SAAS,GAAG,EAAE,CAAC;QACtD,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU;YAChC,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAgC,EAAE,CAAC;YAChF,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,CACF,CAAC,GAAG,CACH,SAAS,EACT,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;QAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,qBAAqB,SAAS,GAAG,EAAE,CAAC;QACtD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAElC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU;YAChC,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAgC,EAAE,CAAC;YAChF,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW;YACnC,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;YACrD,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEjD,SAAS;QACT,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;YAE/C,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,kBAAkB,SAAS,CAAC,MAAM,eAAe,EAAE,CAAC;YACtE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;YAE7E,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;YAC1C,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,yBAAyB,QAAQ,GAAG,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,QAAQ;QACR,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC;IAChB,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAUnC;IACC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzD,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAkE,EAAE,EAAE;QACvG,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACtC,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAExC,MAAM,SAAS,GAAG,WAAW;YAC3B,CAAC,CAAC,MAAM,WAAW,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC;YACnD,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAE9C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAChE,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChF,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,kBAAkB,MAAM,CAAC,MAAM,eAAe,EAAE,CAAC;YACnE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAClF,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;YAC1C,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,yBAAyB,QAAQ,GAAG,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@tablecraft/adapter-elysia",
+  "version": "0.1.0-beta.1",
+  "description": "Elysia (Bun) 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",
+    "elysia": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@tablecraft/engine": "workspace:*",
+    "elysia": "^1.2.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "keywords": [
+    "tablecraft",
+    "elysia",
+    "bun",
+    "adapter"
+  ],
+  "license": "MIT"
+}