@rivascva/dt-idl 1.1.192 → 1.1.194

package/dist/index.d.ts

@@ -142,6 +142,23 @@ interface paths$3 {
         patch?: never;
         trace?: never;
     };
+    "/stocks/splits": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Gets the market stock splits */
+        get: operations$3["getStockSplits"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/stocks/search": {
         parameters: {
             query?: never;
@@ -295,6 +312,23 @@ interface components$3 {
             /** @example USA */
             country: string;
         };
+        /** @description An upcoming stock split */
+        StockSplit: {
+            /** @example AAPL */
+            symbol: string;
+            /** @example 2026-05-15 */
+            date: string;
+            /**
+             * Format: double
+             * @example 4
+             */
+            numerator: number;
+            /**
+             * Format: double
+             * @example 1
+             */
+            denominator: number;
+        };
         /** @description A stock history chart entry */
         StockHistoryEntry: {
             /** @example 2024-12-24T02:30:00Z */
@@ -614,6 +648,33 @@ interface operations$3 {
             500: components$3["responses"]["InternalServerError"];
         };
     };
+    getStockSplits: {
+        parameters: {
+            query: {
+                /** @description The stock split from date */
+                from: string;
+                /** @description The stock split to date */
+                to: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components$3["schemas"]["StockSplit"][];
+                };
+            };
+            404: components$3["responses"]["NotFound"];
+            500: components$3["responses"]["InternalServerError"];
+        };
+    };
     getSearchStocks: {
         parameters: {
             query: {
@@ -2135,6 +2196,8 @@ type GetSearchStocksQueryParams = operations$3['getSearchStocks']['parameters'][
 type GetStockHistoryQueryParams = operations$3['getStockHistory']['parameters']['query'];
 type MarketMetadata = MarketServiceSchemas['MarketMetadata'];
 type MarketHours = MarketServiceSchemas['MarketHours'];
+type StockSplit = MarketServiceSchemas['StockSplit'];
+type GetStockSplitsQueryParams = operations$3['getStockSplits']['parameters']['query'];
 type Portfolio = TradeServiceSchemas['Portfolio'];
 type PortfolioType = TradeServiceSchemas['PortfolioType'];
 type UpdatePortfolioPayload = TradeServiceSchemas['UpdatePortfolioPayload'];
@@ -2164,4 +2227,4 @@ type UploadImageResponse = AssetServiceSchemas['UploadImageResponse'];
 type DeleteImagePayload = AssetServiceSchemas['DeleteImagePayload'];
 type AssetServiceError = AssetServiceSchemas['Error'];
 
-export { type AddOrderPayload, type AddUserPayload, type AssetServiceError, type DeleteImagePayload, type FullQuote, type GetIndexesQueryParams, type GetOrdersByPortfolioParams, type GetPortfolioHistoryParams, type GetSearchStocksQueryParams, type GetStockHistoryQueryParams, type GetStocksBySymbolsQueryParams, type Holding, type ImageType, type Index, type LoginWithFirebasePayload, type LogoutPayload, type MarketHours, type MarketMetadata, type MarketServiceError, type NewsArticle, type Order, type OrderType, type Portfolio, type PortfolioHistoryTimeframe, type PortfolioHistoryValue, type PortfolioType, type RefreshAccessTokenPayload, type SendPushNotificationPayload, type SignupWithFirebasePayload, type SimpleQuote, type SortField, type SortOrder, type StockHistoryEntry, type StockHistoryTimeframe, type StockNewsArticle, type SubmitUserFeedbackPayload, type TradeServiceError, type UpdatePortfolioPayload, type UpdateUserDevicePayload, type UpdateUserPayload, type UploadImagePayload, type UploadImageResponse, type User, type UserServiceError, createAssetServiceClient, createMarketServiceClient, createTradeServiceClient, createUserServiceClient, isAssetServiceError, isMarketServiceError, isTradeServiceError, isUserServiceError };
+export { type AddOrderPayload, type AddUserPayload, type AssetServiceError, type DeleteImagePayload, type FullQuote, type GetIndexesQueryParams, type GetOrdersByPortfolioParams, type GetPortfolioHistoryParams, type GetSearchStocksQueryParams, type GetStockHistoryQueryParams, type GetStockSplitsQueryParams, type GetStocksBySymbolsQueryParams, type Holding, type ImageType, type Index, type LoginWithFirebasePayload, type LogoutPayload, type MarketHours, type MarketMetadata, type MarketServiceError, type NewsArticle, type Order, type OrderType, type Portfolio, type PortfolioHistoryTimeframe, type PortfolioHistoryValue, type PortfolioType, type RefreshAccessTokenPayload, type SendPushNotificationPayload, type SignupWithFirebasePayload, type SimpleQuote, type SortField, type SortOrder, type StockHistoryEntry, type StockHistoryTimeframe, type StockNewsArticle, type StockSplit, type SubmitUserFeedbackPayload, type TradeServiceError, type UpdatePortfolioPayload, type UpdateUserDevicePayload, type UpdateUserPayload, type UploadImagePayload, type UploadImageResponse, type User, type UserServiceError, createAssetServiceClient, createMarketServiceClient, createTradeServiceClient, createUserServiceClient, isAssetServiceError, isMarketServiceError, isTradeServiceError, isUserServiceError };

package/docs/deployment.md

@@ -79,6 +79,21 @@ Each service has a `.github/workflows/lambda-deploy.yaml` that triggers on:
 
 Services with asynchronous flows use a **matrix strategy** to deploy multiple Lambda functions from a single workflow run.
 
+### GitHub Access Token (`GH_ACCESS_TOKEN`)
+
+Because `dt-idl` is a private repository, each service repo requires a **GitHub Personal Access Token** (stored as the `GH_ACCESS_TOKEN` secret) to interact with it. This token is used in two contexts:
+
+1. **Local / CI code generation (`make api` & `make clients`)**
+   Each service's Makefile pulls OpenAPI specs from `dt-idl` to generate API handler templates and typed clients. These commands fetch from the private `dt-idl` repo, which requires authenticated access via the token.
+2. **Lambda deploy workflow (private Go module resolution)**
+   During the build step, `go build` needs to download the private `dt-idl` Go modules (e.g., `github.com/RivasCVA/dt-idl/go/...`). The workflow configures Git to embed the token in HTTPS URLs. This allows `go build` to authenticate when fetching the private module.
+
+**Generating the token:**
+
+1. Go to **GitHub > Settings > Developer settings > Personal access tokens > Fine-grained tokens**.
+2. Create a token scoped to the `dt-idl` repository with **Contents: Read** permission.
+3. Add it as a repository secret named `GH_ACCESS_TOKEN` in each service repo (**Settings > Secrets and variables > Actions**).
+
 ### Environment Variables
 
 Each service's environment variables are managed via **GitHub Settings > Secrets and Variables** in its respective repository. The deployment workflow reads these secrets/variables at deploy time and pushes them to the Lambda function configuration.

package/go/models/constants.go

@@ -40,6 +40,106 @@ const (
 	MarketCloseGracePeriod = 2 * time.Minute
 )
 
+var (
+	// MarketHolidays is a map of future market holidays.
+	// The key is the date of the holiday in YYYY-MM-DD format (based on the timezone specified in MarketTimezone).
+	// The value is the information about the holiday.
+	MarketHolidays = map[string]MarketHolidayInfo{
+		"2026-01-01": {
+			Name:      "New Year's Day",
+			CloseTime: "",
+		},
+		"2026-01-19": {
+			Name:      "Martin Luther King, Jr. Day",
+			CloseTime: "",
+		},
+		"2026-02-16": {
+			Name:      "Presidents' Day",
+			CloseTime: "",
+		},
+		"2026-04-03": {
+			Name:      "Good Friday",
+			CloseTime: "",
+		},
+		"2026-05-25": {
+			Name:      "Memorial Day",
+			CloseTime: "",
+		},
+		"2026-06-19": {
+			Name:      "Juneteenth National Independence Day",
+			CloseTime: "",
+		},
+		"2026-07-03": {
+			Name:      "Independence Day (Observed)",
+			CloseTime: "",
+		},
+		"2026-09-07": {
+			Name:      "Labor Day",
+			CloseTime: "",
+		},
+		"2026-11-26": {
+			Name:      "Thanksgiving Day",
+			CloseTime: "",
+		},
+		"2026-11-27": {
+			Name:      "Friday after Thanksgiving",
+			CloseTime: "13:00",
+		},
+		"2026-12-24": {
+			Name:      "Christmas Eve",
+			CloseTime: "13:00",
+		},
+		"2026-12-25": {
+			Name:      "Christmas Day",
+			CloseTime: "",
+		},
+		"2027-01-01": {
+			Name:      "New Year's Day",
+			CloseTime: "",
+		},
+		"2027-01-18": {
+			Name:      "Martin Luther King, Jr. Day",
+			CloseTime: "",
+		},
+		"2027-02-15": {
+			Name:      "Presidents' Day",
+			CloseTime: "",
+		},
+		"2027-03-26": {
+			Name:      "Good Friday",
+			CloseTime: "",
+		},
+		"2027-05-31": {
+			Name:      "Memorial Day",
+			CloseTime: "",
+		},
+		"2027-06-18": {
+			Name:      "Juneteenth National Independence Day (Observed)",
+			CloseTime: "",
+		},
+		"2027-07-05": {
+			Name:      "Independence Day (Observed)",
+			CloseTime: "",
+		},
+		"2027-09-06": {
+			Name:      "Labor Day",
+			CloseTime: "",
+		},
+		"2027-11-25": {
+			Name:      "Thanksgiving Day",
+			CloseTime: "",
+		},
+		"2027-11-26": {
+			Name:      "Friday after Thanksgiving",
+			CloseTime: "13:00",
+		},
+		"2027-12-24": {
+			Name:      "Christmas Day (Observed)",
+			CloseTime: "",
+		},
+	}
+)
+
 var (
 	// PortfolioDefaultCash is the default cash for new portfolios.
 	PortfolioDefaultCash = float64(50000)

package/go/models/structs.go

@@ -0,0 +1,12 @@
+package models
+
+// MarketHolidayInfo contains information about a market holiday.
+type MarketHolidayInfo struct {
+	// Name is the name of the holiday.
+	Name string
+	// CloseTime is the time the market closes on the holiday in a 24-hour format (HH:mm).
+	// Based on the timezone specified in MarketTimezone.
+	// For some holidays, the market may simply close early.
+	// The value will be empty if the market closes the entire day.
+	CloseTime string
+}

package/go/utils/market.go

@@ -66,6 +66,25 @@ func isMarketHoursWithOpenAndCloseOffsets(now time.Time, openOffset time.Duratio
 		return false, fmt.Errorf("unable to parse the close minute: %w", err)
 	}
 
+	// check if on a market holiday
+	if holidayInfo, ok := models.MarketHolidays[now.Format("2006-01-02")]; ok {
+		if holidayInfo.CloseTime == "" {
+			// the market closes the entire day
+			return false, nil
+		} else {
+			// the market closes early, so set the close time to the holiday close time
+			holidayCloseTimeParts := strings.Split(holidayInfo.CloseTime, ":")
+			closeHour, err = strconv.Atoi(holidayCloseTimeParts[0])
+			if err != nil {
+				return false, fmt.Errorf("unable to parse the holiday close hour: %w", err)
+			}
+			closeMinute, err = strconv.Atoi(holidayCloseTimeParts[1])
+			if err != nil {
+				return false, fmt.Errorf("unable to parse the holiday close minute: %w", err)
+			}
+		}
+	}
+
 	// create the open time with the offset
 	openTime := time.Date(now.Year(), now.Month(), now.Day(), openHour, openMinute, 0, 0, loc)
 	openWithOffset := openTime.Add(openOffset)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivascva/dt-idl",
-  "version": "1.1.192",
+  "version": "1.1.194",
   "description": "Dream Trade - Interface Definition Language",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/services/dt-market-service.yaml

@@ -234,6 +234,41 @@ paths:
         500:
           $ref: '#/components/responses/InternalServerError'
 
+  /stocks/splits:
+    get:
+      description: Gets the market stock splits
+      operationId: getStockSplits
+      tags:
+        - Stocks
+      parameters:
+        - in: query
+          name: from
+          description: The stock split from date
+          required: true
+          schema:
+            type: string
+            example: 2026-05-01
+        - in: query
+          name: to
+          description: The stock split to date
+          required: true
+          schema:
+            type: string
+            example: 2026-05-31
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/StockSplit'
+        404:
+          $ref: '#/components/responses/NotFound'
+        500:
+          $ref: '#/components/responses/InternalServerError'
+
   /stocks/search:
     get:
       description: Gets the simple quotes that fuzzy match the search query
@@ -459,6 +494,29 @@ components:
             - state
             - country
 
+    StockSplit:
+      description: An upcoming stock split
+      properties:
+        symbol:
+          type: string
+          example: AAPL
+        date:
+          type: string
+          example: 2026-05-15
+        numerator:
+          type: number
+          format: double
+          example: 4
+        denominator:
+          type: number
+          format: double
+          example: 1
+      required:
+        - symbol
+        - date
+        - numerator
+        - denominator
+
     StockHistoryEntry:
       description: A stock history chart entry
       properties:

package/ts/services/dt-market-service.ts

@@ -140,6 +140,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/stocks/splits": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Gets the market stock splits */
+        get: operations["getStockSplits"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/stocks/search": {
         parameters: {
             query?: never;
@@ -294,6 +311,23 @@ export interface components {
             /** @example USA */
             country: string;
         };
+        /** @description An upcoming stock split */
+        StockSplit: {
+            /** @example AAPL */
+            symbol: string;
+            /** @example 2026-05-15 */
+            date: string;
+            /**
+             * Format: double
+             * @example 4
+             */
+            numerator: number;
+            /**
+             * Format: double
+             * @example 1
+             */
+            denominator: number;
+        };
         /** @description A stock history chart entry */
         StockHistoryEntry: {
             /** @example 2024-12-24T02:30:00Z */
@@ -614,6 +648,33 @@ export interface operations {
             500: components["responses"]["InternalServerError"];
         };
     };
+    getStockSplits: {
+        parameters: {
+            query: {
+                /** @description The stock split from date */
+                from: string;
+                /** @description The stock split to date */
+                to: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StockSplit"][];
+                };
+            };
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["InternalServerError"];
+        };
+    };
     getSearchStocks: {
         parameters: {
             query: {

package/ts/types/types.ts

@@ -31,6 +31,8 @@ export type GetSearchStocksQueryParams = MarketServiceOperations['getSearchStock
 export type GetStockHistoryQueryParams = MarketServiceOperations['getStockHistory']['parameters']['query'];
 export type MarketMetadata = MarketServiceSchemas['MarketMetadata'];
 export type MarketHours = MarketServiceSchemas['MarketHours'];
+export type StockSplit = MarketServiceSchemas['StockSplit'];
+export type GetStockSplitsQueryParams = MarketServiceOperations['getStockSplits']['parameters']['query'];
 
 // Trade Service Types
 export type Portfolio = TradeServiceSchemas['Portfolio'];