@hypequery/clickhouse 0.0.0-canary-20260306132943

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/LICENSE +201 -0
  2. package/README-CLI.md +123 -0
  3. package/README.md +316 -0
  4. package/dist/cli/bin.js +285 -0
  5. package/dist/cli/generate-types.d.ts +5 -0
  6. package/dist/cli/generate-types.js +218 -0
  7. package/dist/cli/index.d.ts +2 -0
  8. package/dist/cli/index.js +2 -0
  9. package/dist/core/cache/cache-manager.d.ts +4 -0
  10. package/dist/core/cache/cache-manager.d.ts.map +1 -0
  11. package/dist/core/cache/cache-manager.js +176 -0
  12. package/dist/core/cache/controller.d.ts +15 -0
  13. package/dist/core/cache/controller.d.ts.map +1 -0
  14. package/dist/core/cache/controller.js +58 -0
  15. package/dist/core/cache/key.d.ts +11 -0
  16. package/dist/core/cache/key.d.ts.map +1 -0
  17. package/dist/core/cache/key.js +26 -0
  18. package/dist/core/cache/providers/memory-lru.d.ts +31 -0
  19. package/dist/core/cache/providers/memory-lru.d.ts.map +1 -0
  20. package/dist/core/cache/providers/memory-lru.js +156 -0
  21. package/dist/core/cache/providers/noop.d.ts +7 -0
  22. package/dist/core/cache/providers/noop.d.ts.map +1 -0
  23. package/dist/core/cache/providers/noop.js +11 -0
  24. package/dist/core/cache/runtime-context.d.ts +30 -0
  25. package/dist/core/cache/runtime-context.d.ts.map +1 -0
  26. package/dist/core/cache/runtime-context.js +58 -0
  27. package/dist/core/cache/serialization.d.ts +6 -0
  28. package/dist/core/cache/serialization.d.ts.map +1 -0
  29. package/dist/core/cache/serialization.js +166 -0
  30. package/dist/core/cache/types.d.ts +52 -0
  31. package/dist/core/cache/types.d.ts.map +1 -0
  32. package/dist/core/cache/types.js +1 -0
  33. package/dist/core/cache/utils.d.ts +9 -0
  34. package/dist/core/cache/utils.d.ts.map +1 -0
  35. package/dist/core/cache/utils.js +30 -0
  36. package/dist/core/connection.d.ts +112 -0
  37. package/dist/core/connection.d.ts.map +1 -0
  38. package/dist/core/connection.js +150 -0
  39. package/dist/core/cross-filter.d.ts +73 -0
  40. package/dist/core/cross-filter.d.ts.map +1 -0
  41. package/dist/core/cross-filter.js +142 -0
  42. package/dist/core/env/auto-client.browser.d.ts +3 -0
  43. package/dist/core/env/auto-client.browser.d.ts.map +1 -0
  44. package/dist/core/env/auto-client.browser.js +3 -0
  45. package/dist/core/env/auto-client.d.ts +9 -0
  46. package/dist/core/env/auto-client.d.ts.map +1 -0
  47. package/dist/core/env/auto-client.js +21 -0
  48. package/dist/core/features/aggregations.d.ts +98 -0
  49. package/dist/core/features/aggregations.d.ts.map +1 -0
  50. package/dist/core/features/aggregations.js +36 -0
  51. package/dist/core/features/analytics.d.ts +81 -0
  52. package/dist/core/features/analytics.d.ts.map +1 -0
  53. package/dist/core/features/analytics.js +45 -0
  54. package/dist/core/features/cross-filtering.d.ts +11 -0
  55. package/dist/core/features/cross-filtering.d.ts.map +1 -0
  56. package/dist/core/features/cross-filtering.js +90 -0
  57. package/dist/core/features/executor.d.ts +21 -0
  58. package/dist/core/features/executor.d.ts.map +1 -0
  59. package/dist/core/features/executor.js +146 -0
  60. package/dist/core/features/filtering.d.ts +99 -0
  61. package/dist/core/features/filtering.d.ts.map +1 -0
  62. package/dist/core/features/filtering.js +118 -0
  63. package/dist/core/features/joins.d.ts +26 -0
  64. package/dist/core/features/joins.d.ts.map +1 -0
  65. package/dist/core/features/joins.js +17 -0
  66. package/dist/core/features/query-modifiers.d.ts +116 -0
  67. package/dist/core/features/query-modifiers.d.ts.map +1 -0
  68. package/dist/core/features/query-modifiers.js +51 -0
  69. package/dist/core/formatters/sql-formatter.d.ts +9 -0
  70. package/dist/core/formatters/sql-formatter.d.ts.map +1 -0
  71. package/dist/core/formatters/sql-formatter.js +131 -0
  72. package/dist/core/join-relationships.d.ts +51 -0
  73. package/dist/core/join-relationships.d.ts.map +1 -0
  74. package/dist/core/join-relationships.js +54 -0
  75. package/dist/core/query-builder.d.ts +236 -0
  76. package/dist/core/query-builder.d.ts.map +1 -0
  77. package/dist/core/query-builder.js +495 -0
  78. package/dist/core/tests/index.d.ts +2 -0
  79. package/dist/core/tests/index.d.ts.map +1 -0
  80. package/dist/core/tests/index.js +1 -0
  81. package/dist/core/tests/integration/setup.d.ts +48 -0
  82. package/dist/core/tests/integration/setup.d.ts.map +1 -0
  83. package/dist/core/tests/integration/setup.js +349 -0
  84. package/dist/core/tests/integration/test-config.d.ts +15 -0
  85. package/dist/core/tests/integration/test-config.d.ts.map +1 -0
  86. package/dist/core/tests/integration/test-config.js +14 -0
  87. package/dist/core/tests/integration/test-data.json +190 -0
  88. package/dist/core/tests/test-utils.d.ts +44 -0
  89. package/dist/core/tests/test-utils.d.ts.map +1 -0
  90. package/dist/core/tests/test-utils.js +65 -0
  91. package/dist/core/types/builder-state.d.ts +27 -0
  92. package/dist/core/types/builder-state.d.ts.map +1 -0
  93. package/dist/core/types/builder-state.js +1 -0
  94. package/dist/core/types/select-types.d.ts +33 -0
  95. package/dist/core/types/select-types.d.ts.map +1 -0
  96. package/dist/core/types/select-types.js +1 -0
  97. package/dist/core/types/type-helpers.d.ts +5 -0
  98. package/dist/core/types/type-helpers.d.ts.map +1 -0
  99. package/dist/core/types/type-helpers.js +1 -0
  100. package/dist/core/utils/logger.d.ts +43 -0
  101. package/dist/core/utils/logger.d.ts.map +1 -0
  102. package/dist/core/utils/logger.js +104 -0
  103. package/dist/core/utils/predicate-builder.d.ts +33 -0
  104. package/dist/core/utils/predicate-builder.d.ts.map +1 -0
  105. package/dist/core/utils/predicate-builder.js +95 -0
  106. package/dist/core/utils/sql-expressions.d.ts +77 -0
  107. package/dist/core/utils/sql-expressions.d.ts.map +1 -0
  108. package/dist/core/utils/sql-expressions.js +54 -0
  109. package/dist/core/utils/streaming-helpers.d.ts +2 -0
  110. package/dist/core/utils/streaming-helpers.d.ts.map +1 -0
  111. package/dist/core/utils/streaming-helpers.js +137 -0
  112. package/dist/core/utils.d.ts +3 -0
  113. package/dist/core/utils.d.ts.map +1 -0
  114. package/dist/core/utils.js +29 -0
  115. package/dist/core/validators/filter-validator.d.ts +9 -0
  116. package/dist/core/validators/filter-validator.d.ts.map +1 -0
  117. package/dist/core/validators/filter-validator.js +19 -0
  118. package/dist/core/validators/value-validator.d.ts +7 -0
  119. package/dist/core/validators/value-validator.d.ts.map +1 -0
  120. package/dist/core/validators/value-validator.js +47 -0
  121. package/dist/formatters/index.d.ts +2 -0
  122. package/dist/formatters/index.d.ts.map +1 -0
  123. package/dist/formatters/index.js +1 -0
  124. package/dist/index.d.ts +20 -0
  125. package/dist/index.d.ts.map +1 -0
  126. package/dist/index.js +21 -0
  127. package/dist/types/base.d.ts +50 -0
  128. package/dist/types/base.d.ts.map +1 -0
  129. package/dist/types/base.js +1 -0
  130. package/dist/types/clickhouse-types.d.ts +17 -0
  131. package/dist/types/clickhouse-types.d.ts.map +1 -0
  132. package/dist/types/clickhouse-types.js +1 -0
  133. package/dist/types/filters.d.ts +53 -0
  134. package/dist/types/filters.d.ts.map +1 -0
  135. package/dist/types/filters.js +1 -0
  136. package/dist/types/index.d.ts +5 -0
  137. package/dist/types/index.d.ts.map +1 -0
  138. package/dist/types/index.js +4 -0
  139. package/dist/types/schema.d.ts +19 -0
  140. package/dist/types/schema.d.ts.map +1 -0
  141. package/dist/types/schema.js +1 -0
  142. package/package.json +90 -0
