@xylex-group/better-auth-athena 1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing
+
+Thanks for taking the time to contribute to **better-auth-athena**!
+
+## Development Setup
+
+1. Fork and clone the repository.
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Run the checks:
+   ```bash
+   npm run typecheck
+   npm run test
+   npm run build
+   ```
+
+## Pull Requests
+
+- Keep changes focused and scoped to a single issue.
+- Add or update tests when you change behavior.
+- Ensure `npm run typecheck`, `npm run test`, and `npm run build` succeed before requesting review.
+- Describe the motivation and context in the PR description.
+
+## Reporting Issues
+
+If you find a bug, please open an issue with clear reproduction steps, expected behavior, and actual behavior.

package/CONTRIBUTORS.md

@@ -0,0 +1,3 @@
+# Contributors
+
+- XYLEX-GROUP

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XYLEX GROUP
+
+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/README.md

@@ -0,0 +1,73 @@
+# better-auth-athena
+
+A Better-Auth database adapter for the `@xylex-group/athena` gateway. It lets Better-Auth read and write data through Athena while keeping column names in `snake_case` as required by the gateway.
+
+## Installation
+
+```bash
+npm install better-auth-athena
+```
+
+This package relies on the following peer dependencies, so ensure they are installed in your project:
+
+```bash
+npm install better-auth @xylex-group/athena
+```
+
+## Usage
+
+```ts
+import { betterAuth } from "better-auth";
+import { athenaAdapter } from "better-auth-athena";
+
+export const auth = betterAuth({
+  database: athenaAdapter({
+    url: process.env.ATHENA_URL!,
+    apiKey: process.env.ATHENA_API_KEY!,
+    client: "my-app",
+  }),
+});
+```
+
+## Configuration
+
+`athenaAdapter` accepts the following options:
+
+| Option | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| `url` | `string` | ✅ | — | Athena gateway URL. |
+| `apiKey` | `string` | ✅ | — | API key used to authenticate with Athena. |
+| `client` | `string` | ❌ | — | Client name included with gateway requests. |
+| `debugLogs` | `DBAdapterDebugLogOption` | ❌ | `false` | Enables Better-Auth adapter debug logs. |
+| `usePlural` | `boolean` | ❌ | `false` | Treats table names as plural when mapping models. |
+
+## Notes
+
+- `findMany` sorting is performed in memory because the Athena SDK does not expose an order-by method on its query builder.
+- The adapter enables JSON, date, boolean, and numeric ID support in Better-Auth.
+
+## Development
+
+Node.js 20.19.0 or later is required for the test/build tooling.
+
+```bash
+npm run typecheck
+npm run test
+npm run build
+```
+
+## CI/CD
+
+GitHub Actions runs the typecheck, test, and build steps for every pull request and push. Releases can be published to npm by creating a GitHub release after the CI workflow succeeds.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup steps and the contribution process.
+
+## Contributors
+
+See [CONTRIBUTORS.md](./CONTRIBUTORS.md) for the current list of project contributors.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,216 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  athenaAdapter: () => athenaAdapter
+});
+module.exports = __toCommonJS(index_exports);
+var import_adapters = require("better-auth/adapters");
+var import_athena = require("@xylex-group/athena");
+function applyWhere(builder, field, operator, value) {
+  switch (operator) {
+    case "eq":
+      return builder.eq(field, value);
+    case "ne":
+      return builder.neq(field, value);
+    case "gt":
+      return builder.gt(field, value);
+    case "gte":
+      return builder.gte(field, value);
+    case "lt":
+      return builder.lt(field, value);
+    case "lte":
+      return builder.lte(field, value);
+    case "in":
+      return builder.in(field, value);
+    case "not_in":
+      return builder.not(field, "in", value);
+    case "contains":
+      return builder.like(field, `%${value}%`);
+    case "starts_with":
+      return builder.like(field, `${value}%`);
+    case "ends_with":
+      return builder.like(field, `%${value}`);
+    default:
+      return builder.eq(field, value);
+  }
+}
+var athenaAdapter = (config) => {
+  const db = (0, import_athena.createClient)(config.url, config.apiKey, {
+    client: config.client
+  });
+  return (0, import_adapters.createAdapterFactory)({
+    config: {
+      adapterId: "athena",
+      adapterName: "Athena Adapter",
+      usePlural: config.usePlural ?? false,
+      debugLogs: config.debugLogs ?? false,
+      // Athena/Postgres supports all these natively
+      supportsJSON: true,
+      supportsDates: true,
+      supportsBooleans: true,
+      supportsNumericIds: true
+    },
+    adapter: () => {
+      return {
+        // ------------------------------------------------------------------
+        // CREATE
+        // ------------------------------------------------------------------
+        create: async ({ model, data }) => {
+          const { data: result, error } = await db.from(model).insert(data).select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] create on "${model}" failed: ${error}`);
+          }
+          const row = Array.isArray(result) ? result[0] : result;
+          return row ?? data;
+        },
+        // ------------------------------------------------------------------
+        // UPDATE
+        // ------------------------------------------------------------------
+        update: async ({ model, where, update }) => {
+          let builder = db.from(model).update(update);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] update on "${model}" failed: ${error}`);
+          }
+          const row = Array.isArray(result) ? result[0] : result;
+          return row ?? null;
+        },
+        // ------------------------------------------------------------------
+        // UPDATE MANY
+        // ------------------------------------------------------------------
+        updateMany: async ({ model, where, update }) => {
+          let builder = db.from(model).update(update);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] updateMany on "${model}" failed: ${error}`);
+          }
+          return Array.isArray(result) ? result.length : result ? 1 : 0;
+        },
+        // ------------------------------------------------------------------
+        // DELETE
+        // ------------------------------------------------------------------
+        delete: async ({ model, where }) => {
+          let builder = db.from(model);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { error } = await builder.delete();
+          if (error) {
+            throw new Error(`[AthenaAdapter] delete on "${model}" failed: ${error}`);
+          }
+        },
+        // ------------------------------------------------------------------
+        // DELETE MANY
+        // ------------------------------------------------------------------
+        deleteMany: async ({ model, where }) => {
+          let builder = db.from(model);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.delete().select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] deleteMany on "${model}" failed: ${error}`);
+          }
+          return Array.isArray(result) ? result.length : result ? 1 : 0;
+        },
+        // ------------------------------------------------------------------
+        // FIND ONE
+        // ------------------------------------------------------------------
+        findOne: async ({ model, where, select }) => {
+          const columns = select && select.length > 0 ? select.join(", ") : void 0;
+          let builder = db.from(model).select(columns);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.limit(1);
+          if (error) {
+            throw new Error(`[AthenaAdapter] findOne on "${model}" failed: ${error}`);
+          }
+          const rows = Array.isArray(result) ? result : result ? [result] : [];
+          return rows[0] ?? null;
+        },
+        // ------------------------------------------------------------------
+        // FIND MANY
+        // ------------------------------------------------------------------
+        findMany: async ({ model, where, limit, sortBy, offset, select }) => {
+          const columns = select && select.length > 0 ? select.join(", ") : void 0;
+          let builder = db.from(model).select(columns);
+          if (where) {
+            for (const clause of where) {
+              builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+            }
+          }
+          if (limit !== void 0) {
+            builder = builder.limit(limit);
+          }
+          if (offset !== void 0) {
+            builder = builder.offset(offset);
+          }
+          const { data: result, error } = await builder;
+          if (error) {
+            throw new Error(`[AthenaAdapter] findMany on "${model}" failed: ${error}`);
+          }
+          const rows = Array.isArray(result) ? result : [];
+          if (sortBy) {
+            rows.sort((a, b) => {
+              const aVal = a[sortBy.field];
+              const bVal = b[sortBy.field];
+              if (aVal == null && bVal == null) return 0;
+              if (aVal == null) return sortBy.direction === "asc" ? -1 : 1;
+              if (bVal == null) return sortBy.direction === "asc" ? 1 : -1;
+              const cmp = typeof aVal === "string" && typeof bVal === "string" ? aVal.localeCompare(bVal) : aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
+              return sortBy.direction === "asc" ? cmp : -cmp;
+            });
+          }
+          return rows;
+        },
+        // ------------------------------------------------------------------
+        // COUNT
+        // ------------------------------------------------------------------
+        count: async ({ model, where }) => {
+          let builder = db.from(model).select();
+          if (where) {
+            for (const clause of where) {
+              builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+            }
+          }
+          const { data: result, error } = await builder;
+          if (error) {
+            throw new Error(`[AthenaAdapter] count on "${model}" failed: ${error}`);
+          }
+          return Array.isArray(result) ? result.length : 0;
+        }
+      };
+    }
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  athenaAdapter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\r\n  createAdapterFactory,\r\n  type AdapterFactory,\r\n  type DBAdapterDebugLogOption,\r\n} from \"better-auth/adapters\";\r\nimport type { BetterAuthOptions } from \"better-auth\";\r\nimport { createClient, type SupabaseClient as AthenaClient } from \"@xylex-group/athena\";\r\n\r\n/**\r\n * Configuration options for the Athena adapter.\r\n */\r\nexport interface AthenaAdapterConfig {\r\n  /**\r\n   * The URL of your Athena gateway.\r\n   */\r\n  url: string;\r\n  /**\r\n   * The API key for authenticating with the Athena gateway.\r\n   */\r\n  apiKey: string;\r\n  /**\r\n   * The client name sent in requests to the Athena gateway.\r\n   */\r\n  client?: string;\r\n  /**\r\n   * Helps you debug issues with the adapter.\r\n   */\r\n  debugLogs?: DBAdapterDebugLogOption;\r\n  /**\r\n   * If the table names in the schema are plural.\r\n   *\r\n   * @default false\r\n   */\r\n  usePlural?: boolean;\r\n}\r\n\r\ntype AthenaFilterBuilder = {\r\n  eq(col: string, val: unknown): AthenaFilterBuilder;\r\n  neq(col: string, val: unknown): AthenaFilterBuilder;\r\n  gt(col: string, val: unknown): AthenaFilterBuilder;\r\n  gte(col: string, val: unknown): AthenaFilterBuilder;\r\n  lt(col: string, val: unknown): AthenaFilterBuilder;\r\n  lte(col: string, val: unknown): AthenaFilterBuilder;\r\n  in(col: string, vals: unknown[]): AthenaFilterBuilder;\r\n  not(col: string, op?: string, val?: unknown): AthenaFilterBuilder;\r\n  like(col: string, val: string): AthenaFilterBuilder;\r\n};\r\n\r\n/**\r\n * Apply a Better-Auth `CleanedWhere` clause to an Athena filter-chain builder.\r\n */\r\nfunction applyWhere<T extends AthenaFilterBuilder>(\r\n  builder: T,\r\n  field: string,\r\n  operator: string,\r\n  value: unknown,\r\n): T {\r\n  switch (operator) {\r\n    case \"eq\":\r\n      return builder.eq(field, value) as T;\r\n    case \"ne\":\r\n      return builder.neq(field, value) as T;\r\n    case \"gt\":\r\n      return builder.gt(field, value) as T;\r\n    case \"gte\":\r\n      return builder.gte(field, value) as T;\r\n    case \"lt\":\r\n      return builder.lt(field, value) as T;\r\n    case \"lte\":\r\n      return builder.lte(field, value) as T;\r\n    case \"in\":\r\n      return builder.in(field, value as unknown[]) as T;\r\n    case \"not_in\":\r\n      return builder.not(field, \"in\", value) as T;\r\n    case \"contains\":\r\n      return builder.like(field, `%${value}%`) as T;\r\n    case \"starts_with\":\r\n      return builder.like(field, `${value}%`) as T;\r\n    case \"ends_with\":\r\n      return builder.like(field, `%${value}`) as T;\r\n    default:\r\n      return builder.eq(field, value) as T;\r\n  }\r\n}\r\n\r\ntype WhereClause = { field: string; operator: string; value: unknown };\r\n\r\n/**\r\n * Create a Better-Auth database adapter backed by @xylex-group/athena.\r\n *\r\n * Column names are kept in snake_case as required by the Athena gateway.\r\n *\r\n * @example\r\n * ```ts\r\n * import { betterAuth } from \"better-auth\";\r\n * import { athenaAdapter } from \"better-auth-athena\";\r\n *\r\n * export const auth = betterAuth({\r\n *   database: athenaAdapter({\r\n *     url: process.env.ATHENA_URL!,\r\n *     apiKey: process.env.ATHENA_API_KEY!,\r\n *     client: \"my-app\",\r\n *   }),\r\n * });\r\n * ```\r\n */\r\nexport const athenaAdapter = (config: AthenaAdapterConfig): AdapterFactory<BetterAuthOptions> => {\r\n  const db: AthenaClient = createClient(config.url, config.apiKey, {\r\n    client: config.client,\r\n  });\r\n\r\n  return createAdapterFactory({\r\n    config: {\r\n      adapterId: \"athena\",\r\n      adapterName: \"Athena Adapter\",\r\n      usePlural: config.usePlural ?? false,\r\n      debugLogs: config.debugLogs ?? false,\r\n      // Athena/Postgres supports all these natively\r\n      supportsJSON: true,\r\n      supportsDates: true,\r\n      supportsBooleans: true,\r\n      supportsNumericIds: true,\r\n    },\r\n    adapter: () => {\r\n      return {\r\n        // ------------------------------------------------------------------\r\n        // CREATE\r\n        // ------------------------------------------------------------------\r\n        create: async <T extends Record<string, unknown>>({ model, data }: { model: string; data: T; select?: string[] }) => {\r\n          const { data: result, error } = await db\r\n            .from(model)\r\n            .insert(data)\r\n            .select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] create on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          // Athena returns the inserted row(s); take the first one.\r\n          const row = Array.isArray(result) ? result[0] : result;\r\n          return (row ?? data) as T;\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // UPDATE\r\n        // ------------------------------------------------------------------\r\n        update: async <T>({ model, where, update }: { model: string; where: WhereClause[]; update: T }) => {\r\n          let builder = db.from(model).update(update as Record<string, unknown>);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] update on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          const row = Array.isArray(result) ? result[0] : result;\r\n          return (row ?? null) as T | null;\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // UPDATE MANY\r\n        // ------------------------------------------------------------------\r\n        updateMany: async ({ model, where, update }: { model: string; where: WhereClause[]; update: Record<string, unknown> }) => {\r\n          let builder = db.from(model).update(update);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] updateMany on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          return Array.isArray(result) ? result.length : (result ? 1 : 0);\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // DELETE\r\n        // ------------------------------------------------------------------\r\n        delete: async ({ model, where }: { model: string; where: WhereClause[] }) => {\r\n          let builder = db.from(model);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { error } = await builder.delete();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] delete on \"${model}\" failed: ${error}`);\r\n          }\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // DELETE MANY\r\n        // ------------------------------------------------------------------\r\n        deleteMany: async ({ model, where }: { model: string; where: WhereClause[] }) => {\r\n          let builder = db.from(model);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.delete().select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] deleteMany on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          return Array.isArray(result) ? result.length : (result ? 1 : 0);\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // FIND ONE\r\n        // ------------------------------------------------------------------\r\n        findOne: async <T>({ model, where, select }: { model: string; where: WhereClause[]; select?: string[]; join?: unknown }) => {\r\n          const columns = select && select.length > 0 ? select.join(\", \") : undefined;\r\n          let builder = db.from(model).select(columns);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.limit(1);\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] findOne on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          const rows = Array.isArray(result) ? result : (result ? [result] : []);\r\n          return (rows[0] ?? null) as T | null;\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // FIND MANY\r\n        // ------------------------------------------------------------------\r\n        findMany: async <T>({ model, where, limit, sortBy, offset, select }: {\r\n          model: string;\r\n          where?: WhereClause[];\r\n          limit: number;\r\n          select?: string[];\r\n          sortBy?: { field: string; direction: \"asc\" | \"desc\" };\r\n          offset?: number;\r\n          join?: unknown;\r\n        }) => {\r\n          const columns = select && select.length > 0 ? select.join(\", \") : undefined;\r\n          let builder = db.from(model).select(columns);\r\n\r\n          if (where) {\r\n            for (const clause of where) {\r\n              builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n            }\r\n          }\r\n\r\n          if (limit !== undefined) {\r\n            builder = builder.limit(limit);\r\n          }\r\n\r\n          if (offset !== undefined) {\r\n            builder = builder.offset(offset);\r\n          }\r\n\r\n          const { data: result, error } = await builder;\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] findMany on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          const rows = (Array.isArray(result) ? result : []) as Record<string, unknown>[];\r\n\r\n          // The Athena SDK's select chain does not expose a native orderBy/sort\r\n          // method, so we sort the returned rows in memory when sortBy is requested.\r\n          if (sortBy) {\r\n            rows.sort((a, b) => {\r\n              const aVal = a[sortBy.field];\r\n              const bVal = b[sortBy.field];\r\n              if (aVal == null && bVal == null) return 0;\r\n              if (aVal == null) return sortBy.direction === \"asc\" ? -1 : 1;\r\n              if (bVal == null) return sortBy.direction === \"asc\" ? 1 : -1;\r\n              const cmp =\r\n                typeof aVal === \"string\" && typeof bVal === \"string\"\r\n                  ? aVal.localeCompare(bVal)\r\n                  : aVal < bVal\r\n                  ? -1\r\n                  : aVal > bVal\r\n                  ? 1\r\n                  : 0;\r\n              return sortBy.direction === \"asc\" ? cmp : -cmp;\r\n            });\r\n          }\r\n\r\n          return rows as T[];\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // COUNT\r\n        // ------------------------------------------------------------------\r\n        count: async ({ model, where }: { model: string; where?: WhereClause[] }) => {\r\n          let builder = db.from(model).select();\r\n\r\n          if (where) {\r\n            for (const clause of where) {\r\n              builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n            }\r\n          }\r\n\r\n          const { data: result, error } = await builder;\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] count on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          return Array.isArray(result) ? result.length : 0;\r\n        },\r\n      };\r\n    },\r\n  });\r\n};\r\n\r\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import { DBAdapterDebugLogOption, AdapterFactory } from 'better-auth/adapters';
+import { BetterAuthOptions } from 'better-auth';
+
+/**
+ * Configuration options for the Athena adapter.
+ */
+interface AthenaAdapterConfig {
+    /**
+     * The URL of your Athena gateway.
+     */
+    url: string;
+    /**
+     * The API key for authenticating with the Athena gateway.
+     */
+    apiKey: string;
+    /**
+     * The client name sent in requests to the Athena gateway.
+     */
+    client?: string;
+    /**
+     * Helps you debug issues with the adapter.
+     */
+    debugLogs?: DBAdapterDebugLogOption;
+    /**
+     * If the table names in the schema are plural.
+     *
+     * @default false
+     */
+    usePlural?: boolean;
+}
+/**
+ * Create a Better-Auth database adapter backed by @xylex-group/athena.
+ *
+ * Column names are kept in snake_case as required by the Athena gateway.
+ *
+ * @example
+ * ```ts
+ * import { betterAuth } from "better-auth";
+ * import { athenaAdapter } from "better-auth-athena";
+ *
+ * export const auth = betterAuth({
+ *   database: athenaAdapter({
+ *     url: process.env.ATHENA_URL!,
+ *     apiKey: process.env.ATHENA_API_KEY!,
+ *     client: "my-app",
+ *   }),
+ * });
+ * ```
+ */
+declare const athenaAdapter: (config: AthenaAdapterConfig) => AdapterFactory<BetterAuthOptions>;
+
+export { type AthenaAdapterConfig, athenaAdapter };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { DBAdapterDebugLogOption, AdapterFactory } from 'better-auth/adapters';
+import { BetterAuthOptions } from 'better-auth';
+
+/**
+ * Configuration options for the Athena adapter.
+ */
+interface AthenaAdapterConfig {
+    /**
+     * The URL of your Athena gateway.
+     */
+    url: string;
+    /**
+     * The API key for authenticating with the Athena gateway.
+     */
+    apiKey: string;
+    /**
+     * The client name sent in requests to the Athena gateway.
+     */
+    client?: string;
+    /**
+     * Helps you debug issues with the adapter.
+     */
+    debugLogs?: DBAdapterDebugLogOption;
+    /**
+     * If the table names in the schema are plural.
+     *
+     * @default false
+     */
+    usePlural?: boolean;
+}
+/**
+ * Create a Better-Auth database adapter backed by @xylex-group/athena.
+ *
+ * Column names are kept in snake_case as required by the Athena gateway.
+ *
+ * @example
+ * ```ts
+ * import { betterAuth } from "better-auth";
+ * import { athenaAdapter } from "better-auth-athena";
+ *
+ * export const auth = betterAuth({
+ *   database: athenaAdapter({
+ *     url: process.env.ATHENA_URL!,
+ *     apiKey: process.env.ATHENA_API_KEY!,
+ *     client: "my-app",
+ *   }),
+ * });
+ * ```
+ */
+declare const athenaAdapter: (config: AthenaAdapterConfig) => AdapterFactory<BetterAuthOptions>;
+
+export { type AthenaAdapterConfig, athenaAdapter };

