@514labs/moose-lib 0.6.297-ci-29-gef88e0aa → 0.6.297-ci-4-g8012f636

package/dist/{index-CcHF2cVT.d.mts → index-B9bvaKAq.d.mts}

@@ -259,6 +259,42 @@ interface TableIndex {
     arguments?: string[];
     granularity?: number;
 }
+/**
+ * Defines a ClickHouse projection for optimizing specific query patterns.
+ * Projections duplicate data with different sort orders or pre-computed aggregations.
+ *
+ * ClickHouse rules:
+ * - Non-aggregate projections: Must have ORDER BY
+ * - Aggregate projections (with GROUP BY): Cannot have ORDER BY (ordering is implicit from GROUP BY)
+ */
+type TableProjection<T = any> = {
+    /** Unique name for the projection */
+    name: string;
+} & ({
+    /** List of column names to include in non-aggregate projection */
+    select: (keyof T & string)[];
+    /** Columns to order by (required for non-aggregate projections) */
+    orderBy: (keyof T & string)[];
+    groupBy?: never;
+} | {
+    /** List of column names to include in aggregate projection */
+    select: (keyof T & string)[];
+    /** GROUP BY columns (for aggregate projections). ORDER BY is implicit from this. */
+    groupBy: (keyof T & string)[];
+    orderBy?: never;
+} | {
+    /** SQL expression for SELECT clause (non-aggregate) */
+    select: string;
+    /** SQL expression for ORDER BY clause (required for non-aggregate projections) */
+    orderBy: string;
+    groupBy?: never;
+} | {
+    /** SQL expression for SELECT clause (aggregate) */
+    select: string;
+    /** SQL expression for GROUP BY clause (for aggregate projections). ORDER BY is implicit from this. */
+    groupBy: string;
+    orderBy?: never;
+});
 /**
  * Represents a failed record during insertion with error details
  */
