@userreason/wizard 0.1.0 → 0.2.0

package/dist/chunk-WL3NOIM6.js

@@ -0,0 +1,42 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __require,
+  __commonJS,
+  __toESM
+};

package/dist/chunk-YMSGDC4B.js

@@ -0,0 +1,280 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  configurePackageRegistry
+} from "./chunk-OEGNGGZ2.js";
+import {
+  packageProfile
+} from "./chunk-GGARVSPT.js";
+
+// src/project.ts
+import { lstat, readFile, writeFile, access, mkdtemp, realpath, rm } from "node:fs/promises";
+import { join, resolve, dirname } from "node:path";
+import { spawn, execFile } from "node:child_process";
+import { promisify } from "node:util";
+var exists = async (path) => {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+};
+async function inspectProject(directory, framework) {
+  directory = resolve(directory);
+  const metadata = await lstat(directory);
+  if (!metadata.isDirectory()) throw new Error("Project directory must be an existing directory");
+  const text = await readFile(join(directory, "package.json"), "utf8");
+  if (text.length > 1e6) throw new Error("Project package.json is too large");
+  const data = JSON.parse(text);
+  if (!data || typeof data !== "object" || Array.isArray(data))
+    throw new Error("Invalid project package.json");
+  const dependencies = { ...data.dependencies, ...data.devDependencies };
+  const inferred = dependencies.next ? "next" : dependencies.react ? "react" : dependencies.vue ? "vue" : "vanilla";
+  const packageManager = typeof data.packageManager === "string" && /^(pnpm|yarn)@/.test(data.packageManager) ? data.packageManager.split("@")[0] : await exists(join(directory, "pnpm-lock.yaml")) ? "pnpm" : await exists(join(directory, "yarn.lock")) ? "yarn" : "npm";
+  const yarnMajor = packageManager === "yarn" ? typeof data.packageManager === "string" && /^yarn@\d+/.test(data.packageManager) ? Number(data.packageManager.slice(5).split(".")[0]) : await exists(join(directory, ".yarnrc.yml")) ? 4 : 1 : void 0;
+  const sourceDirectory = await exists(join(directory, "src")) ? join(directory, "src") : directory;
+  let nextVersion = dependencies.next;
+  if (inferred === "next") {
+    try {
+      nextVersion = JSON.parse(await readFile(join(directory, "node_modules/next/package.json"), "utf8")).version;
+    } catch {
+    }
+  }
+  const version = typeof nextVersion === "string" ? /^[~^]?(\d+)(?:\.(\d+))?/.exec(nextVersion) : null;
+  return {
+    directory,
+    framework: framework ?? inferred,
+    sourceDirectory,
+    packageManager,
+    yarnMajor,
+    name: typeof data.name === "string" && data.name ? data.name : "My site",
+    vite: Boolean(dependencies.vite),
+    devScript: data.scripts && typeof data.scripts === "object" ? typeof data.scripts.dev === "string" ? "dev" : typeof data.scripts.start === "string" ? "start" : void 0 : void 0,
+    nextInstrumentation: Boolean(version && (Number(version[1]) > 15 || Number(version[1]) === 15 && Number(version[2]) >= 3)),
+    typescript: Boolean(dependencies.typescript) || await exists(join(directory, "tsconfig.json")) || await exists(join(sourceDirectory, "userreason.generated.tsx")) || await exists(join(sourceDirectory, "userreason.generated.ts"))
+  };
+}
+var DEFAULT_API = "https://api.userreason.com";
+function publicOptions(config) {
+  return { siteId: config.siteId, ...config.apiBaseUrl !== DEFAULT_API ? { apiBaseUrl: config.apiBaseUrl } : {} };
+}
+function optionsSource(config) {
+  return `{
+${Object.entries(publicOptions(config)).map(([key, value]) => `  ${key}: ${JSON.stringify(value)},`).join("\n")}
+}`;
+}
+function initializationSource(config) {
+  return `UserReason.init(${optionsSource(config)});
+`;
+}
+function integrationSource(framework, config, typescript = true, legacyNext = false) {
+  const options = optionsSource(config);
+  const base = `// Generated by the UserReason wizard. Contains public SDK configuration only.
+`;
+  if (framework === "next" && legacyNext)
+    return {
+      filename: `userreason.client.${typescript ? "tsx" : "jsx"}`,
+      content: `'use client';
+${base}import { useEffect, useLayoutEffect } from 'react';
+import UserReason from '@userreason/js';
+
+const useBrowserLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
+
+export function UserReasonInit() {
+  useBrowserLayoutEffect(() => {
+    UserReason.init(${options});
+    return () => UserReason.destroy();
+  }, []);
+  return null;
+}
+`,
+      instruction: framework === "next" ? "Import UserReasonInit from the generated client file and render <UserReasonInit /> once inside <body> or your Pages Router root." : "Initialize UserReason once before mounting your application."
+    };
+  return {
+    filename: `instrumentation-client.${typescript ? "ts" : "js"}`,
+    content: `${base}import UserReason from '@userreason/js';
+
+${initializationSource(config)}`,
+    instruction: `Add this initialization to ${framework === "next" ? "instrumentation-client.ts/js for Next.js 15.3+, or a browser-only entry for older versions" : "your browser entry before mounting the app"}:
+
+import UserReason from '@userreason/js';
+
+${initializationSource(config)}`
+  };
+}
+async function writeGenerated(path, content, force) {
+  try {
+    await writeFile(path, content, { flag: "wx", mode: 420 });
+    return;
+  } catch (error) {
+    if (error.code !== "EEXIST") throw error;
+  }
+  const metadata = await lstat(path);
+  if (!metadata.isFile() || metadata.isSymbolicLink())
+    throw new Error(`Refusing to overwrite a non-file: ${path}`);
+  if (await readFile(path, "utf8") === content) return;
+  if (!force)
+    throw new Error(
+      `Existing file differs: ${path}. Review it and rerun with --force to replace it.`
+    );
+  await writeFile(path, content, { mode: 420 });
+}
+async function writeIntegration(project, config, force = false, legacyNext = false) {
+  const helper = integrationSource(project.framework, config, project.typescript, legacyNext), helperPath = join(project.sourceDirectory, helper.filename);
+  const source = await lstat(dirname(helperPath));
+  if (!source.isDirectory() || source.isSymbolicLink())
+    throw new Error("Source directory must be a real directory inside the project");
+  if (legacyNext) await writeGenerated(helperPath, helper.content, force);
+  return { files: legacyNext ? [helperPath] : [], instruction: helper.instruction };
+}
+async function installedVersion(project, name) {
+  if (project.packageManager === "yarn" && (project.yarnMajor ?? 1) >= 2 && await exists(join(project.directory, ".pnp.cjs"))) {
+    const script = "const p=require('pnpapi').resolveToUnqualified(process.argv[1],process.cwd()+'/'); console.log(JSON.parse(require('node:fs').readFileSync(require('node:path').join(p,'package.json'),'utf8')).version)";
+    const result = await promisify(execFile)("yarn", ["node", "-e", script, name], { cwd: project.directory, timeout: 15e3 });
+    return result.stdout.trim();
+  }
+  return JSON.parse(await readFile(join(project.directory, "node_modules", name, "package.json"), "utf8")).version;
+}
+var cliCommand = (project) => project.packageManager === "pnpm" ? "pnpm exec userreason" : project.packageManager === "yarn" ? "yarn exec userreason" : "npx --no-install userreason";
+async function hasCompatibleSdk(project, profile = packageProfile()) {
+  try {
+    const manifest = JSON.parse(await readFile(join(project.directory, "package.json"), "utf8"));
+    const version = await installedVersion(project, "@userreason/js");
+    return Boolean(manifest.dependencies?.["@userreason/js"] && (profile.kind === "local-development" ? version === profile.sdkVersion : /^0\.4\.\d+$/.test(version)));
+  } catch {
+    return false;
+  }
+}
+function sdkInstallCommand(project, profile = packageProfile()) {
+  return project.packageManager === "npm" ? `npm install --ignore-scripts @userreason/js@${profile.sdkVersion}` : project.packageManager === "pnpm" ? `pnpm add --ignore-scripts @userreason/js@${profile.sdkVersion}` : (project.yarnMajor ?? 1) >= 2 ? `yarn add --mode=skip-build @userreason/js@${profile.sdkVersion}` : `yarn add --ignore-scripts @userreason/js@${profile.sdkVersion}`;
+}
+async function hasCompatibleCli(project, profile = packageProfile()) {
+  try {
+    const manifest = JSON.parse(await readFile(join(project.directory, "package.json"), "utf8"));
+    const version = await installedVersion(project, "@userreason/cli");
+    return Boolean(manifest.devDependencies?.["@userreason/cli"] && compatibleCliVersion(version, profile));
+  } catch {
+    return false;
+  }
+}
+function compatibleCliVersion(version, profile) {
+  return profile.kind === "local-development" ? version === profile.cliVersion : /^0\.1\.\d+$/.test(version) && Number(version.split(".")[2]) >= 1;
+}
+function cliInstallCommand(project, profile = packageProfile()) {
+  return sdkInstallCommand(project, profile).replace("@userreason/js@" + profile.sdkVersion, "--save-dev @userreason/cli@" + profile.cliVersion).replace("yarn add --mode=skip-build --save-dev", "yarn add --mode=skip-build --dev").replace("yarn add --ignore-scripts --save-dev", "yarn add --ignore-scripts --dev");
+}
+var SdkInstallError = class extends Error {
+};
+async function installSdk(project, options = {}) {
+  return installDependency(project, "sdk", options);
+}
+async function installCli(project, options = {}) {
+  return installDependency(project, "cli", options);
+}
+async function installDependency(project, dependency, options) {
+  const label = dependency === "sdk" ? "SDK" : "CLI";
+  const profile = options.profile ?? packageProfile();
+  const spec = dependency === "sdk" ? `@userreason/js@${profile.sdkVersion}` : `@userreason/cli@${profile.cliVersion}`;
+  const args = project.packageManager === "npm" ? ["install", "--ignore-scripts", spec] : project.packageManager === "pnpm" ? ["add", "--ignore-scripts", spec] : (project.yarnMajor ?? 1) >= 2 ? ["add", "--mode=skip-build", spec] : ["add", "--ignore-scripts", spec];
+  if (dependency === "cli") args.push(project.packageManager === "yarn" ? "--dev" : "--save-dev");
+  if (profile.kind === "local-development") args.push(project.packageManager === "yarn" ? "--exact" : "--save-exact");
+  let cache;
+  try {
+    await configurePackageRegistry(project, profile);
+    if (project.packageManager === "npm") {
+      cache = await mkdtemp(join(await realpath(project.directory), ".userreason-npm-"));
+      args.push("--cache", cache);
+    }
+    await new Promise((resolve2, reject) => {
+      const child = spawn(project.packageManager, args, {
+        cwd: project.directory,
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: false,
+        env: {
+          ...process.env,
+          YARN_ENABLE_SCRIPTS: "false",
+          npm_config_ignore_scripts: "true",
+          ...cache ? { npm_config_cache: cache, NPM_CONFIG_CACHE: cache } : {}
+        }
+      });
+      let logs = "";
+      const capture = (chunk) => {
+        const text = chunk.toString();
+        logs = (logs + text).slice(-64e3);
+        if (options.verbose) process.stderr.write(text);
+      };
+      child.stdout?.on("data", capture);
+      child.stderr?.on("data", capture);
+      child.on("error", () => reject(new SdkInstallError(`Unable to start ${project.packageManager}.`)));
+      child.on("close", (code) => {
+        if (code === 0) {
+          if (/\b[1-9]\d*\s+vulnerabilit(?:y|ies)\b|\bWARN\b|\bwarning\b/i.test(logs))
+            options.onWarning?.(
+              `The package manager reported warnings. Review its output with --debug and check your project's dependency audit.`
+            );
+          resolve2();
+        } else {
+          const restricted = /ERR_ACCESS_DENIED|Access to this API has been restricted/.test(logs);
+          reject(
+            new SdkInstallError(
+              restricted ? `Your Node or package-manager permission policy blocked ${label} installation. Run the manual install command in your normal terminal.` : `${label} installation failed (${project.packageManager} exit ${code}). Rerun with --debug to inspect package-manager output.`
+            )
+          );
+        }
+      });
+    });
+  } catch (error) {
+    if (error instanceof SdkInstallError) throw error;
+    throw new SdkInstallError(
+      "Unable to prepare a writable SDK install cache inside the project. Run the manual install command in your normal terminal.",
+      { cause: error }
+    );
+  } finally {
+    if (cache) {
+      try {
+        await rm(cache, { recursive: true, force: true });
+      } catch {
+        options.onWarning?.("Unable to remove the temporary .userreason-npm-* cache inside your project.");
+      }
+    }
+  }
+}
+async function verifyConfiguration(config, hostOrigin, fetcher = fetch) {
+  const response = await fetcher(
+    `${config.apiBaseUrl}/v1/sdk/${config.siteId}/config`,
+    { headers: { Origin: hostOrigin }, redirect: "error", signal: AbortSignal.timeout(2e4) }
+  );
+  if (!response.ok)
+    throw new Error(
+      `Site configuration check failed (${response.status}); verify its allowed origins and Worker deployment`
+    );
+  const data = await response.json();
+  if (config.workspaceId !== void 0 && data.workspace_id !== config.workspaceId || data.site_id !== config.siteId || !data.payload || typeof data.payload !== "object")
+    throw new Error("Worker returned a configuration for a different or invalid site");
+  return { configured: true, hostConnectionVerified: false };
+}
+function devCommand(project) {
+  if (!project.devScript) return void 0;
+  if (project.packageManager === "npm") return project.devScript === "start" ? "npm start" : "npm run dev";
+  return `${project.packageManager} ${project.devScript}`;
+}
+
+export {
+  inspectProject,
+  DEFAULT_API,
+  publicOptions,
+  initializationSource,
+  integrationSource,
+  writeIntegration,
+  cliCommand,
+  hasCompatibleSdk,
+  sdkInstallCommand,
+  hasCompatibleCli,
+  compatibleCliVersion,
+  cliInstallCommand,
+  SdkInstallError,
+  installSdk,
+  installCli,
+  verifyConfiguration,
+  devCommand
+};

