Home / File/ utils.ts — drizzle-orm Source File

utils.ts — drizzle-orm Source File

Architecture documentation for utils.ts, a typescript file in the drizzle-orm codebase. 24 imports, 4 dependents.

File typescript DrizzleORM RelationalQuery 24 imports 4 dependents 4 functions

Entity Profile

Dependency Diagram

graph LR
  9cb8488e_0ece_edef_af6a_5851d56cddda["utils.ts"]
  171b1831_b7c8_175e_cfcd_84202c037834["checks.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 171b1831_b7c8_175e_cfcd_84202c037834
  9dcfe2e5_3f46_2442_2b8b_bda3ac7c2c0c["CheckBuilder"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 9dcfe2e5_3f46_2442_2b8b_bda3ac7c2c0c
  a2e1e4f4_2b6e_c197_a707_793466cb421f["index.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> a2e1e4f4_2b6e_c197_a707_793466cb421f
  fe0bf683_1731_529c_f1b4_81cc9db56955["foreign-keys.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> fe0bf683_1731_529c_f1b4_81cc9db56955
  dbda35af_725c_bbfb_ce7e_01f35541cefa["ForeignKeyBuilder"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> dbda35af_725c_bbfb_ce7e_01f35541cefa
  8e96cfe7_b09e_acd6_1e9a_cf73dc90a16f["indexes.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 8e96cfe7_b09e_acd6_1e9a_cf73dc90a16f
  6445d9e1_77f2_40aa_77c4_9c61ce1b7aef["IndexBuilder"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 6445d9e1_77f2_40aa_77c4_9c61ce1b7aef
  9a930930_b333_9b87_28f1_b079b1897ce5["IndexBuilder"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 9a930930_b333_9b87_28f1_b079b1897ce5
  2653b8be_3a2e_d91d_bd2c_70b1c16e3b68["policies.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 2653b8be_3a2e_d91d_bd2c_70b1c16e3b68
  f86054e6_9a36_2142_b020_d41b11f58b79["GelPolicy"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> f86054e6_9a36_2142_b020_d41b11f58b79
  471611d2_cce2_4786_c10b_d1a110fdccc3["primary-keys.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 471611d2_cce2_4786_c10b_d1a110fdccc3
  f39d1a38_676c_c9d6_ed8b_219e95eb0ee7["PrimaryKeyBuilder"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> f39d1a38_676c_c9d6_ed8b_219e95eb0ee7
  cbe7af57_41be_454d_306f_02d0e6f81949["table.ts"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> cbe7af57_41be_454d_306f_02d0e6f81949
  2eedb6f7_d8cd_b386_c3b0_8585d8562d1d["GelTable"]
  9cb8488e_0ece_edef_af6a_5851d56cddda --> 2eedb6f7_d8cd_b386_c3b0_8585d8562d1d
  style 9cb8488e_0ece_edef_af6a_5851d56cddda fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

import { is } from '~/entity.ts';
import { SQL } from '~/sql/sql.ts';
import { Subquery } from '~/subquery.ts';
import { Table } from '~/table.ts';
import { ViewBaseConfig } from '~/view-common.ts';
import { type Check, CheckBuilder } from './checks.ts';
import type { AnyGelColumn } from './columns/index.ts';
import { type ForeignKey, ForeignKeyBuilder } from './foreign-keys.ts';
import type { Index } from './indexes.ts';
import { IndexBuilder } from './indexes.ts';
import { GelPolicy } from './policies.ts';
import { type PrimaryKey, PrimaryKeyBuilder } from './primary-keys.ts';
import { GelTable } from './table.ts';
import { type UniqueConstraint, UniqueConstraintBuilder } from './unique-constraint.ts';
import type { GelViewBase } from './view-base.ts';
import { GelViewConfig } from './view-common.ts';
import { type GelMaterializedView, GelMaterializedViewConfig, type GelView } from './view.ts';

export function getTableConfig<TTable extends GelTable>(table: TTable) {
	const columns = Object.values(table[Table.Symbol.Columns]);
	const indexes: Index[] = [];
	const checks: Check[] = [];
	const primaryKeys: PrimaryKey[] = [];
	const foreignKeys: ForeignKey[] = Object.values(table[GelTable.Symbol.InlineForeignKeys]);
	const uniqueConstraints: UniqueConstraint[] = [];
	const name = table[Table.Symbol.Name];
	const schema = table[Table.Symbol.Schema];
	const policies: GelPolicy[] = [];
	const enableRLS: boolean = table[GelTable.Symbol.EnableRLS];

	const extraConfigBuilder = table[GelTable.Symbol.ExtraConfigBuilder];

	if (extraConfigBuilder !== undefined) {
		const extraConfig = extraConfigBuilder(table[Table.Symbol.ExtraConfigColumns]);
		const extraValues = Array.isArray(extraConfig) ? extraConfig.flat(1) as any[] : Object.values(extraConfig);
		for (const builder of extraValues) {
			if (is(builder, IndexBuilder)) {
				indexes.push(builder.build(table));
			} else if (is(builder, CheckBuilder)) {
				checks.push(builder.build(table));
			} else if (is(builder, UniqueConstraintBuilder)) {
				uniqueConstraints.push(builder.build(table));
			} else if (is(builder, PrimaryKeyBuilder)) {
				primaryKeys.push(builder.build(table));
			} else if (is(builder, ForeignKeyBuilder)) {
				foreignKeys.push(builder.build(table));
			} else if (is(builder, GelPolicy)) {
				policies.push(builder);
			}
		}
	}

	return {
		columns,
		indexes,
		foreignKeys,
		checks,
		primaryKeys,
		uniqueConstraints,
		name,
		schema,
		policies,
		enableRLS,
	};
}

export function extractUsedTable(table: GelTable | Subquery | GelViewBase | SQL): string[] {
	if (is(table, GelTable)) {
		return [`${table[Table.Symbol.BaseName]}`];
	}
	if (is(table, Subquery)) {
		return table._.usedTables ?? [];
	}
	if (is(table, SQL)) {
		return table.usedTables ?? [];
	}
	return [];
}

export function getViewConfig<
	TName extends string = string,
	TExisting extends boolean = boolean,
>(view: GelView<TName, TExisting>) {
	return {
		...view[ViewBaseConfig],
		...view[GelViewConfig],
	};
}

export function getMaterializedViewConfig<
	TName extends string = string,
	TExisting extends boolean = boolean,
>(view: GelMaterializedView<TName, TExisting>) {
	return {
		...view[ViewBaseConfig],
		...view[GelMaterializedViewConfig],
	};
}

export type ColumnsWithTable<
	TTableName extends string,
	TForeignTableName extends string,
	TColumns extends AnyGelColumn<{ tableName: TTableName }>[],
> = { [Key in keyof TColumns]: AnyGelColumn<{ tableName: TForeignTableName }> };

Domain

Subdomains

Frequently Asked Questions

What does utils.ts do?
utils.ts is a source file in the drizzle-orm codebase, written in typescript. It belongs to the DrizzleORM domain, RelationalQuery subdomain.
What functions are defined in utils.ts?
utils.ts defines 4 function(s): extractUsedTable, getMaterializedViewConfig, getTableConfig, getViewConfig.
What does utils.ts depend on?
utils.ts imports 24 module(s): CheckBuilder, ForeignKeyBuilder, GelPolicy, GelTable, IndexBuilder, IndexBuilder, PrimaryKeyBuilder, UniqueConstraintBuilder, and 16 more.
What files import utils.ts?
utils.ts is imported by 4 file(s): delete.ts, insert.ts, select.ts, update.ts.
Where is utils.ts in the architecture?
utils.ts is located at drizzle-orm/src/gel-core/utils.ts (domain: DrizzleORM, subdomain: RelationalQuery, directory: drizzle-orm/src/gel-core).

Analyze Your Own Codebase

Get architecture documentation, dependency graphs, and domain analysis for your codebase in minutes.

Try Supermodel Free