Refactor MaterializedView and View to use TableReference and unknown

Extract a non-generic TableReference interface from OlapTable to avoid
invariance issues with OlapTable<T> (T appears in both input and output
positions). Deduplicate formatTableReference into a shared export.

Replace { [key: string]: any } with { [key: string]: unknown } in
MaterializedView and View metadata fields for stricter type safety.

Author: onelesd

packages/ts-moose-lib/src/dmv2/index.ts

@@ -46,7 +46,13 @@ export type SimpleAggregated<
   _argType?: ArgType;
 };
 
-export { OlapTable, OlapConfig, S3QueueTableSettings } from "./sdk/olapTable";
+export {
+  OlapTable,
+  OlapConfig,
+  S3QueueTableSettings,
+  TableReference,
+  formatTableReference,
+} from "./sdk/olapTable";
 export { ClickHouseEngines } from "../dataModels/types";
 export {
   Stream,

packages/ts-moose-lib/src/dmv2/sdk/materializedView.ts

@@ -1,24 +1,17 @@
 import { ClickHouseEngines } from "../../dataModels/types";
 import { Sql, toStaticQuery } from "../../sqlHelpers";
-import { OlapConfig, OlapTable } from "./olapTable";
+import {
+  OlapConfig,
+  OlapTable,
+  TableReference,
+  formatTableReference,
+} from "./olapTable";
 import { View } from "./view";
 import { IJsonSchemaCollection } from "typia";
 import { Column } from "../../dataModels/dataModelTypes";
 import { getMooseInternal, isClientOnlyMode } from "../internal";
 import { getSourceFileFromStack } from "../utils/stackTrace";
 
-/**
- * Helper function to format a table reference as `database`.`table` or just `table`
- */
-function formatTableReference(table: OlapTable<any> | View): string {
-  const database =
-    table instanceof OlapTable ? table.config.database : undefined;
-  if (database) {
-    return `\`${database}\`.\`${table.name}\``;
-  }
-  return `\`${table.name}\``;
-}
-
 /**
  * Configuration options for creating a Materialized View.
  * @template T The data type of the records stored in the target table of the materialized view.
@@ -27,7 +20,7 @@ export interface MaterializedViewConfig<T> {
   /** The SQL SELECT statement or `Sql` object defining the data to be materialized. Dynamic SQL (with parameters) is not allowed here. */
   selectStatement: string | Sql;
   /** An array of OlapTable or View objects that the `selectStatement` reads from. */
-  selectTables: (OlapTable<any> | View)[];
+  selectTables: (TableReference | View)[];
 
   /** @deprecated See {@link targetTable}
    *  The name for the underlying target OlapTable that stores the materialized data. */

packages/ts-moose-lib/src/dmv2/sdk/olapTable.ts

@@ -625,6 +625,29 @@ type EngineConfig<T> =
  */
 export type OlapConfig<T> = EngineConfig<T> | LegacyOlapConfig<T>;
 
+/**
+ * Non-generic interface for referencing an OlapTable or View by name,
+ * without depending on the table's row type parameter.
+ *
+ * Use this in signatures that only need the table identity (name and
+ * optional database), avoiding the invariance issues of OlapTable<T>.
+ */
+export interface TableReference {
+  name: string;
+  config?: { database?: string };
+}
+
+/**
+ * Format a table reference as `database`.`table` or just `table`.
+ */
+export function formatTableReference(table: TableReference): string {
+  const database = table.config?.database;
+  if (database) {
+    return `\`${database}\`.\`${table.name}\``;
+  }
+  return `\`${table.name}\``;
+}
+
 /**
  * Represents an OLAP (Online Analytical Processing) table, typically corresponding to a ClickHouse table.
  * Provides a typed interface for interacting with the table.

packages/ts-moose-lib/src/dmv2/sdk/view.ts

@@ -1,20 +1,8 @@
 import { Sql, toStaticQuery } from "../../sqlHelpers";
-import { OlapTable } from "./olapTable";
+import { TableReference, formatTableReference } from "./olapTable";
 import { getMooseInternal, isClientOnlyMode } from "../internal";
 import { getSourceFileFromStack } from "../utils/stackTrace";
 
-/**
- * Helper function to format a table reference as `database`.`table` or just `table`
- */
-function formatTableReference(table: OlapTable<any> | View): string {
-  const database =
-    table instanceof OlapTable ? table.config.database : undefined;
-  if (database) {
-    return `\`${database}\`.\`${table.name}\``;
-  }
-  return `\`${table.name}\``;
-}
-
 /**
  * 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.
@@ -33,7 +21,7 @@ export class View {
   sourceTables: string[];
 
   /** Optional metadata for the view */
-  metadata: { [key: string]: any };
+  metadata: { [key: string]: unknown };
 
   /**
    * Creates a new View instance.
@@ -45,8 +33,8 @@ export class View {
   constructor(
     name: string,
     selectStatement: string | Sql,
-    baseTables: (OlapTable<any> | View)[],
-    metadata?: { [key: string]: any },
+    baseTables: (TableReference | View)[],
+    metadata?: { [key: string]: unknown },
   ) {
     if (typeof selectStatement !== "string") {
       selectStatement = toStaticQuery(selectStatement);