@nextclaw/remote 0.1.76 → 0.1.78

package/dist/index.d.ts

@@ -1,236 +1,245 @@
-import { Config } from '@nextclaw/core';
-import { Command } from 'commander';
+import { Config } from "@nextclaw/core";
+import { Command } from "commander";
 
+//#region src/types.d.ts
 type RemoteConnectCommandOptions = {
-    apiBase?: string;
-    localOrigin?: string;
-    name?: string;
-    once?: boolean;
+  apiBase?: string;
+  localOrigin?: string;
+  name?: string;
+  once?: boolean;
 };
 type RemoteEnableCommandOptions = {
-    apiBase?: string;
-    name?: string;
+  apiBase?: string;
+  name?: string;
 };
 type RemoteStatusCommandOptions = {
-    json?: boolean;
+  json?: boolean;
 };
 type RemoteDoctorCommandOptions = {
-    json?: boolean;
+  json?: boolean;
 };
 type RemoteRuntimeState = {
-    enabled: boolean;
-    mode: "service" | "foreground";
-    state: "disabled" | "connecting" | "connected" | "disconnected" | "error";
-    deviceId?: string;
-    deviceName?: string;
-    platformBase?: string;
-    localOrigin?: string;
-    lastConnectedAt?: string | null;
-    lastError?: string | null;
-    updatedAt: string;
+  enabled: boolean;
+  mode: "service" | "foreground";
+  state: "disabled" | "connecting" | "connected" | "disconnected" | "error";
+  deviceId?: string;
+  deviceName?: string;
+  platformBase?: string;
+  localOrigin?: string;
+  lastConnectedAt?: string | null;
+  lastError?: string | null;
+  updatedAt: string;
 };
 type RemoteStatusSnapshot = {
-    configuredEnabled: boolean;
-    runtime: RemoteRuntimeState | null;
+  configuredEnabled: boolean;
+  runtime: RemoteRuntimeState | null;
 };
 type RemoteLogger = {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
+  info: (message: string) => void;
+  warn: (message: string) => void;
+  error: (message: string) => void;
 };
 type RemoteServiceStateView = {
-    pid: number;
-    uiPort?: number;
+  pid: number;
+  uiPort?: number;
 };
 type RegisteredRemoteDevice = {
-    id: string;
-    deviceInstallId: string;
-    displayName: string;
-    platform: string;
-    appVersion: string;
-    localOrigin: string;
-    status: "online" | "offline";
-    lastSeenAt: string;
-    createdAt: string;
-    updatedAt: string;
+  id: string;
+  deviceInstallId: string;
+  displayName: string;
+  platform: string;
+  appVersion: string;
+  localOrigin: string;
+  status: "online" | "offline";
+  lastSeenAt: string;
+  createdAt: string;
+  updatedAt: string;
 };
 type RemoteStatusWriter = {
-    write: (next: Omit<RemoteRuntimeState, "mode" | "updatedAt">) => void;
+  write: (next: Omit<RemoteRuntimeState, "mode" | "updatedAt">) => void;
 };
 type RemoteConnectorRunOptions = RemoteConnectCommandOptions & {
-    signal?: AbortSignal;
-    mode?: "foreground" | "service";
-    autoReconnect?: boolean;
-    statusStore?: RemoteStatusWriter;
+  signal?: AbortSignal;
+  mode?: "foreground" | "service";
+  autoReconnect?: boolean;
+  statusStore?: RemoteStatusWriter;
 };
 type RemoteRunContext = {
-    config: Config;
-    platformBase: string;
-    token: string;
-    localOrigin: string;
-    displayName: string;
-    deviceInstallId: string;
-    autoReconnect: boolean;
+  config: Config;
+  platformBase: string;
+  token: string;
+  localOrigin: string;
+  displayName: string;
+  deviceInstallId: string;
+  autoReconnect: boolean;
 };
 type RemotePlatformClientDeps = {
-    loadConfig: () => Config;
-    getDataDir: () => string;
-    getPackageVersion: () => string;
-    resolvePlatformBase: (rawApiBase: string) => string;
-    readManagedServiceState?: () => RemoteServiceStateView | null;
-    isProcessRunning?: (pid: number) => boolean;
-};
-
+  loadConfig: () => Config;
+  getDataDir: () => string;
+  getPackageVersion: () => string;
+  resolvePlatformBase: (rawApiBase: string) => string;
+  readManagedServiceState?: () => RemoteServiceStateView | null;
+  isProcessRunning?: (pid: number) => boolean;
+};
+//#endregion
+//#region src/register-remote-commands.d.ts
 type RemoteCommandRuntime = {
-    enable: (opts?: RemoteEnableCommandOptions) => Promise<void>;
-    disable: () => Promise<void>;
-    status: (opts?: RemoteStatusCommandOptions) => Promise<void>;
-    doctor: (opts?: RemoteDoctorCommandOptions) => Promise<void>;
-    connect: (opts?: RemoteConnectCommandOptions) => Promise<void>;
+  enable: (opts?: RemoteEnableCommandOptions) => Promise<void>;
+  disable: () => Promise<void>;
+  status: (opts?: RemoteStatusCommandOptions) => Promise<void>;
+  doctor: (opts?: RemoteDoctorCommandOptions) => Promise<void>;
+  connect: (opts?: RemoteConnectCommandOptions) => Promise<void>;
 };
 declare function registerRemoteCommands(program: Command, runtime: RemoteCommandRuntime): void;
