@stapel/chat-react 0.1.0

package/dist/i18n/generated/errors.ru.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.ru.gen.js","sourceRoot":"","sources":["../../../src/i18n/generated/errors.ru.gen.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2C;IACvE,uBAAuB,EAAE,qBAAqB;IAC9C,2BAA2B,EAAE,6DAA6D;IAC1F,4BAA4B,EAAE,wBAAwB;IACtD,yBAAyB,EAAE,2BAA2B;IACtD,uBAAuB,EAAE,qCAAqC;IAC9D,gCAAgC,EAAE,yBAAyB;IAC3D,yBAAyB,EAAE,+CAA+C;IAC1E,gCAAgC,EAAE,yCAAyC;IAC3E,4BAA4B,EAAE,gEAAgE;IAC9F,2BAA2B,EAAE,2DAA2D;IACxF,4BAA4B,EAAE,gEAAgE;IAC9F,2BAA2B,EAAE,2DAA2D;IACxF,sBAAsB,EAAE,mCAAmC;IAC3D,0BAA0B,EAAE,4BAA4B;IACxD,wBAAwB,EAAE,gDAAgD;IAC1E,yBAAyB,EAAE,uCAAuC;IAClE,4BAA4B,EAAE,kBAAkB;IAChD,+BAA+B,EAAE,sBAAsB;IACvD,uCAAuC,EAAE,sCAAsC;IAC/E,wBAAwB,EAAE,0BAA0B;IACpD,4BAA4B,EAAE,kBAAkB;IAChD,qBAAqB,EAAE,8CAA8C;IACrE,2BAA2B,EAAE,oCAAoC;IACjE,4CAA4C,EAAE,8CAA8C;IAC5F,iCAAiC,EAAE,mCAAmC;IACtE,wBAAwB,EAAE,uBAAuB;IACjD,qBAAqB,EAAE,8BAA8B;IACrD,4CAA4C,EAAE,6CAA6C;IAC3F,8BAA8B,EAAE,mBAAmB;IACnD,0BAA0B,EAAE,4BAA4B;IACxD,2BAA2B,EAAE,gCAAgC;IAC7D,oBAAoB,EAAE,uBAAuB;IAC7C,gBAAgB,EAAE,gCAAgC;IAClD,6BAA6B,EAAE,8BAA8B;IAC7D,kCAAkC,EAAE,6BAA6B;IACjE,gCAAgC,EAAE,sCAAsC;IACxE,kBAAkB,EAAE,qBAAqB;IACzC,+BAA+B,EAAE,+DAA+D;IAChG,sBAAsB,EAAE,2EAA2E;IACnG,6BAA6B,EAAE,8DAA8D;IAC7F,oBAAoB,EAAE,qBAAqB;IAC3C,+BAA+B,EAAE,qDAAqD;CACvF,CAAC"}

package/dist/i18n/keys.d.ts

@@ -0,0 +1,78 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+/**
+ * chat-react's own translation KEYS (frontend-standard §4.2): headless
+ * components never render literal strings — hosts resolve these via core's
+ * i18n engine (`useT`). Backend error codes flow through the SAME contour: a
+ * `StapelApiError.code` is already a key, so the default bundle below ships
+ * English fallbacks for both the backend error codes (generated) and the
+ * pair's own UI keys.
+ */
+export declare const CHAT_I18N_KEYS: {
+    readonly unknownError: "chat.error.unknown";
+    readonly listTitle: "chat.list.title";
+    readonly listEmpty: "chat.list.empty";
+    readonly listLoading: "chat.list.loading";
+    readonly listLoadMore: "chat.list.load_more";
+    readonly listEnd: "chat.list.end";
+    readonly listRetry: "chat.list.retry";
+    readonly listUnread: "chat.list.unread";
+    readonly listOpen: "chat.list.open";
+    readonly kindDirect: "chat.kind.direct";
+    readonly kindGroup: "chat.kind.group";
+    readonly kindSupport: "chat.kind.support";
+    readonly threadLoading: "chat.thread.loading";
+    readonly threadEmpty: "chat.thread.empty";
+    readonly threadRetry: "chat.thread.retry";
+    readonly threadLoadOlder: "chat.thread.load_older";
+    readonly threadBeginning: "chat.thread.beginning";
+    readonly threadSystem: "chat.thread.system";
+    readonly composerPlaceholder: "chat.composer.placeholder";
+    readonly composerSend: "chat.composer.send";
+    readonly composerSending: "chat.composer.sending";
+    readonly composerBlockedEmpty: "chat.composer.blocked.empty";
+    readonly composerBlockedTooLong: "chat.composer.blocked.too_long";
+    readonly startButton: "chat.start.button";
+    readonly startStarting: "chat.start.starting";
+    readonly startBlockedSelf: "chat.start.blocked.self";
+    readonly startBlockedUnknownSeller: "chat.start.blocked.unknown_seller";
+    readonly transportLive: "chat.transport.live";
+    readonly transportPolling: "chat.transport.polling";
+    readonly transportIdle: "chat.transport.idle";
+    readonly errorEmptyMessage: "error.400.chat_empty_message";
+    readonly errorBodyTooLong: "error.400.chat_body_too_long";
+    readonly errorAttachmentsDisabled: "error.400.chat_attachments_disabled";
+    readonly errorInvalidDirect: "error.400.chat_invalid_direct";
+    readonly errorInvalidKind: "error.400.chat_invalid_kind";
+    readonly errorKindDisabled: "error.400.chat_kind_disabled";
+    readonly errorInvalidReply: "error.400.chat_invalid_reply";
+    readonly errorNotSupport: "error.400.chat_not_support";
+    readonly errorNotOperator: "error.403.chat_not_operator";
+    readonly errorNotParticipant: "error.403.chat_not_participant";
+    readonly errorConversationNotFound: "error.404.chat_conversation_not_found";
+    readonly errorAlreadyAssigned: "error.409.chat_already_assigned";
+    readonly navConversations: "chat.nav.conversations";
+};
+export type ChatI18nKey = (typeof CHAT_I18N_KEYS)[keyof typeof CHAT_I18N_KEYS];
+/**
+ * English fallback bundle for chat-react UI keys + backend error codes. The
+ * generated `chatErrorBundleEn` (from stapel-chat's error registry, `pnpm
+ * gen:errors`) is spread FIRST so every backend `error.*` key has a fallback —
+ * a `StapelApiError.code` never renders as a raw key. Hand-polished copy below
+ * then OVERRIDES the generated English for the keys users see most.
+ */
+export declare const chatI18nBundleEn: I18nDictionary;
+/**
+ * Register chat-react's key bundle into a core i18n engine (call once at
+ * startup). Registers under the given locale (default `"en"`).
+ *
+ * MERGE-PRIORITY CONVENTION (i18n-shipping.md §3 — every `@stapel/*-react`
+ * pair follows it): registration order IS override priority, later wins per
+ * key. Within a locale, layers register bottom-up:
+ *
+ *   1. generated en floor (`chatErrorBundleEn` — coverage by construction),
+ *   2. the pair's polish / UI copy (this bundle spreads 1 then overrides),
+ *   3. the pair's locale bundle from the `./i18n/<locale>` subpath,
+ *   4. the HOST's own bundle — always registered LAST.
+ */
+export declare function registerChatI18n(engine: I18nEngine, locale?: string): void;
+//# sourceMappingURL=keys.d.ts.map

