@geekmidas/db 0.0.4 → 0.2.0

package/dist/kysely/pagination.d.mts

@@ -0,0 +1,78 @@
+import { SelectQueryBuilder } from "kysely";
+
+//#region src/kysely/pagination.d.ts
+
+/**
+ * Sort direction for cursor-based pagination.
+ */
+declare enum Direction {
+  Asc = "asc",
+  Desc = "desc",
+}
+/**
+ * Result of a paginated query.
+ */
+interface PaginationResult<TItem> {
+  items: TItem[];
+  pagination: {
+    total: number;
+    hasMore: boolean;
+    cursor?: string;
+  };
+}
+/**
+ * Options for paginated search.
+ */
+interface PaginatedSearchOptions<TRow, TMapRow extends (row: TRow) => unknown> {
+  /** The base Kysely query to paginate */
+  query: SelectQueryBuilder<any, any, TRow>;
+  /** Cursor value for pagination (value of cursorField from previous page) */
+  cursor?: string;
+  /** Maximum number of items per page (default: 20) */
+  limit?: number;
+  /** Function to transform each row to the output format */
+  mapRow: TMapRow;
+  /** Field to use for cursor pagination (default: 'id') */
+  cursorField?: string;
+  /** Sort direction for cursor field (default: Direction.Asc) */
+  cursorDirection?: Direction;
+}
+/**
+ * Generic paginated search function that handles:
+ * - Total count calculation
+ * - Cursor-based pagination
+ * - Fetching one extra row to determine hasMore
+ * - Mapping rows to output format
+ *
+ * @example
+ * ```typescript
+ * const result = await paginatedSearch({
+ *   query: db.selectFrom('users').selectAll(),
+ *   cursor: previousCursor,
+ *   limit: 20,
+ *   mapRow: (row) => ({ id: row.id, name: row.name }),
+ *   cursorField: 'id',
+ *   cursorDirection: Direction.Asc,
+ * });
+ * ```
+ */
+declare function paginatedSearch<TRow extends Record<string, unknown>, TMapRow extends (row: TRow) => unknown>({
+  query,
+  cursor,
+  limit,
+  mapRow,
+  cursorField,
+  cursorDirection
+}: PaginatedSearchOptions<TRow, TMapRow>): Promise<PaginationResult<Awaited<ReturnType<TMapRow>>>>;
+/**
+ * Encode a cursor value for safe URL transmission.
+ * Supports various types: string, number, Date, etc.
+ */
+declare function encodeCursor(value: unknown): string;
+/**
+ * Decode a cursor string back to its original value.
+ */
+declare function decodeCursor(cursor: string): unknown;
+//#endregion
+export { Direction, PaginatedSearchOptions, PaginationResult, decodeCursor, encodeCursor, paginatedSearch };
+//# sourceMappingURL=pagination.d.mts.map

package/dist/kysely/pagination.mjs

@@ -0,0 +1,79 @@
+//#region src/kysely/pagination.ts
+/**
+* Sort direction for cursor-based pagination.
+*/
+let Direction = /* @__PURE__ */ function(Direction$1) {
+	Direction$1["Asc"] = "asc";
+	Direction$1["Desc"] = "desc";
+	return Direction$1;
+}({});
+/**
+* Generic paginated search function that handles:
+* - Total count calculation
+* - Cursor-based pagination
+* - Fetching one extra row to determine hasMore
+* - Mapping rows to output format
+*
+* @example
+* ```typescript
+* const result = await paginatedSearch({
+*   query: db.selectFrom('users').selectAll(),
+*   cursor: previousCursor,
+*   limit: 20,
+*   mapRow: (row) => ({ id: row.id, name: row.name }),
+*   cursorField: 'id',
+*   cursorDirection: Direction.Asc,
+* });
+* ```
+*/
+async function paginatedSearch({ query, cursor, limit = 20, mapRow, cursorField = "id", cursorDirection = Direction.Asc }) {
+	const countResult = await query.clearSelect().clearOrderBy().select((eb) => eb.fn.countAll().as("count")).executeTakeFirstOrThrow();
+	const count = countResult.count;
+	let paginatedQuery = query;
+	if (cursor) {
+		const operator = cursorDirection === Direction.Asc ? ">" : "<";
+		paginatedQuery = paginatedQuery.where(cursorField, operator, cursor);
+	}
+	const data = await paginatedQuery.orderBy(cursorField, cursorDirection).limit(limit + 1).execute();
+	const hasMore = data.length > limit;
+	const rows = hasMore ? data.slice(0, limit) : data;
+	const lastRow = rows[rows.length - 1];
+	const nextCursor = hasMore && lastRow ? String(lastRow[cursorField]) : void 0;
+	const items = await Promise.all(rows.map(mapRow));
+	return {
+		items,
+		pagination: {
+			total: Number(count),
+			hasMore,
+			cursor: nextCursor
+		}
+	};
+}
+/**
+* Encode a cursor value for safe URL transmission.
+* Supports various types: string, number, Date, etc.
+*/
+function encodeCursor(value) {
+	const payload = {
+		v: value instanceof Date ? value.toISOString() : value,
+		t: value instanceof Date ? "date" : typeof value
+	};
+	return Buffer.from(JSON.stringify(payload)).toString("base64url");
+}
+/**
+* Decode a cursor string back to its original value.
+*/
+function decodeCursor(cursor) {
+	try {
+		const json = Buffer.from(cursor, "base64url").toString("utf-8");
+		const payload = JSON.parse(json);
+		if (payload.t === "date") return new Date(payload.v);
+		return payload.v;
+	} catch {
+		throw new Error("Invalid cursor format");
+	}
+}
+
+//#endregion
+export { Direction, decodeCursor, encodeCursor, paginatedSearch };
+//# sourceMappingURL=pagination.mjs.map

