@bayoudhi/moose-lib-serverless 0.2.0 → 0.2.1

package/dist/index.d.mts

@@ -1,12 +1,83 @@
 import { Readable } from 'node:stream';
 import { IsTuple } from 'typia/lib/typings/IsTuple';
 import { IJsonSchemaCollection as IJsonSchemaCollection$1, tags } from 'typia';
+import { IJsonSchemaCollection } from 'typia/src/schemas/json/IJsonSchemaCollection';
+import { Pattern, TagBase } from 'typia/lib/tags';
 import { ClickHouseClient, ResultSet, CommandResult } from '@clickhouse/client';
 import { Client } from '@temporalio/client';
 import { JWTPayload } from 'jose';
 import http from 'http';
-import { IJsonSchemaCollection } from 'typia/src/schemas/json/IJsonSchemaCollection';
-import { Pattern, TagBase } from 'typia/lib/tags';
+
+/**
+ * Quote a ClickHouse identifier with backticks if not already quoted.
+ * Backticks allow special characters (e.g., hyphens) in identifiers.
+ */
+declare const quoteIdentifier: (name: string) => string;
+type IdentifierBrandedString = string & {
+    readonly __identifier_brand?: unique symbol;
+};
+type NonIdentifierBrandedString = string & {
+    readonly __identifier_brand?: unique symbol;
+};
+/**
+ * Values supported by SQL engine.
+ */
+type Value = NonIdentifierBrandedString | number | boolean | Date | [string, string];
+/**
+ * Supported value or SQL instance.
+ */
+type RawValue = Value | Sql;
+/**
+ * Sql template tag interface with attached helper methods.
+ */
+interface SqlTemplateTag {
+    (strings: readonly string[], ...values: readonly (RawValue | Column | OlapTable<any> | View)[]): Sql;
+    /**
+     * Join an array of Sql fragments with a separator.
+     * @param fragments - Array of Sql fragments to join
+     * @param separator - Optional separator string (defaults to ", ")
+     */
+    join(fragments: Sql[], separator?: string): Sql;
+    /**
+     * Create raw SQL from a string without parameterization.
+     * WARNING: SQL injection risk if used with untrusted input.
+     */
+    raw(text: string): Sql;
+}
+declare const sql: SqlTemplateTag;
+/**
+ * A SQL instance can be nested within each other to build SQL strings.
+ */
+declare class Sql {
+    readonly values: Value[];
+    readonly strings: string[];
+    constructor(rawStrings: readonly string[], rawValues: readonly (RawValue | Column | OlapTable<any> | View | Sql)[]);
+    /**
+     * Append another Sql fragment, returning a new Sql instance.
+     */
+    append(other: Sql): Sql;
+}
+declare const toStaticQuery: (sql: Sql) => string;
+declare const toQuery: (sql: Sql) => [string, {
+    [pN: string]: any;
+}];
+/**
+ * Build a display-only SQL string with values inlined for logging/debugging.
+ * Does not alter execution behavior; use toQuery for actual execution.
+ */
+declare const toQueryPreview: (sql: Sql) => string;
+declare const getValueFromParameter: (value: any) => any;
+declare function createClickhouseParameter(parameterIndex: number, value: Value): string;
+/**
+ * Convert the JS type (source is JSON format by API query parameter) to the corresponding ClickHouse type for generating named placeholder of parameterized query.
+ * Only support to convert number to Int or Float, boolean to Bool, string to String, other types will convert to String.
+ * If exist complex type e.g: object, Array, null, undefined, Date, Record.. etc, just convert to string type by ClickHouse function in SQL.
+ * ClickHouse support converting string to other types function.
+ * Please see Each section of the https://clickhouse.com/docs/en/sql-reference/functions and https://clickhouse.com/docs/en/sql-reference/functions/type-conversion-functions
+ * @param value
+ * @returns 'Float', 'Int', 'Bool', 'String'
+ */
+declare const mapToClickHouseType: (value: Value) => string;
 
 type EnumValues = {
     name: string;
@@ -1647,6 +1718,53 @@ 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);
 }
 
