helpdock 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,243 @@
+# HelpDock
+
+*A drop-in help desk widget. Bring your own backend.*
+
+HelpDock is a lightweight, self-hosted help desk widget built as a TypeScript library. It provides an embeddable knowledge base and contact form that sits in the corner of any web page. Uses native Web Components with no React/Vue/Angular dependencies.
+
+## Features
+
+- **Knowledge Base**: Searchable articles with categories and tags
+- **Contact Form**: Configurable support ticket submission with file attachments
+- **Mobile Responsive**: Adapts to desktop floating panel or mobile full-screen overlay
+- **Self-Hosted**: Bring your own backend and datastore
+- **TypeScript Support**: Full type definitions included
+- **Analytics**: Track user interactions and events
+
+## Installation
+
+```bash
+npm install helpdock
+```
+
+## Quick Start
+
+```typescript
+import { HelpDock, type AnalyticsEvent } from 'helpdock';
+
+HelpDock.init({
+  articles: {
+    type: "function",
+    fetch: async () => ({
+      articles: [
+        {
+          id: "getting-started",
+          title: "Getting Started",
+          description: "Learn how to use HelpDock and integrate it into your application",
+          content: "# Getting Started\n\nWelcome to HelpDock! This guide will help you get up and running quickly.\n\n## Installation\n\n```bash\nnpm install helpdock\n```\n\n## Basic Setup\n\nImport and initialize the widget with your configuration.",
+          contentType: "markdown",
+          category: "Guide",
+          tags: ["introduction", "setup"],
+        },
+        {
+          id: "api-reference",
+          title: "API Reference",
+          description: "Complete API documentation for HelpDock configuration options",
+          content: "# API Reference\n\n## Configuration Options\n\n- `position`: Widget position ('topLeft', 'topRight', 'bottomLeft', 'bottomRight')\n- `closeOnEscape`: Close widget when Escape key is pressed\n- `analytics`: Track user interactions",
+          contentType: "markdown",
+          category: "Documentation",
+          tags: ["api", "reference"],
+        },
+      ],
+    }),
+  },
+
+  contact: {
+    title: "How can we help?",
+    subtitle: "We usually respond in a few hours",
+    fields: [
+      {
+        type: "text",
+        name: "name",
+        label: "Name",
+        required: true,
+        placeholder: "Enter your name",
+      },
+      {
+        type: "email",
+        name: "email",
+        label: "Email",
+        required: true,
+        placeholder: "your@email.com",
+      },
+      {
+        type: "select",
+        name: "topic",
+        label: "Topic",
+        required: true,
+        options: [
+          { value: "bug", label: "Bug Report" },
+          { value: "feature", label: "Feature Request" },
+          { value: "question", label: "Question" },
+          { value: "other", label: "Other" },
+        ],
+      },
+      {
+        type: "textarea",
+        name: "message",
+        label: "Message",
+        required: true,
+        placeholder: "How can we help you?",
+        rows: 5,
+      },
+    ],
+
+    attachments: {
+      mode: "inline",
+      maxFiles: 3,
+      maxSizeMB: 5,
+      accept: "image/*,.pdf,.doc,.docx",
+    },
+
+    submit: {
+      type: "function",
+      handler: async ({ fields, attachments }) => {
+        // Send to your backend
+        const response = await fetch('/api/contact', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ fields, attachments }),
+        });
+
+        if (!response.ok) {
+          return {
+            success: false,
+            message: "Failed to send message. Please try again.",
+          };
+        }
+
+        return {
+          success: true,
+          message: "Thank you for contacting us!",
+        };
+      },
+    },
+    submitButtonText: "Send message",
+  },
+
+  analytics: {
+    enabled: true,
+    onEvent: (event: AnalyticsEvent) => {
+      console.log("[HelpDock Analytics]", event.type, event);
+
+      // Send to your analytics service
+      // analytics.track(event.type, event);
+    },
+  },
+
+  closeOnEscape: true,
+  position: "bottomRight",
+});
+```
+
+## Script Tag Usage
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>My App</title>
+
+  <!-- Configure HelpDock before loading the script -->
+  <script>
+    window.HelpDockConfig = {
+      articles: {
+        type: "function",
+        fetch: async () => ({
+          articles: [
+            {
+              id: "getting-started",
+              title: "Getting Started",
+              description: "Learn how to use HelpDock and integrate it into your application",
+              content: "# Getting Started\n\nWelcome to HelpDock! This guide will help you get up and running quickly.\n\n## Installation\n\nInclude the script tag and configure the widget.",
+              contentType: "markdown",
+              category: "Guide",
+              tags: ["introduction", "setup"],
+            },
+            {
+              id: "troubleshooting",
+              title: "Troubleshooting",
+              description: "Common issues and how to resolve them",
+              content: "# Troubleshooting\n\n## Common Issues\n\n- **Widget not appearing**: Check that the script loaded successfully\n- **Articles not loading**: Verify your article data format\n- **Contact form errors**: Check your submit handler",
+              contentType: "markdown",
+              category: "Support",
+              tags: ["troubleshooting", "support"],
+            },
+          ],
+        }),
+      },
+
+      contact: {
+        title: "Need help?",
+        subtitle: "We're here to assist",
+        fields: [
+          {
+            type: "text",
+            name: "name",
+            label: "Name",
+            required: true,
+            placeholder: "Enter your name",
+          },
+          {
+            type: "email",
+            name: "email",
+            label: "Email",
+            required: true,
+            placeholder: "your@email.com",
+          },
+          {
+            type: "textarea",
+            name: "message",
+            label: "Message",
+            required: true,
+            placeholder: "How can we help you?",
+            rows: 4,
+          },
+        ],
+
+        submit: {
+          type: "function",
+          handler: async ({ fields }) => {
+            // Simulate API call
+            await new Promise(resolve => setTimeout(resolve, 1000));
+
+            console.log("Contact form submitted:", fields);
+
+            return {
+              success: true,
+              message: "Thank you for your message!",
+            };
+          },
+        },
+      },
+
+      closeOnEscape: true,
+      position: "bottomRight",
+    };
+  </script>
+
+  <!-- Load HelpDock -->
+  <script src="https://unpkg.com/helpdock/dist/helpdock.umd.js"></script>
+</head>
+<body>
+  <!-- Your app content -->
+  <h1>My Application</h1>
+
+  <!-- HelpDock will automatically initialize with the window.HelpDockConfig -->
+</body>
+</html>
+```
+
+## License
+
+MIT

package/dist/assets/DemoPage.d.ts

@@ -0,0 +1,20 @@
+import { LitElement } from "lit";
+/**
+ * An example element.
+ *
+ * @slot - This element has a slot
+ * @csspart button - The button
+ */
+export declare class DemoPage extends LitElement {
+    /**
+     * Copy for the read the docs hint.
+     */
+    docsHint: string;
+    /**
+     * The number of times the button has been clicked.
+     */
+    count: number;
+    render(): import("lit-html").TemplateResult<1>;
+    private _onClick;
+    static styles: import("lit").CSSResult;
+}

package/dist/components/ArticleDetail.d.ts

@@ -0,0 +1,18 @@
+import { LitElement, nothing } from "lit";
+/**
+ * Article detail view component
+ */
+export declare class ArticleDetail extends LitElement {
+    expanded: boolean;
+    private articlesData?;
+    private get articles();
+    private get selectedArticle();
+    private closeArticle;
+    private toggleExpand;
+    private selectArticle;
+    private handleContentClick;
+    firstUpdated(): void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+    static styles: import("lit").CSSResult;
+}

package/dist/components/ArticlesTab.d.ts

@@ -0,0 +1,19 @@
+import { LitElement } from "lit";
+/**
+ * Articles tab content - displays article list and article detail views
+ */
+export declare class ArticlesTab extends LitElement {
+    expanded: boolean;
+    private articlesData?;
+    private config?;
+    private searchValue;
+    private hasTrackedArticlesView;
+    private get articles();
+    private get loading();
+    private selectArticle;
+    private handleSearchInput;
+    private handleContactClick;
+    updated(changedProperties: Map<string, any>): void;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: import("lit").CSSResult;
+}

package/dist/components/ContactTab.d.ts

@@ -0,0 +1,31 @@
+import { LitElement } from "lit";
+/**
+ * Contact tab content - configurable contact form
+ */
+export declare class ContactTab extends LitElement {
+    private config?;
+    private formValues;
+    private formErrors;
+    private isSubmitting;
+    private submitSuccess;
+    private submitError;
+    private attachedFiles;
+    private uploadedFiles;
+    private uploadingFiles;
+    private uploadErrors;
+    private hasTrackedContactView;
+    firstUpdated(): void;
+    private handleInput;
+    private handleFieldFocus;
+    private validateForm;
+    private handleFileSelect;
+    private handlePresignedUploads;
+    private removeAttachedFile;
+    private removeUploadedFile;
+    private clearUploadError;
+    private handleSubmit;
+    private renderField;
+    private renderAttachments;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: import("lit").CSSResult;
+}

package/dist/components/HelpDock.d.ts

@@ -0,0 +1,33 @@
+import { LitElement } from "lit";
+import { type HelpDockConfig } from "../schema/config";
+/**
+ * Main HelpDock widget component
+ *
+ * @slot - This element has a slot
+ * @csspart button - The button
+ */
+export declare class HelpDock extends LitElement {
+    static init(config?: Partial<HelpDockConfig>, el?: HelpDock): void;
+    open: boolean;
+    private config;
+    private updateContextValue;
+    private articles;
+    private articlesLoading;
+    private selectedArticle;
+    private expanded;
+    private searchQuery;
+    private articleOpenTime;
+    private widgetOpenTrigger;
+    private articlesProvider;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleOpen;
+    private handleArticleOpen;
+    private handleArticleClose;
+    private handleToggleExpand;
+    private handleSearch;
+    updateConfig(config?: HelpDockConfig): void;
+    private fetchArticles;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: import("lit").CSSResult;
+}

package/dist/components/Panel.d.ts

@@ -0,0 +1,20 @@
+import { LitElement } from "lit";
+import "./ArticlesTab";
+import "./ArticleDetail";
+import "./ContactTab";
+/**
+ * Floating panel that slides up from the widget button
+ */
+export declare class Panel extends LitElement {
+    open: boolean;
+    expanded: boolean;
+    articleOpen: boolean;
+    private config?;
+    private activeTab;
+    private setActiveTab;
+    private switchTabListener;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: import("lit").CSSResult;
+}

package/dist/components/WidgetButton.d.ts

@@ -0,0 +1,11 @@
+import { LitElement } from "lit";
+/**
+ * Floating button that appears in collapsed state
+ * Click opens the widget panel
+ */
+export declare class WidgetButton extends LitElement {
+    open: boolean;
+    private _onClick;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: import("lit").CSSResult;
+}

package/dist/context/articles-context.d.ts

@@ -0,0 +1,11 @@
+import type { Article } from "../schema/article";
+export interface ArticlesContextValue {
+    articles: Article[];
+    loading: boolean;
+    searchQuery: string;
+    filteredArticles: Article[];
+    selectedArticle: Article | null;
+}
+export declare const articlesContext: {
+    __context__: ArticlesContextValue;
+};

package/dist/context/config-context.d.ts

@@ -0,0 +1,242 @@
+export declare const configContext: {
+    __context__: {
+        position: "bottomRight" | "bottomLeft";
+        offset: {
+            x: number;
+            y: number;
+        };
+        panelWidth: number;
+        panelHeight: number;
+        mobileBreakpoint: number;
+        articles: {
+            type: "function";
+            fetch: import("zod/v4/core").$InferOuterFunctionType<import("zod/mini").ZodMiniTuple<[], null>, import("zod/mini").ZodMiniPromise<import("zod/mini").ZodMiniObject<{
+                articles: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniObject<{
+                    id: import("zod/mini").ZodMiniString<string>;
+                    title: import("zod/mini").ZodMiniString<string>;
+                    description: import("zod/mini").ZodMiniString<string>;
+                    category: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                    tags: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniString<string>>>;
+                    updatedAt: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniISODateTime>;
+                    content: import("zod/mini").ZodMiniString<string>;
+                    contentType: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniEnum<{
+                        markdown: "markdown";
+                        html: "html";
+                    }>>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>>>;
+        };
+        defaultTab: "articles" | "contact";
+        closeOnEscape: boolean;
+        closeOnClickOutside: boolean;
+        contact?: {
+            title: string;
+            fields: ({
+                name: string;
+                label: string;
+                required: boolean;
+                type: "text";
+                placeholder?: string | undefined;
+            } | {
+                name: string;
+                label: string;
+                required: boolean;
+                type: "email";
+                placeholder?: string | undefined;
+            } | {
+                name: string;
+                label: string;
+                required: boolean;
+                type: "textarea";
+                rows: number;
+                placeholder?: string | undefined;
+            } | {
+                name: string;
+                label: string;
+                required: boolean;
+                type: "select";
+                options: {
+                    value: string;
+                    label: string;
+                }[];
+                placeholder?: string | undefined;
+            })[];
+            attachments: {
+                mode: "disabled";
+            } | {
+                mode: "inline";
+                maxFiles: number;
+                maxSizeMB: number;
+                accept?: string | undefined;
+            } | {
+                mode: "presigned";
+                maxFiles: number;
+                maxSizeMB: number;
+                getUploadUrl: import("zod/v4/core").$InferOuterFunctionType<import("zod/mini").ZodMiniTuple<[import("zod/mini").ZodMiniObject<{
+                    filename: import("zod/mini").ZodMiniString<string>;
+                    contentType: import("zod/mini").ZodMiniString<string>;
+                    size: import("zod/mini").ZodMiniNumber<number>;
+                }, import("zod/v4/core").$strip>], null>, import("zod/mini").ZodMiniPromise<import("zod/mini").ZodMiniObject<{
+                    uploadUrl: import("zod/mini").ZodMiniString<string>;
+                    fileUrl: import("zod/mini").ZodMiniString<string>;
+                }, import("zod/v4/core").$strip>>>;
+                accept?: string | undefined;
+            };
+            submit: {
+                type: "function";
+                handler: import("zod/v4/core").$InferOuterFunctionType<import("zod/mini").ZodMiniTuple<[import("zod/mini").ZodMiniObject<{
+                    fields: import("zod/mini").ZodMiniRecord<import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniUnknown>;
+                    attachments: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniCustom<File, File>>, import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniObject<{
+                        filename: import("zod/mini").ZodMiniString<string>;
+                        url: import("zod/mini").ZodMiniString<string>;
+                        contentType: import("zod/mini").ZodMiniString<string>;
+                        size: import("zod/mini").ZodMiniNumber<number>;
+                    }, import("zod/v4/core").$strip>>]>>;
+                }, import("zod/v4/core").$strip>], null>, import("zod/mini").ZodMiniPromise<import("zod/mini").ZodMiniObject<{
+                    success: import("zod/mini").ZodMiniDefault<import("zod/mini").ZodMiniBoolean<boolean>>;
+                    message: import("zod/mini").ZodMiniString<string>;
+                }, import("zod/v4/core").$strip>>>;
+            };
+            submitButtonText: string;
+            subtitle?: string | undefined;
+        } | undefined;
+        icons?: {
+            widget: string | import("lit-html").TemplateResult<1>;
+            close: string | import("lit-html").TemplateResult<1>;
+        } | undefined;
+        labels?: {
+            articlesTab: string;
+            contactTab: string;
+            searchPlaceholder: string;
+            noResults: string;
+            loading: string;
+            backToArticles: string;
+            emptyStateTitle: string;
+            emptyStateSearchMessage: string;
+            emptyStateNoArticlesMessage: string;
+            getInTouch: string;
+        } | undefined;
+        analytics?: {
+            enabled: boolean;
+            onEvent?: import("zod/v4/core").$InferOuterFunctionType<import("zod/mini").ZodMiniTuple<[import("zod/mini").ZodMiniDiscriminatedUnion<[import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"widget:open">;
+                trigger: import("zod/mini").ZodMiniEnum<{
+                    button_click: "button_click";
+                    programmatic: "programmatic";
+                    auto: "auto";
+                }>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"widget:close">;
+                trigger: import("zod/mini").ZodMiniEnum<{
+                    button_click: "button_click";
+                    programmatic: "programmatic";
+                    escape: "escape";
+                    click_outside: "click_outside";
+                }>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"tab:change">;
+                from: import("zod/mini").ZodMiniEnum<{
+                    articles: "articles";
+                    contact: "contact";
+                }>;
+                to: import("zod/mini").ZodMiniEnum<{
+                    articles: "articles";
+                    contact: "contact";
+                }>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"articles:view">;
+                articleCount: import("zod/mini").ZodMiniNumber<number>;
+                hasSearchQuery: import("zod/mini").ZodMiniBoolean<boolean>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"article:click">;
+                articleId: import("zod/mini").ZodMiniString<string>;
+                articleTitle: import("zod/mini").ZodMiniString<string>;
+                articleCategory: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+                fromSearch: import("zod/mini").ZodMiniBoolean<boolean>;
+                searchQuery: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"article:view">;
+                articleId: import("zod/mini").ZodMiniString<string>;
+                articleTitle: import("zod/mini").ZodMiniString<string>;
+                articleCategory: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniString<string>>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"article:close">;
+                articleId: import("zod/mini").ZodMiniString<string>;
+                articleTitle: import("zod/mini").ZodMiniString<string>;
+                timeSpent: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"article:link:click">;
+                articleId: import("zod/mini").ZodMiniString<string>;
+                articleTitle: import("zod/mini").ZodMiniString<string>;
+                linkUrl: import("zod/mini").ZodMiniString<string>;
+                linkText: import("zod/mini").ZodMiniString<string>;
+                external: import("zod/mini").ZodMiniBoolean<boolean>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"search:query">;
+                query: import("zod/mini").ZodMiniString<string>;
+                resultCount: import("zod/mini").ZodMiniNumber<number>;
+                timeToResults: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"search:result:click">;
+                query: import("zod/mini").ZodMiniString<string>;
+                articleId: import("zod/mini").ZodMiniString<string>;
+                articleTitle: import("zod/mini").ZodMiniString<string>;
+                resultPosition: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"search:clear">;
+                previousQuery: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:view">;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:field:focus">;
+                fieldName: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:submit">;
+                hasName: import("zod/mini").ZodMiniBoolean<boolean>;
+                hasEmail: import("zod/mini").ZodMiniBoolean<boolean>;
+                hasMessage: import("zod/mini").ZodMiniBoolean<boolean>;
+                messageLength: import("zod/mini").ZodMiniNumber<number>;
+                attachmentCount: import("zod/mini").ZodMiniNumber<number>;
+                totalAttachmentSize: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:success">;
+                responseTime: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:error">;
+                errorType: import("zod/mini").ZodMiniString<string>;
+                errorMessage: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:attachment:add">;
+                fileName: import("zod/mini").ZodMiniString<string>;
+                fileSize: import("zod/mini").ZodMiniNumber<number>;
+                fileType: import("zod/mini").ZodMiniString<string>;
+                attachmentCount: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:attachment:remove">;
+                fileName: import("zod/mini").ZodMiniString<string>;
+                attachmentCount: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:attachment:upload:start">;
+                fileName: import("zod/mini").ZodMiniString<string>;
+                fileSize: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:attachment:upload:success">;
+                fileName: import("zod/mini").ZodMiniString<string>;
+                uploadTime: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"contact:attachment:upload:error">;
+                fileName: import("zod/mini").ZodMiniString<string>;
+                errorMessage: import("zod/mini").ZodMiniString<string>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"filter:category">;
+                category: import("zod/mini").ZodMiniString<string>;
+                resultCount: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>, import("zod/mini").ZodMiniObject<{
+                type: import("zod/mini").ZodMiniLiteral<"filter:tag">;
+                tag: import("zod/mini").ZodMiniString<string>;
+                resultCount: import("zod/mini").ZodMiniNumber<number>;
+            }, import("zod/v4/core").$strip>], "type">], null>, import("zod/mini").ZodMiniVoid> | undefined;
+            getSessionId?: import("zod/v4/core").$InferOuterFunctionType<import("zod/mini").ZodMiniTuple<[], null>, import("zod/mini").ZodMiniString<string>> | undefined;
+        } | undefined;
+    } | null;
+};

package/dist/helpdock.js

@@ -2208,8 +2208,8 @@ const ln = m({
   icons: S(ft(
     S(ht(Fn)),
     pt((t) => ({
-      widget: p`<svg width="24" height="24" viewBox="0 0 24 24" fill="currentColor">
-				<path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z"/>
+      widget: p`<svg width="24" height="24" viewBox="5 2 14 20" fill="currentColor">
+				<path d="M12 4C9.243 4 7 6.243 7 9h2c0-1.654 1.346-3 3-3s3 1.346 3 3c0 1.069-.454 1.465-1.481 2.255-.382.294-.813.626-1.226 1.038C10.981 13.604 10.995 14.897 11 15v2h2v-2.009c0-.024.023-.601.707-1.284.32-.32.682-.598 1.031-.867C15.798 12.024 17 11.1 17 9c0-2.757-2.243-5-5-5zm-1 14h2v2h-2z"/>
 			</svg>`,
       close: p`<svg width="24" height="24" viewBox="0 0 24 24" fill="currentColor">
 				<path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>