@spotlightjs/spotlight 4.7.2 → 4.9.0

package/dist/node_modules/.pnpm/zod@4.1.13/node_modules/zod/v4/mini/schemas.js

@@ -0,0 +1,61 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2d946abd-f197-42c9-98c6-b0224ed16edb", e._sentryDebugIdIdentifier = "sentry-dbid-2d946abd-f197-42c9-98c6-b0224ed16edb");
+  } catch (e2) {
+  }
+}();
+import { $constructor } from "../core/core.js";
+import { parse, safeParse, parseAsync, safeParseAsync } from "../core/parse.js";
+import { normalizeParams, defineLazy, clone } from "../core/util.js";
+import { $ZodObject, $ZodType } from "../core/schemas.js";
+import "../core/registries.js";
+const ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
+  if (!inst._zod)
+    throw new Error("Uninitialized schema in ZodMiniType.");
+  $ZodType.init(inst, def);
+  inst.def = def;
+  inst.type = def.type;
+  inst.parse = (data, params) => parse(inst, data, params, { callee: inst.parse });
+  inst.safeParse = (data, params) => safeParse(inst, data, params);
+  inst.parseAsync = async (data, params) => parseAsync(inst, data, params, { callee: inst.parseAsync });
+  inst.safeParseAsync = async (data, params) => safeParseAsync(inst, data, params);
+  inst.check = (...checks) => {
+    return inst.clone(
+      {
+        ...def,
+        checks: [
+          ...def.checks ?? [],
+          ...checks.map((ch) => typeof ch === "function" ? { _zod: { check: ch, def: { check: "custom" }, onattach: [] } } : ch)
+        ]
+      }
+      // { parent: true }
+    );
+  };
+  inst.clone = (_def, params) => clone(inst, _def, params);
+  inst.brand = () => inst;
+  inst.register = (reg, meta) => {
+    reg.add(inst, meta);
+    return inst;
+  };
+});
+const ZodMiniObject = /* @__PURE__ */ $constructor("ZodMiniObject", (inst, def) => {
+  $ZodObject.init(inst, def);
+  ZodMiniType.init(inst, def);
+  defineLazy(inst, "shape", () => def.shape);
+});
+function object(shape, params) {
+  const def = {
+    type: "object",
+    shape: shape ?? {},
+    ...normalizeParams(params)
+  };
+  return new ZodMiniObject(def);
+}
+export {
+  ZodMiniObject,
+  ZodMiniType,
+  object
+};
+//# sourceMappingURL=schemas.js.map

