@piaa/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Merrr <wign@wign.dev>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+# @piaa/sdk (Official TypeScript / JavaScript SDK)
+
+The official, production-ready SDK for the **PIA Market Intelligence & Realtime Financial Platform**.
+
+Designed for institutional algorithmic traders, fintech dashboards, and quantitative applications across **Node.js 18+**, **Bun**, **Deno**, and modern **Browsers**.
+
+---
+
+## Features
+
+- ⚡ **Zero-Fuss Sensible Defaults**: Connect in 3 lines of code with pre-configured endpoints and sensible timeout/retry defaults.
+- 🔁 **Enterprise Resiliency**: Automatic exponential backoff with full jitter for transient 5xx/429 network hiccups and retry-after headers.
+- 🛡️ **Typed Error Hierarchy**: Clear, actionable, strongly-typed errors (`AuthenticationError`, `RateLimitError`, `TimeoutError`, `ValidationError`, `NetworkError`).
+- 🔒 **Zero Sensitive Data Leaks**: Automatic redaction of API keys, bearer tokens, and secrets from error logs and stack traces.
+- 📡 **Cross-Platform Realtime Streaming**: Built-in resilient WebSocket client with **In-Band Message Authentication**, ping/pong keep-alives, and automatic re-subscription on reconnect.
+- 📊 **Rate Limit Telemetry**: Real-time inspection of RFC 6585 and daily quota headers (`X-RateLimit-*`, `X-DailyQuota-*`).
+
+---
+
+## Installation
+
+```bash
+# Using bun
+bun add @piaa/sdk
+
+# Using npm
+npm install @piaa/sdk
+
+# Using pnpm / yarn
+pnpm add @piaa/sdk
+```
+
+---
+
+## Quickstart
+
+### 1. REST API Usage
+
+```typescript
+import { PiaClient, RateLimitError, AuthenticationError } from "@piaa/sdk";
+
+// Automatically picks up process.env.PIA_API_KEY if omitted
+const client = new PiaClient({
+  apiKey: "wi_live_your_api_key",
+});
+
+async function run() {
+  try {
+    // 1. Fetch live multi-asset snapshot (105+ symbols)
+    const prices = await client.market.getPrices();
+    console.log(`Tracked assets: ${prices.total}`);
+    for (const item of prices.items.slice(0, 5)) {
+      console.log(`[${item.symbol}] $${item.price} (${item.asset_type})`);
+    }
+
+    // 2. Fetch historical OHLCV candlesticks
+    const candles = await client.market.getCandles("XAUUSD", {
+      timeframe: "1h",
+      limit: 100,
+    });
+    console.log(`Fetched ${candles.count} bars for ${candles.symbol}`);
+
+    // 3. Inspect rate limit telemetry
+    const quota = client.getRateLimitInfo();
+    console.log(`Remaining daily hits: ${quota.dailyRemaining}/${quota.dailyLimit}`);
+  } catch (err) {
+    if (err instanceof AuthenticationError) {
+      console.error("Invalid or expired API key.");
+    } else if (err instanceof RateLimitError) {
+      console.error(`Rate limited! Retry after ${err.retryAfterSeconds} seconds.`);
+    } else {
+      console.error("API error:", err);
+    }
+  }
+}
+
+run();
+```
+
+---
+
+### 2. Realtime WebSocket Streaming (In-Band Message Auth)
+
+Cross-platform streaming without query-string leakage:
+
+```typescript
+import { PiaClient } from "@piaa/sdk";
+
+const client = new PiaClient({ apiKey: "wi_live_..." });
+
+// Listen for connection events
+client.realtime.on("connect", () => {
+  console.log("WebSocket connected. Authenticating...");
+});
+
+// Fired once In-Band authentication is accepted by the server
+client.realtime.on("authenticated", (info) => {
+  console.log("Authenticated! Tier:", info.plan);
+
+  // Subscribe to market symbols
+  client.realtime.subscribe(["XAUUSD", "BTCUSDT", "EURUSD"]);
+});
+
+// Handle real-time price ticks
+client.realtime.on("tick", (tick) => {
+  console.log(`[TICK] ${tick.symbol} -> $${tick.price} (bid: ${tick.bid}, ask: ${tick.ask})`);
+});
+
+// Handle disconnections (auto-reconnect is handled automatically)
+client.realtime.on("disconnect", ({ code, reason }) => {
+  console.warn(`WebSocket closed (${code}): ${reason}`);
+});
+
+// Start streaming
+client.realtime.connect();
+
+// To stop and prevent auto-reconnection:
+// client.realtime.disconnect();
+```
+
+---
+
+## Configuration Reference
+
+```typescript
+const client = new PiaClient({
+  // Secret API key. Falls back to process.env.PIA_API_KEY
+  apiKey: "wi_live_...",
+
+  // Unified REST gateway (Default: "https://api-engine.wign.dev")
+  baseUrl: "https://api-engine.wign.dev",
+
+  // Realtime streaming gateway (Default: "wss://api-engine.wign.dev/api/v1/ws")
+  wsUrl: "wss://api-engine.wign.dev/api/v1/ws",
+
+  // Request timeout in milliseconds (Default: 15,000)
+  timeoutMs: 10_000,
+
+  // Maximum retry attempts for transient errors (Default: 3)
+  maxRetries: 3,
+
+  // Initial retry delay for exponential backoff (Default: 500ms)
+  retryDelayMs: 500,
+
+  // Custom HTTP headers injected into all requests
+  headers: {
+    "X-Client-App": "my-trading-bot",
+  },
+
+  // Custom fetch implementation (useful for mocking or custom proxies)
+  fetch: customFetch,
+
+  // Custom WebSocket implementation (e.g. 'ws' in Node.js)
+  WebSocket: customWebSocket,
+
+  // Enable verbose debug logs (Default: false)
+  debug: false,
+});
+```
+
+---
+
+## Error Handling
+
+All errors thrown by the SDK inherit from `PiaError`:
+
+| Error Class | HTTP Status | Description | Properties |
+|---|---|---|---|
+| `ConfigurationError` | N/A | Missing or invalid client configuration | `message` |
+| `ValidationError` | N/A | Invalid method arguments (e.g. empty symbol) | `paramName` |
+| `AuthenticationError` | 401 | Invalid, expired, or revoked API key | `statusCode`, `endpoint` |
+| `PermissionError` | 403 | API key lacks required scope (e.g. `realtime:ws`) | `requiredScope` |
+| `RateLimitError` | 429 | Rate limit or daily quota exceeded | `retryAfterSeconds`, `dailyRemaining`, `minuteRemaining` |
+| `TimeoutError` | 408 / N/A | Request exceeded configured `timeoutMs` | `timeoutMs`, `endpoint` |
+| `NetworkError` | N/A | Network drop, DNS resolution failure | `causeError` |
+| `ParseError` | N/A | Response was not valid JSON | `rawText` |
+| `ApiError` | Other | General HTTP errors | `statusCode`, `rawBody` |
+
+---
+
+## Testing
+
+Run the test suite using Bun:
+
+```bash
+bun test
+```

