useyuva 0.0.0-stage → 0.0.4

package/dist/types/client/api.d.ts

@@ -0,0 +1,32 @@
+import type { components } from "../schema.gen.js";
+type Schemas = components["schemas"];
+export type ClientSession = Schemas["ClientSession"];
+export type ClientSessionInfo = Schemas["ClientSessionInfo"];
+export type ClientInbox = Schemas["ClientInbox"];
+export type ClientContact = Schemas["ClientContact"];
+export type ClientPresence = Schemas["ClientPresence"];
+export type ClientConversation = Schemas["ClientConversation"];
+export type ClientConversationPage = Schemas["ClientConversationPage"];
+export type ClientConversationCreated = Schemas["ClientConversationCreated"];
+export type ClientMessage = Schemas["ClientMessage"];
+export type ClientMessagePage = Schemas["ClientMessagePage"];
+export type ClientAttachment = Schemas["ClientAttachment"];
+export type ClientReadState = Schemas["ClientReadState"];
+export type ClientRealtimeMessage = Schemas["ClientRealtimeMessage"];
+export type Problem = Schemas["Problem"];
+export type Fetch = (url: string, init: RequestInit) => Promise<Response>;
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string);
+}
+export interface Request {
+    method?: string;
+    json?: unknown;
+    body?: Blob;
+    headers?: Record<string, string>;
+    token?: string | null;
+    blob?: boolean;
+}
+export declare function call<T>(fetcher: Fetch, server: string, path: string, { method, json, body, headers, token, blob }?: Request): Promise<T>;
+export {};

package/dist/types/client/client.d.ts

@@ -0,0 +1,82 @@
+import { type Fetch, type ClientContact, type ClientConversation, type ClientConversationCreated, type ClientConversationPage, type ClientInbox, type ClientMessage, type ClientMessagePage, type ClientReadState, type ClientRealtimeMessage, type ClientSessionInfo } from "./api.js";
+export type IdentityTokenSource = () => string | null | undefined | Promise<string | null | undefined>;
+export interface YuvaStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export interface YuvaClientOptions {
+    server: string;
+    channel: string;
+    identityToken?: IdentityTokenSource | null;
+    storage?: YuvaStorage | null;
+    fetch?: Fetch;
+    WebSocket?: typeof WebSocket;
+    idempotencyKeys?: boolean;
+}
+export interface StoredState {
+    visitor_id?: string;
+    session?: {
+        token: string;
+        expires_at: string;
+        sub: string | null;
+    };
+    [key: string]: unknown;
+}
+export interface ConnectionState {
+    state: "connecting" | "open" | "reconnecting" | "closed";
+    attempt: number;
+}
+export interface YuvaClientEvents {
+    event: ClientRealtimeMessage;
+    connection: ConnectionState;
+    session: {
+        session: ClientSessionInfo;
+        renewed: boolean;
+    };
+}
+export interface MessageInput {
+    body?: string;
+    files?: Blob[];
+    client_id?: string;
+}
+export interface ConversationInput extends MessageInput {
+    subject?: string;
+}
+export interface Page {
+    cursor?: string;
+    limit?: number;
+}
+export declare function storageKey(channel: string): string;
+export declare function randomId(): string;
+export declare class YuvaClient {
+    #private;
+    readonly server: string;
+    readonly channel: string;
+    constructor(options: YuvaClientOptions);
+    get session(): ClientSessionInfo | null;
+    get token(): string | null;
+    get connected(): boolean;
+    on<K extends keyof YuvaClientEvents>(type: K, handler: (value: YuvaClientEvents[K]) => void): () => void;
+    stored(): StoredState;
+    channelSettings(): Promise<ClientInbox>;
+    setIdentityToken(source: IdentityTokenSource | null): void;
+    start(): Promise<ClientSessionInfo>;
+    refresh(): Promise<ClientSessionInfo>;
+    reset(): void;
+    signOut(): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): void;
+    reconnect(): void;
+    listConversations(page?: Page): Promise<ClientConversationPage>;
+    getConversation(id: string): Promise<ClientConversation>;
+    startConversation(input: ConversationInput): Promise<ClientConversationCreated>;
+    listMessages(conversationId: string, page?: Page & {
+        order?: "asc" | "desc";
+    }): Promise<ClientMessagePage>;
+    sendMessage(conversationId: string, input: MessageInput): Promise<ClientMessage>;
+    markRead(conversationId: string, messageId?: string): Promise<ClientReadState>;
+    setTyping(conversationId: string, typing: boolean): Promise<void>;
+    setEmail(email: string): Promise<ClientContact>;
+    attachment(id: string): Promise<Blob>;
+}
+export declare function createYuvaClient(options: YuvaClientOptions): YuvaClient;