package/dist/node_modules/.pnpm/zod@4.1.13/node_modules/zod/v4/mini/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sources":["../../../../../../../../../../node_modules/.pnpm/zod@4.1.13/node_modules/zod/v4/mini/schemas.js"],"sourcesContent":["import * as core from \"../core/index.js\";\nimport { util } from \"../core/index.js\";\nimport * as parse from \"./parse.js\";\nexport const ZodMiniType = /*@__PURE__*/ core.$constructor(\"ZodMiniType\", (inst, def) => {\n    if (!inst._zod)\n        throw new Error(\"Uninitialized schema in ZodMiniType.\");\n    core.$ZodType.init(inst, def);\n    inst.def = def;\n    inst.type = def.type;\n    inst.parse = (data, params) => parse.parse(inst, data, params, { callee: inst.parse });\n    inst.safeParse = (data, params) => parse.safeParse(inst, data, params);\n    inst.parseAsync = async (data, params) => parse.parseAsync(inst, data, params, { callee: inst.parseAsync });\n    inst.safeParseAsync = async (data, params) => parse.safeParseAsync(inst, data, params);\n    inst.check = (...checks) => {\n        return inst.clone({\n            ...def,\n            checks: [\n                ...(def.checks ?? []),\n                ...checks.map((ch) => typeof ch === \"function\" ? { _zod: { check: ch, def: { check: \"custom\" }, onattach: [] } } : ch),\n            ],\n        }\n        // { parent: true }\n        );\n    };\n    inst.clone = (_def, params) => core.clone(inst, _def, params);\n    inst.brand = () => inst;\n    inst.register = ((reg, meta) => {\n        reg.add(inst, meta);\n        return inst;\n    });\n});\nexport const ZodMiniString = /*@__PURE__*/ core.$constructor(\"ZodMiniString\", (inst, def) => {\n    core.$ZodString.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function string(params) {\n    return core._string(ZodMiniString, params);\n}\nexport const ZodMiniStringFormat = /*@__PURE__*/ core.$constructor(\"ZodMiniStringFormat\", (inst, def) => {\n    core.$ZodStringFormat.init(inst, def);\n    ZodMiniString.init(inst, def);\n});\nexport const ZodMiniEmail = /*@__PURE__*/ core.$constructor(\"ZodMiniEmail\", (inst, def) => {\n    core.$ZodEmail.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function email(params) {\n    return core._email(ZodMiniEmail, params);\n}\nexport const ZodMiniGUID = /*@__PURE__*/ core.$constructor(\"ZodMiniGUID\", (inst, def) => {\n    core.$ZodGUID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function guid(params) {\n    return core._guid(ZodMiniGUID, params);\n}\nexport const ZodMiniUUID = /*@__PURE__*/ core.$constructor(\"ZodMiniUUID\", (inst, def) => {\n    core.$ZodUUID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function uuid(params) {\n    return core._uuid(ZodMiniUUID, params);\n}\nexport function uuidv4(params) {\n    return core._uuidv4(ZodMiniUUID, params);\n}\n// ZodMiniUUIDv6\nexport function uuidv6(params) {\n    return core._uuidv6(ZodMiniUUID, params);\n}\n// ZodMiniUUIDv7\nexport function uuidv7(params) {\n    return core._uuidv7(ZodMiniUUID, params);\n}\nexport const ZodMiniURL = /*@__PURE__*/ core.$constructor(\"ZodMiniURL\", (inst, def) => {\n    core.$ZodURL.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function url(params) {\n    return core._url(ZodMiniURL, params);\n}\nexport function httpUrl(params) {\n    return core._url(ZodMiniURL, {\n        protocol: /^https?$/,\n        hostname: core.regexes.domain,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniEmoji = /*@__PURE__*/ core.$constructor(\"ZodMiniEmoji\", (inst, def) => {\n    core.$ZodEmoji.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function emoji(params) {\n    return core._emoji(ZodMiniEmoji, params);\n}\nexport const ZodMiniNanoID = /*@__PURE__*/ core.$constructor(\"ZodMiniNanoID\", (inst, def) => {\n    core.$ZodNanoID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function nanoid(params) {\n    return core._nanoid(ZodMiniNanoID, params);\n}\nexport const ZodMiniCUID = /*@__PURE__*/ core.$constructor(\"ZodMiniCUID\", (inst, def) => {\n    core.$ZodCUID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function cuid(params) {\n    return core._cuid(ZodMiniCUID, params);\n}\nexport const ZodMiniCUID2 = /*@__PURE__*/ core.$constructor(\"ZodMiniCUID2\", (inst, def) => {\n    core.$ZodCUID2.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function cuid2(params) {\n    return core._cuid2(ZodMiniCUID2, params);\n}\nexport const ZodMiniULID = /*@__PURE__*/ core.$constructor(\"ZodMiniULID\", (inst, def) => {\n    core.$ZodULID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function ulid(params) {\n    return core._ulid(ZodMiniULID, params);\n}\nexport const ZodMiniXID = /*@__PURE__*/ core.$constructor(\"ZodMiniXID\", (inst, def) => {\n    core.$ZodXID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function xid(params) {\n    return core._xid(ZodMiniXID, params);\n}\nexport const ZodMiniKSUID = /*@__PURE__*/ core.$constructor(\"ZodMiniKSUID\", (inst, def) => {\n    core.$ZodKSUID.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function ksuid(params) {\n    return core._ksuid(ZodMiniKSUID, params);\n}\nexport const ZodMiniIPv4 = /*@__PURE__*/ core.$constructor(\"ZodMiniIPv4\", (inst, def) => {\n    core.$ZodIPv4.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function ipv4(params) {\n    return core._ipv4(ZodMiniIPv4, params);\n}\nexport const ZodMiniIPv6 = /*@__PURE__*/ core.$constructor(\"ZodMiniIPv6\", (inst, def) => {\n    core.$ZodIPv6.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function ipv6(params) {\n    return core._ipv6(ZodMiniIPv6, params);\n}\nexport const ZodMiniCIDRv4 = /*@__PURE__*/ core.$constructor(\"ZodMiniCIDRv4\", (inst, def) => {\n    core.$ZodCIDRv4.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function cidrv4(params) {\n    return core._cidrv4(ZodMiniCIDRv4, params);\n}\nexport const ZodMiniCIDRv6 = /*@__PURE__*/ core.$constructor(\"ZodMiniCIDRv6\", (inst, def) => {\n    core.$ZodCIDRv6.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function cidrv6(params) {\n    return core._cidrv6(ZodMiniCIDRv6, params);\n}\nexport const ZodMiniMAC = /*@__PURE__*/ core.$constructor(\"ZodMiniMAC\", (inst, def) => {\n    core.$ZodMAC.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function mac(params) {\n    return core._mac(ZodMiniMAC, params);\n}\nexport const ZodMiniBase64 = /*@__PURE__*/ core.$constructor(\"ZodMiniBase64\", (inst, def) => {\n    core.$ZodBase64.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function base64(params) {\n    return core._base64(ZodMiniBase64, params);\n}\nexport const ZodMiniBase64URL = /*@__PURE__*/ core.$constructor(\"ZodMiniBase64URL\", (inst, def) => {\n    core.$ZodBase64URL.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function base64url(params) {\n    return core._base64url(ZodMiniBase64URL, params);\n}\nexport const ZodMiniE164 = /*@__PURE__*/ core.$constructor(\"ZodMiniE164\", (inst, def) => {\n    core.$ZodE164.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function e164(params) {\n    return core._e164(ZodMiniE164, params);\n}\nexport const ZodMiniJWT = /*@__PURE__*/ core.$constructor(\"ZodMiniJWT\", (inst, def) => {\n    core.$ZodJWT.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function jwt(params) {\n    return core._jwt(ZodMiniJWT, params);\n}\nexport const ZodMiniCustomStringFormat = /*@__PURE__*/ core.$constructor(\"ZodMiniCustomStringFormat\", (inst, def) => {\n    core.$ZodCustomStringFormat.init(inst, def);\n    ZodMiniStringFormat.init(inst, def);\n});\nexport function stringFormat(format, fnOrRegex, _params = {}) {\n    return core._stringFormat(ZodMiniCustomStringFormat, format, fnOrRegex, _params);\n}\nexport function hostname(_params) {\n    return core._stringFormat(ZodMiniCustomStringFormat, \"hostname\", core.regexes.hostname, _params);\n}\nexport function hex(_params) {\n    return core._stringFormat(ZodMiniCustomStringFormat, \"hex\", core.regexes.hex, _params);\n}\nexport function hash(alg, params) {\n    const enc = params?.enc ?? \"hex\";\n    const format = `${alg}_${enc}`;\n    const regex = core.regexes[format];\n    // check for unrecognized format\n    if (!regex)\n        throw new Error(`Unrecognized hash format: ${format}`);\n    return core._stringFormat(ZodMiniCustomStringFormat, format, regex, params);\n}\nexport const ZodMiniNumber = /*@__PURE__*/ core.$constructor(\"ZodMiniNumber\", (inst, def) => {\n    core.$ZodNumber.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function number(params) {\n    return core._number(ZodMiniNumber, params);\n}\nexport const ZodMiniNumberFormat = /*@__PURE__*/ core.$constructor(\"ZodMiniNumberFormat\", (inst, def) => {\n    core.$ZodNumberFormat.init(inst, def);\n    ZodMiniNumber.init(inst, def);\n});\n// int\nexport function int(params) {\n    return core._int(ZodMiniNumberFormat, params);\n}\n// float32\nexport function float32(params) {\n    return core._float32(ZodMiniNumberFormat, params);\n}\n// float64\nexport function float64(params) {\n    return core._float64(ZodMiniNumberFormat, params);\n}\n// int32\nexport function int32(params) {\n    return core._int32(ZodMiniNumberFormat, params);\n}\n// uint32\nexport function uint32(params) {\n    return core._uint32(ZodMiniNumberFormat, params);\n}\nexport const ZodMiniBoolean = /*@__PURE__*/ core.$constructor(\"ZodMiniBoolean\", (inst, def) => {\n    core.$ZodBoolean.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function boolean(params) {\n    return core._boolean(ZodMiniBoolean, params);\n}\nexport const ZodMiniBigInt = /*@__PURE__*/ core.$constructor(\"ZodMiniBigInt\", (inst, def) => {\n    core.$ZodBigInt.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function bigint(params) {\n    return core._bigint(ZodMiniBigInt, params);\n}\nexport const ZodMiniBigIntFormat = /*@__PURE__*/ core.$constructor(\"ZodMiniBigIntFormat\", (inst, def) => {\n    core.$ZodBigIntFormat.init(inst, def);\n    ZodMiniBigInt.init(inst, def);\n});\n// int64\nexport function int64(params) {\n    return core._int64(ZodMiniBigIntFormat, params);\n}\n// uint64\nexport function uint64(params) {\n    return core._uint64(ZodMiniBigIntFormat, params);\n}\nexport const ZodMiniSymbol = /*@__PURE__*/ core.$constructor(\"ZodMiniSymbol\", (inst, def) => {\n    core.$ZodSymbol.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function symbol(params) {\n    return core._symbol(ZodMiniSymbol, params);\n}\nexport const ZodMiniUndefined = /*@__PURE__*/ core.$constructor(\"ZodMiniUndefined\", (inst, def) => {\n    core.$ZodUndefined.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nfunction _undefined(params) {\n    return core._undefined(ZodMiniUndefined, params);\n}\nexport { _undefined as undefined };\nexport const ZodMiniNull = /*@__PURE__*/ core.$constructor(\"ZodMiniNull\", (inst, def) => {\n    core.$ZodNull.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nfunction _null(params) {\n    return core._null(ZodMiniNull, params);\n}\nexport { _null as null };\nexport const ZodMiniAny = /*@__PURE__*/ core.$constructor(\"ZodMiniAny\", (inst, def) => {\n    core.$ZodAny.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function any() {\n    return core._any(ZodMiniAny);\n}\nexport const ZodMiniUnknown = /*@__PURE__*/ core.$constructor(\"ZodMiniUnknown\", (inst, def) => {\n    core.$ZodUnknown.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function unknown() {\n    return core._unknown(ZodMiniUnknown);\n}\nexport const ZodMiniNever = /*@__PURE__*/ core.$constructor(\"ZodMiniNever\", (inst, def) => {\n    core.$ZodNever.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function never(params) {\n    return core._never(ZodMiniNever, params);\n}\nexport const ZodMiniVoid = /*@__PURE__*/ core.$constructor(\"ZodMiniVoid\", (inst, def) => {\n    core.$ZodVoid.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nfunction _void(params) {\n    return core._void(ZodMiniVoid, params);\n}\nexport { _void as void };\nexport const ZodMiniDate = /*@__PURE__*/ core.$constructor(\"ZodMiniDate\", (inst, def) => {\n    core.$ZodDate.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function date(params) {\n    return core._date(ZodMiniDate, params);\n}\nexport const ZodMiniArray = /*@__PURE__*/ core.$constructor(\"ZodMiniArray\", (inst, def) => {\n    core.$ZodArray.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function array(element, params) {\n    return new ZodMiniArray({\n        type: \"array\",\n        element: element,\n        ...util.normalizeParams(params),\n    });\n}\n// .keyof\nexport function keyof(schema) {\n    const shape = schema._zod.def.shape;\n    return _enum(Object.keys(shape));\n}\nexport const ZodMiniObject = /*@__PURE__*/ core.$constructor(\"ZodMiniObject\", (inst, def) => {\n    core.$ZodObject.init(inst, def);\n    ZodMiniType.init(inst, def);\n    util.defineLazy(inst, \"shape\", () => def.shape);\n});\nexport function object(shape, params) {\n    const def = {\n        type: \"object\",\n        shape: shape ?? {},\n        ...util.normalizeParams(params),\n    };\n    return new ZodMiniObject(def);\n}\n// strictObject\nexport function strictObject(shape, params) {\n    return new ZodMiniObject({\n        type: \"object\",\n        shape,\n        catchall: never(),\n        ...util.normalizeParams(params),\n    });\n}\n// looseObject\nexport function looseObject(shape, params) {\n    return new ZodMiniObject({\n        type: \"object\",\n        shape,\n        catchall: unknown(),\n        ...util.normalizeParams(params),\n    });\n}\n// object methods\nexport function extend(schema, shape) {\n    return util.extend(schema, shape);\n}\nexport function safeExtend(schema, shape) {\n    return util.safeExtend(schema, shape);\n}\nexport function merge(schema, shape) {\n    return util.extend(schema, shape);\n}\nexport function pick(schema, mask) {\n    return util.pick(schema, mask);\n}\n// .omit\nexport function omit(schema, mask) {\n    return util.omit(schema, mask);\n}\nexport function partial(schema, mask) {\n    return util.partial(ZodMiniOptional, schema, mask);\n}\nexport function required(schema, mask) {\n    return util.required(ZodMiniNonOptional, schema, mask);\n}\nexport function catchall(inst, catchall) {\n    return inst.clone({ ...inst._zod.def, catchall: catchall });\n}\nexport const ZodMiniUnion = /*@__PURE__*/ core.$constructor(\"ZodMiniUnion\", (inst, def) => {\n    core.$ZodUnion.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function union(options, params) {\n    return new ZodMiniUnion({\n        type: \"union\",\n        options: options,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniDiscriminatedUnion = /*@__PURE__*/ core.$constructor(\"ZodMiniDiscriminatedUnion\", (inst, def) => {\n    core.$ZodDiscriminatedUnion.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function discriminatedUnion(discriminator, options, params) {\n    return new ZodMiniDiscriminatedUnion({\n        type: \"union\",\n        options,\n        discriminator,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniIntersection = /*@__PURE__*/ core.$constructor(\"ZodMiniIntersection\", (inst, def) => {\n    core.$ZodIntersection.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function intersection(left, right) {\n    return new ZodMiniIntersection({\n        type: \"intersection\",\n        left: left,\n        right: right,\n    });\n}\nexport const ZodMiniTuple = /*@__PURE__*/ core.$constructor(\"ZodMiniTuple\", (inst, def) => {\n    core.$ZodTuple.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function tuple(items, _paramsOrRest, _params) {\n    const hasRest = _paramsOrRest instanceof core.$ZodType;\n    const params = hasRest ? _params : _paramsOrRest;\n    const rest = hasRest ? _paramsOrRest : null;\n    return new ZodMiniTuple({\n        type: \"tuple\",\n        items: items,\n        rest,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniRecord = /*@__PURE__*/ core.$constructor(\"ZodMiniRecord\", (inst, def) => {\n    core.$ZodRecord.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function record(keyType, valueType, params) {\n    return new ZodMiniRecord({\n        type: \"record\",\n        keyType,\n        valueType: valueType,\n        ...util.normalizeParams(params),\n    });\n}\nexport function partialRecord(keyType, valueType, params) {\n    const k = core.clone(keyType);\n    k._zod.values = undefined;\n    return new ZodMiniRecord({\n        type: \"record\",\n        keyType: k,\n        valueType: valueType,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniMap = /*@__PURE__*/ core.$constructor(\"ZodMiniMap\", (inst, def) => {\n    core.$ZodMap.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function map(keyType, valueType, params) {\n    return new ZodMiniMap({\n        type: \"map\",\n        keyType: keyType,\n        valueType: valueType,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniSet = /*@__PURE__*/ core.$constructor(\"ZodMiniSet\", (inst, def) => {\n    core.$ZodSet.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function set(valueType, params) {\n    return new ZodMiniSet({\n        type: \"set\",\n        valueType: valueType,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniEnum = /*@__PURE__*/ core.$constructor(\"ZodMiniEnum\", (inst, def) => {\n    core.$ZodEnum.init(inst, def);\n    ZodMiniType.init(inst, def);\n    inst.options = Object.values(def.entries);\n});\nfunction _enum(values, params) {\n    const entries = Array.isArray(values) ? Object.fromEntries(values.map((v) => [v, v])) : values;\n    return new ZodMiniEnum({\n        type: \"enum\",\n        entries,\n        ...util.normalizeParams(params),\n    });\n}\nexport { _enum as enum };\n/** @deprecated This API has been merged into `z.enum()`. Use `z.enum()` instead.\n *\n * ```ts\n * enum Colors { red, green, blue }\n * z.enum(Colors);\n * ```\n */\nexport function nativeEnum(entries, params) {\n    return new ZodMiniEnum({\n        type: \"enum\",\n        entries,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniLiteral = /*@__PURE__*/ core.$constructor(\"ZodMiniLiteral\", (inst, def) => {\n    core.$ZodLiteral.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function literal(value, params) {\n    return new ZodMiniLiteral({\n        type: \"literal\",\n        values: Array.isArray(value) ? value : [value],\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniFile = /*@__PURE__*/ core.$constructor(\"ZodMiniFile\", (inst, def) => {\n    core.$ZodFile.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function file(params) {\n    return core._file(ZodMiniFile, params);\n}\nexport const ZodMiniTransform = /*@__PURE__*/ core.$constructor(\"ZodMiniTransform\", (inst, def) => {\n    core.$ZodTransform.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function transform(fn) {\n    return new ZodMiniTransform({\n        type: \"transform\",\n        transform: fn,\n    });\n}\nexport const ZodMiniOptional = /*@__PURE__*/ core.$constructor(\"ZodMiniOptional\", (inst, def) => {\n    core.$ZodOptional.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function optional(innerType) {\n    return new ZodMiniOptional({\n        type: \"optional\",\n        innerType: innerType,\n    });\n}\nexport const ZodMiniNullable = /*@__PURE__*/ core.$constructor(\"ZodMiniNullable\", (inst, def) => {\n    core.$ZodNullable.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function nullable(innerType) {\n    return new ZodMiniNullable({\n        type: \"nullable\",\n        innerType: innerType,\n    });\n}\n// nullish\nexport function nullish(innerType) {\n    return optional(nullable(innerType));\n}\nexport const ZodMiniDefault = /*@__PURE__*/ core.$constructor(\"ZodMiniDefault\", (inst, def) => {\n    core.$ZodDefault.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function _default(innerType, defaultValue) {\n    return new ZodMiniDefault({\n        type: \"default\",\n        innerType: innerType,\n        get defaultValue() {\n            return typeof defaultValue === \"function\" ? defaultValue() : util.shallowClone(defaultValue);\n        },\n    });\n}\nexport const ZodMiniPrefault = /*@__PURE__*/ core.$constructor(\"ZodMiniPrefault\", (inst, def) => {\n    core.$ZodPrefault.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function prefault(innerType, defaultValue) {\n    return new ZodMiniPrefault({\n        type: \"prefault\",\n        innerType: innerType,\n        get defaultValue() {\n            return typeof defaultValue === \"function\" ? defaultValue() : util.shallowClone(defaultValue);\n        },\n    });\n}\nexport const ZodMiniNonOptional = /*@__PURE__*/ core.$constructor(\"ZodMiniNonOptional\", (inst, def) => {\n    core.$ZodNonOptional.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function nonoptional(innerType, params) {\n    return new ZodMiniNonOptional({\n        type: \"nonoptional\",\n        innerType: innerType,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniSuccess = /*@__PURE__*/ core.$constructor(\"ZodMiniSuccess\", (inst, def) => {\n    core.$ZodSuccess.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function success(innerType) {\n    return new ZodMiniSuccess({\n        type: \"success\",\n        innerType: innerType,\n    });\n}\nexport const ZodMiniCatch = /*@__PURE__*/ core.$constructor(\"ZodMiniCatch\", (inst, def) => {\n    core.$ZodCatch.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nfunction _catch(innerType, catchValue) {\n    return new ZodMiniCatch({\n        type: \"catch\",\n        innerType: innerType,\n        catchValue: (typeof catchValue === \"function\" ? catchValue : () => catchValue),\n    });\n}\nexport { _catch as catch };\nexport const ZodMiniNaN = /*@__PURE__*/ core.$constructor(\"ZodMiniNaN\", (inst, def) => {\n    core.$ZodNaN.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function nan(params) {\n    return core._nan(ZodMiniNaN, params);\n}\nexport const ZodMiniPipe = /*@__PURE__*/ core.$constructor(\"ZodMiniPipe\", (inst, def) => {\n    core.$ZodPipe.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function pipe(in_, out) {\n    return new ZodMiniPipe({\n        type: \"pipe\",\n        in: in_,\n        out: out,\n    });\n}\nexport const ZodMiniCodec = /*@__PURE__*/ core.$constructor(\"ZodMiniCodec\", (inst, def) => {\n    ZodMiniPipe.init(inst, def);\n    core.$ZodCodec.init(inst, def);\n});\nexport function codec(in_, out, params) {\n    return new ZodMiniCodec({\n        type: \"pipe\",\n        in: in_,\n        out: out,\n        transform: params.decode,\n        reverseTransform: params.encode,\n    });\n}\nexport const ZodMiniReadonly = /*@__PURE__*/ core.$constructor(\"ZodMiniReadonly\", (inst, def) => {\n    core.$ZodReadonly.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function readonly(innerType) {\n    return new ZodMiniReadonly({\n        type: \"readonly\",\n        innerType: innerType,\n    });\n}\nexport const ZodMiniTemplateLiteral = /*@__PURE__*/ core.$constructor(\"ZodMiniTemplateLiteral\", (inst, def) => {\n    core.$ZodTemplateLiteral.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function templateLiteral(parts, params) {\n    return new ZodMiniTemplateLiteral({\n        type: \"template_literal\",\n        parts,\n        ...util.normalizeParams(params),\n    });\n}\nexport const ZodMiniLazy = /*@__PURE__*/ core.$constructor(\"ZodMiniLazy\", (inst, def) => {\n    core.$ZodLazy.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\n// export function lazy<T extends object>(getter: () => T): T {\n//   return util.createTransparentProxy<T>(getter);\n// }\nfunction _lazy(getter) {\n    return new ZodMiniLazy({\n        type: \"lazy\",\n        getter: getter,\n    });\n}\nexport { _lazy as lazy };\nexport const ZodMiniPromise = /*@__PURE__*/ core.$constructor(\"ZodMiniPromise\", (inst, def) => {\n    core.$ZodPromise.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function promise(innerType) {\n    return new ZodMiniPromise({\n        type: \"promise\",\n        innerType: innerType,\n    });\n}\nexport const ZodMiniCustom = /*@__PURE__*/ core.$constructor(\"ZodMiniCustom\", (inst, def) => {\n    core.$ZodCustom.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\n// custom checks\nexport function check(fn, params) {\n    const ch = new core.$ZodCheck({\n        check: \"custom\",\n        ...util.normalizeParams(params),\n    });\n    ch._zod.check = fn;\n    return ch;\n}\n// ZodCustom\n// custom schema\nexport function custom(fn, _params) {\n    return core._custom(ZodMiniCustom, fn ?? (() => true), _params);\n}\n// refine\nexport function refine(fn, _params = {}) {\n    return core._refine(ZodMiniCustom, fn, _params);\n}\n// superRefine\nexport function superRefine(fn) {\n    return core._superRefine(fn);\n}\n// Re-export describe and meta from core\nexport const describe = core.describe;\nexport const meta = core.meta;\n// instanceof\nclass Class {\n    constructor(..._args) { }\n}\nfunction _instanceof(cls, params = {\n    error: `Input not instance of ${cls.name}`,\n}) {\n    const inst = custom((data) => data instanceof cls, params);\n    inst._zod.bag.Class = cls;\n    return inst;\n}\nexport { _instanceof as instanceof };\n// stringbool\nexport const stringbool = (...args) => core._stringbool({\n    Codec: ZodMiniCodec,\n    Boolean: ZodMiniBoolean,\n    String: ZodMiniString,\n}, ...args);\nexport function json() {\n    const jsonSchema = _lazy(() => {\n        return union([string(), number(), boolean(), _null(), array(jsonSchema), record(string(), jsonSchema)]);\n    });\n    return jsonSchema;\n}\nexport const ZodMiniFunction = /*@__PURE__*/ core.$constructor(\"ZodMiniFunction\", (inst, def) => {\n    core.$ZodFunction.init(inst, def);\n    ZodMiniType.init(inst, def);\n});\nexport function _function(params) {\n    return new ZodMiniFunction({\n        type: \"function\",\n        input: Array.isArray(params?.input) ? tuple(params?.input) : (params?.input ?? array(unknown())),\n        output: params?.output ?? unknown(),\n    });\n}\nexport { _function as function };\n"],"names":["core.$constructor","core.$ZodType","parse.parse","parse.safeParse","parse.parseAsync","parse.safeParseAsync","core.clone","core.$ZodObject","util.defineLazy","util.normalizeParams"],"mappings":";;;;;;;;;;;;;AAGY,MAAC,cAA4BA,6BAAkB,eAAe,CAAC,MAAM,QAAQ;AACrF,MAAI,CAAC,KAAK;AACN,UAAM,IAAI,MAAM,sCAAsC;AAC1DC,WAAc,KAAK,MAAM,GAAG;AAC5B,OAAK,MAAM;AACX,OAAK,OAAO,IAAI;AAChB,OAAK,QAAQ,CAAC,MAAM,WAAWC,MAAY,MAAM,MAAM,QAAQ,EAAE,QAAQ,KAAK,MAAK,CAAE;AACrF,OAAK,YAAY,CAAC,MAAM,WAAWC,UAAgB,MAAM,MAAM,MAAM;AACrE,OAAK,aAAa,OAAO,MAAM,WAAWC,WAAiB,MAAM,MAAM,QAAQ,EAAE,QAAQ,KAAK,WAAU,CAAE;AAC1G,OAAK,iBAAiB,OAAO,MAAM,WAAWC,eAAqB,MAAM,MAAM,MAAM;AACrF,OAAK,QAAQ,IAAI,WAAW;AACxB,WAAO,KAAK;AAAA,MAAM;AAAA,QACd,GAAG;AAAA,QACH,QAAQ;AAAA,UACJ,GAAI,IAAI,UAAU;UAClB,GAAG,OAAO,IAAI,CAAC,OAAO,OAAO,OAAO,aAAa,EAAE,MAAM,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,SAAQ,GAAI,UAAU,CAAA,EAAE,EAAE,IAAK,EAAE;AAAA,QACrI;AAAA,MACA;AAAA;AAAA,IAEA;AAAA,EACI;AACA,OAAK,QAAQ,CAAC,MAAM,WAAWC,MAAW,MAAM,MAAM,MAAM;AAC5D,OAAK,QAAQ,MAAM;AACnB,OAAK,WAAY,CAAC,KAAK,SAAS;AAC5B,QAAI,IAAI,MAAM,IAAI;AAClB,WAAO;AAAA,EACX;AACJ,CAAC;AAoUW,MAAC,gBAA8BN,6BAAkB,iBAAiB,CAAC,MAAM,QAAQ;AACzFO,aAAgB,KAAK,MAAM,GAAG;AAC9B,cAAY,KAAK,MAAM,GAAG;AAC1BC,aAAgB,MAAM,SAAS,MAAM,IAAI,KAAK;AAClD,CAAC;AACM,SAAS,OAAO,OAAO,QAAQ;AAClC,QAAM,MAAM;AAAA,IACR,MAAM;AAAA,IACN,OAAO,SAAS,CAAA;AAAA,IAChB,GAAGC,gBAAqB,MAAM;AAAA,EACtC;AACI,SAAO,IAAI,cAAc,GAAG;AAChC;","x_google_ignoreList":[0]}