package/dist/i18n/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/i18n/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA4C9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,SAAO,GAAG,IAAI,CAExE"}

package/dist/i18n/keys.js

@@ -0,0 +1,130 @@
+import { chatErrorBundleEn } from "./generated/errors.gen.js";
+/**
+ * chat-react's own translation KEYS (frontend-standard §4.2): headless
+ * components never render literal strings — hosts resolve these via core's
+ * i18n engine (`useT`). Backend error codes flow through the SAME contour: a
+ * `StapelApiError.code` is already a key, so the default bundle below ships
+ * English fallbacks for both the backend error codes (generated) and the
+ * pair's own UI keys.
+ */
+export const CHAT_I18N_KEYS = {
+    unknownError: "chat.error.unknown",
+    // Conversation list
+    listTitle: "chat.list.title",
+    listEmpty: "chat.list.empty",
+    listLoading: "chat.list.loading",
+    listLoadMore: "chat.list.load_more",
+    listEnd: "chat.list.end",
+    listRetry: "chat.list.retry",
+    listUnread: "chat.list.unread",
+    listOpen: "chat.list.open",
+    // Conversation kinds (the response carries no title — the kind and the
+    // participants are all a row can honestly say)
+    kindDirect: "chat.kind.direct",
+    kindGroup: "chat.kind.group",
+    kindSupport: "chat.kind.support",
+    // Thread
+    threadLoading: "chat.thread.loading",
+    threadEmpty: "chat.thread.empty",
+    threadRetry: "chat.thread.retry",
+    threadLoadOlder: "chat.thread.load_older",
+    threadBeginning: "chat.thread.beginning",
+    threadSystem: "chat.thread.system",
+    // Composer
+    composerPlaceholder: "chat.composer.placeholder",
+    composerSend: "chat.composer.send",
+    composerSending: "chat.composer.sending",
+    composerBlockedEmpty: "chat.composer.blocked.empty",
+    composerBlockedTooLong: "chat.composer.blocked.too_long",
+    // "Message the seller"
+    startButton: "chat.start.button",
+    startStarting: "chat.start.starting",
+    startBlockedSelf: "chat.start.blocked.self",
+    startBlockedUnknownSeller: "chat.start.blocked.unknown_seller",
+    // Transport (the seam is invisible to the UI's BEHAVIOUR, but a person may
+    // still be told whether the thread is live or on a timer)
+    transportLive: "chat.transport.live",
+    transportPolling: "chat.transport.polling",
+    transportIdle: "chat.transport.idle",
+    // Backend error keys the pair OWNS the localization of. stapel-chat ships
+    // English only (it has no `translations/` directory), so its 12 keys are
+    // absent from the generated ru/es bundles and are authored here instead —
+    // the stapel-forms/stapel_attributes precedent. Listed as keys so the
+    // i18n-key-exists lint knows them and `test/i18n.test.ts` can prove all
+    // three locales carry them.
+    errorEmptyMessage: "error.400.chat_empty_message",
+    errorBodyTooLong: "error.400.chat_body_too_long",
+    errorAttachmentsDisabled: "error.400.chat_attachments_disabled",
+    errorInvalidDirect: "error.400.chat_invalid_direct",
+    errorInvalidKind: "error.400.chat_invalid_kind",
+    errorKindDisabled: "error.400.chat_kind_disabled",
+    errorInvalidReply: "error.400.chat_invalid_reply",
+    errorNotSupport: "error.400.chat_not_support",
+    errorNotOperator: "error.403.chat_not_operator",
+    errorNotParticipant: "error.403.chat_not_participant",
+    errorConversationNotFound: "error.404.chat_conversation_not_found",
+    errorAlreadyAssigned: "error.409.chat_already_assigned",
+    // Nav-manifest label (`../nav/manifest.ts`) — read by a shell via
+    // `t(entry.labelKey)`.
+    navConversations: "chat.nav.conversations",
+};
+/**
+ * English fallback bundle for chat-react UI keys + backend error codes. The
+ * generated `chatErrorBundleEn` (from stapel-chat's error registry, `pnpm
+ * gen:errors`) is spread FIRST so every backend `error.*` key has a fallback —
+ * a `StapelApiError.code` never renders as a raw key. Hand-polished copy below
+ * then OVERRIDES the generated English for the keys users see most.
+ */
+export const chatI18nBundleEn = {
+    // Backend error codes — generated en fallbacks (coverage by construction).
+    ...chatErrorBundleEn,
+    // chat-react UI
+    "chat.error.unknown": "Something went wrong. Please try again.",
+    "chat.list.title": "Messages",
+    "chat.list.empty": "No conversations yet.",
+    "chat.list.loading": "Loading conversations…",
+    "chat.list.load_more": "Load more",
+    "chat.list.end": "That's everything.",
+    "chat.list.retry": "Try again",
+    "chat.list.unread": "{count} unread",
+    "chat.list.open": "Open",
+    "chat.kind.direct": "Direct message",
+    "chat.kind.group": "Group",
+    "chat.kind.support": "Support",
+    "chat.thread.loading": "Loading messages…",
+    "chat.thread.empty": "No messages yet. Say hello.",
+    "chat.thread.retry": "Try again",
+    "chat.thread.load_older": "Show earlier messages",
+    "chat.thread.beginning": "This is the beginning of the conversation.",
+    "chat.thread.system": "System",
+    "chat.composer.placeholder": "Write a message…",
+    "chat.composer.send": "Send",
+    "chat.composer.sending": "Sending…",
+    "chat.composer.blocked.empty": "Write something first.",
+    "chat.composer.blocked.too_long": "That is longer than {max} characters — shorten it a little.",
+    "chat.start.button": "Message the seller",
+    "chat.start.starting": "Opening…",
+    "chat.start.blocked.self": "This is your own listing.",
+    "chat.start.blocked.unknown_seller": "This listing has no seller to write to.",
+    "chat.transport.live": "Live",
+    "chat.transport.polling": "Refreshing every few seconds",
+    "chat.transport.idle": "Paused",
+    "chat.nav.conversations": "Messages",
+};
+/**
+ * Register chat-react's key bundle into a core i18n engine (call once at
+ * startup). Registers under the given locale (default `"en"`).
+ *
+ * MERGE-PRIORITY CONVENTION (i18n-shipping.md §3 — every `@stapel/*-react`
+ * pair follows it): registration order IS override priority, later wins per
+ * key. Within a locale, layers register bottom-up:
+ *
+ *   1. generated en floor (`chatErrorBundleEn` — coverage by construction),
+ *   2. the pair's polish / UI copy (this bundle spreads 1 then overrides),
+ *   3. the pair's locale bundle from the `./i18n/<locale>` subpath,
+ *   4. the HOST's own bundle — always registered LAST.
+ */
+export function registerChatI18n(engine, locale = "en") {
+    engine.registerBundle(locale, chatI18nBundleEn);
+}
+//# sourceMappingURL=keys.js.map

