@stackframe/tanstack-start 0.0.1 → 2.8.91

package/dist/esm/lib/stack-app/apps/implementations/session-replay.js

@@ -0,0 +1,234 @@
+import { runAsynchronously } from "@stackframe/stack-shared/dist/utils/promises";
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+import { isBrowserLike } from "@stackframe/stack-shared/dist/utils/env";
+
+//#region src/lib/stack-app/apps/implementations/session-replay.ts
+/**
+* Converts AnalyticsOptions to a JSON-safe representation.
+* RegExp blockClass values are serialized as `{ __regexp, __flags }` objects.
+* The return type is AnalyticsOptions to keep StackClientAppJson simple;
+* the actual runtime value is JSON-safe.
+*/
+function analyticsOptionsToJson(options) {
+	if (!options?.replays?.blockClass) return options;
+	const { blockClass, ...rest } = options.replays;
+	if (!(blockClass instanceof RegExp)) return options;
+	return {
+		...options,
+		replays: {
+			...rest,
+			blockClass: {
+				__regexp: blockClass.source,
+				__flags: blockClass.flags
+			}
+		}
+	};
+}
+/**
+* Reconstructs AnalyticsOptions from a JSON-deserialized value.
+* Converts `{ __regexp, __flags }` objects back to RegExp instances.
+*/
+function analyticsOptionsFromJson(json) {
+	if (!json?.replays?.blockClass) return json;
+	const { blockClass, ...rest } = json.replays;
+	if (typeof blockClass === "object" && "__regexp" in blockClass) {
+		const bc = blockClass;
+		return {
+			...json,
+			replays: {
+				...rest,
+				blockClass: new RegExp(bc.__regexp, bc.__flags)
+			}
+		};
+	}
+	return json;
+}
+const LOCAL_STORAGE_PREFIX = "stack:session-replay:v1";
+const IDLE_TTL_MS = 180 * 1e3;
+const FLUSH_INTERVAL_MS = 5e3;
+const MAX_EVENTS_PER_BATCH = 200;
+const MAX_APPROX_BYTES_PER_BATCH = 512e3;
+function safeParseStoredSession(raw) {
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		if (typeof parsed !== "object" || parsed === null) return null;
+		if (typeof parsed.session_id !== "string") return null;
+		if (typeof parsed.created_at_ms !== "number") return null;
+		if (typeof parsed.last_activity_ms !== "number") return null;
+		return parsed;
+	} catch {
+		return null;
+	}
+}
+function makeStorageKey(projectId) {
+	return `${LOCAL_STORAGE_PREFIX}:${projectId}`;
+}
+function generateUuid() {
+	return crypto.randomUUID();
+}
+function getOrRotateSession(options) {
+	const existing = safeParseStoredSession(localStorage.getItem(options.key));
+	if (existing && options.nowMs - existing.last_activity_ms <= IDLE_TTL_MS) return existing;
+	const next = {
+		session_id: generateUuid(),
+		created_at_ms: options.nowMs,
+		last_activity_ms: options.nowMs
+	};
+	localStorage.setItem(options.key, JSON.stringify(next));
+	return next;
+}
+var SessionRecorder = class {
+	constructor(deps, replayOptions) {
+		this._started = false;
+		this._cancelled = false;
+		this._stopRecording = null;
+		this._detachListeners = null;
+		this._flushTimer = null;
+		this._events = [];
+		this._approxBytes = 0;
+		this._lastPersistActivity = 0;
+		this._recording = false;
+		this._rrwebModule = null;
+		this._lastBrowserSessionId = null;
+		this._takingSnapshot = false;
+		this._flushInProgress = false;
+		this._deps = deps;
+		this._replayOptions = replayOptions;
+		this._sessionReplaySegmentId = generateUuid();
+		this._storageKey = makeStorageKey(deps.projectId);
+	}
+	/**
+	* Starts recording. Idempotent — calling multiple times is safe.
+	*/
+	start() {
+		if (this._started) return;
+		if (!isBrowserLike()) return;
+		this._started = true;
+		runAsynchronously(() => this._startRecording(), { noErrorLogging: true });
+		this._flushTimer = setInterval(() => this._tick(), FLUSH_INTERVAL_MS);
+	}
+	stop() {
+		this._cancelled = true;
+		if (this._flushTimer !== null) {
+			clearInterval(this._flushTimer);
+			this._flushTimer = null;
+		}
+		runAsynchronously(() => this._flush({ keepalive: true }));
+		this._stopCurrentRecording();
+	}
+	clearBuffer() {
+		this._events = [];
+		this._approxBytes = 0;
+	}
+	_persistActivity(nowMs) {
+		const stored = getOrRotateSession({
+			key: this._storageKey,
+			nowMs
+		});
+		if (nowMs - this._lastPersistActivity < 5e3) return stored;
+		this._lastPersistActivity = nowMs;
+		const updated = {
+			...stored,
+			last_activity_ms: nowMs
+		};
+		localStorage.setItem(this._storageKey, JSON.stringify(updated));
+		return stored;
+	}
+	async _flush(options) {
+		if (this._events.length === 0) return;
+		if (this._flushInProgress) return;
+		const nowMs = Date.now();
+		const stored = getOrRotateSession({
+			key: this._storageKey,
+			nowMs
+		});
+		const batchId = generateUuid();
+		const payload = {
+			browser_session_id: stored.session_id,
+			session_replay_segment_id: this._sessionReplaySegmentId,
+			batch_id: batchId,
+			started_at_ms: stored.created_at_ms,
+			sent_at_ms: nowMs,
+			events: this._events
+		};
+		this._events = [];
+		this._approxBytes = 0;
+		this._flushInProgress = true;
+		try {
+			const res = await this._deps.sendBatch(JSON.stringify(payload), { keepalive: options.keepalive });
+			if (res.status === "error") {
+				console.warn("SessionRecorder flush failed:", res.error);
+				return;
+			}
+			if (!res.data.ok) console.warn("SessionRecorder flush failed:", res.data.status, await res.data.text());
+		} finally {
+			this._flushInProgress = false;
+		}
+	}
+	async _startRecording() {
+		if (this._recording || this._cancelled) return;
+		if (!this._rrwebModule) {
+			const rrwebImport = await Result.fromPromise(import("rrweb"));
+			if (rrwebImport.status === "error") {
+				console.warn("SessionRecorder: rrweb import failed. Is rrweb installed?", rrwebImport.error);
+				return;
+			}
+			this._rrwebModule = rrwebImport.data;
+		}
+		if (this._cancelled) return;
+		this._stopRecording = this._rrwebModule.record({
+			emit: (event) => {
+				const nowMs = Date.now();
+				const stored = this._persistActivity(nowMs);
+				if (this._lastBrowserSessionId === null) this._lastBrowserSessionId = stored.session_id;
+				else if (stored.session_id !== this._lastBrowserSessionId && !this._takingSnapshot) {
+					this._lastBrowserSessionId = stored.session_id;
+					this._takingSnapshot = true;
+					try {
+						this._rrwebModule.record.takeFullSnapshot();
+					} finally {
+						this._takingSnapshot = false;
+					}
+				}
+				this._events.push(event);
+				this._approxBytes += JSON.stringify(event).length;
+				if (this._events.length >= MAX_EVENTS_PER_BATCH || this._approxBytes >= MAX_APPROX_BYTES_PER_BATCH) runAsynchronously(() => this._flush({ keepalive: false }));
+			},
+			maskAllInputs: this._replayOptions.maskAllInputs ?? true,
+			...this._replayOptions.blockClass !== void 0 ? { blockClass: this._replayOptions.blockClass } : {},
+			...this._replayOptions.blockSelector !== void 0 ? { blockSelector: this._replayOptions.blockSelector } : {}
+		}) ?? null;
+		this._recording = true;
+		const onPageHide = () => {
+			runAsynchronously(() => this._flush({ keepalive: true }));
+		};
+		window.addEventListener("pagehide", onPageHide);
+		document.addEventListener("visibilitychange", onPageHide);
+		this._detachListeners = () => {
+			window.removeEventListener("pagehide", onPageHide);
+			document.removeEventListener("visibilitychange", onPageHide);
+		};
+	}
+	_stopCurrentRecording() {
+		if (this._detachListeners) {
+			this._detachListeners();
+			this._detachListeners = null;
+		}
+		if (this._stopRecording) {
+			this._stopRecording();
+			this._stopRecording = null;
+		}
+		this._events = [];
+		this._approxBytes = 0;
+		this._recording = false;
+	}
+	_tick() {
+		if (this._cancelled) return;
+		if (this._events.length > 0) runAsynchronously(() => this._flush({ keepalive: false }));
+	}
+};
+
+//#endregion
+export { SessionRecorder, analyticsOptionsFromJson, analyticsOptionsToJson, generateUuid, getOrRotateSession, makeStorageKey, safeParseStoredSession };
+//# sourceMappingURL=session-replay.js.map