package/dist/run.js

@@ -3,7 +3,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "28f3503b-2bbb-4abb-824d-ba26c116f8a9", e._sentryDebugIdIdentifier = "sentry-dbid-28f3503b-2bbb-4abb-824d-ba26c116f8a9");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "50225044-9d98-4571-95c7-5a773fe8b6f3", e._sentryDebugIdIdentifier = "sentry-dbid-50225044-9d98-4571-95c7-5a773fe8b6f3");
   } catch (e2) {
   }
 }();
@@ -15,10 +15,10 @@ import { setContext, startSpan } from "@sentry/node";
 import { main } from "./server/cli.js";
 import "./instrument.js";
 import "./_virtual/_sentry-release-injection-file.js";
-const require$1 = Module.createRequire(import.meta.url);
+const require2 = Module.createRequire(import.meta.url);
 let sea = null;
 try {
-  sea = require$1("node:sea");
+  sea = require2("node:sea");
 } catch {
   sea = { isSea: () => false };
 }

package/dist/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sources":["../src/run.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport Module from \"node:module\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { setContext, startSpan } from \"@sentry/node\";\nimport { main } from \"./server/cli.ts\";\nimport \"./instrument.ts\";\n\nconst require = Module.createRequire(import.meta.url);\nlet sea: any = null;\ntry {\n  // This is to maintain compatibility with Node 20.11- as\n  // the `node:sea` module is added in Node 20.12+\n  sea = require(\"node:sea\");\n} catch {\n  sea = { isSea: () => false };\n}\n\nconst homeDir = process.env.HOME || process.env.USERPROFILE;\nsetContext(\"CLI\", {\n  sea: sea.isSea(),\n  // TODO: Be less naive with path obscuring\n  argv: homeDir ? process.argv.map(arg => arg.replace(homeDir, \"~\")) : process.argv,\n});\n\nconst withTracing = <T extends (...args: any[]) => any>(\n  fn: T,\n  spanArgs = {},\n): ((...args: Parameters<T>) => ReturnType<T>) => {\n  return (...args: Parameters<T>): ReturnType<T> =>\n    startSpan({ name: fn.name, attributes: { args }, ...spanArgs }, () => fn(...args));\n};\n\nconst readAsset = withTracing(\n  sea.isSea()\n    ? (name: string) => Buffer.from(sea.getRawAsset(name))\n    : (() => {\n        const ASSET_DIR = join(fileURLToPath(import.meta.url), \"../../dist/ui/\");\n\n        return (name: string) => readFileSync(join(ASSET_DIR, name));\n      })(),\n  { name: \"readAsset\", op: \"cli.asset.read\" },\n);\n\nstartSpan({ name: \"Spotlight CLI\", op: \"cli\" }, async () => {\n  await startSpan({ name: \"Setup Spotlight\", op: \"cli.setup\" }, async () => {\n    const MANIFEST_NAME = \"manifest.json\";\n    const ENTRY_POINT_NAME = \"index.html\";\n    const filesToServe = Object.create(null);\n\n    if (process.env.NODE_ENV === \"production\") {\n      startSpan({ name: \"Setup Server Assets\", op: \"cli.setup.assets\" }, () => {\n        // Following the guide here: https://vite.dev/guide/backend-integration.html\n        const manifest = JSON.parse(readAsset(MANIFEST_NAME).toString());\n        filesToServe[ENTRY_POINT_NAME] = readAsset(ENTRY_POINT_NAME);\n        const entries = Object.values(manifest);\n        for (const entry of entries) {\n          if (entry && typeof entry === \"object\" && \"file\" in entry && typeof entry.file === \"string\") {\n            filesToServe[entry.file] = readAsset(entry.file);\n          }\n        }\n      });\n    }\n\n    await main({\n      basePath: process.cwd(),\n      filesToServe,\n    });\n  });\n});\n"],"names":["require"],"mappings":";;;;;;;;;;;;;;;;AAQA,MAAMA,YAAU,OAAO,cAAc,YAAY,GAAG;AACpD,IAAI,MAAW;AACf,IAAI;AAGF,QAAMA,UAAQ,UAAU;AAC1B,QAAQ;AACN,QAAM,EAAE,OAAO,MAAM,MAAA;AACvB;AAEA,MAAM,UAAU,QAAQ,IAAI,QAAQ,QAAQ,IAAI;AAChD,WAAW,OAAO;AAAA,EAChB,KAAK,IAAI,MAAA;AAAA;AAAA,EAET,MAAM,UAAU,QAAQ,KAAK,IAAI,CAAA,QAAO,IAAI,QAAQ,SAAS,GAAG,CAAC,IAAI,QAAQ;AAC/E,CAAC;AAED,MAAM,cAAc,CAClB,IACA,WAAW,OACqC;AAChD,SAAO,IAAI,SACT,UAAU,EAAE,MAAM,GAAG,MAAM,YAAY,EAAE,KAAA,GAAQ,GAAG,SAAA,GAAY,MAAM,GAAG,GAAG,IAAI,CAAC;AACrF;AAEA,MAAM,YAAY;AAAA,EAChB,IAAI,MAAA,IACA,CAAC,SAAiB,OAAO,KAAK,IAAI,YAAY,IAAI,CAAC,KAClD,MAAM;AACL,UAAM,YAAY,KAAK,cAAc,YAAY,GAAG,GAAG,gBAAgB;AAEvE,WAAO,CAAC,SAAiB,aAAa,KAAK,WAAW,IAAI,CAAC;AAAA,EAC7D,GAAA;AAAA,EACJ,EAAE,MAAM,aAAa,IAAI,iBAAA;AAC3B;AAEA,UAAU,EAAE,MAAM,iBAAiB,IAAI,MAAA,GAAS,YAAY;AAC1D,QAAM,UAAU,EAAE,MAAM,mBAAmB,IAAI,YAAA,GAAe,YAAY;AACxE,UAAM,gBAAgB;AACtB,UAAM,mBAAmB;AACzB,UAAM,eAAe,uBAAO,OAAO,IAAI;AAEI;AACzC,gBAAU,EAAE,MAAM,uBAAuB,IAAI,mBAAA,GAAsB,MAAM;AAEvE,cAAM,WAAW,KAAK,MAAM,UAAU,aAAa,EAAE,UAAU;AAC/D,qBAAa,gBAAgB,IAAI,UAAU,gBAAgB;AAC3D,cAAM,UAAU,OAAO,OAAO,QAAQ;AACtC,mBAAW,SAAS,SAAS;AAC3B,cAAI,SAAS,OAAO,UAAU,YAAY,UAAU,SAAS,OAAO,MAAM,SAAS,UAAU;AAC3F,yBAAa,MAAM,IAAI,IAAI,UAAU,MAAM,IAAI;AAAA,UACjD;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,KAAK;AAAA,MACT,UAAU,QAAQ,IAAA;AAAA,MAClB;AAAA,IAAA,CACD;AAAA,EACH,CAAC;AACH,CAAC;"}
+{"version":3,"file":"run.js","sources":["../src/run.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport Module from \"node:module\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { setContext, startSpan } from \"@sentry/node\";\nimport { main } from \"./server/cli.ts\";\nimport \"./instrument.ts\";\n\nconst require = Module.createRequire(import.meta.url);\nlet sea: any = null;\ntry {\n  // This is to maintain compatibility with Node 20.11- as\n  // the `node:sea` module is added in Node 20.12+\n  sea = require(\"node:sea\");\n} catch {\n  sea = { isSea: () => false };\n}\n\nconst homeDir = process.env.HOME || process.env.USERPROFILE;\nsetContext(\"CLI\", {\n  sea: sea.isSea(),\n  // TODO: Be less naive with path obscuring\n  argv: homeDir ? process.argv.map(arg => arg.replace(homeDir, \"~\")) : process.argv,\n});\n\nconst withTracing = <T extends (...args: any[]) => any>(\n  fn: T,\n  spanArgs = {},\n): ((...args: Parameters<T>) => ReturnType<T>) => {\n  return (...args: Parameters<T>): ReturnType<T> =>\n    startSpan({ name: fn.name, attributes: { args }, ...spanArgs }, () => fn(...args));\n};\n\nconst readAsset = withTracing(\n  sea.isSea()\n    ? (name: string) => Buffer.from(sea.getRawAsset(name))\n    : (() => {\n        const ASSET_DIR = join(fileURLToPath(import.meta.url), \"../../dist/ui/\");\n\n        return (name: string) => readFileSync(join(ASSET_DIR, name));\n      })(),\n  { name: \"readAsset\", op: \"cli.asset.read\" },\n);\n\nstartSpan({ name: \"Spotlight CLI\", op: \"cli\" }, async () => {\n  await startSpan({ name: \"Setup Spotlight\", op: \"cli.setup\" }, async () => {\n    const MANIFEST_NAME = \"manifest.json\";\n    const ENTRY_POINT_NAME = \"index.html\";\n    const filesToServe = Object.create(null);\n\n    if (process.env.NODE_ENV === \"production\") {\n      startSpan({ name: \"Setup Server Assets\", op: \"cli.setup.assets\" }, () => {\n        // Following the guide here: https://vite.dev/guide/backend-integration.html\n        const manifest = JSON.parse(readAsset(MANIFEST_NAME).toString());\n        filesToServe[ENTRY_POINT_NAME] = readAsset(ENTRY_POINT_NAME);\n        const entries = Object.values(manifest);\n        for (const entry of entries) {\n          if (entry && typeof entry === \"object\" && \"file\" in entry && typeof entry.file === \"string\") {\n            filesToServe[entry.file] = readAsset(entry.file);\n          }\n        }\n      });\n    }\n\n    await main({\n      basePath: process.cwd(),\n      filesToServe,\n    });\n  });\n});\n"],"names":["require"],"mappings":";;;;;;;;;;;;;;;;AAQA,MAAMA,WAAU,OAAO,cAAc,YAAY,GAAG;AACpD,IAAI,MAAW;AACf,IAAI;AAGF,QAAMA,SAAQ,UAAU;AAC1B,QAAQ;AACN,QAAM,EAAE,OAAO,MAAM,MAAA;AACvB;AAEA,MAAM,UAAU,QAAQ,IAAI,QAAQ,QAAQ,IAAI;AAChD,WAAW,OAAO;AAAA,EAChB,KAAK,IAAI,MAAA;AAAA;AAAA,EAET,MAAM,UAAU,QAAQ,KAAK,IAAI,CAAA,QAAO,IAAI,QAAQ,SAAS,GAAG,CAAC,IAAI,QAAQ;AAC/E,CAAC;AAED,MAAM,cAAc,CAClB,IACA,WAAW,OACqC;AAChD,SAAO,IAAI,SACT,UAAU,EAAE,MAAM,GAAG,MAAM,YAAY,EAAE,KAAA,GAAQ,GAAG,SAAA,GAAY,MAAM,GAAG,GAAG,IAAI,CAAC;AACrF;AAEA,MAAM,YAAY;AAAA,EAChB,IAAI,MAAA,IACA,CAAC,SAAiB,OAAO,KAAK,IAAI,YAAY,IAAI,CAAC,KAClD,MAAM;AACL,UAAM,YAAY,KAAK,cAAc,YAAY,GAAG,GAAG,gBAAgB;AAEvE,WAAO,CAAC,SAAiB,aAAa,KAAK,WAAW,IAAI,CAAC;AAAA,EAC7D,GAAA;AAAA,EACJ,EAAE,MAAM,aAAa,IAAI,iBAAA;AAC3B;AAEA,UAAU,EAAE,MAAM,iBAAiB,IAAI,MAAA,GAAS,YAAY;AAC1D,QAAM,UAAU,EAAE,MAAM,mBAAmB,IAAI,YAAA,GAAe,YAAY;AACxE,UAAM,gBAAgB;AACtB,UAAM,mBAAmB;AACzB,UAAM,eAAe,uBAAO,OAAO,IAAI;AAEI;AACzC,gBAAU,EAAE,MAAM,uBAAuB,IAAI,mBAAA,GAAsB,MAAM;AAEvE,cAAM,WAAW,KAAK,MAAM,UAAU,aAAa,EAAE,UAAU;AAC/D,qBAAa,gBAAgB,IAAI,UAAU,gBAAgB;AAC3D,cAAM,UAAU,OAAO,OAAO,QAAQ;AACtC,mBAAW,SAAS,SAAS;AAC3B,cAAI,SAAS,OAAO,UAAU,YAAY,UAAU,SAAS,OAAO,MAAM,SAAS,UAAU;AAC3F,yBAAa,MAAM,IAAI,IAAI,UAAU,MAAM,IAAI;AAAA,UACjD;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,KAAK;AAAA,MACT,UAAU,QAAQ,IAAA;AAAA,MAClB;AAAA,IAAA,CACD;AAAA,EACH,CAAC;AACH,CAAC;"}

