@adaptic/utils 0.0.383 → 0.0.900

package/dist/types/utils/paginator.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Configuration for cursor-based pagination.
+ * Used by Alpaca APIs that return `next_page_token`.
+ */
+export interface CursorPaginationConfig<TItem, TResponse> {
+    /** Pagination strategy type */
+    type: "cursor";
+    /**
+     * Function that fetches a single page of results.
+     * @param cursor - The cursor/page token for the next page (undefined for first page)
+     * @returns The API response for that page
+     */
+    fetchPage: (cursor: string | undefined) => Promise<TResponse>;
+    /**
+     * Function that extracts items from the API response.
+     * @param response - The raw API response
+     * @returns Array of items from this page
+     */
+    getItems: (response: TResponse) => TItem[];
+    /**
+     * Function that extracts the next cursor/page token from the response.
+     * Returns undefined/null/empty string when there are no more pages.
+     * @param response - The raw API response
+     * @returns The next page token, or a falsy value if no more pages
+     */
+    getNextCursor: (response: TResponse) => string | undefined | null;
+    /** Maximum number of items to collect (optional; defaults to no limit) */
+    maxItems?: number;
+    /** Maximum number of pages to fetch (safety limit; defaults to 1000) */
+    maxPages?: number;
+    /** Label for logging purposes */
+    label?: string;
+}
+/**
+ * Configuration for URL-based pagination.
+ * Used by Polygon APIs that return `next_url`.
+ */
+export interface UrlPaginationConfig<TItem, TResponse> {
+    /** Pagination strategy type */
+    type: "url";
+    /**
+     * Function that fetches a page from a given URL.
+     * For the first page, the URL is the initial request URL.
+     * For subsequent pages, the URL comes from the previous response.
+     * @param url - The URL to fetch
+     * @returns The API response for that page
+     */
+    fetchPage: (url: string) => Promise<TResponse>;
+    /** The initial URL for the first page */
+    initialUrl: string;
+    /**
+     * Function that extracts items from the API response.
+     * @param response - The raw API response
+     * @returns Array of items from this page
+     */
+    getItems: (response: TResponse) => TItem[];
+    /**
+     * Function that extracts the next URL from the response.
+     * Returns undefined/null/empty string when there are no more pages.
+     * @param response - The raw API response
+     * @returns The next page URL, or a falsy value if no more pages
+     */
+    getNextUrl: (response: TResponse) => string | undefined | null;
+    /** Maximum number of items to collect (optional; defaults to no limit) */
+    maxItems?: number;
+    /** Maximum number of pages to fetch (safety limit; defaults to 1000) */
+    maxPages?: number;
+    /** Label for logging purposes */
+    label?: string;
+}
+/**
+ * Configuration for offset-based pagination.
+ * Used by APIs that accept page/offset parameters.
+ */
+export interface OffsetPaginationConfig<TItem, TResponse> {
+    /** Pagination strategy type */
+    type: "offset";
+    /**
+     * Function that fetches a page at a given offset.
+     * @param offset - The current offset (starts at 0)
+     * @param limit - The page size
+     * @returns The API response for that page
+     */
+    fetchPage: (offset: number, limit: number) => Promise<TResponse>;
+    /**
+     * Function that extracts items from the API response.
+     * @param response - The raw API response
+     * @returns Array of items from this page
+     */
+    getItems: (response: TResponse) => TItem[];
+    /** Number of items per page */
+    pageSize: number;
+    /**
+     * Optional function to determine the total number of items.
+     * If not provided, pagination stops when a page returns fewer items than pageSize.
+     * @param response - The first API response
+     * @returns Total number of items available
+     */
+    getTotalCount?: (response: TResponse) => number;
+    /** Maximum number of items to collect (optional; defaults to no limit) */
+    maxItems?: number;
+    /** Maximum number of pages to fetch (safety limit; defaults to 1000) */
+    maxPages?: number;
+    /** Label for logging purposes */
+    label?: string;
+}
+/** Union type of all pagination configurations */
+export type PaginationConfig<TItem, TResponse> = CursorPaginationConfig<TItem, TResponse> | UrlPaginationConfig<TItem, TResponse> | OffsetPaginationConfig<TItem, TResponse>;
+/**
+ * Creates an async iterator that paginates through API results.
+ * Yields individual items one at a time across all pages.
+ *
+ * @param config - Pagination configuration
+ * @returns AsyncGenerator that yields items one at a time
+ *
+ * @example
+ * ```typescript
+ * // Cursor-based (Alpaca)
+ * const iterator = paginate({
+ *   type: 'cursor',
+ *   fetchPage: (cursor) => alpacaAPI.getOrders({ page_token: cursor }),
+ *   getItems: (response) => response.orders,
+ *   getNextCursor: (response) => response.next_page_token,
+ *   label: 'getOrders',
+ * });
+ *
+ * for await (const order of iterator) {
+ *   processOrder(order);
+ * }
+ * ```
+ */
+export declare function paginate<TItem, TResponse>(config: PaginationConfig<TItem, TResponse>): AsyncGenerator<TItem, void, undefined>;
+/**
+ * Collects all items from a paginated API into a single array.
+ * This is a convenience wrapper around `paginate()`.
+ *
+ * @param config - Pagination configuration
+ * @returns Array of all items collected across all pages
+ *
+ * @example
+ * ```typescript
+ * // Collect all orders
+ * const allOrders = await paginateAll({
+ *   type: 'cursor',
+ *   fetchPage: (cursor) => alpacaAPI.getOrders({ page_token: cursor, limit: 100 }),
+ *   getItems: (response) => response,
+ *   getNextCursor: (response) => response.next_page_token,
+ *   maxItems: 500,
+ *   label: 'getAllOrders',
+ * });
+ * ```
+ */
+export declare function paginateAll<TItem, TResponse>(config: PaginationConfig<TItem, TResponse>): Promise<TItem[]>;
+//# sourceMappingURL=paginator.d.ts.map