+/**
+ * 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;
+}
+/**
+ * @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;
+    constructor(queryClient: QueryClient, temporalClient?: Client);
+}
+declare class QueryClient {
+    client: ClickHouseClient;
+    query_id_prefix: string;
+    constructor(client: ClickHouseClient, query_id_prefix: string);
+    execute<T = any>(sql: Sql): Promise<ResultSet<"JSONEachRow"> & {
+        __query_result_t?: T[];
+    }>;
+    command(sql: Sql): Promise<CommandResult>;
+}
+declare class WorkflowClient {
+    client: Client | undefined;
+    constructor(temporalClient?: Client);
+    execute(name: string, input_data: any): Promise<{
+        status: number;
+        body: string;
+    }>;
+    terminate(workflowId: string): Promise<{
+        status: number;
+        body: string;
+    }>;
+    private getWorkflowConfig;
+    private processInputData;
+}
+
 /**
  * Defines the signature for a handler function used by a Consumption API.
  * @template T The expected type of the request parameters or query parameters.
@@ -2220,140 +2338,9 @@ type SimpleAggregated<AggregationFunction extends string, ArgType = any> = {
     _argType?: ArgType;
 };
 
-/**
- * Quote a ClickHouse identifier with backticks if not already quoted.
- * Backticks allow special characters (e.g., hyphens) in identifiers.
- */
-declare const quoteIdentifier: (name: string) => string;
-type IdentifierBrandedString = string & {
-    readonly __identifier_brand?: unique symbol;
-};
-type NonIdentifierBrandedString = string & {
-    readonly __identifier_brand?: unique symbol;
-};
-/**
- * Values supported by SQL engine.
- */
-type Value = NonIdentifierBrandedString | number | boolean | Date | [string, string];
-/**
- * Supported value or SQL instance.
- */
-type RawValue = Value | Sql;
-/**
- * Sql template tag interface with attached helper methods.
- */
-interface SqlTemplateTag {
-    (strings: readonly string[], ...values: readonly (RawValue | Column | OlapTable<any> | View)[]): Sql;
-    /**
-     * Join an array of Sql fragments with a separator.
-     * @param fragments - Array of Sql fragments to join
-     * @param separator - Optional separator string (defaults to ", ")
-     */
-    join(fragments: Sql[], separator?: string): Sql;
-    /**
-     * Create raw SQL from a string without parameterization.
-     * WARNING: SQL injection risk if used with untrusted input.
-     */
-    raw(text: string): Sql;
-}
-declare const sql: SqlTemplateTag;
-/**
- * A SQL instance can be nested within each other to build SQL strings.
- */
-declare class Sql {
-    readonly values: Value[];
-    readonly strings: string[];
-    constructor(rawStrings: readonly string[], rawValues: readonly (RawValue | Column | OlapTable<any> | View | Sql)[]);
-    /**
-     * Append another Sql fragment, returning a new Sql instance.
-     */
-    append(other: Sql): Sql;
-}
-declare const toStaticQuery: (sql: Sql) => string;
-declare const toQuery: (sql: Sql) => [string, {
-    [pN: string]: any;
-}];
-/**
- * Build a display-only SQL string with values inlined for logging/debugging.
- * Does not alter execution behavior; use toQuery for actual execution.
- */
-declare const toQueryPreview: (sql: Sql) => string;
-declare const getValueFromParameter: (value: any) => any;
-declare function createClickhouseParameter(parameterIndex: number, value: Value): string;
-/**
- * Convert the JS type (source is JSON format by API query parameter) to the corresponding ClickHouse type for generating named placeholder of parameterized query.
- * Only support to convert number to Int or Float, boolean to Bool, string to String, other types will convert to String.
- * If exist complex type e.g: object, Array, null, undefined, Date, Record.. etc, just convert to string type by ClickHouse function in SQL.
- * ClickHouse support converting string to other types function.
- * Please see Each section of the https://clickhouse.com/docs/en/sql-reference/functions and https://clickhouse.com/docs/en/sql-reference/functions/type-conversion-functions
- * @param value
- * @returns 'Float', 'Int', 'Bool', 'String'
- */
-declare const mapToClickHouseType: (value: Value) => string;
-
-/**
- * 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;
-}
-/**
- * @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;
-    constructor(queryClient: QueryClient, temporalClient?: Client);
-}
-declare class QueryClient {
-    client: ClickHouseClient;
-    query_id_prefix: string;
-    constructor(client: ClickHouseClient, query_id_prefix: string);
-    execute<T = any>(sql: Sql): Promise<ResultSet<"JSONEachRow"> & {
-        __query_result_t?: T[];
-    }>;
-    command(sql: Sql): Promise<CommandResult>;
-}
-declare class WorkflowClient {
-    client: Client | undefined;
-    constructor(temporalClient?: Client);
-    execute(name: string, input_data: any): Promise<{
-        status: number;
-        body: string;
-    }>;
-    terminate(workflowId: string): Promise<{
-        status: number;
-        body: string;
-    }>;
-    private getWorkflowConfig;
-    private processInputData;
-}
-
 type Key<T extends string | number | Date> = T;
 type JWT<T extends object> = T;
 
-/**
- * @fileoverview Pure TypeScript types, interfaces, constants, and utility functions
- * extracted from commons.ts. This module has NO native dependencies (no Kafka,
- * no ClickHouse client, no fs) and is safe to import in serverless/Lambda environments.
- *
- * The full commons.ts re-exports everything from this module for backward compatibility.
- *
- * @module commons-types
- */
-/**
- * Utility function for compiler-related logging that can be disabled via environment variable.
- * Set MOOSE_DISABLE_COMPILER_LOGS=true to suppress these logs (useful for testing environments).
- */
 declare const compilerLog: (message: string) => void;
 declare const antiCachePath: (path: string) => string;
 declare const getFileName: (filePath: string) => string;
