@wirecat/max-cli 0.50.0 → 0.52.0

package/dist/client/session.js

@@ -0,0 +1,293 @@
+import { CliError } from "@wirecat/cli-base";
+import { toChat, toContact, toProfile } from "../domain/map.js";
+import { asFirstWord } from "../profile.js";
+import { asId } from "../protocol/frame.js";
+import { LOGIN_CHATS, startSession } from "../session/handshake.js";
+import { withLoginRefused, withoutLoginPause } from "../session/store.js";
+import { WEB_USER_AGENT } from "../spec/identity.js";
+import { asArray, asCliError, asMarker, CHATS_PAGE_SEEN, eventTime, reasonOf, record, refuseWhilePaused, } from "./values.js";
+export const createSession = (deps) => {
+    let login;
+    let chatsCut = false;
+    let chatsComplete = false;
+    let merged;
+    let connecting;
+    let closed = false;
+    const connect = (options = {}) => {
+        if (closed)
+            return Promise.reject(new CliError("network_error", "the client is closed"));
+        if (!connecting)
+            connecting = performConnect(options)
+                .catch((error) => {
+                login = undefined;
+                throw error;
+            })
+                .finally(() => {
+                connecting = undefined;
+            });
+        return connecting;
+    };
+    async function performConnect({ token: candidate } = {}) {
+        if (deps.offline)
+            throw new CliError("validation_error", "`--offline` reads through the shared store; it cannot connect to MAX");
+        const token = candidate ?? deps.store.readToken();
+        if (!token) {
+            const profile = deps.store.profile;
+            // cli-base swallows a keyring that will not open, so the state file is the only witness: a
+            // profile that has logged in lost its keyring, not its session, and another login would
+            // register one more device for nothing (MAX-50, measured from cron 2026-09-25).
+            if (deps.store.hasLoggedIn()) {
+                throw new CliError("authentication_error", `no token found for profile "${profile}", although it has logged in on this machine — ` +
+                    `the keyring is probably out of reach (cron, ssh: set XDG_RUNTIME_DIR); ` +
+                    `\`max ${asFirstWord(profile)}doctor\` shows it. Log in again only if the token was removed`);
+            }
+            if (deps.store.isBot()) {
+                throw new CliError("authentication_error", `profile "${profile}" is a bot — its commands are \`max ${asFirstWord(profile)}bot …\`; ` +
+                    `\`max ${asFirstWord(profile)}session start\` would add a personal account to it`);
+            }
+            // The fix has to carry the profile, or it logs the wrong one in: a name nobody has logged
+            // in under is the ordinary shape of this failure now that the first word is the profile.
+            throw new CliError("authentication_error", `no session for profile "${profile}" — run \`max ${asFirstWord(profile)}setup\` in a local terminal; agents: read \`max skill show\``);
+        }
+        const state = deps.store.readState();
+        refuseWhilePaused(state);
+        const sync = deps.fullLogin ? undefined : await loginMarker();
+        try {
+            await deps.connection.open();
+            if (closed)
+                throw new CliError("network_error", "the client is closed");
+            const answer = await startSession(deps.invoke, {
+                token,
+                deviceId: state.deviceId,
+                ...(sync === undefined ? {} : { sync }),
+                ...(deps.resume ? { resume: deps.resume.login } : {}),
+            });
+            login = answer;
+        }
+        catch (error) {
+            const failure = asCliError(error);
+            if (failure.code !== "rate_limited")
+                throw failure;
+            const paused = withLoginRefused(state);
+            deps.store.writeState(paused);
+            throw new CliError("rate_limited", `${failure.message} — this profile will not log in again before ${paused.loginPausedUntil}; ` +
+                "logging in sooner is what keeps an account locked");
+        }
+        // MAX has counted this login by now, so its state and rotated token are kept even when the client
+        // closed meanwhile; dropping them would make the next run log in again.
+        const viewerId = toProfile(record(login.profile) ?? {}).id;
+        // **Before `writeState`**, so a login we are about to refuse does not count itself or move
+        // `lastLoginAt`. A profile is a person, not a directory name: if this token belongs to someone
+        // else, every later command in this process would send as them and nothing would say so.
+        // Switching accounts has a door already — `session end` clears the id along with the token.
+        if (viewerId && state.viewerId && viewerId !== state.viewerId) {
+            throw new CliError("authentication_error", `this token is for a different account than profile "${deps.store.profile}" was set up with — ` +
+                `run \`max ${asFirstWord(deps.store.profile)}session end\` first if you meant to switch`);
+        }
+        deps.store.writeState({
+            ...withoutLoginPause(state),
+            ...(viewerId ? { viewerId } : {}),
+            logins: state.logins + 1,
+            lastLoginAt: new Date(deps.now()).toISOString(),
+        });
+        keepRotatedToken(token);
+        // `max serve` hands this login to any process that asks its socket; none of them needs the token.
+        const { token: _, ...withoutToken } = login;
+        login = withoutToken;
+        if (closed)
+            throw new CliError("network_error", "the client is closed");
+        if (deps.resume)
+            mergeChanged(deps.resume.chats);
+        else
+            await readRestOfChats();
+        await mergeLogin(viewerId);
+        if (closed)
+            throw new CliError("network_error", "the client is closed");
+    }
+    async function connectOnce() {
+        if (closed)
+            throw new CliError("network_error", "the client is closed");
+        if (connecting)
+            await connecting;
+        else if (!login)
+            await connect();
+    }
+    function mergeChanged(before) {
+        const session = snapshot();
+        const changed = asArray(session.chats);
+        const ids = new Set(changed.map((chat) => asId(record(chat)?.id)));
+        const kept = before.filter((chat) => !ids.has(asId(chat.id)));
+        session.chats = [...changed, ...kept].sort((a, b) => eventTime(b) - eventTime(a));
+    }
+    async function readRestOfChats() {
+        chatsCut = false;
+        chatsComplete = false;
+        const session = snapshot();
+        const chats = asArray(session.chats);
+        const marker = record(chats.at(-1))?.lastEventTime;
+        if (chats.length < LOGIN_CHATS) {
+            chatsComplete = true;
+            return;
+        }
+        if (typeof marker !== "number" && typeof marker !== "bigint")
+            return;
+        try {
+            const answer = await deps.wire.chats.list({ marker: Number(marker) });
+            const known = new Set(chats.map((chat) => asId(record(chat)?.id)));
+            const rest = asArray(answer.chats).filter((chat) => !known.has(asId(record(chat)?.id)));
+            session.chats = [...chats, ...rest];
+            chatsCut = rest.length >= CHATS_PAGE_SEEN;
+            chatsComplete = !chatsCut;
+        }
+        catch (error) {
+            chatsCut = true;
+            deps.warnAbout("chats_partial", `only the newest ${chats.length} chats were read: ${reasonOf(error)}`);
+        }
+    }
+    function keepRotatedToken(sent) {
+        const rotated = snapshot().token;
+        if (typeof rotated !== "string" || rotated === "" || rotated === sent)
+            return;
+        if (fromEnvironment()) {
+            deps.warnAbout("token_not_saved", "MAX refreshed the session; the fresh token was not saved, because the one in use came from MAX_TOKEN");
+            return;
+        }
+        try {
+            deps.store.writeToken(rotated);
+        }
+        catch (error) {
+            deps.warnAbout("token_not_saved", `the refreshed session could not be saved, so the previous one is still in use: ${reasonOf(error)}`);
+        }
+    }
+    async function mergeLogin(viewerId) {
+        const marker = asMarker(snapshot().time);
+        if (!deps.record)
+            return;
+        const chats = asArray(snapshot().chats);
+        const members = new Map();
+        for (const raw of chats) {
+            const chat = toChat(raw);
+            // A channel lists four of its hundred and seventy-eight thousand subscribers, so its
+            // `participants` is not a membership — storing it would be storing a wrong answer.
+            if (!chat.id || chat.kind === "channel")
+                continue;
+            const participants = participantsOf(raw, viewerId);
+            if (participants !== undefined)
+                members.set(chat.id, participants);
+        }
+        const delta = {
+            chats: chats.map(toChat).filter((chat) => chat.id !== ""),
+            people: asArray(snapshot().contacts)
+                .map(toContact)
+                .filter((contact) => contact.id !== ""),
+            members,
+        };
+        // A login `max serve` made answered its own marker, not the record's: what changed before it is not in it.
+        const own = deps.server?.journals !== true;
+        await keep("login", async (record) => {
+            const summary = await record.applyLogin({ ...delta, ...(own && marker !== undefined ? { marker } : {}) });
+            merged = summary;
+        });
+    }
+    async function loginMarker() {
+        let marker;
+        await keep("marker", async (record) => {
+            marker = await record.syncMarker();
+        });
+        return marker;
+    }
+    async function keep(what, write) {
+        if (!deps.record)
+            return;
+        try {
+            await write(deps.record);
+        }
+        catch (error) {
+            deps.warnAbout("cache_not_written", `the local store did not take the ${what}: ${reasonOf(error)}`);
+        }
+    }
+    function participantsOf(chat, viewerId) {
+        const participants = record(chat.participants);
+        return participants === undefined ? undefined : Object.keys(participants).filter((id) => id !== viewerId);
+    }
+    async function logout() {
+        if (deps.offline)
+            throw new CliError("validation_error", "`--offline` cannot log out on MAX's side");
+        await connectOnce();
+        await deps.wire.session.logout({});
+    }
+    async function close() {
+        closed = true;
+        await deps.connection.close();
+    }
+    async function beforeLogin(flow) {
+        try {
+            await deps.connection.open();
+        }
+        catch (error) {
+            throw asCliError(error);
+        }
+        await deps.wire.session.init({ userAgent: WEB_USER_AGENT, deviceId: deps.store.readState().deviceId });
+        return await flow();
+    }
+    function fromEnvironment() {
+        try {
+            return deps.store.tokenSource() === "environment";
+        }
+        catch {
+            return false;
+        }
+    }
+    function keepSettings(sent, answer) {
+        const login = snapshot();
+        const config = record(login.config) ?? {};
+        login.config = {
+            ...config,
+            ...(typeof answer.hash === "string" ? { hash: answer.hash } : {}),
+            ...(sent.user ? { user: { ...(record(config.user) ?? {}), ...sent.user, ...(record(answer.user) ?? {}) } } : {}),
+            ...(sent.chats ? { chats: { ...(record(config.chats) ?? {}), ...sent.chats } } : {}),
+        };
+    }
+    function lastEventOf(chatId) {
+        const chat = asArray(snapshot().chats).find((one) => asId(one.id) === chatId);
+        return eventTime(chat) || deps.now();
+    }
+    function snapshot() {
+        if (!login)
+            throw new CliError("configuration_error", "connect() was never called");
+        return login;
+    }
+    return {
+        connect: connect,
+        connectOnce: connectOnce,
+        keep: keep,
+        participantsOf: participantsOf,
+        logout: logout,
+        close: close,
+        beforeLogin: beforeLogin,
+        fromEnvironment: fromEnvironment,
+        keepSettings: keepSettings,
+        lastEventOf: lastEventOf,
+        session: () => {
+            if (connecting)
+                throw new CliError("configuration_error", "the login is still initializing");
+            return snapshot();
+        },
+        get login() {
+            return connecting ? undefined : login;
+        },
+        set login(value) {
+            login = value;
+        },
+        get chatsCut() {
+            return chatsCut;
+        },
+        get chatsComplete() {
+            return chatsComplete;
+        },
+        get merged() {
+            return merged;
+        },
+    };
+};
+//# sourceMappingURL=session.js.map