package/dist/i18n/keys.js.map

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

package/dist/i18n/ru.d.ts

@@ -0,0 +1,28 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+export { chatErrorBundleRu } from "./generated/errors.ru.gen.js";
+/**
+ * Russian bundle for chat-react — the pair's `ru` locale, shipped as the
+ * `@stapel/chat-react/i18n/ru` subpath (i18n-shipping.md §2) so the locale is
+ * opt-in: hosts that don't register it never carry these strings (the main
+ * entry does not import this module — gated by size-limit + the bundle-purity
+ * test).
+ *
+ * TWO SOURCES, ON PURPOSE. The generated `chatErrorBundleRu` covers the 42
+ * cross-cutting keys stapel-core owns and localizes. The 12 keys stapel-chat
+ * owns are NOT in it, and cannot be: the module ships no `translations/`
+ * directory at all, so the generator emits a `Partial` bundle and says so in
+ * its own header (`ERRORS_LOCALE_EXEMPT_OWNERS`, the stapel-forms precedent).
+ * They are authored below, beside the UI copy. When upstream ships
+ * `translations/errors.ru.json`, these twelve lines are deleted and the
+ * generated bundle covers them — the keys and the texts do not move.
+ */
+export declare const chatI18nBundleRu: I18nDictionary;
+/**
+ * Register the pair's `ru` locale into a core i18n engine (call once at
+ * startup, after {@link registerChatI18n}). Layers per the merge-priority
+ * convention (i18n-shipping.md §3): the en floor is registered UNDER the ru
+ * texts inside the `ru` locale, so a key the ru bundle ever misses degrades to
+ * its English text — never to a raw key.
+ */
+export declare function registerChatI18nRu(engine: I18nEngine): void;
+//# sourceMappingURL=ru.d.ts.map