-
+//#endregion
+//#region src/remote-runtime-actions.d.ts
 type RemoteConfigChange = {
-    changed: boolean;
-    config: Config;
+  changed: boolean;
+  config: Config;
 };
 type RemoteCommandDriver = {
-    connect: (opts?: RemoteConnectCommandOptions) => Promise<void>;
-    enableConfig: (opts?: RemoteEnableCommandOptions) => RemoteConfigChange;
-    disableConfig: () => RemoteConfigChange;
-    status: (opts?: RemoteStatusCommandOptions) => Promise<void>;
-    doctor: (opts?: RemoteDoctorCommandOptions) => Promise<void>;
+  connect: (opts?: RemoteConnectCommandOptions) => Promise<void>;
+  enableConfig: (opts?: RemoteEnableCommandOptions) => RemoteConfigChange;
+  disableConfig: () => RemoteConfigChange;
+  status: (opts?: RemoteStatusCommandOptions) => Promise<void>;
+  doctor: (opts?: RemoteDoctorCommandOptions) => Promise<void>;
 };
 declare class RemoteRuntimeActions {
-    private readonly deps;
-    constructor(deps: {
-        appName: string;
-        initAuto: (source: string) => Promise<void>;
-        remoteCommands: RemoteCommandDriver;
-        restartBackgroundService: (reason: string) => Promise<boolean>;
-        hasRunningManagedService: () => boolean;
-    });
-    connect(opts?: RemoteConnectCommandOptions): Promise<void>;
-    enable(opts?: RemoteEnableCommandOptions): Promise<void>;
-    disable(): Promise<void>;
-    status(opts?: RemoteStatusCommandOptions): Promise<void>;
-    doctor(opts?: RemoteDoctorCommandOptions): Promise<void>;
+  private readonly deps;
+  constructor(deps: {
+    appName: string;
+    initAuto: (source: string) => Promise<void>;
+    remoteCommands: RemoteCommandDriver;
+    restartBackgroundService: (reason: string) => Promise<boolean>;
+    hasRunningManagedService: () => boolean;
+  });
+  connect(opts?: RemoteConnectCommandOptions): Promise<void>;
+  enable(opts?: RemoteEnableCommandOptions): Promise<void>;
+  disable(): Promise<void>;
+  status(opts?: RemoteStatusCommandOptions): Promise<void>;
+  doctor(opts?: RemoteDoctorCommandOptions): Promise<void>;
 }
