@truto/ginger 1.0.0

package/dist/pagination.d.ts

@@ -0,0 +1,31 @@
+import { sql } from '@truto/sqlite-builder';
+import type { CursorToken, OrderBy } from './types.js';
+/**
+ * Encode a cursor token to an opaque base64 string
+ */
+export declare function encodeCursor(token: CursorToken): string;
+/**
+ * Decode an opaque cursor string back to a cursor token
+ */
+export declare function decodeCursor(cursor: string): CursorToken;
+/**
+ * Create a cursor token from a row and order specification
+ */
+export declare function createCursor(row: Record<string, unknown>, orderBy: OrderBy[], direction: 'next' | 'prev'): CursorToken;
+/**
+ * Generate WHERE conditions for cursor-based pagination
+ */
+export declare function buildCursorConditions(cursor: CursorToken, tableName?: string): ReturnType<typeof sql>;
+/**
+ * Get default ordering for a table
+ */
+export declare function getDefaultOrderBy(primaryKey: string | string[], defaultOrderBy?: OrderBy): OrderBy[];
+/**
+ * Validate order by columns against allowed columns
+ */
+export declare function validateOrderBy(orderBy: OrderBy[], allowedColumns: string[]): void;
+/**
+ * Reverse the direction of OrderBy for previous page navigation
+ */
+export declare function reverseOrderBy(orderBy: OrderBy[]): OrderBy[];
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAUvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA0CxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,OAAO,EAAE,EAClB,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,WAAW,CAiBb;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU,CAAC,OAAO,GAAG,CAAC,CAiFxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,EAAE,CAUX;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAAE,EAClB,cAAc,EAAE,MAAM,EAAE,GACvB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAK5D"}

package/dist/pagination.js

