@authhero/kysely-adapter 11.14.2 → 11.16.0

package/dist/types/src/helpers/paginate.d.ts

@@ -0,0 +1,31 @@
+import { SelectQueryBuilder } from "kysely";
+import { ListParams } from "@authhero/adapter-interfaces";
+/**
+ * Keyset (checkpoint) pagination for list queries — the Auth0 `from`/`take`
+ * style. `from` is an OPAQUE cursor (see encodeCursor), decoded to a
+ * `(sortValue, id)` position; `take` is the page size. We fetch `take + 1`
+ * rows to detect whether another page follows and emit a `next` cursor,
+ * absent on the last page.
+ *
+ * This is intentionally keyset-only. Offset pagination (page/per_page + total),
+ * which the admin UI uses and which honors arbitrary user sort, stays in each
+ * adapter untouched. Callers branch to this helper only when `from`/`take` is
+ * present. The helper owns ORDER BY (sortColumn then idColumn as a unique
+ * tiebreaker), so the passed query must not be pre-ordered.
+ */
+export declare function isKeysetRequest(params?: ListParams): boolean;
+export interface KeysetOptions {
+    /** Column to sort by. Must be a real column on the queried table. */
+    sortColumn: string;
+    sortOrder: "asc" | "desc";
+    /** Unique tiebreaker column; defaults to "id". */
+    idColumn?: string;
+}
+export interface KeysetResult<Row> {
+    rows: Row[];
+    /** Page size actually applied. */
+    limit: number;
+    /** Opaque cursor for the next page; set only when more rows follow. */
+    next?: string;
+}
+export declare function keysetPaginate<DB, TB extends keyof DB, O>(query: SelectQueryBuilder<DB, TB, O>, params: ListParams | undefined, options: KeysetOptions): Promise<KeysetResult<O>>;

package/dist/types/src/outbox/create.d.ts

@@ -1,4 +1,11 @@
 import { Kysely } from "kysely";
 import { AuditEventInsert } from "@authhero/adapter-interfaces";
 import { Database } from "../db";
+/**
+ * Insert a single outbox event using the provided Kysely instance — which may
+ * be a transaction (`trx`). Shared by `createOutboxEvent` (standalone insert)
+ * and the user write adapters, which call it inside their own transaction so
+ * the event row commits together with the business row (issue #1057).
+ */
+export declare function insertOutboxEvent(db: Kysely<Database>, tenantId: string, id: string, event: AuditEventInsert): Promise<void>;
 export declare function createOutboxEvent(db: Kysely<Database>): (tenantId: string, event: AuditEventInsert) => Promise<string>;

package/dist/types/src/users/create.d.ts

@@ -1,4 +1,4 @@
 import { Kysely } from "kysely";
 import { Database } from "../db";
-import { User, UserInsert, CreateOptions } from "@authhero/adapter-interfaces";
-export declare function create(db: Kysely<Database>): (tenantId: string, user: UserInsert, options?: CreateOptions) => Promise<User>;
+import { User, UserInsert, CreateOptions, WriteOptions } from "@authhero/adapter-interfaces";
+export declare function create(db: Kysely<Database>): (tenantId: string, user: UserInsert, options?: CreateOptions & WriteOptions) => Promise<User>;

package/dist/types/src/users/remove.d.ts

@@ -1,3 +1,4 @@
 import { Kysely } from "kysely";
+import { WriteOptions } from "@authhero/adapter-interfaces";
 import { Database } from "../db";
-export declare function remove(db: Kysely<Database>): (tenant_id: string, user_id: string) => Promise<boolean>;
+export declare function remove(db: Kysely<Database>): (tenant_id: string, user_id: string, options?: WriteOptions) => Promise<boolean>;

package/dist/types/src/users/update.d.ts

@@ -1,4 +1,4 @@
-import { PostUsersBody, User } from "@authhero/adapter-interfaces";
+import { PostUsersBody, User, WriteOptions } from "@authhero/adapter-interfaces";
 import { Kysely } from "kysely";
 import { Database } from "../db";
-export declare function update(db: Kysely<Database>): (tenant_id: string, user_id: string, user: Partial<PostUsersBody> & Partial<Pick<User, "last_login" | "last_ip" | "login_count">>) => Promise<boolean>;
+export declare function update(db: Kysely<Database>): (tenant_id: string, user_id: string, user: Partial<PostUsersBody> & Partial<Pick<User, "last_login" | "last_ip" | "login_count">>, options?: WriteOptions) => Promise<boolean>;