@mercurjs/core 2.3.9-canary.3 → 2.3.9-canary.5

package/.medusa/server/src/utils/telemetry/boot.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scheduleTelemetryBoot = scheduleTelemetryBoot;
+const framework_1 = require("@medusajs/framework");
+const utils_1 = require("@medusajs/framework/utils");
+const types_1 = require("@mercurjs/types");
+const config_1 = require("./config");
+const milestones_1 = require("./milestones");
+const sender_1 = require("./sender");
+const snapshot_1 = require("./snapshot");
+let scheduled = false;
+const startedAt = Date.now();
+const uptimeSeconds = () => Math.floor((Date.now() - startedAt) / 1_000);
+const groupIdentify = (installation, snapshot) => {
+    const { $groups: _groups, ...properties } = snapshot;
+    return {
+        event: "$groupidentify",
+        distinct_id: installation.installation_id,
+        properties: {
+            $group_type: "installation",
+            $group_key: installation.installation_id,
+            $group_set: properties,
+        },
+    };
+};
+const bucketMilestones = [
+    ["payouts_paid", milestones_1.TelemetryMilestones.FIRST_PAYOUT_PAID],
+    ["commission_rules_total", milestones_1.TelemetryMilestones.FIRST_COMMISSION_RULE],
+];
+async function report(container, event) {
+    const logger = container.resolve(utils_1.ContainerRegistrationKeys.LOGGER);
+    const service = container.resolve(types_1.MercurModules.TELEMETRY);
+    const sender = (0, sender_1.createTelemetrySender)({ logger });
+    const installation = await service.getOrCreateInstallation();
+    const snapshot = await (0, snapshot_1.collectSnapshot)(container, installation, uptimeSeconds());
+    const events = [
+        { event, distinct_id: installation.installation_id, properties: snapshot },
+        groupIdentify(installation, snapshot),
+    ];
+    const version = snapshot.mercur_version;
+    if (version && installation.last_reported_version && installation.last_reported_version !== version) {
+        events.push({
+            event: "instance_upgraded",
+            distinct_id: installation.installation_id,
+            properties: { ...snapshot, from_version: installation.last_reported_version, to_version: version },
+        });
+    }
+    const milestones = (installation.milestones ?? {});
+    const dueMilestones = [
+        ...(snapshot.node_env === "production" ? [milestones_1.TelemetryMilestones.FIRST_PRODUCTION_BOOT] : []),
+        ...bucketMilestones.filter(([key]) => snapshot[key] && snapshot[key] !== "0").map(([, m]) => m),
+    ].filter((m) => !milestones[m]);
+    for (const milestone of dueMilestones) {
+        if (await service.recordMilestone(milestone)) {
+            events.push({
+                event: "installation_milestone",
+                distinct_id: installation.installation_id,
+                properties: { ...snapshot, milestone, days_since_install: snapshot.instance_age_days },
+            });
+        }
+    }
+    await sender.capture(events);
+    if (version && installation.last_reported_version !== version) {
+        await service.setReportedVersion(version);
+    }
+}
+function scheduleHeartbeat(container) {
+    const delay = config_1.HEARTBEAT_INTERVAL_MS + Math.floor(Math.random() * config_1.HEARTBEAT_JITTER_MS);
+    const timer = setTimeout(async () => {
+        try {
+            const service = container.resolve(types_1.MercurModules.TELEMETRY);
+            if (await service.claimHeartbeat(config_1.HEARTBEAT_MIN_GAP_SECONDS)) {
+                await report(container, "instance_heartbeat");
+            }
+        }
+        catch (error) {
+            container.resolve(utils_1.ContainerRegistrationKeys.LOGGER).debug(`[telemetry] heartbeat skipped: ${error?.message}`);
+        }
+        finally {
+            scheduleHeartbeat(container);
+        }
+    }, delay);
+    timer.unref();
+}
+async function run(container) {
+    const logger = container.resolve(utils_1.ContainerRegistrationKeys.LOGGER);
+    const reason = (0, config_1.telemetryDisabledReason)({ configEnabled: (0, milestones_1.isTelemetryConfigEnabled)(container) });
+    if (reason) {
+        logger.debug(`[telemetry] disabled (${reason}). ${config_1.TELEMETRY_DOCS_URL}`);
+        return;
+    }
+    try {
+        const service = container.resolve(types_1.MercurModules.TELEMETRY);
+        await service.getOrCreateInstallation();
+        await service.claimHeartbeat(0);
+        await report(container, "instance_started");
+    }
+    catch (error) {
+        logger.debug(`[telemetry] boot report skipped: ${error?.message}`);
+    }
+    scheduleHeartbeat(container);
+}
+/**
+ * Called from the plugin's API middleware file, which Medusa only loads in
+ * processes that serve HTTP. Worker processes, `medusa exec` and migrations
+ * never import it, so a boot event means a real server came up.
+ */
+function scheduleTelemetryBoot(container = framework_1.container) {
+    if (scheduled)
+        return;
+    scheduled = true;
+    const timer = setTimeout(() => {
+        run(container).catch(() => undefined);
+    }, (0, config_1.startupDelayMs)());
+    timer.unref();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYm9vdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy91dGlscy90ZWxlbWV0cnkvYm9vdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQWdJQSxzREFRQztBQXhJRCxtREFBa0U7QUFFbEUscURBQXFFO0FBQ3JFLDJDQUErQztBQUcvQyxxQ0FPaUI7QUFDakIsNkNBQTRFO0FBQzVFLHFDQUFnRTtBQUNoRSx5Q0FBZ0U7QUFFaEUsSUFBSSxTQUFTLEdBQUcsS0FBSyxDQUFBO0FBQ3JCLE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQTtBQUU1QixNQUFNLGFBQWEsR0FBRyxHQUFHLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLFNBQVMsQ0FBQyxHQUFHLEtBQUssQ0FBQyxDQUFBO0FBRXhFLE1BQU0sYUFBYSxHQUFHLENBQUMsWUFBZ0MsRUFBRSxRQUFpQyxFQUFrQixFQUFFO0lBQzVHLE1BQU0sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEdBQUcsVUFBVSxFQUFFLEdBQUcsUUFBUSxDQUFBO0lBQ3BELE9BQU87UUFDTCxLQUFLLEVBQUUsZ0JBQWdCO1FBQ3ZCLFdBQVcsRUFBRSxZQUFZLENBQUMsZUFBZTtRQUN6QyxVQUFVLEVBQUU7WUFDVixXQUFXLEVBQUUsY0FBYztZQUMzQixVQUFVLEVBQUUsWUFBWSxDQUFDLGVBQWU7WUFDeEMsVUFBVSxFQUFFLFVBQVU7U0FDdkI7S0FDRixDQUFBO0FBQ0gsQ0FBQyxDQUFBO0FBRUQsTUFBTSxnQkFBZ0IsR0FBb0Y7SUFDeEcsQ0FBQyxjQUFjLEVBQUUsZ0NBQW1CLENBQUMsaUJBQWlCLENBQUM7SUFDdkQsQ0FBQyx3QkFBd0IsRUFBRSxnQ0FBbUIsQ0FBQyxxQkFBcUIsQ0FBQztDQUN0RSxDQUFBO0FBRUQsS0FBSyxVQUFVLE1BQU0sQ0FBQyxTQUEwQixFQUFFLEtBQWdEO0lBQ2hH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

package/.medusa/server/src/utils/telemetry/buckets.d.ts

@@ -0,0 +1,2 @@
+export type CountBucket = "0" | "1-10" | "11-100" | "101-1k" | "1k-10k" | "10k-100k" | "100k+";
+export declare function toBucket(count: number | null | undefined): CountBucket | undefined;

package/.medusa/server/src/utils/telemetry/buckets.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBucket = toBucket;
+function toBucket(count) {
+    if (count === null || count === undefined || !Number.isFinite(count) || count < 0) {
+        return undefined;
+    }
+    if (count === 0)
+        return "0";
+    if (count <= 10)
+        return "1-10";
+    if (count <= 100)
+        return "11-100";
+    if (count <= 1_000)
+        return "101-1k";
+    if (count <= 10_000)
+        return "1k-10k";
+    if (count <= 100_000)
+        return "10k-100k";
+    return "100k+";
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVja2V0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy91dGlscy90ZWxlbWV0cnkvYnVja2V0cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUVBLDRCQVdDO0FBWEQsU0FBZ0IsUUFBUSxDQUFDLEtBQWdDO0lBQ3ZELElBQUksS0FBSyxLQUFLLElBQUksSUFBSSxLQUFLLEtBQUssU0FBUyxJQUFJLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsSUFBSSxLQUFLLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDbEYsT0FBTyxTQUFTLENBQUE7SUFDbEIsQ0FBQztJQUNELElBQUksS0FBSyxLQUFLLENBQUM7UUFBRSxPQUFPLEdBQUcsQ0FBQTtJQUMzQixJQUFJLEtBQUssSUFBSSxFQUFFO1FBQUUsT0FBTyxNQUFNLENBQUE7SUFDOUIsSUFBSSxLQUFLLElBQUksR0FBRztRQUFFLE9BQU8sUUFBUSxDQUFBO0lBQ2pDLElBQUksS0FBSyxJQUFJLEtBQUs7UUFBRSxPQUFPLFFBQVEsQ0FBQTtJQUNuQyxJQUFJLEtBQUssSUFBSSxNQUFNO1FBQUUsT0FBTyxRQUFRLENBQUE7SUFDcEMsSUFBSSxLQUFLLElBQUksT0FBTztRQUFFLE9BQU8sVUFBVSxDQUFBO0lBQ3ZDLE9BQU8sT0FBTyxDQUFBO0FBQ2hCLENBQUMifQ==

package/.medusa/server/src/utils/telemetry/config.d.ts

@@ -0,0 +1,19 @@
+export declare const TELEMETRY_SCHEMA_VERSION = 1;
+export declare const TELEMETRY_DOCS_URL = "https://docs.mercurjs.com/telemetry";
+export declare const DEFAULT_TELEMETRY_HOST = "https://telemetry.mercurjs.com";
+export declare const TELEMETRY_REQUEST_TIMEOUT_MS = 2000;
+export declare const HEARTBEAT_INTERVAL_MS: number;
+export declare const HEARTBEAT_JITTER_MS: number;
+export declare const HEARTBEAT_MIN_GAP_SECONDS: number;
+export declare const DEFAULT_STARTUP_DELAY_MS = 5000;
+export declare const isCi: (env?: NodeJS.ProcessEnv) => boolean;
+export type TelemetryEnablementInput = {
+    env?: NodeJS.ProcessEnv;
+    configEnabled?: boolean;
+    workerMode?: string;
+};
+export type TelemetryDisabledReason = "env" | "do_not_track" | "config" | "ci" | "test" | "worker";
+export declare function telemetryDisabledReason({ env, configEnabled, workerMode, }?: TelemetryEnablementInput): TelemetryDisabledReason | null;
+export declare const isTelemetryDebug: (env?: NodeJS.ProcessEnv) => boolean;
+export declare const telemetryHost: (env?: NodeJS.ProcessEnv) => string;
+export declare const startupDelayMs: (env?: NodeJS.ProcessEnv) => number;

package/.medusa/server/src/utils/telemetry/config.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startupDelayMs = exports.telemetryHost = exports.isTelemetryDebug = exports.isCi = exports.DEFAULT_STARTUP_DELAY_MS = exports.HEARTBEAT_MIN_GAP_SECONDS = exports.HEARTBEAT_JITTER_MS = exports.HEARTBEAT_INTERVAL_MS = exports.TELEMETRY_REQUEST_TIMEOUT_MS = exports.DEFAULT_TELEMETRY_HOST = exports.TELEMETRY_DOCS_URL = exports.TELEMETRY_SCHEMA_VERSION = void 0;
+exports.telemetryDisabledReason = telemetryDisabledReason;
+exports.TELEMETRY_SCHEMA_VERSION = 1;
+exports.TELEMETRY_DOCS_URL = "https://docs.mercurjs.com/telemetry";
+exports.DEFAULT_TELEMETRY_HOST = "https://telemetry.mercurjs.com";
+exports.TELEMETRY_REQUEST_TIMEOUT_MS = 2_000;
+exports.HEARTBEAT_INTERVAL_MS = 24 * 60 * 60 * 1_000;
+exports.HEARTBEAT_JITTER_MS = 60 * 60 * 1_000;
+exports.HEARTBEAT_MIN_GAP_SECONDS = 23 * 60 * 60;
+exports.DEFAULT_STARTUP_DELAY_MS = 5_000;
+const CI_ENV_KEYS = [
+    "CI",
+    "GITHUB_ACTIONS",
+    "GITLAB_CI",
+    "CIRCLECI",
+    "BUILDKITE",
+    "JENKINS_URL",
+    "TF_BUILD",
+    "TEAMCITY_VERSION",
+    "DRONE",
+];
+const isTruthy = (value) => value !== undefined && ["1", "true", "yes"].includes(value.toLowerCase());
+const isCi = (env = process.env) => CI_ENV_KEYS.some((key) => Boolean(env[key]));
+exports.isCi = isCi;
+function telemetryDisabledReason({ env = process.env, configEnabled = true, workerMode, } = {}) {
+    if (isTruthy(env.MERCUR_TELEMETRY_FORCE_ENABLED)) {
+        return null;
+    }
+    if (isTruthy(env.MERCUR_DISABLE_TELEMETRY)) {
+        return "env";
+    }
+    if (isTruthy(env.DO_NOT_TRACK)) {
+        return "do_not_track";
+    }
+    if (!configEnabled) {
+        return "config";
+    }
+    if (env.NODE_ENV === "test") {
+        return "test";
+    }
+    if ((0, exports.isCi)(env)) {
+        return "ci";
+    }
+    if (workerMode === "worker" || env.MEDUSA_WORKER_MODE === "worker") {
+        return "worker";
+    }
+    return null;
+}
+const isTelemetryDebug = (env = process.env) => isTruthy(env.MERCUR_TELEMETRY_DEBUG);
+exports.isTelemetryDebug = isTelemetryDebug;
+const telemetryHost = (env = process.env) => (env.MERCUR_TELEMETRY_PROXY_URL || exports.DEFAULT_TELEMETRY_HOST).replace(/\/+$/, "");
+exports.telemetryHost = telemetryHost;
+const startupDelayMs = (env = process.env) => {
+    const parsed = Number(env.MERCUR_TELEMETRY_STARTUP_DELAY_MS);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : exports.DEFAULT_STARTUP_DELAY_MS;
+};
+exports.startupDelayMs = startupDelayMs;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL3V0aWxzL3RlbGVtZXRyeS9jb25maWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBeUNBLDBEQTJCQztBQXBFWSxRQUFBLHdCQUF3QixHQUFHLENBQUMsQ0FBQTtBQUM1QixRQUFBLGtCQUFrQixHQUFHLHFDQUFxQyxDQUFBO0FBQzFELFFBQUEsc0JBQXNCLEdBQUcsZ0NBQWdDLENBQUE7QUFDekQsUUFBQSw0QkFBNEIsR0FBRyxLQUFLLENBQUE7QUFDcEMsUUFBQSxxQkFBcUIsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxLQUFLLENBQUE7QUFDNUMsUUFBQSxtQkFBbUIsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEtBQUssQ0FBQTtBQUNyQyxRQUFBLHlCQUF5QixHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxDQUFBO0FBQ3hDLFFBQUEsd0JBQXdCLEdBQUcsS0FBSyxDQUFBO0FBRTdDLE1BQU0sV0FBVyxHQUFHO0lBQ2xCLElBQUk7SUFDSixnQkFBZ0I7SUFDaEIsV0FBVztJQUNYLFVBQVU7SUFDVixXQUFXO0lBQ1gsYUFBYTtJQUNiLFVBQVU7SUFDVixrQkFBa0I7SUFDbEIsT0FBTztDQUNSLENBQUE7QUFFRCxNQUFNLFFBQVEsR0FBRyxDQUFDLEtBQXlCLEVBQUUsRUFBRSxDQUM3QyxLQUFLLEtBQUssU0FBUyxJQUFJLENBQUMsR0FBRyxFQUFFLE1BQU0sRUFBRSxLQUFLLENBQUMsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUE7QUFFcEUsTUFBTSxJQUFJLEdBQUcsQ0FBQyxNQUF5QixPQUFPLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FDM0QsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUE7QUFEakMsUUFBQSxJQUFJLFFBQzZCO0FBZ0I5QyxTQUFnQix1QkFBdUIsQ0FBQyxFQUN0QyxHQUFHLEdBQUcsT0FBTyxDQUFDLEdBQUcsRUFDakIsYUFBYSxHQUFHLElBQUksRUFDcEIsVUFBVSxNQUNrQixFQUFFO0lBQzlCLElBQUksUUFBUSxDQUFDLEdBQUcsQ0FBQyw4QkFBOEIsQ0FBQyxFQUFFLENBQUM7UUFDakQsT0FBTyxJQUFJLENBQUE7SUFDYixDQUFDO0lBQ0QsSUFBSSxRQUFRLENBQUMsR0FBRyxDQUFDLHdCQUF3QixDQUFDLEVBQUUsQ0FBQztRQUMzQyxPQUFPLEtBQUssQ0FBQTtJQUNkLENBQUM7SUFDRCxJQUFJLFFBQVEsQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLEVBQUUsQ0FBQztRQUMvQixPQUFPLGNBQWMsQ0FBQTtJQUN2QixDQUFDO0lBQ0QsSUFBSSxDQUFDLGFBQWEsRUFBRSxDQUFDO1FBQ25CLE9BQU8sUUFBUSxDQUFBO0lBQ2pCLENBQUM7SUFDRCxJQUFJLEdBQUcsQ0FBQyxRQUFRLEtBQUssTUFBTSxFQUFFLENBQUM7UUFDNUIsT0FBTyxNQUFNLENBQUE7SUFDZixDQUFDO0lBQ0QsSUFBSSxJQUFBLFlBQUksRUFBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ2QsT0FBTyxJQUFJLENBQUE7SUFDYixDQUFDO0lBQ0QsSUFBSSxVQUFVLEtBQUssUUFBUSxJQUFJLEdBQUcsQ0FBQyxrQkFBa0IsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUNuRSxPQUFPLFFBQVEsQ0FBQTtJQUNqQixDQUFDO0lBQ0QsT0FBTyxJQUFJLENBQUE7QUFDYixDQUFDO0FBRU0sTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLE1BQXlCLE9BQU8sQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUN2RSxRQUFRLENBQUMsR0FBRyxDQUFDLHNCQUFzQixDQUFDLENBQUE7QUFEekIsUUFBQSxnQkFBZ0Isb0JBQ1M7QUFFL0IsTUFBTSxhQUFhLEdBQUcsQ0FBQyxNQUF5QixPQUFPLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FDcEUsQ0FBQyxHQUFHLENBQUMsMEJBQTBCLElBQUksOEJBQXNCLENBQUMsQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFBO0FBRG5FLFFBQUEsYUFBYSxpQkFDc0Q7QUFFekUsTUFBTSxjQUFjLEdBQUcsQ0FBQyxNQUF5QixPQUFPLENBQUMsR0FBRyxFQUFFLEVBQUU7SUFDckUsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFBO0lBQzVELE9BQU8sTUFBTSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsSUFBSSxNQUFNLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLGdDQUF3QixDQUFBO0FBQ25GLENBQUMsQ0FBQTtBQUhZLFFBQUEsY0FBYyxrQkFHMUIifQ==

package/.medusa/server/src/utils/telemetry/first-party.d.ts

@@ -0,0 +1,11 @@
+export declare const isFirstPartyName: (name: string) => boolean;
+export type NameSplit = {
+    first_party: string[];
+    custom_count: number;
+};
+/**
+ * Keeps only package names Mercur or Medusa publish. Anything else is counted,
+ * never named, because a custom plugin or provider name can identify a company.
+ */
+export declare function splitFirstParty(names: Array<string | undefined | null>): NameSplit;
+export declare const providerIdLabel: (resolve: string | undefined, id: string | undefined) => string | undefined;

package/.medusa/server/src/utils/telemetry/first-party.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.providerIdLabel = exports.isFirstPartyName = void 0;
+exports.splitFirstParty = splitFirstParty;
+const FIRST_PARTY_PREFIXES = ["@mercurjs/", "@medusajs/"];
+const isFirstPartyName = (name) => FIRST_PARTY_PREFIXES.some((prefix) => name.startsWith(prefix));
+exports.isFirstPartyName = isFirstPartyName;
+/**
+ * Keeps only package names Mercur or Medusa publish. Anything else is counted,
+ * never named, because a custom plugin or provider name can identify a company.
+ */
+function splitFirstParty(names) {
+    const first_party = new Set();
+    let custom_count = 0;
+    for (const name of names) {
+        if (!name)
+            continue;
+        if ((0, exports.isFirstPartyName)(name)) {
+            first_party.add(name);
+        }
+        else {
+            custom_count += 1;
+        }
+    }
+    return { first_party: [...first_party].sort(), custom_count };
+}
+const providerIdLabel = (resolve, id) => {
+    if (!resolve || !id)
+        return undefined;
+    return (0, exports.isFirstPartyName)(resolve) ? `${resolve}#${id}` : "custom";
+};
+exports.providerIdLabel = providerIdLabel;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlyc3QtcGFydHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvdXRpbHMvdGVsZW1ldHJ5L2ZpcnN0LXBhcnR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQWNBLDBDQWNDO0FBNUJELE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxZQUFZLEVBQUUsWUFBWSxDQUFDLENBQUE7QUFFbEQsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLElBQVksRUFBRSxFQUFFLENBQy9DLG9CQUFvQixDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFBO0FBRG5ELFFBQUEsZ0JBQWdCLG9CQUNtQztBQU9oRTs7O0dBR0c7QUFDSCxTQUFnQixlQUFlLENBQUMsS0FBdUM7SUFDckUsTUFBTSxXQUFXLEdBQUcsSUFBSSxHQUFHLEVBQVUsQ0FBQTtJQUNyQyxJQUFJLFlBQVksR0FBRyxDQUFDLENBQUE7SUFFcEIsS0FBSyxNQUFNLElBQUksSUFBSSxLQUFLLEVBQUUsQ0FBQztRQUN6QixJQUFJLENBQUMsSUFBSTtZQUFFLFNBQVE7UUFDbkIsSUFBSSxJQUFBLHdCQUFnQixFQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7WUFDM0IsV0FBVyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQTtRQUN2QixDQUFDO2FBQU0sQ0FBQztZQUNOLFlBQVksSUFBSSxDQUFDLENBQUE7UUFDbkIsQ0FBQztJQUNILENBQUM7SUFFRCxPQUFPLEVBQUUsV0FBVyxFQUFFLENBQUMsR0FBRyxXQUFXLENBQUMsQ0FBQyxJQUFJLEVBQUUsRUFBRSxZQUFZLEVBQUUsQ0FBQTtBQUMvRCxDQUFDO0FBRU0sTUFBTSxlQUFlLEdBQUcsQ0FBQyxPQUEyQixFQUFFLEVBQXNCLEVBQUUsRUFBRTtJQUNyRixJQUFJLENBQUMsT0FBTyxJQUFJLENBQUMsRUFBRTtRQUFFLE9BQU8sU0FBUyxDQUFBO0lBQ3JDLE9BQU8sSUFBQSx3QkFBZ0IsRUFBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxPQUFPLElBQUksRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQTtBQUNsRSxDQUFDLENBQUE7QUFIWSxRQUFBLGVBQWUsbUJBRzNCIn0=

package/.medusa/server/src/utils/telemetry/identity.d.ts

@@ -0,0 +1,6 @@
+export declare const hashProjectKey: (input: string) => string;
+/**
+ * Stable, irreversible id for the codebase an instance was built from. Shared
+ * with the CLI so a scaffolded project can be matched to its running server.
+ */
+export declare function resolveProjectId(cwd?: string): string;

package/.medusa/server/src/utils/telemetry/identity.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashProjectKey = void 0;
+exports.resolveProjectId = resolveProjectId;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const PROJECT_ID_SALT = "mercur-telemetry-v1";
+const hashProjectKey = (input) => (0, node_crypto_1.createHash)("sha256").update(`${PROJECT_ID_SALT}:${input}`).digest("base64url");
+exports.hashProjectKey = hashProjectKey;
+const gitRemote = (cwd) => {
+    try {
+        return (0, node_child_process_1.execSync)("git config --local --get remote.origin.url", {
+            cwd,
+            stdio: "pipe",
+            timeout: 1_000,
+        })
+            .toString()
+            .trim();
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Stable, irreversible id for the codebase an instance was built from. Shared
+ * with the CLI so a scaffolded project can be matched to its running server.
+ */
+function resolveProjectId(cwd = process.cwd()) {
+    const remote = gitRemote(cwd);
+    return (0, exports.hashProjectKey)(remote || cwd);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaWRlbnRpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvdXRpbHMvdGVsZW1ldHJ5L2lkZW50aXR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQTBCQSw0Q0FHQztBQTdCRCwyREFBNkM7QUFDN0MsNkNBQXdDO0FBRXhDLE1BQU0sZUFBZSxHQUFHLHFCQUFxQixDQUFBO0FBRXRDLE1BQU0sY0FBYyxHQUFHLENBQUMsS0FBYSxFQUFFLEVBQUUsQ0FDOUMsSUFBQSx3QkFBVSxFQUFDLFFBQVEsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLGVBQWUsSUFBSSxLQUFLLEVBQUUsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxXQUFXLENBQUMsQ0FBQTtBQURuRSxRQUFBLGNBQWMsa0JBQ3FEO0FBRWhGLE1BQU0sU0FBUyxHQUFHLENBQUMsR0FBVyxFQUFFLEVBQUU7SUFDaEMsSUFBSSxDQUFDO1FBQ0gsT0FBTyxJQUFBLDZCQUFRLEVBQUMsNENBQTRDLEVBQUU7WUFDNUQsR0FBRztZQUNILEtBQUssRUFBRSxNQUFNO1lBQ2IsT0FBTyxFQUFFLEtBQUs7U0FDZixDQUFDO2FBQ0MsUUFBUSxFQUFFO2FBQ1YsSUFBSSxFQUFFLENBQUE7SUFDWCxDQUFDO0lBQUMsTUFBTSxDQUFDO1FBQ1AsT0FBTyxJQUFJLENBQUE7SUFDYixDQUFDO0FBQ0gsQ0FBQyxDQUFBO0FBRUQ7OztHQUdHO0FBQ0gsU0FBZ0IsZ0JBQWdCLENBQUMsR0FBRyxHQUFHLE9BQU8sQ0FBQyxHQUFHLEVBQUU7SUFDbEQsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLEdBQUcsQ0FBQyxDQUFBO0lBQzdCLE9BQU8sSUFBQSxzQkFBYyxFQUFDLE1BQU0sSUFBSSxHQUFHLENBQUMsQ0FBQTtBQUN0QyxDQUFDIn0=

package/.medusa/server/src/utils/telemetry/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./buckets";
+export * from "./config";
+export * from "./first-party";
+export * from "./identity";
+export * from "./milestones";
+export * from "./sender";
+export * from "./snapshot";
+export { scheduleTelemetryBoot } from "./boot";

package/.medusa/server/src/utils/telemetry/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scheduleTelemetryBoot = void 0;
+__exportStar(require("./buckets"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./first-party"), exports);
+__exportStar(require("./identity"), exports);
+__exportStar(require("./milestones"), exports);
+__exportStar(require("./sender"), exports);
+__exportStar(require("./snapshot"), exports);
+var boot_1 = require("./boot");
+Object.defineProperty(exports, "scheduleTelemetryBoot", { enumerable: true, get: function () { return boot_1.scheduleTelemetryBoot; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvdXRpbHMvdGVsZW1ldHJ5L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsNENBQXlCO0FBQ3pCLDJDQUF3QjtBQUN4QixnREFBNkI7QUFDN0IsNkNBQTBCO0FBQzFCLCtDQUE0QjtBQUM1QiwyQ0FBd0I7QUFDeEIsNkNBQTBCO0FBQzFCLCtCQUE4QztBQUFyQyw2R0FBQSxxQkFBcUIsT0FBQSJ9

package/.medusa/server/src/utils/telemetry/milestones.d.ts

@@ -0,0 +1,20 @@
+import { MedusaContainer } from "@medusajs/framework/types";
+export declare const TelemetryMilestones: {
+    readonly FIRST_PRODUCTION_BOOT: "first_production_boot";
+    readonly FIRST_SELLER: "first_seller";
+    readonly FIRST_SELLER_APPROVED: "first_seller_approved";
+    readonly FIRST_MEMBER_INVITED: "first_member_invited";
+    readonly FIRST_OFFER: "first_offer";
+    readonly FIRST_PRODUCT_PUBLISHED: "first_product_published";
+    readonly FIRST_ORDER: "first_order";
+    readonly FIRST_PAYOUT_ACCOUNT: "first_payout_account";
+    readonly FIRST_PAYOUT_PAID: "first_payout_paid";
+    readonly FIRST_COMMISSION_RULE: "first_commission_rule";
+};
+export type TelemetryMilestone = (typeof TelemetryMilestones)[keyof typeof TelemetryMilestones];
+export declare const isTelemetryConfigEnabled: (container: MedusaContainer) => boolean;
+/**
+ * Milestones are recorded from subscribers, which in a split deployment run in
+ * the worker, so the worker-process rule that gates boot events does not apply.
+ */
+export declare function recordMilestone(container: MedusaContainer, milestone: TelemetryMilestone): Promise<boolean>;

package/.medusa/server/src/utils/telemetry/milestones.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTelemetryConfigEnabled = exports.TelemetryMilestones = void 0;
+exports.recordMilestone = recordMilestone;
+const utils_1 = require("@medusajs/framework/utils");
+const types_1 = require("@mercurjs/types");
+const config_1 = require("./config");
+const sender_1 = require("./sender");
+const snapshot_1 = require("./snapshot");
+exports.TelemetryMilestones = {
+    FIRST_PRODUCTION_BOOT: "first_production_boot",
+    FIRST_SELLER: "first_seller",
+    FIRST_SELLER_APPROVED: "first_seller_approved",
+    FIRST_MEMBER_INVITED: "first_member_invited",
+    FIRST_OFFER: "first_offer",
+    FIRST_PRODUCT_PUBLISHED: "first_product_published",
+    FIRST_ORDER: "first_order",
+    FIRST_PAYOUT_ACCOUNT: "first_payout_account",
+    FIRST_PAYOUT_PAID: "first_payout_paid",
+    FIRST_COMMISSION_RULE: "first_commission_rule",
+};
+const isTelemetryConfigEnabled = (container) => {
+    const configModule = container.resolve(utils_1.ContainerRegistrationKeys.CONFIG_MODULE);
+    const mercur = configModule.projectConfig.mercur;
+    return mercur?.telemetry !== false;
+};
+exports.isTelemetryConfigEnabled = isTelemetryConfigEnabled;
+/**
+ * Milestones are recorded from subscribers, which in a split deployment run in
+ * the worker, so the worker-process rule that gates boot events does not apply.
+ */
+async function recordMilestone(container, milestone) {
+    try {
+        const reason = (0, config_1.telemetryDisabledReason)({ configEnabled: (0, exports.isTelemetryConfigEnabled)(container) });
+        if (reason && reason !== "worker") {
+            return false;
+        }
+        const service = container.resolve(types_1.MercurModules.TELEMETRY);
+        const installation = await service.getOrCreateInstallation();
+        const isNew = await service.recordMilestone(milestone);
+        if (!isNew) {
+            return false;
+        }
+        const logger = container.resolve(utils_1.ContainerRegistrationKeys.LOGGER);
+        const sender = (0, sender_1.createTelemetrySender)({ logger });
+        const base = (0, snapshot_1.collectBaseProperties)(container, installation);
+        await sender.capture([
+            {
+                event: "installation_milestone",
+                distinct_id: installation.installation_id,
+                properties: { ...base, milestone, days_since_install: base.instance_age_days },
+            },
+        ]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWlsZXN0b25lcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy91dGlscy90ZWxlbWV0cnkvbWlsZXN0b25lcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFrQ0EsMENBNkJDO0FBOURELHFEQUFxRTtBQUNyRSwyQ0FBK0M7QUFHL0MscUNBQWtEO0FBQ2xELHFDQUFnRDtBQUNoRCx5Q0FBa0Q7QUFFckMsUUFBQSxtQkFBbUIsR0FBRztJQUNqQyxxQkFBcUIsRUFBRSx1QkFBdUI7SUFDOUMsWUFBWSxFQUFFLGNBQWM7SUFDNUIscUJBQXFCLEVBQUUsdUJBQXVCO0lBQzlDLG9CQUFvQixFQUFFLHNCQUFzQjtJQUM1QyxXQUFXLEVBQUUsYUFBYTtJQUMxQix1QkFBdUIsRUFBRSx5QkFBeUI7SUFDbEQsV0FBVyxFQUFFLGFBQWE7SUFDMUIsb0JBQW9CLEVBQUUsc0JBQXNCO0lBQzVDLGlCQUFpQixFQUFFLG1CQUFtQjtJQUN0QyxxQkFBcUIsRUFBRSx1QkFBdUI7Q0FDdEMsQ0FBQTtBQUlILE1BQU0sd0JBQXdCLEdBQUcsQ0FBQyxTQUEwQixFQUFFLEVBQUU7SUFDckUsTUFBTSxZQUFZLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBZSxpQ0FBeUIsQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUM3RixNQUFNLE1BQU0sR0FBSSxZQUFZLENBQUMsYUFBc0QsQ0FBQyxNQUFNLENBQUE7SUFDMUYsT0FBTyxNQUFNLEVBQUUsU0FBUyxLQUFLLEtBQUssQ0FBQTtBQUNwQyxDQUFDLENBQUE7QUFKWSxRQUFBLHdCQUF3Qiw0QkFJcEM7QUFFRDs7O0dBR0c7QUFDSSxLQUFLLFVBQVUsZUFBZSxDQUFDLFNBQTBCLEVBQUUsU0FBNkI7SUFDN0YsSUFBSSxDQUFDO1FBQ0gsTUFBTSxNQUFNLEdBQUcsSUFBQSxnQ0FBdUIsRUFBQyxFQUFFLGFBQWEsRUFBRSxJQUFBLGdDQUF3QixFQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsQ0FBQTtRQUM5RixJQUFJLE1BQU0sSUFBSSxNQUFNLEtBQUssUUFBUSxFQUFFLENBQUM7WUFDbEMsT0FBTyxLQUFLLENBQUE7UUFDZCxDQUFDO1FBRUQsTUFBTSxPQUFPLEdBQUcsU0FBUyxDQUFDLE9BQU8sQ0FBeUIscUJBQWEsQ0FBQyxTQUFTLENBQUMsQ0FBQTtRQUNsRixNQUFNLFlBQVksR0FBRyxNQUFNLE9BQU8sQ0FBQyx1QkFBdUIsRUFBRSxDQUFBO1FBQzVELE1BQU0sS0FBSyxHQUFHLE1BQU0sT0FBTyxDQUFDLGVBQWUsQ0FBQyxTQUFTLENBQUMsQ0FBQTtRQUN0RCxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDWCxPQUFPLEtBQUssQ0FBQTtRQUNkLENBQUM7UUFFRCxNQUFNLE1BQU0sR0FBRyxTQUFTLENBQUMsT0FBTyxDQUFTLGlDQUF5QixDQUFDLE1BQU0sQ0FBQyxDQUFBO1FBQzFFLE1BQU0sTUFBTSxHQUFHLElBQUEsOEJBQXFCLEVBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFBO1FBQ2hELE1BQU0sSUFBSSxHQUFHLElBQUEsZ0NBQXFCLEVBQUMsU0FBUyxFQUFFLFlBQVksQ0FBQyxDQUFBO1FBRTNELE1BQU0sTUFBTSxDQUFDLE9BQU8sQ0FBQztZQUNuQjtnQkFDRSxLQUFLLEVBQUUsd0JBQXdCO2dCQUMvQixXQUFXLEVBQUUsWUFBWSxDQUFDLGVBQWU7Z0JBQ3pDLFVBQVUsRUFBRSxFQUFFLEdBQUcsSUFBSSxFQUFFLFNBQVMsRUFBRSxrQkFBa0IsRUFBRSxJQUFJLENBQUMsaUJBQWlCLEVBQUU7YUFDL0U7U0FDRixDQUFDLENBQUE7UUFDRixPQUFPLElBQUksQ0FBQTtJQUNiLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxPQUFPLEtBQUssQ0FBQTtJQUNkLENBQUM7QUFDSCxDQUFDIn0=

package/.medusa/server/src/utils/telemetry/sender.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from "@medusajs/framework/types";
+export type TelemetryEvent = {
+    event: string;
+    distinct_id: string;
+    properties: Record<string, unknown>;
+    timestamp?: string;
+};
+export type TelemetrySender = {
+    capture: (events: TelemetryEvent[]) => Promise<void>;
+};
+type SenderOptions = {
+    logger?: Logger;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: typeof fetch;
+};
+export declare function createTelemetrySender({ logger, env, fetchImpl, }?: SenderOptions): TelemetrySender;
+export {};

package/.medusa/server/src/utils/telemetry/sender.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTelemetrySender = createTelemetrySender;
+const config_1 = require("./config");
+/**
+ * The proxy swaps this for the real project key, so no PostHog credential
+ * ships inside the package.
+ */
+const PLACEHOLDER_API_KEY = "mercur";
+function createTelemetrySender({ logger, env = process.env, fetchImpl = fetch, } = {}) {
+    const url = `${(0, config_1.telemetryHost)(env)}/batch`;
+    const debug = (0, config_1.isTelemetryDebug)(env);
+    return {
+        async capture(events) {
+            if (!events.length)
+                return;
+            const body = {
+                api_key: PLACEHOLDER_API_KEY,
+                batch: events.map((event) => ({
+                    ...event,
+                    timestamp: event.timestamp ?? new Date().toISOString(),
+                    properties: { ...event.properties, $geoip_disable: true },
+                })),
+            };
+            if (debug) {
+                logger?.info(`[telemetry] ${JSON.stringify(body.batch, null, 2)}`);
+                return;
+            }
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), config_1.TELEMETRY_REQUEST_TIMEOUT_MS);
+            try {
+                await fetchImpl(url, {
+                    method: "POST",
+                    headers: { "content-type": "application/json" },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+            }
+            catch (error) {
+                logger?.debug(`[telemetry] send failed: ${error?.message}`);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VuZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL3V0aWxzL3RlbGVtZXRyeS9zZW5kZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUEyQkEsc0RBMENDO0FBbkVELHFDQUF3RjtBQUV4Rjs7O0dBR0c7QUFDSCxNQUFNLG1CQUFtQixHQUFHLFFBQVEsQ0FBQTtBQW1CcEMsU0FBZ0IscUJBQXFCLENBQUMsRUFDcEMsTUFBTSxFQUNOLEdBQUcsR0FBRyxPQUFPLENBQUMsR0FBRyxFQUNqQixTQUFTLEdBQUcsS0FBSyxNQUNBLEVBQUU7SUFDbkIsTUFBTSxHQUFHLEdBQUcsR0FBRyxJQUFBLHNCQUFhLEVBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQTtJQUN6QyxNQUFNLEtBQUssR0FBRyxJQUFBLHlCQUFnQixFQUFDLEdBQUcsQ0FBQyxDQUFBO0lBRW5DLE9BQU87UUFDTCxLQUFLLENBQUMsT0FBTyxDQUFDLE1BQU07WUFDbEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNO2dCQUFFLE9BQU07WUFFMUIsTUFBTSxJQUFJLEdBQUc7Z0JBQ1gsT0FBTyxFQUFFLG1CQUFtQjtnQkFDNUIsS0FBSyxFQUFFLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLENBQUM7b0JBQzVCLEdBQUcsS0FBSztvQkFDUixTQUFTLEVBQUUsS0FBSyxDQUFDLFNBQVMsSUFBSSxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRTtvQkFDdEQsVUFBVSxFQUFFLEVBQUUsR0FBRyxLQUFLLENBQUMsVUFBVSxFQUFFLGNBQWMsRUFBRSxJQUFJLEVBQUU7aUJBQzFELENBQUMsQ0FBQzthQUNKLENBQUE7WUFFRCxJQUFJLEtBQUssRUFBRSxDQUFDO2dCQUNWLE1BQU0sRUFBRSxJQUFJLENBQUMsZUFBZSxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQTtnQkFDbEUsT0FBTTtZQUNSLENBQUM7WUFFRCxNQUFNLFVBQVUsR0FBRyxJQUFJLGVBQWUsRUFBRSxDQUFBO1lBQ3hDLE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLEVBQUUscUNBQTRCLENBQUMsQ0FBQTtZQUNoRixJQUFJLENBQUM7Z0JBQ0gsTUFBTSxTQUFTLENBQUMsR0FBRyxFQUFFO29CQUNuQixNQUFNLEVBQUUsTUFBTTtvQkFDZCxPQUFPLEVBQUUsRUFBRSxjQUFjLEVBQUUsa0JBQWtCLEVBQUU7b0JBQy9DLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQztvQkFDMUIsTUFBTSxFQUFFLFVBQVUsQ0FBQyxNQUFNO2lCQUMxQixDQUFDLENBQUE7WUFDSixDQUFDO1lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztnQkFDZixNQUFNLEVBQUUsS0FBSyxDQUFDLDRCQUE2QixLQUFlLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQTtZQUN4RSxDQUFDO29CQUFTLENBQUM7Z0JBQ1QsWUFBWSxDQUFDLEtBQUssQ0FBQyxDQUFBO1lBQ3JCLENBQUM7UUFDSCxDQUFDO0tBQ0YsQ0FBQTtBQUNILENBQUMifQ==

package/.medusa/server/src/utils/telemetry/snapshot.d.ts

@@ -0,0 +1,13 @@
+import { MedusaContainer } from "@medusajs/framework/types";
+export type InstallationRecord = {
+    installation_id: string;
+    created_at: Date | string;
+};
+export declare function collectBaseProperties(container: MedusaContainer, installation: InstallationRecord, env?: NodeJS.ProcessEnv): Record<string, unknown>;
+export declare function collectStackProperties(container: MedusaContainer, env?: NodeJS.ProcessEnv): Record<string, unknown>;
+/**
+ * Counts run one at a time on purpose: a heartbeat must never compete with
+ * request traffic for the connection pool.
+ */
+export declare function collectMarketplaceProperties(container: MedusaContainer): Promise<Record<string, unknown>>;
+export declare function collectSnapshot(container: MedusaContainer, installation: InstallationRecord, uptimeSeconds: number): Promise<Record<string, unknown>>;