@@ -0,0 +1,173 @@
+import { sql } from '@truto/sqlite-builder';
+import { CursorError } from './errors.js';
+/**
+ * Encode a cursor token to an opaque base64 string
+ */
+export function encodeCursor(token) {
+    try {
+        const json = JSON.stringify(token);
+        return btoa(json);
+    }
+    catch (error) {
+        throw new CursorError(`Failed to encode cursor: ${error instanceof Error ? error.message : 'Unknown error'}`, { token, error });
+    }
+}
+/**
+ * Decode an opaque cursor string back to a cursor token
+ */
+export function decodeCursor(cursor) {
+    try {
+        const json = atob(cursor);
+        const parsed = JSON.parse(json);
+        // Validate cursor structure
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error('Invalid cursor structure');
+        }
+        if (!Array.isArray(parsed.orderBy)) {
+            throw new Error('Invalid orderBy in cursor');
+        }
+        if (!Array.isArray(parsed.values)) {
+            throw new Error('Invalid values in cursor');
+        }
+        if (!parsed.direction || !['next', 'prev'].includes(parsed.direction)) {
+            throw new Error('Invalid direction in cursor');
+        }
+        // Validate orderBy structure
+        for (const order of parsed.orderBy) {
+            if (!order || typeof order !== 'object') {
+                throw new Error('Invalid order object in cursor');
+            }
+            if (!order.column || typeof order.column !== 'string') {
+                throw new Error('Invalid column in cursor orderBy');
+            }
+            if (!order.direction || !['asc', 'desc'].includes(order.direction)) {
+                throw new Error('Invalid direction in cursor orderBy');
+            }
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new CursorError(`Failed to decode cursor: ${error instanceof Error ? error.message : 'Unknown error'}`, { cursor, error });
+    }
+}
+/**
+ * Create a cursor token from a row and order specification
+ */
+export function createCursor(row, orderBy, direction) {
+    const values = orderBy.map((order) => {
+        const value = row[order.column];
+        if (value === undefined) {
+            throw new CursorError(`Column "${order.column}" not found in row for cursor creation`, { row, orderBy, column: order.column });
+        }
+        return value;
+    });
+    return {
+        orderBy,
+        values,
+        direction,
+    };
+}
+/**
+ * Generate WHERE conditions for cursor-based pagination
+ */
+export function buildCursorConditions(cursor, tableName) {
+    const { orderBy, values, direction } = cursor;
+    if (orderBy.length !== values.length) {
+        throw new CursorError('Cursor orderBy and values arrays must have the same length', { orderBy, values });
+    }
+    if (orderBy.length === 0) {
+        return sql ``;
+    }
+    // Build comparison conditions for cursor pagination
+    // For next: use > or < based on sort direction
+    // For prev: use < or > based on sort direction (opposite)
+    const conditions = [];
+    for (let i = 0; i < orderBy.length; i++) {
+        const order = orderBy[i];
+        const value = values[i];
+        // Build column identifier safely
+        const columnIdent = tableName
+            ? sql.ident(`${tableName}.${order.column}`)
+            : sql.ident(order.column);
+        // Determine comparison operator
+        let operator;
+        if (direction === 'next') {
+            operator = order.direction === 'asc' ? '>' : '<';
+        }
+        else {
+            operator = order.direction === 'asc' ? '<' : '>';
+        }
+        if (i === orderBy.length - 1) {
+            // Last column: simple comparison
+            const operatorFragment = sql.raw(operator);
+            conditions.push(sql `${columnIdent} ${operatorFragment} ${value}`);
+        }
+        else {
+            // Multi-column: build composite condition
+            // (col1 = ? AND col2 = ? AND ... AND colN > ?) OR
+            // (col1 = ? AND col2 = ? AND ... AND colN-1 > ?) OR
+            // ...
+            // (col1 > ?)
+            const equalityConditions = [];
+            for (let j = 0; j <= i; j++) {
+                const currentOrder = orderBy[j];
+                const currentValue = values[j];
+                // Build current column identifier safely
+                const currentColumnIdent = tableName
+                    ? sql.ident(`${tableName}.${currentOrder.column}`)
+                    : sql.ident(currentOrder.column);
+                if (j === i) {
+                    // Last condition in this group: use comparison
+                    let currentOperator;
+                    if (direction === 'next') {
+                        currentOperator = currentOrder.direction === 'asc' ? '>' : '<';
+                    }
+                    else {
+                        currentOperator = currentOrder.direction === 'asc' ? '<' : '>';
+                    }
+                    const currentOperatorFragment = sql.raw(currentOperator);
+                    equalityConditions.push(sql `${currentColumnIdent} ${currentOperatorFragment} ${currentValue}`);
+                }
+                else {
+                    // Earlier conditions: use equality
+                    equalityConditions.push(sql `${currentColumnIdent} = ${currentValue}`);
+                }
+            }
+            const compositeCondition = sql.join(equalityConditions, ' AND ');
+            conditions.push(sql `(${compositeCondition})`);
+        }
+    }
+    return conditions.length > 0 ? sql.join(conditions, ' OR ') : sql ``;
+}
+/**
+ * Get default ordering for a table
+ */
+export function getDefaultOrderBy(primaryKey, defaultOrderBy) {
+    if (defaultOrderBy) {
+        return [defaultOrderBy];
+    }
+    if (Array.isArray(primaryKey)) {
+        return primaryKey.map((key) => ({ column: key, direction: 'asc' }));
+    }
+    return [{ column: primaryKey, direction: 'asc' }];
+}
+/**
+ * Validate order by columns against allowed columns
+ */
+export function validateOrderBy(orderBy, allowedColumns) {
+    for (const order of orderBy) {
+        if (!allowedColumns.includes(order.column)) {
+            throw new CursorError(`Invalid order column "${order.column}". Allowed columns: ${allowedColumns.join(', ')}`, { column: order.column, allowedColumns });
+        }
+    }
+}
+/**
+ * Reverse the direction of OrderBy for previous page navigation
+ */
+export function reverseOrderBy(orderBy) {
+    return orderBy.map((order) => ({
+        ...order,
+        direction: order.direction === 'asc' ? 'desc' : 'asc',
+    }));
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"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"}

