@mapier/imsg-sdk 0.6.0 → 0.8.0

package/dist/gateway/multipart.d.ts

@@ -0,0 +1,38 @@
+import type { GatewayCapabilities, MultipartPart, MultipartResult, NumericTextFormatRange } from './types.js';
+export declare const MULTIPART_MAX_PARTS = 100;
+export declare const MULTIPART_MAX_FILE_PARTS = 40;
+export declare const MULTIPART_PROVEN_REJECTIONS: readonly string[];
+export declare function classifyMultipartFireFailure(err: unknown): MultipartResult;
+export type MultipartWirePart = {
+    type: 'text';
+    text: string;
+    text_formatting?: NumericTextFormatRange[];
+} | {
+    type: 'file';
+    file: string;
+};
+export interface MultipartWireParams {
+    chat_id: number;
+    parts: MultipartWirePart[];
+    reply_to?: string;
+    effect?: string;
+    subject?: string;
+}
+export interface MultipartSendResponse {
+    ok: boolean;
+    guid?: string;
+    message_id?: string;
+    parts_count?: number;
+}
+export interface MultipartSendOptions {
+    replyToGuid?: string;
+    effect?: string;
+    subject?: string;
+}
+export declare function multipartRefusalReason(parts: readonly MultipartPart[]): string | null;
+export declare function multipartPreflight(capabilities: Pick<GatewayCapabilities, 'multipartSend' | 'mentionFormatting'>, parts: readonly MultipartPart[]): {
+    result: MultipartResult;
+    reason: string;
+} | null;
+export declare function multipartWireParams(chatId: number, parts: readonly MultipartPart[], opts?: MultipartSendOptions): MultipartWireParams;
+export declare function multipartResultFromResponse(response: MultipartSendResponse): MultipartResult;

package/dist/gateway/multipart.js

