@joewinke/jatui 0.1.24 → 0.1.26

package/dist/types/comments.d.ts

@@ -0,0 +1,65 @@
+/** Entity kinds a comment thread can hang off — mirrors the host DB CHECK. */
+export type CommentEntityType = 'project' | 'invoice' | 'contract' | 'asset' | 'task' | 'form_submission' | 'milestone' | 'contract_term';
+export declare const COMMENT_ENTITY_TYPES: readonly CommentEntityType[];
+/** Internal = staff-only. Client = also visible in the customer portal. */
+export type CommentVisibility = 'internal' | 'client';
+export declare const COMMENT_VISIBILITIES: readonly CommentVisibility[];
+export interface Comment {
+    id: string;
+    team_id: string;
+    entity_type: CommentEntityType;
+    entity_id: string;
+    author_id: string;
+    /** Joined author display name (null if the profile is gone). */
+    author_name: string | null;
+    /** Joined author avatar URL. */
+    author_avatar_url: string | null;
+    body: string;
+    /** null = top-level; otherwise the id of the top-level comment it replies to. */
+    parent_id: string | null;
+    visibility: CommentVisibility;
+    /** Set the first time the body is edited. */
+    edited_at: string | null;
+    /** Set on soft-delete; body is replaced with "[deleted]". */
+    deleted_at: string | null;
+    created_at: string;
+    /** Number of replies (top-level rows only; always 0 for replies). */
+    reply_count: number;
+    /**
+     * Replies are loaded on demand; this is [] in the paginated top-level
+     * listing and populated by the component when a thread is expanded.
+     */
+    replies: Comment[];
+}
+export interface CommentCreateInput {
+    entityType: CommentEntityType;
+    entityId: string;
+    body: string;
+    /** When set, this comment is a reply to the given TOP-LEVEL comment. */
+    parentId?: string | null;
+    /** Defaults to "internal". Clamped to the parent's visibility for replies. */
+    visibility?: CommentVisibility;
+}
+/**
+ * Transport-agnostic data layer for `<CommentThread>`. The consuming app
+ * wires these to a server load / form action / fetch endpoint. The
+ * component never imports server code or knows how data is fetched.
+ */
+export interface CommentCallbacks {
+    /** Persist a new comment (top-level or reply) and return the created row. */
+    submitComment: (input: CommentCreateInput) => Promise<Comment>;
+    /** Edit an existing comment body; returns the updated row. */
+    editComment: (id: string, body: string) => Promise<Comment>;
+    /** Soft-delete a comment. The row stays so replies remain anchored. */
+    deleteComment: (id: string) => Promise<void>;
+    /** Fetch the replies for a top-level comment (oldest-first). */
+    loadReplies: (parentId: string) => Promise<Comment[]>;
+    /**
+     * Optional: fetch the next page of top-level comments. When omitted, the
+     * "Load more" affordance is hidden.
+     */
+    loadMore?: (offset: number) => Promise<{
+        comments: Comment[];
+        total: number;
+    }>;
+}

package/dist/types/comments.js

@@ -0,0 +1,22 @@
+// Threaded Comments Types
+// Generic types for the CommentThread UI component — no framework or backend
+// dependencies. Mirrors the JST `$lib/types/comments` projection so the
+// component is a drop-in for any app whose server speaks the same shape.
+//
+// Threading is ONE level deep on the data side: a comment is either
+// top-level (`parent_id === null`) or a single-level reply. The UI renders
+// this as two visual levels (a comment and its replies).
+export var COMMENT_ENTITY_TYPES = [
+    'project',
+    'invoice',
+    'contract',
+    'asset',
+    'task',
+    'form_submission',
+    'milestone',
+    'contract_term'
+];
+export var COMMENT_VISIBILITIES = [
+    'internal',
+    'client'
+];