package/dist/i18n/ru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ru.d.ts","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA+D9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAG3D"}

package/dist/i18n/ru.js

@@ -0,0 +1,80 @@
+import { chatI18nBundleEn } from "./keys.js";
+import { chatErrorBundleRu } from "./generated/errors.ru.gen.js";
+export { chatErrorBundleRu } from "./generated/errors.ru.gen.js";
+/**
+ * Russian bundle for chat-react — the pair's `ru` locale, shipped as the
+ * `@stapel/chat-react/i18n/ru` subpath (i18n-shipping.md §2) so the locale is
+ * opt-in: hosts that don't register it never carry these strings (the main
+ * entry does not import this module — gated by size-limit + the bundle-purity
+ * test).
+ *
+ * TWO SOURCES, ON PURPOSE. The generated `chatErrorBundleRu` covers the 42
+ * cross-cutting keys stapel-core owns and localizes. The 12 keys stapel-chat
+ * owns are NOT in it, and cannot be: the module ships no `translations/`
+ * directory at all, so the generator emits a `Partial` bundle and says so in
+ * its own header (`ERRORS_LOCALE_EXEMPT_OWNERS`, the stapel-forms precedent).
+ * They are authored below, beside the UI copy. When upstream ships
+ * `translations/errors.ru.json`, these twelve lines are deleted and the
+ * generated bundle covers them — the keys and the texts do not move.
+ */
+export const chatI18nBundleRu = {
+    // Backend error codes — generated ru texts for every key core owns.
+    ...chatErrorBundleRu,
+    // Backend error codes stapel-chat owns — authored here (see the note above).
+    "error.400.chat_attachments_disabled": "Вложения отключены в этой установке",
+    "error.400.chat_body_too_long": "Сообщение длиннее допустимого предела",
+    "error.400.chat_empty_message": "В сообщении должен быть текст или хотя бы одно вложение",
+    "error.400.chat_invalid_direct": "В личной переписке должен быть ровно один собеседник",
+    "error.400.chat_invalid_kind": "Неизвестный тип диалога",
+    "error.400.chat_invalid_reply": "Сообщение, на которое вы отвечаете, не из этого диалога",
+    "error.400.chat_kind_disabled": "Этот тип диалога отключён в этой установке",
+    "error.400.chat_not_support": "Это действие применимо только к обращениям в поддержку",
+    "error.403.chat_not_operator": "Это действие доступно только оператору поддержки",
+    "error.403.chat_not_participant": "Вы не участник этого диалога",
+    "error.404.chat_conversation_not_found": "Диалог не найден",
+    "error.409.chat_already_assigned": "Это обращение уже взято в работу",
+    // chat-react UI (hand-written ru mirror of the en copy in keys.ts)
+    "chat.error.unknown": "Что-то пошло не так. Попробуйте ещё раз.",
+    "chat.list.title": "Сообщения",
+    "chat.list.empty": "Диалогов пока нет.",
+    "chat.list.loading": "Загрузка диалогов…",
+    "chat.list.load_more": "Показать ещё",
+    "chat.list.end": "Это все диалоги.",
+    "chat.list.retry": "Повторить",
+    "chat.list.unread": "Непрочитанных: {count}",
+    "chat.list.open": "Открыть",
+    "chat.kind.direct": "Личная переписка",
+    "chat.kind.group": "Групповой диалог",
+    "chat.kind.support": "Поддержка",
+    "chat.thread.loading": "Загрузка сообщений…",
+    "chat.thread.empty": "Сообщений пока нет. Напишите первым.",
+    "chat.thread.retry": "Повторить",
+    "chat.thread.load_older": "Показать более ранние",
+    "chat.thread.beginning": "Это начало переписки.",
+    "chat.thread.system": "Системное сообщение",
+    "chat.composer.placeholder": "Напишите сообщение…",
+    "chat.composer.send": "Отправить",
+    "chat.composer.sending": "Отправка…",
+    "chat.composer.blocked.empty": "Сначала напишите текст.",
+    "chat.composer.blocked.too_long": "Это длиннее {max} символов — немного сократите.",
+    "chat.start.button": "Написать продавцу",
+    "chat.start.starting": "Открываем…",
+    "chat.start.blocked.self": "Это ваше собственное объявление.",
+    "chat.start.blocked.unknown_seller": "У этого объявления не указан продавец.",
+    "chat.transport.live": "На связи",
+    "chat.transport.polling": "Обновляется каждые несколько секунд",
+    "chat.transport.idle": "Приостановлено",
+    "chat.nav.conversations": "Сообщения",
+};
+/**
+ * Register the pair's `ru` locale into a core i18n engine (call once at
+ * startup, after {@link registerChatI18n}). Layers per the merge-priority
+ * convention (i18n-shipping.md §3): the en floor is registered UNDER the ru
+ * texts inside the `ru` locale, so a key the ru bundle ever misses degrades to
+ * its English text — never to a raw key.
+ */
+export function registerChatI18nRu(engine) {
+    engine.registerBundle("ru", chatI18nBundleEn);
+    engine.registerBundle("ru", chatI18nBundleRu);
+}
+//# sourceMappingURL=ru.js.map