package/dist/types/utils/paginator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginator.d.ts","sourceRoot":"","sources":["../../../src/utils/paginator.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,SAAS;IACtD,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,aAAa,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClE,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,EAAE,SAAS;IACnD,+BAA+B;IAC/B,IAAI,EAAE,KAAK,CAAC;IACZ;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,SAAS;IACtD,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf;;;;;OAKG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACjE;;;;OAIG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC;IAC3C,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,MAAM,CAAC;IAChD,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,SAAS,IACzC,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,GACxC,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,GACrC,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAK7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAuB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAC9C,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,GACzC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CA8FxC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAChD,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,GACzC,OAAO,CAAC,KAAK,EAAE,CAAC,CAQlB"}

package/dist/types/utils/retry.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Retry utility with exponential backoff for handling transient errors in external API calls.
+ *
+ * Features:
+ * - Configurable retry attempts and delays
+ * - Exponential backoff with jitter to prevent thundering herd
+ * - Respects Retry-After headers for rate limiting (429)
+ * - Fail-fast for non-retryable errors (4xx client errors)
+ * - Detailed error logging with context
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries: number;
+    /** Initial delay in milliseconds before first retry (default: 1000) */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds between retries (default: 30000) */
+    maxDelayMs: number;
+    /** HTTP status codes that should trigger a retry (default: [429, 500, 502, 503, 504]) */
+    retryableStatusCodes: number[];
+    /** Whether to retry on network errors (default: true) */
+    retryOnNetworkError: boolean;
+    /** Optional callback invoked on each retry attempt */
+    onRetry?: (attempt: number, error: unknown) => void;
+}
+/**
+ * Wraps an async function with retry logic and exponential backoff.
+ *
+ * This utility handles transient errors in external API calls by automatically retrying
+ * failed requests with intelligent backoff strategies. It respects rate limit headers,
+ * fails fast on non-retryable errors, and provides detailed logging.
+ *
+ * @template T - The return type of the wrapped function
+ * @param fn - The async function to wrap with retry logic
+ * @param config - Retry configuration (merged with defaults)
+ * @param label - A descriptive label for logging (e.g., 'Polygon.fetchTickerInfo')
+ * @returns A promise that resolves to the function's return value
+ * @throws The last error encountered if all retries are exhausted
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const data = await withRetry(
+ *   async () => fetch('https://api.example.com/data'),
+ *   {},
+ *   'ExampleAPI.fetchData'
+ * );
+ *
+ * // Custom configuration for rate-limited API
+ * const result = await withRetry(
+ *   async () => alphaVantageAPI.getQuote(symbol),
+ *   {
+ *     maxRetries: 5,
+ *     baseDelayMs: 5000,
+ *     maxDelayMs: 60000,
+ *     onRetry: (attempt, error) => {
+ *       getLogger().info(`Retry ${attempt} after error:`, error);
+ *     }
+ *   },
+ *   'AlphaVantage.getQuote'
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>, label?: string): Promise<T>;
+/**
+ * API-specific retry configurations for different external services.
+ * These configurations are tuned based on each API's rate limits and characteristics.
+ */
+export declare const API_RETRY_CONFIGS: {
+    /** Polygon.io API - 5 requests/second rate limit */
+    POLYGON: Partial<RetryConfig>;
+    /** Alpha Vantage API - 5 requests/minute rate limit (more strict) */
+    ALPHA_VANTAGE: Partial<RetryConfig>;
+    /** Alpaca API - generally reliable, shorter retry window */
+    ALPACA: Partial<RetryConfig>;
+    /** Generic crypto API configuration */
+    CRYPTO: Partial<RetryConfig>;
+};
+//# sourceMappingURL=retry.d.ts.map

