@pilotiq/pilotiq 0.1.0

package/dist/Pilotiq.js

@@ -0,0 +1,463 @@
+import { validateRightPanel, findDuplicateRightPanelId, } from './RightPanel.js';
+export class Pilotiq {
+    config;
+    installedPlugins = [];
+    constructor(name) {
+        this.config = {
+            name,
+            path: '/admin',
+            layout: 'sidebar',
+            resources: [],
+            globals: [],
+            pages: [],
+            clusters: [],
+            branding: {},
+        };
+    }
+    static make(name) {
+        return new Pilotiq(name);
+    }
+    path(p) {
+        this.config.path = `/${p.replace(/^\/+/, '')}`;
+        return this;
+    }
+    branding(b) {
+        this.config.branding = b;
+        return this;
+    }
+    resources(r) {
+        this.config.resources = r;
+        return this;
+    }
+    globals(g) {
+        this.config.globals = g;
+        return this;
+    }
+    pages(p) {
+        this.config.pages = p;
+        return this;
+    }
+    clusters(c) {
+        this.config.clusters = c;
+        return this;
+    }
+    schema(def) {
+        this.config.schema = def;
+        return this;
+    }
+    /**
+     * Plan #15 — mark a Page as the panel-root entry. Sugar for "render
+     * this page's `schema()` at `${base}` instead of the default
+     * dashboard layout."
+     *
+     * Effects:
+     *   1. `GET ${base}` resolves the page's schema (instead of the
+     *      builder-level `schema()` definition).
+     *   2. The page is registered in `cfg.pages` if not already there
+     *      (so canAccess + the action / form-state routes wire up).
+     *   3. Navigation collapses the page's nav URL to `${base}` (no
+     *      trailing slug segment) so the sidebar entry deep-links to
+     *      the panel root.
+     *
+     * The page subclass is plain — no special Page subclass required.
+     * The convention is `static slug = ''` so the regular slug-route
+     * doesn't also catch it; `panel.dashboard()` enforces this by
+     * skipping the page in the slug-route registration.
+     *
+     * @example
+     *   class MyDashboard extends Page {
+     *     static slug = ''
+     *     static label = 'Dashboard'
+     *     static schema() { return [Heading.make('Welcome')] }
+     *   }
+     *   panel.dashboard(MyDashboard)
+     */
+    dashboard(P) {
+        this.config.dashboardPage = P;
+        if (!this.config.pages.includes(P)) {
+            this.config.pages = [...this.config.pages, P];
+        }
+        return this;
+    }
+    /**
+     * Mark a Page as the panel's profile page. The page is auto-added to
+     * `cfg.pages` (routing + canAccess wired up) and the user-menu
+     * dropdown prepends an "Edit profile" entry pointing at it.
+     *
+     *   class ProfilePage extends Page {
+     *     static slug  = 'profile'
+     *     static label = 'My profile'
+     *     static icon  = 'user-circle'
+     *     static schema(ctx) {
+     *       return [Form.make().schema([TextField.make('name')…])]
+     *     }
+     *   }
+     *   panel.profile(ProfilePage)
+     */
+    profile(P) {
+        this.config.profilePage = P;
+        if (!this.config.pages.includes(P)) {
+            this.config.pages = [...this.config.pages, P];
+        }
+        return this;
+    }
+    layout(l) {
+        this.config.layout = l;
+        return this;
+    }
+    theme(config) {
+        this.config.theme = config;
+        return this;
+    }
+    guard(fn) {
+        this.config.guard = fn;
+        return this;
+    }
+    /**
+     * Configure the current-user resolver. Pilotiq calls `fn(req)` once per
+     * request and forwards the return value into every `Resource.canX(...)`,
+     * `Global.canX(...)`, `Page.canAccess(...)`, and `Action.visible(({ user })
+     * => ...)` callback. The user object is opaque to pilotiq.
+     *
+     * Apps using `@rudderjs/auth`:
+     *
+     *   import { Auth } from '@rudderjs/auth'
+     *   Pilotiq.make('admin').user(() => Auth.user())
+     *
+     * Apps with custom auth pass whatever resolves their user. When unset,
+     * `resolveUser` returns `null` and the default `can*` predicates (which
+     * ignore `user`) all resolve `true`.
+     */
+    user(fn) {
+        this.config.user = fn;
+        return this;
+    }
+    /**
+     * Configure file uploads. Pass an adapter implementing
+     * `UploadAdapter`; `localUpload({ root, urlPrefix })` is bundled for
+     * disk-backed storage. Apps using S3 / R2 / a custom storage backend
+     * provide their own adapter conforming to the same interface.
+     *
+     *   import { localUpload } from '@pilotiq/pilotiq/uploads'
+     *   Pilotiq.make('admin').uploads({
+     *     adapter: localUpload({ root: 'public/uploads', urlPrefix: '/uploads' })
+     *   })
+     */
+    uploads(config) {
+        this.config.uploads = config;
+        return this;
+    }
+    /**
+     * Register entries for the panel's top-right user-menu dropdown.
+     * Replaces any previously registered set (call once with the full
+     * list). The dropdown only mounts when `Pilotiq.user(req => …)` is
+     * configured AND resolves a non-null user; otherwise the items are
+     * silently ignored.
+     *
+     *   import { UserMenuItem } from '@pilotiq/pilotiq'
+     *   Pilotiq.make('admin')
+     *     .user(req => Auth.user())
+     *     .userMenuItems([
+     *       UserMenuItem.make('profile').label('My profile').url('/profile'),
+     *       UserMenuItem.make('billing').label('Billing').url('/billing').sort(10),
+     *     ])
+     *     .signOut('/logout')
+     */
+    userMenuItems(items) {
+        this.config.userMenuItems = items;
+        return this;
+    }
+    /**
+     * Configure the sign-out entry on the user menu. Pass a string for the
+     * default POST shape, or a `SignOutConfig` to override label/method.
+     *
+     *   .signOut('/logout')
+     *   .signOut({ url: '/auth/logout', method: 'GET', label: 'Log out' })
+     */
+    signOut(config) {
+        this.config.signOut = typeof config === 'string' ? { url: config } : config;
+        return this;
+    }
+    /**
+     * Enable persistent database-backed notifications. Mounts the bell in
+     * the panel chrome + a small set of `_notifications` endpoints. The
+     * bell only renders when a non-null user resolves from
+     * `Pilotiq.user(req => …)` — anonymous requests never see the
+     * affordance.
+     *
+     * Sends originate from `Notification.make('Saved')
+     * .sendToDatabase(user)` (and the rudder `Notifier.send(user, ...)` /
+     * `notify(user, ...)` paths when the app uses the upstream
+     * notification class). Both write to the same `notification` table so
+     * the bell surfaces both.
+     *
+     *   Pilotiq.make('admin')
+     *     .user(req => Auth.user())
+     *     .databaseNotifications()                              // defaults
+     *     .databaseNotifications({ position: 'sidebar' })       // bell in sidebar
+     *     .databaseNotifications({ polling: null })             // disable polling
+     *     .databaseNotifications({ polling: 10, pageSize: 50 }) // custom
+     */
+    databaseNotifications(opts = {}) {
+        this.config.databaseNotifications = { ...opts, enabled: true };
+        return this;
+    }
+    /**
+     * Sugar setter for the polling interval. `null` disables auto-poll.
+     * Has no effect unless `.databaseNotifications()` was called.
+     */
+    databaseNotificationsPolling(seconds) {
+        if (!this.config.databaseNotifications)
+            return this;
+        this.config.databaseNotifications = {
+            ...this.config.databaseNotifications,
+            polling: seconds,
+        };
+        return this;
+    }
+    /**
+     * Sugar setter for the bell mount position. Has no effect unless
+     * `.databaseNotifications()` was called.
+     */
+    databaseNotificationsPosition(position) {
+        if (!this.config.databaseNotifications)
+            return this;
+        this.config.databaseNotifications = {
+            ...this.config.databaseNotifications,
+            position,
+        };
+        return this;
+    }
+    /**
+     * Phase 2 — enable broadcast push for the bell. Requires
+     * `@rudderjs/broadcast` to be installed and `BroadcastingProvider`
+     * registered. Pass `{ wsUrl }` to override the WebSocket URL (default:
+     * same-origin `/ws`). Has no effect unless `.databaseNotifications()`
+     * was called.
+     *
+     *   .databaseNotifications().databaseNotificationsBroadcast()
+     *   .databaseNotifications().databaseNotificationsBroadcast({ wsUrl: 'wss://…/ws' })
+     */
+    databaseNotificationsBroadcast(opts = true) {
+        if (!this.config.databaseNotifications)
+            return this;
+        this.config.databaseNotifications = {
+            ...this.config.databaseNotifications,
+            broadcast: opts,
+        };
+        return this;
+    }
+    /**
+     * Register named handlers for `Notification.actions([…])` slots.
+     * Calling this twice merges — later registrations override earlier
+     * keys.
+     *
+     *   panel.notificationHandlers({
+     *     'archive-project': async (ctx) => {
+     *       const { projectId } = ctx.payload as { projectId: number }
+     *       await Project.update(projectId, { archivedAt: new Date() })
+     *       return { notify: { title: 'Archived', type: 'success' } }
+     *     },
+     *   })
+     *
+     * Names must match `^[A-Za-z0-9_-]+$` (URL-safe — they ride in the
+     * action endpoint path). Empty / whitespace / non-conforming keys
+     * throw at registration time so a typo fails fast instead of 404ing
+     * three days later when a user clicks the action on an old row.
+     *
+     * Closures registered here survive a `data` JSON round-trip (only
+     * the name does — the closure stays in memory). For transient toasts
+     * authored against the current page, `Action.handler(async ctx => …)`
+     * still works inline — the registry is only required for persisted
+     * actions.
+     */
+    notificationHandlers(map) {
+        const namePattern = /^[A-Za-z0-9_-]+$/;
+        for (const key of Object.keys(map)) {
+            if (!namePattern.test(key)) {
+                throw new Error(`[Pilotiq] notificationHandlers: handler name "${key}" contains characters ` +
+                    `outside [A-Za-z0-9_-]. Names ride in the action URL path; pick a URL-safe key.`);
+            }
+        }
+        this.config.notificationHandlers = {
+            ...(this.config.notificationHandlers ?? {}),
+            ...map,
+        };
+        return this;
+    }
+    /** @internal — looked up by the notification-action route. */
+    getNotificationHandler(name) {
+        return this.config.notificationHandlers?.[name];
+    }
+    /**
+     * Register a render hook — a callback that returns `Element[]` to
+     * mount at a named slot in the panel chrome or page renderers. Multiple
+     * hooks against the same name run in registration order; their outputs
+     * concatenate.
+     *
+     *   import { Alert } from '@pilotiq/pilotiq'
+     *
+     *   Pilotiq.make('admin')
+     *     .renderHook('panels::topbar.start', ({ user }) => [
+     *       Alert.make(`Hi, ${(user as any)?.name ?? 'there'}`).info(),
+     *     ])
+     *     .renderHook(
+     *       'panels::resource.pages.list-records.table.before',
+     *       () => [Heading.make('Bulk import')],
+     *       { resource: ArticleResource },
+     *     )
+     *
+     * Scope (optional) restricts the hook to a single resource / page /
+     * global. Scope keys are OR'd within the object — passing
+     * `{ resource: A, page: P }` fires when EITHER `A` OR `P` is the
+     * active route's identifier.
+     *
+     * Throwing hooks fail closed: their slot's contribution drops; other
+     * hooks at the same slot still ship.
+     *
+     * Plan + guide: docs/plans/render-hooks.md, docs/guide/render-hooks.md.
+     */
+    renderHook(name, fn, scope) {
+        if (!this.config.renderHooks)
+            this.config.renderHooks = [];
+        const entry = { name, fn };
+        if (scope !== undefined)
+            entry.scope = scope;
+        this.config.renderHooks.push(entry);
+        return this;
+    }
+    /**
+     * Resolve the current user for a request. Internal helper called by
+     * routes + `panelInfo()`. Returns `null` when the resolver is unset or
+     * throws. Errors are swallowed deliberately — a failing user resolver
+     * should fail closed (no user) rather than 500 the page.
+     */
+    async resolveUser(req) {
+        if (!this.config.user)
+            return null;
+        try {
+            const u = await this.config.user(req);
+            return u ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    use(plugin) {
+        this.installedPlugins.push(plugin);
+        plugin.register(this);
+        return this;
+    }
+    /**
+     * Register multiple plugins in a single call. Each plugin's `register()`
+     * runs in array order — equivalent to chaining `.use(p)` per item.
+     *
+     * @example
+     * ```ts
+     * import { tiptap } from '@pilotiq/tiptap'
+     * import { codeEditor } from '@pilotiq/codemirror'
+     * import { recharts } from '@pilotiq/recharts'
+     * import { json } from '@codemirror/lang-json'
+     *
+     * Pilotiq.make('Admin')
+     *   .plugins([
+     *     tiptap(),
+     *     codeEditor({ languages: { json } }),
+     *     recharts(),
+     *   ])
+     * ```
+     */
+    plugins(list) {
+        for (const plugin of list)
+            this.use(plugin);
+        return this;
+    }
+    /**
+     * Register a single right-sidebar contribution. Plugins surface chat
+     * boxes, presence panels, document outlines, etc. through this — pilotiq
+     * core ships the sidebar chrome (collapse / resize / tab strip / mobile
+     * sheet); each contribution provides only its body component.
+     *
+     * @example
+     * ```ts
+     * Pilotiq.make('Admin').rightPanel({
+     *   id:        'ai.chat',
+     *   label:     'AI Assistant',
+     *   icon:      'sparkles',
+     *   render:    AiChatBody,
+     *   defaultWidth: 360,
+     * })
+     * ```
+     *
+     * Adapter packages typically call this from inside their plugin's
+     * `register(panel)` so consumers wire everything via `.plugins([…])`.
+     *
+     * @throws when `id` is missing/invalid, when `render` isn't a
+     *         component, when `defaultWidth` is out of [240, 800], or when
+     *         the same `id` was already registered.
+     */
+    rightPanel(contribution) {
+        validateRightPanel(contribution);
+        const existing = this.config.rightPanels ?? [];
+        const dup = findDuplicateRightPanelId(existing, contribution);
+        if (dup) {
+            throw new Error(`[Pilotiq] rightPanel: contribution id "${contribution.id}" is already ` +
+                `registered. Each right-sidebar contribution must use a unique id.`);
+        }
+        this.config.rightPanels = [...existing, contribution];
+        return this;
+    }
+    /**
+     * Bulk variant of {@link rightPanel}. Registers each contribution in
+     * array order; throws on the first invalid or duplicate id.
+     *
+     * @example
+     * ```ts
+     * Pilotiq.make('Admin').rightPanels([
+     *   { id: 'ai.chat',  render: AiChatBody },
+     *   { id: 'outline',  render: OutlineBody, defaultWidth: 280 },
+     * ])
+     * ```
+     */
+    rightPanels(list) {
+        for (const c of list)
+            this.rightPanel(c);
+        return this;
+    }
+    /** @internal — `panelInfo()` reads this to build `RightSidebarMeta`. */
+    getRightPanels() {
+        return this.config.rightPanels ?? [];
+    }
+    /** @internal */
+    enableThemeEditor() {
+        this.config.themeEditor = true;
+    }
+    /** @internal */
+    setThemeOverrides(overrides) {
+        if (overrides === undefined) {
+            delete this.config._themeOverrides;
+        }
+        else {
+            this.config._themeOverrides = overrides;
+        }
+    }
+    /** @internal — returns code defaults merged with DB overrides. Returns an
+     *  empty config when the theme editor is on so the built-in default preset
+     *  still resolves and the editor can persist overrides on top. */
+    getMergedTheme() {
+        const base = this.config.theme;
+        const overrides = this.config._themeOverrides;
+        if (!base && !overrides && !this.config.themeEditor)
+            return undefined;
+        return { ...base, ...overrides };
+    }
+    /** @internal */
+    getConfig() {
+        return this.config;
+    }
+    /** @internal */
+    getPlugins() {
+        return this.installedPlugins;
+    }
+}
+//# sourceMappingURL=Pilotiq.js.map

package/dist/Pilotiq.js.map

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

package/dist/PilotiqRegistry.d.ts

@@ -0,0 +1,10 @@
+import type { Pilotiq } from './Pilotiq.js';
+export declare const PilotiqRegistry: {
+    register(panel: Pilotiq): void;
+    all(): Pilotiq[];
+    get(name: string): Pilotiq | undefined;
+    findByPath(path: string): Pilotiq | undefined;
+    /** @internal — for testing and dev hot-reload */
+    reset(): void;
+};
+//# sourceMappingURL=PilotiqRegistry.d.ts.map

package/dist/PilotiqRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PilotiqRegistry.d.ts","sourceRoot":"","sources":["../src/PilotiqRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAO3C,eAAO,MAAM,eAAe;oBACV,OAAO,GAAG,IAAI;WAQvB,OAAO,EAAE;cAIN,MAAM,GAAG,OAAO,GAAG,SAAS;qBAIrB,MAAM,GAAG,OAAO,GAAG,SAAS;IAO7C,iDAAiD;aACxC,IAAI;CAGd,CAAA"}

package/dist/PilotiqRegistry.js

@@ -0,0 +1,32 @@
+const g = globalThis;
+const STORE_KEY = '__pilotiq_registry';
+if (!g[STORE_KEY])
+    g[STORE_KEY] = new Map();
+const map = g[STORE_KEY];
+export const PilotiqRegistry = {
+    register(panel) {
+        const name = panel.getConfig().name;
+        if (map.has(name)) {
+            throw new Error(`[Pilotiq] A panel named "${name}" is already registered.`);
+        }
+        map.set(name, panel);
+    },
+    all() {
+        return [...map.values()];
+    },
+    get(name) {
+        return map.get(name);
+    },
+    findByPath(path) {
+        for (const panel of map.values()) {
+            if (panel.getConfig().path === path)
+                return panel;
+        }
+        return undefined;
+    },
+    /** @internal — for testing and dev hot-reload */
+    reset() {
+        map.clear();
+    },
+};
+//# sourceMappingURL=PilotiqRegistry.js.map

package/dist/PilotiqRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PilotiqRegistry.js","sourceRoot":"","sources":["../src/PilotiqRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,GAAG,UAAqC,CAAA;AAC/C,MAAM,SAAS,GAAG,oBAAoB,CAAA;AACtC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,EAAmB,CAAA;AAC5D,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAyB,CAAA;AAEhD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,KAAc;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,CAAA;QACnC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,0BAA0B,CAAC,CAAA;QAC7E,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACtB,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAA;QACnD,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,iDAAiD;IACjD,KAAK;QACH,GAAG,CAAC,KAAK,EAAE,CAAA;IACb,CAAC;CACF,CAAA"}

package/dist/PilotiqServiceProvider.d.ts

@@ -0,0 +1,16 @@
+import { ServiceProvider } from '@rudderjs/core';
+import type { Application } from '@rudderjs/core';
+import type { Pilotiq } from './Pilotiq.js';
+/**
+ * Register one or more Pilotiq panels and mount their view routes.
+ *
+ * @example
+ * import { pilotiq } from '@pilotiq/pilotiq'
+ * import { adminPanel } from './app/Pilotiq/AdminPanel.js'
+ *
+ * export default [
+ *   pilotiq([adminPanel]),
+ * ]
+ */
+export declare function pilotiq(panelList: Pilotiq[]): new (app: Application) => ServiceProvider;
+//# sourceMappingURL=PilotiqServiceProvider.d.ts.map

package/dist/PilotiqServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PilotiqServiceProvider.d.ts","sourceRoot":"","sources":["../src/PilotiqServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AA+C3C;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,OAAO,EAAE,GACnB,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAM3C"}

package/dist/PilotiqServiceProvider.js

@@ -0,0 +1,57 @@
+import { ServiceProvider } from '@rudderjs/core';
+import { PilotiqRegistry } from './PilotiqRegistry.js';
+import { registerPilotiqRoutes } from './routes.js';
+// ─── Service Provider ─────────────────────────────────────
+class PilotiqServiceProvider extends ServiceProvider {
+    panels;
+    constructor(app, panels) {
+        super(app);
+        this.panels = panels;
+    }
+    register() {
+        PilotiqRegistry.reset();
+        for (const panel of this.panels) {
+            PilotiqRegistry.register(panel);
+        }
+    }
+    async boot() {
+        const { router } = await import('@rudderjs/router');
+        // Load saved theme overrides from DB for panels with themeEditor enabled
+        for (const panel of PilotiqRegistry.all()) {
+            if (panel.getConfig().themeEditor) {
+                try {
+                    const prisma = this.app.make('prisma');
+                    const slug = `${panel.getConfig().name}__theme`;
+                    const row = await prisma.panelGlobal.findUnique({ where: { slug } });
+                    if (row?.data) {
+                        const raw = typeof row.data === 'string' ? JSON.parse(row.data) : row.data;
+                        const { migrateThemeOverrides } = await import('./theme/migrate.js');
+                        panel.setThemeOverrides(migrateThemeOverrides(raw));
+                    }
+                }
+                catch { /* no DB or no table — use code defaults */ }
+            }
+            registerPilotiqRoutes(router, panel);
+        }
+    }
+}
+// ─── Factory ──────────────────────────────────────────────
+/**
+ * Register one or more Pilotiq panels and mount their view routes.
+ *
+ * @example
+ * import { pilotiq } from '@pilotiq/pilotiq'
+ * import { adminPanel } from './app/Pilotiq/AdminPanel.js'
+ *
+ * export default [
+ *   pilotiq([adminPanel]),
+ * ]
+ */
+export function pilotiq(panelList) {
+    return class PilotiqProvider extends PilotiqServiceProvider {
+        constructor(app) {
+            super(app, panelList);
+        }
+    };
+}
+//# sourceMappingURL=PilotiqServiceProvider.js.map

package/dist/PilotiqServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PilotiqServiceProvider.js","sourceRoot":"","sources":["../src/PilotiqServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGhD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,6DAA6D;AAE7D,MAAM,sBAAuB,SAAQ,eAAe;IAC1C,MAAM,CAAW;IAEzB,YAAY,GAAgB,EAAE,MAAiB;QAC7C,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,QAAQ;QACN,eAAe,CAAC,KAAK,EAAE,CAAA;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAEjD,CAAA;QAED,yEAAyE;QACzE,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,GAAG,EAAE,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAQ,CAAA;oBAC7C,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,SAAS,CAAA;oBAC/C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;oBACpE,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;wBACd,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAA;wBACpF,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;wBACpE,KAAK,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAA;oBACrD,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAC,2CAA2C,CAAC,CAAC;YACzD,CAAC;YACD,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;CACF;AAED,6DAA6D;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CACrB,SAAoB;IAEpB,OAAO,MAAM,eAAgB,SAAQ,sBAAsB;QACzD,YAAY,GAAgB;YAC1B,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC"}