stacktape 3.2.0-beta.10 → 3.2.0-beta.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stacktape",
-  "version": "3.2.0-beta.10",
+  "version": "3.2.0-beta.12",
   "description": "PaaS 2.0 that deploys to your own AWS account.",
   "author": "Stacktape team <support@stacktape.com>",
   "license": "MIT",

package/sdk.d.ts

@@ -5,6 +5,7 @@ export type LoggableEventType =
   | "ANALYZE_PROJECT"
   | "ASSUME_ROLE"
   | "BUILD_CODE"
+  | "BUILD_HOSTING_BUCKET"
   | "BUILD_IMAGE"
   | "BUILD_NEXTJS_PROJECT"
   | "BUILD_SHARED_LAYER"
@@ -7026,6 +7027,7 @@ export interface RelationalDatabaseProps {
    */
   disabledGlobalAlarms?: string[];
   logging?: RelationalDatabaseLogging;
+  dev?: DevModeConfig;
 }
 /**
  * #### Configures the credentials for the database's master user.
@@ -7896,6 +7898,27 @@ export interface MysqlLoggingOptions {
    */
   long_query_time?: number;
 }
+/**
+ * #### Dev Mode Configuration
+ *
+ * ---
+ *
+ * Configures how this database behaves during `stacktape dev` mode.
+ * By default, databases run locally using Docker. Set `dev.remote: true` to connect to the deployed AWS database instead.
+ */
+export interface DevModeConfig {
+  /**
+   * #### Use Remote Resource
+   *
+   * ---
+   *
+   * If `true`, connects to the deployed AWS resource instead of running a local emulation during dev mode.
+   *
+   * By default, databases (RDS, Aurora), Redis clusters, and DynamoDB tables run locally during dev mode.
+   * Set this to `true` to use the deployed AWS resource instead.
+   */
+  remote?: boolean;
+}
 /**
  * #### Application Load Balancer
  *
@@ -10596,6 +10619,7 @@ export interface DynamoDbTableProps {
    * For more details, see the [AWS documentation on secondary indexes](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html).
    */
   secondaryIndexes?: DynamoDbTableGlobalSecondaryIndex[];
+  dev?: DevModeConfig1;
 }
 /**
  * #### Configures the primary key for the table.
@@ -10813,6 +10837,27 @@ export interface DynamoDbAttribute3 {
    */
   type: "binary" | "number" | "string";
 }
+/**
+ * #### Dev Mode Configuration
+ *
+ * ---
+ *
+ * Configures how this DynamoDB table behaves during `stacktape dev` mode.
+ * By default, DynamoDB runs locally using Docker. Set `dev.remote: true` to connect to the deployed AWS DynamoDB table instead.
+ */
+export interface DevModeConfig1 {
+  /**
+   * #### Use Remote Resource
+   *
+   * ---
+   *
+   * If `true`, connects to the deployed AWS resource instead of running a local emulation during dev mode.
+   *
+   * By default, databases (RDS, Aurora), Redis clusters, and DynamoDB tables run locally during dev mode.
+   * Set this to `true` to use the deployed AWS resource instead.
+   */
+  remote?: boolean;
+}
 /**
  * #### State Machine
  *
@@ -11493,6 +11538,7 @@ export interface RedisClusterProps {
    * ---
    */
   engineVersion?: "6.0" | "6.2" | "7.0" | "7.1";
+  dev?: DevModeConfig2;
 }
 /**
  * #### Configures the logging behavior and format.
@@ -11561,6 +11607,27 @@ export interface RedisAccessibility {
    */
   accessibilityMode: "scoping-workloads-in-vpc" | "vpc";
 }
+/**
+ * #### Dev Mode Configuration
+ *
+ * ---
+ *
+ * Configures how this Redis cluster behaves during `stacktape dev` mode.
+ * By default, Redis runs locally using Docker. Set `dev.remote: true` to connect to the deployed AWS Redis cluster instead.
+ */
+export interface DevModeConfig2 {
+  /**
+   * #### Use Remote Resource
+   *
+   * ---
+   *
+   * If `true`, connects to the deployed AWS resource instead of running a local emulation during dev mode.
+   *
+   * By default, databases (RDS, Aurora), Redis clusters, and DynamoDB tables run locally during dev mode.
+   * Set this to `true` to use the deployed AWS resource instead.
+   */
+  remote?: boolean;
+}
 /**
  * #### Custom resource instance
  *
@@ -12842,6 +12909,8 @@ export interface HostingBucketProps {
    * The contents of this folder will be uploaded to the bucket during the `deploy`, `codebuild:deploy`, or `bucket:sync` commands.
    */
   uploadDirectoryPath: string;