package/dist/kysely/pagination.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.mjs","names":["value: unknown","cursor: string"],"sources":["../../src/kysely/pagination.ts"],"sourcesContent":["import type { SelectQueryBuilder } from 'kysely';\n\n/**\n * Sort direction for cursor-based pagination.\n */\nexport enum Direction {\n  Asc = 'asc',\n  Desc = 'desc',\n}\n\n/**\n * Result of a paginated query.\n */\nexport interface PaginationResult<TItem> {\n  items: TItem[];\n  pagination: {\n    total: number;\n    hasMore: boolean;\n    cursor?: string;\n  };\n}\n\n/**\n * Options for paginated search.\n */\nexport interface PaginatedSearchOptions<\n  TRow,\n  TMapRow extends (row: TRow) => unknown,\n> {\n  /** The base Kysely query to paginate */\n  query: SelectQueryBuilder<any, any, TRow>;\n  /** Cursor value for pagination (value of cursorField from previous page) */\n  cursor?: string;\n  /** Maximum number of items per page (default: 20) */\n  limit?: number;\n  /** Function to transform each row to the output format */\n  mapRow: TMapRow;\n  /** Field to use for cursor pagination (default: 'id') */\n  cursorField?: string;\n  /** Sort direction for cursor field (default: Direction.Asc) */\n  cursorDirection?: Direction;\n}\n\n/**\n * Generic paginated search function that handles:\n * - Total count calculation\n * - Cursor-based pagination\n * - Fetching one extra row to determine hasMore\n * - Mapping rows to output format\n *\n * @example\n * ```typescript\n * const result = await paginatedSearch({\n *   query: db.selectFrom('users').selectAll(),\n *   cursor: previousCursor,\n *   limit: 20,\n *   mapRow: (row) => ({ id: row.id, name: row.name }),\n *   cursorField: 'id',\n *   cursorDirection: Direction.Asc,\n * });\n * ```\n */\nexport async function paginatedSearch<\n  TRow extends Record<string, unknown>,\n  TMapRow extends (row: TRow) => unknown,\n>({\n  query,\n  cursor,\n  limit = 20,\n  mapRow,\n  cursorField = 'id',\n  cursorDirection = Direction.Asc,\n}: PaginatedSearchOptions<TRow, TMapRow>): Promise<\n  PaginationResult<Awaited<ReturnType<TMapRow>>>\n> {\n  // Get total count (without cursor)\n  const countResult = await query\n    .clearSelect()\n    .clearOrderBy()\n    .select((eb) => eb.fn.countAll().as('count'))\n    .executeTakeFirstOrThrow();\n\n  const count = countResult.count;\n\n  // Apply cursor if provided\n  let paginatedQuery = query;\n  if (cursor) {\n    const operator = cursorDirection === Direction.Asc ? '>' : '<';\n    paginatedQuery = paginatedQuery.where(\n      cursorField as any,\n      operator,\n      cursor,\n    ) as typeof query;\n  }\n\n  // Fetch one extra to determine if there are more results\n  const data = await paginatedQuery\n    .orderBy(cursorField as any, cursorDirection)\n    .limit(limit + 1)\n    .execute();\n\n  const hasMore = data.length > limit;\n  const rows = hasMore ? data.slice(0, limit) : data;\n  const lastRow = rows[rows.length - 1];\n  const nextCursor =\n    hasMore && lastRow ? String(lastRow[cursorField]) : undefined;\n\n  const items = (await Promise.all(rows.map(mapRow))) as Awaited<\n    ReturnType<TMapRow>\n  >[];\n\n  return {\n    items,\n    pagination: {\n      total: Number(count),\n      hasMore,\n      cursor: nextCursor,\n    },\n  };\n}\n\n/**\n * Encode a cursor value for safe URL transmission.\n * Supports various types: string, number, Date, etc.\n */\nexport function encodeCursor(value: unknown): string {\n  const payload = {\n    v: value instanceof Date ? value.toISOString() : value,\n    t: value instanceof Date ? 'date' : typeof value,\n  };\n  return Buffer.from(JSON.stringify(payload)).toString('base64url');\n}\n\n/**\n * Decode a cursor string back to its original value.\n */\nexport function decodeCursor(cursor: string): unknown {\n  try {\n    const json = Buffer.from(cursor, 'base64url').toString('utf-8');\n    const payload = JSON.parse(json);\n\n    if (payload.t === 'date') {\n      return new Date(payload.v);\n    }\n\n    return payload.v;\n  } catch {\n    throw new Error('Invalid cursor format');\n  }\n}\n"],"mappings":";;;;AAKA,IAAY,kDAAL;AACL;AACA;;AACD;;;;;;;;;;;;;;;;;;;;AAsDD,eAAsB,gBAGpB,EACA,OACA,QACA,QAAQ,IACR,QACA,cAAc,MACd,kBAAkB,UAAU,KACU,EAEtC;CAEA,MAAM,cAAc,MAAM,MACvB,aAAa,CACb,cAAc,CACd,OAAO,CAAC,OAAO,GAAG,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,CAC5C,yBAAyB;CAE5B,MAAM,QAAQ,YAAY;CAG1B,IAAI,iBAAiB;AACrB,KAAI,QAAQ;EACV,MAAM,WAAW,oBAAoB,UAAU,MAAM,MAAM;AAC3D,mBAAiB,eAAe,MAC9B,aACA,UACA,OACD;CACF;CAGD,MAAM,OAAO,MAAM,eAChB,QAAQ,aAAoB,gBAAgB,CAC5C,MAAM,QAAQ,EAAE,CAChB,SAAS;CAEZ,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,OAAO,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG;CAC9C,MAAM,UAAU,KAAK,KAAK,SAAS;CACnC,MAAM,aACJ,WAAW,UAAU,OAAO,QAAQ,aAAa;CAEnD,MAAM,QAAS,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAO,CAAC;AAIlD,QAAO;EACL;EACA,YAAY;GACV,OAAO,OAAO,MAAM;GACpB;GACA,QAAQ;EACT;CACF;AACF;;;;;AAMD,SAAgB,aAAaA,OAAwB;CACnD,MAAM,UAAU;EACd,GAAG,iBAAiB,OAAO,MAAM,aAAa,GAAG;EACjD,GAAG,iBAAiB,OAAO,gBAAgB;CAC5C;AACD,QAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,CAAC,CAAC,SAAS,YAAY;AAClE;;;;AAKD,SAAgB,aAAaC,QAAyB;AACpD,KAAI;EACF,MAAM,OAAO,OAAO,KAAK,QAAQ,YAAY,CAAC,SAAS,QAAQ;EAC/D,MAAM,UAAU,KAAK,MAAM,KAAK;AAEhC,MAAI,QAAQ,MAAM,OAChB,QAAO,IAAI,KAAK,QAAQ;AAG1B,SAAO,QAAQ;CAChB,QAAO;AACN,QAAM,IAAI,MAAM;CACjB;AACF"}

package/dist/kysely-0FOi6ZdO.d.cts

@@ -0,0 +1,11 @@
+import { ControlledTransaction, IsolationLevel, Kysely, Transaction } from "kysely";
+
+//#region src/kysely.d.ts
+interface TransactionSettings {
+  isolationLevel?: IsolationLevel;
+}
+declare function withTransaction<DB, T>(db: DatabaseConnection<DB>, cb: (trx: Transaction<DB>) => Promise<T>, settings?: TransactionSettings): Promise<T>;
+type DatabaseConnection<T> = ControlledTransaction<T> | Kysely<T> | Transaction<T>;
+//#endregion
+export { DatabaseConnection, TransactionSettings, withTransaction };
+//# sourceMappingURL=kysely-0FOi6ZdO.d.cts.map

package/dist/kysely-8WPSKCZG.cjs

@@ -0,0 +1,17 @@
+
+//#region src/kysely.ts
+function withTransaction(db, cb, settings) {
+	if (db.isTransaction) return cb(db);
+	const builder = db.transaction();
+	if (settings?.isolationLevel) return builder.setIsolationLevel(settings.isolationLevel).execute(cb);
+	return builder.execute(cb);
+}
+
+//#endregion
+Object.defineProperty(exports, 'withTransaction', {
+  enumerable: true,
+  get: function () {
+    return withTransaction;
+  }
+});
+//# sourceMappingURL=kysely-8WPSKCZG.cjs.map

package/dist/kysely-8WPSKCZG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-8WPSKCZG.cjs","names":["db: DatabaseConnection<DB>","cb: (trx: Transaction<DB>) => Promise<T>","settings?: TransactionSettings"],"sources":["../src/kysely.ts"],"sourcesContent":["import type {\n  ControlledTransaction,\n  IsolationLevel,\n  Kysely,\n  Transaction,\n} from 'kysely';\n\nexport interface TransactionSettings {\n  isolationLevel?: IsolationLevel;\n}\n\nexport function withTransaction<DB, T>(\n  db: DatabaseConnection<DB>,\n  cb: (trx: Transaction<DB>) => Promise<T>,\n  settings?: TransactionSettings,\n): Promise<T> {\n  if (db.isTransaction) {\n    return cb(db as Transaction<DB>);\n  }\n\n  const builder = db.transaction();\n\n  if (settings?.isolationLevel) {\n    return builder.setIsolationLevel(settings.isolationLevel).execute(cb);\n  }\n\n  return builder.execute(cb);\n}\n\nexport type DatabaseConnection<T> =\n  | ControlledTransaction<T>\n  | Kysely<T>\n  | Transaction<T>;\n"],"mappings":";;AAWA,SAAgB,gBACdA,IACAC,IACAC,UACY;AACZ,KAAI,GAAG,cACL,QAAO,GAAG,GAAsB;CAGlC,MAAM,UAAU,GAAG,aAAa;AAEhC,KAAI,UAAU,eACZ,QAAO,QAAQ,kBAAkB,SAAS,eAAe,CAAC,QAAQ,GAAG;AAGvE,QAAO,QAAQ,QAAQ,GAAG;AAC3B"}

package/dist/kysely-Di1LVvL2.d.mts

@@ -0,0 +1,11 @@
+import { ControlledTransaction, IsolationLevel, Kysely, Transaction } from "kysely";
+
+//#region src/kysely.d.ts
+interface TransactionSettings {
+  isolationLevel?: IsolationLevel;
+}
+declare function withTransaction<DB, T>(db: DatabaseConnection<DB>, cb: (trx: Transaction<DB>) => Promise<T>, settings?: TransactionSettings): Promise<T>;
+type DatabaseConnection<T> = ControlledTransaction<T> | Kysely<T> | Transaction<T>;
+//#endregion
+export { DatabaseConnection, TransactionSettings, withTransaction };
+//# sourceMappingURL=kysely-Di1LVvL2.d.mts.map

package/dist/kysely-DmfA94RY.mjs

@@ -0,0 +1,11 @@
+//#region src/kysely.ts
+function withTransaction(db, cb, settings) {
+	if (db.isTransaction) return cb(db);
+	const builder = db.transaction();
+	if (settings?.isolationLevel) return builder.setIsolationLevel(settings.isolationLevel).execute(cb);
+	return builder.execute(cb);
+}
+
+//#endregion
+export { withTransaction };
+//# sourceMappingURL=kysely-DmfA94RY.mjs.map

package/dist/kysely-DmfA94RY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-DmfA94RY.mjs","names":["db: DatabaseConnection<DB>","cb: (trx: Transaction<DB>) => Promise<T>","settings?: TransactionSettings"],"sources":["../src/kysely.ts"],"sourcesContent":["import type {\n  ControlledTransaction,\n  IsolationLevel,\n  Kysely,\n  Transaction,\n} from 'kysely';\n\nexport interface TransactionSettings {\n  isolationLevel?: IsolationLevel;\n}\n\nexport function withTransaction<DB, T>(\n  db: DatabaseConnection<DB>,\n  cb: (trx: Transaction<DB>) => Promise<T>,\n  settings?: TransactionSettings,\n): Promise<T> {\n  if (db.isTransaction) {\n    return cb(db as Transaction<DB>);\n  }\n\n  const builder = db.transaction();\n\n  if (settings?.isolationLevel) {\n    return builder.setIsolationLevel(settings.isolationLevel).execute(cb);\n  }\n\n  return builder.execute(cb);\n}\n\nexport type DatabaseConnection<T> =\n  | ControlledTransaction<T>\n  | Kysely<T>\n  | Transaction<T>;\n"],"mappings":";AAWA,SAAgB,gBACdA,IACAC,IACAC,UACY;AACZ,KAAI,GAAG,cACL,QAAO,GAAG,GAAsB;CAGlC,MAAM,UAAU,GAAG,aAAa;AAEhC,KAAI,UAAU,eACZ,QAAO,QAAQ,kBAAkB,SAAS,eAAe,CAAC,QAAQ,GAAG;AAGvE,QAAO,QAAQ,QAAQ,GAAG;AAC3B"}

package/dist/kysely.cjs

@@ -1,9 +1,3 @@
+const require_kysely = require('./kysely-8WPSKCZG.cjs');
 
-//#region src/kysely.ts
-function withTransaction(db, cb) {
-	if (db.isTransaction) return cb(db);
-	return db.transaction().execute(cb);
-}
-
-//#endregion
-exports.withTransaction = withTransaction;
+exports.withTransaction = require_kysely.withTransaction;

package/dist/kysely.d.cts

@@ -1,7 +1,2 @@
-import { ControlledTransaction, Kysely, Transaction } from "kysely";
-
-//#region src/kysely.d.ts
-declare function withTransaction<DB, T>(db: DatabaseConnection<DB>, cb: (trx: Transaction<DB>) => Promise<T>): Promise<T>;
-type DatabaseConnection<T> = ControlledTransaction<T> | Kysely<T> | Transaction<T>;
-//#endregion
-export { DatabaseConnection, withTransaction };
+import { DatabaseConnection, TransactionSettings, withTransaction } from "./kysely-0FOi6ZdO.cjs";
+export { DatabaseConnection, TransactionSettings, withTransaction };

package/dist/kysely.d.mts

@@ -1,7 +1,2 @@
-import { ControlledTransaction, Kysely, Transaction } from "kysely";
-
-//#region src/kysely.d.ts
-declare function withTransaction<DB, T>(db: DatabaseConnection<DB>, cb: (trx: Transaction<DB>) => Promise<T>): Promise<T>;
-type DatabaseConnection<T> = ControlledTransaction<T> | Kysely<T> | Transaction<T>;
-//#endregion
-export { DatabaseConnection, withTransaction };
+import { DatabaseConnection, TransactionSettings, withTransaction } from "./kysely-Di1LVvL2.mjs";
+export { DatabaseConnection, TransactionSettings, withTransaction };

package/dist/kysely.mjs

@@ -1,8 +1,3 @@
-//#region src/kysely.ts
-function withTransaction(db, cb) {
-	if (db.isTransaction) return cb(db);
-	return db.transaction().execute(cb);
-}
+import { withTransaction } from "./kysely-DmfA94RY.mjs";
 
-//#endregion
 export { withTransaction };

package/dist/rls.cjs

@@ -0,0 +1,72 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const require_kysely = require('./kysely-8WPSKCZG.cjs');
+const kysely = __toESM(require("kysely"));
+
+//#region src/rls.ts
+/**
+* Execute a callback within a transaction with RLS context variables set.
+*
+* Sets PostgreSQL session variables using `SET LOCAL` which scopes them to the
+* current transaction. Variables are automatically cleared when the transaction
+* ends (commit or rollback).
+*
+* @example
+* ```ts
+* await withRlsContext(
+*   db,
+*   { user_id: session.userId, tenant_id: session.tenantId },
+*   async (trx) => {
+*     // RLS policies can now use current_setting('app.user_id')
+*     return trx.selectFrom('orders').selectAll().execute();
+*   }
+* );
+* ```
+*
+* @param db - Database connection (Kysely, Transaction, or ControlledTransaction)
+* @param context - Key-value pairs to set as session variables
+* @param callback - Function to execute within the RLS context
+* @param options - Optional prefix and transaction settings
+*/
+async function withRlsContext(db, context, callback, options) {
+	const prefix = options?.prefix ?? "app";
+	return require_kysely.withTransaction(db, async (trx) => {
+		for (const [key, value] of Object.entries(context)) {
+			if (value === null || value === void 0) continue;
+			const settingName = `${prefix}.${key}`;
+			const settingValue = String(value);
+			await kysely.sql`SELECT set_config(${settingName}, ${settingValue}, true)`.execute(trx);
+		}
+		return callback(trx);
+	}, options?.settings);
+}
+/**
+* Bypass marker symbol for explicitly skipping RLS context.
+*/
+const RLS_BYPASS = Symbol.for("geekmidas.rls.bypass");
+
+//#endregion
+exports.RLS_BYPASS = RLS_BYPASS;
+exports.withRlsContext = withRlsContext;
+//# sourceMappingURL=rls.cjs.map

package/dist/rls.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls.cjs","names":["db: DatabaseConnection<DB>","context: RlsContext","callback: (trx: Transaction<DB>) => Promise<T>","options?: WithRlsContextOptions"],"sources":["../src/rls.ts"],"sourcesContent":["import type { Transaction } from 'kysely';\nimport { sql } from 'kysely';\nimport {\n  type DatabaseConnection,\n  type TransactionSettings,\n  withTransaction,\n} from './kysely';\n\n/**\n * RLS context - key-value pairs to set as PostgreSQL session variables.\n * Keys become `prefix.key` (e.g., `app.user_id`).\n */\nexport interface RlsContext {\n  [key: string]: string | number | boolean | null | undefined;\n}\n\n/**\n * Options for withRlsContext function.\n */\nexport interface WithRlsContextOptions {\n  /** Prefix for PostgreSQL session variables (default: 'app') */\n  prefix?: string;\n  /** Transaction settings (isolation level) */\n  settings?: TransactionSettings;\n}\n\n/**\n * Execute a callback within a transaction with RLS context variables set.\n *\n * Sets PostgreSQL session variables using `SET LOCAL` which scopes them to the\n * current transaction. Variables are automatically cleared when the transaction\n * ends (commit or rollback).\n *\n * @example\n * ```ts\n * await withRlsContext(\n *   db,\n *   { user_id: session.userId, tenant_id: session.tenantId },\n *   async (trx) => {\n *     // RLS policies can now use current_setting('app.user_id')\n *     return trx.selectFrom('orders').selectAll().execute();\n *   }\n * );\n * ```\n *\n * @param db - Database connection (Kysely, Transaction, or ControlledTransaction)\n * @param context - Key-value pairs to set as session variables\n * @param callback - Function to execute within the RLS context\n * @param options - Optional prefix and transaction settings\n */\nexport async function withRlsContext<DB, T>(\n  db: DatabaseConnection<DB>,\n  context: RlsContext,\n  callback: (trx: Transaction<DB>) => Promise<T>,\n  options?: WithRlsContextOptions,\n): Promise<T> {\n  const prefix = options?.prefix ?? 'app';\n\n  return withTransaction(\n    db,\n    async (trx) => {\n      // Set each context variable using SET LOCAL (scoped to transaction)\n      for (const [key, value] of Object.entries(context)) {\n        if (value === null || value === undefined) continue;\n\n        const settingName = `${prefix}.${key}`;\n        const settingValue = String(value);\n\n        // Use raw SQL for SET LOCAL with proper escaping\n        // The setting name is an identifier, value is a string literal\n        await sql`SELECT set_config(${settingName}, ${settingValue}, true)`.execute(\n          trx,\n        );\n      }\n\n      return callback(trx);\n    },\n    options?.settings,\n  );\n}\n\n/**\n * Bypass marker symbol for explicitly skipping RLS context.\n */\nexport const RLS_BYPASS = Symbol.for('geekmidas.rls.bypass');\n\n/**\n * Type for RLS bypass marker.\n */\nexport type RlsBypass = typeof RLS_BYPASS;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,eAAsB,eACpBA,IACAC,SACAC,UACAC,SACY;CACZ,MAAM,SAAS,SAAS,UAAU;AAElC,QAAO,+BACL,IACA,OAAO,QAAQ;AAEb,OAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,QAAQ,EAAE;AAClD,OAAI,UAAU,QAAQ,iBAAqB;GAE3C,MAAM,eAAe,EAAE,OAAO,GAAG,IAAI;GACrC,MAAM,eAAe,OAAO,MAAM;AAIlC,SAAM,WAAI,oBAAoB,YAAY,IAAI,aAAa,SAAS,QAClE,IACD;EACF;AAED,SAAO,SAAS,IAAI;CACrB,GACD,SAAS,SACV;AACF;;;;AAKD,MAAa,aAAa,OAAO,IAAI,uBAAuB"}

package/dist/rls.d.cts

@@ -0,0 +1,57 @@
+import { DatabaseConnection, TransactionSettings } from "./kysely-0FOi6ZdO.cjs";
+import { Transaction } from "kysely";
+
+//#region src/rls.d.ts
+
+/**
+ * RLS context - key-value pairs to set as PostgreSQL session variables.
+ * Keys become `prefix.key` (e.g., `app.user_id`).
+ */
+interface RlsContext {
+  [key: string]: string | number | boolean | null | undefined;
+}
+/**
+ * Options for withRlsContext function.
+ */
+interface WithRlsContextOptions {
+  /** Prefix for PostgreSQL session variables (default: 'app') */
+  prefix?: string;
+  /** Transaction settings (isolation level) */
+  settings?: TransactionSettings;
+}
+/**
+ * Execute a callback within a transaction with RLS context variables set.
+ *
+ * Sets PostgreSQL session variables using `SET LOCAL` which scopes them to the
+ * current transaction. Variables are automatically cleared when the transaction
+ * ends (commit or rollback).
+ *
+ * @example
+ * ```ts
+ * await withRlsContext(
+ *   db,
+ *   { user_id: session.userId, tenant_id: session.tenantId },
+ *   async (trx) => {
+ *     // RLS policies can now use current_setting('app.user_id')
+ *     return trx.selectFrom('orders').selectAll().execute();
+ *   }
+ * );
+ * ```
+ *
+ * @param db - Database connection (Kysely, Transaction, or ControlledTransaction)
+ * @param context - Key-value pairs to set as session variables
+ * @param callback - Function to execute within the RLS context
+ * @param options - Optional prefix and transaction settings
+ */
+declare function withRlsContext<DB, T>(db: DatabaseConnection<DB>, context: RlsContext, callback: (trx: Transaction<DB>) => Promise<T>, options?: WithRlsContextOptions): Promise<T>;
+/**
+ * Bypass marker symbol for explicitly skipping RLS context.
+ */
+declare const RLS_BYPASS: unique symbol;
+/**
+ * Type for RLS bypass marker.
+ */
+type RlsBypass = typeof RLS_BYPASS;
+//#endregion
+export { RLS_BYPASS, RlsBypass, RlsContext, WithRlsContextOptions, withRlsContext };
+//# sourceMappingURL=rls.d.cts.map

package/dist/rls.d.mts

@@ -0,0 +1,57 @@
+import { DatabaseConnection, TransactionSettings } from "./kysely-Di1LVvL2.mjs";
+import { Transaction } from "kysely";
+
+//#region src/rls.d.ts
+
+/**
+ * RLS context - key-value pairs to set as PostgreSQL session variables.
+ * Keys become `prefix.key` (e.g., `app.user_id`).
+ */
+interface RlsContext {
+  [key: string]: string | number | boolean | null | undefined;
+}
+/**
+ * Options for withRlsContext function.
+ */
+interface WithRlsContextOptions {
+  /** Prefix for PostgreSQL session variables (default: 'app') */
+  prefix?: string;
+  /** Transaction settings (isolation level) */
+  settings?: TransactionSettings;
+}
+/**
+ * Execute a callback within a transaction with RLS context variables set.
+ *
+ * Sets PostgreSQL session variables using `SET LOCAL` which scopes them to the
+ * current transaction. Variables are automatically cleared when the transaction
+ * ends (commit or rollback).
+ *
+ * @example
+ * ```ts
+ * await withRlsContext(
+ *   db,
+ *   { user_id: session.userId, tenant_id: session.tenantId },
+ *   async (trx) => {
+ *     // RLS policies can now use current_setting('app.user_id')
+ *     return trx.selectFrom('orders').selectAll().execute();
+ *   }
+ * );
+ * ```
+ *
+ * @param db - Database connection (Kysely, Transaction, or ControlledTransaction)
+ * @param context - Key-value pairs to set as session variables
+ * @param callback - Function to execute within the RLS context
+ * @param options - Optional prefix and transaction settings
+ */
+declare function withRlsContext<DB, T>(db: DatabaseConnection<DB>, context: RlsContext, callback: (trx: Transaction<DB>) => Promise<T>, options?: WithRlsContextOptions): Promise<T>;
+/**
+ * Bypass marker symbol for explicitly skipping RLS context.
+ */
+declare const RLS_BYPASS: unique symbol;
+/**
+ * Type for RLS bypass marker.
+ */
+type RlsBypass = typeof RLS_BYPASS;
+//#endregion
+export { RLS_BYPASS, RlsBypass, RlsContext, WithRlsContextOptions, withRlsContext };
+//# sourceMappingURL=rls.d.mts.map

package/dist/rls.mjs

@@ -0,0 +1,48 @@
+import { withTransaction } from "./kysely-DmfA94RY.mjs";
+import { sql } from "kysely";
+
+//#region src/rls.ts
+/**
+* Execute a callback within a transaction with RLS context variables set.
+*
+* Sets PostgreSQL session variables using `SET LOCAL` which scopes them to the
+* current transaction. Variables are automatically cleared when the transaction
+* ends (commit or rollback).
+*
+* @example
+* ```ts
+* await withRlsContext(
+*   db,
+*   { user_id: session.userId, tenant_id: session.tenantId },
+*   async (trx) => {
+*     // RLS policies can now use current_setting('app.user_id')
+*     return trx.selectFrom('orders').selectAll().execute();
+*   }
+* );
+* ```
+*
+* @param db - Database connection (Kysely, Transaction, or ControlledTransaction)
+* @param context - Key-value pairs to set as session variables
+* @param callback - Function to execute within the RLS context
+* @param options - Optional prefix and transaction settings
+*/
+async function withRlsContext(db, context, callback, options) {
+	const prefix = options?.prefix ?? "app";
+	return withTransaction(db, async (trx) => {
+		for (const [key, value] of Object.entries(context)) {
+			if (value === null || value === void 0) continue;
+			const settingName = `${prefix}.${key}`;
+			const settingValue = String(value);
+			await sql`SELECT set_config(${settingName}, ${settingValue}, true)`.execute(trx);
+		}
+		return callback(trx);
+	}, options?.settings);
+}
+/**
+* Bypass marker symbol for explicitly skipping RLS context.
+*/
+const RLS_BYPASS = Symbol.for("geekmidas.rls.bypass");
+
+//#endregion
+export { RLS_BYPASS, withRlsContext };
+//# sourceMappingURL=rls.mjs.map

package/dist/rls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls.mjs","names":["db: DatabaseConnection<DB>","context: RlsContext","callback: (trx: Transaction<DB>) => Promise<T>","options?: WithRlsContextOptions"],"sources":["../src/rls.ts"],"sourcesContent":["import type { Transaction } from 'kysely';\nimport { sql } from 'kysely';\nimport {\n  type DatabaseConnection,\n  type TransactionSettings,\n  withTransaction,\n} from './kysely';\n\n/**\n * RLS context - key-value pairs to set as PostgreSQL session variables.\n * Keys become `prefix.key` (e.g., `app.user_id`).\n */\nexport interface RlsContext {\n  [key: string]: string | number | boolean | null | undefined;\n}\n\n/**\n * Options for withRlsContext function.\n */\nexport interface WithRlsContextOptions {\n  /** Prefix for PostgreSQL session variables (default: 'app') */\n  prefix?: string;\n  /** Transaction settings (isolation level) */\n  settings?: TransactionSettings;\n}\n\n/**\n * Execute a callback within a transaction with RLS context variables set.\n *\n * Sets PostgreSQL session variables using `SET LOCAL` which scopes them to the\n * current transaction. Variables are automatically cleared when the transaction\n * ends (commit or rollback).\n *\n * @example\n * ```ts\n * await withRlsContext(\n *   db,\n *   { user_id: session.userId, tenant_id: session.tenantId },\n *   async (trx) => {\n *     // RLS policies can now use current_setting('app.user_id')\n *     return trx.selectFrom('orders').selectAll().execute();\n *   }\n * );\n * ```\n *\n * @param db - Database connection (Kysely, Transaction, or ControlledTransaction)\n * @param context - Key-value pairs to set as session variables\n * @param callback - Function to execute within the RLS context\n * @param options - Optional prefix and transaction settings\n */\nexport async function withRlsContext<DB, T>(\n  db: DatabaseConnection<DB>,\n  context: RlsContext,\n  callback: (trx: Transaction<DB>) => Promise<T>,\n  options?: WithRlsContextOptions,\n): Promise<T> {\n  const prefix = options?.prefix ?? 'app';\n\n  return withTransaction(\n    db,\n    async (trx) => {\n      // Set each context variable using SET LOCAL (scoped to transaction)\n      for (const [key, value] of Object.entries(context)) {\n        if (value === null || value === undefined) continue;\n\n        const settingName = `${prefix}.${key}`;\n        const settingValue = String(value);\n\n        // Use raw SQL for SET LOCAL with proper escaping\n        // The setting name is an identifier, value is a string literal\n        await sql`SELECT set_config(${settingName}, ${settingValue}, true)`.execute(\n          trx,\n        );\n      }\n\n      return callback(trx);\n    },\n    options?.settings,\n  );\n}\n\n/**\n * Bypass marker symbol for explicitly skipping RLS context.\n */\nexport const RLS_BYPASS = Symbol.for('geekmidas.rls.bypass');\n\n/**\n * Type for RLS bypass marker.\n */\nexport type RlsBypass = typeof RLS_BYPASS;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,eAAsB,eACpBA,IACAC,SACAC,UACAC,SACY;CACZ,MAAM,SAAS,SAAS,UAAU;AAElC,QAAO,gBACL,IACA,OAAO,QAAQ;AAEb,OAAK,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,QAAQ,QAAQ,EAAE;AAClD,OAAI,UAAU,QAAQ,iBAAqB;GAE3C,MAAM,eAAe,EAAE,OAAO,GAAG,IAAI;GACrC,MAAM,eAAe,OAAO,MAAM;AAIlC,SAAM,IAAI,oBAAoB,YAAY,IAAI,aAAa,SAAS,QAClE,IACD;EACF;AAED,SAAO,SAAS,IAAI;CACrB,GACD,SAAS,SACV;AACF;;;;AAKD,MAAa,aAAa,OAAO,IAAI,uBAAuB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/db",
-  "version": "0.0.4",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -8,6 +8,16 @@
       "types": "./dist/kysely.d.ts",
       "import": "./dist/kysely.mjs",
       "require": "./dist/kysely.cjs"
+    },
+    "./kysely/pagination": {
+      "types": "./dist/kysely/pagination.d.ts",
+      "import": "./dist/kysely/pagination.mjs",
+      "require": "./dist/kysely/pagination.cjs"
+    },
+    "./rls": {
+      "types": "./dist/rls.d.ts",
+      "import": "./dist/rls.mjs",
+      "require": "./dist/rls.cjs"
     }
   },
   "dependencies": {
@@ -16,6 +26,10 @@
   "devDependencies": {
     "@types/pg": "~8.15.4"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geekmidas/toolbox"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -27,5 +41,8 @@
     "objection": "~3.1.5",
     "db-errors": "~0.2.3",
     "vitest": "~3.2.4"
+  },
+  "scripts": {
+    "ts": "tsc --noEmit --skipLibCheck src/**/*.ts"
   }
 }