package/dist/esm/lib/stack-app/apps/implementations/session-replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.js","names":[],"sources":["../../../../../../src/lib/stack-app/apps/implementations/session-replay.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { isBrowserLike } from \"@stackframe/stack-shared/dist/utils/env\";\nimport { runAsynchronously } from \"@stackframe/stack-shared/dist/utils/promises\";\nimport { Result } from \"@stackframe/stack-shared/dist/utils/results\";\n\nexport type AnalyticsReplayOptions = {\n  /**\n   * Whether session replays are enabled.\n   *\n   * @default false\n   */\n  enabled?: boolean,\n  /**\n   * Whether to mask the content of all `<input>` elements.\n   *\n   * @default true\n   */\n  maskAllInputs?: boolean,\n  /**\n   * A CSS class name or RegExp. Elements with a matching class will be blocked\n   * (replaced with a placeholder in the recording).\n   *\n   * @default undefined\n   */\n  blockClass?: string | RegExp,\n  /**\n   * A CSS selector string. Elements matching this selector will be blocked\n   * (replaced with a placeholder in the recording).\n   *\n   * @default undefined\n   */\n  blockSelector?: string,\n};\n\nexport type AnalyticsOptions = {\n  /**\n   * Whether SDK-managed analytics capture is enabled.\n   *\n   * @default true\n   */\n  enabled?: boolean,\n  /**\n   * Options for session replay recording. Replays are disabled by default;\n   * set `enabled: true` to opt in.\n   */\n  replays?: AnalyticsReplayOptions,\n};\n\n/**\n * Converts AnalyticsOptions to a JSON-safe representation.\n * RegExp blockClass values are serialized as `{ __regexp, __flags }` objects.\n * The return type is AnalyticsOptions to keep StackClientAppJson simple;\n * the actual runtime value is JSON-safe.\n */\nexport function analyticsOptionsToJson(options: AnalyticsOptions | undefined): AnalyticsOptions | undefined {\n  if (!options?.replays?.blockClass) return options;\n  const { blockClass, ...rest } = options.replays;\n  if (!(blockClass instanceof RegExp)) return options;\n  return {\n    ...options,\n    replays: {\n      ...rest,\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n      blockClass: { __regexp: blockClass.source, __flags: blockClass.flags } as any,\n    },\n  };\n}\n\n/**\n * Reconstructs AnalyticsOptions from a JSON-deserialized value.\n * Converts `{ __regexp, __flags }` objects back to RegExp instances.\n */\nexport function analyticsOptionsFromJson(json: AnalyticsOptions | undefined): AnalyticsOptions | undefined {\n  if (!json?.replays?.blockClass) return json;\n  const { blockClass, ...rest } = json.replays;\n  if (typeof blockClass === 'object' && '__regexp' in blockClass) {\n    const bc = blockClass as unknown as { __regexp: string, __flags: string };\n    return {\n      ...json,\n      replays: {\n        ...rest,\n        blockClass: new RegExp(bc.__regexp, bc.__flags),\n      },\n    };\n  }\n  return json;\n}\n\n// ---------- Recording internals ----------\n\nconst LOCAL_STORAGE_PREFIX = \"stack:session-replay:v1\";\nconst IDLE_TTL_MS = 3 * 60 * 1000;\n\nconst FLUSH_INTERVAL_MS = 5_000;\nconst MAX_EVENTS_PER_BATCH = 200;\nconst MAX_APPROX_BYTES_PER_BATCH = 512_000;\n\nexport type StoredSession = {\n  session_id: string,\n  created_at_ms: number,\n  last_activity_ms: number,\n};\n\nexport function safeParseStoredSession(raw: string | null): StoredSession | null {\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw);\n    if (typeof parsed !== \"object\" || parsed === null) return null;\n    if (typeof parsed.session_id !== \"string\") return null;\n    if (typeof parsed.created_at_ms !== \"number\") return null;\n    if (typeof parsed.last_activity_ms !== \"number\") return null;\n    return parsed as StoredSession;\n  } catch {\n    return null;\n  }\n}\n\nexport function makeStorageKey(projectId: string) {\n  return `${LOCAL_STORAGE_PREFIX}:${projectId}`;\n}\n\nexport function generateUuid() {\n  return crypto.randomUUID();\n}\n\nexport function getOrRotateSession(options: { key: string, nowMs: number }): StoredSession {\n  const existing = safeParseStoredSession(localStorage.getItem(options.key));\n  if (existing && options.nowMs - existing.last_activity_ms <= IDLE_TTL_MS) {\n    return existing;\n  }\n  const next: StoredSession = {\n    session_id: generateUuid(),\n    created_at_ms: options.nowMs,\n    last_activity_ms: options.nowMs,\n  };\n  localStorage.setItem(options.key, JSON.stringify(next));\n  return next;\n}\n\nexport type SessionRecorderDeps = {\n  projectId: string,\n  sendBatch: (body: string, options: { keepalive: boolean }) => Promise<Result<Response, Error>>,\n};\n\nexport class SessionRecorder {\n  private _started = false;\n  private _cancelled = false;\n  private _stopRecording: (() => void) | null = null;\n  private _detachListeners: (() => void) | null = null;\n  private _flushTimer: ReturnType<typeof setInterval> | null = null;\n  private _events: unknown[] = [];\n  private _approxBytes = 0;\n  private _lastPersistActivity = 0;\n  private _recording = false;\n  private _rrwebModule: typeof import(\"rrweb\") | null = null;\n  private _lastBrowserSessionId: string | null = null;\n  private _takingSnapshot = false;\n  private _flushInProgress = false;\n  private readonly _sessionReplaySegmentId: string;\n  private readonly _storageKey: string;\n  private readonly _deps: SessionRecorderDeps;\n  private readonly _replayOptions: AnalyticsReplayOptions;\n\n  constructor(deps: SessionRecorderDeps, replayOptions: AnalyticsReplayOptions) {\n    this._deps = deps;\n    this._replayOptions = replayOptions;\n    this._sessionReplaySegmentId = generateUuid();\n    this._storageKey = makeStorageKey(deps.projectId);\n  }\n\n  /**\n   * Starts recording. Idempotent — calling multiple times is safe.\n   */\n  start() {\n    if (this._started) return;\n    if (!isBrowserLike()) return;\n    this._started = true;\n\n    // Kick off rrweb recording\n    runAsynchronously(() => this._startRecording(), { noErrorLogging: true });\n\n    // Periodic flush\n    this._flushTimer = setInterval(() => this._tick(), FLUSH_INTERVAL_MS);\n  }\n\n  stop() {\n    this._cancelled = true;\n    if (this._flushTimer !== null) {\n      clearInterval(this._flushTimer);\n      this._flushTimer = null;\n    }\n    // Flush remaining events before cleanup\n    runAsynchronously(() => this._flush({ keepalive: true }));\n    this._stopCurrentRecording();\n  }\n\n  clearBuffer() {\n    this._events = [];\n    this._approxBytes = 0;\n  }\n\n  private _persistActivity(nowMs: number): StoredSession {\n    const stored = getOrRotateSession({ key: this._storageKey, nowMs });\n    if (nowMs - this._lastPersistActivity < 5_000) return stored;\n    this._lastPersistActivity = nowMs;\n    const updated: StoredSession = { ...stored, last_activity_ms: nowMs };\n    localStorage.setItem(this._storageKey, JSON.stringify(updated));\n    return stored;\n  }\n\n  private async _flush(options: { keepalive: boolean }) {\n    if (this._events.length === 0) return;\n    // Prevent concurrent in-flight HTTP requests. When a flush is already\n    // in-flight, a second batch could race on the server (both call\n    // findRecentSessionReplay before either upsert commits) and create\n    // duplicate SessionReplay records. Events stay in _events and will be\n    // picked up by the next tick or batch-size check.\n    if (this._flushInProgress) return;\n\n    const nowMs = Date.now();\n    const stored = getOrRotateSession({ key: this._storageKey, nowMs });\n\n    const batchId = generateUuid();\n    const payload = {\n      browser_session_id: stored.session_id,\n      session_replay_segment_id: this._sessionReplaySegmentId,\n      batch_id: batchId,\n      started_at_ms: stored.created_at_ms,\n      sent_at_ms: nowMs,\n      events: this._events,\n    };\n\n    this._events = [];\n    this._approxBytes = 0;\n\n    this._flushInProgress = true;\n    try {\n      const res = await this._deps.sendBatch(\n        JSON.stringify(payload),\n        { keepalive: options.keepalive },\n      );\n\n      if (res.status === \"error\") {\n        console.warn(\"SessionRecorder flush failed:\", res.error);\n        return;\n      }\n\n      if (!res.data.ok) {\n        console.warn(\"SessionRecorder flush failed:\", res.data.status, await res.data.text());\n      }\n    } finally {\n      this._flushInProgress = false;\n    }\n  }\n\n  private async _startRecording() {\n    if (this._recording || this._cancelled) return;\n\n    if (!this._rrwebModule) {\n      const rrwebImport = await Result.fromPromise(import(\"rrweb\"));\n      if (rrwebImport.status === \"error\") {\n        console.warn(\"SessionRecorder: rrweb import failed. Is rrweb installed?\", rrwebImport.error);\n        return;\n      }\n      this._rrwebModule = rrwebImport.data;\n    }\n\n    // cancelled may change during the await above\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this._cancelled) return;\n\n    this._stopRecording = this._rrwebModule.record({\n      emit: (event) => {\n        const nowMs = Date.now();\n        const stored = this._persistActivity(nowMs);\n\n        // Detect session rotation: after 3+ minutes idle, getOrRotateSession\n        // creates a new session ID. We need to inject a FullSnapshot so the\n        // new server-side SessionReplay record is playable.\n        if (this._lastBrowserSessionId === null) {\n          this._lastBrowserSessionId = stored.session_id;\n        } else if (stored.session_id !== this._lastBrowserSessionId && !this._takingSnapshot) {\n          this._lastBrowserSessionId = stored.session_id;\n          // Inject a FullSnapshot for the new session (calls emit synchronously)\n          this._takingSnapshot = true;\n          try {\n            this._rrwebModule!.record.takeFullSnapshot();\n          } finally {\n            this._takingSnapshot = false;\n          }\n        }\n\n        this._events.push(event);\n        this._approxBytes += JSON.stringify(event).length;\n        if (this._events.length >= MAX_EVENTS_PER_BATCH || this._approxBytes >= MAX_APPROX_BYTES_PER_BATCH) {\n          runAsynchronously(() => this._flush({ keepalive: false }));\n        }\n      },\n      maskAllInputs: this._replayOptions.maskAllInputs ?? true,\n      ...(this._replayOptions.blockClass !== undefined ? { blockClass: this._replayOptions.blockClass } : {}),\n      ...(this._replayOptions.blockSelector !== undefined ? { blockSelector: this._replayOptions.blockSelector } : {}),\n    }) ?? null;\n\n    this._recording = true;\n\n    const onPageHide = () => {\n      runAsynchronously(() => this._flush({ keepalive: true }));\n    };\n    window.addEventListener(\"pagehide\", onPageHide);\n    document.addEventListener(\"visibilitychange\", onPageHide);\n    this._detachListeners = () => {\n      window.removeEventListener(\"pagehide\", onPageHide);\n      document.removeEventListener(\"visibilitychange\", onPageHide);\n    };\n  }\n\n  private _stopCurrentRecording() {\n    if (this._detachListeners) {\n      this._detachListeners();\n      this._detachListeners = null;\n    }\n    if (this._stopRecording) {\n      this._stopRecording();\n      this._stopRecording = null;\n    }\n    this._events = [];\n    this._approxBytes = 0;\n    this._recording = false;\n  }\n\n  private _tick() {\n    if (this._cancelled) return;\n    if (this._events.length > 0) {\n      runAsynchronously(() => this._flush({ keepalive: false }));\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/esm/lib/stack-app/apps/implementations/session-replay.test.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/esm/lib/stack-app/apps/implementations/session-replay.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { analyticsOptionsFromJson, analyticsOptionsToJson } from "./session-replay.js";
+
+//#region src/lib/stack-app/apps/implementations/session-replay.test.ts
+describe("analytics option JSON conversion", () => {
+	it("preserves top-level analytics options when serializing replay block classes", () => {
+		const json = analyticsOptionsToJson({
+			enabled: false,
+			replays: {
+				enabled: true,
+				blockClass: /stack-sensitive/u
+			}
+		});
+		expect(json?.enabled).toBe(false);
+		expect(json?.replays?.enabled).toBe(true);
+	});
+	it("preserves top-level analytics options when deserializing replay block classes", () => {
+		const roundTripped = analyticsOptionsFromJson(analyticsOptionsToJson({
+			enabled: false,
+			replays: { blockClass: /stack-sensitive/u }
+		}));
+		expect(roundTripped?.enabled).toBe(false);
+		expect(roundTripped?.replays?.blockClass).toEqual(/stack-sensitive/u);
+	});
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=session-replay.test.js.map

package/dist/esm/lib/stack-app/apps/implementations/session-replay.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.test.js","names":[],"sources":["../../../../../../src/lib/stack-app/apps/implementations/session-replay.test.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { describe, expect, it } from \"vitest\";\nimport { analyticsOptionsFromJson, analyticsOptionsToJson } from \"./session-replay\";\n\ndescribe(\"analytics option JSON conversion\", () => {\n  it(\"preserves top-level analytics options when serializing replay block classes\", () => {\n    const json = analyticsOptionsToJson({\n      enabled: false,\n      replays: {\n        enabled: true,\n        blockClass: /stack-sensitive/u,\n      },\n    });\n\n    expect(json?.enabled).toBe(false);\n    expect(json?.replays?.enabled).toBe(true);\n  });\n\n  it(\"preserves top-level analytics options when deserializing replay block classes\", () => {\n    const roundTripped = analyticsOptionsFromJson(analyticsOptionsToJson({\n      enabled: false,\n      replays: {\n        blockClass: /stack-sensitive/u,\n      },\n    }));\n\n    expect(roundTripped?.enabled).toBe(false);\n    expect(roundTripped?.replays?.blockClass).toEqual(/stack-sensitive/u);\n  });\n});\n"],"mappings":";;;;AAOA,SAAS,0CAA0C;AACjD,IAAG,qFAAqF;EACtF,MAAM,OAAO,uBAAuB;GAClC,SAAS;GACT,SAAS;IACP,SAAS;IACT,YAAY;IACb;GACF,CAAC;AAEF,SAAO,MAAM,QAAQ,CAAC,KAAK,MAAM;AACjC,SAAO,MAAM,SAAS,QAAQ,CAAC,KAAK,KAAK;GACzC;AAEF,IAAG,uFAAuF;EACxF,MAAM,eAAe,yBAAyB,uBAAuB;GACnE,SAAS;GACT,SAAS,EACP,YAAY,oBACb;GACF,CAAC,CAAC;AAEH,SAAO,cAAc,QAAQ,CAAC,KAAK,MAAM;AACzC,SAAO,cAAc,SAAS,WAAW,CAAC,QAAQ,mBAAmB;GACrE;EACF"}

