@hype-stack/cli 1.3.5 → 1.4.0

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUnE,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAsS3E"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUnE,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiT3E"}

package/dist/config/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as e, n as t, t as n, u as r } from "../cli-pTQ4lEfV.js";
+import { d as e, n as t, t as n, u as r } from "../cli-C1Bvl6gU.js";
 import { z as i } from "zod";
 import * as a from "@sentry/node";
 //#region src/core/sentry.ts

package/dist/constants/constants.d.ts

@@ -9,9 +9,20 @@ import { CodeEditor } from '../types/types.js';
 export declare const VERSION: string;
 /** `owner/repo` of the template the CLI clones. Also the id it is recorded under in `stack.json`. */
 export declare const TEMPLATE_REPO_SLUG = "BetterTyped/hype-stack";
-/** Branch the template is cloned from when no commit is pinned. */
+/**
+ * Branch the template is cloned from when no release can be resolved. Also what a dev build always
+ * uses, so working from source keeps tracking the template's head.
+ */
 export declare const TEMPLATE_REPO_REF = "main";
 export declare const TEMPLATE_REPO = "gh:BetterTyped/hype-stack";
+/**
+ * Overrides which template revision `create` clones: a tag, a branch, or a sha. This is the lever
+ * for trying a breaking template change end to end before it is released, without touching a
+ * deploy.
+ */
+export declare const TEMPLATE_REF_ENV_KEY = "HYPE_STACK_TEMPLATE_REF";
+/** API path telling the CLI which template release this registry serves packs for. */
+export declare const TEMPLATE_CHANNEL_PATH = "/cli/template-channel";
 export declare const STACK_CONFIG_FILE = "stack.json";
 export declare const SCHEMA_PATH = "/schema/stack.json";
 export declare const DEFAULT_API_URL = "https://api.hype-stack.dev";

package/dist/constants/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,QAAkE,CAAC;AAEvF,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,eAAO,MAAM,aAAa,8BAA6B,CAAC;AAExD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAMhD,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,uGAAuG;AACvG,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,mEAAmE;AACnE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,kDAAkD;AAClD,eAAO,MAAM,eAAe,oCAAoC,CAAC;AAEjE,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,QAAwC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjB,CAAC;AAEX,eAAO,MAAM,aAAa,EAAE,UAAU,EAAuC,CAAC;AAE9E,eAAO,MAAM,cAAc,EAAE,UAAqB,CAAC;AAEnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAOvG;AAED,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,UAAU,YAAY,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAClD,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAYhD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,QAAkE,CAAC;AAEvF,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,eAAO,MAAM,aAAa,8BAA6B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAE9D,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAMhD,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,uGAAuG;AACvG,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,mEAAmE;AACnE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAErE,kDAAkD;AAClD,eAAO,MAAM,eAAe,oCAAoC,CAAC;AAEjE,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,QAAwC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjB,CAAC;AAEX,eAAO,MAAM,aAAa,EAAE,UAAU,EAAuC,CAAC;AAE9E,eAAO,MAAM,cAAc,EAAE,UAAqB,CAAC;AAEnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAOvG;AAED,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,UAAU,YAAY,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAClD,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAYhD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/core/clone.d.ts

@@ -1,3 +1,4 @@
+import { TemplateRefSource } from './template-channel.js';
 export interface CloneResult {
     dir: string;
     source: string;
@@ -7,6 +8,10 @@ export interface CloneResult {
      * what a later upgrade of the template itself has to diff against.
      */
     commit: string | null;
+    /** The ref that was cloned: a release tag, a branch, or a sha. */
+    ref: string;
+    /** How the ref was chosen. See {@link resolveTemplateRef}. */
+    refSource: TemplateRefSource;
 }
 /**
  * Ask GitHub for the commit a ref currently points at. `Accept: application/vnd.github.sha` makes
@@ -20,10 +25,13 @@ export declare function resolveTemplateCommit(ref?: string): Promise<string | nu
 /**
  * Clone the Hype Stack template into `targetDir`.
  *
- * The clone is pinned to a resolved commit rather than to the branch, so the sha written into
- * `stack.json` is exactly the tree on disk. Resolving and then cloning `main` separately would leave
- * a window where a push lands between the two calls and the project records a commit it never had.
- * When the sha cannot be resolved, fall back to the branch: an unrecorded commit beats no project.
+ * Which revision gets cloned is decided by {@link resolveTemplateRef}: a released CLI takes the
+ * release the registry serves packs for, a dev build takes `main`.
+ *
+ * The clone is then pinned to a resolved commit rather than to the ref, so the sha written into
+ * `stack.json` is exactly the tree on disk. Resolving and then cloning the ref separately would
+ * leave a window where a push lands between the two calls and the project records a commit it never
+ * had. When the sha cannot be resolved, fall back to the ref: an unrecorded commit beats no project.
  */
 export declare function cloneTemplate(targetDir: string): Promise<CloneResult>;
 //# sourceMappingURL=clone.d.ts.map

package/dist/core/clone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/core/clone.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,GAAE,MAA0B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASnG;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAa3E"}
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/core/clone.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iBAAiB,EAAsB,MAAM,uBAAuB,CAAC;AAEnF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAID;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,GAAE,MAA0B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASnG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E"}

package/dist/core/template-channel.d.ts

@@ -0,0 +1,24 @@
+/** Where the answer came from. Reported so `create` can say why it cloned what it cloned. */
+export type TemplateRefSource = "env" | "dev" | "api" | "github-tag" | "default";
+export interface TemplateChannel {
+    /** Ref to clone: a tag (`v1.4.0`), a branch, or a sha. */
+    ref: string;
+    source: TemplateRefSource;
+}
+/**
+ * Which revision of the template `create` should clone.
+ *
+ * A released CLI clones a tagged release, which is what makes `main` usable as a workspace: a
+ * breaking change can sit there for a week without a single user seeing it. A dev build keeps
+ * cloning `main`, so working from source still tests the template as it is right now.
+ *
+ * Every lookup is best-effort. Nobody should fail to create a project because a metadata endpoint
+ * was down, so each step falls through to the next and the last one needs no network at all.
+ */
+export declare function resolveTemplateRef(): Promise<TemplateChannel>;
+/**
+ * Whether a ref names a release rather than a moving branch. Only a release is worth recording as
+ * the project's template version: "main" would age into a lie the moment the branch moves.
+ */
+export declare function isReleaseRef(ref: string): boolean;
+//# sourceMappingURL=template-channel.d.ts.map

package/dist/core/template-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-channel.d.ts","sourceRoot":"","sources":["../../src/core/template-channel.ts"],"names":[],"mappings":"AASA,6FAA6F;AAC7F,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AA+DD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAanE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, o as i, r as a, s as o, t as s } from "./cli-pTQ4lEfV.js";
+import { a as e, c as t, i as n, l as r, o as i, r as a, s as o, t as s } from "./cli-C1Bvl6gU.js";
 export { i as composeCommand, r as createCommand, s as createProgram, e as deployCommand, o as ensureInit, t as initCommand, n as loginCommand, a as logoutCommand };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hype-stack/cli",
-  "version": "1.3.5",
+  "version": "1.4.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",