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

package/dist/gen/v1/rest/users.d.ts

@@ -0,0 +1,292 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { ErrorInfo } from "../common.js";
+/** 背景槽位引用 区分目录装饰与剧本 CG */
+export declare enum BackgroundKind {
+    BACKGROUND_KIND_UNSPECIFIED = 0,
+    BACKGROUND_KIND_COSMETIC = 1,
+    BACKGROUND_KIND_CG = 2,
+    UNRECOGNIZED = -1
+}
+export declare function backgroundKindFromJSON(object: any): BackgroundKind;
+export declare function backgroundKindToJSON(object: BackgroundKind): string;
+/** GET /v1/users/{id}/profile (id 可为 "me" 或 uuid) */
+export interface UserPublicProfile {
+    user_id: string;
+    display_name: string;
+    discriminator: number;
+    avatar_url?: string | undefined;
+    bio?: string | undefined;
+    joined_at: string;
+    scenarios_published: string;
+    total_plays: string;
+    /** 头衔展示文案 由 loadout title 槽位解出 */
+    title?: string | undefined;
+    /** 各槽位当前装备 */
+    loadout?: ProfileLoadout | undefined;
+    /** 库存 仅 /me 返回 他人资料为空 */
+    owned_cosmetics: UserCosmeticItem[];
+    /** 个性签名 短文本 有别于 bio 简介 */
+    status?: string | undefined;
+    /** 展示柜 装备 showcase 槽位时返回 公开可读 */
+    showcase: ShowcaseItem[];
+    /** 徽章库存 仅 /me 返回 他人资料为空 */
+    owned_badges: UserBadge[];
+    error?: ErrorInfo | undefined;
+    /** 已 pin 徽章 id 列表 装备 badges 槽位时返回 公开可读 */
+    pinned_badges: string[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * 橱窗模块实例 对应 user_showcase_items 行。
+ * 同一种 kind 可重复出现，instance_id 是实例稳定标识，config_json 是各实例独立配置。
+ * ADR-0116 v1 只允许 native；未知版本、未知模式与 iframe 一律 fail closed。
+ */
+export interface ShowcaseItem {
+    /** favorite_scenarios/recent_plays/cg_wall/achievement_wall/checkin_calendar */
+    kind: string;
+    /** 兼容旧客户端，新的模块实例保持为空 */
+    ref_id: string;
+    /** 兼容旧客户端，新的模块实例保持为空 */
+    scenario_id: string;
+    sort_index: number;
+    instance_id: string;
+    config_json: string;
+    contract_version: number;
+    /** v1 仅 native */
+    render_mode: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 徽章目录项 对应 badge_catalog 行 */
+export interface Badge {
+    id: string;
+    name: string;
+    icon: string;
+    rarity: string;
+    description: string;
+    enabled: boolean;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 用户已授予徽章 对应 user_badges 行 */
+export interface UserBadge {
+    badge_id: string;
+    granted_at: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** GET /v1/badges/catalog */
+export interface ListBadgesResponse {
+    items: Badge[];
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** GET /v1/users/{id}/badges (公开 仅返回 owned 集合) */
+export interface UserBadgesResponse {
+    items: UserBadge[];
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** PUT /v1/users/me/badges/pinned */
+export interface PutPinnedBadgesRequest {
+    badge_ids: string[];
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface PutPinnedBadgesResponse {
+    ok: boolean;
+    count: string;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 装饰目录项 对应 cosmetic_catalog 行 */
+export interface Cosmetic {
+    id: string;
+    slot: string;
+    name: string;
+    icon: string;
+    price_shark: string;
+    rarity: string;
+    config_json: string;
+    enabled: boolean;
+    /** 上架门槛 JSON 树 详见 src/core-service/src/cosmetics/criterion.rs 空字符串视为无门槛 */
+    unlock_criterion_json?: string | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 库存项 对应 user_cosmetics 行 */
+export interface UserCosmeticItem {
+    cosmetic_id: string;
+    acquired_at: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface BackgroundRef {
+    kind: BackgroundKind;
+    id: string;
+    /** CG 授权作用域；kind=CG 时必填，cosmetic 留空 */
+    scenario_id: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** 背景槽位 SFW/NSFW 对 各自可空 nsfw 非空时 sfw 必须非空 */
+export interface BackgroundLoadout {
+    sfw?: BackgroundRef | undefined;
+    nsfw?: BackgroundRef | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * 各槽位当前装备 对应 user_profile_loadout.loadout_json
+ * 普通槽位存装饰 id 背景槽位用 BackgroundLoadout (sfw/nsfw 对)
+ */
+export interface ProfileLoadout {
+    frame_id: string;
+    title_id: string;
+    status_id: string;
+    palette_id: string;
+    font_id: string;
+    iconset_id: string;
+    layout_id: string;
+    border_id: string;
+    background?: BackgroundLoadout | undefined;
+    banner_id: string;
+    effect_id: string;
+    showcase_id: string;
+    badges_id: string;
+    desktop_theme_id: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** GET /v1/cosmetics?slot= */
+export interface ListCosmeticsRequest {
+    /** 空 slot 表示全部 */
+    slot: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface ListCosmeticsResponse {
+    items: Cosmetic[];
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** POST /v1/cosmetics/purchase */
+export interface PurchaseCosmeticRequest {
+    cosmetic_id: string;
+    operation_id: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/**
+ * COSMETIC_PURCHASE_RECEIPT_V1：购买 mutation 的持久化终态。
+ * GET /v1/cosmetics/purchase?operation_id= 只允许当前 principal 读取自己的 receipt。
+ */
+export interface CosmeticPurchaseReceipt {
+    contract_version: string;
+    operation_id: string;
+    request_fingerprint: string;
+    principal_id: string;
+    cosmetic_id: string;
+    price_shark: string;
+    /** applied/rejected */
+    status: string;
+    /** applied 时为空；rejected 时为稳定业务原因 */
+    reason: string;
+    balance_after: string;
+    /** rejected 时为 0 */
+    acquired_at_ms: string;
+    completed_at_ms: string;
+    replayed: boolean;
+    /** 购买结算币种，当前仅允许小写 shark */
+    currency: string;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface PurchaseCosmeticResponse {
+    ok: boolean;
+    /** ""/"not_found"/"already_owned"/"insufficient_funds" */
+    reason: string;
+    new_shark_balance: string;
+    receipt?: CosmeticPurchaseReceipt | undefined;
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+/** GET /v1/users/search */
+export interface UserSearchItem {
+    user_id: string;
+    display_name: string;
+    discriminator: number;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export interface UserSearchResponse {
+    items: UserSearchItem[];
+    error?: ErrorInfo | undefined;
+    _unknownFields?: {
+        [key: number]: Uint8Array[];
+    } | undefined;
+}
+export declare const UserPublicProfile: MessageFns<UserPublicProfile>;
+export declare const ShowcaseItem: MessageFns<ShowcaseItem>;
+export declare const Badge: MessageFns<Badge>;
+export declare const UserBadge: MessageFns<UserBadge>;
+export declare const ListBadgesResponse: MessageFns<ListBadgesResponse>;
+export declare const UserBadgesResponse: MessageFns<UserBadgesResponse>;
+export declare const PutPinnedBadgesRequest: MessageFns<PutPinnedBadgesRequest>;
+export declare const PutPinnedBadgesResponse: MessageFns<PutPinnedBadgesResponse>;
+export declare const Cosmetic: MessageFns<Cosmetic>;
+export declare const UserCosmeticItem: MessageFns<UserCosmeticItem>;
+export declare const BackgroundRef: MessageFns<BackgroundRef>;
+export declare const BackgroundLoadout: MessageFns<BackgroundLoadout>;
+export declare const ProfileLoadout: MessageFns<ProfileLoadout>;
+export declare const ListCosmeticsRequest: MessageFns<ListCosmeticsRequest>;
+export declare const ListCosmeticsResponse: MessageFns<ListCosmeticsResponse>;
+export declare const PurchaseCosmeticRequest: MessageFns<PurchaseCosmeticRequest>;
+export declare const CosmeticPurchaseReceipt: MessageFns<CosmeticPurchaseReceipt>;
+export declare const PurchaseCosmeticResponse: MessageFns<PurchaseCosmeticResponse>;
+export declare const UserSearchItem: MessageFns<UserSearchItem>;
+export declare const UserSearchResponse: MessageFns<UserSearchResponse>;
+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 {};