@decibelsystems/tools 2.0.0

package/dist/lib/benchmark.js

@@ -0,0 +1,338 @@
+/**
+ * Decibel Benchmark Library
+ *
+ * First-class benchmarking for the decibel toolchain.
+ * Supports micro (ns, pure functions) and integration (ms, I/O) benchmarks.
+ * Includes baseline persistence and regression detection for CI.
+ *
+ * Usage:
+ *   - Direct: runBenchmarkSuite(benchmarks, options)
+ *   - Dojo: dojo_bench tool (discovers from experiments)
+ *   - CLI: decibel bench <suite.json>
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import os from 'os';
+// ============================================================================
+// Kind Defaults
+// ============================================================================
+const KIND_DEFAULTS = {
+    micro: {
+        iterations: 10000,
+        warmup: 1000,
+        threshold_p99_ns: 100_000, // 100μs
+        time_budget_ms: 5000, // 5s max per bench
+        min_iterations: 1000,
+    },
+    integration: {
+        iterations: 100,
+        warmup: 10,
+        threshold_p99_ns: 500_000_000, // 500ms
+        time_budget_ms: 30000, // 30s max per bench
+        min_iterations: 20,
+    },
+};
+// ============================================================================
+// Platform Fingerprint
+// ============================================================================
+export function getPlatformFingerprint() {
+    let gitSha;
+    let gitBranch;
+    try {
+        const { execSync } = require('child_process');
+        gitSha = execSync('git rev-parse HEAD', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        gitBranch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    }
+    catch {
+        // Not in a git repo
+    }
+    const cpus = os.cpus();
+    const cpuModel = cpus.length > 0 ? cpus[0].model : 'unknown';
+    return {
+        git_sha: gitSha,
+        git_branch: gitBranch,
+        node_version: process.version,
+        os_arch: `${os.platform()}-${os.arch()}`,
+        cpu_model: cpuModel,
+        timestamp: new Date().toISOString(),
+    };
+}
+// ============================================================================
+// Statistics
+// ============================================================================
+function calculateStddev(times, mean) {
+    if (times.length < 2)
+        return 0;
+    const squaredDiffs = times.map(t => Math.pow(t - mean, 2));
+    const variance = squaredDiffs.reduce((a, b) => a + b, 0) / (times.length - 1);
+    return Math.sqrt(variance);
+}
+function calculateStability(stddev, mean) {
+    if (mean === 0)
+        return 'high';
+    const cv = stddev / mean; // Coefficient of variation
+    if (cv < 0.1)
+        return 'high';
+    if (cv < 0.3)
+        return 'medium';
+    return 'low';
+}
+// ============================================================================
+// Core Benchmark Runner
+// ============================================================================
+/**
+ * Run a single benchmark
+ */
+export async function runBenchmark(bench, options) {
+    const kind = bench.kind || options.kind;
+    const defaults = KIND_DEFAULTS[kind];
+    const iterations = options.iterations ?? defaults.iterations;
+    const warmup = options.warmup ?? defaults.warmup;
+    const threshold = bench.threshold_p99_ns ?? options.threshold_p99_ns ?? defaults.threshold_p99_ns;
+    // Setup
+    let ctx;
+    if (bench.setup) {
+        ctx = await bench.setup();
+    }
+    try {
+        // Warmup phase
+        for (let i = 0; i < warmup; i++) {
+            const result = bench.run(ctx);
+            if (result instanceof Promise)
+                await result;
+        }
+        // Measurement phase
+        const times = [];
+        for (let i = 0; i < iterations; i++) {
+            const start = process.hrtime.bigint();
+            const result = bench.run(ctx);
+            if (result instanceof Promise)
+                await result;
+            const end = process.hrtime.bigint();
+            times.push(Number(end - start));
+        }
+        // Sort for percentile calculations
+        times.sort((a, b) => a - b);
+        // Calculate statistics
+        const sum = times.reduce((a, b) => a + b, 0);
+        const mean = sum / times.length;
+        const stddev = calculateStddev(times, mean);
+        const stability = calculateStability(stddev, mean);
+        const p99 = times[Math.floor(times.length * 0.99)];
+        return {
+            id: bench.id,
+            kind,
+            p50_ns: times[Math.floor(times.length * 0.50)],
+            p95_ns: times[Math.floor(times.length * 0.95)],
+            p99_ns: p99,
+            max_ns: times[times.length - 1],
+            min_ns: times[0],
+            mean_ns: Math.round(mean),
+            stddev_ns: Math.round(stddev),
+            iterations,
+            stability,
+            threshold_p99_ns: threshold,
+            passed: p99 < threshold,
+        };
+    }
+    finally {
+        // Teardown
+        if (bench.teardown) {
+            await bench.teardown(ctx);
+        }
+    }
+}
+/**
+ * Run a suite of benchmarks
+ */
+export async function runBenchmarkSuite(suiteId, benchmarks, options = {}) {
+    const kind = options.kind || 'micro';
+    const fullOptions = { kind, ...options };
+    const results = [];
+    for (const bench of benchmarks) {
+        const result = await runBenchmark(bench, fullOptions);
+        results.push(result);
+    }
+    // Load baseline for regression detection
+    let baseline = null;
+    let regressions = [];
+    const tolerancePct = options.regression_tolerance ?? 0.10; // 10% default
+    if (options.baseline_path && existsSync(options.baseline_path)) {
+        try {
+            baseline = JSON.parse(readFileSync(options.baseline_path, 'utf-8'));
+        }
+        catch {
+            // Invalid baseline, ignore
+        }
+    }
+    if (baseline) {
+        for (const result of results) {
+            const baselineResult = baseline.results[result.id];
+            if (baselineResult) {
+                const deltaPct = (result.p99_ns - baselineResult.p99_ns) / baselineResult.p99_ns;
+                regressions.push({
+                    id: result.id,
+                    baseline_p99_ns: baselineResult.p99_ns,
+                    current_p99_ns: result.p99_ns,
+                    delta_pct: deltaPct,
+                    regressed: deltaPct > tolerancePct,
+                    tolerance_pct: tolerancePct,
+                });
+            }
+        }
+    }
+    const hasRegressions = regressions.some(r => r.regressed);
+    const allPassed = results.every(r => r.passed);
+    const verdict = getVerdict(results, hasRegressions);
+    const platform = getPlatformFingerprint();
+    const report = {
+        suite_id: suiteId,
+        kind,
+        results,
+        regressions,
+        verdict,
+        platform,
+        baseline_used: baseline ? options.baseline_path : undefined,
+        has_regressions: hasRegressions,
+        timestamp: new Date().toISOString(),
+    };
+    // Save as new baseline if requested
+    if (options.save_baseline && options.baseline_path) {
+        const newBaseline = {
+            suite_id: suiteId,
+            platform,
+            results: Object.fromEntries(results.map(r => [r.id, { p99_ns: r.p99_ns, p95_ns: r.p95_ns, mean_ns: r.mean_ns }])),
+            created_at: new Date().toISOString(),
+        };
+        const dir = dirname(options.baseline_path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(options.baseline_path, JSON.stringify(newBaseline, null, 2));
+    }
+    return report;
+}
+// ============================================================================
+// Verdict Logic
+// ============================================================================
+export function getVerdict(results, hasRegressions) {
+    if (hasRegressions) {
+        return 'SLOW';
+    }
+    const allPassed = results.every(r => r.passed);
+    if (allPassed) {
+        return 'FAST';
+    }
+    // Some passed, some didn't
+    const passRate = results.filter(r => r.passed).length / results.length;
+    if (passRate >= 0.8) {
+        return 'OK';
+    }
+    return 'SLOW';
+}
+// ============================================================================
+// Formatting Functions
+// ============================================================================
+function formatNs(ns, kind) {
+    if (kind === 'integration' || ns >= 1_000_000) {
+        return `${(ns / 1_000_000).toFixed(1)}ms`;
+    }
+    else if (ns >= 1000) {
+        return `${(ns / 1000).toFixed(1)}μs`;
+    }
+    else {
+        return `${ns}ns`;
+    }
+}
+function formatPct(pct) {
+    const sign = pct >= 0 ? '+' : '';
+    return `${sign}${(pct * 100).toFixed(1)}%`;
+}
+export function formatTable(report) {
+    const lines = [];
+    const kind = report.kind;
+    lines.push(`${report.suite_id} Benchmark Results (${kind})`);
+    lines.push('='.repeat(60));
+    lines.push(`Platform: ${report.platform.os_arch} | Node ${report.platform.node_version}`);
+    if (report.platform.git_sha) {
+        lines.push(`Git: ${report.platform.git_branch}@${report.platform.git_sha.slice(0, 7)}`);
+    }
+    lines.push('');
+    const header = 'Benchmark            p50      p95      p99      stab  pass';
+    lines.push(header);
+    lines.push('─'.repeat(header.length));
+    for (const r of report.results) {
+        const name = r.id.padEnd(18).slice(0, 18);
+        const p50 = formatNs(r.p50_ns, kind).padStart(8);
+        const p95 = formatNs(r.p95_ns, kind).padStart(8);
+        const p99 = formatNs(r.p99_ns, kind).padStart(8);
+        const stab = r.stability.padStart(6);
+        const pass = r.passed ? '  ✓' : '  ✗';
+        lines.push(`${name}  ${p50} ${p95} ${p99} ${stab} ${pass}`);
+    }
+    if (report.regressions.length > 0) {
+        lines.push('');
+        lines.push('Regressions:');
+        lines.push('─'.repeat(40));
+        for (const r of report.regressions) {
+            const status = r.regressed ? '✗ REGRESSED' : '✓ OK';
+            lines.push(`  ${r.id}: ${formatPct(r.delta_pct)} (${status})`);
+        }
+    }
+    lines.push('');
+    const verdictSymbol = report.verdict === 'FAST' ? '✓' : report.verdict === 'OK' ? '○' : '✗';
+    lines.push(`${verdictSymbol} Verdict: ${report.verdict}${report.has_regressions ? ' (regressions detected)' : ''}`);
+    return lines.join('\n');
+}
+export function formatMarkdown(report) {
+    const lines = [];
+    const kind = report.kind;
+    lines.push(`# ${report.suite_id} Benchmark Results`);
+    lines.push('');
+    lines.push(`**Kind:** ${kind}`);
+    lines.push(`**Platform:** ${report.platform.os_arch} | Node ${report.platform.node_version}`);
+    if (report.platform.git_sha) {
+        lines.push(`**Git:** ${report.platform.git_branch}@${report.platform.git_sha.slice(0, 7)}`);
+    }
+    lines.push(`**Verdict:** ${report.verdict}`);
+    lines.push('');
+    lines.push('## Results');
+    lines.push('');
+    lines.push('| Benchmark | p50 | p95 | p99 | Stability | Pass |');
+    lines.push('|-----------|-----|-----|-----|-----------|------|');
+    for (const r of report.results) {
+        const pass = r.passed ? '✓' : '✗';
+        lines.push(`| ${r.id} | ${formatNs(r.p50_ns, kind)} | ${formatNs(r.p95_ns, kind)} | ${formatNs(r.p99_ns, kind)} | ${r.stability} | ${pass} |`);
+    }
+    if (report.regressions.length > 0) {
+        lines.push('');
+        lines.push('## Regressions');
+        lines.push('');
+        lines.push('| Benchmark | Baseline | Current | Delta | Status |');
+        lines.push('|-----------|----------|---------|-------|--------|');
+        for (const r of report.regressions) {
+            const status = r.regressed ? '✗ REGRESSED' : '✓ OK';
+            lines.push(`| ${r.id} | ${formatNs(r.baseline_p99_ns, kind)} | ${formatNs(r.current_p99_ns, kind)} | ${formatPct(r.delta_pct)} | ${status} |`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Convert simple operations dict to Bench array
+ */
+export function operationsToBenches(operations, kind = 'micro') {
+    return Object.entries(operations).map(([id, run]) => ({
+        id,
+        kind,
+        run,
+    }));
+}
+/**
+ * Simple runner for operations dict (backwards compatible)
+ */
+export async function runAllBenchmarks(suiteId, operations, options = {}) {
+    const kind = options.kind || 'micro';
+    const benchmarks = operationsToBenches(operations, kind);
+    return runBenchmarkSuite(suiteId, benchmarks, options);
+}
+//# sourceMappingURL=benchmark.js.map

package/dist/lib/benchmark.js.map

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

package/dist/lib/supabase.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Supabase Client
+ *
+ * Connects to senken.pro Supabase for Decibel Studio Cloud Spine.
+ * Uses environment variables for configuration.
+ *
+ * Environment:
+ *   SUPABASE_URL - Supabase project URL
+ *   SUPABASE_ANON_KEY - Supabase anon/public key
+ *   SUPABASE_SERVICE_KEY - Optional service role key for admin operations
+ */
+import { SupabaseClient } from '@supabase/supabase-js';
+export interface Project {
+    id: string;
+    owner_id: string;
+    name: string;
+    description: string | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+}
+export interface Artifact {
+    id: string;
+    project_id: string;
+    schema_version: string;
+    type: 'image' | 'video' | '3d' | 'audio' | 'text';
+    status: 'generating' | 'partial' | 'complete' | 'failed';
+    progress: number | null;
+    platform: 'ios' | 'web' | 'claude-code' | 'macos' | 'android';
+    app_version: string;
+    package_url: string | null;
+    package_sha256: string | null;
+    prompt: string | null;
+    model: string | null;
+    provider: string | null;
+    parent_artifact_id: string | null;
+    workflow_id: string | null;
+    workflow_step_id: string | null;
+    tags: string[];
+    is_pinned: boolean;
+    rating: number | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+}
+export interface ArtifactFile {
+    id: string;
+    artifact_id: string;
+    path: string;
+    role: 'preview' | 'render' | 'variant' | 'thumbnail';
+    mime_type: string;
+    bytes: number;
+    sha256: string;
+    width: number | null;
+    height: number | null;
+    storage_url: string | null;
+    created_at: string;
+}
+export interface Device {
+    id: string;
+    user_id: string;
+    name: string;
+    platform: 'ios' | 'web' | 'claude-code' | 'macos' | 'android';
+    capabilities: Record<string, unknown>;
+    push_token: string | null;
+    last_seen_at: string;
+    created_at: string;
+}
+export interface Event {
+    seq: number;
+    project_id: string;
+    type: string;
+    payload: Record<string, unknown>;
+    device_id: string | null;
+    created_at: string;
+}
+export interface Job {
+    id: string;
+    owner_id: string;
+    target_device_id: string | null;
+    claimed_by_device_id: string | null;
+    workflow_id: string | null;
+    project_id: string | null;
+    inputs: Record<string, unknown>;
+    status: 'pending' | 'claimed' | 'running' | 'complete' | 'failed' | 'cancelled';
+    progress: number | null;
+    error_message: string | null;
+    result_artifact_id: string | null;
+    created_at: string;
+    updated_at: string;
+    claimed_at: string | null;
+    completed_at: string | null;
+    expires_at: string | null;
+}
+/**
+ * Get the Supabase client (anon key - respects RLS)
+ */
+export declare function getSupabaseClient(): SupabaseClient<any>;
+/**
+ * Get the Supabase service client (service role key - bypasses RLS)
+ * Use only for admin operations that require elevated privileges.
+ */
+export declare function getSupabaseServiceClient(): SupabaseClient<any>;
+/**
+ * Check if Supabase is configured (for service-level operations like voice inbox)
+ * Requires URL and SERVICE_KEY for server-side writes
+ */
+export declare function isSupabaseConfigured(): boolean;
+/**
+ * Set access token for user-scoped requests
+ */
+export declare function setAccessToken(token: string): Promise<void>;
+export interface SupabaseError {
+    error: string;
+    code: string;
+    details?: string;
+}
+export declare function isSupabaseError(result: unknown): result is SupabaseError;
+export declare function formatSupabaseError(error: {
+    message: string;
+    code?: string;
+}): SupabaseError;
+//# sourceMappingURL=supabase.d.ts.map

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

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

package/dist/lib/supabase.js

@@ -0,0 +1,91 @@
+/**
+ * Supabase Client
+ *
+ * Connects to senken.pro Supabase for Decibel Studio Cloud Spine.
+ * Uses environment variables for configuration.
+ *
+ * Environment:
+ *   SUPABASE_URL - Supabase project URL
+ *   SUPABASE_ANON_KEY - Supabase anon/public key
+ *   SUPABASE_SERVICE_KEY - Optional service role key for admin operations
+ */
+import { createClient } from '@supabase/supabase-js';
+import { log } from '../config.js';
+// ============================================================================
+// Client Singleton
+// ============================================================================
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _client = null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _serviceClient = null;
+/**
+ * Get the Supabase client (anon key - respects RLS)
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getSupabaseClient() {
+    if (_client)
+        return _client;
+    const url = process.env.SUPABASE_URL;
+    const anonKey = process.env.SUPABASE_ANON_KEY;
+    if (!url || !anonKey) {
+        throw new Error('Supabase not configured. Set SUPABASE_URL and SUPABASE_ANON_KEY environment variables.');
+    }
+    log('[Supabase] Initializing client');
+    _client = createClient(url, anonKey, {
+        auth: {
+            persistSession: false,
+            autoRefreshToken: false,
+        },
+    });
+    return _client;
+}
+/**
+ * Get the Supabase service client (service role key - bypasses RLS)
+ * Use only for admin operations that require elevated privileges.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getSupabaseServiceClient() {
+    if (_serviceClient)
+        return _serviceClient;
+    const url = process.env.SUPABASE_URL;
+    const serviceKey = process.env.SUPABASE_SERVICE_KEY;
+    if (!url || !serviceKey) {
+        throw new Error('Supabase service client not configured. Set SUPABASE_URL and SUPABASE_SERVICE_KEY.');
+    }
+    log('[Supabase] Initializing service client');
+    _serviceClient = createClient(url, serviceKey, {
+        auth: {
+            persistSession: false,
+            autoRefreshToken: false,
+        },
+    });
+    return _serviceClient;
+}
+/**
+ * Check if Supabase is configured (for service-level operations like voice inbox)
+ * Requires URL and SERVICE_KEY for server-side writes
+ */
+export function isSupabaseConfigured() {
+    return !!(process.env.SUPABASE_URL && process.env.SUPABASE_SERVICE_KEY);
+}
+/**
+ * Set access token for user-scoped requests
+ */
+export async function setAccessToken(token) {
+    const client = getSupabaseClient();
+    await client.auth.setSession({
+        access_token: token,
+        refresh_token: '',
+    });
+}
+export function isSupabaseError(result) {
+    return typeof result === 'object' && result !== null && 'error' in result && 'code' in result;
+}
+export function formatSupabaseError(error) {
+    return {
+        error: error.message,
+        code: error.code || 'SUPABASE_ERROR',
+        details: JSON.stringify(error),
+    };
+}
+//# sourceMappingURL=supabase.js.map

package/dist/lib/supabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.js","sourceRoot":"","sources":["../../src/lib/supabase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AA8FnC,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,8DAA8D;AAC9D,IAAI,OAAO,GAA+B,IAAI,CAAC;AAC/C,8DAA8D;AAC9D,IAAI,cAAc,GAA+B,IAAI,CAAC;AAEtD;;GAEG;AACH,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAE9C,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,gCAAgC,CAAC,CAAC;IACtC,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE;QACnC,IAAI,EAAE;YACJ,cAAc,EAAE,KAAK;YACrB,gBAAgB,EAAE,KAAK;SACxB;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,8DAA8D;AAC9D,MAAM,UAAU,wBAAwB;IACtC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAEpD,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAC9C,cAAc,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE;QAC7C,IAAI,EAAE;YACJ,cAAc,EAAE,KAAK;YACrB,gBAAgB,EAAE,KAAK;SACxB;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa;IAChD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;QAC3B,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC;AAYD,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAyC;IAC3E,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,gBAAgB;QACpC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/license.d.ts

@@ -0,0 +1,30 @@
+export interface LicenseResult {
+    valid: boolean;
+    tier: 'core' | 'pro';
+    expires_at?: string;
+    cached?: boolean;
+    offline_grace?: boolean;
+}
+export declare class LicenseValidator {
+    private cache;
+    /**
+     * Validate a license key. Returns tier info.
+     * - Checks format first (fast reject)
+     * - Uses 24h in-memory cache
+     * - Falls back to Supabase REST API
+     * - Offline grace: trusts cache for 72h if Supabase unreachable
+     */
+    validate(key: string): Promise<LicenseResult>;
+    /**
+     * Pre-validate a key on startup (fire and forget).
+     */
+    prevalidate(key: string): Promise<void>;
+    /**
+     * Check if a key is currently valid (from cache only, no network).
+     */
+    getCachedResult(key: string): LicenseResult | null;
+    private hashKey;
+    private remoteValidate;
+}
+export declare function getLicenseValidator(): LicenseValidator;
+//# sourceMappingURL=license.d.ts.map

package/dist/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAWD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiC;IAE9C;;;;;;OAMG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmCnD;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAOlD,OAAO,CAAC,OAAO;YAID,cAAc;CAwC7B;AAKD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}