@beeable/sdk 0.6.0 → 0.7.1

package/dist/app-runtime/data.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Beeable SDK — app-runtime data layer.
+ *
+ * Unified `collection<T>()` API with two backends, chosen automatically
+ * by the environment the app is running in:
+ *
+ *   • In production (inside the Beeable app-runtime container):
+ *     `FetchCollection<T>` hits a private REST surface on the runtime
+ *     at `/_internal/collection/:name/*`. The runtime validates every
+ *     POST/PATCH against the app's declared manifest schema (Ajv), and
+ *     the routes are **not** emitted into the app's openapi.json —
+ *     which means the orchestrator's tool catalog and other apps'
+ *     generated clients can't see them. This is the private surface
+ *     for the app's own frontend.
+ *
+ *   • In Lovable's preview (or any browser context with no Beeable
+ *     server reachable): `IndexedDBCollection<T>` stores the same
+ *     shape in browser-local IndexedDB. This lets Lovable build and
+ *     iterate on a real, working app without needing a backend.
+ *
+ * Both backends satisfy the same `Collection<T>` interface, so the
+ * rest of your app code is backend-agnostic.
+ *
+ *   import { collection } from '@beeable/sdk/app-runtime/data';
+ *
+ *   interface Note extends Record<string, unknown> {
+ *     title: string;
+ *     body: string;
+ *   }
+ *
+ *   const notes = collection<Note>('notes', {
+ *     version: 1,
+ *     normalize: (doc) => doc as Note,
+ *   });
+ *
+ *   await notes.insert({ title: 'hi', body: 'there' });
+ *   await notes.find({ title: 'hi' });
+ *
+ * Design rationale
+ * ----------------
+ *
+ * The pattern evolved from an earlier unified auto-CRUD setup that
+ * exposed collection routes as part of the app's public HTTP surface.
+ * That turned into a footgun — the LLM saw POST tools with
+ * `additionalProperties: true` and produced ghost records with no
+ * required fields. We fixed it by making apps own their entire
+ * public HTTP surface (every public operation declared with an
+ * `@openapi` JSDoc block) and keeping auto-CRUD for the app's own
+ * frontend only, on a path the tool catalog never sees.
+ */
+/**
+ * Stored document shape — `id`, `created_at`, `updated_at` are set by
+ * the runtime / IndexedDB store; callers provide the rest.
+ */
+export type CollectionDocument<T> = T & {
+    id: string;
+    created_at: string;
+    updated_at: string;
+};
+export interface CollectionOptions<T> {
+    /**
+     * Increment when the document shape changes. The `normalize`
+     * function is expected to handle migrations from older versions.
+     */
+    version: number;
+    /**
+     * Called on every read before the doc is returned to the caller.
+     * Use it to upgrade old rows to the current shape.
+     */
+    normalize: (doc: Record<string, unknown>) => T;
+}
+export interface Collection<T> {
+    find(filter?: Partial<T>): Promise<CollectionDocument<T>[]>;
+    findOne(id: string): Promise<CollectionDocument<T> | null>;
+    insert(doc: T): Promise<CollectionDocument<T>>;
+    update(id: string, changes: Partial<T>): Promise<CollectionDocument<T> | null>;
+    remove(id: string): Promise<boolean>;
+    count(filter?: Partial<T>): Promise<number>;
+}
+declare class FetchCollection<T> implements Collection<T> {
+    private readonly base;
+    constructor(name: string);
+    private request;
+    find(filter?: Partial<T>): Promise<CollectionDocument<T>[]>;
+    findOne(id: string): Promise<CollectionDocument<T> | null>;
+    insert(doc: T): Promise<CollectionDocument<T>>;
+    update(id: string, changes: Partial<T>): Promise<CollectionDocument<T> | null>;
+    remove(id: string): Promise<boolean>;
+    count(filter?: Partial<T>): Promise<number>;
+}
+declare class IndexedDBCollection<T> implements Collection<T> {
+    private readonly name;
+    private readonly options;
+    constructor(name: string, options: CollectionOptions<T>);
+    private store;
+    private toDocument;
+    private matchesFilter;
+    find(filter?: Partial<T>): Promise<CollectionDocument<T>[]>;
+    findOne(id: string): Promise<CollectionDocument<T> | null>;
+    insert(doc: T): Promise<CollectionDocument<T>>;
+    update(id: string, changes: Partial<T>): Promise<CollectionDocument<T> | null>;
+    remove(id: string): Promise<boolean>;
+    count(filter?: Partial<T>): Promise<number>;
+}
+/**
+ * Open a typed collection. Returns a backend that matches the current
+ * environment — no server means IndexedDB, server present means
+ * FetchCollection routed through the private `/_internal/collection/*`
+ * surface.
+ *
+ * For the production path to work, the app's `manifest.json` must
+ * declare the collection under `collections` with a JSON Schema so
+ * the runtime can validate writes:
+ *
+ *   {
+ *     "collections": {
+ *       "notes": {
+ *         "version": 1,
+ *         "schema": {
+ *           "type": "object",
+ *           "required": ["title"],
+ *           "properties": {
+ *             "title": { "type": "string" },
+ *             "body":  { "type": "string" }
+ *           },
+ *           "additionalProperties": false
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * Writes that fail schema validation are rejected with HTTP 400 — so
+ * even on the private surface, callers can't produce ghost records.
+ */
+export declare function collection<T>(name: string, options: CollectionOptions<T>): Collection<T>;
+export { FetchCollection, IndexedDBCollection };
+//# sourceMappingURL=data.d.ts.map

