@qwanyx/stack 0.2.0 → 0.2.3

package/dist/api/client.d.ts

@@ -0,0 +1,53 @@
+import type { ApiConfig, QueryParams } from '../types';
+/**
+ * Generic API Client
+ * Framework-agnostic HTTP client for any API
+ */
+export declare class ApiClient {
+    private config;
+    constructor(config: ApiConfig);
+    /**
+     * Build query string from params
+     */
+    private buildQueryString;
+    /**
+     * Make HTTP request
+     */
+    private request;
+    /**
+     * GET request
+     */
+    get<T = any>(endpoint: string, params?: QueryParams): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T = any>(endpoint: string, body?: any, params?: QueryParams): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T = any>(endpoint: string, body?: any, params?: QueryParams): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T = any>(endpoint: string, body?: any, params?: QueryParams): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T = any>(endpoint: string, params?: QueryParams): Promise<T>;
+    /**
+     * Update base URL
+     */
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * Get current base URL
+     */
+    getBaseUrl(): string;
+}
+/**
+ * Initialize the API client
+ */
+export declare function initializeApiClient(config: ApiConfig): ApiClient;
+/**
+ * Get the API client instance
+ */
+export declare function getApiClient(): ApiClient;

package/dist/auth/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Generic authentication manager
+ * Handles token storage and retrieval
+ */
+export declare class AuthManager {
+    /**
+     * Store authentication token
+     */
+    static setToken(token: string): void;
+    /**
+     * Get authentication token
+     */
+    static getToken(): string | null;
+    /**
+     * Remove authentication token
+     */
+    static clearToken(): void;
+    /**
+     * Store refresh token
+     */
+    static setRefreshToken(token: string): void;
+    /**
+     * Get refresh token
+     */
+    static getRefreshToken(): string | null;
+    /**
+     * Check if user is authenticated
+     */
+    static isAuthenticated(): boolean;
+    /**
+     * Get authorization header
+     */
+    static getAuthHeader(): Record<string, string>;
+}

package/dist/client/GraphClient.d.ts

@@ -0,0 +1,86 @@
+/**
+ * GraphClient - Backend Communication Layer
+ *
+ * Provides a type-safe interface to the qwanyx-brain SPU backend.
+ * All operations communicate through the unified `/spu/invoke` endpoint.
+ */
+import type { GraphNode, GraphEdge, GraphClientConfig } from '../types';
+export declare class GraphClient {
+    private config;
+    constructor(config: GraphClientConfig);
+    /**
+     * Call the Graph coprocessor
+     */
+    private callGraph;
+    /**
+     * Get auth token from localStorage (browser) or return empty string
+     */
+    private getToken;
+    /**
+     * Get children nodes
+     */
+    getChildren(parentId?: string): Promise<GraphNode[]>;
+    /**
+     * Get a specific node by ID
+     */
+    getNode(nodeId: string): Promise<GraphNode | null>;
+    /**
+     * Add a new node
+     */
+    addNode(node: Partial<GraphNode> & {
+        p?: string;
+        type: string;
+    }): Promise<GraphNode>;
+    /**
+     * Update an existing node
+     */
+    updateNode(nodeId: string, updates: Partial<GraphNode>): Promise<GraphNode>;
+    /**
+     * Delete a node
+     */
+    deleteNode(nodeId: string, cascade?: boolean): Promise<boolean>;
+    /**
+     * Get children with edges (supports different display modes)
+     */
+    getChildrenWithEdges(nodeId?: string, displayMode?: 'children' | 'edges' | 'both', edgeType?: string, nodeType?: string): Promise<GraphNode[]>;
+    /**
+     * Add an edge between two nodes
+     */
+    addEdge(sourceId: string | null, targetId: string, edgeType?: string, data?: Record<string, any>): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Delete an edge
+     */
+    deleteEdge(sourceId: string | null, targetId: string, edgeType?: string): Promise<{
+        deleted: boolean;
+        count: number;
+    }>;
+    /**
+     * Get edges from a source node
+     * @param sourceId - Source node ID (null for edges without source)
+     * @param edgeType - Optional edge type filter
+     * @param targetId - Optional target node ID for reverse lookups
+     */
+    getEdges(sourceId: string | null, edgeType?: string, targetId?: string): Promise<GraphEdge[]>;
+    /**
+     * Get ancestors of a node (path from root to node)
+     */
+    getAncestors(nodeId: string): Promise<GraphNode[]>;
+    /**
+     * Get tree structure starting from a root
+     */
+    getTree(rootId?: string, maxDepth?: number): Promise<any>;
+    /**
+     * Move a node to a new parent
+     */
+    moveNode(nodeId: string, newParentId?: string): Promise<GraphNode>;
+    /**
+     * Search nodes by query
+     */
+    searchNodes(query: string, type?: string): Promise<GraphNode[]>;
+    /**
+     * Get all nodes of a specific type
+     */
+    getNodesByType(type: string): Promise<GraphNode[]>;
+}

package/dist/client/MailClient.d.ts

@@ -0,0 +1,69 @@
+/**
+ * MailClient - Email Communication Layer
+ *
+ * Provides a type-safe interface to the mail coprocessor in qwanyx-brain.
+ * Handles email settings (with encrypted passwords) and IMAP operations.
+ */
+import type { MailClientConfig, MailAccount, MailListResult, ImapResponse, FolderInfo } from '../types';
+export declare class MailClient {
+    private config;
+    constructor(config: MailClientConfig);
+    /**
+     * Call the Mail coprocessor
+     */
+    private callMail;
+    /**
+     * Get auth token from localStorage (browser) or return empty string
+     */
+    private getToken;
+    /**
+     * Get email settings with decrypted passwords
+     */
+    getSettings(): Promise<{
+        accounts: MailAccount[];
+    }>;
+    /**
+     * Save email settings (passwords encrypted server-side)
+     */
+    saveSettings(accounts: MailAccount[]): Promise<void>;
+    /**
+     * List emails from IMAP inbox
+     */
+    listEmails(accountId?: string, limit?: number): Promise<MailListResult>;
+    /**
+     * Delete emails by UID
+     */
+    deleteEmails(accountId: string, uids: number[], expunge?: boolean): Promise<{
+        success: boolean;
+        deleted: number;
+    }>;
+    /**
+     * Execute raw IMAP commands - thin proxy for stack-side logic
+     * Commands are strings like: "SELECT INBOX", "UID STORE 123 +FLAGS (\\Deleted)", "EXPUNGE"
+     */
+    imapExec(accountId: string, commands: string[]): Promise<{
+        success: boolean;
+        responses: ImapResponse[];
+    }>;
+    /**
+     * Move emails to trash (soft delete)
+     */
+    trashEmails(accountId: string, uids: number[]): Promise<{
+        success: boolean;
+        moved: number;
+    }>;
+    /**
+     * Archive emails (remove from inbox, keep in All Mail)
+     */
+    archiveEmails(accountId: string, uids: number[]): Promise<{
+        success: boolean;
+        archived: number;
+    }>;
+    /**
+     * List available folders
+     */
+    listFolders(accountId: string): Promise<{
+        success: boolean;
+        folders: FolderInfo[];
+    }>;
+}

package/dist/components/AnimatedCardFlip.d.ts

