session.ts — drizzle-orm Source File

Architecture documentation for session.ts, a typescript file in the drizzle-orm codebase. 14 imports, 1 dependents.

File typescript DrizzleORM RelationalQuery 14 imports 1 dependents 2 functions 3 classes

Entity Profile

DrizzleORM→ RelationalQuery→ session.ts — drizzle-orm Source File

Dependency Diagram

graph LR
  71955c9c_98bb_2bea_3a87_96f5a4be3a27["session.ts"]
  33707adf_3867_206c_1f47_142479def47f["client"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 33707adf_3867_206c_1f47_142479def47f
  4dc3ba08_25aa_13fd_82c6_8802d5991d05["batch.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 4dc3ba08_25aa_13fd_82c6_8802d5991d05
  363fdd67_2503_7ef7_e1f3_a1ef31694431["index.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 363fdd67_2503_7ef7_e1f3_a1ef31694431
  47a9c453_10f1_a759_6246_695fcce2b20a["types.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 47a9c453_10f1_a759_6246_695fcce2b20a
  27705a9d_afe9_57dd_8c97_e52d8a67d426["entity.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 27705a9d_afe9_57dd_8c97_e52d8a67d426
  220c512d_350b_24bf_2142_53ec35a980ac["logger.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 220c512d_350b_24bf_2142_53ec35a980ac
  e4d6a0ab_9aa2_13a6_a2f1_58d94314c3f2["relations.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> e4d6a0ab_9aa2_13a6_a2f1_58d94314c3f2
  547e9370_8c5e_e9f1_3d6f_b9a83ab3d562["session.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 547e9370_8c5e_e9f1_3d6f_b9a83ab3d562
  be483a7f_d5d7_7a9b_9a13_44a4a6aafbbd["sql.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> be483a7f_d5d7_7a9b_9a13_44a4a6aafbbd
  3d205d67_2ef4_984a_3241_ff4981527231["dialect.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 3d205d67_2ef4_984a_3241_ff4981527231
  c9460fa2_b68e_584b_2be3_a4db38ea6f7c["index.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> c9460fa2_b68e_584b_2be3_a4db38ea6f7c
  bf02be20_6959_f396_18fe_977324363c59["select.types.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> bf02be20_6959_f396_18fe_977324363c59
  21edec30_3c3a_04cb_9bbe_28adfc576bfb["session.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> 21edec30_3c3a_04cb_9bbe_28adfc576bfb
  ecce3253_1e75_a87f_27b3_ca87e81a3024["utils.ts"]
  71955c9c_98bb_2bea_3a87_96f5a4be3a27 --> ecce3253_1e75_a87f_27b3_ca87e81a3024
  style 71955c9c_98bb_2bea_3a87_96f5a4be3a27 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

import type { Client, InArgs, InStatement, ResultSet, Transaction } from '@libsql/client';
import type { BatchItem as BatchItem } from '~/batch.ts';
import { type Cache, NoopCache } from '~/cache/core/index.ts';
import type { WithCacheConfig } from '~/cache/core/types.ts';
import { entityKind } from '~/entity.ts';
import type { Logger } from '~/logger.ts';
import { NoopLogger } from '~/logger.ts';
import type { RelationalSchemaConfig, TablesRelationalConfig } from '~/relations.ts';
import type { PreparedQuery } from '~/session.ts';
import { fillPlaceholders, type Query, sql } from '~/sql/sql.ts';
import type { SQLiteAsyncDialect } from '~/sqlite-core/dialect.ts';
import { SQLiteTransaction } from '~/sqlite-core/index.ts';
import type { SelectedFieldsOrdered } from '~/sqlite-core/query-builders/select.types.ts';
import type {
	PreparedQueryConfig as PreparedQueryConfigBase,
	SQLiteExecuteMethod,
	SQLiteTransactionConfig,
} from '~/sqlite-core/session.ts';
import { SQLitePreparedQuery, SQLiteSession } from '~/sqlite-core/session.ts';
import { mapResultRow } from '~/utils.ts';

export interface LibSQLSessionOptions {
	logger?: Logger;
	cache?: Cache;
}

type PreparedQueryConfig = Omit<PreparedQueryConfigBase, 'statement' | 'run'>;

export class LibSQLSession<
	TFullSchema extends Record<string, unknown>,
	TSchema extends TablesRelationalConfig,
> extends SQLiteSession<'async', ResultSet, TFullSchema, TSchema> {
	static override readonly [entityKind]: string = 'LibSQLSession';

	private logger: Logger;
	private cache: Cache;

	constructor(
		private client: Client,
		dialect: SQLiteAsyncDialect,
		private schema: RelationalSchemaConfig<TSchema> | undefined,
		private options: LibSQLSessionOptions,
		private tx: Transaction | undefined,
	) {
		super(dialect);
		this.logger = options.logger ?? new NoopLogger();
		this.cache = options.cache ?? new NoopCache();
	}

	prepareQuery<T extends Omit<PreparedQueryConfig, 'run'>>(
		query: Query,
		fields: SelectedFieldsOrdered | undefined,
		executeMethod: SQLiteExecuteMethod,
		isResponseInArrayMode: boolean,
		customResultMapper?: (rows: unknown[][]) => unknown,
		queryMetadata?: {
			type: 'select' | 'update' | 'delete' | 'insert';
			tables: string[];
		},
		cacheConfig?: WithCacheConfig,
// ... (268 more lines)