Interface OperationContext

Base context for all operations.

Provides common information available to all hooks.

interface OperationContext {
    operationId: string;
    operation:
        | "get"
        | "all"
        | "exec"
        | "run"
        | "batch"
        | "transaction";
    startTime: number;
    adapterKind: string;
    metadata?: Record<string, unknown>;
}

Hierarchy (view full)

Properties

operationId operation startTime adapterKind metadata?

Properties

ReadonlyoperationId

operationId: string

Unique identifier for this operation (UUID v4).

Use for correlation in logs and traces.

Readonlyoperation

operation:
    | "get"
    | "all"
    | "exec"
    | "run"
    | "batch"
    | "transaction"

Operation type being performed.

ReadonlystartTime

startTime: number

Timestamp when operation started (ms since epoch).

ReadonlyadapterKind

adapterKind: string

Adapter kind (e.g., 'better-sqlite3', 'indexeddb', 'postgres').

Optionalmetadata

metadata?: Record<string, unknown>

Custom metadata attached to this operation.

Hooks can read and modify this to pass data between hooks or to the calling code.

Example: Marking a query for special handling

const results = await db.all(
  'SELECT * FROM users WHERE id = ?',
  [userId],
  { metadata: { skipCache: true, auditLevel: 'high' } }
);

Settings

Member Visibility

On This Page

Properties