@impulselab/cli 0.1.0 → 0.1.2

package/src/transforms/add-env.ts

@@ -1,53 +0,0 @@
-import fsExtra from "fs-extra";
-const { readFile, outputFile, pathExists } = fsExtra;
-import path from "path";
-import * as p from "@clack/prompts";
-
-/**
- * Prompts for an env var value and appends to .env if not already present.
- * target: path to .env file (e.g. ".env")
- * value: the env var name (e.g. "AUTH_SECRET")
- */
-export async function addEnv(
-  target: string,
-  value: string,
-  cwd: string,
-  dryRun: boolean
-): Promise<void> {
-  const file = path.join(cwd, target);
-  let content = "";
-
-  if (await pathExists(file)) {
-    content = await readFile(file, "utf-8");
-    // Check if key already set — escape value to avoid regex injection
-    const escaped = value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    const keyPattern = new RegExp(`^${escaped}=`, "m");
-    if (keyPattern.test(content)) return;
-  }
-
-  let envValue = "";
-  if (!dryRun) {
-    const answer = await p.text({
-      message: `Enter value for ${value} (leave blank to skip):`,
-      placeholder: "",
-    });
-
-    if (p.isCancel(answer)) {
-      p.log.warn(`Skipped env var: ${value}`);
-      return;
-    }
-
-    envValue = String(answer);
-  }
-
-  const line = `${value}=${envValue}`;
-
-  if (!dryRun) {
-    const newContent = content
-      ? content.endsWith("\n")
-        ? `${content}${line}\n`
-        : `${content}\n${line}\n`
-      : `${line}\n`;
-    await outputFile(file, newContent, "utf-8");
-  }
-}

package/src/transforms/add-nav-item.test.ts

