@volter/world-core 2.0.37 → 3.0.0

package/src/clickhouse/types.ts

@@ -0,0 +1,44 @@
+// The ClickHouse® type vocabulary the kernel's engine reads: a relation's column (its name and its type, as ClickHouse
+// spells it), a type unwrapped of Nullable and Array, and whether a type is one the engine models.
+export type ClickHouseColumn = { name: string; type: string; jsonpath?: string; defaultExpr?: string };
+
+export const INT_TYPES = new Set(['Int8', 'Int16', 'Int32', 'Int64', 'Int128', 'Int256']);
+
+export const UINT_TYPES = new Set(['UInt8', 'UInt16', 'UInt32', 'UInt64', 'UInt128', 'UInt256']);
+
+export const FLOAT_TYPES = new Set(['Float32', 'Float64']);
+
+/** Strip the wrappers a schema line may carry, reporting what they said. */
+export function unwrapType(type: string): { base: string; nullable: boolean; array: boolean } {
+  let t = type.trim();
+  let nullable = false;
+  let array = false;
+  // LowCardinality is a storage hint, not a value domain — peel it and keep going.
+  for (let guard = 0; guard < 4; guard++) {
+    const low = /^LowCardinality\((.*)\)$/s.exec(t);
+    if (low) { t = low[1]!.trim(); continue; }
+    const nul = /^Nullable\((.*)\)$/s.exec(t);
+    if (nul) { nullable = true; t = nul[1]!.trim(); continue; }
+    const arr = /^Array\((.*)\)$/s.exec(t);
+    if (arr) { array = true; t = arr[1]!.trim(); continue; }
+    break;
+  }
+  return { base: t, nullable, array };
+}
+
+/** Type names this twin recognises in a `schema` parameter. An UNKNOWN name is refused rather than
+ *  stored verbatim: a Data Source whose column type is a typo would validate nothing forever. */
+export function isModeledSchemaType(type: string): boolean {
+  const { base } = unwrapType(type);
+  const head = base.replace(/\(.*\)$/s, '').trim();
+  if (KNOWN_TYPE_HEADS.has(head)) return true;
+  return false;
+}
+
+const KNOWN_TYPE_HEADS = new Set([
+  ...INT_TYPES, ...UINT_TYPES, ...FLOAT_TYPES,
+  'String', 'FixedString', 'UUID', 'IPv4', 'IPv6', 'Bool', 'Boolean',
+  'Date', 'Date32', 'DateTime', 'DateTime64', 'JSON',
+  'Decimal', 'Decimal32', 'Decimal64', 'Decimal128', 'Decimal256',
+  'Enum', 'Enum8', 'Enum16', 'Map', 'Tuple', 'Nested', 'AggregateFunction', 'SimpleAggregateFunction',
+]);