@trade-it/core 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# `@trade-it/core`
+
+Framework-agnostic core utilities for Trade It embedded SDKs.
+
+This package powers the Trade It SDK surface shared across framework wrappers, including:
+
+- shared types
+- trade URL resolution
+- event parsing helpers
+
+Most integrators should use [`@trade-it/react`](https://www.npmjs.com/package/@trade-it/react) directly.
+
+## Install
+
+```bash
+npm i @trade-it/core
+```
+
+## Documentation
+
+Integration guides and reference docs:
+
+- [React SDK Overview](https://docs.tradeit.app/sdk)
+- [Place Trades](https://docs.tradeit.app/sdk/trades)
+- [SDK Enums Reference](https://docs.tradeit.app/sdk/enums)
+
+## Notes
+
+- This package is intended for framework wrappers or advanced integrations.
+- Trade It session URLs should still be requested from your server.

package/dist/index.cjs

@@ -0,0 +1,153 @@
+
+//#region ../../lib/types/src/enums/trading.enums.ts
+let TradeAction = /* @__PURE__ */ function(TradeAction$1) {
+	TradeAction$1["Buy"] = "buy";
+	TradeAction$1["Sell"] = "sell";
+	return TradeAction$1;
+}({});
+let PositionEffect = /* @__PURE__ */ function(PositionEffect$1) {
+	PositionEffect$1["Open"] = "open";
+	PositionEffect$1["Close"] = "close";
+	return PositionEffect$1;
+}({});
+let OrderType = /* @__PURE__ */ function(OrderType$1) {
+	OrderType$1["Market"] = "market";
+	OrderType$1["Limit"] = "limit";
+	OrderType$1["Stop"] = "stop";
+	OrderType$1["StopLimit"] = "stop_limit";
+	return OrderType$1;
+}({});
+let OrderDirection = /* @__PURE__ */ function(OrderDirection$1) {
+	OrderDirection$1["Debit"] = "debit";
+	OrderDirection$1["Credit"] = "credit";
+	return OrderDirection$1;
+}({});
+let TimeInForce = /* @__PURE__ */ function(TimeInForce$1) {
+	TimeInForce$1["Day"] = "day";
+	TimeInForce$1["GoodTillCanceled"] = "gtc";
+	TimeInForce$1["ImmediateOrCancel"] = "ioc";
+	TimeInForce$1["FillOrKill"] = "fok";
+	return TimeInForce$1;
+}({});
+let TradeUnit = /* @__PURE__ */ function(TradeUnit$1) {
+	TradeUnit$1["Dollars"] = "dollars";
+	TradeUnit$1["Shares"] = "shares";
+	return TradeUnit$1;
+}({});
+let LegType = /* @__PURE__ */ function(LegType$1) {
+	LegType$1["Option"] = "option";
+	LegType$1["Equity"] = "equity";
+	return LegType$1;
+}({});
+let TradeType = /* @__PURE__ */ function(TradeType$1) {
+	TradeType$1[TradeType$1["Simple"] = 0] = "Simple";
+	TradeType$1[TradeType$1["MultiLeg"] = 1] = "MultiLeg";
+	return TradeType$1;
+}({});
+
+//#endregion
+//#region ../../lib/types/src/types/trade-link.types.ts
+/**
+* Short query parameter keys for trade link URLs
+*/
+let TradeLinkParam = /* @__PURE__ */ function(TradeLinkParam$1) {
+	TradeLinkParam$1["TradeType"] = "tt";
+	TradeLinkParam$1["Action"] = "t";
+	TradeLinkParam$1["OrderType"] = "ot";
+	TradeLinkParam$1["Amount"] = "a";
+	TradeLinkParam$1["Unit"] = "u";
+	TradeLinkParam$1["LimitPrice"] = "lp";
+	TradeLinkParam$1["StopPrice"] = "sp";
+	TradeLinkParam$1["TimeInForce"] = "tif";
+	TradeLinkParam$1["UtmReferred"] = "ref";
+	TradeLinkParam$1["Legs"] = "legs";
+	return TradeLinkParam$1;
+}({});
+
+//#endregion
+//#region src/events.ts
+function isTradeItEvent(data) {
+	if (!data || typeof data !== "object") return false;
+	const message = data;
+	return message.source === "tradeit" && message.version === 1 && typeof message.type === "string" && message.type.startsWith("tradeit.");
+}
+function getTradeItErrorMessage(event) {
+	const message = event.payload?.message;
+	return typeof message === "string" ? message : "Trade It embedded experience returned an error event.";
+}
+
+//#endregion
+//#region src/url.ts
+function appendQueryParam(params, key, value) {
+	if (value == null) return;
+	params.set(key, String(value));
+}
+function isMultiLegTradeConfig(config) {
+	return config.tradeType === TradeType.MultiLeg || Array.isArray(config.legs);
+}
+function toShortLegConfig(leg) {
+	return {
+		type: leg.type,
+		t: leg.action,
+		pe: leg.positionEffect,
+		occ: leg.occ,
+		q: leg.quantity
+	};
+}
+function normalizeTradeConfig(config) {
+	const params = new URLSearchParams();
+	if (!config) return params;
+	const multiLeg = isMultiLegTradeConfig(config);
+	appendQueryParam(params, TradeLinkParam.TradeType, multiLeg ? TradeType.MultiLeg : TradeType.Simple);
+	appendQueryParam(params, TradeLinkParam.OrderType, config.orderType);
+	appendQueryParam(params, TradeLinkParam.LimitPrice, config.limitPrice);
+	appendQueryParam(params, TradeLinkParam.StopPrice, config.stopPrice);
+	appendQueryParam(params, TradeLinkParam.TimeInForce, config.timeInForce);
+	appendQueryParam(params, TradeLinkParam.UtmReferred, config.referral);
+	if (multiLeg) params.set(TradeLinkParam.Legs, JSON.stringify(config.legs.map(toShortLegConfig)));
+	else {
+		appendQueryParam(params, TradeLinkParam.Action, config.action);
+		appendQueryParam(params, TradeLinkParam.Amount, config.amount);
+		appendQueryParam(params, TradeLinkParam.Unit, config.unit);
+	}
+	return params;
+}
+function mergeSearchParams(url, extra) {
+	extra.forEach((value, key) => {
+		url.searchParams.set(key, value);
+	});
+}
+function resolveLaunchUrl(launch) {
+	if (launch.mode === "connect") return launch.url;
+	if (!launch.config) throw new Error("Trade launch must include a config object.");
+	if (!launch.url.includes("[ticker]")) throw new Error("Trade launch url must contain the \"[ticker]\" placeholder.");
+	const encodedTicker = encodeURIComponent(launch.config.ticker);
+	const rawUrl = launch.url.replace("[ticker]", encodedTicker);
+	const url = new URL(rawUrl, typeof window !== "undefined" ? window.location.href : "https://tradeit.app");
+	const configParams = normalizeTradeConfig(launch.config);
+	mergeSearchParams(url, configParams);
+	if (!url.searchParams.has("embedded")) url.searchParams.set("embedded", "1");
+	return url.toString();
+}
+function getUrlOrigin(url) {
+	try {
+		return new URL(url).origin;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+exports.LegType = LegType;
+exports.OrderDirection = OrderDirection;
+exports.OrderType = OrderType;
+exports.PositionEffect = PositionEffect;
+exports.TimeInForce = TimeInForce;
+exports.TradeAction = TradeAction;
+exports.TradeLinkParam = TradeLinkParam;
+exports.TradeType = TradeType;
+exports.TradeUnit = TradeUnit;
+exports.getTradeItErrorMessage = getTradeItErrorMessage;
+exports.getUrlOrigin = getUrlOrigin;
+exports.isTradeItEvent = isTradeItEvent;
+exports.resolveLaunchUrl = resolveLaunchUrl;

package/dist/index.d.cts

@@ -0,0 +1,174 @@
+import { z } from "zod";
+
+//#region ../../lib/types/src/enums/trading.enums.d.ts
+declare enum TradeAction {
+  Buy = "buy",
+  Sell = "sell",
+}
+declare enum PositionEffect {
+  Open = "open",
+  Close = "close",
+}
+declare enum OrderType {
+  Market = "market",
+  Limit = "limit",
+  Stop = "stop",
+  StopLimit = "stop_limit",
+}
+declare enum OrderDirection {
+  Debit = "debit",
+  Credit = "credit",
+}
+declare enum TimeInForce {
+  Day = "day",
+  GoodTillCanceled = "gtc",
+  ImmediateOrCancel = "ioc",
+  FillOrKill = "fok",
+}
+declare enum TradeUnit {
+  Dollars = "dollars",
+  Shares = "shares",
+}
+declare enum LegType {
+  Option = "option",
+  Equity = "equity",
+}
+declare enum TradeType {
+  Simple = 0,
+  MultiLeg = 1,
+}
+//#endregion
+//#region ../../lib/types/src/schemas/trade-link.schemas.d.ts
+/**
+ * Trade Link Leg Config - derived from TradeLeg without execution_price
+ */
+declare const zTradeLinkLegConfig: z.ZodObject<Omit<{
+  type: z.ZodNativeEnum<typeof LegType>;
+  action: z.ZodNativeEnum<typeof TradeAction>;
+  position_effect: z.ZodNullable<z.ZodNativeEnum<typeof PositionEffect>>;
+  occ: z.ZodNullable<z.ZodString>;
+  quantity: z.ZodNumber;
+  execution_price: z.ZodNullable<z.ZodObject<{
+    amount: z.ZodNumber;
+    currency: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    amount: number;
+    currency: string;
+  }, {
+    amount: number;
+    currency: string;
+  }>>;
+}, "execution_price">, "strip", z.ZodTypeAny, {
+  type: LegType;
+  action: TradeAction;
+  position_effect: PositionEffect | null;
+  occ: string | null;
+  quantity: number;
+}, {
+  type: LegType;
+  action: TradeAction;
+  position_effect: PositionEffect | null;
+  occ: string | null;
+  quantity: number;
+}>;
+/**
+ * Full Trade Link Config - stored in database as JSONB
+ * Supports both simple trades and multi-leg options trades
+ */
+//#endregion
+//#region ../../lib/types/src/types/misc.types.d.ts
+type SnakeToCamelCase<S extends string> = S extends `${infer P1}_${infer P2}` ? `${P1}${Capitalize<SnakeToCamelCase<P2>>}` : S;
+/** Converts a type's snake_case keys to camelCase keys */
+type Camelize<T> = T extends object ? { [K in keyof T as K extends string ? SnakeToCamelCase<K> : K]: Camelize<T[K]> } : T;
+//#endregion
+//#region ../../lib/types/src/types/trade-link.types.d.ts
+/** Configuration for a leg in a multi-leg trade link */
+type TradeLinkLegConfig = z.infer<typeof zTradeLinkLegConfig>;
+/** Full configuration stored in the trade link */
+
+/**
+ * Short query parameter keys for trade link URLs
+ */
+declare enum TradeLinkParam {
+  TradeType = "tt",
+  // s (simple), m (multi_leg)
+  Action = "t",
+  // b, s, bto, btc, sto, stc
+  OrderType = "ot",
+  // m, l, st, sl
+  Amount = "a",
+  // number
+  Unit = "u",
+  // d, s
+  LimitPrice = "lp",
+  // number
+  StopPrice = "sp",
+  // number
+  TimeInForce = "tif",
+  // d, gtc, ioc, fok
+  UtmReferred = "ref",
+  // string
+  Legs = "legs",
+}
+//#endregion
+//#region src/types.d.ts
+type TradeItEventType = 'tradeit.ready' | 'tradeit.close_requested' | 'tradeit.brokerage_connected' | 'tradeit.trade_submitted' | 'tradeit.trade_executed' | 'tradeit.error' | 'tradeit.login_required';
+interface TradeItEvent<TPayload = Record<string, unknown>> {
+  source: 'tradeit';
+  version: 1;
+  type: TradeItEventType;
+  payload?: TPayload;
+}
+type TradeItQueryPrimitive = string | number | boolean | null | undefined;
+type TradeItMode = 'connect' | 'trade';
+type TradeItMultiLegTradeLegConfig = Partial<Camelize<TradeLinkLegConfig>>;
+/**
+ * Query params accepted by Trade It's /t/[ticker] page.
+ * User-facing config uses descriptive keys; core converts them to the short-key
+ * query format used by the page parser (tt, t, ot, a, u, lp, sp, tif, ref, legs).
+ */
+interface TradeItTradeConfigBase {
+  ticker: string;
+  orderType?: OrderType;
+  limitPrice?: number;
+  stopPrice?: number;
+  timeInForce?: TimeInForce;
+  referral?: string;
+}
+interface TradeItSimpleTradeConfig extends TradeItTradeConfigBase {
+  tradeType?: TradeType.Simple;
+  action?: TradeAction;
+  amount?: number;
+  unit?: TradeUnit;
+}
+interface TradeItMultiLegTradeConfig extends TradeItTradeConfigBase {
+  tradeType: TradeType.MultiLeg;
+  direction?: OrderDirection;
+  legs: TradeItMultiLegTradeLegConfig[];
+}
+type TradeItTradeConfig = TradeItSimpleTradeConfig | TradeItMultiLegTradeConfig;
+interface TradeItLaunchConfigMap {
+  connect: undefined;
+  trade: TradeItTradeConfig;
+}
+type TradeItLaunchShape<TMode extends TradeItMode> = {
+  mode: TMode;
+  url: string;
+} & (TMode extends 'connect' ? {
+  config?: undefined;
+} : {
+  config: TradeItLaunchConfigMap[TMode];
+});
+type TradeItLaunch<TMode extends TradeItMode = TradeItMode> = TMode extends TradeItMode ? TradeItLaunchShape<TMode> : never;
+type TradeItConnectLaunch = TradeItLaunch<'connect'>;
+type TradeItTradeLaunch = TradeItLaunch<'trade'>;
+//#endregion
+//#region src/events.d.ts
+declare function isTradeItEvent(data: unknown): data is TradeItEvent;
+declare function getTradeItErrorMessage(event: TradeItEvent): string;
+//#endregion
+//#region src/url.d.ts
+declare function resolveLaunchUrl(launch: TradeItLaunch): string;
+declare function getUrlOrigin(url: string): string | null;
+//#endregion
+export { LegType, OrderDirection, OrderType, PositionEffect, TimeInForce, TradeAction, type TradeItConnectLaunch, type TradeItEvent, type TradeItEventType, type TradeItLaunch, type TradeItLaunchConfigMap, type TradeItMode, type TradeItMultiLegTradeConfig, type TradeItMultiLegTradeLegConfig, type TradeItQueryPrimitive, type TradeItSimpleTradeConfig, type TradeItTradeConfig, type TradeItTradeLaunch, type TradeLinkLegConfig, TradeLinkParam, TradeType, TradeUnit, getTradeItErrorMessage, getUrlOrigin, isTradeItEvent, resolveLaunchUrl };

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+import { z } from "zod";
+
+//#region ../../lib/types/src/enums/trading.enums.d.ts
+declare enum TradeAction {
+  Buy = "buy",
+  Sell = "sell",
+}
+declare enum PositionEffect {
+  Open = "open",
+  Close = "close",
+}
+declare enum OrderType {
+  Market = "market",
+  Limit = "limit",
+  Stop = "stop",
+  StopLimit = "stop_limit",
+}
+declare enum OrderDirection {
+  Debit = "debit",
+  Credit = "credit",
+}
+declare enum TimeInForce {
+  Day = "day",
+  GoodTillCanceled = "gtc",
+  ImmediateOrCancel = "ioc",
+  FillOrKill = "fok",
+}
+declare enum TradeUnit {
+  Dollars = "dollars",
+  Shares = "shares",
+}
+declare enum LegType {
+  Option = "option",
+  Equity = "equity",
+}
+declare enum TradeType {
+  Simple = 0,
+  MultiLeg = 1,
+}
+//#endregion
+//#region ../../lib/types/src/schemas/trade-link.schemas.d.ts
+/**
+ * Trade Link Leg Config - derived from TradeLeg without execution_price
+ */
+declare const zTradeLinkLegConfig: z.ZodObject<Omit<{
+  type: z.ZodNativeEnum<typeof LegType>;
+  action: z.ZodNativeEnum<typeof TradeAction>;
+  position_effect: z.ZodNullable<z.ZodNativeEnum<typeof PositionEffect>>;
+  occ: z.ZodNullable<z.ZodString>;
+  quantity: z.ZodNumber;
+  execution_price: z.ZodNullable<z.ZodObject<{
+    amount: z.ZodNumber;
+    currency: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    amount: number;
+    currency: string;
+  }, {
+    amount: number;
+    currency: string;
+  }>>;
+}, "execution_price">, "strip", z.ZodTypeAny, {
+  type: LegType;
+  action: TradeAction;
+  position_effect: PositionEffect | null;
+  occ: string | null;
+  quantity: number;
+}, {
+  type: LegType;
+  action: TradeAction;
+  position_effect: PositionEffect | null;
+  occ: string | null;
+  quantity: number;
+}>;
+/**
+ * Full Trade Link Config - stored in database as JSONB
+ * Supports both simple trades and multi-leg options trades
+ */
+//#endregion
+//#region ../../lib/types/src/types/misc.types.d.ts
+type SnakeToCamelCase<S extends string> = S extends `${infer P1}_${infer P2}` ? `${P1}${Capitalize<SnakeToCamelCase<P2>>}` : S;
+/** Converts a type's snake_case keys to camelCase keys */
+type Camelize<T> = T extends object ? { [K in keyof T as K extends string ? SnakeToCamelCase<K> : K]: Camelize<T[K]> } : T;
+//#endregion
+//#region ../../lib/types/src/types/trade-link.types.d.ts
+/** Configuration for a leg in a multi-leg trade link */
+type TradeLinkLegConfig = z.infer<typeof zTradeLinkLegConfig>;
+/** Full configuration stored in the trade link */
+
+/**
+ * Short query parameter keys for trade link URLs
+ */
+declare enum TradeLinkParam {
+  TradeType = "tt",
+  // s (simple), m (multi_leg)
+  Action = "t",
+  // b, s, bto, btc, sto, stc
+  OrderType = "ot",
+  // m, l, st, sl
+  Amount = "a",
+  // number
+  Unit = "u",
+  // d, s
+  LimitPrice = "lp",
+  // number
+  StopPrice = "sp",
+  // number
+  TimeInForce = "tif",
+  // d, gtc, ioc, fok
+  UtmReferred = "ref",
+  // string
+  Legs = "legs",
+}
+//#endregion
+//#region src/types.d.ts
+type TradeItEventType = 'tradeit.ready' | 'tradeit.close_requested' | 'tradeit.brokerage_connected' | 'tradeit.trade_submitted' | 'tradeit.trade_executed' | 'tradeit.error' | 'tradeit.login_required';
+interface TradeItEvent<TPayload = Record<string, unknown>> {
+  source: 'tradeit';
+  version: 1;
+  type: TradeItEventType;
+  payload?: TPayload;
+}
+type TradeItQueryPrimitive = string | number | boolean | null | undefined;
+type TradeItMode = 'connect' | 'trade';
+type TradeItMultiLegTradeLegConfig = Partial<Camelize<TradeLinkLegConfig>>;
+/**
+ * Query params accepted by Trade It's /t/[ticker] page.
+ * User-facing config uses descriptive keys; core converts them to the short-key
+ * query format used by the page parser (tt, t, ot, a, u, lp, sp, tif, ref, legs).
+ */
+interface TradeItTradeConfigBase {
+  ticker: string;
+  orderType?: OrderType;
+  limitPrice?: number;
+  stopPrice?: number;
+  timeInForce?: TimeInForce;
+  referral?: string;
+}
+interface TradeItSimpleTradeConfig extends TradeItTradeConfigBase {
+  tradeType?: TradeType.Simple;
+  action?: TradeAction;
+  amount?: number;
+  unit?: TradeUnit;
+}
+interface TradeItMultiLegTradeConfig extends TradeItTradeConfigBase {
+  tradeType: TradeType.MultiLeg;
+  direction?: OrderDirection;
+  legs: TradeItMultiLegTradeLegConfig[];
+}
+type TradeItTradeConfig = TradeItSimpleTradeConfig | TradeItMultiLegTradeConfig;
+interface TradeItLaunchConfigMap {
+  connect: undefined;
+  trade: TradeItTradeConfig;
+}
+type TradeItLaunchShape<TMode extends TradeItMode> = {
+  mode: TMode;
+  url: string;
+} & (TMode extends 'connect' ? {
+  config?: undefined;
+} : {
+  config: TradeItLaunchConfigMap[TMode];
+});
+type TradeItLaunch<TMode extends TradeItMode = TradeItMode> = TMode extends TradeItMode ? TradeItLaunchShape<TMode> : never;
+type TradeItConnectLaunch = TradeItLaunch<'connect'>;
+type TradeItTradeLaunch = TradeItLaunch<'trade'>;
+//#endregion
+//#region src/events.d.ts
+declare function isTradeItEvent(data: unknown): data is TradeItEvent;
+declare function getTradeItErrorMessage(event: TradeItEvent): string;
+//#endregion
+//#region src/url.d.ts
+declare function resolveLaunchUrl(launch: TradeItLaunch): string;
+declare function getUrlOrigin(url: string): string | null;
+//#endregion
+export { LegType, OrderDirection, OrderType, PositionEffect, TimeInForce, TradeAction, type TradeItConnectLaunch, type TradeItEvent, type TradeItEventType, type TradeItLaunch, type TradeItLaunchConfigMap, type TradeItMode, type TradeItMultiLegTradeConfig, type TradeItMultiLegTradeLegConfig, type TradeItQueryPrimitive, type TradeItSimpleTradeConfig, type TradeItTradeConfig, type TradeItTradeLaunch, type TradeLinkLegConfig, TradeLinkParam, TradeType, TradeUnit, getTradeItErrorMessage, getUrlOrigin, isTradeItEvent, resolveLaunchUrl };

package/dist/index.js

@@ -0,0 +1,140 @@
+//#region ../../lib/types/src/enums/trading.enums.ts
+let TradeAction = /* @__PURE__ */ function(TradeAction$1) {
+	TradeAction$1["Buy"] = "buy";
+	TradeAction$1["Sell"] = "sell";
+	return TradeAction$1;
+}({});
+let PositionEffect = /* @__PURE__ */ function(PositionEffect$1) {
+	PositionEffect$1["Open"] = "open";
+	PositionEffect$1["Close"] = "close";
+	return PositionEffect$1;
+}({});
+let OrderType = /* @__PURE__ */ function(OrderType$1) {
+	OrderType$1["Market"] = "market";
+	OrderType$1["Limit"] = "limit";
+	OrderType$1["Stop"] = "stop";
+	OrderType$1["StopLimit"] = "stop_limit";
+	return OrderType$1;
+}({});
+let OrderDirection = /* @__PURE__ */ function(OrderDirection$1) {
+	OrderDirection$1["Debit"] = "debit";
+	OrderDirection$1["Credit"] = "credit";
+	return OrderDirection$1;
+}({});
+let TimeInForce = /* @__PURE__ */ function(TimeInForce$1) {
+	TimeInForce$1["Day"] = "day";
+	TimeInForce$1["GoodTillCanceled"] = "gtc";
+	TimeInForce$1["ImmediateOrCancel"] = "ioc";
+	TimeInForce$1["FillOrKill"] = "fok";
+	return TimeInForce$1;
+}({});
+let TradeUnit = /* @__PURE__ */ function(TradeUnit$1) {
+	TradeUnit$1["Dollars"] = "dollars";
+	TradeUnit$1["Shares"] = "shares";
+	return TradeUnit$1;
+}({});
+let LegType = /* @__PURE__ */ function(LegType$1) {
+	LegType$1["Option"] = "option";
+	LegType$1["Equity"] = "equity";
+	return LegType$1;
+}({});
+let TradeType = /* @__PURE__ */ function(TradeType$1) {
+	TradeType$1[TradeType$1["Simple"] = 0] = "Simple";
+	TradeType$1[TradeType$1["MultiLeg"] = 1] = "MultiLeg";
+	return TradeType$1;
+}({});
+
+//#endregion
+//#region ../../lib/types/src/types/trade-link.types.ts
+/**
+* Short query parameter keys for trade link URLs
+*/
+let TradeLinkParam = /* @__PURE__ */ function(TradeLinkParam$1) {
+	TradeLinkParam$1["TradeType"] = "tt";
+	TradeLinkParam$1["Action"] = "t";
+	TradeLinkParam$1["OrderType"] = "ot";
+	TradeLinkParam$1["Amount"] = "a";
+	TradeLinkParam$1["Unit"] = "u";
+	TradeLinkParam$1["LimitPrice"] = "lp";
+	TradeLinkParam$1["StopPrice"] = "sp";
+	TradeLinkParam$1["TimeInForce"] = "tif";
+	TradeLinkParam$1["UtmReferred"] = "ref";
+	TradeLinkParam$1["Legs"] = "legs";
+	return TradeLinkParam$1;
+}({});
+
+//#endregion
+//#region src/events.ts
+function isTradeItEvent(data) {
+	if (!data || typeof data !== "object") return false;
+	const message = data;
+	return message.source === "tradeit" && message.version === 1 && typeof message.type === "string" && message.type.startsWith("tradeit.");
+}
+function getTradeItErrorMessage(event) {
+	const message = event.payload?.message;
+	return typeof message === "string" ? message : "Trade It embedded experience returned an error event.";
+}
+
+//#endregion
+//#region src/url.ts
+function appendQueryParam(params, key, value) {
+	if (value == null) return;
+	params.set(key, String(value));
+}
+function isMultiLegTradeConfig(config) {
+	return config.tradeType === TradeType.MultiLeg || Array.isArray(config.legs);
+}
+function toShortLegConfig(leg) {
+	return {
+		type: leg.type,
+		t: leg.action,
+		pe: leg.positionEffect,
+		occ: leg.occ,
+		q: leg.quantity
+	};
+}
+function normalizeTradeConfig(config) {
+	const params = new URLSearchParams();
+	if (!config) return params;
+	const multiLeg = isMultiLegTradeConfig(config);
+	appendQueryParam(params, TradeLinkParam.TradeType, multiLeg ? TradeType.MultiLeg : TradeType.Simple);
+	appendQueryParam(params, TradeLinkParam.OrderType, config.orderType);
+	appendQueryParam(params, TradeLinkParam.LimitPrice, config.limitPrice);
+	appendQueryParam(params, TradeLinkParam.StopPrice, config.stopPrice);
+	appendQueryParam(params, TradeLinkParam.TimeInForce, config.timeInForce);
+	appendQueryParam(params, TradeLinkParam.UtmReferred, config.referral);
+	if (multiLeg) params.set(TradeLinkParam.Legs, JSON.stringify(config.legs.map(toShortLegConfig)));
+	else {
+		appendQueryParam(params, TradeLinkParam.Action, config.action);
+		appendQueryParam(params, TradeLinkParam.Amount, config.amount);
+		appendQueryParam(params, TradeLinkParam.Unit, config.unit);
+	}
+	return params;
+}
+function mergeSearchParams(url, extra) {
+	extra.forEach((value, key) => {
+		url.searchParams.set(key, value);
+	});
+}
+function resolveLaunchUrl(launch) {
+	if (launch.mode === "connect") return launch.url;
+	if (!launch.config) throw new Error("Trade launch must include a config object.");
+	if (!launch.url.includes("[ticker]")) throw new Error("Trade launch url must contain the \"[ticker]\" placeholder.");
+	const encodedTicker = encodeURIComponent(launch.config.ticker);
+	const rawUrl = launch.url.replace("[ticker]", encodedTicker);
+	const url = new URL(rawUrl, typeof window !== "undefined" ? window.location.href : "https://tradeit.app");
+	const configParams = normalizeTradeConfig(launch.config);
+	mergeSearchParams(url, configParams);
+	if (!url.searchParams.has("embedded")) url.searchParams.set("embedded", "1");
+	return url.toString();
+}
+function getUrlOrigin(url) {
+	try {
+		return new URL(url).origin;
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { LegType, OrderDirection, OrderType, PositionEffect, TimeInForce, TradeAction, TradeLinkParam, TradeType, TradeUnit, getTradeItErrorMessage, getUrlOrigin, isTradeItEvent, resolveLaunchUrl };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@trade-it/core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic core for Trade It embedded SDKs.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm,cjs --dts --out-dir dist && node ../../scripts/fix-trade-it-sdk-dts.mjs dist/index.d.ts dist/index.d.cts",
+    "dev": "tsdown src/index.ts --format esm,cjs --dts --out-dir dist --watch"
+  },
+  "dependencies": {
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "tsdown": "^0.11.0",
+    "typescript": "^5.7.2"
+  }
+}