package/dist/i18n/ru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ru.js","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,oEAAoE;IACpE,GAAG,iBAAiB;IAEpB,6EAA6E;IAC7E,qCAAqC,EAAE,qCAAqC;IAC5E,8BAA8B,EAAE,uCAAuC;IACvE,8BAA8B,EAC5B,yDAAyD;IAC3D,+BAA+B,EAC7B,sDAAsD;IACxD,6BAA6B,EAAE,yBAAyB;IACxD,8BAA8B,EAC5B,yDAAyD;IAC3D,8BAA8B,EAAE,4CAA4C;IAC5E,4BAA4B,EAC1B,wDAAwD;IAC1D,6BAA6B,EAC3B,kDAAkD;IACpD,gCAAgC,EAAE,8BAA8B;IAChE,uCAAuC,EAAE,kBAAkB;IAC3D,iCAAiC,EAAE,kCAAkC;IAErE,mEAAmE;IACnE,oBAAoB,EAAE,0CAA0C;IAEhE,iBAAiB,EAAE,WAAW;IAC9B,iBAAiB,EAAE,oBAAoB;IACvC,mBAAmB,EAAE,oBAAoB;IACzC,qBAAqB,EAAE,cAAc;IACrC,eAAe,EAAE,kBAAkB;IACnC,iBAAiB,EAAE,WAAW;IAC9B,kBAAkB,EAAE,wBAAwB;IAC5C,gBAAgB,EAAE,SAAS;IAE3B,kBAAkB,EAAE,kBAAkB;IACtC,iBAAiB,EAAE,kBAAkB;IACrC,mBAAmB,EAAE,WAAW;IAEhC,qBAAqB,EAAE,qBAAqB;IAC5C,mBAAmB,EAAE,sCAAsC;IAC3D,mBAAmB,EAAE,WAAW;IAChC,wBAAwB,EAAE,uBAAuB;IACjD,uBAAuB,EAAE,uBAAuB;IAChD,oBAAoB,EAAE,qBAAqB;IAE3C,2BAA2B,EAAE,qBAAqB;IAClD,oBAAoB,EAAE,WAAW;IACjC,uBAAuB,EAAE,WAAW;IACpC,6BAA6B,EAAE,yBAAyB;IACxD,gCAAgC,EAC9B,iDAAiD;IAEnD,mBAAmB,EAAE,mBAAmB;IACxC,qBAAqB,EAAE,YAAY;IACnC,yBAAyB,EAAE,kCAAkC;IAC7D,mCAAmC,EAAE,wCAAwC;IAE7E,qBAAqB,EAAE,UAAU;IACjC,wBAAwB,EAAE,qCAAqC;IAC/D,qBAAqB,EAAE,gBAAgB;IAEvC,wBAAwB,EAAE,WAAW;CACtC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC9C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * `@stapel/chat-react` — the headless React pair for stapel-chat
+ * (frontend-standard §2). Business + state only, zero visual opinion. Built on
+ * `@stapel/core`'s StapelClient (verification-403 interception, token refresh,
+ * i18n, analytics, query layer).
+ *
+ * WHAT IS DIFFERENT ABOUT THIS PAIR. Its backend has two ways to deliver the
+ * same journal: the REST history, and its own resumable WebSocket protocol
+ * (`ws/chat/<conversation_id>` — hello{last_seq} → welcome → replay →
+ * replay_done → live). Both are wired here, behind ONE seam
+ * (`useChatFreshness`), and no component above that seam can tell which is
+ * running. Writes go over REST in either case. See `flows/freshness.ts` for
+ * the seam and the criterion under which `@stapel/realtime` replaces its
+ * insides.
+ *
+ * Layers: api → model → realtime → flows → headless → i18n. Generated
+ * surfaces (error map, manifest, llms.txt) are produced by the monorepo
+ * `gen:*` drivers and stand under drift gates.
+ */
+export { createChatApi } from "./api/chatApi.js";
+export type { ChatApi } from "./api/chatApi.js";
+export type { Schemas, AnchorDirection, ChatMessage, Conversation, ConversationKind, ConversationListParams, ConversationPage, CreateConversationRequest, MarkReadRequest, MessageHistoryParams, MessageKind, MessagePage, Participant, ParticipantRole, SendMessageRequest, SupportStatus, } from "./api/types.js";
+export { CHAT_WS_CLOSE_NOT_PARTICIPANT, CHAT_WS_CLOSE_UNAUTHENTICATED, CHAT_WS_REPLAY_LIMIT, CHAT_WS_RESYNC, decodeServerFrame, parseServerFrame, } from "./realtime/frames.js";
+export type { ChatAckFrame, ChatClientFrame, ChatErrorFrame, ChatHelloFrame, ChatMessageFrame, ChatPingFrame, ChatPongFrame, ChatReplayDoneFrame, ChatSendFrame, ChatServerFrame, ChatWelcomeFrame, } from "./realtime/frames.js";
+export { browserWebSocketFactory, canOpenWebSocket, createChatSocket, } from "./realtime/chatSocket.js";
+export type { ChatConnectionState, ChatReconnectOptions, ChatSocket, ChatSocketConnection, ChatSocketHandlers, ChatSocketOptions, ChatSocketRefusal, ChatSocketStatus, ChatWebSocketFactory, } from "./realtime/chatSocket.js";
+export { chatConversationStream, chatInboxStream, chatSocketUrl, chatStreamId, deriveChatSocketBase, } from "./realtime/streams.js";
+export type { ChatConversationStream, ChatInboxStream, ChatStreamKey, } from "./realtime/streams.js";
+export { createFlowMachine, useFlow, isErrorCode } from "@stapel/core";
+export type { FlowMachine, FlowMachineOptions, FlowStateBase, FlowError, } from "@stapel/core";
+export { toFlowError } from "./flows/errors.js";
+export { CHAT_FLOWS, flowEndpoints } from "./flows/registry.js";
+export type { ChatFlowId, ChatFlowSpec, FlowEndpoint } from "./flows/registry.js";
+export { CONVERSATION_LIST_INTERVAL_MS, THREAD_INTERVAL_MS, useChatFreshness, } from "./flows/freshness.js";
+export type { ChatFreshness, ChatFreshnessOptions, ChatSignal, ChatSignalKeyMap, ChatTransport, } from "./flows/freshness.js";
+export { createChatRuntime } from "./model/runtime.js";
+export type { ChatRealtimeConfig, ChatRealtimeOptions, ChatRuntime, CreateChatRuntimeOptions, } from "./model/runtime.js";
+export { ChatRuntimeContext, useChatRuntime, useChatApi, useChatAnalytics, } from "./model/context.js";
+export { chatQueryKeys } from "./model/queryKeys.js";
+export { THREAD_PAGE, useConversation, useConversations, useThread } from "./model/queries.js";
+export { useLoadOlderMessages, useMarkRead, useSendMessage, useStartDirectChat, } from "./model/mutations.js";
+export type { SendMessageVariables, StartDirectChatVariables, } from "./model/mutations.js";
+export { CHAT_DEFAULT_MAX_BODY_LENGTH } from "./model/limits.js";
+export { nextReadMarker } from "./model/readMarker.js";
+export { EMPTY_THREAD_WINDOW, mergeMessage, mergeNewerPage, mergeOlderPage, threadFirstSeq, threadLastSeq, threadWindowFromPage, } from "./model/threadWindow.js";
+export type { ChatThreadWindow, ThreadMergeResult } from "./model/threadWindow.js";
+export { ChatProvider } from "./headless/ChatProvider.js";
+export { ConversationList } from "./headless/ConversationList.js";
+export type { ConversationListBag } from "./headless/ConversationList.js";
+export { ConversationThread } from "./headless/ConversationThread.js";
+export type { ConversationThreadBag } from "./headless/ConversationThread.js";
+export { MessageComposer } from "./headless/MessageComposer.js";
+export type { MessageComposerBag } from "./headless/MessageComposer.js";
+export { StartDirectChat } from "./headless/StartDirectChat.js";
+export type { StartDirectChatBag } from "./headless/StartDirectChat.js";
+export { navEntries } from "./nav/manifest.js";
+export { CHAT_I18N_KEYS, chatI18nBundleEn, registerChatI18n } from "./i18n/keys.js";
+export type { ChatI18nKey } from "./i18n/keys.js";
+export { CHAT_ERRORS, CHAT_ERROR_CODES, chatErrorBundleEn, explainChatError, } from "./i18n/errorsMap.js";
+export type { ChatErrorCode, ChatErrorSpec, Remediation, } from "./i18n/errorsMap.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,55 @@
+/**
+ * `@stapel/chat-react` — the headless React pair for stapel-chat
+ * (frontend-standard §2). Business + state only, zero visual opinion. Built on
+ * `@stapel/core`'s StapelClient (verification-403 interception, token refresh,
+ * i18n, analytics, query layer).
+ *
+ * WHAT IS DIFFERENT ABOUT THIS PAIR. Its backend has two ways to deliver the
+ * same journal: the REST history, and its own resumable WebSocket protocol
+ * (`ws/chat/<conversation_id>` — hello{last_seq} → welcome → replay →
+ * replay_done → live). Both are wired here, behind ONE seam
+ * (`useChatFreshness`), and no component above that seam can tell which is
+ * running. Writes go over REST in either case. See `flows/freshness.ts` for
+ * the seam and the criterion under which `@stapel/realtime` replaces its
+ * insides.
+ *
+ * Layers: api → model → realtime → flows → headless → i18n. Generated
+ * surfaces (error map, manifest, llms.txt) are produced by the monorepo
+ * `gen:*` drivers and stand under drift gates.
+ */
+// ── api ──────────────────────────────────────────────────────────────────────
+export { createChatApi } from "./api/chatApi.js";
+// ── realtime (the module's own socket protocol, typed) ───────────────────────
+// Exported because a host may want to render the connection state or inject a
+// transport; NOTHING above `flows/freshness.ts` inside this package uses it,
+// which is what keeps the substrate migration to one file.
+export { CHAT_WS_CLOSE_NOT_PARTICIPANT, CHAT_WS_CLOSE_UNAUTHENTICATED, CHAT_WS_REPLAY_LIMIT, CHAT_WS_RESYNC, decodeServerFrame, parseServerFrame, } from "./realtime/frames.js";
+export { browserWebSocketFactory, canOpenWebSocket, createChatSocket, } from "./realtime/chatSocket.js";
+export { chatConversationStream, chatInboxStream, chatSocketUrl, chatStreamId, deriveChatSocketBase, } from "./realtime/streams.js";
+// ── flows (the transport seam + the error fold) ──────────────────────────────
+export { createFlowMachine, useFlow, isErrorCode } from "@stapel/core";
+export { toFlowError } from "./flows/errors.js";
+export { CHAT_FLOWS, flowEndpoints } from "./flows/registry.js";
+export { CONVERSATION_LIST_INTERVAL_MS, THREAD_INTERVAL_MS, useChatFreshness, } from "./flows/freshness.js";
+// ── model (runtime wiring, query keys, context, the thread store) ────────────
+export { createChatRuntime } from "./model/runtime.js";
+export { ChatRuntimeContext, useChatRuntime, useChatApi, useChatAnalytics, } from "./model/context.js";
+export { chatQueryKeys } from "./model/queryKeys.js";
+export { THREAD_PAGE, useConversation, useConversations, useThread } from "./model/queries.js";
+export { useLoadOlderMessages, useMarkRead, useSendMessage, useStartDirectChat, } from "./model/mutations.js";
+export { CHAT_DEFAULT_MAX_BODY_LENGTH } from "./model/limits.js";
+export { nextReadMarker } from "./model/readMarker.js";
+export { EMPTY_THREAD_WINDOW, mergeMessage, mergeNewerPage, mergeOlderPage, threadFirstSeq, threadLastSeq, threadWindowFromPage, } from "./model/threadWindow.js";
+// ── headless (renderless components) ─────────────────────────────────────────
+export { ChatProvider } from "./headless/ChatProvider.js";
+export { ConversationList } from "./headless/ConversationList.js";
+export { ConversationThread } from "./headless/ConversationThread.js";
+export { MessageComposer } from "./headless/MessageComposer.js";
+export { StartDirectChat } from "./headless/StartDirectChat.js";
+// ── nav ──────────────────────────────────────────────────────────────────────
+export { navEntries } from "./nav/manifest.js";
+// ── i18n ─────────────────────────────────────────────────────────────────────
+export { CHAT_I18N_KEYS, chatI18nBundleEn, registerChatI18n } from "./i18n/keys.js";
+// ── errors map (code → status/params/remediation/en; generated) ──────────────
+export { CHAT_ERRORS, CHAT_ERROR_CODES, chatErrorBundleEn, explainChatError, } from "./i18n/errorsMap.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,gFAAgF;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAqBjD,gFAAgF;AAChF,8EAA8E;AAC9E,6EAA6E;AAC7E,2DAA2D;AAC3D,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAc9B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAYlC,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAO/B,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAS9B,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAOvD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGpF,gFAAgF;AAChF,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/model/context.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "react";
+import type { Analytics, ModuleContextKit } from "@stapel/core";
+import type { ChatApi } from "../api/chatApi.js";
+import type { ChatRuntime } from "./runtime.js";
+export declare const ChatRuntimeContext: Context<ChatRuntime | null>;
+export declare const useChatRuntime: () => ChatRuntime;
+export declare const useChatApi: () => ChatApi;
+export declare const useChatAnalytics: () => Analytics | null;
+/** @internal Re-exported as `<ChatProvider>` from `headless/`. */
+export declare const ModuleProvider: ModuleContextKit<ChatRuntime>["Provider"];
+//# sourceMappingURL=context.d.ts.map

