juxscript 1.1.393 → 1.1.395

package/dist/primitives/tabs.js

@@ -0,0 +1,263 @@
+import generateId from '../utils/idgen.js';
+import { pageState } from '../state/pageState.js';
+class Tabs {
+    constructor(id, options = {}) {
+        this._items = [];
+        this._value = null;
+        this._onChange = null;
+        this.id = id || generateId();
+        this.opts = {
+            tabListClass: 'jux-tabs-list',
+            tabClass: 'jux-tab',
+            tabActiveClass: 'jux-tab--active',
+            panelClass: 'jux-tab-panel',
+            ...options
+        };
+        this._element = document.createElement('div');
+        this._element.id = this.id;
+        this._element.setAttribute('data-jux-tabs', '');
+        if (this.opts.class)
+            this._element.className = this.opts.class;
+        if (this.opts.style)
+            this._element.setAttribute('style', this.opts.style);
+        // Tab list (the clickable triggers)
+        this._tabList = document.createElement('div');
+        this._tabList.className = this.opts.tabListClass;
+        this._tabList.setAttribute('role', 'tablist');
+        this._element.appendChild(this._tabList);
+        // Panel container (the content areas)
+        this._panelContainer = document.createElement('div');
+        this._panelContainer.className = 'jux-tabs-panels';
+        this._element.appendChild(this._panelContainer);
+        const resolvedTarget = this.opts.target;
+        const container = resolvedTarget
+            ? document.getElementById(resolvedTarget) || document.querySelector(resolvedTarget)
+            : document.getElementById('app');
+        container?.appendChild(this._element);
+        if (this.opts.items) {
+            this.addItems(this.opts.items);
+        }
+        if (this.opts.defaultTab) {
+            this.setValue(this.opts.defaultTab);
+        }
+        else if (this._items.length > 0) {
+            this.setValue(this._items[0].id);
+        }
+    }
+    // ═══════════════════════════════════════════════════════════
+    // FLUENT BUILDER API
+    // ═══════════════════════════════════════════════════════════
+    defaultTab(value) {
+        this.opts.defaultTab = value;
+        this.setValue(value);
+        return this;
+    }
+    class(value) {
+        this.opts.class = value;
+        this._element.className = value;
+        return this;
+    }
+    style(value) {
+        this.opts.style = value;
+        this._element.setAttribute('style', value);
+        return this;
+    }
+    tabListClass(value) {
+        this.opts.tabListClass = value;
+        this._tabList.className = value;
+        return this;
+    }
+    tabClass(value) {
+        this.opts.tabClass = value;
+        this._renderAll();
+        return this;
+    }
+    tabActiveClass(value) {
+        this.opts.tabActiveClass = value;
+        this._updateActiveState();
+        return this;
+    }
+    panelClass(value) {
+        this.opts.panelClass = value;
+        this._renderAll();
+        return this;
+    }
+    // ═══════════════════════════════════════════════════════════
+    // STANDARD COLLECTION API
+    // ═══════════════════════════════════════════════════════════
+    addItem(item) {
+        const tabItem = { ...item, id: item.id || `${this.id}-tab-${this._items.length}` };
+        this._items.push(tabItem);
+        this._renderTab(tabItem);
+        this._renderPanel(tabItem);
+        if (this._items.length === 1)
+            this.setValue(tabItem.id);
+        this._dispatchChange();
+        return this;
+    }
+    addItems(items) {
+        for (const item of items) {
+            const tabItem = { ...item, id: item.id || `${this.id}-tab-${this._items.length}` };
+            this._items.push(tabItem);
+            this._renderTab(tabItem);
+            this._renderPanel(tabItem);
+        }
+        if (this._items.length > 0 && !this._value) {
+            this.setValue(this._items[0].id);
+        }
+        this._dispatchChange();
+        return this;
+    }
+    removeItem(key) {
+        const idx = typeof key === 'number' ? key : this._items.findIndex(i => i.id === key);
+        if (idx > -1) {
+            const removed = this._items.splice(idx, 1)[0];
+            this._renderAll();
+            if (this._value === removed.id && this._items.length > 0) {
+                this.setValue(this._items[0].id);
+            }
+            else if (this._items.length === 0) {
+                this._value = null;
+            }
+            this._dispatchChange();
+        }
+        return this;
+    }
+    updateItem(key, updates) {
+        const idx = typeof key === 'number' ? key : this._items.findIndex(i => i.id === key);
+        if (idx > -1) {
+            this._items[idx] = { ...this._items[idx], ...updates };
+            this._renderAll();
+            this._updateActiveState();
+            this._dispatchChange();
+        }
+        return this;
+    }
+    clearItems() {
+        this._items = [];
+        this._value = null;
+        this._tabList.innerHTML = '';
+        this._panelContainer.innerHTML = '';
+        this._dispatchChange();
+        return this;
+    }
+    getItems() { return [...this._items]; }
+    getCount() { return this._items.length; }
+    // ═══════════════════════════════════════════════════════════
+    // PANEL ACCESS (for rendering content into tab panels)
+    // ═══════════════════════════════════════════════════════════
+    /** Get the panel element for a tab so you can render jux components into it */
+    getPanel(tabId) {
+        return this._panelContainer.querySelector(`[data-tab-panel="${tabId}"]`);
+    }
+    // ═══════════════════════════════════════════════════════════
+    // PAGESTATE INTEGRATION (delegates to fluent API)
+    // ═══════════════════════════════════════════════════════════
+    getValue() { return this._value; }
+    setValue(val) {
+        this._value = val;
+        this._updateActiveState();
+        return this;
+    }
+    getDefaultTab() { return this.opts.defaultTab ?? ''; }
+    getClass() { return this.opts.class ?? ''; }
+    getStyle() { return this.opts.style ?? ''; }
+    getTabListClass() { return this.opts.tabListClass ?? ''; }
+    getTabClass() { return this.opts.tabClass ?? ''; }
+    getTabActiveClass() { return this.opts.tabActiveClass ?? ''; }
+    getPanelClass() { return this.opts.panelClass ?? ''; }
+    setDefaultTab(val) { return this.defaultTab(val); }
+    setClass(val) { return this.class(val); }
+    setStyle(val) { return this.style(val); }
+    setTabListClass(val) { return this.tabListClass(val); }
+    setTabClass(val) { return this.tabClass(val); }
+    setTabActiveClass(val) { return this.tabActiveClass(val); }
+    setPanelClass(val) { return this.panelClass(val); }
+    getElement() { return this._element; }
+    onChange(fn) {
+        this._onChange = fn;
+        return this;
+    }
+    /** Returns the reactive pageState proxy for this component */
+    get state() {
+        return pageState[this.id];
+    }
+    // ═══════════════════════════════════════════════════════════
+    // INTERNAL
+    // ═══════════════════════════════════════════════════════════
+    _renderTab(item) {
+        const btn = document.createElement('button');
+        btn.id = `${item.id}-trigger`;
+        btn.className = this.opts.tabClass;
+        btn.setAttribute('role', 'tab');
+        btn.setAttribute('data-tab-id', item.id);
+        btn.textContent = item.label;
+        if (item.disabled) {
+            btn.disabled = true;
+            btn.setAttribute('data-disabled', 'true');
+        }
+        btn.addEventListener('click', () => {
+            if (item.disabled)
+                return;
+            this._value = item.id;
+            this._updateActiveState();
+            if (this._onChange)
+                this._onChange(this._value);
+            this._element.dispatchEvent(new Event('change', { bubbles: false }));
+        });
+        this._tabList.appendChild(btn);
+    }
+    _renderPanel(item) {
+        const panel = document.createElement('div');
+        panel.id = `${item.id}-panel`;
+        panel.className = this.opts.panelClass;
+        panel.setAttribute('role', 'tabpanel');
+        panel.setAttribute('data-tab-panel', item.id);
+        if (item.content)
+            panel.innerHTML = item.content;
+        panel.style.display = 'none';
+        this._panelContainer.appendChild(panel);
+    }
+    _renderAll() {
+        this._tabList.innerHTML = '';
+        this._panelContainer.innerHTML = '';
+        for (const item of this._items) {
+            this._renderTab(item);
+            this._renderPanel(item);
+        }
+        this._updateActiveState();
+    }
+    _updateActiveState() {
+        // Tabs
+        const tabs = this._tabList.querySelectorAll('[role="tab"]');
+        tabs.forEach(tab => {
+            const tabId = tab.getAttribute('data-tab-id');
+            if (tabId === this._value) {
+                tab.classList.add(this.opts.tabActiveClass);
+                tab.setAttribute('aria-selected', 'true');
+            }
+            else {
+                tab.classList.remove(this.opts.tabActiveClass);
+                tab.setAttribute('aria-selected', 'false');
+            }
+        });
+        // Panels
+        const panels = this._panelContainer.querySelectorAll('[role="tabpanel"]');
+        panels.forEach(panel => {
+            const panelId = panel.getAttribute('data-tab-panel');
+            panel.style.display = panelId === this._value ? '' : 'none';
+        });
+    }
+    _dispatchChange() {
+        this._element.setAttribute('data-count', String(this._items.length));
+        this._element.dispatchEvent(new Event('change', { bubbles: false }));
+    }
+}
+export function tabs(id, options = {}) {
+    const t = new Tabs(id, options);
+    pageState.__register(t);
+    return t;
+}
+export { Tabs };
+export default tabs;
+//# sourceMappingURL=tabs.js.map

