@123toto/ai-app-assistant-client 0.1.0

package/dist/controller.js

@@ -0,0 +1,341 @@
+import { capturePage } from "./capture.js";
+import { createElementPickerSession } from "./picker.js";
+/**
+ * Framework-neutral browser controller for capture, selection and conversation.
+ * Angular, React, Vue and Web Components can all bind to the same snapshots.
+ */
+export class AiDocsAssistantController {
+    client;
+    config;
+    #state = { status: "idle" };
+    #messages = [];
+    #selectedElement;
+    #selecting = false;
+    #maxConversationTurns;
+    #picker;
+    #requestController;
+    #lastQuestion;
+    #phaseTimers = [];
+    #pageKey;
+    #listeners = new Set();
+    constructor(config, client) {
+        this.client = client;
+        this.config = Object.freeze({ ...config });
+        this.#maxConversationTurns = clampInteger(config.maxConversationTurns ?? 3, 1, 10);
+        this.#pageKey = this.currentPageKey();
+    }
+    get snapshot() {
+        const conversationTurns = this.#messages.filter((message) => message.role === "assistant").length;
+        const selectedElementLabel = describeElement(this.#selectedElement);
+        return {
+            state: this.#state,
+            messages: [...this.#messages],
+            selecting: this.#selecting,
+            ...(selectedElementLabel ? { selectedElementLabel } : {}),
+            loading: this.#state.status === "loading",
+            maxConversationTurns: this.#maxConversationTurns,
+            conversationTurns,
+            conversationLimitReached: conversationTurns >= this.#maxConversationTurns
+        };
+    }
+    /** Subscribes to complete immutable snapshots and immediately emits the current one. */
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        listener(this.snapshot);
+        return () => this.#listeners.delete(listener);
+    }
+    /** Captures the current page and sends one question to the configured backend. */
+    async ask(options = {}) {
+        this.syncPage();
+        if (this.snapshot.conversationLimitReached) {
+            throw new Error("Conversation limit reached. Start a new conversation.");
+        }
+        const question = options.question?.trim()
+            || this.config.defaultQuestion
+            || "Présente cette page et explique ses principales actions.";
+        const selectedElement = options.selectedElement ?? this.#selectedElement;
+        const conversation = conversationHistory(this.#messages, this.#maxConversationTurns);
+        this.#lastQuestion = question;
+        this.stop();
+        const controller = new AbortController();
+        this.#requestController = controller;
+        this.#state = { status: "loading", phase: "preparing", partialText: "" };
+        const selectedElementLabel = describeElement(selectedElement);
+        this.#messages = [...this.#messages, {
+                id: crypto.randomUUID(),
+                role: "user",
+                text: question,
+                ...(selectedElementLabel ? { selectedElementLabel } : {})
+            }];
+        this.notify();
+        try {
+            const captured = this.capture(selectedElement);
+            const input = {
+                html: captured.html,
+                htmlTruncated: captured.htmlTruncated,
+                ...(captured.selectedElementHtml ? { selectedElementHtml: captured.selectedElementHtml } : {}),
+                question,
+                ...(conversation.length ? { conversation } : {})
+            };
+            const response = this.config.streaming === false
+                ? await this.client.ask(input, { signal: controller.signal })
+                : await this.client.stream(input, {
+                    signal: controller.signal,
+                    onEvent: (event) => this.applyStreamEvent(event)
+                });
+            this.#state = { status: "success", response };
+            this.#messages = [...this.#messages, {
+                    id: crypto.randomUUID(), role: "assistant", response
+                }];
+            this.clearSelectedElement();
+            this.notify();
+            return response;
+        }
+        catch (error) {
+            const normalized = normalizeAiDocsError(error);
+            if (normalized.name === "AbortError" && this.#messages.at(-1)?.role === "user") {
+                this.#messages = this.#messages.slice(0, -1);
+            }
+            this.#state = normalized.name === "AbortError"
+                ? { status: "idle" }
+                : { status: "error", error: normalized, canRetry: true };
+            this.notify();
+            throw normalized;
+        }
+        finally {
+            if (this.#requestController === controller)
+                this.#requestController = undefined;
+        }
+    }
+    /** Starts a cancellable DOM picker without sending a question. */
+    async selectElement() {
+        this.cancelElementSelection();
+        this.#selecting = true;
+        this.notify();
+        const picker = createElementPickerSession({
+            excludeSelectors: ["[data-ai-docs-ui]", ...(this.config.redactSelectors ?? [])]
+        });
+        this.#picker = picker;
+        try {
+            const element = await picker.result;
+            this.#selectedElement = element;
+            this.#messages = [...this.#messages, {
+                    id: crypto.randomUUID(),
+                    role: "selection",
+                    label: describeElement(element) ?? "Selected element"
+                }];
+            this.notify();
+            return element;
+        }
+        finally {
+            if (this.#picker === picker)
+                this.#picker = undefined;
+            this.#selecting = false;
+            this.notify();
+        }
+    }
+    /** Backward-compatible shortcut; prefer selection followed by a custom prompt. */
+    async selectAndAsk(question, options) {
+        const picker = createElementPickerSession({
+            ...(options?.signal ? { signal: options.signal } : {}),
+            excludeSelectors: ["[data-ai-docs-ui]", ...(this.config.redactSelectors ?? [])]
+        });
+        return this.ask({ question, selectedElement: await picker.result });
+    }
+    cancelElementSelection() {
+        this.#picker?.cancel();
+        this.#picker = undefined;
+        this.#selecting = false;
+        this.notify();
+    }
+    /** Forgets the selected target but keeps the current conversation. */
+    clearSelectedElement() {
+        this.#selectedElement = undefined;
+        if (this.#messages.at(-1)?.role === "selection") {
+            this.#messages = this.#messages.slice(0, -1);
+        }
+        this.notify();
+    }
+    /** Aborts only the active request; messages remain available for retry. */
+    stop() {
+        this.clearPhaseTimers();
+        this.#requestController?.abort(new DOMException("Request stopped.", "AbortError"));
+        this.#requestController = undefined;
+    }
+    /** Replays the last question after automatic transport retries are exhausted. */
+    retry() {
+        if (!this.#lastQuestion)
+            return Promise.reject(new Error("No request to retry."));
+        if (this.#messages.at(-1)?.role === "user")
+            this.#messages = this.#messages.slice(0, -1);
+        return this.ask({ question: this.#lastQuestion });
+    }
+    /** Clears every conversation-scoped value, including DOM selection. */
+    newConversation() {
+        this.clearPhaseTimers();
+        this.stop();
+        this.cancelElementSelection();
+        this.#messages = [];
+        this.#selectedElement = undefined;
+        this.#lastQuestion = undefined;
+        this.#state = { status: "idle" };
+        this.notify();
+    }
+    /** Starts a fresh conversation when the host page key changes. */
+    syncPage(key = this.currentPageKey()) {
+        if (key === this.#pageKey)
+            return false;
+        this.#pageKey = key;
+        this.newConversation();
+        return true;
+    }
+    reset() { this.newConversation(); }
+    /** Updates the server-defined limit and prevents keeping an invalid session. */
+    setMaxConversationTurns(value) {
+        const previousLimit = this.#maxConversationTurns;
+        const nextLimit = clampInteger(value, 1, 10);
+        const currentTurns = this.snapshot.conversationTurns;
+        if (nextLimit === previousLimit)
+            return;
+        this.#maxConversationTurns = nextLimit;
+        if (nextLimit < previousLimit && currentTurns >= nextLimit)
+            this.newConversation();
+        else
+            this.notify();
+    }
+    /** Centralizes safe DOM capture for every framework connector. */
+    capture(selectedElement) {
+        const root = this.config.rootSelector
+            ? document.querySelector(this.config.rootSelector) ?? document.body
+            : document;
+        return capturePage({
+            root,
+            ...(selectedElement ? { selectedElement } : {}),
+            redactSelectors: ["[data-ai-docs-ui]", ...(this.config.redactSelectors ?? [])],
+            ...(this.config.maxHtmlChars ? { maxHtmlChars: this.config.maxHtmlChars } : {}),
+            ...(this.config.includeFormValues !== undefined
+                ? { includeFormValues: this.config.includeFormValues }
+                : {})
+        });
+    }
+    /** Translates transport events into stable UI phases and partial text. */
+    applyStreamEvent(event) {
+        if (event.type === "status") {
+            this.clearPhaseTimers();
+            if (event.phase === "preparing") {
+                this.#state = { status: "loading", phase: "preparing", partialText: "" };
+            }
+            else {
+                this.#state = { status: "loading", phase: "thinking", partialText: "" };
+                this.#phaseTimers.push(setTimeout(() => {
+                    if (this.#state.status === "loading" && this.#state.phase === "thinking") {
+                        this.#state = { ...this.#state, phase: "writing" };
+                        this.notify();
+                    }
+                }, 3_000));
+            }
+        }
+        else if (event.type === "partial") {
+            const retry = this.#state.status === "loading" ? this.#state.retry : undefined;
+            this.#state = {
+                status: "loading", phase: "writing", partialText: event.text,
+                ...(retry ? { retry } : {})
+            };
+        }
+        else if (event.type === "retry") {
+            this.#state = {
+                status: "loading", phase: "thinking", partialText: "", retry: event
+            };
+        }
+        else if (event.type === "complete") {
+            this.clearPhaseTimers();
+            this.#state = { status: "loading", phase: "finalizing", partialText: "" };
+        }
+        this.notify();
+    }
+    clearPhaseTimers() {
+        this.#phaseTimers.forEach((timer) => clearTimeout(timer));
+        this.#phaseTimers = [];
+    }
+    currentPageKey() {
+        return this.config.pageKey?.() ?? `${location.pathname}${location.search}`;
+    }
+    notify() {
+        const snapshot = this.snapshot;
+        this.#listeners.forEach((listener) => listener(snapshot));
+    }
+}
+export function describeAiDocsElement(element) {
+    return describeElement(element);
+}
+export function normalizeAiDocsError(error) {
+    if (error instanceof Error && error.name === "AbortError")
+        return error;
+    const payload = error && typeof error === "object" && "error" in error
+        ? error.error
+        : undefined;
+    const responseBody = error && typeof error === "object" && "responseBody" in error
+        ? error.responseBody
+        : undefined;
+    const message = extractErrorMessage(payload)
+        ?? extractErrorMessage(responseBody)
+        ?? (error instanceof Error && error.message !== "[object Object]" ? error.message : undefined);
+    return new Error(message ?? "The assistant request failed. Please try again.");
+}
+/** Reads common HTTP envelopes without dumping technical JSON into the chat. */
+function extractErrorMessage(value, depth = 0) {
+    if (depth > 4 || value === undefined || value === null)
+        return undefined;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (!trimmed || trimmed === "[object Object]")
+            return undefined;
+        if ((trimmed.startsWith("{") || trimmed.startsWith("["))) {
+            try {
+                return extractErrorMessage(JSON.parse(trimmed), depth + 1);
+            }
+            catch {
+                return trimmed.slice(0, 500);
+            }
+        }
+        return trimmed.slice(0, 500);
+    }
+    if (typeof value !== "object")
+        return undefined;
+    const record = value;
+    for (const field of ["message", "error", "detail", "details"]) {
+        const message = extractErrorMessage(record[field], depth + 1);
+        if (message)
+            return message;
+    }
+    return undefined;
+}
+function describeElement(element) {
+    if (!element)
+        return undefined;
+    const text = element.textContent?.replace(/\s+/g, " ").trim();
+    const label = element.getAttribute("aria-label") || element.getAttribute("title") || text;
+    return label ? label.slice(0, 80) : element.tagName.toLowerCase();
+}
+function conversationHistory(messages, maxTurns) {
+    return messages.filter((message) => message.role !== "selection").slice(-(maxTurns * 2)).map((message) => ({
+        role: message.role,
+        content: message.role === "user"
+            ? message.text.slice(0, 8_000)
+            : renderResponseForHistory(message.response).slice(0, 8_000)
+    }));
+}
+function renderResponseForHistory(response) {
+    return [
+        response.answer.title,
+        response.answer.summary,
+        ...response.answer.sections.flatMap((section) => [section.heading, section.content]),
+        ...(response.answer.steps ?? []).flatMap((step) => [step.label, step.description]),
+        ...(response.answer.warnings ?? []),
+        ...response.limitations
+    ].filter((part) => Boolean(part)).join("\n");
+}
+function clampInteger(value, minimum, maximum) {
+    return Math.min(maximum, Math.max(minimum, Math.round(value)));
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { capturePage, type CaptureOptions, type CaptureResult } from "./capture.js";
+export { AiDocsHttpError, createAiDocsClient, type AiDocsClient, type AiDocsClientOptions, type AiDocsStreamTransport, type AiDocsTransport, type AskInput } from "./client.js";
+export { createElementPickerSession, pickElement, type ElementPickerOptions, type ElementPickerSession } from "./picker.js";
+export { AiDocsAssistantController, describeAiDocsElement, normalizeAiDocsError, type AiDocsControllerConfig, type AiDocsControllerListener, type AiDocsControllerMessage, type AiDocsControllerSnapshot, type AiDocsControllerState } from "./controller.js";
+export { AiDocsSettingsController, createAiDocsSettingsClient, type AiDocsSettingsClient, type AiDocsSettingsClientOptions, type AiDocsSettingsListener, type AiDocsSettingsSnapshot } from "./settings.js";
+export type { AiDocsAccessView, AiDocsAccessRule, AiDocsConfigurationInput, AiDocsConfigurationOptions, AiDocsConnectionResult, AiDocsConnectionTestInput, AiDocsCredentials, AiDocsManagedConfigurationView, AiDocsModelInfoContract, AiDocsProvider, AiDocsProviderInfoContract } from "@123toto/ai-app-assistant-contracts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,8BAA8B,EAC9B,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC3B,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { capturePage } from "./capture.js";
+export { AiDocsHttpError, createAiDocsClient } from "./client.js";
+export { createElementPickerSession, pickElement } from "./picker.js";
+export { AiDocsAssistantController, describeAiDocsElement, normalizeAiDocsError } from "./controller.js";
+export { AiDocsSettingsController, createAiDocsSettingsClient } from "./settings.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAGZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,kBAAkB,EAMnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,0BAA0B,EAC1B,WAAW,EAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EAMrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAK3B,MAAM,eAAe,CAAC"}

