@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.
- package/LICENSE +91 -0
- package/README.md +65 -0
- package/dist/admin.d.ts +159 -0
- package/dist/admin.d.ts.map +1 -0
- package/dist/admin.js +399 -0
- package/dist/admin.js.map +1 -0
- package/dist/arca.d.ts +1343 -0
- package/dist/arca.d.ts.map +1 -0
- package/dist/arca.js +3454 -0
- package/dist/arca.js.map +1 -0
- package/dist/cache.d.ts +29 -0
- package/dist/cache.d.ts.map +1 -0
- package/dist/cache.js +74 -0
- package/dist/cache.js.map +1 -0
- package/dist/candle-cdn.d.ts +17 -0
- package/dist/candle-cdn.d.ts.map +1 -0
- package/dist/candle-cdn.js +138 -0
- package/dist/candle-cdn.js.map +1 -0
- package/dist/client.d.ts +98 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +225 -0
- package/dist/client.js.map +1 -0
- package/dist/errors.d.ts +153 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +243 -0
- package/dist/errors.js.map +1 -0
- package/dist/events.d.ts +2 -0
- package/dist/events.d.ts.map +1 -0
- package/dist/events.js +6 -0
- package/dist/events.js.map +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +71 -0
- package/dist/index.js.map +1 -0
- package/dist/ladder.d.ts +40 -0
- package/dist/ladder.d.ts.map +1 -0
- package/dist/ladder.js +145 -0
- package/dist/ladder.js.map +1 -0
- package/dist/ladder.test.d.ts +2 -0
- package/dist/ladder.test.d.ts.map +1 -0
- package/dist/ladder.test.js +112 -0
- package/dist/ladder.test.js.map +1 -0
- package/dist/operation-handle.d.ts +88 -0
- package/dist/operation-handle.d.ts.map +1 -0
- package/dist/operation-handle.js +262 -0
- package/dist/operation-handle.js.map +1 -0
- package/dist/recovery.d.ts +20 -0
- package/dist/recovery.d.ts.map +1 -0
- package/dist/recovery.js +91 -0
- package/dist/recovery.js.map +1 -0
- package/dist/revalue.d.ts +22 -0
- package/dist/revalue.d.ts.map +1 -0
- package/dist/revalue.js +153 -0
- package/dist/revalue.js.map +1 -0
- package/dist/streams.d.ts +661 -0
- package/dist/streams.d.ts.map +1 -0
- package/dist/streams.js +2272 -0
- package/dist/streams.js.map +1 -0
- package/dist/types.d.ts +2814 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +118 -0
- package/dist/types.js.map +1 -0
- package/dist/websocket.d.ts +240 -0
- package/dist/websocket.d.ts.map +1 -0
- package/dist/websocket.js +1288 -0
- package/dist/websocket.js.map +1 -0
- package/package.json +48 -0
package/dist/index.d.ts
ADDED
|
@@ -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"}
|
package/dist/ladder.d.ts
ADDED
|
@@ -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 @@
|
|
|
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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"}
|