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

package/LICENSE

@@ -0,0 +1,46 @@
+WorldEngine 官方作者工具许可证
+
+版权所有 (c) 2026 Nixdorfer。保留所有权利。
+
+本仓库的源代码、构建材料及附带资源（统称“本作品”）不是开源软件，
+不适用任何 OSI 认证的开源许可证。
+
+一、官方作者工具分发许可
+
+版权所有者可以通过其官方网站、npm registry、签名安装包或其他官方渠道，
+复制并分发由本作品构建的 WorldEngine 作者工具及其必要运行资源
+（统称“官方作者工具”）。仅版权所有者或其书面指定的发布者享有此分发权。
+
+二、作者用户许可
+
+从官方渠道取得官方作者工具的作者用户，可以：
+
+1. 安装和运行官方作者工具；
+2. 使用官方作者工具创作、编辑、预览、导入、导出和提交其有权处理的内容；
+3. 为上述使用目的制作合理必要的本地备份副本。
+
+三、未授予的权利
+
+除第二条明确允许的行为外，本许可证不授予作者用户或其他第三方以下权利：
+
+1. 修改、改编、反编译、反汇编或制作官方作者工具的派生作品；
+2. 复制、镜像、转发、再上传、出售、出租、再分发或再许可官方作者工具；
+3. 使用本作品的源代码、构建材料或任何部分开发、提供或训练其他产品或服务；
+4. 删除或规避版权、许可、签名、访问控制或其他权利管理信息。
+
+法律强制允许且合同不得排除的权利不受上述限制影响。
+
+四、源代码查看
+
+第三方可以在已获合法访问权限的范围内查看本作品，用于审查、安全研究或学习参考；
+查看不授予运行、复制、修改、分发、再许可或用于其他产品与服务的权利。
+
+五、无担保与责任限制
+
+本作品与官方作者工具均按“现状”提供，不附带任何明示或暗示的担保。
+在适用法律允许的最大范围内，版权所有者不对因访问或使用本作品或官方作者工具
+造成的任何损失承担责任。
+
+六、终止
+
+违反本许可证将立即终止相应的访问与使用权；终止不影响版权所有者已经产生的权利和救济。

package/dist/entity-prop-envelope.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Canonical marker for a serialized entity/relation property envelope.
+ *
+ * Public graph objects may legitimately contain keys such as `value`,
+ * `title`, or `states`. Consumers must therefore interpret an object as an
+ * envelope only when this explicit marker is present and exactly `true`.
+ */
+export declare const SERIALIZED_PROP_ENVELOPE_MARKER: "_system_prop_envelope_v1";
+export declare const SERIALIZED_PROP_ENVELOPE_METADATA_KEYS: readonly ["initial_available", "source_refs", "states", "title", "trigger", "view_access"];
+export declare const SERIALIZED_PROP_ENVELOPE_KNOWN_KEYS: readonly ["_system_prop_envelope_v1", "value", "initial_available", "source_refs", "states", "title", "trigger", "view_access"];
+export type SerializedPropEnvelopeMetadataKey = (typeof SERIALIZED_PROP_ENVELOPE_METADATA_KEYS)[number];
+export type SerializedPropEnvelopeKnownKey = (typeof SERIALIZED_PROP_ENVELOPE_KNOWN_KEYS)[number];
+/**
+ * The protocol layer intentionally keeps metadata payloads opaque. Their
+ * domain types belong to blocks-editor, Ladybug policy, and scenario schema;
+ * importing those packages here would reverse the dependency direction.
+ */
+export type SerializedPropEnvelope<Value = unknown> = Readonly<{
+    [SERIALIZED_PROP_ENVELOPE_MARKER]: true;
+    value: Value;
+    initial_available?: unknown;
+    source_refs?: unknown;
+    states?: unknown;
+    title?: unknown;
+    trigger?: unknown;
+    view_access?: unknown;
+}>;
+export declare const isSerializedPropEnvelopeKnownKey: (key: string) => key is SerializedPropEnvelopeKnownKey;
+/**
+ * Strict marker-aware guard. An unmarked object is ordinary user graph JSON
+ * and returns `false`; once the reserved marker is present, malformed marker,
+ * missing `value`, or any unknown sibling key is a protocol error rather than
+ * a permissive fallback.
+ */
+export declare const isSerializedPropEnvelope: (value: unknown) => value is SerializedPropEnvelope;
+export declare const assertSerializedPropEnvelope: (value: unknown) => asserts value is SerializedPropEnvelope;