package/dist/primitives/tabs.js.map

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

package/dist/primitives/tag.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Options for creating a Tag element.
+ * @property content - Text content of the element
+ * @property class - CSS class name(s) to apply
+ * @property style - Inline CSS style string
+ * @property target - ID of parent element to append into (enables nesting). Defaults to `#app`.
+ * @property onClick - Click event handler
+ */
+interface TagOptions {
+    content?: string;
+    class?: string;
+    style?: string;
+    target?: string;
+    onClick?: (event: MouseEvent) => void;
+    [key: string]: any;
+}
+declare class Tag {
+    /** Unique element ID */
+    id: string;
+    /** HTML tag name (div, span, etc.) */
+    tagName: string;
+    /** Creation options */
+    opts: TagOptions;
+    private _element;
+    private _onClick;
+    constructor(id: string, tagName: string, options?: TagOptions);
+    /** Set text content. Returns `this` for chaining. */
+    content(value: string): this;
+    /** Set CSS class(es). Returns `this` for chaining. */
+    class(value: string): this;
+    /** Set inline style string. Returns `this` for chaining. */
+    style(value: string): this;
+    getValue(): string;
+    getContent(): string;
+    getClass(): string;
+    getStyle(): string;
+    setValue(val: string): this;
+    setContent(val: string): this;
+    setClass(val: string): this;
+    setStyle(val: string): this;
+    setInnerHTML(val: string): this;
+    getElement(): HTMLElement | null;
+    onClick(fn: (event: MouseEvent) => void): this;
+    /** Returns the reactive pageState proxy for this component */
+    get state(): any;
+    /**
+     * Render the element into the DOM.
+     * @param target - Optional parent element or ID. Falls back to `opts.target`, then `#app`.
+     */
+    render(target?: string | HTMLElement): this;
+}
+/**
+ * Create and render a generic HTML element.
+ * @param id - Unique element ID
+ * @param tagName - HTML tag name
+ * @param options - Tag options including style, content, target for nesting
+ */
+export declare function tag(id: string, tagName: string, options?: TagOptions): Tag;
+/**
+ * Create and render a `<div>` element.
+ * @param id - Unique element ID
+ * @param options - Tag options. Use `{ target: parentId }` to nest inside another element.
+ * @example
+ * ```js
+ * jux.div('card').style('padding: 20px;');
+ * jux.div('child', { target: 'card' }).content('I am nested!');
+ * ```
+ */
+export declare function div(id: string, options?: TagOptions): Tag;
+/**
+ * Create and render a `<span>` element.
+ * @param id - Unique element ID
+ * @param options - Tag options. Use `{ target: parentId }` to nest inside another element.
+ */
+export declare function span(id: string, options?: TagOptions): Tag;
+/**
+ * Create and render a `<p>` element.
+ * @param id - Unique element ID
+ * @param options - Tag options. Use `{ target: parentId }` to nest inside another element.
+ */
+export declare function p(id: string, options?: TagOptions): Tag;
+export declare function code(id: string, options?: TagOptions): Tag;
+export declare function pre(id: string, options?: TagOptions): Tag;
+export declare function h1(id: string, options?: TagOptions): Tag;
+export declare function h2(id: string, options?: TagOptions): Tag;
+export declare function h3(id: string, options?: TagOptions): Tag;
+export declare function h4(id: string, options?: TagOptions): Tag;
+export declare function h5(id: string, options?: TagOptions): Tag;
+export declare function h6(id: string, options?: TagOptions): Tag;
+export { Tag, TagOptions };
+export default tag;
+//# sourceMappingURL=tag.d.ts.map