package/dist/app-runtime/data.d.ts.map

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

package/dist/app-runtime/data.js

@@ -0,0 +1,360 @@
+/**
+ * Beeable SDK — app-runtime data layer.
+ *
+ * Unified `collection<T>()` API with two backends, chosen automatically
+ * by the environment the app is running in:
+ *
+ *   • In production (inside the Beeable app-runtime container):
+ *     `FetchCollection<T>` hits a private REST surface on the runtime
+ *     at `/_internal/collection/:name/*`. The runtime validates every
+ *     POST/PATCH against the app's declared manifest schema (Ajv), and
+ *     the routes are **not** emitted into the app's openapi.json —
+ *     which means the orchestrator's tool catalog and other apps'
+ *     generated clients can't see them. This is the private surface
+ *     for the app's own frontend.
+ *
+ *   • In Lovable's preview (or any browser context with no Beeable
+ *     server reachable): `IndexedDBCollection<T>` stores the same
+ *     shape in browser-local IndexedDB. This lets Lovable build and
+ *     iterate on a real, working app without needing a backend.
+ *
+ * Both backends satisfy the same `Collection<T>` interface, so the
+ * rest of your app code is backend-agnostic.
+ *
+ *   import { collection } from '@beeable/sdk/app-runtime/data';
+ *
+ *   interface Note extends Record<string, unknown> {
+ *     title: string;
+ *     body: string;
+ *   }
+ *
+ *   const notes = collection<Note>('notes', {
+ *     version: 1,
+ *     normalize: (doc) => doc as Note,
+ *   });
+ *
+ *   await notes.insert({ title: 'hi', body: 'there' });
+ *   await notes.find({ title: 'hi' });
+ *
+ * Design rationale
+ * ----------------
+ *
+ * The pattern evolved from an earlier unified auto-CRUD setup that
+ * exposed collection routes as part of the app's public HTTP surface.
+ * That turned into a footgun — the LLM saw POST tools with
+ * `additionalProperties: true` and produced ghost records with no
+ * required fields. We fixed it by making apps own their entire
+ * public HTTP surface (every public operation declared with an
+ * `@openapi` JSDoc block) and keeping auto-CRUD for the app's own
+ * frontend only, on a path the tool catalog never sees.
+ */
+// ── Environment detection ──────────────────────────────────────────
+// Same logic as in ./index.ts — duplicated here so this module is
+// self-contained (bundled via esbuild into app-runtime/src/public/
+// beeable-sdk.js the same way).
+function detectHasServer() {
+    if (typeof window === 'undefined')
+        return false;
+    if (window.__BEEABLE_APP_ID__)
+        return true;
+    const proxyMatch = window.location.pathname.match(/^\/api\/apps\/[^/]+\/proxy\b/);
+    if (proxyMatch)
+        return true;
+    const directMatch = window.location.pathname.match(/\/apps\/([^/]+)/);
+    return !!directMatch;
+}
+function currentAppId() {
+    if (typeof window === 'undefined')
+        return 'lovable-dev';
+    if (window.__BEEABLE_APP_ID__)
+        return window.__BEEABLE_APP_ID__;
+    const direct = window.location.pathname.match(/\/apps\/([^/]+)/);
+    if (direct)
+        return direct[1];
+    return 'lovable-dev';
+}
+// ── Shared helpers ─────────────────────────────────────────────────
+function nowIso() {
+    return new Date().toISOString();
+}
+function newId() {
+    // 16 bytes of hex, matches the server-side SQLiteCollection id format.
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    let hex = '';
+    for (const b of bytes)
+        hex += b.toString(16).padStart(2, '0');
+    return hex;
+}
+// ── FetchCollection — production (talks to the runtime) ────────────
+class FetchCollection {
+    base;
+    constructor(name) {
+        // The proxy path-transparently forwards /api/apps/:id/proxy/… to
+        // the runtime's /apps/:id/api/…, and the iframe loads under that
+        // proxy prefix, so relative URLs Just Work. `_internal/collection`
+        // is a private path — never declared in openapi.json.
+        this.base = `/api/apps/${encodeURIComponent(currentAppId())}/proxy/_internal/collection/${encodeURIComponent(name)}`;
+    }
+    async request(path, init) {
+        const res = await fetch(`${this.base}${path}`, {
+            ...init,
+            headers: {
+                'Content-Type': 'application/json',
+                ...(init?.headers ?? {}),
+            },
+            credentials: 'include',
+        });
+        if (!res.ok) {
+            let detail = '';
+            try {
+                const body = (await res.json());
+                detail = body.error ?? '';
+            }
+            catch {
+                /* not JSON */
+            }
+            throw new Error(`${init?.method ?? 'GET'} ${this.base}${path}: ${res.status}${detail ? ` ${detail}` : ''}`);
+        }
+        if (res.status === 204)
+            return undefined;
+        return (await res.json());
+    }
+    async find(filter) {
+        const params = filter
+            ? '?' +
+                new URLSearchParams(Object.entries(filter).map(([k, v]) => [
+                    `filter.${k}`,
+                    String(v),
+                ])).toString()
+            : '';
+        return this.request(`${params}`);
+    }
+    async findOne(id) {
+        try {
+            return await this.request(`/${encodeURIComponent(id)}`);
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes(' 404'))
+                return null;
+            throw err;
+        }
+    }
+    async insert(doc) {
+        return this.request(``, {
+            method: 'POST',
+            body: JSON.stringify(doc),
+        });
+    }
+    async update(id, changes) {
+        try {
+            return await this.request(`/${encodeURIComponent(id)}`, {
+                method: 'PATCH',
+                body: JSON.stringify(changes),
+            });
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes(' 404'))
+                return null;
+            throw err;
+        }
+    }
+    async remove(id) {
+        try {
+            await this.request(`/${encodeURIComponent(id)}`, { method: 'DELETE' });
+            return true;
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes(' 404'))
+                return false;
+            throw err;
+        }
+    }
+    async count(filter) {
+        const params = filter
+            ? '?' +
+                new URLSearchParams(Object.entries(filter).map(([k, v]) => [
+                    `filter.${k}`,
+                    String(v),
+                ])).toString()
+            : '';
+        const res = await this.request(`/_count${params}`);
+        return res.count;
+    }
+}
+const DB_NAME = 'beeable-collections';
+const DB_VERSION = 1;
+// Open once per session; lazily create the object store for the
+// collection on the first read/write that touches it.
+let _dbPromise = null;
+async function openDb(storeName) {
+    const existing = await existingDb();
+    if (existing.objectStoreNames.contains(storeName))
+        return existing;
+    // Need to upgrade to add the object store for this collection.
+    existing.close();
+    _dbPromise = null;
+    const currentVersion = existing.version;
+    return new Promise((resolve, reject) => {
+        const req = indexedDB.open(DB_NAME, currentVersion + 1);
+        req.onupgradeneeded = () => {
+            const db = req.result;
+            if (!db.objectStoreNames.contains(storeName)) {
+                db.createObjectStore(storeName, { keyPath: 'id' });
+            }
+        };
+        req.onsuccess = () => {
+            _dbPromise = Promise.resolve(req.result);
+            resolve(req.result);
+        };
+        req.onerror = () => reject(req.error);
+    });
+}
+async function existingDb() {
+    if (_dbPromise)
+        return _dbPromise;
+    _dbPromise = new Promise((resolve, reject) => {
+        const req = indexedDB.open(DB_NAME, DB_VERSION);
+        req.onupgradeneeded = () => {
+            // First open — no stores yet; they're created on demand above.
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+    return _dbPromise;
+}
+function promisifyRequest(req) {
+    return new Promise((resolve, reject) => {
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+class IndexedDBCollection {
+    name;
+    options;
+    constructor(name, options) {
+        this.name = name;
+        this.options = options;
+    }
+    async store(mode) {
+        const db = await openDb(this.name);
+        return db.transaction(this.name, mode).objectStore(this.name);
+    }
+    toDocument(row) {
+        const data = this.options.normalize(row.data);
+        return {
+            ...data,
+            id: row.id,
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        };
+    }
+    matchesFilter(doc, filter) {
+        if (!filter)
+            return true;
+        const record = doc;
+        for (const [key, value] of Object.entries(filter)) {
+            if (record[key] !== value)
+                return false;
+        }
+        return true;
+    }
+    async find(filter) {
+        const store = await this.store('readonly');
+        const rows = (await promisifyRequest(store.getAll()));
+        const all = rows.map((r) => this.toDocument(r));
+        const filtered = all.filter((d) => this.matchesFilter(d, filter));
+        filtered.sort((a, b) => (b.created_at ?? '').localeCompare(a.created_at ?? ''));
+        return filtered;
+    }
+    async findOne(id) {
+        const store = await this.store('readonly');
+        const row = (await promisifyRequest(store.get(id)));
+        return row ? this.toDocument(row) : null;
+    }
+    async insert(doc) {
+        const now = nowIso();
+        const row = {
+            id: newId(),
+            data: { ...doc, _v: this.options.version },
+            created_at: now,
+            updated_at: now,
+        };
+        const store = await this.store('readwrite');
+        await promisifyRequest(store.put(row));
+        return this.toDocument(row);
+    }
+    async update(id, changes) {
+        const store = await this.store('readwrite');
+        const existing = (await promisifyRequest(store.get(id)));
+        if (!existing)
+            return null;
+        const next = {
+            ...existing,
+            data: {
+                ...existing.data,
+                ...changes,
+                _v: this.options.version,
+            },
+            updated_at: nowIso(),
+        };
+        await promisifyRequest(store.put(next));
+        return this.toDocument(next);
+    }
+    async remove(id) {
+        const store = await this.store('readwrite');
+        const existing = (await promisifyRequest(store.get(id)));
+        if (!existing)
+            return false;
+        await promisifyRequest(store.delete(id));
+        return true;
+    }
+    async count(filter) {
+        if (!filter) {
+            const store = await this.store('readonly');
+            return promisifyRequest(store.count());
+        }
+        const all = await this.find(filter);
+        return all.length;
+    }
+}
+// ── Factory ────────────────────────────────────────────────────────
+/**
+ * Open a typed collection. Returns a backend that matches the current
+ * environment — no server means IndexedDB, server present means
+ * FetchCollection routed through the private `/_internal/collection/*`
+ * surface.
+ *
+ * For the production path to work, the app's `manifest.json` must
+ * declare the collection under `collections` with a JSON Schema so
+ * the runtime can validate writes:
+ *
+ *   {
+ *     "collections": {
+ *       "notes": {
+ *         "version": 1,
+ *         "schema": {
+ *           "type": "object",
+ *           "required": ["title"],
+ *           "properties": {
+ *             "title": { "type": "string" },
+ *             "body":  { "type": "string" }
+ *           },
+ *           "additionalProperties": false
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * Writes that fail schema validation are rejected with HTTP 400 — so
+ * even on the private surface, callers can't produce ghost records.
+ */
+export function collection(name, options) {
+    if (detectHasServer()) {
+        return new FetchCollection(name);
+    }
+    return new IndexedDBCollection(name, options);
+}
+// Named exports in case callers want to pin a specific backend.
+export { FetchCollection, IndexedDBCollection };
+//# sourceMappingURL=data.js.map

package/dist/app-runtime/data.js.map

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

package/dist/app-runtime/index.d.ts

@@ -2,22 +2,29 @@
  * Beeable App Runtime SDK
  *
  * The client-side SDK that runs INSIDE a Beeable app — both in
- * production (the app runtime) and in development sandboxes like
- * Lovable's preview where the runtime isn't available.
+ * production (the app-runtime container) and in development sandboxes
+ * like Lovable's preview where the runtime isn't available.
  *
  * Provides:
  *   - Host bridge: postMessage communication with the Beeable host UI
  *     (`ready`, `declareMenu`, `clearMenu`, `onMenuAction`, `requestSelect`)
  *   - Live data signals: `onDataChanged` (SSE in production, no-op in dev)
- *   - Platform / cross-app calls: `beeable.api`, `beeable.app(name)`,
- *     `beeable.llm.chat(...)`
+ *   - **Typed platform API**: `beeable.api.<tag>.<method>(...)` — full
+ *     orval-generated TypeScript inference on every endpoint. Backed by
+ *     `beeableRequest` which is auto-configured for the iframe context.
+ *   - **Typed LLM chat**: `beeable.llm.chat(dto)` → OpenAI-compatible
+ *     response shape.
+ *   - Escape hatches: `beeable.api.raw.get<T>(path)` / `.post<T>` for paths
+ *     the generated client doesn't cover.
+ *   - Cross-app calls: `beeable.app(name)` — untyped by default, since
+ *     the target's route shape is unknown. For typed cross-app access,
+ *     codegen a client from the app's openapi.json.
  *
  * Apps own their entire HTTP surface. There is intentionally no
- * SDK collection() helper — every public operation is a deliberate
- * route the app declares in server/routes.js with an @openapi block,
- * and the frontend talks to those routes directly (typically via a
- * small `data.js` of fetch helpers, or a generated typed client).
- * One contract for the frontend AND any LLM/external caller.
+ * SDK collection() helper here — every public operation an app exposes
+ * is a deliberate `@openapi`-annotated route in server/routes.ts. For
+ * apps that also want a local data store (IndexedDB in dev, SQLite via
+ * private routes in production), see `@beeable/sdk/app-runtime/data`.
  *
  * Usage:
  *   import { beeable, ready, declareMenu, onDataChanged } from '@beeable/sdk/app-runtime';
@@ -26,12 +33,17 @@
  *   declareMenu([{ id: 'new', label: 'New' }]);
  *   onDataChanged(() => refetch());
  *
+ *   const me = await beeable.api.auth.getMe();
+ *   const convs = await beeable.api.conversations.list({ colleagueId });
+ *   const reply = await beeable.llm.chat({ model: 'claude-sonnet-4-6', messages });
+ *
  * IMPORTANT: this file is the canonical source. The Beeable app runtime
  * mirrors a built copy at `app-runtime/src/public/beeable-sdk.js` so its
  * Vite override plugin can serve the same bytes inside running app
  * containers. Both must stay in sync — the SDK build's postbuild step
  * handles that automatically.
  */
+import * as api from './typed-api';
 declare global {
     interface Window {
         __BEEABLE_APP_ID__?: string;
@@ -43,14 +55,8 @@ export interface MenuItem {
     label: string;
     children?: MenuItem[];
 }
-export interface LlmChatMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-export interface LlmChatOptions {
-    model?: string;
-    [key: string]: unknown;
-}
+/** True when running inside the Beeable runtime (proxy or direct). False in Lovable preview. */
+export declare const hasServer: boolean;
 /** Notify the host that the app has loaded and is ready. */
 export declare function ready(): void;
 /** Declare (or update) the app's menu items. */
@@ -77,20 +83,24 @@ export declare function onMenuAction(callback: (action: string) => void): () =>
  * Returns an unsubscribe function.
  */
 export declare function onDataChanged(callback: () => void): () => void;
-export interface BeeableLlm {
-    chat(messages: LlmChatMessage[], options?: LlmChatOptions): Promise<unknown>;
-}
-export interface BeeableApi {
-    get(path: string): Promise<unknown>;
-    post(path: string, body: unknown): Promise<unknown>;
+export interface RawApi {
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
 }
 export interface BeeableAppClient {
-    get(path: string): Promise<unknown>;
-    post(path: string, body: unknown): Promise<unknown>;
+    raw: RawApi;
 }
 export interface Beeable {
-    llm: BeeableLlm;
-    api: BeeableApi;
+    /** Fully-typed platform API, grouped by OpenAPI tag. */
+    api: typeof api & {
+        raw: RawApi;
+    };
+    /** Fully-typed LLM surface (shortcut for `beeable.api.llm`). */
+    llm: typeof api.llm;
+    /** Call another installed app. Untyped by default — use the app's generated client for inference. */
     app(name: string): BeeableAppClient;
 }
 export declare const beeable: Beeable;

package/dist/app-runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;CACF;AAID,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA0CD,4DAA4D;AAC5D,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAEnD;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAYD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK9D;AAKD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;IAChB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACrC;AAED,eAAO,MAAM,OAAO,EAAE,OAuDrB,CAAC;AAOF,eAAO,MAAM,KAAK,EAAE,MAAe,CAAC;AACpC,eAAO,MAAM,QAAQ,EAAE,MAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAGH,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAInC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;CACF;AAID,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAqBD,gGAAgG;AAChG,eAAO,MAAM,SAAS,EAAE,OAA0D,CAAC;AA0CnF,4DAA4D;AAC5D,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAEnD;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAYD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK9D;AAQD,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/C;AAqBD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAwBD,MAAM,WAAW,OAAO;IACtB,wDAAwD;IACxD,GAAG,EAAE,OAAO,GAAG,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,gEAAgE;IAChE,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IACpB,qGAAqG;IACrG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACrC;AAED,eAAO,MAAM,OAAO,EAAE,OAIrB,CAAC;AAOF,eAAO,MAAM,KAAK,EAAE,MAAe,CAAC;AACpC,eAAO,MAAM,QAAQ,EAAE,MAAkB,CAAC"}