@happyvertical/smrt-reports 0.55.24 → 0.56.1

package/dist/svelte/spec.js

@@ -0,0 +1,282 @@
+const IDENTIFIER = /^[A-Za-z][A-Za-z0-9_]*$/;
+const ALIAS = /^[a-z][a-z0-9_]*$/;
+const SOURCE = /^[A-Za-z@][A-Za-z0-9_@./:-]*$/;
+// biome-ignore lint/suspicious/noControlCharactersInRegex: mirrors the server grammar's printable-text guard
+const CONTROL = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/;
+const BUCKETS = new Set([
+    'minute',
+    'hour',
+    'day',
+    'week',
+    'month',
+    'quarter',
+    'year',
+]);
+const MEASURES = new Set([
+    'count',
+    'countDistinct',
+    'sum',
+    'avg',
+    'min',
+    'max',
+]);
+const FILTERS = new Set([
+    'eq',
+    'ne',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'in',
+    'notIn',
+    'contains',
+    'isNull',
+    'isNotNull',
+]);
+const HAVING = new Set(['eq', 'ne', 'gt', 'gte', 'lt', 'lte']);
+const CHARTS = new Set(['table', 'bar', 'line', 'pie', 'stat']);
+const RESERVED = new Set([
+    'all',
+    'and',
+    'as',
+    'asc',
+    'between',
+    'by',
+    'case',
+    'cast',
+    'check',
+    'column',
+    'constraint',
+    'create',
+    'cross',
+    'default',
+    'delete',
+    'desc',
+    'distinct',
+    'drop',
+    'else',
+    'end',
+    'except',
+    'exists',
+    'false',
+    'for',
+    'foreign',
+    'from',
+    'full',
+    'group',
+    'having',
+    'in',
+    'inner',
+    'insert',
+    'intersect',
+    'into',
+    'is',
+    'join',
+    'left',
+    'like',
+    'limit',
+    'natural',
+    'not',
+    'null',
+    'offset',
+    'on',
+    'or',
+    'order',
+    'outer',
+    'primary',
+    'references',
+    'right',
+    'select',
+    'set',
+    'table',
+    'then',
+    'to',
+    'true',
+    'union',
+    'unique',
+    'update',
+    'user',
+    'using',
+    'values',
+    'when',
+    'where',
+    'with',
+]);
+function record(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null
+        ? value
+        : null;
+}
+function keys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.includes(key));
+}
+function text(value, max, optional = false) {
+    if (value === undefined)
+        return optional;
+    if (typeof value !== 'string')
+        return false;
+    const trimmed = value.trim();
+    return (trimmed.length > 0 &&
+        trimmed.length <= max &&
+        trimmed === value &&
+        !CONTROL.test(trimmed));
+}
+function field(value) {
+    return (typeof value === 'string' && value.length <= 64 && IDENTIFIER.test(value));
+}
+function alias(value) {
+    return (typeof value === 'string' &&
+        value.length <= 40 &&
+        ALIAS.test(value) &&
+        !RESERVED.has(value));
+}
+function scalar(value) {
+    return ((typeof value === 'string' &&
+        value.length <= 256 &&
+        !value.includes('\u0000')) ||
+        (typeof value === 'number' && Number.isFinite(value)) ||
+        typeof value === 'boolean');
+}
+/** Browser-safe validation of the server's already-normalized closed grammar. */
+export function validRuntimeReportSpec(value) {
+    const spec = record(value);
+    if (!spec ||
+        !keys(spec, [
+            'version',
+            'title',
+            'description',
+            'source',
+            'dimensions',
+            'measures',
+            'filters',
+            'having',
+            'sort',
+            'limit',
+            'chart',
+        ]) ||
+        spec.version !== 1 ||
+        !text(spec.title, 120) ||
+        !text(spec.description, 500, true) ||
+        typeof spec.source !== 'string' ||
+        spec.source.length === 0 ||
+        spec.source.length > 120 ||
+        !SOURCE.test(spec.source) ||
+        !Array.isArray(spec.dimensions) ||
+        spec.dimensions.length > 4 ||
+        !Array.isArray(spec.measures) ||
+        spec.measures.length < 1 ||
+        spec.measures.length > 6 ||
+        !Array.isArray(spec.filters) ||
+        spec.filters.length > 12 ||
+        !Array.isArray(spec.having) ||
+        spec.having.length > 4 ||
+        !Array.isArray(spec.sort) ||
+        spec.sort.length > 3 ||
+        !Number.isSafeInteger(spec.limit) ||
+        spec.limit < 1 ||
+        spec.limit > 1000)
+        return false;
+    const dimensions = new Set();
+    const measures = new Set();
+    const aliases = new Set();
+    for (const value of spec.dimensions) {
+        const item = record(value);
+        if (!item ||
+            !keys(item, ['field', 'as', 'bucket']) ||
+            !field(item.field) ||
+            !alias(item.as) ||
+            (item.bucket !== undefined &&
+                (typeof item.bucket !== 'string' || !BUCKETS.has(item.bucket))) ||
+            aliases.has(item.as))
+            return false;
+        aliases.add(item.as);
+        dimensions.add(item.as);
+    }
+    for (const value of spec.measures) {
+        const item = record(value);
+        if (!item ||
+            !keys(item, ['fn', 'field', 'as']) ||
+            typeof item.fn !== 'string' ||
+            !MEASURES.has(item.fn) ||
+            !alias(item.as) ||
+            aliases.has(item.as) ||
+            (item.field !== undefined && !field(item.field)) ||
+            (item.fn !== 'count' && item.field === undefined))
+            return false;
+        aliases.add(item.as);
+        measures.add(item.as);
+    }
+    for (const value of spec.filters) {
+        const item = record(value);
+        if (!item ||
+            !keys(item, ['field', 'op', 'value']) ||
+            !field(item.field) ||
+            typeof item.op !== 'string' ||
+            !FILTERS.has(item.op))
+            return false;
+        if (item.op === 'isNull' || item.op === 'isNotNull') {
+            if (item.value !== undefined)
+                return false;
+        }
+        else if (item.op === 'in' || item.op === 'notIn') {
+            if (!Array.isArray(item.value) ||
+                item.value.length < 1 ||
+                item.value.length > 100 ||
+                !item.value.every(scalar))
+                return false;
+        }
+        else if (!scalar(item.value) ||
+            (item.op === 'contains' && typeof item.value !== 'string'))
+            return false;
+    }
+    for (const value of spec.having) {
+        const item = record(value);
+        if (!item ||
+            !keys(item, ['measure', 'op', 'value']) ||
+            !alias(item.measure) ||
+            !measures.has(item.measure) ||
+            typeof item.op !== 'string' ||
+            !HAVING.has(item.op) ||
+            typeof item.value !== 'number' ||
+            !Number.isFinite(item.value))
+            return false;
+    }
+    for (const value of spec.sort) {
+        const item = record(value);
+        if (!item ||
+            !keys(item, ['by', 'direction']) ||
+            !alias(item.by) ||
+            !aliases.has(item.by) ||
+            (item.direction !== 'asc' && item.direction !== 'desc'))
+            return false;
+    }
+    const chart = record(spec.chart);
+    if (!chart ||
+        !keys(chart, ['type', 'x', 'y']) ||
+        typeof chart.type !== 'string' ||
+        !CHARTS.has(chart.type) ||
+        (chart.x !== undefined && (!alias(chart.x) || !dimensions.has(chart.x))) ||
+        (chart.y !== undefined &&
+            (!Array.isArray(chart.y) ||
+                chart.y.length > 6 ||
+                !chart.y.every((name) => alias(name) && measures.has(name)))))
+        return false;
+    return true;
+}
+export function runtimeReportSpecFromWire(value) {
+    let candidate = value;
+    if (typeof value === 'string') {
+        if (value.length > 64 * 1024)
+            return null;
+        try {
+            candidate = JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    return validRuntimeReportSpec(candidate) ? candidate : null;
+}

package/dist/svelte/tool-result.d.ts

@@ -0,0 +1,11 @@
+import type { Component } from 'svelte';
+import type { RuntimeReportProposal } from './types.js';
+export interface ToolResultMessage {
+    toolCallData?: unknown;
+}
+export declare function runtimeReportProposalFromMessage(message: ToolResultMessage): RuntimeReportProposal | null;
+/** Host selector for AssistantDock's generic `toolResultComponent` seam. */
+export declare function runtimeReportToolResultComponent(message: ToolResultMessage): Component<{
+    message: ToolResultMessage;
+}> | undefined;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/svelte/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/svelte/tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iBAAiB,GACzB,qBAAqB,GAAG,IAAI,CAc9B;AAED,4EAA4E;AAC5E,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iBAAiB,GACzB,SAAS,CAAC;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC,GAAG,SAAS,CAIvD"}

package/dist/svelte/tool-result.js

@@ -0,0 +1,19 @@
+import RuntimeReportToolResult from './RuntimeReportToolResult.svelte';
+import { validReportProposal } from './result.js';
+export function runtimeReportProposalFromMessage(message) {
+    const data = message.toolCallData;
+    if (!data || typeof data !== 'object')
+        return null;
+    const value = data;
+    const toolName = value.name ?? value.tool ?? value.toolName;
+    return toolName === 'reports.runtime.define' &&
+        validReportProposal(value.result)
+        ? value.result
+        : null;
+}
+/** Host selector for AssistantDock's generic `toolResultComponent` seam. */
+export function runtimeReportToolResultComponent(message) {
+    return runtimeReportProposalFromMessage(message)
+        ? RuntimeReportToolResult
+        : undefined;
+}

package/dist/svelte/types.d.ts

@@ -0,0 +1,38 @@
+import type { RuntimeReportResult } from '../runtime-compiler.js';
+import type { RuntimeReportSpec } from '../runtime-spec.js';
+/** Browser projection only: never includes persisted result rows. */
+export interface SavedRuntimeReport {
+    id: string;
+    title: string;
+    description?: string;
+    sourceId: string;
+    createdByUserId: string;
+    status: 'active' | 'archived';
+    spec: RuntimeReportSpec;
+    /** Browser-session hint only. Runtime result rows and run history are not persisted. */
+    lastRunAt?: string;
+    /** Host permission hint. The archive endpoint authorizes every mutation again. */
+    canArchive: boolean;
+}
+/** A principal-scoped transport. Replace it when the tenant or viewer changes. */
+export interface RuntimeReportsClient {
+    list(options: {
+        onlyMine: boolean;
+        includeArchived: boolean;
+    }): Promise<SavedRuntimeReport[]>;
+    get(id: string): Promise<SavedRuntimeReport>;
+    run(id: string): Promise<RuntimeReportResult>;
+    archive(id: string, archived: boolean): Promise<void>;
+    confirm(proposal: RuntimeReportProposal): Promise<SavedRuntimeReport>;
+}
+export type { RuntimeReportResult, RuntimeReportSpec };
+/** Server-issued proposal projection; the server retains the canonical pending spec. */
+export interface RuntimeReportProposal {
+    status: 'awaiting_confirmation';
+    specHash: string;
+    spec: RuntimeReportSpec;
+    sourceLabel: string;
+    confirmPath: string;
+    preview: RuntimeReportResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/svelte/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,OAAO,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvE;AAED,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;AAEvD,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}

package/dist/svelte/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-reports",
-  "version": "0.55.24",
+  "version": "0.56.1",
   "description": "Materialized aggregate report models for SMRT",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,22 +40,38 @@
       "import": "./dist/state.js"
     },
     "./manifest": "./dist/manifest.json",
-    "./manifest.json": "./dist/manifest.json"
+    "./manifest.json": "./dist/manifest.json",
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    },
+    "./playground": {
+      "types": "./dist/playground.d.ts",
+      "import": "./dist/playground.js"
+    }
   },
   "dependencies": {
-    "@happyvertical/smrt-core": "0.55.24",
-    "@happyvertical/smrt-jobs": "0.55.24",
-    "@happyvertical/smrt-types": "0.55.24",
-    "@happyvertical/smrt-tenancy": "0.55.24",
-    "@happyvertical/sql": "^0.103.6"
+    "@happyvertical/smrt-core": "0.56.1",
+    "@happyvertical/smrt-jobs": "0.56.1",
+    "@happyvertical/smrt-types": "0.56.1",
+    "@happyvertical/smrt-tenancy": "0.56.1",
+    "@happyvertical/sql": "^0.103.7",
+    "@happyvertical/smrt-config": "0.56.1",
+    "@happyvertical/smrt-ui": "0.56.1"
   },
   "devDependencies": {
-    "@happyvertical/smrt-scanner": "0.55.24",
-    "@happyvertical/smrt-vitest": "0.55.24",
+    "@happyvertical/smrt-scanner": "0.56.1",
+    "@happyvertical/smrt-vitest": "0.56.1",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",
-    "vitest": "4.1.10"
+    "vitest": "4.1.10",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "@testing-library/svelte": "^5.4.2",
+    "svelte-check": "^4.7.6",
+    "svelte": "^5.57.1"
   },
   "keywords": [
     "ai",
@@ -75,8 +91,16 @@
     "url": "https://github.com/happyvertical/smrt.git",
     "directory": "packages/reports"
   },
+  "peerDependencies": {
+    "svelte": "^5.57.0"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "build": "vite build --mode library",
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json && node ../../scripts/prune-svelte-package-artifacts.js dist",
     "build:watch": "vite build --mode library --watch",
     "clean": "rm -rf dist",
     "dev": "vite dev",
@@ -84,7 +108,7 @@
     "test": "vitest run",
     "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run optional.test.ts",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
     "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
   }
 }