@duckcodeailabs/dql-core 0.3.0 → 0.3.2

package/dist/semantic/providers/registry.js

@@ -7,45 +7,95 @@ import { join } from 'node:path';
 import { DqlProvider } from './dql-provider.js';
 import { DbtProvider } from './dbt-provider.js';
 import { CubejsProvider } from './cubejs-provider.js';
+import { resolveRepoSource } from './repo-resolver.js';
 /**
  * Resolve the semantic layer from config, or auto-detect if no config is given.
  *
  * Auto-detection order:
- *  1. If `semantic-layer/` exists in projectRoot, use DQL native provider.
- *  2. Otherwise return undefined.
+ *  1. If explicit config is provided, use that provider.
+ *  2. If `semantic-layer/` exists in projectRoot, use DQL native provider.
+ *  3. If `dbt_project.yml` exists in projectRoot, use dbt provider.
+ *  4. If `model/` or `schema/` with cube YAML exists, use cubejs provider.
+ *  5. Otherwise return undefined.
  */
 export function resolveSemanticLayer(config, projectRoot) {
+    return resolveSemanticLayerWithDiagnostics(config, projectRoot).layer;
+}
+export function resolveSemanticLayerWithDiagnostics(config, projectRoot) {
     if (config) {
         return loadFromConfig(config, projectRoot);
     }
-    // Auto-detect: check for native DQL semantic-layer directory
+    return autoDetect(projectRoot);
+}
+function autoDetect(projectRoot) {
+    // 1. DQL native semantic-layer/ directory
     const nativeDir = join(projectRoot, 'semantic-layer');
     if (existsSync(nativeDir)) {
-        const provider = new DqlProvider();
-        return provider.load({ provider: 'dql' }, projectRoot);
+        const result = loadFromConfig({ provider: 'dql' }, projectRoot);
+        result.detectedProvider = 'dql';
+        return result;
+    }
+    // 2. dbt project (dbt_project.yml in root)
+    if (existsSync(join(projectRoot, 'dbt_project.yml'))) {
+        const result = loadFromConfig({ provider: 'dbt' }, projectRoot);
+        result.detectedProvider = 'dbt';
+        return result;
+    }
+    // 3. Cube.js project (model/ or schema/ directory)
+    for (const candidate of ['model', 'schema']) {
+        if (existsSync(join(projectRoot, candidate))) {
+            const result = loadFromConfig({ provider: 'cubejs' }, projectRoot);
+            result.detectedProvider = 'cubejs';
+            return result;
+        }
     }
-    return undefined;
+    return { layer: undefined, errors: [] };
 }
 function loadFromConfig(config, projectRoot) {
-    switch (config.provider) {
-        case 'dql': {
-            const provider = new DqlProvider();
-            return provider.load(config, projectRoot);
-        }
-        case 'dbt': {
-            const provider = new DbtProvider();
-            return provider.load(config, projectRoot);
+    const errors = [];
+    try {
+        // Resolve remote repo source to a local path if needed
+        let effectiveRoot = projectRoot;
+        if (config.source && config.source !== 'local' && config.repoUrl) {
+            const resolved = resolveRepoSource(config, projectRoot);
+            effectiveRoot = resolved.localPath;
+            if (resolved.warnings.length > 0) {
+                errors.push(...resolved.warnings);
+            }
+            // When using a remote source, the provider should read from the resolved
+            // root directly — clear projectPath so the provider doesn't double-join.
+            config = { ...config, projectPath: undefined };
         }
-        case 'cubejs': {
-            const provider = new CubejsProvider();
-            return provider.load(config, projectRoot);
+        switch (config.provider) {
+            case 'dql': {
+                const provider = new DqlProvider();
+                return { layer: provider.load(config, effectiveRoot), errors };
+            }
+            case 'dbt': {
+                const provider = new DbtProvider();
+                return { layer: provider.load(config, effectiveRoot), errors };
+            }
+            case 'cubejs': {
+                const provider = new CubejsProvider();
+                return { layer: provider.load(config, effectiveRoot), errors };
+            }
+            case 'snowflake': {
+                errors.push('Snowflake semantic views provider requires a live connection. Use the SnowflakeSemanticProvider directly.');
+                return { layer: undefined, errors };
+            }
+            case 'lookml': {
+                errors.push('LookML provider is not yet implemented. Use provider "dql", "dbt", or "cubejs".');
+                return { layer: undefined, errors };
+            }
+            default:
+                errors.push(`Unknown semantic layer provider: "${config.provider}". Supported: dql, dbt, cubejs, snowflake, lookml.`);
+                return { layer: undefined, errors };
         }
-        case 'lookml': {
-            // LookML provider not yet implemented
-            return undefined;
-        }
-        default:
-            return undefined;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        errors.push(`Failed to load ${config.provider} semantic layer: ${msg}`);
+        return { layer: undefined, errors };
     }
 }
 //# sourceMappingURL=registry.js.map

package/dist/semantic/providers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/semantic/providers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA+C,EAC/C,WAAmB;IAEnB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,6DAA6D;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CACrB,MAAmC,EACnC,WAAmB;IAEnB,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;YACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;YACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;YACtC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,sCAAsC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/semantic/providers/registry.ts"],"names":[],"mappings":"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"}

package/dist/semantic/providers/repo-resolver.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Repo resolver: clones or pulls a remote Git repository into a local cache
+ * directory so that file-based semantic layer providers (dbt, cubejs, etc.)
+ * can read definitions from it.
+ *
+ * Supports GitHub and GitLab repositories. Uses shallow clone with a single
+ * branch for speed. Caches clones under ~/.dql/cache/repos/ with a TTL so
+ * repeated runs don't re-clone every time.
+ */
+import type { SemanticLayerProviderConfig } from './provider.js';
+export interface RepoResolveResult {
+    /** Absolute path to the resolved project root (local dir or cloned repo + subPath). */
+    localPath: string;
+    /** Whether the repo was freshly cloned or updated. */
+    freshClone: boolean;
+    /** Any warnings (e.g., stale cache used). */
+    warnings: string[];
+}
+/**
+ * Resolve the effective local path for a semantic layer config.
+ *
+ * - If source is 'local' (default) or no repoUrl is set, returns the
+ *   projectRoot + projectPath as-is.
+ * - If source is 'github' or 'gitlab', shallow-clones the repo into a
+ *   cache directory and returns the path to the cloned content.
+ */
+export declare function resolveRepoSource(config: SemanticLayerProviderConfig, projectRoot: string): RepoResolveResult;
+/**
+ * Manually refresh a cached repo (for `dql semantic pull` CLI command).
+ */
+export declare function pullCachedRepo(repoUrl: string, branch?: string): RepoResolveResult;
+//# sourceMappingURL=repo-resolver.d.ts.map

package/dist/semantic/providers/repo-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolver.d.ts","sourceRoot":"","sources":["../../../src/semantic/providers/repo-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAwBjE,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,2BAA2B,EACnC,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAyEnB;AAwCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAe,GAAG,iBAAiB,CA0B1F"}

package/dist/semantic/providers/repo-resolver.js

@@ -0,0 +1,169 @@
+/**
+ * Repo resolver: clones or pulls a remote Git repository into a local cache
+ * directory so that file-based semantic layer providers (dbt, cubejs, etc.)
+ * can read definitions from it.
+ *
+ * Supports GitHub and GitLab repositories. Uses shallow clone with a single
+ * branch for speed. Caches clones under ~/.dql/cache/repos/ with a TTL so
+ * repeated runs don't re-clone every time.
+ */
+import { existsSync, mkdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+/** Default cache TTL: 10 minutes. */
+const CACHE_TTL_MS = 10 * 60 * 1000;
+/** Base directory for cached repo clones. */
+function getCacheBaseDir() {
+    return join(homedir(), '.dql', 'cache', 'repos');
+}
+/**
+ * Compute a stable cache key from the repo URL + branch.
+ */
+function cacheKey(repoUrl, branch) {
+    const hash = createHash('sha256').update(`${repoUrl}#${branch}`).digest('hex').slice(0, 16);
+    // Extract a human-readable slug from the URL
+    const slug = repoUrl
+        .replace(/^https?:\/\//, '')
+        .replace(/\.git$/, '')
+        .replace(/[^a-zA-Z0-9_-]/g, '_')
+        .slice(-60);
+    return `${slug}__${hash}`;
+}
+/**
+ * Resolve the effective local path for a semantic layer config.
+ *
+ * - If source is 'local' (default) or no repoUrl is set, returns the
+ *   projectRoot + projectPath as-is.
+ * - If source is 'github' or 'gitlab', shallow-clones the repo into a
+ *   cache directory and returns the path to the cloned content.
+ */
+export function resolveRepoSource(config, projectRoot) {
+    const source = config.source ?? 'local';
+    if (source === 'local' || !config.repoUrl) {
+        // Local path — just resolve projectPath relative to projectRoot
+        const localPath = config.projectPath
+            ? join(projectRoot, config.projectPath)
+            : projectRoot;
+        return { localPath, freshClone: false, warnings: [] };
+    }
+    // Remote source: clone or update
+    const repoUrl = config.repoUrl;
+    const branch = config.branch ?? 'main';
+    const subPath = config.subPath ?? '';
+    const warnings = [];
+    const cacheBase = getCacheBaseDir();
+    mkdirSync(cacheBase, { recursive: true });
+    const key = cacheKey(repoUrl, branch);
+    const cloneDir = join(cacheBase, key);
+    let freshClone = false;
+    if (existsSync(cloneDir)) {
+        // Check if the cache is still fresh
+        const stat = statSync(cloneDir);
+        const age = Date.now() - stat.mtimeMs;
+        if (age < CACHE_TTL_MS) {
+            // Cache is fresh — use as-is
+            const localPath = subPath ? join(cloneDir, subPath) : cloneDir;
+            return { localPath, freshClone: false, warnings };
+        }
+        // Cache is stale — try to pull
+        try {
+            execSync(`git -C "${cloneDir}" fetch --depth=1 origin ${branch} && git -C "${cloneDir}" reset --hard origin/${branch}`, {
+                timeout: 30_000,
+                stdio: 'pipe',
+                env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+            });
+            freshClone = true;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            warnings.push(`Failed to update cached repo, using stale cache: ${msg}`);
+        }
+    }
+    else {
+        // Fresh clone
+        try {
+            const tokenEnv = getAuthEnv(repoUrl);
+            const authUrl = injectToken(repoUrl, tokenEnv);
+            execSync(`git clone --depth=1 --branch "${branch}" --single-branch "${authUrl}" "${cloneDir}"`, {
+                timeout: 60_000,
+                stdio: 'pipe',
+                env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+            });
+            freshClone = true;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to clone semantic layer repo "${repoUrl}" (branch: ${branch}): ${msg}. ` +
+                'Ensure the repo URL is correct and, for private repos, set GITHUB_TOKEN or GITLAB_TOKEN.');
+        }
+    }
+    const localPath = subPath ? join(cloneDir, subPath) : cloneDir;
+    return { localPath, freshClone, warnings };
+}
+/**
+ * Get the auth token from environment variables based on repo URL.
+ */
+function getAuthEnv(repoUrl) {
+    if (repoUrl.includes('github.com') || repoUrl.includes('github')) {
+        return process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+    }
+    if (repoUrl.includes('gitlab.com') || repoUrl.includes('gitlab')) {
+        return process.env.GITLAB_TOKEN ?? process.env.GL_TOKEN;
+    }
+    return undefined;
+}
+/**
+ * Inject an auth token into an HTTPS URL for git clone.
+ * Returns the original URL if no token is available or URL is not HTTPS.
+ */
+function injectToken(repoUrl, token) {
+    if (!token)
+        return repoUrl;
+    try {
+        const url = new URL(repoUrl);
+        if (url.protocol !== 'https:')
+            return repoUrl;
+        if (repoUrl.includes('github')) {
+            // GitHub: https://x-access-token:TOKEN@github.com/owner/repo.git
+            url.username = 'x-access-token';
+            url.password = token;
+        }
+        else if (repoUrl.includes('gitlab')) {
+            // GitLab: https://oauth2:TOKEN@gitlab.com/owner/repo.git
+            url.username = 'oauth2';
+            url.password = token;
+        }
+        return url.toString();
+    }
+    catch {
+        return repoUrl;
+    }
+}
+/**
+ * Manually refresh a cached repo (for `dql semantic pull` CLI command).
+ */
+export function pullCachedRepo(repoUrl, branch = 'main') {
+    const cacheBase = getCacheBaseDir();
+    const key = cacheKey(repoUrl, branch);
+    const cloneDir = join(cacheBase, key);
+    const warnings = [];
+    if (!existsSync(cloneDir)) {
+        // No cache — do a fresh clone
+        return resolveRepoSource({ provider: 'dbt', source: 'github', repoUrl, branch }, process.cwd());
+    }
+    try {
+        execSync(`git -C "${cloneDir}" fetch --depth=1 origin ${branch} && git -C "${cloneDir}" reset --hard origin/${branch}`, {
+            timeout: 30_000,
+            stdio: 'pipe',
+            env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        warnings.push(`Failed to pull: ${msg}`);
+    }
+    return { localPath: cloneDir, freshClone: true, warnings };
+}
+//# sourceMappingURL=repo-resolver.js.map

package/dist/semantic/providers/repo-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolver.js","sourceRoot":"","sources":["../../../src/semantic/providers/repo-resolver.ts"],"names":[],"mappings":"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"}

package/dist/semantic/providers/snowflake-provider.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Snowflake Semantic Views Provider.
+ *
+ * Introspects Snowflake's semantic views (CREATE SEMANTIC VIEW) to discover
+ * metrics, dimensions, and relationships. Unlike file-based providers (dbt,
+ * cubejs), this provider requires a live Snowflake connection.
+ *
+ * Because dql-core must not depend on dql-connectors, this provider accepts
+ * a generic query executor function. The CLI / local-runtime injects the
+ * actual Snowflake connector at runtime.
+ *
+ * Usage:
+ *   const provider = new SnowflakeSemanticProvider(async (sql) => {
+ *     return connector.execute(sql);
+ *   });
+ *   const layer = await provider.loadAsync(config, projectRoot);
+ */
+import { SemanticLayer } from '../semantic-layer.js';
+import type { SemanticLayerProviderConfig } from './provider.js';
+export interface SnowflakeQueryRow {
+    [column: string]: unknown;
+}
+export interface SnowflakeQueryResult {
+    rows: SnowflakeQueryRow[];
+}
+/** A function that executes a SQL query against Snowflake and returns rows. */
+export type SnowflakeQueryExecutor = (sql: string) => Promise<SnowflakeQueryResult>;
+export declare class SnowflakeSemanticProvider {
+    private readonly executeQuery;
+    readonly name = "snowflake";
+    constructor(executeQuery: SnowflakeQueryExecutor);
+    /**
+     * Load semantic layer definitions from Snowflake semantic views.
+     * This is async because it needs to query Snowflake metadata.
+     */
+    loadAsync(config: SemanticLayerProviderConfig, _projectRoot: string): Promise<SemanticLayer>;
+    /**
+     * Discover available semantic views in the Snowflake account.
+     */
+    private discoverSemanticViews;
+    private discoverViaInformationSchema;
+    /**
+     * Load metrics from a semantic view's metadata.
+     */
+    private loadViewMetrics;
+    /**
+     * Load dimensions from a semantic view's metadata.
+     */
+    private loadViewDimensions;
+    /**
+     * Load relationships/joins from a semantic view's metadata.
+     */
+    private loadViewRelationships;
+}
+//# sourceMappingURL=snowflake-provider.d.ts.map

package/dist/semantic/providers/snowflake-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snowflake-provider.d.ts","sourceRoot":"","sources":["../../../src/semantic/providers/snowflake-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAKjE,MAAM,WAAW,iBAAiB;IAChC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEpF,qBAAa,yBAAyB;IAGxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,QAAQ,CAAC,IAAI,eAAe;gBAEC,YAAY,EAAE,sBAAsB;IAEjE;;;OAGG;IACG,SAAS,CACb,MAAM,EAAE,2BAA2B,EACnC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC;IAiBzB;;OAEG;YACW,qBAAqB;YAsBrB,4BAA4B;IAuB1C;;OAEG;YACW,eAAe;IAgC7B;;OAEG;YACW,kBAAkB;IA6BhC;;OAEG;YACW,qBAAqB;CA4DpC"}

package/dist/semantic/providers/snowflake-provider.js

@@ -0,0 +1,246 @@
+/**
+ * Snowflake Semantic Views Provider.
+ *
+ * Introspects Snowflake's semantic views (CREATE SEMANTIC VIEW) to discover
+ * metrics, dimensions, and relationships. Unlike file-based providers (dbt,
+ * cubejs), this provider requires a live Snowflake connection.
+ *
+ * Because dql-core must not depend on dql-connectors, this provider accepts
+ * a generic query executor function. The CLI / local-runtime injects the
+ * actual Snowflake connector at runtime.
+ *
+ * Usage:
+ *   const provider = new SnowflakeSemanticProvider(async (sql) => {
+ *     return connector.execute(sql);
+ *   });
+ *   const layer = await provider.loadAsync(config, projectRoot);
+ */
+import { SemanticLayer } from '../semantic-layer.js';
+export class SnowflakeSemanticProvider {
+    executeQuery;
+    name = 'snowflake';
+    constructor(executeQuery) {
+        this.executeQuery = executeQuery;
+    }
+    /**
+     * Load semantic layer definitions from Snowflake semantic views.
+     * This is async because it needs to query Snowflake metadata.
+     */
+    async loadAsync(config, _projectRoot) {
+        const layer = new SemanticLayer();
+        const database = config.projectPath; // Reuse projectPath as database filter
+        // 1. Discover semantic views
+        const views = await this.discoverSemanticViews(database);
+        // 2. For each semantic view, load its metrics and dimensions
+        for (const view of views) {
+            await this.loadViewMetrics(layer, view);
+            await this.loadViewDimensions(layer, view);
+            await this.loadViewRelationships(layer, view);
+        }
+        return layer;
+    }
+    /**
+     * Discover available semantic views in the Snowflake account.
+     */
+    async discoverSemanticViews(database) {
+        // Snowflake exposes semantic views via SHOW SEMANTIC VIEWS or
+        // INFORMATION_SCHEMA. We try SHOW first as it's more universally available.
+        let sql = 'SHOW SEMANTIC VIEWS';
+        if (database) {
+            sql += ` IN DATABASE "${database}"`;
+        }
+        try {
+            const result = await this.executeQuery(sql);
+            return result.rows.map((row) => ({
+                name: String(row['name'] ?? row['NAME'] ?? ''),
+                databaseName: String(row['database_name'] ?? row['DATABASE_NAME'] ?? ''),
+                schemaName: String(row['schema_name'] ?? row['SCHEMA_NAME'] ?? ''),
+            }));
+        }
+        catch {
+            // SHOW SEMANTIC VIEWS may not be available in older Snowflake versions.
+            // Fall back to INFORMATION_SCHEMA query.
+            return this.discoverViaInformationSchema(database);
+        }
+    }
+    async discoverViaInformationSchema(database) {
+        const db = database ? `"${database}".` : '';
+        const sql = `
+      SELECT TABLE_NAME, TABLE_CATALOG, TABLE_SCHEMA
+      FROM ${db}INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_TYPE = 'SEMANTIC VIEW'
+      ORDER BY TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAME
+    `;
+        try {
+            const result = await this.executeQuery(sql);
+            return result.rows.map((row) => ({
+                name: String(row['TABLE_NAME'] ?? ''),
+                databaseName: String(row['TABLE_CATALOG'] ?? ''),
+                schemaName: String(row['TABLE_SCHEMA'] ?? ''),
+            }));
+        }
+        catch {
+            // If neither approach works, return empty — the error will surface as
+            // "no metrics found" which is more helpful than a raw SQL error.
+            return [];
+        }
+    }
+    /**
+     * Load metrics from a semantic view's metadata.
+     */
+    async loadViewMetrics(layer, view) {
+        const fqn = `"${view.databaseName}"."${view.schemaName}"."${view.name}"`;
+        try {
+            // DESC SEMANTIC VIEW returns columns with their semantic roles
+            const result = await this.executeQuery(`DESC SEMANTIC VIEW ${fqn}`);
+            for (const row of result.rows) {
+                const colName = String(row['name'] ?? row['NAME'] ?? '');
+                const colType = String(row['type'] ?? row['TYPE'] ?? '');
+                const semanticRole = String(row['semantic_role'] ?? row['SEMANTIC_ROLE'] ?? row['kind'] ?? row['KIND'] ?? '');
+                const expression = String(row['expression'] ?? row['EXPRESSION'] ?? row['default'] ?? row['DEFAULT'] ?? colName);
+                const description = String(row['comment'] ?? row['COMMENT'] ?? '');
+                if (semanticRole.toLowerCase() === 'measure' || semanticRole.toLowerCase() === 'metric') {
+                    const aggregation = inferAggregation(colType, expression);
+                    layer.addMetric({
+                        name: `${view.name}.${colName}`,
+                        label: colName.replace(/_/g, ' '),
+                        description: description || `Metric from ${view.name}`,
+                        sql: expression,
+                        type: aggregation,
+                        table: fqn,
+                        domain: view.schemaName,
+                    });
+                }
+            }
+        }
+        catch {
+            // Silently skip views we can't describe — they'll show as having no metrics
+        }
+    }
+    /**
+     * Load dimensions from a semantic view's metadata.
+     */
+    async loadViewDimensions(layer, view) {
+        const fqn = `"${view.databaseName}"."${view.schemaName}"."${view.name}"`;
+        try {
+            const result = await this.executeQuery(`DESC SEMANTIC VIEW ${fqn}`);
+            for (const row of result.rows) {
+                const colName = String(row['name'] ?? row['NAME'] ?? '');
+                const colType = String(row['type'] ?? row['TYPE'] ?? '');
+                const semanticRole = String(row['semantic_role'] ?? row['SEMANTIC_ROLE'] ?? row['kind'] ?? row['KIND'] ?? '');
+                const description = String(row['comment'] ?? row['COMMENT'] ?? '');
+                if (semanticRole.toLowerCase() === 'dimension' || semanticRole.toLowerCase() === 'entity') {
+                    const dimType = inferDimensionType(colType);
+                    layer.addDimension({
+                        name: `${view.name}.${colName}`,
+                        label: colName.replace(/_/g, ' '),
+                        description: description || `Dimension from ${view.name}`,
+                        sql: colName,
+                        type: dimType,
+                        table: fqn,
+                    });
+                }
+            }
+        }
+        catch {
+            // Skip on error
+        }
+    }
+    /**
+     * Load relationships/joins from a semantic view's metadata.
+     */
+    async loadViewRelationships(layer, view) {
+        const fqn = `"${view.databaseName}"."${view.schemaName}"."${view.name}"`;
+        try {
+            // Try to get relationship metadata — this varies by Snowflake version
+            const result = await this.executeQuery(`SELECT * FROM TABLE(INFORMATION_SCHEMA.SEMANTIC_VIEW_RELATIONSHIPS('${fqn}'))`);
+            for (const row of result.rows) {
+                const leftTable = String(row['left_table'] ?? row['LEFT_TABLE'] ?? '');
+                const rightTable = String(row['right_table'] ?? row['RIGHT_TABLE'] ?? '');
+                const joinType = String(row['join_type'] ?? row['JOIN_TYPE'] ?? 'left');
+                const joinCondition = String(row['join_condition'] ?? row['JOIN_CONDITION'] ?? '');
+                if (leftTable && rightTable && joinCondition) {
+                    // Register as a cube with join if both sides are available
+                    const leftName = leftTable.split('.').pop() ?? leftTable;
+                    const rightName = rightTable.split('.').pop() ?? rightTable;
+                    const emptyCube = (cubeName, cubeTable) => ({
+                        name: cubeName,
+                        label: cubeName,
+                        description: `Auto-discovered from Snowflake semantic view`,
+                        sql: `SELECT * FROM ${cubeTable}`,
+                        table: cubeTable,
+                        domain: view.schemaName,
+                        measures: [],
+                        dimensions: [],
+                        timeDimensions: [],
+                        joins: [],
+                    });
+                    // Ensure both cubes exist
+                    if (!layer.getCube(leftName)) {
+                        layer.addCube(emptyCube(leftName, leftTable));
+                    }
+                    if (!layer.getCube(rightName)) {
+                        layer.addCube(emptyCube(rightName, rightTable));
+                    }
+                    // Add join to the left cube
+                    const leftCube = layer.getCube(leftName);
+                    if (leftCube) {
+                        const jt = joinType.toLowerCase();
+                        const joinDef = {
+                            name: `${leftName}_${rightName}`,
+                            left: leftName,
+                            right: rightName,
+                            type: jt.includes('right') ? 'right' : jt.includes('full') ? 'full' : jt.includes('inner') ? 'inner' : 'left',
+                            sql: joinCondition,
+                        };
+                        leftCube.joins.push(joinDef);
+                    }
+                }
+            }
+        }
+        catch {
+            // Relationship introspection is optional — older Snowflake may not support it
+        }
+    }
+}
+/**
+ * Infer the metric aggregation type from the column type and expression.
+ */
+function inferAggregation(colType, expression) {
+    const exprLower = expression.toLowerCase();
+    if (exprLower.includes('count('))
+        return 'count';
+    if (exprLower.includes('sum('))
+        return 'sum';
+    if (exprLower.includes('avg(') || exprLower.includes('average('))
+        return 'avg';
+    if (exprLower.includes('min('))
+        return 'min';
+    if (exprLower.includes('max('))
+        return 'max';
+    if (exprLower.includes('count_distinct(') || exprLower.includes('count(distinct'))
+        return 'count_distinct';
+    // Infer from column type
+    const typeLower = colType.toLowerCase();
+    if (typeLower.includes('number') || typeLower.includes('float') || typeLower.includes('decimal')) {
+        return 'sum';
+    }
+    return 'count';
+}
+/**
+ * Infer the dimension type from the column SQL type.
+ */
+function inferDimensionType(colType) {
+    const typeLower = colType.toLowerCase();
+    if (typeLower.includes('date') || typeLower.includes('time') || typeLower.includes('timestamp')) {
+        return 'date';
+    }
+    if (typeLower.includes('number') || typeLower.includes('float') || typeLower.includes('decimal') || typeLower.includes('int')) {
+        return 'number';
+    }
+    if (typeLower.includes('bool')) {
+        return 'boolean';
+    }
+    return 'string';
+}
+//# sourceMappingURL=snowflake-provider.js.map