package/dist/sentry-config.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "6bfc3023-ae15-42d9-ac6b-bc60ecdc1334", e._sentryDebugIdIdentifier = "sentry-dbid-6bfc3023-ae15-42d9-ac6b-bc60ecdc1334");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e3629ce1-8dd0-44cf-b2aa-738f940e100e", e._sentryDebugIdIdentifier = "sentry-dbid-e3629ce1-8dd0-44cf-b2aa-738f940e100e");
   } catch (e2) {
   }
 }();
@@ -11,7 +11,7 @@ const isCI = process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
 const sentryBaseConfig = {
   enabled: Boolean("production") && true,
   environment: isCI ? "github-ci" : "production",
-  release: `spotlight@${"4.7.2"}`,
+  release: `spotlight@${"4.9.0"}`,
   tracesSampleRate: 1,
   enableLogs: true
 };

package/dist/server/cli/help.d.ts

@@ -1 +1,2 @@
-export default function showHelp(): void;
+import { CLIHandlerOptions } from '../types/cli.ts';
+export default function showHelp({ cmdArgs }: CLIHandlerOptions): void;

package/dist/server/cli/help.js

@@ -2,28 +2,48 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e9690808-fca0-4d98-bfa6-5a55512c8693", e._sentryDebugIdIdentifier = "sentry-dbid-e9690808-fca0-4d98-bfa6-5a55512c8693");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d8378fd8-7267-4573-9c94-cf79105656bb", e._sentryDebugIdIdentifier = "sentry-dbid-d8378fd8-7267-4573-9c94-cf79105656bb");
   } catch (e2) {
   }
 }();