@@ -2374,6 +2361,14 @@ declare const RETRY_INITIAL_TIME_MS = 100;
 declare const MAX_RETRIES_PRODUCER = 150;
 declare const RETRY_FACTOR_PRODUCER = 0.2;
 declare const ACKs = -1;
+type KafkaClientConfig = {
+    clientId: string;
+    broker: string;
+    securityProtocol?: string;
+    saslUsername?: string;
+    saslPassword?: string;
+    saslMechanism?: string;
+};
 /**
  * Interface for logging functionality
  */
@@ -2384,14 +2379,6 @@ interface Logger {
     warn: (message: string) => void;
 }
 declare const logError: (logger: Logger, e: Error) => void;
-type KafkaClientConfig = {
-    clientId: string;
-    broker: string;
-    securityProtocol?: string;
-    saslUsername?: string;
-    saslPassword?: string;
-    saslMechanism?: string;
-};
 
 /**
  * @module secrets

package/dist/index.d.ts

@@ -1,12 +1,83 @@
 import { Readable } from 'node:stream';
 import { IsTuple } from 'typia/lib/typings/IsTuple';
 import { IJsonSchemaCollection as IJsonSchemaCollection$1, tags } from 'typia';
+import { IJsonSchemaCollection } from 'typia/src/schemas/json/IJsonSchemaCollection';
+import { Pattern, TagBase } from 'typia/lib/tags';
 import { ClickHouseClient, ResultSet, CommandResult } from '@clickhouse/client';
 import { Client } from '@temporalio/client';
 import { JWTPayload } from 'jose';
 import http from 'http';
-import { IJsonSchemaCollection } from 'typia/src/schemas/json/IJsonSchemaCollection';
-import { Pattern, TagBase } from 'typia/lib/tags';
+
+/**
+ * Quote a ClickHouse identifier with backticks if not already quoted.
+ * Backticks allow special characters (e.g., hyphens) in identifiers.
+ */
+declare const quoteIdentifier: (name: string) => string;
+type IdentifierBrandedString = string & {
+    readonly __identifier_brand?: unique symbol;
+};
+type NonIdentifierBrandedString = string & {
+    readonly __identifier_brand?: unique symbol;
+};
+/**
+ * Values supported by SQL engine.
+ */
+type Value = NonIdentifierBrandedString | number | boolean | Date | [string, string];
+/**
+ * Supported value or SQL instance.
+ */
+type RawValue = Value | Sql;
+/**
+ * Sql template tag interface with attached helper methods.
+ */
+interface SqlTemplateTag {
+    (strings: readonly string[], ...values: readonly (RawValue | Column | OlapTable<any> | View)[]): Sql;
+    /**
+     * Join an array of Sql fragments with a separator.
+     * @param fragments - Array of Sql fragments to join
+     * @param separator - Optional separator string (defaults to ", ")
+     */
+    join(fragments: Sql[], separator?: string): Sql;
+    /**
+     * Create raw SQL from a string without parameterization.
+     * WARNING: SQL injection risk if used with untrusted input.
+     */
+    raw(text: string): Sql;
+}
+declare const sql: SqlTemplateTag;
+/**
+ * A SQL instance can be nested within each other to build SQL strings.
+ */
+declare class Sql {
+    readonly values: Value[];
+    readonly strings: string[];
+    constructor(rawStrings: readonly string[], rawValues: readonly (RawValue | Column | OlapTable<any> | View | Sql)[]);
+    /**
+     * Append another Sql fragment, returning a new Sql instance.
+     */
+    append(other: Sql): Sql;
+}
+declare const toStaticQuery: (sql: Sql) => string;
+declare const toQuery: (sql: Sql) => [string, {
+    [pN: string]: any;
+}];
+/**
+ * Build a display-only SQL string with values inlined for logging/debugging.
+ * Does not alter execution behavior; use toQuery for actual execution.
+ */
+declare const toQueryPreview: (sql: Sql) => string;
+declare const getValueFromParameter: (value: any) => any;
+declare function createClickhouseParameter(parameterIndex: number, value: Value): string;
+/**
+ * Convert the JS type (source is JSON format by API query parameter) to the corresponding ClickHouse type for generating named placeholder of parameterized query.
+ * Only support to convert number to Int or Float, boolean to Bool, string to String, other types will convert to String.
+ * If exist complex type e.g: object, Array, null, undefined, Date, Record.. etc, just convert to string type by ClickHouse function in SQL.
+ * ClickHouse support converting string to other types function.
+ * Please see Each section of the https://clickhouse.com/docs/en/sql-reference/functions and https://clickhouse.com/docs/en/sql-reference/functions/type-conversion-functions
+ * @param value
+ * @returns 'Float', 'Int', 'Bool', 'String'
+ */
+declare const mapToClickHouseType: (value: Value) => string;
 
 type EnumValues = {
     name: string;
@@ -1647,6 +1718,53 @@ 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);
 }
 