package/dist/types/client/realtime.d.ts

@@ -0,0 +1,19 @@
+import type { ClientRealtimeMessage } from "./api.js";
+export interface RealtimeHandlers {
+    token(): string | null;
+    event(message: ClientRealtimeMessage): void;
+    sessionEnded(): void;
+    reconnecting(attempt: number): void;
+}
+export declare class Realtime {
+    #private;
+    readonly server: string;
+    readonly socketClass: typeof WebSocket;
+    readonly handlers: RealtimeHandlers;
+    constructor(server: string, socketClass: typeof WebSocket, handlers: RealtimeHandlers);
+    get connected(): boolean;
+    start(): void;
+    stop(): void;
+    reset(): void;
+    nudge(): void;
+}

package/dist/types/element.d.ts

@@ -0,0 +1,23 @@
+import { type IdentityTokenSource, type Layout, type PanelModule } from "./types.js";
+export declare function contrastOn(color: string): string;
+export declare class YuvaChatElement extends HTMLElement {
+    #private;
+    static observedAttributes: string[];
+    static loadPanel: () => Promise<PanelModule>;
+    constructor();
+    get layout(): Layout;
+    get channel(): string | null;
+    get server(): string;
+    get locale(): string;
+    get isOpen(): boolean;
+    get unread(): number;
+    setIdentityToken(source: IdentityTokenSource | null): void;
+    signOut(): Promise<void>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, previous: string | null, value: string | null): void;
+    open(): Promise<void>;
+    close(): void;
+    toggle(): Promise<void> | void;
+}
+export declare function define(): void;

package/dist/types/i18n.d.ts

@@ -0,0 +1,6 @@
+import type { MessageDescriptor, Messages } from "@lingui/core";
+export declare const sourceLocale = "en";
+export declare function resolveLocale(...candidates: (string | null | undefined)[]): string;
+export declare function directionOf(locale: string): "ltr" | "rtl";
+export declare function catalogFor(locale: string): Messages;
+export declare function translatePlain(messages: Messages, descriptor: MessageDescriptor): string;

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export { createYuvaClient, YuvaClient, type ConnectionState, type ConversationInput, type IdentityTokenSource, type MessageInput, type Page, type StoredState, type YuvaClientEvents, type YuvaClientOptions, type YuvaStorage, } from "./client/client.js";
+export { ApiError, type Fetch, type ClientAttachment, type ClientContact, type ClientConversation, type ClientConversationCreated, type ClientConversationPage, type ClientInbox, type ClientMessage, type ClientMessagePage, type ClientPresence, type ClientReadState, type ClientRealtimeMessage, type ClientSession, type ClientSessionInfo, type Problem, } from "./client/api.js";

package/dist/types/locales/en/loader.d.ts

@@ -0,0 +1,2 @@
+import type { Messages } from "@lingui/core";
+export declare const messages: Messages;

package/dist/types/locales/en/panel.d.ts

@@ -0,0 +1,2 @@
+import type { Messages } from "@lingui/core";
+export declare const messages: Messages;

package/dist/types/locales/tr/loader.d.ts

@@ -0,0 +1,2 @@
+import type { Messages } from "@lingui/core";
+export declare const messages: Messages;

package/dist/types/locales/tr/panel.d.ts

@@ -0,0 +1,2 @@
+import type { Messages } from "@lingui/core";
+export declare const messages: Messages;

package/dist/types/panel/chat.d.ts

@@ -0,0 +1,12 @@
+import { type PanelController, type PanelHost } from "../types.js";
+export declare class Chat implements PanelController {
+    #private;
+    constructor(host: PanelHost);
+    update(): void;
+    opened(): void;
+    closed(): void;
+    identityChanged(): void;
+    signOut(): Promise<void>;
+    destroy(): void;
+}
+export declare function mount(host: PanelHost): PanelController;

package/dist/types/panel/styles.d.ts

