@piaa/sdk 1.2.0 → 1.3.0

package/dist/client.d.ts

@@ -4,12 +4,16 @@
 import { type PiaClientOptions, type ResolvedPiaConfig } from "./config";
 import { RealtimeClient } from "./realtime/socket";
 import { MarketResource } from "./resources/market";
-import { NewsResource } from "./resources/news";
+import { IntelligenceResource } from "./resources/intelligence";
+import { OptionsResource } from "./resources/options";
+import { MacroResource } from "./resources/macro";
+import { GeosignalsResource } from "./resources/geosignals";
+import { EnergyResource } from "./resources/energy";
+import { SecResource } from "./resources/sec";
 import { SocialResource } from "./resources/social";
+import { NewsResource } from "./resources/news";
 import { EconomicResource } from "./resources/economic";
 import { FixedIncomeResource } from "./resources/fixed-income";
-import { MacroResource } from "./resources/macro";
-import { OptionsResource } from "./resources/options";
 import { WsResource } from "./resources/ws";
 import type { RateLimitInfo } from "./types";
 export declare class PiaClient {
@@ -19,6 +23,10 @@ export declare class PiaClient {
      * Market data & prices API resource.
      */
     readonly market: MarketResource;
+    /**
+     * AI-powered quantitative intelligence and narrative catalysts resource.
+     */
+    readonly intelligence: IntelligenceResource;
     /**
      * Derivatives, options chain, and Gamma Exposure (GEX) resource.
      */
@@ -27,6 +35,18 @@ export declare class PiaClient {
      * Macro indicators, Fear & Greed index, COT positioning, and central banks.
      */
     readonly macro: MacroResource;
+    /**
+     * Geopolitical risk alerts, conflict mapping, and asset exposure resource.
+     */
+    readonly geosignals: GeosignalsResource;
+    /**
+     * Energy benchmarks, crude spreads, and natural gas storage resource.
+     */
+    readonly energy: EnergyResource;
+    /**
+     * SEC EDGAR corporate filings (10-K, 10-Q, 8-K, Form 4) resource.
+     */
+    readonly sec: SecResource;
     /**
      * Social sentiment and discussions resource.
      */
@@ -53,14 +73,6 @@ export declare class PiaClient {
     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);
     /**

package/dist/errors.d.ts

@@ -93,3 +93,7 @@ export declare class ApiError extends PiaError {
     readonly rawBody?: unknown;
     constructor(message: string, statusCode: number, rawBody?: unknown, details?: PiaErrorDetails);
 }
+/**
+ * Sanitizes and redacts API keys and secrets from string representations.
+ */
+export declare function redactSensitive(input: string): string;

package/dist/index.d.ts

@@ -3,17 +3,20 @@
  * 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 SocialPostItem, type SocialPostsResponse, type GetSocialPostsOptions, type OptionContract, type OptionChainResponse, type OptionGexResponse, type OptionSummaryResponse, type FearGreedData, type FearGreedHistoryResponse, type CotPositioning, type CotReportResponse, type CentralBankStanceResponse, type NewsArticle, type NewsFeedResponse, type GetNewsOptions, type EconomicEvent, type EconomicCalendarResponse, type GetCalendarOptions, type YieldCurvePoint, type YieldCurveResponse, type MarketInsight, type WsTicketResponse, } from "./types";
+export { type PiaClientOptions, type ResolvedPiaConfig, resolveConfig, } from "./config";
+export { PiaError, ConfigurationError, ValidationError, AuthenticationError, PermissionError, RateLimitError, TimeoutError, NetworkError, ParseError, ApiError, redactSensitive, } from "./errors";
+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 SocialPostItem, type SocialPostsResponse, type GetSocialPostsOptions, type GetSocialOptions, type NewsArticle, type NewsFeedResponse, type GetNewsOptions, type EconomicEvent, type EconomicCalendarResponse, type GetCalendarOptions, type YieldCurvePoint, type YieldCurveResponse, type WsTicketResponse, type OptionContract, type OptionChainResponse, type OptionGexResponse, type OptionSummaryResponse, type FearGreedData, type FearGreedHistoryResponse, type CotPositioning, type CotReportResponse, type CentralBankStanceResponse, } from "./types";
+export { RealtimeClient, type SocketState, } from "./realtime/socket";
+export { type RealtimeEvents, } from "./realtime/events";
 export { MarketResource } from "./resources/market";
+export { IntelligenceResource, type IntelligenceAnalyzeRequest, type IntelligenceAnalyzeResponse, type MarketInsightResponse } from "./resources/intelligence";
 export { OptionsResource } from "./resources/options";
 export { MacroResource } from "./resources/macro";
+export { GeosignalsResource, type GeoSignalEvent, type GeoSignalsResponse, type GeoSignalsMapResponse, type GeoSignalsAssetImpactResponse } from "./resources/geosignals";
+export { EnergyResource, type EnergyDashboardResponse, type EnergySeriesResponse } from "./resources/energy";
+export { SecResource, type SecFilingItem, type SecFilingsResponse, type GetSecFilingsOptions } from "./resources/sec";
 export { SocialResource } from "./resources/social";
 export { NewsResource } from "./resources/news";
 export { EconomicResource } from "./resources/economic";
 export { FixedIncomeResource } from "./resources/fixed-income";
 export { WsResource } from "./resources/ws";
-export { RealtimeClient, type SocketState } from "./realtime/socket";
-export { type RealtimeEvents } from "./realtime/events";

package/dist/index.js

@@ -100,6 +100,15 @@ class ApiError extends PiaError {
     this.rawBody = rawBody;
   }
 }
