amplitude-auto-track 0.1.0

package/bin/generate-events.mjs

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+/**
+ * amplitude-auto-track generate
+ *
+ * Scans your app for Korean button/link text and generates event-names.json
+ * using OpenAI. Existing entries are never overwritten.
+ *
+ * Usage:
+ *   npx amplitude-auto-track               # scans ./app or ./src
+ *   npx amplitude-auto-track --dir src     # custom scan directory
+ *   npx amplitude-auto-track --out lib/events.json  # custom output path
+ */
+
+import dotenv from "dotenv";
+import fs from "fs";
+import path from "path";
+import OpenAI from "openai";
+
+dotenv.config();
+
+const ROOT = process.cwd();
+
+// ── CLI args ────────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const getArg = (flag) => {
+  const idx = args.indexOf(flag);
+  return idx !== -1 ? args[idx + 1] : null;
+};
+
+const dirArg = getArg("--dir");
+const outArg = getArg("--out");
+
+const SCAN_DIR = dirArg
+  ? path.join(ROOT, dirArg)
+  : fs.existsSync(path.join(ROOT, "app"))
+  ? path.join(ROOT, "app")
+  : path.join(ROOT, "src");
+
+const OUT_PATH = outArg
+  ? path.join(ROOT, outArg)
+  : path.join(ROOT, "lib", "event-names.json");
+
+// ── 1. Load existing mappings ───────────────────────────────────────────────
+fs.mkdirSync(path.dirname(OUT_PATH), { recursive: true });
+const existing = fs.existsSync(OUT_PATH)
+  ? JSON.parse(fs.readFileSync(OUT_PATH, "utf-8"))
+  : {};
+
+// ── 2. Scan for Korean clickable text ───────────────────────────────────────
+const hasKorean = /[\uAC00-\uD7AF]/;
+
+function extractKoreanFromInner(inner) {
+  const results = new Set();
+  const trimmed = inner.trim();
+  if (trimmed && hasKorean.test(trimmed) && !trimmed.includes("<")) {
+    results.add(trimmed);
+  }
+  const textNode = />([^<{}]*[\uAC00-\uD7AF][^<{}]*)</g;
+  let m;
+  while ((m = textNode.exec(inner)) !== null) {
+    const t = m[1].trim();
+    if (t && hasKorean.test(t)) results.add(t);
+  }
+  return results;
+}
+
+function extractClickableKorean(content) {
+  const results = new Set();
+  let m;
+  const buttonRe = /<button[\s>][^>]*>([\s\S]*?)<\/button>/gi;
+  while ((m = buttonRe.exec(content)) !== null)
+    for (const t of extractKoreanFromInner(m[1])) results.add(t);
+
+  const anchorRe = /<a\s[^>]*>([\s\S]*?)<\/a>/gi;
+  while ((m = anchorRe.exec(content)) !== null)
+    for (const t of extractKoreanFromInner(m[1])) results.add(t);
+
+  const propRe =
+    /(?:buttonText|label|aria-label|title)\s*=\s*\{?["'`]([^"'`\n]*[\uAC00-\uD7AF][^"'`\n]*)["'`]/g;
+  while ((m = propRe.exec(content)) !== null) {
+    const t = m[1].trim();
+    if (t) results.add(t);
+  }
+
+  const dataRe =
+    /(?:buttonText|label)\s*:\s*["'`]([^"'`\n]*[\uAC00-\uD7AF][^"'`\n]*)["'`]/g;
+  while ((m = dataRe.exec(content)) !== null) {
+    const t = m[1].trim();
+    if (t) results.add(t);
+  }
+
+  return results;
+}
+
+function scanDir(dir) {
+  const all = new Set();
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.name === "node_modules") continue;
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      for (const t of scanDir(full)) all.add(t);
+    } else if (entry.name.endsWith(".tsx") || entry.name.endsWith(".ts")) {
+      for (const t of extractClickableKorean(fs.readFileSync(full, "utf-8")))
+        all.add(t);
+    }
+  }
+  return all;
+}
+
+if (!fs.existsSync(SCAN_DIR)) {
+  console.error(`Error: scan directory not found: ${SCAN_DIR}`);
+  console.error(`Use --dir to specify a directory, e.g. --dir src`);
+  process.exit(1);
+}
+
+const allTexts = scanDir(SCAN_DIR);
+const toTranslate = [...allTexts].filter((t) => !existing[t]);
+
+if (toTranslate.length === 0) {
+  console.log("✓ No new texts found. event-names.json is up to date.");
+  process.exit(0);
+}
+
+console.log(`Found ${toTranslate.length} new text(s):`, toTranslate);
+
+// ── 3. Translate via OpenAI ─────────────────────────────────────────────────
+const apiKey = process.env.OPENAI_API_KEY || process.env.NEXT_PUBLIC_OPENAI_API_KEY;
+if (!apiKey) {
+  console.error("Error: OPENAI_API_KEY is not set in your .env file.");
+  process.exit(1);
+}
+
+const client = new OpenAI({ apiKey });
+const response = await client.chat.completions.create({
+  model: "gpt-4o-mini",
+  messages: [
+    {
+      role: "system",
+      content: `Convert button/link text into snake_case analytics event names.
+Rules:
+- Convert any language to English
+- Use lowercase snake_case
+- Keep it concise (max 3-4 words)
+- Add "_clicked" suffix
+- Return ONLY a JSON object mapping each input to its event name`,
+    },
+    {
+      role: "user",
+      content: `Convert these texts:\n${JSON.stringify(toTranslate)}`,
+    },
+  ],
+  temperature: 0.3,
+  response_format: { type: "json_object" },
+});
+
+const translations = JSON.parse(response.choices[0].message.content);
+const merged = { ...translations, ...existing };
+const sorted = Object.fromEntries(
+  Object.entries(merged).sort(([a], [b]) => a.localeCompare(b))
+);
+
+fs.writeFileSync(OUT_PATH, JSON.stringify(sorted, null, 2) + "\n");
+console.log(`✓ Wrote ${Object.keys(sorted).length} entries to ${path.relative(ROOT, OUT_PATH)}`);