@@ -0,0 +1,19 @@
+export interface AnimatedCardFlipNode {
+    _id: string;
+    type: string;
+    title: string;
+    data: {
+        name: string;
+        image: string;
+    };
+}
+export interface AnimatedCardFlipProps {
+    nodes: AnimatedCardFlipNode[];
+    cardCount?: number;
+    minInterval?: number;
+    maxInterval?: number;
+    onCardClick?: (node: AnimatedCardFlipNode) => void;
+    cardSize?: 'small' | 'medium' | 'large';
+    className?: string;
+}
+export declare function AnimatedCardFlip({ nodes, cardCount, minInterval, maxInterval, onCardClick, cardSize, className }: AnimatedCardFlipProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Card.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Default Card Component for Stack list items
+ * Generic design that works with any data type
+ */
+export interface CardProps<T = any> {
+    item: T;
+    onClick?: () => void;
+    title?: (item: T) => string;
+    subtitle?: (item: T) => string;
+    image?: (item: T) => string | undefined;
+    badge?: (item: T) => string | undefined;
+}
+export declare function Card<T = any>({ item, onClick, title, subtitle, image, badge, }: CardProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/Detail.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default Detail View Component
+ * Generic detail view for any item
+ */
+export interface DetailProps<T = any> {
+    item: T | null;
+    onClose?: () => void;
+    title?: (item: T) => string;
+    image?: (item: T) => string | undefined;
+    fields?: Array<{
+        label: string;
+        value: (item: T) => any;
+    }>;
+}
+export declare function Detail<T = any>({ item, onClose, title, image, fields, }: DetailProps<T>): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Mail.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Mail Component
+ * Smart email list with selection, actions, and detail view
+ */
+import React from 'react';
+export interface EmailMessage {
+    uid: number;
+    subject: string;
+    from: string;
+    date: string;
+    seen: boolean;
+}
+export interface MailProps {
+    baseUrl: string;
+    systemId: string;
+    accountId: string;
+    limit?: number;
+    selectable?: boolean;
+    showDetail?: boolean;
+    emptyMessage?: string;
+    autoLoad?: boolean;
+    onSelect?: (email: EmailMessage) => void;
+    onSelectionChange?: (uids: number[]) => void;
+    onDelete?: (uids: number[]) => void;
+    onError?: (error: Error) => void;
+    renderItem?: (email: EmailMessage, selected: boolean) => React.ReactNode;
+    renderDetail?: (email: EmailMessage) => React.ReactNode;
+    renderActions?: (selectedUids: number[], actions: MailActions) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    renderLoading?: () => React.ReactNode;
+    theme?: MailTheme;
+}
+export interface MailTheme {
+    background?: string;
+    cardBackground?: string;
+    selectedBackground?: string;
+    unreadBackground?: string;
+    text?: string;
+    textSecondary?: string;
+    border?: string;
+    primary?: string;
+    danger?: string;
+}
+export interface MailActions {
+    delete: () => Promise<void>;
+    archive: () => Promise<void>;
+    refresh: () => Promise<void>;
+    selectAll: () => void;
+    clearSelection: () => void;
+}
+export declare function Mail({ baseUrl, systemId, accountId, limit, selectable, showDetail, emptyMessage, autoLoad, onSelect, onSelectionChange, onDelete, onError, renderItem, renderDetail, renderActions, renderEmpty, renderLoading, theme: themeProp, }: MailProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Stack.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Stack Component
+ * Apple/Superhuman inspired clean design
+ */
+import React from 'react';
+import type { QueryParams } from '../types';
+export interface StackProps<T = any> {
+    endpoint: string;
+    params?: QueryParams;
+    layout?: 'list' | 'grid' | 'masonry';
+    title?: string;
+    emptyMessage?: string;
+    renderItem?: (item: T, index: number) => React.ReactNode;
+    keyExtractor?: (item: T, index: number) => string;
+    searchable?: boolean;
+    searchFields?: (keyof T)[];
+    searchPlaceholder?: string;
+    filters?: Array<{
+        field: keyof T;
+        label: string;
+        options?: Array<{
+            value: any;
+            label: string;
+        }>;
+    }>;
+    pageSize?: number;
+    onItemClick?: (item: T) => void;
+    onRefresh?: () => void;
+    theme?: {
+        background?: string;
+        cardBackground?: string;
+        text?: string;
+        textSecondary?: string;
+        border?: string;
+        primary?: string;
+    };
+}
+export declare function Stack<T = any>({ endpoint, params, layout, title, emptyMessage, renderItem, keyExtractor, searchable, searchFields, searchPlaceholder, filters, pageSize, onItemClick, onRefresh, theme, }: StackProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/hooks/useMutation.d.ts

@@ -0,0 +1,16 @@
+import type { HttpMethod } from '../types';
+export interface UseMutationOptions<TData, TVariables> {
+    onSuccess?: (data: TData, variables: TVariables) => void;
+    onError?: (error: Error, variables: TVariables) => void;
+}
+export interface UseMutationResult<TData, TVariables> {
+    data: TData | null;
+    loading: boolean;
+    error: Error | null;
+    mutate: (variables: TVariables) => Promise<TData | null>;
+    reset: () => void;
+}
+/**
+ * Generic hook for mutations (POST, PUT, PATCH, DELETE)
+ */
+export declare function useMutation<TData = any, TVariables = any>(endpoint: string, method?: HttpMethod, options?: UseMutationOptions<TData, TVariables>): UseMutationResult<TData, TVariables>;

package/dist/hooks/useQuery.d.ts

@@ -0,0 +1,18 @@
+import type { QueryParams } from '../types';
+export interface UseQueryOptions<T> {
+    enabled?: boolean;
+    refetchOnMount?: boolean;
+    onSuccess?: (data: T) => void;
+    onError?: (error: Error) => void;
+}
+export interface UseQueryResult<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Generic hook for fetching data
+ * Similar to React Query but simpler
+ */
+export declare function useQuery<T = any>(endpoint: string, params?: QueryParams, options?: UseQueryOptions<T>): UseQueryResult<T>;

package/dist/index.cjs.js

@@ -1,4 +1,4 @@
-"use strict";var wt=Object.defineProperty;var _t=(f,t,r)=>t in f?wt(f,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):f[t]=r;var be=(f,t,r)=>_t(f,typeof t!="symbol"?t+"":t,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("react");class jt{constructor(t){be(this,"config");if(!t.system_id)throw new Error("GraphClient: system_id is REQUIRED. No system_id → No start.");this.config=t}async callGraph(t,r={}){const n={coprocessor:"graph",method:t,system_id:this.config.system_id,params:r};try{const i=await fetch(`${this.config.baseUrl}/spu/invoke`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.getToken()}`},body:JSON.stringify(n)});if(!i.ok){const l=await i.text();throw new Error(`API error (${i.status}): ${l}`)}const o=await i.json();if(!o.success&&o.error)throw new Error(o.error);return o}catch(i){throw console.error("Graph API call failed:",i),i}}getToken(){return typeof window<"u"&&window.localStorage&&localStorage.getItem("qwanyx_token")||""}async getChildren(t){return(await this.callGraph("get_children",{parent_id:t})).result||[]}async getNode(t){return(await this.callGraph("get_node",{node_id:t})).result||null}async addNode(t){const r={...t,created:t.created||new Date().toISOString(),modified:new Date().toISOString()},n=await this.callGraph("add_node",r);if(!n.result)throw new Error("Failed to add node");return n.result}async updateNode(t,r){const n={node_id:t,updates:{...r,modified:new Date().toISOString()}},i=await this.callGraph("update_node",n);if(!i.result)throw new Error("Failed to update node");return i.result}async deleteNode(t,r=!1){return(await this.callGraph("delete_node",{node_id:t,cascade:r})).success===!0}async getChildrenWithEdges(t,r="children",n,i){return(await this.callGraph("get_children_with_edges",{node_id:t,display_mode:r,edge_type:n,node_type:i})).result||[]}async addEdge(t,r,n="link",i){return await this.callGraph("add_edge",{source_id:t,target_id:r,edge_type:n,data:i})}async deleteEdge(t,r,n){return await this.callGraph("delete_edge",{source_id:t,target_id:r,edge_type:n})}async getEdges(t,r){return(await this.callGraph("get_edges",{source_id:t,edge_type:r})).result||[]}async getAncestors(t){return(await this.callGraph("get_ancestors",{node_id:t})).ancestors||[]}async getTree(t,r=10){return(await this.callGraph("get_tree",{root_id:t,max_depth:r})).tree||[]}async moveNode(t,r){const n=await this.callGraph("move",{node_id:t,new_parent_id:r});if(!n.node)throw new Error("Failed to move node");return n.node}async searchNodes(t,r){return(await this.callGraph("search",{query:t,type:r})).nodes||[]}}class Qe{constructor(t){be(this,"config");if(!t.system_id)throw new Error("MailClient: system_id is REQUIRED");this.config=t}async callMail(t,r={}){const n={coprocessor:"mail",method:t,system_id:this.config.system_id,params:{user_id:this.config.system_id,...r}};try{const i=await fetch(`${this.config.baseUrl}/spu/invoke`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.getToken()}`},body:JSON.stringify(n)});if(!i.ok){const l=await i.text();throw new Error(`API error (${i.status}): ${l}`)}const o=await i.json();if(!o.success&&o.error)throw new Error(o.error);return o.result}catch(i){throw console.error("Mail API call failed:",i),i}}getToken(){return typeof window<"u"&&window.localStorage&&localStorage.getItem("qwanyx_token")||""}async getSettings(){try{return await this.callMail("get_email_settings")||{accounts:[]}}catch{return{accounts:[]}}}async saveSettings(t){await this.callMail("save_email_settings",{accounts:t})}async listEmails(t,r=20){return this.callMail("list_emails",{account_id:t,limit:r})}async deleteEmails(t,r,n=!0){return this.callMail("delete_emails",{account_id:t,uids:r,expunge:n})}async imapExec(t,r){return this.callMail("imap_exec",{account_id:t,commands:r})}async trashEmails(t,r){const n=["SELECT INBOX",...r.map(l=>`UID MOVE ${l} [Gmail]/Trash`)],o=(await this.imapExec(t,n)).responses.filter(l=>l.ok&&l.command==="UID MOVE").length;return{success:o>0,moved:o}}async archiveEmails(t,r){const n=["SELECT INBOX",...r.map(l=>`UID STORE ${l} +FLAGS (\\Deleted)`),"EXPUNGE"],o=(await this.imapExec(t,n)).responses.filter(l=>l.ok&&l.command==="UID STORE").length;return{success:o>0,archived:o}}async listFolders(t){const n=(await this.imapExec(t,['LIST "" *'])).responses.find(i=>i.command==="LIST");return n!=null&&n.ok&&n.folders?{success:!0,folders:n.folders}:{success:!1,folders:[]}}}const Ae="qwanyx_auth_token",$e="qwanyx_refresh_token";class He{static setToken(t){typeof window<"u"&&localStorage.setItem(Ae,t)}static getToken(){return typeof window<"u"?localStorage.getItem(Ae):null}static clearToken(){typeof window<"u"&&(localStorage.removeItem(Ae),localStorage.removeItem($e))}static setRefreshToken(t){typeof window<"u"&&localStorage.setItem($e,t)}static getRefreshToken(){return typeof window<"u"?localStorage.getItem($e):null}static isAuthenticated(){return!!this.getToken()}static getAuthHeader(){const t=this.getToken();return t?{Authorization:`Bearer ${t}`}:{}}}class Ze{constructor(t){be(this,"config");this.config={timeout:3e4,headers:{"Content-Type":"application/json"},...t}}buildQueryString(t){if(!t||Object.keys(t).length===0)return"";const r=new URLSearchParams;Object.entries(t).forEach(([i,o])=>{o!=null&&r.append(i,String(o))});const n=r.toString();return n?`?${n}`:""}async request(t,r={}){const{method:n="GET",headers:i={},body:o,params:l}=r,v=`${this.config.baseUrl}/${t}${this.buildQueryString(l)}`,u={...this.config.headers,...He.getAuthHeader(),...i},h={method:n,headers:u};o&&n!=="GET"&&(h.body=JSON.stringify(o));try{const x=new AbortController,j=setTimeout(()=>x.abort(),this.config.timeout),O=await fetch(v,{...h,signal:x.signal});if(clearTimeout(j),!O.ok){const D=await O.json().catch(()=>({message:O.statusText}));throw new Error(D.message||`HTTP ${O.status}`)}return await O.json()}catch(x){throw x instanceof Error?x:new Error("An unexpected error occurred")}}async get(t,r){return this.request(t,{method:"GET",params:r})}async post(t,r,n){return this.request(t,{method:"POST",body:r,params:n})}async put(t,r,n){return this.request(t,{method:"PUT",body:r,params:n})}async patch(t,r,n){return this.request(t,{method:"PATCH",body:r,params:n})}async delete(t,r){return this.request(t,{method:"DELETE",params:r})}setBaseUrl(t){this.config.baseUrl=t}getBaseUrl(){return this.config.baseUrl}}let je=null;function Et(f){return je=new Ze(f),je}function Me(){if(!je)throw new Error("API client not initialized. Call initializeApiClient() first.");return je}function et(f,t,r={}){const{enabled:n=!0,refetchOnMount:i=!0,onSuccess:o,onError:l}=r,[v,u]=b.useState(null),[h,x]=b.useState(n),[j,O]=b.useState(null),D=b.useCallback(async()=>{if(n){x(!0),O(null);try{const C=await Me().get(f,t);u(C),o==null||o(C)}catch(P){const C=P instanceof Error?P:new Error("Unknown error");O(C),l==null||l(C)}finally{x(!1)}}},[f,JSON.stringify(t),n,o,l]);return b.useEffect(()=>{i&&D()},[D,i]),{data:v,loading:h,error:j,refetch:D}}function St(f,t="POST",r={}){const{onSuccess:n,onError:i}=r,[o,l]=b.useState(null),[v,u]=b.useState(!1),[h,x]=b.useState(null),j=b.useCallback(async D=>{u(!0),x(null);try{const P=Me();let C;switch(t){case"POST":C=await P.post(f,D);break;case"PUT":C=await P.put(f,D);break;case"PATCH":C=await P.patch(f,D);break;case"DELETE":C=await P.delete(f);break;default:throw new Error(`Unsupported method: ${t}`)}return l(C),n==null||n(C,D),C}catch(P){const C=P instanceof Error?P:new Error("Unknown error");return x(C),i==null||i(C,D),null}finally{u(!1)}},[f,t,n,i]),O=b.useCallback(()=>{l(null),x(null),u(!1)},[]);return{data:o,loading:v,error:h,mutate:j,reset:O}}var De={exports:{}},ce={};/**
+"use strict";var wt=Object.defineProperty;var _t=(f,t,r)=>t in f?wt(f,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):f[t]=r;var be=(f,t,r)=>_t(f,typeof t!="symbol"?t+"":t,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("react");class jt{constructor(t){be(this,"config");if(!t.system_id)throw new Error("GraphClient: system_id is REQUIRED. No system_id → No start.");this.config=t}async callGraph(t,r={}){const n={coprocessor:"graph",method:t,system_id:this.config.system_id,params:r};try{const i=await fetch(`${this.config.baseUrl}/spu/invoke`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.getToken()}`},body:JSON.stringify(n)});if(!i.ok){const l=await i.text();throw new Error(`API error (${i.status}): ${l}`)}const o=await i.json();if(!o.success&&o.error)throw new Error(o.error);return o}catch(i){throw console.error("Graph API call failed:",i),i}}getToken(){return typeof window<"u"&&window.localStorage&&localStorage.getItem("qwanyx_token")||""}async getChildren(t){return(await this.callGraph("get_children",{parent_id:t})).result||[]}async getNode(t){return(await this.callGraph("get_node",{node_id:t})).result||null}async addNode(t){const r={...t,created:t.created||new Date().toISOString(),modified:new Date().toISOString()},n=await this.callGraph("add_node",r);if(!n.result)throw new Error("Failed to add node");return n.result}async updateNode(t,r){const n={node_id:t,updates:{...r,modified:new Date().toISOString()}},i=await this.callGraph("update_node",n);if(!i.result)throw new Error("Failed to update node");return i.result}async deleteNode(t,r=!1){return(await this.callGraph("delete_node",{node_id:t,cascade:r})).success===!0}async getChildrenWithEdges(t,r="children",n,i){return(await this.callGraph("get_children_with_edges",{node_id:t,display_mode:r,edge_type:n,node_type:i})).result||[]}async addEdge(t,r,n="link",i){return await this.callGraph("add_edge",{source_id:t,target_id:r,edge_type:n,data:i})}async deleteEdge(t,r,n){return await this.callGraph("delete_edge",{source_id:t,target_id:r,edge_type:n})}async getEdges(t,r,n){return(await this.callGraph("get_edges",{source_id:t,edge_type:r,target_id:n})).result||[]}async getAncestors(t){return(await this.callGraph("get_ancestors",{node_id:t})).ancestors||[]}async getTree(t,r=10){return(await this.callGraph("get_tree",{root_id:t,max_depth:r})).tree||[]}async moveNode(t,r){const n=await this.callGraph("move",{node_id:t,new_parent_id:r});if(!n.node)throw new Error("Failed to move node");return n.node}async searchNodes(t,r){return(await this.callGraph("search",{query:t,type:r})).nodes||[]}async getNodesByType(t){return(await this.callGraph("get_nodes_by_type",{type:t})).result||[]}}class Qe{constructor(t){be(this,"config");if(!t.system_id)throw new Error("MailClient: system_id is REQUIRED");this.config=t}async callMail(t,r={}){const n={coprocessor:"mail",method:t,system_id:this.config.system_id,params:{user_id:this.config.system_id,...r}};try{const i=await fetch(`${this.config.baseUrl}/spu/invoke`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.getToken()}`},body:JSON.stringify(n)});if(!i.ok){const l=await i.text();throw new Error(`API error (${i.status}): ${l}`)}const o=await i.json();if(!o.success&&o.error)throw new Error(o.error);return o.result}catch(i){throw console.error("Mail API call failed:",i),i}}getToken(){return typeof window<"u"&&window.localStorage&&localStorage.getItem("qwanyx_token")||""}async getSettings(){try{return await this.callMail("get_email_settings")||{accounts:[]}}catch{return{accounts:[]}}}async saveSettings(t){await this.callMail("save_email_settings",{accounts:t})}async listEmails(t,r=20){return this.callMail("list_emails",{account_id:t,limit:r})}async deleteEmails(t,r,n=!0){return this.callMail("delete_emails",{account_id:t,uids:r,expunge:n})}async imapExec(t,r){return this.callMail("imap_exec",{account_id:t,commands:r})}async trashEmails(t,r){const n=["SELECT INBOX",...r.map(l=>`UID MOVE ${l} [Gmail]/Trash`)],o=(await this.imapExec(t,n)).responses.filter(l=>l.ok&&l.command==="UID MOVE").length;return{success:o>0,moved:o}}async archiveEmails(t,r){const n=["SELECT INBOX",...r.map(l=>`UID STORE ${l} +FLAGS (\\Deleted)`),"EXPUNGE"],o=(await this.imapExec(t,n)).responses.filter(l=>l.ok&&l.command==="UID STORE").length;return{success:o>0,archived:o}}async listFolders(t){const n=(await this.imapExec(t,['LIST "" *'])).responses.find(i=>i.command==="LIST");return n!=null&&n.ok&&n.folders?{success:!0,folders:n.folders}:{success:!1,folders:[]}}}const Ae="qwanyx_auth_token",$e="qwanyx_refresh_token";class He{static setToken(t){typeof window<"u"&&localStorage.setItem(Ae,t)}static getToken(){return typeof window<"u"?localStorage.getItem(Ae):null}static clearToken(){typeof window<"u"&&(localStorage.removeItem(Ae),localStorage.removeItem($e))}static setRefreshToken(t){typeof window<"u"&&localStorage.setItem($e,t)}static getRefreshToken(){return typeof window<"u"?localStorage.getItem($e):null}static isAuthenticated(){return!!this.getToken()}static getAuthHeader(){const t=this.getToken();return t?{Authorization:`Bearer ${t}`}:{}}}class Ze{constructor(t){be(this,"config");this.config={timeout:3e4,headers:{"Content-Type":"application/json"},...t}}buildQueryString(t){if(!t||Object.keys(t).length===0)return"";const r=new URLSearchParams;Object.entries(t).forEach(([i,o])=>{o!=null&&r.append(i,String(o))});const n=r.toString();return n?`?${n}`:""}async request(t,r={}){const{method:n="GET",headers:i={},body:o,params:l}=r,v=`${this.config.baseUrl}/${t}${this.buildQueryString(l)}`,u={...this.config.headers,...He.getAuthHeader(),...i},h={method:n,headers:u};o&&n!=="GET"&&(h.body=JSON.stringify(o));try{const x=new AbortController,j=setTimeout(()=>x.abort(),this.config.timeout),O=await fetch(v,{...h,signal:x.signal});if(clearTimeout(j),!O.ok){const D=await O.json().catch(()=>({message:O.statusText}));throw new Error(D.message||`HTTP ${O.status}`)}return await O.json()}catch(x){throw x instanceof Error?x:new Error("An unexpected error occurred")}}async get(t,r){return this.request(t,{method:"GET",params:r})}async post(t,r,n){return this.request(t,{method:"POST",body:r,params:n})}async put(t,r,n){return this.request(t,{method:"PUT",body:r,params:n})}async patch(t,r,n){return this.request(t,{method:"PATCH",body:r,params:n})}async delete(t,r){return this.request(t,{method:"DELETE",params:r})}setBaseUrl(t){this.config.baseUrl=t}getBaseUrl(){return this.config.baseUrl}}let je=null;function Et(f){return je=new Ze(f),je}function Me(){if(!je)throw new Error("API client not initialized. Call initializeApiClient() first.");return je}function et(f,t,r={}){const{enabled:n=!0,refetchOnMount:i=!0,onSuccess:o,onError:l}=r,[v,u]=b.useState(null),[h,x]=b.useState(n),[j,O]=b.useState(null),D=b.useCallback(async()=>{if(n){x(!0),O(null);try{const C=await Me().get(f,t);u(C),o==null||o(C)}catch(P){const C=P instanceof Error?P:new Error("Unknown error");O(C),l==null||l(C)}finally{x(!1)}}},[f,JSON.stringify(t),n,o,l]);return b.useEffect(()=>{i&&D()},[D,i]),{data:v,loading:h,error:j,refetch:D}}function St(f,t="POST",r={}){const{onSuccess:n,onError:i}=r,[o,l]=b.useState(null),[v,u]=b.useState(!1),[h,x]=b.useState(null),j=b.useCallback(async D=>{u(!0),x(null);try{const P=Me();let C;switch(t){case"POST":C=await P.post(f,D);break;case"PUT":C=await P.put(f,D);break;case"PATCH":C=await P.patch(f,D);break;case"DELETE":C=await P.delete(f);break;default:throw new Error(`Unsupported method: ${t}`)}return l(C),n==null||n(C,D),C}catch(P){const C=P instanceof Error?P:new Error("Unknown error");return x(C),i==null||i(C,D),null}finally{u(!1)}},[f,t,n,i]),O=b.useCallback(()=>{l(null),x(null),u(!1)},[]);return{data:o,loading:v,error:h,mutate:j,reset:O}}var De={exports:{}},ce={};/**
  * @license React
  * react-jsx-runtime.production.min.js
  *

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @qwanyx/stack
+ *
+ * All-in-one data management system for React applications
+ * Combines Graph API + REST API + UI components
+ *
+ * Like HyperCard, but with React instead of HyperTalk
+ */
+export { GraphClient } from './client/GraphClient';
+export { MailClient } from './client/MailClient';
+export { ApiClient, initializeApiClient, getApiClient } from './api/client';
+export { AuthManager } from './auth';
+export { useQuery } from './hooks/useQuery';
+export type { UseQueryOptions, UseQueryResult } from './hooks/useQuery';
+export { useMutation } from './hooks/useMutation';
+export type { UseMutationOptions, UseMutationResult } from './hooks/useMutation';
+export type { GraphNode, GraphEdge, GraphClientConfig, StackItem, StackConfig, StackContainerProps, StackContext, ViewContext, CardRenderer, ViewRenderer, Editor, EditorProps, StackTheme, LayoutMode, ApiConfig, ApiResponse, PaginationParams, SortParams, FilterParams, QueryParams, PaginatedResponse, HttpMethod, RequestOptions, MailClientConfig, MailServer, MailAccount, EmailMessage, MailListResult, ImapResponse, FolderInfo, APIResponse, } from './types';
+export { Stack } from './components/Stack';
+export type { StackProps } from './components/Stack';
+export { Card } from './components/Card';
+export type { CardProps } from './components/Card';
+export { Detail } from './components/Detail';
+export type { DetailProps } from './components/Detail';
+export { AnimatedCardFlip } from './components/AnimatedCardFlip';
+export type { AnimatedCardFlipProps, AnimatedCardFlipNode } from './components/AnimatedCardFlip';
+export { Mail } from './components/Mail';
+export type { MailProps, MailTheme, MailActions } from './components/Mail';
+export { DataOperations } from './operations';

package/dist/index.esm.js

@@ -135,11 +135,15 @@ class $t {
   }
   /**
    * Get edges from a source node
+   * @param sourceId - Source node ID (null for edges without source)
+   * @param edgeType - Optional edge type filter
+   * @param targetId - Optional target node ID for reverse lookups
    */
-  async getEdges(t, r) {
+  async getEdges(t, r, n) {
     return (await this.callGraph("get_edges", {
       source_id: t,
-      edge_type: r
+      edge_type: r,
+      target_id: n
     })).result || [];
   }
   // ===== HIERARCHY OPERATIONS =====
@@ -182,6 +186,14 @@ class $t {
       type: r
     })).nodes || [];
   }