package/dist/types/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/utils/retry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,yDAAyD;IACzD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AA4LD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,KAAK,GAAE,MAAkB,GACxB,OAAO,CAAC,CAAC,CAAC,CAmGZ;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B,oDAAoD;aAO/C,OAAO,CAAC,WAAW,CAAC;IAEzB,qEAAqE;mBAOhE,OAAO,CAAC,WAAW,CAAC;IAEzB,4DAA4D;YAOvD,OAAO,CAAC,WAAW,CAAC;IAEzB,uCAAuC;YAOlC,OAAO,CAAC,WAAW,CAAC;CAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/utils",
-  "version": "0.0.383",
+  "version": "0.0.900",
   "author": "Adaptic.ai",
   "description": "Utility functions used in Adaptic app and Lambda functions",
   "always-build-npm": true,
@@ -15,6 +15,9 @@
       "types": "./dist/types/index.d.ts"
     }
   },
+  "publishConfig": {
+    "tag": "stable"
+  },
   "files": [
     "dist"
   ],
@@ -23,11 +26,19 @@
     "build": "npm run clean && rollup -c",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build",
-    "test": "npm run build && node dist/test.js"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:legacy": "npm run build && node dist/test.js",
+    "build:analyze": "ANALYZE_BUNDLE=true npm run build",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch",
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s"
   },
   "dependencies": {
-    "@adaptic/backend-legacy": "^0.0.39",
+    "@adaptic/backend-legacy": "^0.0.59",
     "@adaptic/lumic-utils": "^1.0.6",
+    "@alpacahq/alpaca-trade-api": "^3.1.3",
     "@apollo/client": "^3.13.8",
     "chalk": "^5.4.1",
     "date-fns": "^4.1.0",
@@ -35,12 +46,15 @@
     "lru-cache": "^11.2.2",
     "ms": "^2.1.3",
     "p-limit": "^6.2.0",
-    "ws": "^8.18.3"
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "license": "ISC",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.6",
     "@rollup/plugin-json": "^6.1.0",
@@ -49,10 +63,16 @@
     "@types/date-fns": "^2.6.3",
     "@types/ms": "^2.1.0",
     "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "conventional-changelog-cli": "^5.0.0",
+    "fast-check": "^4.5.3",
     "lightweight-charts": "^5.0.8",
     "react": "^19.1.0",
     "rollup": "^4.46.2",
     "rollup-cli": "^1.0.9",
-    "typescript": "^5.8.3"
+    "rollup-plugin-visualizer": "^6.0.5",
+    "typedoc": "^0.28.16",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
   }
 }