-
+//#endregion
+//#region src/remote-platform-client.d.ts
 declare function normalizeOptionalString(value: unknown): string | undefined;
 declare function delay(ms: number, signal?: AbortSignal): Promise<void>;
 declare function redactWsUrl(url: string): string;
 declare class RemotePlatformClient {
-    private readonly deps;
-    constructor(deps: RemotePlatformClientDeps);
-    private get remoteDir();
-    private get devicePath();
-    resolveRunContext(opts: RemoteConnectorRunOptions): RemoteRunContext;
-    registerDevice(params: {
-        platformBase: string;
-        token: string;
-        deviceInstallId: string;
-        displayName: string;
-        localOrigin: string;
-    }): Promise<RegisteredRemoteDevice>;
-    private ensureDeviceInstallId;
-    private resolvePlatformAccess;
-    private resolveLocalOrigin;
-    private resolveDisplayName;
+  private readonly deps;
+  constructor(deps: RemotePlatformClientDeps);
+  private get remoteDir();
+  private get devicePath();
+  resolveRunContext(opts: RemoteConnectorRunOptions): RemoteRunContext;
+  registerDevice(params: {
+    platformBase: string;
+    token: string;
+    deviceInstallId: string;
+    displayName: string;
+    localOrigin: string;
+  }): Promise<RegisteredRemoteDevice>;
+  private ensureDeviceInstallId;
+  private resolvePlatformAccess;
+  private resolveLocalOrigin;
+  private resolveDisplayName;
 }
-
+//#endregion
+//#region src/remote-relay-bridge.d.ts
 type RelayRequestFrame = {
-    type: "request";
-    requestId: string;
-    method: string;
-    path: string;
-    headers: Array<[string, string]>;
-    bodyBase64?: string;
+  type: "request";
+  requestId: string;
+  method: string;
+  path: string;
+  headers: Array<[string, string]>;
+  bodyBase64?: string;
 };
 declare class RemoteRelayBridge {
-    private readonly localOrigin;
-    constructor(localOrigin: string);
-    ensureLocalUiHealthy(): Promise<void>;
-    forward(frame: RelayRequestFrame, socket: WebSocket): Promise<void>;
-    private createForwardHeaders;
-    requestBridgeCookie(): Promise<string | null>;
-    private sendStreamingResponse;
+  private readonly localOrigin;
+  constructor(localOrigin: string);
+  ensureLocalUiHealthy(): Promise<void>;
+  forward(frame: RelayRequestFrame, socket: WebSocket): Promise<void>;
+  private createForwardHeaders;
+  requestBridgeCookie(): Promise<string | null>;
+  private sendStreamingResponse;
 }
-
+//#endregion
+//#region src/remote-connector.d.ts
 declare class RemoteConnector {
-    private readonly deps;
-    constructor(deps: {
-        platformClient: RemotePlatformClient;
-        relayBridgeFactory?: (localOrigin: string) => RemoteRelayBridge;
-        logger?: RemoteLogger;
-        createSocket?: (wsUrl: string) => WebSocket;
-        delayFn?: typeof delay;
-        random?: () => number;
-    });
-    private get logger();
-    private get delayFn();
-    private get random();
-    private createSocket;
-    private connectOnce;
-    private handleSocketMessage;
-    private parseRelayFrame;
-    private ensureDevice;
-    private writeRemoteState;
-    private runCycle;
-    run(opts?: RemoteConnectorRunOptions): Promise<void>;
+  private readonly deps;
+  constructor(deps: {
+    platformClient: RemotePlatformClient;
+    relayBridgeFactory?: (localOrigin: string) => RemoteRelayBridge;
+    logger?: RemoteLogger;
+    createSocket?: (wsUrl: string) => WebSocket;
+    delayFn?: typeof delay;
+    random?: () => number;
+  });
+  private get logger();
+  private get delayFn();
+  private get random();
+  private createSocket;
+  private connectOnce;
+  private handleSocketMessage;
+  private parseRelayFrame;
+  private ensureDevice;
+  private writeRemoteState;
+  private runCycle;
+  run(opts?: RemoteConnectorRunOptions): Promise<void>;
 }
-
+//#endregion
+//#region src/remote-status-store.d.ts
 declare function buildConfiguredRemoteState(config: Config): RemoteRuntimeState;
 declare function resolveRemoteStatusSnapshot(params: {
-    config: Config;
-    currentRemoteState?: RemoteRuntimeState | null;
-    fallbackDeviceName?: string;
+  config: Config;
+  currentRemoteState?: RemoteRuntimeState | null;
+  fallbackDeviceName?: string;
 }): RemoteStatusSnapshot;
 declare class RemoteStatusStore implements RemoteStatusWriter {
-    private readonly mode;
-    private readonly deps;
-    constructor(mode: RemoteRuntimeState["mode"], deps: {
-        writeRemoteState: (next: RemoteRuntimeState) => void;
-    });
-    write(next: Omit<RemoteRuntimeState, "mode" | "updatedAt">): void;
+  private readonly mode;
+  private readonly deps;
+  constructor(mode: RemoteRuntimeState["mode"], deps: {
+    writeRemoteState: (next: RemoteRuntimeState) => void;
+  });
+  write(next: Omit<RemoteRuntimeState, "mode" | "updatedAt">): void;
 }