-import { EVERYTHING_MAGIC_WORDS, NAME_TO_TYPE_MAPPING } from "./tail.js";
+import { COMMANDS } from "../cli.js";
 import { AVAILABLE_FORMATTERS } from "../formatters/types.js";
 import "../../_virtual/_sentry-release-injection-file.js";
-function showHelp() {
+function showCommandHelp(commandName) {
+  const command = COMMANDS.find((c) => c.meta.name === commandName);
+  if (!command) {
+    return false;
+  }
+  const { meta } = command;
+  console.log(`
+${meta.name} - ${meta.short}
+
+Usage: ${meta.usage || `spotlight ${meta.name} [options]`}
+${meta.long ? `
+${meta.long}` : ""}
+${meta.examples && meta.examples.length > 0 ? `
+Examples:
+${meta.examples.map((ex) => `  ${ex}`).join("\n")}` : ""}
+`);
+  return true;
+}
+function showMainHelp() {
+  const commandsHelp = COMMANDS.map(({ meta }) => {
+    const name = meta.name.padEnd(20);
+    return `  ${name} ${meta.short}`;
+  }).join("\n");
   console.log(`
 Spotlight Sidecar - Development proxy server for Spotlight
 
 Usage: spotlight [command] [options]
 
 Commands:
-  tail [types...]      Tail Sentry events (default: everything)
-                       Available types: ${[...Object.keys(NAME_TO_TYPE_MAPPING)].join(", ")}
-                       Magic words: ${[...EVERYTHING_MAGIC_WORDS].join(", ")}
-  mcp                  Start in MCP (Model Context Protocol) mode
+${commandsHelp}
   help                 Show this help message
 
 Options:
   -p, --port <port>      Port to listen on (default: 8969, or 0 for random)
+  -o, --open             Open the Spotlight dashboard in your default browser
   -d, --debug            Enable debug logging
   -f, --format <format>  Output format for tail command (default: human)
                          Available formats: ${[...AVAILABLE_FORMATTERS].join(", ")}
@@ -36,17 +56,22 @@ Options:
   -h, --help             Show this help message
 
 Examples:
-  spotlight                          # Start on default port 8969
-  spotlight tail                     # Tail all event types (human format)
-  spotlight tail errors              # Tail only errors
-  spotlight tail errors logs         # Tail errors and logs
-  spotlight tail --format json       # Explicitly use json format
-  spotlight mcp                      # Start in MCP mode
-  spotlight --port 3000              # Start on port 3000
-  spotlight -p 3000 -d               # Start on port 3000 with debug logging
-  spotlight -A myapp.local           # Allow requests from myapp.local
-  spotlight -A https://tunnel.ngrok.io -A dev.local  # Multiple origins
+${COMMANDS.flatMap(({ meta }) => meta.examples?.slice(0, 2) || []).map((ex) => `  ${ex}`).join("\n")}
+
+Run 'spotlight help <command>' for more information on a specific command.
 `);
+}
+function showHelp({ cmdArgs }) {
+  const targetCmd = cmdArgs?.[0];
+  if (targetCmd) {
+    if (!showCommandHelp(targetCmd)) {
+      console.error(`Unknown command: ${targetCmd}`);
+      console.error(`Run 'spotlight help' to see available commands.`);
+      process.exit(1);
+    }
+  } else {
+    showMainHelp();
+  }
   process.exit(0);
 }
 export {

package/dist/server/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sources":["../../../src/server/cli/help.ts"],"sourcesContent":["import { EVERYTHING_MAGIC_WORDS, NAME_TO_TYPE_MAPPING } from \"../cli/tail.ts\";\nimport { AVAILABLE_FORMATTERS } from \"../formatters/types.ts\";\n\nexport default function showHelp() {\n  console.log(`\nSpotlight Sidecar - Development proxy server for Spotlight\n\nUsage: spotlight [command] [options]\n\nCommands:\n  tail [types...]      Tail Sentry events (default: everything)\n                       Available types: ${[...Object.keys(NAME_TO_TYPE_MAPPING)].join(\", \")}\n                       Magic words: ${[...EVERYTHING_MAGIC_WORDS].join(\", \")}\n  mcp                  Start in MCP (Model Context Protocol) mode\n  help                 Show this help message\n\nOptions:\n  -p, --port <port>      Port to listen on (default: 8969, or 0 for random)\n  -d, --debug            Enable debug logging\n  -f, --format <format>  Output format for tail command (default: human)\n                         Available formats: ${[...AVAILABLE_FORMATTERS].join(\", \")}\n  -A, --allowed-origin <origin>\n                         Additional origins to allow for CORS requests.\n                         Can be specified multiple times or comma-separated.\n                         Accepts full origins (https://example.com:443) for\n                         strict matching or plain domains (myapp.local) to\n                         allow any protocol/port.\n  -h, --help             Show this help message\n\nExamples:\n  spotlight                          # Start on default port 8969\n  spotlight tail                     # Tail all event types (human format)\n  spotlight tail errors              # Tail only errors\n  spotlight tail errors logs         # Tail errors and logs\n  spotlight tail --format json       # Explicitly use json format\n  spotlight mcp                      # Start in MCP mode\n  spotlight --port 3000              # Start on port 3000\n  spotlight -p 3000 -d               # Start on port 3000 with debug logging\n  spotlight -A myapp.local           # Allow requests from myapp.local\n  spotlight -A https://tunnel.ngrok.io -A dev.local  # Multiple origins\n`);\n  process.exit(0);\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAGA,SAAwB,WAAW;AACjC,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0CAO4B,CAAC,GAAG,OAAO,KAAK,oBAAoB,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA,sCACrD,CAAC,GAAG,sBAAsB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CAQ9B,CAAC,GAAG,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAoBjF;AACC,UAAQ,KAAK,CAAC;AAChB;"}
+{"version":3,"file":"help.js","sources":["../../../src/server/cli/help.ts"],"sourcesContent":["import { COMMANDS } from \"../cli.ts\";\nimport { AVAILABLE_FORMATTERS } from \"../formatters/types.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\n\nfunction showCommandHelp(commandName: string): boolean {\n  const command = COMMANDS.find(c => c.meta.name === commandName);\n  if (!command) {\n    return false;\n  }\n\n  const { meta } = command;\n  console.log(`\n${meta.name} - ${meta.short}\n\nUsage: ${meta.usage || `spotlight ${meta.name} [options]`}\n${meta.long ? `\\n${meta.long}` : \"\"}\n${\n  meta.examples && meta.examples.length > 0\n    ? `\nExamples:\n${meta.examples.map(ex => `  ${ex}`).join(\"\\n\")}`\n    : \"\"\n}\n`);\n  return true;\n}\n\nfunction showMainHelp() {\n  // Build commands section dynamically from COMMANDS\n  const commandsHelp = COMMANDS.map(({ meta }) => {\n    const name = meta.name.padEnd(20);\n    return `  ${name} ${meta.short}`;\n  }).join(\"\\n\");\n\n  console.log(`\nSpotlight Sidecar - Development proxy server for Spotlight\n\nUsage: spotlight [command] [options]\n\nCommands:\n${commandsHelp}\n  help                 Show this help message\n\nOptions:\n  -p, --port <port>      Port to listen on (default: 8969, or 0 for random)\n  -o, --open             Open the Spotlight dashboard in your default browser\n  -d, --debug            Enable debug logging\n  -f, --format <format>  Output format for tail command (default: human)\n                         Available formats: ${[...AVAILABLE_FORMATTERS].join(\", \")}\n  -A, --allowed-origin <origin>\n                         Additional origins to allow for CORS requests.\n                         Can be specified multiple times or comma-separated.\n                         Accepts full origins (https://example.com:443) for\n                         strict matching or plain domains (myapp.local) to\n                         allow any protocol/port.\n  -h, --help             Show this help message\n\nExamples:\n${COMMANDS.flatMap(({ meta }) => meta.examples?.slice(0, 2) || [])\n  .map(ex => `  ${ex}`)\n  .join(\"\\n\")}\n\nRun 'spotlight help <command>' for more information on a specific command.\n`);\n}\n\nexport default function showHelp({ cmdArgs }: CLIHandlerOptions) {\n  const targetCmd = cmdArgs?.[0];\n\n  if (targetCmd) {\n    // Show detailed help for specific command\n    if (!showCommandHelp(targetCmd)) {\n      console.error(`Unknown command: ${targetCmd}`);\n      console.error(`Run 'spotlight help' to see available commands.`);\n      process.exit(1);\n    }\n  } else {\n    // Show main help\n    showMainHelp();\n  }\n\n  process.exit(0);\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAIA,SAAS,gBAAgB,aAA8B;AACrD,QAAM,UAAU,SAAS,KAAK,OAAK,EAAE,KAAK,SAAS,WAAW;AAC9D,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,SAAS;AACjB,UAAQ,IAAI;AAAA,EACZ,KAAK,IAAI,MAAM,KAAK,KAAK;AAAA;AAAA,SAElB,KAAK,SAAS,aAAa,KAAK,IAAI,YAAY;AAAA,EACvD,KAAK,OAAO;AAAA,EAAK,KAAK,IAAI,KAAK,EAAE;AAAA,EAEjC,KAAK,YAAY,KAAK,SAAS,SAAS,IACpC;AAAA;AAAA,EAEJ,KAAK,SAAS,IAAI,CAAA,OAAM,KAAK,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC,KACzC,EACN;AAAA,CACC;AACC,SAAO;AACT;AAEA,SAAS,eAAe;AAEtB,QAAM,eAAe,SAAS,IAAI,CAAC,EAAE,WAAW;AAC9C,UAAM,OAAO,KAAK,KAAK,OAAO,EAAE;AAChC,WAAO,KAAK,IAAI,IAAI,KAAK,KAAK;AAAA,EAChC,CAAC,EAAE,KAAK,IAAI;AAEZ,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMZ,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CAQgC,CAAC,GAAG,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUhF,SAAS,QAAQ,CAAC,EAAE,WAAW,KAAK,UAAU,MAAM,GAAG,CAAC,KAAK,CAAA,CAAE,EAC9D,IAAI,CAAA,OAAM,KAAK,EAAE,EAAE,EACnB,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA,CAGZ;AACD;AAEA,SAAwB,SAAS,EAAE,WAA8B;AAC/D,QAAM,YAAY,UAAU,CAAC;AAE7B,MAAI,WAAW;AAEb,QAAI,CAAC,gBAAgB,SAAS,GAAG;AAC/B,cAAQ,MAAM,oBAAoB,SAAS,EAAE;AAC7C,cAAQ,MAAM,iDAAiD;AAC/D,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,OAAO;AAEL,iBAAA;AAAA,EACF;AAEA,UAAQ,KAAK,CAAC;AAChB;"}

package/dist/server/cli/mcp.d.ts

@@ -1,2 +1,8 @@
-import { CLIHandlerOptions } from '../types/cli.ts';
-export default function mcp({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
+export declare const meta: CommandMeta;
+export declare function handler({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/mcp.js

@@ -2,12 +2,12 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "76ae9be3-3fab-4851-89d6-2ad159f12870", e._sentryDebugIdIdentifier = "sentry-dbid-76ae9be3-3fab-4851-89d6-2ad159f12870");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f8d2431f-3fab-49ff-a5e2-8a9059a5187e", e._sentryDebugIdIdentifier = "sentry-dbid-f8d2431f-3fab-49ff-a5e2-8a9059a5187e");
   } catch (e2) {
   }
 }();
-import { Client } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.16.0/node_modules/@modelcontextprotocol/sdk/dist/esm/client/index.js";
-import { StdioServerTransport } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.16.0/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js";
+import { Client } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.24.3_zod@4.1.13/node_modules/@modelcontextprotocol/sdk/dist/esm/client/index.js";
+import { StdioServerTransport } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.24.3_zod@4.1.13/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js";
 import { captureException } from "@sentry/node";
 import { startStdioServer, ServerType } from "mcp-proxy";
 import { logger } from "../logger.js";
@@ -16,6 +16,27 @@ import { createMCPInstance } from "../mcp/mcp.js";
 import { normalizeAllowedOrigins } from "../utils/cors.js";
 import { isSidecarRunning } from "../utils/extras.js";
 import "../../_virtual/_sentry-release-injection-file.js";
+const meta = {
+  name: "mcp",
+  short: "Start in MCP (Model Context Protocol) mode",
+  usage: "spotlight mcp [options]",
+  long: `Start Spotlight in MCP (Model Context Protocol) stdio server mode for
+integration with AI coding assistants like Cursor, Claude, etc.
+
+Connects to existing sidecar if running, otherwise starts a new one.
+Provides MCP tools for AI assistants to query errors, logs, and traces.
+
+Available MCP Tools:
+  - search_errors: Search for errors
+  - search_logs: Search for logs
+  - search_traces: List traces
+  - get_traces: Get trace details`,
+  examples: [
+    "spotlight mcp                      # Start MCP server on default port",
+    "spotlight mcp -p 3000              # Start on custom port",
+    "spotlight mcp -d                   # Start with debug logging"
+  ]
+};
 async function startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins) {
   const serverInstance = await startServer({
     port,
@@ -101,7 +122,7 @@ async function startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAl
     }
   };
 }
-async function mcp({ port, basePath, filesToServe, allowedOrigins }) {
+async function handler({ port, basePath, filesToServe, allowedOrigins }) {
   const normalizedAllowedOrigins = allowedOrigins ? normalizeAllowedOrigins(allowedOrigins) : void 0;
   if (port > 0 && await isSidecarRunning(port)) {
     logger.info("Connecting to existing MCP instance with stdio proxy...");
@@ -111,7 +132,10 @@ async function mcp({ port, basePath, filesToServe, allowedOrigins }) {
     return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);
   }
 }
+const mcp = { meta, handler };
 export {
-  mcp as default
+  mcp as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=mcp.js.map

package/dist/server/cli/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sources":["../../../src/server/cli/mcp.ts"],"sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { captureException } from \"@sentry/node\";\nimport { ServerType as ProxyServerType, startStdioServer } from \"mcp-proxy\";\nimport { logger } from \"../logger.ts\";\nimport { setShutdownHandlers, startServer } from \"../main.ts\";\nimport { createMCPInstance } from \"../mcp/mcp.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport type { NormalizedAllowedOrigins } from \"../utils/cors.ts\";\nimport { normalizeAllowedOrigins } from \"../utils/cors.ts\";\nimport { isSidecarRunning } from \"../utils/extras.ts\";\n\nasync function startServerWithStdioMCP(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  const serverInstance = await startServer({\n    port,\n    basePath,\n    filesToServe,\n    normalizedAllowedOrigins,\n  });\n  setShutdownHandlers(serverInstance);\n\n  logger.info(\"Starting MCP over stdio too...\");\n  const mcpInstance = createMCPInstance();\n  await mcpInstance.connect(new StdioServerTransport());\n\n  const shutdownMcp = () => {\n    mcpInstance.close();\n  };\n\n  process.on(\"SIGINT\", shutdownMcp);\n  process.on(\"SIGTERM\", shutdownMcp);\n\n  return serverInstance;\n}\n\nasync function startMCPStdioHTTPProxy(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  let intentionalShutdown = false;\n  let client: Client | null = null;\n  let server: Awaited<ReturnType<typeof startStdioServer>> | null = null;\n\n  const shutdown = async () => {\n    if (intentionalShutdown) {\n      // If we get the signal again, exit immediately\n      logger.info(\"Bye.\");\n      process.exit(0);\n    }\n\n    intentionalShutdown = true;\n    logger.info(\"Shutting down MCP stdio proxy...\");\n\n    if (client) {\n      await client.close();\n    }\n    if (server) {\n      await server.close();\n    }\n  };\n\n  // Set up signal handlers for graceful shutdown\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  server = await startStdioServer({\n    // We need to hook into `initStreamClient` as the returned object from startStdioServer\n    // is not a meta proxy object giving access to both the server and the client. It just\n    // returns the StdioServerTransport instance without a way to access the client or its errors.\n    // TODO: We should probably upstream a fix for this to close the server or bubble the errors\n    initStreamClient: () => {\n      client = new Client({\n        name: \"Spotlight Sidecar (stdio proxy)\",\n        version: \"1.0.0\",\n      });\n      client.onerror = async (err: Error) => {\n        if (\n          err.message.startsWith(\"Maximum reconnection attempts\") ||\n          /disconnected|fetch failed|connection closed/i.test(err.message)\n        ) {\n          if (client) await client.close();\n          if (server) await server.close();\n        } else if (!/conflict/i.test(err.message)) {\n          captureException(err);\n          logger.error(`MCP stdio proxy error: ${err.name}: ${err.message}`);\n        }\n      };\n      return Promise.resolve(client);\n    },\n    serverType: ProxyServerType.HTTPStream,\n    url: `http://localhost:${port}/mcp`,\n  });\n  server.onclose = async () => {\n    // If this is an intentional shutdown, don't restart\n    if (intentionalShutdown) {\n      logger.info(\"MCP stdio proxy server closed.\");\n      return;\n    }\n\n    logger.info(\"MCP stdio proxy server closed unexpectedly. Attempting to restart...\");\n    process.off(\"SIGINT\", shutdown);\n    process.off(\"SIGTERM\", shutdown);\n    // We need to manually resume stdin as `StdioServerTransport` pauses it on\n    // close but does not `resume` it when a new instance is created. Probably\n    // a bug in https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/stdio.ts\n    process.stdin.resume();\n\n    try {\n      await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      logger.info(\"Connection restored\");\n    } catch (_err) {\n      try {\n        return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n      } catch (_err2) {\n        logger.error(\"Failed to restart sidecar server after MCP stdio proxy closed.\");\n        captureException(_err2);\n        await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      }\n    }\n  };\n}\n\nexport default async function mcp({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions) {\n  // Normalize allowed origins once at startup\n  const normalizedAllowedOrigins = allowedOrigins ? normalizeAllowedOrigins(allowedOrigins) : undefined;\n\n  if (port > 0 && (await isSidecarRunning(port))) {\n    logger.info(\"Connecting to existing MCP instance with stdio proxy...\");\n    await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n    logger.info(`Connected to existing MCP instance on port ${port}`);\n  } else {\n    return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n  }\n}\n"],"names":["ProxyServerType"],"mappings":";;;;;;;;;;;;;;;;;;AAYA,eAAe,wBACb,MACA,UACA,cACA,0BACA;AACA,QAAM,iBAAiB,MAAM,YAAY;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AACD,sBAAoB,cAAc;AAElC,SAAO,KAAK,gCAAgC;AAC5C,QAAM,cAAc,kBAAA;AACpB,QAAM,YAAY,QAAQ,IAAI,sBAAsB;AAEpD,QAAM,cAAc,MAAM;AACxB,gBAAY,MAAA;AAAA,EACd;AAEA,UAAQ,GAAG,UAAU,WAAW;AAChC,UAAQ,GAAG,WAAW,WAAW;AAEjC,SAAO;AACT;AAEA,eAAe,uBACb,MACA,UACA,cACA,0BACA;AACA,MAAI,sBAAsB;AAC1B,MAAI,SAAwB;AAC5B,MAAI,SAA8D;AAElE,QAAM,WAAW,YAAY;AAC3B,QAAI,qBAAqB;AAEvB,aAAO,KAAK,MAAM;AAClB,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,0BAAsB;AACtB,WAAO,KAAK,kCAAkC;AAE9C,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AACA,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AAAA,EACF;AAGA,UAAQ,GAAG,UAAU,QAAQ;AAC7B,UAAQ,GAAG,WAAW,QAAQ;AAE9B,WAAS,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA,IAK9B,kBAAkB,MAAM;AACtB,eAAS,IAAI,OAAO;AAAA,QAClB,MAAM;AAAA,QACN,SAAS;AAAA,MAAA,CACV;AACD,aAAO,UAAU,OAAO,QAAe;AACrC,YACE,IAAI,QAAQ,WAAW,+BAA+B,KACtD,+CAA+C,KAAK,IAAI,OAAO,GAC/D;AACA,cAAI,OAAQ,OAAM,OAAO,MAAA;AACzB,cAAI,OAAQ,OAAM,OAAO,MAAA;AAAA,QAC3B,WAAW,CAAC,YAAY,KAAK,IAAI,OAAO,GAAG;AACzC,2BAAiB,GAAG;AACpB,iBAAO,MAAM,0BAA0B,IAAI,IAAI,KAAK,IAAI,OAAO,EAAE;AAAA,QACnE;AAAA,MACF;AACA,aAAO,QAAQ,QAAQ,MAAM;AAAA,IAC/B;AAAA,IACA,YAAYA,WAAgB;AAAA,IAC5B,KAAK,oBAAoB,IAAI;AAAA,EAAA,CAC9B;AACD,SAAO,UAAU,YAAY;AAE3B,QAAI,qBAAqB;AACvB,aAAO,KAAK,gCAAgC;AAC5C;AAAA,IACF;AAEA,WAAO,KAAK,sEAAsE;AAClF,YAAQ,IAAI,UAAU,QAAQ;AAC9B,YAAQ,IAAI,WAAW,QAAQ;AAI/B,YAAQ,MAAM,OAAA;AAEd,QAAI;AACF,YAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AACnF,aAAO,KAAK,qBAAqB;AAAA,IACnC,SAAS,MAAM;AACb,UAAI;AACF,eAAO,MAAM,wBAAwB,MAAM,UAAU,cAAc,wBAAwB;AAAA,MAC7F,SAAS,OAAO;AACd,eAAO,MAAM,gEAAgE;AAC7E,yBAAiB,KAAK;AACtB,cAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AAAA,MACrF;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAA8B,IAAI,EAAE,MAAM,UAAU,cAAc,kBAAqC;AAErG,QAAM,2BAA2B,iBAAiB,wBAAwB,cAAc,IAAI;AAE5F,MAAI,OAAO,KAAM,MAAM,iBAAiB,IAAI,GAAI;AAC9C,WAAO,KAAK,yDAAyD;AACrE,UAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AACnF,WAAO,KAAK,8CAA8C,IAAI,EAAE;AAAA,EAClE,OAAO;AACL,WAAO,MAAM,wBAAwB,MAAM,UAAU,cAAc,wBAAwB;AAAA,EAC7F;AACF;"}
+{"version":3,"file":"mcp.js","sources":["../../../src/server/cli/mcp.ts"],"sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { captureException } from \"@sentry/node\";\nimport { ServerType as ProxyServerType, startStdioServer } from \"mcp-proxy\";\nimport { logger } from \"../logger.ts\";\nimport { setShutdownHandlers, startServer } from \"../main.ts\";\nimport { createMCPInstance } from \"../mcp/mcp.ts\";\nimport type { CLIHandlerOptions, Command, CommandMeta } from \"../types/cli.ts\";\nimport type { NormalizedAllowedOrigins } from \"../utils/cors.ts\";\nimport { normalizeAllowedOrigins } from \"../utils/cors.ts\";\nimport { isSidecarRunning } from \"../utils/extras.ts\";\n\nexport const meta: CommandMeta = {\n  name: \"mcp\",\n  short: \"Start in MCP (Model Context Protocol) mode\",\n  usage: \"spotlight mcp [options]\",\n  long: `Start Spotlight in MCP (Model Context Protocol) stdio server mode for\nintegration with AI coding assistants like Cursor, Claude, etc.\n\nConnects to existing sidecar if running, otherwise starts a new one.\nProvides MCP tools for AI assistants to query errors, logs, and traces.\n\nAvailable MCP Tools:\n  - search_errors: Search for errors\n  - search_logs: Search for logs\n  - search_traces: List traces\n  - get_traces: Get trace details`,\n  examples: [\n    \"spotlight mcp                      # Start MCP server on default port\",\n    \"spotlight mcp -p 3000              # Start on custom port\",\n    \"spotlight mcp -d                   # Start with debug logging\",\n  ],\n};\n\nasync function startServerWithStdioMCP(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  const serverInstance = await startServer({\n    port,\n    basePath,\n    filesToServe,\n    normalizedAllowedOrigins,\n  });\n  setShutdownHandlers(serverInstance);\n\n  logger.info(\"Starting MCP over stdio too...\");\n  const mcpInstance = createMCPInstance();\n  await mcpInstance.connect(new StdioServerTransport());\n\n  const shutdownMcp = () => {\n    mcpInstance.close();\n  };\n\n  process.on(\"SIGINT\", shutdownMcp);\n  process.on(\"SIGTERM\", shutdownMcp);\n\n  return serverInstance;\n}\n\nasync function startMCPStdioHTTPProxy(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n  normalizedAllowedOrigins: NormalizedAllowedOrigins | undefined,\n) {\n  let intentionalShutdown = false;\n  let client: Client | null = null;\n  let server: Awaited<ReturnType<typeof startStdioServer>> | null = null;\n\n  const shutdown = async () => {\n    if (intentionalShutdown) {\n      // If we get the signal again, exit immediately\n      logger.info(\"Bye.\");\n      process.exit(0);\n    }\n\n    intentionalShutdown = true;\n    logger.info(\"Shutting down MCP stdio proxy...\");\n\n    if (client) {\n      await client.close();\n    }\n    if (server) {\n      await server.close();\n    }\n  };\n\n  // Set up signal handlers for graceful shutdown\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  server = await startStdioServer({\n    // We need to hook into `initStreamClient` as the returned object from startStdioServer\n    // is not a meta proxy object giving access to both the server and the client. It just\n    // returns the StdioServerTransport instance without a way to access the client or its errors.\n    // TODO: We should probably upstream a fix for this to close the server or bubble the errors\n    initStreamClient: () => {\n      client = new Client({\n        name: \"Spotlight Sidecar (stdio proxy)\",\n        version: \"1.0.0\",\n      });\n      client.onerror = async (err: Error) => {\n        if (\n          err.message.startsWith(\"Maximum reconnection attempts\") ||\n          /disconnected|fetch failed|connection closed/i.test(err.message)\n        ) {\n          if (client) await client.close();\n          if (server) await server.close();\n        } else if (!/conflict/i.test(err.message)) {\n          captureException(err);\n          logger.error(`MCP stdio proxy error: ${err.name}: ${err.message}`);\n        }\n      };\n      return Promise.resolve(client);\n    },\n    serverType: ProxyServerType.HTTPStream,\n    url: `http://localhost:${port}/mcp`,\n  });\n  server.onclose = async () => {\n    // If this is an intentional shutdown, don't restart\n    if (intentionalShutdown) {\n      logger.info(\"MCP stdio proxy server closed.\");\n      return;\n    }\n\n    logger.info(\"MCP stdio proxy server closed unexpectedly. Attempting to restart...\");\n    process.off(\"SIGINT\", shutdown);\n    process.off(\"SIGTERM\", shutdown);\n    // We need to manually resume stdin as `StdioServerTransport` pauses it on\n    // close but does not `resume` it when a new instance is created. Probably\n    // a bug in https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/stdio.ts\n    process.stdin.resume();\n\n    try {\n      await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      logger.info(\"Connection restored\");\n    } catch (_err) {\n      try {\n        return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n      } catch (_err2) {\n        logger.error(\"Failed to restart sidecar server after MCP stdio proxy closed.\");\n        captureException(_err2);\n        await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n      }\n    }\n  };\n}\n\nexport async function handler({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions) {\n  // Normalize allowed origins once at startup\n  const normalizedAllowedOrigins = allowedOrigins ? normalizeAllowedOrigins(allowedOrigins) : undefined;\n\n  if (port > 0 && (await isSidecarRunning(port))) {\n    logger.info(\"Connecting to existing MCP instance with stdio proxy...\");\n    await startMCPStdioHTTPProxy(port, basePath, filesToServe, normalizedAllowedOrigins);\n    logger.info(`Connected to existing MCP instance on port ${port}`);\n  } else {\n    return await startServerWithStdioMCP(port, basePath, filesToServe, normalizedAllowedOrigins);\n  }\n}\n\nexport default { meta, handler } satisfies Command;\n"],"names":["ProxyServerType"],"mappings":";;;;;;;;;;;;;;;;;;AAYO,MAAM,OAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,eAAe,wBACb,MACA,UACA,cACA,0BACA;AACA,QAAM,iBAAiB,MAAM,YAAY;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AACD,sBAAoB,cAAc;AAElC,SAAO,KAAK,gCAAgC;AAC5C,QAAM,cAAc,kBAAA;AACpB,QAAM,YAAY,QAAQ,IAAI,sBAAsB;AAEpD,QAAM,cAAc,MAAM;AACxB,gBAAY,MAAA;AAAA,EACd;AAEA,UAAQ,GAAG,UAAU,WAAW;AAChC,UAAQ,GAAG,WAAW,WAAW;AAEjC,SAAO;AACT;AAEA,eAAe,uBACb,MACA,UACA,cACA,0BACA;AACA,MAAI,sBAAsB;AAC1B,MAAI,SAAwB;AAC5B,MAAI,SAA8D;AAElE,QAAM,WAAW,YAAY;AAC3B,QAAI,qBAAqB;AAEvB,aAAO,KAAK,MAAM;AAClB,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,0BAAsB;AACtB,WAAO,KAAK,kCAAkC;AAE9C,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AACA,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AAAA,EACF;AAGA,UAAQ,GAAG,UAAU,QAAQ;AAC7B,UAAQ,GAAG,WAAW,QAAQ;AAE9B,WAAS,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA,IAK9B,kBAAkB,MAAM;AACtB,eAAS,IAAI,OAAO;AAAA,QAClB,MAAM;AAAA,QACN,SAAS;AAAA,MAAA,CACV;AACD,aAAO,UAAU,OAAO,QAAe;AACrC,YACE,IAAI,QAAQ,WAAW,+BAA+B,KACtD,+CAA+C,KAAK,IAAI,OAAO,GAC/D;AACA,cAAI,OAAQ,OAAM,OAAO,MAAA;AACzB,cAAI,OAAQ,OAAM,OAAO,MAAA;AAAA,QAC3B,WAAW,CAAC,YAAY,KAAK,IAAI,OAAO,GAAG;AACzC,2BAAiB,GAAG;AACpB,iBAAO,MAAM,0BAA0B,IAAI,IAAI,KAAK,IAAI,OAAO,EAAE;AAAA,QACnE;AAAA,MACF;AACA,aAAO,QAAQ,QAAQ,MAAM;AAAA,IAC/B;AAAA,IACA,YAAYA,WAAgB;AAAA,IAC5B,KAAK,oBAAoB,IAAI;AAAA,EAAA,CAC9B;AACD,SAAO,UAAU,YAAY;AAE3B,QAAI,qBAAqB;AACvB,aAAO,KAAK,gCAAgC;AAC5C;AAAA,IACF;AAEA,WAAO,KAAK,sEAAsE;AAClF,YAAQ,IAAI,UAAU,QAAQ;AAC9B,YAAQ,IAAI,WAAW,QAAQ;AAI/B,YAAQ,MAAM,OAAA;AAEd,QAAI;AACF,YAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AACnF,aAAO,KAAK,qBAAqB;AAAA,IACnC,SAAS,MAAM;AACb,UAAI;AACF,eAAO,MAAM,wBAAwB,MAAM,UAAU,cAAc,wBAAwB;AAAA,MAC7F,SAAS,OAAO;AACd,eAAO,MAAM,gEAAgE;AAC7E,yBAAiB,KAAK;AACtB,cAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AAAA,MACrF;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAsB,QAAQ,EAAE,MAAM,UAAU,cAAc,kBAAqC;AAEjG,QAAM,2BAA2B,iBAAiB,wBAAwB,cAAc,IAAI;AAE5F,MAAI,OAAO,KAAM,MAAM,iBAAiB,IAAI,GAAI;AAC9C,WAAO,KAAK,yDAAyD;AACrE,UAAM,uBAAuB,MAAM,UAAU,cAAc,wBAAwB;AACnF,WAAO,KAAK,8CAA8C,IAAI,EAAE;AAAA,EAClE,OAAO;AACL,WAAO,MAAM,wBAAwB,MAAM,UAAU,cAAc,wBAAwB;AAAA,EAC7F;AACF;AAEA,MAAA,MAAe,EAAE,MAAM,QAAA;"}

package/dist/server/cli/run.d.ts

@@ -1,2 +1,8 @@
-import { CLIHandlerOptions } from '../types/cli.ts';
-export default function run({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins, }: CLIHandlerOptions): Promise<void>;
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
+export declare const meta: CommandMeta;
+export declare function handler({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins, open, }: CLIHandlerOptions): Promise<void>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/run.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d80c232c-dfe0-4e60-8770-34fe04e96b35", e._sentryDebugIdIdentifier = "sentry-dbid-d80c232c-dfe0-4e60-8770-34fe04e96b35");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e59232d7-48d8-4dfe-907e-19a2d2b3cd58", e._sentryDebugIdIdentifier = "sentry-dbid-e59232d7-48d8-4dfe-907e-19a2d2b3cd58");
   } catch (e2) {
   }
 }();
