@arcanejs/toolkit 8.0.0 → 9.0.0

package/dist/{toolkit-BPqxbDbk.d.mts → toolkit-GNytD78y.d.mts}

@@ -4,10 +4,115 @@ import _ from 'lodash';
 import * as http from 'http';
 import { Application } from 'express';
 import { WebSocket } from 'ws';
-import { ClientMessage, ServerMessage, BaseComponentProto, AnyClientComponentMessage, AnyClientComponentCall, ReturnForPair } from '@arcanejs/protocol';
+import { BaseComponentProto, AnyClientComponentMessage, AnyClientComponentCall, AnyClientComponentCallUpload, AnyClientComponentCallDownload, ReturnForPair, ClientMessage, ServerMessage, BaseNotificationMessage } from '@arcanejs/protocol';
+import { Readable } from 'node:stream';
+import { I as IDMap } from './id-map-DxQ3_gyA.mjs';
 import * as proto from '@arcanejs/protocol/core';
 import { GroupComponentStyle } from '@arcanejs/protocol/styles';
-import { I as IDMap } from './id-map-DxQ3_gyA.mjs';
+
+type CallUploadResponse = (data: Readable) => Promise<void>;
+type CallDownloadResponse = () => Promise<{
+    stream: Readable;
+    headers: Record<string, string>;
+}>;
+declare abstract class Base<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, Props, CallPairs = any, CallActions extends string & keyof CallPairs = any> {
+    /** @hidden */
+    private parent;
+    /** @hidden */
+    private readonly defaultProps;
+    /** @hidden */
+    private _props;
+    /** @hidden */
+    private _onPropsUpdated;
+    constructor(defaultProps: Props, props?: Partial<Props>, options?: {
+        onPropsUpdated?: (oldProps: Props) => void;
+    });
+    /**
+     * Call if
+     */
+    triggerInitialPropsUpdate: () => void;
+    log: () => Logger | null;
+    get props(): Props;
+    set props(props: Partial<Props>);
+    setProps: (props: Partial<Props>) => void;
+    updateProps: (updates: Partial<Props>) => void;
+    /** @hidden */
+    setParent(parent: Parent | null): void;
+    /** @hidden */
+    updateTree(): void;
+    /** @hidden */
+    abstract getProtoInfo(idMap: IDMap, context: ToolkitRenderContext): Proto;
+    /** @hidden */
+    handleMessage(_message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
+    /** @hidden */
+    handleAnyCall(message: AnyClientComponentCall | AnyClientComponentCallUpload | AnyClientComponentCallDownload, _connection: ToolkitConnection): Promise<ReturnForPair<CallPairs, CallActions> | CallUploadResponse | CallDownloadResponse>;
+    /** @hidden */
+    handleCall(_call: AnyClientComponentCall, _connection: ToolkitConnection): Promise<ReturnForPair<CallPairs, CallActions>>;
+    /** @hidden */
+    handleCallUpload(_call: AnyClientComponentCallUpload, _connection: ToolkitConnection): Promise<CallUploadResponse>;
+    /** @hidden */
+    handleCallDownload(_call: AnyClientComponentCallDownload, _connection: ToolkitConnection): Promise<CallDownloadResponse>;
+    routeMessage(_idMap: IDMap, _message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
+    routeCall(_idMap: IDMap, _call: AnyClientComponentCall | AnyClientComponentCallUpload | AnyClientComponentCallDownload, _connection: ToolkitConnection, _callbacks: {
+        resolve: (result: unknown) => void;
+        reject: (error: unknown) => void;
+    }): void;
+}
+type AnyComponent = Base<string, BaseComponentProto<string, string>, any>;
+/** @hidden */
+interface Parent {
+    updateTree(): void;
+    removeChild(component: AnyComponent): void;
+    log(): Logger | null;
+}
+declare abstract class BaseParent<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, T, CallPairs = any, CallActions extends string & keyof CallPairs = any> extends Base<Namespace, Proto, T, CallPairs, CallActions> implements Parent {
+    /** @hidden */
+    private children;
+    abstract validateChildren(children: AnyComponent[]): void;
+    appendChildren: <CS extends AnyComponent[]>(...children: CS) => CS;
+    appendChild: <C extends AnyComponent>(child: C) => C;
+    removeChild: (component: AnyComponent) => void;
+    removeAllChildren: () => void;
+    /**
+     * Return all children components that messages need to be routed to
+     */
+    getChildren: () => readonly AnyComponent[];
+    /**
+     * TODO: we can do this better, right now it broadcasts the message to all
+     * components of the tree
+     *
+     * @hidden
+     */
+    routeMessage(idMap: IDMap, message: AnyClientComponentMessage, connection: ToolkitConnection): void;
+    routeCall(idMap: IDMap, call: AnyClientComponentCall | AnyClientComponentCallUpload | AnyClientComponentCallDownload, connection: ToolkitConnection, callbacks: {
+        resolve: (result: unknown) => void;
+        reject: (error: unknown) => void;
+    }): Promise<void>;
+    insertBefore(child: AnyComponent, beforeChild: AnyComponent): void;
+}
+interface Listenable<Map extends Record<string, (...args: any[]) => void>> {
+    addListener<T extends keyof Map>(type: T, listener: Map[T]): void;
+    removeListener<T extends keyof Map>(type: T, listener: Map[T]): void;
+}
+declare class EventEmitter<Map extends Record<string, (...args: any[]) => void>> implements Listenable<Map> {
+    private readonly listeners;
+    addListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
+    removeListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
+    emit: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>[]>;
+    /**
+     * Like {@link emit},
+     * but ensures only a single listener exists and returns its result.
+     */
+    call: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>>;
+    /**
+     * Process prop changes to update listeners
+     */
+    processPropChanges: <Mapping extends Record<string, keyof Map>, Props extends { [key in keyof Mapping]?: Map[Mapping[key]] | null | undefined; }>(
+    /**
+     * Mapping from prop key to event name
+     */
+    mapping: Mapping, oldProps: Props, newProps: Props) => void;
+}
 
 interface Connection {
     sendMessage(msg: ServerMessage): void;
@@ -17,12 +122,14 @@ declare class Server<TAdditionalFiles extends ToolkitAdditionalFiles = Record<ne
     private readonly onNewConnection;
     private readonly onClosedConnection;
     private readonly onMessage;
+    private readonly onUpload;
+    private readonly onDownload;
     private readonly log?;
     private staticFiles;
     private htmlContext;
     private staticFilesInitPromise;
     private readonly title;
-    constructor(options: ToolkitOptions<TAdditionalFiles>, onNewConnection: (connection: Connection) => void, onClosedConnection: (connection: Connection) => void, onMessage: (connection: Connection, message: ClientMessage) => void, log?: Logger | undefined);
+    constructor(options: ToolkitOptions<TAdditionalFiles>, onNewConnection: (connection: Connection) => void, onClosedConnection: (connection: Connection) => void, onMessage: (connection: Connection, message: ClientMessage) => void, onUpload: (id: string, data: Readable) => Promise<void>, onDownload: (id: string) => Promise<CallDownloadResponse>, log?: Logger | undefined);
     private getEntrypointPaths;
     private fileExists;
     private ensureStaticFilesInitialized;
@@ -147,95 +254,6 @@ type InitializationOptions<TAdditionalFiles extends ToolkitAdditionalFiles = Rec
     setup: (server: Server<TAdditionalFiles>) => void;
 };
 
-declare abstract class Base<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, Props, CallPairs = any, CallActions extends string & keyof CallPairs = any> {
-    /** @hidden */
-    private parent;
-    /** @hidden */
-    private readonly defaultProps;
-    /** @hidden */
-    private _props;
-    /** @hidden */
-    private _onPropsUpdated;
-    constructor(defaultProps: Props, props?: Partial<Props>, options?: {
-        onPropsUpdated?: (oldProps: Props) => void;
-    });
-    /**
-     * Call if
-     */
-    triggerInitialPropsUpdate: () => void;
-    log: () => Logger | null;
-    get props(): Props;
-    set props(props: Partial<Props>);
-    setProps: (props: Partial<Props>) => void;
-    updateProps: (updates: Partial<Props>) => void;
-    /** @hidden */
-    setParent(parent: Parent | null): void;
-    /** @hidden */
-    updateTree(): void;
-    /** @hidden */
-    abstract getProtoInfo(idMap: IDMap, context: ToolkitRenderContext): Proto;
-    /** @hidden */
-    handleMessage(_message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
-    /** @hidden */
-    handleCall(_call: AnyClientComponentCall, _connection: ToolkitConnection): Promise<ReturnForPair<CallPairs, CallActions>>;
-    routeMessage(_idMap: IDMap, _message: AnyClientComponentMessage, _connection: ToolkitConnection): void;
-    routeCall(_idMap: IDMap, _call: AnyClientComponentCall, _connection: ToolkitConnection, _callbacks: {
-        resolve: (result: unknown) => void;
-        reject: (error: unknown) => void;
-    }): void;
-}
-type AnyComponent = Base<string, BaseComponentProto<string, string>, any>;
-/** @hidden */
-interface Parent {
-    updateTree(): void;
-    removeChild(component: AnyComponent): void;
-    log(): Logger | null;
-}
-declare abstract class BaseParent<Namespace extends string, Proto extends BaseComponentProto<Namespace, string>, T, CallPairs = any, CallActions extends string & keyof CallPairs = any> extends Base<Namespace, Proto, T, CallPairs, CallActions> implements Parent {
-    /** @hidden */
-    private children;
-    abstract validateChildren(children: AnyComponent[]): void;
-    appendChildren: <CS extends AnyComponent[]>(...children: CS) => CS;
-    appendChild: <C extends AnyComponent>(child: C) => C;
-    removeChild: (component: AnyComponent) => void;
-    removeAllChildren: () => void;
-    /**
-     * Return all children components that messages need to be routed to
-     */
-    getChildren: () => readonly AnyComponent[];
-    /**
-     * TODO: we can do this better, right now it broadcasts the message to all
-     * components of the tree
-     *
-     * @hidden
-     */
-    routeMessage(idMap: IDMap, message: AnyClientComponentMessage, connection: ToolkitConnection): void;
-    routeCall(idMap: IDMap, call: AnyClientComponentCall, connection: ToolkitConnection, callbacks: {
-        resolve: (result: unknown) => void;
-        reject: (error: unknown) => void;
-    }): Promise<void>;
-    insertBefore(child: AnyComponent, beforeChild: AnyComponent): void;
-}
-interface Listenable<Map extends Record<string, (...args: any[]) => void>> {
-    addListener<T extends keyof Map>(type: T, listener: Map[T]): void;
-    removeListener<T extends keyof Map>(type: T, listener: Map[T]): void;
-}
-declare class EventEmitter<Map extends Record<string, (...args: any[]) => void>> implements Listenable<Map> {
-    private readonly listeners;
-    addListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
-    removeListener: <T extends keyof Map>(type: T, listener: Map[T]) => void;
-    emit: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>[]>;
-    /**
-     * Like {@link emit},
-     * but ensures only a single listener exists and returns its result.
-     */
-    call: <T extends keyof Map>(type: T, ...args: Parameters<Map[T]>) => Promise<ReturnType<Map[T]>>;
-    /**
-     * Process prop changes to update listeners
-     */
-    processPropChanges: <Mapping extends Record<string, keyof Map>, Props extends { [key in keyof Mapping]?: Map[Mapping[key]] | null | undefined; }>(mapping: Mapping, oldProps: Props, newProps: Props) => void;
-}
-
 type Events$2 = {
     click: (connection: ToolkitConnection) => void | Promise<void>;
 };
@@ -338,6 +356,8 @@ declare class Toolkit<TAdditionalFiles extends ToolkitAdditionalFiles = Record<n
     /** @hidden */
     private readonly events;
     private readonly server;
+    private readonly uploads;
+    private readonly downloads;
     constructor(options?: Partial<ToolkitOptions<TAdditionalFiles>>);
     addListener: <T extends keyof Events>(type: T, listener: Events[T]) => void;
     removeListener: <T extends keyof Events>(type: T, listener: Events[T]) => void;
@@ -352,6 +372,9 @@ declare class Toolkit<TAdditionalFiles extends ToolkitAdditionalFiles = Record<n
     private onClosedConnection;
     private handleCall;
     private onMessage;
+    private onUpload;
+    private onDownload;
+    sendNotification: (notification: BaseNotificationMessage<string, string>, filter?: (connection: ToolkitConnection) => boolean) => void;
 }
 
-export { type AnyComponent as A, Button as B, EventEmitter as E, Group as G, type InternalProps$1 as I, type Listenable as L, type Parent as P, Toolkit as T, type ToolkitConnection as a, type ToolkitRenderContext as b, type ToolkitServerListenerOptions as c, type ToolkitServerListener as d, type ToolkitAdditionalFiles as e, type ToolkitClockSyncOptions as f, type ToolkitCoreAssetRelativePath as g, type ToolkitHtmlPageContext as h, type ToolkitOptions as i, type ToolkitStaticFile as j, type ToolkitStaticFileResolver as k, GroupHeader as l, Base as m, BaseParent as n, type Events$2 as o, type ButtonMode as p, type Props$1 as q, type Events$1 as r, type InternalProps as s, type Props as t };
+export { type AnyComponent as A, Button as B, type CallUploadResponse as C, EventEmitter as E, Group as G, type InternalProps$1 as I, type Listenable as L, type Parent as P, Toolkit as T, type ToolkitConnection as a, type ToolkitRenderContext as b, type ToolkitServerListenerOptions as c, type ToolkitServerListener as d, type ToolkitAdditionalFiles as e, type ToolkitClockSyncOptions as f, type ToolkitCoreAssetRelativePath as g, type ToolkitHtmlPageContext as h, type ToolkitOptions as i, type ToolkitStaticFile as j, type ToolkitStaticFileResolver as k, GroupHeader as l, Base as m, BaseParent as n, type CallDownloadResponse as o, type Events$2 as p, type ButtonMode as q, type Props$1 as r, type Events$1 as s, type InternalProps as t, type Props as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcanejs/toolkit",
-  "version": "8.0.0",
+  "version": "9.0.0",
   "private": false,
   "description": "Build web-accessible control interfaces for your long-running Node.js processes",
   "keywords": [
@@ -111,11 +111,11 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tsup": "^8.1.0",
-    "typescript": "^5.3.3",
+    "typescript": "^5.7",
     "@arcanejs/eslint-config": "^0.0.0",
-    "@arcanejs/toolkit-frontend": "^0.11.0",
-    "@arcanejs/typescript-config": "^0.0.0",
-    "@arcanejs/build-utils": "^0.1.2"
+    "@arcanejs/toolkit-frontend": "^0.12.0",
+    "@arcanejs/build-utils": "^0.1.2",
+    "@arcanejs/typescript-config": "^0.0.0"
   },
   "dependencies": {
     "escape-html": "^1.0.3",
@@ -124,13 +124,13 @@
     "material-symbols": "^0.25.0",
     "uuid": "^11.0.3",
     "ws": "^8.18.0",
-    "@arcanejs/diff": "^0.5.2",
-    "@arcanejs/protocol": "^0.8.0"
+    "@arcanejs/diff": "^0.6.0",
+    "@arcanejs/protocol": "^0.9.0"
   },
   "peerDependencies": {
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "@arcanejs/toolkit-frontend": "^0.11.0"
+    "@arcanejs/toolkit-frontend": "^0.12.0"
   },
   "peerDependenciesMeta": {
     "@arcanejs/toolkit-frontend": {