@yuihub/server 1.0.0-beta.10

package/dist/engine/lock.js

@@ -0,0 +1,58 @@
+/**
+ * YuiHub V1 Backend - Lock Utilities
+ * ReadWriteLock for LanceDB concurrency control
+ */
+import { RWLock } from 'async-rwlock';
+// ReadWriteLock: Multiple readers OR single writer
+export const rwLock = new RWLock();
+/**
+ * Execute function with write lock (exclusive)
+ * Use for: /save, /checkpoints, indexing
+ */
+export async function withWriteLock(fn) {
+    await rwLock.writeLock();
+    try {
+        return await fn();
+    }
+    finally {
+        rwLock.unlock();
+    }
+}
+/**
+ * Execute function with read lock (shared)
+ * Use for: /search, /export/context
+ */
+export async function withReadLock(fn) {
+    await rwLock.readLock();
+    try {
+        return await fn();
+    }
+    finally {
+        rwLock.unlock();
+    }
+}
+/**
+ * Execute function with exponential backoff retry
+ */
+export async function withRetry(fn, maxRetries = 3, baseDelayMs = 100) {
+    let lastError;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < maxRetries - 1) {
+                const delay = baseDelayMs * Math.pow(2, attempt);
+                console.warn(`[Lock] Retry ${attempt + 1}/${maxRetries} after ${delay}ms: ${lastError.message}`);
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+        }
+    }
+    throw lastError;
+}
+// Legacy export for backward compatibility (deprecated)
+import { Mutex } from 'async-mutex';
+/** @deprecated Use withWriteLock instead */
+export const globalMutex = new Mutex();
+//# sourceMappingURL=lock.js.map

package/dist/engine/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/engine/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,mDAAmD;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,EAAoB;IACzD,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,EAAoB;IACxD,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAU,GAAG,CAAC,EACd,WAAW,GAAG,GAAG;IAEjB,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAC3B,IAAI,OAAO,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,gBAAgB,OAAO,GAAG,CAAC,IAAI,UAAU,UAAU,KAAK,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,wDAAwD;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,KAAK,EAAE,CAAC"}

package/dist/engine/schema.d.ts

@@ -0,0 +1,19 @@
+import { Entry } from '@yuihub/core';
+export interface LanceEntry {
+    id: string;
+    vector: number[];
+    text: string;
+    mode: string;
+    tags: string;
+    session_id: string;
+    source: string;
+    date: string;
+    metadata: string;
+}
+/**
+ * Convert Core Entry to LanceDB Entry (without vector)
+ * Vector must be added separately.
+ * Tags are serialized to JSON string.
+ */
+export declare function toLanceEntryBase(entry: Entry): Omit<LanceEntry, 'vector'>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/engine/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/engine/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAIrC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAWzE"}

package/dist/engine/schema.js

