@arca-network/sdk 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/LICENSE +91 -0
  2. package/README.md +65 -0
  3. package/dist/admin.d.ts +159 -0
  4. package/dist/admin.d.ts.map +1 -0
  5. package/dist/admin.js +399 -0
  6. package/dist/admin.js.map +1 -0
  7. package/dist/arca.d.ts +1343 -0
  8. package/dist/arca.d.ts.map +1 -0
  9. package/dist/arca.js +3454 -0
  10. package/dist/arca.js.map +1 -0
  11. package/dist/cache.d.ts +29 -0
  12. package/dist/cache.d.ts.map +1 -0
  13. package/dist/cache.js +74 -0
  14. package/dist/cache.js.map +1 -0
  15. package/dist/candle-cdn.d.ts +17 -0
  16. package/dist/candle-cdn.d.ts.map +1 -0
  17. package/dist/candle-cdn.js +138 -0
  18. package/dist/candle-cdn.js.map +1 -0
  19. package/dist/client.d.ts +98 -0
  20. package/dist/client.d.ts.map +1 -0
  21. package/dist/client.js +225 -0
  22. package/dist/client.js.map +1 -0
  23. package/dist/errors.d.ts +153 -0
  24. package/dist/errors.d.ts.map +1 -0
  25. package/dist/errors.js +243 -0
  26. package/dist/errors.js.map +1 -0
  27. package/dist/events.d.ts +2 -0
  28. package/dist/events.d.ts.map +1 -0
  29. package/dist/events.js +6 -0
  30. package/dist/events.js.map +1 -0
  31. package/dist/index.d.ts +21 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +71 -0
  34. package/dist/index.js.map +1 -0
  35. package/dist/ladder.d.ts +40 -0
  36. package/dist/ladder.d.ts.map +1 -0
  37. package/dist/ladder.js +145 -0
  38. package/dist/ladder.js.map +1 -0
  39. package/dist/ladder.test.d.ts +2 -0
  40. package/dist/ladder.test.d.ts.map +1 -0
  41. package/dist/ladder.test.js +112 -0
  42. package/dist/ladder.test.js.map +1 -0
  43. package/dist/operation-handle.d.ts +88 -0
  44. package/dist/operation-handle.d.ts.map +1 -0
  45. package/dist/operation-handle.js +262 -0
  46. package/dist/operation-handle.js.map +1 -0
  47. package/dist/recovery.d.ts +20 -0
  48. package/dist/recovery.d.ts.map +1 -0
  49. package/dist/recovery.js +91 -0
  50. package/dist/recovery.js.map +1 -0
  51. package/dist/revalue.d.ts +22 -0
  52. package/dist/revalue.d.ts.map +1 -0
  53. package/dist/revalue.js +153 -0
  54. package/dist/revalue.js.map +1 -0
  55. package/dist/streams.d.ts +661 -0
  56. package/dist/streams.d.ts.map +1 -0
  57. package/dist/streams.js +2272 -0
  58. package/dist/streams.js.map +1 -0
  59. package/dist/types.d.ts +2814 -0
  60. package/dist/types.d.ts.map +1 -0
  61. package/dist/types.js +118 -0
  62. package/dist/types.js.map +1 -0
  63. package/dist/websocket.d.ts +240 -0
  64. package/dist/websocket.d.ts.map +1 -0
  65. package/dist/websocket.js +1288 -0
  66. package/dist/websocket.js.map +1 -0
  67. package/package.json +48 -0
