@boboddy/sdk 0.2.14-alpha → 0.2.15-alpha

package/dist/defaults/auth-file.d.ts

@@ -6,9 +6,38 @@ export interface AuthProfile {
 }
 export interface AuthFile {
     profiles: Record<string, AuthProfile>;
+    /**
+     * A random id generated on first read and persisted here, alongside (not
+     * inside) any per-baseUrl profile — it identifies this machine/install
+     * before any account exists, so pre-auth CLI telemetry (init started,
+     * requirements verified) has a stable distinct id to key events to. See
+     * `getOrCreateAnonymousId`.
+     */
+    anonymousId?: string;
+    /**
+     * User-level telemetry opt-out, set via `boboddy telemetry disable` (or the
+     * `BOBODDY_TELEMETRY_DISABLED` env var, checked separately at the call
+     * site). Global — unlike `profiles`, it is not scoped to a `baseUrl`.
+     */
+    telemetryDisabled?: boolean;
 }
+/** Test-only. Redirects every read/write in this module under `dir`. */
+export declare function setHomeDirForTests(dir: string | undefined): void;
 export declare const getAuthFilePath: () => string;
 export declare const loadAuthFile: () => AuthFile;
 export declare const loadAuthProfile: (baseUrl: string) => AuthProfile | null;
 export declare const saveAuthProfile: (baseUrl: string, profile: AuthProfile) => void;
 export declare const deleteAuthProfile: (baseUrl: string) => void;
+/**
+ * The persisted pre-auth distinct id for this machine/install, creating and
+ * persisting one the first time it is read. Stable across every command
+ * invocation until `~/.boboddy.json` is deleted (e.g. by `boboddy auth
+ * logout` clearing the last profile — see `deleteAuthProfile` above, which
+ * only removes the file once no profiles remain; a bare id-only file is left
+ * alone by that path since it always re-reads via `loadAuthFile`).
+ */
+export declare const getOrCreateAnonymousId: () => string;
+/** The persisted telemetry opt-out flag. Defaults to `false` (enabled). */
+export declare const isTelemetryDisabled: () => boolean;
+/** Persist the telemetry opt-out flag, leaving profiles/anonymousId intact. */
+export declare const setTelemetryDisabled: (disabled: boolean) => void;

package/dist/defaults/index.d.ts

@@ -1,4 +1,4 @@
-export { deleteAuthProfile, getAuthFilePath, loadAuthFile, loadAuthProfile, saveAuthProfile, } from "./auth-file";
+export { deleteAuthProfile, getAuthFilePath, getOrCreateAnonymousId, isTelemetryDisabled, loadAuthFile, loadAuthProfile, saveAuthProfile, setTelemetryDisabled, } from "./auth-file";
 export type { AuthFile, AuthProfile } from "./auth-file";
 export { resolveBoboddyBaseUrl } from "./base-url";
 export { loadProjectConfig, PROJECT_CONFIG_RELATIVE_PATH, } from "./project-config";

package/dist/defaults/index.js

@@ -141,8 +141,11 @@ import {
 } from "fs";
 import { dirname, join } from "path";
 import { homedir } from "os";
-var LEGACY_AUTH_FILE_PATH = join(homedir(), ".boboddy");
-var AUTH_FILE_PATH = join(homedir(), ".boboddy.json");
+import { randomUUID } from "crypto";
+var homeDirOverrideForTests;
+var resolveHomeDir = () => homeDirOverrideForTests ?? homedir();
+var legacyAuthFilePath = () => join(resolveHomeDir(), ".boboddy");
+var authFilePath = () => join(resolveHomeDir(), ".boboddy.json");
 var EMPTY_AUTH_FILE = {
   profiles: {}
 };
