@ultracart/bq-skill 0.1.2

package/dist/lib/renderer.js

@@ -0,0 +1,166 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderChart = renderChart;
+exports.checkDependencies = checkDependencies;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const puppeteer_1 = __importDefault(require("puppeteer"));
+function getTemplatePath() {
+    return path.resolve(__dirname, '..', '..', 'templates', 'render.html');
+}
+async function renderChart(options) {
+    const errors = [];
+    const templateHtml = fs.readFileSync(getTemplatePath(), 'utf-8');
+    const chartFunction = fs.readFileSync(options.chartJsPath, 'utf-8');
+    const rawData = fs.readFileSync(options.dataJsonPath, 'utf-8');
+    // The data file may be { rows: [...] } or a plain array — normalize to array
+    let dataArray;
+    try {
+        const parsed = JSON.parse(rawData);
+        if (parsed && Array.isArray(parsed.rows)) {
+            dataArray = JSON.stringify(parsed.rows);
+        }
+        else if (Array.isArray(parsed)) {
+            dataArray = JSON.stringify(parsed);
+        }
+        else {
+            dataArray = rawData;
+        }
+    }
+    catch {
+        dataArray = rawData;
+    }
+    // Remove the auto-executing script from the template — we'll run it manually after injecting data
+    const strippedHtml = templateHtml.replace(/\(function\s*\(\)\s*\{[\s\S]*?\}\)\(\);/, '// Chart initialization will be triggered by Puppeteer');
+    const browser = await puppeteer_1.default.launch({ headless: true });
+    const page = await browser.newPage();
+    await page.setViewport({
+        width: options.width + 40,
+        height: options.height + 40,
+        deviceScaleFactor: 2,
+    });
+    // Load the template (loads ECharts from CDN)
+    await page.setContent(strippedHtml, { waitUntil: 'networkidle0' });
+    // Inject data and render via addScriptTag — guarantees execution after DOM + ECharts are ready
+    await page.addScriptTag({
+        content: `
+      (async function() { try {
+        var data = ${dataArray};
+        var fnSource = ${JSON.stringify(chartFunction)};
+        var isDashboard = ${options.isDashboard};
+        var chartWidth = ${options.width};
+        var chartHeight = ${options.height};
+
+        var container = document.getElementById('myChart');
+        container.style.width = chartWidth + 'px';
+        container.style.height = chartHeight + 'px';
+
+        // Load USA map for geo charts (async)
+        try {
+          var mapResponse = await fetch('https://cdn.jsdelivr.net/npm/echarts@5.4.3/map/json/USA.json');
+          if (mapResponse.ok) {
+            var usaJson = await mapResponse.json();
+            echarts.registerMap('USA', usaJson, {
+              Alaska: { left: -131, top: 25, width: 15 },
+              Hawaii: { left: -110, top: 28, width: 5 },
+              'Puerto Rico': { left: -76, top: 26, width: 2 }
+            });
+          }
+        } catch (e) { /* map not needed for most charts */ }
+
+        var chart = echarts.init(container);
+
+        // Evaluate chart function — runs in Puppeteer sandbox, not Node.js process
+        var functionBody = fnSource
+          .replace(/function\\s+formatChartData\\s*\\(\\s*data\\s*(?:,\\s*isDashboard\\s*(?:=\\s*[^)]+)?\\s*)?\\)\\s*\\{/, '')
+          .replace(/\\}\\s*$/, '');
+        var formatChartData = new Function('data', 'isDashboard', functionBody);
+
+        var options = formatChartData(data, isDashboard);
+
+        if (options && typeof options === 'object') {
+          options.animation = false;
+          chart.setOption(options, true);
+        }
+
+        window.__RENDER_COMPLETE__ = true;
+      } catch (e) {
+        window.__RENDER_ERROR__ = e.message || String(e);
+        window.__RENDER_COMPLETE__ = true;
+      } })();
+    `
+    });
+    // Wait for render to complete
+    await page.waitForFunction('(globalThis).__RENDER_COMPLETE__ === true', { timeout: 30000 });
+    // Check for render errors
+    const renderError = await page.evaluate(() => globalThis.__RENDER_ERROR__);
+    if (renderError) {
+        errors.push(renderError);
+    }
+    if (options.format === 'pdf') {
+        await page.pdf({
+            path: options.outputPath,
+            width: `${options.width + 40}px`,
+            height: `${options.height + 40}px`,
+            printBackground: true,
+        });
+    }
+    else {
+        const chartElement = await page.$('#myChart');
+        if (chartElement) {
+            await chartElement.screenshot({ path: options.outputPath });
+        }
+        else {
+            await page.screenshot({ path: options.outputPath });
+        }
+    }
+    await browser.close();
+    return { outputPath: options.outputPath, errors };
+}
+async function checkDependencies() {
+    try {
+        const browser = await puppeteer_1.default.launch({ headless: true });
+        await browser.close();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/lib/renderer.js.map

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

package/dist/lib/schema-filter.d.ts

@@ -0,0 +1,3 @@
+import type { LlmProvider } from './llm/provider';
+export declare function filterSchemaWithLLM(schema: any[], naturalLanguageQuery: string, provider: LlmProvider, model: string): Promise<any[]>;
+//# sourceMappingURL=schema-filter.d.ts.map

package/dist/lib/schema-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-filter.d.ts","sourceRoot":"","sources":["../../src/lib/schema-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAgB9D,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,GAAG,EAAE,EACb,oBAAoB,EAAE,MAAM,EAC5B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC,CAiChB"}

package/dist/lib/schema-filter.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterSchemaWithLLM = filterSchemaWithLLM;
+const SCHEMA_FILTER_SYSTEM_PROMPT = `You are an expert at taking a natural language query from users for building reports or charts and filtering down BigQuery schema to fields highly likely to be used by another AI agent to write the query. Take the user's query and the schema in JSON format, then return only the applicable schema in minified single line JSON format inside a markdown code block (\`\`\`json).
+
+# Follow these rules when processing column definitions
+1. Always include columns with a name of "partition_date"
+2. Always include columns with mandatory = true
+3. CRITICALLY IMPORTANT: DO NOT modify or filter the "allowed_values" array in any way. The entire allowed_values list must be preserved exactly as it appears in the original schema.
+4. If a column has 'mandatory': true, ALWAYS include the entire column definition in the output, regardless of other filtering criteria.
+
+# Additional Output Instructions
+- When a column is selected, include its description as a "description" field
+- Preserve all other specified filtering rules
+
+Do not include any other output, explanations, or unnecessary whitespace to minimize token count.`;
+async function filterSchemaWithLLM(schema, naturalLanguageQuery, provider, model) {
+    const messages = [
+        { role: 'system', content: SCHEMA_FILTER_SYSTEM_PROMPT },
+        {
+            role: 'user',
+            content: `Here is the BigQuery schema:\n\`\`\`json\n${JSON.stringify(schema)}\n\`\`\``,
+        },
+        {
+            role: 'user',
+            content: `Please filter the schema based on this query: ${naturalLanguageQuery}`,
+        },
+    ];
+    const text = await provider.complete(messages, {
+        model,
+        maxTokens: 8192,
+        temperature: 0,
+    });
+    // Extract the JSON from the markdown code block
+    const match = text.match(/```json\s*([\s\S]*?)```/);
+    if (match) {
+        return JSON.parse(match[1].trim());
+    }
+    // If no code block found, try parsing the whole response
+    try {
+        return JSON.parse(text.trim());
+    }
+    catch {
+        // Fall back to full schema if parsing fails
+        console.error('Warning: LLM schema filtering returned unparseable response, using full schema.');
+        return schema;
+    }
+}
+//# sourceMappingURL=schema-filter.js.map

package/dist/lib/schema-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-filter.js","sourceRoot":"","sources":["../../src/lib/schema-filter.ts"],"names":[],"mappings":";;AAgBA,kDAsCC;AApDD,MAAM,2BAA2B,GAAG;;;;;;;;;;;;kGAY8D,CAAC;AAE5F,KAAK,UAAU,mBAAmB,CACvC,MAAa,EACb,oBAA4B,EAC5B,QAAqB,EACrB,KAAa;IAEb,MAAM,QAAQ,GAAiB;QAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE;QACxD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,6CAA6C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU;SACvF;QACD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,iDAAiD,oBAAoB,EAAE;SACjF;KACF,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;QAC7C,KAAK;QACL,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,CAAC;KACf,CAAC,CAAC;IAEH,gDAAgD;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACpD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;QAC5C,OAAO,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/lib/template.d.ts

@@ -0,0 +1,4 @@
+export declare function substituteParams(sql: string, params: Record<string, string>): string;
+export declare function processConditionals(sql: string, params: Record<string, string>): string;
+export declare function renderTemplate(sqlTemplate: string, params: Record<string, string>): string;
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/lib/template.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAOpF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA0BvF;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAG1F"}

package/dist/lib/template.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.substituteParams = substituteParams;
+exports.processConditionals = processConditionals;
+exports.renderTemplate = renderTemplate;
+function substituteParams(sql, params) {
+    return sql.replace(/\{\{(\w+)\}\}/g, (match, name) => {
+        if (name in params) {
+            return params[name];
+        }
+        return match;
+    });
+}
+function processConditionals(sql, params) {
+    // Handle {% if param_name != 'value' %}...{% endif %}
+    let result = sql.replace(/\{%\s*if\s+(\w+)\s*!=\s*'([^']*)'\s*%\}([\s\S]*?)\{%\s*endif\s*%\}/g, (_match, name, value, body) => {
+        const paramValue = params[name];
+        if (paramValue !== undefined && paramValue !== value) {
+            return body;
+        }
+        return '';
+    });
+    // Handle {% if param_name %}...{% endif %}
+    result = result.replace(/\{%\s*if\s+(\w+)\s*%\}([\s\S]*?)\{%\s*endif\s*%\}/g, (_match, name, body) => {
+        const paramValue = params[name];
+        if (paramValue !== undefined && paramValue !== '' && paramValue !== 'false') {
+            return body;
+        }
+        return '';
+    });
+    return result;
+}
+function renderTemplate(sqlTemplate, params) {
+    const afterConditionals = processConditionals(sqlTemplate, params);
+    return substituteParams(afterConditionals, params);
+}
+//# sourceMappingURL=template.js.map

