@aloth/olcli 0.15.2 → 0.16.0

package/dist/move-plan.js

@@ -0,0 +1,168 @@
+/**
+ * Pure planning logic for `olcli rename|mv` and the MCP tool `rename_entity`.
+ *
+ * Overleaf has two separate endpoints: `rename` changes an entity's name and
+ * keeps its folder, `move` changes its folder and keeps its name. A request
+ * such as `mv sub/a.txt chapters/b.txt` therefore needs up to three kinds of
+ * writes: create missing folders, rename, move. Every check that can refuse
+ * the request runs here, over the project tree, before any of them is sent,
+ * so a refusal never leaves a half-done move behind. The same plan feeds the
+ * MCP confirmation dialog, which is why it lives apart from the client.
+ */
+/** A request that was refused before anything was written. */
+export class MoveRefusedError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'MoveRefusedError';
+    }
+}
+function join(folder, name) {
+    return folder ? `${folder}/${name}` : name;
+}
+function checkSegment(segment, whole) {
+    if (segment === '' || segment === '.' || segment === '..') {
+        throw new MoveRefusedError(`Invalid destination path: ${whole}`, 'invalid_path');
+    }
+}
+/**
+ * Split the destination as the user wrote it into folder and name.
+ *
+ * - no `/`: a new name in the current folder (plain rename)
+ * - ends in `/`: a folder; the name is kept (`/` alone is the project root)
+ * - otherwise: folder part and name; a leading `/` means the project root
+ */
+export function parseDestination(destination, currentFolder, currentName) {
+    if (!destination.includes('/')) {
+        checkSegment(destination, destination);
+        return { folder: currentFolder, name: destination };
+    }
+    const stripped = destination.replace(/^\/+/, '');
+    let folder;
+    let name;
+    if (stripped === '' || stripped.endsWith('/')) {
+        folder = stripped.replace(/\/+$/, '');
+        name = currentName;
+    }
+    else {
+        const cut = stripped.lastIndexOf('/');
+        folder = cut === -1 ? '' : stripped.slice(0, cut);
+        name = cut === -1 ? stripped : stripped.slice(cut + 1);
+        checkSegment(name, destination);
+    }
+    if (folder)
+        for (const segment of folder.split('/'))
+            checkSegment(segment, destination);
+    return { folder, name };
+}
+function indexTree(root) {
+    const entities = new Map();
+    const order = [];
+    const add = (entry) => {
+        entities.set(entry.path, entry);
+        order.push(entry);
+    };
+    const walk = (folder, path) => {
+        // Same order as OverleafClient.findEntityByPath: docs, files, folders.
+        for (const doc of folder.docs || [])
+            add({ id: doc._id, type: 'doc', name: doc.name, path: join(path, doc.name), parentPath: path });
+        for (const file of folder.fileRefs || [])
+            add({ id: file._id, type: 'file', name: file.name, path: join(path, file.name), parentPath: path });
+        for (const sub of folder.folders || []) {
+            const subPath = join(path, sub.name);
+            add({ id: sub._id, type: 'folder', name: sub.name, path: subPath, parentPath: path });
+            walk(sub, subPath);
+        }
+    };
+    walk(root, '');
+    return { entities, order };
+}
+/**
+ * Work out what `rename|mv <source> <destination>` does in a project tree,
+ * or throw MoveRefusedError. Reads only.
+ *
+ * The source is looked up by its full path; as before, a bare name also
+ * matches an entity of that name in any folder.
+ */
+export function planEntityMove(root, source, destination) {
+    const { entities, order } = indexTree(root);
+    const wanted = source.replace(/^\/+/, '').replace(/\/+$/, '');
+    let entity = wanted ? entities.get(wanted) : undefined;
+    if (!entity && wanted && !wanted.includes('/'))
+        entity = order.find(e => e.name === wanted);
+    if (!entity)
+        throw new MoveRefusedError(`File not found: ${source}`, 'not_found');
+    const folderId = (path) => {
+        if (path === '')
+            return root._id;
+        const found = entities.get(path);
+        return found?.type === 'folder' ? found.id : undefined;
+    };
+    const { folder: targetFolderPath, name: newName } = parseDestination(destination, entity.parentPath, entity.name);
+    const to = join(targetFolderPath, newName);
+    if (entity.type === 'folder' && (targetFolderPath === entity.path || targetFolderPath.startsWith(`${entity.path}/`))) {
+        const message = targetFolderPath === entity.path
+            ? `Cannot move folder ${entity.path} into itself`
+            : `Cannot move folder ${entity.path} into its own subfolder ${targetFolderPath}`;
+        throw new MoveRefusedError(message, 'into_itself');
+    }
+    // Walk the target folder path: existing folders are reused, the first
+    // missing segment and everything below it is created.
+    const knownFolders = { '': root._id };
+    const createFolders = [];
+    if (targetFolderPath) {
+        let prefix = '';
+        for (const segment of targetFolderPath.split('/')) {
+            prefix = join(prefix, segment);
+            if (createFolders.length > 0) {
+                createFolders.push(prefix);
+                continue;
+            }
+            const existing = entities.get(prefix);
+            if (!existing) {
+                createFolders.push(prefix);
+            }
+            else if (existing.type !== 'folder') {
+                throw new MoveRefusedError(`Cannot move into ${targetFolderPath}: ${prefix} is a ${existing.type}, not a folder`, 'not_a_folder');
+            }
+            else {
+                knownFolders[prefix] = existing.id;
+            }
+        }
+    }
+    const sourceFolderId = folderId(entity.parentPath);
+    const base = {
+        entity: { id: entity.id, type: entity.type, name: entity.name, path: entity.path },
+        from: entity.path,
+        to,
+        newName,
+        targetFolderPath,
+        targetFolderId: createFolders.length ? undefined : folderId(targetFolderPath),
+        sourceFolderPath: entity.parentPath,
+        sourceFolderId,
+        createFolders,
+        knownFolders,
+    };
+    if (to === entity.path) {
+        return { ...base, rename: false, move: false, noop: true, order: 'rename-then-move' };
+    }
+    if (entities.has(to)) {
+        throw new MoveRefusedError(`Destination already exists: ${to}`, 'exists');
+    }
+    const rename = newName !== entity.name;
+    const move = targetFolderPath !== entity.parentPath;
+    let planOrder = 'rename-then-move';
+    if (rename && move) {
+        // Overleaf refuses a name that is taken in the folder, so the step in
+        // between must not collide either.
+        const renameClash = entities.has(join(entity.parentPath, newName));
+        const moveClash = createFolders.length === 0 && entities.has(join(targetFolderPath, entity.name));
+        if (renameClash && moveClash) {
+            throw new MoveRefusedError(`Cannot move ${entity.path} to ${to} in one step: ${join(entity.parentPath, newName)} and ${join(targetFolderPath, entity.name)} both exist. Rename or move it through a free name first`, 'intermediate_clash');
+        }
+        planOrder = renameClash ? 'move-then-rename' : 'rename-then-move';
+    }
+    return { ...base, rename, move, noop: false, order: planOrder };
+}
+//# sourceMappingURL=move-plan.js.map