@@ -0,0 +1 @@
+export declare const styles = "\n[hidden] { display: none !important; }\n.header {\n  display: flex;\n  align-items: center;\n  gap: 10px;\n  padding-block: 12px;\n  padding-inline: 14px 10px;\n  background: var(--yuva-accent);\n  color: var(--yuva-on-accent);\n}\n.heading { flex: 1; min-inline-size: 0; }\n.title {\n  margin: 0;\n  font-size: 16px;\n  font-weight: 600;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.status { display: flex; align-items: center; gap: 6px; font-size: 13px; opacity: 0.9; }\n.dot { inline-size: 8px; block-size: 8px; border-radius: 50%; background: #22c55e; box-shadow: 0 0 0 2px rgb(255 255 255 / 0.6); }\n.dot.away { background: #9ca3af; }\n.avatars { display: flex; }\n.avatars .avatar { margin-inline-start: -8px; box-shadow: 0 0 0 2px var(--yuva-accent); }\n.avatars .avatar:first-child { margin-inline-start: 0; }\n.avatar {\n  display: grid;\n  place-items: center;\n  flex: none;\n  inline-size: 28px;\n  block-size: 28px;\n  border-radius: 50%;\n  background: var(--yuva-soft);\n  color: var(--yuva-fg);\n  font-size: 11px;\n  font-weight: 700;\n  text-transform: uppercase;\n}\n.icon {\n  display: grid;\n  place-items: center;\n  flex: none;\n  inline-size: 32px;\n  block-size: 32px;\n  padding: 0;\n  border: 0;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  cursor: pointer;\n}\n.icon:hover { background: rgb(127 127 127 / 0.18); }\n.icon:focus-visible { outline: 2px solid currentColor; outline-offset: -4px; }\n[dir=\"rtl\"] .flip { transform: scaleX(-1); }\n.body { position: relative; flex: 1; min-block-size: 0; display: flex; flex-direction: column; }\n.scroll { flex: 1; overflow-y: auto; overscroll-behavior: contain; padding: 14px; display: flex; flex-direction: column; gap: 4px; }\n.center { flex: 1; display: grid; place-content: center; gap: 6px; padding: 24px; text-align: center; }\n.empty { margin: 0; font-weight: 600; }\n.hint { margin: 0; color: var(--yuva-muted); font-size: 14px; }\n.list { list-style: none; margin: 0; padding: 6px; overflow-y: auto; flex: 1; }\n.item {\n  display: flex;\n  gap: 10px;\n  align-items: center;\n  inline-size: 100%;\n  padding: 10px;\n  border: 0;\n  border-radius: 10px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: start;\n  cursor: pointer;\n}\n.item:hover, .item:focus-visible { background: var(--yuva-soft); outline: none; }\n.item-main { flex: 1; min-inline-size: 0; }\n.item-top { display: flex; gap: 8px; justify-content: space-between; }\n.item-subject, .item-preview { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.item-subject { font-weight: 600; }\n.item-preview { color: var(--yuva-muted); font-size: 14px; }\n.item.unread .item-preview { color: var(--yuva-fg); font-weight: 600; }\n.item-time { flex: none; color: var(--yuva-muted); font-size: 12px; }\n.unread-dot { flex: none; inline-size: 9px; block-size: 9px; border-radius: 50%; background: var(--yuva-accent); }\n.primary {\n  margin: 10px;\n  padding: 10px 14px;\n  border: 0;\n  border-radius: 10px;\n  background: var(--yuva-accent);\n  color: var(--yuva-on-accent);\n  font: inherit;\n  font-weight: 600;\n  cursor: pointer;\n}\n.row { display: flex; gap: 8px; align-items: flex-end; max-inline-size: 85%; }\n.row.mine { align-self: flex-end; }\n.row.theirs .avatar { margin-block-end: 2px; }\n.avatar img { inline-size: 100%; block-size: 100%; border-radius: 50%; object-fit: cover; }\n.group-gap { margin-block-start: 8px; }\n.author { margin: 6px 0 2px; margin-inline-start: 36px; color: var(--yuva-muted); font-size: 12px; }\n.bubble {\n  padding: 8px 12px;\n  border-radius: 16px;\n  background: var(--yuva-soft);\n  overflow-wrap: anywhere;\n  white-space: normal;\n}\n.mine .bubble { background: var(--yuva-accent); color: var(--yuva-on-accent); border-end-end-radius: 4px; }\n.theirs .bubble { border-end-start-radius: 4px; }\n.bubble a { color: inherit; text-decoration: underline; }\n.bubble code { font-family: ui-monospace, Menlo, monospace; font-size: 13px; padding: 1px 4px; border-radius: 4px; background: rgb(127 127 127 / 0.2); }\n.bubble pre { margin: 4px 0; padding: 8px; border-radius: 8px; background: rgb(127 127 127 / 0.2); font-family: ui-monospace, Menlo, monospace; font-size: 13px; white-space: pre-wrap; }\n.greeting { align-self: flex-start; max-inline-size: 85%; }\n.files { display: flex; flex-direction: column; gap: 4px; margin-block-start: 4px; }\n.files img { display: block; max-inline-size: 100%; max-block-size: 220px; border-radius: 10px; cursor: zoom-in; }\n.file {\n  display: inline-flex;\n  gap: 6px;\n  align-items: center;\n  padding: 6px 10px;\n  border: 1px solid currentColor;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  font-size: 13px;\n  cursor: pointer;\n}\n.meta { align-self: flex-end; color: var(--yuva-muted); font-size: 12px; margin-block-start: 2px; }\n.meta.failed { color: var(--yuva-danger); }\n.link { padding: 0; border: 0; background: none; color: inherit; font: inherit; text-decoration: underline; cursor: pointer; }\n.typing { display: flex; gap: 6px; align-items: center; color: var(--yuva-muted); font-size: 13px; margin-block-start: 6px; }\n.typing i { display: inline-block; inline-size: 6px; block-size: 6px; border-radius: 50%; background: currentColor; animation: blink 1.2s infinite both; }\n.typing i:nth-child(2) { animation-delay: 0.2s; }\n.typing i:nth-child(3) { animation-delay: 0.4s; }\n@keyframes blink { 0%, 80%, 100% { opacity: 0.25; } 40% { opacity: 1; } }\n@media (prefers-reduced-motion: reduce) { .typing i { animation: none; } }\n.card { margin-block-start: 10px; padding: 12px; border: 1px solid var(--yuva-border); border-radius: 12px; font-size: 14px; }\n.card p { margin: 0 0 8px; }\n.card form { display: flex; gap: 6px; }\n.card input {\n  flex: 1;\n  min-inline-size: 0;\n  padding: 8px 10px;\n  border: 1px solid var(--yuva-border);\n  border-radius: 8px;\n  background: var(--yuva-bg);\n  color: inherit;\n  font: inherit;\n}\n.card button { padding: 8px 12px; border: 0; border-radius: 8px; background: var(--yuva-accent); color: var(--yuva-on-accent); font: inherit; font-weight: 600; cursor: pointer; }\n.card .error { margin: 6px 0 0; color: var(--yuva-danger); }\n.composer { border-block-start: 1px solid var(--yuva-border); padding: 8px; }\n.composer form { display: flex; gap: 4px; align-items: flex-end; }\n.composer textarea {\n  flex: 1;\n  min-inline-size: 0;\n  box-sizing: border-box;\n  block-size: 38px;\n  max-block-size: 140px;\n  padding: 8px 10px;\n  border: 0;\n  border-radius: 10px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  resize: none;\n  outline: none;\n}\n.composer .icon { color: var(--yuva-muted); }\n.composer .send { color: var(--yuva-accent); }\n.composer .send:disabled { opacity: 0.4; cursor: default; }\n.chips { display: flex; flex-wrap: wrap; gap: 6px; padding: 0 6px 6px; }\n.chip { display: inline-flex; gap: 4px; align-items: center; max-inline-size: 100%; padding: 2px 4px 2px 10px; border-radius: 999px; background: var(--yuva-soft); font-size: 13px; }\n.chip span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-inline-size: 180px; }\n.chip .icon { inline-size: 22px; block-size: 22px; }\n.banner { padding: 6px 12px; background: var(--yuva-soft); color: var(--yuva-muted); font-size: 13px; text-align: center; }\n@media (max-width: 480px) { .composer textarea, .card input { font-size: 16px; } }\n.sr { position: absolute; inline-size: 1px; block-size: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }\n";