package/dist/model/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhD,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAsB,CAAC;AAElF,eAAO,MAAM,cAAc,EAAE,MAAM,WAA4B,CAAC;AAEhE,eAAO,MAAM,UAAU,EAAE,MAAM,OAAoB,CAAC;AAEpD,eAAO,MAAM,gBAAgB,EAAE,MAAM,SAAS,GAAG,IAAuB,CAAC;AAEzE,kEAAkE;AAClE,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,UAAU,CAAgB,CAAC"}

package/dist/model/context.js

@@ -0,0 +1,16 @@
+import { createModuleContext } from "@stapel/core";
+/**
+ * The wired ChatRuntime shared through React context by `<ChatProvider>`.
+ * Hooks in `model/`, `flows/` and `headless/` read the singletons from here.
+ * One reviewed copy of this plumbing lives in `@stapel/core`
+ * (`createModuleContext`, slim wave §21/S2); this module binds it under the
+ * pair's public names.
+ */
+const kit = createModuleContext("Chat");
+export const ChatRuntimeContext = kit.RuntimeContext;
+export const useChatRuntime = kit.useRuntime;
+export const useChatApi = kit.useApi;
+export const useChatAnalytics = kit.useAnalytics;
+/** @internal Re-exported as `<ChatProvider>` from `headless/`. */
+export const ModuleProvider = kit.Provider;
+//# sourceMappingURL=context.js.map