package/dist/esm/lib/stack-app/apps/index.d.ts

@@ -0,0 +1,4 @@
+import { StackClientApp, StackClientAppConstructor, StackClientAppConstructorOptions, StackClientAppJson } from "./interfaces/client-app";
+import { StackServerApp, StackServerAppConstructor, StackServerAppConstructorOptions } from "./interfaces/server-app";
+import { StackAdminApp, StackAdminAppConstructor, StackAdminAppConstructorOptions } from "./interfaces/admin-app";
+export { StackAdminApp, type StackAdminAppConstructor, type StackAdminAppConstructorOptions, StackClientApp, type StackClientAppConstructor, type StackClientAppConstructorOptions, type StackClientAppJson, StackServerApp, type StackServerAppConstructor, type StackServerAppConstructorOptions };

package/dist/esm/lib/stack-app/apps/index.js

@@ -0,0 +1,5 @@
+import { StackClientApp } from "./interfaces/client-app.js";
+import { StackServerApp } from "./interfaces/server-app.js";
+import { StackAdminApp } from "./interfaces/admin-app.js";
+
+export { StackAdminApp, StackClientApp, StackServerApp };

package/dist/esm/lib/stack-app/apps/interfaces/admin-app.d.ts

@@ -0,0 +1,252 @@
+import { Result } from "@stackframe/stack-shared/dist/utils/results";
+import { InternalSession } from "@stackframe/stack-shared/dist/sessions";
+import { AsyncStoreProperty, EmailConfig } from "../../common";
+import { AnalyticsQueryOptions, AnalyticsQueryResponse } from "@stackframe/stack-shared/dist/interface/crud/analytics";
+import { AdminGetSessionReplayChunkEventsResponse } from "@stackframe/stack-shared/dist/interface/crud/session-replays";
+import { Transaction, TransactionType } from "@stackframe/stack-shared/dist/interface/crud/transactions";
+import { MoneyAmount } from "@stackframe/stack-shared/dist/utils/currency-constants";
+import { InternalApiKey, InternalApiKeyCreateOptions, InternalApiKeyFirstView } from "../../internal-api-keys";
+import { AdminProjectPermission, AdminProjectPermissionDefinition, AdminProjectPermissionDefinitionCreateOptions, AdminProjectPermissionDefinitionUpdateOptions, AdminTeamPermission, AdminTeamPermissionDefinition, AdminTeamPermissionDefinitionCreateOptions, AdminTeamPermissionDefinitionUpdateOptions } from "../../permissions";
+import { AdminProject } from "../../projects";
+import { AdminSessionReplay, AdminSessionReplay as AdminSessionReplay$1, AdminSessionReplayChunk, ListSessionReplayChunksOptions, ListSessionReplayChunksOptions as ListSessionReplayChunksOptions$1, ListSessionReplayChunksResult, ListSessionReplayChunksResult as ListSessionReplayChunksResult$1, ListSessionReplaysOptions, ListSessionReplaysOptions as ListSessionReplaysOptions$1, ListSessionReplaysResult, ListSessionReplaysResult as ListSessionReplaysResult$1, SessionReplayAllEventsResult, SessionReplayAllEventsResult as SessionReplayAllEventsResult$1 } from "../../session-replays";
+import { AdminEmailOutbox, AdminSentEmail } from "../../email";
+import { StackServerApp, StackServerAppConstructorOptions } from "./server-app";
+
+//#region src/lib/stack-app/apps/interfaces/admin-app.d.ts
+type EmailOutboxListOptions = {
+  status?: string;
+  simpleStatus?: string;
+  limit?: number;
+  cursor?: string;
+};
+type EmailOutboxListResult = {
+  items: AdminEmailOutbox[];
+  nextCursor: string | null;
+};
+type EmailOutboxUpdateOptions = {
+  isPaused?: boolean;
+  scheduledAtMillis?: number;
+  cancel?: boolean;
+  tsxSource?: string;
+  themeId?: string | null;
+};
+type ManagedEmailProviderSetupResult = {
+  domainId: string;
+  subdomain: string;
+  senderLocalPart: string;
+  nameServerRecords: string[];
+  status: ManagedEmailProviderStatus["status"];
+};
+type ManagedEmailProviderStatus = {
+  status: "pending_dns" | "pending_verification" | "verified" | "applied" | "failed";
+};
+type ManagedEmailProviderListItem = {
+  domainId: string;
+  subdomain: string;
+  senderLocalPart: string;
+  status: ManagedEmailProviderStatus["status"];
+  nameServerRecords: string[];
+};
+type StackAdminAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = (StackServerAppConstructorOptions<HasTokenStore, ProjectId> & {
+  superSecretAdminKey?: string;
+  projectOwnerSession?: InternalSession | (() => Promise<string | null>);
+});
+type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (AsyncStoreProperty<"project", [], AdminProject, false> & AsyncStoreProperty<"internalApiKeys", [], InternalApiKey[], true> & AsyncStoreProperty<"teamPermissionDefinitions", [], AdminTeamPermissionDefinition[], true> & AsyncStoreProperty<"projectPermissionDefinitions", [], AdminProjectPermissionDefinition[], true> & AsyncStoreProperty<"emailThemes", [], {
+  id: string;
+  displayName: string;
+}[], true> & AsyncStoreProperty<"emailPreview", [{
+  themeId?: string | null | false;
+  themeTsxSource?: string;
+  templateId?: string;
+  templateTsxSource?: string;
+}], string, false> & AsyncStoreProperty<"emailPreviewWithEditableMarkers", [{
+  themeId?: string | null | false;
+  themeTsxSource?: string;
+  templateId?: string;
+  templateTsxSource?: string;
+  editableSource?: 'template' | 'theme' | 'both';
+}], {
+  html: string;
+  editableRegions?: Record<string, unknown>;
+}, false> & AsyncStoreProperty<"emailTemplates", [], {
+  id: string;
+  displayName: string;
+  themeId?: string;
+  tsxSource: string;
+}[], true> & AsyncStoreProperty<"emailDrafts", [], {
+  id: string;
+  displayName: string;
+  themeId: string | undefined | false;
+  tsxSource: string;
+  sentAt: Date | null;
+}[], true> & AsyncStoreProperty<"stripeAccountInfo", [], {
+  account_id: string;
+  charges_enabled: boolean;
+  details_submitted: boolean;
+  payouts_enabled: boolean;
+} | null, false> & AsyncStoreProperty<"transactions", [{
+  cursor?: string;
+  limit?: number;
+  type?: TransactionType;
+  customerType?: 'user' | 'team' | 'custom';
+  customerId?: string;
+}], {
+  transactions: Transaction[];
+  nextCursor: string | null;
+}, true> & {
+  createInternalApiKey(options: InternalApiKeyCreateOptions): Promise<InternalApiKeyFirstView>;
+  createTeamPermissionDefinition(data: AdminTeamPermissionDefinitionCreateOptions): Promise<AdminTeamPermission>;
+  updateTeamPermissionDefinition(permissionId: string, data: AdminTeamPermissionDefinitionUpdateOptions): Promise<void>;
+  deleteTeamPermissionDefinition(permissionId: string): Promise<void>;
+  /**
+   * @param options.query Free-text search; matches against permission ID and description.
+   */
+  listTeamPermissionDefinitionsPaginated(options: {
+    limit: number;
+    cursor?: string;
+    query?: string;
+  }): Promise<{
+    items: AdminTeamPermissionDefinition[];
+    nextCursor: string | null;
+  }>;
+  createProjectPermissionDefinition(data: AdminProjectPermissionDefinitionCreateOptions): Promise<AdminProjectPermission>;
+  updateProjectPermissionDefinition(permissionId: string, data: AdminProjectPermissionDefinitionUpdateOptions): Promise<void>;
+  deleteProjectPermissionDefinition(permissionId: string): Promise<void>;
+  useSvixToken(): {
+    token: string;
+    url: string | undefined;
+  };
+  sendTestEmail(options: {
+    recipientEmail: string;
+    emailConfig: EmailConfig;
+  }): Promise<Result<undefined, {
+    errorMessage: string;
+  }>>;
+  sendTestWebhook(options: {
+    endpointId: string;
+  }): Promise<Result<undefined, {
+    errorMessage: string;
+  }>>;
+  sendSignInInvitationEmail(email: string, callbackUrl: string): Promise<void>;
+  listSentEmails(): Promise<AdminSentEmail[]>;
+  setupManagedEmailProvider(options: {
+    subdomain: string;
+    senderLocalPart: string;
+  }): Promise<ManagedEmailProviderSetupResult>;
+  checkManagedEmailStatus(options: {
+    domainId: string;
+    subdomain: string;
+    senderLocalPart: string;
+  }): Promise<ManagedEmailProviderStatus>;
+  listManagedEmailDomains(): Promise<ManagedEmailProviderListItem[]>;
+  applyManagedEmailProvider(options: {
+    domainId: string;
+  }): Promise<{
+    status: "applied";
+  }>;
+  useEmailTheme(id: string): {
+    displayName: string;
+    tsxSource: string;
+  };
+  createEmailTheme(displayName: string): Promise<{
+    id: string;
+  }>;
+  updateEmailTheme(id: string, tsxSource: string): Promise<void>;
+  deleteEmailTheme(id: string): Promise<void>;
+  saveChatMessage(threadId: string, message: any): Promise<void>;
+  listChatMessages(threadId: string): Promise<{
+    messages: Array<any>;
+  }>;
+  rewriteTemplateSourceWithAI(templateTsxSource: string): Promise<{
+    tsxSource: string;
+  }>;
+  updateEmailTemplate(id: string, tsxSource: string, themeId: string | null | false): Promise<{
+    renderedHtml: string;
+  }>;
+  createEmailTemplate(displayName: string): Promise<{
+    id: string;
+  }>;
+  deleteEmailTemplate(id: string): Promise<void>;
+  setupPayments(): Promise<{
+    url: string;
+  }>;
+  createStripeWidgetAccountSession(): Promise<{
+    client_secret: string;
+  }>;
+  getPaymentMethodConfigs(): Promise<{
+    configId: string;
+    methods: Array<{
+      id: string;
+      name: string;
+      enabled: boolean;
+      available: boolean;
+      overridable: boolean;
+    }>;
+  } | null>;
+  updatePaymentMethodConfigs(configId: string, updates: Record<string, 'on' | 'off'>): Promise<void>;
+  createEmailDraft(options: {
+    displayName: string;
+    themeId?: string | undefined | false;
+    tsxSource?: string;
+  }): Promise<{
+    id: string;
+  }>;
+  updateEmailDraft(id: string, data: {
+    displayName?: string;
+    themeId?: string | undefined | false;
+    tsxSource?: string;
+  }): Promise<void>;
+  deleteEmailDraft(id: string): Promise<void>;
+  refreshEmailDrafts(): Promise<void>;
+  createItemQuantityChange(options: ({
+    userId: string;
+    itemId: string;
+    quantity: number;
+    expiresAt?: string;
+    description?: string;
+  } | {
+    teamId: string;
+    itemId: string;
+    quantity: number;
+    expiresAt?: string;
+    description?: string;
+  } | {
+    customCustomerId: string;
+    itemId: string;
+    quantity: number;
+    expiresAt?: string;
+    description?: string;
+  })): Promise<void>;
+  refundTransaction(options: {
+    type: "subscription" | "one-time-purchase";
+    id: string;
+    invoiceId?: string;
+    amountUsd: MoneyAmount;
+    endAction?: "now" | "at-period-end";
+  }): Promise<{
+    refundTransactionId: string;
+  }>;
+  queryAnalytics(options: AnalyticsQueryOptions): Promise<AnalyticsQueryResponse>;
+  listSessionReplays(options?: ListSessionReplaysOptions$1): Promise<ListSessionReplaysResult$1>;
+  getSessionReplay(sessionReplayId: string): Promise<AdminSessionReplay$1>;
+  listSessionReplayChunks(sessionReplayId: string, options?: ListSessionReplayChunksOptions$1): Promise<ListSessionReplayChunksResult$1>;
+  getSessionReplayChunkEvents(sessionReplayId: string, chunkId: string): Promise<AdminGetSessionReplayChunkEventsResponse>;
+  getSessionReplayEvents(sessionReplayId: string, options?: {
+    offset?: number;
+    limit?: number;
+  }): Promise<SessionReplayAllEventsResult$1>;
+  listOutboxEmails(options?: EmailOutboxListOptions): Promise<EmailOutboxListResult>;
+  getOutboxEmail(id: string): Promise<AdminEmailOutbox>;
+  updateOutboxEmail(id: string, options: EmailOutboxUpdateOptions): Promise<AdminEmailOutbox>;
+  pauseOutboxEmail(id: string): Promise<AdminEmailOutbox>;
+  unpauseOutboxEmail(id: string): Promise<AdminEmailOutbox>;
+  cancelOutboxEmail(id: string): Promise<AdminEmailOutbox>;
+} & StackServerApp<HasTokenStore, ProjectId>);
+type StackAdminAppConstructor = {
+  new <HasTokenStore extends boolean, ProjectId extends string>(options: StackAdminAppConstructorOptions<HasTokenStore, ProjectId>): StackAdminApp<HasTokenStore, ProjectId>;
+  new (options: StackAdminAppConstructorOptions<boolean, string>): StackAdminApp<boolean, string>;
+};
+declare const StackAdminApp: StackAdminAppConstructor;
+//#endregion
+export { type AdminSessionReplay, type AdminSessionReplayChunk, EmailOutboxListOptions, EmailOutboxListResult, EmailOutboxUpdateOptions, type ListSessionReplayChunksOptions, type ListSessionReplayChunksResult, type ListSessionReplaysOptions, type ListSessionReplaysResult, ManagedEmailProviderListItem, ManagedEmailProviderSetupResult, ManagedEmailProviderStatus, type SessionReplayAllEventsResult, StackAdminApp, StackAdminAppConstructor, StackAdminAppConstructorOptions };
+//# sourceMappingURL=admin-app.d.ts.map