package/dist/types/entityPreview.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Entity preview card — the uniform shape an EntityPreviewCard renders and that
+ * a server-side resolver returns for any domain entity. One shape for every
+ * entity type so the card and hover-action stay generic and the same card backs
+ * hover-previews, @-mention unfurls, and link previews.
+ *
+ * Pure types — safe to import from both server (the resolver) and client (the
+ * card + action).
+ */
+/** A small labelled stat shown in the card's footer grid (e.g. "Submissions" → 42). */
+export interface EntityPreviewStat {
+    label: string;
+    value: string | number;
+}
+/** A coloured pill (status, type, …). `tone` maps to a DaisyUI semantic token. */
+export interface EntityPreviewBadge {
+    label: string;
+    tone?: "neutral" | "primary" | "info" | "success" | "warning" | "error";
+}
+export interface EntityPreviewData {
+    /** Canonical entity type slug (e.g. "base", "vendor", "form", "task"). */
+    type: string;
+    id: string;
+    /** Human label for the type, shown as the card's kicker (e.g. "Knowledge base"). */
+    typeLabel: string;
+    /** Main title. */
+    title: string;
+    /** Optional one-line subtitle under the title (e.g. a vendor's company). */
+    subtitle?: string | null;
+    /** Optional longer summary / description (clamped in the card). */
+    summary?: string | null;
+    /** og:image / avatar / thumbnail URL, when the entity has one. */
+    imageUrl?: string | null;
+    /** A short emoji/text glyph fallback when there's no image. */
+    icon?: string | null;
+    /** Up to ~4 labelled stats. */
+    stats?: EntityPreviewStat[];
+    /** Up to ~3 status/type pills. */
+    badges?: EntityPreviewBadge[];
+    /** The admin detail route for the entity (the card links here). */
+    href?: string | null;
+}

package/dist/types/entityPreview.js

@@ -0,0 +1,10 @@
+/**
+ * Entity preview card — the uniform shape an EntityPreviewCard renders and that
+ * a server-side resolver returns for any domain entity. One shape for every
+ * entity type so the card and hover-action stay generic and the same card backs
+ * hover-previews, @-mention unfurls, and link previews.
+ *
+ * Pure types — safe to import from both server (the resolver) and client (the
+ * card + action).
+ */
+export {};

package/dist/types/filePicker.d.ts

@@ -0,0 +1,15 @@
+export interface FilePickerFile {
+    id: string;
+    name: string;
+    created_at: string;
+    updated_at: string;
+    metadata: Record<string, any>;
+    scope: "personal" | "team";
+    /** Publicly accessible URL (no auth required). When present, used instead of the /api/files proxy URL. */
+    publicUrl?: string;
+}
+export interface FilePickerSelection {
+    file: FilePickerFile;
+    url: string;
+    downloadUrl: string;
+}

package/dist/types/filePicker.js

@@ -0,0 +1 @@
+export {};

package/dist/types/googleMaps.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Minimal ambient declarations for Google Maps JS API loaded at runtime.
+ * Prevents "Property 'google' does not exist on Window" TS errors.
+ * Components using the Google Maps API operate with `any` for advanced
+ * marker types until @types/google.maps is added as a dev dependency.
+ */
+
+declare namespace google {
+	namespace maps {
+		class Map {
+			constructor(el: HTMLElement, options: object);
+			fitBounds(bounds: any): void;
+			getZoom(): number | undefined;
+			setZoom(zoom: number): void;
+			setCenter(center: object): void;
+		}
+		class InfoWindow {
+			constructor(options: object);
+			open(map: any, marker: any): void;
+		}
+		class Circle {
+			constructor(options: object);
+			setMap(map: any): void;
+		}
+		class LatLngBounds {
+			extend(position: object): void;
+		}
+		const MapTypeId: { ROADMAP: string };
+		const event: {
+			addListener(instance: any, event: string, fn: () => void): any;
+			removeListener(listener: any): void;
+			clearInstanceListeners(instance: any): void;
+		};
+		namespace marker {
+			class AdvancedMarkerElement {
+				constructor(options: object);
+				map: any;
+				position: any;
+				addListener(event: string, fn: () => void): void;
+			}
+		}
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		const places: any;
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		const geometry: any;
+	}
+}
+
+interface Window {
+	google?: typeof google;
+}

package/dist/types/maps.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Types for MapView, LocationMap, and GPSTracker components.
+ */
+export interface MapJob {
+    id: string;
+    status: string;
+    type?: string;
+    priority?: string;
+    description?: string;
+    scheduled_at?: string;
+    customer?: {
+        name?: string;
+        phone?: string;
+    };
+    location?: {
+        address?: string;
+        latitude?: number;
+        longitude?: number;
+    };
+}
+export interface MapAgent {
+    id: string;
+    name: string;
+    email?: string;
+    avatarUrl?: string;
+    status?: string;
+    capacity?: string;
+    specializations?: string[];
+    vehicle?: {
+        name?: string;
+    };
+    /** Most recent GPS fix */
+    location?: {
+        latitude?: number;
+        longitude?: number;
+        age_seconds?: number;
+    };
+    /** Active dispatches used as fallback location */
+    dispatches?: Array<{
+        job_id: string;
+        status: string;
+    }>;
+}