package/dist/primitives/tag.d.ts.map

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

package/dist/primitives/tag.js

@@ -0,0 +1,151 @@
+import generateId from '../utils/idgen.js';
+import { pageState } from '../state/pageState.js';
+import codeparser from '../utils/codeparser.js';
+class Tag {
+    constructor(id, tagName, options = {}) {
+        this._element = null;
+        this._onClick = null;
+        this.id = id || generateId();
+        this.tagName = tagName;
+        this.opts = options;
+    }
+    // Fluent API
+    /** Set text content. Returns `this` for chaining. */
+    content(value) { this.opts.content = value; if (this._element)
+        this._element.textContent = value; return this; }
+    /** Set CSS class(es). Returns `this` for chaining. */
+    class(value) { this.opts.class = value; if (this._element)
+        this._element.className = value; return this; }
+    /** Set inline style string. Returns `this` for chaining. */
+    style(value) { this.opts.style = value; if (this._element)
+        this._element.setAttribute('style', value); return this; }
+    // Getters/Setters for pageState integration (delegates to fluent API)
+    getValue() { return this._element?.textContent ?? this.opts.content ?? ''; }
+    getContent() { return this._element?.textContent ?? this.opts.content ?? ''; }
+    getClass() { return this.opts.class ?? ''; }
+    getStyle() { return this.opts.style ?? ''; }
+    setValue(val) { return this.content(val); }
+    setContent(val) { return this.content(val); }
+    setClass(val) { return this.class(val); }
+    setStyle(val) { return this.style(val); }
+    setInnerHTML(val) { if (this._element)
+        this._element.innerHTML = val; return this; }
+    getElement() { return this._element; }
+    onClick(fn) {
+        this._onClick = fn;
+        this._element?.addEventListener('click', fn);
+        return this;
+    }
+    /** Returns the reactive pageState proxy for this component */
+    get state() {
+        return pageState[this.id];
+    }
+    /**
+     * Render the element into the DOM.
+     * @param target - Optional parent element or ID. Falls back to `opts.target`, then `#app`.
+     */
+    render(target) {
+        const el = document.createElement(this.tagName);
+        el.id = this.id;
+        if (this.opts.content)
+            el.textContent = this.opts.content;
+        if (this.opts.class)
+            el.className = this.opts.class;
+        if (this.opts.style)
+            el.setAttribute('style', this.opts.style);
+        for (const [key, value] of Object.entries(this.opts)) {
+            if (['content', 'class', 'style', 'target', 'onClick'].includes(key))
+                continue;
+            el.setAttribute(key, String(value));
+        }
+        this._element = el;
+        // Wire up option-based click handler
+        if (this.opts.onClick) {
+            this._onClick = this.opts.onClick;
+            el.addEventListener('click', this.opts.onClick);
+        }
+        // Resolve target: param > opts.target > #app
+        const resolvedTarget = target || this.opts.target;
+        const container = resolvedTarget
+            ? (typeof resolvedTarget === 'string' ? document.getElementById(resolvedTarget) || document.querySelector(resolvedTarget) : resolvedTarget)
+            : document.getElementById('app');
+        container?.appendChild(el);
+        return this;
+    }
+}
+/**
+ * Create and render a generic HTML element.
+ * @param id - Unique element ID
+ * @param tagName - HTML tag name
+ * @param options - Tag options including style, content, target for nesting
+ */
+export function tag(id, tagName, options = {}) {
+    const t = new Tag(id, tagName, options);
+    t.render();
+    pageState.__register(t);
+    return t;
+}
+/**
+ * Create and render a `<div>` element.
+ * @param id - Unique element ID
+ * @param options - Tag options. Use `{ target: parentId }` to nest inside another element.
+ * @example
+ * ```js
+ * jux.div('card').style('padding: 20px;');
+ * jux.div('child', { target: 'card' }).content('I am nested!');
+ * ```
+ */
+export function div(id, options = {}) { return tag(id, 'div', options); }
+/**
+ * Create and render a `<span>` element.
+ * @param id - Unique element ID
+ * @param options - Tag options. Use `{ target: parentId }` to nest inside another element.
+ */
+export function span(id, options = {}) { return tag(id, 'span', options); }
+/**
+ * Create and render a `<p>` element.
+ * @param id - Unique element ID
+ * @param options - Tag options. Use `{ target: parentId }` to nest inside another element.
+ */
+export function p(id, options = {}) { return tag(id, 'p', options); }
+export function code(id, options = {}) {
+    // Inject highlight styles once
+    if (!document.getElementById('__jux-hl-styles')) {
+        const style = document.createElement('style');
+        style.id = '__jux-hl-styles';
+        style.textContent = codeparser.getCSS();
+        document.head.appendChild(style);
+    }
+    // Parse and highlight content
+    const raw = options.content || '';
+    const trimmed = raw.replace(/^\n+/, '').replace(/\n+$/, '');
+    const parsed = codeparser.parse(trimmed);
+    // Build line-by-line HTML
+    const linesHtml = parsed.map(line => `<div class="jux-code-line"><span class="jux-code-line-number">${line.lineNumber}</span><span class="jux-code-line-content">${line.html}</span></div>`).join('');
+    // Create as <pre> with inner code structure
+    const t = new Tag(id, 'pre', {
+        ...options,
+        content: undefined,
+        class: `jux-code${options.class ? ' ' + options.class : ''}`
+    });
+    t.render();
+    const el = t.getElement();
+    if (el) {
+        const codeEl = document.createElement('code');
+        codeEl.className = 'jux-code-lines';
+        codeEl.innerHTML = linesHtml;
+        el.appendChild(codeEl);
+    }
+    pageState.__register(t);
+    return t;
+}
+export function pre(id, options = {}) { return tag(id, 'pre', options); }
+export function h1(id, options = {}) { return tag(id, 'h1', options); }
+export function h2(id, options = {}) { return tag(id, 'h2', options); }
+export function h3(id, options = {}) { return tag(id, 'h3', options); }
+export function h4(id, options = {}) { return tag(id, 'h4', options); }
+export function h5(id, options = {}) { return tag(id, 'h5', options); }
+export function h6(id, options = {}) { return tag(id, 'h6', options); }
+export { Tag };
+export default tag;
+//# sourceMappingURL=tag.js.map