@@ -0,0 +1,137 @@
1
+ import { Readable } from 'stream';
2
+ function createBufferFlusher() {
3
+ let buffer = '';
4
+ const flush = () => {
5
+ if (!buffer.length) {
6
+ return [];
7
+ }
8
+ const lines = buffer.split('\n');
9
+ buffer = lines.pop() ?? '';
10
+ const rows = [];
11
+ for (const line of lines) {
12
+ const trimmed = line.trim();
13
+ if (!trimmed.length) {
14
+ continue;
15
+ }
16
+ rows.push(JSON.parse(trimmed));
17
+ }
18
+ return rows;
19
+ };
20
+ const append = (value) => {
21
+ buffer += typeof value === 'string' ? value : value.toString('utf8');
22
+ };
23
+ return { flush, append };
24
+ }
25
+ async function normalizeChunk(chunk, flush, append) {
26
+ if (chunk == null) {
27
+ return [];
28
+ }
29
+ if (Array.isArray(chunk)) {
30
+ const rows = [];
31
+ for (const item of chunk) {
32
+ rows.push(...await normalizeChunk(item, flush, append));
33
+ }
34
+ return rows;
35
+ }
36
+ if (typeof chunk.json === 'function') {
37
+ return [await chunk.json()];
38
+ }
39
+ if (typeof chunk.text === 'function') {
40
+ const text = await chunk.text();
41
+ return [JSON.parse(text)];
42
+ }
43
+ if (typeof chunk.text === 'string') {
44
+ return [JSON.parse(chunk.text)];
45
+ }
46
+ if (Buffer.isBuffer(chunk)) {
47
+ append(chunk);
48
+ return flush();
49
+ }
50
+ if (typeof chunk === 'string') {
51
+ append(chunk);
52
+ return flush();
53
+ }
54
+ if (typeof chunk === 'object') {
55
+ return [chunk];
56
+ }
57
+ return [];
58
+ }
59
+ async function createChunkReader(nodeStream) {
60
+ const iterator = nodeStream[Symbol.asyncIterator]?.();
61
+ let webReader;
62
+ const readNext = async () => {
63
+ if (iterator) {
64
+ const result = await iterator.next();
65
+ return { done: Boolean(result.done), value: result.value };
66
+ }
67
+ if (!webReader) {
68
+ const webStream = Readable.toWeb(nodeStream);
69
+ webReader = webStream.getReader();
70
+ }
71
+ const result = await webReader.read();
72
+ return { done: Boolean(result.done), value: result.value };
73
+ };
74
+ const close = async () => {
75
+ if (iterator && typeof iterator.return === 'function') {
76
+ try {
77
+ await iterator.return();
78
+ }
79
+ catch { }
80
+ }
81
+ if (typeof nodeStream.destroy === 'function') {
82
+ nodeStream.destroy();
83
+ }
84
+ };
85
+ return { readNext, close };
86
+ }
87
+ async function createWebStreamReader(webStream) {
88
+ const reader = webStream.getReader();
89
+ const readNext = async () => {
90
+ const result = await reader.read();
91
+ return { done: Boolean(result.done), value: result.value };
92
+ };
93
+ const close = async () => {
94
+ try {
95
+ await reader.cancel();
96
+ }
97
+ catch { }
98
+ };
99
+ return { readNext, close };
100
+ }
101
+ export function createJsonEachRowStream(stream) {
102
+ const { flush, append } = createBufferFlusher();
103
+ let readerPromise;
104
+ const ensureReader = () => {
105
+ if (!readerPromise) {
106
+ if (typeof stream?.getReader === 'function') {
107
+ readerPromise = createWebStreamReader(stream);
108
+ }
109
+ else {
110
+ readerPromise = createChunkReader(stream);
111
+ }
112
+ }
113
+ return readerPromise;
114
+ };
115
+ return new ReadableStream({
116
+ async pull(controller) {
117
+ const reader = await ensureReader();
118
+ const { done, value } = await reader.readNext();
119
+ if (done) {
120
+ const remaining = flush();
121
+ if (remaining.length) {
122
+ controller.enqueue(remaining);
123
+ }
124
+ controller.close();
125
+ return;
126
+ }
127
+ const rows = await normalizeChunk(value, flush, append);
128
+ if (rows.length) {
129
+ controller.enqueue(rows);
130
+ }
131
+ },
132
+ async cancel() {
133
+ const reader = await ensureReader();
134
+ await reader.close();
135
+ }
136
+ });
137
+ }
@@ -0,0 +1,3 @@
1
+ export declare function escapeValue(value: any): string;
2
+ export declare function substituteParameters(sql: string, params: any[]): string;
3
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAa9C;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAavE"}
@@ -0,0 +1,29 @@
1
+ export function escapeValue(value) {
2
+ if (typeof value === 'boolean') {
3
+ return value ? 'true' : 'false';
4
+ }
5
+ else if (typeof value === 'number') {
6
+ return value.toString();
7
+ }
8
+ else if (typeof value === 'string') {
9
+ return `'${value.replace(/'/g, "''")}'`;
10
+ }
11
+ else if (value instanceof Date) {
12
+ return `'${value.toISOString()}'`;
13
+ }
14
+ else {
15
+ return `'${JSON.stringify(value)}'`;
16
+ }
17
+ }
18
+ export function substituteParameters(sql, params) {
19
+ const parts = sql.split('?');
20
+ if (parts.length - 1 !== params.length) {
21
+ throw new Error(`Mismatch between placeholders and parameters. Found ${parts.length - 1} placeholders but ${params.length} parameters.`);
22
+ }
23
+ let substitutedSql = '';
24
+ for (let i = 0; i < params.length; i++) {
25
+ substitutedSql += parts[i] + escapeValue(params[i]);
26
+ }
27
+ substitutedSql += parts[parts.length - 1];
28
+ return substitutedSql;
29
+ }
@@ -0,0 +1,9 @@
1
+ import { FilterConditionInput } from '../../types/index.js';
2
+ import { ColumnType } from '../../types/schema.js';
3
+ export declare class FilterValidator {
4
+ static validateFilterCondition<T = any>(condition: FilterConditionInput<T>, columnType?: ColumnType, options?: {
5
+ allowNull?: boolean;
6
+ }): void;
7
+ static validateJoinedColumn(column: string): boolean;
8
+ }
9
+ //# sourceMappingURL=filter-validator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filter-validator.d.ts","sourceRoot":"","sources":["../../../src/core/validators/filter-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,qBAAa,eAAe;IAC1B,MAAM,CAAC,uBAAuB,CAAC,CAAC,GAAG,GAAG,EACpC,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAClC,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACpC,IAAI;IAgBP,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAGrD"}
@@ -0,0 +1,19 @@
1
+ import { ValueValidator } from './value-validator.js';
2
+ export class FilterValidator {
3
+ static validateFilterCondition(condition, columnType, options = {}) {
4
+ const { column, operator, value } = condition;
5
+ const columnName = String(column);
6
+ // Validate value is not null/undefined unless explicitly allowed
7
+ if (!options.allowNull && (value === null || value === undefined)) {
8
+ throw new Error(`Filter value for column '${columnName}' cannot be null/undefined`);
9
+ }
10
+ // Skip type validation if no columnType provided (e.g., for joined columns)
11
+ if (!columnType)
12
+ return;
13
+ // Delegate to value validator for type checking
14
+ ValueValidator.validateFilterValue(columnType, operator, value, columnName);
15
+ }
16
+ static validateJoinedColumn(column) {
17
+ return column.includes('.');
18
+ }
19
+ }
@@ -0,0 +1,7 @@
1
+ import { FilterOperator } from '../../types/index.js';
2
+ import { ColumnType } from '../../types/schema.js';
3
+ export declare class ValueValidator {
4
+ static validateFilterValue(columnType: ColumnType, operator: FilterOperator, value: any, columnName: string): void;
5
+ private static validateSingleValue;
6
+ }
7
+ //# sourceMappingURL=value-validator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value-validator.d.ts","sourceRoot":"","sources":["../../../src/core/validators/value-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,qBAAa,cAAc;IACzB,MAAM,CAAC,mBAAmB,CACxB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,GAAG,EACV,UAAU,EAAE,MAAM,GACjB,IAAI;IAqBP,OAAO,CAAC,MAAM,CAAC,mBAAmB;CA4BnC"}
@@ -0,0 +1,47 @@
1
+ export class ValueValidator {
2
+ static validateFilterValue(columnType, operator, value, columnName) {
3
+ if (operator === 'in' || operator === 'notIn') {
4
+ if (!Array.isArray(value)) {
5
+ throw new Error(`Operator '${operator}' requires an array value`);
6
+ }
7
+ value.forEach((v) => this.validateSingleValue(columnType, v, columnName));
8
+ return;
9
+ }
10
+ if (operator === 'between') {
11
+ if (!Array.isArray(value) || value.length !== 2) {
12
+ throw new Error(`Operator 'between' requires an array with exactly two values`);
13
+ }
14
+ value.forEach((v) => this.validateSingleValue(columnType, v, columnName));
15
+ return;
16
+ }
17
+ if ((operator === 'like' || operator === 'notLike') && typeof value !== 'string') {
18
+ throw new Error(`Operator '${operator}' requires a string value`);
19
+ }
20
+ this.validateSingleValue(columnType, value, columnName);
21
+ }
22
+ static validateSingleValue(columnType, value, columnName) {
23
+ if (value === null)
24
+ return;
25
+ switch (columnType) {
26
+ case 'Date':
27
+ if (!(value instanceof Date) && typeof value !== 'string') {
28
+ throw new Error(`Invalid date value for column '${columnName}'`);
29
+ }
30
+ break;
31
+ case 'Int32':
32
+ case 'Int64':
33
+ case 'Float64':
34
+ if (typeof value !== 'number') {
35
+ throw new Error(`Invalid numeric value for column '${columnName}'`);
36
+ }
37
+ break;
38
+ case 'String':
39
+ if (typeof value !== 'string') {
40
+ throw new Error(`Invalid string value for column '${columnName}'`);
41
+ }
42
+ break;
43
+ default:
44
+ break;
45
+ }
46
+ }
47
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":""}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,20 @@
1
+ export { createQueryBuilder, QueryBuilder } from './core/query-builder.js';
2
+ export { ClickHouseConnection } from './core/connection.js';
3
+ export { JoinRelationships } from './core/join-relationships.js';
4
+ export type { ClickHouseConfig, ClickHouseClientConfig, CreateQueryBuilderConfig, ExecuteOptions } from './core/query-builder.js';
5
+ export { isClientConfig } from './core/query-builder.js';
6
+ export type { CacheOptions, CacheConfig, CacheProvider, CacheEntry, CacheStatus } from './core/cache/types.js';
7
+ export { CacheController } from './core/cache/controller.js';
8
+ export { MemoryCacheProvider } from './core/cache/providers/memory-lru.js';
9
+ export { MemoryCacheProvider as MemoryLRUCacheProvider } from './core/cache/providers/memory-lru.js';
10
+ export { NoopCacheProvider } from './core/cache/providers/noop.js';
11
+ export type { ColumnType, TableColumn, TableSchema, TableRecord, DatabaseSchema, InferColumnType, } from './types/schema.js';
12
+ export type { OrderDirection, QueryConfig, AggregationType } from './types/base.js';
13
+ export type { FilterOperator, OperatorValueMap, FilterConditionInput } from './types/filters.js';
14
+ export type { JoinPath, JoinPathOptions } from './core/join-relationships.js';
15
+ export { CrossFilter } from './core/cross-filter.js';
16
+ export { logger } from './core/utils/logger.js';
17
+ export { raw, rawAs, selectExpr, toDateTime, formatDateTime, toStartOfInterval, datePart } from './core/utils/sql-expressions.js';
18
+ export type { SqlExpression, FormatDateTimeOptions, AliasedExpression } from './core/utils/sql-expressions.js';
19
+ export type { PredicateExpression, PredicateLiteral, PredicateBuilder, PredicateArg } from './core/utils/predicate-builder.js';
20
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EACL,GAAG,EACH,KAAK,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACT,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,mCAAmC,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,21 @@
1
+ // Main entry point
2
+ export { createQueryBuilder } from './core/query-builder.js';
3
+ export { ClickHouseConnection } from './core/connection.js';
4
+ export { JoinRelationships } from './core/join-relationships.js';
5
+ export { CrossFilter } from './core/cross-filter.js';
6
+ export { logger } from './core/utils/logger.js';
7
+ export { CacheController } from './core/cache/controller.js';
8
+ export { MemoryCacheProvider } from './core/cache/providers/memory-lru.js';
9
+ export { MemoryCacheProvider as MemoryLRUCacheProvider } from './core/cache/providers/memory-lru.js';
10
+ export { NoopCacheProvider } from './core/cache/providers/noop.js';
11
+ export {
12
+ raw,
13
+ rawAs,
14
+ toDateTime,
15
+ formatDateTime,
16
+ toStartOfInterval,
17
+ datePart
18
+ } from './core/utils/sql-expressions.js';
19
+
20
+ // Note: CLI functionality is deliberately not exported from the main package
21
+ // This prevents Node.js-specific modules from being included in browser bundles
@@ -0,0 +1,50 @@
1
+ import { FilterOperator } from "./filters.js";
2
+ import type { TableColumn } from './schema.js';
3
+ export interface QueryConfig<T, Schema> {
4
+ select?: Array<keyof T | string>;
5
+ where?: WhereCondition[];
6
+ groupBy?: string[];
7
+ having?: string[];
8
+ limit?: number;
9
+ offset?: number;
10
+ distinct?: boolean;
11
+ orderBy?: Array<{
12
+ column: keyof T | TableColumn<Schema>;
13
+ direction: OrderDirection;
14
+ }>;
15
+ joins?: JoinClause[];
16
+ parameters?: any[];
17
+ ctes?: string[];
18
+ unionQueries?: string[];
19
+ settings?: string;
20
+ }
21
+ export type { ColumnType, TableSchema, DatabaseSchema, TableRecord, InferColumnType, TableColumn } from './schema.js';
22
+ export type WhereExpression = string;
23
+ export type GroupByExpression<T> = keyof T | Array<keyof T>;
24
+ export type OrderDirection = 'ASC' | 'DESC';
25
+ export interface StandardWhereCondition {
26
+ column: string;
27
+ operator: FilterOperator;
28
+ value: any;
29
+ conjunction: 'AND' | 'OR';
30
+ type?: 'condition' | 'group-start' | 'group-end';
31
+ }
32
+ export interface ExpressionWhereCondition {
33
+ type: 'expression';
34
+ expression: string;
35
+ parameters: any[];
36
+ conjunction: 'AND' | 'OR';
37
+ }
38
+ export type WhereCondition = StandardWhereCondition | ExpressionWhereCondition;
39
+ export type JoinType = 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
40
+ export interface JoinClause {
41
+ type: JoinType;
42
+ table: string;
43
+ leftColumn: string;
44
+ rightColumn: string;
45
+ alias?: string;
46
+ }
47
+ export type AggregationType<T, Aggregations, Column, A extends string, Suffix extends string, HasSelect extends boolean> = HasSelect extends true ? {
48
+ [K in keyof T | A]: K extends keyof T ? T[K] : string;
49
+ } : Aggregations extends Record<string, string> ? Aggregations & Record<A extends undefined ? `${Column & string}_${Suffix}` : A, string> : Record<A extends undefined ? `${Column & string}_${Suffix}` : A, string>;
50
+ //# sourceMappingURL=base.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,17 @@
1
+ export type ClickHouseInteger = 'Int8' | 'Int16' | 'Int32' | 'Int64' | 'Int128' | 'Int256' | 'UInt8' | 'UInt16' | 'UInt32' | 'UInt64' | 'UInt128' | 'UInt256';
2
+ export type ClickHouseFloat = 'Float32' | 'Float64';
3
+ export type ClickHouseDecimal = 'Decimal32' | 'Decimal64' | 'Decimal128' | 'Decimal256' | `Decimal(${number}, ${number})`;
4
+ export type ClickHouseDateTime = 'Date' | 'Date32' | 'DateTime' | `DateTime('${string}')` | `DateTime64(${number})` | `DateTime64(${number}, '${string}')`;
5
+ export type ClickHouseString = 'String' | `FixedString(${number})` | 'UUID';
6
+ export type ClickHouseBoolean = 'Bool' | 'Boolean';
7
+ export type ClickHouseEnum = `Enum8(${string})` | `Enum16(${string})`;
8
+ export type ClickHouseBaseType = ClickHouseInteger | ClickHouseFloat | ClickHouseDecimal | ClickHouseDateTime | ClickHouseString | ClickHouseBoolean | ClickHouseEnum;
9
+ export type ClickHouseType = ClickHouseBaseType | `Array(${ClickHouseBaseType})` | `Array(Nullable(${ClickHouseBaseType}))` | `Array(LowCardinality(String))` | `Array(LowCardinality(${ClickHouseEnum}))` | `Nullable(${ClickHouseBaseType})` | `Nullable(Array(${ClickHouseBaseType}))` | `LowCardinality(${ClickHouseString})` | `LowCardinality(${ClickHouseEnum})` | `LowCardinality(Nullable(${ClickHouseString}))` | `LowCardinality(Nullable(${ClickHouseEnum}))` | `Map(String, ${ClickHouseBaseType})` | `Map(String, Array(${ClickHouseBaseType}))` | `Map(String, Nullable(${ClickHouseBaseType}))` | `Map(LowCardinality(String), ${ClickHouseBaseType})` | `Map(LowCardinality(String), Array(${ClickHouseBaseType}))` | `Map(LowCardinality(String), Nullable(${ClickHouseBaseType}))` | `Map(${ClickHouseInteger}, ${ClickHouseBaseType})` | `Map(${ClickHouseInteger}, Array(${ClickHouseBaseType}))` | `Map(${ClickHouseInteger}, Nullable(${ClickHouseBaseType}))` | `Array(Map(String, ${ClickHouseBaseType}))` | `Array(Map(LowCardinality(String), ${ClickHouseBaseType}))` | `Array(Map(${ClickHouseInteger}, ${ClickHouseBaseType}))` | `Nullable(Map(String, ${ClickHouseBaseType}))` | `Nullable(Map(LowCardinality(String), ${ClickHouseBaseType}))`;
10
+ export type InferClickHouseType<T extends ClickHouseType, Depth extends number = 0> = Depth extends 5 ? unknown : T extends ClickHouseInteger ? number : T extends ClickHouseFloat ? number : T extends ClickHouseDecimal ? number : T extends ClickHouseDateTime ? string : T extends ClickHouseString ? string : T extends ClickHouseEnum ? string : T extends ClickHouseBoolean ? boolean : T extends `Array(${infer U})` ? U extends ClickHouseType ? Array<InferClickHouseType<U, Add1<Depth>>> : unknown[] : T extends `Nullable(${infer U})` ? U extends ClickHouseType ? InferClickHouseType<U, Add1<Depth>> | null : unknown | null : T extends `LowCardinality(${infer U})` ? U extends `Nullable(${infer V})` ? V extends ClickHouseString | ClickHouseEnum ? InferClickHouseType<V, Add1<Depth>> | null : unknown | null : U extends ClickHouseString | ClickHouseEnum ? InferClickHouseType<U, Add1<Depth>> : unknown : T extends `Map(${string}, ${infer V})` ? V extends ClickHouseType ? Record<string, InferClickHouseType<V, Add1<Depth>>> : Record<string, unknown> : unknown;
11
+ type Add1<T extends number> = T extends 0 ? 1 : T extends 1 ? 2 : T extends 2 ? 3 : T extends 3 ? 4 : 5;
12
+ export type ClickHouseSchema = Record<string, ClickHouseType>;
13
+ export type InferSchemaType<T extends ClickHouseSchema> = {
14
+ [K in keyof T]: InferClickHouseType<T[K]>;
15
+ };
16
+ export {};
17
+ //# sourceMappingURL=clickhouse-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clickhouse-types.d.ts","sourceRoot":"","sources":["../../src/types/clickhouse-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,53 @@
1
+ import { TableColumn } from './schema.js';
2
+ export type FilterValue<T> = T extends Date ? Date | string : T extends number ? number : T extends string ? string : T extends boolean ? boolean : never;
3
+ export type FilterCondition<T> = {
4
+ eq: FilterValue<T>;
5
+ neq: FilterValue<T>;
6
+ gt: T extends number | Date ? FilterValue<T> : never;
7
+ gte: T extends number | Date ? FilterValue<T> : never;
8
+ lt: T extends number | Date ? FilterValue<T> : never;
9
+ lte: T extends number | Date ? FilterValue<T> : never;
10
+ in: FilterValue<T>[];
11
+ notIn: FilterValue<T>[];
12
+ between: [FilterValue<T>, FilterValue<T>] | [string, string];
13
+ like: T extends string ? string : never;
14
+ notLike: T extends string ? string : never;
15
+ globalIn: FilterValue<T>[];
16
+ globalNotIn: FilterValue<T>[];
17
+ inSubquery: string;
18
+ globalInSubquery: string;
19
+ inTable: string;
20
+ globalInTable: string;
21
+ inTuple: [FilterValue<T>, FilterValue<T>][];
22
+ globalInTuple: [FilterValue<T>, FilterValue<T>][];
23
+ };
24
+ export type FilterValueType<T, Op extends FilterOperator, Schema = any> = Op extends 'in' | 'notIn' | 'globalIn' | 'globalNotIn' ? T extends (infer U)[] ? U[] : T[] : Op extends 'between' ? [T, T] | [string, string] : Op extends 'inSubquery' | 'globalInSubquery' ? string : Op extends 'inTable' | 'globalInTable' ? keyof Schema : Op extends 'inTuple' | 'globalInTuple' ? [T, T][] : T;
25
+ export type OperatorValueMap<T, Schema = any> = {
26
+ 'eq': T | string;
27
+ 'neq': T | string;
28
+ 'gt': T extends string | number | Date ? T | string : never;
29
+ 'lt': T extends string | number | Date ? T | string : never;
30
+ 'gte': T extends string | number | Date ? T | string : never;
31
+ 'lte': T extends string | number | Date ? T | string : never;
32
+ 'in': (T | string)[];
33
+ 'notIn': (T | string)[];
34
+ 'between': [T | string, T | string] | [string, string];
35
+ 'like': T extends string ? string : never;
36
+ 'notLike': T extends string ? string : never;
37
+ 'globalIn': (T | string)[];
38
+ 'globalNotIn': (T | string)[];
39
+ 'inSubquery': string;
40
+ 'globalInSubquery': string;
41
+ 'inTable': keyof Schema;
42
+ 'globalInTable': keyof Schema;
43
+ 'inTuple': [T | string, T | string][];
44
+ 'globalInTuple': [T | string, T | string][];
45
+ };
46
+ export type FilterOperator = keyof OperatorValueMap<any>;
47
+ export interface FilterConditionInput<T = any, Schema extends Record<string, Record<string, any>> = any, OriginalT extends Record<string, any> = any> {
48
+ column: keyof OriginalT | TableColumn<Schema>;
49
+ operator: FilterOperator;
50
+ value: T;
51
+ conjunction?: 'AND' | 'OR';
52
+ }
53
+ //# sourceMappingURL=filters.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/types/filters.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,5 @@
1
+ export * from './base.js';
2
+ export * from './filters.js';
3
+ export * from './clickhouse-types.js';
4
+ export * from './schema.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}
@@ -0,0 +1,4 @@
1
+ export * from './base.js';
2
+ export * from './filters.js';
3
+ export * from './clickhouse-types.js';
4
+ export * from './schema.js';
@@ -0,0 +1,19 @@
1
+ import { ClickHouseType, InferClickHouseType } from './clickhouse-types.js';
2
+ export type ColumnType = ClickHouseType;
3
+ export type InferColumnType<T extends ColumnType> = InferClickHouseType<T>;
4
+ export type DatabaseSchema = Record<string, Record<string, ColumnType>>;
5
+ export type AnySchema = Record<string, Record<string, ColumnType>>;
6
+ export interface TableSchema<TColumns> {
7
+ name: string;
8
+ columns: TColumns;
9
+ }
10
+ export type TableRecord<TColumns> = {
11
+ [K in keyof TColumns]: InferColumnType<Extract<TColumns[K], ColumnType>>;
12
+ };
13
+ export type QualifiedColumn<Schema, TableName extends keyof Schema> = `${string & TableName}.${string & keyof Schema[TableName]}`;
14
+ export type ColumnIdentifier<Schema, TableName extends keyof Schema> = QualifiedColumn<Schema, TableName> | keyof Schema[TableName];
15
+ export type TableColumnForTables<Schema, Tables extends keyof Schema = keyof Schema> = {
16
+ [TableName in Tables]: ColumnIdentifier<Schema, TableName>;
17
+ }[Tables];
18
+ export type TableColumn<Schema> = TableColumnForTables<Schema>;
19
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AAExC,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,UAAU,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE3E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnE,MAAM,WAAW,WAAW,CAAC,QAAQ;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,CAAC,QAAQ,IAAI;KACjC,CAAC,IAAI,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IAChE,GAAG,MAAM,GAAG,SAAS,IAAI,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;AAE9D,MAAM,MAAM,gBAAgB,CAAC,MAAM,EAAE,SAAS,SAAS,MAAM,MAAM,IACjE,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;AAE/D,MAAM,MAAM,oBAAoB,CAAC,MAAM,EAAE,MAAM,SAAS,MAAM,MAAM,GAAG,MAAM,MAAM,IAAI;KACpF,SAAS,IAAI,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC;CAC3D,CAAC,MAAM,CAAC,CAAC;AAEV,MAAM,MAAM,WAAW,CAAC,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
package/package.json ADDED
@@ -0,0 +1,90 @@
1
+ {
2
+ "name": "@hypequery/clickhouse",
3
+ "version": "0.0.0-canary-20260306132943",
4
+ "description": "ClickHouse typescript query builder",
5
+ "main": "dist/index.js",
6
+ "types": "dist/index.d.ts",
7
+ "type": "module",
8
+ "browser": {
9
+ "./dist/core/env/auto-client.js": "./dist/core/env/auto-client.browser.js"
10
+ },
11
+ "exports": {
12
+ ".": {
13
+ "types": "./dist/index.d.ts",
14
+ "import": "./dist/index.js",
15
+ "require": "./dist/index.js"
16
+ },
17
+ "./cli": {
18
+ "types": "./dist/cli/index.d.ts",
19
+ "import": "./dist/cli/index.js",
20
+ "require": "./dist/cli/index.js"
21
+ }
22
+ },
23
+ "license": "Apache-2.0",
24
+ "bin": {
25
+ "hypequery-generate-types": "./dist/cli/bin.js"
26
+ },
27
+ "files": [
28
+ "dist",
29
+ "README-CLI.md"
30
+ ],
31
+ "dependencies": {
32
+ "@clickhouse/client": "^1.11.2",
33
+ "dotenv": "^16.0.0"
34
+ },
35
+ "peerDependencies": {
36
+ "@clickhouse/client-web": "^0.2.0 || ^1.0.0"
37
+ },
38
+ "peerDependenciesMeta": {
39
+ "@clickhouse/client-web": {
40
+ "optional": true
41
+ }
42
+ },
43
+ "devDependencies": {
44
+ "@clickhouse/client": "^1.11.2",
45
+ "@clickhouse/client-common": "^1.11.2",
46
+ "@clickhouse/client-web": "^1.11.2",
47
+ "@types/node": "^18.19.80",
48
+ "glob": "^11.0.3",
49
+ "ts-node": "^10.9.0",
50
+ "typedoc": "^0.28.1",
51
+ "typedoc-plugin-markdown": "^4.6.0",
52
+ "typescript": "^5.7.3",
53
+ "@vitest/coverage-v8": "^2.1.6",
54
+ "vitest": "^2.1.6"
55
+ },
56
+ "ts-node": {
57
+ "esm": true,
58
+ "experimentalSpecifiers": true
59
+ },
60
+ "repository": {
61
+ "type": "git",
62
+ "url": "https://github.com/hypequery/hypequery.git"
63
+ },
64
+ "homepage": "https://hypequery.com",
65
+ "bugs": {
66
+ "url": "https://github.com/hypequery/hypequery/issues"
67
+ },
68
+ "publishConfig": {
69
+ "access": "public"
70
+ },
71
+ "scripts": {
72
+ "build": "npm run build:main && npm run build:cli && npm run verify-build || npm run diagnose-ci",
73
+ "build:main": "tsc --project tsconfig.json",
74
+ "build:cli": "node scripts/ensure-core-files.js && node scripts/handle-cli-files.js",
75
+ "build:ci": "npm run build:main && node scripts/ensure-core-files.js && node scripts/handle-cli-files.js && npm run verify-build || npm run diagnose-ci",
76
+ "verify-build": "node scripts/verify-build.js",
77
+ "diagnose-ci": "node scripts/diagnose-ci.js",
78
+ "dev": "tsc --watch",
79
+ "test": "npm run test:types && npm run test:unit",
80
+ "test:unit": "vitest run --config vitest.config.ts",
81
+ "test:types": "tsc --project tsconfig.type-tests.json",
82
+ "test:integration": "node scripts/run-integration-tests.js",
83
+ "test:watch": "vitest watch --config vitest.config.ts",
84
+ "test:coverage": "vitest run --coverage --config vitest.config.ts",
85
+ "test:cli": "node scripts/test-cli-integration.js",
86
+ "lint": "eslint --ext .ts \"src/**/*.ts\"",
87
+ "docs:api": "typedoc --options typedoc.json",
88
+ "docs:mdx": "npm run docs:api && node scripts/process-typedoc-markdown.js"
89
+ }
90
+ }