@@ -1,125 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtemp, rm } from "fs/promises";
-import { outputFile, readFile } from "fs-extra";
-import path from "path";
-import os from "os";
-import { addNavItem } from "./add-nav-item";
-
-let tmpDir: string;
-
-beforeEach(async () => {
-  tmpDir = await mkdtemp(path.join(os.tmpdir(), "impulse-nav-test-"));
-});
-
-afterEach(async () => {
-  await rm(tmpDir, { recursive: true, force: true });
-});
-
-describe("addNavItem", () => {
-  it("inserts item into a flat nav array", async () => {
-    const navFile = path.join(tmpDir, "src/config/nav.ts");
-    await outputFile(
-      navFile,
-      `export const navItems = [\n  { title: "Home", href: "/" },\n];\n`
-    );
-
-    await addNavItem(
-      "src/config/nav.ts",
-      '{ title: "Auth", href: "/auth" }',
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(navFile, "utf-8");
-    expect(result).toContain('{ title: "Auth", href: "/auth" }');
-    expect(result).toContain('{ title: "Home", href: "/" }');
-    // insertion uses trailing newline — closing ] must be on its own line
-    expect(result).toMatch(/\},\n\]/);
-  });
-
-  it("inserts item into a typed array declaration (const navItems: NavItem[] = [...])", async () => {
-    const navFile = path.join(tmpDir, "src/config/nav.ts");
-    await outputFile(
-      navFile,
-      `export const navItems: NavItem[] = [\n  { title: "Home", href: "/" },\n];\n`
-    );
-
-    await addNavItem(
-      "src/config/nav.ts",
-      '{ title: "Auth", href: "/auth" }',
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(navFile, "utf-8");
-    expect(result).toContain('{ title: "Auth", href: "/auth" }');
-  });
-
-  it("inserts item into a nav array with nested arrays (nested subnav)", async () => {
-    const navFile = path.join(tmpDir, "src/config/nav.ts");
-    await outputFile(
-      navFile,
-      `export const navItems = [\n  {\n    title: "Settings",\n    href: "/settings",\n    children: [\n      { title: "Profile", href: "/settings/profile" },\n    ],\n  },\n];\n`
-    );
-
-    await addNavItem(
-      "src/config/nav.ts",
-      '{ title: "Auth", href: "/auth" }',
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(navFile, "utf-8");
-    // Item should be appended before the outer closing bracket
-    expect(result).toContain('{ title: "Auth", href: "/auth" }');
-    // Nested structure must be preserved
-    expect(result).toContain("children:");
-  });
-
-  it("does not insert duplicate items", async () => {
-    const navFile = path.join(tmpDir, "src/config/nav.ts");
-    const item = '{ title: "Auth", href: "/auth" }';
-    await outputFile(navFile, `export const navItems = [\n  ${item},\n];\n`);
-
-    await addNavItem("src/config/nav.ts", item, tmpDir, false);
-
-    const result = await readFile(navFile, "utf-8");
-    expect(result.split(item).length - 1).toBe(1);
-  });
-
-  it("does not write file in dry-run mode", async () => {
-    const navFile = path.join(tmpDir, "src/config/nav.ts");
-    const original = `export const navItems = [\n  { title: "Home", href: "/" },\n];\n`;
-    await outputFile(navFile, original);
-
-    await addNavItem(
-      "src/config/nav.ts",
-      '{ title: "Auth", href: "/auth" }',
-      tmpDir,
-      true
-    );
-
-    const result = await readFile(navFile, "utf-8");
-    expect(result).toBe(original);
-  });
-
-  it("throws if file not found", async () => {
-    await expect(
-      addNavItem("nonexistent/nav.ts", '{ title: "X" }', tmpDir, false)
-    ).rejects.toThrow("target file not found");
-  });
-
-  it("throws if no nav array can be located", async () => {
-    const navFile = path.join(tmpDir, "src/config/nav.ts");
-    await outputFile(navFile, `export const foo = "bar";\n`);
-
-    await expect(
-      addNavItem(
-        "src/config/nav.ts",
-        '{ title: "Auth", href: "/auth" }',
-        tmpDir,
-        false
-      )
-    ).rejects.toThrow("could not locate nav array");
-  });
-});

package/src/transforms/add-nav-item.ts

@@ -1,70 +0,0 @@
-import fsExtra from "fs-extra";
-const { readFile, outputFile, pathExists } = fsExtra;
-import path from "path";
-
-/**
- * Adds a navigation item to the sidebar config file.
- * target: path to the nav config file (e.g. "src/config/nav.ts")
- * value: the nav item JSON string to inject
- *        (e.g. '{ title: "Auth", href: "/auth", icon: "lock" }')
- */
-export async function addNavItem(
-  target: string,
-  value: string,
-  cwd: string,
-  dryRun: boolean
-): Promise<void> {
-  const file = path.join(cwd, target);
-
-  if (!(await pathExists(file))) {
-    throw new Error(
-      `add-nav-item: target file not found: ${target}`
-    );
-  }
-
-  const content = await readFile(file, "utf-8");
-  if (content.includes(value)) return;
-
-  // Find the opening bracket of the navItems array using a pattern match,
-  // then walk brackets to find the matching close — handles nested arrays.
-  // The type annotation group handles typed declarations: `const navItems: NavItem[] = [`
-  const openPattern = /(?:const\s+\w+(?:\s*:\s*[\w<>\[\], ]+)?\s*=\s*\[|items\s*:\s*\[)/;
-  const openMatch = openPattern.exec(content);
-
-  if (!openMatch) {
-    throw new Error(
-      `add-nav-item: could not locate nav array in ${target}. Add "${value}" manually.`
-    );
-  }
-
-  // Position of the '[' that opens the array
-  const bracketStart = openMatch.index + openMatch[0].length - 1;
-
-  // Walk forward counting brackets to find the matching ']'
-  let depth = 0;
-  let insertPos = -1;
-  for (let i = bracketStart; i < content.length; i++) {
-    if (content[i] === "[") depth++;
-    else if (content[i] === "]") {
-      depth--;
-      if (depth === 0) {
-        insertPos = i;
-        break;
-      }
-    }
-  }
-
-  if (insertPos === -1) {
-    throw new Error(
-      `add-nav-item: could not find closing bracket for nav array in ${target}. Add "${value}" manually.`
-    );
-  }
-
-  if (!dryRun) {
-    const newContent =
-      content.slice(0, insertPos) +
-      `  ${value},\n` +
-      content.slice(insertPos);
-    await outputFile(file, newContent, "utf-8");
-  }
-}

package/src/transforms/append-export.test.ts

@@ -1,50 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtemp, rm } from "fs/promises";
-import { outputFile, readFile } from "fs-extra";
-import path from "path";
-import os from "os";
-import { appendExport } from "./append-export";
-
-let tmpDir: string;
-
-beforeEach(async () => {
-  tmpDir = await mkdtemp(path.join(os.tmpdir(), "impulse-test-"));
-});
-
-afterEach(async () => {
-  await rm(tmpDir, { recursive: true, force: true });
-});
-
-describe("appendExport", () => {
-  it("creates the file if it does not exist", async () => {
-    await appendExport("src/index.ts", "export * from './auth'", tmpDir, false);
-    const content = await readFile(path.join(tmpDir, "src/index.ts"), "utf-8");
-    expect(content).toBe("export * from './auth'\n");
-  });
-
-  it("appends to existing file", async () => {
-    await outputFile(
-      path.join(tmpDir, "src/index.ts"),
-      "export * from './existing'\n"
-    );
-    await appendExport("src/index.ts", "export * from './auth'", tmpDir, false);
-    const content = await readFile(path.join(tmpDir, "src/index.ts"), "utf-8");
-    expect(content).toBe("export * from './existing'\nexport * from './auth'\n");
-  });
-
-  it("does not duplicate if already present", async () => {
-    await outputFile(
-      path.join(tmpDir, "src/index.ts"),
-      "export * from './auth'\n"
-    );
-    await appendExport("src/index.ts", "export * from './auth'", tmpDir, false);
-    const content = await readFile(path.join(tmpDir, "src/index.ts"), "utf-8");
-    expect(content).toBe("export * from './auth'\n");
-  });
-
-  it("does not write in dry-run mode", async () => {
-    await appendExport("src/index.ts", "export * from './auth'", tmpDir, true);
-    const { pathExists } = await import("fs-extra");
-    expect(await pathExists(path.join(tmpDir, "src/index.ts"))).toBe(false);
-  });
-});

package/src/transforms/append-export.ts

@@ -1,34 +0,0 @@
-import fsExtra from "fs-extra";
-const { readFile, outputFile, pathExists } = fsExtra;
-import path from "path";
-
-/**
- * Appends an export line to a barrel file if not already present.
- * target: relative path to the barrel file (e.g. "src/server/api/index.ts")
- * value: the export line to append (e.g. "export * from './auth'")
- */
-export async function appendExport(
-  target: string,
-  value: string,
-  cwd: string,
-  dryRun: boolean
-): Promise<void> {
-  const file = path.join(cwd, target);
-
-  if (!(await pathExists(file))) {
-    if (!dryRun) {
-      await outputFile(file, `${value}\n`, "utf-8");
-    }
-    return;
-  }
-
-  const content = await readFile(file, "utf-8");
-  if (content.includes(value)) return; // already present
-
-  if (!dryRun) {
-    const newContent = content.endsWith("\n")
-      ? `${content}${value}\n`
-      : `${content}\n${value}\n`;
-    await outputFile(file, newContent, "utf-8");
-  }
-}

package/src/transforms/index.ts

@@ -1,32 +0,0 @@
-import { appendExport } from "./append-export";
-import { registerRoute } from "./register-route";
-import { addNavItem } from "./add-nav-item";
-import { mergeSchema } from "./merge-schema";
-import { addEnv } from "./add-env";
-import type { ModuleTransform } from "../types";
-
-export async function runTransform(
-  transform: ModuleTransform,
-  cwd: string,
-  dryRun: boolean
-): Promise<void> {
-  switch (transform.type) {
-    case "append-export":
-      await appendExport(transform.target, transform.value, cwd, dryRun);
-      break;
-    case "register-route":
-      await registerRoute(transform.target, transform.value, cwd, dryRun);
-      break;
-    case "add-nav-item":
-      await addNavItem(transform.target, transform.value, cwd, dryRun);
-      break;
-    case "merge-schema":
-      await mergeSchema(transform.target, transform.value, cwd, dryRun);
-      break;
-    case "add-env":
-      await addEnv(transform.target, transform.value, cwd, dryRun);
-      break;
-  }
-}
-
-export { appendExport, registerRoute, addNavItem, mergeSchema, addEnv };

package/src/transforms/merge-schema.test.ts

@@ -1,70 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtemp, rm } from "fs/promises";
-import { outputFile, readFile } from "fs-extra";
-import path from "path";
-import os from "os";
-import { mergeSchema } from "./merge-schema";
-
-let tmpDir: string;
-
-beforeEach(async () => {
-  tmpDir = await mkdtemp(path.join(os.tmpdir(), "impulse-test-"));
-});
-
-afterEach(async () => {
-  await rm(tmpDir, { recursive: true, force: true });
-});
-
-describe("mergeSchema", () => {
-  it("creates schema index if it does not exist", async () => {
-    await mergeSchema(
-      "src/server/db/schema/index.ts",
-      "export * from './auth'",
-      tmpDir,
-      false
-    );
-    const content = await readFile(
-      path.join(tmpDir, "src/server/db/schema/index.ts"),
-      "utf-8"
-    );
-    expect(content).toBe("export * from './auth'\n");
-  });
-
-  it("appends to existing schema index", async () => {
-    await outputFile(
-      path.join(tmpDir, "src/server/db/schema/index.ts"),
-      "export * from './users'\n"
-    );
-    await mergeSchema(
-      "src/server/db/schema/index.ts",
-      "export * from './auth'",
-      tmpDir,
-      false
-    );
-    const content = await readFile(
-      path.join(tmpDir, "src/server/db/schema/index.ts"),
-      "utf-8"
-    );
-    expect(content).toBe(
-      "export * from './users'\nexport * from './auth'\n"
-    );
-  });
-
-  it("skips duplicates", async () => {
-    await outputFile(
-      path.join(tmpDir, "src/server/db/schema/index.ts"),
-      "export * from './auth'\n"
-    );
-    await mergeSchema(
-      "src/server/db/schema/index.ts",
-      "export * from './auth'",
-      tmpDir,
-      false
-    );
-    const content = await readFile(
-      path.join(tmpDir, "src/server/db/schema/index.ts"),
-      "utf-8"
-    );
-    expect(content).toBe("export * from './auth'\n");
-  });
-});

package/src/transforms/merge-schema.ts

@@ -1,35 +0,0 @@
-import fsExtra from "fs-extra";
-const { readFile, outputFile, pathExists } = fsExtra;
-import path from "path";
-
-/**
- * Adds a Drizzle schema import to the main schema index file.
- * target: path to the schema index (e.g. "src/server/db/schema/index.ts")
- * value: import/export line (e.g. "export * from './auth'")
- */
-export async function mergeSchema(
-  target: string,
-  value: string,
-  cwd: string,
-  dryRun: boolean
-): Promise<void> {
-  const file = path.join(cwd, target);
-
-  if (!(await pathExists(file))) {
-    // Create new schema index
-    if (!dryRun) {
-      await outputFile(file, `${value}\n`, "utf-8");
-    }
-    return;
-  }
-
-  const content = await readFile(file, "utf-8");
-  if (content.includes(value)) return;
-
-  if (!dryRun) {
-    const newContent = content.endsWith("\n")
-      ? `${content}${value}\n`
-      : `${content}\n${value}\n`;
-    await outputFile(file, newContent, "utf-8");
-  }
-}

package/src/transforms/register-route.test.ts

@@ -1,177 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtemp, rm } from "fs/promises";
-import { outputFile, readFile } from "fs-extra";
-import path from "path";
-import os from "os";
-import { registerRoute } from "./register-route";
-
-let tmpDir: string;
-
-beforeEach(async () => {
-  tmpDir = await mkdtemp(path.join(os.tmpdir(), "impulse-route-test-"));
-});
-
-afterEach(async () => {
-  await rm(tmpDir, { recursive: true, force: true });
-});
-
-const satisfiesRouter = `import { createRouter } from "@orpc/server";
-import { healthRouter } from "./health";
-
-export const appRouter = createRouter({
-  health: healthRouter,
-} satisfies RouterInput);
-`;
-
-const asRouter = `import { createRouter } from "@orpc/server";
-import { healthRouter } from "./health";
-
-export const appRouter = {
-  health: healthRouter,
-} as AppRouter;
-`;
-
-// Router that contains an inline `as` type cast inside a nested expression
-// — the fix must NOT insert into the inline cast.
-const routerWithInlineAs = `import { createRouter } from "@orpc/server";
-
-function helper(x: unknown) {
-  return (x as string).toUpperCase();
-}
-
-export const appRouter = createRouter({
-  health: healthRouter,
-} satisfies RouterInput);
-`;
-
-// Router where another typed object's `}` appears on its own line before
-// `satisfies`/`as` on the next line — cross-line match must be avoided.
-const routerWithCrossLineSatisfies = `const config = {
-  setting: true,
-}
-satisfies ConfigType;
-
-export const appRouter = createRouter({
-  health: healthRouter,
-} satisfies RouterInput);
-`;
-
-describe("registerRoute", () => {
-  it("inserts route into a 'satisfies' router", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, satisfiesRouter);
-
-    await registerRoute(
-      "src/server/api/router.ts",
-      "auth: authRouter",
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(routerFile, "utf-8");
-    expect(result).toContain("auth: authRouter");
-    expect(result).toContain("health: healthRouter");
-  });
-
-  it("inserts route into an 'as' router", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, asRouter);
-
-    await registerRoute(
-      "src/server/api/router.ts",
-      "auth: authRouter",
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(routerFile, "utf-8");
-    expect(result).toContain("auth: authRouter");
-  });
-
-  it("does not match when } and satisfies/as are on separate lines (cross-line false match)", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, routerWithCrossLineSatisfies);
-
-    await registerRoute(
-      "src/server/api/router.ts",
-      "auth: authRouter",
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(routerFile, "utf-8");
-    // Route must appear near the appRouter closing, not near the config object
-    const insertIdx = result.indexOf("auth: authRouter");
-    const configSatisfiesIdx = result.indexOf("}\nsatisfies ConfigType");
-    expect(insertIdx).toBeGreaterThan(configSatisfiesIdx);
-  });
-
-  it("does not match inline 'as' casts inside nested expressions", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, routerWithInlineAs);
-
-    await registerRoute(
-      "src/server/api/router.ts",
-      "auth: authRouter",
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(routerFile, "utf-8");
-    // Route must appear just before `} satisfies`, not before `} as string`
-    const insertIdx = result.indexOf("auth: authRouter");
-    const satisfiesIdx = result.indexOf("} satisfies");
-    expect(insertIdx).toBeGreaterThan(-1);
-    expect(insertIdx).toBeLessThan(satisfiesIdx);
-  });
-
-  it("does not insert duplicate routes", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, satisfiesRouter);
-
-    await registerRoute(
-      "src/server/api/router.ts",
-      "health: healthRouter",
-      tmpDir,
-      false
-    );
-
-    const result = await readFile(routerFile, "utf-8");
-    expect(result.split("health: healthRouter").length - 1).toBe(1);
-  });
-
-  it("does not write file in dry-run mode", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, satisfiesRouter);
-
-    await registerRoute(
-      "src/server/api/router.ts",
-      "auth: authRouter",
-      tmpDir,
-      true
-    );
-
-    const result = await readFile(routerFile, "utf-8");
-    expect(result).toBe(satisfiesRouter);
-  });
-
-  it("throws if file not found", async () => {
-    await expect(
-      registerRoute("nonexistent/router.ts", "auth: authRouter", tmpDir, false)
-    ).rejects.toThrow("target file not found");
-  });
-
-  it("throws if no router closing brace found", async () => {
-    const routerFile = path.join(tmpDir, "src/server/api/router.ts");
-    await outputFile(routerFile, `export const foo = "bar";\n`);
-
-    await expect(
-      registerRoute(
-        "src/server/api/router.ts",
-        "auth: authRouter",
-        tmpDir,
-        false
-      )
-    ).rejects.toThrow("could not find router closing brace");
-  });
-});