@ontemper/sdk 0.3.5 → 0.4.0

package/dist/Sftp.d.ts

@@ -0,0 +1,82 @@
+import { Context, Effect, Layer, Redacted, Schema, type Scope } from 'effect';
+import { type SftpEntry, type SftpFileType, type SftpStats, type SftpTransport } from './SftpTransport.js';
+export type { SftpChannel, SftpEntry, SftpFileType, SftpStats, SftpTransferOptions, SftpTransport, SftpTransportOptions, } from './SftpTransport.js';
+declare const SftpError_base: Schema.Class<SftpError, Schema.TaggedStruct<"SftpError", {
+    readonly host: Schema.String;
+    readonly operation: Schema.String;
+    readonly path: Schema.optional<Schema.String>;
+    readonly message: Schema.String;
+    readonly cause: Schema.optional<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+/** An SFTP operation failed; its `SFTP <operation> failed.` line carries the cause. */
+export declare class SftpError extends SftpError_base {
+}
+declare const SftpHostKeyError_base: Schema.Class<SftpHostKeyError, Schema.TaggedStruct<"SftpHostKeyError", {
+    readonly host: Schema.String;
+    /** The OpenSSH `SHA256:` fingerprint the server offered, when it offered one. */
+    readonly offered: Schema.optional<Schema.String>;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The connection was refused before any credential left: no pins, an unreadable pin, or an unpinned host key. */
+export declare class SftpHostKeyError extends SftpHostKeyError_base {
+}
+export interface SftpConnectOptions {
+    readonly host: string;
+    /** Default 22. */
+    readonly port?: number | undefined;
+    readonly username: string;
+    readonly password?: Redacted.Redacted<string> | undefined;
+    /** PEM or OpenSSH text; literal `\\n` sequences from one-line variables become newlines. */
+    readonly privateKey?: Redacted.Redacted<string> | undefined;
+    readonly passphrase?: Redacted.Redacted<string> | undefined;
+    /**
+     * Accepted server host keys as OpenSSH `SHA256:<base64>` fingerprints (`ssh-keygen -lf`). Required:
+     * with none, or with a key not in the list, the connection fails before authentication.
+     */
+    readonly hostKeyFingerprints: ReadonlyArray<string>;
+    /** SSH handshake timeout in milliseconds. Default 20000. */
+    readonly readyTimeoutMs?: number | undefined;
+    /** Bytes per pipelined request, 32 KiB to 1 MiB. Default 32 KiB. */
+    readonly chunkBytes?: number | undefined;
+    /** Pipelined requests in flight per transfer, 1 to 64. Default 16. */
+    readonly concurrency?: number | undefined;
+    /** Largest file `get` buffers in memory. Default 256 MiB; use `download` for larger files. */
+    readonly maxBufferBytes?: number | undefined;
+}
+/** One connected SFTP mailbox. Paths are remote unless the name says `local`. */
+export interface SftpSession {
+    readonly host: string;
+    readonly list: (path: string) => Effect.Effect<ReadonlyArray<SftpEntry>, SftpError>;
+    readonly stat: (path: string) => Effect.Effect<SftpStats, SftpError>;
+    /** The entry's type without following a link, or `false` when nothing exists at the path. */
+    readonly exists: (path: string) => Effect.Effect<false | SftpFileType, SftpError>;
+    /** Reads the whole file into memory with pipelined requests. */
+    readonly get: (path: string) => Effect.Effect<Buffer, SftpError>;
+    /** Replaces the file with `data` using pipelined requests. */
+    readonly put: (data: Uint8Array, path: string) => Effect.Effect<void, SftpError>;
+    /** Streams the remote file to a local file with pipelined requests, never holding it in memory. */
+    readonly download: (path: string, localPath: string) => Effect.Effect<void, SftpError>;
+    /** Streams a local file to the remote path with pipelined requests. */
+    readonly upload: (localPath: string, path: string) => Effect.Effect<void, SftpError>;
+    readonly rename: (from: string, to: string) => Effect.Effect<void, SftpError>;
+    readonly remove: (path: string) => Effect.Effect<void, SftpError>;
+    readonly mkdir: (path: string) => Effect.Effect<void, SftpError>;
+}
+export interface SftpConnector {
+    /**
+     * Connects for the life of the enclosing scope: closing the scope, including on the Run deadline or an
+     * interrupt, closes the connection and logs `SFTP close`.
+     */
+    readonly connect: (options: SftpConnectOptions) => Effect.Effect<SftpSession, SftpError | SftpHostKeyError, Scope.Scope>;
+}
+/** The OpenSSH `SHA256:` fingerprint of a raw public host key, without base64 padding. */
+export declare const hostKeyFingerprint: (key: Uint8Array) => string;
+declare const Sftp_base: Context.ServiceClass<Sftp, "@temper/workflow/Sftp", SftpConnector>;
+/** First-party SFTP: `yield* Sftp`, then `connect` inside the Run's scope. */
+export declare class Sftp extends Sftp_base {
+    /** SFTP over `ssh2`. */
+    static readonly layer: Layer.Layer<Sftp, never, never>;
+    /** The same client over another transport, such as `memorySftp` from `@temper/workflow/sftp/testing`. */
+    static readonly layerWith: (transport: SftpTransport) => Layer.Layer<Sftp, never, never>;
+}
+//# sourceMappingURL=Sftp.d.ts.map

package/dist/Sftp.d.ts.map

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

package/dist/Sftp.js

@@ -0,0 +1,127 @@
+import { createHash } from 'node:crypto';
+import { Context, Effect, Layer, Redacted, Schema } from 'effect';
+import { withSpanLines } from './LogContext.js';
+import { registerSecrets } from './Redaction.js';
+import { ssh2Transport, } from './SftpTransport.js';
+/** An SFTP operation failed; its `SFTP <operation> failed.` line carries the cause. */
+export class SftpError extends Schema.TaggedError()('SftpError', {
+    host: Schema.String,
+    operation: Schema.String,
+    path: Schema.optional(Schema.String),
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+}) {
+}
+/** The connection was refused before any credential left: no pins, an unreadable pin, or an unpinned host key. */
+export class SftpHostKeyError extends Schema.TaggedError()('SftpHostKeyError', {
+    host: Schema.String,
+    /** The OpenSSH `SHA256:` fingerprint the server offered, when it offered one. */
+    offered: Schema.optional(Schema.String),
+    message: Schema.String,
+}) {
+}
+const DEFAULTS = { port: 22, readyTimeoutMs: 20_000, chunkBytes: 32 * 1024, concurrency: 16 };
+const DEFAULT_MAX_BUFFER_BYTES = 256 * 1024 * 1024;
+const FINGERPRINT = /^SHA256:[A-Za-z0-9+/]{43}$/;
+/** The OpenSSH `SHA256:` fingerprint of a raw public host key, without base64 padding. */
+export const hostKeyFingerprint = (key) => `SHA256:${createHash('sha256').update(key).digest('base64').replace(/=+$/u, '')}`;
+const inRange = (value, fallback, minimum, maximum) => value === undefined || (Number.isInteger(value) && value >= minimum && value <= maximum)
+    ? (value ?? fallback)
+    : undefined;
+/** `SFTP <operation>` lines on the SDK logger and one tracer span; failures carry the raw cause as `err`. */
+const traced = (host, operation, fields = () => ({})) => (effect) => effect.pipe(withSpanLines(`SFTP ${operation}`, (outcome) => ({ type: 'sftp', sftp: { host, operation, ...fields(outcome) } }), {
+    err: ({ error }) => (error instanceof SftpError && error.cause instanceof Error ? error.cause : undefined),
+}), Effect.withSpan(`SFTP ${operation}`, { attributes: { 'sftp.host': host, 'sftp.operation': operation } }));
+const attempt = (host, operation, path, run) => Effect.tryPromise({
+    try: run,
+    catch: (cause) => new SftpError({
+        host,
+        operation,
+        path,
+        message: `SFTP ${operation}${path === undefined ? '' : ` ${path}`} failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+        cause,
+    }),
+});
+const sessionOf = (host, channel, transfer, maxBytes) => {
+    const run = (operation, path, go, fields = () => ({})) => attempt(host, operation, path, go).pipe(traced(host, operation, (outcome) => ({ path, ...fields(outcome) })));
+    return {
+        host,
+        list: (path) => run('list', path, () => channel.list(path), (outcome) => ({ files: outcome?.result?.map((entry) => entry.name) })),
+        stat: (path) => run('stat', path, () => channel.stat(path)),
+        exists: (path) => run('exists', path, async () => (await channel.lstat(path))?.type ?? false, (outcome) => ({ exists: outcome?.result })),
+        // File contents never reach a log line: only the byte count does.
+        get: (path) => run('get', path, () => channel.read(path, { ...transfer, maxBytes }), (outcome) => ({ bytes: outcome?.result?.length })),
+        put: (data, path) => run('put', path, () => channel.write(path, data, transfer), () => ({ bytes: data.byteLength })),
+        download: (path, localPath) => run('download', path, () => channel.download(path, localPath, transfer)),
+        upload: (localPath, path) => run('upload', path, () => channel.upload(localPath, path, transfer)),
+        rename: (from, to) => run('rename', from, () => channel.rename(from, to), () => ({ destinationPath: to })),
+        remove: (path) => run('remove', path, () => channel.remove(path)),
+        mkdir: (path) => run('mkdir', path, () => channel.mkdir(path)),
+    };
+};
+const makeSftp = (transport) => ({
+    connect: (options) => {
+        const { host } = options;
+        const refuse = (message, offered) => new SftpHostKeyError({ host, offered, message });
+        const pins = new Set(options.hostKeyFingerprints.map((pin) => pin.trim().replace(/=+$/u, '')));
+        const privateKey = options.privateKey && Redacted.value(options.privateKey).split('\\n').join('\n');
+        const secrets = [options.password, options.privateKey, options.passphrase].flatMap((secret) => secret === undefined ? [] : [Redacted.value(secret)]);
+        const port = options.port ?? DEFAULTS.port;
+        const chunkBytes = inRange(options.chunkBytes, DEFAULTS.chunkBytes, 32 * 1024, 1024 * 1024);
+        const concurrency = inRange(options.concurrency, DEFAULTS.concurrency, 1, 64);
+        const maxBytes = options.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;
+        let offered;
+        const open = Effect.gen(function* () {
+            offered = undefined;
+            if (pins.size === 0)
+                return yield* refuse('SFTP host-key pinning is required: set hostKeyFingerprints.');
+            const malformed = [...pins].find((pin) => !FINGERPRINT.test(pin));
+            if (malformed !== undefined)
+                return yield* refuse(`Host-key pin ${malformed} is not an OpenSSH SHA256 fingerprint.`);
+            if (chunkBytes === undefined || concurrency === undefined || !Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+                return yield* new SftpError({ host, operation: 'connect', message: 'SFTP transfer options are out of range.' });
+            }
+            return yield* Effect.tryPromise({
+                try: (signal) => transport.connect({
+                    host,
+                    port,
+                    username: options.username,
+                    password: options.password && Redacted.value(options.password),
+                    privateKey,
+                    passphrase: options.passphrase && Redacted.value(options.passphrase),
+                    readyTimeoutMs: options.readyTimeoutMs ?? DEFAULTS.readyTimeoutMs,
+                    verifyHostKey: (key) => {
+                        const fingerprint = hostKeyFingerprint(key);
+                        if (pins.has(fingerprint))
+                            return true;
+                        offered = fingerprint;
+                        return false;
+                    },
+                }, signal),
+                catch: (cause) => offered === undefined
+                    ? new SftpError({
+                        host,
+                        operation: 'connect',
+                        message: `SFTP connect failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+                        cause,
+                    })
+                    : refuse(`SFTP server ${host} offered untrusted host-key fingerprint ${offered}.`, offered),
+            }).pipe(Effect.map((channel) => ({ channel, chunkBytes, concurrency })));
+        }).pipe(traced(host, 'connect'));
+        const close = (channel) => Effect.promise(() => channel.end()).pipe(withSpanLines('SFTP close', { type: 'sftp', sftp: { host, operation: 'close' } }));
+        return Effect.gen(function* () {
+            yield* registerSecrets([...secrets, ...(privateKey === undefined ? [] : [privateKey])]);
+            // The connect attempt stays interruptible; once it succeeds, its close is registered before anything else runs.
+            const opened = yield* Effect.uninterruptibleMask((restore) => Effect.tap(restore(open), ({ channel }) => Effect.addFinalizer(() => close(channel))));
+            return sessionOf(host, opened.channel, opened, maxBytes);
+        });
+    },
+});
+/** First-party SFTP: `yield* Sftp`, then `connect` inside the Run's scope. */
+export class Sftp extends Context.Service()('@temper/workflow/Sftp') {
+    /** SFTP over `ssh2`. */
+    static layer = Layer.succeed(Sftp, makeSftp(ssh2Transport));
+    /** The same client over another transport, such as `memorySftp` from `@temper/workflow/sftp/testing`. */
+    static layerWith = (transport) => Layer.succeed(Sftp, makeSftp(transport));
+}
+//# sourceMappingURL=Sftp.js.map

