77 lines
2.5 KiB
TypeScript
77 lines
2.5 KiB
TypeScript
/**
|
|
* Programmatic uninstall entry point for the Cursor hive-mind hooks.
|
|
*
|
|
* Round-trip guarantee:
|
|
* - `created_by_us=false` (hooks.json pre-existed): restore the
|
|
* byte-identical backup the installer wrote; refuse to delete the
|
|
* backup unless the in-place readback matches.
|
|
* - `created_by_us=true` (we created hooks.json): delete the file we
|
|
* created — never orphan it, never leave a backup behind.
|
|
*
|
|
* Both branches are handled by the shared `restoreFromBackup` primitive.
|
|
*/
|
|
|
|
import { unlink } from 'node:fs/promises';
|
|
import { existsSync } from 'node:fs';
|
|
import { createLogger, type Logger } from '@waggle/hive-mind-shim-core';
|
|
import {
|
|
readPointer,
|
|
restoreFromBackup,
|
|
} from '@waggle/hive-mind-hooks-core';
|
|
import { resolvePaths, type CursorPaths, type ResolvePathsOptions } from './paths.js';
|
|
|
|
export interface UninstallResult {
|
|
paths: CursorPaths;
|
|
/** Backup restored from, or null when we deleted a file we created. */
|
|
restoredFrom: string | null;
|
|
/** True when created_by_us=true and we removed the config we created. */
|
|
createdRemoved: boolean;
|
|
pointerRemoved: boolean;
|
|
backupRemoved: boolean;
|
|
}
|
|
|
|
export interface UninstallOptions extends ResolvePathsOptions {
|
|
logger?: Logger;
|
|
/** If false, leaves the backup file in place after restore. Default true. */
|
|
cleanupBackup?: boolean;
|
|
}
|
|
|
|
export async function uninstall(opts: UninstallOptions = {}): Promise<UninstallResult> {
|
|
const log = opts.logger ?? createLogger({ name: 'cursor-hooks/uninstall' });
|
|
const paths = resolvePaths({
|
|
...(opts.home !== undefined ? { home: opts.home } : {}),
|
|
...(opts.hooksDir !== undefined ? { hooksDir: opts.hooksDir } : { moduleUrl: import.meta.url }),
|
|
});
|
|
const cleanup = opts.cleanupBackup ?? true;
|
|
|
|
if (!existsSync(paths.pointerPath)) {
|
|
throw new Error(
|
|
`no install pointer found at ${paths.pointerPath}. ` +
|
|
`Was @waggle/hive-mind-hooks-cursor ever installed for this user?`,
|
|
);
|
|
}
|
|
|
|
const pointer = await readPointer(paths.pointerPath);
|
|
const restore = await restoreFromBackup({
|
|
configPath: paths.configPath,
|
|
pointer,
|
|
cleanupBackup: cleanup,
|
|
});
|
|
|
|
if (restore.createdRemoved) {
|
|
log.info('cursor hooks.json removed (created by us)', { config: paths.configPath });
|
|
} else {
|
|
log.info('cursor hooks.json restored byte-identical', { config: paths.configPath });
|
|
}
|
|
|
|
await unlink(paths.pointerPath);
|
|
|
|
return {
|
|
paths,
|
|
restoredFrom: restore.restoredFrom,
|
|
createdRemoved: restore.createdRemoved,
|
|
pointerRemoved: true,
|
|
backupRemoved: restore.backupRemoved,
|
|
};
|
|
}
|