@drakkar.software/octobot-client 0.4.0

package/README.md

@@ -0,0 +1,140 @@
+# @drakkar.software/octobot-client
+
+Talk to a self-hosted OctoBot node from TypeScript: wallet identity, accounts, automations,
+strategies, and user actions over the Starfish sync transport.
+
+## What this is not
+
+- **No local state.** Every read is a fresh pull from the node; nothing is cached.
+- **No persistence.** There is no store, no database, no `AsyncStorage`.
+- **No offline queue.** If the node is unreachable, a call fails — it does not queue for later.
+- **No CRDT merge.** This package has no concept of "local edits reconciled with remote state."
+- **No React.** No hooks, no components, no dependency on any UI framework.
+
+If you need any of the above (an offline-first mobile app syncing across devices, say), build that
+layer on top of this package — see [Advanced: building an offline layer on top](https://docs.octobot.cloud/client-sdk/advanced-primitives)
+for the subpath exports meant for exactly that.
+
+## Install
+
+```bash
+npm install @drakkar.software/octobot-client
+```
+
+**Runtime requirements:** WebCrypto (`crypto.subtle` — SHA-256/512, HMAC, PBKDF2, AES-GCM, HKDF),
+`fetch`, `btoa`/`atob`, `AbortController`. Available natively in Node ≥18, all modern browsers, and
+Deno/Bun. React Native needs a crypto polyfill (`react-native-quick-crypto` or similar) — this
+package does not bundle one.
+
+## Hello world
+
+```ts
+import { connectOctoBot, strategy } from '@drakkar.software/octobot-client'
+
+const octobot = await connectOctoBot({
+  url: 'http://192.168.1.10:5001',
+  seed: process.env.OCTOBOT_PRIVATE_KEY!, // a raw 0x-prefixed private key
+})
+
+const [account] = await octobot.accounts.list()
+
+const dca = strategy.dca({ pairs: ['BTC/USDT'], buyOrderAmount: '25' })
+const action = await octobot.automations.create({
+  name: 'My DCA',
+  strategy: dca,
+  accountIds: [account.id],
+})
+
+const automation = await action.settled() // polls the node until it confirms
+console.log(automation.id, automation.status) // 'live'
+```
+
+## Five concepts
+
+1. **A node is a server you point at.** `connectOctoBot({ url, seed })` — no registration, no
+   cloud account. Anyone running their own OctoBot node can be your `url`.
+2. **The wallet IS the identity.** There's no separate login. The private key (or a BIP39 mnemonic,
+   which derives one) deterministically derives both the address the node authorizes and the
+   encryption key for everything synced to it. See
+   [Identity](https://docs.octobot.cloud/client-sdk/identity) — this is the single most important
+   thing to get right, and the easiest to get subtly wrong.
+3. **Collections, not tables.** `accounts`, `settings`, `strategies`, `user-data` are documents at
+   fixed paths under `users/{identity}/...`, pulled and pushed as whole blobs, encrypted per-collection.
+4. **User actions are a queue, not an RPC call.** Creating an account or starting an automation
+   doesn't happen synchronously — it appends one element to an append-only queue the node consumes
+   and executes. `ActionHandle.settled()` is how you wait for the result. See
+   [User actions](https://docs.octobot.cloud/client-sdk/user-actions).
+5. **`ActionHandle` work starts eagerly.** The moment `accounts.create()`/`automations.create()`
+   returns a handle, the underlying action is already appended (and, for automations, the two-phase
+   orchestration is already running). `settled()` just lets you observe the outcome — a caller who
+   never awaits it still leaves nothing half-done.
+
+## API map
+
+| | |
+|---|---|
+| `connectOctoBot(options)` | Connect to a node. Returns an `OctoBotClient`. |
+| `strategy.dca/grid/marketMaking/copy/signal/index/genericProcess(input)` | Pure, zero-I/O strategy builders. |
+| `strategy.build(input)` / `.toInput(strategy)` / `.bumpVersion(v)` | The discriminated-union entry point, its inverse, and version bumping. |
+| `client.accounts.list/get/create/update/delete/refresh/trading` | Exchange, wallet, and generic accounts. |
+| `client.automations.list/get/create/update/stop` | Running bots. |
+| `client.strategies.list/get/create/update/delete` | Reconstructed from the action history — the node has no strategies collection of its own. |
+| `client.settings.get/patch/replace` | An opaque document the node stores encrypted and never reads. |
+| `client.node.status/tradedPairs/predictedOrderBook/requiredFunds/dslKeywords/exportWallet/createGenericProcessBot` | The node's direct REST API. The last three need `basicAuth`. |
+| `client.documents.pull/push/append` + `.raw` | Escape hatch: any collection, the raw `StarfishClient`. |
+| `client.close()` | Drops the derived-key cache. |
+| `createReadOnlyPairing(seed, derivation, node)` | Mint a scoped, node-enforced read-only credential for a less-trusted device. See [Read-only devices](https://docs.octobot.cloud/client-sdk/read-only-pairing). |
+| `connectReadOnlyDevice(pairingPayload)` | Connect with that credential instead of a seed. Write methods return a `ProposedAction` (build, don't send) instead of an `ActionHandle`. |
+| `startPairingRequest(options)` / `fetchPairingRequestByCode({code, rendezvous})` | Website side: publish a device-code pairing request; phone side: look it up (returns `{request, hash}`). See [Website pairing](https://docs.octobot.cloud/client-sdk/website-pairing). |
+| `mintPairingGrant(session, request)` / `publishPairingGrant(...)` | Phone side, on approval: invite the website's device into the cloud mirror as a read-only `space:member`, then seal and publish the grant. |
+| `awaitPairingGrant(session, options)` / `fetchPairingGrant(session, options)` | Website side: wait for (or poll for) the grant, unseal it, and live-read the mirror collections it covers. |
+| `revokePairingGrant(...)` / `clearPairingGrant(...)` | Unpair: remove the website's space membership and clear the rendezvous slot. |
+
+## Errors
+
+Every `OctoBotClient`/`ReadOnlyOctoBotClient` method, and the `client/pairing/*` functions above
+(`startPairingRequest`, `fetchPairingGrant`, etc.), throw an `OctoBotError` subclass (or let an
+`AbortError` `DOMException` through unwrapped, per the platform convention). Switch on `.code`
+rather than `instanceof` if you need the check to survive a duplicated package instance. Full
+taxonomy, extra fields, and handling patterns: [Errors](https://docs.octobot.cloud/client-sdk/errors).
+The two exceptions are the I/O-free `identity/pairingRequest.js` and `identity/pairing.js` pure
+functions (`createPairingRequest`, `parsePairingRequest`, `createReadOnlyPairing`,
+`parseReadOnlyPairing`) — they validate/build payloads only, never touch the network, and throw a
+plain `Error` rather than an `OctoBotError`.
+
+| Class | `code` | When |
+|---|---|---|
+| `OctoBotConfigError` | `'config'` | Bad `ConnectOptions` — unparseable `url`, or a `node.*` call made without `basicAuth`. |
+| `OctoBotConnectionError` | `'unreachable' \| 'timeout' \| 'aborted'` | The node could not be reached. |
+| `OctoBotAuthError` | `'unauthorized'` | The node answered but didn't authorize this wallet — carries `.address`/`.userId`/`.derivation` so you can see what was tried. |
+| `OctoBotHttpError` | `'http'` | A node REST call answered non-2xx. Carries `.status`. |
+| `OctoBotConflictError` | `'conflict'` | A document push raced another writer. Carries `.serverHash` — pull again and retry. |
+| `OctoBotActionError` | `'action_failed'` | The node executed a queued action and rejected it. Not retriable by resubmitting unchanged. |
+| `OctoBotTimeoutError` | `'action_timeout'` | `settled()` gave up waiting — the action may still complete. |
+| `OctoBotScopeError` | `'forbidden_collection'` | A read-only session reached a collection outside its pairing grant — thrown client-side, before any request. |
+
+## Escape hatches
+
+- **Custom `fetch`** — `ConnectOptions.fetch`, for proxies, mTLS, or a React Native polyfill.
+- **`verify: false`** — skip the connect-time probe; `connectOctoBot()` does zero I/O and the first
+  real call surfaces any problem.
+- **Raw documents** — `client.documents.pull/push/append` for any collection, typed loosely; and
+  `client.documents.raw` for the underlying `StarfishClient` and cap provider directly.
+- **`seedDerivation: 'auto'`** — tries every registered derivation scheme and keeps whichever the
+  node authorizes.
+
+Full detail: [Escape hatches](https://docs.octobot.cloud/client-sdk/escape-hatches).
+
+## Compatibility
+
+| This package | `@drakkar.software/octobot-protocol` | Minimum node |
+|---|---|---|
+| `0.3.0` | `^0.6.0` | protocol 0.4.0 |
+
+## More
+
+- [Client SDK docs](https://docs.octobot.cloud/client-sdk/getting-started) — one topic per page,
+  start with Getting Started.
+- [`CHANGELOG.md`](CHANGELOG.md)
+- [Wire contract](https://docs.octobot.cloud/client-sdk/wire-contract) — every literal string shared
+  with the node's Python implementation, for anyone changing either side.

package/dist/client/adapters/accounts.d.ts

@@ -0,0 +1,66 @@
+import type { Account as ProtocolAccount, AccountAuthentication, ExchangeConfig, UserActionConfiguration } from '@drakkar.software/octobot-protocol';
+import type { ClientSession } from '../core/session.js';
+import type { CallOptions } from '../core/options.js';
+import { type AccountView, type Holding } from '../core/views.js';
+import { type ActionHandle } from './actionHandle.js';
+export type { AccountView, AccountKind } from '../core/views.js';
+export type { AccountTradingDocument } from '../../protocol/documents.js';
+export type AccountInput = {
+    id?: string;
+    name: string;
+    type: 'exchange';
+    exchange: string;
+    credentials: {
+        apiKey: string;
+        apiSecret: string;
+        passphrase?: string;
+    };
+    simulated?: boolean;
+    holdings?: Holding[];
+} | {
+    id?: string;
+    name: string;
+    type: 'wallet';
+    address: string;
+    chain?: string;
+    holdings?: Holding[];
+} | {
+    id?: string;
+    name: string;
+    type: 'generic';
+    description?: string;
+    holdings?: Holding[];
+};
+/** The three protocol items one `AccountInput` maps to. `auth`/`exchangeConfig`
+ *  are null for kinds that don't need them (a wallet/generic account still
+ *  gets an `AccountAuthentication` carrying its address; only credentials
+ *  proper are exchange-only). Exported for the read-only facade
+ *  (`readOnly.ts`), which builds the same protocol items without appending
+ *  them. */
+export declare function toAccountGraph(input: AccountInput): {
+    account: ProtocolAccount;
+    auth: AccountAuthentication | null;
+    exchangeConfig: ExchangeConfig | null;
+};
+export interface AccountsApi {
+    list(opts?: CallOptions): Promise<AccountView[]>;
+    get(id: string, opts?: CallOptions): Promise<AccountView | null>;
+    create(input: AccountInput, opts?: CallOptions): Promise<ActionHandle<AccountView | null>>;
+    update(id: string, input: AccountInput, opts?: CallOptions): Promise<ActionHandle<AccountView | null>>;
+    /** The node does NOT cascade deletes — this emits `account_delete` plus
+     *  the two companion deletes (auth, exchange config) itself. */
+    delete(id: string, opts?: CallOptions): Promise<ActionHandle<void>>;
+    refresh(ids?: string[], opts?: CallOptions): Promise<ActionHandle<AccountView[]>>;
+    trading(id: string, opts?: CallOptions): ReturnType<DocumentsApiTrading>;
+}
+type DocumentsApiTrading = (id: string, opts?: CallOptions) => Promise<import('../../protocol/documents.js').AccountTradingDocument | null>;
+export type AppendAction = (configuration: UserActionConfiguration) => Promise<string>;
+/** Pull the raw `accounts` collection document. Exported for the read-only
+ *  facade (`readOnly.ts`), which needs an existing account's `created_at`
+ *  when proposing an edit, same as `update()` below does. */
+export declare function pullAccountsDocument(session: ClientSession): Promise<import("../../transport/documents.js").PulledDocument<{
+    accounts?: ProtocolAccount[];
+    exchange_configs?: ExchangeConfig[];
+}>>;
+export declare function createAccountsApi(session: ClientSession, appendAction: AppendAction): AccountsApi;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/client/adapters/accounts.d.ts.map

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

package/dist/client/adapters/accounts.js

@@ -0,0 +1,214 @@
+import { accountViewOf } from '../core/views.js';
+import { createActionHandle } from './actionHandle.js';
+import { pullDocument } from '../../transport/documents.js';
+import { accountAuthIdFor, exchangeConfigIdFor, buildCreateAccountConfig, buildEditAccountConfig, buildDeleteAccountConfig, buildRefreshAccountsConfig, buildCreateAccountAuthConfig, buildEditAccountAuthConfig, buildDeleteAccountAuthConfig, buildCreateExchangeConfigConfig, buildEditExchangeConfigConfig, buildDeleteExchangeConfigConfig, } from '../../protocol/actions.js';
+import { rethrowAsOctoBotError } from '../core/errors.js';
+const SPOT_TRADING_TYPE = 'spot';
+function holdingsToAssets(holdings) {
+    if (!holdings?.length)
+        return undefined;
+    return [{
+            trading_type: SPOT_TRADING_TYPE,
+            assets: holdings.map((h) => ({ symbol: h.symbol, total: h.total, available: h.free })),
+        }];
+}
+function newAccountId() {
+    return `acc_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+/** The three protocol items one `AccountInput` maps to. `auth`/`exchangeConfig`
+ *  are null for kinds that don't need them (a wallet/generic account still
+ *  gets an `AccountAuthentication` carrying its address; only credentials
+ *  proper are exchange-only). Exported for the read-only facade
+ *  (`readOnly.ts`), which builds the same protocol items without appending
+ *  them. */
+export function toAccountGraph(input) {
+    const id = input.id ?? newAccountId();
+    const now = new Date().toISOString();
+    if (input.type === 'exchange') {
+        return {
+            account: {
+                id,
+                name: input.name,
+                is_simulated: Boolean(input.simulated),
+                created_at: now,
+                updated_at: now,
+                authentication_id: accountAuthIdFor(id),
+                specifics: { account_type: 'exchange', remote_account_id: '', exchange_config_ids: [exchangeConfigIdFor(id)] },
+                ...(holdingsToAssets(input.holdings) ? { assets: holdingsToAssets(input.holdings) } : {}),
+            },
+            auth: {
+                id: accountAuthIdFor(id),
+                api_key: input.credentials.apiKey,
+                api_secret: input.credentials.apiSecret,
+                ...(input.credentials.passphrase ? { api_passphrase: input.credentials.passphrase } : {}),
+            },
+            exchangeConfig: {
+                id: exchangeConfigIdFor(id),
+                name: input.name,
+                exchange: input.exchange,
+                sandboxed: Boolean(input.simulated),
+            },
+        };
+    }
+    if (input.type === 'wallet') {
+        return {
+            account: {
+                id,
+                name: input.name,
+                is_simulated: false,
+                created_at: now,
+                updated_at: now,
+                authentication_id: accountAuthIdFor(id),
+                specifics: { account_type: 'generic' },
+                ...(input.chain ? { description: input.chain } : {}),
+                ...(holdingsToAssets(input.holdings) ? { assets: holdingsToAssets(input.holdings) } : {}),
+            },
+            auth: { id: accountAuthIdFor(id), public_key: input.address },
+            exchangeConfig: null,
+        };
+    }
+    // 'generic' — no credentials, node has nothing to authenticate.
+    return {
+        account: {
+            id,
+            name: input.name,
+            is_simulated: false,
+            created_at: now,
+            updated_at: now,
+            specifics: { account_type: 'generic' },
+            ...(input.description ? { description: input.description } : {}),
+            ...(holdingsToAssets(input.holdings) ? { assets: holdingsToAssets(input.holdings) } : {}),
+        },
+        auth: null,
+        exchangeConfig: null,
+    };
+}
+/** Pull the raw `accounts` collection document. Exported for the read-only
+ *  facade (`readOnly.ts`), which needs an existing account's `created_at`
+ *  when proposing an edit, same as `update()` below does. */
+export async function pullAccountsDocument(session) {
+    const encryptor = await session.collectionEncryptor('accounts');
+    return pullDocument(session.syncClient, 'accounts', { identity: session.userId }, encryptor);
+}
+export function createAccountsApi(session, appendAction) {
+    const pullAccounts = () => pullAccountsDocument(session);
+    async function list() {
+        try {
+            const { data } = await pullAccounts();
+            const configs = data.exchange_configs ?? [];
+            return (data.accounts ?? []).map((a) => accountViewOf(a, configs));
+        }
+        catch (err) {
+            rethrowAsOctoBotError(err);
+        }
+    }
+    async function get(id) {
+        const all = await list();
+        return all.find((a) => a.id === id) ?? null;
+    }
+    async function afterSettle(id) {
+        return get(id);
+    }
+    return {
+        list,
+        get,
+        async create(input) {
+            const { account, auth, exchangeConfig } = toAccountGraph(input);
+            const ids = [];
+            const work = (async () => {
+                if (auth)
+                    ids.push(await appendAction(buildCreateAccountAuthConfig(auth)));
+                if (exchangeConfig)
+                    ids.push(await appendAction(buildCreateExchangeConfigConfig(exchangeConfig)));
+                ids.push(await appendAction(buildCreateAccountConfig(account)));
+                return afterSettle(account.id);
+            })();
+            // ids[] is populated synchronously as `work` progresses; the handle
+            // reflects whatever has been appended by the time it's inspected.
+            return createActionHandle(session, ids, work);
+        },
+        async update(id, input) {
+            const ids = [];
+            const work = (async () => {
+                const { account, auth, exchangeConfig } = toAccountGraph({ ...input, id });
+                const existing = await pullAccounts()
+                    .then(({ data }) => (data.accounts ?? []).find((a) => a.id === id))
+                    .catch(() => undefined);
+                if (existing?.created_at)
+                    account.created_at = existing.created_at;
+                // Credentials/exchange config are rotated BEFORE the account edit so
+                // the node's account re-validation reads the new keys, not the old ones.
+                if (auth)
+                    ids.push(await appendAction(buildEditAccountAuthConfig(auth)));
+                if (exchangeConfig)
+                    ids.push(await appendAction(buildEditExchangeConfigConfig(exchangeConfig)));
+                ids.push(await appendAction(buildEditAccountConfig(id, account)));
+                return afterSettle(id);
+            })();
+            return createActionHandle(session, ids, work);
+        },
+        async delete(id) {
+            const ids = [];
+            const work = (async () => {
+                // Which companion deletes actually apply depends on account kind —
+                // a 'generic' account has no AccountAuthentication at all
+                // (toAccountGraph: auth: null), and an ExchangeConfig only exists
+                // when `specifics.exchange_config_ids` is actually populated (every
+                // AccountSpecifics variant, including 'blockchain', CAN carry it —
+                // this is not exclusive to 'exchange'). Emitting a delete for a
+                // companion that was never created queues a guaranteed non-retriable
+                // failed action on the node (it deletes-by-id; the id never
+                // existed). Pulling first to check is the same pattern update()
+                // already uses for created_at.
+                //
+                // If the pull itself fails (network blip, decrypt error — NOT "the
+                // account doesn't exist"), `existing` is undefined and we can't tell
+                // which companions exist. Defaulting to "delete nothing but the
+                // account" would silently orphan real credentials on the node with
+                // no error surfaced anywhere — worse than the bug being fixed here.
+                // Fall back to the old unconditional-three behavior instead: a
+                // delete for a companion that never existed is a harmless failed
+                // action, not a data leak.
+                let existing;
+                let pullFailed = false;
+                try {
+                    const { data } = await pullAccounts();
+                    existing = (data.accounts ?? []).find((a) => a.id === id);
+                }
+                catch {
+                    pullFailed = true;
+                }
+                const specifics = existing?.specifics;
+                const hasAuth = pullFailed || Boolean(existing?.authentication_id);
+                const hasExchangeConfig = pullFailed || (specifics !== undefined && 'exchange_config_ids' in specifics && (specifics.exchange_config_ids?.length ?? 0) > 0);
+                ids.push(await appendAction(buildDeleteAccountConfig(id)));
+                if (hasAuth) {
+                    ids.push(await appendAction(buildDeleteAccountAuthConfig(accountAuthIdFor(id))));
+                }
+                if (hasExchangeConfig) {
+                    ids.push(await appendAction(buildDeleteExchangeConfigConfig(exchangeConfigIdFor(id))));
+                }
+            })();
+            return createActionHandle(session, ids, work);
+        },
+        async refresh(accountIds) {
+            const ids = [];
+            const work = (async () => {
+                ids.push(await appendAction(buildRefreshAccountsConfig(accountIds)));
+                return list();
+            })();
+            return createActionHandle(session, ids, work);
+        },
+        async trading(id) {
+            try {
+                const encryptor = await session.collectionEncryptor('accountTrading');
+                const { data } = await pullDocument(session.syncClient, 'accountTrading', { identity: session.userId, accountId: id }, encryptor);
+                return data;
+            }
+            catch (err) {
+                rethrowAsOctoBotError(err);
+            }
+        },
+    };
+}
+//# sourceMappingURL=accounts.js.map

package/dist/client/adapters/accounts.js.map

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

package/dist/client/adapters/actionHandle.d.ts

@@ -0,0 +1,29 @@
+import type { UserAction } from '@drakkar.software/octobot-protocol';
+import type { ClientSession } from '../core/session.js';
+import type { CallOptions } from '../core/options.js';
+export interface ActionHandle<T = void> {
+    /** Action ids appended so far. For a multi-phase operation (e.g.
+     *  `automations.create`, which emits a strategy action before the
+     *  automation action) this grows as each phase starts. */
+    readonly ids: readonly string[];
+    /** Resolves once the node reports every phase completed. Memoized — safe
+     *  to await twice, from different call sites, without double-polling.
+     *  The underlying work started the moment the method that returned this
+     *  handle returned (tuning like `timeoutMs`/`onProgress` belongs on THAT
+     *  call, not here) — a caller who never awaits `settled()` still leaves
+     *  nothing half-done, it just won't know the outcome.
+     *  Rejects with `OctoBotActionError` (the node rejected an action) or
+     *  `OctoBotTimeoutError` (the node never confirmed in time). */
+    settled(): Promise<T>;
+    /** One-shot, non-blocking read of the node's current verdict for `ids` —
+     *  does not wait, does not affect the in-flight `settled()` work. */
+    status(opts?: CallOptions): Promise<{
+        settled: boolean;
+        actions: UserAction[];
+    }>;
+}
+/** Wrap an already-started promise (and the action ids it's driving) as a
+ *  public `ActionHandle`. `work` must already be running — see the
+ *  `settled()` doc comment on why eager-start matters. */
+export declare function createActionHandle<T>(session: ClientSession, ids: readonly string[], work: Promise<T>): ActionHandle<T>;
+//# sourceMappingURL=actionHandle.d.ts.map

package/dist/client/adapters/actionHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionHandle.d.ts","sourceRoot":"","sources":["../../../src/client/adapters/actionHandle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKrD,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,IAAI;IACpC;;8DAE0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B;;;;;;;oEAOgE;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;IACrB;yEACqE;IACrE,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAA;CACjF;AAED;;0DAE0D;AAC1D,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,YAAY,CAAC,CAAC,CAAC,CAiCjB"}

package/dist/client/adapters/actionHandle.js

@@ -0,0 +1,34 @@
+import { pullDocument } from '../../transport/documents.js';
+import { parseNodeUserActions } from '../../protocol/state.js';
+import { rethrowAsOctoBotError } from '../core/errors.js';
+/** Wrap an already-started promise (and the action ids it's driving) as a
+ *  public `ActionHandle`. `work` must already be running — see the
+ *  `settled()` doc comment on why eager-start matters. */
+export function createActionHandle(session, ids, work) {
+    // Attach a no-op rejection handler so an unawaited handle never surfaces
+    // an unhandled promise rejection — settled() still gets the real outcome.
+    work.catch(() => undefined);
+    return {
+        ids,
+        settled: () => work.catch((err) => rethrowAsOctoBotError(err)),
+        async status(_opts) {
+            try {
+                const encryptor = await session.collectionEncryptor('userData');
+                const { data } = await pullDocument(session.syncClient, 'userData', { identity: session.userId }, encryptor);
+                const nodeActions = parseNodeUserActions(data);
+                const actions = nodeActions.filter((a) => ids.includes(a.id));
+                // `ids.length > 0` matters: before any phase has appended,
+                // `ids` is still `[]`, making `actions.length === ids.length` true
+                // (0 === 0) and `[].every(...)` vacuously true — without this guard
+                // a caller polling status() immediately after getting a handle back
+                // would see `settled: true` before a single action exists.
+                const settledAll = ids.length > 0 && actions.length === ids.length && actions.every((a) => a.status === 'completed' || a.status === 'failed');
+                return { settled: settledAll, actions };
+            }
+            catch (err) {
+                rethrowAsOctoBotError(err);
+            }
+        },
+    };
+}
+//# sourceMappingURL=actionHandle.js.map

package/dist/client/adapters/actionHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionHandle.js","sourceRoot":"","sources":["../../../src/client/adapters/actionHandle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAqBzD;;0DAE0D;AAC1D,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,GAAsB,EACtB,IAAgB;IAEhB,yEAAyE;IACzE,0EAA0E;IAC1E,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAE3B,OAAO;QACL,GAAG;QACH,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC9D,KAAK,CAAC,MAAM,CAAC,KAAmB;YAC9B,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAA;gBAC/D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CACjC,OAAO,CAAC,UAAU,EAClB,UAAU,EACV,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,EAC5B,SAAS,CACV,CAAA;gBACD,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;gBAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC7D,2DAA2D;gBAC3D,mEAAmE;gBACnE,oEAAoE;gBACpE,oEAAoE;gBACpE,2DAA2D;gBAC3D,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CACjF,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CACzD,CAAA;gBACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,qBAAqB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/client/adapters/automations.d.ts

@@ -0,0 +1,31 @@
+import type { Strategy as ProtocolStrategy } from '@drakkar.software/octobot-protocol';
+import type { ClientSession } from '../core/session.js';
+import type { CallOptions } from '../core/options.js';
+import type { AppendAction } from './accounts.js';
+import { type AutomationView } from '../core/views.js';
+import { type ActionHandle } from './actionHandle.js';
+import { type CreateAutomationProgress } from '../../protocol/orchestration/createAutomation.js';
+export type { AutomationView, CreateAutomationProgress };
+export type CreateAutomationInput = {
+    name: string;
+    description?: string;
+    strategy: ProtocolStrategy;
+    accountIds: string[];
+};
+export interface AutomationsApi {
+    list(opts?: CallOptions): Promise<AutomationView[]>;
+    get(id: string, opts?: CallOptions): Promise<AutomationView | null>;
+    /** Two-phase under the hood: `strategy_create` is appended and confirmed
+     *  BEFORE `automation_create` is appended, avoiding a node-side race where
+     *  the automation would resolve its strategy before the node's
+     *  StrategyProvider had registered it. See `protocol/orchestration/createAutomation.ts`. */
+    create(input: CreateAutomationInput, opts?: {
+        onProgress?: (p: CreateAutomationProgress) => void;
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ActionHandle<AutomationView | null>>;
+    update(id: string, input: CreateAutomationInput, opts?: CallOptions): Promise<ActionHandle<AutomationView | null>>;
+    stop(id: string, opts?: CallOptions): Promise<ActionHandle<void>>;
+}
+export declare function createAutomationsApi(session: ClientSession, appendAction: AppendAction): AutomationsApi;
+//# sourceMappingURL=automations.d.ts.map

package/dist/client/adapters/automations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../../src/client/adapters/automations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,gBAAgB,EAAc,MAAM,oCAAoC,CAAA;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIzE,OAAO,EAA2C,KAAK,wBAAwB,EAAE,MAAM,kDAAkD,CAAA;AAGzI,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,CAAA;AAExD,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IACnE;;;gGAG4F;IAC5F,MAAM,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,CAAA;IAC3L,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,CAAA;IAClH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;CAClE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,GAAG,cAAc,CA0EvG"}

package/dist/client/adapters/automations.js

@@ -0,0 +1,79 @@
+import { automationViewOf } from '../core/views.js';
+import { createActionHandle } from './actionHandle.js';
+import { pullDocument } from '../../transport/documents.js';
+import { parseNodeAutomationStates, parseNodeUserActions } from '../../protocol/state.js';
+import { buildEditAutomationConfig, buildEditStrategyConfig, buildStopAutomationConfig } from '../../protocol/actions.js';
+import { runCreateAutomation } from '../../protocol/orchestration/createAutomation.js';
+import { rethrowAsOctoBotError } from '../core/errors.js';
+export function createAutomationsApi(session, appendAction) {
+    async function pullUserData() {
+        const encryptor = await session.collectionEncryptor('userData');
+        return pullDocument(session.syncClient, 'userData', { identity: session.userId }, encryptor);
+    }
+    async function listWithActions() {
+        const { data } = await pullUserData();
+        const states = parseNodeAutomationStates(data);
+        const actions = parseNodeUserActions(data);
+        return { views: states.map((s) => automationViewOf(s, actions)), actions };
+    }
+    async function list() {
+        try {
+            return (await listWithActions()).views;
+        }
+        catch (err) {
+            rethrowAsOctoBotError(err);
+        }
+    }
+    async function get(id) {
+        const all = await list();
+        return all.find((a) => a.id === id) ?? null;
+    }
+    const emitter = {
+        emit: (configuration) => appendAction(configuration),
+        poll: async () => {
+            const { data } = await pullUserData();
+            return parseNodeUserActions(data);
+        },
+    };
+    return {
+        list,
+        get,
+        async create(input, opts) {
+            const ids = [];
+            const io = {
+                emit: async (configuration) => {
+                    const id = await emitter.emit(configuration);
+                    ids.push(id);
+                    return id;
+                },
+                poll: emitter.poll,
+            };
+            const buildInput = input;
+            const work = runCreateAutomation(io, buildInput, {
+                onProgress: opts?.onProgress,
+                timeoutMs: opts?.timeoutMs,
+                signal: opts?.signal,
+            }).then(({ automationId }) => (automationId ? get(automationId) : null));
+            return createActionHandle(session, ids, work);
+        },
+        async update(id, input) {
+            const ids = [];
+            const work = (async () => {
+                // Same strategy id, bumped version: the node treats strategy items
+                // as replace-by-id, so edits flow through strategy_edit.
+                ids.push(await appendAction(buildEditStrategyConfig(input.strategy)));
+                ids.push(await appendAction(buildEditAutomationConfig({ ...input, automationId: id })));
+                return get(id);
+            })();
+            return createActionHandle(session, ids, work);
+        },
+        async stop(id) {
+            const ids = [];
+            const work = (async () => {
+                ids.push(await appendAction(buildStopAutomationConfig(id)));
+            })();
+            return createActionHandle(session, ids, work);
+        },
+    };
+}
+//# sourceMappingURL=automations.js.map

package/dist/client/adapters/automations.js.map

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