@world-engines/protocol-ts 0.1.0-alpha.0

package/dist/gen/v1/session.d.ts

@@ -0,0 +1,49 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { Region } from "./common.js";
+export declare enum SessionMode {
+    SESSION_MODE_UNSPECIFIED = 0,
+    SESSION_MODE_SINGLE = 1,
+    SESSION_MODE_MULTI = 2,
+    UNRECOGNIZED = -1
+}
+export declare function sessionModeFromJSON(object: any): SessionMode;
+export declare function sessionModeToJSON(object: SessionMode): string;
+/** 会话初始化 session_key 由 DO 启动时生成 用于 ws 帧加密 */
+export interface SessionInit {
+    session_id: string;
+    session_key: Uint8Array;
+    scenario_id: string;
+    save_id: string;
+    region: Region;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface SessionTeardown {
+    session_id: string;
+    reason: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const SessionInit: MessageFns<SessionInit>;
+export declare const SessionTeardown: MessageFns<SessionTeardown>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/gen/v1/session.js

@@ -0,0 +1,311 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               unknown
+// source: v1/session.proto
+/* eslint-disable */
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { regionFromJSON, regionToJSON } from "./common.js";
+export var SessionMode;
+(function (SessionMode) {
+    SessionMode[SessionMode["SESSION_MODE_UNSPECIFIED"] = 0] = "SESSION_MODE_UNSPECIFIED";
+    SessionMode[SessionMode["SESSION_MODE_SINGLE"] = 1] = "SESSION_MODE_SINGLE";
+    SessionMode[SessionMode["SESSION_MODE_MULTI"] = 2] = "SESSION_MODE_MULTI";
+    SessionMode[SessionMode["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(SessionMode || (SessionMode = {}));
+export function sessionModeFromJSON(object) {
+    switch (object) {
+        case 0:
+        case "SESSION_MODE_UNSPECIFIED":
+            return SessionMode.SESSION_MODE_UNSPECIFIED;
+        case 1:
+        case "SESSION_MODE_SINGLE":
+            return SessionMode.SESSION_MODE_SINGLE;
+        case 2:
+        case "SESSION_MODE_MULTI":
+            return SessionMode.SESSION_MODE_MULTI;
+        case -1:
+        case "UNRECOGNIZED":
+        default:
+            return SessionMode.UNRECOGNIZED;
+    }
+}
+export function sessionModeToJSON(object) {
+    switch (object) {
+        case SessionMode.SESSION_MODE_UNSPECIFIED:
+            return "SESSION_MODE_UNSPECIFIED";
+        case SessionMode.SESSION_MODE_SINGLE:
+            return "SESSION_MODE_SINGLE";
+        case SessionMode.SESSION_MODE_MULTI:
+            return "SESSION_MODE_MULTI";
+        case SessionMode.UNRECOGNIZED:
+        default:
+            return "UNRECOGNIZED";
+    }
+}
+function createBaseSessionInit() {
+    return {
+        session_id: "",
+        session_key: new Uint8Array(0),
+        scenario_id: "",
+        save_id: "",
+        region: 0,
+        _unknownFields: {},
+    };
+}
+export const SessionInit = {
+    encode(message, writer = new BinaryWriter()) {
+        if (message.session_id !== "") {
+            writer.uint32(10).string(message.session_id);
+        }
+        if (message.session_key.length !== 0) {
+            writer.uint32(18).bytes(message.session_key);
+        }
+        if (message.scenario_id !== "") {
+            writer.uint32(26).string(message.scenario_id);
+        }
+        if (message.save_id !== "") {
+            writer.uint32(34).string(message.save_id);
+        }
+        if (message.region !== 0) {
+            writer.uint32(40).int32(message.region);
+        }
+        if (message._unknownFields !== undefined) {
+            for (const [key, values] of globalThis.Object.entries(message._unknownFields)) {
+                const tag = parseInt(key, 10);
+                for (const value of values) {
+                    writer.uint32(tag).raw(value);
+                }
+            }
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseSessionInit();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.session_id = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.session_key = reader.bytes();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.scenario_id = reader.string();
+                    continue;
+                }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.save_id = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 40) {
+                        break;
+                    }
+                    message.region = reader.int32();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            const buf = reader.skip(tag & 7);
+            const list = message._unknownFields[tag];
+            if (list === undefined) {
+                message._unknownFields[tag] = [buf];
+            }
+            else {
+                list.push(buf);
+            }
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            session_id: isSet(object.sessionId)
+                ? globalThis.String(object.sessionId)
+                : isSet(object.session_id)
+                    ? globalThis.String(object.session_id)
+                    : "",
+            session_key: isSet(object.sessionKey)
+                ? bytesFromBase64(object.sessionKey)
+                : isSet(object.session_key)
+                    ? bytesFromBase64(object.session_key)
+                    : new Uint8Array(0),
+            scenario_id: isSet(object.scenarioId)
+                ? globalThis.String(object.scenarioId)
+                : isSet(object.scenario_id)
+                    ? globalThis.String(object.scenario_id)
+                    : "",
+            save_id: isSet(object.saveId)
+                ? globalThis.String(object.saveId)
+                : isSet(object.save_id)
+                    ? globalThis.String(object.save_id)
+                    : "",
+            region: isSet(object.region) ? regionFromJSON(object.region) : 0,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.session_id !== "") {
+            obj.sessionId = message.session_id;
+        }
+        if (message.session_key.length !== 0) {
+            obj.sessionKey = base64FromBytes(message.session_key);
+        }
+        if (message.scenario_id !== "") {
+            obj.scenarioId = message.scenario_id;
+        }
+        if (message.save_id !== "") {
+            obj.saveId = message.save_id;
+        }
+        if (message.region !== 0) {
+            obj.region = regionToJSON(message.region);
+        }
+        return obj;
+    },
+    create(base) {
+        return SessionInit.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseSessionInit();
+        message.session_id = object.session_id ?? "";
+        message.session_key = object.session_key ?? new Uint8Array(0);
+        message.scenario_id = object.scenario_id ?? "";
+        message.save_id = object.save_id ?? "";
+        message.region = object.region ?? 0;
+        return message;
+    },
+};
+function createBaseSessionTeardown() {
+    return { session_id: "", reason: "", _unknownFields: {} };
+}
+export const SessionTeardown = {
+    encode(message, writer = new BinaryWriter()) {
+        if (message.session_id !== "") {
+            writer.uint32(10).string(message.session_id);
+        }
+        if (message.reason !== "") {
+            writer.uint32(18).string(message.reason);
+        }
+        if (message._unknownFields !== undefined) {
+            for (const [key, values] of globalThis.Object.entries(message._unknownFields)) {
+                const tag = parseInt(key, 10);
+                for (const value of values) {
+                    writer.uint32(tag).raw(value);
+                }
+            }
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseSessionTeardown();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.session_id = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.reason = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            const buf = reader.skip(tag & 7);
+            const list = message._unknownFields[tag];
+            if (list === undefined) {
+                message._unknownFields[tag] = [buf];
+            }
+            else {
+                list.push(buf);
+            }
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            session_id: isSet(object.sessionId)
+                ? globalThis.String(object.sessionId)
+                : isSet(object.session_id)
+                    ? globalThis.String(object.session_id)
+                    : "",
+            reason: isSet(object.reason) ? globalThis.String(object.reason) : "",
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.session_id !== "") {
+            obj.sessionId = message.session_id;
+        }
+        if (message.reason !== "") {
+            obj.reason = message.reason;
+        }
+        return obj;
+    },
+    create(base) {
+        return SessionTeardown.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseSessionTeardown();
+        message.session_id = object.session_id ?? "";
+        message.reason = object.reason ?? "";
+        return message;
+    },
+};
+function bytesFromBase64(b64) {
+    if (globalThis.Buffer) {
+        return Uint8Array.from(globalThis.Buffer.from(b64, "base64"));
+    }
+    else {
+        const bin = globalThis.atob(b64);
+        const arr = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; ++i) {
+            arr[i] = bin.charCodeAt(i);
+        }
+        return arr;
+    }
+}
+function base64FromBytes(arr) {
+    if (globalThis.Buffer) {
+        return globalThis.Buffer.from(arr).toString("base64");
+    }
+    else {
+        const bin = [];
+        arr.forEach((byte) => {
+            bin.push(globalThis.String.fromCharCode(byte));
+        });
+        return globalThis.btoa(bin.join(""));
+    }
+}
+function isSet(value) {
+    return value !== null && value !== undefined;
+}

package/dist/gen/v1/view_state.d.ts

@@ -0,0 +1,267 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare enum RestorePhase {
+    RESTORE_PHASE_UNSPECIFIED = 0,
+    RESTORE_PHASE_PREHYDRATE = 1,
+    RESTORE_PHASE_POST_MOUNT = 2,
+    RESTORE_PHASE_AFTER_PROJECTION = 3,
+    RESTORE_PHASE_USER_RESUME = 4,
+    UNRECOGNIZED = -1
+}
+export declare function restorePhaseFromJSON(object: any): RestorePhase;
+export declare function restorePhaseToJSON(object: RestorePhase): string;
+export declare enum FormControlKind {
+    FORM_CONTROL_KIND_UNSPECIFIED = 0,
+    FORM_CONTROL_KIND_TEXT = 1,
+    FORM_CONTROL_KIND_CHECKBOX = 2,
+    FORM_CONTROL_KIND_RADIO = 3,
+    FORM_CONTROL_KIND_SELECT_ONE = 4,
+    FORM_CONTROL_KIND_SELECT_MULTIPLE = 5,
+    FORM_CONTROL_KIND_TEXTAREA = 6,
+    FORM_CONTROL_KIND_RANGE = 7,
+    UNRECOGNIZED = -1
+}
+export declare function formControlKindFromJSON(object: any): FormControlKind;
+export declare function formControlKindToJSON(object: FormControlKind): string;
+export declare enum MediaPlaybackState {
+    MEDIA_PLAYBACK_STATE_UNSPECIFIED = 0,
+    MEDIA_PLAYBACK_STATE_PAUSED = 1,
+    MEDIA_PLAYBACK_STATE_PLAYING = 2,
+    MEDIA_PLAYBACK_STATE_ENDED = 3,
+    MEDIA_PLAYBACK_STATE_PENDING_USER_RESUME = 4,
+    UNRECOGNIZED = -1
+}
+export declare function mediaPlaybackStateFromJSON(object: any): MediaPlaybackState;
+export declare function mediaPlaybackStateToJSON(object: MediaPlaybackState): string;
+export declare enum CanvasSnapshotKind {
+    CANVAS_SNAPSHOT_KIND_UNSPECIFIED = 0,
+    CANVAS_SNAPSHOT_KIND_CANVAS_2D = 1,
+    CANVAS_SNAPSHOT_KIND_WEBGL = 2,
+    CANVAS_SNAPSHOT_KIND_OFFSCREEN = 3,
+    UNRECOGNIZED = -1
+}
+export declare function canvasSnapshotKindFromJSON(object: any): CanvasSnapshotKind;
+export declare function canvasSnapshotKindToJSON(object: CanvasSnapshotKind): string;
+/** 页面导航的强类型 canonical state；不依赖浏览器 history 内部对象。 */
+export interface NavigationState {
+    scene_id: string;
+    chapter_id: string;
+    route: string;
+    history_entries: NavigationHistoryEntry[];
+    history_index: number;
+    modal_stack: OverlaySurfaceState[];
+    drawer_stack: OverlaySurfaceState[];
+    active_tab: string;
+    active_panel: string;
+    selections: ViewSelection[];
+    state_revision: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface NavigationHistoryEntry {
+    entry_id: string;
+    route: string;
+    canonical_state: Uint8Array;
+    state_codec: string;
+    state_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface OverlaySurfaceState {
+    surface_id: string;
+    surface_kind: string;
+    canonical_state: Uint8Array;
+    state_codec: string;
+    state_revision: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ViewSelection {
+    selection_id: string;
+    namespace: string;
+    stable_node_key: string;
+    value: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 作者 adapter 的 canonical payload。payload 必须受 adapter schema 与 hash 约束。 */
+export interface StateEntry {
+    namespace: string;
+    adapter_id: string;
+    adapter_schema_version: number;
+    portable: boolean;
+    codec: string;
+    payload: Uint8Array;
+    payload_sha256: Uint8Array;
+    state_revision: string;
+    restore_phase: RestorePhase;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface FormState {
+    form_id: string;
+    stable_node_key: string;
+    controls: FormControlState[];
+    state_revision: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface FormControlState {
+    stable_node_key: string;
+    name: string;
+    kind: FormControlKind;
+    value: string;
+    selected_values: string[];
+    checked: boolean;
+    disabled: boolean;
+    selection_start: number;
+    selection_end: number;
+    selection_direction: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ScrollState {
+    stable_node_key: string;
+    scroll_left: number;
+    scroll_top: number;
+    scroll_width: number;
+    scroll_height: number;
+    is_document: boolean;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface FocusState {
+    stable_node_key: string;
+    had_focus: boolean;
+    selection_start: number;
+    selection_end: number;
+    selection_direction: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface MediaState {
+    stable_node_key: string;
+    source_url: string;
+    source_sha256: Uint8Array;
+    current_time_seconds: number;
+    playback_rate: number;
+    volume: number;
+    muted: boolean;
+    loop: boolean;
+    playback_state: MediaPlaybackState;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ComponentSnapshot {
+    stable_node_key: string;
+    namespace: string;
+    component_kind: string;
+    adapter_id: string;
+    adapter_schema_version: number;
+    portable: boolean;
+    restore_phase: RestorePhase;
+    state_revision: string;
+    payload: Uint8Array;
+    codec: string;
+    payload_sha256: Uint8Array;
+    owned_subtree_key: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface CanvasSnapshot {
+    stable_node_key: string;
+    kind: CanvasSnapshotKind;
+    width: number;
+    height: number;
+    mime_type: string;
+    image_bytes: Uint8Array;
+    image_sha256: Uint8Array;
+    portable: boolean;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface DomSnapshot {
+    doctype: string;
+    document_element_html_gzip: Uint8Array;
+    raw_sha256: Uint8Array;
+    gzip_sha256: Uint8Array;
+    raw_size: string;
+    gzip_size: string;
+    capture_url: string;
+    base_uri: string;
+    viewport_width: number;
+    viewport_height: number;
+    device_pixel_ratio: number;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 完整 DOM 原文用于诊断/视觉辅助；业务恢复以 adapter canonical state 为准。 */
+export interface ViewStateSnapshot {
+    schema_version: number;
+    snapshot_id: string;
+    captured_at_ms: string;
+    platform: string;
+    view_artifact_sha256: Uint8Array;
+    runtime_major: number;
+    sdk_schema_version: number;
+    canonical_state_revision: string;
+    navigation?: NavigationState | undefined;
+    state_entries: StateEntry[];
+    forms: FormState[];
+    scroll: ScrollState[];
+    focus?: FocusState | undefined;
+    media: MediaState[];
+    components: ComponentSnapshot[];
+    dom_snapshot?: DomSnapshot | undefined;
+    canvas_snapshots: CanvasSnapshot[];
+    capture_warnings: string[];
+    canonical_state_sha256: Uint8Array;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const NavigationState: MessageFns<NavigationState>;
+export declare const NavigationHistoryEntry: MessageFns<NavigationHistoryEntry>;
+export declare const OverlaySurfaceState: MessageFns<OverlaySurfaceState>;
+export declare const ViewSelection: MessageFns<ViewSelection>;
+export declare const StateEntry: MessageFns<StateEntry>;
+export declare const FormState: MessageFns<FormState>;
+export declare const FormControlState: MessageFns<FormControlState>;
+export declare const ScrollState: MessageFns<ScrollState>;
+export declare const FocusState: MessageFns<FocusState>;
+export declare const MediaState: MessageFns<MediaState>;
+export declare const ComponentSnapshot: MessageFns<ComponentSnapshot>;
+export declare const CanvasSnapshot: MessageFns<CanvasSnapshot>;
+export declare const DomSnapshot: MessageFns<DomSnapshot>;
+export declare const ViewStateSnapshot: MessageFns<ViewStateSnapshot>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};