package/dist/model/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAKnD;;;;;;GAMG;AACH,MAAM,GAAG,GAAkC,mBAAmB,CAAc,MAAM,CAAC,CAAC;AAEpF,MAAM,CAAC,MAAM,kBAAkB,GAAgC,GAAG,CAAC,cAAc,CAAC;AAElF,MAAM,CAAC,MAAM,cAAc,GAAsB,GAAG,CAAC,UAAU,CAAC;AAEhE,MAAM,CAAC,MAAM,UAAU,GAAkB,GAAG,CAAC,MAAM,CAAC;AAEpD,MAAM,CAAC,MAAM,gBAAgB,GAA2B,GAAG,CAAC,YAAY,CAAC;AAEzE,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAA8C,GAAG,CAAC,QAAQ,CAAC"}

package/dist/model/limits.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mirrors of the backend's CONFIGURABLE limits — axes, not constants.
+ *
+ * `STAPEL_CHAT.MAX_BODY_LENGTH` (`stapel_chat/conf.py`, surfaced in
+ * `docs/capabilities.json`) defaults to 4000 characters and a deployment may
+ * narrow it. The server stays authoritative and answers
+ * `error.400.chat_body_too_long`; the mirror exists so a person is told before
+ * they lose what they typed, not after. A host that changed the axis passes
+ * its own value to `<MessageComposer maxLength=…>`.
+ */
+export declare const CHAT_DEFAULT_MAX_BODY_LENGTH = 4000;
+//# sourceMappingURL=limits.d.ts.map