package/dist/picker.d.ts

@@ -0,0 +1,14 @@
+export interface ElementPickerOptions {
+    signal?: AbortSignal;
+    overlayClassName?: string;
+    /** Selectors ignored by the picker, such as the assistant itself. */
+    excludeSelectors?: string[];
+}
+export interface ElementPickerSession {
+    result: Promise<Element>;
+    cancel(reason?: unknown): void;
+}
+/** Starts a cancellable picker session whose listeners are always cleaned up. */
+export declare function createElementPickerSession(options?: ElementPickerOptions): ElementPickerSession;
+export declare function pickElement(options?: ElementPickerOptions): Promise<Element>;
+//# sourceMappingURL=picker.d.ts.map

package/dist/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../src/picker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CAmItB;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhF"}

package/dist/picker.js

@@ -0,0 +1,140 @@
+/** Starts a cancellable picker session whose listeners are always cleaned up. */
+export function createElementPickerSession(options = {}) {
+    const controller = new AbortController();
+    const relayAbort = () => controller.abort(options.signal?.reason);
+    if (options.signal?.aborted)
+        relayAbort();
+    else
+        options.signal?.addEventListener("abort", relayAbort, { once: true });
+    const result = new Promise((resolve, reject) => {
+        const overlay = document.createElement("div");
+        overlay.className = options.overlayClassName ?? "ai-docs-element-highlight";
+        Object.assign(overlay.style, {
+            position: "fixed",
+            pointerEvents: "none",
+            zIndex: "2147483647",
+            border: "2px solid #20a779",
+            borderRadius: "8px",
+            background: "rgba(32, 167, 121, 0.13)",
+            boxShadow: "0 0 0 4px rgba(32, 167, 121, 0.12), 0 0 28px rgba(32, 167, 121, 0.38)",
+            transition: "left 90ms ease, top 90ms ease, width 90ms ease, height 90ms ease",
+            display: "none"
+        });
+        const glow = typeof overlay.animate === "function" ? overlay.animate([
+            { boxShadow: "0 0 0 3px rgba(32,167,121,.12), 0 0 16px rgba(32,167,121,.28)" },
+            { boxShadow: "0 0 0 7px rgba(32,167,121,.05), 0 0 34px rgba(32,167,121,.5)" },
+            { boxShadow: "0 0 0 3px rgba(32,167,121,.12), 0 0 16px rgba(32,167,121,.28)" }
+        ], { duration: 1_700, iterations: Infinity, easing: "ease-in-out" }) : undefined;
+        document.body.append(overlay);
+        let hovered;
+        let animationFrame;
+        let pointer;
+        let settled = false;
+        const cleanup = () => {
+            document.removeEventListener("pointermove", onPointerMove, true);
+            document.removeEventListener("click", onClick, true);
+            document.removeEventListener("keydown", onKeyDown, true);
+            controller.signal.removeEventListener("abort", onAbort);
+            options.signal?.removeEventListener("abort", relayAbort);
+            if (animationFrame !== undefined)
+                cancelAnimationFrame(animationFrame);
+            glow?.cancel();
+            overlay.remove();
+        };
+        const finish = (element) => {
+            if (settled)
+                return;
+            settled = true;
+            if (typeof overlay.animate !== "function") {
+                cleanup();
+                resolve(element);
+                return;
+            }
+            const confirmation = overlay.animate([
+                { opacity: 1, transform: "scale(1)" },
+                { opacity: 1, transform: "scale(1.025)", background: "rgba(32,167,121,.3)" },
+                { opacity: 0, transform: "scale(.96)" }
+            ], { duration: 360, easing: "cubic-bezier(.2,.9,.3,1)" });
+            void confirmation.finished.finally(() => {
+                cleanup();
+                resolve(element);
+            });
+        };
+        const fail = (reason) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(reason);
+        };
+        const onPointerMove = (event) => {
+            if (settled)
+                return;
+            pointer = { x: event.clientX, y: event.clientY };
+            if (animationFrame !== undefined)
+                return;
+            animationFrame = requestAnimationFrame(() => {
+                animationFrame = undefined;
+                if (!pointer)
+                    return;
+                const target = document.elementFromPoint(pointer.x, pointer.y);
+                if (!target || target === overlay || isExcluded(target, options.excludeSelectors)) {
+                    hovered = undefined;
+                    overlay.style.display = "none";
+                    return;
+                }
+                hovered = target;
+                const rect = target.getBoundingClientRect();
+                Object.assign(overlay.style, {
+                    display: "block",
+                    left: `${rect.left}px`,
+                    top: `${rect.top}px`,
+                    width: `${rect.width}px`,
+                    height: `${rect.height}px`
+                });
+            });
+        };
+        const onClick = (event) => {
+            if (settled)
+                return;
+            const clicked = event.target;
+            if (clicked instanceof Element && isExcluded(clicked, options.excludeSelectors))
+                return;
+            if (!hovered)
+                return;
+            event.preventDefault();
+            event.stopImmediatePropagation();
+            finish(hovered);
+        };
+        const onKeyDown = (event) => {
+            if (event.key !== "Escape")
+                return;
+            event.preventDefault();
+            fail(new DOMException("Element selection cancelled.", "AbortError"));
+        };
+        const onAbort = () => {
+            fail(controller.signal.reason ?? new DOMException("Aborted", "AbortError"));
+        };
+        if (controller.signal.aborted) {
+            onAbort();
+            return;
+        }
+        document.addEventListener("pointermove", onPointerMove, true);
+        document.addEventListener("click", onClick, true);
+        document.addEventListener("keydown", onKeyDown, true);
+        controller.signal.addEventListener("abort", onAbort, { once: true });
+    });
+    return {
+        result,
+        cancel: (reason = new DOMException("Element selection cancelled.", "AbortError")) => {
+            controller.abort(reason);
+        }
+    };
+}
+export function pickElement(options = {}) {
+    return createElementPickerSession(options).result;
+}
+function isExcluded(element, selectors) {
+    return (selectors ?? []).some((selector) => element.matches(selector) || element.closest(selector) !== null);
+}
+//# sourceMappingURL=picker.js.map