package/dist/index.d.mts

@@ -0,0 +1,30 @@
+interface InitAmplitudeOptions {
+    /** Event name map generated by `npx amplitude-auto-track`. */
+    eventNames?: Record<string, string>;
+    /** Amplitude API key. Falls back to NEXT_PUBLIC_AMPLITUDE_API_KEY. */
+    apiKey?: string;
+}
+interface AmplitudeTrackDetail {
+    name: string;
+    displayName: string;
+    props: Record<string, string | number>;
+}
+
+/** CustomEvent name fired on window after every amplitude.track() call. */
+declare const AMPLITUDE_TRACK_EVENT: "amplitude:track";
+/**
+ * Initialize Amplitude and start auto-tracking all button/link clicks.
+ *
+ * @example
+ * import { initAmplitude } from 'amplitude-auto-track'
+ * import eventNames from './lib/event-names.json'
+ *
+ * initAmplitude({ eventNames })
+ */
+declare function initAmplitude(options?: InitAmplitudeOptions): void;
+/**
+ * Send an event to Amplitude directly and emit an `amplitude:track` window event.
+ */
+declare function handleTrackEvent(logName: string, displayName: string, customFields?: Record<string, string | number>): void;
+
+export { AMPLITUDE_TRACK_EVENT, type AmplitudeTrackDetail, type InitAmplitudeOptions, handleTrackEvent, initAmplitude };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+interface InitAmplitudeOptions {
+    /** Event name map generated by `npx amplitude-auto-track`. */
+    eventNames?: Record<string, string>;
+    /** Amplitude API key. Falls back to NEXT_PUBLIC_AMPLITUDE_API_KEY. */
+    apiKey?: string;
+}
+interface AmplitudeTrackDetail {
+    name: string;
+    displayName: string;
+    props: Record<string, string | number>;
+}
+
+/** CustomEvent name fired on window after every amplitude.track() call. */
+declare const AMPLITUDE_TRACK_EVENT: "amplitude:track";
+/**
+ * Initialize Amplitude and start auto-tracking all button/link clicks.
+ *
+ * @example
+ * import { initAmplitude } from 'amplitude-auto-track'
+ * import eventNames from './lib/event-names.json'
+ *
+ * initAmplitude({ eventNames })
+ */
+declare function initAmplitude(options?: InitAmplitudeOptions): void;
+/**
+ * Send an event to Amplitude directly and emit an `amplitude:track` window event.
+ */
+declare function handleTrackEvent(logName: string, displayName: string, customFields?: Record<string, string | number>): void;
+
+export { AMPLITUDE_TRACK_EVENT, type AmplitudeTrackDetail, type InitAmplitudeOptions, handleTrackEvent, initAmplitude };