package/dist/Sftp.js.map

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

package/dist/SftpTesting.d.ts

@@ -0,0 +1,28 @@
+import type { Layer } from 'effect';
+import { Sftp } from './Sftp.js';
+import type { SftpTransport, SftpTransportOptions } from './SftpTransport.js';
+export interface MemorySftpOptions {
+    /** Host name → path → bytes; the test reads and seeds them directly. A host that is absent refuses the connection. */
+    readonly hosts: Record<string, Map<string, Buffer>>;
+    /** Every file's modification time, epoch milliseconds. Default 0. */
+    readonly modifyTime?: number;
+    /** The host key every memory host presents. Pin `MemorySftp.fingerprint`. */
+    readonly hostKey?: Uint8Array;
+}
+export interface MemorySftp {
+    /** Provide in place of `Sftp.layer`. */
+    readonly layer: Layer.Layer<Sftp>;
+    readonly transport: SftpTransport;
+    /** The OpenSSH fingerprint of the presented host key. */
+    readonly fingerprint: string;
+    /** Every connection the client completed, in order, with the options it sent. */
+    readonly connections: Array<Omit<SftpTransportOptions, 'verifyHostKey'>>;
+    /** Connections not yet closed. */
+    readonly open: () => number;
+}
+/**
+ * An in-memory SFTP transport for workflow tests: the SDK client runs unchanged on top of it, so host-key
+ * pinning, span lines, redaction, and scope release behave as in production. Directories are implicit.
+ */
+export declare const memorySftp: (options: MemorySftpOptions) => MemorySftp;
+//# sourceMappingURL=SftpTesting.d.ts.map