package/dist/picker.js.map

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

package/dist/settings-web-component.d.ts

@@ -0,0 +1,57 @@
+import { type AiDocsSettingsClient, type AiDocsSettingsClientOptions } from "./settings.js";
+export interface AiDocsSettingsElementConfig {
+    endpoint: string;
+    /** Lets framework connectors reuse their authenticated HTTP transport. */
+    client?: AiDocsSettingsClient;
+    headers?: AiDocsSettingsClientOptions["headers"];
+    title?: string;
+    confirmRevoke?: () => boolean | Promise<boolean>;
+    theme?: Partial<AiDocsSettingsTheme>;
+}
+export interface AiDocsSettingsTheme {
+    accent: string;
+    surface: string;
+    surfaceMuted: string;
+    text: string;
+    textMuted: string;
+    border: string;
+    danger: string;
+}
+declare const HTMLElementBase: typeof HTMLElement;
+/** Optional framework-independent settings screen for the managed server API. */
+export declare class AiDocsSettingsElement extends HTMLElementBase {
+    #private;
+    static readonly observedAttributes: string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    /** Supplies dynamic authorization headers without coupling to a framework. */
+    configure(config: AiDocsSettingsElementConfig): void;
+    show(): void;
+    close(): void;
+    /** Rebuilds transport only when needed, then reloads the safe admin snapshot. */
+    private initialize;
+    private render;
+    private renderForm;
+    private get resolvedTitle();
+    private readonly onClick;
+    private readonly onSubmit;
+    private readonly onChange;
+    private form;
+    /** Keeps unsaved values across controller status renders. */
+    private captureDraft;
+    private connectionInput;
+    private loadModels;
+    private testConnection;
+    private save;
+    private revoke;
+    private applyTheme;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "ai-docs-settings": AiDocsSettingsElement;
+    }
+}
+export declare function defineAiDocsSettingsElement(tagName?: string): typeof AiDocsSettingsElement;
+export {};
+//# sourceMappingURL=settings-web-component.d.ts.map