package/dist/lib/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/lib/template.ts"],"names":[],"mappings":";;AAAA,4CAOC;AAED,kDA0BC;AAED,wCAGC;AAxCD,SAAgB,gBAAgB,CAAC,GAAW,EAAE,MAA8B;IAC1E,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnD,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,mBAAmB,CAAC,GAAW,EAAE,MAA8B;IAC7E,sDAAsD;IACtD,IAAI,MAAM,GAAG,GAAG,CAAC,OAAO,CACtB,qEAAqE,EACrE,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CACF,CAAC;IAEF,2CAA2C;IAC3C,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,oDAAoD,EACpD,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC5E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,MAA8B;IAChF,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/lib/validator.d.ts

@@ -0,0 +1,8 @@
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateConfig(config: unknown): ValidationResult;
+export declare function validateManifest(manifest: unknown): ValidationResult;
+export {};
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA8BD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAQhE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAQpE"}

package/dist/lib/validator.js

@@ -0,0 +1,88 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+exports.validateManifest = validateManifest;
+const ajv_1 = __importDefault(require("ajv"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function createAjv() {
+    const ajv = new ajv_1.default({ allErrors: true });
+    (0, ajv_formats_1.default)(ajv);
+    return ajv;
+}
+function getSchemaPath(schemaFile) {
+    // Resolve relative to the package root (two levels up from dist/lib/)
+    return path.resolve(__dirname, '..', '..', 'schemas', schemaFile);
+}
+function loadSchema(schemaFile) {
+    const schemaPath = getSchemaPath(schemaFile);
+    const schema = JSON.parse(fs.readFileSync(schemaPath, 'utf-8'));
+    // Remove $schema and $id — Ajv doesn't support 2020-12 meta-schema natively
+    delete schema.$schema;
+    delete schema.$id;
+    return schema;
+}
+function formatErrors(ajv) {
+    if (!ajv.errors)
+        return [];
+    return ajv.errors.map((e) => {
+        const path = e.instancePath || '/';
+        return `${path}: ${e.message}`;
+    });
+}
+function validateConfig(config) {
+    const ajv = createAjv();
+    const schema = loadSchema('ultracart-bq-config.schema.json');
+    const valid = ajv.validate(schema, config);
+    return {
+        valid: valid,
+        errors: valid ? [] : formatErrors(ajv),
+    };
+}
+function validateManifest(manifest) {
+    const ajv = createAjv();
+    const schema = loadSchema('report-manifest.schema.json');
+    const valid = ajv.validate(schema, manifest);
+    return {
+        valid: valid,
+        errors: valid ? [] : formatErrors(ajv),
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,wCAQC;AAED,4CAQC;AAxDD,8CAAsB;AACtB,8DAAqC;AACrC,uCAAyB;AACzB,2CAA6B;AAO7B,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB;IACvC,sEAAsE;IACtE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,4EAA4E;IAC5E,OAAO,MAAM,CAAC,OAAO,CAAC;IACtB,OAAO,MAAM,CAAC,GAAG,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,GAAQ;IAC5B,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,GAAG,CAAC;QACnC,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,cAAc,CAAC,MAAe;IAC5C,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,UAAU,CAAC,iCAAiC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,KAAK,EAAE,KAAgB;QACvB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC;KACvC,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAiB;IAChD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO;QACL,KAAK,EAAE,KAAgB;QACvB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ultracart/bq-skill",
+  "version": "0.1.2",
+  "description": "UltraCart BigQuery reporting skill for Claude Code — CLI + skill prompt for creating and replaying e-commerce reports",
+  "main": "dist/cli.js",
+  "bin": {
+    "uc-bq": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ultracart",
+    "bigquery",
+    "claude-code",
+    "reporting",
+    "echarts",
+    "e-commerce"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UltraCart/uc-bq-claude-skill"
+  },
+  "author": "UltraCart",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.0.0",
+    "@google-cloud/bigquery": "^8.0.0",
+    "@google/generative-ai": "^0.24.0",
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.0",
+    "commander": "^14.0.0",
+    "js-yaml": "^4.1.0",
+    "md-to-pdf": "^5.2.5",
+    "openai": "^6.0.0",
+    "puppeteer": "^24.0.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "files": [
+    "dist/",
+    "schemas/",
+    "templates/",
+    "skill/"
+  ],
+  "volta": {
+    "node": "24.13.0"
+  }
+}

package/schemas/deck.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ultracart.com/schemas/deck.schema.json",
+  "title": "UltraCart Report Deck",
+  "description": "A deck definition that combines multiple reports into a single branded PDF with cover page and table of contents.",
+  "type": "object",
+  "required": ["name", "title", "reports"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Human-readable deck name",
+      "minLength": 1,
+      "maxLength": 100
+    },
+    "title": {
+      "type": "string",
+      "description": "Title displayed on the cover page",
+      "maxLength": 200
+    },
+    "cover": {
+      "type": "object",
+      "description": "Cover page branding options",
+      "properties": {
+        "company": {
+          "type": "string",
+          "description": "Company name displayed on the cover page"
+        },
+        "logo_url": {
+          "type": "string",
+          "description": "URL to a logo image to embed on the cover page"
+        }
+      },
+      "additionalProperties": false
+    },
+    "reports": {
+      "type": "array",
+      "description": "Ordered list of reports to include. Each entry is either a report directory name (string) or an object with name and optional per-report parameter overrides.",
+      "items": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "required": ["name"],
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Report directory name"
+              },
+              "parameters": {
+                "type": "object",
+                "description": "Per-report parameter overrides (always win over deck-level parameters)",
+                "additionalProperties": { "type": "string" }
+              }
+            }
+          }
+        ]
+      },
+      "minItems": 1
+    },
+    "parameter_mode": {
+      "type": "string",
+      "enum": ["smart", "override"],
+      "description": "How deck-level parameters push down to reports. 'smart' (default): only override static date defaults, leave relative date expressions (today, -90d, start_of_year, etc.) alone. 'override': deck parameters always win over report defaults.",
+      "default": "smart"
+    },
+    "parameters": {
+      "type": "object",
+      "description": "Shared parameter defaults that flow down to all reports in the deck (subject to parameter_mode)",
+      "additionalProperties": { "type": "string" }
+    },
+    "landscape": {
+      "type": "boolean",
+      "description": "Generate the deck PDF in landscape orientation"
+    },
+    "delivery": {
+      "type": "object",
+      "description": "Deck delivery configuration for Slack and/or email",
+      "properties": {
+        "slack": {
+          "type": "object",
+          "properties": {
+            "channels": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "minItems": 1,
+              "description": "Slack channel IDs (e.g., C0123456789)"
+            }
+          },
+          "required": ["channels"],
+          "additionalProperties": false
+        },
+        "email": {
+          "type": "object",
+          "properties": {
+            "to": {
+              "type": "array",
+              "items": { "type": "string", "format": "email" },
+              "minItems": 1,
+              "description": "Recipient email addresses"
+            },
+            "subject": {
+              "type": "string",
+              "description": "Email subject line"
+            },
+            "provider": {
+              "type": "string",
+              "enum": ["sendgrid", "ses", "postmark", "mailgun", "resend"],
+              "description": "Email delivery provider"
+            }
+          },
+          "required": ["to", "subject", "provider"],
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}