package/dist/SftpTesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SftpTesting.d.ts","sourceRoot":"","sources":["../src/SftpTesting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAqC,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEjH,MAAM,WAAW,iBAAiB;IAChC,sHAAsH;IACtH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC,CAAC;IACzE,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC;CAC7B;AAKD;;;GAGG;AACH,eAAO,MAAM,UAAU,YAAa,iBAAiB,KAAG,UA8EvD,CAAC"}

package/dist/SftpTesting.js

@@ -0,0 +1,91 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { Sftp, hostKeyFingerprint } from './Sftp.js';
+const notFound = (operation, path) => Object.assign(new Error(`${operation}: No such file ${path}`), { code: 2 });
+/**
+ * An in-memory SFTP transport for workflow tests: the SDK client runs unchanged on top of it, so host-key
+ * pinning, span lines, redaction, and scope release behave as in production. Directories are implicit.
+ */
+export const memorySftp = (options) => {
+    const hostKey = options.hostKey ?? Buffer.from('temper-memory-sftp-host-key');
+    const connections = [];
+    let open = 0;
+    const statsOf = (data) => ({
+        type: '-',
+        size: data.length,
+        modifyTime: options.modifyTime ?? 0,
+        accessTime: options.modifyTime ?? 0,
+    });
+    const transport = {
+        connect: async ({ verifyHostKey, ...sent }) => {
+            const files = options.hosts[sent.host];
+            if (files === undefined)
+                throw Object.assign(new Error(`getaddrinfo ENOTFOUND ${sent.host}`), { code: 'ENOTFOUND' });
+            if (!verifyHostKey(hostKey))
+                throw new Error('Handshake failed: host key verification failed');
+            connections.push(sent);
+            open++;
+            let ended = false;
+            const file = (operation, path) => {
+                const found = files.get(path);
+                if (found === undefined)
+                    throw notFound(operation, path);
+                return found;
+            };
+            const channel = {
+                list: async (dir) => {
+                    const prefix = dir.endsWith('/') ? dir : `${dir}/`;
+                    return [...files.entries()]
+                        .filter(([path]) => path.startsWith(prefix) && !path.slice(prefix.length).includes('/'))
+                        .map(([path, entry]) => ({ name: path.slice(prefix.length), ...statsOf(entry) }));
+                },
+                stat: async (path) => statsOf(file('stat', path)),
+                lstat: async (path) => {
+                    const found = files.get(path);
+                    return found === undefined ? undefined : statsOf(found);
+                },
+                read: async (path, { maxBytes }) => {
+                    const data = file('get', path);
+                    if (data.length > maxBytes)
+                        throw new RangeError(`${path} has ${data.length} bytes; get buffers at most ${maxBytes}.`);
+                    return Buffer.from(data);
+                },
+                write: async (path, data) => {
+                    files.set(path, Buffer.from(data));
+                },
+                download: async (path, localPath) => {
+                    await writeFile(localPath, file('download', path));
+                },
+                upload: async (localPath, path) => {
+                    files.set(path, await readFile(localPath));
+                },
+                rename: async (from, to) => {
+                    const moved = file('rename', from);
+                    if (files.has(to))
+                        throw Object.assign(new Error(`rename: ${to} exists`), { code: 4 });
+                    files.delete(from);
+                    files.set(to, moved);
+                },
+                remove: async (path) => {
+                    file('remove', path);
+                    files.delete(path);
+                },
+                mkdir: async () => undefined,
+                end: async () => {
+                    if (ended)
+                        return;
+                    ended = true;
+                    open--;
+                },
+            };
+            return channel;
+        },
+    };
+    return {
+        layer: Sftp.layerWith(transport),
+        transport,
+        fingerprint: hostKeyFingerprint(hostKey),
+        connections,
+        open: () => open,
+    };
+};
+//# sourceMappingURL=SftpTesting.js.map