package/dist/types/alpaca-functions.d.ts

@@ -1,233 +0,0 @@
-import { types } from '@adaptic/backend-legacy';
-import { AccountConfiguration, AlpacaPosition, SimpleNews, CreateOrderParams, GetOrdersParams, AlpacaOrder, ReplaceOrderParams, AlpacaAuth, AlpacaAccountDetails, PortfolioHistoryResponse, FetchPortfolioHistoryProps, AlpacaAsset, DataFeed, LatestQuotesResponse } from './types/alpaca-types';
-import { ApolloClientType, NormalizedCacheObject } from '@adaptic/backend-legacy';
-/**
- * Creates a new order in Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {CreateOrderParams} params - The parameters for creating the order.
- * @returns {Promise<Order>} The created order.
- */
-export declare function createOrder(auth: AlpacaAuth, params: CreateOrderParams): Promise<AlpacaOrder>;
-/**
- * Retrieves a list of orders from Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {GetOrdersParams} [params={}] - The parameters for fetching orders.
- * @returns {Promise<AlpacaOrder[]>} The list of orders.
- */
-export declare function getOrders(auth: AlpacaAuth, params?: GetOrdersParams): Promise<AlpacaOrder[]>;
-/**
- * Cancels all orders in Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @returns {Promise<{ id: string; status: number }[]>} The list of canceled orders with their statuses.
- */
-export declare function cancelAllOrders(auth: AlpacaAuth): Promise<{
-    id: string;
-    status: number;
-}[]>;
-/**
- * Retrieves a specific order from Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {string} orderId - The ID of the order to retrieve.
- * @param {boolean} [nested] - Whether to include nested details.
- * @returns {Promise<Order>} The requested order.
- */
-export declare function getOrder(auth: AlpacaAuth, orderId: string, nested?: boolean): Promise<AlpacaOrder>;
-/**
- * Replaces an existing order in Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {string} orderId - The ID of the order to replace.
- * @param {ReplaceOrderParams} params - The parameters for replacing the order.
- * @returns {Promise<Order>} The updated order.
- */
-export declare function replaceOrder(auth: AlpacaAuth, orderId: string, params: ReplaceOrderParams): Promise<AlpacaOrder>;
-/**
- * Cancels a specific order in Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {string} orderId - The ID of the order to cancel.
- * @returns {Promise<{ success: boolean; message?: string }>} - Success status and optional message if order not found.
- */
-export declare function cancelOrder(auth: AlpacaAuth, orderId: string): Promise<{
-    success: boolean;
-    message?: string;
-}>;
-/**
- * Fetches news articles from Alpaca API for specified symbols.
- * @param {string} symbols - The symbols to fetch news for (comma-separated for multiple symbols, e.g. "AAPL,MSFT,GOOG")
- * @param {Object} params - Optional parameters for fetching news
- * @param {AlpacaAuth} params.auth - Optional Alpaca authentication details
- * @param {Date | string} params.start - Start date for fetching news (default is last 24 hours)
- * @param {Date | string} params.end - End date for fetching news (default is now)
- * @param {number} params.limit - Maximum number of articles to return (default is 10)
- * @param {'asc' | 'desc'} params.sort - Sorting order (default is descending)
- * @param {string} params.page_token - Token for pagination
- * @param {boolean} params.include_content - Whether to include content in the news articles (default is true)
- * @returns {Promise<{ news: SimpleNews[]; nextPageToken?: string }>} The fetched news articles.
- */
-export declare function fetchNews(symbols: string, params?: {
-    auth?: AlpacaAuth;
-    start?: Date | string;
-    end?: Date | string;
-    limit?: number;
-    sort?: 'asc' | 'desc';
-    page_token?: string;
-    include_content?: boolean;
-}): Promise<{
-    news: SimpleNews[];
-    nextPageToken?: string;
-}>;
-export interface FetchAccountDetailsProps {
-    auth?: AlpacaAuth;
-    accountId?: string;
-    client?: ApolloClientType<NormalizedCacheObject>;
-    alpacaAccount?: types.AlpacaAccount;
-}
-/**
- * Fetches account details from Alpaca API.
- * @param {FetchAccountDetailsProps} props - The properties for fetching account details.
- * @returns {Promise<AlpacaAccountDetails>} The account details.
- */
-export declare function fetchAccountDetails({ accountId, client, alpacaAccount, auth }: FetchAccountDetailsProps): Promise<AlpacaAccountDetails>;
-/**
- * Fetches portfolio history for one Alpaca account.
- * @param {FetchPortfolioHistoryProps} props - The properties for fetching portfolio history.
- * @returns {Promise<PortfolioHistoryResponse>} The portfolio history.
- */
-/** Fetches portfolio history for one Alpaca account, as stored in Adaptic backend
-*/
-export declare function fetchPortfolioHistory({ params, accountId, client, alpacaAccount }: FetchPortfolioHistoryProps): Promise<PortfolioHistoryResponse>;
-/**
- * Fetches all positions for an Alpaca trading account.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @returns {Promise<AlpacaPosition[]>} The list of positions.
- */
-export declare function fetchAllPositions(auth: AlpacaAuth): Promise<AlpacaPosition[]>;
-/**
- * Fetches a specific position for an Alpaca account.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {string} symbolOrAssetId - The symbol or asset ID to fetch the position for.
- * @returns {Promise<{ position: AlpacaPosition | null; message?: string }>} The position details or null with message if not found.
- */
-export declare function fetchPosition(auth: AlpacaAuth, symbolOrAssetId: string): Promise<{
-    position: AlpacaPosition | null;
-    message?: string;
-}>;
-/**
- * Closes a specific position in Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {string} symbolOrAssetId - The symbol or asset ID of the position to close.
- * @param {Object} [params] - Optional parameters for closing the position.
- * @param {number} [params.qty] - Quantity of shares to close (up to 9 decimal places).
- * @param {number} [params.percentage] - Percentage of position to close (0-100, up to 9 decimal places).
- * @param {boolean} [params.useLimitOrder] - Whether to use a limit order to close the position.
- * @param {boolean} [params.cancelOrders] - Whether to cancel open orders for the symbol before closing.
- * @param {number} [params.slippagePercent1] - Slippage percentage for limit orders (default: 0.1).
- * @param {boolean} [params.extendedHours] - Whether to enable extended hours trading (default: false).
- * @returns {Promise<AlpacaOrder>} The order created to close the position.
- */
-export declare function closePosition(auth: AlpacaAuth, symbolOrAssetId: string, params?: {
-    qty?: number;
-    percentage?: number;
-    useLimitOrder?: boolean;
-    cancelOrders?: boolean;
-    slippagePercent1?: number;
-    extendedHours?: boolean;
-}): Promise<AlpacaOrder>;
-export declare function makeRequest(auth: AlpacaAuth, params: {
-    endpoint: string;
-    method: string;
-    body?: any;
-    queryString?: string;
-    apiBaseUrl?: string;
-}): Promise<any>;
-/**
- * Create a limit order
- * @param symbol (string) - the symbol of the order
- * @param qty (number) - the quantity of the order
- * @param side (string) - the side of the order
- * @param limitPrice (number) - the limit price of the order
- * @param position_intent (string) - the position intent of the order
- * @param extended_hours (boolean) - whether the order is in extended hours
- * @param client_order_id (string) - the client order id of the order
- */
-export declare function createLimitOrder(auth: AlpacaAuth, params?: {
-    symbol: string;
-    qty: number;
-    side: 'buy' | 'sell';
-    limitPrice: number;
-    position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close';
-    extended_hours: boolean;
-    client_order_id?: string;
-}): Promise<AlpacaOrder>;
-/**
- * Closes all positions in Alpaca.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {Object} [params] - Optional parameters for closing all positions.
- * @param {boolean} [params.cancelOrders] - If true, cancels all open orders before closing positions.
- * @param {boolean} [params.useLimitOrders] - If true, uses limit orders to close positions.
- * @returns {Promise<Array<{ symbol: string; status: number; body?: Order }>>} The status of each position closure attempt.
- */
-export declare function closeAllPositions(auth: AlpacaAuth, params?: {
-    cancel_orders?: boolean;
-    useLimitOrders?: boolean;
-    slippagePercent1?: number;
-}): Promise<Array<{
-    symbol: string;
-    status: number;
-    body?: AlpacaOrder;
-}> | void>;
-/**
- * Close all positions using limit orders during extended hours trading
- * @param cancelOrders Whether to cancel related orders (default: true)
- * @returns Promise that resolves when all positions are closed
- */
-/**
- * Closes all positions in Alpaca using limit orders during extended hours trading.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {Object} [params] - Optional parameters for closing all positions.
- * @param {boolean} [params.cancelOrders] - If true, cancels all open orders before closing positions.
- * @returns {Promise<Array<{ symbol: string; status: number; body?: Order }>>} The status of each position closure attempt.
- */
-export declare function closeAllPositionsAfterHours(auth: AlpacaAuth, params?: {
-    cancel_orders?: boolean;
-    slippagePercent1?: number;
-}): Promise<Array<{
-    symbol: string;
-    status: number;
-    body?: AlpacaOrder;
-}> | void>;
-/**
-  * Get the most recent quotes for requested symbols
-  * @param symbols Array of stock symbols to query
-  * @param feed Optional data source (sip/iex/delayed_sip)
-  * @param currency Optional currency in ISO 4217 format
-  * @returns Latest quote data for each symbol
-  * @throws Error if request fails or rate limit exceeded
-  */
-export declare function getLatestQuotes(auth: AlpacaAuth, params: {
-    symbols: string[];
-    feed?: DataFeed;
-    currency?: string;
-}): Promise<LatestQuotesResponse>;
-/**
- * Retrieves the configuration for a specific Alpaca account.
- * @param {types.AlpacaAccount} account - The Alpaca account to retrieve the configuration for.
- * @returns {Promise<AccountConfiguration>} The account configuration.
- */
-export declare function getConfiguration(account: types.AlpacaAccount): Promise<AccountConfiguration>;
-/**
- * Updates the configuration for a specific Alpaca account.
- * @param {types.User} user - The user making the update.
- * @param {types.AlpacaAccount} account - The Alpaca account to update.
- * @param {AccountConfiguration} updatedConfig - The updated configuration.
- * @returns {Promise<AccountConfiguration>} The updated account configuration.
- */
-export declare function updateConfiguration(user: types.User, account: types.AlpacaAccount, updatedConfig: AccountConfiguration): Promise<AccountConfiguration>;
-export declare function cleanContent(htmlContent: string): string;
-/**
- * Retrieves an asset from Alpaca by symbol or asset ID.
- * @param {AlpacaAuth} auth - The authentication details for Alpaca.
- * @param {string} symbolOrAssetId - The symbol or asset ID to retrieve.
- * @returns {Promise<Asset>} The requested asset.
- */
-export declare function getAsset(auth: AlpacaAuth, symbolOrAssetId: string): Promise<AlpacaAsset>;
-//# sourceMappingURL=alpaca-functions.d.ts.map

package/dist/types/alpaca-functions.d.ts.map

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