@ontemper/sdk 0.3.6 → 0.4.1

package/dist/EdiModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdiModel.js","sourceRoot":"","sources":["../src/EdiModel.ts"],"names":[],"mappings":""}

package/dist/Manifest.d.ts

@@ -1,6 +1,6 @@
 import { HttpApi, type HttpApiGroup } from 'effect/unstable/httpapi';
 import { type WorkflowManifest } from './Contract/Manifest.js';
-export declare const SDK_VERSION = "0.3.6";
+export declare const SDK_VERSION = "0.4.1";
 export declare const RUNTIME_API_VERSION = 1;
 /** The route the SDK serves for platform probes; an API declaring `GET` on it collides with it on every request. */
 export declare const HEALTHCHECK_PATH = "/healthcheck";

package/dist/Manifest.js

@@ -5,7 +5,7 @@ import { declarationOf } from './Resource.js';
 import { Trigger } from './Trigger.js';
 const decodeTrigger = Schema.decodeUnknownSync(TriggerMetadata, { onExcessProperty: 'error' });
 const identityOf = (resource) => `${resource.kind}:${resource.kind === 'resourceType' ? resource.type : resource.key}`;
-export const SDK_VERSION = '0.3.6';
+export const SDK_VERSION = '0.4.1';
 export const RUNTIME_API_VERSION = 1;
 /** The route the SDK serves for platform probes; an API declaring `GET` on it collides with it on every request. */
 export const HEALTHCHECK_PATH = '/healthcheck';

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":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG9E,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EAEd,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;;;;;;;;AAE5B,uFAAuF;AACvF,qBAAa,SAAU,SAAQ,cAM7B;CAAG;;;IAKH,iFAAiF;;;;AAHnF,kHAAkH;AAClH,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;AAEL,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1D,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IACpF,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrE,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,YAAY,EAAE,SAAS,CAAC,CAAC;IAClF,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjE,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjF,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvF,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrF,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAClE,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,kBAAkB,KACxB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,GAAG,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CAC5E;AAMD,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,QAAS,UAAU,KAAG,MAC8B,CAAC;;AA4KpF,8EAA8E;AAC9E,qBAAa,IAAK,SAAQ,SAA+D;IACvF,wBAAwB;IACxB,MAAM,CAAC,QAAQ,CAAC,KAAK,kCAAgD;IACrE,yGAAyG;IACzG,MAAM,CAAC,QAAQ,CAAC,SAAS,cAAe,aAAa,qCAA8C;CACpG"}

package/dist/Sftp.js

@@ -0,0 +1,135 @@
+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;
+/** Names logged per listing; a longer list would push the line past the logger's size cap and lose its fields. */
+const LISTED_NAMES = 100;
+const listed = (entries) => {
+    if (entries === undefined)
+        return {};
+    const files = entries.slice(0, LISTED_NAMES).map((entry) => entry.name);
+    return entries.length > LISTED_NAMES ? { files, fileCount: entries.length } : { files };
+};
+/** `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) => listed(outcome?.result)),
+        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 = Object.hasOwn(options.hosts, sent.host) ? options.hosts[sent.host] : undefined;
+            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":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAwBrD,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAE,IAAY,EAAE,EAAE,CACnD,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,SAAS,kBAAkB,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAA0B,EAAc,EAAE;IACnE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9E,MAAM,WAAW,GAA8B,EAAE,CAAC;IAClD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,CAAC,IAAY,EAAa,EAAE,CAAC,CAAC;QAC5C,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,IAAI,CAAC,MAAM;QACjB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;KACpC,CAAC,CAAC;IACH,MAAM,SAAS,GAAkB;QAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7F,IAAI,KAAK,KAAK,SAAS;gBACrB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAC9F,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC/F,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,EAAE,CAAC;YACP,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAE,IAAY,EAAE,EAAE;gBAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC9B,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACzD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;YACF,MAAM,OAAO,GAAgB;gBAC3B,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;oBAClB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;oBACnD,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;yBACxB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;yBACvF,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;gBACjG,CAAC;gBACD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACjD,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBACpB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC9B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1D,CAAC;gBACD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;oBACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;oBAC/B,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ;wBACxB,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,QAAQ,IAAI,CAAC,MAAM,+BAA+B,QAAQ,GAAG,CAAC,CAAC;oBAC7F,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;gBACD,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;oBAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACrC,CAAC;gBACD,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;oBAClC,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;gBACrD,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;oBAChC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC7C,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;oBACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBACnC,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;wBAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;oBACvF,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACnB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBACvB,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBACrB,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBACrB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBACD,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;gBAC5B,GAAG,EAAE,KAAK,IAAI,EAAE;oBACd,IAAI,KAAK;wBAAE,OAAO;oBAClB,KAAK,GAAG,IAAI,CAAC;oBACb,IAAI,EAAE,CAAC;gBACT,CAAC;aACF,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;IACF,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QAChC,SAAS;QACT,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC;QACxC,WAAW;QACX,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC,CAAC"}

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