@@ -162,13 +165,20 @@ function isAuthProfile(value) {
 function isAuthFile(value) {
   if (typeof value !== "object" || value === null)
     return false;
-  const profiles = value["profiles"];
+  const obj = value;
+  const profiles = obj["profiles"];
   if (typeof profiles !== "object" || profiles === null)
     return false;
   for (const profile of Object.values(profiles)) {
     if (!isAuthProfile(profile))
       return false;
   }
+  if (obj["anonymousId"] !== undefined && typeof obj["anonymousId"] !== "string") {
+    return false;
+  }
+  if (obj["telemetryDisabled"] !== undefined && typeof obj["telemetryDisabled"] !== "boolean") {
+    return false;
+  }
   return true;
 }
 var ensureFilePermissions = (filePath) => {
@@ -176,7 +186,7 @@ var ensureFilePermissions = (filePath) => {
     chmodSync(filePath, 384);
   } catch {}
 };
-var getAuthFilePath = () => AUTH_FILE_PATH;
+var getAuthFilePath = () => authFilePath();
 var loadAuthFileFromPath = (filePath) => {
   if (!existsSync(filePath))
     return EMPTY_AUTH_FILE;
@@ -196,22 +206,27 @@ var loadAuthFileFromPath = (filePath) => {
   return parsed;
 };
 var loadAuthFile = () => {
-  if (existsSync(AUTH_FILE_PATH)) {
-    return loadAuthFileFromPath(AUTH_FILE_PATH);
+  const authFile = authFilePath();
+  if (existsSync(authFile)) {
+    return loadAuthFileFromPath(authFile);
   }
-  return loadAuthFileFromPath(LEGACY_AUTH_FILE_PATH);
+  return loadAuthFileFromPath(legacyAuthFilePath());
 };
 var writeAuthFile = (data) => {
-  const parentDirectory = dirname(AUTH_FILE_PATH);
+  const authFile = authFilePath();
+  const parentDirectory = dirname(authFile);
   if (!existsSync(parentDirectory)) {
     mkdirSync(parentDirectory, { recursive: true });
   }
-  const temporaryPath = `${AUTH_FILE_PATH}.${String(process.pid)}.${String(Date.now())}.tmp`;
+  const temporaryPath = `${authFile}.${String(process.pid)}.${String(Date.now())}.tmp`;
   writeFileSync(temporaryPath, `${JSON.stringify(data, null, 2)}
-`, { encoding: "utf8", mode: 384 });
+`, {
+    encoding: "utf8",
+    mode: 384
+  });
   ensureFilePermissions(temporaryPath);
-  renameSync(temporaryPath, AUTH_FILE_PATH);
-  ensureFilePermissions(AUTH_FILE_PATH);
+  renameSync(temporaryPath, authFile);
+  ensureFilePermissions(authFile);
 };
 var loadAuthProfile = (baseUrl) => {
   const authFile = loadAuthFile();
@@ -228,14 +243,28 @@ var deleteAuthProfile = (baseUrl) => {
     return;
   const remainingProfiles = Object.fromEntries(Object.entries(authFile.profiles).filter(([profileBaseUrl]) => profileBaseUrl !== baseUrl));
   if (Object.keys(remainingProfiles).length === 0) {
-    rmSync(AUTH_FILE_PATH, { force: true });
-    if (existsSync(LEGACY_AUTH_FILE_PATH) && lstatSync(LEGACY_AUTH_FILE_PATH).isFile()) {
-      rmSync(LEGACY_AUTH_FILE_PATH, { force: true });
+    rmSync(authFilePath(), { force: true });
+    const legacyPath = legacyAuthFilePath();
+    if (existsSync(legacyPath) && lstatSync(legacyPath).isFile()) {
+      rmSync(legacyPath, { force: true });
     }
     return;
   }
   writeAuthFile({ profiles: remainingProfiles });
 };
+var getOrCreateAnonymousId = () => {
+  const authFile = loadAuthFile();
+  if (authFile.anonymousId)
+    return authFile.anonymousId;
+  const anonymousId = randomUUID();
+  writeAuthFile({ ...authFile, anonymousId });
+  return anonymousId;
+};
+var isTelemetryDisabled = () => loadAuthFile().telemetryDisabled === true;
+var setTelemetryDisabled = (disabled) => {
+  const authFile = loadAuthFile();
+  writeAuthFile({ ...authFile, telemetryDisabled: disabled });
+};
 // src/defaults/base-url.ts
 var DEFAULT_BASE_URL = "https://app.boboddy.dev";
 var trimTrailingSlashes = (value) => {
@@ -309,12 +338,15 @@ async function loadPushDefaults(opts) {
   return { baseUrl, projectId, accessToken };
 }
 export {
+  setTelemetryDisabled,
   saveAuthProfile,
   resolveBoboddyBaseUrl,
   loadPushDefaults,
   loadProjectConfig,
   loadAuthProfile,
   loadAuthFile,
+  isTelemetryDisabled,
+  getOrCreateAnonymousId,
   getAuthFilePath,
   deleteAuthProfile,
   PROJECT_CONFIG_RELATIVE_PATH

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@boboddy/sdk",
-  "version": "0.2.14-alpha",
+  "version": "0.2.15-alpha",
   "type": "module",
   "exports": {
     ".": {