@robono/server 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.25.0 — release candidate
+
+Make Robono-hosted connections the default, add framework installation and sign-in examples, and import historical conversations with validation and retry-safe jobs. Customer-hosted forwarding remains optional.
+
 ## 0.24.0
 
 Add explicit Robono-managed membership permissions to the supplied Messenger server and installer. Preserve existing custom authorization during upgrades. Register native incoming-call devices and deliver genuine Apple VoIP / Android data call invitations separately from message notifications.

package/HISTORY-IMPORT.md

@@ -0,0 +1,97 @@
+# Bring existing conversations to Robono
+
+Use this server-only tool before opening the destination conversation to users.
+It preserves original authors, dates and replies, and keeps attachment files private.
+It does not send old push notifications, create unread badges, fabricate read
+receipts, or charge old messages as new sends. Storage, transfer and any enabled
+screening still follow your selected plan and spending limits.
+
+## One conversation at a time
+
+1. Create the authorized empty conversation using your existing Robono connection.
+   Full history must be selected. For direct chats, authors must be the two members.
+   For groups, the import can name former authors without granting them membership.
+2. Export messages into the JSON format below. Keep the job UUID and original source
+   IDs unchanged for retries. Your existing provider's export must be mapped to
+   these fields; this command does not request your old provider's credentials.
+3. Validate locally, then apply from your server:
+
+```sh
+npx --package @robono/server robono-history-import --file history.json
+# Set ROBONO_API_KEY securely in this server's environment, then:
+npx --package @robono/server robono-history-import --file history.json --apply
+```
+
+Use a key with `messaging:manage`. Never put it in a website, phone app, exported
+JSON, screenshot or source control. Validation alone does not contact Robono.
+The command retries temporary connection failures using the same import identity.
+A policy failure stays visible. Correct the cause and rerun the same command.
+
+```json
+{
+  "jobId": "66a3ee0d-18bb-49dc-bb06-a7adab745ef4",
+  "conversationId": "c829bd4f-1f67-4cd1-b285-6502923885b5",
+  "authors": ["alice", "bob"],
+  "messages": [
+    {"sourceId":"old-1","authorId":"alice","sentAt":"2026-01-01T12:00:00Z",
+     "content":{"kind":"text","text":"Meet at noon?"}},
+    {"sourceId":"old-2","authorId":"bob","sentAt":"2026-01-01T12:01:00Z",
+     "replyToSourceId":"old-1","content":{"kind":"text","text":"Yes."}}
+  ]
+}
+```
+
+Messages become visible together when the whole conversation passes validation.
+Ordinary sends wait while the import is active. A retry after a lost final response
+returns the existing result; it does not create another copy. Replies must point
+to earlier messages in the same import. Original timestamps order the history;
+file order resolves ties. Current permission, blocked-word/link, attachment and
+screening rules apply again at the final commit.
+
+## Private attachments
+
+Text, photos, videos, voice messages and documents are supported. Public URLs and
+another customer's asset IDs are not accepted. Use `RobonoHistoryImport` on your
+server to start the job, upload each original file privately, and use the returned
+`media` object in the message. The importer never sends your API key to file storage.
+
+```ts
+import {randomUUID} from 'node:crypto';
+import {readFile} from 'node:fs/promises';
+import {RobonoHistoryImport} from '@robono/server';
+const importer = new RobonoHistoryImport({apiKey: process.env.ROBONO_API_KEY!});
+// Persist these IDs and the export before starting; reuse them after interruption.
+const jobId = savedJobId;
+await importer.start({jobId, conversationId, authors: ['alice', 'bob'], count: 1});
+const bytes = await readFile('./private-export/photo.jpg');
+const media = await importer.upload({
+  jobId, conversationId, authorId: 'alice', uploadId: 'old-photo-1', kind: 'image',
+  file: {fileName: 'photo.jpg', mimeType: 'image/jpeg', byteSize: bytes.byteLength}, bytes,
+});
+await importer.importMessages({jobId, conversationId, authors: ['alice', 'bob'],
+  messages: [{sourceId: 'old-photo-1', authorId: 'alice', sentAt: originalTimestamp,
+    content: {kind: 'image', media}}],
+});
+```
+
+For video/voice, provide the original `durationMs`. Normal file verification and
+screening can keep an upload pending; reuse the same upload ID when retrying.
+Changing the file under the same ID is rejected. Imported file retention starts
+when the imported message is committed and uses your selected storage retention.
+
+## Limits and recovery
+
+- Up to 10,000 messages and 32 MiB of staged message content per conversation;
+  three active imports per customer. Each HTTP append accepts up to 100 messages;
+  the SDK uses smaller batches. Existing nonempty conversations cannot be merged.
+- A job expires after 24 hours. Call `status(jobId)` to check it or `cancel(jobId)`
+  to stop an unfinished import. An expired/cancelled job requires a new job UUID.
+- `cancel` removes staging copies, not already committed conversations. Unused
+  uploads follow ordinary cleanup. Completed staging copies are removed within
+  seven days; the content-free job result remains for safe retries.
+- User erasure cancels affected unfinished imports and removes their staging
+  copies, so an old import cannot restore erased content.
+- Poll votes, reactions, delivered/read status and provider-specific custom
+  objects are not imported by this format. Keep the original export if needed.
+
+This is an import into Robono-managed messaging, not a live cross-provider bridge.