+function redactSensitive(input) {
+  if (!input || typeof input !== "string")
+    return input;
+  return input.replace(/wi_live_([a-zA-Z0-9_-]+)/g, (_match, p1) => {
+    if (p1.length <= 4)
+      return "wi_live_***";
+    return `wi_live_***${p1.slice(-4)}`;
+  }).replace(/Bearer\s+[a-zA-Z0-9._-]+/gi, "Bearer [REDACTED]");
+}
 
 // src/logger.ts
 var SENSITIVE_KEY_PATTERNS = [
@@ -108,7 +117,7 @@ var SENSITIVE_KEY_PATTERNS = [
   /api[_-]?key["':\s]+["']?([a-zA-Z0-9_-]+)["']?/gi,
   /password["':\s]+["']?([^"'\s]+)["']?/gi
 ];
-function redactSensitive(input) {
+function redactSensitive2(input) {
   let redacted = input;
   for (const pattern of SENSITIVE_KEY_PATTERNS) {
     redacted = redacted.replace(pattern, (match) => {
@@ -138,13 +147,13 @@ class DefaultLogger {
     this.levelNum = LOG_LEVELS[level] ?? LOG_LEVELS.warn;
   }
   safeFormat(msg, args) {
-    const cleanMsg = `${this.prefix} ${redactSensitive(msg)}`;
+    const cleanMsg = `${this.prefix} ${redactSensitive2(msg)}`;
     const cleanArgs = args.map((arg) => {
       if (typeof arg === "string")
-        return redactSensitive(arg);
+        return redactSensitive2(arg);
       if (typeof arg === "object" && arg !== null) {
         try {
-          return JSON.parse(redactSensitive(JSON.stringify(arg)));
+          return JSON.parse(redactSensitive2(JSON.stringify(arg)));
         } catch {
           return "[Unserializable Object]";
         }
@@ -253,7 +262,7 @@ function resolveConfig(options = {}) {
 
 // src/http/transport.ts
 var RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);
-var SDK_VERSION = "1.2.0";
+var SDK_VERSION = "1.3.0";
 
 class HttpTransport {
   config;
@@ -739,34 +748,162 @@ class MarketResource {
     const cleanSymbol = symbol.trim().toUpperCase();
     return this.transport.request(`/api/v1/market/insights/${encodeURIComponent(cleanSymbol)}`, "GET", undefined, options);
   }
+  async getTradingHalts(options) {
+    return this.transport.request("/api/v1/market/trading-halts", "GET", undefined, options);
+  }
+  async getCorporateActions(options) {
+    return this.transport.request("/api/v1/market/corporate-actions", "GET", undefined, options);
+  }
+  async getRealizedVolatility(symbol, options) {
+    const params = new URLSearchParams;
+    if (symbol)
+      params.set("symbol", symbol.trim().toUpperCase());
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.transport.request(`/api/v1/market/realized-volatility${query}`, "GET", undefined, options);
+  }
+  async getImpliedVolatility(symbol, options) {
+    const params = new URLSearchParams;
+    if (symbol)
+      params.set("symbol", symbol.trim().toUpperCase());
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.transport.request(`/api/v1/market/implied-volatility${query}`, "GET", undefined, options);
+  }
   async getWhy(symbol, options) {
     return this.getInsights(symbol, options);
   }
 }
 
-// src/resources/news.ts
-class NewsResource {
+// src/resources/intelligence.ts
+class IntelligenceResource {
   transport;
   constructor(transport) {
     this.transport = transport;
   }
-  async getNews(options) {
-    const params = new URLSearchParams;
-    if (options?.symbols && options.symbols.length > 0) {
-      params.set("symbols", options.symbols.map((s) => s.trim().toUpperCase()).join(","));
+  async analyze(request, options) {
+    return this.transport.request("/api/v1/intelligence/analyze", "POST", request, options);
+  }
+  async getInsights(symbol, options) {
+    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
+      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
     }
-    if (options?.category)
-      params.set("category", options.category);
+    const cleanSymbol = symbol.trim().toUpperCase();
+    return this.transport.request(`/api/v1/market/insights/${encodeURIComponent(cleanSymbol)}`, "GET", undefined, options);
+  }
+}
+
+// src/resources/options.ts
+class OptionsResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  async getChain(symbol, options) {
+    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
+      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
+    }
+    const clean = symbol.trim().toUpperCase();
+    return this.transport.request(`/api/v1/options/chain/${encodeURIComponent(clean)}`, "GET", undefined, options);
+  }
+  async getGex(symbol, options) {
+    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
+      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
+    }
+    const clean = symbol.trim().toUpperCase();
+    return this.transport.request(`/api/v1/options/gex/${encodeURIComponent(clean)}`, "GET", undefined, options);
+  }
+  async getSummary(options) {
+    return this.transport.request("/api/v1/options/summary", "GET", undefined, options);
+  }
+}
+
+// src/resources/macro.ts
+class MacroResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  async getFearGreed(options) {
+    return this.transport.request("/api/v1/fear-greed", "GET", undefined, options);
+  }
+  async getFearGreedHistory(options) {
+    return this.transport.request("/api/v1/fear-greed/history", "GET", undefined, options);
+  }
+  async getCot(symbol, options) {
+    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
+      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
+    }
+    const clean = symbol.trim().toUpperCase();
+    return this.transport.request(`/api/v1/cot/symbol/${encodeURIComponent(clean)}`, "GET", undefined, options);
+  }
+  async getCentralBankStance(bank, options) {
+    if (!bank || typeof bank !== "string" || bank.trim() === "") {
+      throw new ValidationError("Bank must be a non-empty string.", "bank");
+    }
+    const clean = bank.trim().toLowerCase();
+    return this.transport.request(`/api/v1/central-banks/${encodeURIComponent(clean)}/stance`, "GET", undefined, options);
+  }
+}
+
+// src/resources/geosignals.ts
+class GeosignalsResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  async getEvents(options) {
+    return this.transport.request("/api/v1/geosignals", "GET", undefined, options);
+  }
+  async getMap(options) {
+    return this.transport.request("/api/v1/geosignals/map", "GET", undefined, options);
+  }
+  async getAssetImpacts(options) {
+    return this.transport.request("/api/v1/geosignals/assets", "GET", undefined, options);
+  }
+}
+
+// src/resources/energy.ts
+class EnergyResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  async getDashboard(options) {
+    return this.transport.request("/api/v1/energy/dashboard", "GET", undefined, options);
+  }
+  async getSeries(seriesId, options) {
+    const params = new URLSearchParams;
+    if (seriesId)
+      params.set("id", seriesId);
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.transport.request(`/api/v1/energy/series${query}`, "GET", undefined, options);
+  }
+}
+
+// src/resources/sec.ts
+class SecResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  async getFilings(options) {
+    const params = new URLSearchParams;
+    if (options?.symbol)
+      params.set("symbol", options.symbol.trim().toUpperCase());
+    if (options?.form_type)
+      params.set("form_type", options.form_type);
     if (options?.limit)
       params.set("limit", String(options.limit));
+    if (options?.since)
+      params.set("since", options.since);
     const query = params.toString() ? `?${params.toString()}` : "";
-    return this.transport.request(`/api/v1/news${query}`, "GET", undefined, options);
-  }
-  async getLatest(options) {
-    return this.transport.request("/api/v1/news/latest", "GET", undefined, options);
+    return this.transport.request(`/api/v1/sec/filings${query}`, "GET", undefined, options);
   }
-  async getById(id, options) {
-    return this.transport.request(`/api/v1/news/${encodeURIComponent(id)}`, "GET", undefined, options);
+  async getCompany(symbol, options) {
+    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
+      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
+    }
+    const cleanSymbol = symbol.trim().toUpperCase();
+    return this.transport.request(`/api/v1/sec/companies/${encodeURIComponent(cleanSymbol)}`, "GET", undefined, options);
   }
 }
 
@@ -800,6 +937,32 @@ class SocialResource {
   }
 }
 
+// src/resources/news.ts
+class NewsResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  async getNews(options) {
+    const params = new URLSearchParams;
+    if (options?.symbols && options.symbols.length > 0) {
+      params.set("symbols", options.symbols.map((s) => s.trim().toUpperCase()).join(","));
+    }
+    if (options?.category)
+      params.set("category", options.category);
+    if (options?.limit)
+      params.set("limit", String(options.limit));
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.transport.request(`/api/v1/news${query}`, "GET", undefined, options);
+  }
+  async getLatest(options) {
+    return this.transport.request("/api/v1/news/latest", "GET", undefined, options);
+  }
+  async getById(id, options) {
+    return this.transport.request(`/api/v1/news/${encodeURIComponent(id)}`, "GET", undefined, options);
+  }
+}
+
 // src/resources/economic.ts
 class EconomicResource {
   transport;
@@ -818,6 +981,12 @@ class EconomicResource {
   async getIndicators(options) {
     return this.transport.request("/api/v1/economic/indicators", "GET", undefined, options);
   }
+  async getCategories(options) {
+    return this.transport.request("/api/v1/economic/categories", "GET", undefined, options);
+  }
+  async getCountries(options) {
+    return this.transport.request("/api/v1/economic/countries", "GET", undefined, options);
+  }
 }
 
 // src/resources/fixed-income.ts
@@ -834,59 +1003,6 @@ class FixedIncomeResource {
   }
 }
 
-// src/resources/macro.ts
-class MacroResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async getFearGreed(options) {
-    return this.transport.request("/api/v1/fear-greed", "GET", undefined, options);
-  }
-  async getFearGreedHistory(options) {
-    return this.transport.request("/api/v1/fear-greed/history", "GET", undefined, options);
-  }
-  async getCot(symbol, options) {
-    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
-      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
-    }
-    const clean = symbol.trim().toUpperCase();
-    return this.transport.request(`/api/v1/cot/symbol/${encodeURIComponent(clean)}`, "GET", undefined, options);
-  }
-  async getCentralBankStance(bank, options) {
-    if (!bank || typeof bank !== "string" || bank.trim() === "") {
-      throw new ValidationError("Bank must be a non-empty string.", "bank");
-    }
-    const clean = bank.trim().toLowerCase();
-    return this.transport.request(`/api/v1/central-banks/${encodeURIComponent(clean)}/stance`, "GET", undefined, options);
-  }
-}
-
-// src/resources/options.ts
-class OptionsResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async getChain(symbol, options) {
-    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
-      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
-    }
-    const clean = symbol.trim().toUpperCase();
-    return this.transport.request(`/api/v1/options/chain/${encodeURIComponent(clean)}`, "GET", undefined, options);
-  }
-  async getGex(symbol, options) {
-    if (!symbol || typeof symbol !== "string" || symbol.trim() === "") {
-      throw new ValidationError("Symbol must be a non-empty string.", "symbol");
-    }
-    const clean = symbol.trim().toUpperCase();
-    return this.transport.request(`/api/v1/options/gex/${encodeURIComponent(clean)}`, "GET", undefined, options);
-  }
-  async getSummary(options) {
-    return this.transport.request("/api/v1/options/summary", "GET", undefined, options);
-  }
-}
-
 // src/resources/ws.ts
 class WsResource {
   transport;
@@ -903,8 +1019,12 @@ class PiaClient {
   config;
   transport;
   market;
+  intelligence;
   options;
   macro;
+  geosignals;
+  energy;
+  sec;
   social;
   news;
   economic;
@@ -915,8 +1035,12 @@ class PiaClient {
     this.config = resolveConfig(options);
     this.transport = new HttpTransport(this.config);
     this.market = new MarketResource(this.transport);
+    this.intelligence = new IntelligenceResource(this.transport);
     this.options = new OptionsResource(this.transport);
     this.macro = new MacroResource(this.transport);
+    this.geosignals = new GeosignalsResource(this.transport);
+    this.energy = new EnergyResource(this.transport);
+    this.sec = new SecResource(this.transport);
     this.social = new SocialResource(this.transport);
     this.news = new NewsResource(this.transport);
     this.economic = new EconomicResource(this.transport);
@@ -932,13 +1056,11 @@ export {
   ApiError,
   AuthenticationError,
   ConfigurationError,
-  DEFAULT_BASE_URL,
-  DEFAULT_MAX_RETRIES,
-  DEFAULT_TIMEOUT_MS,
-  DEFAULT_WS_URL,
-  DefaultLogger,
   EconomicResource,
+  EnergyResource,
   FixedIncomeResource,
+  GeosignalsResource,
+  IntelligenceResource,
   MacroResource,
   MarketResource,
   NetworkError,
@@ -950,6 +1072,7 @@ export {
   PiaError,
   RateLimitError,
   RealtimeClient,
+  SecResource,
   SocialResource,
   TimeoutError,
   ValidationError,

package/dist/resources/economic.d.ts

@@ -14,4 +14,12 @@ export declare class EconomicResource {
      * Retrieves macroeconomic indicators and series metadata.
      */
     getIndicators(options?: RequestOptions): Promise<any>;
+    /**
+     * Retrieves list of available macroeconomic indicator categories.
+     */
+    getCategories(options?: RequestOptions): Promise<any>;
+    /**
+     * Retrieves list of supported sovereign countries for economic indicators.
+     */
+    getCountries(options?: RequestOptions): Promise<any>;
 }

package/dist/resources/energy.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Official PIA SDK - Energy Markets & Commodity Reserves Resource
+ */
+import type { HttpTransport } from "../http/transport";
+import type { RequestOptions } from "../types";
+export interface EnergyDashboardResponse {
+    crude_oil?: {
+        wti_price?: number;
+        brent_price?: number;
+        spread?: number;
+        weekly_change_pct?: number;
+    };
+    natural_gas?: {
+        henry_hub_price?: number;
+        storage_bcf?: number;
+        storage_change?: number;
+    };
+    refining_margins?: Record<string, number>;
+    updated_at: string;
+}
+export interface EnergySeriesResponse {
+    series_id: string;
+    name: string;
+    unit: string;
+    data: Array<{
+        date: string;
+        value: number;
+    }>;
+}
+export declare class EnergyResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Retrieves energy market dashboard including WTI/Brent crude prices, crack spreads, and storage.
+     */
+    getDashboard(options?: RequestOptions): Promise<EnergyDashboardResponse>;
+    /**
+     * Retrieves historical time series data for a specific energy benchmark series.
+     */
+    getSeries(seriesId: string, options?: RequestOptions): Promise<EnergySeriesResponse>;
+}

package/dist/resources/geosignals.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Official PIA SDK - Geopolitical Signals & Macro Conflict Map Resource
+ */
+import type { HttpTransport } from "../http/transport";
+import type { RequestOptions } from "../types";
+export interface GeoSignalEvent {
+    id: string;
+    title: string;
+    region: string;
+    severity: "low" | "medium" | "high" | "critical";
+    category: "conflict" | "sanction" | "trade" | "election" | "supply_chain";
+    latitude?: number;
+    longitude?: number;
+    impacted_assets?: string[];
+    summary: string;
+    published_at: string;
+}
+export interface GeoSignalsResponse {
+    total: number;
+    events: GeoSignalEvent[];
+}
+export interface GeoSignalsMapResponse {
+    layers: Array<{
+        region: string;
+        risk_level: number;
+        active_conflicts: number;
+        chokepoints_status?: Record<string, string>;
+    }>;
+}
+export interface GeoSignalsAssetImpactResponse {
+    assets: Array<{
+        symbol: string;
+        risk_score: number;
+        primary_risk_driver: string;
+        affected_supply_pct?: number;
+    }>;
+}
+export declare class GeosignalsResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Retrieves active geopolitical risk events and conflict alerts.
+     */
+    getEvents(options?: RequestOptions): Promise<GeoSignalsResponse>;
+    /**
+     * Retrieves global geopolitical risk map layer data and maritime chokepoints status.
+     */
+    getMap(options?: RequestOptions): Promise<GeoSignalsMapResponse>;
+    /**
+     * Retrieves mapped asset vulnerabilities and commodity exposure to current geopolitical tensions.
+     */
+    getAssetImpacts(options?: RequestOptions): Promise<GeoSignalsAssetImpactResponse>;
+}

package/dist/resources/intelligence.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Official PIA SDK - AI Intelligence & Market Analysis Resource
+ */
+import type { HttpTransport } from "../http/transport";
+import type { RequestOptions } from "../types";
+export interface IntelligenceAnalyzeRequest {
+    symbol?: string;
+    query?: string;
+    context?: Record<string, any>;
+}
+export interface IntelligenceAnalyzeResponse {
+    symbol?: string;
+    sentiment?: "bullish" | "bearish" | "neutral";
+    confidence?: number;
+    analysis: string;
+    catalysts?: string[];
+    key_levels?: {
+        support?: number[];
+        resistance?: number[];
+    };
+    generated_at: string;
+}
+export interface MarketInsightResponse {
+    symbol: string;
+    summary: string;
+    sentiment: string;
+    drivers?: string[];
+    timestamp?: string;
+}
+export declare class IntelligenceResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Generates AI-powered real-time quantitative analysis and catalyst explanations.
+     */
+    analyze(request: IntelligenceAnalyzeRequest, options?: RequestOptions): Promise<IntelligenceAnalyzeResponse>;
+    /**
+     * Retrieves synthesized AI narrative insights and price drivers for a specific symbol.
+     */
+    getInsights(symbol: string, options?: RequestOptions): Promise<MarketInsightResponse>;
+}

package/dist/resources/market.d.ts

@@ -25,6 +25,22 @@ export declare class MarketResource {
      * Retrieves AI/Quant market insights and price movement narrative for a given instrument.
      */
     getInsights(symbol: string, options?: RequestOptions): Promise<any>;
+    /**
+     * Retrieves active market trading halts and circuit breaker triggers.
+     */
+    getTradingHalts(options?: RequestOptions): Promise<any>;
+    /**
+     * Retrieves upcoming and historical corporate actions (dividends, splits, earnings).
+     */
+    getCorporateActions(options?: RequestOptions): Promise<any>;
+    /**
+     * Calculates historical realized volatility (HV) across rolling windows (10d, 30d, 90d).
+     */
+    getRealizedVolatility(symbol?: string, options?: RequestOptions): Promise<any>;
+    /**
+     * Retrieves implied volatility (IV) surface and ATM volatility index.
+     */
+    getImpliedVolatility(symbol?: string, options?: RequestOptions): Promise<any>;
     /**
      * @deprecated Use `getInsights(symbol)` instead.
      */

package/dist/resources/sec.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Official PIA SDK - SEC EDGAR Filings Resource
+ */
+import type { HttpTransport } from "../http/transport";
+import type { RequestOptions } from "../types";
+export interface SecFilingItem {
+    id: string;
+    symbol: string;
+    form_type: "10-K" | "10-Q" | "8-K" | "4" | "13F" | string;
+    company_name: string;
+    cik: string;
+    filing_date: string;
+    report_url: string;
+    description?: string;
+}
+export interface SecFilingsResponse {
+    total: number;
+    items: SecFilingItem[];
+    has_more?: boolean;
+}
+export interface GetSecFilingsOptions extends RequestOptions {
+    symbol?: string;
+    form_type?: string;
+    limit?: number;
+    since?: string;
+}
+export declare class SecResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Retrieves latest corporate SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4 insider trades).
+     */
+    getFilings(options?: GetSecFilingsOptions): Promise<SecFilingsResponse>;
+    /**
+     * Retrieves SEC filing history for a specific public company symbol.
+     */
+    getCompany(symbol: string, options?: RequestOptions): Promise<any>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piaa/sdk",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Official TypeScript/JavaScript SDK for PIA Market Intelligence Platform",
   "main": "./dist/index.js",
   "module": "./dist/index.js",