package/dist/esm/lib/stack-app/apps/interfaces/admin-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-app.d.ts","names":[],"sources":["../../../../../../src/lib/stack-app/apps/interfaces/admin-app.ts"],"mappings":"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"}

package/dist/esm/lib/stack-app/apps/interfaces/admin-app.js

@@ -0,0 +1,8 @@
+import { _StackAdminAppImpl } from "../implementations/index.js";
+
+//#region src/lib/stack-app/apps/interfaces/admin-app.ts
+const StackAdminApp = _StackAdminAppImpl;
+
+//#endregion
+export { StackAdminApp };
+//# sourceMappingURL=admin-app.js.map

package/dist/esm/lib/stack-app/apps/interfaces/admin-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-app.js","names":[],"sources":["../../../../../../src/lib/stack-app/apps/interfaces/admin-app.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY, INSTEAD EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { AnalyticsQueryOptions, AnalyticsQueryResponse } from \"@stackframe/stack-shared/dist/interface/crud/analytics\";\nimport type { AdminGetSessionReplayChunkEventsResponse, AdminGetSessionReplayAllEventsResponse } from \"@stackframe/stack-shared/dist/interface/crud/session-replays\";\nimport type { Transaction, TransactionType } from \"@stackframe/stack-shared/dist/interface/crud/transactions\";\nimport { InternalSession } from \"@stackframe/stack-shared/dist/sessions\";\nimport type { MoneyAmount } from \"@stackframe/stack-shared/dist/utils/currency-constants\";\nimport { Result } from \"@stackframe/stack-shared/dist/utils/results\";\nimport { AsyncStoreProperty, EmailConfig } from \"../../common\";\nimport { AdminEmailOutbox, AdminSentEmail } from \"../../email\";\nimport { InternalApiKey, InternalApiKeyCreateOptions, InternalApiKeyFirstView } from \"../../internal-api-keys\";\nimport { AdminProjectPermission, AdminProjectPermissionDefinition, AdminProjectPermissionDefinitionCreateOptions, AdminProjectPermissionDefinitionUpdateOptions, AdminTeamPermission, AdminTeamPermissionDefinition, AdminTeamPermissionDefinitionCreateOptions, AdminTeamPermissionDefinitionUpdateOptions } from \"../../permissions\";\nimport { AdminProject } from \"../../projects\";\nimport { _StackAdminAppImpl } from \"../implementations\";\nimport { StackServerApp, StackServerAppConstructorOptions } from \"./server-app\";\n\nexport type EmailOutboxListOptions = {\n  status?: string,\n  simpleStatus?: string,\n  limit?: number,\n  cursor?: string,\n};\n\nexport type EmailOutboxListResult = {\n  items: AdminEmailOutbox[],\n  nextCursor: string | null,\n};\n\nexport type EmailOutboxUpdateOptions = {\n  isPaused?: boolean,\n  scheduledAtMillis?: number,\n  cancel?: boolean,\n  tsxSource?: string,\n  themeId?: string | null,\n};\n\nexport type ManagedEmailProviderSetupResult = {\n  domainId: string,\n  subdomain: string,\n  senderLocalPart: string,\n  nameServerRecords: string[],\n  status: ManagedEmailProviderStatus[\"status\"],\n};\n\nexport type ManagedEmailProviderStatus = {\n  status: \"pending_dns\" | \"pending_verification\" | \"verified\" | \"applied\" | \"failed\",\n};\n\nexport type ManagedEmailProviderListItem = {\n  domainId: string,\n  subdomain: string,\n  senderLocalPart: string,\n  status: ManagedEmailProviderStatus[\"status\"],\n  nameServerRecords: string[],\n};\n\nimport type { AdminSessionReplay, ListSessionReplayChunksOptions, ListSessionReplayChunksResult, ListSessionReplaysOptions, ListSessionReplaysResult, SessionReplayAllEventsResult } from \"../../session-replays\";\nexport type { AdminSessionReplay, AdminSessionReplayChunk, ListSessionReplaysOptions, ListSessionReplaysResult, ListSessionReplayChunksOptions, ListSessionReplayChunksResult, SessionReplayAllEventsResult } from \"../../session-replays\";\n\n\nexport type StackAdminAppConstructorOptions<HasTokenStore extends boolean, ProjectId extends string> = (\n  & StackServerAppConstructorOptions<HasTokenStore, ProjectId>\n  & {\n    superSecretAdminKey?: string,\n    projectOwnerSession?: InternalSession | (() => Promise<string | null>),\n  }\n);\n\n\nexport type StackAdminApp<HasTokenStore extends boolean = boolean, ProjectId extends string = string> = (\n  & AsyncStoreProperty<\"project\", [], AdminProject, false>\n  & AsyncStoreProperty<\"internalApiKeys\", [], InternalApiKey[], true>\n  & AsyncStoreProperty<\"teamPermissionDefinitions\", [], AdminTeamPermissionDefinition[], true>\n  & AsyncStoreProperty<\"projectPermissionDefinitions\", [], AdminProjectPermissionDefinition[], true>\n  & AsyncStoreProperty<\"emailThemes\", [], { id: string, displayName: string }[], true>\n  & AsyncStoreProperty<\"emailPreview\", [{ themeId?: string | null | false, themeTsxSource?: string, templateId?: string, templateTsxSource?: string }], string, false>\n  & AsyncStoreProperty<\"emailPreviewWithEditableMarkers\", [{ themeId?: string | null | false, themeTsxSource?: string, templateId?: string, templateTsxSource?: string, editableSource?: 'template' | 'theme' | 'both' }], { html: string, editableRegions?: Record<string, unknown> }, false> // THIS_LINE_PLATFORM react-like\n  & AsyncStoreProperty<\"emailTemplates\", [], { id: string, displayName: string, themeId?: string, tsxSource: string }[], true>\n  & AsyncStoreProperty<\"emailDrafts\", [], { id: string, displayName: string, themeId: string | undefined | false, tsxSource: string, sentAt: Date | null }[], true>\n  & AsyncStoreProperty<\"stripeAccountInfo\", [], { account_id: string, charges_enabled: boolean, details_submitted: boolean, payouts_enabled: boolean } | null, false>\n  & AsyncStoreProperty<\n    \"transactions\",\n    [{\n      cursor?: string,\n      limit?: number,\n      type?: TransactionType,\n      customerType?: 'user' | 'team' | 'custom',\n      customerId?: string,\n    }],\n    { transactions: Transaction[], nextCursor: string | null },\n    true\n  >\n  & {\n    createInternalApiKey(options: InternalApiKeyCreateOptions): Promise<InternalApiKeyFirstView>,\n\n    createTeamPermissionDefinition(data: AdminTeamPermissionDefinitionCreateOptions): Promise<AdminTeamPermission>,\n    updateTeamPermissionDefinition(permissionId: string, data: AdminTeamPermissionDefinitionUpdateOptions): Promise<void>,\n    deleteTeamPermissionDefinition(permissionId: string): Promise<void>,\n    /**\n     * @param options.query Free-text search; matches against permission ID and description.\n     */\n    listTeamPermissionDefinitionsPaginated(options: { limit: number, cursor?: string, query?: string }): Promise<{ items: AdminTeamPermissionDefinition[], nextCursor: string | null }>,\n\n    createProjectPermissionDefinition(data: AdminProjectPermissionDefinitionCreateOptions): Promise<AdminProjectPermission>,\n    updateProjectPermissionDefinition(permissionId: string, data: AdminProjectPermissionDefinitionUpdateOptions): Promise<void>,\n    deleteProjectPermissionDefinition(permissionId: string): Promise<void>,\n\n    useSvixToken(): { token: string, url: string | undefined }, // THIS_LINE_PLATFORM react-like\n\n    sendTestEmail(options: {\n      recipientEmail: string,\n      emailConfig: EmailConfig,\n    }): Promise<Result<undefined, { errorMessage: string }>>,\n\n    sendTestWebhook(options: { endpointId: string }): Promise<Result<undefined, { errorMessage: string }>>,\n\n    sendSignInInvitationEmail(email: string, callbackUrl: string): Promise<void>,\n\n    listSentEmails(): Promise<AdminSentEmail[]>,\n    setupManagedEmailProvider(options: { subdomain: string, senderLocalPart: string }): Promise<ManagedEmailProviderSetupResult>,\n    checkManagedEmailStatus(options: { domainId: string, subdomain: string, senderLocalPart: string }): Promise<ManagedEmailProviderStatus>,\n    listManagedEmailDomains(): Promise<ManagedEmailProviderListItem[]>,\n    applyManagedEmailProvider(options: { domainId: string }): Promise<{ status: \"applied\" }>,\n\n    useEmailTheme(id: string): { displayName: string, tsxSource: string }, // THIS_LINE_PLATFORM react-like\n    createEmailTheme(displayName: string): Promise<{ id: string }>,\n    updateEmailTheme(id: string, tsxSource: string): Promise<void>,\n    deleteEmailTheme(id: string): Promise<void>,\n    saveChatMessage(threadId: string, message: any): Promise<void>,\n    listChatMessages(threadId: string): Promise<{ messages: Array<any> }>,\n    rewriteTemplateSourceWithAI(templateTsxSource: string): Promise<{ tsxSource: string }>,\n    updateEmailTemplate(id: string, tsxSource: string, themeId: string | null | false): Promise<{ renderedHtml: string }>,\n    createEmailTemplate(displayName: string): Promise<{ id: string }>,\n    deleteEmailTemplate(id: string): Promise<void>,\n\n    setupPayments(): Promise<{ url: string }>,\n    createStripeWidgetAccountSession(): Promise<{ client_secret: string }>,\n    getPaymentMethodConfigs(): Promise<{ configId: string, methods: Array<{ id: string, name: string, enabled: boolean, available: boolean, overridable: boolean }> } | null>,\n    updatePaymentMethodConfigs(configId: string, updates: Record<string, 'on' | 'off'>): Promise<void>,\n    createEmailDraft(options: { displayName: string, themeId?: string | undefined | false, tsxSource?: string }): Promise<{ id: string }>,\n    updateEmailDraft(id: string, data: { displayName?: string, themeId?: string | undefined | false, tsxSource?: string }): Promise<void>,\n    deleteEmailDraft(id: string): Promise<void>,\n    refreshEmailDrafts(): Promise<void>,\n    createItemQuantityChange(options: (\n      { userId: string, itemId: string, quantity: number, expiresAt?: string, description?: string } |\n      { teamId: string, itemId: string, quantity: number, expiresAt?: string, description?: string } |\n      { customCustomerId: string, itemId: string, quantity: number, expiresAt?: string, description?: string }\n    )): Promise<void>,\n    refundTransaction(options: {\n      type: \"subscription\" | \"one-time-purchase\",\n      id: string,\n      invoiceId?: string,\n      amountUsd: MoneyAmount,\n      endAction?: \"now\" | \"at-period-end\",\n    }): Promise<{ refundTransactionId: string }>,\n    queryAnalytics(options: AnalyticsQueryOptions): Promise<AnalyticsQueryResponse>,\n\n    listSessionReplays(options?: ListSessionReplaysOptions): Promise<ListSessionReplaysResult>,\n    getSessionReplay(sessionReplayId: string): Promise<AdminSessionReplay>,\n    listSessionReplayChunks(sessionReplayId: string, options?: ListSessionReplayChunksOptions): Promise<ListSessionReplayChunksResult>,\n    getSessionReplayChunkEvents(sessionReplayId: string, chunkId: string): Promise<AdminGetSessionReplayChunkEventsResponse>,\n    getSessionReplayEvents(sessionReplayId: string, options?: { offset?: number, limit?: number }): Promise<SessionReplayAllEventsResult>,\n\n    // Email Outbox methods\n    listOutboxEmails(options?: EmailOutboxListOptions): Promise<EmailOutboxListResult>,\n    getOutboxEmail(id: string): Promise<AdminEmailOutbox>,\n    updateOutboxEmail(id: string, options: EmailOutboxUpdateOptions): Promise<AdminEmailOutbox>,\n    pauseOutboxEmail(id: string): Promise<AdminEmailOutbox>,\n    unpauseOutboxEmail(id: string): Promise<AdminEmailOutbox>,\n    cancelOutboxEmail(id: string): Promise<AdminEmailOutbox>,\n  }\n  & StackServerApp<HasTokenStore, ProjectId>\n);\nexport type StackAdminAppConstructor = {\n  new <\n    HasTokenStore extends boolean,\n    ProjectId extends string\n  >(options: StackAdminAppConstructorOptions<HasTokenStore, ProjectId>): StackAdminApp<HasTokenStore, ProjectId>,\n  new(options: StackAdminAppConstructorOptions<boolean, string>): StackAdminApp<boolean, string>,\n};\nexport const StackAdminApp: StackAdminAppConstructor = _StackAdminAppImpl;\n"],"mappings":";;;AAsLA,MAAa,gBAA0C"}