@@ -0,0 +1,18 @@
+/**
+ * Convert Core Entry to LanceDB Entry (without vector)
+ * Vector must be added separately.
+ * Tags are serialized to JSON string.
+ */
+export function toLanceEntryBase(entry) {
+    return {
+        id: entry.id,
+        text: entry.text,
+        mode: entry.mode,
+        tags: JSON.stringify(entry.tags || []), // Serialize to avoid Arrow type inference issues
+        session_id: entry.session_id || '',
+        source: entry.source || '',
+        date: entry.date,
+        metadata: JSON.stringify(entry.metadata || {})
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/engine/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/engine/schema.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,iDAAiD;QACzF,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/engine/vector-store-types.d.ts

@@ -0,0 +1,24 @@
+import { Entry } from '@yuihub/core';
+export interface SearchResult {
+    id: string;
+    text: string;
+    score: number;
+    mode: string;
+    tags: string;
+    session_id: string;
+    source: string;
+    date: string;
+    metadata: string;
+    _source_store?: string;
+}
+export interface IVectorStore {
+    init(): Promise<void>;
+    add(entries: Entry[]): Promise<void>;
+    search(query: string, limit?: number, filter?: {
+        tag?: string;
+        session?: string;
+    }): Promise<SearchResult[]>;
+    isEmpty(): Promise<boolean>;
+    deleteBySource(source: string): Promise<number>;
+}
+//# sourceMappingURL=vector-store-types.d.ts.map

package/dist/engine/vector-store-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-types.d.ts","sourceRoot":"","sources":["../../src/engine/vector-store-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5G,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD"}

package/dist/engine/vector-store-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector-store-types.js.map

package/dist/engine/vector-store-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-types.js","sourceRoot":"","sources":["../../src/engine/vector-store-types.ts"],"names":[],"mappings":""}

package/dist/engine/vector-store.d.ts

@@ -0,0 +1,21 @@
+import { Entry } from '@yuihub/core';
+import { IEmbeddingService } from './embeddings/types.js';
+import { IVectorStore, SearchResult } from './vector-store-types.js';
+export declare class LanceVectorStore implements IVectorStore {
+    private db;
+    private table;
+    private embedder;
+    private dbPath;
+    private tableName;
+    readonly name: string;
+    constructor(basePath: string, embedder: IEmbeddingService, name?: string, tableName?: string);
+    init(): Promise<void>;
+    add(entries: Entry[]): Promise<void>;
+    search(query: string, limit?: number, filter?: {
+        tag?: string;
+        session?: string;
+    }): Promise<SearchResult[]>;
+    isEmpty(): Promise<boolean>;
+    deleteBySource(source: string): Promise<number>;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/engine/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../src/engine/vector-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAErE,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,GAAE,MAAyB,EAAE,SAAS,CAAC,EAAE,MAAM;IAOxG,IAAI;IAcJ,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE;IA0BpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6B/G,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAU3B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAetD"}

package/dist/engine/vector-store.js

@@ -0,0 +1,105 @@
+import * as lancedb from '@lancedb/lancedb';
+import path from 'path';
+import fs from 'fs-extra';
+import { toLanceEntryBase } from './schema.js';
+export class LanceVectorStore {
+    db = null;
+    table = null;
+    embedder;
+    dbPath;
+    tableName;
+    name; // Identifier for RRF (e.g. 'local', 'vertex')
+    constructor(basePath, embedder, name = 'yuihub_entries', tableName) {
+        this.dbPath = path.join(basePath, 'data/lancedb');
+        this.embedder = embedder;
+        this.name = name;
+        this.tableName = tableName || `entries_${name}`; // e.g. entries_local, entries_vertex
+    }
+    async init() {
+        await fs.ensureDir(this.dbPath);
+        this.db = await lancedb.connect(this.dbPath);
+        // Initialize Embedder
+        await this.embedder.init();
+        // Check if table exists
+        const tableNames = await this.db.tableNames();
+        if (tableNames.includes(this.tableName)) {
+            this.table = await this.db.openTable(this.tableName);
+        }
+    }
+    async add(entries) {
+        if (!this.db)
+            throw new Error('VectorStore not initialized');
+        const data = [];
+        for (const entry of entries) {
+            const output = await this.embedder.embed(entry.text);
+            // Serialize tags array to JSON string to avoid Arrow type inference issues
+            const baseEntry = toLanceEntryBase(entry);
+            data.push({
+                ...baseEntry,
+                vector: output.data
+            });
+        }
+        if (data.length === 0)
+            return;
+        if (!this.table) {
+            // @ts-ignore: LanceDB Type mismatch with strict mode
+            this.table = await this.db.createTable(this.tableName, data);
+        }
+        else {
+            // @ts-ignore: LanceDB Type mismatch with strict mode
+            await this.table.add(data);
+        }
+    }
+    async search(query, limit = 10, filter) {
+        if (!this.table)
+            return [];
+        const output = await this.embedder.embed(query);
+        const vector = output.data;
+        let builder = this.table.search(vector).limit(limit);
+        const whereClauses = [];
+        if (filter?.session) {
+            whereClauses.push(`session_id = '${filter.session}'`);
+        }
+        if (whereClauses.length > 0) {
+            builder = builder.where(whereClauses.join(' AND '));
+        }
+        const rows = await builder.toArray();
+        return rows.map((r) => ({
+            ...r,
+            score: r._distance, // LanceDB uses distance (lower is better usually for L2, cosine dist?)
+            // Note: OpenAI/MiniLM usually use Cosine Similarity or Distance. 
+            // LanceDB 'cosine' distance = 1 - similarity. 
+            // RRF needs consistent ranking. Distance is fine for ascending rank.
+            _source_store: this.name
+        }));
+    }
+    async isEmpty() {
+        if (!this.table)
+            return true;
+        try {
+            const count = await this.table.countRows();
+            return count === 0;
+        }
+        catch {
+            return true;
+        }
+    }
+    async deleteBySource(source) {
+        if (!this.table)
+            return 0;
+        try {
+            // LanceDB delete API - returns void, we count before/after
+            const countBefore = await this.table.countRows();
+            // Escape single quotes in source path
+            const escapedSource = source.replace(/'/g, "''");
+            await this.table.delete(`source = '${escapedSource}'`);
+            const countAfter = await this.table.countRows();
+            return countBefore - countAfter;
+        }
+        catch (e) {
+            console.error(`[LanceVectorStore] deleteBySource failed for ${source}:`, e);
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/engine/vector-store.js.map

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

package/dist/engine/watcher.d.ts

@@ -0,0 +1,16 @@
+import { Indexer } from './indexer.js';
+export declare class SafeWatcher {
+    private watcher;
+    private indexer;
+    private debouncedHandlers;
+    constructor(indexer: Indexer);
+    start(paths: string | string[]): void;
+    private callbacks;
+    onActivity(cb: (path: string, type: 'change' | 'add' | 'unlink') => void): void;
+    private handleFileDelete;
+    private handleFileChange;
+    scan(dir: string): Promise<void>;
+    private getFiles;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/engine/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/engine/watcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,iBAAiB,CAA4D;gBAEzE,OAAO,EAAE,OAAO;IAK5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAgB9B,OAAO,CAAC,SAAS,CAAqE;IAEtF,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,KAAK,IAAI;IAIxE,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,gBAAgB;IAqBlB,IAAI,CAAC,GAAG,EAAE,MAAM;YAqBR,QAAQ;IAShB,KAAK;CAKZ"}

package/dist/engine/watcher.js

@@ -0,0 +1,94 @@
+import { watch } from 'chokidar';
+import lodash from 'lodash';
+export class SafeWatcher {
+    watcher = null;
+    indexer;
+    debouncedHandlers;
+    constructor(indexer) {
+        this.indexer = indexer;
+        this.debouncedHandlers = new Map();
+    }
+    start(paths) {
+        this.watcher = watch(paths, {
+            ignored: /(^|[\/\\])\../, // ignore dotfiles
+            persistent: true,
+            ignoreInitial: true // Don't queue initial scan to avoid storm? Or maybe allow it?
+            // For V1, maybe allow initial scan to build index. But let's keep it safe.
+        });
+        this.watcher
+            .on('add', this.handleFileChange.bind(this))
+            .on('change', this.handleFileChange.bind(this))
+            .on('unlink', this.handleFileDelete.bind(this));
+        console.log(`[Watcher] Started watching: ${paths}`);
+    }
+    callbacks = [];
+    onActivity(cb) {
+        this.callbacks.push(cb);
+    }
+    handleFileDelete(filePath) {
+        console.log(`[Watcher] File deleted: ${filePath}`);
+        this.callbacks.forEach(cb => cb(filePath, 'unlink'));
+        // Cancel any pending debounced handler for this file
+        const handler = this.debouncedHandlers.get(filePath);
+        if (handler) {
+            handler.cancel();
+            this.debouncedHandlers.delete(filePath);
+        }
+        // Enqueue delete job
+        this.indexer.enqueueDelete(filePath);
+    }
+    handleFileChange(filePath) {
+        // Notify listeners immediately (or debounced?)
+        // Live Context prefers immediate or distinct? 
+        // Let's use debounced for indexing, but maybe immediate for "activity log"?
+        // The current logic debounces indexing. 
+        // Let's notify listeners here (immediate activity).
+        this.callbacks.forEach(cb => cb(filePath, 'change'));
+        if (!this.debouncedHandlers.has(filePath)) {
+            // Create debounced handler per file
+            const handler = lodash.debounce((path) => {
+                console.log(`[Watcher] Change detected (stable): ${path}`);
+                this.indexer.enqueue(path);
+            }, 2000); // 2000ms debounce
+            this.debouncedHandlers.set(filePath, handler);
+        }
+        const handler = this.debouncedHandlers.get(filePath);
+        if (handler)
+            handler(filePath);
+    }
+    async scan(dir) {
+        console.log(`[Watcher] Scanning directory: ${dir}`);
+        try {
+            // Node 20+ supports recursive readdir. Assume Node 18+ or use manual walk?
+            // Let's use fs-extra readdir or custom walk if needed. 
+            // fs.readdir(dir, { recursive: true }) is Node 20.
+            // Safe fallback: use chokidar instance if ready? No.
+            // Simple recursive walk:
+            const files = await this.getFiles(dir);
+            console.log(`[Watcher] Found ${files.length} files. Enqueuing...`);
+            for (const file of files) {
+                if (file.endsWith('.md')) {
+                    this.indexer.enqueue(file);
+                }
+            }
+        }
+        catch (e) {
+            console.error('[Watcher] Scan failed:', e);
+        }
+    }
+    async getFiles(dir) {
+        const dirents = await import('fs').then(r => r.promises.readdir(dir, { withFileTypes: true }));
+        const files = await Promise.all(dirents.map((dirent) => {
+            const res = import('path').then(p => p.join(dir, dirent.name));
+            return dirent.isDirectory() ? res.then(p => this.getFiles(p)) : res;
+        }));
+        return Array.prototype.concat(...files);
+    }
+    async close() {
+        if (this.watcher)
+            await this.watcher.close();
+        this.debouncedHandlers.forEach(h => h.cancel());
+        this.debouncedHandlers.clear();
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/engine/watcher.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}