@orangecharts/wrun-chart-host 0.10.0 β†’ 0.11.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 (145) hide show
  1. package/README.md +1 -0
  2. package/dist/constants/feature-flags.constants.d.ts +9 -0
  3. package/dist/constants/feature-flags.constants.js +67 -4
  4. package/dist/constants/governed-exchanges.constants.d.ts +12 -0
  5. package/dist/constants/governed-exchanges.constants.js +16 -0
  6. package/dist/constants/option-venues.constants.d.ts +2 -2
  7. package/dist/host-env.d.ts +1 -9
  8. package/dist/host-ports.types.d.ts +36 -7
  9. package/dist/index.d.ts +6 -1
  10. package/dist/index.js +6 -1
  11. package/dist/interfaces/cancel-reason.interface.d.ts +1 -1
  12. package/dist/interfaces/cme-realtime.interface.d.ts +16 -9
  13. package/dist/interfaces/cme-realtime.interface.js +6 -3
  14. package/dist/interfaces/kscript-diagnostics.interface.d.ts +6 -0
  15. package/dist/interfaces/opra-realtime.interface.d.ts +1 -5
  16. package/dist/interfaces/prediction-market.interface.d.ts +7 -0
  17. package/dist/interfaces/stocks-realtime.interface.d.ts +57 -0
  18. package/dist/interfaces/stocks-realtime.interface.js +32 -0
  19. package/dist/kscript-data/controls/live-trades-merge.util.d.ts +48 -117
  20. package/dist/kscript-data/controls/live-trades-merge.util.js +97 -207
  21. package/dist/market-data/billing.interface.d.ts +86 -12
  22. package/dist/market-data/billing.interface.js +23 -4
  23. package/dist/market-data/venue.d.ts +65 -2
  24. package/dist/market-data/venues/index.d.ts +135 -5
  25. package/dist/market-data/venues/index.js +2 -1
  26. package/dist/market-data/venues/opra.contract.copy.json +3 -2
  27. package/dist/market-data/venues/opra.d.ts +2 -2
  28. package/dist/market-data/venues/opra.js +5 -2
  29. package/dist/market-data/venues/stocks.contract.copy.json +64 -0
  30. package/dist/market-data/venues/stocks.d.ts +130 -0
  31. package/dist/market-data/venues/stocks.js +117 -0
  32. package/dist/settings-templates/footprint-rows.js +35 -2
  33. package/dist/settings-templates/form-rows.d.ts +2 -1
  34. package/dist/settings-templates/indicator-fields.js +34 -4
  35. package/dist/settings-templates/tool-rules.d.ts +12 -5
  36. package/dist/settings-templates/tool-rules.js +11 -5
  37. package/dist/settings-templates/tool-tables.generated.js +4 -0
  38. package/dist/utility/chart/cme-cache-context.util.d.ts +5 -3
  39. package/dist/utility/chart/cme-cache-context.util.js +10 -6
  40. package/dist/utility/chart/cme-realtime.util.js +10 -0
  41. package/dist/utility/chart/cme-user-scripts-gate.util.d.ts +83 -0
  42. package/dist/utility/chart/cme-user-scripts-gate.util.js +142 -0
  43. package/dist/utility/chart/effective-chart-session.util.d.ts +14 -0
  44. package/dist/utility/chart/effective-chart-session.util.js +39 -0
  45. package/dist/utility/chart/host-bar-placement.util.d.ts +28 -0
  46. package/dist/utility/chart/host-bar-placement.util.js +170 -30
  47. package/dist/utility/chart/index-host-tier.util.d.ts +3 -1
  48. package/dist/utility/chart/index-host-tier.util.js +7 -2
  49. package/dist/utility/chart/index-mode-admission.util.js +25 -11
  50. package/dist/utility/chart/kscript-apply-fingerprint.util.js +1 -1
  51. package/dist/utility/chart/kscript-live-coalesce.util.d.ts +6 -9
  52. package/dist/utility/chart/kscript-live-coalesce.util.js +8 -9
  53. package/dist/utility/chart/kscript-live-source-identity.util.d.ts +9 -0
  54. package/dist/utility/chart/kscript-live-source-identity.util.js +10 -1
  55. package/dist/utility/chart/kscript-provenance-keys.util.js +7 -0
  56. package/dist/utility/chart/kscript-standin-identity.leaf.d.ts +3 -1
  57. package/dist/utility/chart/kscript-venue-policy.util.d.ts +115 -21
  58. package/dist/utility/chart/kscript-venue-policy.util.js +194 -40
  59. package/dist/utility/chart/live-bucket.util.d.ts +24 -8
  60. package/dist/utility/chart/live-bucket.util.js +85 -27
  61. package/dist/utility/chart/marketKind.util.js +5 -0
  62. package/dist/utility/chart/mixed-mode.util.d.ts +7 -0
  63. package/dist/utility/chart/mixed-mode.util.js +14 -0
  64. package/dist/utility/chart/opra-user-scripts-gate.util.d.ts +11 -16
  65. package/dist/utility/chart/opra-user-scripts-gate.util.js +12 -28
  66. package/dist/utility/chart/rth-session.util.d.ts +9 -8
  67. package/dist/utility/chart/rth-session.util.js +23 -20
  68. package/dist/utility/chart/trading-day.util.d.ts +17 -0
  69. package/dist/utility/chart/trading-day.util.js +59 -0
  70. package/dist/utility/chart/window-owner.leaf.d.ts +23 -2
  71. package/dist/utility/chart/window-owner.leaf.js +45 -3
  72. package/dist/utility/chart/wrun-bar-session-facts.util.d.ts +33 -15
  73. package/dist/utility/chart/wrun-bar-session-facts.util.js +70 -20
  74. package/dist/utility/intl-locale.util.js +5 -0
  75. package/dist/utility/scriptEditor/wrun-runtime-diagnostics.leaf.js +2 -0
  76. package/dist/utility/v2/gate-plane.util.d.ts +12 -3
  77. package/dist/utility/v2/gate-plane.util.js +30 -4
  78. package/dist/utility/v2/gate-session-latch.util.js +1 -1
  79. package/dist/utility/v2/stocks-governed.util.d.ts +16 -0
  80. package/dist/utility/v2/stocks-governed.util.js +34 -0
  81. package/dist/utility/wrun/derived-roots.leaf.d.ts +13 -0
  82. package/dist/utility/wrun/derived-roots.leaf.js +27 -0
  83. package/dist/utility/wrun/derived-roots.util.d.ts +1 -9
  84. package/dist/utility/wrun/derived-roots.util.js +3 -23
  85. package/dist/utility/wrun/run-schedule/wrun-chart-gate-reader.util.d.ts +4 -3
  86. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.d.ts +24 -3
  87. package/dist/utility/wrun/run-schedule/wrun-own-candles.util.js +46 -10
  88. package/dist/utility/wrun/sources/wrun-poll-lanes.util.js +2 -0
  89. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.d.ts +63 -16
  90. package/dist/utility/wrun/sources/wrun-row-lane-add-memo.util.js +58 -14
  91. package/dist/utility/wrun/sources/wrun-row-lanes.util.d.ts +34 -11
  92. package/dist/utility/wrun/sources/wrun-row-lanes.util.js +106 -30
  93. package/dist/utility/wrun/wrun-browser-sources.leaf.js +1 -2
  94. package/dist/utility/wrun/wrun-chart-market-facts.util.d.ts +7 -4
  95. package/dist/utility/wrun/wrun-chart-market-facts.util.js +12 -8
  96. package/dist/utility/wrun/wrun-color-settings.util.d.ts +9 -0
  97. package/dist/utility/wrun/wrun-color-settings.util.js +33 -0
  98. package/dist/utility/wrun/wrun-handles.util.d.ts +7 -3
  99. package/dist/utility/wrun/wrun-handles.util.js +9 -8
  100. package/dist/utility/wrun/wrun-input-requirements.leaf.d.ts +68 -0
  101. package/dist/utility/wrun/wrun-input-requirements.leaf.js +163 -7
  102. package/dist/utility/wrun/wrun-leg-close.util.d.ts +59 -23
  103. package/dist/utility/wrun/wrun-leg-close.util.js +186 -28
  104. package/dist/utility/wrun/wrun-live-intake.util.d.ts +26 -12
  105. package/dist/utility/wrun/wrun-live-intake.util.js +219 -155
  106. package/dist/utility/wrun/wrun-live-tick.util.d.ts +9 -5
  107. package/dist/utility/wrun/wrun-live-tick.util.js +130 -94
  108. package/dist/utility/wrun/wrun-market-facts.util.d.ts +13 -3
  109. package/dist/utility/wrun/wrun-market-facts.util.js +13 -3
  110. package/dist/utility/wrun/wrun-market-size-defaults.leaf.d.ts +20 -10
  111. package/dist/utility/wrun/wrun-market-size-defaults.leaf.js +10 -5
  112. package/dist/utility/wrun/wrun-option-book-rows.util.d.ts +56 -0
  113. package/dist/utility/wrun/wrun-option-book-rows.util.js +96 -0
  114. package/dist/utility/wrun/wrun-option-views.util.d.ts +281 -20
  115. package/dist/utility/wrun/wrun-option-views.util.js +391 -50
  116. package/dist/utility/wrun/wrun-options-chain.util.d.ts +3 -3
  117. package/dist/utility/wrun/wrun-options-chain.util.js +2 -0
  118. package/dist/utility/wrun/wrun-overlay-drivers.util.d.ts +15 -2
  119. package/dist/utility/wrun/wrun-overlay-drivers.util.js +13 -3
  120. package/dist/utility/wrun/wrun-overlay-recovery.util.js +3 -1
  121. package/dist/utility/wrun/wrun-overlay-run.util.d.ts +60 -11
  122. package/dist/utility/wrun/wrun-overlay-run.util.js +529 -113
  123. package/dist/utility/wrun/wrun-panel-mount.util.js +51 -6
  124. package/dist/utility/wrun/wrun-pin-spelling.util.d.ts +15 -2
  125. package/dist/utility/wrun/wrun-pin-spelling.util.js +27 -3
  126. package/dist/utility/wrun/wrun-refusal.util.d.ts +3 -2
  127. package/dist/utility/wrun/wrun-refusal.util.js +22 -0
  128. package/dist/utility/wrun/wrun-registry-errors.util.d.ts +26 -0
  129. package/dist/utility/wrun/wrun-registry-errors.util.js +34 -0
  130. package/dist/utility/wrun/wrun-replay-lane.util.js +3 -2
  131. package/dist/utility/wrun/wrun-run-interval-session.util.d.ts +20 -6
  132. package/dist/utility/wrun/wrun-run-interval-session.util.js +22 -7
  133. package/dist/utility/wrun/wrun-run-interval.util.d.ts +39 -7
  134. package/dist/utility/wrun/wrun-run-interval.util.js +49 -9
  135. package/dist/utility/wrun/wrun-socket-row-source.js +7 -2
  136. package/dist/utility/wrun/wrun-source-rows.util.d.ts +29 -22
  137. package/dist/utility/wrun/wrun-source-rows.util.js +62 -41
  138. package/dist/utility/wrun/wrun-tape-per-order.util.js +1 -20
  139. package/dist/utility/wrun/wrun-tape-source.util.d.ts +17 -9
  140. package/dist/utility/wrun/wrun-tape-source.util.js +20 -12
  141. package/dist/workers/constants/socket-slots.d.ts +91 -6
  142. package/dist/workers/constants/socket-slots.js +85 -6
  143. package/package.json +11 -11
  144. package/dist/kscript-data/controls/live-trades-order-gate.util.d.ts +0 -56
  145. package/dist/kscript-data/controls/live-trades-order-gate.util.js +0 -107
