@514labs/moose-lib 0.6.295-ci-18-g185e40dc → 0.6.295-ci-16-gad4ec11a

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

@@ -1566,13 +1566,24 @@ declare class IngestApi<T> extends TypedBase<T, IngestConfig<T>> {
     constructor(name: string, config: IngestConfig<T>, schema: IJsonSchemaCollection$1.IV3_1, columns: Column[], validators: undefined, allowExtraFields: boolean);
 }
 
-interface ApiUtil {
+/**
+ * Utilities provided by getMooseUtils() for database access and SQL queries.
+ * Works in both Moose runtime and standalone contexts.
+ */
+interface MooseUtils {
     client: MooseClient;
     sql: typeof sql;
-    jwt: JWTPayload | undefined;
+    jwt?: JWTPayload;
 }
-/** @deprecated Use ApiUtil instead. */
-type ConsumptionUtil = ApiUtil;
+/**
+ * @deprecated Use MooseUtils instead. ApiUtil is now a type alias to MooseUtils
+ * and will be removed in a future version.
+ *
+ * Migration: Replace `ApiUtil` with `MooseUtils` in your type annotations.
+ */
+type ApiUtil = MooseUtils;
+/** @deprecated Use MooseUtils instead. */
+type ConsumptionUtil = MooseUtils;
 declare class MooseClient {
     query: QueryClient;
     workflow: WorkflowClient;
@@ -1883,21 +1894,50 @@ declare class ETLPipeline<T, U> {
     run(): Promise<void>;
 }
 
+type SqlObject = OlapTable<any> | SqlResource;
 /**
- * Represents a database View, defined by a SQL SELECT statement based on one or more base tables or other views.
- * Emits structured data for the Moose infrastructure system.
+ * Represents a generic SQL resource that requires setup and teardown commands.
+ * Base class for constructs like Views and Materialized Views. Tracks dependencies.
  */
-declare class View {
+declare class SqlResource {
     /** @internal */
-    readonly kind = "CustomView";
-    /** The name of the view */
+    readonly kind = "SqlResource";
+    /** Array of SQL statements to execute for setting up the resource. */
+    setup: readonly string[];
+    /** Array of SQL statements to execute for tearing down the resource. */
+    teardown: readonly string[];
+    /** The name of the SQL resource (e.g., view name, materialized view name). */
     name: string;
-    /** The SELECT SQL statement that defines the view */
-    selectSql: string;
-    /** Names of source tables/views that the SELECT reads from */
-    sourceTables: string[];
-    /** @internal Source file path where this view was defined */
+    /** List of OlapTables or Views that this resource reads data from. */
+    pullsDataFrom: SqlObject[];
+    /** List of OlapTables or Views that this resource writes data to. */
+    pushesDataTo: SqlObject[];
+    /** @internal Source file path where this resource was defined */
     sourceFile?: string;
+    /** @internal Source line number where this resource was defined */
+    sourceLine?: number;
+    /** @internal Source column number where this resource was defined */
+    sourceColumn?: number;
+    /**
+     * Creates a new SqlResource instance.
+     * @param name The name of the resource.
+     * @param setup An array of SQL DDL statements to create the resource.
+     * @param teardown An array of SQL DDL statements to drop the resource.
+     * @param options Optional configuration for specifying data dependencies.
+     * @param options.pullsDataFrom Tables/Views this resource reads from.
+     * @param options.pushesDataTo Tables/Views this resource writes to.
+     */
+    constructor(name: string, setup: readonly (string | Sql)[], teardown: readonly (string | Sql)[], options?: {
+        pullsDataFrom?: SqlObject[];
+        pushesDataTo?: SqlObject[];
+    });
+}
+
+/**
+ * Represents a database View, defined by a SQL SELECT statement based on one or more base tables or other views.
+ * Inherits from SqlResource, providing setup (CREATE VIEW) and teardown (DROP VIEW) commands.
+ */
+declare class View extends SqlResource {
     /**
      * Creates a new View instance.
      * @param name The name of the view to be created.
@@ -1943,19 +1983,9 @@ interface MaterializedViewConfig<T> {
  *
  * @template TargetTable The data type of the records stored in the underlying target OlapTable. The structure of T defines the target table schema.
  */
-declare class MaterializedView<TargetTable> {
-    /** @internal */
-    readonly kind = "MaterializedView";
-    /** The name of the materialized view */
-    name: string;
+declare class MaterializedView<TargetTable> extends SqlResource {
     /** The target OlapTable instance where the materialized data is stored. */
     targetTable: OlapTable<TargetTable>;
-    /** The SELECT SQL statement */
-    selectSql: string;
-    /** Names of source tables that the SELECT reads from */
-    sourceTables: string[];
-    /** @internal Source file path where this MV was defined */
-    sourceFile?: string;
     /**
      * Creates a new MaterializedView instance.
      * Requires the `TargetTable` type parameter to be explicitly provided or inferred,
@@ -1968,45 +1998,6 @@ declare class MaterializedView<TargetTable> {
     constructor(options: MaterializedViewConfig<TargetTable>, targetSchema: IJsonSchemaCollection$1.IV3_1, targetColumns: Column[]);
 }
 
-type SqlObject = OlapTable<any> | SqlResource;
-/**
- * Represents a generic SQL resource that requires setup and teardown commands.
- * Base class for constructs like Views and Materialized Views. Tracks dependencies.
- */
-declare class SqlResource {
-    /** @internal */
-    readonly kind = "SqlResource";
-    /** Array of SQL statements to execute for setting up the resource. */
-    setup: readonly string[];
-    /** Array of SQL statements to execute for tearing down the resource. */
-    teardown: readonly string[];
-    /** The name of the SQL resource (e.g., view name, materialized view name). */
-    name: string;
-    /** List of OlapTables or Views that this resource reads data from. */
-    pullsDataFrom: SqlObject[];
-    /** List of OlapTables or Views that this resource writes data to. */
-    pushesDataTo: SqlObject[];
-    /** @internal Source file path where this resource was defined */
-    sourceFile?: string;
-    /** @internal Source line number where this resource was defined */
-    sourceLine?: number;
-    /** @internal Source column number where this resource was defined */
-    sourceColumn?: number;
-    /**
-     * Creates a new SqlResource instance.
-     * @param name The name of the resource.
-     * @param setup An array of SQL DDL statements to create the resource.
-     * @param teardown An array of SQL DDL statements to drop the resource.
-     * @param options Optional configuration for specifying data dependencies.
-     * @param options.pullsDataFrom Tables/Views this resource reads from.
-     * @param options.pushesDataTo Tables/Views this resource writes to.
-     */
-    constructor(name: string, setup: readonly (string | Sql)[], teardown: readonly (string | Sql)[], options?: {
-        pullsDataFrom?: SqlObject[];
-        pushesDataTo?: SqlObject[];
-    });
-}
-
 type WebAppHandler = (req: http.IncomingMessage, res: http.ServerResponse) => void | Promise<void>;
 interface FrameworkApp {
     handle?: (req: http.IncomingMessage, res: http.ServerResponse, next?: (err?: any) => void) => void;
@@ -2123,28 +2114,6 @@ declare function getWebApps(): Map<string, WebApp>;
  * @returns The WebApp instance or undefined if not found
  */
 declare function getWebApp(name: string): WebApp | undefined;
-/**
- * Get all registered materialized views.
- * @returns A Map of MV name to MaterializedView instance
- */
-declare function getMaterializedViews(): Map<string, MaterializedView<any>>;
-/**
- * Get a registered materialized view by name.
- * @param name - The name of the materialized view
- * @returns The MaterializedView instance or undefined if not found
- */
-declare function getMaterializedView(name: string): MaterializedView<any> | undefined;
-/**
- * Get all registered custom views.
- * @returns A Map of view name to View instance
- */
-declare function getCustomViews(): Map<string, View>;
-/**
- * Get a registered custom view by name.
- * @param name - The name of the custom view
- * @returns The View instance or undefined if not found
- */
-declare function getCustomView(name: string): View | undefined;
 
 /**
  * @module dmv2
@@ -2186,4 +2155,4 @@ type SimpleAggregated<AggregationFunction extends string, ArgType = any> = {
     _argType?: ArgType;
 };
 
-export { type RawValue as $, type Aggregated as A, getWorkflows as B, ConsumptionApi as C, type DeadLetterModel as D, type EgressConfig as E, type FrameworkApp as F, getWorkflow as G, getWebApps as H, IngestApi as I, getWebApp as J, getCustomView as K, LifeCycle as L, MaterializedView as M, getCustomViews as N, OlapTable as O, getMaterializedView as P, getMaterializedViews as Q, type ApiUtil as R, type SimpleAggregated as S, Task as T, type ConsumptionUtil as U, View as V, Workflow as W, quoteIdentifier as X, type IdentifierBrandedString as Y, type NonIdentifierBrandedString as Z, type Value as _, type OlapConfig as a, sql as a0, Sql as a1, toStaticQuery as a2, toQuery as a3, toQueryPreview as a4, getValueFromParameter as a5, createClickhouseParameter as a6, mapToClickHouseType as a7, MooseClient as a8, type Blocks as a9, ClickHouseEngines as aa, dropView as ab, createMaterializedView as ac, populateTable as ad, QueryClient as ae, WorkflowClient as af, getTemporalClient as ag, ApiHelpers as ah, ConsumptionHelpers as ai, joinQueries as aj, type ConsumerConfig as ak, type TransformConfig as al, type TaskContext as am, type TaskConfig as an, type IngestPipelineConfig as ao, type MaterializedViewConfig as ap, type S3QueueTableSettings as b, Stream as c, type StreamConfig as d, type DeadLetter as e, DeadLetterQueue as f, type IngestConfig as g, Api as h, type ApiConfig as i, IngestPipeline as j, SqlResource as k, ETLPipeline as l, type ETLPipelineConfig as m, WebApp as n, type WebAppConfig as o, type WebAppHandler as p, getTables as q, getTable as r, getStreams as s, getStream as t, getIngestApis as u, getIngestApi as v, getApis as w, getApi as x, getSqlResources as y, getSqlResource as z };
+export { toQuery as $, type Aggregated as A, getWorkflows as B, ConsumptionApi as C, type DeadLetterModel as D, type EgressConfig as E, type FrameworkApp as F, getWorkflow as G, getWebApps as H, IngestApi as I, getWebApp as J, type ApiUtil as K, LifeCycle as L, MaterializedView as M, type ConsumptionUtil as N, OlapTable as O, quoteIdentifier as P, type IdentifierBrandedString as Q, type NonIdentifierBrandedString as R, type SimpleAggregated as S, Task as T, type Value as U, View as V, Workflow as W, type RawValue as X, sql as Y, Sql as Z, toStaticQuery as _, type OlapConfig as a, toQueryPreview as a0, getValueFromParameter as a1, createClickhouseParameter as a2, mapToClickHouseType as a3, type MooseUtils as a4, MooseClient as a5, type Blocks as a6, ClickHouseEngines as a7, dropView as a8, createMaterializedView as a9, populateTable as aa, QueryClient as ab, WorkflowClient as ac, getTemporalClient as ad, ApiHelpers as ae, ConsumptionHelpers as af, joinQueries as ag, type ConsumerConfig as ah, type TransformConfig as ai, type TaskContext as aj, type TaskConfig as ak, type IngestPipelineConfig as al, type MaterializedViewConfig as am, type S3QueueTableSettings as b, Stream as c, type StreamConfig as d, type DeadLetter as e, DeadLetterQueue as f, type IngestConfig as g, Api as h, type ApiConfig as i, IngestPipeline as j, SqlResource as k, ETLPipeline as l, type ETLPipelineConfig as m, WebApp as n, type WebAppConfig as o, type WebAppHandler as p, getTables as q, getTable as r, getStreams as s, getStream as t, getIngestApis as u, getIngestApi as v, getApis as w, getApi as x, getSqlResources as y, getSqlResource as z };

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

@@ -1566,13 +1566,24 @@ declare class IngestApi<T> extends TypedBase<T, IngestConfig<T>> {
     constructor(name: string, config: IngestConfig<T>, schema: IJsonSchemaCollection$1.IV3_1, columns: Column[], validators: undefined, allowExtraFields: boolean);
 }
 
-interface ApiUtil {
+/**
+ * Utilities provided by getMooseUtils() for database access and SQL queries.
+ * Works in both Moose runtime and standalone contexts.
+ */
+interface MooseUtils {
     client: MooseClient;
     sql: typeof sql;
-    jwt: JWTPayload | undefined;
+    jwt?: JWTPayload;
 }
-/** @deprecated Use ApiUtil instead. */
-type ConsumptionUtil = ApiUtil;
+/**
+ * @deprecated Use MooseUtils instead. ApiUtil is now a type alias to MooseUtils
+ * and will be removed in a future version.
+ *
+ * Migration: Replace `ApiUtil` with `MooseUtils` in your type annotations.
+ */
+type ApiUtil = MooseUtils;
+/** @deprecated Use MooseUtils instead. */
+type ConsumptionUtil = MooseUtils;
 declare class MooseClient {
     query: QueryClient;
     workflow: WorkflowClient;
@@ -1883,21 +1894,50 @@ declare class ETLPipeline<T, U> {
     run(): Promise<void>;
 }
 
+type SqlObject = OlapTable<any> | SqlResource;
 /**
- * Represents a database View, defined by a SQL SELECT statement based on one or more base tables or other views.
- * Emits structured data for the Moose infrastructure system.
+ * Represents a generic SQL resource that requires setup and teardown commands.
+ * Base class for constructs like Views and Materialized Views. Tracks dependencies.
  */
-declare class View {
+declare class SqlResource {
     /** @internal */
-    readonly kind = "CustomView";
-    /** The name of the view */
+    readonly kind = "SqlResource";
+    /** Array of SQL statements to execute for setting up the resource. */
+    setup: readonly string[];
+    /** Array of SQL statements to execute for tearing down the resource. */
+    teardown: readonly string[];
+    /** The name of the SQL resource (e.g., view name, materialized view name). */
     name: string;
-    /** The SELECT SQL statement that defines the view */
-    selectSql: string;
-    /** Names of source tables/views that the SELECT reads from */
-    sourceTables: string[];
-    /** @internal Source file path where this view was defined */
+    /** List of OlapTables or Views that this resource reads data from. */
+    pullsDataFrom: SqlObject[];
+    /** List of OlapTables or Views that this resource writes data to. */
+    pushesDataTo: SqlObject[];
+    /** @internal Source file path where this resource was defined */
     sourceFile?: string;
+    /** @internal Source line number where this resource was defined */
+    sourceLine?: number;
+    /** @internal Source column number where this resource was defined */
+    sourceColumn?: number;
+    /**
+     * Creates a new SqlResource instance.
+     * @param name The name of the resource.
+     * @param setup An array of SQL DDL statements to create the resource.
+     * @param teardown An array of SQL DDL statements to drop the resource.
+     * @param options Optional configuration for specifying data dependencies.
+     * @param options.pullsDataFrom Tables/Views this resource reads from.
+     * @param options.pushesDataTo Tables/Views this resource writes to.
+     */
+    constructor(name: string, setup: readonly (string | Sql)[], teardown: readonly (string | Sql)[], options?: {
+        pullsDataFrom?: SqlObject[];
+        pushesDataTo?: SqlObject[];
+    });
+}
+
+/**
+ * Represents a database View, defined by a SQL SELECT statement based on one or more base tables or other views.
+ * Inherits from SqlResource, providing setup (CREATE VIEW) and teardown (DROP VIEW) commands.
+ */
+declare class View extends SqlResource {
     /**
      * Creates a new View instance.
      * @param name The name of the view to be created.
@@ -1943,19 +1983,9 @@ interface MaterializedViewConfig<T> {
  *
  * @template TargetTable The data type of the records stored in the underlying target OlapTable. The structure of T defines the target table schema.
  */
-declare class MaterializedView<TargetTable> {
-    /** @internal */
-    readonly kind = "MaterializedView";
-    /** The name of the materialized view */
-    name: string;
+declare class MaterializedView<TargetTable> extends SqlResource {
     /** The target OlapTable instance where the materialized data is stored. */
     targetTable: OlapTable<TargetTable>;
-    /** The SELECT SQL statement */
-    selectSql: string;
-    /** Names of source tables that the SELECT reads from */
-    sourceTables: string[];
-    /** @internal Source file path where this MV was defined */
-    sourceFile?: string;
     /**
      * Creates a new MaterializedView instance.
      * Requires the `TargetTable` type parameter to be explicitly provided or inferred,
@@ -1968,45 +1998,6 @@ declare class MaterializedView<TargetTable> {
     constructor(options: MaterializedViewConfig<TargetTable>, targetSchema: IJsonSchemaCollection$1.IV3_1, targetColumns: Column[]);
 }
 
-type SqlObject = OlapTable<any> | SqlResource;
-/**
- * Represents a generic SQL resource that requires setup and teardown commands.
- * Base class for constructs like Views and Materialized Views. Tracks dependencies.
- */
-declare class SqlResource {
-    /** @internal */
-    readonly kind = "SqlResource";
-    /** Array of SQL statements to execute for setting up the resource. */
-    setup: readonly string[];
-    /** Array of SQL statements to execute for tearing down the resource. */
-    teardown: readonly string[];
-    /** The name of the SQL resource (e.g., view name, materialized view name). */
-    name: string;
-    /** List of OlapTables or Views that this resource reads data from. */
-    pullsDataFrom: SqlObject[];
-    /** List of OlapTables or Views that this resource writes data to. */
-    pushesDataTo: SqlObject[];
-    /** @internal Source file path where this resource was defined */
-    sourceFile?: string;
-    /** @internal Source line number where this resource was defined */
-    sourceLine?: number;
-    /** @internal Source column number where this resource was defined */
-    sourceColumn?: number;
-    /**
-     * Creates a new SqlResource instance.
-     * @param name The name of the resource.
-     * @param setup An array of SQL DDL statements to create the resource.
-     * @param teardown An array of SQL DDL statements to drop the resource.
-     * @param options Optional configuration for specifying data dependencies.
-     * @param options.pullsDataFrom Tables/Views this resource reads from.
-     * @param options.pushesDataTo Tables/Views this resource writes to.
-     */
-    constructor(name: string, setup: readonly (string | Sql)[], teardown: readonly (string | Sql)[], options?: {
-        pullsDataFrom?: SqlObject[];
-        pushesDataTo?: SqlObject[];
-    });
-}
-
 type WebAppHandler = (req: http.IncomingMessage, res: http.ServerResponse) => void | Promise<void>;
 interface FrameworkApp {
     handle?: (req: http.IncomingMessage, res: http.ServerResponse, next?: (err?: any) => void) => void;
@@ -2123,28 +2114,6 @@ declare function getWebApps(): Map<string, WebApp>;
  * @returns The WebApp instance or undefined if not found
  */
 declare function getWebApp(name: string): WebApp | undefined;
-/**
- * Get all registered materialized views.
- * @returns A Map of MV name to MaterializedView instance
- */
-declare function getMaterializedViews(): Map<string, MaterializedView<any>>;
-/**
- * Get a registered materialized view by name.
- * @param name - The name of the materialized view
- * @returns The MaterializedView instance or undefined if not found
- */
-declare function getMaterializedView(name: string): MaterializedView<any> | undefined;
-/**
- * Get all registered custom views.
- * @returns A Map of view name to View instance
- */
-declare function getCustomViews(): Map<string, View>;
-/**
- * Get a registered custom view by name.
- * @param name - The name of the custom view
- * @returns The View instance or undefined if not found
- */
-declare function getCustomView(name: string): View | undefined;
 
 /**
  * @module dmv2
@@ -2186,4 +2155,4 @@ type SimpleAggregated<AggregationFunction extends string, ArgType = any> = {
     _argType?: ArgType;
 };
 
-export { type RawValue as $, type Aggregated as A, getWorkflows as B, ConsumptionApi as C, type DeadLetterModel as D, type EgressConfig as E, type FrameworkApp as F, getWorkflow as G, getWebApps as H, IngestApi as I, getWebApp as J, getCustomView as K, LifeCycle as L, MaterializedView as M, getCustomViews as N, OlapTable as O, getMaterializedView as P, getMaterializedViews as Q, type ApiUtil as R, type SimpleAggregated as S, Task as T, type ConsumptionUtil as U, View as V, Workflow as W, quoteIdentifier as X, type IdentifierBrandedString as Y, type NonIdentifierBrandedString as Z, type Value as _, type OlapConfig as a, sql as a0, Sql as a1, toStaticQuery as a2, toQuery as a3, toQueryPreview as a4, getValueFromParameter as a5, createClickhouseParameter as a6, mapToClickHouseType as a7, MooseClient as a8, type Blocks as a9, ClickHouseEngines as aa, dropView as ab, createMaterializedView as ac, populateTable as ad, QueryClient as ae, WorkflowClient as af, getTemporalClient as ag, ApiHelpers as ah, ConsumptionHelpers as ai, joinQueries as aj, type ConsumerConfig as ak, type TransformConfig as al, type TaskContext as am, type TaskConfig as an, type IngestPipelineConfig as ao, type MaterializedViewConfig as ap, type S3QueueTableSettings as b, Stream as c, type StreamConfig as d, type DeadLetter as e, DeadLetterQueue as f, type IngestConfig as g, Api as h, type ApiConfig as i, IngestPipeline as j, SqlResource as k, ETLPipeline as l, type ETLPipelineConfig as m, WebApp as n, type WebAppConfig as o, type WebAppHandler as p, getTables as q, getTable as r, getStreams as s, getStream as t, getIngestApis as u, getIngestApi as v, getApis as w, getApi as x, getSqlResources as y, getSqlResource as z };
+export { toQuery as $, type Aggregated as A, getWorkflows as B, ConsumptionApi as C, type DeadLetterModel as D, type EgressConfig as E, type FrameworkApp as F, getWorkflow as G, getWebApps as H, IngestApi as I, getWebApp as J, type ApiUtil as K, LifeCycle as L, MaterializedView as M, type ConsumptionUtil as N, OlapTable as O, quoteIdentifier as P, type IdentifierBrandedString as Q, type NonIdentifierBrandedString as R, type SimpleAggregated as S, Task as T, type Value as U, View as V, Workflow as W, type RawValue as X, sql as Y, Sql as Z, toStaticQuery as _, type OlapConfig as a, toQueryPreview as a0, getValueFromParameter as a1, createClickhouseParameter as a2, mapToClickHouseType as a3, type MooseUtils as a4, MooseClient as a5, type Blocks as a6, ClickHouseEngines as a7, dropView as a8, createMaterializedView as a9, populateTable as aa, QueryClient as ab, WorkflowClient as ac, getTemporalClient as ad, ApiHelpers as ae, ConsumptionHelpers as af, joinQueries as ag, type ConsumerConfig as ah, type TransformConfig as ai, type TaskContext as aj, type TaskConfig as ak, type IngestPipelineConfig as al, type MaterializedViewConfig as am, type S3QueueTableSettings as b, Stream as c, type StreamConfig as d, type DeadLetter as e, DeadLetterQueue as f, type IngestConfig as g, Api as h, type ApiConfig as i, IngestPipeline as j, SqlResource as k, ETLPipeline as l, type ETLPipelineConfig as m, WebApp as n, type WebAppConfig as o, type WebAppHandler as p, getTables as q, getTable as r, getStreams as s, getStream as t, getIngestApis as u, getIngestApi as v, getApis as w, getApi as x, getSqlResources as y, getSqlResource as z };

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-DCCiBirg.mjs';
-import { R as ApiUtil, a8 as MooseClient } from './index-CcZRaA0b.mjs';
-export { A as Aggregated, h as Api, i as ApiConfig, ah as ApiHelpers, a9 as Blocks, aa as ClickHouseEngines, C as ConsumptionApi, ai as ConsumptionHelpers, U as ConsumptionUtil, e as DeadLetter, D as DeadLetterModel, f as DeadLetterQueue, l as ETLPipeline, m as ETLPipelineConfig, E as EgressConfig, F as FrameworkApp, Y as IdentifierBrandedString, I as IngestApi, g as IngestConfig, j as IngestPipeline, L as LifeCycle, M as MaterializedView, Z as NonIdentifierBrandedString, a as OlapConfig, O as OlapTable, ae as QueryClient, $ as RawValue, b as S3QueueTableSettings, S as SimpleAggregated, a1 as Sql, k as SqlResource, c as Stream, d as StreamConfig, T as Task, _ as Value, V as View, n as WebApp, o as WebAppConfig, p as WebAppHandler, W as Workflow, af as WorkflowClient, a6 as createClickhouseParameter, ac as createMaterializedView, ab as dropView, x as getApi, w as getApis, K as getCustomView, N as getCustomViews, v as getIngestApi, u as getIngestApis, P as getMaterializedView, Q as getMaterializedViews, z as getSqlResource, y as getSqlResources, t as getStream, s as getStreams, r as getTable, q as getTables, ag as getTemporalClient, a5 as getValueFromParameter, J as getWebApp, H as getWebApps, G as getWorkflow, B as getWorkflows, aj as joinQueries, a7 as mapToClickHouseType, ad as populateTable, X as quoteIdentifier, a0 as sql, a3 as toQuery, a4 as toQueryPreview, a2 as toStaticQuery } from './index-CcZRaA0b.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-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';
 import * as _clickhouse_client from '@clickhouse/client';
 import { KafkaJS } from '@514labs/kafka-javascript';
 import http from 'http';
@@ -193,10 +193,54 @@ declare const mooseEnvSecrets: {
     get(envVarName: string): string;
 };
 
-declare function getMooseUtils(req: http.IncomingMessage | any): ApiUtil | undefined;
+/**
+ * @deprecated Use `getMooseUtils()` from '@514labs/moose-lib' instead.
+ *
+ * This synchronous function extracts MooseUtils from a request object that was
+ * injected by Moose runtime middleware. It returns undefined if not running
+ * in a Moose-managed context.
+ *
+ * Migration: Replace with the async version:
+ * ```typescript
+ * // Old (sync, deprecated):
+ * import { getMooseUtilsFromRequest } from '@514labs/moose-lib';
+ * const moose = getMooseUtilsFromRequest(req);
+ *
+ * // New (async, recommended):
+ * import { getMooseUtils } from '@514labs/moose-lib';
+ * const moose = await getMooseUtils();
+ * ```
+ *
+ * @param req - The HTTP request object containing injected moose utilities
+ * @returns MooseUtils if available on the request, undefined otherwise
+ */
+declare function getMooseUtilsFromRequest(req: http.IncomingMessage | any): MooseUtils | undefined;
+/**
+ * @deprecated Use `getMooseUtils()` from '@514labs/moose-lib' instead.
+ *
+ * This is a legacy alias for getMooseUtilsFromRequest. The main getMooseUtils
+ * export from '@514labs/moose-lib' is now async and does not require a request parameter.
+ *
+ * BREAKING CHANGE WARNING: The new getMooseUtils() returns Promise<MooseUtils>,
+ * not MooseUtils | undefined. You must await the result:
+ * ```typescript
+ * const moose = await getMooseUtils(); // New async API
+ * ```
+ *
+ * @param req - The HTTP request object containing injected moose utilities
+ * @returns MooseUtils if available on the request, undefined otherwise
+ */
+declare function getLegacyMooseUtils(req: http.IncomingMessage | any): MooseUtils | undefined;
+/**
+ * @deprecated No longer needed. Use getMooseUtils() directly instead.
+ * Moose now handles utility injection automatically when injectMooseUtils is true.
+ */
 declare function expressMiddleware(): (req: any, res: any, next: any) => void;
+/**
+ * @deprecated Use MooseUtils from helpers.ts instead.
+ */
 interface ExpressRequestWithMoose {
-    moose?: ApiUtil;
+    moose?: MooseUtils;
 }
 
 interface TaskFunction {
@@ -322,6 +366,35 @@ interface RuntimeClickHouseConfig {
     useSSL: boolean;
 }
 
+/**
+ * Get Moose utilities for database access and SQL queries.
+ * Works in both Moose runtime and standalone contexts.
+ *
+ * **IMPORTANT**: This function is async and returns a Promise. You must await the result:
+ * ```typescript
+ * const moose = await getMooseUtils(); // Correct
+ * const moose = getMooseUtils(); // WRONG - returns Promise, not MooseUtils!
+ * ```
+ *
+ * **Breaking Change from v1.x**: This function signature changed from sync to async.
+ * If you were using the old sync API that extracted utils from a request object,
+ * use `getMooseUtilsFromRequest(req)` for backward compatibility (deprecated).
+ *
+ * @param req - DEPRECATED: Request parameter is no longer needed and will be ignored.
+ *              If you need to extract moose from a request, use getMooseUtilsFromRequest().
+ * @returns Promise resolving to MooseUtils with client and sql utilities.
+ *
+ * @example
+ * ```typescript
+ * const { client, sql } = await getMooseUtils();
+ * const result = await client.query.execute(sql`SELECT * FROM table`);
+ * ```
+ */
+declare function getMooseUtils(req?: any): Promise<MooseUtils>;
+/**
+ * @deprecated Use getMooseUtils() instead.
+ * Creates a Moose client for database access.
+ */
 declare function getMooseClients(config?: Partial<RuntimeClickHouseConfig>): Promise<{
     client: MooseClient;
 }>;
@@ -554,4 +627,4 @@ type DataModelConfig<T> = Partial<{
     parallelism?: number;
 }>;
 
-export { ACKs, ApiUtil, type CSVParsingConfig, CSV_DELIMITERS, type CliLogData, DEFAULT_CSV_CONFIG, DEFAULT_JSON_CONFIG, type DataModelConfig, DataSource, type DataSourceConfig, type ExpressRequestWithMoose, type ExtractionResult, type JSONParsingConfig, type KafkaClientConfig, type Logger, MAX_RETRIES, MAX_RETRIES_PRODUCER, MAX_RETRY_TIME_MS, MOOSE_RUNTIME_ENV_PREFIX, MooseCache, MooseClient, type Producer, RETRY_FACTOR_PRODUCER, RETRY_INITIAL_TIME_MS, type StripDateIntersection, type TaskConfig, type TaskDefinition, type TaskFunction, antiCachePath, cliLog, compilerLog, createApi, createConsumptionApi, createProducerConfig, expressMiddleware, getClickhouseClient, getFileName, getKafkaClient, getKafkaProducer, getMooseClients, getMooseUtils, isValidCSVDelimiter, logError, mapTstoJs, mooseEnvSecrets, mooseRuntimeEnv, parseCSV, parseJSON, parseJSONWithDates };
+export { ACKs, ApiUtil, type CSVParsingConfig, CSV_DELIMITERS, type CliLogData, DEFAULT_CSV_CONFIG, DEFAULT_JSON_CONFIG, type DataModelConfig, DataSource, type DataSourceConfig, type ExpressRequestWithMoose, type ExtractionResult, type JSONParsingConfig, type KafkaClientConfig, type Logger, MAX_RETRIES, MAX_RETRIES_PRODUCER, MAX_RETRY_TIME_MS, MOOSE_RUNTIME_ENV_PREFIX, MooseCache, MooseClient, MooseUtils, type Producer, RETRY_FACTOR_PRODUCER, RETRY_INITIAL_TIME_MS, type StripDateIntersection, type TaskConfig, type TaskDefinition, type TaskFunction, antiCachePath, cliLog, compilerLog, createApi, createConsumptionApi, createProducerConfig, expressMiddleware, getClickhouseClient, getFileName, getKafkaClient, getKafkaProducer, getLegacyMooseUtils, getMooseClients, getMooseUtils, getMooseUtilsFromRequest, isValidCSVDelimiter, logError, mapTstoJs, mooseEnvSecrets, mooseRuntimeEnv, parseCSV, parseJSON, parseJSONWithDates };

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-DhVPp9qX.js';
-import { R as ApiUtil, a8 as MooseClient } from './index-CcZRaA0b.js';
-export { A as Aggregated, h as Api, i as ApiConfig, ah as ApiHelpers, a9 as Blocks, aa as ClickHouseEngines, C as ConsumptionApi, ai as ConsumptionHelpers, U as ConsumptionUtil, e as DeadLetter, D as DeadLetterModel, f as DeadLetterQueue, l as ETLPipeline, m as ETLPipelineConfig, E as EgressConfig, F as FrameworkApp, Y as IdentifierBrandedString, I as IngestApi, g as IngestConfig, j as IngestPipeline, L as LifeCycle, M as MaterializedView, Z as NonIdentifierBrandedString, a as OlapConfig, O as OlapTable, ae as QueryClient, $ as RawValue, b as S3QueueTableSettings, S as SimpleAggregated, a1 as Sql, k as SqlResource, c as Stream, d as StreamConfig, T as Task, _ as Value, V as View, n as WebApp, o as WebAppConfig, p as WebAppHandler, W as Workflow, af as WorkflowClient, a6 as createClickhouseParameter, ac as createMaterializedView, ab as dropView, x as getApi, w as getApis, K as getCustomView, N as getCustomViews, v as getIngestApi, u as getIngestApis, P as getMaterializedView, Q as getMaterializedViews, z as getSqlResource, y as getSqlResources, t as getStream, s as getStreams, r as getTable, q as getTables, ag as getTemporalClient, a5 as getValueFromParameter, J as getWebApp, H as getWebApps, G as getWorkflow, B as getWorkflows, aj as joinQueries, a7 as mapToClickHouseType, ad as populateTable, X as quoteIdentifier, a0 as sql, a3 as toQuery, a4 as toQueryPreview, a2 as toStaticQuery } from './index-CcZRaA0b.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-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';
 import * as _clickhouse_client from '@clickhouse/client';
 import { KafkaJS } from '@514labs/kafka-javascript';
 import http from 'http';
@@ -193,10 +193,54 @@ declare const mooseEnvSecrets: {
     get(envVarName: string): string;
 };
 
-declare function getMooseUtils(req: http.IncomingMessage | any): ApiUtil | undefined;
+/**
+ * @deprecated Use `getMooseUtils()` from '@514labs/moose-lib' instead.
+ *
+ * This synchronous function extracts MooseUtils from a request object that was
+ * injected by Moose runtime middleware. It returns undefined if not running
+ * in a Moose-managed context.
+ *
+ * Migration: Replace with the async version:
+ * ```typescript
+ * // Old (sync, deprecated):
+ * import { getMooseUtilsFromRequest } from '@514labs/moose-lib';
+ * const moose = getMooseUtilsFromRequest(req);
+ *
+ * // New (async, recommended):
+ * import { getMooseUtils } from '@514labs/moose-lib';
+ * const moose = await getMooseUtils();
+ * ```
+ *
+ * @param req - The HTTP request object containing injected moose utilities
+ * @returns MooseUtils if available on the request, undefined otherwise
+ */
+declare function getMooseUtilsFromRequest(req: http.IncomingMessage | any): MooseUtils | undefined;
+/**
+ * @deprecated Use `getMooseUtils()` from '@514labs/moose-lib' instead.
+ *
+ * This is a legacy alias for getMooseUtilsFromRequest. The main getMooseUtils
+ * export from '@514labs/moose-lib' is now async and does not require a request parameter.
+ *
+ * BREAKING CHANGE WARNING: The new getMooseUtils() returns Promise<MooseUtils>,
+ * not MooseUtils | undefined. You must await the result:
+ * ```typescript
+ * const moose = await getMooseUtils(); // New async API
+ * ```
+ *
+ * @param req - The HTTP request object containing injected moose utilities
+ * @returns MooseUtils if available on the request, undefined otherwise
+ */
+declare function getLegacyMooseUtils(req: http.IncomingMessage | any): MooseUtils | undefined;
+/**
+ * @deprecated No longer needed. Use getMooseUtils() directly instead.
+ * Moose now handles utility injection automatically when injectMooseUtils is true.
+ */
 declare function expressMiddleware(): (req: any, res: any, next: any) => void;
+/**
+ * @deprecated Use MooseUtils from helpers.ts instead.
+ */
 interface ExpressRequestWithMoose {
-    moose?: ApiUtil;
+    moose?: MooseUtils;
 }
 
 interface TaskFunction {
@@ -322,6 +366,35 @@ interface RuntimeClickHouseConfig {
     useSSL: boolean;
 }
 
+/**
+ * Get Moose utilities for database access and SQL queries.
+ * Works in both Moose runtime and standalone contexts.
+ *
+ * **IMPORTANT**: This function is async and returns a Promise. You must await the result:
+ * ```typescript
+ * const moose = await getMooseUtils(); // Correct
+ * const moose = getMooseUtils(); // WRONG - returns Promise, not MooseUtils!
+ * ```
+ *
+ * **Breaking Change from v1.x**: This function signature changed from sync to async.
+ * If you were using the old sync API that extracted utils from a request object,
+ * use `getMooseUtilsFromRequest(req)` for backward compatibility (deprecated).
+ *
+ * @param req - DEPRECATED: Request parameter is no longer needed and will be ignored.
+ *              If you need to extract moose from a request, use getMooseUtilsFromRequest().
+ * @returns Promise resolving to MooseUtils with client and sql utilities.
+ *
+ * @example
+ * ```typescript
+ * const { client, sql } = await getMooseUtils();
+ * const result = await client.query.execute(sql`SELECT * FROM table`);
+ * ```
+ */
+declare function getMooseUtils(req?: any): Promise<MooseUtils>;
+/**
+ * @deprecated Use getMooseUtils() instead.
+ * Creates a Moose client for database access.
+ */
 declare function getMooseClients(config?: Partial<RuntimeClickHouseConfig>): Promise<{
     client: MooseClient;
 }>;
@@ -554,4 +627,4 @@ type DataModelConfig<T> = Partial<{
     parallelism?: number;
 }>;
 
-export { ACKs, ApiUtil, type CSVParsingConfig, CSV_DELIMITERS, type CliLogData, DEFAULT_CSV_CONFIG, DEFAULT_JSON_CONFIG, type DataModelConfig, DataSource, type DataSourceConfig, type ExpressRequestWithMoose, type ExtractionResult, type JSONParsingConfig, type KafkaClientConfig, type Logger, MAX_RETRIES, MAX_RETRIES_PRODUCER, MAX_RETRY_TIME_MS, MOOSE_RUNTIME_ENV_PREFIX, MooseCache, MooseClient, type Producer, RETRY_FACTOR_PRODUCER, RETRY_INITIAL_TIME_MS, type StripDateIntersection, type TaskConfig, type TaskDefinition, type TaskFunction, antiCachePath, cliLog, compilerLog, createApi, createConsumptionApi, createProducerConfig, expressMiddleware, getClickhouseClient, getFileName, getKafkaClient, getKafkaProducer, getMooseClients, getMooseUtils, isValidCSVDelimiter, logError, mapTstoJs, mooseEnvSecrets, mooseRuntimeEnv, parseCSV, parseJSON, parseJSONWithDates };
+export { ACKs, ApiUtil, type CSVParsingConfig, CSV_DELIMITERS, type CliLogData, DEFAULT_CSV_CONFIG, DEFAULT_JSON_CONFIG, type DataModelConfig, DataSource, type DataSourceConfig, type ExpressRequestWithMoose, type ExtractionResult, type JSONParsingConfig, type KafkaClientConfig, type Logger, MAX_RETRIES, MAX_RETRIES_PRODUCER, MAX_RETRY_TIME_MS, MOOSE_RUNTIME_ENV_PREFIX, MooseCache, MooseClient, MooseUtils, type Producer, RETRY_FACTOR_PRODUCER, RETRY_INITIAL_TIME_MS, type StripDateIntersection, type TaskConfig, type TaskDefinition, type TaskFunction, antiCachePath, cliLog, compilerLog, createApi, createConsumptionApi, createProducerConfig, expressMiddleware, getClickhouseClient, getFileName, getKafkaClient, getKafkaProducer, getLegacyMooseUtils, getMooseClients, getMooseUtils, getMooseUtilsFromRequest, isValidCSVDelimiter, logError, mapTstoJs, mooseEnvSecrets, mooseRuntimeEnv, parseCSV, parseJSON, parseJSONWithDates };