session.d.cts 4.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. import type { Connection, FieldPacket, OkPacket, Pool, ResultSetHeader, RowDataPacket } from 'mysql2/promise';
  2. import { type Cache } from "../cache/core/index.cjs";
  3. import type { WithCacheConfig } from "../cache/core/types.cjs";
  4. import { entityKind } from "../entity.cjs";
  5. import type { Logger } from "../logger.cjs";
  6. import type { MySqlDialect } from "../mysql-core/dialect.cjs";
  7. import type { SelectedFieldsOrdered } from "../mysql-core/query-builders/select.types.cjs";
  8. import { type Mode, MySqlPreparedQuery, type MySqlPreparedQueryConfig, type MySqlPreparedQueryHKT, type MySqlQueryResultHKT, MySqlSession, MySqlTransaction, type MySqlTransactionConfig, type PreparedQueryKind } from "../mysql-core/session.cjs";
  9. import type { RelationalSchemaConfig, TablesRelationalConfig } from "../relations.cjs";
  10. import type { Query, SQL } from "../sql/sql.cjs";
  11. import { type Assume } from "../utils.cjs";
  12. export type MySql2Client = Pool | Connection;
  13. export type MySqlRawQueryResult = [ResultSetHeader, FieldPacket[]];
  14. export type MySqlQueryResultType = RowDataPacket[][] | RowDataPacket[] | OkPacket | OkPacket[] | ResultSetHeader;
  15. export type MySqlQueryResult<T = any> = [T extends ResultSetHeader ? T : T[], FieldPacket[]];
  16. export declare class MySql2PreparedQuery<T extends MySqlPreparedQueryConfig> extends MySqlPreparedQuery<T> {
  17. private client;
  18. private params;
  19. private logger;
  20. private fields;
  21. private customResultMapper?;
  22. private generatedIds?;
  23. private returningIds?;
  24. static readonly [entityKind]: string;
  25. private rawQuery;
  26. private query;
  27. constructor(client: MySql2Client, queryString: string, params: unknown[], logger: Logger, cache: Cache, queryMetadata: {
  28. type: 'select' | 'update' | 'delete' | 'insert';
  29. tables: string[];
  30. } | undefined, cacheConfig: WithCacheConfig | undefined, fields: SelectedFieldsOrdered | undefined, customResultMapper?: ((rows: unknown[][]) => T["execute"]) | undefined, generatedIds?: Record<string, unknown>[] | undefined, returningIds?: SelectedFieldsOrdered | undefined);
  31. execute(placeholderValues?: Record<string, unknown>): Promise<T['execute']>;
  32. iterator(placeholderValues?: Record<string, unknown>): AsyncGenerator<T['execute'] extends any[] ? T['execute'][number] : T['execute']>;
  33. }
  34. export interface MySql2SessionOptions {
  35. logger?: Logger;
  36. cache?: Cache;
  37. mode: Mode;
  38. }
  39. export declare class MySql2Session<TFullSchema extends Record<string, unknown>, TSchema extends TablesRelationalConfig> extends MySqlSession<MySqlQueryResultHKT, MySql2PreparedQueryHKT, TFullSchema, TSchema> {
  40. private client;
  41. private schema;
  42. private options;
  43. static readonly [entityKind]: string;
  44. private logger;
  45. private mode;
  46. private cache;
  47. constructor(client: MySql2Client, dialect: MySqlDialect, schema: RelationalSchemaConfig<TSchema> | undefined, options: MySql2SessionOptions);
  48. prepareQuery<T extends MySqlPreparedQueryConfig>(query: Query, fields: SelectedFieldsOrdered | undefined, customResultMapper?: (rows: unknown[][]) => T['execute'], generatedIds?: Record<string, unknown>[], returningIds?: SelectedFieldsOrdered, queryMetadata?: {
  49. type: 'select' | 'update' | 'delete' | 'insert';
  50. tables: string[];
  51. }, cacheConfig?: WithCacheConfig): PreparedQueryKind<MySql2PreparedQueryHKT, T>;
  52. all<T = unknown>(query: SQL): Promise<T[]>;
  53. transaction<T>(transaction: (tx: MySql2Transaction<TFullSchema, TSchema>) => Promise<T>, config?: MySqlTransactionConfig): Promise<T>;
  54. }
  55. export declare class MySql2Transaction<TFullSchema extends Record<string, unknown>, TSchema extends TablesRelationalConfig> extends MySqlTransaction<MySql2QueryResultHKT, MySql2PreparedQueryHKT, TFullSchema, TSchema> {
  56. static readonly [entityKind]: string;
  57. transaction<T>(transaction: (tx: MySql2Transaction<TFullSchema, TSchema>) => Promise<T>): Promise<T>;
  58. }
  59. export interface MySql2QueryResultHKT extends MySqlQueryResultHKT {
  60. type: MySqlRawQueryResult;
  61. }
  62. export interface MySql2PreparedQueryHKT extends MySqlPreparedQueryHKT {
  63. type: MySql2PreparedQuery<Assume<this['config'], MySqlPreparedQueryConfig>>;
  64. }