@hypen-space/core 0.4.3 → 0.4.5

package/dist/remote/server.d.ts

@@ -1,31 +1,31 @@
 /**
  * RemoteServer - Stream Hypen apps over WebSocket with Session Management
  *
- * Usage:
+ * Usage with inline UI:
  * ```typescript
  * import { RemoteServer, app } from "@hypen-space/core";
  *
  * const counter = app
  *   .defineState({ count: 0 })
  *   .onAction("increment", ({ state }) => state.count++)
- *   .onDisconnect(async ({ state, session }) => {
- *     await redis.set(`session:${session.id}`, JSON.stringify(state));
- *   })
- *   .onReconnect(async ({ session, restore }) => {
- *     const saved = await redis.get(`session:${session.id}`);
- *     if (saved) restore(JSON.parse(saved));
- *   })
- *   .onExpire(async ({ session }) => {
- *     await redis.del(`session:${session.id}`);
- *   })
  *   .build();
  *
  * new RemoteServer()
  *   .module("Counter", counter)
  *   .ui(`Column { Text("Count: \${state.count}") }`)
- *   .session({ ttl: 3600, concurrent: "kick-old" })
  *   .listen(3000);
  * ```
+ *
+ * Usage with directory-based discovery (auto-resolves imports):
+ * ```typescript
+ * import { RemoteServer } from "@hypen-space/core";
+ * import chatModule from "./apps/chat/Chat/component.js";
+ *
+ * await new RemoteServer()
+ *   .source("./apps/chat")
+ *   .module("Chat", chatModule)
+ *   .listen(3001);
+ * ```
  */
 import type { HypenModule } from "../app.js";
 import type { RemoteMessage, RemoteClient, RemoteServerConfig, SessionConfig } from "./types.js";
@@ -36,6 +36,8 @@ export declare class RemoteServer {
     private _module;
     private _moduleName;
     private _ui;
+    private _sourceDir;
+    private _discoveredComponents;
     private _config;
     private _sessionConfig;
     private _onConnectionCallbacks;
@@ -52,6 +54,22 @@ export declare class RemoteServer {
      * Set the UI DSL string
      */
     ui(dsl: string): this;
+    /**
+     * Set a source directory for automatic component discovery.
+     *
+     * All .hypen and .ts components in the directory (and subdirectories) are
+     * discovered automatically. The entry component's template is used as the
+     * UI, so calling .ui() is optional when .source() is set.
+     *
+     * @example
+     * ```typescript
+     * new RemoteServer()
+     *   .source("./apps/chat")
+     *   .module("Chat", chatModule)
+     *   .listen(3001);
+     * ```
+     */
+    source(dir: string): this;
     /**
      * Set server configuration
      */
@@ -71,7 +89,7 @@ export declare class RemoteServer {
     /**
      * Start the WebSocket server
      */
-    listen(port?: number): this;
+    listen(port?: number): Promise<this>;
     /**
      * Stop the server
      */
@@ -80,6 +98,18 @@ export declare class RemoteServer {
      * Get the server URL
      */
     get url(): string | null;
+    /**
+     * Discover components from the source directory.
+     * Populates _discoveredComponents and sets _ui from the entry component
+     * if not already set via .ui().
+     */
+    private discoverFromSource;
+    /**
+     * Set up a component resolver on a client engine so that imports
+     * and component references in templates are resolved from discovered
+     * components.
+     */
+    private setupComponentResolver;
     /**
      * Handle new WebSocket connection
      * Waits for hello message before fully initializing
@@ -133,10 +163,11 @@ export declare class RemoteServer {
 export declare function serve(options: {
     module: HypenModule<any>;
     moduleName?: string;
-    ui: string;
+    ui?: string;
+    source?: string;
     port?: number;
     hostname?: string;
     session?: SessionConfig;
     onConnection?: (client: RemoteClient) => void;
     onDisconnection?: (client: RemoteClient) => void;
-}): RemoteServer;
+}): Promise<RemoteServer>;