package/dist/client/session.js.map

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

package/dist/client/stickers.d.ts

@@ -0,0 +1,12 @@
+import type { Id, Sticker, StickerSet } from "../domain/models.js";
+import type { wireClient } from "../generated/client.generated.js";
+interface Dependencies {
+    connectOnce: () => Promise<void>;
+    readonly wire: Pick<ReturnType<typeof wireClient>, "assets">;
+}
+export declare const createStickers: (deps: Dependencies) => {
+    sets: () => Promise<StickerSet[]>;
+    list: (setId: Id) => Promise<Sticker[]>;
+};
+export {};
+//# sourceMappingURL=stickers.d.ts.map

package/dist/client/stickers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickers.d.ts","sourceRoot":"","sources":["../../src/client/stickers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAGlE,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAA;CAC7D;AAED,eAAO,MAAM,cAAc,SAAU,YAAY;IAqBtC,IAAI,QAnBK,OAAO,CAAC,UAAU,EAAE,CAAC;IAmBT,IAAI,UAXZ,EAAE,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAY9C,CAAA"}

package/dist/client/stickers.js

@@ -0,0 +1,29 @@
+import { CliError } from "@wirecat/cli-base";
+import { toSticker, toStickerSet } from "../domain/map.js";
+import { asArray, numbers, record } from "./values.js";
+export const createStickers = (deps) => {
+    const resource = {
+        sets: async () => {
+            await deps.connectOnce();
+            const sections = asArray((await deps.wire.assets.update({ type: "STICKER", sync: 0 })).sections);
+            const ids = [...new Set(sections.flatMap((section) => numbers(record(section)?.stickerSets)))];
+            if (ids.length === 0)
+                return [];
+            const answer = await deps.wire.assets.byIds({ type: "STICKER_SET", ids });
+            return asArray(answer.stickerSets).map((raw) => toStickerSet(record(raw) ?? {}));
+        },
+        list: async (setId) => {
+            await deps.connectOnce();
+            const [set] = asArray((await deps.wire.assets.byIds({ type: "STICKER_SET", ids: [Number(setId)] })).stickerSets);
+            if (set === undefined)
+                throw new CliError("not_found", `no sticker set ${setId} — \`stickers list\` names the sets`);
+            const ids = numbers(record(set)?.stickers);
+            if (ids.length === 0)
+                return [];
+            const answer = await deps.wire.assets.byIds({ type: "STICKER", ids });
+            return asArray(answer.stickers).map((raw) => toSticker(record(raw) ?? {}));
+        },
+    };
+    return { sets: resource.sets, list: resource.list };
+};
+//# sourceMappingURL=stickers.js.map

