From c99fd8c04e076a69093aa339d7205dd20e589152 Mon Sep 17 00:00:00 2001
From: sonpiaz <sonxpiaz@gmail.com>
Date: Thu, 15 Oct 2026 21:42:46 -0700
Subject: [PATCH 1/3] feat: init writes the program's partner link parameter to
 ref_param (0.4.4)

The init response now carries link_param (via for new programs, aff for older
ones); the CLI writes it as ref_param, with aff when an older server omits it.
Setup notes name the parameter and say the tracker reads both aff and via.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 node_modules                              |  1 +
 packages/cli/CHANGELOG.md                 |  3 +++
 packages/cli/package.json                 |  2 +-
 packages/cli/src/commands/init.ts         |  7 ++++++-
 packages/cli/src/lib/config.ts            |  2 +-
 packages/cli/src/types.ts                 |  2 ++
 packages/cli/tests/init-ref-param.test.ts | 17 +++++++++++++++++
 7 files changed, 31 insertions(+), 3 deletions(-)
 create mode 120000 node_modules
 create mode 100644 packages/cli/tests/init-ref-param.test.ts

diff --git a/node_modules b/node_modules
new file mode 120000
index 0000000..02d9ad6
--- /dev/null
+++ b/node_modules
@@ -0,0 +1 @@
+../../node_modules
\ No newline at end of file
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 85258ff..909139f 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -1,5 +1,8 @@
 # Changelog — affitor (CLI)
 
+## 0.4.4
+- `affitor init` writes the program's partner link parameter to `ref_param` (`via` for programs created from now on, `aff` for older ones), from the server's answer. An older server without that field still gives `aff`. The setup notes say which parameter partner links use; the tracker reads both `?aff=` and `?via=`.
+
 ## 0.4.3
 - `affitor setup stripe` now points to the dashboard (program Settings, Connect Stripe) and exits 1 (`{"error": "stripe_setup_moved"}` with `--json`). The old flow could not complete: its token exchange needed Affitor's platform secret, the API that saved the connection is retired (410), and the webhook it created pointed at a URL the API does not serve. It no longer creates anything on your Stripe account. The unused `stripe` dependency is removed.
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index e5b2770..d6b6b76 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "affitor",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "CLI-native affiliate tracking. Connect Stripe, track commissions, manage partners — all from your terminal.",
   "type": "module",
   "bin": {
diff --git a/packages/cli/src/commands/init.ts b/packages/cli/src/commands/init.ts
index 39a72db..496f786 100644
--- a/packages/cli/src/commands/init.ts
+++ b/packages/cli/src/commands/init.ts
@@ -203,7 +203,7 @@ export async function runInit(
       name: "_aff",
       duration_days: cookieDuration,
     },
-    ref_param: "aff",
+    ref_param: refParamFrom(response),
     api_url: apiUrl,
     created_at: new Date().toISOString(),
   };
@@ -307,3 +307,8 @@ function formatCommission(
   }
   return `${value} per sale`;
 }
+
+/** The program's partner-code parameter from the init response; aff when an older server omits it. */
+export function refParamFrom(response: { link_param?: string }): string {
+  return response.link_param === "via" || response.link_param === "aff" ? response.link_param : "aff";
+}
diff --git a/packages/cli/src/lib/config.ts b/packages/cli/src/lib/config.ts
index a876802..7370737 100644
--- a/packages/cli/src/lib/config.ts
+++ b/packages/cli/src/lib/config.ts
@@ -326,7 +326,7 @@ This project uses Affitor for affiliate/partner tracking. Affitor tracks clicks,
 
 ### 1. Click Tracking
 