+/**
+ * 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;
+}
+/**
+ * @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;
+    constructor(queryClient: QueryClient, temporalClient?: Client);
+}
+declare class QueryClient {
+    client: ClickHouseClient;
+    query_id_prefix: string;
+    constructor(client: ClickHouseClient, query_id_prefix: string);
+    execute<T = any>(sql: Sql): Promise<ResultSet<"JSONEachRow"> & {
+        __query_result_t?: T[];
+    }>;
+    command(sql: Sql): Promise<CommandResult>;
+}
+declare class WorkflowClient {
+    client: Client | undefined;
+    constructor(temporalClient?: Client);
+    execute(name: string, input_data: any): Promise<{
+        status: number;
+        body: string;
+    }>;
+    terminate(workflowId: string): Promise<{
+        status: number;
+        body: string;
+    }>;
+    private getWorkflowConfig;
+    private processInputData;
+}
+
 /**
  * Defines the signature for a handler function used by a Consumption API.
  * @template T The expected type of the request parameters or query parameters.
@@ -2220,140 +2338,9 @@ type SimpleAggregated<AggregationFunction extends string, ArgType = any> = {
     _argType?: ArgType;
 };
 
-/**
- * Quote a ClickHouse identifier with backticks if not already quoted.
- * Backticks allow special characters (e.g., hyphens) in identifiers.
- */
-declare const quoteIdentifier: (name: string) => string;
-type IdentifierBrandedString = string & {
-    readonly __identifier_brand?: unique symbol;
-};
-type NonIdentifierBrandedString = string & {
-    readonly __identifier_brand?: unique symbol;
-};
-/**
- * Values supported by SQL engine.
- */
-type Value = NonIdentifierBrandedString | number | boolean | Date | [string, string];
-/**
- * Supported value or SQL instance.
- */
-type RawValue = Value | Sql;
-/**
- * Sql template tag interface with attached helper methods.
- */
-interface SqlTemplateTag {
-    (strings: readonly string[], ...values: readonly (RawValue | Column | OlapTable<any> | View)[]): Sql;
-    /**
-     * Join an array of Sql fragments with a separator.
-     * @param fragments - Array of Sql fragments to join
-     * @param separator - Optional separator string (defaults to ", ")
-     */
-    join(fragments: Sql[], separator?: string): Sql;
-    /**
-     * Create raw SQL from a string without parameterization.
-     * WARNING: SQL injection risk if used with untrusted input.
-     */
-    raw(text: string): Sql;
-}
-declare const sql: SqlTemplateTag;
-/**
- * A SQL instance can be nested within each other to build SQL strings.
- */
-declare class Sql {
-    readonly values: Value[];
-    readonly strings: string[];
-    constructor(rawStrings: readonly string[], rawValues: readonly (RawValue | Column | OlapTable<any> | View | Sql)[]);
-    /**
-     * Append another Sql fragment, returning a new Sql instance.
-     */
-    append(other: Sql): Sql;
-}
-declare const toStaticQuery: (sql: Sql) => string;
-declare const toQuery: (sql: Sql) => [string, {
-    [pN: string]: any;
-}];
-/**
- * Build a display-only SQL string with values inlined for logging/debugging.
- * Does not alter execution behavior; use toQuery for actual execution.
- */
-declare const toQueryPreview: (sql: Sql) => string;
-declare const getValueFromParameter: (value: any) => any;
-declare function createClickhouseParameter(parameterIndex: number, value: Value): string;
-/**
- * Convert the JS type (source is JSON format by API query parameter) to the corresponding ClickHouse type for generating named placeholder of parameterized query.
- * Only support to convert number to Int or Float, boolean to Bool, string to String, other types will convert to String.
- * If exist complex type e.g: object, Array, null, undefined, Date, Record.. etc, just convert to string type by ClickHouse function in SQL.
- * ClickHouse support converting string to other types function.
- * Please see Each section of the https://clickhouse.com/docs/en/sql-reference/functions and https://clickhouse.com/docs/en/sql-reference/functions/type-conversion-functions
- * @param value
- * @returns 'Float', 'Int', 'Bool', 'String'
- */
-declare const mapToClickHouseType: (value: Value) => string;
-
-/**
- * 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;
-}
-/**
- * @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;
-    constructor(queryClient: QueryClient, temporalClient?: Client);
-}
-declare class QueryClient {
-    client: ClickHouseClient;
-    query_id_prefix: string;
-    constructor(client: ClickHouseClient, query_id_prefix: string);
-    execute<T = any>(sql: Sql): Promise<ResultSet<"JSONEachRow"> & {
-        __query_result_t?: T[];
-    }>;
-    command(sql: Sql): Promise<CommandResult>;
-}
-declare class WorkflowClient {
-    client: Client | undefined;
-    constructor(temporalClient?: Client);
-    execute(name: string, input_data: any): Promise<{
-        status: number;
-        body: string;
-    }>;
-    terminate(workflowId: string): Promise<{
-        status: number;
-        body: string;
-    }>;
-    private getWorkflowConfig;
-    private processInputData;
-}
-
 type Key<T extends string | number | Date> = T;
 type JWT<T extends object> = T;
 
-/**
- * @fileoverview Pure TypeScript types, interfaces, constants, and utility functions
- * extracted from commons.ts. This module has NO native dependencies (no Kafka,
- * no ClickHouse client, no fs) and is safe to import in serverless/Lambda environments.
- *
- * The full commons.ts re-exports everything from this module for backward compatibility.
- *
- * @module commons-types
- */
-/**
- * Utility function for compiler-related logging that can be disabled via environment variable.
- * Set MOOSE_DISABLE_COMPILER_LOGS=true to suppress these logs (useful for testing environments).
- */
 declare const compilerLog: (message: string) => void;
 declare const antiCachePath: (path: string) => string;
 declare const getFileName: (filePath: string) => string;
@@ -2374,6 +2361,14 @@ declare const RETRY_INITIAL_TIME_MS = 100;
 declare const MAX_RETRIES_PRODUCER = 150;
 declare const RETRY_FACTOR_PRODUCER = 0.2;
 declare const ACKs = -1;
+type KafkaClientConfig = {
+    clientId: string;
+    broker: string;
+    securityProtocol?: string;
+    saslUsername?: string;
+    saslPassword?: string;
+    saslMechanism?: string;
+};
 /**
  * Interface for logging functionality
  */
@@ -2384,14 +2379,6 @@ interface Logger {
     warn: (message: string) => void;
 }
 declare const logError: (logger: Logger, e: Error) => void;
-type KafkaClientConfig = {
-    clientId: string;
-    broker: string;
-    securityProtocol?: string;
-    saslUsername?: string;
-    saslPassword?: string;
-    saslMechanism?: string;
-};
 
 /**
  * @module secrets