package/dist/types/panel/text.d.ts

@@ -0,0 +1,2 @@
+export declare function inlineNodes(text: string): Node[];
+export declare function richText(body: string): DocumentFragment;

package/dist/types/react.d.ts

@@ -0,0 +1,29 @@
+import { type ReactElement, type ReactNode } from "react";
+import type { ClientConversation, ClientMessage } from "./client/api.js";
+import type { MessageInput, YuvaClient } from "./client/client.js";
+export interface YuvaProviderProps {
+    client: YuvaClient;
+    connect?: boolean;
+    children?: ReactNode;
+}
+export declare function YuvaProvider({ client, connect, children }: YuvaProviderProps): ReactElement;
+export declare function useYuva(): YuvaClient;
+export interface ConversationsResult {
+    conversations: ClientConversation[];
+    loading: boolean;
+    error: unknown;
+    hasMore: boolean;
+    loadMore(): Promise<void>;
+    reload(): Promise<void>;
+}
+export declare function useConversations(): ConversationsResult;
+export interface MessagesResult {
+    messages: ClientMessage[];
+    loading: boolean;
+    error: unknown;
+    hasMore: boolean;
+    loadOlder(): Promise<void>;
+    send(input: MessageInput | string): Promise<ClientMessage>;
+    markRead(): Promise<void>;
+}
+export declare function useMessages(conversationId: string | null | undefined): MessagesResult;