@@ -0,0 +1,216 @@
+import { bridgeEffectStarted } from './chat-background.js';
+import { hasMentionRange, multipartFailure, resolveTextFormatting, textFormattingRefusal } from './types.js';
+// What a Mac will ever accept in one multipart message, mirroring the native
+// caps exactly (`MultipartLimits` in MultipartParts.swift and
+// `kMaxMultipartParts` / `kMaxMultipartFileParts` in IMsgInjected.m). Checked
+// here so an over-long list is a proven no-op instead of a round trip.
+//
+// The native side also caps the file parts' TOTAL BYTES at 100 MiB
+// (`kMaxMultipartFileBytes`). That one is deliberately NOT mirrored: this SDK
+// never stats a file — it passes the caller's path through, exactly as
+// `sendAttachment` does — so the byte cap stays the Mac's refusal, classified
+// through MULTIPART_PROVEN_REJECTIONS below.
+export const MULTIPART_MAX_PARTS = 100;
+export const MULTIPART_MAX_FILE_PARTS = 40;
+// handleSendMultipart's `errorResponse` returns BEFORE `dispatchAttempted`
+// (IMsgInjected.m), plus the formatting refusals it forwards from
+// `buildFormattedAttributed` (IMsgMentionFormatting.m), matched against
+// `error.data` exactly as the other bridge verbs match theirs. Several are
+// formatted with the part index in the middle ("Part 3 file not found: …"), so
+// the needles are the stable fragments rather than prefixes.
+//
+// Deliberately absent: `send-multipart failed:` — that wraps an NSException
+// caught around the whole build-and-dispatch block, so the text cannot prove
+// which side of `dispatchIMMessageInChat` it was raised on and the result stays
+// ambiguous.
+export const MULTIPART_PROVEN_REJECTIONS = [
+    'Missing chatGuid',
+    'Missing or empty parts array',
+    'Too many parts',
+    'Too many file parts',
+    'File parts total too many bytes',
+    'isAudioMessage is not supported on a multipart message',
+    // Formatted with the guid appended, so the match has to be a fragment.
+    'Chat not found',
+    'is not an object',
+    'has both text and filePath',
+    'has neither text nor filePath',
+    'file not found',
+    'symlinked attachment paths are not allowed',
+    'attachment path traverses a symlink',
+    'transfer registered without guid',
+    'Could not register attachment transfer',
+    'Could not construct multipart IMMessage',
+    // Pass 1 validates every text part's formatting against the live chat before
+    // a single transfer is prepared, so these are pre-staging refusals here even
+    // though sendRich meets them at its own fire time.
+    'Invalid text formatting',
+    'Mention identifier',
+    'Mention range',
+    'Mention formatting requires',
+    'Confirmed mention formatting is unavailable',
+];
+// The send itself threw. `refused` only when the error proves the helper
+// stopped before IMChat was invoked; everything else — a bridge timeout, an
+// exception raised after the dispatch, a dead rpc child — may already have put
+// the message in the thread.
+export function classifyMultipartFireFailure(err) {
+    return multipartFailure(bridgeEffectStarted(err, MULTIPART_PROVEN_REJECTIONS) ? 'fire-failed' : 'refused');
+}
+// The declared types do not run at runtime, so the list is validated the way
+// the native handler reads it — as values of unknown shape — rather than as the
+// union TypeScript promises. An untyped JS caller can send a null entry, a
+// `textFormatting` on a file part, or a single range object where an array
+// belongs, and each of those must refuse rather than throw.
+function isObject(value) {
+    return value !== null && typeof value === 'object';
+}
+// The native side reads an empty string as "absent" on both part keys
+// (`.nonEmpty`), so "carries both halves" means both are really there.
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value !== '';
+}
+// True when any part asks for a confirmed mention, tolerating parts this is
+// asked about before they have been validated.
+function mentionsSomeone(parts) {
+    return parts.some((part) => {
+        if (!isObject(part))
+            return false;
+        const ranges = part.textFormatting;
+        return Array.isArray(ranges) && hasMentionRange(ranges);
+    });
+}
+// Every rule the native side enforces, checked here so a bad list is a proven
+// no-op instead of a round trip. Returns the line to log, or null.
+//
+// One native check is deliberately NOT mirrored: that each file part's path
+// exists, is not a symlink and is inside the byte budget. This SDK never
+// touches the filesystem — the fake runs where the Mac's files are not, and the
+// real gateway's path is the MAC's path — so a local `existsSync` would make
+// the fake and the real path disagree in both directions. A missing file is the
+// Mac's refusal, classified through MULTIPART_PROVEN_REJECTIONS.
+export function multipartRefusalReason(parts) {
+    const rawParts = parts;
+    if (!Array.isArray(rawParts))
+        return 'parts must be an array';
+    if (rawParts.length === 0)
+        return 'parts must not be empty';
+    if (rawParts.length > MULTIPART_MAX_PARTS) {
+        return `too many parts: ${rawParts.length} (max ${MULTIPART_MAX_PARTS})`;
+    }
+    const fileParts = rawParts.filter((part) => isObject(part) && part.kind === 'file').length;
+    if (fileParts > MULTIPART_MAX_FILE_PARTS) {
+        return `too many file parts: ${fileParts} (max ${MULTIPART_MAX_FILE_PARTS})`;
+    }
+    for (const [index, part] of rawParts.entries()) {
+        if (!isObject(part))
+            return `part ${index} must be an object`;
+        const kind = part.kind;
+        // A part carrying BOTH halves is refused before its `kind` is consulted,
+        // never resolved by the label: whichever branch ran would drop the other
+        // key without a word, and losing part content in silence is the one failure
+        // this verb exists to remove — it must not come back in through a caller
+        // that labels a part wrong. The native handler refuses it by index for the
+        // same reason.
+        if (isNonEmptyString(part.text) && isNonEmptyString(part.filePath)) {
+            return `part ${index}: has both text and filePath`;
+        }
+        if (kind === 'file') {
+            // Formatting on a file part is an error on the native side rather than
+            // something dropped, because a dropped one would look like a send that
+            // did what was asked.
+            if (part.textFormatting !== undefined)
+                return `part ${index}: a file part cannot carry textFormatting`;
+            const filePath = part.filePath;
+            if (typeof filePath !== 'string' || filePath === '')
+                return `part ${index}: a file part needs a filePath`;
+            // The path crosses a line-delimited JSON-RPC protocol on its way to the
+            // Mac and is then handed to the filesystem, so neither a line break nor a
+            // NUL may ride along as if it were part of a name.
+            if (filePath.includes('\n') || filePath.includes('\r') || filePath.includes('\0')) {
+                return `part ${index}: filePath must not contain newlines or NUL`;
+            }
+            continue;
+        }
+        if (kind !== 'text')
+            return `part ${index}: unknown kind ${String(kind)}`;
+        const text = part.text;
+        if (typeof text !== 'string' || text === '')
+            return `part ${index}: a text part needs text`;
+        const ranges = part.textFormatting;
+        if (ranges === undefined)
+            continue;
+        if (!Array.isArray(ranges))
+            return `part ${index}: textFormatting must be an array of ranges`;
+        if (ranges.length === 0)
+            continue;
+        // The SAME validator sendRich uses, per part: the helper builds each part's
+        // attributed run on its own and silently DROPS a style range with bad
+        // offsets while sending the rest, which a caller cannot detect because
+        // formatting is write-only.
+        const refusal = textFormattingRefusal(text, ranges);
+        if (refusal)
+            return `part ${index}: ${refusal.reason}`;
+    }
+    return null;
+}
+// The whole sendMultipart preflight, shared by both gateways so parity is
+// structural: the capability gates first, then the list rules. Returns the
+// result to answer with plus a line to log, or null to fire. Nothing has been
+// sent at any exit here, so every one of them is `effectStarted:false`.
+export function multipartPreflight(capabilities, parts) {
+    if (!capabilities.multipartSend) {
+        return { result: multipartFailure('unsupported'), reason: 'bridge does not advertise multipartSend' };
+    }
+    const rawParts = parts;
+    if (!Array.isArray(rawParts)) {
+        return { result: multipartFailure('refused'), reason: 'parts must be an array' };
+    }
+    // A confirmed mention needs the helper's runtime-resolved attribute key, the
+    // same gate sendRich applies — without it the helper fails the whole send
+    // rather than degrading to plain text. `unsupported`, not `refused`, because
+    // no build on this host can do it (the extensionCardUpdate precedent).
+    if (mentionsSomeone(rawParts) && !capabilities.mentionFormatting) {
+        return { result: multipartFailure('unsupported'), reason: 'bridge does not advertise mentionFormatting' };
+    }
+    const refusal = multipartRefusalReason(parts);
+    return refusal ? { result: multipartFailure('refused'), reason: refusal } : null;
+}
+export function multipartWireParams(chatId, parts, opts = {}) {
+    return {
+        chat_id: chatId,
+        parts: parts.map((part) => part.kind === 'file'
+            ? { type: 'file', file: part.filePath }
+            : {
+                type: 'text',
+                text: part.text,
+                // Effect names resolved to Apple's ids, the same shape send.rich
+                // takes; an empty array carries nothing and is left off.
+                ...(part.textFormatting?.length ? { text_formatting: resolveTextFormatting(part.textFormatting) } : {}),
+            }),
+        // Message-wide, and read by the native handler exactly as send.rich reads
+        // them (`rpcReplyToParam`, `rpcExpressiveEffectParam`, `subject`).
+        ...(opts.subject !== undefined ? { subject: opts.subject } : {}),
+        ...(opts.effect ? { effect: opts.effect } : {}),
+        ...(opts.replyToGuid ? { reply_to: opts.replyToGuid } : {}),
+    };
+}
+// Build the caller's result out of the host's response. Shared by both
+// gateways, so neither can invent a field the other cannot report.
+export function multipartResultFromResponse(response) {
+    // The native handler answers `ok:true` on every path that reaches a result
+    // and raises a JSON-RPC error otherwise, so a falsy `ok` is a host the SDK
+    // cannot read. It was invoked, so it is ambiguous, not a refusal.
+    if (!response.ok)
+        return multipartFailure('fire-failed');
+    const guid = response.guid || response.message_id || undefined;
+    return {
+        ok: true,
+        ...(guid ? { guid } : {}),
+        // The host's own count of the parts it built, never the caller's list
+        // length: a count shorter than the list is how a helper that dropped file
+        // parts shows up, and inventing the number would hide exactly that.
+        ...(typeof response.parts_count === 'number' ? { partCount: response.parts_count } : {}),
+    };
+}
+//# sourceMappingURL=multipart.js.map