package/dist/model/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/model/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,OAAO,CAAC"}

package/dist/model/limits.js

@@ -0,0 +1,12 @@
+/**
+ * Mirrors of the backend's CONFIGURABLE limits — axes, not constants.
+ *
+ * `STAPEL_CHAT.MAX_BODY_LENGTH` (`stapel_chat/conf.py`, surfaced in
+ * `docs/capabilities.json`) defaults to 4000 characters and a deployment may
+ * narrow it. The server stays authoritative and answers
+ * `error.400.chat_body_too_long`; the mirror exists so a person is told before
+ * they lose what they typed, not after. A host that changed the axis passes
+ * its own value to `<MessageComposer maxLength=…>`.
+ */
+export const CHAT_DEFAULT_MAX_BODY_LENGTH = 4000;
+//# sourceMappingURL=limits.js.map

package/dist/model/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/model/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC"}

package/dist/model/mutations.d.ts

@@ -0,0 +1,66 @@
+import type { UseMutationResult } from "@tanstack/react-query";
+import type { StapelApiError } from "@stapel/core";
+import type { ChatMessage, Conversation } from "../api/types.js";
+import type { ChatThreadWindow } from "./threadWindow.js";
+/** Variables for {@link useSendMessage}. */
+export interface SendMessageVariables {
+    readonly body: string;
+    /** Quoted message id; must belong to this conversation. */
+    readonly replyTo?: string;
+}
+/**
+ * Append a message to a thread. On success the persisted row (with its `seq`)
+ * is folded straight into the window, so the sender sees their own line
+ * without waiting for a poll — and the socket's fan-out copy of the same row
+ * is then a duplicate that `mergeMessage` drops.
+ *
+ * Attachments are NOT wired in this version (spec §4.5): the field exists on
+ * the wire, but shipping it would mean shipping CDN upload rights into chat,
+ * and a control that is visible but does nothing is worse than one that is
+ * absent.
+ */
+export declare function useSendMessage(conversationId: string): UseMutationResult<ChatMessage, StapelApiError, SendMessageVariables>;
+/**
+ * Advance the caller's read marker to `upto_seq`.
+ *
+ * Monotonic on the client as well as on the server: a candidate at or below
+ * what this client already reported resolves without a request
+ * (`nextReadMarker`). The reported value is remembered in the query cache —
+ * see `readMarker.ts` for why it cannot be read back off the wire.
+ */
+export declare function useMarkRead(conversationId: string): UseMutationResult<number | null, StapelApiError, number>;
+/** Variables for {@link useStartDirectChat}. */
+export interface StartDirectChatVariables {
+    /** The other person — the seller, on a listing page. */
+    readonly userId: string;
+}
+/**
+ * Open the direct thread with someone, creating it only if it does not exist.
+ *
+ * The idempotency is the module's, not ours: a direct thread is keyed by an
+ * order-independent `direct_key` over the participant pair (namespaced by
+ * scope) under a unique constraint, and the create race is resolved by the
+ * constraint — the loser gets the winner's row (`MODULE.md`, "Direct
+ * idempotency"). So "message the seller" is safe to press twice, from two
+ * tabs, on two listings.
+ *
+ * TWO PEOPLE, ONE THREAD — INCLUDING ACROSS LISTINGS. The key is the pair,
+ * not the listing: a buyer who writes to the same seller about a second item
+ * lands in the same conversation. `CreateConversationRequest.scope_key` does
+ * not change that (the server ignores the field and resolves the scope
+ * itself — `api/extensions.ts`), so a host that wants the listing named must
+ * name it in the first message.
+ */
+export declare function useStartDirectChat(): UseMutationResult<Conversation, StapelApiError, StartDirectChatVariables>;
+/**
+ * Backfill one page of older history onto the front of the window
+ * (`direction=next` from the window's oldest seq — "next" is OLDER here,
+ * because the history is ordered `-seq`).
+ *
+ * A mutation rather than a second query: it is an action a person takes
+ * ("show me more"), it must not re-run on focus, and its result belongs in
+ * the ONE thread cache entry rather than in a second one that would then have
+ * to be reconciled with it.
+ */
+export declare function useLoadOlderMessages(conversationId: string, limit?: number): UseMutationResult<ChatThreadWindow | null, StapelApiError, void>;
+//# sourceMappingURL=mutations.d.ts.map