-Add this script tag to every page in \`<head>\`. It auto-detects affiliate visits via \`?aff=\` parameter and stores a first-party cookie.
+Add this script tag to every page in \`<head>\`. It auto-detects affiliate visits via \`?${config.ref_param}=\` (it also reads \`?aff=\` and \`?via=\`) and stores a first-party cookie.
 
 \`\`\`html
 <script src="${config.api_url}/js/affitor-tracker.js"
diff --git a/packages/cli/src/types.ts b/packages/cli/src/types.ts
index 7487999..6ea32af 100644
--- a/packages/cli/src/types.ts
+++ b/packages/cli/src/types.ts
@@ -56,6 +56,8 @@ export interface InitResponse {
   api_key: string;
   program_slug: string;
   domain: string;
+  /** The partner-code parameter the program prints (via | aff). Older servers omit it. */
+  link_param?: string;
 }
 
 export interface ProgramStatus {
diff --git a/packages/cli/tests/init-ref-param.test.ts b/packages/cli/tests/init-ref-param.test.ts
new file mode 100644
index 0000000..b1d2c66
--- /dev/null
+++ b/packages/cli/tests/init-ref-param.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, test } from "vitest";
+import { refParamFrom } from "../src/commands/init";
+
+describe("init writes ref_param from the server", () => {
+  test("via from the init response", () => {
+    expect(refParamFrom({ link_param: "via" })).toBe("via");
+  });
+  test("aff from the init response", () => {
+    expect(refParamFrom({ link_param: "aff" })).toBe("aff");
+  });
+  test("an older server without the field: aff", () => {
+    expect(refParamFrom({})).toBe("aff");
+  });
+  test("an unknown value: aff", () => {
+    expect(refParamFrom({ link_param: "ref" })).toBe("aff");
+  });
+});

From fbe43d65731ea6206cb9cbae6e09f26ff7b2328f Mon Sep 17 00:00:00 2001
From: sonpiaz <sonxpiaz@gmail.com>
Date: Thu, 15 Oct 2026 21:42:57 -0700
Subject: [PATCH 2/3] chore: drop the local node_modules link committed by
 mistake

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 node_modules | 1 -
 1 file changed, 1 deletion(-)
 delete mode 120000 node_modules

diff --git a/node_modules b/node_modules
deleted file mode 120000
index 02d9ad6..0000000
--- a/node_modules
+++ /dev/null
@@ -1 +0,0 @@
-../../node_modules
\ No newline at end of file

From 36dfc3b877fe8d20e7dfb2f9e7329afdca7243eb Mon Sep 17 00:00:00 2001
From: sonpiaz <sonxpiaz@gmail.com>
Date: Fri, 16 Oct 2026 01:19:53 -0700
Subject: [PATCH 3/3] fix: test ref_param through runInit; lockfile and
 component comment

Codex r1 on #38: the tests now run `affitor init` itself with a mocked init
response (via, aff, missing, unknown, non-string) and read the written
.affitor/config.json; an existing config makes no API call and no write. The
lockfile's workspace version matches 0.4.4, and the generated component's
comment names both ?via= and ?aff=.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 package-lock.json                         |  2 +-
 packages/cli/src/lib/inject.ts            |  2 +-
 packages/cli/tests/init-ref-param.test.ts | 91 ++++++++++++++++++++---
 3 files changed, 83 insertions(+), 12 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index a4745a3..056ca9c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -3396,7 +3396,7 @@
     },
     "packages/cli": {
       "name": "affitor",
-      "version": "0.4.3",
+      "version": "0.4.4",
       "license": "MIT",
       "dependencies": {
         "@affitor/recipes": "^0.1.0",
diff --git a/packages/cli/src/lib/inject.ts b/packages/cli/src/lib/inject.ts
index cbcc66b..c2724c0 100644
--- a/packages/cli/src/lib/inject.ts
+++ b/packages/cli/src/lib/inject.ts
@@ -26,7 +26,7 @@ import { loadAffitor } from '@affitor/sdk';
 
 /**
  * Affitor affiliate tracking — auto-generated by \`affitor init\`.
- * Captures ?aff= attribution on every page. Safe to keep at the app root.
+ * Captures ?via= and ?aff= attribution on every page. Safe to keep at the app root.
  */
 export function ${TRACKER_MARKER}() {
   useEffect(() => {
diff --git a/packages/cli/tests/init-ref-param.test.ts b/packages/cli/tests/init-ref-param.test.ts
index b1d2c66..d14d03f 100644
--- a/packages/cli/tests/init-ref-param.test.ts
+++ b/packages/cli/tests/init-ref-param.test.ts
@@ -1,17 +1,88 @@
-import { describe, expect, test } from "vitest";
-import { refParamFrom } from "../src/commands/init";
+import { afterEach, beforeEach, describe, expect, it, test, vi } from "vitest";
+import { existsSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { refParamFrom, runInit } from "../src/commands/init";
+import { AffitorAPI } from "../src/lib/api-client";
+import type { CLIFlags } from "../src/types";
 
-describe("init writes ref_param from the server", () => {
-  test("via from the init response", () => {
+const flags: CLIFlags = { json: true, noInteractive: true, autoConfirm: true, quiet: true, verbose: false };
+const opts = { name: "Demo", domain: "demo.example.test", commissionType: "percent", commissionRate: 20 };
+
+describe("refParamFrom", () => {
+  test("via and aff pass through; a missing or unknown value is aff", () => {
     expect(refParamFrom({ link_param: "via" })).toBe("via");
-  });
-  test("aff from the init response", () => {
     expect(refParamFrom({ link_param: "aff" })).toBe("aff");
-  });
-  test("an older server without the field: aff", () => {
     expect(refParamFrom({})).toBe("aff");
-  });
-  test("an unknown value: aff", () => {
     expect(refParamFrom({ link_param: "ref" })).toBe("aff");
+    expect(refParamFrom({ link_param: "VIA" })).toBe("aff");
+  });
+});
+
+describe("affitor init writes ref_param from the server", () => {
+  let home: string;
+  let project: string;
+  let cwd: string;
+  let originalHome: string | undefined;
+
+  beforeEach(() => {
+    cwd = process.cwd();
+    originalHome = process.env.HOME;
+    home = mkdtempSync(join(tmpdir(), "affitor-home-"));
+    mkdirSync(join(home, ".affitor"));
+    writeFileSync(
+      join(home, ".affitor", "credentials.json"),
+      JSON.stringify({ token: "jwt_test", email: "brand@example.test", expires_at: "2099-01-01T00:00:00.000Z" }),
+    );
+    process.env.HOME = home;
+    project = mkdtempSync(join(tmpdir(), "affitor-init-"));
+    process.chdir(project);
+    vi.spyOn(process, "exit").mockImplementation(((code?: number) => {
+      throw new Error(`exit:${code}`);
+    }) as never);
+    vi.spyOn(console, "log").mockImplementation(() => {});
+    vi.spyOn(console, "error").mockImplementation(() => {});
+  });
+
+  afterEach(() => {
+    process.chdir(cwd);
+    if (originalHome === undefined) delete process.env.HOME;
+    else process.env.HOME = originalHome;
+    rmSync(home, { recursive: true, force: true });
+    rmSync(project, { recursive: true, force: true });
+    vi.restoreAllMocks();
+  });
+
+  const config = () => JSON.parse(readFileSync(join(project, ".affitor", "config.json"), "utf8"));
+
+  it.each([
+    [{ link_param: "via" }, "via"],
+    [{ link_param: "aff" }, "aff"],
+    [{}, "aff"],
+    [{ link_param: "ref" }, "aff"],
+    [{ link_param: 7 }, "aff"],
+  ])("init response %j → ref_param %s in .affitor/config.json", async (extra, expected) => {
+    const init = vi
+      .spyOn(AffitorAPI.prototype, "initProgram")
+      .mockResolvedValue({ program_id: "58", api_key: "aff_test_key", ...extra } as never);
+
+    await runInit(opts, flags);
+
+    expect(init).toHaveBeenCalledTimes(1);
+    expect(config().ref_param).toBe(expected);
+    expect(config().program_id).toBe("58");
+  });
+
+  it("an existing config is left as it is: no API call, no write", async () => {
+    mkdirSync(join(project, ".affitor"));
+    const before = JSON.stringify({ version: 2, program_id: "12", ref_param: "aff" });
+    writeFileSync(join(project, ".affitor", "config.json"), before);
+    const init = vi.spyOn(AffitorAPI.prototype, "initProgram");
+
+    await expect(runInit(opts, flags)).rejects.toThrow("exit:1");
+
+    expect(init).not.toHaveBeenCalled();
+    expect(readFileSync(join(project, ".affitor", "config.json"), "utf8")).toBe(before);
+    expect(existsSync(join(project, ".affitor", ".env"))).toBe(false);
   });
 });