@evcraddock/slug-cli 0.6.4 → 0.6.5

package/README.md

@@ -25,7 +25,7 @@ Create a standalone site with:
 slug init ./my-site --name my-site --site-title "My Site"
 ```
 
-Run `slug init --help` for template options. By default, `slug init` downloads the default template zip artifact. `--template-dir` remains available for local template development, `--template-url` supports alternate remote zip artifacts, and `--template` reserves the selection path for future named templates.
+Run `slug init --help` for template options. By default, `slug init` downloads the latest template zip artifact and falls back to the template artifact published with the installed CLI version if the latest artifact is missing. `--template-dir` remains available for local template development, `--template-url` supports alternate remote zip artifacts, and `--template` reserves the selection path for future named templates. Explicit `--template-url` and `SLUGKIT_TEMPLATE_URL` overrides do not fall back.
 
 ## Login and configuration
 

package/dist/commands.js

@@ -155,7 +155,7 @@ Options:
   --json                 Print command output as JSON.
   --help, -h             Show this help.
 
-By default, slug init downloads the default template zip artifact. Set SLUGKIT_TEMPLATE_URL or pass --template-url to use a different zip artifact. Generated sites do not depend on the template artifact at runtime.`;
+By default, slug init downloads the latest template zip artifact and falls back to the CLI-versioned artifact if latest is missing. Set SLUGKIT_TEMPLATE_URL or pass --template-url to use a different zip artifact without fallback. Generated sites do not depend on the template artifact at runtime.`;
 const SITE_INIT_NEXT_STEPS = [
     "Install dependencies",
     "Copy and edit .env",
@@ -438,17 +438,37 @@ async function resolveInitTemplateSource(context, options) {
     if (options.template !== undefined && options.template !== DEFAULT_TEMPLATE_NAME) {
         throw createInvalidUsageError(`Unsupported template: ${options.template}. Use --template-url for external template zip artifacts.`);
     }
-    return downloadTemplateSite(context, getDefaultTemplateUrl(context));
+    return downloadDefaultTemplateSite(context, getDefaultTemplateResolution(context));
 }
-function getDefaultTemplateUrl(context) {
-    if (context.templateAssetBaseUrl !== undefined) {
-        return `${context.templateAssetBaseUrl.replace(/\/+$/u, "")}/slugkit-site-template.zip`;
-    }
+function getDefaultTemplateResolution(context) {
     const environmentUrl = process.env.SLUGKIT_TEMPLATE_URL?.trim();
     if (environmentUrl !== undefined && environmentUrl !== "") {
-        return environmentUrl;
+        return { primaryUrl: environmentUrl };
+    }
+    const primaryUrl = context.templateAssetBaseUrl !== undefined
+        ? `${context.templateAssetBaseUrl.replace(/\/+$/u, "")}/slugkit-site-template.zip`
+        : DEFAULT_TEMPLATE_URL;
+    return {
+        primaryUrl,
+        fallbackUrl: getVersionedTemplateUrl(context.packageVersion),
+    };
+}
+function getVersionedTemplateUrl(packageVersion) {
+    const version = packageVersion.trim().replace(/^v/u, "");
+    return `https://forge.caradoc.com/erik/slugkit/releases/download/v${version}/slugkit-site-template-v${version}.zip`;
+}
+async function downloadDefaultTemplateSite(context, resolution) {
+    try {
+        return await downloadTemplateSite(context, resolution.primaryUrl);
+    }
+    catch (error) {
+        if (resolution.fallbackUrl === undefined ||
+            !(error instanceof TemplateDownloadError) ||
+            error.status !== 404) {
+            throw error;
+        }
+        return downloadTemplateSite(context, resolution.fallbackUrl);
     }
-    return DEFAULT_TEMPLATE_URL;
 }
 async function downloadTemplateSite(context, templateUrl) {
     let parsedUrl;
@@ -464,7 +484,7 @@ async function downloadTemplateSite(context, templateUrl) {
     const fetchImpl = context.fetchImpl ?? fetch;
     const response = await fetchImpl(parsedUrl);
     if (!response.ok) {
-        throw new CliError(`Failed to download Slugkit template from ${parsedUrl.toString()}: HTTP ${response.status}`, ExitCode.NetworkError);
+        throw new TemplateDownloadError(parsedUrl.toString(), response.status);
     }
     const tempDirectory = await mkdtemp(join(tmpdir(), "slug-template-"));
     const archivePath = join(tempDirectory, "template.zip");
@@ -479,6 +499,13 @@ async function downloadTemplateSite(context, templateUrl) {
         cleanup: () => rm(tempDirectory, { force: true, recursive: true }),
     };
 }
+class TemplateDownloadError extends CliError {
+    status;
+    constructor(templateUrl, status) {
+        super(`Failed to download Slugkit template from ${templateUrl}: HTTP ${status}`, ExitCode.NetworkError);
+        this.status = status;
+    }
+}
 async function findExtractedTemplateDirectory(extractDirectory) {
     if (await isTemplateSiteDirectory(extractDirectory)) {
         return extractDirectory;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evcraddock/slug-cli",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Command-line tool for Slugkit sites.",
   "private": false,
   "type": "module",