package/dist/service.d.ts

@@ -0,0 +1,81 @@
+import type { z } from 'zod/v4';
+import type { BaseCtx, BaseService, ComputeJoins, CountParams, CreateParams, Database, DeleteParams, GetParams, JoinDef, KeyProvider, ListParams, ListResult, MethodOptions, OrderBy, QueryParams, SecretFieldDef, ServiceOptions, UpdateParams } from './types.js';
+/**
+ * Main service class that provides type-safe data access for SQLite databases
+ */
+export declare class Service<TRow extends z.ZodTypeAny, TCreate extends z.ZodTypeAny, TUpdate extends z.ZodTypeAny, TJoins extends Record<string, JoinDef>, TSecrets extends readonly SecretFieldDef[] | undefined> implements BaseService<TRow, TCreate, TUpdate, TJoins, TSecrets> {
+    readonly table: string;
+    readonly db: Database;
+    readonly rowSchema: TRow;
+    readonly createSchema: TCreate;
+    readonly updateSchema: TUpdate;
+    readonly joins: TJoins | undefined;
+    readonly secrets: TSecrets | undefined;
+    readonly primaryKey: string | string[];
+    readonly defaultOrderBy: OrderBy | undefined;
+    readonly keyProvider: KeyProvider;
+    readonly deps: Record<string, BaseService<any, any, any, any, any>>;
+    private readonly hooks;
+    constructor(options: ServiceOptions<TRow, TCreate, TUpdate, TJoins, TSecrets>);
+    /**
+     * List records with cursor-based pagination
+     */
+    list(params?: ListParams & MethodOptions): Promise<ListResult<z.infer<TRow> & ComputeJoins<TJoins, ListParams['include']>>>;
+    /**
+     * Get a single record by ID
+     */
+    get(id: string | number, opts?: GetParams & MethodOptions): Promise<(z.infer<TRow> & ComputeJoins<TJoins, GetParams['include']>) | null>;
+    /**
+     * Create a new record
+     */
+    create(data: z.infer<TCreate>, opts?: CreateParams & MethodOptions): Promise<z.infer<TRow> & ComputeJoins<TJoins, CreateParams['include']>>;
+    /**
+     * Update a record by ID
+     */
+    update(id: string | number, data: Partial<z.infer<TUpdate>>, opts?: UpdateParams & MethodOptions): Promise<(z.infer<TRow> & ComputeJoins<TJoins, UpdateParams['include']>) | null>;
+    /**
+     * Delete a record by ID
+     */
+    delete(id: string | number, opts?: DeleteParams & MethodOptions): Promise<boolean>;
+    /**
+     * Count records matching criteria
+     */
+    count(params?: CountParams & MethodOptions): Promise<number>;
+    /**
+     * Execute custom SQL query
+     */
+    query<T = z.infer<TRow>>(query: string, opts?: QueryParams & MethodOptions, ...sqlParams: unknown[]): Promise<T[]>;
+    /**
+     * Run hooks with context for a specific method
+     */
+    protected runHooks<TMethod extends string>(phase: 'before' | 'after' | 'error', method: TMethod, ctx: BaseCtx): Promise<void>;
+    /**
+     * Get columns to select based on secrets configuration
+     */
+    private getSelectColumns;
+    /**
+     * Get allowed columns for ordering
+     */
+    private getAllowedColumns;
+    /**
+     * Encrypt secrets in data
+     */
+    private encryptDataSecrets;
+    /**
+     * Decrypt secrets in a row
+     */
+    private decryptRowSecrets;
+    /**
+     * Process joined rows by extracting join data
+     */
+    private processJoinedRows;
+    /**
+     * Extract only join data from processed row
+     */
+    private extractJoinData;
+    /**
+     * Fetch one-to-many joins using separate queries
+     */
+    private fetchOneToManyJoins;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}