+  build?: HostingBucketBuild;
+  dev?: HostingBucketBuild1;
   /**
    * #### Glob patterns for files to be excluded from the upload.
    *
@@ -12960,6 +13029,72 @@ export interface HostingBucketProps {
    */
   routeRewrites?: CdnRouteRewrite[];
 }
+/**
+ * #### Build configuration for the hosting bucket.
+ *
+ * ---
+ *
+ * Configures the build process that produces the files to upload. The build runs during the packaging phase, in parallel with other packaging jobs.
+ *
+ * Supports common frontend build tools like Vite, Webpack, Angular CLI, Vue CLI, Create React App, and SvelteKit.
+ * Build output is parsed to display meaningful information (e.g., bundle size) in the deployment logs.
+ */
+export interface HostingBucketBuild {
+  /**
+   * #### The command to execute.
+   *
+   * ---
+   *
+   * Examples:
+   * - `npm run build`
+   * - `bun run build`
+   * - `vite build`
+   * - `webpack --mode production`
+   */
+  command: string;
+  /**
+   * #### The working directory for the command.
+   *
+   * ---
+   *
+   * Relative to the project root. Defaults to the project root.
+   */
+  workingDirectory?: string;
+}
+/**
+ * #### Dev server configuration for the hosting bucket.
+ *
+ * ---
+ *
+ * Configures the dev server process for local development. Used by the `dev` command.
+ *
+ * Example commands:
+ * - `npm run dev`
+ * - `vite`
+ * - `webpack serve`
+ */
+export interface HostingBucketBuild1 {
+  /**
+   * #### The command to execute.
+   *
+   * ---
+   *
+   * Examples:
+   * - `npm run build`
+   * - `bun run build`
+   * - `vite build`
+   * - `webpack --mode production`
+   */
+  command: string;
+  /**
+   * #### The working directory for the command.
+   *
+   * ---
+   *
+   * Relative to the project root. Defaults to the project root.
+   */
+  workingDirectory?: string;
+}
 /**
  * #### Configures Edge function triggers.
  *
@@ -13423,6 +13558,27 @@ export interface NextjsWebProps {
    * If you have a custom build process, you can specify the command here.
    */
   buildCommand?: string;
+  /**
+   * #### Dev server configuration for local development.
+   *
+   * ---
+   *
+   * Configures the dev server process for local development. Used by the `dev` command.
+   *
+   * If not specified, defaults to `next dev` in the app directory.
+   */
+  dev?: {
+    /**
+     * #### The dev server command to execute.
+     *
+     * ---
+     *
+     * Examples:
+     * - `next dev`
+     * - `npm run dev`
+     */
+    command?: string;
+  };
   /**
    * #### Sets custom headers for static files.
    *
@@ -25993,7 +26149,50 @@ declare class Stacktape {
     * 
     * Additional arguments to pass to the `docker run` or `docker build` commands.
     */
-    dockerArgs?: array, onEvent?: (eventData: any) => void, printProgress?: boolean }): Promise<{ eventLog: EventLogEntry[], result: DevReturnValue }>;
+    dockerArgs?: array,
+    /**
+    * #### Remote Resources
+    * 
+    * ---
+    * 
+    * Comma-separated list of resource names that should connect to deployed AWS resources
+    * instead of running locally during dev mode. By default, databases (RDS, Aurora),
+    * Redis, and DynamoDB run locally. Use this flag to connect to the deployed version instead.
+    * 
+    * Example: --remoteResources myDatabase,myRedis
+    */
+    remoteResources?: array,
+    /**
+    * #### Resources
+    * 
+    * ---
+    * 
+    * Specify which resources to run in dev mode. If not provided, an interactive picker is shown.
+    * Use 'all' to run all resources without prompting.
+    * Specify resource names as a comma-separated list or use the flag multiple times.
+    */
+    resources?: array,
+    /**
+    * #### Skip Resources
+    * 
+    * ---
+    * 
+    * Skip the specified resources in dev mode. All other resources will run.
+    * Specify resource names as a comma-separated list or use the flag multiple times.
+    */
+    skipResources?: array,
+    /**
+    * #### Dev Mode
+    * 
+    * ---
+    * 
+    * Specifies which dev mode to use:
+    * - `normal` (default): Deploys a stripped-down "dev stack" to AWS and runs workloads locally.
+    *   Databases and Redis are emulated locally using Docker.
+    * - `legacy`: Requires an already deployed stack. Runs selected workloads locally while
+    *   connecting to all resources in the deployed stack. No local database emulation.
+    */
+    devMode?: 'legacy' | 'normal', onEvent?: (eventData: any) => void, printProgress?: boolean }): Promise<{ eventLog: EventLogEntry[], result: DevReturnValue }>;
 
 
   /**