package/HOSTED.md

@@ -0,0 +1,241 @@
+# Robono-hosted Messenger
+
+Robono runs messaging, calling, private attachment storage and location services.
+Your existing server verifies your existing users. It issues a short-lived Robono
+session and tells Robono who is allowed to communicate. Chat traffic does not
+pass through your server. Users do not create a second account.
+
+## 1. Install the interface
+
+From the website or Expo project:
+
+```sh
+npx --package @robono/server@^0.25.0 robono-messenger-install --project . --origin https://your-company.com --company 'Your company'
+```
+
+Review the files, then accept installation. The default is Robono hosting.
+Next.js receives a small sign-in route. React/Vite, Vue, Svelte, Angular and Expo
+connect to your existing sign-in server; they do not need a Node messaging server.
+Use `--token-endpoint https://your-server.com/api/robono-token` if that route is on
+another server. That server must explicitly allow your website origin for this
+bearer-authenticated request; never use a wildcard with credentials.
+
+For Expo, rebuild both phone apps after installing the native dependencies. A
+static app.json gets the grouped plugin automatically. For a config written in
+JavaScript/TypeScript, add `@robono/messaging-react-native/setup` to `plugins`.
+The installer preserves existing screens, configuration code and environment files.
+
+The generated `.robono/SETUP.md` explains exactly which component to import.
+React/Expo use `CustomerMessenger` with your existing Supabase/Firebase instance
+or the small generated account interface. Other website frameworks receive a
+thin component around the same supplied Messenger. Give the component a height
+and keep it mounted while signed in. Supply names, avatars and phone numbers
+from your own contact directory; Robono does not invent your employee/customer
+records or make every user visible to every other user.
+
+## 2. Verify the existing login
+
+Keep `ROBONO_API_KEY` on your existing server. Never put it in a phone app,
+JavaScript served to the browser, a URL, or a public environment variable.
+
+The client sends its existing bearer login to your `/api/robono-token` route.
+The route verifies that login using your existing authentication provider. Use
+the verified account ID, never a user ID supplied in the request body.
+
+### JavaScript / TypeScript
+
+```ts
+import {createRobonoTokenHandler} from '@robono/server';
+import {verifyExistingLogin} from './your-existing-login';
+
+export const POST = createRobonoTokenHandler({
+  apiKey: process.env.ROBONO_API_KEY!,
+  origins: ['https://your-company.com'],
+  authenticate: async request => {
+    const account = await verifyExistingLogin(request);
+    return account?.id ?? null;
+  },
+});
+export const OPTIONS = POST;
+```
+
+Supabase and Firebase verification are generated when selected in the installer.
+For another login system, `verifyExistingLogin` is the one customer-owned
+connection. It must check expiry, revocation and disabled accounts. Decoding a
+JWT without verifying its signature is not authentication.
+
+### Any other server language
+
+The same route can make one ordinary HTTPS request. No Node service is required:
+
+```http
+POST https://api.robono.com/v1/messenger/sessions
+Authorization: Bearer YOUR_PRIVATE_ROBONO_KEY
+Content-Type: application/json
+
+{"operation":"create","userId":"VERIFIED_ACCOUNT_ID","origins":["https://your-company.com"],"expiresInSeconds":900}
+```
+
+Return the response only to that signed-in user with `Cache-Control: no-store`.
+Reject unknown browser origins. Native clients may omit Origin but must still
+present their existing login. Do not log the returned token. Requests use HTTPS,
+a timeout and no redirects. Set CORS on a separate sign-in domain to your exact
+website origin and allow `Authorization` and `Content-Type`; no cookies are
+needed by the supplied bearer-token connection.
+
+This Python helper is called **after your framework has authenticated the user**:
+
+```python
+import json, os, urllib.request
+
+class NoRedirect(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, request, fp, code, message, headers, new_url):
+        return None
+
+def issue_robono_session(verified_user_id):
+    request = urllib.request.Request(
+        'https://api.robono.com/v1/messenger/sessions',
+        data=json.dumps({'operation': 'create', 'userId': verified_user_id,
+                         'origins': ['https://your-company.com']}).encode(),
+        headers={'Authorization': 'Bearer ' + os.environ['ROBONO_API_KEY'],
+                 'Content-Type': 'application/json'}, method='POST')
+    with urllib.request.build_opener(NoRedirect()).open(request, timeout=15) as response:
+        return json.load(response)
+```
+
+PHP, inside an already authenticated controller:
+
+```php
+function issueRobonoSession(string $verifiedUserId): array {
+    $request = curl_init('https://api.robono.com/v1/messenger/sessions');
+    curl_setopt_array($request, [
+        CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
+        CURLOPT_FOLLOWLOCATION => false, CURLOPT_TIMEOUT => 15,
+        CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ROBONO_API_KEY'),
+                              'Content-Type: application/json'],
+        CURLOPT_POSTFIELDS => json_encode(['operation' => 'create',
+            'userId' => $verifiedUserId, 'origins' => ['https://your-company.com']], JSON_THROW_ON_ERROR),
+    ]);
+    $body = curl_exec($request);
+    $status = curl_getinfo($request, CURLINFO_RESPONSE_CODE);
+    curl_close($request);
+    if ($body === false || $status !== 201) throw new RuntimeException('Messaging sign-in unavailable');
+    return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
+}
+```
+
+.NET, inside an endpoint protected by your existing authentication middleware:
+
+```csharp
+using System.Net.Http.Headers;
+using System.Net.Http.Json;
+using System.Text.Json;
+
+static async Task<JsonElement> IssueRobonoSession(string verifiedUserId, string key) {
+    using var client = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false }) {
+        Timeout = TimeSpan.FromSeconds(15)
+    };
+    client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", key);
+    using var response = await client.PostAsJsonAsync(
+        "https://api.robono.com/v1/messenger/sessions",
+        new { operation = "create", userId = verifiedUserId,
+              origins = new[] { "https://your-company.com" } });
+    response.EnsureSuccessStatusCode();
+    return await response.Content.ReadFromJsonAsync<JsonElement>();
+}
+```
+
+The examples deliberately receive `verifiedUserId`; it must come from your
+framework's authenticated account, never form data or an unsigned header.
+Handle provider errors with a generic failure response, not a private token or
+provider response dump. Your regular login rate limit also applies to this route.
+
+## 3. Synchronize your permissions
+
+For contacts, call the server-only `RobonoMessengerConnections.synchronizeContact`
+with the two authoritative user IDs, `allowed` and a monotonically increasing
+revision. It updates texting and calling together. Group membership uses
+`RobonoMessagingBackend.setGroup`. Location visibility uses
+`RobonoLocationBackend.setGrant` and the recipient's sharing approval. Send
+changes when your own records change; users cannot grant themselves membership.
+An empty contact list is valid and means you have not connected anyone yet.
+
+For suspension/deletion, synchronize the account's service permissions and call
+`RobonoSessions.revokeUser(userId)` with the same server key that minted sessions.
+Key revocation also invalidates sessions minted by that key. Sessions never
+extend the original key's scope. A session lasts 15 minutes by default and may
+be configured from one minute to one hour. The supplied client renews it through
+your verified login; it never stores the token on disk.
+
+## Notifications, Maps and calling
+
+- Website: publish the included `public/robono-notifications/worker.js`. Enter
+  your website origin and chat-page path in Robono's notification setup. The
+  worker has its own scope and does not replace your existing website worker.
+  A user must allow notifications. iPhone websites must be installed on the
+  Home Screen and opened there to receive web notifications.
+- iPhone: connect your Apple Developer Team ID, APNs Key ID, private `.p8` key
+  and Bundle ID privately in Robono. Enable push notifications, including the
+  incoming-call `.voip` topic. Use development credentials/environment for a
+  development build and production for TestFlight/App Store. Do not put the
+  `.p8` file in the app.
+- Android: connect the Firebase project, app `google-services.json`, and private
+  FCM service account in the documented setup. Only app configuration goes in
+  the app; the service account stays at Robono. Full-screen call alerts depend
+  on Android permissions and Play eligibility; ordinary Answer/Decline alerts
+  are the fallback.
+- Maps: register the website origin or both phone app identifiers in Robono's
+  Maps setup. Supply your own authoritative people and sharing grants. The
+  supplied interface manages location permission, sharing start/stop and expiry.
+- Video: camera and microphone permissions are required. Apple screen sharing
+  additionally needs the Broadcast Upload extension configured by the calling
+  plugin; it cannot be added to an already-built app without rebuilding it.
+
+These platform credentials belong to the customer's apps and cannot be replaced
+with Robono Messenger's credentials. AWS screening and Robono service credentials
+are managed by Robono; customers do not need their own AWS account.
+
+## Offline behavior and sign-out
+
+With the supplied persistent storage, interrupted outgoing messages remain on
+that device and retry for up to 24 hours while the app/site is running. This is
+not a promise that a force-closed app runs in the background. On reconnection,
+Robono checks current permissions before sending. An attachment keeps its place
+in the queue; later text does not overtake it. Stable IDs prevent a lost server
+acknowledgement from creating a second message. Policy failures and expired
+queue items require user action. Users can remove waiting messages.
+
+Offline reading/composition requires a still-valid server-issued offline-history
+window. If that window expires, reconnect before displaying private history.
+Sign-out clears the local account state, stops sharing, unregisters notifications
+and revokes the connection's Robono sessions. Notify Robono when your own account
+is suspended; a cached screen is never a new authorization grant.
+
+## Existing installations
+
+`--upgrade` preserves customer-edited files and saves proposed changes for review.
+Existing self-hosted installations retain their mode. Moving an existing app to
+hosted mode is a deliberate migration: use the hosted connection and token route,
+verify your existing permission synchronization, then retire the old forwarding
+route. Never leave a private API key in the client as a shortcut. `--self-hosted`
+remains available for customers deliberately maintaining their own adapter.
+
+
+## Interface language and recovery
+
+Set `interfaceLocale={{locale:'es'}}` on the supplied phone Messenger, or
+`interfaceLocale:{locale:'es'}` when mounting the website Messenger. English is the
+default. This also covers the supplied calling controls and Maps screens. It does
+not change the language of anyone's messages or their translation preferences.
+For custom wording or another language, see the interface language guide.
+
+The supplied interface keeps unsent messages and waiting edits/reactions/deletions
+on the device, scoped to the account and customer. It retries connection failures
+in order, after checking current access. Policy failures stay visible for review;
+users can retry or discard them. Automatic retries expire after 24 hours. Sign-out
+clears this account's saved work. Offline storage is device-local, not a server
+backup. A custom outbox can implement the optional action methods to use this flow.
+
+To migrate an existing conversation, use `robono-history-import`; see
+[History import](./HISTORY-IMPORT.md). Do this before allowing new sends in that
+conversation. Existing user and membership records remain your responsibility.