@@ -16,17 +16,41 @@ import { uuidv7 } from "uuidv7";
 import { SENTRY_CONTENT_TYPE } from "../../shared/constants.js";
 import "../../_virtual/_sentry-release-injection-file.js";
 import { logger } from "../logger.js";
-import { detectDockerCompose, buildDockerComposeCommand } from "../utils/docker-compose.js";
-import { getSpotlightURL } from "../utils/extras.js";
+import { detectDockerCompose, prepareDockerComposeRun, parseExplicitDockerCompose } from "../utils/docker-compose.js";
+import { openInBrowser, getSpotlightURL } from "../utils/extras.js";
 import { getBuffer } from "../utils/getBuffer.js";
 import { EventContainer } from "../utils/eventContainer.js";
 import "node:dns/promises";
 import "node:net";
 import "node:os";
-import tail from "./tail.js";
-const SPOTLIGHT_VERSION = "4.7.2";
+import { handler as handler$1 } from "./tail.js";
+const meta = {
+  name: "run",
+  short: "Run your app with automatic Spotlight instrumentation",
+  usage: "spotlight run [options] [command...]",
+  long: `Run your application with Spotlight, automatically setting up the necessary
+environment variables and capturing telemetry data.
+
+If no command is provided, Spotlight auto-detects:
+  - Docker Compose projects (docker-compose.yml, compose.yml, etc.)
+  - package.json scripts (dev, develop, serve, start)
+
+Environment variables set automatically:
+  - SENTRY_SPOTLIGHT=http://localhost:<port>/stream
+  - NEXT_PUBLIC_SENTRY_SPOTLIGHT=http://localhost:<port>/stream
+  - SENTRY_TRACES_SAMPLE_RATE=1
+
+stdout/stderr are captured and sent to Spotlight as log events.`,
+  examples: [
+    "spotlight run                      # Auto-detect and run (package.json or docker-compose)",
+    "spotlight run node server.js       # Run a specific command with Spotlight",
+    "spotlight run -p 3000 npm start    # Run with custom port",
+    "spotlight run python manage.py runserver  # Run Python app",
+    "spotlight run docker compose up    # Run Docker Compose with Spotlight injection"
+  ]
+};
+const SPOTLIGHT_VERSION = "4.9.0";
 const LOCALHOST_HOST = "localhost";