@@ -29,7 +29,26 @@ export function marketDataProductByKey(venue, key) {
29
29
  }
30
30
  /** The venue records its agreement as the registration its own wall makes (never a purchase step). */
31
31
  export function isMarketDataRegistrationAgreement(venue) {
32
- return venue.agreement.recordedAs === 'registration';
32
+ return venue.agreement?.recordedAs === 'registration';
33
+ }
34
+ /** The venue's listed agreements (`agreements`, in the card's order), or none for a venue of one agreement. */
35
+ export function marketDataListedAgreements(venue) {
36
+ return venue.agreements ?? [];
37
+ }
38
+ /** The listed agreement whose assent real time on `productGroup` needs (an exchange code as the gate names it), or null. */
39
+ export function marketDataAgreementForProductGroup(venue, productGroup) {
40
+ if (!productGroup)
41
+ return null;
42
+ return marketDataListedAgreements(venue).find((agreement) => agreement.productGroups.includes(productGroup)) ?? null;
43
+ }
44
+ /**
45
+ * An assent counts only for the version the agreement's text route presents NOW (`current`, its K1-shaped answer),
46
+ * never for an older text and never for the card's pin. With no current text read, nothing counts.
47
+ */
48
+ export function isMarketDataListedAgreementCurrent(current, assent) {
49
+ if (!current?.version)
50
+ return false;
51
+ return assent?.version === current.version;
33
52
  }