package/README.md

@@ -1,6 +1,14 @@
 # `@robono/server`
 
-Headless Node/TypeScript SDK for connecting an existing app or private ecosystem to Robono Bridge.
+Server SDK and project installer for Robono Messenger, Maps, calling and Bridge.
+
+## Start with the hosted connection
+
+Robono runs the messaging, media, calling and Maps services. Your server verifies your existing user login and returns a short-lived Robono session; it does not forward chat requests. Your company continues to supply its users, permitted contacts and group memberships.
+
+Run `npx --package @robono/server robono-messenger-install` in your application project. The installer detects supported projects, creates the connection files and explains the remaining login and platform credentials. See [the hosted setup guide](https://robono.com/guides/hosted-messenger.html) for the recommended setup, supported frameworks and non-JavaScript server examples. The older self-hosted adapters below remain available with `--self-hosted`.
+
+Never put your Robono API key or Apple/Google private keys in browser or phone code.
 
 ## License
 
@@ -11,10 +19,10 @@ Robono's own app and third-party connected apps appear as endpoints in the same
 ## Install
 
 ```bash
-npm install @robono/server@0.12.1
+npm install @robono/server
 ```
 
-Version 0.12.1 is available on npm and through the [calling release](https://github.com/IMLX16/robono-sdks/releases/tag/calling-v0.2.1), with checksums and source.
+Use the current package for the hosted setup; older releases retain their original adapter API.
 
 The package is ESM-only, supports Node.js 18+ and Deno 2.x through npm compatibility, and includes TypeScript declarations and `SBOM.spdx.json`.
 

package/SBOM.spdx.json

@@ -2,22 +2,22 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@robono/server@0.24.0",
-  "documentNamespace": "http://spdx.org/spdxdocs/@robono%2fserver-0.24.0-***",
+  "name": "@robono/server@0.25.0",
+  "documentNamespace": "http://spdx.org/spdxdocs/@robono%2fserver-0.25.0-***",
   "creationInfo": {
-    "created": "2026-11-04T14:48:55.080Z",
+    "created": "2026-11-04T19:16:12.352Z",
     "creators": [
       "Tool: npm/cli-11.6.2"
     ]
   },
   "documentDescribes": [
-    "SPDXRef-Package-robono.server-0.24.0"
+    "SPDXRef-Package-robono.server-0.25.0"
   ],
   "packages": [
     {
       "name": "@robono/server",
-      "SPDXID": "SPDXRef-Package-robono.server-0.24.0",
-      "versionInfo": "0.24.0",
+      "SPDXID": "SPDXRef-Package-robono.server-0.25.0",
+      "versionInfo": "0.25.0",
       "packageFileName": "",
       "description": "Provider-neutral server SDK for the Robono Bridge API.",
       "primaryPackagePurpose": "LIBRARY",
@@ -29,7 +29,7 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40robono/server@0.24.0"
+          "referenceLocator": "pkg:npm/%40robono/server@0.25.0"
         }
       ]
     },
@@ -175,12 +175,12 @@
   "relationships": [
     {
       "spdxElementId": "SPDXRef-DOCUMENT",
-      "relatedSpdxElement": "SPDXRef-Package-robono.server-0.24.0",
+      "relatedSpdxElement": "SPDXRef-Package-robono.server-0.25.0",
       "relationshipType": "DESCRIBES"
     },
     {
       "spdxElementId": "SPDXRef-Package-cross-spawn-7.0.6",
-      "relatedSpdxElement": "SPDXRef-Package-robono.server-0.24.0",
+      "relatedSpdxElement": "SPDXRef-Package-robono.server-0.25.0",
       "relationshipType": "DEPENDENCY_OF"
     },
     {

package/dist/calling-session-handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calling-session-handle.d.ts","sourceRoot":"","sources":["../src/calling-session-handle.ts"],"names":[],"mappings":"AACA;iFACiF;AACjF,wBAAgB,2BAA2B,CAAC,SAAS,EAAC,MAAM,EAAC,UAAU,EAAC,MAAM;kBAK/D,MAAM,WAAS;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC;iBAK/C,OAAO,WAAS,MAAM,GAAE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC;EAWpE"}
+{"version":3,"file":"calling-session-handle.d.ts","sourceRoot":"","sources":["../src/calling-session-handle.ts"],"names":[],"mappings":"AAEA;iFACiF;AACjF,wBAAgB,2BAA2B,CAAC,SAAS,EAAC,MAAM,EAAC,UAAU,EAAC,MAAM;kBAK/D,MAAM,WAAS;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC;iBAK/C,OAAO,WAAS,MAAM,GAAE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC;EAWpE"}

package/dist/calling-session-handle.js

@@ -1,3 +1,4 @@
+import { Buffer } from 'node:buffer';
 import { createCipheriv, createDecipheriv, createHash, randomBytes } from 'node:crypto';
 /** Full call credentials stay encrypted between requests to the customer's route.
  * The browser receives a separate credential that can only hear change hints. */

package/dist/calling-session-handle.js.map

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

package/dist/history-import-cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { type HistoryImportMessage } from './history-import.js';
+/** Private JSON export: never print message bodies or keys. Validation does not contact Robono. */
+export declare function runHistoryImport(args: string[], env?: NodeJS.ProcessEnv, log?: (line: string) => void): Promise<void>;
+export declare function validateHistoryImportFile(value: any): asserts value is {
+    jobId: string;
+    conversationId: string;
+    authors: string[];
+    messages: HistoryImportMessage[];
+};
+//# sourceMappingURL=history-import-cli.d.ts.map

package/dist/history-import-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-import-cli.d.ts","sourceRoot":"","sources":["../src/history-import-cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAAqB,KAAK,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AAElF,mGAAmG;AACnG,wBAAsB,gBAAgB,CAAC,IAAI,EAAC,MAAM,EAAE,EAAC,GAAG,GAAC,MAAM,CAAC,UAAsB,EAAC,GAAG,GAAC,CAAC,IAAI,EAAC,MAAM,KAAG,IAAgB,iBAkBzH;AACD,wBAAgB,yBAAyB,CAAC,KAAK,EAAC,GAAG,GAAE,OAAO,CAAC,KAAK,IAAI;IAAC,KAAK,EAAC,MAAM,CAAC;IAAA,cAAc,EAAC,MAAM,CAAC;IAAA,OAAO,EAAC,MAAM,EAAE,CAAC;IAAA,QAAQ,EAAC,oBAAoB,EAAE,CAAA;CAAC,CAiB1J"}

package/dist/history-import-cli.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { readFile, stat } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { RobonoHistoryImport } from './history-import.js';
+import { RobonoError } from './errors.js';
+/** Private JSON export: never print message bodies or keys. Validation does not contact Robono. */
+export async function runHistoryImport(args, env = process.env, log = console.log) {
+    const flags = new Set(args.filter(a => a === '--apply' || a === '--help'));
+    if (flags.has('--help')) {
+        log('robono-history-import --file history.json [--apply]\nWithout --apply, validates locally. To import, set ROBONO_API_KEY on your server. Keep jobId and sourceId unchanged when retrying.');
+        return;
+    }
+    const rest = args.filter(a => !flags.has(a));
+    if (rest.length !== 2 || rest[0] !== '--file' || !rest[1])
+        throw Error('Use --file history.json, with --apply when ready.');
+    const info = await stat(rest[1]);
+    if (!info.isFile() || info.size > 33554432)
+        throw Error('Use a JSON file no larger than 32 MiB.');
+    let input;
+    try {
+        input = JSON.parse(await readFile(rest[1], 'utf8'));
+    }
+    catch {
+        throw Error('The import file must contain valid JSON.');
+    }
+    validateHistoryImportFile(input);
+    log(`Validated ${input.messages.length} messages from ${input.authors.length} authors.`);
+    if (!flags.has('--apply')) {
+        log('Nothing sent. Add --apply to import into the authorized empty conversation.');
+        return;
+    }
+    const apiKey = env.ROBONO_API_KEY;
+    if (!apiKey)
+        throw Error('Set ROBONO_API_KEY in your server environment. Do not put it in the JSON file.');
+    const importer = new RobonoHistoryImport({ apiKey });
+    for (let attempt = 0;; attempt++) {
+        try {
+            const result = await importer.importMessages({ ...input, onProgress: (done, total) => log(`Prepared ${done}/${total}.`) });
+            log(`Import ${result.state}: ${result.importedCount ?? input.messages.length} messages.`);
+            return;
+        }
+        catch (error) {
+            if (attempt >= 4 || !(error instanceof TypeError || error instanceof RobonoError && error.retryable))
+                throw error;
+            log('Connection interrupted. Retrying the same import safely.');
+            await new Promise(r => setTimeout(r, Math.min(15000, 2000 * 2 ** attempt)));
+        }
+    }
+}
+export function validateHistoryImportFile(value) {
+    const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    const id = (v) => typeof v === 'string' && v.length > 0 && v.length <= 200 && v === v.trim() && !/[\u0000-\u001f\u007f]/.test(v);
+    if (!value || !uuid.test(value.jobId) || !uuid.test(value.conversationId) || !Array.isArray(value.authors) || !value.authors.length || value.authors.length > 10000 || value.authors.some((a) => !id(a)) || new Set(value.authors).size !== value.authors.length)
+        throw Error('Provide UUID jobId and conversationId and a unique authors list.');
+    if (!Array.isArray(value.messages) || !value.messages.length || value.messages.length > 10000)
+        throw Error('Include 1–10,000 messages.');
+    const ids = new Map(), order = new Map();
+    for (const [index, message] of value.messages.entries()) {
+        const fail = (reason) => { throw Error(`Message ${index + 1}: ${reason}`); };
+        if (!message || !id(message.sourceId) || ids.has(message.sourceId) || !value.authors.includes(message.authorId))
+            fail('use a unique sourceId and an author from the authors list.');
+        const sent = Date.parse(message.sentAt);
+        if (typeof message.sentAt !== 'string' || !Number.isFinite(sent) || sent < 0 || sent > Date.now())
+            fail('sentAt must be a valid past date.');
+        const c = message.content;
+        if (!c || !['text', 'image', 'video', 'voice', 'document'].includes(c.kind) || Object.keys(c).some(k => !['kind', 'text', 'media'].includes(k)))
+            fail('provide supported content only.');
+        if (c.kind === 'text' && (typeof c.text !== 'string' || !c.text.trim() || c.text.length > 10000 || c.media))
+            fail('text must contain 1–10,000 characters.');
+        if (c.kind !== 'text' && (!c.media || typeof c.media.assetId !== 'string' || !c.media.assetId.startsWith('robono-r2:')))
+            fail('upload attachments privately through importer.upload first. Public source URLs are not accepted.');
+        if (message.replyToSourceId !== undefined && !id(message.replyToSourceId))
+            fail('replyToSourceId must be an original source ID.');
+        ids.set(message.sourceId, sent);
+        order.set(message.sourceId, index);
+    }
+    for (const [index, message] of value.messages.entries())
+        if (message.replyToSourceId !== undefined && (!ids.has(message.replyToSourceId) || ids.get(message.replyToSourceId) > Date.parse(message.sentAt) || message.replyToSourceId === message.sourceId || ids.get(message.replyToSourceId) === Date.parse(message.sentAt) && order.get(message.replyToSourceId) >= index))
+            throw Error(`Message ${index + 1}: the original reply target must exist and precede this message.`);
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
+    runHistoryImport(process.argv.slice(2)).catch(error => { console.error(error instanceof Error ? error.message : 'History import failed.'); process.exitCode = 1; });
+//# sourceMappingURL=history-import-cli.js.map

package/dist/history-import-cli.js.map

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

package/dist/history-import.d.ts

@@ -0,0 +1,64 @@
+import { RobonoManagedMedia } from './managed-media.js';
+import type { MessagingStoredMedia, MessagingUploadFile, MessagingMediaKind } from './messaging-media.js';
+export interface HistoryImportMessage {
+    sourceId: string;
+    authorId: string;
+    sentAt: string;
+    content: {
+        kind: 'text' | 'voice' | 'image' | 'video' | 'document';
+        text?: string;
+        media?: MessagingStoredMedia;
+    };
+    replyToSourceId?: string;
+}
+export interface HistoryImportStatus {
+    jobId: string;
+    state: 'staging' | 'committing' | 'complete' | 'cancelled';
+    expiresAt?: string;
+    stagedCount?: number;
+    importedCount?: number;
+}
+/** Server-only. A manage-scoped key cannot be exposed in an app or browser. */
+export declare class RobonoHistoryImport {
+    private options;
+    private endpoint;
+    constructor(options: {
+        apiKey: string;
+        baseUrl?: string;
+        mediaUrl?: string;
+        fetch?: typeof fetch;
+    });
+    private request;
+    start(input: {
+        jobId: string;
+        conversationId: string;
+        authors: string[];
+        count: number;
+    }): Promise<HistoryImportStatus>;
+    append(jobId: string, messages: Array<HistoryImportMessage & {
+        ordinal: number;
+    }>): Promise<HistoryImportStatus>;
+    status(jobId: string): Promise<HistoryImportStatus>;
+    commit(jobId: string): Promise<HistoryImportStatus>;
+    cancel(jobId: string): Promise<HistoryImportStatus>;
+    /** Upload historic files privately, with normal limits, verification and screening. */
+    media(jobId: string): RobonoManagedMedia;
+    upload(input: {
+        jobId: string;
+        conversationId: string;
+        authorId: string;
+        uploadId: string;
+        kind: MessagingMediaKind;
+        file: MessagingUploadFile;
+        bytes: Uint8Array;
+    }): Promise<MessagingStoredMedia>;
+    /** Retry this whole operation with the same job/source IDs after interruption. */
+    importMessages(input: {
+        jobId: string;
+        conversationId: string;
+        authors: string[];
+        messages: HistoryImportMessage[];
+        onProgress?: (accepted: number, total: number) => void;
+    }): Promise<HistoryImportStatus>;
+}
+//# sourceMappingURL=history-import.d.ts.map

package/dist/history-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-import.d.ts","sourceRoot":"","sources":["../src/history-import.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAC,oBAAoB,EAAC,mBAAmB,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACtG,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAC9C,OAAO,EAAC;QAAC,IAAI,EAAC,MAAM,GAAC,OAAO,GAAC,OAAO,GAAC,OAAO,GAAC,UAAU,CAAC;QAAA,IAAI,CAAC,EAAC,MAAM,CAAC;QAAA,KAAK,CAAC,EAAC,oBAAoB,CAAA;KAAC,CAAC;IAClG,eAAe,CAAC,EAAC,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,mBAAmB;IAAE,KAAK,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,SAAS,GAAC,YAAY,GAAC,UAAU,GAAC,WAAW,CAAC;IAAA,SAAS,CAAC,EAAC,MAAM,CAAC;IAAA,WAAW,CAAC,EAAC,MAAM,CAAC;IAAA,aAAa,CAAC,EAAC,MAAM,CAAA;CAAC;AAEnK,+EAA+E;AAC/E,qBAAa,mBAAmB;IAEnB,OAAO,CAAC,OAAO;IAD3B,OAAO,CAAC,QAAQ,CAAQ;gBACJ,OAAO,EAAC;QAAC,MAAM,EAAC,MAAM,CAAC;QAAA,OAAO,CAAC,EAAC,MAAM,CAAC;QAAA,QAAQ,CAAC,EAAC,MAAM,CAAC;QAAA,KAAK,CAAC,EAAC,OAAO,KAAK,CAAA;KAAC;YAIlF,OAAO;IAOrB,KAAK,CAAC,KAAK,EAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,KAAK,EAAC,MAAM,CAAA;KAAC;IAC9E,MAAM,CAAC,KAAK,EAAC,MAAM,EAAC,QAAQ,EAAC,KAAK,CAAC,oBAAoB,GAAC;QAAC,OAAO,EAAC,MAAM,CAAA;KAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAC,MAAM;IACnB,MAAM,CAAC,KAAK,EAAC,MAAM;IACnB,MAAM,CAAC,KAAK,EAAC,MAAM;IACnB,uFAAuF;IACvF,KAAK,CAAC,KAAK,EAAC,MAAM;IAIZ,MAAM,CAAC,KAAK,EAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,QAAQ,EAAC,MAAM,CAAC;QAAA,QAAQ,EAAC,MAAM,CAAC;QAAA,IAAI,EAAC,kBAAkB,CAAC;QAAA,IAAI,EAAC,mBAAmB,CAAC;QAAA,KAAK,EAAC,UAAU,CAAA;KAAC,GAAE,OAAO,CAAC,oBAAoB,CAAC;IAUxL,kFAAkF;IAC5E,cAAc,CAAC,KAAK,EAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,OAAO,EAAC,MAAM,EAAE,CAAC;QAAA,QAAQ,EAAC,oBAAoB,EAAE,CAAC;QAAA,UAAU,CAAC,EAAC,CAAC,QAAQ,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,KAAG,IAAI,CAAA;KAAC,GAAE,OAAO,CAAC,mBAAmB,CAAC;CAW/L"}