package/dist/types/maps.js

@@ -0,0 +1,4 @@
+/**
+ * Types for MapView, LocationMap, and GPSTracker components.
+ */
+export {};

package/dist/types/messaging.d.ts

@@ -0,0 +1,282 @@
+export interface Message {
+    id: string;
+    content: string;
+    senderId: string;
+    senderName: string;
+    senderAvatar?: string;
+    createdAt: string;
+    editedAt?: string;
+    isRead?: boolean;
+    readByCount?: number;
+    isPinned?: boolean;
+    pinnedAt?: string;
+    pinnedBy?: string;
+    pinnedByName?: string;
+    parentMessageId?: string;
+    recipientId?: string;
+    thread_reply_count?: number;
+    thread_last_reply_at?: string;
+    thread_last_sender?: {
+        id: string;
+        full_name: string;
+        avatar_url?: string;
+    };
+    quotedMessageId?: string;
+    quotedMessage?: QuotedMessage;
+    attachments?: MessageAttachment[];
+}
+export interface QuotedMessage {
+    id: string;
+    content: string;
+    senderId: string;
+    senderName: string;
+    senderAvatar?: string;
+    createdAt: string;
+}
+export interface MessageAttachment {
+    id: string;
+    file_name: string;
+    file_type: string;
+    file_size: number;
+    storage_path: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+    thumbnail_path?: string;
+    uploaded_by: string;
+    created_at: string;
+}
+export interface PendingAttachment {
+    id: string;
+    file: File;
+    preview?: string;
+    uploading: boolean;
+    progress: number;
+    error?: string;
+    storagePath?: string;
+    width?: number;
+    height?: number;
+}
+export interface Channel {
+    id: string;
+    name: string;
+    description?: string;
+    type: 'public' | 'private' | 'direct';
+    isActive: boolean;
+    memberRole: 'admin' | 'moderator' | 'member';
+    joinedAt: string;
+    createdAt: string;
+    unreadCount?: number;
+    emoji?: string;
+}
+export interface ChannelMember {
+    id: string;
+    userId: string;
+    fullName: string;
+    avatarUrl?: string | null;
+    role: 'admin' | 'moderator' | 'member';
+    userRole?: string;
+}
+export interface DirectConversation {
+    id: string;
+    name: string;
+    avatar?: string;
+    lastMessageAt: string;
+    unreadCount?: number;
+    isOnline?: boolean;
+}
+export interface OrgMember {
+    id: string;
+    full_name: string;
+    avatar_url?: string;
+    role: string;
+    active?: boolean;
+}
+export type EmojiCategory = 'search' | 'frequently_used' | 'smileys_people' | 'animals_nature' | 'food_drink' | 'travel_places' | 'activities' | 'objects' | 'symbols' | 'flags' | 'custom';
+export type SkinTone = 'default' | 'light' | 'medium-light' | 'medium' | 'medium-dark' | 'dark';
+export interface StandardEmoji {
+    unicode: string;
+    name: string;
+    shortcode: string;
+    category: EmojiCategory;
+    keywords: string[];
+    skinTones?: string[];
+}
+export interface CustomEmoji {
+    id: string;
+    organizationId: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    fileName: string;
+    fileSize: number;
+    contentType: 'image/png' | 'image/gif';
+    storagePath: string;
+    isAnimated: boolean;
+    isActive: boolean;
+    usageCount: number;
+    uploadedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EmojiReaction {
+    id: string;
+    messageId: string;
+    userId: string;
+    emojiUnicode?: string;
+    customEmojiId?: string;
+    skinTone?: SkinTone;
+    createdAt: string;
+}
+export interface ReactionSummary {
+    emojiUnicode?: string;
+    customEmojiId?: string;
+    customEmojiName?: string;
+    customEmojiStoragePath?: string;
+    customEmojiIsAnimated?: boolean;
+    reactionCount: number;
+    userReacted: boolean;
+    recentUsers: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+export interface EmojiSelection {
+    type: 'standard' | 'custom';
+    unicode?: string;
+    customEmojiId?: string;
+    name: string;
+    shortcode: string;
+    skinTone?: SkinTone;
+}
+export interface EmojiPreferences {
+    skinTone: SkinTone;
+    frequentlyUsed: string[];
+    lastUsedAt?: string;
+    customEmojiFavorites?: string[];
+}
+export interface EmojiCategoryInfo {
+    id: EmojiCategory;
+    name: string;
+    icon: string;
+    description: string;
+}
+export interface SkinToneInfo {
+    id: SkinTone;
+    name: string;
+    unicode: string;
+    preview: string;
+}
+export interface MentionItem {
+    type: string;
+    id: string;
+    name: string;
+    secondary: string;
+    url: string;
+}
+export interface NotificationChannels {
+    email: boolean;
+    sms: boolean;
+}
+export interface NotificationEvents {
+    [key: string]: boolean;
+}
+export interface NotificationTiming {
+    [key: string]: string | number;
+}
+export interface NotificationPreferences {
+    channels: NotificationChannels;
+    events: NotificationEvents;
+    timing: NotificationTiming;
+}
+export interface PresenceState {
+    [userId: string]: {
+        status: string;
+        technicianStatus?: string;
+        lastSeen?: string;
+    };
+}
+export interface MessageCallbacks {
+    loadMessages: (params: {
+        channelId?: string;
+        dmUserId?: string;
+        before?: string;
+        limit?: number;
+    }) => Promise<Message[]>;
+    sendMessage: (params: {
+        content: string;
+        channelId?: string;
+        dmUserId?: string;
+        parentMessageId?: string;
+        quotedMessageId?: string;
+        attachments?: PendingAttachment[];
+        priority?: string;
+    }) => Promise<Message>;
+    editMessage: (messageId: string, content: string) => Promise<Message>;
+    deleteMessage: (messageId: string) => Promise<void>;
+    pinMessage: (messageId: string, channelId: string) => Promise<void>;
+    unpinMessage: (messageId: string, channelId: string) => Promise<void>;
+    markAsRead: (messageIds: string[]) => Promise<void>;
+}
+export interface ReactionCallbacks {
+    loadReactions: (messageId: string) => Promise<ReactionSummary[]>;
+    addReaction: (messageId: string, emoji: {
+        unicode?: string;
+        customEmojiId?: string;
+        skinTone?: SkinTone;
+    }) => Promise<void>;
+    removeReaction: (messageId: string, emoji: {
+        unicode?: string;
+        customEmojiId?: string;
+    }) => Promise<void>;
+}
+export interface AttachmentCallbacks {
+    getSignedUrl: (storagePath: string) => Promise<string>;
+    getThumbnailUrl: (thumbnailPath: string) => Promise<string | null>;
+    uploadFile: (file: File, organizationId: string) => Promise<{
+        path: string;
+        error?: string;
+    }>;
+    deleteAttachment: (attachmentId: string) => Promise<void>;
+}
+export interface MentionCallbacks {
+    searchMentions: (query: string) => Promise<MentionItem[]>;
+}
+export interface EmojiCallbacks {
+    loadCustomEmojis: () => Promise<CustomEmoji[]>;
+    loadPreferences: () => Promise<EmojiPreferences>;
+    savePreferences: (prefs: Partial<EmojiPreferences>) => Promise<void>;
+}
+export interface ChannelCallbacks {
+    createChannel: (params: {
+        name: string;
+        description?: string;
+        type: 'public' | 'private';
+        emoji?: string;
+        memberIds?: string[];
+    }) => Promise<Channel>;
+    updateChannel: (channelId: string, params: Partial<Pick<Channel, 'name' | 'description' | 'emoji'>>) => Promise<Channel>;
+    deleteChannel: (channelId: string) => Promise<void>;
+    leaveChannel: (channelId: string) => Promise<void>;
+    getMembers: (channelId: string) => Promise<ChannelMember[]>;
+    addMember: (channelId: string, userId: string) => Promise<void>;
+    removeMember: (channelId: string, userId: string) => Promise<void>;
+    updateMemberRole: (channelId: string, userId: string, role: 'admin' | 'moderator' | 'member') => Promise<void>;
+}
+export interface ThreadCallbacks {
+    loadReplies: (parentMessageId: string) => Promise<Message[]>;
+    sendReply: (parentMessageId: string, content: string, attachments?: PendingAttachment[]) => Promise<Message>;
+}
+export interface NotificationCallbacks {
+    loadSettings: (params: {
+        type: 'global' | 'channel';
+        channelId?: string;
+    }) => Promise<NotificationPreferences>;
+    saveSettings: (params: {
+        type: 'global' | 'channel';
+        channelId?: string;
+    }, settings: NotificationPreferences) => Promise<void>;
+}
+export declare const EMOJI_CATEGORIES: EmojiCategoryInfo[];
+export declare const SKIN_TONES: SkinToneInfo[];
+export declare const DEFAULT_QUICK_REACTIONS: StandardEmoji[];

package/dist/types/messaging.js

@@ -0,0 +1,100 @@
+// Messaging System Types
+// Generic types for messaging UI components — no framework or backend dependencies
+// ─── Emoji Data Constants ─────────────────────────────────────────────
+export var EMOJI_CATEGORIES = [
+    { id: 'search', name: 'Search', icon: '🔍', description: 'Search results' },
+    {
+        id: 'frequently_used',
+        name: 'Frequently Used',
+        icon: '🕐',
+        description: 'Your most used emojis'
+    },
+    {
+        id: 'smileys_people',
+        name: 'Smileys & People',
+        icon: '😀',
+        description: 'Faces, people, and emotions'
+    },
+    {
+        id: 'animals_nature',
+        name: 'Animals & Nature',
+        icon: '🐻',
+        description: 'Animals, plants, and nature'
+    },
+    {
+        id: 'food_drink',
+        name: 'Food & Drink',
+        icon: '🍎',
+        description: 'Food, drinks, and meals'
+    },
+    {
+        id: 'travel_places',
+        name: 'Travel & Places',
+        icon: '🏠',
+        description: 'Places, transport, and travel'
+    },
+    {
+        id: 'activities',
+        name: 'Activities',
+        icon: '⚽',
+        description: 'Sports, games, and activities'
+    },
+    { id: 'objects', name: 'Objects', icon: '🔨', description: 'Tools, objects, and items' },
+    {
+        id: 'symbols',
+        name: 'Symbols',
+        icon: '❤️',
+        description: 'Symbols, signs, and icons'
+    },
+    {
+        id: 'flags',
+        name: 'Flags',
+        icon: '🏳️',
+        description: 'Country and regional flags'
+    },
+    {
+        id: 'custom',
+        name: 'Custom',
+        icon: '🎨',
+        description: 'Organization custom emojis'
+    }
+];
+export var SKIN_TONES = [
+    { id: 'default', name: 'Default', unicode: '', preview: '👋' },
+    { id: 'light', name: 'Light', unicode: '🏻', preview: '👋🏻' },
+    { id: 'medium-light', name: 'Medium Light', unicode: '🏼', preview: '👋🏼' },
+    { id: 'medium', name: 'Medium', unicode: '🏽', preview: '👋🏽' },
+    { id: 'medium-dark', name: 'Medium Dark', unicode: '🏾', preview: '👋🏾' },
+    { id: 'dark', name: 'Dark', unicode: '🏿', preview: '👋🏿' }
+];
+// Default quick-reaction emojis (used when no user preferences available)
+export var DEFAULT_QUICK_REACTIONS = [
+    {
+        unicode: '👍',
+        name: 'Thumbs Up',
+        shortcode: 'thumbsup',
+        category: 'smileys_people',
+        keywords: ['like', 'approve', 'yes']
+    },
+    {
+        unicode: '❤️',
+        name: 'Red Heart',
+        shortcode: 'heart',
+        category: 'symbols',
+        keywords: ['love', 'heart']
+    },
+    {
+        unicode: '😂',
+        name: 'Face with Tears of Joy',
+        shortcode: 'joy',
+        category: 'smileys_people',
+        keywords: ['laugh', 'lol', 'funny']
+    },
+    {
+        unicode: '🎉',
+        name: 'Party Popper',
+        shortcode: 'tada',
+        category: 'activities',
+        keywords: ['party', 'celebrate']
+    }
+];

package/dist/types/milestone.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generic milestone/timeline types for stepped workflows.
+ *
+ * Used by MilestoneCard and MilestoneTimeline components.
+ * Projects extend this with domain-specific fields (e.g. stripe_invoice_id).
+ */
+export type MilestoneStatus = "pending" | "delivered" | "accepted" | "paid";
+export interface Milestone {
+    id: string;
+    name: string;
+    description: string;
+    percentage: number;
+    amount: number;
+    acceptance_criteria: string;
+    status: MilestoneStatus;
+    sort_order: number;
+    delivered_at: string | null;
+    accepted_at: string | null;
+    paid_at: string | null;
+}

package/dist/types/milestone.js

@@ -0,0 +1,7 @@
+/**
+ * Generic milestone/timeline types for stepped workflows.
+ *
+ * Used by MilestoneCard and MilestoneTimeline components.
+ * Projects extend this with domain-specific fields (e.g. stripe_invoice_id).
+ */
+export {};