@hyperfixation/cli 0.1.0 → 0.1.2

package/dist/template-source.d.ts

@@ -1,5 +1,7 @@
 /** Points `hf new` at a template checkout; what a CI job or a second checkout sets. */
 export declare const TEMPLATE_DIR_ENV = "HF_TEMPLATE_DIR";
+/** What a cloud `hf new` fetches when `--from` is absent; giget's `gh:` provider resolves it. */
+export declare const TEMPLATE_REPOSITORY = "gh:grahamlutz/hyperfixation-template";
 /**
  * Where `hf new --local` looks when `--from` is not given: the environment, then the sibling
  * checkout beside the working directory, then the sibling beside this package's own repo.
@@ -14,3 +16,24 @@ export declare const TEMPLATE_DIR_ENV = "HF_TEMPLATE_DIR";
 export declare function findTemplateSource(cwd?: string): Promise<string | undefined>;
 /** The same search, but a miss is the error the user has to act on rather than `undefined`. */
 export declare function requireTemplateSource(cwd?: string): Promise<string>;
+/** giget's `downloadTemplate`, narrowed to what `fetchTemplate` asks of it so a test can be one. */
+export type TemplateDownload = (source: string, options: {
+    dir: string;
+    force: boolean;
+}) => Promise<{
+    dir: string;
+}>;
+export interface FetchTemplateOptions {
+    /** Replaces the real download; the tests never reach the network. */
+    download?: TemplateDownload;
+}
+/**
+ * Fetches the template into `dir` — the cloud path's counterpart to `requireTemplateSource`.
+ *
+ * `source` is a giget specifier (`gh:owner/repo`, optionally `#ref`), defaulting to
+ * `TEMPLATE_REPOSITORY`; `--from` passes whatever the operator typed straight through, so a
+ * branch or a fork needs no flag of its own. What arrives is checked for `TEMPLATE_MARKER`
+ * before `newApp` is let near it: a specifier that resolves to some other repository would
+ * otherwise be copied, substituted and committed as an app.
+ */
+export declare function fetchTemplate(source: string | undefined, dir: string, options?: FetchTemplateOptions): Promise<string>;

package/dist/template-source.js

@@ -1,9 +1,12 @@
 import { stat } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { downloadTemplate } from "giget";
 import { TEMPLATE_MARKER, TemplateError } from "./new.js";
 /** Points `hf new` at a template checkout; what a CI job or a second checkout sets. */
 export const TEMPLATE_DIR_ENV = "HF_TEMPLATE_DIR";
+/** What a cloud `hf new` fetches when `--from` is absent; giget's `gh:` provider resolves it. */
+export const TEMPLATE_REPOSITORY = "gh:grahamlutz/hyperfixation-template";
 /**
  * Where `hf new --local` looks when `--from` is not given: the environment, then the sibling
  * checkout beside the working directory, then the sibling beside this package's own repo.
@@ -36,6 +39,26 @@ export async function requireTemplateSource(cwd) {
     }
     return found;
 }
+/**
+ * Fetches the template into `dir` — the cloud path's counterpart to `requireTemplateSource`.
+ *
+ * `source` is a giget specifier (`gh:owner/repo`, optionally `#ref`), defaulting to
+ * `TEMPLATE_REPOSITORY`; `--from` passes whatever the operator typed straight through, so a
+ * branch or a fork needs no flag of its own. What arrives is checked for `TEMPLATE_MARKER`
+ * before `newApp` is let near it: a specifier that resolves to some other repository would
+ * otherwise be copied, substituted and committed as an app.
+ */
+export async function fetchTemplate(source, dir, options = {}) {
+    const specifier = source ?? TEMPLATE_REPOSITORY;
+    const download = options.download ?? defaultDownload;
+    const target = path.resolve(dir);
+    const { dir: fetched } = await download(specifier, { dir: target, force: true });
+    if (!(await isTemplate(fetched))) {
+        throw new TemplateError(`${specifier} has no ${TEMPLATE_MARKER}: it is not the hyperfixation template`);
+    }
+    return fetched;
+}
+const defaultDownload = async (source, options) => await downloadTemplate(source, { ...options, silent: true });
 async function isTemplate(dir) {
     try {
         return (await stat(path.join(dir, TEMPLATE_MARKER))).isFile();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixation/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "MIT",
   "description": "The hf binary and its Turborepo generator templates",
   "repository": {
@@ -29,17 +29,20 @@
     "!dist/test-support/**"
   ],
   "dependencies": {
-    "@hyperfixation/auth": "0.1.0",
-    "@hyperfixation/core": "0.1.0",
-    "@hyperfixation/db": "0.1.0",
+    "@hyperfixation/auth": "0.1.2",
+    "@hyperfixation/core": "0.1.2",
+    "@hyperfixation/db": "0.1.2",
+    "giget": "3.3.1",
     "pg": "^8.23.0"
   },
   "devDependencies": {
-    "@hyperfixation/eslint-config": "0.1.0",
-    "@hyperfixation/testing": "0.1.0",
+    "@hyperfixation/eslint-config": "0.1.2",
+    "@hyperfixation/testing": "0.1.2",
     "@microsoft/api-extractor": "^7.59.1",
     "@types/pg": "^8.23.1",
-    "eslint": "^10.10.0"
+    "eslint": "^10.10.0",
+    "msw": "2.15.0",
+    "openapi-request-validator": "12.1.3"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",