-const DOCKER_HOST = "host.docker.internal";
 function detectPackageJson() {
   try {
     const scripts = JSON.parse(readFileSync("./package.json", "utf-8")).scripts;
@@ -98,13 +122,14 @@ function createLogEnvelope(level, body, timestamp) {
   return Buffer.from(`${parts.join("\n")}
 `, "utf-8");
 }
-async function run({
+async function handler({
   port,
   cmdArgs,
   basePath,
   filesToServe,
   format,
-  allowedOrigins
+  allowedOrigins,
+  open
 }) {
   let relayStdioAsLogs = true;
   const fuzzySearcher = new Searcher([], {
@@ -135,7 +160,7 @@ async function run({
     }
     return true;
   };
-  const serverInstance = await tail({ port, cmdArgs: [], basePath, filesToServe, format, allowedOrigins }, logChecker);
+  const serverInstance = await handler$1({ port, cmdArgs: [], basePath, filesToServe, format, allowedOrigins }, logChecker);
   if (!serverInstance) {
     logger.error("Failed to start Spotlight sidecar server.");
     logger.error(`The port ${port} might already be in use — most likely by another Spotlight instance.`);
@@ -143,6 +168,9 @@ async function run({
   }
   const actualServerPort = serverInstance.address().port;
   const spotlightUrl = getSpotlightURL(actualServerPort, LOCALHOST_HOST);
+  if (open) {
+    openInBrowser(actualServerPort);
+  }
   let shell = false;
   let stdin = void 0;
   const env = {
@@ -171,11 +199,7 @@ async function run({
           `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(", ")}`
         );
         metrics.count("cli.run.autodetect", 1, { attributes: { type: "docker-compose" } });
-        env.SENTRY_SPOTLIGHT = getSpotlightURL(actualServerPort, DOCKER_HOST);
-        const command = buildDockerComposeCommand(dockerCompose);
-        cmdArgs = command.cmdArgs;
-        stdin = command.stdin;
-        delete env.COMPOSE_FILE;
+        ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));
       } else {
         logger.info(`Using package.json script: ${packageJson.scriptName}`);
         metrics.count("cli.run.autodetect", 1, { attributes: { type: "package-json" } });
@@ -188,11 +212,7 @@ async function run({
         `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(", ")}`
       );
       metrics.count("cli.run.autodetect", 1, { attributes: { type: "docker-compose" } });
-      env.SENTRY_SPOTLIGHT = getSpotlightURL(actualServerPort, DOCKER_HOST);
-      const command = buildDockerComposeCommand(dockerCompose);
-      cmdArgs = command.cmdArgs;
-      stdin = command.stdin;
-      delete env.COMPOSE_FILE;
+      ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));
     } else if (packageJson) {
       logger.info(`Using package.json script: ${packageJson.scriptName}`);
       metrics.count("cli.run.autodetect", 1, { attributes: { type: "package-json" } });
@@ -200,6 +220,20 @@ async function run({
       shell = true;
       env.PATH = path.resolve("./node_modules/.bin") + path.delimiter + env.PATH;
     }
+  } else {
+    const explicitDockerConfig = parseExplicitDockerCompose(cmdArgs);
+    if (explicitDockerConfig) {
+      logger.info(
+        `Detected explicit Docker Compose command with ${explicitDockerConfig.serviceNames.length} service(s): ${explicitDockerConfig.serviceNames.join(", ")}`
+      );
+      metrics.count("cli.run.docker_compose.explicit", 1, {
+        attributes: {
+          services: explicitDockerConfig.serviceNames.length,
+          subcommand: explicitDockerConfig.subcommandArgs.join(" ")
+        }
+      });
+      ({ cmdArgs, stdin } = prepareDockerComposeRun(explicitDockerConfig, actualServerPort, env));
+    }
   }
   if (cmdArgs.length === 0) {
     logger.error("Error: No command specified to run and could not infer the command automatically.");
@@ -290,7 +324,10 @@ async function run({
     process.on("beforeExit", killRunCmd);
   });
 }
+const run = { meta, handler };
 export {
-  run as default
+  run as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=run.js.map