@pagelines/sdk 1.0.438 → 1.0.439

package/dist/agent/ui/ElSidebar.vue.d.ts

@@ -0,0 +1,30 @@
+import { NavItem } from '@pagelines/core';
+type __VLS_Props = {
+    modelValue: boolean;
+    items: NavItem[];
+    position?: 'left' | 'right';
+    title?: string;
+    widthClasses?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        header?(_: {}): any;
+        footer?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/agent/ui/ElTrialGate.vue.d.ts

@@ -0,0 +1,6 @@
+import { PageLinesSDK } from '../../sdkClient';
+type __VLS_Props = {
+    sdk: PageLinesSDK;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/agent/utils.d.ts

@@ -0,0 +1,35 @@
+import { AgentConfig, getDefaultAvatarUrl } from '@pagelines/core';
+export { getDefaultAvatarUrl };
+export declare function getImageSrc(image: string | {
+    src?: string;
+} | undefined): string;
+type AgentLike = Pick<AgentConfig, 'cover' | 'avatar' | 'name'>;
+export declare function getAgentAvatarUrl(agent: AgentLike): string;
+export declare function handleImageError(event: Event): void;
+export declare function parseVoiceMessage(args: {
+    message: string;
+    source: string;
+}): {
+    text: string;
+    sender: 'user' | 'agent';
+} | null;
+export declare function generateFirstMessage(args: {
+    name: string;
+    context?: string;
+}): string;
+/**
+ * Parse button template string with self data variables
+ * Supports: {name}, {title}, {handle}, {orgName}
+ * Uses single braces to avoid conflicts with Vue {{}} or React JSX
+ *
+ * @example
+ * parseButtonTemplate({ template: 'Talk to {name}', self })
+ * // => 'Talk to Andrew'
+ *
+ * parseButtonTemplate({ template: 'Book a meeting with {title}', self })
+ * // => 'Book a meeting with CEO & Co-Founder'
+ */
+export declare function parseButtonTemplate(args: {
+    template: string;
+    agent: Pick<AgentConfig, 'name' | 'title' | 'handle' | 'org'>;
+}): string;

package/dist/api.d.ts

@@ -0,0 +1,28 @@
+import { Hono } from 'hono';
+import { hc } from 'hono/client';
+export interface ApiClientSettings {
+    isDev: boolean;
+    apiBase?: string;
+    [key: string]: unknown;
+}
+/**
+ * Resolve API base URL from settings.
+ * Centralizes the isDev/apiBase/production URL logic used across SDK clients.
+ */
+export declare function resolveApiBase(apiBase?: string, isDev?: boolean): string;
+/**
+ * Create fully typed Hono RPC client for PageLines SDK
+ *
+ * @template TAppType - The Hono app type from the server (enables full type safety)
+ * @param settings - Configuration for API base URL and environment
+ * @param responseHandler - Optional handler to process ApiResponse for auto user/token updates
+ * @returns Typed Hono client with response interceptor
+ *
+ * @example
+ * ```typescript
+ * import type { SDKAppType } from '@/modules/main/server'
+ * const client = createApiClient<SDKAppType>({ isDev: true })
+ * const response = await client.api.auth['check-email'].$post({ json: { email } })
+ * ```
+ */
+export declare function createApiClient<TAppType extends Hono = any>(settings: ApiClientSettings, responseHandler?: (response: any) => void): ReturnType<typeof hc<TAppType>>;

package/dist/clients/AgentClient.d.ts

@@ -0,0 +1,39 @@
+import { AgentConfig } from '@pagelines/core';
+import { SDKContext } from './types';
+export declare class AgentClient {
+    private ctx;
+    constructor(ctx: SDKContext);
+    create(args: {
+        name: string;
+        orgId?: string;
+    }): Promise<AgentConfig>;
+    getStatus(args: {
+        agentId: string;
+    }): Promise<{
+        status: string;
+        ready: boolean;
+        error?: string;
+    }>;
+    waitUntilReady(args: {
+        agentId: string;
+        onStatus?: (message: string) => void;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<void>;
+    /** Send a typed webhook event to a bot agent. No auth required — the proxy is public. */
+    webhook<T = Record<string, unknown>>(args: {
+        agentId: string;
+        type: string;
+        data: T;
+        meta?: {
+            source?: string;
+            timestamp?: string;
+            correlationId?: string;
+            [key: string]: unknown;
+        };
+    }): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    private resolveOrgId;
+}

package/dist/clients/AuthClient.d.ts

@@ -0,0 +1,23 @@
+import { EnrichedUser } from '@pagelines/core';
+import { SDKContext } from './types';
+export declare class AuthClient {
+    private ctx;
+    constructor(ctx: SDKContext);
+    sendCode(email: string): Promise<void>;
+    verifyCode(email: string, code: string): Promise<void>;
+    logout(): Promise<void>;
+    getCurrentUser(): Promise<EnrichedUser | undefined>;
+    requestAuthCode(args: {
+        email: string;
+    }): Promise<boolean>;
+    loginWithCode(args: {
+        email: string;
+        code: string;
+        orgId?: string;
+        autoCreateContact?: boolean;
+    }): Promise<boolean>;
+    loginWithGoogle(args?: {
+        onSuccess?: (user: EnrichedUser) => void;
+        onError?: (error: string) => void;
+    }): void;
+}

package/dist/clients/BillingClient.d.ts

@@ -0,0 +1,22 @@
+import { SDKContext } from './types';
+export interface BillingStatus {
+    plan?: string;
+    status: string;
+    hasActiveBilling: boolean;
+    maxAgents: number;
+    trialEnd?: string;
+    trialDaysRemaining?: number;
+}
+export declare class BillingClient {
+    private ctx;
+    constructor(ctx: SDKContext);
+    startTrial(args?: {
+        returnUrl?: string;
+        planKey?: string;
+    }): Promise<void>;
+    confirmCheckout(_args?: {
+        sessionId?: string;
+    }): Promise<BillingStatus>;
+    getStatus(): Promise<BillingStatus>;
+    private resolveOrgId;
+}

package/dist/clients/ChatClient.d.ts

@@ -0,0 +1,59 @@
+import { SDKContext } from './types';
+export declare class ChatClient {
+    private ctx;
+    constructor(ctx: SDKContext);
+    chatStream(args: {
+        handle: string;
+        message: string;
+        attachments?: Array<{
+            type: string;
+            url: string;
+            name: string;
+            mimeType: string;
+            mediaId?: string;
+        }>;
+        conversationId?: string;
+        history?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+        visitorId?: string;
+        context?: string;
+        onDelta: (text: string) => void;
+        onDone: (conversationId: string) => void;
+        onError: (error: string) => void;
+        onStatus?: (status: string) => void;
+    }): Promise<void>;
+    chatStreamAuthenticated(args: {
+        agentId: string;
+        message: string;
+        attachments?: Array<{
+            type: string;
+            url: string;
+            name: string;
+            mimeType: string;
+            mediaId?: string;
+        }>;
+        conversationId?: string;
+        history?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+        onDelta: (text: string) => void;
+        onDone: (conversationId: string) => void;
+        onError: (error: string) => void;
+        onStatus?: (status: string) => void;
+    }): Promise<void>;
+    /** Shared SSE streaming logic for both public and authenticated chat */
+    private _streamChat;
+    chatMessage(args: {
+        handle: string;
+        message: string;
+        conversationId?: string;
+        visitorId?: string;
+        context?: string;
+    }): Promise<{
+        conversationId: string;
+        content: string;
+    } | undefined>;
+}

package/dist/clients/UserClient.d.ts

@@ -0,0 +1,18 @@
+import { AgentConfig } from '@pagelines/core';
+import { SDKContext } from './types';
+export declare class UserClient {
+    private ctx;
+    constructor(ctx: SDKContext);
+    getPublicAgent(args: {
+        handle: string;
+    }): Promise<AgentConfig | undefined>;
+    getAgentByEmail(args: {
+        email: string;
+    }): Promise<AgentConfig | undefined>;
+    generateAnonId(): string;
+    track(args: {
+        event: 'view_profile' | 'profile_interaction';
+        agentId: string;
+        properties?: Record<string, any>;
+    }): void;
+}

package/dist/clients/types.d.ts

@@ -0,0 +1,21 @@
+import { hc } from 'hono/client';
+import { SDKAppType } from '../types/SDKAppType.stub';
+import { AgentConfig, ApiResponse, EnrichedUser, LogHelper } from '@pagelines/core';
+import { ComputedRef, Ref } from 'vue';
+import { SDKStorage } from '../sdkStorage';
+export interface SDKContext {
+    api: ReturnType<typeof hc<SDKAppType>> extends {
+        api: infer A;
+    } ? A : any;
+    apiBase?: string;
+    isDev: boolean;
+    activeUser: Ref<EnrichedUser | undefined>;
+    token: Ref<string | null>;
+    loading: Ref<boolean>;
+    error: Ref<string | null>;
+    currentAgent: ComputedRef<AgentConfig | undefined>;
+    storage: SDKStorage;
+    sessionId: string;
+    logger: LogHelper;
+    processApiResponse: (response: ApiResponse<any>) => void;
+}

package/dist/constants/socialPlatforms.d.ts

@@ -0,0 +1,10 @@
+import { SocialAccount } from '@pagelines/core';
+type Platform = SocialAccount['platform'];
+export declare const SOCIAL_PLATFORMS: Record<Platform, {
+    label: string;
+    icon: string;
+    placeholder: string;
+    getUrl: (handle: string) => string;
+}>;
+export type SocialPlatform = keyof typeof SOCIAL_PLATFORMS;
+export {};

package/dist/demo/index.d.ts

@@ -0,0 +1,106 @@
+import { PageLinesSDK } from '../sdkClient';
+import { AgentConfig } from '@pagelines/core';
+export type { AgentConfig } from '@pagelines/core';
+export type { DemoAgentEntry } from '@/modules/agent/static/data';
+export { getStaticAgentByHandle } from '@/modules/agent/static';
+/**
+ * Get demo agents - mix of static data and DB-fetched entries
+ * @param sdk - PageLinesSDK instance for fetching handle-only entries
+ * @returns Promise<Partial<AgentConfig>[]> - Array of demo agents (static + fetched)
+ *
+ * Handle-only entries (e.g., { handle: 'dan' }) are fetched in parallel via sdk.getPublicAgent()
+ * Failed fetches are skipped silently with optional logging
+ */
+export declare function getDemoAgents(sdk: PageLinesSDK): Promise<Partial<AgentConfig>[]>;
+export declare function getDemoAgentByHandle(handle: string): Partial<{
+    agentId?: string | undefined;
+    handle?: string | undefined;
+    ownerId?: string | undefined;
+    orgId?: string | undefined;
+    name?: string | undefined;
+    emoji?: string | null | undefined;
+    title?: string | null | undefined;
+    summary?: string | null | undefined;
+    entityType?: string | undefined;
+    avatarId?: string | null | undefined;
+    coverId?: string | null | undefined;
+    avatar?: {
+        mediaId?: string | undefined;
+        userId?: string | undefined;
+        orgId?: string | undefined;
+        agentId?: string | null | undefined;
+        filename?: string | undefined;
+        mimeType?: string | undefined;
+        size?: number | undefined;
+        src?: string | undefined;
+        alt?: string | undefined;
+        context?: "avatar" | "cover" | "general" | undefined;
+        status?: "processing" | "active" | "failed" | "deleted" | undefined;
+        quality?: "high" | "low" | "standard" | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        mediaType?: "image" | "video" | "audio" | undefined;
+        className?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        duration?: number | undefined;
+        blurhash?: string | undefined;
+    } | undefined;
+    cover?: {
+        mediaId?: string | undefined;
+        userId?: string | undefined;
+        orgId?: string | undefined;
+        agentId?: string | null | undefined;
+        filename?: string | undefined;
+        mimeType?: string | undefined;
+        size?: number | undefined;
+        src?: string | undefined;
+        alt?: string | undefined;
+        context?: "avatar" | "cover" | "general" | undefined;
+        status?: "processing" | "active" | "failed" | "deleted" | undefined;
+        quality?: "high" | "low" | "standard" | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        mediaType?: "image" | "video" | "audio" | undefined;
+        className?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        duration?: number | undefined;
+        blurhash?: string | undefined;
+    } | undefined;
+    email?: string | null | undefined;
+    website?: string | null | undefined;
+    accounts?: {
+        platform: "email" | "website" | "linkedin" | "x" | "facebook" | "tiktok" | "youtube" | "github" | "instagram" | "threads" | "phone";
+        handle: string;
+    }[] | null | undefined;
+    model?: string | null | undefined;
+    lastActivityAt?: string | null | undefined;
+    lastMessageAt?: string | null | undefined;
+    instanceId?: string | null | undefined;
+    instanceProvider?: string | null | undefined;
+    imageVersion?: string | null | undefined;
+    deployEnv?: string | undefined;
+    runtime?: string | undefined;
+    consecutiveRestarts?: number | null | undefined;
+    lastRestartAt?: string | null | undefined;
+    botServerUrl?: string | null | undefined;
+    botLastPingAt?: string | null | undefined;
+    desiredStatus?: "active" | "stopped" | null | undefined;
+    botLastError?: string | null | undefined;
+    onboardedAt?: string | null | undefined;
+    org?: {
+        orgId: string;
+        handle: string;
+        name: string;
+        status: string;
+        headline?: string | undefined;
+        summary?: string | undefined;
+    } | undefined;
+    visibility?: "org" | "private" | "public" | undefined;
+    status?: string | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    isPrimary?: boolean | undefined;
+}> | undefined;
+export { staticAgents } from '@/modules/agent/static/data';

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { PageLinesSDK } from './sdkClient';
+export { PageLinesSDK };
+export type { PageLinesSDKSettings } from './sdkClient';
+export { AgentClient } from './clients/AgentClient';
+export { AuthClient } from './clients/AuthClient';
+export { ChatClient } from './clients/ChatClient';
+export { UserClient } from './clients/UserClient';
+export type { SDKContext } from './clients/types';
+export { MediaSchema } from '@pagelines/core';
+export type { Agent, User, EnrichedUser, MediaObject, ApiResponse, } from '@pagelines/core';
+export { SOCIAL_PLATFORMS } from './constants/socialPlatforms';
+export type { SocialPlatform } from './constants/socialPlatforms';