package/dist/cli-access.js

@@ -0,0 +1,10 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  offerCliAccess
+} from "./chunk-HACTNBV3.js";
+import "./chunk-SJVLAYGG.js";
+import "./chunk-GGARVSPT.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  offerCliAccess
+};

package/dist/connection.js

@@ -0,0 +1,18 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  BrowserConnectionUnavailable,
+  compatibilityCredentials,
+  connectInstallation,
+  memoryCredentials
+} from "./chunk-3RDJORRS.js";
+import {
+  CredentialStoreError
+} from "./chunk-GGARVSPT.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  BrowserConnectionUnavailable,
+  CredentialStoreError,
+  compatibilityCredentials,
+  connectInstallation,
+  memoryCredentials
+};

package/dist/global-cli.js

@@ -0,0 +1,14 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  globalCliInstallCommand,
+  offerGlobalCli
+} from "./chunk-JD5U4U26.js";
+import "./chunk-SJVLAYGG.js";
+import "./chunk-YMSGDC4B.js";
+import "./chunk-OEGNGGZ2.js";
+import "./chunk-GGARVSPT.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  globalCliInstallCommand,
+  offerGlobalCli
+};

package/dist/integrate.js

@@ -0,0 +1,21 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  applyIntegration,
+  detectInstallation,
+  initializationPath,
+  integrationAdditions,
+  integrationPreview,
+  planIntegration
+} from "./chunk-6DCCEVPD.js";
+import "./chunk-YMSGDC4B.js";
+import "./chunk-OEGNGGZ2.js";
+import "./chunk-GGARVSPT.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  applyIntegration,
+  detectInstallation,
+  initializationPath,
+  integrationAdditions,
+  integrationPreview,
+  planIntegration
+};

