extension 3.14.0-next.0 → 3.14.0

package/dist/extension/commands/build.d.ts

@@ -1,2 +1,2 @@
 import type { Command } from 'commander';
-export declare function registerBuildCommand(program: Command, telemetry: any): void;
+export declare function registerBuildCommand(program: Command): void;

package/dist/extension/commands/create.d.ts

@@ -1,2 +1,2 @@
 import type { Command } from 'commander';
-export declare function registerCreateCommand(program: Command, telemetry: any): void;
+export declare function registerCreateCommand(program: Command): void;

package/dist/extension/commands/dev.d.ts

@@ -1,2 +1,2 @@
 import type { Command } from 'commander';
-export declare function registerDevCommand(program: Command, telemetry: any): void;
+export declare function registerDevCommand(program: Command): void;

package/dist/extension/commands/install.d.ts

@@ -1,2 +1,2 @@
 import type { Command } from 'commander';
-export declare function registerInstallCommand(program: Command, telemetry: any): void;
+export declare function registerInstallCommand(program: Command): void;

package/dist/extension/commands/preview.d.ts

@@ -1,2 +1,2 @@
 import type { Command } from 'commander';
-export declare function registerPreviewCommand(program: Command, telemetry: any): void;
+export declare function registerPreviewCommand(program: Command): void;

package/dist/extension/commands/start.d.ts

@@ -1,2 +1,2 @@
 import type { Command } from 'commander';
-export declare function registerStartCommand(program: Command, telemetry: any): void;
+export declare function registerStartCommand(program: Command): void;

package/dist/extension/commands/telemetry.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerTelemetryCommand(program: Command): void;

package/dist/extension/helpers/messages.d.ts

@@ -15,6 +15,7 @@ export declare const commandDescriptions: {
     readonly build: "Builds the extension for packaging/distribution";
     readonly install: "Installs a managed browser binary into Extension.js cache";
     readonly uninstall: "Removes managed browser binaries from Extension.js cache";
+    readonly telemetry: "Manage anonymous telemetry consent (enable, disable, or show status)";
 };
 export declare function unhandledError(err: unknown): string;
 export declare function updateFailed(err: any): string;