+  /**
+   * Get all nodes of a specific type
+   */
+  async getNodesByType(t) {
+    return (await this.callGraph("get_nodes_by_type", {
+      type: t
+    })).result || [];
+  }
 }
 class Et {
   constructor(t) {
@@ -353,7 +365,7 @@ class Rt {
     return t ? { Authorization: `Bearer ${t}` } : {};
   }
 }
-class kt {
+class Tt {
   constructor(t) {
     _e(this, "config");
     this.config = {
@@ -456,14 +468,14 @@ class kt {
 }
 let Ee = null;
 function Dt(f) {
-  return Ee = new kt(f), Ee;
+  return Ee = new Tt(f), Ee;
 }
 function tt() {
   if (!Ee)
     throw new Error("API client not initialized. Call initializeApiClient() first.");
   return Ee;
 }
-function Tt(f, t, r = {}) {
+function kt(f, t, r = {}) {
   const {
     enabled: n = !0,
     refetchOnMount: i = !0,
@@ -597,10 +609,10 @@ function Nt() {
         A.unshift("Warning: " + a), Function.prototype.apply.call(console[e], console, A);
       }
     }
-    var V = !1, Q = !1, m = !1, T = !1, C = !1, p;
+    var V = !1, Q = !1, m = !1, k = !1, C = !1, p;
     p = Symbol.for("react.module.reference");
-    function k(e) {
-      return !!(typeof e == "string" || typeof e == "function" || e === n || e === o || C || e === i || e === h || e === x || T || e === $ || V || Q || m || typeof e == "object" && e !== null && (e.$$typeof === S || e.$$typeof === _ || e.$$typeof === l || e.$$typeof === v || e.$$typeof === d || // This needs to include all possible module reference object
+    function T(e) {
+      return !!(typeof e == "string" || typeof e == "function" || e === n || e === o || C || e === i || e === h || e === x || k || e === $ || V || Q || m || typeof e == "object" && e !== null && (e.$$typeof === S || e.$$typeof === _ || e.$$typeof === l || e.$$typeof === v || e.$$typeof === d || // This needs to include all possible module reference object
       // types supported by any Flight configuration anywhere since
       // we don't know which Flight build this will end up being used
       // with.
@@ -688,7 +700,7 @@ function Nt() {
         D++;
       }
     }
-    function ke() {
+    function Te() {
       {
         if (D--, D === 0) {
           var e = {
@@ -739,8 +751,8 @@ function Nt() {
     }
     var le = !1, ne;
     {
-      var Te = typeof WeakMap == "function" ? WeakMap : Map;
-      ne = new Te();
+      var ke = typeof WeakMap == "function" ? WeakMap : Map;
+      ne = new ke();
     }
     function be(e, a) {
       if (!e || le)
@@ -808,7 +820,7 @@ function Nt() {
             }
         }
       } finally {
-        le = !1, ie.current = A, ke(), Error.prepareStackTrace = O;
+        le = !1, ie.current = A, Te(), Error.prepareStackTrace = O;
       }
       var ae = e ? e.displayName || e.name : "", te = ae ? re(ae) : "";
       return typeof e == "function" && ne.set(e, te), te;
@@ -1107,7 +1119,7 @@ Check the top-level render call using <` + c + ">.");
     var Je = {};
     function Ke(e, a, c, y, O, A) {
       {
-        var R = k(e);
+        var R = T(e);
         if (!R) {
           var w = "";
           (e === void 0 || typeof e == "object" && e !== null && Object.keys(e).length === 0) && (w += " You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");
@@ -1263,15 +1275,15 @@ function It({
   onRefresh: $,
   theme: P = {}
 }) {
-  const { data: N, loading: H, error: z, refetch: g } = Tt(f, t), [I, V] = L(""), [Q, m] = L({}), [T, C] = L(1), p = et(() => {
+  const { data: N, loading: H, error: z, refetch: g } = kt(f, t), [I, V] = L(""), [Q, m] = L({}), [k, C] = L(1), p = et(() => {
     if (!N) return { data: [], total: 0, totalPages: 0 };
     let E = N;
-    return v && I && d.length > 0 && (E = Fe.search(E, I, d)), Object.keys(Q).length > 0 && (E = Fe.filterByFields(E, Q)), Fe.paginate(E, T, _);
-  }, [N, I, Q, T, _, v, d]);
+    return v && I && d.length > 0 && (E = Fe.search(E, I, d)), Object.keys(Q).length > 0 && (E = Fe.filterByFields(E, Q)), Fe.paginate(E, k, _);
+  }, [N, I, Q, k, _, v, d]);
   fe(() => {
     C(1);
   }, [I, Q]);
-  const k = () => {
+  const T = () => {
     V(""), m({}), C(1), g(), $ == null || $();
   }, j = {
     background: P.background || "#ffffff",
@@ -1303,7 +1315,7 @@ function It({
     /* @__PURE__ */ s.jsx(
       "button",
       {
-        onClick: k,
+        onClick: T,
         style: {
           marginTop: "16px",
           padding: "8px 16px",
@@ -1340,7 +1352,7 @@ function It({
         /* @__PURE__ */ s.jsx(
           "button",
           {
-            onClick: k,
+            onClick: T,
             style: {
               padding: "6px 12px",
               background: "transparent",
@@ -1411,7 +1423,7 @@ function It({
     }, children: [
       /* @__PURE__ */ s.jsxs("div", { style: { fontSize: "13px", color: j.textSecondary }, children: [
         "Page ",
-        T,
+        k,
         " of ",
         p.totalPages
       ] }),
@@ -1420,14 +1432,14 @@ function It({
           "button",
           {
             onClick: () => C((E) => Math.max(1, E - 1)),
-            disabled: T === 1,
+            disabled: k === 1,
             style: {
               padding: "6px 12px",
               border: `1px solid ${j.border}`,
               borderRadius: "6px",
               background: "white",
-              cursor: T === 1 ? "not-allowed" : "pointer",
-              opacity: T === 1 ? 0.5 : 1
+              cursor: k === 1 ? "not-allowed" : "pointer",
+              opacity: k === 1 ? 0.5 : 1
             },
             children: "Previous"
           }
@@ -1436,14 +1448,14 @@ function It({
           "button",
           {
             onClick: () => C((E) => Math.min(p.totalPages, E + 1)),
-            disabled: T === p.totalPages,
+            disabled: k === p.totalPages,
             style: {
               padding: "6px 12px",
               border: `1px solid ${j.border}`,
               borderRadius: "6px",
               background: "white",
-              cursor: T === p.totalPages ? "not-allowed" : "pointer",
-              opacity: T === p.totalPages ? 0.5 : 1
+              cursor: k === p.totalPages ? "not-allowed" : "pointer",
+              opacity: k === p.totalPages ? 0.5 : 1
             },
             children: "Next"
           }
@@ -1555,49 +1567,49 @@ function Bt({
   className: l = ""
 }) {
   const v = Math.min(Math.max(t, 1), 5), [d, h] = L([]), [x, _] = L([]), [S, $] = L(Array(v).fill(!1)), [P, N] = L(Array(v).fill(!1)), H = Xe([]), z = X((m) => {
-    const T = f.filter((p) => !m.includes(p._id));
-    if (T.length === 0) return null;
-    const C = Math.floor(Math.random() * T.length);
-    return T[C];
+    const k = f.filter((p) => !m.includes(p._id));
+    if (k.length === 0) return null;
+    const C = Math.floor(Math.random() * k.length);
+    return k[C];
   }, [f]), g = X(() => Math.random() * (n - r) + r, [r, n]);
   fe(() => {
     if (f.length === 0) {
       h([]), _([]);
       return;
     }
-    const m = [], T = [], C = [];
+    const m = [], k = [], C = [];
     for (let p = 0; p < v && p < f.length; p++) {
-      const k = z(C);
-      k && (m.push(k), C.push(k._id));
+      const T = z(C);
+      T && (m.push(T), C.push(T._id));
     }
     for (let p = 0; p < m.length; p++) {
-      const k = [
+      const T = [
         m[p]._id,
         ...m.filter((Z, U) => U !== p).map((Z) => Z._id)
-      ], j = z(k);
-      j ? T.push(j) : T.push(m[p]);
+      ], j = z(T);
+      j ? k.push(j) : k.push(m[p]);
     }
-    h(m), _(T);
+    h(m), _(k);
   }, [f, v, z]);
   const I = X((m) => {
-    const T = g(), C = setTimeout(() => {
+    const k = g(), C = setTimeout(() => {
       $((p) => {
-        const k = [...p];
-        return k[m] = !k[m], k;
+        const T = [...p];
+        return T[m] = !T[m], T;
       }), setTimeout(() => {
         N((p) => {
-          const k = [...p];
-          return k[m] = !k[m], k;
+          const T = [...p];
+          return T[m] = !T[m], T;
         }), setTimeout(() => {
           const p = !P[m];
-          p && h((k) => {
-            const j = [...k];
+          p && h((T) => {
+            const j = [...T];
             return j[m] = x[m], j;
-          }), _((k) => {
-            const j = [...k], U = [
+          }), _((T) => {
+            const j = [...T], U = [
               (p ? x[m] : d[m])._id,
               ...d.filter((D, Y) => Y !== m).map((D) => D._id),
-              ...k.filter((D, Y) => Y !== m).map((D) => D._id)
+              ...T.filter((D, Y) => Y !== m).map((D) => D._id)
             ], E = z(U);
             return E && (j[m] = E), j;
           }), setTimeout(() => {
@@ -1605,7 +1617,7 @@ function Bt({
           }, 150);
         }, 200);
       }, 150);
-    }, T);
+    }, k);
     H.current[m] = C;
   }, [g, z, d, x, P]), V = Xe(!1);
   fe(() => {
@@ -1621,8 +1633,8 @@ function Bt({
   const Q = (m) => {
     i && i(m);
   };
-  return f.length === 0 ? /* @__PURE__ */ s.jsx("div", { className: `flex items-center justify-center p-8 ${l}`, children: /* @__PURE__ */ s.jsx("p", { className: "text-gray-500", children: "No nodes available" }) }) : d.length === 0 ? /* @__PURE__ */ s.jsx("div", { className: `flex items-center justify-center p-8 ${l}`, children: /* @__PURE__ */ s.jsx("p", { className: "text-gray-500", children: "Loading..." }) }) : /* @__PURE__ */ s.jsx("div", { className: `flex gap-4 justify-center items-center flex-wrap ${l}`, children: d.map((m, T) => {
-    const C = x[T], p = P[T];
+  return f.length === 0 ? /* @__PURE__ */ s.jsx("div", { className: `flex items-center justify-center p-8 ${l}`, children: /* @__PURE__ */ s.jsx("p", { className: "text-gray-500", children: "No nodes available" }) }) : d.length === 0 ? /* @__PURE__ */ s.jsx("div", { className: `flex items-center justify-center p-8 ${l}`, children: /* @__PURE__ */ s.jsx("p", { className: "text-gray-500", children: "Loading..." }) }) : /* @__PURE__ */ s.jsx("div", { className: `flex gap-4 justify-center items-center flex-wrap ${l}`, children: d.map((m, k) => {
+    const C = x[k], p = P[k];
     return /* @__PURE__ */ s.jsx(
       "div",
       {
@@ -1634,7 +1646,7 @@ function Bt({
           {
             className: "w-full h-full rounded-lg shadow-lg overflow-hidden cursor-pointer hover:shadow-xl",
             style: {
-              transform: `rotateY(${S[T] ? 180 : 0}deg)`,
+              transform: `rotateY(${S[k] ? 180 : 0}deg)`,
               transition: "transform 0.5s",
               transformStyle: "preserve-3d"
             },
@@ -1650,7 +1662,7 @@ function Bt({
                     "div",
                     {
                       style: {
-                        transform: S[T] ? "scaleX(-1)" : "scaleX(1)",
+                        transform: S[k] ? "scaleX(-1)" : "scaleX(1)",
                         width: "100%",
                         height: "100%"
                       },
@@ -1680,7 +1692,7 @@ function Bt({
                     "div",
                     {
                       style: {
-                        transform: S[T] ? "scaleX(-1)" : "scaleX(1)",
+                        transform: S[k] ? "scaleX(-1)" : "scaleX(1)",
                         width: "100%",
                         height: "100%"
                       },
@@ -1703,7 +1715,7 @@ function Bt({
           }
         )
       },
-      `slot-${T}`
+      `slot-${k}`
     );
   }) });
 }
@@ -1759,7 +1771,7 @@ function Lt({
   renderLoading: H,
   theme: z = {}
 }) {
-  const g = { ...Pt, ...z }, [I, V] = L([]), [Q, m] = L(!1), [T, C] = L(null), [p, k] = L(/* @__PURE__ */ new Set()), [j, Z] = L(null), [U, E] = L(null), D = et(() => t ? new Et({ baseUrl: f, system_id: t }) : null, [f, t]), Y = X(async () => {
+  const g = { ...Pt, ...z }, [I, V] = L([]), [Q, m] = L(!1), [k, C] = L(null), [p, T] = L(/* @__PURE__ */ new Set()), [j, Z] = L(null), [U, E] = L(null), D = et(() => t ? new Et({ baseUrl: f, system_id: t }) : null, [f, t]), Y = X(async () => {
     if (D) {
       m(!0), C(null);
       try {
@@ -1788,9 +1800,9 @@ function Lt({
     const W = u.uid;
     if (B.shiftKey && j !== null) {
       const ee = Math.min(j, b), J = Math.max(j, b), Ne = I.slice(ee, J + 1).map((ce) => ce.uid), we = new Set(Ne);
-      k(we), h == null || h(Array.from(we));
+      T(we), h == null || h(Array.from(we));
     } else if (B.ctrlKey || B.metaKey)
-      k((ee) => {
+      T((ee) => {
         const J = new Set(ee);
         return J.has(W) ? J.delete(W) : J.add(W), h == null || h(Array.from(J)), J;
       }), Z(b);
@@ -1798,7 +1810,7 @@ function Lt({
       d == null || d(u), o && E(u);
     else {
       const ee = /* @__PURE__ */ new Set([W]);
-      k(ee), Z(b), h == null || h(Array.from(ee));
+      T(ee), Z(b), h == null || h(Array.from(ee));
     }
   }, [i, j, I, p, d, h, o]), he = X(async () => {
     if (!(!D || p.size === 0))
@@ -1807,7 +1819,7 @@ function Lt({
         if (console.log("Trash result:", u), u.success && u.moved > 0) {
           V((B) => B.filter((W) => !p.has(W.uid)));
           const b = Array.from(p);
-          k(/* @__PURE__ */ new Set()), x == null || x(b);
+          T(/* @__PURE__ */ new Set()), x == null || x(b);
         } else
           C("Failed to move emails to trash");
       } catch (u) {
@@ -1821,7 +1833,7 @@ function Lt({
         if (console.log("Archive result:", u), u.success && u.archived > 0) {
           V((B) => B.filter((W) => !p.has(W.uid)));
           const b = Array.from(p);
-          k(/* @__PURE__ */ new Set()), x == null || x(b);
+          T(/* @__PURE__ */ new Set()), x == null || x(b);
         } else
           C("Failed to archive emails");
       } catch (u) {
@@ -1830,13 +1842,13 @@ function Lt({
       }
   }, [D, r, p, x, _]), ye = X(() => {
     if (p.size === I.length)
-      k(/* @__PURE__ */ new Set()), h == null || h([]);
+      T(/* @__PURE__ */ new Set()), h == null || h([]);
     else {
       const u = new Set(I.map((b) => b.uid));
-      k(u), h == null || h(Array.from(u));
+      T(u), h == null || h(Array.from(u));
     }
   }, [I, p.size, h]), xe = X(() => {
-    k(/* @__PURE__ */ new Set()), h == null || h([]);
+    T(/* @__PURE__ */ new Set()), h == null || h([]);
   }, [h]), me = {
     delete: he,
     archive: ge,
@@ -1878,7 +1890,7 @@ function Lt({
       color: g.textSecondary,
       flexShrink: 0
     }, children: ve(u.date) })
-  ] }) }), ke = (u) => /* @__PURE__ */ s.jsxs("div", { style: { padding: "24px" }, children: [
+  ] }) }), Te = (u) => /* @__PURE__ */ s.jsxs("div", { style: { padding: "24px" }, children: [
     /* @__PURE__ */ s.jsx("h2", { style: { margin: "0 0 8px", fontSize: "20px", color: g.text }, children: je(u.subject) || "(No subject)" }),
     /* @__PURE__ */ s.jsxs("div", { style: { fontSize: "14px", color: g.textSecondary, marginBottom: "16px" }, children: [
       "From: ",
@@ -1986,7 +1998,7 @@ function Lt({
     padding: "48px",
     textAlign: "center",
     color: g.textSecondary
-  }, children: "Loading..." }), le = S || Re, ne = $ || ke, Te = P || ie, be = N || oe, Se = H || re;
+  }, children: "Loading..." }), le = S || Re, ne = $ || Te, ke = P || ie, be = N || oe, Se = H || re;
   return Q && I.length === 0 ? /* @__PURE__ */ s.jsx("div", { style: { background: g.background, width: "100%", height: "100%" }, children: Se() }) : /* @__PURE__ */ s.jsxs("div", { style: { display: "flex", background: g.background, width: "100%", height: "100%" }, children: [
     /* @__PURE__ */ s.jsxs("div", { style: {
       flex: o && U ? "0 0 50%" : "1",
@@ -1995,14 +2007,14 @@ function Lt({
       borderRight: o && U ? `1px solid ${g.border}` : "none",
       overflow: "hidden"
     }, children: [
-      i && Te(Array.from(p), me),
-      T && /* @__PURE__ */ s.jsx("div", { style: {
+      i && ke(Array.from(p), me),
+      k && /* @__PURE__ */ s.jsx("div", { style: {
         padding: "12px 16px",
         background: "#fef2f2",
         color: g.danger,
         fontSize: "14px",
         borderBottom: `1px solid ${g.border}`
-      }, children: T }),
+      }, children: k }),
       /* @__PURE__ */ s.jsx("div", { style: { flex: 1, overflowY: "auto" }, children: I.length === 0 ? be() : I.map((u, b) => /* @__PURE__ */ s.jsx(
         "div",
         {
@@ -2017,7 +2029,7 @@ function Lt({
 }
 export {
   Bt as AnimatedCardFlip,
-  kt as ApiClient,
+  Tt as ApiClient,
   Rt as AuthManager,
   Mt as Card,
   Fe as DataOperations,
@@ -2029,5 +2041,5 @@ export {
   tt as getApiClient,
   Dt as initializeApiClient,
   Ft as useMutation,
-  Tt as useQuery
+  kt as useQuery
 };

package/dist/operations/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Operations Layer
+ * Client-side data manipulation utilities
+ */
+export declare class DataOperations {
+    /**
+     * Filter array by predicate function
+     */
+    static filter<T>(items: T[], predicate: (item: T) => boolean): T[];
+    /**
+     * Filter by field value
+     */
+    static filterBy<T>(items: T[], field: keyof T, value: any): T[];
+    /**
+     * Filter by multiple fields
+     */
+    static filterByFields<T>(items: T[], filters: Partial<T>): T[];
+    /**
+     * Sort array by field
+     */
+    static sort<T>(items: T[], field: keyof T, order?: 'asc' | 'desc'): T[];
+    /**
+     * Search items by query string in specified fields
+     */
+    static search<T>(items: T[], query: string, fields: (keyof T)[]): T[];
+    /**
+     * Paginate array
+     */
+    static paginate<T>(items: T[], page: number, limit: number): {
+        data: T[];
+        total: number;
+        page: number;
+        totalPages: number;
+    };
+    /**
+     * Group items by field value
+     */
+    static groupBy<T>(items: T[], field: keyof T): Record<string, T[]>;
+    /**
+     * Get unique values for a field
+     */
+    static unique<T>(items: T[], field: keyof T): any[];
+    /**
+     * Count items by field value
+     */
+    static countBy<T>(items: T[], field: keyof T): Record<string, number>;
+    /**
+     * Apply multiple operations in sequence
+     */
+    static pipe<T>(items: T[], operations: Array<(items: T[]) => T[]>): T[];
+}

package/dist/types/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * TypeScript type definitions for Qwanyx Stack
+ */
+import { ReactNode } from 'react';
+export interface GraphNode {
+    _id: string;
+    p?: string | null;
+    type: string;
+    title?: string;
+    description?: string;
+    icon?: string;
+    editor?: string;
+    hidden?: boolean;
+    archive?: boolean;
+    data?: Record<string, any>;
+    created?: string;
+    modified?: string;
+    creator?: string;
+    owner?: string;
+    owner_group?: string | null;
+    permissions?: number;
+    acl?: string;
+}
+export interface GraphEdge {
+    source_id: string | null;
+    target_id: string;
+    edge_type: string;
+    data?: Record<string, any>;
+    created: number;
+    modified?: number;
+}
+export type StackItem = GraphNode;
+export interface StackContext {
+    apiUrl?: string;
+    systemId?: string;
+    onNavigate?: (item: StackItem) => void;
+}
+export interface ViewContext {
+    onBack?: () => void;
+    onEdit?: () => void;
+    onDelete?: () => void;
+    onOpenChat?: (nodeId: string) => void;
+    apiUrl?: string;
+    userId?: string;
+    graphClient?: any;
+}
+export type CardRenderer = (item: StackItem, context?: StackContext) => ReactNode;
+export type ViewRenderer = (item: StackItem, context?: ViewContext) => ReactNode;
+export interface EditorProps {
+    item?: StackItem;
+    graphClient: any;
+    onSave: (item: StackItem) => void;
+    onCancel: () => void;
+    onDelete?: () => void;
+    apiUrl?: string;
+    systemId?: string;
+}
+export type Editor = React.ComponentType<EditorProps>;
+export interface StackConfig {
+    id: string;
+    name?: string;
+    system_id: string;
+    parentId?: string;
+    displayMode?: 'children' | 'edges' | 'both';
+    maxWidth?: string;
+    minWidth?: string;
+    cardRenderer?: CardRenderer;
+    viewRenderer?: ViewRenderer;
+    items?: StackItem[];
+    loadItems?: () => Promise<StackItem[]>;
+    metadata?: {
+        hidden?: boolean;
+        archive?: boolean;
+        originalNode?: any;
+        isSelected?: boolean;
+    };
+    onNavigate?: (item: StackItem) => void;
+    onAdd?: () => void;
+    onAddRequest?: (data: any) => Promise<void>;
+    systemMessage?: {
+        type: 'error' | 'warning' | 'info' | 'success';
+        message: string;
+        details?: string;
+    };
+}
+export interface StackProps {
+    config: StackConfig;
+    onItemClick?: (item: StackItem) => void;
+    onClose?: () => void;
+    onClick?: (event: React.MouseEvent) => void;
+    style?: React.CSSProperties;
+    currentView?: StackItem | null;
+    viewNode?: any;
+    onCloseView?: () => void;
+    onAdd?: () => void;
+    theme?: StackTheme;
+    apiUrl?: string;
+    userId?: string;
+    onCreateColumn?: (item: StackItem, direction: 'left' | 'right') => void;
+}
+export interface StackTheme {
+    primary?: string;
+    surface?: string;
+    surfaceHover?: string;
+    muted?: string;
+    text?: string;
+    textMuted?: string;
+    success?: string;
+    error?: string;
+}
+export interface StackContainerProps {
+    stacks: StackConfig[];
+    defaultViewMode?: 'side' | 'fullscreen' | 'modal';
+    maxStacks?: number;
+    stackSpacing?: string;
+    containerPadding?: string;
+    onStackClose?: (stackId: string) => void;
+    onStackOpen?: (config: StackConfig) => void;
+    style?: React.CSSProperties;
+}
+export type LayoutMode = 'list' | 'grid' | 'masonry';
+export interface GraphClientConfig {
+    baseUrl: string;
+    system_id: string;
+}
+export interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    result?: T;
+    error?: string;
+}
+export interface ApiConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface ApiResponse<T = any> {
+    data: T;
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface SortParams {
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface FilterParams {
+    [key: string]: any;
+}
+export interface QueryParams extends PaginationParams, SortParams, FilterParams {
+}
+export interface PaginatedResponse<T = any> {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RequestOptions {
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    body?: any;
+    params?: QueryParams;
+}
+export interface MailClientConfig {
+    baseUrl: string;
+    system_id: string;
+}
+export interface MailServer {
+    host: string;
+    port: string;
+    user: string;
+    password: string;
+}
+export interface MailAccount {
+    id: string;
+    label: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    signature?: string;
+    imap: MailServer;
+    smtp: MailServer;
+}
+export interface EmailMessage {
+    uid: number;
+    subject: string;
+    from: string;
+    date: string;
+    seen: boolean;
+}
+export interface MailListResult {
+    account: {
+        id: string;
+        label: string;
+        email: string;
+    };
+    mailbox: {
+        name: string;
+        total: number;
+    };
+    messages: EmailMessage[];
+}
+export interface ImapResponse {
+    ok: boolean;
+    command: string;
+    error?: string;
+    mailbox?: string;
+    exists?: number;
+    recent?: number;
+    unseen?: number;
+    folders?: FolderInfo[];
+    uid?: string;
+}
+export interface FolderInfo {
+    name: string;
+    delimiter: string | null;
+    attributes: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwanyx/stack",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "description": "Modern HyperCard for React - All-in-one data management (REST + Graph API + Auth + Hooks + UI)",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",