package/dist/index.js

@@ -0,0 +1,202 @@
+'use strict';
+
+var amplitude = require('@amplitude/analytics-browser');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var amplitude__namespace = /*#__PURE__*/_interopNamespace(amplitude);
+
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var AMPLITUDE_TRACK_EVENT = "amplitude:track";
+var eventMap = {};
+function getEventName(text) {
+  var _a;
+  if (!text) return "button_clicked";
+  return (_a = eventMap[text.trim()]) != null ? _a : "button_clicked";
+}
+function inferLocationFromDOM(el) {
+  let current = el.parentElement;
+  while (current && current !== document.body) {
+    const tag = current.tagName.toLowerCase();
+    if (tag === "nav") return current.id || "navbar";
+    if (tag === "header") return current.id || "header";
+    if (tag === "footer") return current.id || "footer";
+    if (tag === "main") return current.id || "main";
+    if (tag === "aside") return current.id || "aside";
+    if (tag === "section") {
+      if (current.id) return current.id;
+      const sections = Array.from(document.querySelectorAll("section"));
+      const idx = sections.indexOf(current);
+      return idx >= 0 ? `section_${idx + 1}` : "section";
+    }
+    current = current.parentElement;
+  }
+  return "page";
+}
+function inferContext(el, tagName) {
+  var _a, _b;
+  const location = el.dataset.location || inferLocationFromDOM(el) || "page";
+  let section = (_a = el.dataset.section) != null ? _a : "";
+  if (!section) {
+    const sectionEl = el.closest("section[id]");
+    if (sectionEl) section = sectionEl.id;
+    else if (el.closest("nav") || el.closest("header")) section = "header";
+    else section = "main";
+  }
+  const buttonType = (_b = el.dataset.buttonType) != null ? _b : tagName === "A" ? "link" : "button";
+  return { buttonType, location, section };
+}
+function inferLocationLabel(el) {
+  let current = el.parentElement;
+  while (current && current !== document.body) {
+    const tag = current.tagName.toLowerCase();
+    if (tag === "nav") return current.id || "nav";
+    if (tag === "header") return current.id || "header";
+    if (tag === "footer") return current.id || "footer";
+    if (tag === "main") return current.id || "main";
+    if (tag === "aside") return current.id || "aside";
+    if (tag === "section") {
+      if (current.id) return current.id;
+      const sections = Array.from(document.querySelectorAll("section"));
+      const idx = sections.indexOf(current);
+      return idx >= 0 ? `section_${idx + 1}` : "section";
+    }
+    current = current.parentElement;
+  }
+  return "page";
+}
+function autoTagDuplicateElements() {
+  var _a;
+  const elements = Array.from(
+    document.querySelectorAll("button, a")
+  );
+  const groups = /* @__PURE__ */ new Map();
+  for (const el of elements) {
+    const text = (_a = el.textContent) == null ? void 0 : _a.trim();
+    if (!text) continue;
+    if (!groups.has(text)) groups.set(text, []);
+    groups.get(text).push(el);
+  }
+  for (const [, els] of groups) {
+    if (els.length <= 1) continue;
+    for (const el of els) {
+      if (!el.dataset.location) {
+        el.dataset.location = inferLocationLabel(el);
+      }
+    }
+  }
+}
+var trackingInitialized = false;
+var debounceTimer = null;
+function scheduleAutoTag() {
+  if (debounceTimer) clearTimeout(debounceTimer);
+  debounceTimer = setTimeout(() => {
+    autoTagDuplicateElements();
+    debounceTimer = null;
+  }, 200);
+}
+function initAmplitude(options) {
+  var _a, _b;
+  if (options == null ? void 0 : options.eventNames) eventMap = options.eventNames;
+  const apiKey = (_b = options == null ? void 0 : options.apiKey) != null ? _b : typeof process !== "undefined" ? (_a = process.env.NEXT_PUBLIC_AMPLITUDE_API_KEY) != null ? _a : "" : "";
+  amplitude__namespace.init(apiKey, void 0, {
+    defaultTracking: {
+      sessions: true,
+      pageViews: true,
+      formInteractions: true,
+      fileDownloads: true
+    }
+  });
+  if (typeof window === "undefined") return;
+  if (trackingInitialized) return;
+  trackingInitialized = true;
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", autoTagDuplicateElements);
+  } else {
+    autoTagDuplicateElements();
+  }
+  const observer = new MutationObserver(scheduleAutoTag);
+  observer.observe(document.body, { childList: true, subtree: true });
+  document.addEventListener("click", (event) => {
+    var _a2, _b2;
+    const target = event.target;
+    const tagName = target.tagName;
+    const ctx = inferContext(target, tagName);
+    if (tagName === "BUTTON") {
+      const text = ((_a2 = target.textContent) == null ? void 0 : _a2.trim()) || "";
+      handleTrackEvent(getEventName(text), text, {
+        button_text: text,
+        button_class: target.className || "",
+        element_id: target.id || "",
+        element_type: "button",
+        text_length: text.length,
+        button_type: ctx.buttonType,
+        location: ctx.location,
+        section: ctx.section
+      });
+    }
+    if (tagName === "A") {
+      const text = ((_b2 = target.textContent) == null ? void 0 : _b2.trim()) || "";
+      handleTrackEvent(getEventName(text), text, {
+        link_text: text,
+        link_href: target.href || "",
+        element_id: target.id || "",
+        element_type: "link",
+        text_length: text.length,
+        button_type: ctx.buttonType,
+        location: ctx.location,
+        section: ctx.section
+      });
+    }
+  });
+}
+function handleTrackEvent(logName, displayName, customFields = {}) {
+  amplitude__namespace.track(logName, __spreadProps(__spreadValues({}, customFields), {
+    event_display_name: String(displayName || "")
+  }));
+  if (typeof window !== "undefined") {
+    window.dispatchEvent(
+      new CustomEvent(AMPLITUDE_TRACK_EVENT, {
+        detail: { name: logName, displayName, props: customFields }
+      })
+    );
+  }
+}
+
+exports.AMPLITUDE_TRACK_EVENT = AMPLITUDE_TRACK_EVENT;
+exports.handleTrackEvent = handleTrackEvent;
+exports.initAmplitude = initAmplitude;