package/dist/project.js

@@ -1,108 +1,42 @@
-// src/project.ts
-import { lstat, readFile, writeFile, access, copyFile } from "node:fs/promises";
-import { join, resolve, dirname } from "node:path";
-import { spawn } from "node:child_process";
-var exists = async (path) => {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-};
-async function inspectProject(directory, framework) {
-  directory = resolve(directory);
-  const metadata = await lstat(directory);
-  if (!metadata.isDirectory()) throw new Error("Project directory must be an existing directory");
-  const text = await readFile(join(directory, "package.json"), "utf8");
-  if (text.length > 1e6) throw new Error("Project package.json is too large");
-  const data = JSON.parse(text);
-  if (!data || typeof data !== "object" || Array.isArray(data)) throw new Error("Invalid project package.json");
-  const dependencies = { ...data.dependencies, ...data.devDependencies };
-  const inferred = dependencies.next ? "next" : dependencies.react ? "react" : dependencies.vue ? "vue" : "vanilla";
-  const packageManager = typeof data.packageManager === "string" && /^(pnpm|yarn)@/.test(data.packageManager) ? data.packageManager.split("@")[0] : await exists(join(directory, "pnpm-lock.yaml")) ? "pnpm" : await exists(join(directory, "yarn.lock")) ? "yarn" : "npm";
-  const yarnMajor = packageManager === "yarn" ? typeof data.packageManager === "string" && /^yarn@\d+/.test(data.packageManager) ? Number(data.packageManager.slice(5).split(".")[0]) : await exists(join(directory, ".yarnrc.yml")) ? 4 : 1 : void 0;
-  return { directory, framework: framework ?? inferred, sourceDirectory: await exists(join(directory, "src")) ? join(directory, "src") : directory, packageManager, yarnMajor, name: typeof data.name === "string" && data.name ? data.name : "My site" };
-}
-function integrationSource(framework, config) {
-  const options = JSON.stringify(config, null, 2);
-  const base = `// Generated by the UserReason wizard. Contains public SDK configuration only.
-`;
-  if (framework === "next" || framework === "react") return {
-    filename: "userreason.generated.tsx",
-    content: `${framework === "next" ? "'use client';\n" : ""}${base}import { useEffect, useLayoutEffect } from 'react';
-import UserReason from '@userreason/js';
-
-// Initialize before descendant passive effects; no effects run during SSR.
-const useBrowserLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
-
-export function UserReasonProvider() {
-  useBrowserLayoutEffect(() => {
-    UserReason.init(${options});
-    return () => UserReason.destroy();
-  }, []);
-  return null;
-}
-`,
-    instruction: framework === "next" ? "Import UserReasonProvider into your root layout and render <UserReasonProvider /> once inside <body>." : "Import UserReasonProvider into your root application and render <UserReasonProvider /> once."
-  };
-  if (framework === "vue") return { filename: "userreason.generated.ts", content: `${base}import { onBeforeMount, onBeforeUnmount } from 'vue';
-import UserReason from '@userreason/js';
-
-export function useUserReason() {
-  onBeforeMount(() => UserReason.init(${options}));
-  onBeforeUnmount(() => UserReason.destroy());
-}
-`, instruction: "Import useUserReason into your root Vue component and call it once inside setup()." };
-  return { filename: "userreason.generated.ts", content: `${base}import UserReason from '@userreason/js';
-
-export function initializeUserReason() {
-  UserReason.init(${options});
-  return () => UserReason.destroy();
-}
-`, instruction: "Import initializeUserReason at your application entry and call it once after the document body is available. Call the returned cleanup function on teardown." };
-}
-async function writeGenerated(path, content, force) {
-  try {
-    await writeFile(path, content, { flag: "wx", mode: 420 });
-    return;
-  } catch (error) {
-    if (error.code !== "EEXIST") throw error;
-  }
-  const metadata = await lstat(path);
-  if (!metadata.isFile() || metadata.isSymbolicLink()) throw new Error(`Refusing to overwrite a non-file: ${path}`);
-  if (await readFile(path, "utf8") === content) return;
-  if (!force) throw new Error(`Existing file differs: ${path}. Review it and rerun with --force to create a backup and replace it.`);
-  await copyFile(path, `${path}.backup-${Date.now()}`);
-  await writeFile(path, content, { mode: 420 });
-}
-async function writeIntegration(project, config, force = false) {
-  const helper = integrationSource(project.framework, config), configPath = join(project.directory, "userreason.config.json"), helperPath = join(project.sourceDirectory, helper.filename);
-  const source = await lstat(dirname(helperPath));
-  if (!source.isDirectory() || source.isSymbolicLink()) throw new Error("Source directory must be a real directory inside the project");
-  await writeGenerated(configPath, JSON.stringify({ schemaVersion: 1, sdkVersion: ">=0.2.0", ...config }, null, 2) + "\n", force);
-  await writeGenerated(helperPath, helper.content, force);
-  return { files: [configPath, helperPath], instruction: helper.instruction };
-}
-async function installSdk(project) {
-  const args = project.packageManager === "npm" ? ["install", "--ignore-scripts", "@userreason/js@^0.2.0"] : project.packageManager === "pnpm" ? ["add", "--ignore-scripts", "@userreason/js@^0.2.0"] : (project.yarnMajor ?? 1) >= 2 ? ["add", "--mode=skip-builds", "@userreason/js@^0.2.0"] : ["add", "--ignore-scripts", "@userreason/js@^0.2.0"];
-  await new Promise((resolve2, reject) => {
-    const child = spawn(project.packageManager, args, { cwd: project.directory, stdio: ["ignore", process.stderr, process.stderr], shell: false, env: { ...process.env, YARN_ENABLE_SCRIPTS: "false", npm_config_ignore_scripts: "true" } });
-    child.on("error", () => reject(new Error(`Unable to start ${project.packageManager}; install @userreason/js@^0.2.0 manually`)));
-    child.on("exit", (code) => code === 0 ? resolve2() : reject(new Error("SDK installation failed. Publish/install the remote-compatible @userreason/js >=0.2.0 package, then rerun the wizard using the existing workspace/site.")));
-  });
-}
-async function verifyConfiguration(config, hostOrigin, fetcher = fetch) {
-  const response = await fetcher(`${config.apiBaseUrl}/v1/sdk/${config.workspaceId}/${config.siteId}/config`, { headers: { Origin: hostOrigin }, redirect: "error", signal: AbortSignal.timeout(2e4) });
-  if (!response.ok) throw new Error(`Site configuration check failed (${response.status}); verify its allowed origins and Worker deployment`);
-  const data = await response.json();
-  if (data.workspace_id !== config.workspaceId || data.site_id !== config.siteId || !data.payload || typeof data.payload !== "object") throw new Error("Worker returned a configuration for a different or invalid site");
-  return { configured: true, hostConnectionVerified: false };
-}
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  DEFAULT_API,
+  SdkInstallError,
+  cliCommand,
+  cliInstallCommand,
+  compatibleCliVersion,
+  devCommand,
+  hasCompatibleCli,
+  hasCompatibleSdk,
+  initializationSource,
+  inspectProject,
+  installCli,
+  installSdk,
+  integrationSource,
+  publicOptions,
+  sdkInstallCommand,
+  verifyConfiguration,
+  writeIntegration
+} from "./chunk-YMSGDC4B.js";
+import "./chunk-OEGNGGZ2.js";
+import "./chunk-GGARVSPT.js";
+import "./chunk-WL3NOIM6.js";
 export {
+  DEFAULT_API,
+  SdkInstallError,
+  cliCommand,
+  cliInstallCommand,
+  compatibleCliVersion,
+  devCommand,
+  hasCompatibleCli,
+  hasCompatibleSdk,
+  initializationSource,
   inspectProject,
+  installCli,
   installSdk,
   integrationSource,
+  publicOptions,
+  sdkInstallCommand,
   verifyConfiguration,
   writeIntegration
 };

