@smallwebco/tinypivot-core 1.0.52 → 1.0.54

package/dist/ai/prompts.js

@@ -0,0 +1,221 @@
+/**
+ * Build the system prompt for the AI Data Analyst
+ */
+export function buildSystemPrompt(dataSources, schemas, selectedSourceId) {
+    const selectedSchema = selectedSourceId ? schemas.get(selectedSourceId) : undefined;
+    const selectedSource = selectedSourceId
+        ? dataSources.find(ds => ds.id === selectedSourceId)
+        : undefined;
+    return `You are a data analyst assistant. Your job is to translate user questions into SQL queries and return data results.
+
+## CRITICAL: ALWAYS GENERATE A SQL QUERY
+**Every response MUST include a SQL query.** The user is here to explore data - they expect to see results.
+- If the user asks a question → Generate a query to answer it
+- If the user says "show me" or "what are" → Generate a query
+- If the user asks for trends/patterns → Generate an aggregation query
+- If the question is vague → Make reasonable assumptions and generate a query anyway
+- If you're unsure what they want → Generate a sensible default query (like top 10 rows with key columns)
+
+**NEVER respond with only text. ALWAYS include a SQL query in your response.**
+
+## Available Data Sources
+${formatDataSourcesList(dataSources)}
+
+${selectedSource && selectedSchema ? formatSelectedSchemaContext(selectedSource, selectedSchema) : '## No Data Source Selected\nPlease ask the user to select a data source first.'}
+
+## Query Rules
+1. **READ-ONLY**: ONLY use SELECT. NEVER use INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE, or any write operations.
+2. **LIMIT RESULTS**: Always use LIMIT (default 100-1000 rows) to avoid overwhelming results.
+3. **ONE TABLE**: Only query the currently selected table: \`${selectedSchema?.table || 'table_name'}\`
+4. **BE SPECIFIC**: Select relevant columns, not SELECT * (unless showing sample data)
+
+## Query Format
+Output queries in this EXACT format (the system auto-executes SQL blocks):
+
+\`\`\`sql
+SELECT column1, column2 FROM ${selectedSchema?.table || 'table_name'} WHERE condition LIMIT 100
+\`\`\`
+
+For complex analysis, use CTEs:
+\`\`\`sql
+WITH summary AS (
+  SELECT category, COUNT(*) as count
+  FROM ${selectedSchema?.table || 'table_name'}
+  GROUP BY category
+)
+SELECT * FROM summary ORDER BY count DESC LIMIT 20
+\`\`\`
+
+## Response Format
+Keep responses concise and insight-focused:
+1. **Start with the SQL query** in a code block (REQUIRED) - this will be extracted and hidden from the user
+2. **Then provide your insight/analysis** (2-3 sentences) explaining what the data shows
+3. **Optional**: Suggest 1-2 follow-up questions
+
+**IMPORTANT**: The SQL block is automatically extracted and shown separately. Your text response should focus on INSIGHTS about the data, not describing the query itself. Don't say "I'm querying..." or "This query shows...". Instead, provide the analytical insight directly.
+
+Example response:
+"\`\`\`sql
+SELECT department, AVG(salary) as avg_salary FROM employees GROUP BY department ORDER BY avg_salary DESC LIMIT 10
+\`\`\`
+
+Engineering and Product teams have the highest average salaries at $145K and $138K respectively, while Support and Operations are at the lower end around $75K. This 2x salary gap may indicate market-driven compensation or role complexity differences.
+
+Want to see how this breaks down by job level?"
+
+## If Query Fails
+- Acknowledge the error briefly
+- Provide a corrected query immediately
+- Don't apologize excessively, just fix it`;
+}
+/**
+ * Format the list of available data sources for the prompt
+ */
+function formatDataSourcesList(dataSources) {
+    if (dataSources.length === 0) {
+        return 'No data sources configured.';
+    }
+    return dataSources
+        .map((ds) => {
+        const desc = ds.description ? `: ${ds.description}` : '';
+        return `- **${ds.name}** (${ds.table})${desc}`;
+    })
+        .join('\n');
+}
+/**
+ * Format the schema context for the currently selected data source
+ */
+function formatSelectedSchemaContext(source, schema) {
+    // Filter out hidden columns
+    const visibleColumns = schema.columns.filter((col) => {
+        const override = source.columns?.find(c => c.name === col.name);
+        return !override?.hidden;
+    });
+    // Merge descriptions from overrides
+    const columnsWithDescriptions = visibleColumns.map((col) => {
+        const override = source.columns?.find(c => c.name === col.name);
+        return {
+            ...col,
+            description: override?.description || col.description,
+        };
+    });
+    return `## Currently Selected: ${source.name}
+Table: \`${schema.table}\`
+${source.description ? `Description: ${source.description}` : ''}
+
+### Columns
+${formatColumnsTable(columnsWithDescriptions)}
+
+### Query Tips
+- Use column names exactly as shown above
+- The table name is \`${schema.table}\`
+- For text searches, use ILIKE for case-insensitive matching
+- For date columns, use standard SQL date functions`;
+}
+/**
+ * Format columns as a readable table for the prompt
+ */
+function formatColumnsTable(columns) {
+    return columns
+        .map((col) => {
+        const nullable = col.nullable ? 'nullable' : 'required';
+        const desc = col.description ? ` - ${col.description}` : '';
+        return `- \`${col.name}\` (${col.type}, ${nullable})${desc}`;
+    })
+        .join('\n');
+}
+/**
+ * Build a user message with additional context
+ */
+export function buildUserMessage(userInput, context) {
+    let message = userInput;
+    if (context?.previousQueryFailed && context.errorMessage) {
+        message = `[Previous query failed: ${context.errorMessage}]\n\n${userInput}`;
+    }
+    return message;
+}
+/**
+ * Extract SQL query from AI response
+ * Returns the SQL if found, null otherwise
+ */
+export function extractSQLFromResponse(response) {
+    // Match SQL code blocks
+    const sqlBlockRegex = /```sql\s*([\s\S]*?)```/i;
+    const match = response.match(sqlBlockRegex);
+    if (match && match[1]) {
+        const sql = match[1].trim();
+        // Validate it's a SELECT statement
+        if (!sql.toUpperCase().startsWith('SELECT')) {
+            return null;
+        }
+        return sql;
+    }
+    return null;
+}
+/**
+ * Validate that a SQL query is safe (read-only)
+ */
+export function validateSQLSafety(sql) {
+    const upperSQL = sql.toUpperCase().trim();
+    // Must start with SELECT or WITH (for CTEs)
+    if (!upperSQL.startsWith('SELECT') && !upperSQL.startsWith('WITH')) {
+        return { valid: false, error: 'Only SELECT queries (including CTEs with WITH) are allowed' };
+    }
+    // If it starts with WITH, ensure it ends with a SELECT
+    if (upperSQL.startsWith('WITH') && !upperSQL.includes('SELECT')) {
+        return { valid: false, error: 'CTE queries must include a final SELECT statement' };
+    }
+    // Check for dangerous keywords
+    const dangerousKeywords = [
+        'INSERT',
+        'UPDATE',
+        'DELETE',
+        'DROP',
+        'ALTER',
+        'TRUNCATE',
+        'CREATE',
+        'GRANT',
+        'REVOKE',
+        'EXEC',
+        'EXECUTE',
+        'INTO', // SELECT INTO
+    ];
+    for (const keyword of dangerousKeywords) {
+        // Check for keyword as a whole word (not part of column name)
+        const regex = new RegExp(`\\b${keyword}\\b`, 'i');
+        if (regex.test(sql)) {
+            return { valid: false, error: `Query contains forbidden keyword: ${keyword}` };
+        }
+    }
+    // Check for multiple statements
+    if (sql.includes(';')) {
+        const statements = sql.split(';').filter(s => s.trim().length > 0);
+        if (statements.length > 1) {
+            return { valid: false, error: 'Multiple statements are not allowed' };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Build a summary message after query results are returned
+ */
+export function buildResultsSummary(rowCount, truncated, maxRows) {
+    if (rowCount === 0) {
+        return 'The query returned no results. You may want to adjust your filters or try a different approach.';
+    }
+    if (truncated) {
+        return `Retrieved ${rowCount} rows (limited to ${maxRows}). There may be more data matching your query. Consider adding filters to narrow down the results.`;
+    }
+    return `Retrieved ${rowCount} row${rowCount === 1 ? '' : 's'}.`;
+}
+/**
+ * Strip SQL code blocks from message content for display
+ * The SQL is stored in metadata and shown via a button instead
+ */
+export function stripSQLFromContent(content) {
+    // Remove SQL code blocks and any surrounding whitespace
+    return content
+        .replace(/```sql\s*[\s\S]*?```\s*/gi, '')
+        .trim();
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

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

package/dist/ai/session.d.ts

@@ -0,0 +1,69 @@
+/**
+ * TinyPivot Core - AI Session Management
+ * Utilities for managing AI conversation sessions
+ */
+import type { AIConversation, AIMessage } from '../types';
+/**
+ * Generate a unique session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Generate a unique message ID
+ */
+export declare function generateMessageId(): string;
+/**
+ * Create a new empty conversation
+ */
+export declare function createConversation(sessionId?: string): AIConversation;
+/**
+ * Create a user message
+ */
+export declare function createUserMessage(content: string): AIMessage;
+/**
+ * Create an assistant message
+ */
+export declare function createAssistantMessage(content: string, metadata?: AIMessage['metadata']): AIMessage;
+/**
+ * Create a system message
+ */
+export declare function createSystemMessage(content: string): AIMessage;
+/**
+ * Add a message to a conversation (immutably)
+ */
+export declare function addMessageToConversation(conversation: AIConversation, message: AIMessage): AIConversation;
+/**
+ * Update the data source for a conversation
+ */
+export declare function setConversationDataSource(conversation: AIConversation, dataSourceId: string | undefined): AIConversation;
+/**
+ * Serialize a conversation to JSON string for storage
+ */
+export declare function serializeConversation(conversation: AIConversation): string;
+/**
+ * Deserialize a conversation from JSON string
+ */
+export declare function deserializeConversation(json: string): AIConversation | null;
+/**
+ * Get the messages formatted for the AI API
+ * Excludes system messages and metadata
+ */
+export declare function getMessagesForAPI(conversation: AIConversation): Array<{
+    role: 'user' | 'assistant';
+    content: string;
+}>;
+/**
+ * Trim conversation to last N messages to manage context window
+ */
+export declare function trimConversation(conversation: AIConversation, maxMessages: number): AIConversation;
+/**
+ * Get conversation statistics
+ */
+export declare function getConversationStats(conversation: AIConversation): {
+    messageCount: number;
+    userMessageCount: number;
+    assistantMessageCount: number;
+    queriesExecuted: number;
+    successfulQueries: number;
+    failedQueries: number;
+};
+//# sourceMappingURL=session.d.ts.map

package/dist/ai/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/ai/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CASrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAO5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAC/B,SAAS,CAQX;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAO9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,cAAc,EAC5B,OAAO,EAAE,SAAS,GACjB,cAAc,CAMhB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,cAAc,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,cAAc,CAMhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,cAAc,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAkB3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,cAAc,GAC3B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAOxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,cAAc,EAC5B,WAAW,EAAE,MAAM,GAClB,cAAc,CAUhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,cAAc,GAAG;IAClE,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;CACtB,CAaA"}

package/dist/ai/session.js

@@ -0,0 +1,145 @@
+/**
+ * Generate a unique session ID
+ */
+export function generateSessionId() {
+    return `tp-ai-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Generate a unique message ID
+ */
+export function generateMessageId() {
+    return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * Create a new empty conversation
+ */
+export function createConversation(sessionId) {
+    const now = Date.now();
+    return {
+        id: sessionId || generateSessionId(),
+        messages: [],
+        dataSourceId: undefined,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Create a user message
+ */
+export function createUserMessage(content) {
+    return {
+        id: generateMessageId(),
+        role: 'user',
+        content,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Create an assistant message
+ */
+export function createAssistantMessage(content, metadata) {
+    return {
+        id: generateMessageId(),
+        role: 'assistant',
+        content,
+        timestamp: Date.now(),
+        metadata,
+    };
+}
+/**
+ * Create a system message
+ */
+export function createSystemMessage(content) {
+    return {
+        id: generateMessageId(),
+        role: 'system',
+        content,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Add a message to a conversation (immutably)
+ */
+export function addMessageToConversation(conversation, message) {
+    return {
+        ...conversation,
+        messages: [...conversation.messages, message],
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Update the data source for a conversation
+ */
+export function setConversationDataSource(conversation, dataSourceId) {
+    return {
+        ...conversation,
+        dataSourceId,
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Serialize a conversation to JSON string for storage
+ */
+export function serializeConversation(conversation) {
+    return JSON.stringify(conversation);
+}
+/**
+ * Deserialize a conversation from JSON string
+ */
+export function deserializeConversation(json) {
+    try {
+        const parsed = JSON.parse(json);
+        // Basic validation
+        if (typeof parsed !== 'object'
+            || !parsed.id
+            || !Array.isArray(parsed.messages)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the messages formatted for the AI API
+ * Excludes system messages and metadata
+ */
+export function getMessagesForAPI(conversation) {
+    return conversation.messages
+        .filter(m => m.role !== 'system')
+        .map(m => ({
+        role: m.role,
+        content: m.content,
+    }));
+}
+/**
+ * Trim conversation to last N messages to manage context window
+ */
+export function trimConversation(conversation, maxMessages) {
+    if (conversation.messages.length <= maxMessages) {
+        return conversation;
+    }
+    return {
+        ...conversation,
+        messages: conversation.messages.slice(-maxMessages),
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Get conversation statistics
+ */
+export function getConversationStats(conversation) {
+    const messages = conversation.messages;
+    const queriesExecuted = messages.filter(m => m.metadata?.query).length;
+    const failedQueries = messages.filter(m => m.metadata?.error).length;
+    return {
+        messageCount: messages.length,
+        userMessageCount: messages.filter(m => m.role === 'user').length,
+        assistantMessageCount: messages.filter(m => m.role === 'assistant').length,
+        queriesExecuted,
+        successfulQueries: queriesExecuted - failedQueries,
+        failedQueries,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/ai/session.js.map

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

package/dist/chart/index.d.ts

@@ -55,15 +55,41 @@ export declare function processChartData(data: Record<string, unknown>[], config
  * Process data for pie/donut charts
  */
 export declare function processChartDataForPie(data: Record<string, unknown>[], config: ChartConfig): ChartData;
-/**
- * Process data for scatter/bubble charts
- */
-export declare function processChartDataForScatter(data: Record<string, unknown>[], config: ChartConfig): Array<{
+/** Point data for scatter/bubble charts */
+export interface ScatterPoint {
     x: number;
     y: number;
     z?: number;
     label?: string;
-}>;
+}
+/** Grouped scatter data with multiple series */
+export interface ScatterSeriesData {
+    series: Array<{
+        name: string;
+        data: ScatterPoint[];
+    }>;
+}
+/**
+ * Process data for scatter/bubble charts
+ * Returns grouped series when seriesField is provided for color-coding
+ */
+export declare function processChartDataForScatter(data: Record<string, unknown>[], config: ChartConfig): ScatterSeriesData;
+/** Heatmap series data format for ApexCharts */
+export interface HeatmapSeriesData {
+    series: Array<{
+        name: string;
+        data: Array<{
+            x: string;
+            y: number;
+        }>;
+    }>;
+}
+/**
+ * Process data for heatmap charts
+ * ApexCharts heatmaps need: series[] where each series is a Y category
+ * containing data[] of {x: X category, y: value}
+ */
+export declare function processChartDataForHeatmap(data: Record<string, unknown>[], config: ChartConfig): HeatmapSeriesData;
 /**
  * Create a default chart config
  */

package/dist/chart/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chart/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,cAAc,EAEd,SAAS,EACT,aAAa,EACb,SAAS,EACV,MAAM,UAAU,CAAA;AAEjB;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,EAqGtC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAOhG,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,UAWxB,CAAA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,SAAS,CAyCX;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC9B,cAAc,EAAE,CAgDlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAE3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAuB/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,gBAAgB,GAAG,MAAM,CAoBvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,WAAW,GAClB,SAAS,CAuEX;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,WAAW,GAClB,SAAS,CAwCX;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,WAAW,GAClB,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CActD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAc,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAOvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAWhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chart/index.ts"],"names":[],"mappings":"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"}