@aloth/olcli 0.15.3 → 0.16.1

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"}

package/dist/proxy.js

@@ -0,0 +1,189 @@
+/**
+ * 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';
+import * as tls from 'node:tls';
+import { isIP } from 'node:net';
+function envValue(env, name) {
+    const value = env[name.toLowerCase()] ?? env[name.toUpperCase()];
+    return value && value.trim() ? value.trim() : undefined;
+}
+/**
+ * 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 function isLoopbackHost(hostname) {
+    const host = hostname.replace(/^\[|\]$/g, '').replace(/\.$/, '').toLowerCase();
+    if (host === 'localhost' || host.endsWith('.localhost'))
+        return true;
+    if (isIP(host) === 4)
+        return host.split('.')[0] === '127';
+    if (isIP(host) === 6) {
+        if (host === '::1' || /^(0{1,4}:){7}0{0,3}1$/.test(host) || host === '0:0:0:0:0:0:0:1')
+            return true;
+        const mapped = host.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);
+        if (mapped)
+            return mapped[1].split('.')[0] === '127';
+        // WHATWG URL normalizes ::ffff:127.0.0.1 to ::ffff:7f00:1.
+        const mappedHex = host.match(/^::ffff:([0-9a-f]{1,4}):[0-9a-f]{1,4}$/);
+        if (mappedHex)
+            return (parseInt(mappedHex[1], 16) >> 8) === 127;
+    }
+    return false;
+}
+function defaultPort(protocol) {
+    return protocol === 'https:' ? 443 : 80;
+}
+/**
+ * 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 function bypassesProxy(target, env = process.env) {
+    const host = target.hostname.replace(/^\[|\]$/g, '').toLowerCase();
+    if (isLoopbackHost(host))
+        return true;
+    const noProxy = envValue(env, 'no_proxy');
+    if (!noProxy)
+        return false;
+    const port = Number(target.port || defaultPort(target.protocol));
+    for (const raw of noProxy.split(/[\s,]+/)) {
+        let entry = raw.trim().toLowerCase();
+        if (!entry)
+            continue;
+        if (entry === '*')
+            return true;
+        let entryPort;
+        const portMatch = entry.match(/^(.*):(\d+)$/);
+        if (portMatch && !portMatch[1].includes(':')) {
+            entry = portMatch[1];
+            entryPort = Number(portMatch[2]);
+        }
+        entry = entry.replace(/^\[|\]$/g, '').replace(/^\*?\./, '');
+        if (entryPort !== undefined && entryPort !== port)
+            continue;
+        if (host === entry || host.endsWith(`.${entry}`))
+            return true;
+    }
+    return false;
+}
+/** The proxy for `target`, or undefined when it should be reached directly. */
+export function proxyForUrl(target, env = process.env) {
+    const raw = target.protocol === 'https:'
+        ? envValue(env, 'https_proxy') ?? envValue(env, 'all_proxy')
+        : envValue(env, 'http_proxy') ?? envValue(env, 'all_proxy');
+    if (!raw || bypassesProxy(target, env))
+        return undefined;
+    try {
+        return new URL(raw.includes('://') ? raw : `http://${raw}`);
+    }
+    catch {
+        throw new Error(`Invalid proxy URL in the environment: ${raw}`);
+    }
+}
+function proxyAuthorization(proxy) {
+    if (!proxy.username && !proxy.password)
+        return undefined;
+    const credentials = `${decodeURIComponent(proxy.username)}:${decodeURIComponent(proxy.password)}`;
+    return `Basic ${Buffer.from(credentials).toString('base64')}`;
+}
+/**
+ * An https.Agent whose sockets are CONNECT tunnels through `proxy`. Node's
+ * Agent accepts an asynchronous createConnection that reports through the
+ * callback, which is what lets the tunnel be opened before TLS starts.
+ */
+class TunnelAgent extends https.Agent {
+    proxy;
+    constructor(proxy) {
+        super({ keepAlive: false });
+        this.proxy = proxy;
+    }
+    createConnection(options, callback) {
+        const host = String(options.host ?? options.hostname ?? 'localhost');
+        const port = Number(options.port ?? 443);
+        const authority = `${host.includes(':') ? `[${host}]` : host}:${port}`;
+        const transport = this.proxy.protocol === 'https:' ? https : http;
+        const headers = { Host: authority };
+        const auth = proxyAuthorization(this.proxy);
+        if (auth)
+            headers['Proxy-Authorization'] = auth;
+        const connect = transport.request({
+            host: this.proxy.hostname.replace(/^\[|\]$/g, ''),
+            port: Number(this.proxy.port || defaultPort(this.proxy.protocol)),
+            method: 'CONNECT',
+            path: authority,
+            headers,
+            agent: false,
+        });
+        connect.once('connect', (res, socket) => {
+            if (res.statusCode !== 200) {
+                socket.destroy();
+                callback(Object.assign(new Error(`Proxy ${this.proxy.host} refused CONNECT ${authority}: HTTP ${res.statusCode}`), { code: 'EPROXY' }));
+                return;
+            }
+            const secure = tls.connect({
+                socket,
+                servername: options.servername || (isIP(host) ? undefined : host),
+                rejectUnauthorized: options.rejectUnauthorized,
+                ca: options.ca,
+            });
+            secure.once('secureConnect', () => callback(null, secure));
+            secure.once('error', (error) => callback(error));
+        });
+        connect.once('error', (error) => callback(error));
+        connect.end();
+        return undefined;
+    }
+}
+const tunnelAgents = new Map();
+/**
+ * How to send a request to `reqUrl`, honoring the proxy variables in `env`.
+ * The headers passed in are extended, never replaced.
+ */
+export function routeRequest(reqUrl, headers, env = process.env) {
+    const target = new URL(reqUrl);
+    const direct = target.protocol === 'https:' ? https : http;
+    const proxy = proxyForUrl(target, env);
+    if (!proxy)
+        return { url: reqUrl, options: { headers }, transport: direct };
+    if (target.protocol === 'https:') {
+        let agent = tunnelAgents.get(proxy.href);
+        if (!agent) {
+            agent = new TunnelAgent(proxy);
+            tunnelAgents.set(proxy.href, agent);
+        }
+        return { url: reqUrl, options: { headers, agent }, transport: https, proxy };
+    }
+    // Plain HTTP: ask the proxy for the absolute URL.
+    const auth = proxyAuthorization(proxy);
+    return {
+        url: `${proxy.protocol}//${proxy.host}${proxy.pathname === '/' ? '' : proxy.pathname}`,
+        options: {
+            headers: { ...headers, Host: target.host, ...(auth ? { 'Proxy-Authorization': auth } : {}) },
+            path: target.href,
+            agent: false,
+        },
+        transport: proxy.protocol === 'https:' ? https : http,
+        proxy,
+    };
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

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

package/dist/remote-helper.d.ts

@@ -9,8 +9,9 @@
  *
  * Protocol reference: gitremote-helpers(7)
  *
- * Capabilities: import + export with refspec.
- * State stored in .git/overleaf/ (manifest).
+ * Capabilities: import + export with refspec, option (for push --force).
+ * State stored in .git/overleaf/ (manifest, marks, sha256 of every remote file).
+ * A push is refused while Overleaf has changes the clone has not fetched.
  */
 export {};
 //# sourceMappingURL=remote-helper.d.ts.map

package/dist/remote-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-helper.d.ts","sourceRoot":"","sources":["../src/remote-helper.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"remote-helper.d.ts","sourceRoot":"","sources":["../src/remote-helper.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}