package/dist/primitives/tag.js.map

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

package/dist/services/db.d.ts

@@ -0,0 +1,44 @@
+/**
+ * db.ts — Jux database service client
+ *
+ * JuxDb establishes connectivity to the `db` downstream service via the
+ * ApiGateway backend. It provides a domain-specific API for database
+ * operations; every method ultimately delegates to `this.call(path, options)`,
+ * which routes through the Jux Gateway transport layer.
+ *
+ * Usage in a .jux file:
+ *   const api = await jux.gateway(username, password);
+ *   const db  = api.connect('db');
+ *
+ *   // Check connectivity
+ *   const ping = await db.health();
+ *
+ *   // Query rows
+ *   const result = await db.query('SELECT * FROM users WHERE active = ?', [1]);
+ *   if (result.ok) { console.log(result.data); }
+ *
+ *   // Execute a write statement
+ *   await db.execute('INSERT INTO logs (msg) VALUES (?)', ['hello']);
+ */
+import { ApiGateway, JuxService, ApiResult, ApiCallOptions } from '../components/gateway.js';
+export declare class JuxDb extends JuxService {
+    constructor(gateway: ApiGateway);
+    /** Verify connectivity to the db downstream service. */
+    health(): Promise<ApiResult>;
+    /**
+     * Execute a read query and return result rows.
+     *
+     * @param sql    SQL statement to run (SELECT …)
+     * @param params Optional positional parameters
+     */
+    query(sql: string, params?: any[]): Promise<ApiResult>;
+    /**
+     * Execute a write statement (INSERT / UPDATE / DELETE).
+     *
+     * @param sql    SQL statement to run
+     * @param params Optional positional parameters
+     */
+    execute(sql: string, params?: any[]): Promise<ApiResult>;
+}
+export { ApiCallOptions, ApiResult };
+//# sourceMappingURL=db.d.ts.map

