@openmarketsai/order-sheet 0.1.0

package/dist/client.js

@@ -0,0 +1,253 @@
+/**
+ * The client: one per credential. Caches the account's constraints, loads
+ * positions, opens sheets, talks to /preflight, /buy, /cancel and the resting
+ * list, and owns the stream. Everything venue-specific arrives from the server.
+ */
+import { credentialSupportsStream, resolveCredential } from './auth.js';
+import { OrderSheetError } from './errors.js';
+import { createHttp } from './http.js';
+import { createSheet, newIdempotencyKey } from './sheet.js';
+import { createOrderStream } from './stream.js';
+import { CONSTRAINTS_VERSION } from './generated/contract.js';
+import { fromServerIssue } from './venues.js';
+export const DEFAULT_API_BASE = 'https://api.openmarkets.ai';
+const DEFAULT_LABELS = {
+    placePractice: 'Place practice order',
+    placeReal: 'Place real order',
+    confirmReal: 'Confirm real order',
+    placing: 'Placing…',
+    practice: 'Practice',
+    real: 'Real money',
+};
+/** The API treats an omitted mode as REAL money, so the SDK never sends a leg without one. */
+function assertLegModes(legs) {
+    if (!Array.isArray(legs) || legs.length === 0)
+        throw new OrderSheetError({ code: 'bad_request', message: 'At least one leg is required.' });
+    legs.forEach((l, i) => {
+        const mode = l?.mode;
+        if (mode !== 'paper' && mode !== 'real') {
+            throw new OrderSheetError({ code: 'bad_request', message: `Leg ${i}: mode must be "paper" or "real" (got ${JSON.stringify(mode)}). The API would treat a missing mode as real money.`, details: { index: i, field: 'mode' } });
+        }
+    });
+}
+export function resolveOptions(input) {
+    const auth = input.apiKey
+        ? { apiKey: input.apiKey }
+        : input.auth
+            ? { auth: input.auth }
+            : input.getToken
+                ? { getToken: input.getToken }
+                : {};
+    const baseUrl = (input.baseUrl ?? DEFAULT_API_BASE).replace(/\/+$/, '');
+    return {
+        auth,
+        baseUrl,
+        streamUrl: input.streamUrl ?? `${baseUrl.replace(/^http/, 'ws')}/flow/v1/stream`,
+        actAs: input.actAs ?? null,
+        defaults: { mode: 'paper', orderType: 'market', stakeUnit: 'amount', slippage: 0.02, oddsFormat: 'cents', staleAfterMs: 60000, ...(input.defaults ?? {}) },
+        realMoney: { enabled: false, confirm: true, ...(input.realMoney ?? {}) },
+        preflight: { auto: true, debounceMs: 300, ...(input.preflight ?? {}) },
+        constraints: { ttlMs: 60000, ...(input.constraints ?? {}) },
+        stream: { enabled: true, pollIntervalMs: 5000, ...(input.stream ?? {}) },
+        labels: { ...DEFAULT_LABELS, ...(input.labels ?? {}) },
+        now: input.now ?? (() => Date.now()),
+        timers: input.timers ?? { set: setTimeout, clear: clearTimeout },
+    };
+}
+export function createOrderSheetClient(input) {
+    const options = resolveOptions(input);
+    const http = createHttp({ baseUrl: options.baseUrl, auth: options.auth, fetch: input.fetch, actAs: options.actAs });
+    const handlers = new Map();
+    const events = {
+        on(event, handler) {
+            if (!handlers.has(event))
+                handlers.set(event, new Set());
+            handlers.get(event).add(handler);
+            return () => { handlers.get(event)?.delete(handler); };
+        },
+        emit(event, payload) {
+            for (const h of handlers.get(event) ?? []) {
+                try {
+                    h(payload);
+                }
+                catch (e) {
+                    console.error('[order-sheet] handler threw', e);
+                }
+            }
+        },
+    };
+    let cached = null;
+    let inflight = null;
+    let stale = false;
+    let stream = null;
+    const sheets = new Set();
+    async function constraints(opts = {}) {
+        const fresh = cached && !stale && options.now() - cached.at < options.constraints.ttlMs;
+        if (fresh && !opts.force)
+            return cached.value;
+        if (inflight)
+            return inflight;
+        inflight = http.request('GET', '/flow/v1/auth/orders/constraints')
+            .then((value) => { cached = { value, at: options.now() }; stale = false; events.emit('constraints', value); return value; })
+            .finally(() => { inflight = null; });
+        return inflight;
+    }
+    function accountFromConstraints(c) {
+        return {
+            routerAccountId: c.account.router_account_id,
+            environment: c.account.environment,
+            canExecute: c.account.can_execute,
+            canPractice: c.account.can_practice,
+            moneyModes: [...c.account.money_modes],
+            practiceOnly: c.account.policy.practice_only,
+            isFiduciary: c.account.is_fiduciary,
+            issues: c.account.issues.map(fromServerIssue),
+            practiceWallet: { partnerId: c.account.practice_wallet.partner_id, currency: c.account.practice_wallet.currency, balance: c.account.practice_wallet.balance },
+            policy: { ...c.account.policy },
+            constraintsVersion: c.constraints_version,
+        };
+    }
+    async function account(opts = {}) {
+        try {
+            return accountFromConstraints(await constraints(opts));
+        }
+        catch (e) {
+            // A credential with no bound account cannot read constraints; /auth/me
+            // still describes what the credential may do.
+            if (e instanceof OrderSheetError && (e.code === 'account_scope_required' || e.code === 'account_not_found')) {
+                const me = await http.request('GET', '/flow/v1/auth/me');
+                return {
+                    routerAccountId: me.router_account_id, environment: me.environment, canExecute: me.can_execute, canPractice: me.can_practice,
+                    moneyModes: [...me.money_modes], practiceOnly: false, isFiduciary: false, issues: [],
+                    practiceWallet: { partnerId: null, currency: 'ATLAS', balance: null }, policy: null, constraintsVersion: null,
+                };
+            }
+            throw e;
+        }
+    }
+    async function loadPosition(ref) {
+        if ('position' in ref)
+            return { position: ref.position, partnerId: ref.partnerId ?? null };
+        let contestId;
+        let positionHash;
+        let partnerId;
+        if ('liquidityHash' in ref) {
+            const parts = ref.liquidityHash.split(':');
+            if (parts.length < 7)
+                throw new OrderSheetError({ code: 'bad_request', message: `Not a liquidity hash: ${ref.liquidityHash}` });
+            partnerId = parts[0];
+            positionHash = parts.slice(1).join(':');
+            contestId = parts[1];
+        }
+        else {
+            const parts = ref.positionHash.split(':');
+            if (parts.length < 6)
+                throw new OrderSheetError({ code: 'bad_request', message: `Not a position hash: ${ref.positionHash}` });
+            positionHash = ref.positionHash;
+            contestId = parts[0];
+            partnerId = ref.partnerId ?? null;
+        }
+        const positions = await http.request('GET', `/flow/v1/contests/${encodeURIComponent(contestId)}/liquidity`);
+        const position = positions.find((p) => p.position_hash === positionHash);
+        if (!position)
+            throw new OrderSheetError({ code: 'position_not_found', message: `Position ${positionHash} is not quoted on contest ${contestId}.`, status: 404 });
+        return { position, partnerId };
+    }
+    function withAtomic(body, atomic, verifyLiquidity) {
+        if (atomic)
+            return { ...body, check_all_first: true, on_leg_failure: 'halt', placement: 'parallel', verify_liquidity: true };
+        return verifyLiquidity ? { ...body, verify_liquidity: true } : body;
+    }
+    async function ensureStream() {
+        if (!options.stream.enabled || !credentialSupportsStream(options.auth))
+            return null;
+        if (!stream) {
+            stream = createOrderStream({
+                url: options.streamUrl,
+                getApiKey: async () => (await resolveCredential(options.auth)).value,
+                WebSocket: input.WebSocket,
+                timers: options.timers,
+            });
+            stream.on('order.update', (f) => events.emit('order.update', f));
+            stream.on('order.settled', (f) => events.emit('order.settled', f));
+            stream.on('balance.update', (f) => {
+                stale = true;
+                events.emit('balance.update', f);
+                events.emit('constraints', cached?.value ?? null);
+                // Balances feed the local checks: with a sheet open, actually re-read
+                // them (single-flighted); otherwise the next constraints() call does.
+                if (sheets.size > 0)
+                    constraints().catch(() => { });
+            });
+            stream.on('connected', (f) => events.emit('stream.connected', f));
+        }
+        await stream.connect();
+        return stream;
+    }
+    const client = {
+        options,
+        http,
+        events,
+        account,
+        constraints,
+        getCachedConstraints: () => cached?.value ?? null,
+        constraintsStale: () => !!cached && cached.value.constraints_version !== CONSTRAINTS_VERSION,
+        accountFromConstraints,
+        invalidateConstraints() { stale = true; events.emit('constraints', cached?.value ?? null); },
+        loadPosition,
+        openSheet(ref, init) {
+            const created = createSheet(client, ref, init);
+            const sheet = { ...created, destroy() { sheets.delete(sheet); created.destroy(); } };
+            sheets.add(sheet);
+            return sheet;
+        },
+        async preflight(legs, opts = {}) {
+            assertLegModes(legs);
+            return http.request('POST', '/flow/v1/auth/orders/preflight', { body: withAtomic({ orders: legs }, opts.atomic, opts.verifyLiquidity) });
+        },
+        async buy(legs, opts = {}) {
+            assertLegModes(legs);
+            if (!options.realMoney.enabled && legs.some((l) => l.mode === 'real')) {
+                throw new OrderSheetError({ code: 'real_money_disabled', message: 'A leg has mode "real" but real-money orders are turned off in this app (realMoney.enabled is false).' });
+            }
+            const body = withAtomic({
+                orders: legs,
+                ...(opts.opportunityId ? { opportunity_id: opts.opportunityId } : {}),
+                ...(opts.modelId ? { model_id: opts.modelId } : {}),
+            }, opts.atomic, opts.verifyLiquidity);
+            const key = opts.idempotencyKey ?? newIdempotencyKey();
+            return http.request('POST', '/flow/v1/auth/orders/buy', { body, headers: { 'Idempotency-Key': key } });
+        },
+        async restingOrders() {
+            return (await http.request('GET', '/flow/v1/auth/orders/resting/me')).orders;
+        },
+        listOrders(opts = {}) {
+            const q = new URLSearchParams();
+            if (opts.contestId)
+                q.set('contest_id', opts.contestId);
+            if (opts.status)
+                q.set('status', opts.status);
+            q.set('limit', String(opts.limit ?? 50));
+            return http.request('GET', `/flow/v1/auth/orders?${q.toString()}`);
+        },
+        cancelOrders(routerOrderIds) {
+            return http.request('POST', '/flow/v1/auth/orders/cancel', { body: { router_order_ids: routerOrderIds } });
+        },
+        me: () => http.request('GET', '/flow/v1/auth/me'),
+        get stream() { return stream; },
+        ensureStream,
+        reset() {
+            cached = null;
+            stale = false;
+            stream?.disconnect();
+            stream = null;
+            for (const s of sheets)
+                s.destroy();
+            sheets.clear();
+            events.emit('constraints', null);
+        },
+        destroy() { client.reset(); handlers.clear(); },
+    };
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,34 @@
+import { type RequestErrorCode } from './generated/contract.js';
+/**
+ * SDK-side failure codes, beside the API's own request error codes. A request
+ * error means the REQUEST was wrong or refused (4xx/5xx, network); a declined
+ * LEG inside a 200 is never thrown — it is an `Issue` on the result.
+ */
+export type ClientErrorCode = 'network_error' | 'invalid_response' | 'not_configured' | 'no_credential' | 'position_not_found' | 'stream_unavailable'
+/** A raw `buy()` carried a real leg while `realMoney.enabled` is false. */
+ | 'real_money_disabled';
+export type OrderSheetErrorCode = RequestErrorCode | ClientErrorCode | (string & {});
+export declare class OrderSheetError extends Error {
+    readonly code: OrderSheetErrorCode;
+    /** HTTP status, or null for a client-side failure. */
+    readonly status: number | null;
+    /** The API's `error.details`, when it sent any. */
+    readonly details: Record<string, unknown> | null;
+    /** A retry may succeed (network, 5xx, 429). Never true for a 4xx that describes the request. */
+    readonly retryable: boolean;
+    constructor(init: {
+        code: OrderSheetErrorCode;
+        message: string;
+        status?: number | null;
+        details?: Record<string, unknown> | null;
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+export declare function isOrderSheetError(e: unknown): e is OrderSheetError;
+/**
+ * What to show an END USER for a thrown error. `error.message` is the API's
+ * developer-facing reason; this is the server-authored plain-language line for
+ * the request-error code (generated), or a status-based fallback.
+ */
+export declare function userMessageFor(e: OrderSheetError): string;

package/dist/errors.js

@@ -0,0 +1,34 @@
+import { REQUEST_ERROR_MESSAGES } from './generated/contract.js';
+export class OrderSheetError extends Error {
+    constructor(init) {
+        super(init.message);
+        this.name = 'OrderSheetError';
+        this.code = init.code;
+        this.status = init.status ?? null;
+        this.details = init.details ?? null;
+        this.retryable = init.retryable ?? false;
+        if (init.cause !== undefined)
+            this.cause = init.cause;
+    }
+}
+export function isOrderSheetError(e) {
+    return e instanceof OrderSheetError || (typeof e === 'object' && e !== null && e.name === 'OrderSheetError');
+}
+/**
+ * What to show an END USER for a thrown error. `error.message` is the API's
+ * developer-facing reason; this is the server-authored plain-language line for
+ * the request-error code (generated), or a status-based fallback.
+ */
+export function userMessageFor(e) {
+    const known = REQUEST_ERROR_MESSAGES[e.code];
+    if (known)
+        return known;
+    if (e.code === 'real_money_disabled')
+        return 'Real-money orders are turned off in this app.';
+    if (e.code === 'network_error' || e.status === null)
+        return 'Couldn\'t reach OpenMarkets. Check your connection and try again.';
+    if (e.retryable)
+        return 'Something went wrong on our side. Try again.';
+    return 'This order couldn\'t be submitted.';
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAyB,MAAM,yBAAyB,CAAA;AAmBvF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAStC,YAAY,IAOX;QACG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAA;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAA;QACxC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAG,IAA4B,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAClF,CAAC;CACJ;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAU;IACxC,OAAO,CAAC,YAAY,eAAe,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAuB,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAA;AACvI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,CAAkB;IAC7C,MAAM,KAAK,GAAI,sBAAiD,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACxE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,IAAI,CAAC,CAAC,IAAI,KAAK,qBAAqB;QAAE,OAAO,+CAA+C,CAAA;IAC5F,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,mEAAmE,CAAA;IAC/H,IAAI,CAAC,CAAC,SAAS;QAAE,OAAO,8CAA8C,CAAA;IACtE,OAAO,oCAAoC,CAAA;AAC/C,CAAC"}

package/dist/generated/contract.d.ts

@@ -0,0 +1,28 @@
+/**
+ * GENERATED — do not edit.
+ *
+ * Source:     src/types/objects/order-constraints.ts (the server contract)
+ * Generator:  npm run gen:order-sheet-contract
+ * CI guard:   npm run gen:order-sheet-contract:check
+ *
+ * Every value here is a closed union the OpenMarkets API emits. Adding a
+ * server code regenerates this file, and the SDK's exhaustive message table
+ * (src/messages.ts) then fails to compile until the new code has a message.
+ */
+/** The shape version of GET /flow/v1/auth/orders/constraints this SDK was generated against. */
+export declare const CONSTRAINTS_VERSION = "2026-09-29.1";
+/** Per-leg issue codes: `rejected_code` on /buy and /preflight, and every reason on /constraints. */
+export declare const ISSUE_CODES: readonly ["real_money_not_permitted", "practice_not_permitted", "test_mode_requires_paper", "venue_disabled", "orders_not_supported", "scope_not_granted", "execution_limit_exceeded", "insufficient_balance", "venue_shard_underfunded", "below_min_order", "above_max_order", "unfillable", "below_min_contracts", "amount_off_increment", "price_out_of_band", "above_max_price", "price_off_tick", "insufficient_size", "insufficient_live_depth", "no_viable_venues", "no_live_price_for_paper", "invalid_requested_amount", "halted_upstream", "unknown"];
+export type IssueCode = (typeof ISSUE_CODES)[number];
+/** What a user can do about an issue. */
+export declare const ISSUE_FIXES: readonly ["raise_price", "lower_price", "raise_stake", "lower_stake", "round_stake", "connect_venue", "fund_venue", "switch_venue", "switch_to_paper", "switch_to_real", "use_market", "use_limit", "grant_scope", "upgrade_plan", "retry", "none"];
+export type IssueFix = (typeof ISSUE_FIXES)[number];
+/** Envelope error codes the /buy and /preflight REQUEST can fail with (4xx/5xx) — the handler's and the middleware's in front of it. */
+export declare const REQUEST_ERROR_CODES: readonly ["missing_credentials", "invalid_api_key", "invalid_jwt", "auth_error", "not_authenticated", "rate_limit_exceeded", "account_forbidden", "scope_not_granted", "idempotency_error", "account_scope_required", "account_not_found", "environment_unresolved", "execution_key_required", "entitlement_required", "bad_request", "unknown_parameter", "conflicting_parameters", "unsupported_order_type", "test_mode_requires_paper", "real_money_not_permitted", "connect_scope_required", "model_not_found", "model_archived", "opportunity_not_found", "currency_mismatch", "model_mismatch", "idempotency_conflict", "internal_error"];
+export type RequestErrorCode = (typeof REQUEST_ERROR_CODES)[number];
+/** What an end user reads when the REQUEST failed (the error's own `message` is developer-facing). */
+export declare const REQUEST_ERROR_MESSAGES: Record<RequestErrorCode, string>;
+/** The server's default severity per code — the SDK's fallback when a response carries no issue object. */
+export declare const ISSUE_SEVERITY: Record<IssueCode, 'block' | 'warn' | 'info'>;
+/** The server's default fix per code (context-dependent codes carry their most common fix). */
+export declare const ISSUE_DEFAULT_FIX: Record<IssueCode, IssueFix>;

package/dist/generated/contract.js

@@ -0,0 +1,176 @@
+/**
+ * GENERATED — do not edit.
+ *
+ * Source:     src/types/objects/order-constraints.ts (the server contract)
+ * Generator:  npm run gen:order-sheet-contract
+ * CI guard:   npm run gen:order-sheet-contract:check
+ *
+ * Every value here is a closed union the OpenMarkets API emits. Adding a
+ * server code regenerates this file, and the SDK's exhaustive message table
+ * (src/messages.ts) then fails to compile until the new code has a message.
+ */
+/** The shape version of GET /flow/v1/auth/orders/constraints this SDK was generated against. */
+export const CONSTRAINTS_VERSION = '2026-09-29.1';
+/** Per-leg issue codes: `rejected_code` on /buy and /preflight, and every reason on /constraints. */
+export const ISSUE_CODES = [
+    'real_money_not_permitted',
+    'practice_not_permitted',
+    'test_mode_requires_paper',
+    'venue_disabled',
+    'orders_not_supported',
+    'scope_not_granted',
+    'execution_limit_exceeded',
+    'insufficient_balance',
+    'venue_shard_underfunded',
+    'below_min_order',
+    'above_max_order',
+    'unfillable',
+    'below_min_contracts',
+    'amount_off_increment',
+    'price_out_of_band',
+    'above_max_price',
+    'price_off_tick',
+    'insufficient_size',
+    'insufficient_live_depth',
+    'no_viable_venues',
+    'no_live_price_for_paper',
+    'invalid_requested_amount',
+    'halted_upstream',
+    'unknown',
+];
+/** What a user can do about an issue. */
+export const ISSUE_FIXES = [
+    'raise_price',
+    'lower_price',
+    'raise_stake',
+    'lower_stake',
+    'round_stake',
+    'connect_venue',
+    'fund_venue',
+    'switch_venue',
+    'switch_to_paper',
+    'switch_to_real',
+    'use_market',
+    'use_limit',
+    'grant_scope',
+    'upgrade_plan',
+    'retry',
+    'none',
+];
+/** Envelope error codes the /buy and /preflight REQUEST can fail with (4xx/5xx) — the handler's and the middleware's in front of it. */
+export const REQUEST_ERROR_CODES = [
+    'missing_credentials',
+    'invalid_api_key',
+    'invalid_jwt',
+    'auth_error',
+    'not_authenticated',
+    'rate_limit_exceeded',
+    'account_forbidden',
+    'scope_not_granted',
+    'idempotency_error',
+    'account_scope_required',
+    'account_not_found',
+    'environment_unresolved',
+    'execution_key_required',
+    'entitlement_required',
+    'bad_request',
+    'unknown_parameter',
+    'conflicting_parameters',
+    'unsupported_order_type',
+    'test_mode_requires_paper',
+    'real_money_not_permitted',
+    'connect_scope_required',
+    'model_not_found',
+    'model_archived',
+    'opportunity_not_found',
+    'currency_mismatch',
+    'model_mismatch',
+    'idempotency_conflict',
+    'internal_error',
+];
+/** What an end user reads when the REQUEST failed (the error's own `message` is developer-facing). */
+export const REQUEST_ERROR_MESSAGES = {
+    missing_credentials: "Sign in to place orders.",
+    invalid_api_key: "This app's access key isn't valid any more.",
+    invalid_jwt: "Your session has expired — sign in again.",
+    auth_error: "We couldn't check your sign-in. Try again.",
+    not_authenticated: "Sign in to place orders.",
+    rate_limit_exceeded: "Too many requests — wait a moment and try again.",
+    account_forbidden: "This app can't act for that account.",
+    scope_not_granted: "This app hasn't been allowed to place orders.",
+    idempotency_error: "The order couldn't be submitted safely. Try again.",
+    account_scope_required: "This sign-in isn't linked to a trading account.",
+    account_not_found: "That trading account no longer exists.",
+    environment_unresolved: "We couldn't tell whether this is a test or live key.",
+    execution_key_required: "This app's key can read markets but not trade.",
+    entitlement_required: "Trading isn't included in this plan.",
+    bad_request: "Something in this order wasn't valid.",
+    unknown_parameter: "Something in this order wasn't valid.",
+    conflicting_parameters: "Something in this order wasn't valid.",
+    unsupported_order_type: "That venue doesn't take this type of order.",
+    test_mode_requires_paper: "This is a test key — it can only place practice orders.",
+    real_money_not_permitted: "Real-money trading is not included in this plan.",
+    connect_scope_required: "This account hasn't allowed this app to trade.",
+    model_not_found: "That model doesn't exist.",
+    model_archived: "That model is archived and takes no new orders.",
+    opportunity_not_found: "That order group doesn't exist.",
+    currency_mismatch: "Those orders use different currencies.",
+    model_mismatch: "That order group belongs to a different model.",
+    idempotency_conflict: "This order was already submitted with different details.",
+    internal_error: "Something went wrong on our side. Try again.",
+};
+/** The server's default severity per code — the SDK's fallback when a response carries no issue object. */
+export const ISSUE_SEVERITY = {
+    real_money_not_permitted: 'block',
+    practice_not_permitted: 'block',
+    test_mode_requires_paper: 'block',
+    venue_disabled: 'block',
+    orders_not_supported: 'block',
+    scope_not_granted: 'block',
+    execution_limit_exceeded: 'block',
+    insufficient_balance: 'block',
+    venue_shard_underfunded: 'block',
+    below_min_order: 'block',
+    above_max_order: 'block',
+    unfillable: 'block',
+    below_min_contracts: 'block',
+    amount_off_increment: 'warn',
+    price_out_of_band: 'block',
+    above_max_price: 'block',
+    price_off_tick: 'warn',
+    insufficient_size: 'block',
+    insufficient_live_depth: 'block',
+    no_viable_venues: 'block',
+    no_live_price_for_paper: 'block',
+    invalid_requested_amount: 'block',
+    halted_upstream: 'info',
+    unknown: 'block',
+};
+/** The server's default fix per code (context-dependent codes carry their most common fix). */
+export const ISSUE_DEFAULT_FIX = {
+    real_money_not_permitted: 'upgrade_plan',
+    practice_not_permitted: 'none',
+    test_mode_requires_paper: 'switch_to_paper',
+    venue_disabled: 'connect_venue',
+    orders_not_supported: 'switch_venue',
+    scope_not_granted: 'grant_scope',
+    execution_limit_exceeded: 'none',
+    insufficient_balance: 'fund_venue',
+    venue_shard_underfunded: 'fund_venue',
+    below_min_order: 'raise_stake',
+    above_max_order: 'lower_stake',
+    unfillable: 'raise_stake',
+    below_min_contracts: 'raise_stake',
+    amount_off_increment: 'round_stake',
+    price_out_of_band: 'lower_price',
+    above_max_price: 'raise_price',
+    price_off_tick: 'none',
+    insufficient_size: 'lower_stake',
+    insufficient_live_depth: 'switch_venue',
+    no_viable_venues: 'switch_venue',
+    no_live_price_for_paper: 'switch_venue',
+    invalid_requested_amount: 'raise_stake',
+    halted_upstream: 'none',
+    unknown: 'retry',
+};
+//# sourceMappingURL=contract.js.map

package/dist/generated/contract.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,19 @@
+import { type AuthOptions } from './auth.js';
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export interface HttpOptions {
+    baseUrl: string;
+    auth: AuthOptions;
+    fetch?: FetchLike;
+    /** X-OpenMarkets-Account — act for a Connect end user (needs connect:trade on the key). */
+    actAs?: string | null;
+}
+export interface RequestOptions {
+    body?: unknown;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+export interface Http {
+    request<T>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, opts?: RequestOptions): Promise<T>;
+    baseUrl: string;
+}
+export declare function createHttp(options: HttpOptions): Http;

package/dist/http.js

@@ -0,0 +1,58 @@
+import { OrderSheetError } from './errors.js';
+import { resolveCredential } from './auth.js';
+const RETRYABLE_STATUS = new Set([408, 425, 429, 500, 502, 503, 504]);
+export function createHttp(options) {
+    const baseUrl = options.baseUrl.replace(/\/+$/, '');
+    const doFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+    async function request(method, path, opts = {}) {
+        const cred = await resolveCredential(options.auth);
+        const headers = {
+            Accept: 'application/json',
+            ...cred.headers,
+            ...(options.actAs ? { 'X-OpenMarkets-Account': options.actAs } : {}),
+            ...(opts.body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+            ...(opts.headers ?? {}),
+        };
+        let res;
+        try {
+            res = await doFetch(`${baseUrl}${path}`, {
+                method,
+                headers,
+                body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+                signal: opts.signal,
+            });
+        }
+        catch (cause) {
+            if (cause?.name === 'AbortError')
+                throw cause;
+            throw new OrderSheetError({ code: 'network_error', message: `Could not reach ${baseUrl}: ${cause?.message ?? String(cause)}`, retryable: true, cause });
+        }
+        let parsed = null;
+        const text = await res.text();
+        if (text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                throw new OrderSheetError({ code: 'invalid_response', message: `Non-JSON response (${res.status}) from ${method} ${path}`, status: res.status, retryable: res.status >= 500 });
+            }
+        }
+        if (!res.ok) {
+            const err = parsed?.error;
+            throw new OrderSheetError({
+                code: err?.code ?? `http_${res.status}`,
+                message: err?.message ?? `${method} ${path} failed with ${res.status}`,
+                status: res.status,
+                details: err?.details ?? null,
+                retryable: RETRYABLE_STATUS.has(res.status),
+            });
+        }
+        const env = parsed;
+        if (!env || typeof env !== 'object' || !('data' in env)) {
+            throw new OrderSheetError({ code: 'invalid_response', message: `Unexpected response shape from ${method} ${path}`, status: res.status });
+        }
+        return env.data;
+    }
+    return { request, baseUrl };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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