package/dist/settings-web-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-web-component.d.ts","sourceRoot":"","sources":["../src/settings-web-component.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAEjC,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD,QAAA,MAAM,eAAe,EAAE,OAAO,WAEf,CAAC;AAEhB,iFAAiF;AACjF,qBAAa,qBAAsB,SAAQ,eAAe;;IACxD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAiC;IAY5D,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IAO5B,wBAAwB,IAAI,IAAI;IAIvC,8EAA8E;IACvE,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI;IAMpD,IAAI,IAAI,IAAI;IAOZ,KAAK,IAAI,IAAI;IAEpB,iFAAiF;YACnE,UAAU;IAkCxB,OAAO,CAAC,MAAM;IA6Bd,OAAO,CAAC,UAAU;IAyClB,OAAO,KAAK,aAAa,GAExB;IAED,OAAO,CAAC,QAAQ,CAAC,OAAO,CAMtB;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGvB;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMvB;IAEF,OAAO,CAAC,IAAI;IAEZ,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,eAAe;YAUT,UAAU;YAOV,cAAc;YAId,IAAI;YAiCJ,MAAM;IAYpB,OAAO,CAAC,UAAU;CAkBnB;AA8DD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAAG,kBAAkB,EAAE,qBAAqB,CAAC;KAAE;CAC/E;AAED,wBAAgB,2BAA2B,CAAC,OAAO,SAAqB,GAAG,OAAO,qBAAqB,CAGtG"}