@blue-soda/dsh-remote 0.4.28

package/dist/cli.js

@@ -0,0 +1,289 @@
+import { stat } from 'node:fs/promises';
+import { hostname } from 'node:os';
+import { join } from 'node:path';
+import { DEFAULT_REMOTE_SERVER_URL, normalizeServerUrl } from './config.js';
+import { IdentityStore, serverStorageDirectory, } from './identity-store.js';
+import { ENABLED_QR_PROVIDERS, HostServerApi, ServerApiError, isEnabledQrProvider, oauthProviderName, } from './server-api.js';
+import { ServerCredentialStore } from './server-credentials.js';
+const QR_POLL_INTERVAL_MS = 2_000;
+const TERMINAL_QR_MARGIN = 4;
+/** TUI-friendly account bootstrap. Configuration remains owned by the DSH profile. */
+export async function runCli(args = process.argv.slice(2), dependencies = {}) {
+    const runtime = resolveDependencies(dependencies);
+    const [command, ...rest] = args;
+    try {
+        if (command === 'login')
+            return await login(rest, runtime);
+        if (command === 'register')
+            return await register(rest, runtime);
+        if (command === 'status')
+            return await status(rest, runtime);
+        if (command === 'logout')
+            return await logout(rest, runtime);
+        if (command === 'help' || command === '--help' || command === '-h' || command === undefined) {
+            write(runtime.stdout, helpText());
+            return 0;
+        }
+        throw new CliUsageError(`Unknown command: ${command}`);
+    }
+    catch (error) {
+        write(runtime.stderr, `${cliErrorMessage(error)}\n`);
+        if (error instanceof CliUsageError)
+            write(runtime.stderr, `\n${helpText()}`);
+        return error instanceof CliUsageError ? 2 : 1;
+    }
+}
+async function register(args, runtime) {
+    if (args.length !== 1 || args[0] === undefined || args[0].trim() === '') {
+        throw new CliUsageError('Usage: ds-harness-remote register <server-token>');
+    }
+    const context = await hostContext(runtime);
+    await context.api.authorizeHostWithCode(context.identity, args[0]);
+    write(runtime.stdout, 'Remote Host registration complete. Restart dsh-tui to bring the Remote Host online.\n');
+    return 0;
+}
+async function login(args, runtime) {
+    const usage = `Usage: ds-harness-remote login [${ENABLED_QR_PROVIDERS.join('|')}]`;
+    if (args.length > 1)
+        throw new CliUsageError(usage);
+    const provider = args[0] ?? ENABLED_QR_PROVIDERS[0] ?? 'wechat';
+    if (!isEnabledQrProvider(provider)) {
+        throw new CliUsageError(`Login provider must be one of: ${ENABLED_QR_PROVIDERS.join(', ')}.`);
+    }
+    const context = await hostContext(runtime);
+    const session = await context.api.startOAuthQrLogin(provider);
+    const qr = await runtime.renderQr(session.scanUrl);
+    const providerName = oauthProviderName(provider);
+    write(runtime.stdout, `Using ${providerName} QR login. ${alternativeProviderHint(provider)}\n`);
+    write(runtime.stdout, 'Scan this QR code to authorize this Host:\n\n');
+    write(runtime.stdout, `${qr.trimEnd()}\n`);
+    write(runtime.stdout, `Authorization URL: ${terminalLink(session.scanUrl, runtime.stdout)}\n\nWaiting for authorization...\n`);
+    const deadline = runtime.now() + session.expiresIn * 1_000;
+    let identity = context.identity;
+    while (runtime.now() < deadline) {
+        let result;
+        try {
+            result = await context.api.pollOAuthQrLogin(identity, session.qrId, async () => {
+                identity = await context.identities.reset(context.deviceName);
+                return identity;
+            });
+        }
+        catch (error) {
+            if (!(error instanceof ServerApiError) || !error.retryable)
+                throw error;
+            await runtime.wait(Math.min(QR_POLL_INTERVAL_MS, Math.max(1, deadline - runtime.now())));
+            continue;
+        }
+        if (result.status === 'complete') {
+            write(runtime.stdout, `${authorizedMessage(result.authorization)} Restart dsh-tui to bring the Remote Host online.\n`);
+            return 0;
+        }
+        if (result.status === 'expired')
+            break;
+        await runtime.wait(Math.min(QR_POLL_INTERVAL_MS, Math.max(1, deadline - runtime.now())));
+    }
+    write(runtime.stderr, 'The QR login expired. Run the login command again to generate a new code.\n');
+    return 1;
+}
+async function status(args, runtime) {
+    if (args.length !== 0)
+        throw new CliUsageError('Usage: ds-harness-remote status');
+    const serverUrl = selectedServer();
+    const root = new IdentityStore({ env: runtime.env }).directory;
+    const directory = serverStorageDirectory(root, serverUrl, 'host');
+    const lines = [
+        'Remote Host status',
+        `Server: ${serverUrl}`,
+        'Host control: enabled (dsh-TUI default)',
+    ];
+    if (!await exists(join(directory, 'device.json'))) {
+        lines.push('Device: not initialized', 'Authorization: logged out', 'Credential: unavailable');
+        write(runtime.stdout, `${lines.join('\n')}\n\nRun "ds-harness-remote login" or use "/remote login" in dsh-TUI.\n`);
+        return 0;
+    }
+    const identities = runtime.createIdentityStore({ directory, env: runtime.env });
+    const identity = await identities.loadOrCreate(hostname());
+    const store = new ServerCredentialStore(directory);
+    const stored = await store.load(serverUrl, identity.deviceId);
+    lines.push(`Device: ${identity.name} (${identity.deviceId})`);
+    if (stored === undefined) {
+        lines.push('Authorization: logged out', 'Credential: unavailable');
+        write(runtime.stdout, `${lines.join('\n')}\n\nRun "ds-harness-remote login" or use "/remote login" in dsh-TUI.\n`);
+        return 0;
+    }
+    lines.push(`Authorization: logged in (${authorizationLabel(stored.authorizationMethod)})`);
+    if (stored.account !== undefined)
+        lines.push(`Account: ${stored.account}`);
+    const api = runtime.createHostApi(serverUrl, store);
+    api.bindIdentity(identity);
+    try {
+        await api.authenticate(identity);
+        lines.push('Credential: ready');
+        lines.push('Presence: published while dsh-tui is running');
+        write(runtime.stdout, `${lines.join('\n')}\n`);
+        return 0;
+    }
+    catch (error) {
+        lines.push(`Credential: unavailable (${statusErrorCode(error)})`);
+        write(runtime.stdout, `${lines.join('\n')}\n`);
+        return 1;
+    }
+}
+async function logout(args, runtime) {
+    if (args.length !== 0)
+        throw new CliUsageError('Usage: ds-harness-remote logout');
+    const serverUrl = selectedServer();
+    const root = new IdentityStore({ env: runtime.env }).directory;
+    const directory = serverStorageDirectory(root, serverUrl, 'host');
+    if (!await exists(join(directory, 'device.json'))) {
+        await new ServerCredentialStore(directory).clear();
+        write(runtime.stdout, 'This Host is already logged out.\n');
+        return 0;
+    }
+    const deviceName = hostname();
+    const identities = runtime.createIdentityStore({ directory, env: runtime.env });
+    await identities.loadOrCreate(deviceName);
+    // Clear the credentials and keep the device identity. Revoking and rotating
+    // would register a second device for this installation on the next login, and
+    // an account holds at most 256 devices. Signing in again reuses this device and
+    // the Server invalidates the previous tokens at that point.
+    await new ServerCredentialStore(directory).clear();
+    write(runtime.stdout, 'Remote Host logged out. This device stays registered and is reused on the next login. Restart dsh-tui.\n');
+    return 0;
+}
+async function hostContext(runtime) {
+    const serverUrl = selectedServer();
+    const root = new IdentityStore({ env: runtime.env }).directory;
+    const directory = serverStorageDirectory(root, serverUrl, 'host');
+    const deviceName = hostname();
+    const identities = runtime.createIdentityStore({ directory, env: runtime.env });
+    const identity = await identities.loadOrCreate(deviceName);
+    const api = runtime.createHostApi(serverUrl, new ServerCredentialStore(directory));
+    return { api, identities, identity, deviceName };
+}
+function selectedServer() {
+    return normalizeServerUrl(DEFAULT_REMOTE_SERVER_URL);
+}
+function resolveDependencies(input) {
+    return {
+        env: input.env ?? process.env,
+        stdout: input.stdout ?? process.stdout,
+        stderr: input.stderr ?? process.stderr,
+        now: input.now ?? Date.now,
+        wait: input.wait ?? (milliseconds => new Promise(resolve => setTimeout(resolve, milliseconds))),
+        renderQr: input.renderQr ?? renderTerminalQr,
+        createIdentityStore: input.createIdentityStore ?? (options => new IdentityStore(options)),
+        createHostApi: input.createHostApi ?? ((serverUrl, store) => new HostServerApi(serverUrl, store)),
+    };
+}
+export async function renderTerminalQr(url) {
+    // Keep the terminal-only renderer off the Host plugin startup path. The
+    // built-in compact renderer has only a one-module quiet zone and relies on
+    // half-height glyphs, which is difficult for phone cameras to recognize in
+    // some terminal profiles. Render square modules with an explicit standard
+    // four-module quiet zone instead.
+    const { default: QRCode } = await import('qrcode');
+    const modules = QRCode.create(url, { errorCorrectionLevel: 'M' }).modules;
+    const width = modules.size + TERMINAL_QR_MARGIN * 2;
+    const quietLine = `\u001B[47m${' '.repeat(width * 2)}\u001B[0m`;
+    const lines = Array.from({ length: TERMINAL_QR_MARGIN }, () => quietLine);
+    for (let row = 0; row < modules.size; row += 1) {
+        let line = `\u001B[47m${' '.repeat(TERMINAL_QR_MARGIN * 2)}`;
+        for (let column = 0; column < modules.size; column += 1) {
+            line += modules.get(row, column) === 1 ? '\u001B[40m  ' : '\u001B[47m  ';
+        }
+        line += `\u001B[47m${' '.repeat(TERMINAL_QR_MARGIN * 2)}\u001B[0m`;
+        lines.push(line);
+    }
+    lines.push(...Array.from({ length: TERMINAL_QR_MARGIN }, () => quietLine));
+    return lines.join('\n');
+}
+/** Square terminal modules at half the row count for fullscreen TUI scenes. */
+export async function renderCompactTerminalQr(url) {
+    const { default: QRCode } = await import('qrcode');
+    const modules = QRCode.create(url, { errorCorrectionLevel: 'M' }).modules;
+    const size = modules.size + TERMINAL_QR_MARGIN * 2;
+    const lines = [];
+    const isBlack = (row, column) => {
+        const qrRow = row - TERMINAL_QR_MARGIN;
+        const qrColumn = column - TERMINAL_QR_MARGIN;
+        return qrRow >= 0 && qrRow < modules.size
+            && qrColumn >= 0 && qrColumn < modules.size
+            && modules.get(qrRow, qrColumn) === 1;
+    };
+    for (let row = 0; row < size; row += 2) {
+        let line = '\u001B[30;47m';
+        for (let column = 0; column < size; column += 1) {
+            const top = isBlack(row, column);
+            const bottom = isBlack(row + 1, column);
+            line += top ? bottom ? '█' : '▀' : bottom ? '▄' : ' ';
+        }
+        lines.push(`${line}\u001B[0m`);
+    }
+    return lines.join('\n');
+}
+function authorizedMessage(authorization) {
+    return authorization.account === undefined
+        ? 'Remote Host login complete.'
+        : `Remote Host login complete for ${authorization.account}.`;
+}
+function alternativeProviderHint(provider) {
+    const alternatives = ENABLED_QR_PROVIDERS.filter(candidate => candidate !== provider);
+    if (alternatives.length === 0)
+        return '';
+    return `Also supported: ${alternatives.map(candidate => `ds-harness-remote login ${candidate}`).join(', ')}`;
+}
+function authorizationLabel(method) {
+    if (method === 'host_registration_code')
+        return 'Host registration code';
+    if (method === 'owned_device')
+        return 'owned device';
+    return 'account';
+}
+function statusErrorCode(error) {
+    return error instanceof ServerApiError ? error.code : 'CONNECTION_FAILED';
+}
+function cliErrorMessage(error) {
+    const message = error instanceof Error ? error.message : 'The Remote command failed.';
+    const code = error instanceof Error && 'code' in error && typeof error.code === 'string'
+        ? error.code
+        : undefined;
+    return code === undefined ? message : `${message} (${code})`;
+}
+function helpText() {
+    return [
+        'Usage:',
+        '  ds-harness-remote login [github|zhihu]',
+        '  ds-harness-remote register <server-token>',
+        '  ds-harness-remote status',
+        '  ds-harness-remote logout',
+        '',
+        'Inside dsh-TUI, use /remote login, /remote status, or /remote logout.',
+        'login defaults to Zhihu and authorizes this computer as a Remote Host with a terminal QR code.',
+        `The Server is ${DEFAULT_REMOTE_SERVER_URL}.`,
+        'Host configuration is not exposed by this CLI yet. Restart dsh-tui after login or logout.',
+        '',
+    ].join('\n');
+}
+function write(target, value) {
+    target.write(value);
+}
+function terminalLink(url, target) {
+    if (target.isTTY !== true)
+        return url;
+    return `\u001B]8;;${url}\u0007${url}\u001B]8;;\u0007`;
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+class CliUsageError extends Error {
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client-runtime.d.ts

@@ -0,0 +1,239 @@
+import type { ApiProxy, RpcResult } from '@deepseek-ai/dsh-host-apiproxy/api';
+import type { CodexAppFrameData, CodexAppStreamClosedData } from '@dsh-remote/protocol';
+import { RemoteClientCore } from '@dsh-remote/client-core';
+import { type RtcPeerConnectionFactory } from '@dsh-remote/webrtc';
+import { type HarnessMode } from './api-proxy-switch.js';
+import type { ResolvedConfig } from './config.js';
+import { type HostWebServerLike } from './control-route.js';
+import type { IdentityStore } from './identity-store.js';
+import type { TypertGatewayLike } from './typert-gateway-contract.js';
+import type { SafeLogger } from './logging.js';
+import { type CodexVirtualWorkspaceView } from './codex/virtual-harness.js';
+import { ClientServerApi, type OAuthProvider } from './server-api.js';
+import { type WeriftFactoryOptions } from './werift-rtc.js';
+export interface RemoteHostFeatures {
+    commandList: boolean;
+    fileViewer: boolean;
+    terminal: boolean;
+    apiProxy: boolean;
+    remoteGateway: boolean;
+    sessionFormat?: 3;
+    codex: boolean;
+}
+export interface RemoteDirectoryEntry {
+    name: string;
+    path: string;
+    hidden: boolean;
+}
+export interface RemoteDirectoryListing {
+    path: string;
+    home: string;
+    crumbs: RemoteDirectoryEntry[];
+    entries: RemoteDirectoryEntry[];
+    truncated: boolean;
+}
+export interface RemoteWorkspaceView {
+    workspaceId: string;
+    path: string;
+    title: string;
+}
+export interface RemoteDeviceView {
+    deviceId: string;
+    name: string;
+    platform: string;
+    membershipId: string;
+    online: boolean;
+    lastSeenAt?: number;
+    clientVersion?: string;
+    harnessVersion?: string;
+}
+export interface HostConnectionRpc {
+    handle(channel: string, handler: (endpoint: string, payload: unknown, signal: AbortSignal) => Promise<RpcResult<unknown>>, options: {
+        authority: 'loopback' | 'trusted-host';
+    }): () => Promise<void>;
+}
+export interface HostConnectionHandle {
+    requestRejection?(request: {
+        headers: Record<string, string | string[] | undefined>;
+    }): number | undefined;
+    rpc: HostConnectionRpc;
+}
+export interface HostAuthorizationControl {
+    setTerminalEnabled?(enabled: boolean): void;
+    setLoopbackPorts?(ports: readonly number[]): void;
+    hostStatus(): {
+        deviceId?: string;
+        configured: boolean;
+        online: boolean;
+        reconnecting: boolean;
+        lastActiveAt?: number;
+        error?: string;
+        account?: string;
+        authorized: boolean;
+        accountRequired: boolean;
+        /** Whether the user asked this machine to stay unreachable while signed in. */
+        paused?: boolean;
+        connectedClients?: Array<{
+            deviceId: string;
+            name: string;
+            platform?: string;
+            mode?: 'LAN' | 'P2P' | 'TURN' | 'Relay';
+        }>;
+    };
+    hasStoredAuthorization?(): Promise<boolean>;
+    reconnectHost(): void;
+    /** Stop being reachable without releasing the authorization. */
+    pauseHostConnection?(): Promise<void>;
+    /** Resume with the same credentials and device identity. */
+    resumeHostConnection?(): Promise<void>;
+    clearHostAuthorization(): Promise<void>;
+    localHarnessVersion?(): string | undefined;
+    authorizeHostAsOwned(accessToken: string, account?: string): Promise<unknown>;
+    authorizeHostWithAccount(email: string, password: string): Promise<unknown>;
+    authorizeHostWithCode(code: string): Promise<unknown>;
+    codexStatus?(): {
+        available: boolean;
+    };
+    codexCall?(input: unknown, signal?: AbortSignal): Promise<unknown>;
+    codexRespond?(input: unknown, signal?: AbortSignal): Promise<{
+        resolved: true;
+    }>;
+    codexOpenStream?(input: unknown, publish: (event: 'codex.app.frame' | 'codex.app.stream.closed', data: CodexAppFrameData | CodexAppStreamClosedData) => Promise<void>, signal?: AbortSignal): Promise<unknown>;
+    codexCloseStream?(input: unknown): Promise<unknown>;
+}
+export declare class ClientModeRuntime {
+    private readonly config;
+    private readonly identities;
+    private readonly server;
+    private readonly logger;
+    private readonly host?;
+    private readonly rtcFactoryProvider;
+    private preview?;
+    private identity?;
+    private connected?;
+    /**
+     * Set when a remote session dropped and the runtime fell back to local.
+     *
+     * The mode then reads 'local', which is what every "return to local" control is
+     * gated on, so without this the user is left in a stale remote view with no way
+     * back except signing out.
+     */
+    private fellBackToLocal;
+    /**
+     * Identifies the live reconnect loop.
+     *
+     * A dropped transport starts one; anything else that settles the connection —
+     * the user returning to local, a logout, a fresh connect — bumps it so the loop
+     * stops instead of fighting the newer decision.
+     */
+    private remoteReconnectRun;
+    private pendingWorkspaceSelection?;
+    private codexVirtual?;
+    private readonly proxySwitch?;
+    private readonly gatewaySwitch;
+    private readonly codexStreams;
+    private connectionProgress?;
+    private connectionProgressRun;
+    private closed;
+    constructor(config: ResolvedConfig, identities: IdentityStore, server: ClientServerApi, apiProxy: ApiProxy | undefined, typertGateway: TypertGatewayLike, logger: SafeLogger, host?: HostAuthorizationControl | undefined, rtcFactoryProvider?: (options?: WeriftFactoryOptions) => Promise<RtcPeerConnectionFactory | undefined>);
+    start(): Promise<void>;
+    /**
+     * Whether this installation already holds stored Server credentials for its
+     * Client identity.
+     *
+     * This is the local answer to "is this installation signed in", available
+     * without contacting the Server, so the UI can choose its panel immediately
+     * instead of inferring the answer from a failed network round trip.
+     */
+    hasStoredAuthorization(): Promise<boolean>;
+    authorizeHostByDefault(): Promise<void>;
+    registerControl(connection: HostConnectionHandle, webServer?: HostWebServerLike): () => Promise<void>;
+    status(): Record<string, unknown>;
+    private closePreview;
+    private detailedStatus;
+    devices(): Promise<RemoteDeviceView[]>;
+    /**
+     * Device discovery is exposed through the local app control route. When this
+     * installation also runs a Host, keep that route closed after the Host's
+     * Server credential has become terminally invalid. The Client credential can
+     * remain usable for a short time after a revoke, so checking only
+     * `ClientServerApi.listDevices()` would otherwise leak the device directory
+     * from a Host that the user has already been told to re-authorize.
+     */
+    private assertHostAuthorizationForDeviceDiscovery;
+    authorizeClientWithAccount(email: string, password: string): Promise<unknown>;
+    startClientOAuthQrLogin(provider: OAuthProvider): Promise<unknown>;
+    pollClientOAuthQrLogin(qrId: string): Promise<unknown>;
+    /**
+     * Stop this Client from being authorized, keeping its device identity.
+     *
+     * The device is deliberately *not* revoked and the identity is deliberately
+     * *not* rotated. Signing out used to revoke the device, which forced a new
+     * identity on the next sign-in and registered a second device for the same
+     * installation; an account holds at most 256 devices, so signing out often
+     * enough could exhaust it. Keeping the row also means the next sign-in reuses
+     * it, and the server invalidates the previous tokens at that point.
+     *
+     * The cost, by choice: while signed out the device stays in the account and
+     * its old tokens stay valid until the next sign-in or their expiry, so signing
+     * out is no longer a way to cut a leaked token off immediately. Removing the
+     * device for good is an operator action on the server's state file.
+     */
+    clearClientAuthorization(): Promise<void>;
+    setHostAuthorization(enabled: boolean): Promise<unknown>;
+    setMode(mode: HarnessMode, targetDeviceId?: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /**
+     * Re-establish a remote session whose transport closed.
+     *
+     * The UI keeps rendering the remote session after the transport is gone, so
+     * without this the user faces a session that silently ignores everything and has
+     * to exit and pick the Host again — which is what a suspended and resumed client
+     * used to require every time. Retry the same Host with backoff; a loop that is
+     * superseded, or one whose session came back another way, stops quietly.
+     * @param targetDeviceId - the Host the dropped session was bound to.
+     */
+    private reconnectRemoteSession;
+    listRemoteDirectory(targetDeviceId: string, path?: string, signal?: AbortSignal): Promise<RemoteDirectoryListing>;
+    listRemoteWorkspaces(targetDeviceId: string, signal?: AbortSignal): Promise<RemoteWorkspaceView[]>;
+    openRemoteWorkspace(targetDeviceId: string, path: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    listCodexWorkspaces(targetDeviceId: string, signal?: AbortSignal): Promise<CodexVirtualWorkspaceView[]>;
+    openCodexWorkspace(targetDeviceId: string, workspaceId: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    createCodexWorkspace(targetDeviceId: string, path: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    private consumeWorkspaceSelection;
+    close(): Promise<void>;
+    private callRemoteFileViewer;
+    private activeRemote;
+    private activeCodexRemote;
+    private openCodexStream;
+    private readonly publishLocalCodexFrame;
+    private appendCodexFrame;
+    private localCodexAvailable;
+    private requireLocalCodex;
+    private nextCodexFrames;
+    private closeCodexStream;
+    private closeCodexStreams;
+    private selectRemoteTarget;
+    private remoteTypertGateway;
+    private selectCodexTarget;
+    private closeCodexVirtual;
+    private assertRemoteCompatible;
+    private selectHarnessRemoteTransport;
+    private assertLocalHarnessCarrierAvailable;
+    private connect;
+    private ensureConnected;
+    private beginAttemptProgress;
+    private updateConnectionProgress;
+    private clearConnectionProgress;
+    handleControl(endpoint: string, payload: unknown, signal: AbortSignal): Promise<RpcResult<unknown>>;
+    private requireIdentity;
+    private authorizeHostPeer;
+}
+export declare class ClientModeError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(code: string, message: string, retryable?: boolean);
+}
+/** Conservative feature profile for Hosts that predate fine-grained capability discovery. */
+export declare function remoteHostFeatures(clientVersion?: string): RemoteHostFeatures;
+export declare function probeRemoteHostFeatures(client: RemoteClientCore, clientVersion?: string): Promise<RemoteHostFeatures>;
+//# sourceMappingURL=client-runtime.d.ts.map

package/dist/client-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-runtime.d.ts","sourceRoot":"","sources":["../src/client-runtime.ts"],"names":[],"mappings":"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"}