@@ -35,7 +36,7 @@ export declare function programAIHelp(): string;
 export type ProgramAIHelpJSON = {
     version: string;
     commands: Array<{
-        name: 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall';
+        name: 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall' | 'telemetry';
         summary: string;
         supportsSourceInspection: boolean;
     }>;

package/dist/extension/helpers/telemetry-cli.d.ts

@@ -1,5 +1,15 @@
-import { Telemetry } from './telemetry';
-type KnownCommand = 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall' | 'cleanup' | 'unknown';
-export declare const telemetry: Telemetry;
+import { Telemetry, type TelemetrySource } from './telemetry';
+type KnownCommand = 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall' | 'telemetry' | 'unknown';
 export declare function detectInvokedCommand(argv: string[]): KnownCommand;
+export declare const telemetry: Telemetry;
+export declare function getTelemetryConsent(): {
+    enabled: boolean;
+    source: TelemetrySource;
+};
+export declare function setTelemetryConsent(value: 'enabled' | 'disabled'): {
+    ok: boolean;
+    path: string | null;
+};
+export declare function markCommandSuccess(command?: KnownCommand): void;
+export declare function markCommandFailure(command?: KnownCommand): void;
 export {};

package/dist/extension/helpers/telemetry.d.ts

@@ -1,23 +1,53 @@
+export type TelemetryEvent = 'command_executed' | 'command_failed';
+export type TelemetryProps = {
+    command: string;
+    success: boolean;
+    version: string;
+};
+export type TelemetrySource = 'env' | 'flag' | 'config' | 'default';
 type TelemetryInit = {
     app: string;
     version: string;
     apiKey?: string;
     host?: string;
     disabled?: boolean;
+    sampleRate?: number;
+    maxEventsPerRun?: number;
+    debounceMs?: number;
+};
+type TelemetryStorage = {
+    telemetryDir: string;
+    auditFile: string;
+    idFile: string;
+    consentFile: string;
 };
+export declare function resolveTelemetryStorage(): TelemetryStorage | null;
+export declare function resolveTelemetryConsent(argv?: string[]): {
+    enabled: boolean;
+    source: TelemetrySource;
+};
+export declare function writeConsent(value: 'enabled' | 'disabled'): boolean;
 export declare class Telemetry {
-    private anonId;
-    private common;
-    private debug;
     private disabled;
-    private apiKey?;
-    private host?;
+    private version;
+    private app;
+    private apiKey;
+    private host;
+    private anonId;
     private storage;
+    private sent;
+    private readonly sampleRate;
+    private readonly maxEventsPerRun;
+    private readonly debounceMs;
+    private readonly debug;
+    private readonly common;
+    private recent;
     private buffer;
-    private timer;
     constructor(init: TelemetryInit);
-    track(event: string, props?: Record<string, unknown>): void;
+    get isEnabled(): boolean;
+    track(event: TelemetryEvent, props: TelemetryProps): void;
     flush(): Promise<void>;
     shutdown(): void;
+    private writeAudit;
 }
 export {};

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "3.14.0-next.0",
+  "version": "3.14.0",
   "description": "Create cross-browser extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -100,9 +100,9 @@
     "cross-spawn": "^7.0.6",
     "edge-location": "2.2.0",
     "firefox-location2": "3.0.0",
-    "extension-create": "3.14.0-next.0",
-    "extension-develop": "3.14.0-next.0",
-    "extension-install": "3.14.0-next.0",
+    "extension-create": "3.14.0",
+    "extension-develop": "3.14.0",
+    "extension-install": "3.14.0",
     "commander": "^14.0.3",
     "pintor": "0.3.0",
     "semver": "^7.7.3",

package/dist/extension/helpers/manifest-summary.d.ts

@@ -1,13 +0,0 @@
-export type ManifestSummary = {
-    mv: 2 | 3;
-    permissions_count: number;
-    optional_permissions_count: number;
-    host_permissions_count: number;
-    uses_all_urls: boolean;
-    uses_declarative_net_request: boolean;
-    background_type: 'service_worker' | 'event_page' | 'none';
-    content_scripts_count: number;
-    has_devtools_page: boolean;
-    has_action_popup: boolean;
-};
-export declare function summarizeManifest(manifest: any): ManifestSummary;

package/dist/extension/helpers/project-profile.d.ts

@@ -1,17 +0,0 @@
-import type { ManifestSummary } from './manifest-summary';
-export type PackageManagerName = 'pnpm' | 'yarn' | 'npm' | 'bun' | 'unknown';
-export type FrameworkPrimary = 'react' | 'preact' | 'vue' | 'svelte' | 'solid' | 'angular' | 'unknown';
-export type PermissionBucket = '0' | '1_3' | '4_10' | '11_plus';
-export type ManifestSurface = 'background_only' | 'content_scripts' | 'action_popup' | 'devtools' | 'multi_surface' | 'other' | 'unknown';
-export type ProjectProfile = {
-    package_manager: PackageManagerName;
-    framework_primary: FrameworkPrimary;
-    has_typescript: boolean;
-    is_monorepo: boolean;
-    has_next_dependency: boolean;
-    has_turbo_dependency: boolean;
-    manifest_surface: ManifestSurface;
-    permissions_bucket: PermissionBucket;
-    host_permissions_bucket: PermissionBucket;
-};
-export declare function collectProjectProfile(projectRoot: string, summary?: ManifestSummary | null): ProjectProfile | null;

package/dist/extension/helpers/workflow-profile.d.ts

@@ -1,35 +0,0 @@
-import type { FrameworkPrimary, PackageManagerName } from './project-profile';
-export type WorkflowCohort = 'local_only' | 'shipping' | 'automation_heavy';
-type WorkflowProjectShape = {
-    packageManager?: PackageManagerName;
-    frameworkPrimary?: FrameworkPrimary;
-    hasNextDependency?: boolean;
-    hasTurboDependency?: boolean;
-};
-type WorkflowContext = {
-    command: 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall';
-    isMultiBrowser?: boolean;
-    isRemoteInput?: boolean;
-    isWaitMode?: boolean;
-    isNoBrowserMode?: boolean;
-    usesMachineReadableOutput?: boolean;
-    sourceInspectionRequested?: boolean;
-    companionExtensionsProvided?: boolean;
-    artifactKind?: 'directory' | 'zip' | 'source_zip' | 'zip_and_source';
-    whereMode?: boolean;
-} & WorkflowProjectShape;
-type WorkflowReason = 'production_command' | 'multi_browser' | 'artifact_output' | 'companion_extensions' | 'headless_sync' | 'machine_readable_output' | 'source_inspection' | 'where_mode';
-export type WorkflowProfile = {
-    workflow_cohort: WorkflowCohort;
-    has_shipping_intent: boolean;
-    has_automation_intent: boolean;
-    shipping_signal_count: number;
-    automation_signal_count: number;
-    primary_workflow_signal: WorkflowReason | 'none';
-    package_manager?: PackageManagerName;
-    framework_primary?: FrameworkPrimary;
-    has_next_dependency?: boolean;
-    has_turbo_dependency?: boolean;
-};
-export declare function collectWorkflowProfile(context: WorkflowContext): WorkflowProfile;
-export {};