package/dist/SftpTesting.js.map

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

package/dist/SftpTransport.d.ts

@@ -0,0 +1,55 @@
+/** `d` directory, `-` regular file, `l` symbolic link, `?` anything else; the `ls -l` letters. */
+export type SftpFileType = 'd' | '-' | 'l' | '?';
+export interface SftpStats {
+    readonly type: SftpFileType;
+    readonly size: number;
+    /** Epoch milliseconds. */
+    readonly modifyTime: number;
+    /** Epoch milliseconds. */
+    readonly accessTime: number;
+}
+export interface SftpEntry extends SftpStats {
+    readonly name: string;
+}
+/** How one pipelined transfer splits a file: request size and requests in flight. */
+export interface SftpTransferOptions {
+    readonly chunkBytes: number;
+    readonly concurrency: number;
+}
+/** What a transport receives to open one SSH connection with one SFTP channel. */
+export interface SftpTransportOptions {
+    readonly host: string;
+    readonly port: number;
+    readonly username: string;
+    readonly password: string | undefined;
+    readonly privateKey: string | undefined;
+    readonly passphrase: string | undefined;
+    readonly readyTimeoutMs: number;
+    /** Decides on the server's raw public host key before any credential is sent; `false` aborts. */
+    readonly verifyHostKey: (key: Uint8Array) => boolean;
+}
+/** One open SFTP channel. Every path is remote unless the name says `local`. */
+export interface SftpChannel {
+    readonly list: (path: string) => Promise<ReadonlyArray<SftpEntry>>;
+    readonly stat: (path: string) => Promise<SftpStats>;
+    /** `undefined` when nothing exists at the path; a link is reported as a link. */
+    readonly lstat: (path: string) => Promise<SftpStats | undefined>;
+    readonly read: (path: string, options: SftpTransferOptions & {
+        readonly maxBytes: number;
+    }) => Promise<Buffer>;
+    readonly write: (path: string, data: Uint8Array, options: SftpTransferOptions) => Promise<void>;
+    readonly download: (path: string, localPath: string, options: SftpTransferOptions) => Promise<void>;
+    readonly upload: (localPath: string, path: string, options: SftpTransferOptions) => Promise<void>;
+    readonly rename: (from: string, to: string) => Promise<void>;
+    readonly remove: (path: string) => Promise<void>;
+    readonly mkdir: (path: string) => Promise<void>;
+    /** Closes the connection; resolves once the socket closed or the close timed out. */
+    readonly end: () => Promise<void>;
+}
+/** Opens SFTP channels; `signal` aborts a connection attempt that has not finished. */
+export interface SftpTransport {
+    readonly connect: (options: SftpTransportOptions, signal: AbortSignal) => Promise<SftpChannel>;
+}
+/** SFTP over `ssh2`: one SSH connection and one SFTP channel per `connect`. */
+export declare const ssh2Transport: SftpTransport;
+//# sourceMappingURL=SftpTransport.d.ts.map