package/dist/entity-prop-envelope.js

@@ -0,0 +1,50 @@
+/**
+ * Canonical marker for a serialized entity/relation property envelope.
+ *
+ * Public graph objects may legitimately contain keys such as `value`,
+ * `title`, or `states`. Consumers must therefore interpret an object as an
+ * envelope only when this explicit marker is present and exactly `true`.
+ */
+export const SERIALIZED_PROP_ENVELOPE_MARKER = "_system_prop_envelope_v1";
+export const SERIALIZED_PROP_ENVELOPE_METADATA_KEYS = Object.freeze([
+    "initial_available",
+    "source_refs",
+    "states",
+    "title",
+    "trigger",
+    "view_access"
+]);
+export const SERIALIZED_PROP_ENVELOPE_KNOWN_KEYS = Object.freeze([
+    SERIALIZED_PROP_ENVELOPE_MARKER,
+    "value",
+    ...SERIALIZED_PROP_ENVELOPE_METADATA_KEYS
+]);
+const KNOWN_KEYS = new Set(SERIALIZED_PROP_ENVELOPE_KNOWN_KEYS);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+export const isSerializedPropEnvelopeKnownKey = (key) => KNOWN_KEYS.has(key);
+/**
+ * Strict marker-aware guard. An unmarked object is ordinary user graph JSON
+ * and returns `false`; once the reserved marker is present, malformed marker,
+ * missing `value`, or any unknown sibling key is a protocol error rather than
+ * a permissive fallback.
+ */
+export const isSerializedPropEnvelope = (value) => {
+    if (!isRecord(value) || !hasOwn(value, SERIALIZED_PROP_ENVELOPE_MARKER)) {
+        return false;
+    }
+    if (value[SERIALIZED_PROP_ENVELOPE_MARKER] !== true || !hasOwn(value, "value")) {
+        throw new Error("entity_prop_envelope_marker_invalid");
+    }
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== "string" || !isSerializedPropEnvelopeKnownKey(key)) {
+            throw new Error(`entity_prop_envelope_unknown_field:${String(key)}`);
+        }
+    }
+    return true;
+};
+export const assertSerializedPropEnvelope = (value) => {
+    if (!isSerializedPropEnvelope(value)) {
+        throw new Error("entity_prop_envelope_marker_missing");
+    }
+};

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