@@ -0,0 +1,21 @@
1
+ export { Arca, computeChartRange } from './arca';
2
+ export type { ChartRangePreset } from './arca';
3
+ export { ArcaAdmin } from './admin';
4
+ export { WebSocketManager } from './websocket';
5
+ export { OperationHandle, OrderHandle } from './operation-handle';
6
+ export { OperationWatchStream, BalanceWatchStream, ObjectWatchStream, AggregationWatchStream, EquityChartStream, PnlChartStream, MaxOrderSizeWatchStream, PriceWatchStream, CandleWatchStream, CandleChartStream, CoverageTracker, ExchangeWatchStream, FillWatchStream, FundingWatchStream, WatchStreamReadyTimeoutError, } from './streams';
7
+ export type { WatchStreamState, OperationUpdate, BalanceSnapshot, BalanceUpdate, EquityChartUpdate, PnlChartUpdate, MaxOrderSizeUpdate, FundingUpdate, MaxOrderSizeWatchOptions, ExchangeStateUpdate, FillUpdate, } from './streams';
8
+ /** @deprecated Use {@link PriceWatchStream} instead. */
9
+ export type { MarketPriceStream } from './arca';
10
+ export type { PnlHistoryAnchor, PnlHistoryOptions, HistoryScopeOptions, WatchPricesOptions } from './arca';
11
+ export type { WaitOptions, OrderHandleDeps } from './operation-handle';
12
+ export type { TokenProvider, AuthErrorListener, ArcaConfig, ArcaApiKeyConfig, ArcaTokenConfig, ArcaObject, ArcaObjectType, ArcaObjectStatus, IsolationInfo, ArcaObjectListResponse, ArcaObjectBrowseResponse, BrowsePathEntry, BrowsePathKind, ArcaObjectDetailResponse, ArcaObjectVersionsResponse, IsolationZone, ArcaBalance, ArcaBalanceListResponse, EnsureArcaObjectResponse, DeleteArcaObjectResponse, Operation, OperationType, OperationState, OperationListResponse, OperationDetailResponse, OperationEvidence, OperationEvidenceJournal, OperationEvidenceIntegrity, OperationEvidenceExportResponse, JournalEntryEvidence, JournalLegEvidence, JournalProofEvidence, ChainTransactionEvidence, IntegrityAnnotation, ProofUniquenessEvidence, CryptographicSequenceState, OperationContext, FillContext, FeeBreakdown, TransferContext, DepositContext, WithdrawalContext, OrderPlacedContext, CancelContext, DeleteContext, ArcaEvent, EventListResponse, EventDetailResponse, StateDelta, DeltaType, StateDeltaListResponse, FundAccountResponse, TransferResponse, NonceResponse, ExplorerSummary, BatchSummariesResponse, CanonicalPosition, SnapshotBalancesResponse, AssetBreakdown, BalanceValue, PositionValue, ReservedValue, ObjectValuation, PathAggregation, PnlResponse, PnlHistoryResponse, PnlPoint, ExternalFlowEntry, EquityHistoryResponse, EquityPoint, AggregationSourceDto, CreateWatchResponse, ReconciliationState, ReconciliationStateListResponse, BuilderProfile, AuthResponse, RefreshResponse, ApiKeyStatus, ApiKey, ApiKeyPermissions, CreateApiKeyOptions, ApiKeyCreatedResponse, ApiKeyListResponse, BrowseObjectsOptions, CreateIsolationZoneOptions, Realm, RealmSettings, RealmType, RealmAsset, RealmLifecycle, RealmBacking, CreateRealmAxes, EnsureDenominatedArcaOptions, EnsureArcaOptions, EnsureInfoOptions, UpdateLabelsOptions, EnsureDeletedOptions, TransferOptions, FundAccountOptions, DefundAccountOptions, DefundAccountResponse, ListObjectsOptions, ListEventsOptions, ListOperationsOptions, GetOperationOptions, ExportOperationEvidenceOptions, EventConnectionStatus, EventCallback, EventEnvelope, RealmEvent, TypedRealmEvent, OperationCreatedEvent, OperationUpdatedEvent, EventCreatedEvent, ObjectCreatedEvent, ObjectUpdatedEvent, ObjectDeletedEvent, BalanceUpdatedEvent, ExchangeUpdatedEvent, FillPreviewedEvent, ExchangeFillEvent, FillRecordedEvent, ExchangeFundingEvent, FundingPayment, AggregationUpdatedEvent, ObjectValuationEvent, MidsUpdatedEvent, CandleClosedEvent, CandleUpdatedEvent, RealmCreatedEvent, PolicyEffect, PolicyStatement, TokenScope, MintTokenRequest, MintTokenResponse, ActionCatalogEntry, AliasCatalogEntry, PermissionCatalogResponse, ReservedBalance, ReservedBalanceStatus, ArcaPositionCurrent, RealmListResponse, CreatePerpsExchangeOptions, PredictedEffect, PlaceOrderOptions, ClosePositionOptions, SetPositionTriggerOptions, SetPositionTpslOptions, SetPositionTpslResult, ClearPositionTpslOptions, CancelOrderOptions, OrderOperationResponse, PlaceTwapOptions, TwapOperationResponse, Twap, TwapStatus, TwapLimits, OrderLimits, UpdateLeverageOptions, UpdateLeverageResponse, UpdateIsolatedMarginOptions, UpdateIsolatedMarginResponse, SetMarginModeOptions, SetMarginModeResponse, LeverageSetting, SimAccount, SimMarginSummary, OrderSide, PositionSide, OrderStatus, LeverageType, MarginMode, SimPosition, SimPositionId, PositionListResponse, OrderListResponse, SimOrder, SimFill, SimOrderWithFills, ExchangeIntent, ExchangeState, Fill, FillDirection, FillResultingPosition, FillListResponse, ListFillsOptions, OpenPositionCosts, MarketTradeSummary, TradeSummaryTotals, TradeSummaryResponse, TradeSummaryOptions, ActiveAssetData, OrderBreakdownAmountType, OrderBreakdownOptions, OrderBreakdown, AssetFeeEntry, SimFeeRates, SimFeeTierEntry, Market, SimMetaResponse, SimMidsResponse, MarketTicker, MarketTickersResponse, SimBookLevel, SimBookResponse, CandleInterval, Candle, CandlesResponse, CandleEvent, MarketTrade, TradeEvent, TradeExecutedEvent, LoadRangeResult, CandleChartUpdate, SparklinesResponse, InvariantViolation, InvariantCheckResult, InvariantCheckResponse, AuthAuditEventType, AuthAuditEntry, AuthAuditListResponse, AuthAuditFilters, CredentialScopeResponse, OrgRole, MemberType, InvitationStatus, Organization, OrgMember, OrgMemberListResponse, Invitation, InvitationListResponse, InvitationPreview, InviteMemberRequest, MyOrgMembership, CreateOrgResponse, UpdateMemberRequest, AgentEvent, AgentTextEvent, AgentToolUseEvent, AgentPlanEvent, AgentPlanStep, AgentConversationLogEvent, AgentDoneEvent, AgentStepUpdatedEvent, AgentExecutionDoneEvent, WatchSnapshot, WatchSnapshotBalanceEntry, CustodyBoundaryStatus, CustodyExchangeArcaStatus, CustodyVenueHaltType, CustodyPendingExit, CustodyBoundary, CustodyExchangeArca, CustodyVenueHalt, CustodyStatus, CustodyBoundaryListResponse, CustodyExchangeArcaListResponse, RegisterRecoveryKeyOptions, RegisterRecoveryKeyResponse, PreparedCustodyTransaction, GeneratedRecoveryKey, ActiveTerms, } from './types';
13
+ export { EventType, Channel, toTypedEvent } from './types';
14
+ export type { CacheConfig } from './cache';
15
+ export { pickResolution, pickResolutionFromIso, bucketMs, retentionMs, alignDown, alignUp, boundaries, promotionTarget, ALL_RESOLUTIONS, DEFAULT_POINTS, MIN_POINTS, } from './ladder';
16
+ export type { Resolution } from './ladder';
17
+ export { generateRecoveryKeyPair } from './recovery';
18
+ export { revalueObject, revalueAggregation, revalueExchangeState } from './revalue';
19
+ export { ArcaError, ValidationError, UnauthorizedError, NotFoundError, ConflictError, InternalError, ExchangeError, OperationFailedError, OperationStalledError, StepUpRequiredError, StepUpCancelledError, } from './errors';
20
+ export type { StepUpChallenge } from './errors';
21
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js ADDED
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StepUpCancelledError = exports.StepUpRequiredError = exports.OperationStalledError = exports.OperationFailedError = exports.ExchangeError = exports.InternalError = exports.ConflictError = exports.NotFoundError = exports.UnauthorizedError = exports.ValidationError = exports.ArcaError = exports.revalueExchangeState = exports.revalueAggregation = exports.revalueObject = exports.generateRecoveryKeyPair = exports.MIN_POINTS = exports.DEFAULT_POINTS = exports.ALL_RESOLUTIONS = exports.promotionTarget = exports.boundaries = exports.alignUp = exports.alignDown = exports.retentionMs = exports.bucketMs = exports.pickResolutionFromIso = exports.pickResolution = exports.toTypedEvent = exports.Channel = exports.EventType = exports.WatchStreamReadyTimeoutError = exports.FundingWatchStream = exports.FillWatchStream = exports.ExchangeWatchStream = exports.CoverageTracker = exports.CandleChartStream = exports.CandleWatchStream = exports.PriceWatchStream = exports.MaxOrderSizeWatchStream = exports.PnlChartStream = exports.EquityChartStream = exports.AggregationWatchStream = exports.ObjectWatchStream = exports.BalanceWatchStream = exports.OperationWatchStream = exports.OrderHandle = exports.OperationHandle = exports.WebSocketManager = exports.ArcaAdmin = exports.computeChartRange = exports.Arca = void 0;
4
+ // Main SDK entry point
5
+ var arca_1 = require("./arca");
6
+ Object.defineProperty(exports, "Arca", { enumerable: true, get: function () { return arca_1.Arca; } });
7
+ Object.defineProperty(exports, "computeChartRange", { enumerable: true, get: function () { return arca_1.computeChartRange; } });
8
+ var admin_1 = require("./admin");
9
+ Object.defineProperty(exports, "ArcaAdmin", { enumerable: true, get: function () { return admin_1.ArcaAdmin; } });
10
+ var websocket_1 = require("./websocket");
11
+ Object.defineProperty(exports, "WebSocketManager", { enumerable: true, get: function () { return websocket_1.WebSocketManager; } });
12
+ var operation_handle_1 = require("./operation-handle");
13
+ Object.defineProperty(exports, "OperationHandle", { enumerable: true, get: function () { return operation_handle_1.OperationHandle; } });
14
+ Object.defineProperty(exports, "OrderHandle", { enumerable: true, get: function () { return operation_handle_1.OrderHandle; } });
15
+ var streams_1 = require("./streams");
16
+ Object.defineProperty(exports, "OperationWatchStream", { enumerable: true, get: function () { return streams_1.OperationWatchStream; } });
17
+ Object.defineProperty(exports, "BalanceWatchStream", { enumerable: true, get: function () { return streams_1.BalanceWatchStream; } });
18
+ Object.defineProperty(exports, "ObjectWatchStream", { enumerable: true, get: function () { return streams_1.ObjectWatchStream; } });
19
+ Object.defineProperty(exports, "AggregationWatchStream", { enumerable: true, get: function () { return streams_1.AggregationWatchStream; } });
20
+ Object.defineProperty(exports, "EquityChartStream", { enumerable: true, get: function () { return streams_1.EquityChartStream; } });
21
+ Object.defineProperty(exports, "PnlChartStream", { enumerable: true, get: function () { return streams_1.PnlChartStream; } });
22
+ Object.defineProperty(exports, "MaxOrderSizeWatchStream", { enumerable: true, get: function () { return streams_1.MaxOrderSizeWatchStream; } });
23
+ Object.defineProperty(exports, "PriceWatchStream", { enumerable: true, get: function () { return streams_1.PriceWatchStream; } });
24
+ Object.defineProperty(exports, "CandleWatchStream", { enumerable: true, get: function () { return streams_1.CandleWatchStream; } });
25
+ Object.defineProperty(exports, "CandleChartStream", { enumerable: true, get: function () { return streams_1.CandleChartStream; } });
26
+ Object.defineProperty(exports, "CoverageTracker", { enumerable: true, get: function () { return streams_1.CoverageTracker; } });
27
+ Object.defineProperty(exports, "ExchangeWatchStream", { enumerable: true, get: function () { return streams_1.ExchangeWatchStream; } });
28
+ Object.defineProperty(exports, "FillWatchStream", { enumerable: true, get: function () { return streams_1.FillWatchStream; } });
29
+ Object.defineProperty(exports, "FundingWatchStream", { enumerable: true, get: function () { return streams_1.FundingWatchStream; } });
30
+ Object.defineProperty(exports, "WatchStreamReadyTimeoutError", { enumerable: true, get: function () { return streams_1.WatchStreamReadyTimeoutError; } });
31
+ // Constants and helpers
32
+ var types_1 = require("./types");
33
+ Object.defineProperty(exports, "EventType", { enumerable: true, get: function () { return types_1.EventType; } });
34
+ Object.defineProperty(exports, "Channel", { enumerable: true, get: function () { return types_1.Channel; } });
35
+ Object.defineProperty(exports, "toTypedEvent", { enumerable: true, get: function () { return types_1.toTypedEvent; } });
36
+ // Resolution ladder (shared with backend; keep in sync with
37
+ // backend/services/aggregation/internal/ladder/ladder.go).
38
+ var ladder_1 = require("./ladder");
39
+ Object.defineProperty(exports, "pickResolution", { enumerable: true, get: function () { return ladder_1.pickResolution; } });
40
+ Object.defineProperty(exports, "pickResolutionFromIso", { enumerable: true, get: function () { return ladder_1.pickResolutionFromIso; } });
41
+ Object.defineProperty(exports, "bucketMs", { enumerable: true, get: function () { return ladder_1.bucketMs; } });
42
+ Object.defineProperty(exports, "retentionMs", { enumerable: true, get: function () { return ladder_1.retentionMs; } });
43
+ Object.defineProperty(exports, "alignDown", { enumerable: true, get: function () { return ladder_1.alignDown; } });
44
+ Object.defineProperty(exports, "alignUp", { enumerable: true, get: function () { return ladder_1.alignUp; } });
45
+ Object.defineProperty(exports, "boundaries", { enumerable: true, get: function () { return ladder_1.boundaries; } });
46
+ Object.defineProperty(exports, "promotionTarget", { enumerable: true, get: function () { return ladder_1.promotionTarget; } });
47
+ Object.defineProperty(exports, "ALL_RESOLUTIONS", { enumerable: true, get: function () { return ladder_1.ALL_RESOLUTIONS; } });
48
+ Object.defineProperty(exports, "DEFAULT_POINTS", { enumerable: true, get: function () { return ladder_1.DEFAULT_POINTS; } });
49
+ Object.defineProperty(exports, "MIN_POINTS", { enumerable: true, get: function () { return ladder_1.MIN_POINTS; } });
50
+ // Recovery key generation
51
+ var recovery_1 = require("./recovery");
52
+ Object.defineProperty(exports, "generateRecoveryKeyPair", { enumerable: true, get: function () { return recovery_1.generateRecoveryKeyPair; } });
53
+ // Revalue helpers
54
+ var revalue_1 = require("./revalue");
55
+ Object.defineProperty(exports, "revalueObject", { enumerable: true, get: function () { return revalue_1.revalueObject; } });
56
+ Object.defineProperty(exports, "revalueAggregation", { enumerable: true, get: function () { return revalue_1.revalueAggregation; } });
57
+ Object.defineProperty(exports, "revalueExchangeState", { enumerable: true, get: function () { return revalue_1.revalueExchangeState; } });
58
+ // Errors
59
+ var errors_1 = require("./errors");
60
+ Object.defineProperty(exports, "ArcaError", { enumerable: true, get: function () { return errors_1.ArcaError; } });
61
+ Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
62
+ Object.defineProperty(exports, "UnauthorizedError", { enumerable: true, get: function () { return errors_1.UnauthorizedError; } });
63
+ Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
64
+ Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return errors_1.ConflictError; } });
65
+ Object.defineProperty(exports, "InternalError", { enumerable: true, get: function () { return errors_1.InternalError; } });
66
+ Object.defineProperty(exports, "ExchangeError", { enumerable: true, get: function () { return errors_1.ExchangeError; } });
67
+ Object.defineProperty(exports, "OperationFailedError", { enumerable: true, get: function () { return errors_1.OperationFailedError; } });
68
+ Object.defineProperty(exports, "OperationStalledError", { enumerable: true, get: function () { return errors_1.OperationStalledError; } });
69
+ Object.defineProperty(exports, "StepUpRequiredError", { enumerable: true, get: function () { return errors_1.StepUpRequiredError; } });
70
+ Object.defineProperty(exports, "StepUpCancelledError", { enumerable: true, get: function () { return errors_1.StepUpCancelledError; } });
71
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAuB;AACvB,+BAAiD;AAAxC,4FAAA,IAAI,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAEhC,iCAAoC;AAA3B,kGAAA,SAAS,OAAA;AAClB,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,uDAAkE;AAAzD,mHAAA,eAAe,OAAA;AAAE,+GAAA,WAAW,OAAA;AACrC,qCAgBmB;AAfjB,+GAAA,oBAAoB,OAAA;AACpB,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AACjB,iHAAA,sBAAsB,OAAA;AACtB,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AACd,kHAAA,uBAAuB,OAAA;AACvB,2GAAA,gBAAgB,OAAA;AAChB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,0GAAA,eAAe,OAAA;AACf,8GAAA,mBAAmB,OAAA;AACnB,0GAAA,eAAe,OAAA;AACf,6GAAA,kBAAkB,OAAA;AAClB,uHAAA,4BAA4B,OAAA;AA+R9B,wBAAwB;AACxB,iCAA2D;AAAlD,kGAAA,SAAS,OAAA;AAAE,gGAAA,OAAO,OAAA;AAAE,qGAAA,YAAY,OAAA;AAKzC,4DAA4D;AAC5D,2DAA2D;AAC3D,mCAYkB;AAXhB,wGAAA,cAAc,OAAA;AACd,+GAAA,qBAAqB,OAAA;AACrB,kGAAA,QAAQ,OAAA;AACR,qGAAA,WAAW,OAAA;AACX,mGAAA,SAAS,OAAA;AACT,iGAAA,OAAO,OAAA;AACP,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,oGAAA,UAAU,OAAA;AAIZ,0BAA0B;AAC1B,uCAAqD;AAA5C,mHAAA,uBAAuB,OAAA;AAEhC,kBAAkB;AAClB,qCAAoF;AAA3E,wGAAA,aAAa,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAEhE,SAAS;AACT,mCAYkB;AAXhB,mGAAA,SAAS,OAAA;AACT,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,uGAAA,aAAa,OAAA;AACb,uGAAA,aAAa,OAAA;AACb,uGAAA,aAAa,OAAA;AACb,uGAAA,aAAa,OAAA;AACb,8GAAA,oBAAoB,OAAA;AACpB,+GAAA,qBAAqB,OAAA;AACrB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Canonical chart resolution ladder.
3
+ *
4
+ * The historical chart system materializes per-object and per-path equity
5
+ * snapshots at a fixed set of resolutions. `pickResolution` is the single
6
+ * function that maps a request range to one of those rungs; it is the same
7
+ * code that the backend uses (mirrored verbatim from
8
+ * backend/services/aggregation/internal/ladder/ladder.go).
9
+ *
10
+ * The two implementations must agree byte-for-byte on `pick(...)` for any
11
+ * input. If you change one, change the other in the same change.
12
+ */
13
+ export type Resolution = "1m" | "5m" | "15m" | "30m" | "1h" | "4h" | "1d";
14
+ export declare const ALL_RESOLUTIONS: ReadonlyArray<Resolution>;
15
+ /** Bucket size in milliseconds. Each rung is an integer multiple of the
16
+ * next finer one (5×, 3×, 2×, 2×, 4×, 6×) so re-aggregating is exact. */
17
+ export declare function bucketMs(r: Resolution): number;
18
+ /** Retention window in milliseconds. Rows older than this for a given rung
19
+ * are not guaranteed to exist on the server; callers should expect the
20
+ * read API to "promote" the request to the next-coarser rung with a flag. */
21
+ export declare function retentionMs(r: Resolution): number;
22
+ export declare const DEFAULT_POINTS = 1000;
23
+ export declare const MIN_POINTS = 50;
24
+ /**
25
+ * Pick the finest rung r such that ceil(rangeMs / bucket(r)) ≤ targetPoints.
26
+ * If no rung fits (very long range), returns the coarsest rung. Ladder is
27
+ * shared with the backend; both must agree on the result.
28
+ */
29
+ export declare function pickResolution(rangeMs: number, targetPoints?: number): Resolution;
30
+ /** Align ts down to the start-of-bucket boundary at-or-before t (UTC). */
31
+ export declare function alignDown(ts: number, r: Resolution): number;
32
+ /** Align ts up to the start-of-bucket boundary at-or-after t (UTC). */
33
+ export declare function alignUp(ts: number, r: Resolution): number;
34
+ /** Enumerate bucket boundaries in [from, to] inclusive on both ends. */
35
+ export declare function boundaries(from: number, to: number, r: Resolution): number[];
36
+ /** Return the next-coarser rung above r, or null if r is the coarsest. */
37
+ export declare function promotionTarget(r: Resolution): Resolution | null;
38
+ /** Convenience: ladder selection from string ISO-8601 timestamps. */
39
+ export declare function pickResolutionFromIso(fromIso: string, toIso: string, targetPoints?: number): Resolution;
40
+ //# sourceMappingURL=ladder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ladder.d.ts","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1E,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,UAAU,CAQrD,CAAC;AAOF;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAiB9C;AAED;;6EAE6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CA0BjD;AAED,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAiB,GAAG,UAAU,CAUzF;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAG3D;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAS5E;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAIhE;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,SAAiB,GAC5B,UAAU,CAIZ"}
package/dist/ladder.js ADDED
@@ -0,0 +1,145 @@
1
+ "use strict";
2
+ /**
3
+ * Canonical chart resolution ladder.
4
+ *
5
+ * The historical chart system materializes per-object and per-path equity
6
+ * snapshots at a fixed set of resolutions. `pickResolution` is the single
7
+ * function that maps a request range to one of those rungs; it is the same
8
+ * code that the backend uses (mirrored verbatim from
9
+ * backend/services/aggregation/internal/ladder/ladder.go).
10
+ *
11
+ * The two implementations must agree byte-for-byte on `pick(...)` for any
12
+ * input. If you change one, change the other in the same change.
13
+ */
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.MIN_POINTS = exports.DEFAULT_POINTS = exports.ALL_RESOLUTIONS = void 0;
16
+ exports.bucketMs = bucketMs;
17
+ exports.retentionMs = retentionMs;
18
+ exports.pickResolution = pickResolution;
19
+ exports.alignDown = alignDown;
20
+ exports.alignUp = alignUp;
21
+ exports.boundaries = boundaries;
22
+ exports.promotionTarget = promotionTarget;
23
+ exports.pickResolutionFromIso = pickResolutionFromIso;
24
+ exports.ALL_RESOLUTIONS = [
25
+ "1m",
26
+ "5m",
27
+ "15m",
28
+ "30m",
29
+ "1h",
30
+ "4h",
31
+ "1d",
32
+ ];
33
+ const SECOND = 1_000;
34
+ const MINUTE = 60 * SECOND;
35
+ const HOUR = 60 * MINUTE;
36
+ const DAY = 24 * HOUR;
37
+ /** Bucket size in milliseconds. Each rung is an integer multiple of the
38
+ * next finer one (5×, 3×, 2×, 2×, 4×, 6×) so re-aggregating is exact. */
39
+ function bucketMs(r) {
40
+ switch (r) {
41
+ case "1m":
42
+ return MINUTE;
43
+ case "5m":
44
+ return 5 * MINUTE;
45
+ case "15m":
46
+ return 15 * MINUTE;
47
+ case "30m":
48
+ return 30 * MINUTE;
49
+ case "1h":
50
+ return HOUR;
51
+ case "4h":
52
+ return 4 * HOUR;
53
+ case "1d":
54
+ return DAY;
55
+ }
56
+ }
57
+ /** Retention window in milliseconds. Rows older than this for a given rung
58
+ * are not guaranteed to exist on the server; callers should expect the
59
+ * read API to "promote" the request to the next-coarser rung with a flag. */
60
+ function retentionMs(r) {
61
+ switch (r) {
62
+ case "1m":
63
+ return 7 * DAY;
64
+ case "5m":
65
+ // 5m sits between 1m's 7d and 1h's 90d; 30d keeps intra-day
66
+ // chart windows well covered while avoiding long-term 5m rows.
67
+ return 30 * DAY;
68
+ case "15m":
69
+ // 15m primarily serves default-budget (1000-pt) 1W charts. 45d gives
70
+ // 6× headroom over the 7d window so cliff-promotion is rare.
71
+ return 45 * DAY;
72
+ case "30m":
73
+ // 30m primarily serves compact-budget (500-pt) 1W charts. 60d sits
74
+ // strictly between 15m's and 1h's retention.
75
+ return 60 * DAY;
76
+ case "1h":
77
+ return 90 * DAY;
78
+ case "4h":
79
+ // Long enough for 3M charts plus margin, without retaining a full
80
+ // year of intermediate-resolution rows.
81
+ return 180 * DAY;
82
+ case "1d":
83
+ // "Forever" with a 10-year soft cap.
84
+ return 10 * 365 * DAY;
85
+ }
86
+ }
87
+ exports.DEFAULT_POINTS = 1000;
88
+ exports.MIN_POINTS = 50;
89
+ /**
90
+ * Pick the finest rung r such that ceil(rangeMs / bucket(r)) ≤ targetPoints.
91
+ * If no rung fits (very long range), returns the coarsest rung. Ladder is
92
+ * shared with the backend; both must agree on the result.
93
+ */
94
+ function pickResolution(rangeMs, targetPoints = exports.DEFAULT_POINTS) {
95
+ let pts = targetPoints;
96
+ if (pts < exports.MIN_POINTS)
97
+ pts = exports.MIN_POINTS;
98
+ if (pts > exports.DEFAULT_POINTS)
99
+ pts = exports.DEFAULT_POINTS;
100
+ for (const r of exports.ALL_RESOLUTIONS) {
101
+ const b = bucketMs(r);
102
+ const n = Math.ceil(rangeMs / b);
103
+ if (n <= pts)
104
+ return r;
105
+ }
106
+ return exports.ALL_RESOLUTIONS[exports.ALL_RESOLUTIONS.length - 1];
107
+ }
108
+ /** Align ts down to the start-of-bucket boundary at-or-before t (UTC). */
109
+ function alignDown(ts, r) {
110
+ const b = bucketMs(r);
111
+ return Math.floor(ts / b) * b;
112
+ }
113
+ /** Align ts up to the start-of-bucket boundary at-or-after t (UTC). */
114
+ function alignUp(ts, r) {
115
+ const down = alignDown(ts, r);
116
+ return down === ts ? down : down + bucketMs(r);
117
+ }
118
+ /** Enumerate bucket boundaries in [from, to] inclusive on both ends. */
119
+ function boundaries(from, to, r) {
120
+ if (to <= from)
121
+ return [];
122
+ const start = alignUp(from, r);
123
+ const end = alignDown(to, r);
124
+ if (start > end)
125
+ return [];
126
+ const b = bucketMs(r);
127
+ const out = [];
128
+ for (let cur = start; cur <= end; cur += b)
129
+ out.push(cur);
130
+ return out;
131
+ }
132
+ /** Return the next-coarser rung above r, or null if r is the coarsest. */
133
+ function promotionTarget(r) {
134
+ const idx = exports.ALL_RESOLUTIONS.indexOf(r);
135
+ if (idx < 0 || idx + 1 >= exports.ALL_RESOLUTIONS.length)
136
+ return null;
137
+ return exports.ALL_RESOLUTIONS[idx + 1];
138
+ }
139
+ /** Convenience: ladder selection from string ISO-8601 timestamps. */
140
+ function pickResolutionFromIso(fromIso, toIso, targetPoints = exports.DEFAULT_POINTS) {
141
+ const from = Date.parse(fromIso);
142
+ const to = Date.parse(toIso);
143
+ return pickResolution(Math.max(0, to - from), targetPoints);
144
+ }
145
+ //# sourceMappingURL=ladder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ladder.js","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=ladder.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ladder.test.d.ts","sourceRoot":"","sources":["../src/ladder.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,112 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const vitest_1 = require("vitest");
4
+ const ladder_1 = require("./ladder");
5
+ const HOUR = 60 * 60 * 1000;
6
+ const DAY = 24 * HOUR;
7
+ (0, vitest_1.describe)("ladder.pickResolution", () => {
8
+ (0, vitest_1.it)("picks 1m for ranges that fit", () => {
9
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(HOUR)).toBe("1m");
10
+ });
11
+ // 24h × 500: 1m=1440 (no), 5m=288 (yes). The 5m rung exists
12
+ // precisely so 24h ranges land on intra-hour granularity.
13
+ (0, vitest_1.it)("picks 5m for 24h", () => {
14
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(24 * HOUR, 500)).toBe("5m");
15
+ });
16
+ // 3d × 1000: 5m=864 fits, picks 5m.
17
+ (0, vitest_1.it)("picks 5m for 3d expanded", () => {
18
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(3 * DAY)).toBe("5m");
19
+ });
20
+ // 3d × 500: 5m=864 over, 15m=288 fits.
21
+ (0, vitest_1.it)("picks 15m for 3d compact", () => {
22
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(3 * DAY, 500)).toBe("15m");
23
+ });
24
+ // 7d × 1000: 5m=2016 over, 15m=672 fits — motivating case for 15m.
25
+ (0, vitest_1.it)("picks 15m for 7d expanded", () => {
26
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(7 * DAY)).toBe("15m");
27
+ });
28
+ // 7d × 500: 15m=672 over, 30m=336 fits — motivating case for 30m.
29
+ (0, vitest_1.it)("picks 30m for 7d compact", () => {
30
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(7 * DAY, 500)).toBe("30m");
31
+ });
32
+ (0, vitest_1.it)("picks 4h for compact 30d", () => {
33
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(30 * DAY, 500)).toBe("4h");
34
+ });
35
+ (0, vitest_1.it)("picks 1h for expanded 30d", () => {
36
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(30 * DAY)).toBe("1h");
37
+ });
38
+ (0, vitest_1.it)("picks 4h for expanded 3m", () => {
39
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(92 * DAY)).toBe("4h");
40
+ });
41
+ (0, vitest_1.it)("picks 1d for 1y", () => {
42
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(365 * DAY)).toBe("1d");
43
+ });
44
+ (0, vitest_1.it)("clamps absurd low to MIN_POINTS (1h needs 60 buckets at 1m, 50 forces 5m)", () => {
45
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(HOUR, 1)).toBe("5m");
46
+ });
47
+ (0, vitest_1.it)("clamps absurd high to DEFAULT_POINTS", () => {
48
+ (0, vitest_1.expect)((0, ladder_1.pickResolution)(HOUR, 100_000)).toBe("1m");
49
+ });
50
+ });
51
+ (0, vitest_1.describe)("ladder.boundaries", () => {
52
+ (0, vitest_1.it)("emits inclusive aligned boundaries", () => {
53
+ const from = Date.parse("2026-04-26T17:23:14.000Z");
54
+ const to = from + 3 * HOUR;
55
+ const got = (0, ladder_1.boundaries)(from, to, "1h");
56
+ (0, vitest_1.expect)(got).toEqual([
57
+ Date.parse("2026-04-26T18:00:00.000Z"),
58
+ Date.parse("2026-04-26T19:00:00.000Z"),
59
+ Date.parse("2026-04-26T20:00:00.000Z"),
60
+ ]);
61
+ });
62
+ (0, vitest_1.it)("returns empty for zero or inverted ranges", () => {
63
+ const t = Date.parse("2026-04-26T17:00:00.000Z");
64
+ (0, vitest_1.expect)((0, ladder_1.boundaries)(t, t, "1h")).toEqual([]);
65
+ (0, vitest_1.expect)((0, ladder_1.boundaries)(t, t - HOUR, "1h")).toEqual([]);
66
+ });
67
+ });
68
+ (0, vitest_1.describe)("ladder.alignment", () => {
69
+ (0, vitest_1.it)("alignDown truncates to bucket", () => {
70
+ const t = Date.parse("2026-04-26T17:23:14.000Z");
71
+ (0, vitest_1.expect)((0, ladder_1.alignDown)(t, "1h")).toBe(Date.parse("2026-04-26T17:00:00.000Z"));
72
+ (0, vitest_1.expect)((0, ladder_1.alignDown)(t, "1d")).toBe(Date.parse("2026-04-26T00:00:00.000Z"));
73
+ });
74
+ (0, vitest_1.it)("alignUp returns same instant if already aligned", () => {
75
+ const aligned = Date.parse("2026-04-26T17:00:00.000Z");
76
+ (0, vitest_1.expect)((0, ladder_1.alignUp)(aligned, "1h")).toBe(aligned);
77
+ });
78
+ });
79
+ (0, vitest_1.describe)("ladder.promotionTarget", () => {
80
+ (0, vitest_1.it)("walks the ladder", () => {
81
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("1m")).toBe("5m");
82
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("5m")).toBe("15m");
83
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("15m")).toBe("30m");
84
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("30m")).toBe("1h");
85
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("1h")).toBe("4h");
86
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("4h")).toBe("1d");
87
+ (0, vitest_1.expect)((0, ladder_1.promotionTarget)("1d")).toBeNull();
88
+ });
89
+ });
90
+ (0, vitest_1.describe)("ladder.retention", () => {
91
+ (0, vitest_1.it)("is monotonic across rungs", () => {
92
+ let prev = 0;
93
+ for (const r of ladder_1.ALL_RESOLUTIONS) {
94
+ const ret = (0, ladder_1.retentionMs)(r);
95
+ (0, vitest_1.expect)(ret).toBeGreaterThan(prev);
96
+ prev = ret;
97
+ }
98
+ });
99
+ (0, vitest_1.it)("buckets are integer multiples between adjacent rungs", () => {
100
+ for (let i = 0; i < ladder_1.ALL_RESOLUTIONS.length - 1; i++) {
101
+ const fine = (0, ladder_1.bucketMs)(ladder_1.ALL_RESOLUTIONS[i]);
102
+ const coarse = (0, ladder_1.bucketMs)(ladder_1.ALL_RESOLUTIONS[i + 1]);
103
+ (0, vitest_1.expect)(coarse % fine).toBe(0);
104
+ }
105
+ // Spot-check non-adjacent pairs that downstream code may rely on.
106
+ (0, vitest_1.expect)((0, ladder_1.bucketMs)("1h") % (0, ladder_1.bucketMs)("1m")).toBe(0);
107
+ (0, vitest_1.expect)((0, ladder_1.bucketMs)("1h") % (0, ladder_1.bucketMs)("5m")).toBe(0);
108
+ (0, vitest_1.expect)((0, ladder_1.bucketMs)("1h") % (0, ladder_1.bucketMs)("15m")).toBe(0);
109
+ (0, vitest_1.expect)((0, ladder_1.bucketMs)("1d") % (0, ladder_1.bucketMs)("4h")).toBe(0);
110
+ });
111
+ });
112
+ //# sourceMappingURL=ladder.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ladder.test.js","sourceRoot":"","sources":["../src/ladder.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,88 @@
1
+ import type { Operation, OrderOperationResponse, PredictedEffect, SimFill, SimOrderWithFills, RealmEvent, CancelOrderOptions, Fill, FillListResponse } from './types';
2
+ export interface WaitOptions {
3
+ timeout?: number;
4
+ }
5
+ /**
6
+ * A thenable handle returned synchronously from mutation methods.
7
+ *
8
+ * `await handle` waits for both HTTP submission AND operation settlement,
9
+ * resolving to the full response with `operation.state` updated to the
10
+ * terminal state.
11
+ *
12
+ * For finer control:
13
+ * - `handle.submitted` — access the HTTP response before settlement
14
+ * - `handle.wait({ timeout })` — explicit timeout
15
+ */
16
+ export declare class OperationHandle<TResponse extends {
17
+ operation: Operation | null;
18
+ }> implements PromiseLike<TResponse> {
19
+ /** Resolves when the HTTP call completes (before settlement). */
20
+ readonly submitted: Promise<TResponse>;
21
+ /**
22
+ * Describes the predicted effects of this operation, available synchronously
23
+ * before the server responds. For transfers this includes predicted
24
+ * `departing`/`arriving` balance changes; for orders it includes the
25
+ * order intent.
26
+ */
27
+ readonly predicted?: PredictedEffect;
28
+ private _waitFn;
29
+ private _defaultCompleted;
30
+ constructor(httpCall: Promise<TResponse>, waitFn: (id: string, timeout?: number) => Promise<Operation>, predicted?: PredictedEffect);
31
+ private _settle;
32
+ then<R1 = TResponse, R2 = never>(onfulfilled?: ((value: TResponse) => R1 | PromiseLike<R1>) | null, onrejected?: ((reason: any) => R2 | PromiseLike<R2>) | null): Promise<R1 | R2>;
33
+ /** Wait for settlement with an explicit timeout. */
34
+ wait(opts?: WaitOptions): Promise<TResponse>;
35
+ }
36
+ /** Internal wiring that OrderHandle receives from the Arca instance. */
37
+ export interface OrderHandleDeps {
38
+ getOrder: (objectId: string, orderId: string) => Promise<SimOrderWithFills>;
39
+ onFillEvent: (handler: (event: RealmEvent) => void) => () => void;
40
+ cancelOrder: (opts: CancelOrderOptions) => OperationHandle<OrderOperationResponse>;
41
+ listFills: (objectId: string) => Promise<FillListResponse>;
42
+ }
43
+ /**
44
+ * Extended handle for order lifecycle.
45
+ *
46
+ * `await order` means "the order was placed" (operation completed).
47
+ * Fills and cancellation are separate lifecycle concerns accessible
48
+ * through `.filled()`, `.onFill()`, `.fills()`, and `.cancel()`.
49
+ */
50
+ export declare class OrderHandle extends OperationHandle<OrderOperationResponse> {
51
+ private _objectId;
52
+ private _placementPath;
53
+ private _deps;
54
+ private _orderId;
55
+ constructor(httpCall: Promise<OrderOperationResponse>, waitFn: (id: string, timeout?: number) => Promise<Operation>, objectId: string, placementPath: string, deps: OrderHandleDeps);
56
+ /**
57
+ * Wait for the order to be fully filled.
58
+ * Resolves with the order and all its fills.
59
+ * Rejects on timeout (limit orders may never fill).
60
+ */
61
+ filled(opts?: WaitOptions): Promise<SimOrderWithFills>;
62
+ /**
63
+ * Register a callback for each fill on this order.
64
+ * Returns an unsubscribe function.
65
+ */
66
+ onFill(callback: (fill: SimFill) => void): () => void;
67
+ /**
68
+ * Async iterator that yields fills as they arrive.
69
+ * Terminates when the order is fully filled, cancelled, or timeout.
70
+ */
71
+ fills(opts?: WaitOptions): AsyncIterableIterator<SimFill>;
72
+ /**
73
+ * Get the platform-side fill record for this order, with P&L, fee breakdown,
74
+ * direction, and resulting position. Waits for the order to be filled first.
75
+ *
76
+ * Returns the first fill matching this order's operation, which includes
77
+ * `direction`, `realizedPnl`, `feeBreakdown`, `resultingPosition`, and `startPosition`.
78
+ */
79
+ fillSummary(opts?: WaitOptions): Promise<Fill | null>;
80
+ /**
81
+ * Cancel the order. Auto-generates a cancel path from the placement path,
82
+ * or accepts an explicit path for idempotency control.
83
+ */
84
+ cancel(opts?: {
85
+ path?: string;
86
+ }): OperationHandle<OrderOperationResponse>;
87
+ }
88
+ //# sourceMappingURL=operation-handle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-handle.d.ts","sourceRoot":"","sources":["../src/operation-handle.ts"],"names":[],"mappings":"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"}