@@ -458,6 +494,11 @@ type BaseOlapConfig<T> = ({
     ttl?: string;
     /** Optional secondary/data-skipping indexes */
     indexes?: TableIndex[];
+    /**
+     * Optional projections for optimizing specific query patterns.
+     * Projections store duplicate data with different sort orders or pre-computed aggregations.
+     */
+    projections?: TableProjection<T>[];
     /**
      * Optional database name for multi-database support.
      * When not specified, uses the global ClickHouse config database.

package/dist/{index-CcHF2cVT.d.ts → index-B9bvaKAq.d.ts}

@@ -259,6 +259,42 @@ interface TableIndex {
     arguments?: string[];
     granularity?: number;
 }
+/**
+ * Defines a ClickHouse projection for optimizing specific query patterns.
+ * Projections duplicate data with different sort orders or pre-computed aggregations.
+ *
+ * ClickHouse rules:
+ * - Non-aggregate projections: Must have ORDER BY
+ * - Aggregate projections (with GROUP BY): Cannot have ORDER BY (ordering is implicit from GROUP BY)
+ */
+type TableProjection<T = any> = {
+    /** Unique name for the projection */
+    name: string;
+} & ({
+    /** List of column names to include in non-aggregate projection */
+    select: (keyof T & string)[];
+    /** Columns to order by (required for non-aggregate projections) */
+    orderBy: (keyof T & string)[];
+    groupBy?: never;
+} | {
+    /** List of column names to include in aggregate projection */
+    select: (keyof T & string)[];
+    /** GROUP BY columns (for aggregate projections). ORDER BY is implicit from this. */
+    groupBy: (keyof T & string)[];
+    orderBy?: never;
+} | {
+    /** SQL expression for SELECT clause (non-aggregate) */
+    select: string;
+    /** SQL expression for ORDER BY clause (required for non-aggregate projections) */
+    orderBy: string;
+    groupBy?: never;
+} | {
+    /** SQL expression for SELECT clause (aggregate) */
+    select: string;
+    /** SQL expression for GROUP BY clause (for aggregate projections). ORDER BY is implicit from this. */
+    groupBy: string;
+    orderBy?: never;
+});
 /**
  * Represents a failed record during insertion with error details
  */
@@ -458,6 +494,11 @@ type BaseOlapConfig<T> = ({
     ttl?: string;
     /** Optional secondary/data-skipping indexes */
     indexes?: TableIndex[];
+    /**
+     * Optional projections for optimizing specific query patterns.
+     * Projections store duplicate data with different sort orders or pre-computed aggregations.
+     */
+    projections?: TableProjection<T>[];
     /**
      * Optional database name for multi-database support.
      * When not specified, uses the global ClickHouse config database.

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-export { C as ClickHouseByteSize, q as ClickHouseCodec, j as ClickHouseDecimal, n as ClickHouseDefault, k as ClickHouseFixedStringSize, l as ClickHouseFloat, a as ClickHouseInt, m as ClickHouseJson, e as ClickHouseLineString, p as ClickHouseMaterialized, f as ClickHouseMultiLineString, h as ClickHouseMultiPolygon, b as ClickHouseNamedTuple, c as ClickHousePoint, g as ClickHousePolygon, i as ClickHousePrecision, d as ClickHouseRing, o as ClickHouseTTL, D as DateTime, r as DateTime64, t as DateTime64String, s as DateTimeString, E as Decimal, F as FixedString, u as Float32, v as Float64, w as Int16, x as Int32, y as Int64, I as Int8, J as JWT, K as Key, L as LowCardinality, z as UInt16, A as UInt32, B as UInt64, U as UInt8, W as WithDefault } from './browserCompatible-FzU17dxm.mjs';
-import { a4 as MooseUtils, K as ApiUtil, a5 as MooseClient } from './index-CcHF2cVT.mjs';
-export { A as Aggregated, h as Api, i as ApiConfig, ae as ApiHelpers, a6 as Blocks, a7 as ClickHouseEngines, C as ConsumptionApi, af as ConsumptionHelpers, N as ConsumptionUtil, e as DeadLetter, D as DeadLetterModel, f as DeadLetterQueue, l as ETLPipeline, m as ETLPipelineConfig, E as EgressConfig, F as FrameworkApp, Q as IdentifierBrandedString, I as IngestApi, g as IngestConfig, j as IngestPipeline, L as LifeCycle, M as MaterializedView, R as NonIdentifierBrandedString, a as OlapConfig, O as OlapTable, ab as QueryClient, X as RawValue, b as S3QueueTableSettings, S as SimpleAggregated, Z as Sql, k as SqlResource, c as Stream, d as StreamConfig, T as Task, U as Value, V as View, n as WebApp, o as WebAppConfig, p as WebAppHandler, W as Workflow, ac as WorkflowClient, a2 as createClickhouseParameter, a9 as createMaterializedView, a8 as dropView, x as getApi, w as getApis, v as getIngestApi, u as getIngestApis, z as getSqlResource, y as getSqlResources, t as getStream, s as getStreams, r as getTable, q as getTables, ad as getTemporalClient, a1 as getValueFromParameter, J as getWebApp, H as getWebApps, G as getWorkflow, B as getWorkflows, ag as joinQueries, a3 as mapToClickHouseType, aa as populateTable, P as quoteIdentifier, Y as sql, $ as toQuery, a0 as toQueryPreview, _ as toStaticQuery } from './index-CcHF2cVT.mjs';
+export { C as ClickHouseByteSize, q as ClickHouseCodec, j as ClickHouseDecimal, n as ClickHouseDefault, k as ClickHouseFixedStringSize, l as ClickHouseFloat, a as ClickHouseInt, m as ClickHouseJson, e as ClickHouseLineString, p as ClickHouseMaterialized, f as ClickHouseMultiLineString, h as ClickHouseMultiPolygon, b as ClickHouseNamedTuple, c as ClickHousePoint, g as ClickHousePolygon, i as ClickHousePrecision, d as ClickHouseRing, o as ClickHouseTTL, D as DateTime, r as DateTime64, t as DateTime64String, s as DateTimeString, E as Decimal, F as FixedString, u as Float32, v as Float64, w as Int16, x as Int32, y as Int64, I as Int8, J as JWT, K as Key, L as LowCardinality, z as UInt16, A as UInt32, B as UInt64, U as UInt8, W as WithDefault } from './browserCompatible-nqz7MwT7.mjs';
+import { a4 as MooseUtils, K as ApiUtil, a5 as MooseClient } from './index-B9bvaKAq.mjs';
+export { A as Aggregated, h as Api, i as ApiConfig, ae as ApiHelpers, a6 as Blocks, a7 as ClickHouseEngines, C as ConsumptionApi, af as ConsumptionHelpers, N as ConsumptionUtil, e as DeadLetter, D as DeadLetterModel, f as DeadLetterQueue, l as ETLPipeline, m as ETLPipelineConfig, E as EgressConfig, F as FrameworkApp, Q as IdentifierBrandedString, I as IngestApi, g as IngestConfig, j as IngestPipeline, L as LifeCycle, M as MaterializedView, R as NonIdentifierBrandedString, a as OlapConfig, O as OlapTable, ab as QueryClient, X as RawValue, b as S3QueueTableSettings, S as SimpleAggregated, Z as Sql, k as SqlResource, c as Stream, d as StreamConfig, T as Task, U as Value, V as View, n as WebApp, o as WebAppConfig, p as WebAppHandler, W as Workflow, ac as WorkflowClient, a2 as createClickhouseParameter, a9 as createMaterializedView, a8 as dropView, x as getApi, w as getApis, v as getIngestApi, u as getIngestApis, z as getSqlResource, y as getSqlResources, t as getStream, s as getStreams, r as getTable, q as getTables, ad as getTemporalClient, a1 as getValueFromParameter, J as getWebApp, H as getWebApps, G as getWorkflow, B as getWorkflows, ag as joinQueries, a3 as mapToClickHouseType, aa as populateTable, P as quoteIdentifier, Y as sql, $ as toQuery, a0 as toQueryPreview, _ as toStaticQuery } from './index-B9bvaKAq.mjs';
 import * as _clickhouse_client from '@clickhouse/client';
 import { KafkaJS } from '@514labs/kafka-javascript';
 import http from 'http';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { C as ClickHouseByteSize, q as ClickHouseCodec, j as ClickHouseDecimal, n as ClickHouseDefault, k as ClickHouseFixedStringSize, l as ClickHouseFloat, a as ClickHouseInt, m as ClickHouseJson, e as ClickHouseLineString, p as ClickHouseMaterialized, f as ClickHouseMultiLineString, h as ClickHouseMultiPolygon, b as ClickHouseNamedTuple, c as ClickHousePoint, g as ClickHousePolygon, i as ClickHousePrecision, d as ClickHouseRing, o as ClickHouseTTL, D as DateTime, r as DateTime64, t as DateTime64String, s as DateTimeString, E as Decimal, F as FixedString, u as Float32, v as Float64, w as Int16, x as Int32, y as Int64, I as Int8, J as JWT, K as Key, L as LowCardinality, z as UInt16, A as UInt32, B as UInt64, U as UInt8, W as WithDefault } from './browserCompatible-CMEunMFq.js';
-import { a4 as MooseUtils, K as ApiUtil, a5 as MooseClient } from './index-CcHF2cVT.js';
-export { A as Aggregated, h as Api, i as ApiConfig, ae as ApiHelpers, a6 as Blocks, a7 as ClickHouseEngines, C as ConsumptionApi, af as ConsumptionHelpers, N as ConsumptionUtil, e as DeadLetter, D as DeadLetterModel, f as DeadLetterQueue, l as ETLPipeline, m as ETLPipelineConfig, E as EgressConfig, F as FrameworkApp, Q as IdentifierBrandedString, I as IngestApi, g as IngestConfig, j as IngestPipeline, L as LifeCycle, M as MaterializedView, R as NonIdentifierBrandedString, a as OlapConfig, O as OlapTable, ab as QueryClient, X as RawValue, b as S3QueueTableSettings, S as SimpleAggregated, Z as Sql, k as SqlResource, c as Stream, d as StreamConfig, T as Task, U as Value, V as View, n as WebApp, o as WebAppConfig, p as WebAppHandler, W as Workflow, ac as WorkflowClient, a2 as createClickhouseParameter, a9 as createMaterializedView, a8 as dropView, x as getApi, w as getApis, v as getIngestApi, u as getIngestApis, z as getSqlResource, y as getSqlResources, t as getStream, s as getStreams, r as getTable, q as getTables, ad as getTemporalClient, a1 as getValueFromParameter, J as getWebApp, H as getWebApps, G as getWorkflow, B as getWorkflows, ag as joinQueries, a3 as mapToClickHouseType, aa as populateTable, P as quoteIdentifier, Y as sql, $ as toQuery, a0 as toQueryPreview, _ as toStaticQuery } from './index-CcHF2cVT.js';
+export { C as ClickHouseByteSize, q as ClickHouseCodec, j as ClickHouseDecimal, n as ClickHouseDefault, k as ClickHouseFixedStringSize, l as ClickHouseFloat, a as ClickHouseInt, m as ClickHouseJson, e as ClickHouseLineString, p as ClickHouseMaterialized, f as ClickHouseMultiLineString, h as ClickHouseMultiPolygon, b as ClickHouseNamedTuple, c as ClickHousePoint, g as ClickHousePolygon, i as ClickHousePrecision, d as ClickHouseRing, o as ClickHouseTTL, D as DateTime, r as DateTime64, t as DateTime64String, s as DateTimeString, E as Decimal, F as FixedString, u as Float32, v as Float64, w as Int16, x as Int32, y as Int64, I as Int8, J as JWT, K as Key, L as LowCardinality, z as UInt16, A as UInt32, B as UInt64, U as UInt8, W as WithDefault } from './browserCompatible-ZQ9mCsFj.js';
+import { a4 as MooseUtils, K as ApiUtil, a5 as MooseClient } from './index-B9bvaKAq.js';
+export { A as Aggregated, h as Api, i as ApiConfig, ae as ApiHelpers, a6 as Blocks, a7 as ClickHouseEngines, C as ConsumptionApi, af as ConsumptionHelpers, N as ConsumptionUtil, e as DeadLetter, D as DeadLetterModel, f as DeadLetterQueue, l as ETLPipeline, m as ETLPipelineConfig, E as EgressConfig, F as FrameworkApp, Q as IdentifierBrandedString, I as IngestApi, g as IngestConfig, j as IngestPipeline, L as LifeCycle, M as MaterializedView, R as NonIdentifierBrandedString, a as OlapConfig, O as OlapTable, ab as QueryClient, X as RawValue, b as S3QueueTableSettings, S as SimpleAggregated, Z as Sql, k as SqlResource, c as Stream, d as StreamConfig, T as Task, U as Value, V as View, n as WebApp, o as WebAppConfig, p as WebAppHandler, W as Workflow, ac as WorkflowClient, a2 as createClickhouseParameter, a9 as createMaterializedView, a8 as dropView, x as getApi, w as getApis, v as getIngestApi, u as getIngestApis, z as getSqlResource, y as getSqlResources, t as getStream, s as getStreams, r as getTable, q as getTables, ad as getTemporalClient, a1 as getValueFromParameter, J as getWebApp, H as getWebApps, G as getWorkflow, B as getWorkflows, ag as joinQueries, a3 as mapToClickHouseType, aa as populateTable, P as quoteIdentifier, Y as sql, $ as toQuery, a0 as toQueryPreview, _ as toStaticQuery } from './index-B9bvaKAq.js';
 import * as _clickhouse_client from '@clickhouse/client';
 import { KafkaJS } from '@514labs/kafka-javascript';
 import http from 'http';