package/dist/move-plan.js.map

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

package/dist/paths.d.ts

@@ -37,4 +37,22 @@ export declare function normalizeRemotePath(path: string): string;
  *      'figures/diagram.png' still lands in the 'figures' folder.
  */
 export declare function resolveRemotePath(localPath: string, destination?: string): string;
+/**
+ * Old local name for a project title: everything outside [a-zA-Z0-9-_]
+ * became "_". Kept so that a directory created by olcli 0.15 or earlier can
+ * still be found; see `defaultProjectDir`.
+ */
+export declare function legacyLocalName(name: string): string;
+/**
+ * A project title as a local file or directory name.
+ *
+ * Letters, digits and symbols from any script are kept, including emoji, so
+ * "Masterarbeit Müller" stays readable instead of becoming
+ * "Masterarbeit_M_ller". Replaced with "_": whitespace (as before, so ASCII
+ * titles keep the names they had), characters that are unsafe in a path on
+ * any platform (/ \ : * ? " < > |) and control characters. Leading dots and
+ * trailing dots or spaces are dropped, Windows device names get a suffix, and
+ * the result is capped at 200 UTF-8 bytes without splitting a character.
+ */
+export declare function safeLocalName(name: string): string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAexD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBjF"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAexD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBjF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBlD"}