package/dist/gateway/multipart.js.map

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

package/dist/gateway/sticker.d.ts

@@ -0,0 +1,13 @@
+import type { StickerSendResponse } from '../imsg/rpc.js';
+import type { SendResult } from '../types.js';
+import type { GatewayCapabilities, StickerPlacement } from './types.js';
+export declare function stickerResultFromResponse(response: StickerSendResponse): SendResult;
+export declare function stickerPlacementFields(placement: StickerPlacement | undefined): StickerPlacement | undefined;
+export declare function stickerPreflight(capabilities: Pick<GatewayCapabilities, 'stickerPlacement'>, opts: {
+    attachToGuid?: string;
+    partIndex?: number;
+    placement?: StickerPlacement;
+} | undefined): {
+    result: SendResult;
+    reason: string;
+} | null;

package/dist/gateway/sticker.js

@@ -0,0 +1,115 @@
+// Build the caller's result out of the host's response. Shared by both
+// gateways, so neither can invent a field the other cannot report.
+export function stickerResultFromResponse(response) {
+    // The native handler answers `ok:true` on every path that reaches a result
+    // and raises a JSON-RPC error otherwise, so a falsy `ok` is a host the SDK
+    // cannot read. It was invoked, so nothing here claims the send was refused.
+    if (!response.ok)
+        return { ok: false };
+    // `guid` and `message_id` carry the same MESSAGE guid, so `message_id` is the
+    // fallback when only it is reported. `transfer_guid` is deliberately NOT read:
+    // it names the upload, not the row, and no consumer asks for it.
+    const guid = response.guid || response.message_id || undefined;
+    // There is deliberately no numeric `id`: the native result sets `message_id`
+    // to the message GUID, so no rowid exists on the real path — the same reason
+    // `sendMultipart` has none. A guid Messages never exposed is left absent
+    // rather than invented; the sticker still went.
+    return { ok: true, ...(guid ? { guid } : {}) };
+}
+// The four placement knobs, in the order the contract lists them.
+const PLACEMENT_FIELDS = ['x', 'y', 'scale', 'rotation'];
+// SANITY bounds, deliberately far wider than any sensible placement and equal
+// to the helper's own. The PRODUCT range (x,y -5…6, scale 0.1…5, rotation
+// ±180) belongs at the `/v1` door, which is one service and can be loosened
+// without a fleet-wide Mac release; these exist only so a number that could
+// never have been meant — a pixel count, a radian mistaken for a degree, a
+// stray exponent — is refused before it reaches a Mac. Out of bounds is
+// REFUSED, never clamped: a silently moved sticker is indistinguishable from
+// one the caller placed, and the phone has no clamp of its own to imitate.
+const PLACEMENT_BOUNDS = {
+    x: [-100, 100],
+    y: [-100, 100],
+    scale: [0.01, 20],
+    rotation: [-3600, 3600],
+};
+function isPlacementField(key) {
+    return PLACEMENT_FIELDS.includes(key);
+}
+// Only the fields the caller actually gave, or `undefined` when none were —
+// which is also what an empty `placement` object means. An omitted field is
+// NOT defaulted here: the helper owns the defaults (centre, normal size, no
+// rotation), so a frame carrying only what was asked for is the one thing that
+// keeps "no placement" byte-identical to the request every deployed helper has
+// always answered.
+export function stickerPlacementFields(placement) {
+    if (!placement)
+        return undefined;
+    const given = {};
+    for (const field of PLACEMENT_FIELDS) {
+        const value = placement[field];
+        if (value !== undefined)
+            given[field] = value;
+    }
+    return Object.keys(given).length > 0 ? given : undefined;
+}
+function refuse(refused, reason) {
+    return { result: { ok: false, refused }, reason };
+}
+// The whole sendSticker preflight, shared by both gateways. Returns the result
+// to answer with plus a line to log, or null to fire. Nothing has been sent at
+// any exit here, and every one of them carries a typed `refused` so a consumer
+// can tell a proven no-op from a send that failed in flight.
+//
+// Order: the placement object has to be READABLE before we can tell whether a
+// placement was asked for at all, so malformed shape is caught first; after
+// that the capability gate comes before the value rules, the way
+// `multipartPreflight` puts its gates first.
+export function stickerPreflight(capabilities, opts) {
+    const raw = opts?.placement;
+    if (raw === undefined)
+        return null;
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        return refuse('sticker-placement-shape', 'placement must be an object');
+    }
+    // An unknown key is refused rather than dropped, and BEFORE the empty check:
+    // `{rotate: 15}` is a caller who meant to place the sticker, and quietly
+    // sending it centred would look exactly like a placement that worked.
+    const unknown = Object.keys(raw).filter((key) => !isPlacementField(key));
+    if (unknown.length > 0) {
+        return refuse('sticker-placement-shape', `placement has unknown field(s): ${unknown.join(', ')}`);
+    }
+    const given = stickerPlacementFields(raw);
+    // `{}` — or a placement whose every field is undefined — asks for nothing, so
+    // it is not a placed send at all: no gate, no target rule, no wire key.
+    if (given === undefined)
+        return null;
+    // The marker gates a loud rejection, not a silent loss (unlike `tapbackPart`
+    // and `multipartSend`): a helper without it answers `-32602` and sends
+    // nothing. Refusing here turns that round trip into a typed answer, and lets
+    // a host announce placement support to its own backend.
+    if (!capabilities.stickerPlacement) {
+        return refuse('sticker-placement-capability', 'bridge does not advertise stickerPlacement');
+    }
+    // Every sticker a phone produces is tied to a message and a part — the six
+    // placed by hand on a real phone included, and including the ones dropped in
+    // empty space well off a bubble. "Off the bubble" is an offset from a target,
+    // never the absence of one, so a placement with nothing to measure against is
+    // a caller error rather than a free-standing sticker.
+    if (opts?.attachToGuid === undefined || opts.attachToGuid === '') {
+        return refuse('sticker-placement-target', 'placement needs the message it sits on (attachToGuid)');
+    }
+    for (const field of PLACEMENT_FIELDS) {
+        const value = given[field];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'number' || !Number.isFinite(value)) {
+            return refuse('sticker-placement-shape', `placement.${field} must be a finite number`);
+        }
+        const [min, max] = PLACEMENT_BOUNDS[field];
+        if (value < min || value > max) {
+            return refuse('sticker-placement-range', `placement.${field} ${value} is outside ${min}…${max}`);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=sticker.js.map

package/dist/gateway/sticker.js.map

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

package/dist/gateway/types.d.ts

@@ -74,6 +74,14 @@ export interface GatewayCapabilities {
     locationRequest: boolean;
     extensionCardSend: boolean;
     extensionCardUpdate: boolean;
+    multipartSend: boolean;
+    stickerPlacement: boolean;
+}
+export interface StickerPlacement {
+    x?: number;
+    y?: number;
+    scale?: number;
+    rotation?: number;
 }
 export declare const PATCHED_GATEWAY_CAPABILITIES: GatewayCapabilities;
 export interface SharedLocation {
@@ -162,6 +170,22 @@ export interface ExtensionCardResult {
     reason?: GroupMutationFailure;
 }
 export declare function extensionCardFailure(reason: GroupMutationFailure): ExtensionCardResult;
+export type MultipartPart = {
+    kind: 'text';
+    text: string;
+    textFormatting?: TextFormatRange[];
+} | {
+    kind: 'file';
+    filePath: string;
+};
+export interface MultipartResult {
+    ok: boolean;
+    guid?: string;
+    partCount?: number;
+    effectStarted?: boolean;
+    reason?: GroupMutationFailure;
+}
+export declare function multipartFailure(reason: GroupMutationFailure): MultipartResult;
 export declare const GROUP_MIN_MEMBERS = 3;
 export declare function removalWouldBreakGroupMinimum(participantCount: number): boolean;
 export declare const TIER2_HISTORY_SCAN_WINDOW = 30;
@@ -273,6 +297,7 @@ export interface Gateway {
     sendSticker(chatId: number, filePath: string, opts?: {
         attachToGuid?: string;
         partIndex?: number;
+        placement?: StickerPlacement;
     }): Promise<SendResult>;
     sendPoll(chatId: number, question: string, options: string[]): Promise<SendResult>;
     votePoll(chatId: number, pollGuid: string, optionId: string): Promise<ReactResult>;
@@ -280,6 +305,11 @@ export interface Gateway {
     sendExtensionCard(chatId: number, card: ExtensionCard, opts?: {
         update?: ExtensionCardHandle;
     }): Promise<ExtensionCardResult>;
+    sendMultipart(chatId: number, parts: readonly MultipartPart[], opts?: {
+        replyToGuid?: string;
+        effect?: string;
+        subject?: string;
+    }): Promise<MultipartResult>;
     editMessage(chatId: number, targetGuid: string, text: string): Promise<EditMessageResult>;
     unsendMessage(chatId: number, targetGuid: string): Promise<MessageRemovalResult>;
     deleteMessage(chatId: number, targetGuid: string): Promise<MessageRemovalResult>;

package/dist/gateway/types.js

@@ -22,6 +22,8 @@ export const PATCHED_GATEWAY_CAPABILITIES = {
     locationRequest: true,
     extensionCardSend: true,
     extensionCardUpdate: true,
+    multipartSend: true,
+    stickerPlacement: true,
 };
 export const LOCATION_SHARE_EVENTS = ['location_update', 'share_started', 'share_ended'];
 // The only preset the native Set pipeline supports today (Mapier-Labs/imsg#12,
@@ -54,6 +56,9 @@ export function messageRemovalFailure(reason) {
 export function extensionCardFailure(reason) {
     return { ok: false, effectStarted: GROUP_MUTATION_EFFECT_STARTED[reason], reason };
 }
+export function multipartFailure(reason) {
+    return { ok: false, effectStarted: GROUP_MUTATION_EFFECT_STARTED[reason], reason };
+}
 // Apple keeps a group conversation at three or more members, the local user
 // included: a removal that would drop it below that is silently refused —
 // IMCore's `removeParticipants:reason:` returns normally and the membership

package/dist/gateway/types.js.map

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

package/dist/imsg/rpc.d.ts

@@ -1,6 +1,7 @@
 import type { ExtensionCardSendResponse, ExtensionCardWireParams } from '../gateway/extension-card.js';
+import type { MultipartSendResponse, MultipartWireParams } from '../gateway/multipart.js';
 import { type LocationsReadWire } from '../gateway/locations.js';
-import type { LocationUpdate, MessageService, NumericTextFormatRange, Reaction } from '../gateway/types.js';
+import type { LocationUpdate, MessageService, NumericTextFormatRange, Reaction, StickerPlacement } from '../gateway/types.js';
 import type { ImsgMessage, MessagePoll, SendResult } from '../types.js';
 export declare class ImsgRpcError extends Error {
     readonly code: number;
@@ -62,9 +63,9 @@ export interface HandleCheckResponse {
 }
 export interface StickerSendResponse {
     ok: boolean;
-    transfer_guid: string;
     guid?: string;
-    message_id?: number;
+    message_id?: string;
+    transfer_guid?: string;
 }
 export interface CreateChatResponse {
     ok: boolean;
@@ -164,6 +165,7 @@ export declare class ImsgRpc {
         audio?: boolean;
         replyToGuid?: string;
     }): Promise<SendResult>;
+    sendMultipart(params: MultipartWireParams): Promise<MultipartSendResponse>;
     messageSendStatus(guid: string): Promise<SendStatusResponse>;
     checkHandle(address: string, opts?: {
         aliasType?: 'phone' | 'email';
@@ -171,6 +173,7 @@ export declare class ImsgRpc {
     sendSticker(chatId: number, filePath: string, opts?: {
         attachToGuid?: string;
         partIndex?: number;
+        placement?: StickerPlacement;
     }): Promise<StickerSendResponse>;
     sendPoll(chatId: number, question: string, options: string[]): Promise<PollSendResponse>;
     votePoll(chatId: number, pollGuid: string, optionId: string): Promise<{

package/dist/imsg/rpc.js

@@ -1,6 +1,7 @@
 import { spawn } from 'node:child_process';
 import { createInterface } from 'node:readline';
 import { locationUpdateFromWire } from '../gateway/locations.js';
+import { stickerPlacementFields } from '../gateway/sticker.js';
 import { reportRuntimeIssue } from '../runtime-report.js';
 import { imsgBinary } from './binary.js';
 export class ImsgRpcError extends Error {
@@ -238,6 +239,14 @@ export class ImsgRpc {
             ...(opts.replyToGuid ? { reply_to: opts.replyToGuid } : {}),
         });
     }
+    // `send.multipart` (RPCServer+MultipartHandler.swift): one message built from
+    // the parts in the order given, with the message-wide effect/subject/reply
+    // read exactly as `send.rich` reads them. The params are already in the
+    // native spelling — see `multipartWireParams` for why `type` is explicit on
+    // every part.
+    sendMultipart(params) {
+        return this.request('send.multipart', params);
+    }
     // Wire shape transcribed from the Mapier fork's docs/rpc.md
     // `message.send_status` response (mapier/macos26-tier2).
     messageSendStatus(guid) {
@@ -254,12 +263,21 @@ export class ImsgRpc {
     // Wire shape transcribed from the Mapier fork's docs/rpc.md
     // `send.sticker` response (mapier/macos26-tier2). part_index is invalid
     // without attach_to, so it is omitted unless both are supplied.
+    //
+    // `placement` carries only the fields the caller gave, as plain JSON numbers
+    // in the public units (M2B-56); the helper fills in the rest and converts to
+    // Apple's own. A send with no placement — or an empty one — omits the key
+    // ENTIRELY rather than sending `{}`: the helper's param allowlist is strict,
+    // so an unexpected key is a rejected request, and the frame must stay
+    // byte-identical to the one every deployed helper already answers.
     sendSticker(chatId, filePath, opts = {}) {
+        const placement = stickerPlacementFields(opts.placement);
         return this.request('send.sticker', {
             chat_id: chatId,
             file: filePath,
             ...(opts.attachToGuid ? { attach_to: opts.attachToGuid } : {}),
             ...(opts.attachToGuid && opts.partIndex !== undefined ? { part_index: opts.partIndex } : {}),
+            ...(placement ? { placement } : {}),
         });
     }
     // Verified against openclaw/imsg 0.13.x source: `poll.send`