package/dist/client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Official PIA SDK - Main Client Facade
+ */
+import { type PiaClientOptions, type ResolvedPiaConfig } from "./config";
+import { RealtimeClient } from "./realtime/socket";
+import { MarketResource } from "./resources/market";
+import { NewsResource } from "./resources/news";
+import { SocialResource } from "./resources/social";
+import { WsResource } from "./resources/ws";
+import type { RateLimitInfo } from "./types";
+export declare class PiaClient {
+    readonly config: Readonly<ResolvedPiaConfig>;
+    private readonly transport;
+    /**
+     * Market data & prices API resource.
+     */
+    readonly market: MarketResource;
+    /**
+     * Social sentiment and discussions resource.
+     */
+    readonly social: SocialResource;
+    /**
+     * Financial news resource.
+     */
+    readonly news: NewsResource;
+    /**
+     * WebSocket ticket issuance resource.
+     */
+    readonly ws: WsResource;
+    /**
+     * Resilient realtime WebSocket streaming client with In-Band Auth.
+     */
+    readonly realtime: RealtimeClient;
+    /**
+     * Initializes a new PIA API Client.
+     *
+     * @example
+     * ```typescript
+     * import { PiaClient } from "@piaa/sdk";
+     *
+     * const client = new PiaClient({ apiKey: "wi_live_..." });
+     * const prices = await client.market.getPrices();
+     * ```
+     */
+    constructor(options?: PiaClientOptions);
+    /**
+     * Returns telemetry on rate limit and daily quota usage from the latest request.
+     */
+    getRateLimitInfo(): RateLimitInfo;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAiB,MAAM,UAAU,CAAC;AAExF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAAa,SAAS;IACpB,SAAgB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAE1C;;OAEG;IACH,SAAgB,MAAM,EAAE,cAAc,CAAC;IAEvC;;OAEG;IACH,SAAgB,MAAM,EAAE,cAAc,CAAC;IAEvC;;OAEG;IACH,SAAgB,IAAI,EAAE,YAAY,CAAC;IAEnC;;OAEG;IACH,SAAgB,EAAE,EAAE,UAAU,CAAC;IAE/B;;OAEG;IACH,SAAgB,QAAQ,EAAE,cAAc,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,YAAY,OAAO,GAAE,gBAAqB,EASzC;IAED;;OAEG;IACI,gBAAgB,IAAI,aAAa,CAEvC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Official PIA SDK - Configuration & Validation
+ */
+import { type LogLevel, type PiaLogger } from "./logger";
+export interface PiaClientOptions {
+    /**
+     * Secret or live API Key (e.g. "wi_live_...").
+     * If omitted, the SDK attempts to read from process.env.PIA_API_KEY or ATSLD_API_KEY.
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the unified REST gateway.
+     * Default: "https://api-engine.wign.dev"
+     */
+    baseUrl?: string;
+    /**
+     * WebSocket URL for realtime streaming.
+     * Default: "wss://api-engine.wign.dev/api/v1/ws"
+     */
+    wsUrl?: string;
+    /**
+     * Global HTTP request timeout in milliseconds.
+     * Default: 15_000 (15s)
+     */
+    timeoutMs?: number;
+    /**
+     * Maximum number of retry attempts for transient failures (408, 429, 5xx).
+     * Default: 3
+     */
+    maxRetries?: number;
+    /**
+     * Base initial delay for exponential backoff in milliseconds.
+     * Default: 500
+     */
+    retryDelayMs?: number;
+    /**
+     * Maximum cap on retry backoff delay in milliseconds.
+     * Default: 10_000 (10s)
+     */
+    maxRetryDelayMs?: number;
+    /**
+     * Custom HTTP headers injected into all requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation (useful for tests or runtime environments).
+     */
+    fetch?: typeof fetch;
+    /**
+     * Custom WebSocket implementation (e.g. 'ws' in Node.js).
+     */
+    WebSocket?: unknown;
+    /**
+     * Custom logger instance.
+     */
+    logger?: PiaLogger;
+    /**
+     * Logging level when using the default logger.
+     * Default: "warn" (or "debug" if debug: true)
+     */
+    logLevel?: LogLevel;
+    /**
+     * Enable verbose debug logs.
+     * Default: false
+     */
+    debug?: boolean;
+}
+export interface ResolvedPiaConfig {
+    apiKey: string;
+    baseUrl: string;
+    wsUrl: string;
+    timeoutMs: number;
+    maxRetries: number;
+    retryDelayMs: number;
+    maxRetryDelayMs: number;
+    headers: Record<string, string>;
+    fetch: typeof fetch;
+    WebSocket?: unknown;
+    logger: PiaLogger;
+    debug: boolean;
+}
+export declare const DEFAULT_BASE_URL = "https://api-engine.wign.dev";
+export declare const DEFAULT_WS_URL = "wss://api-engine.wign.dev/api/v1/ws";
+export declare const DEFAULT_TIMEOUT_MS = 15000;
+export declare const DEFAULT_MAX_RETRIES = 3;
+export declare const DEFAULT_RETRY_DELAY_MS = 500;
+export declare const DEFAULT_MAX_RETRY_DELAY_MS = 10000;
+/**
+ * Validates and resolves full client configuration with sensible defaults.
+ */
+export declare function resolveConfig(options?: PiaClientOptions): ResolvedPiaConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,cAAc,wCAAwC,CAAC;AACpE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAcjD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,iBAAiB,CAuF/E"}

package/dist/errors.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Official PIA SDK - Strongly Typed Error Hierarchy
+ */
+export interface PiaErrorDetails {
+    statusCode?: number;
+    endpoint?: string;
+    method?: string;
+    requestId?: string | null;
+    headers?: Record<string, string>;
+    rawResponse?: unknown;
+}
+/**
+ * Base class for all errors thrown by the PIA SDK.
+ */
+export declare class PiaError extends Error {
+    readonly isPiaError = true;
+    readonly statusCode?: number;
+    readonly endpoint?: string;
+    readonly method?: string;
+    readonly requestId?: string | null;
+    constructor(message: string, details?: PiaErrorDetails);
+}
+/**
+ * Thrown when client configuration is invalid (e.g. missing API key, invalid URL).
+ */
+export declare class ConfigurationError extends PiaError {
+    constructor(message: string);
+}
+/**
+ * Thrown when caller passes invalid arguments (e.g. empty symbol, negative limit).
+ */
+export declare class ValidationError extends PiaError {
+    readonly paramName?: string;
+    constructor(message: string, paramName?: string);
+}
+/**
+ * Thrown on HTTP 401 Unauthorized (invalid or revoked API key).
+ * Redacts any sensitive data.
+ */
+export declare class AuthenticationError extends PiaError {
+    constructor(message?: string, details?: PiaErrorDetails);
+}
+/**
+ * Thrown on HTTP 403 Forbidden (missing required scope/permissions, e.g. 'realtime:ws').
+ */
+export declare class PermissionError extends PiaError {
+    readonly requiredScope?: string;
+    constructor(message: string, requiredScope?: string, details?: PiaErrorDetails);
+}
+/**
+ * Thrown on HTTP 429 Too Many Requests (rate limit or daily quota exceeded).
+ */
+export declare class RateLimitError extends PiaError {
+    readonly retryAfterSeconds?: number;
+    readonly dailyLimit?: number;
+    readonly dailyRemaining?: number;
+    readonly minuteLimit?: number;
+    readonly minuteRemaining?: number;
+    constructor(message: string, options?: {
+        retryAfterSeconds?: number;
+        dailyLimit?: number;
+        dailyRemaining?: number;
+        minuteLimit?: number;
+        minuteRemaining?: number;
+        details?: PiaErrorDetails;
+    });
+}
+/**
+ * Thrown when a request or operation exceeds the configured timeout threshold.
+ */
+export declare class TimeoutError extends PiaError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, details?: PiaErrorDetails);
+}
+/**
+ * Thrown when network transport fails (DNS resolution, connection refused, connection reset).
+ */
+export declare class NetworkError extends PiaError {
+    readonly causeError?: unknown;
+    constructor(message: string, cause?: unknown, details?: PiaErrorDetails);
+}
+/**
+ * Thrown when response parsing fails (malformed JSON or unexpected response body).
+ */
+export declare class ParseError extends PiaError {
+    readonly rawText?: string;
+    constructor(message: string, rawText?: string, details?: PiaErrorDetails);
+}
+/**
+ * Thrown on generic unexpected API responses (4xx, 5xx).
+ */
+export declare class ApiError extends PiaError {
+    readonly rawBody?: unknown;
+    constructor(message: string, statusCode: number, rawBody?: unknown, details?: PiaErrorDetails);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/http/transport.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Official PIA SDK - Resilient HTTP Transport with Exponential Backoff & Telemetry
+ */
+import type { ResolvedPiaConfig } from "../config";
+import type { RateLimitInfo, RequestOptions } from "../types";
+export declare class HttpTransport {
+    private readonly config;
+    private lastRateLimitInfo;
+    constructor(config: ResolvedPiaConfig);
+    /**
+     * Returns the most recent rate limit headers telemetry recorded by the SDK.
+     */
+    getRateLimitInfo(): RateLimitInfo;
+    /**
+     * Executes an HTTP request with automatic retry, jittered backoff, and timeout.
+     */
+    request<T>(endpoint: string, method?: "GET" | "POST" | "PUT" | "DELETE", body?: unknown, options?: RequestOptions): Promise<T>;
+    private parseTelemetryHeaders;
+    private calculateBackoffDelay;
+    private parseResponseBody;
+    private handleHttpError;
+    private sleep;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/http/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/http/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAUnD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK9D,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,iBAAiB,CAAqB;IAE9C,YAA6B,MAAM,EAAE,iBAAiB,EAAI;IAE1D;;OAEG;IACI,gBAAgB,IAAI,aAAa,CAEvC;IAED;;OAEG;IACU,OAAO,CAAC,CAAC,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAgB,EACjD,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAsIZ;IAED,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,qBAAqB;YAiBf,iBAAiB;IAqB/B,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,KAAK;CAGd"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Official PIA SDK
+ * Enterprise market intelligence & realtime streaming SDK.
+ */
+export { PiaClient } from "./client";
+export { type PiaClientOptions, type ResolvedPiaConfig, resolveConfig, DEFAULT_BASE_URL, DEFAULT_WS_URL, DEFAULT_TIMEOUT_MS, DEFAULT_MAX_RETRIES, } from "./config";
+export { PiaError, type PiaErrorDetails, ConfigurationError, ValidationError, AuthenticationError, PermissionError, RateLimitError, TimeoutError, NetworkError, ParseError, ApiError, } from "./errors";
+export { type PiaLogger, type LogLevel, DefaultLogger, redactSensitive, } from "./logger";
+export { type Timeframe, type RateLimitInfo, type RequestOptions, type MarketPrice, type MarketPricesResponse, type Candle, type CandleResponse, type GetCandlesOptions, type OrderBook, type OrderBookLevel, type SocialPost, type SocialFeedResponse, type GetSocialOptions, type NewsArticle, type NewsFeedResponse, type GetNewsOptions, type WsTicketResponse, } from "./types";
+export { RealtimeClient, type SocketState } from "./realtime/socket";
+export { type RealtimeEvents } from "./realtime/events";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,QAAQ,GACT,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,aAAa,EACb,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC"}