package/dist/index.js

@@ -0,0 +1,193 @@
+// src/index.ts
+import {
+  createAdapterFactory
+} from "better-auth/adapters";
+import { createClient } from "@xylex-group/athena";
+function applyWhere(builder, field, operator, value) {
+  switch (operator) {
+    case "eq":
+      return builder.eq(field, value);
+    case "ne":
+      return builder.neq(field, value);
+    case "gt":
+      return builder.gt(field, value);
+    case "gte":
+      return builder.gte(field, value);
+    case "lt":
+      return builder.lt(field, value);
+    case "lte":
+      return builder.lte(field, value);
+    case "in":
+      return builder.in(field, value);
+    case "not_in":
+      return builder.not(field, "in", value);
+    case "contains":
+      return builder.like(field, `%${value}%`);
+    case "starts_with":
+      return builder.like(field, `${value}%`);
+    case "ends_with":
+      return builder.like(field, `%${value}`);
+    default:
+      return builder.eq(field, value);
+  }
+}
+var athenaAdapter = (config) => {
+  const db = createClient(config.url, config.apiKey, {
+    client: config.client
+  });
+  return createAdapterFactory({
+    config: {
+      adapterId: "athena",
+      adapterName: "Athena Adapter",
+      usePlural: config.usePlural ?? false,
+      debugLogs: config.debugLogs ?? false,
+      // Athena/Postgres supports all these natively
+      supportsJSON: true,
+      supportsDates: true,
+      supportsBooleans: true,
+      supportsNumericIds: true
+    },
+    adapter: () => {
+      return {
+        // ------------------------------------------------------------------
+        // CREATE
+        // ------------------------------------------------------------------
+        create: async ({ model, data }) => {
+          const { data: result, error } = await db.from(model).insert(data).select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] create on "${model}" failed: ${error}`);
+          }
+          const row = Array.isArray(result) ? result[0] : result;
+          return row ?? data;
+        },
+        // ------------------------------------------------------------------
+        // UPDATE
+        // ------------------------------------------------------------------
+        update: async ({ model, where, update }) => {
+          let builder = db.from(model).update(update);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] update on "${model}" failed: ${error}`);
+          }
+          const row = Array.isArray(result) ? result[0] : result;
+          return row ?? null;
+        },
+        // ------------------------------------------------------------------
+        // UPDATE MANY
+        // ------------------------------------------------------------------
+        updateMany: async ({ model, where, update }) => {
+          let builder = db.from(model).update(update);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] updateMany on "${model}" failed: ${error}`);
+          }
+          return Array.isArray(result) ? result.length : result ? 1 : 0;
+        },
+        // ------------------------------------------------------------------
+        // DELETE
+        // ------------------------------------------------------------------
+        delete: async ({ model, where }) => {
+          let builder = db.from(model);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { error } = await builder.delete();
+          if (error) {
+            throw new Error(`[AthenaAdapter] delete on "${model}" failed: ${error}`);
+          }
+        },
+        // ------------------------------------------------------------------
+        // DELETE MANY
+        // ------------------------------------------------------------------
+        deleteMany: async ({ model, where }) => {
+          let builder = db.from(model);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.delete().select();
+          if (error) {
+            throw new Error(`[AthenaAdapter] deleteMany on "${model}" failed: ${error}`);
+          }
+          return Array.isArray(result) ? result.length : result ? 1 : 0;
+        },
+        // ------------------------------------------------------------------
+        // FIND ONE
+        // ------------------------------------------------------------------
+        findOne: async ({ model, where, select }) => {
+          const columns = select && select.length > 0 ? select.join(", ") : void 0;
+          let builder = db.from(model).select(columns);
+          for (const clause of where) {
+            builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+          }
+          const { data: result, error } = await builder.limit(1);
+          if (error) {
+            throw new Error(`[AthenaAdapter] findOne on "${model}" failed: ${error}`);
+          }
+          const rows = Array.isArray(result) ? result : result ? [result] : [];
+          return rows[0] ?? null;
+        },
+        // ------------------------------------------------------------------
+        // FIND MANY
+        // ------------------------------------------------------------------
+        findMany: async ({ model, where, limit, sortBy, offset, select }) => {
+          const columns = select && select.length > 0 ? select.join(", ") : void 0;
+          let builder = db.from(model).select(columns);
+          if (where) {
+            for (const clause of where) {
+              builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+            }
+          }
+          if (limit !== void 0) {
+            builder = builder.limit(limit);
+          }
+          if (offset !== void 0) {
+            builder = builder.offset(offset);
+          }
+          const { data: result, error } = await builder;
+          if (error) {
+            throw new Error(`[AthenaAdapter] findMany on "${model}" failed: ${error}`);
+          }
+          const rows = Array.isArray(result) ? result : [];
+          if (sortBy) {
+            rows.sort((a, b) => {
+              const aVal = a[sortBy.field];
+              const bVal = b[sortBy.field];
+              if (aVal == null && bVal == null) return 0;
+              if (aVal == null) return sortBy.direction === "asc" ? -1 : 1;
+              if (bVal == null) return sortBy.direction === "asc" ? 1 : -1;
+              const cmp = typeof aVal === "string" && typeof bVal === "string" ? aVal.localeCompare(bVal) : aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
+              return sortBy.direction === "asc" ? cmp : -cmp;
+            });
+          }
+          return rows;
+        },
+        // ------------------------------------------------------------------
+        // COUNT
+        // ------------------------------------------------------------------
+        count: async ({ model, where }) => {
+          let builder = db.from(model).select();
+          if (where) {
+            for (const clause of where) {
+              builder = applyWhere(builder, clause.field, clause.operator, clause.value);
+            }
+          }
+          const { data: result, error } = await builder;
+          if (error) {
+            throw new Error(`[AthenaAdapter] count on "${model}" failed: ${error}`);
+          }
+          return Array.isArray(result) ? result.length : 0;
+        }
+      };
+    }
+  });
+};
+export {
+  athenaAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\r\n  createAdapterFactory,\r\n  type AdapterFactory,\r\n  type DBAdapterDebugLogOption,\r\n} from \"better-auth/adapters\";\r\nimport type { BetterAuthOptions } from \"better-auth\";\r\nimport { createClient, type SupabaseClient as AthenaClient } from \"@xylex-group/athena\";\r\n\r\n/**\r\n * Configuration options for the Athena adapter.\r\n */\r\nexport interface AthenaAdapterConfig {\r\n  /**\r\n   * The URL of your Athena gateway.\r\n   */\r\n  url: string;\r\n  /**\r\n   * The API key for authenticating with the Athena gateway.\r\n   */\r\n  apiKey: string;\r\n  /**\r\n   * The client name sent in requests to the Athena gateway.\r\n   */\r\n  client?: string;\r\n  /**\r\n   * Helps you debug issues with the adapter.\r\n   */\r\n  debugLogs?: DBAdapterDebugLogOption;\r\n  /**\r\n   * If the table names in the schema are plural.\r\n   *\r\n   * @default false\r\n   */\r\n  usePlural?: boolean;\r\n}\r\n\r\ntype AthenaFilterBuilder = {\r\n  eq(col: string, val: unknown): AthenaFilterBuilder;\r\n  neq(col: string, val: unknown): AthenaFilterBuilder;\r\n  gt(col: string, val: unknown): AthenaFilterBuilder;\r\n  gte(col: string, val: unknown): AthenaFilterBuilder;\r\n  lt(col: string, val: unknown): AthenaFilterBuilder;\r\n  lte(col: string, val: unknown): AthenaFilterBuilder;\r\n  in(col: string, vals: unknown[]): AthenaFilterBuilder;\r\n  not(col: string, op?: string, val?: unknown): AthenaFilterBuilder;\r\n  like(col: string, val: string): AthenaFilterBuilder;\r\n};\r\n\r\n/**\r\n * Apply a Better-Auth `CleanedWhere` clause to an Athena filter-chain builder.\r\n */\r\nfunction applyWhere<T extends AthenaFilterBuilder>(\r\n  builder: T,\r\n  field: string,\r\n  operator: string,\r\n  value: unknown,\r\n): T {\r\n  switch (operator) {\r\n    case \"eq\":\r\n      return builder.eq(field, value) as T;\r\n    case \"ne\":\r\n      return builder.neq(field, value) as T;\r\n    case \"gt\":\r\n      return builder.gt(field, value) as T;\r\n    case \"gte\":\r\n      return builder.gte(field, value) as T;\r\n    case \"lt\":\r\n      return builder.lt(field, value) as T;\r\n    case \"lte\":\r\n      return builder.lte(field, value) as T;\r\n    case \"in\":\r\n      return builder.in(field, value as unknown[]) as T;\r\n    case \"not_in\":\r\n      return builder.not(field, \"in\", value) as T;\r\n    case \"contains\":\r\n      return builder.like(field, `%${value}%`) as T;\r\n    case \"starts_with\":\r\n      return builder.like(field, `${value}%`) as T;\r\n    case \"ends_with\":\r\n      return builder.like(field, `%${value}`) as T;\r\n    default:\r\n      return builder.eq(field, value) as T;\r\n  }\r\n}\r\n\r\ntype WhereClause = { field: string; operator: string; value: unknown };\r\n\r\n/**\r\n * Create a Better-Auth database adapter backed by @xylex-group/athena.\r\n *\r\n * Column names are kept in snake_case as required by the Athena gateway.\r\n *\r\n * @example\r\n * ```ts\r\n * import { betterAuth } from \"better-auth\";\r\n * import { athenaAdapter } from \"better-auth-athena\";\r\n *\r\n * export const auth = betterAuth({\r\n *   database: athenaAdapter({\r\n *     url: process.env.ATHENA_URL!,\r\n *     apiKey: process.env.ATHENA_API_KEY!,\r\n *     client: \"my-app\",\r\n *   }),\r\n * });\r\n * ```\r\n */\r\nexport const athenaAdapter = (config: AthenaAdapterConfig): AdapterFactory<BetterAuthOptions> => {\r\n  const db: AthenaClient = createClient(config.url, config.apiKey, {\r\n    client: config.client,\r\n  });\r\n\r\n  return createAdapterFactory({\r\n    config: {\r\n      adapterId: \"athena\",\r\n      adapterName: \"Athena Adapter\",\r\n      usePlural: config.usePlural ?? false,\r\n      debugLogs: config.debugLogs ?? false,\r\n      // Athena/Postgres supports all these natively\r\n      supportsJSON: true,\r\n      supportsDates: true,\r\n      supportsBooleans: true,\r\n      supportsNumericIds: true,\r\n    },\r\n    adapter: () => {\r\n      return {\r\n        // ------------------------------------------------------------------\r\n        // CREATE\r\n        // ------------------------------------------------------------------\r\n        create: async <T extends Record<string, unknown>>({ model, data }: { model: string; data: T; select?: string[] }) => {\r\n          const { data: result, error } = await db\r\n            .from(model)\r\n            .insert(data)\r\n            .select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] create on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          // Athena returns the inserted row(s); take the first one.\r\n          const row = Array.isArray(result) ? result[0] : result;\r\n          return (row ?? data) as T;\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // UPDATE\r\n        // ------------------------------------------------------------------\r\n        update: async <T>({ model, where, update }: { model: string; where: WhereClause[]; update: T }) => {\r\n          let builder = db.from(model).update(update as Record<string, unknown>);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] update on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          const row = Array.isArray(result) ? result[0] : result;\r\n          return (row ?? null) as T | null;\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // UPDATE MANY\r\n        // ------------------------------------------------------------------\r\n        updateMany: async ({ model, where, update }: { model: string; where: WhereClause[]; update: Record<string, unknown> }) => {\r\n          let builder = db.from(model).update(update);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] updateMany on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          return Array.isArray(result) ? result.length : (result ? 1 : 0);\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // DELETE\r\n        // ------------------------------------------------------------------\r\n        delete: async ({ model, where }: { model: string; where: WhereClause[] }) => {\r\n          let builder = db.from(model);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { error } = await builder.delete();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] delete on \"${model}\" failed: ${error}`);\r\n          }\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // DELETE MANY\r\n        // ------------------------------------------------------------------\r\n        deleteMany: async ({ model, where }: { model: string; where: WhereClause[] }) => {\r\n          let builder = db.from(model);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.delete().select();\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] deleteMany on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          return Array.isArray(result) ? result.length : (result ? 1 : 0);\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // FIND ONE\r\n        // ------------------------------------------------------------------\r\n        findOne: async <T>({ model, where, select }: { model: string; where: WhereClause[]; select?: string[]; join?: unknown }) => {\r\n          const columns = select && select.length > 0 ? select.join(\", \") : undefined;\r\n          let builder = db.from(model).select(columns);\r\n\r\n          for (const clause of where) {\r\n            builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n          }\r\n\r\n          const { data: result, error } = await builder.limit(1);\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] findOne on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          const rows = Array.isArray(result) ? result : (result ? [result] : []);\r\n          return (rows[0] ?? null) as T | null;\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // FIND MANY\r\n        // ------------------------------------------------------------------\r\n        findMany: async <T>({ model, where, limit, sortBy, offset, select }: {\r\n          model: string;\r\n          where?: WhereClause[];\r\n          limit: number;\r\n          select?: string[];\r\n          sortBy?: { field: string; direction: \"asc\" | \"desc\" };\r\n          offset?: number;\r\n          join?: unknown;\r\n        }) => {\r\n          const columns = select && select.length > 0 ? select.join(\", \") : undefined;\r\n          let builder = db.from(model).select(columns);\r\n\r\n          if (where) {\r\n            for (const clause of where) {\r\n              builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n            }\r\n          }\r\n\r\n          if (limit !== undefined) {\r\n            builder = builder.limit(limit);\r\n          }\r\n\r\n          if (offset !== undefined) {\r\n            builder = builder.offset(offset);\r\n          }\r\n\r\n          const { data: result, error } = await builder;\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] findMany on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          const rows = (Array.isArray(result) ? result : []) as Record<string, unknown>[];\r\n\r\n          // The Athena SDK's select chain does not expose a native orderBy/sort\r\n          // method, so we sort the returned rows in memory when sortBy is requested.\r\n          if (sortBy) {\r\n            rows.sort((a, b) => {\r\n              const aVal = a[sortBy.field];\r\n              const bVal = b[sortBy.field];\r\n              if (aVal == null && bVal == null) return 0;\r\n              if (aVal == null) return sortBy.direction === \"asc\" ? -1 : 1;\r\n              if (bVal == null) return sortBy.direction === \"asc\" ? 1 : -1;\r\n              const cmp =\r\n                typeof aVal === \"string\" && typeof bVal === \"string\"\r\n                  ? aVal.localeCompare(bVal)\r\n                  : aVal < bVal\r\n                  ? -1\r\n                  : aVal > bVal\r\n                  ? 1\r\n                  : 0;\r\n              return sortBy.direction === \"asc\" ? cmp : -cmp;\r\n            });\r\n          }\r\n\r\n          return rows as T[];\r\n        },\r\n\r\n        // ------------------------------------------------------------------\r\n        // COUNT\r\n        // ------------------------------------------------------------------\r\n        count: async ({ model, where }: { model: string; where?: WhereClause[] }) => {\r\n          let builder = db.from(model).select();\r\n\r\n          if (where) {\r\n            for (const clause of where) {\r\n              builder = applyWhere(builder, clause.field, clause.operator, clause.value);\r\n            }\r\n          }\r\n\r\n          const { data: result, error } = await builder;\r\n\r\n          if (error) {\r\n            throw new Error(`[AthenaAdapter] count on \"${model}\" failed: ${error}`);\r\n          }\r\n\r\n          return Array.isArray(result) ? result.length : 0;\r\n        },\r\n      };\r\n    },\r\n  });\r\n};\r\n\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@xylex-group/better-auth-athena",
+  "version": "1.0.0",
+  "description": "A better-Auth database adapter for @xylex-group/athena",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CONTRIBUTING.md",
+    "CONTRIBUTORS.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm run typecheck && npm run test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xylex-group/better-auth-athena.git"
+  },
+  "keywords": [
+    "better-auth",
+    "athena",
+    "database",
+    "adapter"
+  ],
+  "author": "XYLEX GROUP",
+  "contributors": [
+    "floris-xlx"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "bugs": {
+    "url": "https://github.com/xylex-group/better-auth-athena/issues"
+  },
+  "homepage": "https://github.com/xylex-group/better-auth-athena#readme",
+  "peerDependencies": {
+    "@xylex-group/athena": "^1.1.1",
+    "better-auth": "^1.5.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@xylex-group/athena": "^1.1.1",
+    "better-auth": "^1.5.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}