-
+//#endregion
+//#region src/remote-service-module.d.ts
 declare class RemoteServiceModule {
-    private readonly deps;
-    private abortController;
-    private runTask;
-    private releaseOwnership;
-    constructor(deps: {
-        loadConfig: () => Config;
-        uiEnabled: boolean;
-        localOrigin: string;
-        statusStore: RemoteStatusWriter;
-        createConnector: (logger: RemoteLogger) => RemoteConnector;
-        claimOwnership?: () => {
-            ok: true;
-            release: () => void;
-        } | {
-            ok: false;
-            error: string;
-        };
-        logger?: RemoteLogger;
-    });
-    start(): Promise<void> | null;
-    restart(): Promise<void>;
-    stop(): Promise<void>;
+  private readonly deps;
+  private abortController;
+  private runTask;
+  private releaseOwnership;
+  constructor(deps: {
+    loadConfig: () => Config;
+    uiEnabled: boolean;
+    localOrigin: string;
+    statusStore: RemoteStatusWriter;
+    createConnector: (logger: RemoteLogger) => RemoteConnector;
+    claimOwnership?: () => {
+      ok: true;
+      release: () => void;
+    } | {
+      ok: false;
+      error: string;
+    };
+    logger?: RemoteLogger;
+  });
+  start(): Promise<void> | null;
+  restart(): Promise<void>;
+  stop(): Promise<void>;
 }
-
+//#endregion
+//#region src/platform-session-token.d.ts
 type PlatformSessionTokenState = {
-    valid: false;
-    reason: "missing" | "malformed" | "expired";
-    payload: Record<string, unknown> | null;
+  valid: false;
+  reason: "missing" | "malformed" | "expired";
+  payload: Record<string, unknown> | null;
 } | {
-    valid: true;
-    reason: "valid";
-    payload: Record<string, unknown>;
+  valid: true;
+  reason: "valid";
+  payload: Record<string, unknown>;
 };
 declare function decodePlatformSessionTokenPayload(token: string): Record<string, unknown> | null;
 declare function readPlatformSessionTokenState(token: string | null | undefined): PlatformSessionTokenState;
 declare function isValidPlatformSessionToken(token: string | null | undefined): token is string;
-
-export { type PlatformSessionTokenState, type RegisteredRemoteDevice, type RelayRequestFrame, type RemoteConnectCommandOptions, RemoteConnector, type RemoteConnectorRunOptions, type RemoteDoctorCommandOptions, type RemoteEnableCommandOptions, type RemoteLogger, RemotePlatformClient, type RemotePlatformClientDeps, RemoteRelayBridge, type RemoteRunContext, RemoteRuntimeActions, type RemoteRuntimeState, RemoteServiceModule, type RemoteServiceStateView, type RemoteStatusCommandOptions, type RemoteStatusSnapshot, RemoteStatusStore, type RemoteStatusWriter, buildConfiguredRemoteState, decodePlatformSessionTokenPayload, delay, isValidPlatformSessionToken, normalizeOptionalString, readPlatformSessionTokenState, redactWsUrl, registerRemoteCommands, resolveRemoteStatusSnapshot };
+//#endregion
+export { PlatformSessionTokenState, RegisteredRemoteDevice, RelayRequestFrame, RemoteConnectCommandOptions, RemoteConnector, RemoteConnectorRunOptions, RemoteDoctorCommandOptions, RemoteEnableCommandOptions, RemoteLogger, RemotePlatformClient, RemotePlatformClientDeps, RemoteRelayBridge, RemoteRunContext, RemoteRuntimeActions, RemoteRuntimeState, RemoteServiceModule, RemoteServiceStateView, RemoteStatusCommandOptions, RemoteStatusSnapshot, RemoteStatusStore, RemoteStatusWriter, buildConfiguredRemoteState, decodePlatformSessionTokenPayload, delay, isValidPlatformSessionToken, normalizeOptionalString, readPlatformSessionTokenState, redactWsUrl, registerRemoteCommands, resolveRemoteStatusSnapshot };