@ultracart/bq-skill 0.1.2

package/dist/lib/bigquery.js

@@ -0,0 +1,321 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProject = getProject;
+exports.getDatasets = getDatasets;
+exports.getTables = getTables;
+exports.getTableSchema = getTableSchema;
+exports.executeQuery = executeQuery;
+exports.getExternalTables = getExternalTables;
+exports.getExternalTableSchema = getExternalTableSchema;
+exports.refreshSchemaCache = refreshSchemaCache;
+const bigquery_1 = require("@google-cloud/bigquery");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function getBigQueryClient(config) {
+    return new bigquery_1.BigQuery({ projectId: config.project_id });
+}
+function getProject(config) {
+    return config.project_id;
+}
+function getDatasets(config) {
+    const datasets = [
+        {
+            dataset_id: 'ultracart_dw',
+            description: 'The standard data set. Does not contain any PII information.',
+        },
+        {
+            dataset_id: 'ultracart_dw_streaming',
+            description: 'The streaming data set. This is only for analytics and screen recordings tables because they are so large that views to see these tables in the standard or medium data sets is horrible for performance.',
+        },
+    ];
+    if (config.taxonomy_level === 'medium' || config.taxonomy_level === 'high') {
+        datasets.splice(1, 0, {
+            dataset_id: 'ultracart_dw_medium',
+            description: 'The medium data set. Contains PII information. Try using hashed versions of fields before accessing this data set for PII.',
+        });
+    }
+    return datasets;
+}
+const STREAMING_TABLES = [
+    {
+        table_name: 'uc_analytics_session_streaming',
+        description: 'UltraCart Analytics sessions. This is a huge table of detailed analytics information. Each session is a collection of different events (hits) that occurred within the session.',
+    },
+    {
+        table_name: 'uc_screen_recording_streaming',
+        description: 'UltraCart StoreFront screen recording sessions. These sessions contain all the meta data information about a customers session as captured by the StoreFront screen recording system.',
+    },
+];
+const STANDARD_TABLES = [
+    { table_name: 'uc_auto_orders', description: 'Auto orders (subscriptions)' },
+    { table_name: 'uc_customers', description: 'customers' },
+    { table_name: 'uc_items', description: 'items' },
+    { table_name: 'uc_orders', description: 'orders' },
+    { table_name: 'uc_zoho_desk_tickets', description: 'Archive of Zoho Desk tickets from customer service' },
+    { table_name: 'uc_affiliate_clicks', description: 'Stores records of clicks on affiliate links, tracking user interactions with affiliate marketing campaigns, including click timestamps, affiliate IDs, and referral details.' },
+    { table_name: 'uc_affiliate_commission_groups', description: 'Contains configuration data for affiliate commission groups, defining commission structures, rates, and rules for affiliate payouts.' },
+    { table_name: 'uc_affiliate_ledgers', description: 'Tracks financial transactions related to affiliates, including earned commissions, adjustments, and payout statuses.' },
+    { table_name: 'uc_affiliate_payments', description: 'Records payment details made to affiliates, including payment amounts, dates, and methods for completed affiliate commissions.' },
+    { table_name: 'uc_affiliate_postback_logs', description: 'Logs postback events sent to or received from affiliate networks, capturing data for tracking conversions and campaign performance.' },
+    { table_name: 'uc_affiliates', description: 'Stores information about affiliate accounts, including affiliate IDs, contact details, and account settings.' },
+    { table_name: 'uc_affiliate_network_pixel_postback_logs', description: 'Affiliate Network Pixel server-to-server postback logs' },
+    { table_name: 'uc_affiliate_network_pixels', description: 'Affiliate Network Pixel configurations' },
+    { table_name: 'uc_cart_abandons', description: 'Abandon cart records' },
+    { table_name: 'uc_conversation_pbx_calls', description: 'Conversation system phone call records from the PBX module' },
+    { table_name: 'uc_conversations', description: 'Conversation system webchat and sms conversations' },
+    { table_name: 'uc_coupons', description: 'Contains details of coupons offered by the storefront, including coupon codes, discount types, expiration dates, and usage restrictions.' },
+    { table_name: 'uc_fraud_rules', description: 'Stores rules and configurations for detecting and preventing fraudulent transactions, such as thresholds and patterns for flagging suspicious activity.' },
+    { table_name: 'uc_gift_certificates', description: 'Tracks gift certificate details, including certificate codes, balances, issuance dates, and redemption status.' },
+    { table_name: 'uc_item_inventory_history', description: 'Records historical changes to item inventory levels, including restocks, sales, and adjustments over time.' },
+    { table_name: 'uc_rotating_transaction_gateway_history', description: 'Logs historical data on transactions processed through rotating payment gateways, including gateway assignments and transaction outcomes.' },
+    { table_name: 'uc_rotating_transaction_gateways', description: 'Stores configuration for rotating payment gateways, including gateway priorities and rules for transaction routing.' },
+    { table_name: 'uc_shipping_methods', description: 'Contains details of available shipping methods, including carrier names, costs, delivery times, and associated rules.' },
+    { table_name: 'uc_storefront_customers', description: 'Stores customer records associated with StoreFront Communications including the email and sms campaigns that the customer was sent through this system' },
+    { table_name: 'uc_storefront_experiments', description: 'Tracks A/B testing or other experiments run on storefronts, including experiment configurations, variants, and performance metrics.' },
+    { table_name: 'uc_storefront_pages', description: 'Contains data on storefront pages, including page URLs, assigned items, permissions, etc.' },
+    { table_name: 'uc_storefront_upsell_offer_events', description: 'Logs events related to upsell offers presented to customers, such as views, clicks, or conversions during the checkout process.' },
+    { table_name: 'uc_storefront_upsell_offers', description: 'Stores details of upsell offers, including offer descriptions, conditions, and associated products or discounts.' },
+    { table_name: 'uc_storefront_upsell_paths', description: 'Defines paths or sequences for presenting upsell offers to customers, including rules for offer eligibility and display order.' },
+    { table_name: 'uc_storefronts', description: 'Contains configuration and metadata for individual storefronts, including domain, theme, and operational settings.' },
+    { table_name: 'uc_surveys', description: 'Stores survey data, including questions, responses, and metadata for customer feedback collected through the platform.' },
+    { table_name: 'uc_workflow_tasks', description: 'Tracks tasks within workflows such as who they are assigned to, status, comments.' },
+];
+function getTables(config, datasetId) {
+    if (datasetId === 'ultracart_dw_streaming') {
+        return STREAMING_TABLES;
+    }
+    return STANDARD_TABLES;
+}
+function getEnhancedSchemaPath(datasetId, tableName) {
+    return path.resolve(__dirname, '..', '..', 'schemas', 'tables', datasetId, `${tableName}.json`);
+}
+async function getTableSchema(config, datasetId, tableName, options) {
+    // Check for enhanced schema first (unless --live is forced)
+    if (!options?.live) {
+        const enhancedPath = getEnhancedSchemaPath(datasetId, tableName);
+        if (fs.existsSync(enhancedPath)) {
+            return JSON.parse(fs.readFileSync(enhancedPath, 'utf-8'));
+        }
+    }
+    // Fall back to live BigQuery
+    const bq = getBigQueryClient(config);
+    const [metadata] = await bq.dataset(datasetId).table(tableName).getMetadata();
+    return metadata.schema.fields;
+}
+function firstSecondOfDay(dateStr) {
+    return `${dateStr} 00:00:00`;
+}
+function lastSecondOfDay(dateStr) {
+    return `${dateStr} 23:59:59`;
+}
+async function executeQuery(config, sql, params = [], options = {}) {
+    const bq = getBigQueryClient(config);
+    // Apply sample limit like the Java code does
+    let querySql = sql;
+    if (options.sample) {
+        const limitRegex = /\s*LIMIT\s+(\d+)\s*$/i;
+        const match = querySql.match(limitRegex);
+        if (match) {
+            const existingLimit = parseInt(match[1], 10);
+            if (existingLimit > options.sample) {
+                querySql = querySql.substring(0, match.index) + ` LIMIT ${options.sample}`;
+            }
+        }
+        else {
+            querySql += ` LIMIT ${options.sample}`;
+        }
+    }
+    const queryOptions = {
+        query: querySql,
+        useLegacySql: false,
+        params: undefined,
+        dryRun: options.dryRun ?? false,
+    };
+    if (params.length > 0) {
+        queryOptions.params = {};
+        for (const p of params) {
+            let value = p.value;
+            switch (p.type) {
+                case 'INT64':
+                    value = parseInt(p.value, 10);
+                    break;
+                case 'FLOAT64':
+                    value = parseFloat(p.value);
+                    break;
+                case 'BOOL':
+                    value = p.value === 'true' || p.value === '1' || p.value === 'yes';
+                    break;
+                case 'DATE':
+                case 'DATETIME': {
+                    // Match Java code: DATE and DATETIME params get start/end of day applied
+                    const dateStr = p.value.substring(0, 10);
+                    if (p.name === 'end_date') {
+                        value = lastSecondOfDay(dateStr);
+                    }
+                    else if (p.name === 'start_date') {
+                        value = firstSecondOfDay(dateStr);
+                    }
+                    else {
+                        value = p.value;
+                    }
+                    break;
+                }
+                case 'STRING':
+                default:
+                    value = p.value;
+                    break;
+            }
+            queryOptions.params[p.name] = value;
+        }
+    }
+    if (options.dryRun) {
+        const [job, apiResponse] = await bq.createQueryJob(queryOptions);
+        const stats = apiResponse?.statistics;
+        return {
+            rows: [],
+            totalRows: 0,
+            schema: [],
+            bytesProcessed: parseInt(stats?.totalBytesProcessed ?? '0', 10),
+        };
+    }
+    // Cost protection: dry-run first to check bytes processed (unless --force)
+    const maxBytes = options.maxBytes ?? config.max_query_bytes ?? (10 * 1024 * 1024 * 1024);
+    if (!options.force) {
+        const dryRunOptions = { ...queryOptions, dryRun: true };
+        const [, dryRunApiResponse] = await bq.createQueryJob(dryRunOptions);
+        const dryRunStats = dryRunApiResponse?.statistics;
+        const estimatedBytes = parseInt(dryRunStats?.totalBytesProcessed ?? '0', 10);
+        const estimatedGB = estimatedBytes / (1024 * 1024 * 1024);
+        const estimatedCost = (estimatedBytes / (1024 * 1024 * 1024 * 1024)) * 6.25;
+        if (estimatedBytes > maxBytes) {
+            throw new Error(`Query would process ${estimatedGB.toFixed(1)} GB (estimated cost: $${estimatedCost.toFixed(4)}), ` +
+                `which exceeds the safety limit of ${(maxBytes / (1024 * 1024 * 1024)).toFixed(1)} GB. ` +
+                `Use --force to execute anyway, or set a higher limit with --max-bytes.`);
+        }
+    }
+    const [rows, jobResponse] = await bq.query(queryOptions);
+    const jobAny = jobResponse;
+    const stats = jobAny?.statistics;
+    // Flatten BigQuery date/timestamp objects (e.g., { value: "2026-03-21" }) to plain strings
+    const flattenedRows = rows.map(flattenRow);
+    return {
+        rows: flattenedRows,
+        totalRows: flattenedRows.length,
+        schema: [],
+        bytesProcessed: parseInt(stats?.totalBytesProcessed ?? '0', 10),
+    };
+}
+function flattenRow(row) {
+    const result = {};
+    for (const [key, val] of Object.entries(row)) {
+        result[key] = flattenValue(val);
+    }
+    return result;
+}
+function getExternalTables(config) {
+    const results = [];
+    if (!config.external_projects)
+        return results;
+    for (const [alias, project] of Object.entries(config.external_projects)) {
+        for (const [dataset, tables] of Object.entries(project.datasets)) {
+            for (const table of tables) {
+                results.push({
+                    alias,
+                    projectId: project.project_id,
+                    description: project.description,
+                    dataset,
+                    table,
+                    fullyQualified: `${project.project_id}.${dataset}.${table}`,
+                });
+            }
+        }
+    }
+    return results;
+}
+const CACHE_DIR = '.ultracart-bq-cache';
+function sanitizePathComponent(name) {
+    return name.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+async function getExternalTableSchema(config, projectId, datasetId, tableName) {
+    // Check cache first
+    const cacheFile = path.join(process.cwd(), CACHE_DIR, sanitizePathComponent(projectId), sanitizePathComponent(datasetId), `${sanitizePathComponent(tableName)}.json`);
+    if (fs.existsSync(cacheFile)) {
+        return JSON.parse(fs.readFileSync(cacheFile, 'utf-8'));
+    }
+    // Fetch live from BigQuery
+    const bq = new bigquery_1.BigQuery({ projectId });
+    const [metadata] = await bq.dataset(datasetId).table(tableName).getMetadata();
+    const fields = metadata.schema.fields;
+    // Save to cache
+    const cacheDir = path.dirname(cacheFile);
+    fs.mkdirSync(cacheDir, { recursive: true });
+    fs.writeFileSync(cacheFile, JSON.stringify(fields, null, 2));
+    return fields;
+}
+async function refreshSchemaCache(config) {
+    const cachePath = path.join(process.cwd(), CACHE_DIR);
+    // Delete existing cache
+    if (fs.existsSync(cachePath)) {
+        fs.rmSync(cachePath, { recursive: true, force: true });
+    }
+    // Re-fetch all external table schemas
+    const tables = getExternalTables(config);
+    for (const table of tables) {
+        await getExternalTableSchema(config, table.projectId, table.dataset, table.table);
+    }
+}
+function flattenValue(val) {
+    if (val === null || val === undefined)
+        return val;
+    if (typeof val === 'object' && !Array.isArray(val)) {
+        const obj = val;
+        // BigQuery NUMERIC/BIGNUMERIC types return Big number objects with s, e, c properties
+        if ('s' in obj && 'e' in obj && 'c' in obj && typeof obj.toString === 'function') {
+            return parseFloat(obj.toString());
+        }
+        // BigQuery date/time objects have a single "value" property
+        if ('value' in obj && Object.keys(obj).length === 1) {
+            return obj.value;
+        }
+        // Recurse into nested records
+        return flattenRow(obj);
+    }
+    if (Array.isArray(val)) {
+        return val.map(flattenValue);
+    }
+    return val;
+}
+//# sourceMappingURL=bigquery.js.map

package/dist/lib/bigquery.js.map

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

package/dist/lib/config-writer.d.ts

@@ -0,0 +1,3 @@
+export declare function readRawConfig(): Record<string, any>;
+export declare function writeConfig(config: Record<string, any>): void;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/lib/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/lib/config-writer.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAMnD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAY7D"}

package/dist/lib/config-writer.js

@@ -0,0 +1,60 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRawConfig = readRawConfig;
+exports.writeConfig = writeConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const CONFIG_FILENAME = '.ultracart-bq.json';
+function readRawConfig() {
+    const configPath = path.join(process.cwd(), CONFIG_FILENAME);
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Config file not found at ${configPath}. Run "uc-bq init" first.`);
+    }
+    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+}
+function writeConfig(config) {
+    // Ensure $schema is present
+    config.$schema = config.$schema || 'https://ultracart.com/schemas/ultracart-bq-config.schema.json';
+    // Validate before writing
+    const validation = (0, config_1.validateConfig)(config);
+    if (!validation.valid) {
+        throw new Error(`Config validation failed:\n  ${validation.errors.join('\n  ')}`);
+    }
+    const configPath = path.join(process.cwd(), CONFIG_FILENAME);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/lib/config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../src/lib/config-writer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,sCAMC;AAED,kCAYC;AA1BD,uCAAyB;AACzB,2CAA6B;AAC7B,qCAA0C;AAE1C,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C,SAAgB,aAAa;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,2BAA2B,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,WAAW,CAAC,MAA2B;IACrD,4BAA4B;IAC5B,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,+DAA+D,CAAC;IAEnG,0BAA0B;IAC1B,MAAM,UAAU,GAAG,IAAA,uBAAc,EAAC,MAAa,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAC7D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,63 @@
+export interface ExternalProject {
+    project_id: string;
+    description?: string;
+    datasets: Record<string, string[]>;
+}
+export interface MerchantConfig {
+    taxonomy_level: 'standard' | 'low' | 'medium' | 'high';
+    dataset: string;
+    external_projects?: Record<string, ExternalProject>;
+}
+export interface UcBqConfig {
+    default_merchant: string;
+    merchants: Record<string, MerchantConfig>;
+    default_output_dir: string;
+    output_format: 'png' | 'pdf' | 'both';
+    chart_theme: string;
+    chart_defaults: {
+        width: number;
+        height: number;
+    };
+    max_query_bytes?: number;
+    llm?: {
+        provider?: string;
+        api_key_env?: string;
+        analysis_model?: string;
+        schema_filter_model?: string;
+        region?: string;
+    };
+}
+export interface LlmConfig {
+    provider: string;
+    apiKey?: string;
+    apiKeyEnv?: string;
+    analysisModel?: string;
+    schemaFilterModel?: string;
+    region?: string;
+}
+export interface ResolvedMerchantConfig {
+    merchant_id: string;
+    project_id: string;
+    taxonomy_level: 'standard' | 'low' | 'medium' | 'high';
+    dataset: string;
+    default_output_dir: string;
+    output_format: 'png' | 'pdf' | 'both';
+    chart_theme: string;
+    chart_defaults: {
+        width: number;
+        height: number;
+    };
+    external_projects?: Record<string, ExternalProject>;
+    max_query_bytes: number;
+}
+export declare function loadConfig(): UcBqConfig;
+export declare function resolveMerchant(config: UcBqConfig, merchantId?: string): ResolvedMerchantConfig;
+export declare function validateConfig(config: UcBqConfig): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function resolveLlmConfig(config: UcBqConfig, overrides?: {
+    provider?: string;
+    apiKey?: string;
+}): LlmConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE;QACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACpD,eAAe,EAAE,MAAM,CAAC;CACzB;AAsDD,wBAAgB,UAAU,IAAI,UAAU,CAmBvC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAuB/F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAEvF;AAUD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAuBlH"}

package/dist/lib/config.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.resolveMerchant = resolveMerchant;
+exports.validateConfig = validateConfig;
+exports.resolveLlmConfig = resolveLlmConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const validator_1 = require("./validator");
+const CONFIG_FILENAME = '.ultracart-bq.json';
+const DEFAULT_MAX_QUERY_BYTES = 10 * 1024 * 1024 * 1024; // 10 GB
+const DEFAULTS = {
+    default_output_dir: './reports',
+    output_format: 'png',
+    chart_theme: 'default',
+    chart_defaults: { width: 1200, height: 600 },
+    max_query_bytes: DEFAULT_MAX_QUERY_BYTES,
+};
+/**
+ * Detects old single-merchant config format (has `project_id`) and migrates
+ * it to the new multi-merchant format in memory. Logs a deprecation warning.
+ */
+function migrateConfigIfNeeded(raw) {
+    if (!('project_id' in raw)) {
+        return raw;
+    }
+    const projectId = raw.project_id;
+    const prefix = 'ultracart-dw-';
+    const merchantId = projectId.startsWith(prefix)
+        ? projectId.substring(prefix.length)
+        : projectId;
+    const taxonomyLevel = raw.taxonomy_level || 'standard';
+    const dataset = raw.dataset || 'ultracart_dw';
+    console.error(`[WARNING] Old config format detected (project_id: "${projectId}"). ` +
+        `Auto-migrating to multi-merchant format with merchant "${merchantId}". ` +
+        `Please update your ${CONFIG_FILENAME} to the new format.`);
+    const migrated = { ...raw };
+    delete migrated.project_id;
+    delete migrated.taxonomy_level;
+    delete migrated.dataset;
+    migrated.default_merchant = merchantId;
+    migrated.merchants = {
+        [merchantId]: {
+            taxonomy_level: taxonomyLevel,
+            dataset: dataset,
+        },
+    };
+    return migrated;
+}
+function loadConfig() {
+    const candidates = [
+        path.join(process.cwd(), CONFIG_FILENAME),
+        path.join(os.homedir(), CONFIG_FILENAME),
+    ];
+    for (const filePath of candidates) {
+        if (fs.existsSync(filePath)) {
+            const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            const migrated = migrateConfigIfNeeded(raw);
+            const config = { ...DEFAULTS, ...migrated };
+            return config;
+        }
+    }
+    throw new Error(`Config file not found. Create ${CONFIG_FILENAME} in the current directory or home directory.\n` +
+        `Required fields: default_merchant, merchants`);
+}
+function resolveMerchant(config, merchantId) {
+    const id = merchantId || config.default_merchant;
+    const merchantConfig = config.merchants[id];
+    if (!merchantConfig) {
+        const available = Object.keys(config.merchants).join(', ');
+        throw new Error(`Merchant "${id}" not found in config. Available merchants: ${available}`);
+    }
+    return {
+        merchant_id: id,
+        project_id: `ultracart-dw-${id.toLowerCase()}`,
+        taxonomy_level: merchantConfig.taxonomy_level,
+        dataset: merchantConfig.dataset,
+        default_output_dir: path.join(config.default_output_dir, id),
+        output_format: config.output_format,
+        chart_theme: config.chart_theme,
+        chart_defaults: config.chart_defaults,
+        external_projects: merchantConfig.external_projects,
+        max_query_bytes: config.max_query_bytes ?? DEFAULT_MAX_QUERY_BYTES,
+    };
+}
+function validateConfig(config) {
+    return (0, validator_1.validateConfig)(config);
+}
+const DEFAULT_API_KEY_ENV = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    grok: 'XAI_API_KEY',
+    bedrock: '', // Uses AWS credential chain, no API key
+    gemini: 'GOOGLE_API_KEY',
+};
+function resolveLlmConfig(config, overrides) {
+    const provider = overrides?.provider || config.llm?.provider || 'anthropic';
+    // Resolve API key: CLI override > env var from config > default env var for provider
+    let apiKey = overrides?.apiKey;
+    let apiKeyEnv = config.llm?.api_key_env;
+    if (!apiKey) {
+        const envVarName = apiKeyEnv || DEFAULT_API_KEY_ENV[provider] || '';
+        if (envVarName) {
+            apiKey = process.env[envVarName];
+            apiKeyEnv = envVarName;
+        }
+    }
+    return {
+        provider,
+        apiKey,
+        apiKeyEnv,
+        analysisModel: config.llm?.analysis_model,
+        schemaFilterModel: config.llm?.schema_filter_model,
+        region: config.llm?.region,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/dashboard.d.ts

@@ -0,0 +1,3 @@
+import { DeckConfig } from './deck';
+export declare function buildDashboardHtml(deck: DeckConfig, reportsBaseDir: string): string;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/lib/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/lib/dashboard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAiB,MAAM,QAAQ,CAAC;AAUnD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CA6UnF"}