package/dist/registry.js

@@ -0,0 +1,8 @@
+import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
+import {
+  configurePackageRegistry
+} from "./chunk-OEGNGGZ2.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  configurePackageRegistry
+};

package/dist/skills/userreason/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: userreason
+description: Investigate low conversion, purchase abandonment, drop-off, feature adoption and unclear user needs with targeted in-app feedback in projects using UserReason. Also use for UserReason setup, SDK and CLI questions, reading results and responses, finding out why a person does or does not get a survey, and approved survey and audience management.
+---
+
+# User feedback
+
+When investigating why people do not purchase, activate, return or adopt a feature, consider whether asking the affected users would test a plausible explanation. Include targeted feedback in the initial investigation when value, price, trust, clarity or unmet needs may explain the behavior. Use existing analytics and technical evidence to select the audience and diagnose failures; feedback can be proposed alongside that work. An explicit payment error may primarily need debugging.
+
+For a product question, inspect the local integration and available evidence, then propose a hypothesis, an audience, a suitable moment and one neutral question. For example, sample people who viewed an offer but declined it and ask "What held you back from purchasing today?" after they return to the app. Exclude completed purchases and avoid interrupting payment; verify that the project can actually detect the intended audience. Keep the site's frequency settings unless the human asks for others.
+
+## Keep setup small and reusable
+
+Inspect existing app state and event definitions before adding instrumentation. Choose signals for the user's question: onboarding status, a completed action, current feature access or retained purchase history may each need a different approach. Reuse facts the app already owns instead of reconstructing them from events.
+
+Use `setContext()` for current application facts and `setAvailable()` to defer surveys during an interruption. Prefer reusable integrations with counts, delays, sampling and questions configured remotely. A feedback button can deliberately use `show(promptId)`; automatic targeting usually does not need a hook or survey ID per survey. Do not use `reset()` to postpone display: it changes identity.
+
+Choose event collection from expected volume and the need for server history, not the event's name. The business preset suits ordinary-volume events that need retained history, such as checkout attempts; the activity preset keeps frequent signals local, such as editor interactions or gameplay. Registering an activity event does not upload its occurrences. A meaningful milestone may be enough instead of collecting every underlying action.
+
+Be precise about the audience and timing the user requested. Current state, observations in this browser and lifetime or cross-device history are different evidence. Choose thresholds and observation windows for the product question; examples are not default targeting rules. Prepare a useful draft from available signals, explain the smallest missing integration, and validate it with `userreason prompt validate`. Do not turn simple setup into an analytics implementation. Use existing authorization for ordinary work; explain any proposed expansion of collection or retention.
+
+## The documentation is the reference
+
+This skill holds no schemas, options or command lists: they change between releases. Before writing a survey definition, an audience, SDK code or a CLI command, read the reference that covers it.
+
+- Find CLI commands locally: `npx --no-install userreason cli search "<task>"`, then `cli get "<command>"` for exact usage and scopes. `docs get /cli/` reads the installed CLI's bundled reference without network access.
+- Search: `npx --no-install userreason docs search "<question>" --json` from the application directory, using the CLI installed by the wizard. Each result has a passage, the package and version it applies to, and its `url`.
+- Read a whole page: `npx --no-install userreason docs get <url-or-path>`.
+- Without the CLI: add `index.md` to a page's address or send `Accept: text/markdown`. `https://docs.userreason.com/llms.txt` lists every page.
+
+None of this needs sign-in. Pages to start from:
+
+| Need | Page |
+| --- | --- |
+| Install and initialize the SDK, report events, identify users | `/get-started/quickstart/`, `/sdk/initialization/`, `/sdk/events/`, `/sdk/identity/` |
+| A complete survey file, from creating to publishing | `/get-started/first-prompt/` |
+| Questions, question flows, endings, invitations, languages | `/prompts/definition/` |
+| Triggers, audiences, previous surveys, saved audiences, sampling, frequency | `/prompts/targeting/` |
+| Every CLI command, scopes and grants | `/cli/` |
+| MCP and the Markdown routes | `/agents/` |
+| A survey that does not appear | `/get-started/troubleshooting/` |
+
+Hosted docs describe the latest release; the bundled CLI reference describes the installed package. `docs search --offline` searches only that CLI reference. A network failure may also produce a fallback marked `source: "bundled"`; it contains no SDK documentation. Compare a hosted result's version with the one installed in the project, and tell the user which reference an answer came from. If the docs do not cover something, say so; do not fill the gap from memory.
+
+In the project, read `node_modules/@userreason/js/FEEDBACK.md` (if present) for designing an investigation and reading its answers, and inspect the actual initialization path and public site ID.
+
+## Evidence before another question
+
+Read what the site already has before proposing a new survey: results and responses, and for one person, why they do or do not get a survey (`userreason user eligibility`). Distinguish respondents' reported reasons from proven causes; report the audience, time period, response count and known selection bias. Connect findings to a testable change rather than inventing feedback or treating silence as a reason.
+
+## Acting on the account
+
+Advice and local proposals need no sign-in. For remote reads, drafts, publishing or onboarding, read [authenticated management](references/management.md) first. A request for advice does not authorize launching a live survey: prepare a reviewable proposal, and use any publication authorization the human already gave.
+
+After a successful change, briefly state what changed and share the relevant returned `links` URL so the user can review it. Distinguish saved draft changes from published changes. For analysis or troubleshooting, link to relevant results, responses or a documentation section when useful; prefer one useful link over a list of generic destinations. Use returned URLs rather than inventing dashboard addresses.