@xbbg/core 1.1.2 → 1.1.3

package/dist/index.d.ts

@@ -0,0 +1,694 @@
+import { Table } from 'apache-arrow';
+
+interface BlpRequestErrorOptions {
+    readonly service?: string;
+    readonly operation?: string;
+    readonly request_id?: string;
+    readonly code?: string | number;
+}
+interface BlpValidationErrorOptions {
+    readonly element?: string;
+    readonly suggestion?: string;
+}
+declare class BlpError extends Error {
+    constructor(message: string);
+}
+declare class BlpSessionError extends BlpError {
+}
+declare class BlpRequestError extends BlpError {
+    readonly service?: string;
+    readonly operation?: string;
+    readonly request_id?: string;
+    readonly code?: string | number;
+    constructor(message: string, options?: BlpRequestErrorOptions);
+}
+declare class BlpValidationError extends BlpError {
+    readonly element?: string;
+    readonly suggestion?: string;
+    constructor(message: string, options?: BlpValidationErrorOptions);
+}
+declare class BlpTimeoutError extends BlpError {
+}
+declare class BlpInternalError extends BlpError {
+}
+declare function wrapError(napiError: unknown): BlpError;
+
+/**
+ * Date-like input accepted by xbbg JS surfaces (issue #317).
+ *
+ * Mirrors the Python `DateLike` alias and the JS half of the date-acceptance
+ * matrix described in the issue:
+ *
+ * - `Date` — JavaScript Date (treated as a calendar date in UTC; the time
+ *   portion is ignored when formatting to `YYYYMMDD`).
+ * - `string` — ISO 8601 (`"2023-01-17"`, `"2023-01-17T10:30:00"`,
+ *   `"2023-01-17T10:30:00-05:00"`) or Bloomberg-native (`"20230117"`).
+ *   Ambiguous formats like `"01/17/2023"` are rejected.
+ * - `number` — epoch milliseconds.
+ * - duck-typed Luxon `DateTime` — anything implementing `toJSDate()`.
+ */
+type DateLike = Date | string | number | {
+    toJSDate: () => Date;
+};
+/**
+ * Datetime-like input. Same shape as `DateLike` today; named separately so the
+ * call sites (`startDatetime`, `endDatetime`, `dt` on intraday surfaces) can
+ * read clearly.
+ */
+type DateTimeLike = DateLike;
+interface StringPair {
+    key: string;
+    value: string;
+}
+interface ServerAddress {
+    host: string;
+    port: number;
+}
+type AuthConfig = {
+    method: 'user';
+} | {
+    method: 'app';
+    appName: string;
+} | {
+    method: 'userapp';
+    appName: string;
+} | {
+    method: 'dir' | 'directory';
+    dirProperty: string;
+} | {
+    method: 'manual';
+    appName: string;
+    userId: string;
+    ipAddress: string;
+} | {
+    method: 'token';
+    token: string;
+};
+interface TlsConfig {
+    clientCredentials?: string;
+    clientCredentialsPassword?: string;
+    trustMaterial?: string;
+    handshakeTimeoutMs?: number;
+    crlFetchTimeoutMs?: number;
+}
+interface RetryPolicy {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    backoffFactor?: number;
+    maxDelayMs?: number;
+}
+interface Socks5Config {
+    host: string;
+    port: number;
+}
+interface EngineConfig {
+    host?: string;
+    port?: number;
+    servers?: ServerAddress[];
+    zfpRemote?: '8194' | '8196';
+    requestPoolSize?: number;
+    subscriptionPoolSize?: number;
+    validationMode?: string;
+    subscriptionFlushThreshold?: number;
+    maxEventQueueSize?: number;
+    commandQueueSize?: number;
+    subscriptionStreamCapacity?: number;
+    overflowPolicy?: string;
+    warmupServices?: string[];
+    fieldCachePath?: string;
+    auth?: AuthConfig;
+    tls?: TlsConfig;
+    numStartAttempts?: number;
+    autoRestartOnDisconnection?: boolean;
+    retryPolicy?: RetryPolicy;
+    /** Hard per-request timeout in ms; 0 disables. Default 0. */
+    requestTimeoutMs?: number;
+    /** Warn threshold for streams staying deactivated, in ms. 0 disables. Default 30000. */
+    streamsDeactivatedWarnMs?: number;
+    /** Enable BLPAPI keep-alive pings. SDK default: true. */
+    keepAliveEnabled?: boolean;
+    /** Milliseconds of inactivity before keep-alive ping. SDK default: 20000. */
+    keepAliveInactivityMs?: number;
+    /** Milliseconds to wait for a keep-alive response. SDK default: 10000. */
+    keepAliveResponseTimeoutMs?: number;
+    /** Slow-consumer hi water mark as fraction of maxEventQueueSize. SDK default: 0.75. */
+    slowConsumerHiWaterMark?: number;
+    /** Slow-consumer lo water mark as fraction of maxEventQueueSize. SDK default: 0.5. */
+    slowConsumerLoWaterMark?: number;
+    sdkLogLevel?: string;
+    socks5?: Socks5Config;
+}
+interface RequestInput {
+    service: string;
+    operation: string;
+    requestOperation?: string;
+    requestId?: string;
+    extractor?: string;
+    securities?: readonly string[];
+    security?: string;
+    fields?: readonly string[];
+    overrides?: readonly StringPair[];
+    elements?: readonly StringPair[];
+    kwargs?: readonly StringPair[];
+    jsonElements?: string;
+    startDate?: string;
+    endDate?: string;
+    startDatetime?: string;
+    endDatetime?: string;
+    requestTz?: string;
+    outputTz?: string;
+    eventType?: string;
+    eventTypes?: readonly string[];
+    interval?: number;
+    options?: readonly StringPair[];
+    fieldTypes?: readonly StringPair[];
+    includeSecurityErrors?: boolean;
+    validateFields?: boolean;
+    searchSpec?: string;
+    fieldIds?: readonly string[];
+    format?: string;
+    backend?: BackendKind;
+}
+interface SubscriptionStats {
+    messagesReceived: number;
+    droppedBatches: number;
+    batchesSent: number;
+    slowConsumer: boolean;
+}
+interface FieldInfo {
+    fieldId: string;
+    arrowType: string;
+    description: string;
+    category: string;
+}
+type PrimitiveValue = string | number | boolean;
+type OverridesMap = Record<string, PrimitiveValue>;
+interface BdpOptions {
+    overrides?: OverridesMap;
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+    includeSecurityErrors?: boolean;
+    validateFields?: boolean;
+}
+interface BdhOptions {
+    start?: DateLike;
+    end?: DateLike;
+    overrides?: OverridesMap;
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+    validateFields?: boolean;
+}
+interface BdibOptions {
+    start?: DateTimeLike;
+    end?: DateTimeLike;
+    requestTz?: string;
+    outputTz?: string;
+    eventType?: string;
+    interval?: number;
+    kwargs?: OverridesMap;
+    backend?: BackendKind;
+}
+interface BdtickOptions {
+    start?: DateTimeLike;
+    end?: DateTimeLike;
+    requestTz?: string;
+    outputTz?: string;
+    eventTypes?: readonly string[];
+    includeConditionCodes?: boolean;
+    includeExchangeCodes?: boolean;
+    includeBrokerCodes?: boolean;
+    includeRpsCodes?: boolean;
+    includeBicMicCodes?: boolean;
+    includeNonPlottableEvents?: boolean;
+    includeBloombergStandardConditionCodes?: boolean;
+    kwargs?: OverridesMap;
+    backend?: BackendKind;
+}
+interface CdxOptions extends BdpOptions {
+    recoveryRate?: number;
+    recovery_rate?: number;
+}
+interface BqlOptions {
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+}
+interface BeqsOptions {
+    asof?: DateLike;
+    screenType?: string;
+    group?: string;
+    overrides?: OverridesMap;
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+}
+interface BsrchOptions {
+    overrides?: OverridesMap;
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+}
+interface BtaOptions {
+    studyParams?: OverridesMap;
+    kwargs?: OverridesMap;
+    startDate?: DateLike;
+    endDate?: DateLike;
+    start_date?: DateLike;
+    end_date?: DateLike;
+    periodicity?: string;
+    interval?: number;
+    format?: string;
+    backend?: BackendKind;
+}
+interface BfldsOptions {
+    fields?: string | readonly string[];
+    searchSpec?: string;
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+}
+interface BlkpOptions {
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+}
+interface RequestOptions {
+    overrides?: OverridesMap;
+    kwargs?: OverridesMap;
+    format?: string;
+    backend?: BackendKind;
+}
+interface StreamOptions {
+    options?: readonly string[];
+    flushThreshold?: number;
+    overflowPolicy?: string;
+    streamCapacity?: number;
+    allFields?: boolean;
+    fields?: readonly string[];
+}
+interface BqrOptions {
+    startDatetime?: DateTimeLike;
+    endDatetime?: DateTimeLike;
+    eventTypes?: readonly string[];
+    includeBrokerCodes?: boolean;
+    backend?: BackendKind;
+}
+interface YasOptions {
+    settleDt?: DateLike;
+    yieldType?: number;
+    spread?: number;
+    yieldVal?: number;
+    price?: number;
+    benchmark?: string;
+    backend?: BackendKind;
+}
+interface PreferredsOptions {
+    fields?: readonly string[];
+    backend?: BackendKind;
+}
+interface CorporateBondsOptions {
+    ccy?: string;
+    fields?: readonly string[];
+    activeOnly?: boolean;
+    backend?: BackendKind;
+}
+interface FuturesResolveOptions {
+    freq?: string;
+    backend?: BackendKind;
+}
+interface ActiveCdxOptions {
+    lookbackDays?: number;
+    backend?: BackendKind;
+}
+interface DividendOptions {
+    dvdType?: string;
+    backend?: BackendKind;
+}
+interface TurnoverOptions {
+    ccy?: string;
+    factor?: number;
+    backend?: BackendKind;
+}
+interface EtfHoldingsOptions {
+    fields?: readonly string[];
+    backend?: BackendKind;
+}
+interface RecipeBackendOptions {
+    backend?: BackendKind;
+}
+interface TimeRange {
+    start: string;
+    end: string;
+}
+interface TickerParts {
+    prefix: string;
+    index: number;
+    asset: string;
+    exchange?: string;
+}
+interface FuturesCandidate {
+    ticker: string;
+    year: number;
+    month: number;
+}
+interface CdxTickerInfo {
+    index: string;
+    series: string;
+    tenor: string;
+    asset: string;
+    isGeneric: boolean;
+    seriesNum?: number;
+}
+interface FxPairInfo {
+    fxPair: string;
+    factor: number;
+    fromCcy: string;
+    toCcy: string;
+}
+interface SessionWindowsInfo {
+    day?: TimeRange;
+    allday?: TimeRange;
+    pre?: TimeRange;
+    post?: TimeRange;
+    am?: TimeRange;
+    pm?: TimeRange;
+}
+interface MarketRule {
+    preMinutes: number;
+    postMinutes: number;
+    lunchStartMin?: number;
+    lunchEndMin?: number;
+    isContinuous: boolean;
+}
+interface ExchangeInfoResult {
+    ticker: string;
+    mic?: string;
+    exchCode?: string;
+    timezone: string;
+    utcOffset?: number;
+    source: string;
+    day?: TimeRange;
+    allday?: TimeRange;
+    pre?: TimeRange;
+    post?: TimeRange;
+    am?: TimeRange;
+    pm?: TimeRange;
+}
+interface ExchangeOverrideInput {
+    timezone?: string;
+    mic?: string;
+    exchCode?: string;
+    day?: TimeRange;
+    allday?: TimeRange;
+    pre?: TimeRange;
+    post?: TimeRange;
+    am?: TimeRange;
+    pm?: TimeRange;
+}
+type BackendKind = 'arrow' | 'json' | 'polars';
+type FormatKind = 'long' | 'long_typed' | 'long_with_metadata' | 'semi_long';
+
+type NativeArrowColumnType = 'bool' | 'binary' | 'date32' | 'date64' | 'float32' | 'float64' | 'int8' | 'int16' | 'int32' | 'int64' | 'large_binary' | 'large_utf8' | 'null' | 'time32_ms' | 'time32_s' | 'time64_us' | 'time64_ns' | 'timestamp_ms' | 'timestamp_ns' | 'timestamp_s' | 'timestamp_us' | 'uint8' | 'uint16' | 'uint32' | 'uint64' | 'utf8';
+interface NativeArrowColumn {
+    readonly name: string;
+    readonly type: NativeArrowColumnType;
+    readonly nullable: boolean;
+    readonly length: number;
+    readonly nullCount: number;
+    readonly timezone?: string;
+    readonly data?: Buffer;
+    readonly offsets?: Buffer;
+    readonly nullBitmap?: Buffer;
+}
+interface NativeArrowZeroCopyBatch {
+    readonly kind: 'zeroCopy';
+    readonly numRows: number;
+    readonly columns: NativeArrowColumn[];
+}
+type NativeUpdateValue = null | boolean | number | string;
+interface NativeSubscriptionUpdate {
+    readonly kind: 'update';
+    readonly topic: string;
+    readonly topicId: number;
+    readonly timestampUs: number;
+    readonly layoutVersion: number;
+    readonly fields: readonly string[];
+    readonly values: readonly NativeUpdateValue[];
+    readonly valueKinds: readonly string[];
+}
+interface NativeSubscription {
+    nextUpdate(): Promise<NativeSubscriptionUpdate | null>;
+    nextArrow(): Promise<NativeArrowZeroCopyBatch | null>;
+    add(tickers: readonly string[]): Promise<void>;
+    remove(tickers: readonly string[]): Promise<void>;
+    unsubscribe(drain: boolean): Promise<NativeSubscriptionUpdate[] | null>;
+    unsubscribeArrow(drain: boolean): Promise<NativeArrowZeroCopyBatch[] | null>;
+    readonly tickers: string[];
+    readonly fields: string[];
+    readonly isActive: boolean;
+    readonly stats: SubscriptionStats;
+}
+
+/**
+ * Date / datetime normalization helpers (issue #317).
+ *
+ * These helpers convert user-supplied date-like values into the wire formats
+ * the Bloomberg engine expects:
+ *
+ * - {@link formatDate} -> Bloomberg-native ``YYYYMMDD`` (used by historical
+ *   requests, override fields, recipe inputs).
+ * - {@link formatDateTime} -> RFC 3339 / ISO 8601 with optional offset (used
+ *   by intraday requests).
+ *
+ * They live in a dedicated module so the public surface in ``index.ts`` can
+ * be tested without dragging in the native NAPI addon.
+ */
+
+/**
+ * Format a date-like value to ``YYYYMMDD`` (Bloomberg-native).
+ *
+ * Accepts ``Date``, ISO 8601 / Bloomberg-native strings, epoch ms, and any
+ * duck-typed Luxon-style ``{ toJSDate(): Date }``. Strict on ambiguous formats.
+ */
+declare function formatDate(value: DateLike | undefined | null): string | undefined;
+/**
+ * Format a datetime-like value to RFC 3339 (ISO 8601 with optional offset).
+ *
+ * Naive ISO strings without a tz suffix are returned as-is so the Rust engine
+ * can apply the caller's ``request_tz``. Anything else (Date, epoch ms, Luxon
+ * DateTime, or ISO with explicit tz) is converted to a tz-bearing ISO string.
+ */
+declare function formatDateTime(value: DateTimeLike | undefined | null): string | undefined;
+
+declare const Backend: Readonly<{
+    ARROW: "arrow";
+    JSON: "json";
+    POLARS: "polars";
+}>;
+declare const Format: Readonly<{
+    LONG: "long";
+    LONG_TYPED: "long_typed";
+    LONG_WITH_METADATA: "long_with_metadata";
+    SEMI_LONG: "semi_long";
+}>;
+interface RawStudy {
+    studyType?: string;
+    study?: string;
+    calcInterval?: string;
+    interval?: number | string;
+    length?: number;
+    period?: number;
+    [key: string]: PrimitiveValue | undefined;
+}
+type TickValue = null | boolean | number | bigint | string | Date;
+declare class FieldHandle {
+    readonly name: string;
+    constructor(name: string);
+}
+declare class Tick {
+    private readonly _update;
+    private readonly _positions;
+    constructor(_update: NativeSubscriptionUpdate);
+    get topic(): string;
+    get timestampUs(): number;
+    get layoutVersion(): number;
+    get(field: string | FieldHandle): TickValue;
+    f64(field: string | FieldHandle): number | null;
+    i64(field: string | FieldHandle): bigint | null;
+    str(field: string | FieldHandle): string | null;
+    toObject(): Record<string, unknown>;
+}
+declare class ArrowSubscription implements AsyncIterator<Table>, AsyncIterable<Table> {
+    private readonly _inner;
+    constructor(_inner: NativeSubscription);
+    next(): Promise<IteratorResult<Table>>;
+    unsubscribe(drain?: boolean): Promise<Table[]>;
+    [Symbol.asyncIterator](): this;
+}
+declare class Subscription implements AsyncIterator<Tick>, AsyncIterable<Tick> {
+    private readonly _inner;
+    constructor(inner: NativeSubscription);
+    next(): Promise<IteratorResult<Tick>>;
+    add(tickers: readonly string[]): Promise<void>;
+    remove(tickers: readonly string[]): Promise<void>;
+    unsubscribe(drain?: boolean): Promise<Tick[]>;
+    field(name: string): FieldHandle;
+    arrow(): ArrowSubscription;
+    get tickers(): string[];
+    get fields(): string[];
+    get isActive(): boolean;
+    get stats(): SubscriptionStats;
+    [Symbol.asyncIterator](): this;
+}
+declare class Engine {
+    private _inner;
+    constructor(host?: string, port?: number);
+    static withConfig(config?: EngineConfig): Engine;
+    request(params: RequestInput): Promise<unknown>;
+    requestRaw(params: RequestInput): Promise<Buffer>;
+    bdp(tickers: readonly string[], fields: readonly string[], options?: BdpOptions): Promise<unknown>;
+    bds(tickers: readonly string[], fields: readonly string[], options?: BdpOptions): Promise<unknown>;
+    bdh(tickers: readonly string[], fields: readonly string[], options?: BdhOptions): Promise<unknown>;
+    bdib(ticker: string, options?: BdibOptions): Promise<unknown>;
+    bdtick(ticker: string, options?: BdtickOptions): Promise<unknown>;
+    bql(query: string, options?: BqlOptions): Promise<unknown>;
+    beqs(screen: string, options?: BeqsOptions): Promise<unknown>;
+    bsrch(searchSpec: string, options?: BsrchOptions): Promise<unknown>;
+    bta(ticker: string, study: string | RawStudy, options?: BtaOptions): Promise<unknown>;
+    bflds(options?: BfldsOptions): Promise<unknown>;
+    blkp(query: string, options?: BlkpOptions): Promise<unknown>;
+    bport(portfolio: string, fields: string | readonly string[], options?: RequestOptions): Promise<unknown>;
+    bcurves(ticker: string, options?: RequestOptions): Promise<unknown>;
+    bgovts(ticker: string, options?: RequestOptions): Promise<unknown>;
+    resolveFieldTypes(fields: readonly string[], overrides?: OverridesMap, defaultType?: string): Promise<Record<string, string>>;
+    getFieldInfo(field: string): FieldInfo | null;
+    clearFieldCache(): void;
+    saveFieldCache(): void;
+    validateFields(fields: readonly string[]): Promise<string[]>;
+    isFieldValidationEnabled(): boolean;
+    getSchema(service: string): Promise<unknown>;
+    getOperation(service: string, operation: string): Promise<unknown>;
+    listOperations(service: string): Promise<string[]>;
+    getCachedSchema(service: string): unknown;
+    invalidateSchema(service: string): void;
+    clearSchemaCache(): void;
+    listCachedSchemas(): string[];
+    getEnumValues(service: string, operation: string, element: string): Promise<string[] | null>;
+    listValidElements(service: string, operation: string): Promise<string[] | null>;
+    subscribe(tickers: readonly string[], fields: readonly string[], options?: StreamOptions): Promise<Subscription>;
+    subscribeWithOptions(service: string, tickers: readonly string[], fields: readonly string[], options?: readonly string[], flushThreshold?: number, overflowPolicy?: string, streamCapacity?: number, allFields?: boolean): Promise<Subscription>;
+    signalShutdown(): void;
+    isAvailable(): boolean;
+    stream(tickers: readonly string[], fields: readonly string[], options?: StreamOptions): Promise<Subscription>;
+    vwap(tickers: readonly string[], fields: readonly string[], options?: StreamOptions): Promise<Subscription>;
+    mktbar(ticker: string, options?: StreamOptions): Promise<Subscription>;
+    depth(ticker: string, options?: StreamOptions): Promise<Subscription>;
+    chains(ticker: string, options?: StreamOptions): Promise<Subscription>;
+    bops(service: string): Promise<string[]>;
+    bschema(service: string, operation?: string): Promise<unknown>;
+    fieldInfo(fields: string | readonly string[], options?: BfldsOptions): Promise<unknown>;
+    fieldSearch(searchSpec: string, options?: BfldsOptions): Promise<unknown>;
+    bqr(ticker: string, options?: BqrOptions): Promise<unknown>;
+    yas(tickers: string | readonly string[], fields: string | readonly string[], options?: YasOptions): Promise<unknown>;
+    preferreds(equityTicker: string, options?: PreferredsOptions): Promise<unknown>;
+    corporateBonds(ticker: string, options?: CorporateBondsOptions): Promise<unknown>;
+    futTicker(genTicker: string, dt: DateLike, options?: FuturesResolveOptions): Promise<unknown>;
+    activeFutures(genTicker: string, dt: DateLike, options?: FuturesResolveOptions): Promise<unknown>;
+    cdxTicker(genTicker: string, dt: DateLike, options?: RecipeBackendOptions): Promise<unknown>;
+    activeCdx(genTicker: string, dt: DateLike, options?: ActiveCdxOptions): Promise<unknown>;
+    dividend(tickers: string | readonly string[], startDate: DateLike, endDate: DateLike, options?: DividendOptions): Promise<unknown>;
+    turnover(tickers: string | readonly string[], startDate: DateLike, endDate: DateLike, options?: TurnoverOptions): Promise<unknown>;
+    etfHoldings(etfTicker: string, options?: EtfHoldingsOptions): Promise<unknown>;
+    currencyConversion(ticker: string, targetCcy: string, startDate: DateLike, endDate: DateLike, options?: RecipeBackendOptions): Promise<unknown>;
+}
+declare function connect(config?: EngineConfig): Promise<Engine>;
+declare function configure(config?: EngineConfig): EngineConfig | undefined;
+declare function configure(host?: string, port?: number): EngineConfig | undefined;
+declare function abdp(tickers: string | readonly string[], fields: string | readonly string[], options?: BdpOptions): Promise<unknown>;
+declare function bdp(tickers: string | readonly string[], fields: string | readonly string[], options?: BdpOptions): Promise<unknown>;
+declare function abdh(tickers: string | readonly string[], fields: string | readonly string[], start?: DateLike | BdhOptions, end?: DateLike, options?: BdhOptions): Promise<unknown>;
+declare function bdh(tickers: string | readonly string[], fields: string | readonly string[], options?: BdhOptions): Promise<unknown>;
+declare function abds(tickers: string | readonly string[], fields: string | readonly string[], overrides?: OverridesMap, options?: BdpOptions): Promise<unknown>;
+declare function bds(tickers: string | readonly string[], fields: string | readonly string[], options?: BdpOptions): Promise<unknown>;
+declare function abdib(ticker: string, dt?: DateTimeLike | BdibOptions, interval?: number | BdibOptions, options?: BdibOptions): Promise<unknown>;
+declare function bdib(ticker: string, options?: BdibOptions): Promise<unknown>;
+declare function abdtick(ticker: string, start: DateTimeLike | null | undefined, end: DateTimeLike | null | undefined, options?: BdtickOptions): Promise<unknown>;
+declare function bdtick(ticker: string, options?: BdtickOptions): Promise<unknown>;
+declare function asubscribe(tickers: string | readonly string[], fields: string | readonly string[], options?: StreamOptions): Promise<Subscription>;
+declare function subscribe(tickers: string | readonly string[], fields: string | readonly string[], options?: StreamOptions): Promise<Subscription>;
+declare function acdxInfo(ticker: string, options?: BdpOptions): Promise<unknown>;
+declare function acdxPricing(ticker: string, options?: CdxOptions): Promise<unknown>;
+declare function acdxRisk(ticker: string, options?: CdxOptions): Promise<unknown>;
+declare const blp: Readonly<{
+    bdp: typeof bdp;
+    bdh: typeof bdh;
+    bds: typeof bds;
+    bdib: typeof bdib;
+    bdtick: typeof bdtick;
+    subscribe: typeof subscribe;
+    abdp: typeof abdp;
+    abdh: typeof abdh;
+    abds: typeof abds;
+    abdib: typeof abdib;
+    abdtick: typeof abdtick;
+    asubscribe: typeof asubscribe;
+}>;
+declare const ext: Readonly<{
+    cdx: Readonly<{
+        acdx_info: typeof acdxInfo;
+        acdx_pricing: typeof acdxPricing;
+        acdx_risk: typeof acdxRisk;
+    }>;
+    parseDate: (dateStr: string) => number[];
+    fmtDate: (year: number, month: number, day: number, fmt?: string) => string;
+    pivotToWide: (ipcBuffer: Buffer) => Buffer;
+    isLongFormat: (ipcBuffer: Buffer) => boolean;
+    parseTicker: (ticker: string) => TickerParts;
+    isSpecificContract: (ticker: string) => boolean;
+    buildFuturesTicker: (prefix: string, monthCode: string, year: string, asset: string) => string;
+    normalizeTickers: (tickers: readonly string[]) => string[];
+    filterEquityTickers: (tickers: readonly string[]) => string[];
+    generateFuturesCandidates: (genTicker: string, year: number, month: number, day: number, freq?: string, count?: number) => FuturesCandidate[];
+    validateGenericTicker: (ticker: string) => void;
+    contractIndex: (genTicker: string) => number;
+    filterCandidatesByCycle: (candidates: readonly FuturesCandidate[], cycle: string) => FuturesCandidate[];
+    filterValidContracts: (contracts: readonly StringPair[], year: number, month: number, day: number) => string[];
+    parseCdxTicker: (ticker: string) => CdxTickerInfo;
+    previousCdxSeries: (ticker: string) => string | null;
+    cdxGenToSpecific: (genTicker: string, series: number) => string;
+    buildFxPair: (fromCcy: string, toCcy: string) => FxPairInfo;
+    sameCurrency: (ccy1: string, ccy2: string) => boolean;
+    currenciesNeedingConversion: (currencies: readonly string[], target: string) => string[];
+    renameDividendColumns: (columns: readonly string[]) => StringPair[];
+    renameEtfColumns: (columns: readonly string[]) => StringPair[];
+    getMonthCode: (monthName: string) => string | null;
+    getMonthName: (code: string) => string | null;
+    getFuturesMonths: () => StringPair[];
+    getDvdType: (typ: string) => string | null;
+    getDvdTypes: () => StringPair[];
+    getDvdCols: () => StringPair[];
+    getEtfCols: () => StringPair[];
+    buildYasOverrides: (settleDt?: string, yieldType?: number, spread?: number, yieldVal?: number, price?: number, benchmark?: string) => StringPair[];
+    buildEarningHeaderRename: (headerRow: readonly StringPair[], dataColumns: readonly string[]) => StringPair[];
+    calculateLevelPercentages: (values: readonly (number | null)[], levels: readonly (number | null)[]) => (number | null)[];
+    buildPreferredsQuery: (equityTicker: string, extraFields?: readonly string[]) => string;
+    buildCorporateBondsQuery: (ticker: string, ccy?: string, extraFields?: readonly string[], activeOnly?: boolean) => string;
+    buildEtfHoldingsQuery: (etfTicker: string, extraFields?: readonly string[]) => string;
+    defaultTurnoverDates: (startDate?: string, endDate?: string) => TimeRange;
+    defaultBqrDatetimes: (startDatetime?: string, endDatetime?: string) => TimeRange;
+    deriveSessions: (dayStart: string, dayEnd: string, mic?: string, exchCode?: string) => SessionWindowsInfo;
+    getMarketRule: (mic?: string, exchCode?: string) => MarketRule | null;
+    inferTimezone: (countryIso: string) => string | null;
+    setExchangeOverride: (ticker: string, input: ExchangeOverrideInput) => void;
+    getExchangeOverride: (ticker: string) => ExchangeInfoResult | null;
+    clearExchangeOverride: (ticker?: string) => void;
+    listExchangeOverrides: () => ExchangeInfoResult[];
+    sessionTimesToUtc: (startTime: string, endTime: string, exchangeTz: string, date: string) => TimeRange;
+}>;
+declare function version(): string;
+declare const setLogLevel: (level: string) => void;
+declare const getLogLevel: () => string;
+
+export { type ActiveCdxOptions, ArrowSubscription, type AuthConfig, Backend, type BackendKind, type BdhOptions, type BdibOptions, type BdpOptions, type BdtickOptions, type BeqsOptions, type BfldsOptions, type BlkpOptions, BlpError, BlpInternalError, BlpRequestError, BlpSessionError, BlpTimeoutError, BlpValidationError, type BqlOptions, type BqrOptions, type BsrchOptions, type BtaOptions, type CdxOptions, type CdxTickerInfo, type CorporateBondsOptions, type DateLike, type DateTimeLike, type DividendOptions, Engine, type EngineConfig, type EtfHoldingsOptions, type ExchangeInfoResult, type ExchangeOverrideInput, FieldHandle, type FieldInfo, Format, type FormatKind, type FuturesCandidate, type FuturesResolveOptions, type FxPairInfo, type MarketRule, type OverridesMap, type PreferredsOptions, type PrimitiveValue, type RecipeBackendOptions, type RequestInput, type RequestOptions, type ServerAddress, type SessionWindowsInfo, type Socks5Config, type StreamOptions, type StringPair, Subscription, type SubscriptionStats, Tick, type TickValue, type TickerParts, type TimeRange, type TlsConfig, type TurnoverOptions, type YasOptions, abdh, abdib, abdp, abds, abdtick, asubscribe, bdh, bdib, bdp, bds, bdtick, blp, configure, connect, ext, formatDate, formatDateTime, getLogLevel, setLogLevel, subscribe, version, wrapError };