@appmachina/node 0.0.1 → 2.2.0

package/dist/index.js

@@ -0,0 +1,550 @@
+import { t as appMachinaDebugMiddleware } from "./express-CeETK4sI.js";
+import { t as FilePersistence } from "./persistence-D_zFNklE.js";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { AppMachinaCore, AppMachinaError, FetchHttpClient } from "@appmachina/core-wasm";
+
+//#region src/standard-events.ts
+/**
+* Predefined standard event name constants.
+*
+* Usage:
+* ```ts
+* import { StandardEvents } from '@appmachina/node';
+* appmachina.track(distinctId, StandardEvents.PURCHASE, { amount: 9.99 });
+* ```
+*/
+const StandardEvents = {
+	APP_INSTALL: "app_install",
+	APP_OPEN: "app_open",
+	LOGIN: "login",
+	SIGN_UP: "sign_up",
+	REGISTER: "register",
+	PURCHASE: "purchase_success",
+	ADD_TO_CART: "add_to_cart",
+	ADD_TO_WISHLIST: "add_to_wishlist",
+	INITIATE_CHECKOUT: "initiate_checkout",
+	BEGIN_CHECKOUT: "begin_checkout",
+	START_TRIAL: "start_trial",
+	SUBSCRIBE: "subscribe",
+	LEVEL_START: "level_start",
+	LEVEL_COMPLETE: "level_complete",
+	TUTORIAL_COMPLETE: "tutorial_complete",
+	SEARCH: "search",
+	VIEW_ITEM: "view_item",
+	VIEW_CONTENT: "view_content",
+	SHARE: "share",
+	DEEP_LINK: "deep_link_opened",
+	SCREEN_VIEW: "screen_view"
+};
+
+//#endregion
+//#region src/commerce.ts
+/**
+* Track a successful purchase for a specific user.
+*
+* ```ts
+* import { trackPurchase } from '@appmachina/node';
+*
+* trackPurchase(sdk, 'user_123', {
+*   productId: 'premium_monthly',
+*   price: 9.99,
+*   currency: 'USD',
+*   transactionId: 'txn_abc123',
+* });
+* ```
+*/
+function trackPurchase(sdk, distinctId, params) {
+	const quantity = params.quantity ?? 1;
+	const props = {
+		product_id: params.productId,
+		price: params.price,
+		currency: params.currency,
+		quantity,
+		revenue: params.price * quantity,
+		...params.properties
+	};
+	if (params.transactionId !== void 0) props.transaction_id = params.transactionId;
+	if (params.isRestored !== void 0) props.is_restored = params.isRestored;
+	if (params.store !== void 0) props.store = params.store;
+	sdk.track(distinctId, "purchase_success", props);
+}
+/**
+* Track a failed purchase attempt for a specific user.
+*/
+function trackPurchaseFailed(sdk, distinctId, params) {
+	const props = {
+		product_id: params.productId,
+		currency: params.currency,
+		error_code: params.errorCode,
+		...params.properties
+	};
+	if (params.errorMessage !== void 0) props.error_message = params.errorMessage;
+	sdk.track(distinctId, "purchase_failed", props);
+}
+/**
+* Track a subscription purchase or renewal for a specific user.
+*
+* ```ts
+* import { trackSubscription } from '@appmachina/node';
+*
+* trackSubscription(sdk, 'user_123', {
+*   productId: 'pro_annual',
+*   price: 49.99,
+*   currency: 'USD',
+*   period: 'P1Y',
+* });
+* ```
+*/
+function trackSubscription(sdk, distinctId, params) {
+	const props = {
+		product_id: params.productId,
+		price: params.price,
+		currency: params.currency,
+		quantity: 1,
+		revenue: params.price,
+		...params.properties
+	};
+	if (params.transactionId !== void 0) props.transaction_id = params.transactionId;
+	if (params.period !== void 0) props.period = params.period;
+	if (params.isRenewal !== void 0) props.is_renewal = params.isRenewal;
+	if (params.isTrial !== void 0) props.is_trial = params.isTrial;
+	if (params.subscriptionGroupId !== void 0) props.subscription_group_id = params.subscriptionGroupId;
+	if (params.originalTransactionId !== void 0) props.original_transaction_id = params.originalTransactionId;
+	sdk.track(distinctId, "subscribe", props);
+}
+/**
+* Track a completed order with multiple line items for a specific user.
+*/
+function trackOrder(sdk, distinctId, params) {
+	const currency = params.currency ?? "USD";
+	let total = params.subtotal;
+	if (params.tax !== void 0) total += params.tax;
+	if (params.shipping !== void 0) total += params.shipping;
+	if (params.discount !== void 0) total -= params.discount;
+	const props = {
+		order_id: params.orderId,
+		subtotal: params.subtotal,
+		total,
+		currency,
+		item_count: params.items.length,
+		revenue: total,
+		product_ids: params.items.map((i) => i.productId).join(","),
+		...params.properties
+	};
+	if (params.tax !== void 0) props.tax = params.tax;
+	if (params.shipping !== void 0) props.shipping = params.shipping;
+	if (params.discount !== void 0) props.discount = params.discount;
+	if (params.couponCode !== void 0) props.coupon_code = params.couponCode;
+	sdk.track(distinctId, "purchase_success", props);
+}
+/**
+* Track an item being added to the cart for a specific user.
+*/
+function trackAddToCart(sdk, distinctId, item, properties) {
+	const quantity = item.quantity ?? 1;
+	const props = {
+		product_id: item.productId,
+		product_name: item.name,
+		price: item.price,
+		quantity,
+		value: item.price * quantity,
+		...properties
+	};
+	if (item.category !== void 0) props.category = item.category;
+	sdk.track(distinctId, "add_to_cart", props);
+}
+/**
+* Track an item being removed from the cart for a specific user.
+*/
+function trackRemoveFromCart(sdk, distinctId, item, properties) {
+	const quantity = item.quantity ?? 1;
+	const props = {
+		product_id: item.productId,
+		product_name: item.name,
+		price: item.price,
+		quantity,
+		...properties
+	};
+	if (item.category !== void 0) props.category = item.category;
+	sdk.track(distinctId, "remove_from_cart", props);
+}
+/**
+* Track beginning the checkout flow for a specific user.
+*/
+function trackBeginCheckout(sdk, distinctId, items, currency = "USD", properties) {
+	const total = items.reduce((sum, item) => sum + item.price * (item.quantity ?? 1), 0);
+	const props = {
+		item_count: items.length,
+		value: total,
+		currency,
+		product_ids: items.map((i) => i.productId).join(","),
+		...properties
+	};
+	sdk.track(distinctId, "begin_checkout", props);
+}
+/**
+* Track viewing a product detail page for a specific user.
+*/
+function trackViewProduct(sdk, distinctId, productId, name, price, currency = "USD", category, properties) {
+	const props = {
+		product_id: productId,
+		product_name: name,
+		price,
+		currency,
+		...properties
+	};
+	if (category !== void 0) props.category = category;
+	sdk.track(distinctId, "view_item", props);
+}
+/**
+* Track a refund for a specific user.
+*/
+function trackRefund(sdk, distinctId, params) {
+	const props = {
+		transaction_id: params.transactionId,
+		amount: params.amount,
+		currency: params.currency,
+		...params.properties
+	};
+	if (params.reason !== void 0) props.reason = params.reason;
+	sdk.track(distinctId, "refund", props);
+}
+
+//#endregion
+//#region src/index.ts
+const SDK_VERSION = typeof __APPMACHINA_NODE_VERSION__ !== "undefined" ? __APPMACHINA_NODE_VERSION__ : "0.1.0";
+var AppMachinaNode = class AppMachinaNode {
+	core;
+	config;
+	enableDebug;
+	baseUrl;
+	shutdownFlushTimeoutMs;
+	isShutDown = false;
+	errorListeners = [];
+	static globalSignalHandlersRegistered = false;
+	static instances = [];
+	_instanceId;
+	_initDurationMs;
+	constructor(config) {
+		const initStart = performance.now();
+		this.config = config;
+		this.enableDebug = config.enableDebug ?? false;
+		this.baseUrl = (config.baseUrl ?? "https://in.appmachina.com").replace(/\/$/, "");
+		this.shutdownFlushTimeoutMs = config.shutdownFlushTimeoutMs ?? 5e3;
+		this._instanceId = getOrCreateInstanceId(config.appId, config.persistenceDir);
+		const persistence = new FilePersistence(config.appId, config.persistenceDir);
+		const httpClient = new FetchHttpClient(3e4);
+		this.core = AppMachinaCore.init({
+			config: {
+				appId: config.appId,
+				environment: config.environment,
+				...config.baseUrl != null && { baseUrl: config.baseUrl },
+				...config.enableDebug != null && { enableDebug: config.enableDebug },
+				flushIntervalMs: config.flushIntervalMs ?? 1e4,
+				flushThreshold: config.flushThreshold ?? 20,
+				...config.maxQueueSize != null && { maxQueueSize: config.maxQueueSize },
+				...config.maxBatchSize != null && { maxBatchSize: config.maxBatchSize },
+				sdkVersion: `node/${SDK_VERSION}`
+			},
+			httpClient,
+			persistence
+		});
+		this.core.setDeviceContext({
+			platform: "node",
+			osVersion: `${process.platform} ${process.version}`,
+			appVersion: SDK_VERSION,
+			deviceModel: process.arch,
+			locale: Intl.DateTimeFormat().resolvedOptions().locale ?? "en-US",
+			installId: this._instanceId
+		});
+		if (config.handleSignals !== false) this.registerSignalHandlers();
+		this._initDurationMs = Math.round((performance.now() - initStart) * 100) / 100;
+	}
+	/**
+	* Complete asynchronous initialization: fetches remote config and tracks init timing.
+	*
+	* Call this after constructing the instance. The constructor handles synchronous
+	* setup; this method handles async work (remote config fetch) and fires the
+	* `appmachina_init_timing` event.
+	*/
+	async init() {
+		await this.core.fetchRemoteConfig().catch(() => {});
+		if (this._initDurationMs != null) try {
+			this.core.track("appmachina_init_timing", {
+				duration_ms: this._initDurationMs,
+				platform: "node"
+			}, "system");
+		} catch {}
+		try {
+			this.core.track("server_start", {
+				platform: "node",
+				node_version: process.version,
+				duration_ms: this._initDurationMs
+			}, "system");
+		} catch {}
+	}
+	/**
+	* Track an event for a specific user.
+	*
+	* Unlike @appmachina/client which stores the user ID via identify(),
+	* the Node.js SDK requires a distinctId on every call. This is the
+	* correct pattern for server-side SDKs where requests come from
+	* many users concurrently.
+	*/
+	track(distinctId, eventName, properties) {
+		if (this.isShutDown) return;
+		if (this.enableDebug) console.log(`[AppMachina] track("${eventName}", ${Object.keys(properties ?? {}).length} properties, distinctId="${distinctId}")`);
+		if (!distinctId || typeof distinctId !== "string") {
+			this.emitError(/* @__PURE__ */ new Error("distinctId must be a non-empty string"));
+			return;
+		}
+		try {
+			const depthBefore = this.core.queueDepth();
+			this.core.track(eventName, properties, distinctId);
+			const depthAfter = this.core.queueDepth();
+			if (depthAfter <= depthBefore && this.enableDebug) console.warn(`[AppMachina] Event "${eventName}" may not have been accepted (queue depth ${depthBefore} -> ${depthAfter})`);
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Track a screen view for a specific user.
+	*/
+	screen(distinctId, screenName, properties) {
+		if (this.isShutDown) return;
+		if (this.enableDebug) console.log(`[AppMachina] screen("${screenName}", ${Object.keys(properties ?? {}).length} properties, distinctId="${distinctId}")`);
+		if (!distinctId || typeof distinctId !== "string") {
+			this.emitError(/* @__PURE__ */ new Error("distinctId must be a non-empty string"));
+			return;
+		}
+		try {
+			this.core.screen(screenName, properties, distinctId);
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Set user properties for a specific user.
+	*
+	* Calls identify(distinctId) first so the core associates
+	* these properties with the correct user.
+	*
+	* Note: identify(distinctId) and setUserProperties are two separate calls.
+	* In concurrent server environments, interleaving is possible. For atomic
+	* user property updates, the Rust core would need a single
+	* identify-and-set-properties API.
+	*/
+	setUserProperties(distinctId, properties) {
+		if (this.isShutDown) return;
+		if (this.enableDebug) console.log(`[AppMachina] setUserProperties(${Object.keys(properties ?? {}).length} properties, distinctId="${distinctId}")`);
+		if (!distinctId || typeof distinctId !== "string") {
+			this.emitError(/* @__PURE__ */ new Error("distinctId must be a non-empty string"));
+			return;
+		}
+		try {
+			this.core.identify(distinctId);
+			this.core.setUserProperties(properties);
+			this.sendUserPropertiesAsync(distinctId, properties, false);
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Set user properties with "set once" semantics for a specific user.
+	*
+	* Only properties whose keys have not been previously set via this method
+	* are forwarded. Calls identify(distinctId) first so the core associates
+	* these properties with the correct user.
+	*/
+	setUserPropertiesOnce(distinctId, properties) {
+		if (this.isShutDown) return;
+		if (this.enableDebug) console.log(`[AppMachina] setUserPropertiesOnce(${Object.keys(properties ?? {}).length} properties, distinctId="${distinctId}")`);
+		if (!distinctId || typeof distinctId !== "string") {
+			this.emitError(/* @__PURE__ */ new Error("distinctId must be a non-empty string"));
+			return;
+		}
+		try {
+			this.core.identify(distinctId);
+			this.core.setUserPropertiesOnce(properties);
+			this.sendUserPropertiesAsync(distinctId, properties, true);
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Associate events for a specific user with a group (company, team, organization).
+	*
+	* Unlike @appmachina/client which stores the group ID, the Node.js SDK
+	* follows the server-side pattern where distinctId is required on every call.
+	* The group association is set on the core and a `group` event is tracked
+	* with the provided properties.
+	*/
+	group(distinctId, groupId, properties) {
+		if (this.isShutDown) return;
+		if (this.enableDebug) console.log(`[AppMachina] group("${groupId}", ${Object.keys(properties ?? {}).length} properties, distinctId="${distinctId}")`);
+		if (!distinctId || typeof distinctId !== "string") {
+			this.emitError(/* @__PURE__ */ new Error("distinctId must be a non-empty string"));
+			return;
+		}
+		try {
+			this.core.identify(distinctId);
+			this.core.group(groupId, properties);
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Update consent state.
+	*
+	* Consent applies globally to this SDK instance, not per-user.
+	* All events from this instance will respect the configured consent state.
+	*/
+	setConsent(consent) {
+		if (this.isShutDown) return;
+		try {
+			this.core.setConsent(consent);
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Get the persistent instance ID for this server instance.
+	*
+	* The instance ID is a UUID generated on first init and persisted to the
+	* filesystem so it survives process restarts. Stored in
+	* `.appmachina-instance-id` inside the persistence directory.
+	*/
+	getInstanceId() {
+		return this._instanceId;
+	}
+	/**
+	* Get current session ID.
+	*/
+	getSessionId() {
+		return this.core.getSessionId();
+	}
+	/**
+	* Get current consent state.
+	*/
+	getConsentState() {
+		return this.core.getConsentState();
+	}
+	/**
+	* Get number of queued events.
+	*/
+	queueDepth() {
+		return this.core.queueDepth();
+	}
+	/**
+	* Flush all queued events to the server.
+	*/
+	async flush() {
+		if (this.isShutDown) return;
+		try {
+			await this.core.flushAsync();
+		} catch (e) {
+			this.emitError(e);
+		}
+	}
+	/**
+	* Gracefully shut down: flush remaining events, then stop.
+	*/
+	async shutdown() {
+		if (this.isShutDown) return;
+		this.isShutDown = true;
+		const idx = AppMachinaNode.instances.indexOf(this);
+		if (idx !== -1) AppMachinaNode.instances.splice(idx, 1);
+		try {
+			await Promise.race([this.core.flushAsync(), new Promise((resolve) => setTimeout(resolve, this.shutdownFlushTimeoutMs))]);
+		} catch {}
+		this.core.shutdown();
+	}
+	/**
+	* Register an error listener. Errors from track/screen/flush
+	* that would otherwise be silently dropped are forwarded here.
+	*/
+	on(event, listener) {
+		this.errorListeners.push(listener);
+		return this;
+	}
+	/**
+	* Remove a previously registered error listener.
+	*/
+	off(event, listener) {
+		const idx = this.errorListeners.indexOf(listener);
+		if (idx !== -1) this.errorListeners.splice(idx, 1);
+		return this;
+	}
+	emitError(e) {
+		const error = e instanceof Error ? e : new Error(String(e));
+		for (const listener of this.errorListeners) try {
+			listener(error);
+		} catch {}
+		if (this.enableDebug && this.errorListeners.length === 0) console.warn("[AppMachina]", error.message);
+	}
+	/**
+	* Fire-and-forget POST to /users/properties.
+	* Best-effort: errors are silently swallowed.
+	*/
+	sendUserPropertiesAsync(distinctId, properties, setOnce) {
+		const payload = {
+			app_id: this.config.appId,
+			app_user_id: distinctId,
+			properties,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		if (setOnce) payload.set_once = true;
+		fetch(`${this.baseUrl}/users/properties`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"X-App-Id": this.config.appId,
+				"X-SDK-Version": `node/${SDK_VERSION}`
+			},
+			body: JSON.stringify(payload)
+		}).catch(() => {});
+	}
+	registerSignalHandlers() {
+		AppMachinaNode.instances.push(this);
+		if (AppMachinaNode.globalSignalHandlersRegistered) return;
+		AppMachinaNode.globalSignalHandlersRegistered = true;
+		const handler = (signal) => {
+			for (const instance of AppMachinaNode.instances) try {
+				instance.core.track("server_shutdown", { reason: signal }, "system");
+			} catch {}
+			const shutdowns = AppMachinaNode.instances.map((inst) => inst.shutdown());
+			Promise.allSettled(shutdowns).then(() => {
+				process.kill(process.pid, signal);
+			});
+		};
+		process.once("SIGTERM", () => handler("SIGTERM"));
+		process.once("SIGINT", () => handler("SIGINT"));
+	}
+};
+const INSTANCE_ID_FILENAME = ".appmachina-instance-id";
+/**
+* Read or create a persistent instance ID on the filesystem.
+* Uses `crypto.randomUUID()` for generation.
+*/
+function getOrCreateInstanceId(appId, baseDir) {
+	const dir = join(baseDir ?? tmpdir(), "appmachina-sdk", appId);
+	const filePath = join(dir, INSTANCE_ID_FILENAME);
+	try {
+		if (existsSync(filePath)) {
+			const existing = readFileSync(filePath, "utf-8").trim();
+			if (existing) return existing;
+		}
+	} catch {}
+	const newId = crypto.randomUUID();
+	try {
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+		writeFileSync(filePath, newId, "utf-8");
+	} catch {}
+	return newId;
+}
+
+//#endregion
+export { AppMachinaError, AppMachinaNode, FilePersistence, StandardEvents, appMachinaDebugMiddleware, trackAddToCart, trackBeginCheckout, trackOrder, trackPurchase, trackPurchaseFailed, trackRefund, trackRemoveFromCart, trackSubscription, trackViewProduct };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["props: EventProperties","SDK_VERSION: string","payload: Record<string, unknown>"],"sources":["../src/standard-events.ts","../src/commerce.ts","../src/index.ts"],"sourcesContent":["// Standard event types for AppMachina Analytics.\n// These 18 events match the canonical AppMachina event taxonomy\n// and are consistent across all SDK platforms.\n\n/**\n * Predefined standard event name constants.\n *\n * Usage:\n * ```ts\n * import { StandardEvents } from '@appmachina/node';\n * appmachina.track(distinctId, StandardEvents.PURCHASE, { amount: 9.99 });\n * ```\n */\nexport const StandardEvents = {\n  APP_INSTALL: 'app_install',\n  APP_OPEN: 'app_open',\n  LOGIN: 'login',\n  SIGN_UP: 'sign_up',\n  REGISTER: 'register',\n  PURCHASE: 'purchase_success',\n  ADD_TO_CART: 'add_to_cart',\n  ADD_TO_WISHLIST: 'add_to_wishlist',\n  INITIATE_CHECKOUT: 'initiate_checkout',\n  BEGIN_CHECKOUT: 'begin_checkout',\n  START_TRIAL: 'start_trial',\n  SUBSCRIBE: 'subscribe',\n  LEVEL_START: 'level_start',\n  LEVEL_COMPLETE: 'level_complete',\n  TUTORIAL_COMPLETE: 'tutorial_complete',\n  SEARCH: 'search',\n  VIEW_ITEM: 'view_item',\n  VIEW_CONTENT: 'view_content',\n  SHARE: 'share',\n  DEEP_LINK: 'deep_link_opened',\n  SCREEN_VIEW: 'screen_view'\n} as const;\n\n/** Union type of all standard event name strings. */\nexport type StandardEventName = (typeof StandardEvents)[keyof typeof StandardEvents];\n","// Commerce module for @appmachina/node (Server-side Node.js SDK).\n// Cross-platform purchase, subscription, cart, and refund tracking helpers.\n// Each function accepts a NodeCommerceTracker instance, a distinctId, and\n// tracks the appropriate event with standardized properties consistent with\n// the iOS CommerceModule, Android CommerceModule, and RN commerce module.\n//\n// Unlike the Web and RN commerce modules, the Node commerce module follows\n// the server-side distinctId-per-call pattern. Every function requires a\n// distinctId to identify which user the commerce event belongs to.\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Event properties bag accepted by commerce functions. */\nexport type EventProperties = Record<string, unknown>;\n\n/** Minimal AppMachina SDK interface required by the Node commerce module. */\nexport interface NodeCommerceTracker {\n  track(distinctId: string, event: string, properties?: Record<string, any>): void;\n}\n\n/** Purchase details for trackPurchase. */\nexport interface PurchaseParams {\n  productId: string;\n  /** Unit price of the item. Revenue is computed as `price * quantity`. */\n  price: number;\n  currency: string;\n  transactionId?: string;\n  quantity?: number;\n  isRestored?: boolean;\n  store?: string;\n  properties?: EventProperties;\n}\n\n/** Subscription details for trackSubscription. */\nexport interface SubscriptionParams {\n  productId: string;\n  /** Unit price of the subscription. */\n  price: number;\n  currency: string;\n  period?: string;\n  transactionId?: string;\n  isRenewal?: boolean;\n  isTrial?: boolean;\n  subscriptionGroupId?: string;\n  originalTransactionId?: string;\n  properties?: EventProperties;\n}\n\n/** Cart item for order and checkout tracking. */\nexport interface CartItem {\n  productId: string;\n  name: string;\n  price: number;\n  quantity?: number;\n  category?: string;\n}\n\n/** Order details for trackOrder. */\nexport interface OrderParams {\n  orderId: string;\n  items: CartItem[];\n  subtotal: number;\n  currency?: string;\n  tax?: number;\n  shipping?: number;\n  discount?: number;\n  couponCode?: string;\n  properties?: EventProperties;\n}\n\n/** Refund details for trackRefund. */\nexport interface RefundParams {\n  transactionId: string;\n  amount: number;\n  currency: string;\n  reason?: string;\n  properties?: EventProperties;\n}\n\n/** Purchase failure details for trackPurchaseFailed. */\nexport interface PurchaseFailedParams {\n  productId: string;\n  currency: string;\n  errorCode: string | number;\n  errorMessage?: string;\n  properties?: EventProperties;\n}\n\n// ---------------------------------------------------------------------------\n// Purchase tracking\n// ---------------------------------------------------------------------------\n\n/**\n * Track a successful purchase for a specific user.\n *\n * ```ts\n * import { trackPurchase } from '@appmachina/node';\n *\n * trackPurchase(sdk, 'user_123', {\n *   productId: 'premium_monthly',\n *   price: 9.99,\n *   currency: 'USD',\n *   transactionId: 'txn_abc123',\n * });\n * ```\n */\nexport function trackPurchase(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  params: PurchaseParams\n): void {\n  const quantity = params.quantity ?? 1;\n  const props: EventProperties = {\n    product_id: params.productId,\n    price: params.price,\n    currency: params.currency,\n    quantity,\n    revenue: params.price * quantity,\n    ...params.properties\n  };\n  if (params.transactionId !== undefined) props.transaction_id = params.transactionId;\n  if (params.isRestored !== undefined) props.is_restored = params.isRestored;\n  if (params.store !== undefined) props.store = params.store;\n\n  sdk.track(distinctId, 'purchase_success', props);\n}\n\n/**\n * Track a failed purchase attempt for a specific user.\n */\nexport function trackPurchaseFailed(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  params: PurchaseFailedParams\n): void {\n  const props: EventProperties = {\n    product_id: params.productId,\n    currency: params.currency,\n    error_code: params.errorCode,\n    ...params.properties\n  };\n  if (params.errorMessage !== undefined) props.error_message = params.errorMessage;\n\n  sdk.track(distinctId, 'purchase_failed', props);\n}\n\n// ---------------------------------------------------------------------------\n// Subscription tracking\n// ---------------------------------------------------------------------------\n\n/**\n * Track a subscription purchase or renewal for a specific user.\n *\n * ```ts\n * import { trackSubscription } from '@appmachina/node';\n *\n * trackSubscription(sdk, 'user_123', {\n *   productId: 'pro_annual',\n *   price: 49.99,\n *   currency: 'USD',\n *   period: 'P1Y',\n * });\n * ```\n */\nexport function trackSubscription(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  params: SubscriptionParams\n): void {\n  const props: EventProperties = {\n    product_id: params.productId,\n    price: params.price,\n    currency: params.currency,\n    quantity: 1,\n    revenue: params.price,\n    ...params.properties\n  };\n  if (params.transactionId !== undefined) props.transaction_id = params.transactionId;\n  if (params.period !== undefined) props.period = params.period;\n  if (params.isRenewal !== undefined) props.is_renewal = params.isRenewal;\n  if (params.isTrial !== undefined) props.is_trial = params.isTrial;\n  if (params.subscriptionGroupId !== undefined)\n    props.subscription_group_id = params.subscriptionGroupId;\n  if (params.originalTransactionId !== undefined)\n    props.original_transaction_id = params.originalTransactionId;\n\n  sdk.track(distinctId, 'subscribe', props);\n}\n\n// ---------------------------------------------------------------------------\n// Order / cart tracking\n// ---------------------------------------------------------------------------\n\n/**\n * Track a completed order with multiple line items for a specific user.\n */\nexport function trackOrder(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  params: OrderParams\n): void {\n  const currency = params.currency ?? 'USD';\n  let total = params.subtotal;\n  if (params.tax !== undefined) total += params.tax;\n  if (params.shipping !== undefined) total += params.shipping;\n  if (params.discount !== undefined) total -= params.discount;\n\n  const props: EventProperties = {\n    order_id: params.orderId,\n    subtotal: params.subtotal,\n    total,\n    currency,\n    item_count: params.items.length,\n    revenue: total,\n    product_ids: params.items.map((i) => i.productId).join(','),\n    ...params.properties\n  };\n  if (params.tax !== undefined) props.tax = params.tax;\n  if (params.shipping !== undefined) props.shipping = params.shipping;\n  if (params.discount !== undefined) props.discount = params.discount;\n  if (params.couponCode !== undefined) props.coupon_code = params.couponCode;\n\n  sdk.track(distinctId, 'purchase_success', props);\n}\n\n/**\n * Track an item being added to the cart for a specific user.\n */\nexport function trackAddToCart(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  item: CartItem,\n  properties?: EventProperties\n): void {\n  const quantity = item.quantity ?? 1;\n  const props: EventProperties = {\n    product_id: item.productId,\n    product_name: item.name,\n    price: item.price,\n    quantity,\n    value: item.price * quantity,\n    ...properties\n  };\n  if (item.category !== undefined) props.category = item.category;\n\n  sdk.track(distinctId, 'add_to_cart', props);\n}\n\n/**\n * Track an item being removed from the cart for a specific user.\n */\nexport function trackRemoveFromCart(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  item: CartItem,\n  properties?: EventProperties\n): void {\n  const quantity = item.quantity ?? 1;\n  const props: EventProperties = {\n    product_id: item.productId,\n    product_name: item.name,\n    price: item.price,\n    quantity,\n    ...properties\n  };\n  if (item.category !== undefined) props.category = item.category;\n\n  sdk.track(distinctId, 'remove_from_cart', props);\n}\n\n/**\n * Track beginning the checkout flow for a specific user.\n */\nexport function trackBeginCheckout(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  items: CartItem[],\n  currency = 'USD',\n  properties?: EventProperties\n): void {\n  const total = items.reduce((sum, item) => sum + item.price * (item.quantity ?? 1), 0);\n  const props: EventProperties = {\n    item_count: items.length,\n    value: total,\n    currency,\n    product_ids: items.map((i) => i.productId).join(','),\n    ...properties\n  };\n\n  sdk.track(distinctId, 'begin_checkout', props);\n}\n\n// ---------------------------------------------------------------------------\n// Product view tracking\n// ---------------------------------------------------------------------------\n\n/**\n * Track viewing a product detail page for a specific user.\n */\nexport function trackViewProduct(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  productId: string,\n  name: string,\n  price: number,\n  currency = 'USD',\n  category?: string,\n  properties?: EventProperties\n): void {\n  const props: EventProperties = {\n    product_id: productId,\n    product_name: name,\n    price,\n    currency,\n    ...properties\n  };\n  if (category !== undefined) props.category = category;\n\n  sdk.track(distinctId, 'view_item', props);\n}\n\n// ---------------------------------------------------------------------------\n// Refund tracking\n// ---------------------------------------------------------------------------\n\n/**\n * Track a refund for a specific user.\n */\nexport function trackRefund(\n  sdk: NodeCommerceTracker,\n  distinctId: string,\n  params: RefundParams\n): void {\n  const props: EventProperties = {\n    transaction_id: params.transactionId,\n    amount: params.amount,\n    currency: params.currency,\n    ...params.properties\n  };\n  if (params.reason !== undefined) props.reason = params.reason;\n\n  sdk.track(distinctId, 'refund', props);\n}\n","// @appmachina/node — Server-side Node.js SDK.\n// Thin wrapper over @appmachina/core-wasm. Owns only:\n//   - distinctId-per-call API pattern (no stored user state)\n//   - SIGTERM/SIGINT graceful shutdown\n//   - File-system persistence via Node.js fs\n//   - process.env access for configuration\n//   - Instance ID persistence (filesystem)\n//   - Init timing measurement\n//   - Remote config fetch on init\n//   - Queue depth gating\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\n\nimport { AppMachinaCore, AppMachinaError, FetchHttpClient } from '@appmachina/core-wasm';\nimport type {\n  ConsentState,\n  Environment,\n  EventProperties,\n  UserProperties\n} from '@appmachina/core-wasm';\n\nimport { FilePersistence } from './persistence.js';\n\nexport type {\n  ConsentState,\n  Environment,\n  EventProperties,\n  UserProperties\n} from '@appmachina/core-wasm';\nexport { AppMachinaError } from '@appmachina/core-wasm';\nexport { FilePersistence } from './persistence.js';\nexport { StandardEvents } from './standard-events.js';\nexport type { StandardEventName } from './standard-events.js';\nexport { appMachinaDebugMiddleware } from './express.js';\n\nexport type {\n  NodeCommerceTracker,\n  PurchaseParams,\n  SubscriptionParams,\n  CartItem,\n  OrderParams,\n  RefundParams,\n  PurchaseFailedParams\n} from './commerce.js';\nexport {\n  trackPurchase,\n  trackPurchaseFailed,\n  trackSubscription,\n  trackOrder,\n  trackAddToCart,\n  trackRemoveFromCart,\n  trackBeginCheckout,\n  trackViewProduct,\n  trackRefund\n} from './commerce.js';\n\nexport type ErrorListener = (error: Error) => void;\n\nexport interface AppMachinaNodeConfig {\n  /** Application identifier that scopes events to a specific app. */\n  appId: string;\n  /** Deployment environment (e.g. \"production\", \"development\"). */\n  environment: Environment;\n  /** Enable verbose debug logging. */\n  enableDebug?: boolean;\n  /** Override the default AppMachina ingestion endpoint URL. */\n  baseUrl?: string;\n  /**\n   * How often (in milliseconds) the SDK automatically flushes queued events.\n   * @default 10000\n   */\n  flushIntervalMs?: number;\n  /**\n   * Number of queued events that triggers an automatic flush.\n   * @default 20\n   */\n  flushThreshold?: number;\n  /** Maximum number of events to hold in the in-memory queue. Events beyond this limit are dropped. */\n  maxQueueSize?: number;\n  /** Maximum number of events sent in a single HTTP request batch. */\n  maxBatchSize?: number;\n  /**\n   * Maximum time (in milliseconds) to wait for a final flush during shutdown before giving up.\n   * @default 5000\n   */\n  shutdownFlushTimeoutMs?: number;\n  /** Whether to register SIGTERM/SIGINT handlers for graceful shutdown. Default: true */\n  handleSignals?: boolean;\n  /**\n   * Directory where persisted event data is stored.\n   * Defaults to `os.tmpdir()` (e.g. `/tmp/appmachina-sdk/<appId>`).\n   */\n  persistenceDir?: string;\n}\n\n// SDK version injected at build time\ndeclare const __APPMACHINA_NODE_VERSION__: string;\nconst SDK_VERSION: string =\n  typeof __APPMACHINA_NODE_VERSION__ !== 'undefined' ? __APPMACHINA_NODE_VERSION__ : '0.1.0';\n\nexport class AppMachinaNode {\n  private core: AppMachinaCore;\n  private readonly config: AppMachinaNodeConfig;\n  private readonly enableDebug: boolean;\n  private readonly baseUrl: string;\n  private readonly shutdownFlushTimeoutMs: number;\n  private isShutDown = false;\n  private readonly errorListeners: ErrorListener[] = [];\n  private static globalSignalHandlersRegistered = false;\n  private static instances: AppMachinaNode[] = [];\n  private readonly _instanceId: string;\n  private _initDurationMs: number | undefined;\n\n  constructor(config: AppMachinaNodeConfig) {\n    const initStart = performance.now();\n\n    this.config = config;\n    this.enableDebug = config.enableDebug ?? false;\n    this.baseUrl = (config.baseUrl ?? 'https://in.appmachina.com').replace(/\\/$/, '');\n    this.shutdownFlushTimeoutMs = config.shutdownFlushTimeoutMs ?? 5_000;\n\n    // Instance ID: persist a UUID to the filesystem so it survives restarts\n    this._instanceId = getOrCreateInstanceId(config.appId, config.persistenceDir);\n\n    const persistence = new FilePersistence(config.appId, config.persistenceDir);\n    const httpClient = new FetchHttpClient(30_000);\n\n    this.core = AppMachinaCore.init({\n      config: {\n        appId: config.appId,\n        environment: config.environment,\n        ...(config.baseUrl != null && { baseUrl: config.baseUrl }),\n        ...(config.enableDebug != null && { enableDebug: config.enableDebug }),\n        flushIntervalMs: config.flushIntervalMs ?? 10_000,\n        flushThreshold: config.flushThreshold ?? 20,\n        ...(config.maxQueueSize != null && { maxQueueSize: config.maxQueueSize }),\n        ...(config.maxBatchSize != null && { maxBatchSize: config.maxBatchSize }),\n        sdkVersion: `node/${SDK_VERSION}`\n      },\n      httpClient,\n      persistence\n    });\n\n    this.core.setDeviceContext({\n      platform: 'node',\n      osVersion: `${process.platform} ${process.version}`,\n      appVersion: SDK_VERSION,\n      deviceModel: process.arch,\n      locale: Intl.DateTimeFormat().resolvedOptions().locale ?? 'en-US',\n      installId: this._instanceId\n    });\n\n    if (config.handleSignals !== false) {\n      this.registerSignalHandlers();\n    }\n\n    // Record init timing\n    this._initDurationMs = Math.round((performance.now() - initStart) * 100) / 100;\n  }\n\n  /**\n   * Complete asynchronous initialization: fetches remote config and tracks init timing.\n   *\n   * Call this after constructing the instance. The constructor handles synchronous\n   * setup; this method handles async work (remote config fetch) and fires the\n   * `appmachina_init_timing` event.\n   */\n  async init(): Promise<void> {\n    // Fetch remote config (best-effort, like Web/RN SDKs)\n    await this.core.fetchRemoteConfig().catch(() => {\n      // Remote config fetch is best-effort\n    });\n\n    // Track init timing\n    if (this._initDurationMs != null) {\n      try {\n        this.core.track(\n          'appmachina_init_timing',\n          { duration_ms: this._initDurationMs, platform: 'node' },\n          'system'\n        );\n      } catch {\n        // Init timing is best-effort\n      }\n    }\n\n    // Track server_start lifecycle event\n    try {\n      this.core.track(\n        'server_start',\n        {\n          platform: 'node',\n          node_version: process.version,\n          duration_ms: this._initDurationMs\n        },\n        'system'\n      );\n    } catch {\n      // Lifecycle events are best-effort\n    }\n  }\n\n  /**\n   * Track an event for a specific user.\n   *\n   * Unlike @appmachina/client which stores the user ID via identify(),\n   * the Node.js SDK requires a distinctId on every call. This is the\n   * correct pattern for server-side SDKs where requests come from\n   * many users concurrently.\n   */\n  track(distinctId: string, eventName: string, properties?: EventProperties): void {\n    if (this.isShutDown) return;\n    if (this.enableDebug) {\n      console.log(\n        `[AppMachina] track(\"${eventName}\", ${Object.keys(properties ?? {}).length} properties, distinctId=\"${distinctId}\")`\n      );\n    }\n    if (!distinctId || typeof distinctId !== 'string') {\n      this.emitError(new Error('distinctId must be a non-empty string'));\n      return;\n    }\n    try {\n      const depthBefore = this.core.queueDepth();\n      this.core.track(eventName, properties, distinctId);\n      const depthAfter = this.core.queueDepth();\n\n      // Queue depth gating: verify the event was accepted by the core\n      if (depthAfter <= depthBefore && this.enableDebug) {\n        console.warn(\n          `[AppMachina] Event \"${eventName}\" may not have been accepted (queue depth ${depthBefore} -> ${depthAfter})`\n        );\n      }\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Track a screen view for a specific user.\n   */\n  screen(distinctId: string, screenName: string, properties?: EventProperties): void {\n    if (this.isShutDown) return;\n    if (this.enableDebug) {\n      console.log(\n        `[AppMachina] screen(\"${screenName}\", ${Object.keys(properties ?? {}).length} properties, distinctId=\"${distinctId}\")`\n      );\n    }\n    if (!distinctId || typeof distinctId !== 'string') {\n      this.emitError(new Error('distinctId must be a non-empty string'));\n      return;\n    }\n    try {\n      this.core.screen(screenName, properties, distinctId);\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Set user properties for a specific user.\n   *\n   * Calls identify(distinctId) first so the core associates\n   * these properties with the correct user.\n   *\n   * Note: identify(distinctId) and setUserProperties are two separate calls.\n   * In concurrent server environments, interleaving is possible. For atomic\n   * user property updates, the Rust core would need a single\n   * identify-and-set-properties API.\n   */\n  setUserProperties(distinctId: string, properties: UserProperties): void {\n    if (this.isShutDown) return;\n    if (this.enableDebug) {\n      console.log(\n        `[AppMachina] setUserProperties(${Object.keys(properties ?? {}).length} properties, distinctId=\"${distinctId}\")`\n      );\n    }\n    if (!distinctId || typeof distinctId !== 'string') {\n      this.emitError(new Error('distinctId must be a non-empty string'));\n      return;\n    }\n    try {\n      this.core.identify(distinctId);\n      this.core.setUserProperties(properties as Record<string, unknown>);\n      this.sendUserPropertiesAsync(distinctId, properties as Record<string, unknown>, false);\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Set user properties with \"set once\" semantics for a specific user.\n   *\n   * Only properties whose keys have not been previously set via this method\n   * are forwarded. Calls identify(distinctId) first so the core associates\n   * these properties with the correct user.\n   */\n  setUserPropertiesOnce(distinctId: string, properties: UserProperties): void {\n    if (this.isShutDown) return;\n    if (this.enableDebug) {\n      console.log(\n        `[AppMachina] setUserPropertiesOnce(${Object.keys(properties ?? {}).length} properties, distinctId=\"${distinctId}\")`\n      );\n    }\n    if (!distinctId || typeof distinctId !== 'string') {\n      this.emitError(new Error('distinctId must be a non-empty string'));\n      return;\n    }\n    try {\n      this.core.identify(distinctId);\n      this.core.setUserPropertiesOnce(properties as Record<string, unknown>);\n      this.sendUserPropertiesAsync(distinctId, properties as Record<string, unknown>, true);\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Associate events for a specific user with a group (company, team, organization).\n   *\n   * Unlike @appmachina/client which stores the group ID, the Node.js SDK\n   * follows the server-side pattern where distinctId is required on every call.\n   * The group association is set on the core and a `group` event is tracked\n   * with the provided properties.\n   */\n  group(distinctId: string, groupId: string, properties?: EventProperties): void {\n    if (this.isShutDown) return;\n    if (this.enableDebug) {\n      console.log(\n        `[AppMachina] group(\"${groupId}\", ${Object.keys(properties ?? {}).length} properties, distinctId=\"${distinctId}\")`\n      );\n    }\n    if (!distinctId || typeof distinctId !== 'string') {\n      this.emitError(new Error('distinctId must be a non-empty string'));\n      return;\n    }\n    try {\n      this.core.identify(distinctId);\n      this.core.group(groupId, properties);\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Update consent state.\n   *\n   * Consent applies globally to this SDK instance, not per-user.\n   * All events from this instance will respect the configured consent state.\n   */\n  setConsent(consent: ConsentState): void {\n    if (this.isShutDown) return;\n    try {\n      this.core.setConsent(consent);\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Get the persistent instance ID for this server instance.\n   *\n   * The instance ID is a UUID generated on first init and persisted to the\n   * filesystem so it survives process restarts. Stored in\n   * `.appmachina-instance-id` inside the persistence directory.\n   */\n  getInstanceId(): string {\n    return this._instanceId;\n  }\n\n  /**\n   * Get current session ID.\n   */\n  getSessionId(): string {\n    return this.core.getSessionId();\n  }\n\n  /**\n   * Get current consent state.\n   */\n  getConsentState(): ConsentState {\n    return this.core.getConsentState();\n  }\n\n  /**\n   * Get number of queued events.\n   */\n  queueDepth(): number {\n    return this.core.queueDepth();\n  }\n\n  /**\n   * Flush all queued events to the server.\n   */\n  async flush(): Promise<void> {\n    if (this.isShutDown) return;\n    try {\n      await this.core.flushAsync();\n    } catch (e) {\n      this.emitError(e);\n    }\n  }\n\n  /**\n   * Gracefully shut down: flush remaining events, then stop.\n   */\n  async shutdown(): Promise<void> {\n    if (this.isShutDown) return;\n    this.isShutDown = true;\n\n    // Remove this instance from the static list to prevent memory leaks\n    const idx = AppMachinaNode.instances.indexOf(this);\n    if (idx !== -1) AppMachinaNode.instances.splice(idx, 1);\n\n    // Try to flush remaining events with a timeout\n    try {\n      await Promise.race([\n        this.core.flushAsync(),\n        new Promise<void>((resolve) => setTimeout(resolve, this.shutdownFlushTimeoutMs))\n      ]);\n    } catch {\n      // Best effort\n    }\n\n    this.core.shutdown();\n  }\n\n  /**\n   * Register an error listener. Errors from track/screen/flush\n   * that would otherwise be silently dropped are forwarded here.\n   */\n  on(event: 'error', listener: ErrorListener): this {\n    this.errorListeners.push(listener);\n    return this;\n  }\n\n  /**\n   * Remove a previously registered error listener.\n   */\n  off(event: 'error', listener: ErrorListener): this {\n    const idx = this.errorListeners.indexOf(listener);\n    if (idx !== -1) this.errorListeners.splice(idx, 1);\n    return this;\n  }\n\n  private emitError(e: unknown): void {\n    const error = e instanceof Error ? e : new Error(String(e));\n    for (const listener of this.errorListeners) {\n      try {\n        listener(error);\n      } catch {\n        // Listener errors must not propagate\n      }\n    }\n    if (this.enableDebug && this.errorListeners.length === 0) {\n      console.warn('[AppMachina]', error.message);\n    }\n  }\n\n  // --- User properties HTTP POST ---\n\n  /**\n   * Fire-and-forget POST to /users/properties.\n   * Best-effort: errors are silently swallowed.\n   */\n  private sendUserPropertiesAsync(\n    distinctId: string,\n    properties: Record<string, unknown>,\n    setOnce: boolean\n  ): void {\n    const payload: Record<string, unknown> = {\n      app_id: this.config.appId,\n      app_user_id: distinctId,\n      properties,\n      timestamp: new Date().toISOString()\n    };\n    if (setOnce) {\n      payload.set_once = true;\n    }\n\n    fetch(`${this.baseUrl}/users/properties`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-App-Id': this.config.appId,\n        'X-SDK-Version': `node/${SDK_VERSION}`\n      },\n      body: JSON.stringify(payload)\n    }).catch(() => {\n      // Best-effort — don't throw on network errors\n    });\n  }\n\n  // --- Signal handlers ---\n\n  private registerSignalHandlers(): void {\n    AppMachinaNode.instances.push(this);\n\n    if (AppMachinaNode.globalSignalHandlersRegistered) return;\n    AppMachinaNode.globalSignalHandlersRegistered = true;\n\n    const handler = (signal: string) => {\n      // Track server_shutdown lifecycle event on all instances before shutting down\n      for (const instance of AppMachinaNode.instances) {\n        try {\n          instance.core.track('server_shutdown', { reason: signal }, 'system');\n        } catch {\n          // Lifecycle events are best-effort\n        }\n      }\n      const shutdowns = AppMachinaNode.instances.map((inst) => inst.shutdown());\n      void Promise.allSettled(shutdowns).then(() => {\n        process.kill(process.pid, signal);\n      });\n    };\n\n    process.once('SIGTERM', () => handler('SIGTERM'));\n    process.once('SIGINT', () => handler('SIGINT'));\n  }\n}\n\n// --- Instance ID persistence ---\n\nconst INSTANCE_ID_FILENAME = '.appmachina-instance-id';\n\n/**\n * Read or create a persistent instance ID on the filesystem.\n * Uses `crypto.randomUUID()` for generation.\n */\nfunction getOrCreateInstanceId(appId: string, baseDir?: string): string {\n  const dir = join(baseDir ?? tmpdir(), 'appmachina-sdk', appId);\n  const filePath = join(dir, INSTANCE_ID_FILENAME);\n\n  try {\n    if (existsSync(filePath)) {\n      const existing = readFileSync(filePath, 'utf-8').trim();\n      if (existing) return existing;\n    }\n  } catch {\n    // Fall through to create a new one\n  }\n\n  const newId = crypto.randomUUID();\n\n  try {\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n    writeFileSync(filePath, newId, 'utf-8');\n  } catch {\n    // If we can't persist, still return the generated ID for this session\n  }\n\n  return newId;\n}\n"],"mappings":"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"}