@geekmidas/db 0.2.0 → 0.3.0

package/src/kysely/pagination.ts

@@ -4,41 +4,41 @@ import type { SelectQueryBuilder } from 'kysely';
  * Sort direction for cursor-based pagination.
  */
 export enum Direction {
-  Asc = 'asc',
-  Desc = 'desc',
+	Asc = 'asc',
+	Desc = 'desc',
 }
 
 /**
  * Result of a paginated query.
  */
 export interface PaginationResult<TItem> {
-  items: TItem[];
-  pagination: {
-    total: number;
-    hasMore: boolean;
-    cursor?: string;
-  };
+	items: TItem[];
+	pagination: {
+		total: number;
+		hasMore: boolean;
+		cursor?: string;
+	};
 }
 
 /**
  * Options for paginated search.
  */
 export interface PaginatedSearchOptions<
-  TRow,
-  TMapRow extends (row: TRow) => unknown,
+	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;
+	/** 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;
 }
 
 /**
@@ -61,62 +61,62 @@ export interface PaginatedSearchOptions<
  * ```
  */
 export async function paginatedSearch<
-  TRow extends Record<string, unknown>,
-  TMapRow extends (row: TRow) => unknown,
+	TRow extends Record<string, unknown>,
+	TMapRow extends (row: TRow) => unknown,
 >({
-  query,
-  cursor,
-  limit = 20,
-  mapRow,
-  cursorField = 'id',
-  cursorDirection = Direction.Asc,
+	query,
+	cursor,
+	limit = 20,
+	mapRow,
+	cursorField = 'id',
+	cursorDirection = Direction.Asc,
 }: PaginatedSearchOptions<TRow, TMapRow>): Promise<
-  PaginationResult<Awaited<ReturnType<TMapRow>>>
+	PaginationResult<Awaited<ReturnType<TMapRow>>>
 > {
-  // Get total count (without cursor)
-  const countResult = await query
-    .clearSelect()
-    .clearOrderBy()
-    .select((eb) => eb.fn.countAll().as('count'))
-    .executeTakeFirstOrThrow();
+	// Get total count (without cursor)
+	const countResult = await query
+		.clearSelect()
+		.clearOrderBy()
+		.select((eb) => eb.fn.countAll().as('count'))
+		.executeTakeFirstOrThrow();
 
-  const count = countResult.count;
+	const count = countResult.count;
 
-  // Apply cursor if provided
-  let paginatedQuery = query;
-  if (cursor) {
-    const operator = cursorDirection === Direction.Asc ? '>' : '<';
-    paginatedQuery = paginatedQuery.where(
-      cursorField as any,
-      operator,
-      cursor,
-    ) as typeof query;
-  }
+	// Apply cursor if provided
+	let paginatedQuery = query;
+	if (cursor) {
+		const operator = cursorDirection === Direction.Asc ? '>' : '<';
+		paginatedQuery = paginatedQuery.where(
+			cursorField as any,
+			operator,
+			cursor,
+		) as typeof query;
+	}
 
-  // Fetch one extra to determine if there are more results
-  const data = await paginatedQuery
-    .orderBy(cursorField as any, cursorDirection)
-    .limit(limit + 1)
-    .execute();
+	// Fetch one extra to determine if there are more results
+	const data = await paginatedQuery
+		.orderBy(cursorField as any, 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]) : undefined;
+	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]) : undefined;
 
-  const items = (await Promise.all(rows.map(mapRow))) as Awaited<
-    ReturnType<TMapRow>
-  >[];
+	const items = (await Promise.all(rows.map(mapRow))) as Awaited<
+		ReturnType<TMapRow>
+	>[];
 