34
53
  /**
35
54
  * A declaration on the venue's current form (a new question set means a new declaration) whose validity has not ended
@@ -91,12 +110,12 @@ export function isMarketDataAgreementCurrent(current, agreement) {
91
110
  export class MarketDataBillingError extends Error {
92
111
  kind;
93
112
  status;
94
- /** Raw backend message: diagnostic content only, never primary UI copy. */
113
+ /** Raw backend message: diagnostic content only, never UI copy. */
95
114
  diagnosticMessage;
96
- /** Stripe's hosted invoice on an 'invoice_owed' refusal; null otherwise. */
115
+ /** Stripe's hosted invoice on the owed-invoice refusal (SUBSCRIPTION_INVOICE_OWED); null otherwise. */
97
116
  invoiceUrl;
98
117
  constructor(kind, options) {
99
- super(`market data billing error: ${kind}`);
118
+ super(`market data billing error: ${kind}`, options?.cause === undefined ? undefined : { cause: options.cause });
100
119
  this.name = 'MarketDataBillingError';
101
120
  this.kind = kind;
102
121
  this.status = options?.status ?? null;
@@ -18,7 +18,10 @@
18
18
  *
19
19
  * Every field a second policy needed (CME: several products, professionals sold, attest first, plan changes, the data
20
20
  * terms as a registration, the two-way declaration, the addendum and the postal address) is optional, and absent means
21
- * the behaviour the OPRA card always had: a card that names none of them is served exactly as before.
21
+ * the behaviour the OPRA card always had: a card that names none of them is served exactly as before. So are the US
22
+ * stocks card's: an agreement per product group (`agreements`, in place of the one `agreement`), an agreement accepted
23
+ * in two sections (`sections`), the fields a declaration records beside the identity (`recordFields`) and the legal
24
+ * name asked as its parts (`legalNameFrom`).
22
25
  */
23
26
  import type { FeatureFlagKey } from '../constants/feature-flags.constants.js';
24
27
  /** The two declarations a subscriber can make; each product names which of them may hold it. */
@@ -101,6 +104,29 @@ export interface MarketDataQuestionnaire {
101
104
  readonly postalAddress?: {
102
105
  readonly answerId: string;
103
106
  };
107
+ /**
108
+ * Text fields the declaration records inside its answers beside the identity, each under its id, in this order
109
+ * (absent: none). US stocks: the CTA Exhibit B Paragraph 12 and UTP subscriber fields the identity does not carry,
110
+ * named as the gate's agreements name them (`firstName`, `postalCode`, `paragraph12Titles`, ...); the server builds
111
+ * each agreement's required fields from the identity and these (docs/features/market-data/plane.md, "Agreements per
112
+ * product group").
113
+ */
114
+ readonly recordFields?: readonly MarketDataRecordField[];
115
+ /**
116
+ * The legal name asked as its parts: these record field ids, joined by single spaces in this order, empty parts left
117
+ * out, make the declaration's `legalName` (absent: one legal name field). US stocks: first, middle and last name,
118
+ * the UTP subscriber fields.
119
+ */
120
+ readonly legalNameFrom?: readonly string[];
121
+ }
122
+ /** One text field a declaration records inside its answers (`questionnaire.recordFields`). */
123
+ export interface MarketDataRecordField {
124
+ /** The answers key the record keeps it under (never translated text). */
125
+ readonly id: string;
126
+ /** Whether the declaration needs it (an optional field left empty is not sent). */
127
+ readonly required: boolean;
128
+ /** The server's bound on the trimmed entry. */
129
+ readonly maxLength: number;
104
130
  }
105
131
  /** The venue's subscriber agreement: an explicit, versioned acceptance, never inferred from a grant or a payment. */
106
132
  export interface MarketDataAgreementPolicy {
@@ -118,6 +144,34 @@ export interface MarketDataAgreementPolicy {
118
144
  */
119
145
  readonly recordedAs?: 'assent' | 'registration';
120
146
  }
147
+ /**
148
+ * One subscriber agreement of a venue that has several, each binding real time on the product groups it covers (US
149
+ * stocks: CTA's Exhibit B for NYSE and NYSE_ARCA, the UTP Subscriber Agreement for NASDAQ). Each is read on its own text
150
+ * route (`GET <basePath>/agreements/<id>`, contract K1's shape) and assented to on its own
151
+ * (`POST <basePath>/agreements/<id>/accept`); the declaration on file records each assent under the id
152
+ * (docs/features/market-data/plane.md, "Agreements per product group").
153
+ */
154
+ export interface MarketDataListedAgreement {
155
+ /** The agreement's id: its route segment and its key in the declaration's `assents` (the gate's agreement name). */
156
+ readonly id: string;
157
+ /** The product groups (exchange codes) whose real time needs an assent to this agreement. */
158
+ readonly productGroups: readonly string[];
159
+ /** The contract export's pin: the version an assent must name is the server's current answer, never this. */
160
+ readonly version: string;
161
+ /** The agreement's text route (K1's shape). */
162
+ readonly url: string;
163
+ /** An explicit, hashed assent: a purchase step, never a registration. */
164
+ readonly recordedAs: 'assent';
165
+ /** Real time only: delayed display never needs it. */
166
+ readonly delayedRequiresAcceptance: false;
167
+ /**
168
+ * How many acceptance controls the agreement's screen takes (absent: one). 2: Section 1 before the served text's
169
+ * `addendumOffset` and Section 2 from it, each read to its end and accepted on its own control, the second sending
170
+ * the one assent (CTA's Exhibit B). A card-only fact, because the offset alone cannot tell two sections from an
171
+ * attached agreement set apart (UTP's); the contract export and its copy carry no such key.
172
+ */
173
+ readonly sections?: 1 | 2;
174
+ }
121
175
  /** The product terms the plan card shows as written (never translated, like the CME bundle names). */
122
176
  export interface MarketDataPlanCard {
123
177
  readonly name: string;
@@ -181,7 +235,16 @@ export interface MarketDataVenue {
181
235
  */
182
236
  readonly offers?: boolean;
183
237
  readonly questionnaire: MarketDataQuestionnaire;
184
- readonly agreement: MarketDataAgreementPolicy;
238
+ /**
239
+ * The venue's one subscriber agreement (OPRA, CME). A card names this or `agreements`, never both and never neither
240
+ * (the store refuses such a card at definition).
241
+ */
242
+ readonly agreement?: MarketDataAgreementPolicy;
243
+ /**
244
+ * The venue's agreements, one per set of product groups, in place of the one `agreement` (US stocks: two). Real time
245
+ * on a product group needs an assent to the agreement covering it; the agreement step asks each in this order.
246
+ */
247
+ readonly agreements?: readonly MarketDataListedAgreement[];
185
248
  /** The delayed tier's nominal delay (the gate's delayed window). */
186
249
  readonly delayMinutes: number;
187
250
  /** 'verbatim': a legally exact English phrase (a compliance constant); 'translated': the venue's locale copy. */
@@ -6,9 +6,10 @@
6
6
  *
7
7
  * Two lists. `MARKET_DATA_VENUES` is served in every session. `FLAG_GATED_MARKET_DATA_VENUES` is carried dark: a card
8
8
  * there is listed only while its `flagKey` reads on, through ONE selector (`marketDataVenueIsServed`), so a venue whose
9
- * generic flow replaces a flow of its own (CME behind `cme-engine`) changes nothing while its flag is off: the bound
10
- * finders never return it, the payment return never takes its venue branch and its doors stay shut. The flag reader is
11
- * the app's, published into this dependency-free module when the app's market-data store module loads
9
+ * generic flow replaces a flow of its own (CME behind `cme-engine`), or whose add-on is not released yet (US stocks
10
+ * behind `us-equities-full`), changes nothing while its flag is off: the bound finders never return it, the payment
11
+ * return never takes its venue branch and its doors stay shut. The flag reader is the app's, published into this
12
+ * dependency-free module when the app's market-data store module loads
12
13
  * (`publishMarketDataVenueFlags`); unpublished, a read that throws (no store in this realm: a worker, a bare spec) or a
13
14
  * card with no flag all read dark.
14
15
  */
@@ -35,7 +36,7 @@ export declare const MARKET_DATA_VENUES: readonly [{
35
36
  };
36
37
  readonly paymentItemPrefix: "opra_";
37
38
  readonly professionalPolicy: "refuse";
38
- readonly internalRolePolicy: "refuse";
39
+ readonly internalRolePolicy: "report";
39
40
  readonly payFirst: true;
40
41
  readonly questionnaire: {
41
42
  readonly formVersion: "opra-v2";
@@ -83,7 +84,7 @@ export declare const MARKET_DATA_VENUES: readonly [{
83
84
  readonly i18nNamespace: "opraRealtimeData";
84
85
  readonly storeId: "opraRealtime";
85
86
  readonly surfaces: readonly ["chain-page-subtitle", "chain-price-pill", "chain-table-marker", "chain-strike-preview", "chain-index-notice", "flow-tape", "terminal-options-tab", "options-overlay-legends", "indicator-legend-notes", "contract-chart-delay-chip", "contract-chart-delay-card", "chart-source-line", "watchlist-panel", "watchlist-cell-tooltip", "board", "purchase-live-price"];
86
- readonly contractRevision: "2026-10-22.1";
87
+ readonly contractRevision: "2026-10-28.1";
87
88
  }];
88
89
  /** The venues carried dark: each is listed only while its `flagKey` reads on (`marketDataVenueIsServed`). */
89
90
  export declare const FLAG_GATED_MARKET_DATA_VENUES: readonly [{
@@ -211,6 +212,135 @@ export declare const FLAG_GATED_MARKET_DATA_VENUES: readonly [{
211
212
  readonly storeId: "cmeMarketData";
212
213
  readonly surfaces: readonly ["contract-chart-delay-chip", "contract-chart-delay-card", "chart-source-line", "watchlist-panel", "watchlist-cell-tooltip", "purchase-live-price"];
213
214
  readonly contractRevision: "2026-10-23.1";
215
+ }, {
216
+ readonly key: "stocks";
217
+ readonly displayName: "US stocks";
218
+ readonly productGroups: readonly import("../../interfaces/stocks-realtime.interface.js").StocksGovernedExchange[];
219
+ readonly basePath: "/market-data/stocks";
220
+ readonly products: readonly [{
221
+ readonly name: "stocks_rt_1m";
222
+ readonly plan: "p1";
223
+ readonly classifications: readonly ["non_professional"];
224
+ readonly interval: "1m";
225
+ readonly priceUsd: 19;
226
+ }];
227
+ readonly planCard: {
228
+ readonly name: "Real-time US stocks";
229
+ readonly level: "ALL US VENUES";
230
+ readonly market: "US stocks";
231
+ readonly region: "πŸ‡ΊπŸ‡Έ USA";
232
+ };
233
+ readonly paymentItemPrefix: "stocks_";
234
+ readonly professionalPolicy: "refuse";
235
+ readonly internalRolePolicy: "refuse";
236
+ readonly payFirst: true;
237
+ readonly questionnaire: {
238
+ readonly formVersion: "stocks-pending";
239
+ readonly questions: readonly [{
240
+ readonly id: "personal_non_business_use";
241
+ readonly qualifying: true;
242
+ }, {
243
+ readonly id: "receives_for_business_or_entity";
244
+ readonly qualifying: false;
245
+ }, {
246
+ readonly id: "registered_sec_cftc";
247
+ readonly qualifying: false;
248
+ }, {
249
+ readonly id: "registered_other_regulator";
250
+ readonly qualifying: false;
251
+ }, {
252
+ readonly id: "performs_registrable_functions";
253
+ readonly qualifying: false;
254
+ }, {
255
+ readonly id: "provides_investment_advice";
256
+ readonly qualifying: false;
257
+ }, {
258
+ readonly id: "asset_manager";
259
+ readonly qualifying: false;
260
+ }, {
261
+ readonly id: "uses_others_capital";
262
+ readonly qualifying: false;
263
+ }, {
264
+ readonly id: "trades_for_entity";
265
+ readonly qualifying: false;
266
+ }, {
267
+ readonly id: "shares_trading_profits";
268
+ readonly qualifying: false;
269
+ }, {
270
+ readonly id: "trading_benefits_received";
271
+ readonly qualifying: false;
272
+ }];
273
+ readonly groups: readonly [];
274
+ readonly identityFields: readonly ["legalName", "employer", "occupation", "country", "address"];
275
+ readonly identityLimits: {
276
+ readonly legalName: 200;
277
+ readonly employer: 200;
278
+ readonly occupation: 200;
279
+ readonly country: 2;
280
+ readonly address: 300;
281
+ };
282
+ readonly recordFields: readonly [{
283
+ readonly id: "firstName";
284
+ readonly required: true;
285
+ readonly maxLength: 64;
286
+ }, {
287
+ readonly id: "middleName";
288
+ readonly required: false;
289
+ readonly maxLength: 64;
290
+ }, {
291
+ readonly id: "lastName";
292
+ readonly required: true;
293
+ readonly maxLength: 64;
294
+ }, {
295
+ readonly id: "postalCode";
296
+ readonly required: true;
297
+ readonly maxLength: 16;
298
+ }, {
299
+ readonly id: "employerAddress";
300
+ readonly required: true;
301
+ readonly maxLength: 300;
302
+ }, {
303
+ readonly id: "employerPostalCode";
304
+ readonly required: true;
305
+ readonly maxLength: 16;
306
+ }, {
307
+ readonly id: "paragraph12Titles";
308
+ readonly required: true;
309
+ readonly maxLength: 200;
310
+ }, {
311
+ readonly id: "paragraph12Functions";
312
+ readonly required: true;
313
+ readonly maxLength: 500;
314
+ }];
315
+ readonly legalNameFrom: readonly ["firstName", "middleName", "lastName"];
316
+ readonly validityDays: 366;
317
+ readonly renewalWindowDays: 30;
318
+ };
319
+ readonly agreements: readonly [{
320
+ readonly id: "cta-exhibit-b";
321
+ readonly productGroups: import("../../interfaces/stocks-realtime.interface.js").StocksGovernedExchange[];
322
+ readonly version: "cta-exhibit-b-pending";
323
+ readonly url: "/api/v1/market-data/stocks/agreements/cta-exhibit-b";
324
+ readonly recordedAs: "assent";
325
+ readonly delayedRequiresAcceptance: false;
326
+ readonly sections: 2;
327
+ }, {
328
+ readonly id: "utp-subscriber";
329
+ readonly productGroups: import("../../interfaces/stocks-realtime.interface.js").StocksGovernedExchange[];
330
+ readonly version: "utp-subscriber-pending";
331
+ readonly url: "/api/v1/market-data/stocks/agreements/utp-subscriber";
332
+ readonly recordedAs: "assent";
333
+ readonly delayedRequiresAcceptance: false;
334
+ }];
335
+ readonly delayMinutes: 15;
336
+ readonly disclosure: {
337
+ readonly kind: "verbatim";
338
+ };
339
+ readonly flagKey: "us-equities-full";
340
+ readonly i18nNamespace: "stocksRealtimeData";
341
+ readonly storeId: "stocksRealtime";
342
+ readonly surfaces: readonly ["contract-chart-delay-chip", "chart-source-line"];
343
+ readonly contractRevision: "2026-10-29.1";
214
344
  }];
215
345
  type CarriedMarketDataVenue = (typeof MARKET_DATA_VENUES)[number] | (typeof FLAG_GATED_MARKET_DATA_VENUES)[number];
216
346
  /** A registered venue's key: a card the build carries, served now or dark. */
@@ -1,9 +1,10 @@
1
1
  import { CME_VENUE } from './cme.js';
2
2
  import { OPRA_VENUE } from './opra.js';
3
+ import { STOCKS_VENUE } from './stocks.js';
3
4
  /** The venues served in every session. */
4
5
  export const MARKET_DATA_VENUES = [OPRA_VENUE];
5
6
  /** The venues carried dark: each is listed only while its `flagKey` reads on (`marketDataVenueIsServed`). */
6
- export const FLAG_GATED_MARKET_DATA_VENUES = [CME_VENUE];
7
+ export const FLAG_GATED_MARKET_DATA_VENUES = [CME_VENUE, STOCKS_VENUE];
7
8
  /** Every card the build carries, served or dark, for the card lookup (`requireVenueByKey`). */
8
9
  const CARRIED_VENUES = [...MARKET_DATA_VENUES, ...FLAG_GATED_MARKET_DATA_VENUES];
9
10
  /** The venue in `venues` with this key, or null. */
@@ -1,5 +1,5 @@
1
1
  {
2
- "revision": "2026-10-22.1",
2
+ "revision": "2026-10-28.1",
3
3
  "key": "opra",
4
4
  "productGroups": ["OPRA"],
5
5
  "products": [
@@ -33,5 +33,6 @@
33
33
  "url": "/api/v1/opra/agreement"
34
34
  },
35
35
  "delaySeconds": 900,
36
- "basePath": "/opra"
36
+ "basePath": "/opra",
37
+ "internalPolicy": "report"
37
38
  }
@@ -18,7 +18,7 @@ export declare const OPRA_VENUE: {
18
18
  };
19
19
  readonly paymentItemPrefix: "opra_";
20
20
  readonly professionalPolicy: "refuse";
21
- readonly internalRolePolicy: "refuse";
21
+ readonly internalRolePolicy: "report";
22
22
  readonly payFirst: true;
23
23
  readonly questionnaire: {
24
24
  readonly formVersion: "opra-v2";
@@ -66,5 +66,5 @@ export declare const OPRA_VENUE: {
66
66
  readonly i18nNamespace: "opraRealtimeData";
67
67
  readonly storeId: "opraRealtime";
68
68
  readonly surfaces: readonly ["chain-page-subtitle", "chain-price-pill", "chain-table-marker", "chain-strike-preview", "chain-index-notice", "flow-tape", "terminal-options-tab", "options-overlay-legends", "indicator-legend-notes", "contract-chart-delay-chip", "contract-chart-delay-card", "chart-source-line", "watchlist-panel", "watchlist-cell-tooltip", "board", "purchase-live-price"];
69
- readonly contractRevision: "2026-10-22.1";
69
+ readonly contractRevision: "2026-10-28.1";
70
70
  };
@@ -17,7 +17,10 @@ export const OPRA_VENUE = {
17
17
  planCard: { name: 'OPRA real-time', level: 'TOP OF BOOK', market: 'OPRA', region: 'πŸ‡ΊπŸ‡Έ USA' },
18
18
  paymentItemPrefix: 'opra_',
19
19
  professionalPolicy: 'refuse',
20
- internalRolePolicy: 'refuse',
20
+ // Staff are reported, as on CME (contract revision 2026-10-28.1; Kyle 2026-10-28: staff get OPRA real time): the
21
+ // server records an internal account's grant as staff (`dev: true`) and the gate reports it. No role is consulted
22
+ // here either way.
23
+ internalRolePolicy: 'report',
21
24
  payFirst: true,
22
25
  questionnaire: {
23
26
  // v2 asks questions 3 to 5 as one group and adds the subscriber's country and address. Bump on any change to the
@@ -71,5 +74,5 @@ export const OPRA_VENUE = {
71
74
  'board',
72
75
  'purchase-live-price',
73
76
  ],
74
- contractRevision: '2026-10-22.1',
77
+ contractRevision: '2026-10-28.1',
75
78
  };
@@ -0,0 +1,64 @@
1
+ {
2
+ "revision": "2026-10-29.1",
3
+ "key": "stocks",
4
+ "productGroups": ["NYSE", "NYSE_ARCA", "NASDAQ"],
5
+ "products": [
6
+ {
7
+ "name": "stocks_rt_1m",
8
+ "plan": "p1",
9
+ "classifications": ["non_professional"],
10
+ "interval": "1m"
11
+ }
12
+ ],
13
+ "formVersion": "stocks-pending",
14
+ "questions": [
15
+ { "id": "personal_non_business_use", "qualifying": true },
16
+ { "id": "receives_for_business_or_entity", "qualifying": false },
17
+ { "id": "registered_sec_cftc", "qualifying": false },
18
+ { "id": "registered_other_regulator", "qualifying": false },
19
+ { "id": "performs_registrable_functions", "qualifying": false },
20
+ { "id": "provides_investment_advice", "qualifying": false },
21
+ { "id": "asset_manager", "qualifying": false },
22
+ { "id": "uses_others_capital", "qualifying": false },
23
+ { "id": "trades_for_entity", "qualifying": false },
24
+ { "id": "shares_trading_profits", "qualifying": false },
25
+ { "id": "trading_benefits_received", "qualifying": false }
26
+ ],
27
+ "identityFields": [
28
+ "legalName",
29
+ "employer",
30
+ "occupation",
31
+ "country",
32
+ "address"
33
+ ],
34
+ "identityLimits": { "text": 200, "address": 300 },
35
+ "agreements": [
36
+ {
37
+ "id": "cta-exhibit-b",
38
+ "productGroups": ["NYSE", "NYSE_ARCA"],
39
+ "version": "cta-exhibit-b-pending",
40
+ "url": "/api/v1/market-data/stocks/agreements/cta-exhibit-b",
41
+ "recordedAs": "assent"
42
+ },
43
+ {
44
+ "id": "utp-subscriber",
45
+ "productGroups": ["NASDAQ"],
46
+ "version": "utp-subscriber-pending",
47
+ "url": "/api/v1/market-data/stocks/agreements/utp-subscriber",
48
+ "recordedAs": "assent"
49
+ }
50
+ ],
51
+ "delaySeconds": 905,
52
+ "basePath": "/market-data/stocks",
53
+ "recordFields": [
54
+ { "id": "firstName", "required": true, "maxLength": 64 },
55
+ { "id": "middleName", "required": false, "maxLength": 64 },
56
+ { "id": "lastName", "required": true, "maxLength": 64 },
57
+ { "id": "postalCode", "required": true, "maxLength": 16 },
58
+ { "id": "employerAddress", "required": true, "maxLength": 300 },
59
+ { "id": "employerPostalCode", "required": true, "maxLength": 16 },
60
+ { "id": "paragraph12Titles", "required": true, "maxLength": 200 },
61
+ { "id": "paragraph12Functions", "required": true, "maxLength": 500 }
62
+ ],
63
+ "legalNameFrom": ["firstName", "middleName", "lastName"]
64
+ }
@@ -0,0 +1,130 @@
1
+ export declare const STOCKS_VENUE: {
2
+ readonly key: "stocks";
3
+ readonly displayName: "US stocks";
4
+ readonly productGroups: readonly import("../../interfaces/stocks-realtime.interface.js").StocksGovernedExchange[];
5
+ readonly basePath: "/market-data/stocks";
6
+ readonly products: readonly [{
7
+ readonly name: "stocks_rt_1m";
8
+ readonly plan: "p1";
9
+ readonly classifications: readonly ["non_professional"];
10
+ readonly interval: "1m";
11
+ readonly priceUsd: 19;
12
+ }];
13
+ readonly planCard: {
14
+ readonly name: "Real-time US stocks";
15
+ readonly level: "ALL US VENUES";
16
+ readonly market: "US stocks";
17
+ readonly region: "πŸ‡ΊπŸ‡Έ USA";
18
+ };
19
+ readonly paymentItemPrefix: "stocks_";
20
+ readonly professionalPolicy: "refuse";
21
+ readonly internalRolePolicy: "refuse";
22
+ readonly payFirst: true;
23
+ readonly questionnaire: {
24
+ readonly formVersion: "stocks-pending";
25
+ readonly questions: readonly [{
26
+ readonly id: "personal_non_business_use";
27
+ readonly qualifying: true;
28
+ }, {
29
+ readonly id: "receives_for_business_or_entity";
30
+ readonly qualifying: false;
31
+ }, {
32
+ readonly id: "registered_sec_cftc";
33
+ readonly qualifying: false;
34
+ }, {
35
+ readonly id: "registered_other_regulator";
36
+ readonly qualifying: false;
37
+ }, {
38
+ readonly id: "performs_registrable_functions";
39
+ readonly qualifying: false;
40
+ }, {
41
+ readonly id: "provides_investment_advice";
42
+ readonly qualifying: false;
43
+ }, {
44
+ readonly id: "asset_manager";
45
+ readonly qualifying: false;
46
+ }, {
47
+ readonly id: "uses_others_capital";
48
+ readonly qualifying: false;
49
+ }, {
50
+ readonly id: "trades_for_entity";
51
+ readonly qualifying: false;
52
+ }, {
53
+ readonly id: "shares_trading_profits";
54
+ readonly qualifying: false;
55
+ }, {
56
+ readonly id: "trading_benefits_received";
57
+ readonly qualifying: false;
58
+ }];
59
+ readonly groups: readonly [];
60
+ readonly identityFields: readonly ["legalName", "employer", "occupation", "country", "address"];
61
+ readonly identityLimits: {
62
+ readonly legalName: 200;
63
+ readonly employer: 200;
64
+ readonly occupation: 200;
65
+ readonly country: 2;
66
+ readonly address: 300;
67
+ };
68
+ readonly recordFields: readonly [{
69
+ readonly id: "firstName";
70
+ readonly required: true;
71
+ readonly maxLength: 64;
72
+ }, {
73
+ readonly id: "middleName";
74
+ readonly required: false;
75
+ readonly maxLength: 64;
76
+ }, {
77
+ readonly id: "lastName";
78
+ readonly required: true;
79
+ readonly maxLength: 64;
80
+ }, {
81
+ readonly id: "postalCode";
82
+ readonly required: true;
83
+ readonly maxLength: 16;
84
+ }, {
85
+ readonly id: "employerAddress";
86
+ readonly required: true;
87
+ readonly maxLength: 300;
88
+ }, {
89
+ readonly id: "employerPostalCode";
90
+ readonly required: true;
91
+ readonly maxLength: 16;
92
+ }, {
93
+ readonly id: "paragraph12Titles";
94
+ readonly required: true;
95
+ readonly maxLength: 200;
96
+ }, {
97
+ readonly id: "paragraph12Functions";
98
+ readonly required: true;
99
+ readonly maxLength: 500;
100
+ }];
101
+ readonly legalNameFrom: readonly ["firstName", "middleName", "lastName"];
102
+ readonly validityDays: 366;
103
+ readonly renewalWindowDays: 30;
104
+ };
105
+ readonly agreements: readonly [{
106
+ readonly id: "cta-exhibit-b";
107
+ readonly productGroups: import("../../interfaces/stocks-realtime.interface.js").StocksGovernedExchange[];
108
+ readonly version: "cta-exhibit-b-pending";
109
+ readonly url: "/api/v1/market-data/stocks/agreements/cta-exhibit-b";
110
+ readonly recordedAs: "assent";
111
+ readonly delayedRequiresAcceptance: false;
112
+ readonly sections: 2;
113
+ }, {
114
+ readonly id: "utp-subscriber";
115
+ readonly productGroups: import("../../interfaces/stocks-realtime.interface.js").StocksGovernedExchange[];
116
+ readonly version: "utp-subscriber-pending";
117
+ readonly url: "/api/v1/market-data/stocks/agreements/utp-subscriber";
118
+ readonly recordedAs: "assent";
119
+ readonly delayedRequiresAcceptance: false;
120
+ }];
121
+ readonly delayMinutes: 15;
122
+ readonly disclosure: {
123
+ readonly kind: "verbatim";
124
+ };
125
+ readonly flagKey: "us-equities-full";
126
+ readonly i18nNamespace: "stocksRealtimeData";
127
+ readonly storeId: "stocksRealtime";
128
+ readonly surfaces: readonly ["contract-chart-delay-chip", "chart-source-line"];
129
+ readonly contractRevision: "2026-10-29.1";
130
+ };