@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/install/install-helper.js

@@ -0,0 +1,227 @@
+/**
+ * Pure logic for generating and merging Claude Code hook/MCP settings.
+ *
+ * All functions are side-effect-free — file I/O happens in the CLI layer (cli.ts).
+ */
+import { dirname, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const HOOK_MATCHER = '';
+const MCP_SERVER_KEY = 'newrelic-preflight';
+const MCP_SERVER_COMMAND = 'preflight';
+const COLLECTOR_COMMAND = 'preflight-collector';
+// Matches the hook commands this installer writes, in both bare-name and
+// absolute-path forms (quoted or unquoted):
+//   preflight-collector pre-tool
+//   /abs/path/preflight-collector pre-tool
+//   "/quoted/path/preflight-collector" pre-tool
+const NR_HOOK_RE = /preflight-collector"?\s+(?:pre|post)-tool/;
+// ---------------------------------------------------------------------------
+// Generators
+// ---------------------------------------------------------------------------
+export function generateHookEntries(binPath) {
+    // Quote the path so shells with sh -c don't split on spaces (e.g. /Users/John Doe/...).
+    // Hook commands use preflight-collector (lightweight, <5ms budget).
+    const bin = binPath
+        ? `"${join(dirname(binPath), COLLECTOR_COMMAND).replace(/"/g, '\\"')}"`
+        : COLLECTOR_COMMAND;
+    return {
+        PreToolUse: [
+            { matcher: HOOK_MATCHER, hooks: [{ type: 'command', command: `${bin} pre-tool` }] },
+        ],
+        PostToolUse: [
+            { matcher: HOOK_MATCHER, hooks: [{ type: 'command', command: `${bin} post-tool` }] },
+        ],
+    };
+}
+export function generateMcpServerEntry(binPath) {
+    // MCP server uses the main preflight binary.
+    const command = binPath ? join(dirname(binPath), MCP_SERVER_COMMAND) : MCP_SERVER_COMMAND;
+    return {
+        [MCP_SERVER_KEY]: { command, args: ['--stdio'] },
+    };
+}
+export function generateNrConfig(licenseKey, accountId) {
+    return { licenseKey, accountId };
+}
+// ---------------------------------------------------------------------------
+// Settings path detection
+// ---------------------------------------------------------------------------
+export function detectSettingsPath(scope) {
+    if (scope === 'user') {
+        return resolve(homedir(), '.claude', 'settings.json');
+    }
+    return resolve(process.cwd(), '.claude', 'settings.json');
+}
+export function detectMcpConfigPath(scope) {
+    if (scope === 'user') {
+        return resolve(homedir(), '.mcp.json');
+    }
+    return resolve(process.cwd(), '.mcp.json');
+}
+// ---------------------------------------------------------------------------
+// Merge helpers
+// ---------------------------------------------------------------------------
+function entryContainsNrObserve(entry) {
+    if (typeof entry !== 'object' || entry === null)
+        return false;
+    const obj = entry;
+    // New format: { matcher, hooks: [{ type, command }] }
+    if (Array.isArray(obj.hooks)) {
+        return obj.hooks.some((h) => typeof h === 'object' &&
+            h !== null &&
+            'command' in h &&
+            typeof h.command === 'string' &&
+            NR_HOOK_RE.test(h.command));
+    }
+    // Legacy flat format: { matcher, command }
+    if ('command' in obj && typeof obj.command === 'string' && NR_HOOK_RE.test(obj.command)) {
+        return true;
+    }
+    return false;
+}
+function filterNrObserveEntries(entries) {
+    return entries.filter((e) => !entryContainsNrObserve(e));
+}
+// ---------------------------------------------------------------------------
+// Zod schemas — validate existing file shapes before merging
+// ---------------------------------------------------------------------------
+// Hooks: only require that PreToolUse/PostToolUse are arrays — individual
+// entries may come from other tools in any shape, so we don't validate them.
+const HooksFieldSchema = z
+    .object({
+    PreToolUse: z.array(z.unknown()).optional(),
+    PostToolUse: z.array(z.unknown()).optional(),
+})
+    .passthrough();
+const SettingsSchema = z.object({ hooks: HooksFieldSchema.optional() }).passthrough();
+// MCP config: only require mcpServers is a string-keyed record — individual
+// entries may be stdio ({command, args}) or remote ({url, transport}), so we
+// don't validate their shape.
+const McpConfigSchema = z
+    .object({
+    mcpServers: z.record(z.string(), z.unknown()).optional(),
+})
+    .passthrough();
+// ---------------------------------------------------------------------------
+// mergeSettings
+// ---------------------------------------------------------------------------
+export function mergeSettings(existing, binPath) {
+    const parsed = SettingsSchema.safeParse(existing);
+    if (!parsed.success) {
+        throw new Error(`Existing settings file has unexpected shape — fix manually before running install.\n${parsed.error.message}`);
+    }
+    const result = { ...existing };
+    const hookEntries = generateHookEntries(binPath);
+    // --- Hooks ---
+    const hooks = typeof result.hooks === 'object' && result.hooks !== null
+        ? { ...result.hooks }
+        : {};
+    for (const hookType of ['PreToolUse', 'PostToolUse']) {
+        const existingArr = Array.isArray(hooks[hookType]) ? [...hooks[hookType]] : [];
+        if (binPath !== null && binPath !== undefined) {
+            // Resolved path available: remove stale entry and re-add with the current
+            // absolute path so re-install always upgrades a bare-name or outdated entry.
+            const withoutNr = filterNrObserveEntries(existingArr);
+            hooks[hookType] = [...withoutNr, ...hookEntries[hookType]];
+        }
+        else {
+            // No path resolved (binary not on PATH): leave any existing entry untouched
+            // so a working absolute-path hook is not downgraded to a bare name.
+            if (!existingArr.some(entryContainsNrObserve)) {
+                existingArr.push(...hookEntries[hookType]);
+            }
+            hooks[hookType] = existingArr;
+        }
+    }
+    result.hooks = hooks;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// mergeMcpConfig — operates on ~/.mcp.json (separate from settings.json)
+// ---------------------------------------------------------------------------
+export function mergeMcpConfig(existing, binPath) {
+    const parsed = McpConfigSchema.safeParse(existing);
+    if (!parsed.success) {
+        throw new Error(`Existing MCP config file has unexpected shape — fix manually before running install.\n${parsed.error.message}`);
+    }
+    const result = { ...existing };
+    const mcpServers = typeof result.mcpServers === 'object' && result.mcpServers !== null
+        ? { ...result.mcpServers }
+        : {};
+    // Remove stale keys from previous installs so ~/.mcp.json doesn't accumulate
+    // duplicate server entries under old names.
+    for (const staleKey of ['preflight', 'nr-ai-observability']) {
+        delete mcpServers[staleKey];
+    }
+    if (binPath !== null && binPath !== undefined) {
+        // Resolved path available: merge new command/args into existing entry,
+        // preserving any user-added fields (env, timeout, etc.).
+        const newEntry = generateMcpServerEntry(binPath);
+        const existingEntry = typeof mcpServers[MCP_SERVER_KEY] === 'object' && mcpServers[MCP_SERVER_KEY] !== null
+            ? mcpServers[MCP_SERVER_KEY]
+            : {};
+        mcpServers[MCP_SERVER_KEY] = { ...existingEntry, ...newEntry[MCP_SERVER_KEY] };
+    }
+    else if (!(MCP_SERVER_KEY in mcpServers)) {
+        // No path resolved: only add if absent so a working absolute-path entry
+        // is not downgraded to a bare name.
+        mcpServers[MCP_SERVER_KEY] = generateMcpServerEntry(null)[MCP_SERVER_KEY];
+    }
+    result.mcpServers = mcpServers;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// removeSettings
+// ---------------------------------------------------------------------------
+export function removeSettings(existing) {
+    const result = { ...existing };
+    // --- Hooks ---
+    if (typeof result.hooks === 'object' && result.hooks !== null) {
+        const hooks = { ...result.hooks };
+        for (const hookType of ['PreToolUse', 'PostToolUse']) {
+            if (Array.isArray(hooks[hookType])) {
+                const filtered = filterNrObserveEntries(hooks[hookType]);
+                if (filtered.length > 0) {
+                    hooks[hookType] = filtered;
+                }
+                else {
+                    delete hooks[hookType];
+                }
+            }
+        }
+        if (Object.keys(hooks).length > 0) {
+            result.hooks = hooks;
+        }
+        else {
+            delete result.hooks;
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// removeMcpConfig — operates on ~/.mcp.json (separate from settings.json)
+// ---------------------------------------------------------------------------
+export function removeMcpConfig(existing) {
+    const result = { ...existing };
+    if (typeof result.mcpServers === 'object' && result.mcpServers !== null) {
+        const mcpServers = { ...result.mcpServers };
+        delete mcpServers[MCP_SERVER_KEY];
+        // Also remove stale keys from prior installs so uninstall is complete even
+        // when the user never ran `preflight install` after upgrading.
+        for (const staleKey of ['preflight', 'nr-ai-observability']) {
+            delete mcpServers[staleKey];
+        }
+        if (Object.keys(mcpServers).length > 0) {
+            result.mcpServers = mcpServers;
+        }
+        else {
+            delete result.mcpServers;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=install-helper.js.map

package/dist/install/install-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helper.js","sourceRoot":"","sources":["../../src/install/install-helper.ts"],"names":[],"mappings":"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"}

package/dist/install/key-validator.d.ts

@@ -0,0 +1,19 @@
+export declare function getEventsApiUrl(accountId: string, collectorHost: string | null): string;
+export declare function getNerdgraphUrl(collectorHost: string | null): string;
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly detail?: string;
+    readonly reason?: 'unauthorized' | 'timeout' | 'network' | 'server-error';
+}
+export declare function validateLicenseKey(params: {
+    licenseKey: string;
+    accountId: string;
+    collectorHost: string | null;
+    timeoutMs?: number;
+}): Promise<ValidationResult>;
+export declare function validateApiKey(params: {
+    nrApiKey: string;
+    collectorHost: string | null;
+    timeoutMs?: number;
+}): Promise<ValidationResult>;
+//# sourceMappingURL=key-validator.d.ts.map

package/dist/install/key-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-validator.d.ts","sourceRoot":"","sources":["../../src/install/key-validator.ts"],"names":[],"mappings":"AAgBA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGvF;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEpE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;CAC3E;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwC5B;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4D5B"}

package/dist/install/key-validator.js

@@ -0,0 +1,122 @@
+import { createLogger } from '../shared/index.js';
+const logger = createLogger('key-validator');
+const EVENTS_API_HOSTS = {
+    eu: 'insights-collector.eu01.nr-data.net',
+    gov: 'gov-insights-collector.newrelic.com',
+    us: 'insights-collector.newrelic.com',
+};
+const NERDGRAPH_URLS = {
+    eu: 'https://api.eu.newrelic.com/graphql',
+    gov: 'https://api.newrelic.com/graphql',
+    us: 'https://api.newrelic.com/graphql',
+};
+export function getEventsApiUrl(accountId, collectorHost) {
+    const host = EVENTS_API_HOSTS[collectorHost ?? 'us'] ?? EVENTS_API_HOSTS['us'];
+    return `https://${host}/v1/accounts/${accountId}/events`;
+}
+export function getNerdgraphUrl(collectorHost) {
+    return NERDGRAPH_URLS[collectorHost ?? 'us'] ?? NERDGRAPH_URLS['us'];
+}
+export async function validateLicenseKey(params) {
+    const { licenseKey, accountId, collectorHost, timeoutMs = 5000 } = params;
+    const url = getEventsApiUrl(accountId, collectorHost);
+    const body = JSON.stringify([{ eventType: 'NrAiObserveSetupCheck', setupCheck: true }]);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'X-Insert-Key': licenseKey, 'Content-Type': 'application/json' },
+            body,
+            signal: controller.signal,
+        });
+        if (res.status === 200)
+            return { valid: true };
+        if (res.status === 403 || res.status === 401) {
+            return {
+                valid: false,
+                reason: 'unauthorized',
+                detail: 'key rejected (HTTP ' + String(res.status) + ')',
+            };
+        }
+        return { valid: false, reason: 'server-error', detail: 'HTTP ' + String(res.status) };
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            return {
+                valid: false,
+                reason: 'timeout',
+                detail: 'no response within ' + String(timeoutMs) + 'ms',
+            };
+        }
+        logger.warn('license key validation network error', { err: String(err) });
+        return {
+            valid: false,
+            reason: 'network',
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function validateApiKey(params) {
+    const { nrApiKey, collectorHost, timeoutMs = 5000 } = params;
+    const url = getNerdgraphUrl(collectorHost);
+    const body = JSON.stringify({ query: '{ actor { user { email } } }' });
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Api-Key': nrApiKey, 'Content-Type': 'application/json' },
+            body,
+            signal: controller.signal,
+        });
+        if (res.status === 403 || res.status === 401) {
+            return {
+                valid: false,
+                reason: 'unauthorized',
+                detail: 'key rejected (HTTP ' + String(res.status) + ')',
+            };
+        }
+        if (res.status !== 200) {
+            return { valid: false, reason: 'server-error', detail: 'HTTP ' + String(res.status) };
+        }
+        const json = (await res.json());
+        if (json.errors?.length) {
+            // Inspect error codes — AUTHENTICATION_ERROR means bad key; anything
+            // else is a server-side or schema problem unrelated to key validity.
+            const isAuthError = json.errors.some((e) => {
+                const code = e?.extensions?.code;
+                return typeof code === 'string' && /auth/i.test(code);
+            });
+            return {
+                valid: false,
+                reason: isAuthError ? 'unauthorized' : 'server-error',
+                detail: isAuthError ? 'API rejected authentication' : 'API returned errors',
+            };
+        }
+        const email = json.data?.actor?.user?.email;
+        return { valid: true, detail: email };
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'AbortError') {
+            return {
+                valid: false,
+                reason: 'timeout',
+                detail: 'no response within ' + String(timeoutMs) + 'ms',
+            };
+        }
+        logger.warn('API key validation network error', { err: String(err) });
+        return {
+            valid: false,
+            reason: 'network',
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=key-validator.js.map

package/dist/install/key-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-validator.js","sourceRoot":"","sources":["../../src/install/key-validator.ts"],"names":[],"mappings":"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"}

package/dist/install/migrate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * One-time migration: rename ~/.nr-ai-observe → ~/.newrelic-preflight when the
+ * new path doesn't exist yet. Safe to call from any entry point (install,
+ * update, setup wizard, server startup). Runs silently on success; warns on
+ * failure but never aborts the caller.
+ *
+ * Pass interactive=true from CLI entry points (install, setup wizard) to
+ * prompt before merging when both paths exist. Non-interactive callers
+ * (server startup, update) print a notice instead.
+ */
+export declare function migrateStoragePath(interactive?: boolean): void;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/install/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/install/migrate.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,UAAQ,GAAG,IAAI,CAgG5D"}

package/dist/install/migrate.js

@@ -0,0 +1,115 @@
+import { existsSync, renameSync, cpSync, rmSync, readSync, openSync, closeSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { DEFAULT_STORAGE_PATH } from '../config.js';
+function promptYesNo(question) {
+    process.stderr.write(question);
+    // Open /dev/tty directly — Node.js sets fd 0 to O_NONBLOCK on TTY startup,
+    // causing readSync(0,...) to return 0 immediately. A freshly opened fd blocks.
+    const fd = openSync('/dev/tty', 'r');
+    try {
+        const buf = Buffer.alloc(256);
+        const n = readSync(fd, buf, 0, buf.length, null);
+        return buf.subarray(0, n).toString().trim().toLowerCase().startsWith('y');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * One-time migration: rename ~/.nr-ai-observe → ~/.newrelic-preflight when the
+ * new path doesn't exist yet. Safe to call from any entry point (install,
+ * update, setup wizard, server startup). Runs silently on success; warns on
+ * failure but never aborts the caller.
+ *
+ * Pass interactive=true from CLI entry points (install, setup wizard) to
+ * prompt before merging when both paths exist. Non-interactive callers
+ * (server startup, update) print a notice instead.
+ */
+export function migrateStoragePath(interactive = false) {
+    const oldPath = resolve(homedir(), '.nr-ai-observe');
+    const newPath = DEFAULT_STORAGE_PATH;
+    if (!existsSync(oldPath))
+        return;
+    if (existsSync(newPath)) {
+        // Both paths exist — newPath was likely created by `preflight install` or
+        // server startup before migration ran.
+        const hasOldContent = existsSync(resolve(oldPath, 'config.json')) ||
+            existsSync(resolve(oldPath, 'sessions')) ||
+            existsSync(resolve(oldPath, 'alerts')) ||
+            existsSync(resolve(oldPath, 'weekly_summaries'));
+        if (!hasOldContent)
+            return;
+        if (!interactive || !process.stdin.isTTY) {
+            // Non-interactive or non-TTY stdin (server startup, launchd update, CI):
+            // surface the notice so the user sees it next time they run `preflight install`.
+            // Never prompt when stdin is not a TTY — readSync returns 0 on EOF rather
+            // than throwing, which would produce a misleading "Migration skipped" message.
+            process.stderr.write(`[preflight] Notice: found old data at ${oldPath} but ${newPath} already exists.\n` +
+                `  Run \`preflight install\` in an interactive terminal to migrate your sessions, config, and alert rules.\n`);
+            return;
+        }
+        let confirmed = false;
+        try {
+            confirmed = promptYesNo(`[preflight] Found old storage data at ${oldPath}.\n` +
+                `  Merge into ${newPath}? Existing files in the new location will not be overwritten. [y/N] `);
+        }
+        catch {
+            // Unexpected stdin error — treat as "no"
+        }
+        if (!confirmed) {
+            process.stderr.write(`[preflight] Migration skipped. To migrate manually:\n` +
+                `    cp -rn "${oldPath}/." "${newPath}/" || true\n` +
+                `    rm -r "${oldPath}"\n`);
+            return;
+        }
+        try {
+            cpSync(oldPath, newPath, { recursive: true, force: false, errorOnExist: false });
+        }
+        catch (err) {
+            process.stderr.write(`[preflight] Could not merge storage directories. To migrate manually:\n` +
+                `    cp -rn "${oldPath}/." "${newPath}/" || true\n` +
+                `    rm -r "${oldPath}"\n` +
+                `  Error: ${err instanceof Error ? err.message : String(err)}\n`);
+            return;
+        }
+        try {
+            rmSync(oldPath, { recursive: true, force: true });
+        }
+        catch (err) {
+            // Copy succeeded — data is safe in newPath. Only cleanup failed.
+            process.stderr.write(`[preflight] Sessions merged into ${newPath} but old directory could not be removed.\n` +
+                `  Safe to delete manually: rm -r "${oldPath}"\n` +
+                `  Error: ${err instanceof Error ? err.message : String(err)}\n`);
+            return;
+        }
+        process.stderr.write(`[preflight] Merged storage directory:\n` +
+            `  ${oldPath}\n` +
+            `  → ${newPath}\n` +
+            `  Your sessions, config, and alert rules have been moved automatically.\n`);
+        return;
+    }
+    try {
+        renameSync(oldPath, newPath);
+        process.stderr.write(`[preflight] Migrated storage directory:\n` +
+            `  ${oldPath}\n` +
+            `  → ${newPath}\n` +
+            `  Your sessions, config, and alert rules have been moved automatically.\n`);
+    }
+    catch (err) {
+        // ENOENT means another preflight process already completed the migration
+        // (oldPath is gone, newPath exists) — return silently.
+        // ENOTEMPTY means newPath was created between our existsSync check and the
+        // rename call (e.g. a concurrent `preflight install`). In that case oldPath
+        // still exists with user data — fall through to the warning so the user
+        // knows to merge manually.
+        const code = err.code;
+        if (code === 'ENOENT' && existsSync(newPath)) {
+            return;
+        }
+        process.stderr.write(`[preflight] Warning: could not migrate storage directory from ${oldPath} to ${newPath}.\n` +
+            `  Please rename it manually, or set NEW_RELIC_AI_MCP_STORAGE_PATH to override.\n` +
+            `  Error: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/install/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/install/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,+EAA+E;IAC/E,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAW,GAAG,KAAK;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,oBAAoB,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACjC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,0EAA0E;QAC1E,uCAAuC;QACvC,MAAM,aAAa,GACjB,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC3C,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACxC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,aAAa;YAAE,OAAO;QAC3B,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzC,yEAAyE;YACzE,iFAAiF;YACjF,0EAA0E;YAC1E,+EAA+E;YAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yCAAyC,OAAO,QAAQ,OAAO,oBAAoB;gBACjF,6GAA6G,CAChH,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,WAAW,CACrB,yCAAyC,OAAO,KAAK;gBACnD,gBAAgB,OAAO,sEAAsE,CAChG,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uDAAuD;gBACrD,eAAe,OAAO,QAAQ,OAAO,cAAc;gBACnD,cAAc,OAAO,KAAK,CAC7B,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yEAAyE;gBACvE,eAAe,OAAO,QAAQ,OAAO,cAAc;gBACnD,cAAc,OAAO,KAAK;gBAC1B,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACnE,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iEAAiE;YACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oCAAoC,OAAO,4CAA4C;gBACrF,qCAAqC,OAAO,KAAK;gBACjD,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACnE,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yCAAyC;YACvC,KAAK,OAAO,IAAI;YAChB,OAAO,OAAO,IAAI;YAClB,2EAA2E,CAC9E,CAAC;QACF,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2CAA2C;YACzC,KAAK,OAAO,IAAI;YAChB,OAAO,OAAO,IAAI;YAClB,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yEAAyE;QACzE,uDAAuD;QACvD,2EAA2E;QAC3E,4EAA4E;QAC5E,wEAAwE;QACxE,2BAA2B;QAC3B,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iEAAiE,OAAO,OAAO,OAAO,KAAK;YACzF,kFAAkF;YAClF,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACnE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/install/schedule.d.ts

@@ -0,0 +1,11 @@
+export interface ScheduleStatus {
+    readonly installed: boolean;
+    readonly hour?: number;
+    readonly minute?: number;
+    readonly binaryPath?: string;
+}
+export declare function installSchedule(binaryPath: string, hour: number, minute: number): void;
+export declare function removeSchedule(): void;
+export declare function getScheduleStatus(): ScheduleStatus;
+export declare function resolveBinaryPath(): string | null;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/install/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/install/schedule.ts"],"names":[],"mappings":"AA6DA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CActF;AAED,wBAAgB,cAAc,IAAI,IAAI,CASrC;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAmBlD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAgBjD"}