package/dist/services/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../lib/services/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAA2B,MAAM,0BAA0B,CAAC;AAEtH,qBAAa,KAAM,SAAQ,UAAU;gBACrB,OAAO,EAAE,UAAU;IAI/B,wDAAwD;IAClD,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAIlC;;;;;OAKG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAO5D;;;;;OAKG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;CAMjE;AAKD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/db.js

@@ -0,0 +1,59 @@
+/**
+ * db.ts — Jux database service client
+ *
+ * JuxDb establishes connectivity to the `db` downstream service via the
+ * ApiGateway backend. It provides a domain-specific API for database
+ * operations; every method ultimately delegates to `this.call(path, options)`,
+ * which routes through the Jux Gateway transport layer.
+ *
+ * Usage in a .jux file:
+ *   const api = await jux.gateway(username, password);
+ *   const db  = api.connect('db');
+ *
+ *   // Check connectivity
+ *   const ping = await db.health();
+ *
+ *   // Query rows
+ *   const result = await db.query('SELECT * FROM users WHERE active = ?', [1]);
+ *   if (result.ok) { console.log(result.data); }
+ *
+ *   // Execute a write statement
+ *   await db.execute('INSERT INTO logs (msg) VALUES (?)', ['hello']);
+ */
+import { JuxService, _registerServiceFactory } from '../components/gateway.js';
+export class JuxDb extends JuxService {
+    constructor(gateway) {
+        super(gateway, 'db');
+    }
+    /** Verify connectivity to the db downstream service. */
+    async health() {
+        return this.call('health');
+    }
+    /**
+     * Execute a read query and return result rows.
+     *
+     * @param sql    SQL statement to run (SELECT …)
+     * @param params Optional positional parameters
+     */
+    async query(sql, params) {
+        return this.call('query', {
+            method: 'POST',
+            body: { sql, params },
+        });
+    }
+    /**
+     * Execute a write statement (INSERT / UPDATE / DELETE).
+     *
+     * @param sql    SQL statement to run
+     * @param params Optional positional parameters
+     */
+    async execute(sql, params) {
+        return this.call('execute', {
+            method: 'POST',
+            body: { sql, params },
+        });
+    }
+}
+// Register this service so ApiGateway.connect('db') returns a JuxDb instance.
+_registerServiceFactory('db', (gw) => new JuxDb(gw));
+//# sourceMappingURL=db.js.map

package/dist/services/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../lib/services/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAc,UAAU,EAA6B,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEtH,MAAM,OAAO,KAAM,SAAQ,UAAU;IACjC,YAAY,OAAmB;QAC3B,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,MAAc;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACtB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAc;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACxB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;SACxB,CAAC,CAAC;IACP,CAAC;CACJ;AAED,8EAA8E;AAC9E,uBAAuB,CAAC,IAAI,EAAE,CAAC,EAAc,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC"}