package/dist/paths.js

@@ -82,4 +82,49 @@ export function resolveRemotePath(localPath, destination) {
     }
     return normalized;
 }
+/**
+ * Old local name for a project title: everything outside [a-zA-Z0-9-_]
+ * became "_". Kept so that a directory created by olcli 0.15 or earlier can
+ * still be found; see `defaultProjectDir`.
+ */
+export function legacyLocalName(name) {
+    return name.replace(/[^a-zA-Z0-9-_]/g, '_');
+}
+const WINDOWS_RESERVED = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i;
+const MAX_NAME_BYTES = 200;
+/**
+ * A project title as a local file or directory name.
+ *
+ * Letters, digits and symbols from any script are kept, including emoji, so
+ * "Masterarbeit Müller" stays readable instead of becoming
+ * "Masterarbeit_M_ller". Replaced with "_": whitespace (as before, so ASCII
+ * titles keep the names they had), characters that are unsafe in a path on
+ * any platform (/ \ : * ? " < > |) and control characters. Leading dots and
+ * trailing dots or spaces are dropped, Windows device names get a suffix, and
+ * the result is capped at 200 UTF-8 bytes without splitting a character.
+ */
+export function safeLocalName(name) {
+    let out = name
+        .normalize('NFC')
+        .trim()
+        // Windows drops trailing dots and spaces, and a leading dot hides the
+        // directory on Unix; neither belongs to the title.
+        .replace(/^\.+/, '')
+        .replace(/[.\s]+$/, '')
+        // eslint-disable-next-line no-control-regex
+        .replace(/[\u0000-\u001f\u007f/\\:*?"<>|]/g, '_')
+        .replace(/\s/g, '_');
+    if (WINDOWS_RESERVED.test(out.split('.')[0]))
+        out = `${out}_`;
+    if (Buffer.byteLength(out) > MAX_NAME_BYTES) {
+        let cut = '';
+        for (const ch of out) {
+            if (Buffer.byteLength(cut + ch) > MAX_NAME_BYTES)
+                break;
+            cut += ch;
+        }
+        out = cut;
+    }
+    return out || 'project';
+}
 //# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,YAAoB;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAS;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,wEAAwE;YACxE,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,WAAoB;IACvE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE/E,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,YAAoB;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAS;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,wEAAwE;YACxE,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,WAAoB;IACvE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE/E,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,gBAAgB,GAAG,wCAAwC,CAAC;AAClE,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,GAAG,GAAG,IAAI;SACX,SAAS,CAAC,KAAK,CAAC;SAChB,IAAI,EAAE;QACP,sEAAsE;QACtE,mDAAmD;SAClD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,4CAA4C;SAC3C,OAAO,CAAC,kCAAkC,EAAE,GAAG,CAAC;SAChD,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAE9D,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,cAAc,EAAE,CAAC;QAC5C,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,cAAc;gBAAE,MAAM;YACxD,GAAG,IAAI,EAAE,CAAC;QACZ,CAAC;QACD,GAAG,GAAG,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,IAAI,SAAS,CAAC;AAC1B,CAAC"}

package/dist/project-match.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Find a project by what the user typed.
+ *
+ * Order, first hit wins:
+ *   1. exact name (case-sensitive), so two projects that differ only in case
+ *      can still be told apart
+ *   2. exact name, case-insensitive
+ *   3. a unique case-insensitive prefix
+ *
+ * Several projects sharing the name or the prefix is an error that lists
+ * them; nothing matching is an error that suggests the closest names. Both
+ * are typed so callers can exit non-zero without parsing the message.
+ */
+export interface NamedProject {
+    id: string;
+    name: string;
+}
+export declare class ProjectNotFoundError extends Error {
+    readonly query: string;
+    readonly suggestions: string[];
+    constructor(query: string, suggestions: string[]);
+}
+export declare class AmbiguousProjectError extends Error {
+    readonly query: string;
+    readonly candidates: NamedProject[];
+    constructor(query: string, candidates: NamedProject[]);
+}
+/** Levenshtein distance; names are short, so the quadratic table is fine. */
+export declare function editDistance(a: string, b: string): number;
+/**
+ * Up to `limit` project names closest to `query`: names containing it first,
+ * then by edit distance, dropping anything further than about half the query.
+ */
+export declare function suggestProjectNames(projects: NamedProject[], query: string, limit?: number): string[];
+/** Resolve `query` to one project or throw ProjectNotFoundError / AmbiguousProjectError. */
+export declare function matchProject<T extends NamedProject>(projects: T[], query: string): T;
+//# sourceMappingURL=project-match.d.ts.map

package/dist/project-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-match.d.ts","sourceRoot":"","sources":["../src/project-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEnB,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CASjD;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;gBAExB,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE;CAQtD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAYzD;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAiBhG;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAepF"}

package/dist/project-match.js

@@ -0,0 +1,97 @@
+/**
+ * Find a project by what the user typed.
+ *
+ * Order, first hit wins:
+ *   1. exact name (case-sensitive), so two projects that differ only in case
+ *      can still be told apart
+ *   2. exact name, case-insensitive
+ *   3. a unique case-insensitive prefix
+ *
+ * Several projects sharing the name or the prefix is an error that lists
+ * them; nothing matching is an error that suggests the closest names. Both
+ * are typed so callers can exit non-zero without parsing the message.
+ */
+export class ProjectNotFoundError extends Error {
+    query;
+    suggestions;
+    constructor(query, suggestions) {
+        const hint = suggestions.length > 0
+            ? `\nDid you mean: ${suggestions.map((s) => `"${s}"`).join(', ')}?`
+            : '\nList your projects with: olcli list';
+        super(`Project not found: ${query}${hint}`);
+        this.name = 'ProjectNotFoundError';
+        this.query = query;
+        this.suggestions = suggestions;
+    }
+}
+export class AmbiguousProjectError extends Error {
+    query;
+    candidates;
+    constructor(query, candidates) {
+        const shown = candidates.slice(0, 10).map((p) => `  ${p.name}  (${p.id})`);
+        if (candidates.length > 10)
+            shown.push(`  ... and ${candidates.length - 10} more`);
+        super(`"${query}" matches ${candidates.length} projects:\n${shown.join('\n')}\nUse the full name or the project ID.`);
+        this.name = 'AmbiguousProjectError';
+        this.query = query;
+        this.candidates = candidates;
+    }
+}
+/** Levenshtein distance; names are short, so the quadratic table is fine. */
+export function editDistance(a, b) {
+    const x = [...a];
+    const y = [...b];
+    let prev = Array.from({ length: y.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= x.length; i++) {
+        const row = [i];
+        for (let j = 1; j <= y.length; j++) {
+            row[j] = Math.min(prev[j] + 1, row[j - 1] + 1, prev[j - 1] + (x[i - 1] === y[j - 1] ? 0 : 1));
+        }
+        prev = row;
+    }
+    return prev[y.length];
+}
+const fold = (s) => s.normalize('NFC').toLocaleLowerCase();
+/**
+ * Up to `limit` project names closest to `query`: names containing it first,
+ * then by edit distance, dropping anything further than about half the query.
+ */
+export function suggestProjectNames(projects, query, limit = 3) {
+    const q = fold(query);
+    const maxDistance = Math.max(2, Math.ceil(q.length / 2));
+    const scored = projects.map((p) => {
+        const name = fold(p.name);
+        const contains = name.includes(q) || (name.length >= 3 && q.includes(name));
+        // Compare against the start of the name as well, so a short query for a
+        // long title is not dismissed for the length difference alone.
+        const distance = Math.min(editDistance(q, name), editDistance(q, name.slice(0, q.length)) + 1);
+        return { name: p.name, contains, distance };
+    });
+    return scored
+        .filter((s) => s.contains || s.distance <= maxDistance)
+        .sort((a, b) => Number(b.contains) - Number(a.contains) || a.distance - b.distance || a.name.localeCompare(b.name))
+        .map((s) => s.name)
+        .filter((name, index, all) => all.indexOf(name) === index)
+        .slice(0, limit);
+}
+/** Resolve `query` to one project or throw ProjectNotFoundError / AmbiguousProjectError. */
+export function matchProject(projects, query) {
+    const exact = projects.filter((p) => p.name === query);
+    if (exact.length === 1)
+        return exact[0];
+    if (exact.length > 1)
+        throw new AmbiguousProjectError(query, exact);
+    const q = fold(query);
+    const insensitive = projects.filter((p) => fold(p.name) === q);
+    if (insensitive.length === 1)
+        return insensitive[0];
+    if (insensitive.length > 1)
+        throw new AmbiguousProjectError(query, insensitive);
+    const prefixed = q ? projects.filter((p) => fold(p.name).startsWith(q)) : [];
+    if (prefixed.length === 1)
+        return prefixed[0];
+    if (prefixed.length > 1)
+        throw new AmbiguousProjectError(query, prefixed);
+    throw new ProjectNotFoundError(query, suggestProjectNames(projects, query));
+}
+//# sourceMappingURL=project-match.js.map

package/dist/project-match.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,52 @@
+/**
+ * HTTPS_PROXY, HTTP_PROXY and NO_PROXY for every request olcli makes.
+ *
+ * The client talks to Overleaf through node:http and node:https (see
+ * httpRequest in client.ts), and the collaboration socket is Socket.IO
+ * xhr-polling over the same function, so routing that one function through
+ * the proxy covers all traffic. Node's own env-proxy support only exists in
+ * recent releases and has to be switched on with NODE_USE_ENV_PROXY, and
+ * undici's EnvHttpProxyAgent only serves fetch(), so this is done here with
+ * no dependency:
+ *
+ * - an https:// target goes through a CONNECT tunnel, then TLS end to end,
+ *   so the proxy never sees the cookie;
+ * - an http:// target (self-hosted instances) is sent to the proxy with the
+ *   absolute URL as the request target, as HTTP/1.1 proxies expect.
+ *
+ * Lower-case variable names win over upper-case ones, as in curl.
+ */
+import * as http from 'node:http';
+import * as https from 'node:https';
+/**
+ * True for localhost (and its subdomains), 127.0.0.0/8, ::1 and the
+ * IPv4-mapped ::ffff:127.x addresses. Brackets around IPv6 are accepted.
+ */
+export declare function isLoopbackHost(hostname: string): boolean;
+/**
+ * True when NO_PROXY exempts `target`. Entries are comma or space separated:
+ * `*` matches everything, `example.com` and `.example.com` match the host and
+ * its subdomains, `host:port` matches only that port, and an IP matches
+ * itself. Loopback (localhost, 127.0.0.0/8, ::1) is always reached
+ * directly, whatever NO_PROXY says: a proxy cannot reach this machine's
+ * loopback interface, and the browser sign-in talks to a local browser.
+ */
+export declare function bypassesProxy(target: URL, env?: NodeJS.ProcessEnv): boolean;
+/** The proxy for `target`, or undefined when it should be reached directly. */
+export declare function proxyForUrl(target: URL, env?: NodeJS.ProcessEnv): URL | undefined;
+export interface ProxiedRequest {
+    /** What to pass to http(s).request as the URL. */
+    url: string;
+    /** Extra request options (agent, headers) for the proxy. */
+    options: http.RequestOptions;
+    /** The transport module to call request() on. */
+    transport: typeof http | typeof https;
+    /** The proxy in use, for --verbose; undefined for a direct request. */
+    proxy?: URL;
+}
+/**
+ * How to send a request to `reqUrl`, honoring the proxy variables in `env`.
+ * The headers passed in are extended, never replaced.
+ */
+export declare function routeRequest(reqUrl: string, headers: Record<string, string>, env?: NodeJS.ProcessEnv): ProxiedRequest;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAUpC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAaxD;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAwBxF;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,GAAG,GAAG,SAAS,CAU9F;AAgED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC;IAC7B,iDAAiD;IACjD,SAAS,EAAE,OAAO,IAAI,GAAG,OAAO,KAAK,CAAC;IACtC,uEAAuE;IACvE,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,cAAc,CA2BhB"}