@@ -0,0 +1,46 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { ErrorInfo } from "./common.js";
+export interface LoginRequest {
+    email: string;
+    /** 客户端预先派生的 password 哈希 后端再做 server 侧 KDF */
+    password_hash: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface LoginResponse {
+    session_id: string;
+    two_factor_required: boolean;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface LogoutRequest {
+    session_id: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const LoginRequest: MessageFns<LoginRequest>;
+export declare const LoginResponse: MessageFns<LoginResponse>;
+export declare const LogoutRequest: MessageFns<LogoutRequest>;
+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/auth.js

@@ -0,0 +1,278 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.0
+//   protoc               unknown
+// source: v1/auth.proto
+/* eslint-disable */
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { ErrorInfo } from "./common.js";
+function createBaseLoginRequest() {
+    return { email: "", password_hash: "", _unknownFields: {} };
+}
+export const LoginRequest = {
+    encode(message, writer = new BinaryWriter()) {
+        if (message.email !== "") {
+            writer.uint32(10).string(message.email);
+        }
+        if (message.password_hash !== "") {
+            writer.uint32(18).string(message.password_hash);
+        }
+        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 = createBaseLoginRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.email = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.password_hash = 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 {
+            email: isSet(object.email) ? globalThis.String(object.email) : "",
+            password_hash: isSet(object.passwordHash)
+                ? globalThis.String(object.passwordHash)
+                : isSet(object.password_hash)
+                    ? globalThis.String(object.password_hash)
+                    : "",
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.email !== "") {
+            obj.email = message.email;
+        }
+        if (message.password_hash !== "") {
+            obj.passwordHash = message.password_hash;
+        }
+        return obj;
+    },
+    create(base) {
+        return LoginRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseLoginRequest();
+        message.email = object.email ?? "";
+        message.password_hash = object.password_hash ?? "";
+        return message;
+    },
+};
+function createBaseLoginResponse() {
+    return { session_id: "", two_factor_required: false, error: undefined, _unknownFields: {} };
+}
+export const LoginResponse = {
+    encode(message, writer = new BinaryWriter()) {
+        if (message.session_id !== "") {
+            writer.uint32(10).string(message.session_id);
+        }
+        if (message.two_factor_required !== false) {
+            writer.uint32(16).bool(message.two_factor_required);
+        }
+        if (message.error !== undefined) {
+            ErrorInfo.encode(message.error, writer.uint32(26).fork()).join();
+        }
+        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 = createBaseLoginResponse();
+        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 !== 16) {
+                        break;
+                    }
+                    message.two_factor_required = reader.bool();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.error = ErrorInfo.decode(reader, reader.uint32());
+                    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)
+                    : "",
+            two_factor_required: isSet(object.twoFactorRequired)
+                ? globalThis.Boolean(object.twoFactorRequired)
+                : isSet(object.two_factor_required)
+                    ? globalThis.Boolean(object.two_factor_required)
+                    : false,
+            error: isSet(object.error) ? ErrorInfo.fromJSON(object.error) : undefined,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.session_id !== "") {
+            obj.sessionId = message.session_id;
+        }
+        if (message.two_factor_required !== false) {
+            obj.twoFactorRequired = message.two_factor_required;
+        }
+        if (message.error !== undefined) {
+            obj.error = ErrorInfo.toJSON(message.error);
+        }
+        return obj;
+    },
+    create(base) {
+        return LoginResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseLoginResponse();
+        message.session_id = object.session_id ?? "";
+        message.two_factor_required = object.two_factor_required ?? false;
+        message.error = (object.error !== undefined && object.error !== null)
+            ? ErrorInfo.fromPartial(object.error)
+            : undefined;
+        return message;
+    },
+};
+function createBaseLogoutRequest() {
+    return { session_id: "", _unknownFields: {} };
+}
+export const LogoutRequest = {
+    encode(message, writer = new BinaryWriter()) {
+        if (message.session_id !== "") {
+            writer.uint32(10).string(message.session_id);
+        }
+        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 = createBaseLogoutRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.session_id = 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)
+                    : "",
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.session_id !== "") {
+            obj.sessionId = message.session_id;
+        }
+        return obj;
+    },
+    create(base) {
+        return LogoutRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseLogoutRequest();
+        message.session_id = object.session_id ?? "";
+        return message;
+    },
+};
+function isSet(value) {
+    return value !== null && value !== undefined;
+}

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

@@ -0,0 +1,71 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { ErrorInfo } from "./common.js";
+export declare enum PaymentMethod {
+    PAYMENT_METHOD_UNSPECIFIED = 0,
+    PAYMENT_METHOD_STRIPE_CARD = 1,
+    PAYMENT_METHOD_STRIPE_APPLE_PAY = 2,
+    PAYMENT_METHOD_STRIPE_GOOGLE_PAY = 3,
+    PAYMENT_METHOD_STRIPE_PAYPAL = 4,
+    PAYMENT_METHOD_FOURTH_PARTY_ALIPAY = 5,
+    PAYMENT_METHOD_FOURTH_PARTY_WECHAT = 6,
+    UNRECOGNIZED = -1
+}
+export declare function paymentMethodFromJSON(object: any): PaymentMethod;
+export declare function paymentMethodToJSON(object: PaymentMethod): string;
+/** 双货币钱包余额 units 为最小单位 (美元 cent 人民币分) currency 遵循 ISO 4217 */
+export interface WalletBalance {
+    top_up_balance_units: string;
+    credit_balance_units: string;
+    currency: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface TopUpIntent {
+    amount_units: string;
+    currency: string;
+    payment_method: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface TopUpIntentResponse {
+    intent_id: string;
+    client_secret: string;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface TokenUsageReport {
+    session_id: string;
+    model_id: string;
+    input_tokens: string;
+    output_tokens: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const WalletBalance: MessageFns<WalletBalance>;
+export declare const TopUpIntent: MessageFns<TopUpIntent>;
+export declare const TopUpIntentResponse: MessageFns<TopUpIntentResponse>;
+export declare const TokenUsageReport: MessageFns<TokenUsageReport>;
+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 {};