chore: import upstream snapshot with attribution

2026-07-13 13:20:55 +08:00
commit d25d482dc2
13754 changed files with 4996608 additions and 0 deletions
@@ -0,0 +1,29 @@
+import type { db } from '@sim/db'
+import type * as schema from '@sim/db/schema'
+import type { ExtractTablesWithRelations } from 'drizzle-orm'
+import type { PgTransaction } from 'drizzle-orm/pg-core'
+import type { PostgresJsQueryResultHKT } from 'drizzle-orm/postgres-js'
+
+/**
+ * Type for database or transaction context.
+ * Allows functions to work with either the db instance or a transaction.
+ */
+export type DbOrTx =
+  | typeof db
+  | PgTransaction<
+      PostgresJsQueryResultHKT,
+      typeof schema,
+      ExtractTablesWithRelations<typeof schema>
+    >
+
+/**
+ * Read-routing client: the primary `db` or the read replica `dbReplica`.
+ *
+ * For read-path helpers (billing summaries, dashboard aggregations) whose
+ * executor param exists to route SELECT fan-outs to a replica. Deliberately
+ * excludes transaction handles — these helpers issue multi-step query fans
+ * that must never run while a transaction holds a pooled connection. Use
+ * `DbOrTx` only for helpers genuinely designed to join a caller's
+ * transaction.
+ */
+export type DbClient = typeof db