@fullstackcraftllc/floe 0.0.12 → 0.0.13

package/README.md

@@ -2,7 +2,7 @@
 
 ![npm](https://img.shields.io/npm/v/@fullstackcraftllc/floe?style=flat-square) ![License](https://img.shields.io/npm/l/@fullstackcraftllc/floe?style=flat-square) ![TypeScript](https://img.shields.io/badge/TypeScript-4.9-blue?style=flat-square&logo=typescript)
 
-Zero-dependency TypeScript functions for options flow: Black-Scholes, greeks, dealer exposures, implied PDFs, and more, with a clean, type-safe API. Built for use in trading platforms and fintech applications.
+Zero-dependency TypeScript functions for options flow: Black-Scholes, greeks, IV surfaces, dealer exposures, implied PDFs, and more, with a clean, type-safe API. Built for use in trading platforms and fintech applications.
 
 The same library that is used in [Full Stack Craft's](https://fullstackcraft.com) various fintech products including [The Wheel Screener](https://wheelscreener.com), [LEAPS Screener](https://leapsscreener.com), [Option Screener](https://option-screener.com), [AMT JOY](https://amtjoy.com), and [VannaCharm](https://vannacharm.com).
 
@@ -84,15 +84,12 @@ By contributing, you agree that your contributions will be licensed under the sa
 
 ## TODOs
 
-- [ ] Implied PDF calculations
-- [ ] Tradier integration, normalization, and docs
-- [ ] TradeStation integration, normalization, and docs
-- [ ] Interactive Brokers integration, normalization, and docs
+- [X] Implied PDF calculations
+- [X] Tradier integration
+- [X] TradeStation integration
+- [ ] Interactive Brokers integration
+- [ ] Trading functionality with all brokers
 
 ## Credits
 
-Built with ❤️ by [Full Stack Craft LLC](https://fullstackcraft.com)
-
----
-
-**© 2025 Full Stack Craft LLC** - All rights reserved.
+Copyright © 2025 Built with ❤️ by [Full Stack Craft LLC](https://fullstackcraft.com)

package/dist/client/brokers/TastyTradeClient.js

@@ -662,6 +662,10 @@ class TastyTradeClient extends BaseBrokerClient_1.BaseBrokerClient {
      * Processes a single event from FEED_DATA.
      */
     processEventData(eventType, values) {
+        // for debugging summary events (if verbose)
+        if (eventType === 'Summary' && this.verbose) {
+            console.log(`[TastyTrade:DEBUG] Summary raw values:`, values);
+        }
         // Values are in order of acceptEventFields
         const fields = FEED_EVENT_FIELDS[eventType];
         if (!fields)

package/dist/client/brokers/TradierClient.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TradierClient = void 0;
+const indexOptions_1 = require("../../utils/indexOptions");
 const occ_1 = require("../../utils/occ");
 const BaseBrokerClient_1 = require("./BaseBrokerClient");
 /**
@@ -193,7 +194,8 @@ class TradierClient extends BaseBrokerClient_1.BaseBrokerClient {
         for (const occSymbol of occSymbols) {
             try {
                 const parsed = (0, occ_1.parseOCCSymbol)(occSymbol);
-                const key = `${parsed.symbol}:${parsed.expiration.toISOString().split('T')[0]}`;
+                const underlying = (0, indexOptions_1.getUnderlyingFromOptionRoot)(parsed.symbol);
+                const key = `${underlying}:${parsed.expiration.toISOString().split('T')[0]}`;
                 if (!groups.has(key)) {
                     groups.set(key, new Set());
                 }

package/dist/utils/indexOptions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Maps option root symbols to their underlying symbols.
+ * Index options often have different root symbols than their underlying.
+ * e.g., SPX options have the prefix 'SPXW', at least in brokers like Tradier.
+ */
+export declare const OPTION_ROOT_TO_UNDERLYING: Record<string, string>;
+/**
+ * Get the underlying symbol for an option root.
+ * Returns the root itself if no mapping exists (i.e., for regular equity options).
+ */
+export declare const getUnderlyingFromOptionRoot: (optionRoot: string) => string;

package/dist/utils/indexOptions.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUnderlyingFromOptionRoot = exports.OPTION_ROOT_TO_UNDERLYING = void 0;
+/**
+ * Maps option root symbols to their underlying symbols.
+ * Index options often have different root symbols than their underlying.
+ * e.g., SPX options have the prefix 'SPXW', at least in brokers like Tradier.
+ */
+exports.OPTION_ROOT_TO_UNDERLYING = {
+    'SPXW': 'SPX', // SPX Weekly options
+    'SPXPM': 'SPX', // SPX PM-settled options
+    'NDXP': 'NDX', // NDX PM-settled options
+    'RUTW': 'RUT', // RUT Weekly options
+    // Add more as needed
+};
+/**
+ * Get the underlying symbol for an option root.
+ * Returns the root itself if no mapping exists (i.e., for regular equity options).
+ */
+const getUnderlyingFromOptionRoot = (optionRoot) => {
+    return exports.OPTION_ROOT_TO_UNDERLYING[optionRoot.toUpperCase()] || optionRoot;
+};
+exports.getUnderlyingFromOptionRoot = getUnderlyingFromOptionRoot;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstackcraftllc/floe",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Production-ready options analytics toolkit. Normalize broker data structures and calculate Black-Scholes, Greeks, and exposures with a clean, type-safe API. Built for trading platforms and fintech applications.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",