@stackonward/cli 1.1.0 → 1.2.0

package/dist/index.js

@@ -177,6 +177,13 @@ function isTextFile(filename) {
   const basename = path.basename(filename);
   return textExtensions.includes(ext) || basename.startsWith(".") || !ext;
 }
+async function readJson(filePath) {
+  try {
+    return await fs.readJson(filePath);
+  } catch {
+    return null;
+  }
+}
 async function isDirEmpty(dir) {
   if (!await fs.pathExists(dir)) return true;
   const files = await fs.readdir(dir);
@@ -302,27 +309,27 @@ async function loadSnippetsRegistry() {
   }
   return {};
 }
-function resolveComponentDependencies(componentName, registry, resolved = /* @__PURE__ */ new Set()) {
+function resolveComponentDependencies(componentName, registry2, resolved = /* @__PURE__ */ new Set()) {
   if (resolved.has(componentName)) return [];
-  const component = registry.components[componentName];
+  const component = registry2.components[componentName];
   if (!component) {
     throw new Error(`Component "${componentName}" not found in registry`);
   }
   resolved.add(componentName);
   const deps = [];
   for (const depName of component.registryDependencies) {
-    deps.push(...resolveComponentDependencies(depName, registry, resolved));
+    deps.push(...resolveComponentDependencies(depName, registry2, resolved));
   }
   deps.push(component);
   return deps;
 }
-function getComponentsByFramework(registry, framework) {
-  return Object.values(registry.components).filter(
+function getComponentsByFramework(registry2, framework) {
+  return Object.values(registry2.components).filter(
     (c) => c.framework === framework || c.framework === "universal" || framework === "nuxt" && c.framework === "vue"
   );
 }
-function getSnippetsByFramework(registry, framework) {
-  return Object.values(registry.snippets).filter(
+function getSnippetsByFramework(registry2, framework) {
+  return Object.values(registry2.snippets).filter(
     (s) => s.framework === framework || s.framework === "universal" || framework === "nuxt" && s.framework === "vue"
   );
 }
@@ -347,8 +354,8 @@ function resolveComponentFramework(framework) {
   }
   return null;
 }
-function findComponentKey(registry, component) {
-  const match = Object.entries(registry.components).find(
+function findComponentKey(registry2, component) {
+  const match = Object.entries(registry2.components).find(
     ([, candidate]) => candidate === component
   );
   return match?.[0] ?? component.name.toLowerCase();
@@ -594,12 +601,12 @@ async function installTemplateRegistryItems(templateInfo, targetDir) {
   if (!registryItems?.length) {
     return;
   }
-  const registry = await loadRegistry();
+  const registry2 = await loadRegistry();
   const installPlan = buildComponentInstallPlan({
     componentKeys: [...registryItems],
     framework: "nuxt",
     projectRoot: targetDir,
-    registry
+    registry: registry2
   });
   await copyFiles(installPlan.filesToCopy, false);
 }
@@ -639,19 +646,19 @@ async function add(items, options) {
     logger.error("No package.json found. Please run this command in a project directory.");
     process.exit(1);
   }
-  const registry = await loadRegistry();
-  const packageItems = items.filter((i) => registry.packages[i]).map((i) => registry.packages[i]);
+  const registry2 = await loadRegistry();
+  const packageItems = items.filter((i) => registry2.packages[i]).map((i) => registry2.packages[i]);
   if (packageItems.length > 0) {
     await addPackages(packageItems, project);
   }
-  const nonPackageItems = items.filter((i) => !registry.packages[i]);
+  const nonPackageItems = items.filter((i) => !registry2.packages[i]);
   if (items.length > 0 && nonPackageItems.length === 0) return;
   const isComponent = options.component || !options.snippet && !options.component;
   const isSnippet = options.snippet;
   if (isComponent) {
-    await addComponents(nonPackageItems, options, project, registry);
+    await addComponents(nonPackageItems, options, project, registry2);
   } else if (isSnippet) {
-    await addSnippets(nonPackageItems, options, project, registry);
+    await addSnippets(nonPackageItems, options, project, registry2);
   }
 }
 async function addPackages(packages, project) {
@@ -691,13 +698,13 @@ async function patchProjectNuxtConfig(root, layer) {
   }
   logger.warn(`No nuxt.config found; add "${layer}" to your nuxt.config extends manually`);
 }
-async function addComponents(items, options, project, registry) {
+async function addComponents(items, options, project, registry2) {
   const framework = resolveComponentFramework(project.framework);
   if (!framework) {
     logger.error("Could not detect framework. Supported: Nuxt, Vue, React");
     process.exit(1);
   }
-  const availableComponents = getComponentsByFramework(registry, framework);
+  const availableComponents = getComponentsByFramework(registry2, framework);
   if (availableComponents.length === 0) {
     logger.warn(`No components available for ${framework}`);
     return;
@@ -708,7 +715,7 @@ async function addComponents(items, options, project, registry) {
   } else if (items.length > 0) {
     for (const item of items) {
       try {
-        const deps = resolveComponentDependencies(item, registry);
+        const deps = resolveComponentDependencies(item, registry2);
         selectedComponents.push(...deps);
       } catch (error) {
         logger.error(error.message);
@@ -722,7 +729,7 @@ async function addComponents(items, options, project, registry) {
       ...components.map((c) => ({
         title: `  ${c.name}`,
         description: c.description,
-        value: findComponentKey(registry, c)
+        value: findComponentKey(registry2, c)
       }))
     ]);
     const response = await prompts2({
@@ -737,12 +744,12 @@ async function addComponents(items, options, project, registry) {
       return;
     }
     for (const name of response.components) {
-      const deps = resolveComponentDependencies(name, registry);
+      const deps = resolveComponentDependencies(name, registry2);
       selectedComponents.push(...deps);
     }
   }
   const componentKeys = [
-    ...new Set(selectedComponents.map((component) => findComponentKey(registry, component)))
+    ...new Set(selectedComponents.map((component) => findComponentKey(registry2, component)))
   ];
   if (selectedComponents.length === 0) {
     logger.info("No components to add");
@@ -767,7 +774,7 @@ async function addComponents(items, options, project, registry) {
     componentKeys,
     framework,
     projectRoot: project.root,
-    registry,
+    registry: registry2,
     targetBase: options.path
   });
   const spinner = ora2("Adding components...").start();
@@ -808,9 +815,9 @@ async function addComponents(items, options, project, registry) {
   logger.br();
   logger.success("Done!");
 }
-async function addSnippets(items, options, project, registry) {
+async function addSnippets(items, options, project, registry2) {
   const framework = project.framework === "nuxt" ? "nuxt" : project.framework === "vue" ? "vue" : project.framework === "react" ? "react" : "node";
-  const availableSnippets = getSnippetsByFramework(registry, framework);
+  const availableSnippets = getSnippetsByFramework(registry2, framework);
   if (availableSnippets.length === 0) {
     logger.warn(`No snippets available for ${framework}`);
     return;
@@ -820,7 +827,7 @@ async function addSnippets(items, options, project, registry) {
     selectedSnippets = availableSnippets;
   } else if (items.length > 0) {
     for (const item of items) {
-      const snippet = registry.snippets[item];
+      const snippet = registry2.snippets[item];
       if (!snippet) {
         logger.error(`Snippet "${item}" not found`);
         process.exit(1);
@@ -848,7 +855,7 @@ async function addSnippets(items, options, project, registry) {
       logger.info("No snippets selected");
       return;
     }
-    selectedSnippets = response.snippets.map((name) => registry.snippets[name]);
+    selectedSnippets = response.snippets.map((name) => registry2.snippets[name]);
   }
   if (selectedSnippets.length === 0) {
     logger.info("No snippets to add");
@@ -934,8 +941,8 @@ function listTemplates() {
 async function listComponents() {
   logger.title("Components");
   logger.br();
-  const registry = await loadRegistry();
-  const components = Object.values(registry.components);
+  const registry2 = await loadRegistry();
+  const components = Object.values(registry2.components);
   if (components.length === 0) {
     logger.info("  No components available");
     logger.br();
@@ -964,8 +971,8 @@ async function listComponents() {
 async function listSnippets() {
   logger.title("Snippets");
   logger.br();
-  const registry = await loadRegistry();
-  const snippets = Object.values(registry.snippets);
+  const registry2 = await loadRegistry();
+  const snippets = Object.values(registry2.snippets);
   if (snippets.length === 0) {
     logger.info("  No snippets available");
     logger.br();
@@ -5413,12 +5420,167 @@ async function runApple(mode, options) {
   }
 }
 
+// src/commands/analytics.ts
+import { randomUUID as randomUUID3 } from "crypto";
+import { mkdir as mkdir4, rename as rename2, rm as rm4, writeFile as writeFile3 } from "fs/promises";
+import path19 from "path";
+
+// src/analytics/generator.ts
+var AnalyticsArtifactError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "AnalyticsArtifactError";
+    this.code = code;
+  }
+};
+var AnalyticsArtifactGeneratorRegistry = class {
+  #generators = /* @__PURE__ */ new Map();
+  constructor(generators) {
+    for (const generator of generators) {
+      if (this.#generators.has(generator.id)) {
+        throw new AnalyticsArtifactError(
+          "duplicate_provider",
+          `Analytics provider is registered more than once: ${generator.id}`
+        );
+      }
+      this.#generators.set(generator.id, generator);
+    }
+  }
+  get(provider) {
+    const generator = this.#generators.get(provider);
+    if (!generator) {
+      throw new AnalyticsArtifactError(
+        "unknown_provider",
+        `Unknown analytics provider: ${provider}`
+      );
+    }
+    return generator;
+  }
+};
+
+// src/analytics/google-tag-manager.ts
+import {
+  createGoogleTagManagerContainer,
+  getGoogleTagManagerContainerConfigJsonSchema
+} from "@stackonward/google-tag-manager/container";
+var googleTagManagerArtifactGenerator = {
+  id: "google-tag-manager",
+  schema: getGoogleTagManagerContainerConfigJsonSchema,
+  generate(input) {
+    try {
+      const container = createGoogleTagManagerContainer(input);
+      return {
+        contents: `${JSON.stringify(container, null, 2)}
+`,
+        resourceCounts: Object.freeze({
+          tags: container.containerVersion.tag.length,
+          triggers: container.containerVersion.trigger.length,
+          variables: container.containerVersion.variable.length
+        })
+      };
+    } catch (error) {
+      if (error instanceof Error && error.name === "ZodError") {
+        throw new AnalyticsArtifactError(
+          "invalid_configuration",
+          "Analytics provider configuration is invalid"
+        );
+      }
+      throw error;
+    }
+  }
+};
+
+// src/commands/analytics.ts
+var registry = new AnalyticsArtifactGeneratorRegistry([googleTagManagerArtifactGenerator]);
+function registerAnalytics(program2) {
+  const analytics = program2.command("analytics").description("Generate reviewed analytics provider configuration artifacts");
+  analytics.command("schema").description("Print the selected analytics provider configuration schema").requiredOption("--provider <provider>", "Analytics provider").action(
+    (options) => guardedAnalytics(() => {
+      process.stdout.write(
+        `${JSON.stringify(registry.get(options.provider).schema(), null, 2)}
+`
+      );
+    })
+  );
+  analytics.command("generate").description("Generate a provider configuration artifact without publishing it").requiredOption("--provider <provider>", "Analytics provider").requiredOption("--config <file>", "Product analytics configuration JSON").requiredOption("--out <file>", "Destination artifact").option("--overwrite", "Replace an existing destination").action((options) => guardedAnalytics(() => generateArtifact(options)));
+}
+async function generateArtifact(options) {
+  const generator = registry.get(options.provider);
+  const input = await readJson(path19.resolve(options.config));
+  if (input === null) {
+    throw new AnalyticsArtifactError(
+      "configuration_unreadable",
+      "Analytics configuration must be a readable JSON file"
+    );
+  }
+  const artifact = generator.generate(input);
+  const destination = path19.resolve(options.out);
+  await writeArtifact(destination, artifact.contents, options.overwrite === true);
+  process.stdout.write(
+    `${JSON.stringify({
+      schemaVersion: 1,
+      outcome: "generated",
+      provider: options.provider,
+      artifact: destination,
+      resources: artifact.resourceCounts,
+      published: false
+    })}
+`
+  );
+}
+async function writeArtifact(destination, contents, overwrite) {
+  await mkdir4(path19.dirname(destination), { recursive: true });
+  if (!overwrite) {
+    try {
+      await writeFile3(destination, contents, { flag: "wx" });
+      return;
+    } catch (error) {
+      if (isFileExistsError(error)) {
+        throw new AnalyticsArtifactError(
+          "artifact_exists",
+          "Analytics artifact already exists; pass --overwrite to replace it"
+        );
+      }
+      throw error;
+    }
+  }
+  const temporary = `${destination}.${process.pid}.${randomUUID3()}.tmp`;
+  let created = false;
+  try {
+    await writeFile3(temporary, contents, { flag: "wx" });
+    created = true;
+    await rename2(temporary, destination);
+    created = false;
+  } finally {
+    if (created) {
+      await rm4(temporary, { force: true });
+    }
+  }
+}
+async function guardedAnalytics(operation) {
+  try {
+    await operation();
+  } catch (error) {
+    const failure = error instanceof AnalyticsArtifactError ? error : new AnalyticsArtifactError("analytics_command_failed", "Analytics command failed");
+    process.stderr.write(
+      `${JSON.stringify({ schemaVersion: 1, outcome: "failed", code: failure.code })}
+`
+    );
+    process.exitCode = 2;
+  }
+}
+function isFileExistsError(error) {
+  return error instanceof Error && "code" in error && error.code === "EEXIST";
+}
+
 // src/index.ts
 var program = new Command();
-program.name("stackonward").description("Create projects and install reusable components and snippets").version("1.1.0");
+program.name("stackonward").description("Create projects and install reusable components and snippets").version("1.2.0");
 program.command("init [name]").description("Create a new project from template").option("-t, --template <template>", "Template to use").option("-d, --dir <directory>", "Target directory").option("--skip-install", "Skip dependency installation").option("--skip-git", "Skip git initialization").option("--module <module>", "Go module path (required for go-backend)").option("--author <author>", "Author name").option("-y, --yes", "Use defaults without interactive prompts").action(init);
 program.command("add [items...]").description("Add components or snippets to your project").option("-c, --component", "Add component(s)").option("-s, --snippet", "Add snippet(s)").option("-a, --all", "Add all items in category").option("-y, --yes", "Skip confirmation prompts").option("-o, --overwrite", "Overwrite existing files").option("-p, --path <path>", "Custom install path").action(add);
 program.command("list [type]").description("List available templates, components, or snippets").option("-t, --templates", "List templates").option("-c, --components", "List components").option("-s, --snippets", "List snippets").action(list);
 registerApple(program);
+registerAnalytics(program);
 await program.parseAsync();
 //# sourceMappingURL=index.js.map