@socketsecurity/cli-with-sentry 1.1.47 → 1.1.49

package/dist/types/commands/npm/cmd-npm.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd-npm.d.mts","sourceRoot":"","sources":["../../../../src/commands/npm/cmd-npm.mts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,QAAQ,OAAM,CAAA;AAM3B,eAAO,MAAM,MAAM;;;;CAIlB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAoEf"}
+{"version":3,"file":"cmd-npm.d.mts","sourceRoot":"","sources":["../../../../src/commands/npm/cmd-npm.mts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,QAAQ,OAAM,CAAA;AAM3B,eAAO,MAAM,MAAM;;;;CAIlB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

package/dist/types/commands/npx/cmd-npx.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd-npx.d.mts","sourceRoot":"","sources":["../../../../src/commands/npx/cmd-npx.mts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAU9C,eAAO,MAAM,MAAM;;;;CAIlB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,EAAE,UAAU,EAAE,EAAE,iBAAiB,GAChC,OAAO,CAAC,IAAI,CAAC,CA4Df"}
+{"version":3,"file":"cmd-npx.d.mts","sourceRoot":"","sources":["../../../../src/commands/npx/cmd-npx.mts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAU9C,eAAO,MAAM,MAAM;;;;CAIlB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,EAAE,UAAU,EAAE,EAAE,iBAAiB,GAChC,OAAO,CAAC,IAAI,CAAC,CAoEf"}

package/dist/types/commands/pnpm/cmd-pnpm.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd-pnpm.d.mts","sourceRoot":"","sources":["../../../../src/commands/pnpm/cmd-pnpm.mts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,QAAQ,QAAO,CAAA;AAM5B,eAAO,MAAM,OAAO;;;;CAInB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAwDf"}
+{"version":3,"file":"cmd-pnpm.d.mts","sourceRoot":"","sources":["../../../../src/commands/pnpm/cmd-pnpm.mts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,QAAQ,QAAO,CAAA;AAM5B,eAAO,MAAM,OAAO;;;;CAInB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Ef"}

package/dist/types/commands/yarn/cmd-yarn.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd-yarn.d.mts","sourceRoot":"","sources":["../../../../src/commands/yarn/cmd-yarn.mts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,QAAQ,QAAO,CAAA;AAM5B,eAAO,MAAM,OAAO;;;;CAInB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAwDf"}
+{"version":3,"file":"cmd-yarn.d.mts","sourceRoot":"","sources":["../../../../src/commands/yarn/cmd-yarn.mts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,QAAQ,QAAO,CAAA;AAM5B,eAAO,MAAM,OAAO;;;;CAInB,CAAA;AAED,iBAAe,GAAG,CAChB,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Ef"}

package/dist/types/utils/ecosystem.d.mts

@@ -2,11 +2,14 @@ import type { EcosystemString } from '@socketsecurity/registry';
 import type { components } from '@socketsecurity/sdk/types/api';
 export type PURL_Type = components['schemas']['SocketPURL_Type'];
 type ExpectNever<T extends never> = T;
-type MissingInEcosystemString = Exclude<PURL_Type, EcosystemString>;
+// Temporarily commented out due to dependency version mismatch.
+// SDK has "alpm" but registry's EcosystemString doesn't yet.
+// type MissingInEcosystemString = Exclude<PURL_Type, EcosystemString>
 type ExtraInEcosystemString = Exclude<EcosystemString, PURL_Type>;
-export type _Check_EcosystemString_has_all_purl_types = ExpectNever<MissingInEcosystemString>;
+// export type _Check_EcosystemString_has_all_purl_types =
+//   ExpectNever<MissingInEcosystemString>
 export type _Check_EcosystemString_has_no_extras = ExpectNever<ExtraInEcosystemString>;
-export declare const ALL_ECOSYSTEMS: readonly ["apk", "bitbucket", "cargo", "chrome", "cocoapods", "composer", "conan", "conda", "cran", "deb", "docker", "gem", "generic", "github", "golang", "hackage", "hex", "huggingface", "maven", "mlflow", "npm", "nuget", "oci", "pub", "pypi", "qpkg", "rpm", "swift", "swid", "unknown"];
+export declare const ALL_ECOSYSTEMS: readonly ["alpm", "apk", "bitbucket", "cargo", "chrome", "cocoapods", "composer", "conan", "conda", "cran", "deb", "docker", "gem", "generic", "github", "golang", "hackage", "hex", "huggingface", "maven", "mlflow", "npm", "nuget", "oci", "pub", "pypi", "qpkg", "rpm", "swift", "swid", "unknown", "vscode"];
 type AllEcosystemsUnion = (typeof ALL_ECOSYSTEMS)[number];
 type MissingInAllEcosystems = Exclude<PURL_Type, AllEcosystemsUnion>;
 type ExtraInAllEcosystems = Exclude<AllEcosystemsUnion, PURL_Type>;

package/dist/types/utils/ecosystem.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ecosystem.d.mts","sourceRoot":"","sources":["../../../src/utils/ecosystem.mts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAA;AAEhE,KAAK,WAAW,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAA;AAErC,KAAK,wBAAwB,GAAG,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;AACnE,KAAK,sBAAsB,GAAG,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;AAEjE,MAAM,MAAM,yCAAyC,GACnD,WAAW,CAAC,wBAAwB,CAAC,CAAA;AACvC,MAAM,MAAM,oCAAoC,GAC9C,WAAW,CAAC,sBAAsB,CAAC,CAAA;AAErC,eAAO,MAAM,cAAc,iSA+Bc,CAAA;AAEzC,KAAK,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AACzD,KAAK,sBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;AACpE,KAAK,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAA;AAElE,MAAM,MAAM,wCAAwC,GAClD,WAAW,CAAC,sBAAsB,CAAC,CAAA;AACrC,MAAM,MAAM,mCAAmC,GAC7C,WAAW,CAAC,oBAAoB,CAAC,CAAA;AAEnC,eAAO,MAAM,wBAAwB,aAAkC,CAAA;AAEvE,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAElE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GACnC,SAAS,EAAE,CAUb"}
+{"version":3,"file":"ecosystem.d.mts","sourceRoot":"","sources":["../../../src/utils/ecosystem.mts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAA;AAEhE,KAAK,WAAW,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAA;AAErC,gEAAgE;AAChE,6DAA6D;AAC7D,sEAAsE;AACtE,KAAK,sBAAsB,GAAG,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;AAEjE,0DAA0D;AAC1D,0CAA0C;AAC1C,MAAM,MAAM,oCAAoC,GAC9C,WAAW,CAAC,sBAAsB,CAAC,CAAA;AAErC,eAAO,MAAM,cAAc,mTAiCc,CAAA;AAEzC,KAAK,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AACzD,KAAK,sBAAsB,GAAG,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;AACpE,KAAK,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAA;AAElE,MAAM,MAAM,wCAAwC,GAClD,WAAW,CAAC,sBAAsB,CAAC,CAAA;AACrC,MAAM,MAAM,mCAAmC,GAC7C,WAAW,CAAC,oBAAoB,CAAC,CAAA;AAEnC,eAAO,MAAM,wBAAwB,aAAkC,CAAA;AAEvE,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAElE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GACnC,SAAS,EAAE,CAUb"}

package/dist/types/utils/sdk.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.mts","sourceRoot":"","sources":["../../../src/utils/sdk.mts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,SAAS,EAA8B,MAAM,qBAAqB,CAAA;AAU3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAO3C,4DAA4D;AAC5D,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAKzD;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvD;AAID,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAavD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAQ9C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,GACpC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CA4E7B"}
+{"version":3,"file":"sdk.d.mts","sourceRoot":"","sources":["../../../src/utils/sdk.mts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,SAAS,EAA8B,MAAM,qBAAqB,CAAA;AAW3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAO3C,4DAA4D;AAC5D,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAKzD;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvD;AAKD,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAavD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAQ9C;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,GACpC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAmH7B"}

package/dist/types/utils/telemetry/integration.d.mts

@@ -0,0 +1,146 @@
+import type { TelemetryContext } from './types.mts';
+/**
+ * Finalize telemetry and clean up resources (async version).
+ * This should be called before process.exit to ensure telemetry is sent and resources are cleaned up.
+ * Use this in async contexts like beforeExit handlers.
+ *
+ * @returns Promise that resolves when finalization completes.
+ */
+export declare function finalizeTelemetry(): Promise<void>;
+/**
+ * Finalize telemetry synchronously (best-effort).
+ * This triggers a flush without awaiting it.
+ * Use this in synchronous contexts like signal handlers where async operations are not possible.
+ *
+ * Note: This is best-effort only. Events may be lost if the process exits before flush completes.
+ * Prefer finalizeTelemetry() (async version) when possible.
+ */
+export declare function finalizeTelemetrySync(): void;
+/**
+ * Set up exit handlers for telemetry finalization.
+ * This registers handlers for both normal exits (beforeExit) and common fatal signals.
+ *
+ * Flushing strategy:
+ * - Batch-based: Auto-flush when queue reaches 10 events.
+ * - beforeExit: Async handler for clean shutdowns (when event loop empties).
+ * - Fatal signals (SIGINT, SIGTERM, SIGHUP): Best-effort sync flush.
+ * - Accepts that forced exits (SIGKILL, process.exit()) may lose final events.
+ *
+ * Call this once during CLI initialization to ensure telemetry is flushed on exit.
+ * Safe to call multiple times - only registers handlers once.
+ *
+ * @example
+ * ```typescript
+ * // In src/cli.mts
+ * setupTelemetryExitHandlers()
+ * ```
+ */
+export declare function setupTelemetryExitHandlers(): void;
+/**
+ * Track subprocess exit and finalize telemetry.
+ * This is a convenience function that tracks completion/error based on exit code
+ * and ensures telemetry is flushed before returning.
+ *
+ * Note: Only tracks subprocess-level events. CLI-level events (cli_complete, cli_error)
+ * are tracked by the main CLI entry point in src/cli.mts.
+ *
+ * @param command - Command name (e.g., 'npm', 'pip').
+ * @param startTime - Start timestamp from trackSubprocessStart.
+ * @param exitCode - Process exit code (null treated as error).
+ * @returns Promise that resolves when tracking and flush complete.
+ *
+ * @example
+ * ```typescript
+ * await trackSubprocessExit(NPM, subprocessStartTime, code)
+ * ```
+ */
+export declare function trackSubprocessExit(command: string, startTime: number, exitCode: number | null): Promise<void>;
+/**
+ * Generic event tracking function.
+ * Tracks any telemetry event with optional error details and explicit flush.
+ *
+ * Events are automatically flushed via batch size or exit handlers.
+ * Use the flush option only when immediate submission is required.
+ *
+ * @param eventType Type of event to track.
+ * @param context Event context.
+ * @param metadata Event metadata.
+ * @param options Optional configuration.
+ * @returns Promise that resolves when tracking completes.
+ */
+export declare function trackEvent(eventType: string, context: TelemetryContext, metadata?: Record<string, unknown>, options?: {
+    error?: Error | undefined;
+    flush?: boolean | undefined;
+}): Promise<void>;
+/**
+ * Track CLI initialization event.
+ * Should be called at the start of CLI execution.
+ *
+ * @param argv Command line arguments (process.argv).
+ * @returns Start timestamp for duration calculation.
+ */
+export declare function trackCliStart(argv: string[]): Promise<number>;
+/**
+ * Track a generic CLI event with optional metadata.
+ * Use this for tracking custom events during CLI execution.
+ *
+ * @param eventType Type of event to track.
+ * @param argv Command line arguments (process.argv).
+ * @param metadata Optional additional metadata to include with the event.
+ */
+export declare function trackCliEvent(eventType: string, argv: string[], metadata?: Record<string, unknown> | undefined): Promise<void>;
+/**
+ * Track CLI completion event.
+ * Should be called on successful CLI exit.
+ * Flushes immediately since this is typically the last event before process exit.
+ *
+ * @param argv
+ * @param startTime Start timestamp from trackCliStart.
+ * @param exitCode Process exit code (default: 0).
+ */
+export declare function trackCliComplete(argv: string[], startTime: number, exitCode?: string | number | undefined | null): Promise<void>;
+/**
+ * Track CLI error event.
+ * Should be called when CLI exits with an error.
+ * Flushes immediately since this is typically the last event before process exit.
+ *
+ * @param argv
+ * @param startTime Start timestamp from trackCliStart.
+ * @param error Error that occurred.
+ * @param exitCode Process exit code (default: 1).
+ */
+export declare function trackCliError(argv: string[], startTime: number, error: unknown, exitCode?: number | string | undefined | null): Promise<void>;
+/**
+ * Track subprocess/command start event.
+ *
+ * Use this when spawning external commands like npm, npx, coana, cdxgen, etc.
+ *
+ * @param command Command being executed (e.g., 'npm', 'npx', 'coana').
+ * @param metadata Optional additional metadata (e.g., cwd, purpose).
+ * @returns Start timestamp for duration calculation.
+ */
+export declare function trackSubprocessStart(command: string, metadata?: Record<string, unknown> | undefined): Promise<number>;
+/**
+ * Track subprocess/command completion event.
+ *
+ * Should be called when spawned command completes successfully.
+ *
+ * @param command Command that was executed.
+ * @param startTime Start timestamp from trackSubprocessStart.
+ * @param exitCode Process exit code.
+ * @param metadata Optional additional metadata (e.g., stdout length, stderr length).
+ */
+export declare function trackSubprocessComplete(command: string, startTime: number, exitCode: number | null, metadata?: Record<string, unknown> | undefined): Promise<void>;
+/**
+ * Track subprocess/command error event.
+ *
+ * Should be called when spawned command fails or throws error.
+ *
+ * @param command Command that was executed.
+ * @param startTime Start timestamp from trackSubprocessStart.
+ * @param error Error that occurred.
+ * @param exitCode Process exit code.
+ * @param metadata Optional additional metadata.
+ */
+export declare function trackSubprocessError(command: string, startTime: number, error: unknown, exitCode?: number | null | undefined, metadata?: Record<string, unknown> | undefined): Promise<void>;
+//# sourceMappingURL=integration.d.mts.map

package/dist/types/utils/telemetry/integration.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.mts","sourceRoot":"","sources":["../../../../src/utils/telemetry/integration.mts"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AASnD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C;AAKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAiCjD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC,CAWf;AAsID;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvB,GACL,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQnE;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC7C,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/types/utils/telemetry/service.d.mts

@@ -0,0 +1,65 @@
+import type { TelemetryEvent } from './types.mts';
+/**
+ * Centralized telemetry service for Socket CLI.
+ * Telemetry is always scoped to an organization.
+ * Singleton pattern ensures only one instance exists per process.
+ *
+ * NOTE: Only one telemetry instance exists per process.
+ * If getTelemetryClient() is called with a different organization slug,
+ * it returns the existing instance for the original organization.
+ * Switching organizations mid-execution is not supported - the first
+ * organization to initialize telemetry will be used for the entire process.
+ *
+ * This is intended, since we can't switch an org during command execution.
+ */
+export declare class TelemetryService {
+    private readonly orgSlug;
+    private config;
+    private eventQueue;
+    private isDestroyed;
+    /**
+     * Private constructor.
+     * Requires organization slug.
+     *
+     * @param orgSlug - Organization identifier.
+     */
+    private constructor();
+    /**
+     * Get the current telemetry instance if one exists.
+     * Does not create a new instance.
+     *
+     * @returns Current telemetry instance or null if none exists.
+     */
+    static getCurrentInstance(): TelemetryService | null;
+    /**
+     * Get telemetry client for an organization.
+     * Creates and initializes client if it doesn't exist.
+     * Returns existing instance if already initialized.
+     *
+     * @param orgSlug - Organization identifier (required).
+     * @returns Initialized telemetry service instance.
+     */
+    static getTelemetryClient(orgSlug: string): Promise<TelemetryService>;
+    /**
+     * Track a telemetry event.
+     * Adds event to queue for batching and eventual submission.
+     * Auto-flushes when batch size is reached.
+     *
+     * @param event - Telemetry event to track (session_id is optional and will be auto-set).
+     */
+    track(event: Omit<TelemetryEvent, 'session_id'>): void;
+    /**
+     * Flush all queued events to the API.
+     * Returns immediately if no events queued or telemetry disabled.
+     * Times out after configured flush_timeout to prevent blocking CLI exit.
+     */
+    flush(): Promise<void>;
+    private sendEvents;
+    /**
+     * Destroy the telemetry service for this organization.
+     * Flushes remaining events and clears all state.
+     * Idempotent - safe to call multiple times.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=service.d.mts.map

package/dist/types/utils/telemetry/service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.mts","sourceRoot":"","sources":["../../../../src/utils/telemetry/service.mts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAmFjD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAQ;IAE3B;;;;;OAKG;IACH,OAAO,eAKN;IAED;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,IAAI,gBAAgB,GAAG,IAAI,CAEnD;IAED;;;;;;;OAOG;IACH,OAAa,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2C1E;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,IAAI,CA8BrD;IAED;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAqD3B;YAQa,UAAU;IAiDxB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAyD7B;CACF"}

package/dist/types/utils/telemetry/types.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Telemetry types for Socket CLI.
+ * Defines the structure of telemetry events and related data.
+ */
+/**
+ * Error details for telemetry events.
+ */
+export interface TelemetryEventError {
+    /** Error class/type name. */
+    type: string;
+    /** Error message. */
+    message: string | undefined;
+    /** Stack trace (sanitized). */
+    stack?: string | undefined;
+}
+/**
+ * Telemetry Context.
+ *
+ * This represent how the cli was invoked and met.
+ */
+export interface TelemetryContext {
+    version: string;
+    platform: string;
+    node_version: string;
+    arch: string;
+    argv: string[];
+}
+/**
+ * Telemetry event structure.
+ * All telemetry events must follow this schema.
+ */
+export interface TelemetryEvent {
+    event_sender_created_at: string;
+    event_type: string;
+    context: TelemetryContext;
+    session_id?: string;
+    metadata?: Record<string, unknown>;
+    error?: TelemetryEventError | undefined;
+}
+//# sourceMappingURL=types.d.mts.map

package/dist/types/utils/telemetry/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../../src/utils/telemetry/types.mts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,KAAK,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;CACxC"}