package/dist/client/stickers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickers.js","sourceRoot":"","sources":["../../src/client/stickers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG1D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOtD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAkB,EAAE,EAAE;IACnD,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,KAAK,IAA2B,EAAE;YACtC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAA;YACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;YAChG,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9F,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAA;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAA;YACzE,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAClF,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,KAAS,EAAsB,EAAE;YAC5C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAA;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;YAChH,IAAI,GAAG,KAAK,SAAS;gBACnB,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,kBAAkB,KAAK,qCAAqC,CAAC,CAAA;YAC/F,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAA;YAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAA;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;YACrE,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5E,CAAC;KACF,CAAA;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAA;AACrD,CAAC,CAAA"}

package/dist/client/types.d.ts

@@ -0,0 +1,54 @@
+import type { SleepLike } from "@wirecat/cli-base";
+import type { DiagnosticEvent } from "@wirecat/cli-core/cli";
+import type { SendGuard } from "@wirecat/cli-core/sends";
+import type { Wire } from "../protocol/connection.js";
+import type { MaxRecord } from "../record.js";
+import type { SessionStore } from "../session/store.js";
+import type { ResumeFrom } from "./values.js";
+export interface Upload {
+    path: string;
+    body: Blob;
+    kind: "photo" | "video" | "file" | "voice";
+    voice?: {
+        durationMs: number;
+        wave: Uint8Array;
+    };
+}
+export interface MaxClientOptions {
+    now?: () => number;
+    monotonicNow?: () => number;
+    store: SessionStore;
+    timeoutMs?: number;
+    /** Injected by tests, or one through `max serve`; defaults to a real WebSocket connection. */
+    connection?: Wire;
+    /**
+     * Log in without the saved contact marker, so the answer names every contact. `max serve` needs that: it hands its login to other commands as theirs.
+     */
+    fullLogin?: boolean;
+    /** The previous connection's login, for logging in again as a web tab does (`MAX-51`). `max serve` only. */
+    resume?: ResumeFrom;
+    /**
+     * Where a protocol note goes. Never stdout: in machine mode that stream carries one JSON value
+     * and nothing else.
+     */
+    warn?: (message: string) => void;
+    /** What the login brings, kept in the shared `messages.db`. */
+    record?: MaxRecord;
+    /** Refuse network use; the shared services own offline reads. */
+    offline?: boolean;
+    /**
+     * One event per request, for whoever is keeping a diagnostic. Injected the way `warn` is: the
+     * client reports what it did and never decides where that goes. Absent means nothing is kept.
+     */
+    events?: (event: DiagnosticEvent) => void;
+    /**
+     * Asked before every send and told its outcome. `"caller"` when whoever holds the client guards
+     * its writes instead: the shared services, or `max serve` for each write it forwards.
+     * Required, so a client without a guard is a choice somebody wrote and never one they forgot.
+     */
+    sends: SendGuard | "caller";
+    reads?: (key: string) => void;
+    /** The wait between retries; a test passes one that returns at once. */
+    sleep?: SleepLike;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAA;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4GAA4G;IAC5G,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACzC;;;;OAIG;IACH,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC3B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB"}

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/client/upload-transport.d.ts

@@ -0,0 +1,15 @@
+import { type Upload as SharedUpload } from "@wirecat/cli-core/sends";
+import type { wireClient } from "../generated/client.generated.js";
+import type { Payload } from "../protocol/frame.js";
+import type { Upload } from "./types.js";
+interface Dependencies {
+    readonly wire: Pick<ReturnType<typeof wireClient>, "uploads">;
+}
+export declare const createUploadTransport: (deps: Dependencies) => {
+    photoToken: (photo: string | SharedUpload, { profile }: {
+        profile: boolean;
+    }) => Promise<string>;
+    upload: ({ path, body, kind, voice }: Upload) => Promise<Payload>;
+};
+export {};
+//# sourceMappingURL=upload-transport.d.ts.map

package/dist/client/upload-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-transport.d.ts","sourceRoot":"","sources":["../../src/client/upload-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,IAAI,YAAY,EAAc,MAAM,yBAAyB,CAAA;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGxC,UAAU,YAAY;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,EAAE,SAAS,CAAC,CAAA;CAC9D;AACD,eAAO,MAAM,qBAAqB,SAAU,YAAY;wBAErB,MAAM,GAAG,YAAY,eAAe;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAG,OAAO,CAAC,MAAM,CAAC;0CAaxD,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;CA0B7E,CAAA"}

package/dist/client/upload-transport.js

@@ -0,0 +1,49 @@
+import { CliError } from "@wirecat/cli-base";
+import { uploadBlob } from "@wirecat/cli-core/sends";
+import { isImage, openUpload, uploadFile, uploadMedia, uploadPhoto } from "../upload.js";
+import { asArray, record } from "./values.js";
+export const createUploadTransport = (deps) => {
+    /** A group's photo goes up as a message photo does; the web client asks `{count: 1}` for it (2026-10-08). */
+    async function photoToken(photo, { profile }) {
+        const path = typeof photo === "string" ? photo : photo.name;
+        if (!isImage(path))
+            throw new CliError("validation_error", `${path} is not an image MAX takes as a photo`);
+        const body = typeof photo === "string" ? await openUpload(photo) : await uploadBlob(photo.source);
+        const { url } = await deps.wire.uploads.photo({ count: 1, type: 0, uploaderType: 0, profile });
+        if (typeof url !== "string")
+            throw new CliError("provider_error", "MAX gave no address to upload the photo to");
+        return uploadPhoto(url, path, body);
+    }
+    /**
+     * Uploads one file and answers what the message attaches (measured 2026-09-24). An upload is never
+     * retried: a failure here happens before `MSG_SEND`, so nothing was sent.
+     */
+    async function upload({ path, body, kind, voice }) {
+        const request = { count: 1, type: 0, uploaderType: 0, profile: false };
+        if (kind === "photo") {
+            const { url } = await deps.wire.uploads.photo(request);
+            if (typeof url !== "string")
+                throw new CliError("provider_error", "MAX gave no address to upload the photo to");
+            return { _type: "PHOTO", photoToken: await uploadPhoto(url, path, body) };
+        }
+        if (kind === "video" || kind === "voice") {
+            const slot = voice ? { ...request, type: 2, uploaderType: 1 } : request;
+            const info = record(asArray((await deps.wire.uploads.video(slot)).info)[0]) ?? {};
+            if (typeof info.url !== "string" || info.videoId === undefined) {
+                throw new CliError("provider_error", `MAX gave no address to upload the ${kind} to`);
+            }
+            await uploadMedia(voice ? "voice message" : "video", info.url, path, body);
+            return voice
+                ? { _type: "AUDIO", audioId: info.videoId, duration: voice.durationMs, wave: voice.wave, token: info.token }
+                : { _type: "VIDEO", videoId: info.videoId, token: info.token, videoType: 0 };
+        }
+        const info = record(asArray((await deps.wire.uploads.file(request)).info)[0]) ?? {};
+        if (typeof info.url !== "string" || info.fileId === undefined) {
+            throw new CliError("provider_error", "MAX gave no address to upload the file to");
+        }
+        await uploadFile(info.url, path, body);
+        return { _type: "FILE", fileId: info.fileId };
+    }
+    return { photoToken, upload };
+};
+//# sourceMappingURL=upload-transport.js.map

package/dist/client/upload-transport.js.map

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

package/dist/client/uploads.d.ts

@@ -0,0 +1,15 @@
+import type { Upload } from "./types.js";
+interface UploadSelection {
+    files?: string[];
+    uploads?: {
+        name: string;
+        body: Blob;
+        kind: Upload["kind"];
+    }[];
+    voice?: string;
+    asFile?: boolean;
+    anyFile?: boolean;
+}
+export declare const prepareUploads: (options: UploadSelection) => Promise<Upload[]>;
+export {};
+//# sourceMappingURL=uploads.d.ts.map

package/dist/client/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../../src/client/uploads.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;KAAE,EAAE,CAAA;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AASD,eAAO,MAAM,cAAc,YAAmB,eAAe,KAAG,OAAO,CAAC,MAAM,EAAE,CAe/E,CAAA"}

package/dist/client/uploads.js

@@ -0,0 +1,25 @@
+import { CliError } from "@wirecat/cli-base";
+import { MAX_BUFFERED_UPLOAD_BYTES } from "@wirecat/cli-core/sends";
+import { isImage, isVideo, openUpload } from "../upload.js";
+import { voiceOf } from "../voice.js";
+/** A voice message is decoded for its length and waveform, so it is read whole — and only up to the cap. */
+const voice = async (name, body) => {
+    if (body.size > MAX_BUFFERED_UPLOAD_BYTES)
+        throw new CliError("validation_error", `${name} is too long for a voice message — nothing was sent`);
+    return voiceOf(name, Buffer.from(await body.arrayBuffer()));
+};
+export const prepareUploads = async (options) => {
+    const files = await Promise.all((options.files ?? []).map(async (path) => ({
+        path,
+        body: await openUpload(path, { anyFile: options.anyFile === true }),
+        kind: isImage(path) ? "photo" : isVideo(path) && options.asFile !== true ? "video" : "file",
+    })));
+    for (const { name, body, kind } of options.uploads ?? [])
+        files.push({ path: name, body, kind, ...(kind === "voice" ? { voice: await voice(name, body) } : {}) });
+    if (options.voice !== undefined) {
+        const body = await openUpload(options.voice, { anyFile: options.anyFile === true });
+        files.push({ path: options.voice, body, kind: "voice", voice: await voice(options.voice, body) });
+    }
+    return files;
+};
+//# sourceMappingURL=uploads.js.map

package/dist/client/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../../src/client/uploads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAWrC,4GAA4G;AAC5G,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAE,IAAU,EAAE,EAAE;IAC/C,IAAI,IAAI,CAAC,IAAI,GAAG,yBAAyB;QACvC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,qDAAqD,CAAC,CAAA;IACtG,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AAC7D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAwB,EAAqB,EAAE;IAClF,MAAM,KAAK,GAAa,MAAM,OAAO,CAAC,GAAG,CACvC,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI;QACJ,IAAI,EAAE,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACnE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;KAC5F,CAAC,CAAC,CACJ,CAAA;IACD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACzG,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC,CAAA;QACnF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IACnG,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}