-  return {
-    items,
-    pagination: {
-      total: Number(count),
-      hasMore,
-      cursor: nextCursor,
-    },
-  };
+	return {
+		items,
+		pagination: {
+			total: Number(count),
+			hasMore,
+			cursor: nextCursor,
+		},
+	};
 }
 
 /**
@@ -124,27 +124,27 @@ export async function paginatedSearch<
  * Supports various types: string, number, Date, etc.
  */
 export function encodeCursor(value: unknown): string {
-  const payload = {
-    v: value instanceof Date ? value.toISOString() : value,
-    t: value instanceof Date ? 'date' : typeof value,
-  };
-  return Buffer.from(JSON.stringify(payload)).toString('base64url');
+	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.
  */
 export function decodeCursor(cursor: string): unknown {
-  try {
-    const json = Buffer.from(cursor, 'base64url').toString('utf-8');
-    const payload = JSON.parse(json);
+	try {
+		const json = Buffer.from(cursor, 'base64url').toString('utf-8');
+		const payload = JSON.parse(json);
 
-    if (payload.t === 'date') {
-      return new Date(payload.v);
-    }
+		if (payload.t === 'date') {
+			return new Date(payload.v);
+		}
 
-    return payload.v;
-  } catch {
-    throw new Error('Invalid cursor format');
-  }
+		return payload.v;
+	} catch {
+		throw new Error('Invalid cursor format');
+	}
 }

package/src/kysely.ts

@@ -1,33 +1,33 @@
 import type {
-  ControlledTransaction,
-  IsolationLevel,
-  Kysely,
-  Transaction,
+	ControlledTransaction,
+	IsolationLevel,
+	Kysely,
+	Transaction,
 } from 'kysely';
 
 export interface TransactionSettings {
-  isolationLevel?: IsolationLevel;
+	isolationLevel?: IsolationLevel;
 }
 
 export function withTransaction<DB, T>(
-  db: DatabaseConnection<DB>,
-  cb: (trx: Transaction<DB>) => Promise<T>,
-  settings?: TransactionSettings,
+	db: DatabaseConnection<DB>,
+	cb: (trx: Transaction<DB>) => Promise<T>,
+	settings?: TransactionSettings,
 ): Promise<T> {
-  if (db.isTransaction) {
-    return cb(db as Transaction<DB>);
-  }
+	if (db.isTransaction) {
+		return cb(db as Transaction<DB>);
+	}
 
-  const builder = db.transaction();
+	const builder = db.transaction();
 
-  if (settings?.isolationLevel) {
-    return builder.setIsolationLevel(settings.isolationLevel).execute(cb);
-  }
+	if (settings?.isolationLevel) {
+		return builder.setIsolationLevel(settings.isolationLevel).execute(cb);
+	}
 
-  return builder.execute(cb);
+	return builder.execute(cb);
 }
 
 export type DatabaseConnection<T> =
-  | ControlledTransaction<T>
-  | Kysely<T>
-  | Transaction<T>;
+	| ControlledTransaction<T>
+	| Kysely<T>
+	| Transaction<T>;

package/src/rls.ts

@@ -1,9 +1,9 @@
 import type { Transaction } from 'kysely';
 import { sql } from 'kysely';
 import {
-  type DatabaseConnection,
-  type TransactionSettings,
-  withTransaction,
+	type DatabaseConnection,
+	type TransactionSettings,
+	withTransaction,
 } from './kysely';
 
 /**
@@ -11,17 +11,17 @@ import {
  * Keys become `prefix.key` (e.g., `app.user_id`).
  */
 export interface RlsContext {
-  [key: string]: string | number | boolean | null | undefined;
+	[key: string]: string | number | boolean | null | undefined;
 }
 
 /**
  * Options for withRlsContext function.
  */
 export interface WithRlsContextOptions {
-  /** Prefix for PostgreSQL session variables (default: 'app') */
-  prefix?: string;
-  /** Transaction settings (isolation level) */
-  settings?: TransactionSettings;
+	/** Prefix for PostgreSQL session variables (default: 'app') */
+	prefix?: string;
+	/** Transaction settings (isolation level) */
+	settings?: TransactionSettings;
 }
 
 /**
@@ -49,34 +49,34 @@ export interface WithRlsContextOptions {
  * @param options - Optional prefix and transaction settings
  */
 export async function withRlsContext<DB, T>(
-  db: DatabaseConnection<DB>,
-  context: RlsContext,
-  callback: (trx: Transaction<DB>) => Promise<T>,
-  options?: WithRlsContextOptions,
+	db: DatabaseConnection<DB>,
+	context: RlsContext,
+	callback: (trx: Transaction<DB>) => Promise<T>,
+	options?: WithRlsContextOptions,
 ): Promise<T> {
-  const prefix = options?.prefix ?? 'app';
+	const prefix = options?.prefix ?? 'app';
 
-  return withTransaction(
-    db,
-    async (trx) => {
-      // Set each context variable using SET LOCAL (scoped to transaction)
-      for (const [key, value] of Object.entries(context)) {
-        if (value === null || value === undefined) continue;
+	return withTransaction(
+		db,
+		async (trx) => {
+			// Set each context variable using SET LOCAL (scoped to transaction)
+			for (const [key, value] of Object.entries(context)) {
+				if (value === null || value === undefined) continue;
 
-        const settingName = `${prefix}.${key}`;
-        const settingValue = String(value);
+				const settingName = `${prefix}.${key}`;
+				const settingValue = String(value);
 
-        // Use raw SQL for SET LOCAL with proper escaping
-        // The setting name is an identifier, value is a string literal
-        await sql`SELECT set_config(${settingName}, ${settingValue}, true)`.execute(
-          trx,
-        );
-      }
+				// Use raw SQL for SET LOCAL with proper escaping
+				// The setting name is an identifier, value is a string literal
+				await sql`SELECT set_config(${settingName}, ${settingValue}, true)`.execute(
+					trx,
+				);
+			}
 
-      return callback(trx);
-    },
-    options?.settings,
-  );
+			return callback(trx);
+		},
+		options?.settings,
+	);
 }
 
 /**

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "composite": true
+  },
+  "include": ["src/**/*"]
+}