package/dist/SftpTransport.d.ts.map

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

package/dist/SftpTransport.js

@@ -0,0 +1,183 @@
+import { Client } from 'ssh2';
+const NO_SUCH_FILE = 2;
+const EOF = 1;
+const CLOSE_TIMEOUT_MS = 1_000;
+const typeOf = (mode) => {
+    switch (mode & 0o170000) {
+        case 0o040000:
+            return 'd';
+        case 0o100000:
+            return '-';
+        case 0o120000:
+            return 'l';
+        default:
+            return '?';
+    }
+};
+const statsOf = (stats) => ({
+    type: typeOf(stats.mode),
+    size: stats.size,
+    modifyTime: stats.mtime * 1000,
+    accessTime: stats.atime * 1000,
+});
+/** ssh2 puts the SFTP status code of a failed request on the error. */
+const hasStatus = (error, status) => error !== null && error !== undefined && 'code' in error && error.code === status;
+const call = (start) => new Promise((resolve, reject) => start((error, value) => (error ? reject(error) : resolve(value))));
+const settle = (start) => new Promise((resolve, reject) => start((error) => (error ? reject(error) : resolve(undefined))));
+/** Runs `work` for every index with at most `concurrency` in flight; the first failure rejects. */
+const pool = async (count, concurrency, work) => {
+    let next = 0;
+    const worker = async () => {
+        while (next < count)
+            await work(next++);
+    };
+    await Promise.all(Array.from({ length: Math.min(concurrency, count) }, worker));
+};
+const readAt = (sftp, handle, target, offset, length) => new Promise((resolve, reject) => sftp.read(handle, target, offset, length, offset, (error, bytesRead) => {
+    if (error && !hasStatus(error, EOF))
+        reject(error);
+    else
+        resolve(error ? 0 : bytesRead);
+}));
+/** Fills `target[start, end)` from the same file offsets; a short read asks again for the rest. */
+const readRange = async (sftp, handle, target, start, end) => {
+    for (let offset = start; offset < end;) {
+        const bytes = await readAt(sftp, handle, target, offset, end - offset);
+        if (bytes === 0)
+            throw new Error(`SFTP read ended at byte ${offset} of ${target.length}: the file shrank.`);
+        offset += bytes;
+    }
+};
+/**
+ * Pipelined read: `concurrency` chunk requests in flight on one channel, each written to its own offset,
+ * then sequential reads past the reported size until EOF, so a file that grew is never cut short.
+ */
+const readFile = async (sftp, path, options) => {
+    const handle = await call((done) => sftp.open(path, 'r', done));
+    try {
+        const { size } = await call((done) => sftp.fstat(handle, done));
+        if (size > options.maxBytes)
+            throw new RangeError(`${path} has ${size} bytes; get buffers at most ${options.maxBytes}.`);
+        const head = Buffer.alloc(size);
+        const chunks = Math.ceil(size / options.chunkBytes);
+        await pool(chunks, options.concurrency, (index) => readRange(sftp, handle, head, index * options.chunkBytes, Math.min(size, (index + 1) * options.chunkBytes)));
+        const tail = [];
+        for (let offset = size;;) {
+            const chunk = Buffer.alloc(options.chunkBytes);
+            const bytes = await new Promise((resolve, reject) => sftp.read(handle, chunk, 0, chunk.length, offset, (error, read) => {
+                if (error && !hasStatus(error, EOF))
+                    reject(error);
+                else
+                    resolve(error ? 0 : read);
+            }));
+            if (bytes === 0)
+                break;
+            offset += bytes;
+            if (offset > options.maxBytes)
+                throw new RangeError(`${path} grew past ${options.maxBytes} bytes during get.`);
+            tail.push(chunk.subarray(0, bytes));
+        }
+        return tail.length === 0 ? head : Buffer.concat([head, ...tail]);
+    }
+    finally {
+        await settle((done) => sftp.close(handle, done)).catch(() => undefined);
+    }
+};
+/** Pipelined write: the file is truncated, then `concurrency` chunk writes stay in flight at their offsets. */
+const writeFile = async (sftp, path, data, options) => {
+    const handle = await call((done) => sftp.open(path, 'w', done));
+    let closed = false;
+    try {
+        const bytes = Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+        const chunks = Math.ceil(bytes.length / options.chunkBytes);
+        await pool(chunks, options.concurrency, (index) => {
+            const offset = index * options.chunkBytes;
+            const length = Math.min(options.chunkBytes, bytes.length - offset);
+            return settle((done) => sftp.write(handle, bytes, offset, length, offset, done));
+        });
+        closed = true;
+        // The server may report a failed flush only on close, so a failed close fails the write.
+        await settle((done) => sftp.close(handle, done));
+    }
+    finally {
+        if (!closed)
+            await settle((done) => sftp.close(handle, done)).catch(() => undefined);
+    }
+};
+const channelOf = (client, sftp) => {
+    let closed = false;
+    client.once('close', () => {
+        closed = true;
+    });
+    return {
+        list: async (path) => (await call((done) => sftp.readdir(path, done)))
+            .filter((entry) => entry.filename !== '.' && entry.filename !== '..')
+            .map((entry) => ({ name: entry.filename, ...statsOf(entry.attrs) })),
+        stat: async (path) => statsOf(await call((done) => sftp.stat(path, done))),
+        lstat: (path) => new Promise((resolve, reject) => sftp.lstat(path, (error, stats) => {
+            if (!error)
+                resolve(statsOf(stats));
+            else if (hasStatus(error, NO_SUCH_FILE))
+                resolve(undefined);
+            else
+                reject(error);
+        })),
+        read: (path, options) => readFile(sftp, path, options),
+        write: (path, data, options) => writeFile(sftp, path, data, options),
+        download: (path, localPath, { chunkBytes, concurrency }) => settle((done) => sftp.fastGet(path, localPath, { chunkSize: chunkBytes, concurrency }, done)),
+        upload: (localPath, path, { chunkBytes, concurrency }) => settle((done) => sftp.fastPut(localPath, path, { chunkSize: chunkBytes, concurrency }, done)),
+        rename: (from, to) => settle((done) => sftp.rename(from, to, done)),
+        remove: (path) => settle((done) => sftp.unlink(path, done)),
+        mkdir: (path) => settle((done) => sftp.mkdir(path, done)),
+        end: () => new Promise((resolve) => {
+            if (closed)
+                return resolve();
+            const timer = setTimeout(() => {
+                client.destroy();
+                resolve();
+            }, CLOSE_TIMEOUT_MS);
+            client.once('close', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            client.end();
+        }),
+    };
+};
+/** SFTP over `ssh2`: one SSH connection and one SFTP channel per `connect`. */
+export const ssh2Transport = {
+    connect: (options, signal) => new Promise((resolve, reject) => {
+        const client = new Client();
+        const fail = (error) => {
+            signal.removeEventListener('abort', abort);
+            client.destroy();
+            reject(error);
+        };
+        const abort = () => fail(new Error('SFTP connect cancelled.', { cause: signal.reason }));
+        if (signal.aborted)
+            return abort();
+        signal.addEventListener('abort', abort, { once: true });
+        client.once('error', fail);
+        client.once('ready', () => client.sftp((error, sftp) => {
+            if (error)
+                return fail(error);
+            signal.removeEventListener('abort', abort);
+            client.removeListener('error', fail);
+            // A later socket error surfaces on the pending SFTP request; unhandled, it would crash the process.
+            client.on('error', () => undefined);
+            resolve(channelOf(client, sftp));
+        }));
+        client.connect({
+            host: options.host,
+            port: options.port,
+            username: options.username,
+            password: options.password,
+            privateKey: options.privateKey,
+            passphrase: options.passphrase,
+            readyTimeout: options.readyTimeoutMs,
+            ident: 'temper',
+            hostVerifier: (key) => options.verifyHostKey(key),
+        });
+    }),
+};
+//# sourceMappingURL=SftpTransport.js.map

package/dist/SftpTransport.js.map

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