rastack 0.0.36 → 0.0.37

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.37](https://github.com/theserverkid/reactapistack/compare/v0.0.36...v0.0.37) (2026-07-11)
+
 ### [0.0.36](https://github.com/theserverkid/reactapistack/compare/v0.0.35...v0.0.36) (2026-07-11)
 
 ### [0.0.35](https://github.com/theserverkid/reactapistack/compare/v0.0.34...v0.0.35) (2026-07-11)

package/dist/deploy/config.d.ts

@@ -64,7 +64,7 @@ export interface DeployConfig {
     resourcesDir: string;
     /** Where `rastack compile` writes the manifest + OpenAPI. */
     outDir: string;
-    /** Bootstrap templates bucket that hosts `app.yaml` (for the launch command). */
+    /** Bootstrap templates bucket that hosts `app.yaml` (recorded for reference). */
     templatesBucket?: string;
     /** Bootstrap artifacts bucket holding the Lambda placeholder bundle. */
     artifactsBucket?: string;
@@ -115,8 +115,6 @@ export interface StackParameter {
  * `ArtifactsBucket` (which has no template default) is included only when set.
  */
 export declare function stackParameters(cfg: DeployConfig): StackParameter[];
-/** The S3 URL app.yaml is launched from, when the templates bucket is known. */
-export declare function templateUrl(cfg: DeployConfig): string | null;
 /** The in-repo CloudFormation templates `rastack init` deploys from. */
 export declare const APP_TEMPLATE_FILE = "deploy/cloudformation/app.yaml";
 export declare const BOOTSTRAP_TEMPLATE_FILE = "deploy/cloudformation/bootstrap.yaml";
@@ -124,9 +122,8 @@ export declare const BOOTSTRAP_TEMPLATE_FILE = "deploy/cloudformation/bootstrap.
 export declare function deployStackArgs(cfg: DeployConfig): string[];
 /**
  * The one-time `aws cloudformation deploy` command that creates the app's
- * infrastructure (app.yaml). Launched from the hosted template URL when the
- * templates bucket is known, else from the in-repo `app.yaml`. `rastack init`
- * runs this for you; it is also printed by `--print` so it can be run by hand.
+ * infrastructure (app.yaml), from the in-repo template. `rastack init` runs this
+ * for you; it is also printed by `--print` so it can be run by hand.
  */
 export declare function deployStackCommand(cfg: DeployConfig): string;
 /**

package/dist/deploy/config.js

@@ -24,7 +24,6 @@ exports.validateConfig = validateConfig;
 exports.mergeConfig = mergeConfig;
 exports.parseGitHubRemote = parseGitHubRemote;
 exports.stackParameters = stackParameters;
-exports.templateUrl = templateUrl;
 exports.deployStackArgs = deployStackArgs;
 exports.deployStackCommand = deployStackCommand;
 exports.bootstrapStackName = bootstrapStackName;
@@ -168,12 +167,6 @@ function stackParameters(cfg) {
         params.push({ key: "ArtifactsBucket", value: cfg.artifactsBucket });
     return params;
 }
-/** The S3 URL app.yaml is launched from, when the templates bucket is known. */
-function templateUrl(cfg) {
-    if (!cfg.templatesBucket)
-        return null;
-    return `https://${cfg.templatesBucket}.s3.${cfg.region}.amazonaws.com/app.yaml`;
-}
 /** The in-repo CloudFormation templates `rastack init` deploys from. */
 exports.APP_TEMPLATE_FILE = "deploy/cloudformation/app.yaml";
 exports.BOOTSTRAP_TEMPLATE_FILE = "deploy/cloudformation/bootstrap.yaml";
@@ -181,15 +174,19 @@ exports.BOOTSTRAP_TEMPLATE_FILE = "deploy/cloudformation/bootstrap.yaml";
  * The argv (after `aws`) for an `aws cloudformation deploy`. `init` feeds this to
  * `execFileSync` (no shell), and the printed command string is just this joined
  * with spaces — so what is shown is exactly what runs.
+ *
+ * Always `--template-file`: the high-level `aws cloudformation deploy` command
+ * accepts *only* a local template file. `--template-url` is exclusive to the
+ * low-level `create-stack`/`update-stack`/`create-change-set` commands, so
+ * pairing it with `deploy` fails with `the following arguments are required:
+ * --template-file`. `init` runs in the repo, where both templates are present.
  */
-function cfnDeployArgs(template, stackName, region, params) {
-    const t = template.url
-        ? ["--template-url", template.url]
-        : ["--template-file", template.file];
+function cfnDeployArgs(templateFile, stackName, region, params) {
     return [
         "cloudformation",
         "deploy",
-        ...t,
+        "--template-file",
+        templateFile,
         "--stack-name",
         stackName,
         "--capabilities",
@@ -212,14 +209,12 @@ function awsCommand(args) {
 }
 /** The argv that creates the app's infrastructure (app.yaml). */
 function deployStackArgs(cfg) {
-    const src = templateUrl(cfg);
-    return cfnDeployArgs(src ? { url: src } : { file: exports.APP_TEMPLATE_FILE }, cfg.stackName, cfg.region, stackParameters(cfg));
+    return cfnDeployArgs(exports.APP_TEMPLATE_FILE, cfg.stackName, cfg.region, stackParameters(cfg));
 }
 /**
  * The one-time `aws cloudformation deploy` command that creates the app's
- * infrastructure (app.yaml). Launched from the hosted template URL when the
- * templates bucket is known, else from the in-repo `app.yaml`. `rastack init`
- * runs this for you; it is also printed by `--print` so it can be run by hand.
+ * infrastructure (app.yaml), from the in-repo template. `rastack init` runs this
+ * for you; it is also printed by `--print` so it can be run by hand.
  */
 function deployStackCommand(cfg) {
     return awsCommand(deployStackArgs(cfg));
@@ -251,7 +246,7 @@ function bootstrapStackParameters(cfg, reuseOidc = false) {
 }
 /** The argv that creates the bootstrap stack (bootstrap.yaml). */
 function bootstrapStackArgs(cfg, reuseOidc = false) {
-    return cfnDeployArgs({ file: exports.BOOTSTRAP_TEMPLATE_FILE }, bootstrapStackName(cfg), cfg.region, bootstrapStackParameters(cfg, reuseOidc));
+    return cfnDeployArgs(exports.BOOTSTRAP_TEMPLATE_FILE, bootstrapStackName(cfg), cfg.region, bootstrapStackParameters(cfg, reuseOidc));
 }
 /** The one-time `aws cloudformation deploy` command that creates the bootstrap stack. */
 function bootstrapStackCommand(cfg, reuseOidc = false) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rastack",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "description": "",
   "main": "runtime.ts",
   "types": "runtime.ts",

package/src/deploy/config.ts

@@ -63,7 +63,7 @@ export interface DeployConfig {
   resourcesDir: string;
   /** Where `rastack compile` writes the manifest + OpenAPI. */
   outDir: string;
-  /** Bootstrap templates bucket that hosts `app.yaml` (for the launch command). */
+  /** Bootstrap templates bucket that hosts `app.yaml` (recorded for reference). */
   templatesBucket?: string;
   /** Bootstrap artifacts bucket holding the Lambda placeholder bundle. */
   artifactsBucket?: string;
@@ -246,12 +246,6 @@ export function stackParameters(cfg: DeployConfig): StackParameter[] {
   return params;
 }
 
-/** The S3 URL app.yaml is launched from, when the templates bucket is known. */
-export function templateUrl(cfg: DeployConfig): string | null {
-  if (!cfg.templatesBucket) return null;
-  return `https://${cfg.templatesBucket}.s3.${cfg.region}.amazonaws.com/app.yaml`;
-}
-
 /** The in-repo CloudFormation templates `rastack init` deploys from. */
 export const APP_TEMPLATE_FILE = "deploy/cloudformation/app.yaml";
 export const BOOTSTRAP_TEMPLATE_FILE = "deploy/cloudformation/bootstrap.yaml";
@@ -260,20 +254,24 @@ export const BOOTSTRAP_TEMPLATE_FILE = "deploy/cloudformation/bootstrap.yaml";
  * The argv (after `aws`) for an `aws cloudformation deploy`. `init` feeds this to
  * `execFileSync` (no shell), and the printed command string is just this joined
  * with spaces — so what is shown is exactly what runs.
+ *
+ * Always `--template-file`: the high-level `aws cloudformation deploy` command
+ * accepts *only* a local template file. `--template-url` is exclusive to the
+ * low-level `create-stack`/`update-stack`/`create-change-set` commands, so
+ * pairing it with `deploy` fails with `the following arguments are required:
+ * --template-file`. `init` runs in the repo, where both templates are present.
  */
 function cfnDeployArgs(
-  template: { file?: string; url?: string },
+  templateFile: string,
   stackName: string,
   region: string,
   params: StackParameter[],
 ): string[] {
-  const t = template.url
-    ? ["--template-url", template.url]
-    : ["--template-file", template.file!];
   return [
     "cloudformation",
     "deploy",
-    ...t,
+    "--template-file",
+    templateFile,
     "--stack-name",
     stackName,
     "--capabilities",
@@ -298,9 +296,8 @@ function awsCommand(args: string[]): string {
 
 /** The argv that creates the app's infrastructure (app.yaml). */
 export function deployStackArgs(cfg: DeployConfig): string[] {
-  const src = templateUrl(cfg);
   return cfnDeployArgs(
-    src ? { url: src } : { file: APP_TEMPLATE_FILE },
+    APP_TEMPLATE_FILE,
     cfg.stackName,
     cfg.region,
     stackParameters(cfg),
@@ -309,9 +306,8 @@ export function deployStackArgs(cfg: DeployConfig): string[] {
 
 /**
  * The one-time `aws cloudformation deploy` command that creates the app's
- * infrastructure (app.yaml). Launched from the hosted template URL when the
- * templates bucket is known, else from the in-repo `app.yaml`. `rastack init`
- * runs this for you; it is also printed by `--print` so it can be run by hand.
+ * infrastructure (app.yaml), from the in-repo template. `rastack init` runs this
+ * for you; it is also printed by `--print` so it can be run by hand.
  */
 export function deployStackCommand(cfg: DeployConfig): string {
   return awsCommand(deployStackArgs(cfg));
@@ -352,7 +348,7 @@ export function bootstrapStackArgs(
   reuseOidc = false,
 ): string[] {
   return cfnDeployArgs(
-    { file: BOOTSTRAP_TEMPLATE_FILE },
+    BOOTSTRAP_TEMPLATE_FILE,
     bootstrapStackName(cfg),
     cfg.region,
     bootstrapStackParameters(cfg, reuseOidc),

package/test/deploy.spec.ts

@@ -19,7 +19,6 @@ import {
   repoVariables,
   scaffoldFiles,
   stackParameters,
-  templateUrl,
   validateConfig,
   zipStore,
   renderCiWorkflow,
@@ -187,25 +186,21 @@ describe("stack parameters + launch command", () => {
     );
   });
 
-  it("builds the template URL only when the templates bucket is known", () => {
-    expect(templateUrl(base())).toBeNull();
-    expect(templateUrl(base({ templatesBucket: "tpl" }))).toBe(
-      "https://tpl.s3.af-south-1.amazonaws.com/app.yaml",
-    );
-  });
-
-  it("launches by URL when hosted, else from the in-repo template", () => {
+  it("always launches from the in-repo --template-file (deploy takes no URL)", () => {
+    // `aws cloudformation deploy` accepts ONLY `--template-file`; `--template-url`
+    // is exclusive to create-stack/update-stack and makes deploy reject the
+    // command. Even with a known templates bucket, the local file is used.
     const hosted = deployStackCommand(
       base({ templatesBucket: "tpl", artifactsBucket: "art" }),
     );
-    expect(hosted).toContain(
-      "--template-url https://tpl.s3.af-south-1.amazonaws.com/app.yaml",
-    );
+    expect(hosted).toContain("--template-file deploy/cloudformation/app.yaml");
+    expect(hosted).not.toContain("--template-url");
     expect(hosted).toContain("--stack-name rastack-airline");
     expect(hosted).toContain("ArtifactsBucket=art");
 
     const local = deployStackCommand(base());
     expect(local).toContain("--template-file deploy/cloudformation/app.yaml");
+    expect(local).not.toContain("--template-url");
   });
 
   it("emits ONE line (PowerShell-safe — no backslash continuations)", () => {