package/dist/index.mjs

@@ -0,0 +1,178 @@
+import * as amplitude from '@amplitude/analytics-browser';
+
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var AMPLITUDE_TRACK_EVENT = "amplitude:track";
+var eventMap = {};
+function getEventName(text) {
+  var _a;
+  if (!text) return "button_clicked";
+  return (_a = eventMap[text.trim()]) != null ? _a : "button_clicked";
+}
+function inferLocationFromDOM(el) {
+  let current = el.parentElement;
+  while (current && current !== document.body) {
+    const tag = current.tagName.toLowerCase();
+    if (tag === "nav") return current.id || "navbar";
+    if (tag === "header") return current.id || "header";
+    if (tag === "footer") return current.id || "footer";
+    if (tag === "main") return current.id || "main";
+    if (tag === "aside") return current.id || "aside";
+    if (tag === "section") {
+      if (current.id) return current.id;
+      const sections = Array.from(document.querySelectorAll("section"));
+      const idx = sections.indexOf(current);
+      return idx >= 0 ? `section_${idx + 1}` : "section";
+    }
+    current = current.parentElement;
+  }
+  return "page";
+}
+function inferContext(el, tagName) {
+  var _a, _b;
+  const location = el.dataset.location || inferLocationFromDOM(el) || "page";
+  let section = (_a = el.dataset.section) != null ? _a : "";
+  if (!section) {
+    const sectionEl = el.closest("section[id]");
+    if (sectionEl) section = sectionEl.id;
+    else if (el.closest("nav") || el.closest("header")) section = "header";
+    else section = "main";
+  }
+  const buttonType = (_b = el.dataset.buttonType) != null ? _b : tagName === "A" ? "link" : "button";
+  return { buttonType, location, section };
+}
+function inferLocationLabel(el) {
+  let current = el.parentElement;
+  while (current && current !== document.body) {
+    const tag = current.tagName.toLowerCase();
+    if (tag === "nav") return current.id || "nav";
+    if (tag === "header") return current.id || "header";
+    if (tag === "footer") return current.id || "footer";
+    if (tag === "main") return current.id || "main";
+    if (tag === "aside") return current.id || "aside";
+    if (tag === "section") {
+      if (current.id) return current.id;
+      const sections = Array.from(document.querySelectorAll("section"));
+      const idx = sections.indexOf(current);
+      return idx >= 0 ? `section_${idx + 1}` : "section";
+    }
+    current = current.parentElement;
+  }
+  return "page";
+}
+function autoTagDuplicateElements() {
+  var _a;
+  const elements = Array.from(
+    document.querySelectorAll("button, a")
+  );
+  const groups = /* @__PURE__ */ new Map();
+  for (const el of elements) {
+    const text = (_a = el.textContent) == null ? void 0 : _a.trim();
+    if (!text) continue;
+    if (!groups.has(text)) groups.set(text, []);
+    groups.get(text).push(el);
+  }
+  for (const [, els] of groups) {
+    if (els.length <= 1) continue;
+    for (const el of els) {
+      if (!el.dataset.location) {
+        el.dataset.location = inferLocationLabel(el);
+      }
+    }
+  }
+}
+var trackingInitialized = false;
+var debounceTimer = null;
+function scheduleAutoTag() {
+  if (debounceTimer) clearTimeout(debounceTimer);
+  debounceTimer = setTimeout(() => {
+    autoTagDuplicateElements();
+    debounceTimer = null;
+  }, 200);
+}
+function initAmplitude(options) {
+  var _a, _b;
+  if (options == null ? void 0 : options.eventNames) eventMap = options.eventNames;
+  const apiKey = (_b = options == null ? void 0 : options.apiKey) != null ? _b : typeof process !== "undefined" ? (_a = process.env.NEXT_PUBLIC_AMPLITUDE_API_KEY) != null ? _a : "" : "";
+  amplitude.init(apiKey, void 0, {
+    defaultTracking: {
+      sessions: true,
+      pageViews: true,
+      formInteractions: true,
+      fileDownloads: true
+    }
+  });
+  if (typeof window === "undefined") return;
+  if (trackingInitialized) return;
+  trackingInitialized = true;
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", autoTagDuplicateElements);
+  } else {
+    autoTagDuplicateElements();
+  }
+  const observer = new MutationObserver(scheduleAutoTag);
+  observer.observe(document.body, { childList: true, subtree: true });
+  document.addEventListener("click", (event) => {
+    var _a2, _b2;
+    const target = event.target;
+    const tagName = target.tagName;
+    const ctx = inferContext(target, tagName);
+    if (tagName === "BUTTON") {
+      const text = ((_a2 = target.textContent) == null ? void 0 : _a2.trim()) || "";
+      handleTrackEvent(getEventName(text), text, {
+        button_text: text,
+        button_class: target.className || "",
+        element_id: target.id || "",
+        element_type: "button",
+        text_length: text.length,
+        button_type: ctx.buttonType,
+        location: ctx.location,
+        section: ctx.section
+      });
+    }
+    if (tagName === "A") {
+      const text = ((_b2 = target.textContent) == null ? void 0 : _b2.trim()) || "";
+      handleTrackEvent(getEventName(text), text, {
+        link_text: text,
+        link_href: target.href || "",
+        element_id: target.id || "",
+        element_type: "link",
+        text_length: text.length,
+        button_type: ctx.buttonType,
+        location: ctx.location,
+        section: ctx.section
+      });
+    }
+  });
+}
+function handleTrackEvent(logName, displayName, customFields = {}) {
+  amplitude.track(logName, __spreadProps(__spreadValues({}, customFields), {
+    event_display_name: String(displayName || "")
+  }));
+  if (typeof window !== "undefined") {
+    window.dispatchEvent(
+      new CustomEvent(AMPLITUDE_TRACK_EVENT, {
+        detail: { name: logName, displayName, props: customFields }
+      })
+    );
+  }
+}
+
+export { AMPLITUDE_TRACK_EVENT, handleTrackEvent, initAmplitude };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "amplitude-auto-track",
+  "version": "0.1.0",
+  "description": "Zero-config Amplitude auto-tracking for Korean Next.js apps. Build-time event name generation via OpenAI + DOM-inferred location/section.",
+  "keywords": [
+    "amplitude",
+    "analytics",
+    "next.js",
+    "auto-track",
+    "korean"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "amplitude-auto-track": "./bin/generate-events.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@amplitude/analytics-browser": "^2.36.5",
+    "next": ">=13"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsup": "^8",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "dotenv": "^17.3.1",
+    "openai": "^6.29.0"
+  }
+}