transloadit 4.0.5 → 4.0.7

package/CHANGELOG.md

@@ -2,22 +2,34 @@
 
 You may also want to refer to [GitHub releases](https://github.com/transloadit/node-sdk/releases).
 
-## v4.0.4
+## v4.0.7
+
+Released: 2025-11-26.
+
+[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.6...v4.0.7).
+
+- [x] Update schemas to match the latest API changes.
+
+## v4.0.6
+
+Released: 2025-11-04.
+
+[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.5...v4.0.6).
+
+- [x] Re-export `AssemblyInstructions` and `AssemblyInstructionsInput` at the package entry to match the migration guide and TypeScript examples.
+
+## v4.0.5
 
 Released: 2025-10-16.
 
-[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.2...v4.0.3).
+[Diff](https://github.com/transloadit/node-sdk/compare/v4.0.1...v4.0.5).
 
-- [x] Fix `smart_sig` CLI to always override embedded credentials with the env-provided auth key while preserving other auth fields.
-- [x] Switch `smart_sig` CLI to return Smart CDN URLs via `getSignedSmartCDNUrl`, making it suitable as the cross-SDK reference implementation.
+- [x] Add `smart_sig` CLI to return Smart CDN URLs via `getSignedSmartCDNUrl`, making it suitable as the cross-SDK reference implementation.
 - [x] Add `sig` CLI command for generating request signatures, including an `--algorithm` flag for choosing the HMAC digest.
 - [x] Ensure the CLI entrypoint executes when invoked through npm/yarn bin shims by resolving symlinks before bootstrapping.
 - [x] Harden validation and tests around CLI invocation paths.
-- [x] Add `smart_sig` CLI command (usable via `npx transloadit smart_sig`) for signing params fed through stdin.
-- [x] Document the CLI workflow and expose the binary via package metadata.
-- [x] Validate CLI input with existing zod schemas and cover the flow with unit tests.
 
-v4.0.2 and v4.0.3 were broken releases
+v4.0.2, v4.0.3, and v4.0.4 were broken releases
 
 ## v4.0.1
 

package/dist/alphalib/lib/nativeGlobby.d.ts

@@ -0,0 +1,14 @@
+type PatternInput = string | readonly string[];
+export interface NativeGlobbyOptions {
+    cwd?: string;
+    absolute?: boolean;
+    onlyFiles?: boolean;
+    ignore?: readonly string[];
+}
+type GlobbyLike = {
+    (patterns: PatternInput, options?: NativeGlobbyOptions): Promise<string[]>;
+    sync(patterns: PatternInput, options?: NativeGlobbyOptions): string[];
+};
+export declare const nativeGlobby: GlobbyLike;
+export {};
+//# sourceMappingURL=nativeGlobby.d.ts.map

package/dist/alphalib/lib/nativeGlobby.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeGlobby.d.ts","sourceRoot":"","sources":["../../../src/alphalib/lib/nativeGlobby.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;AAG9C,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B;AAwKD,KAAK,UAAU,GAAG;IAChB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1E,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAAA;CACtE,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,UAyD1B,CAAA"}

package/dist/alphalib/lib/nativeGlobby.js

@@ -0,0 +1,181 @@
+import * as fs from 'node:fs';
+import { glob as fsGlob, stat as statAsync } from 'node:fs/promises';
+import path from 'node:path';
+const { globSync: fsGlobSync } = fs;
+const normalizeSlashes = (value) => value.replace(/\\/g, '/');
+const toAbsolutePath = (rawPath, cwd) => {
+    if (path.isAbsolute(rawPath)) {
+        return rawPath;
+    }
+    if (cwd) {
+        return path.join(cwd, rawPath);
+    }
+    return path.resolve(rawPath);
+};
+const normalizeOptions = (options = {}) => ({
+    cwd: options.cwd ? path.resolve(options.cwd) : undefined,
+    absolute: options.absolute ?? false,
+    onlyFiles: options.onlyFiles ?? true,
+    ignore: options.ignore && options.ignore.length > 0 ? options.ignore : undefined,
+});
+const hasGlobMagic = (pattern) => /[*?[\]{}()!]/.test(pattern);
+const expandPatternAsync = async (pattern, options) => {
+    if (hasGlobMagic(pattern)) {
+        return [pattern];
+    }
+    try {
+        const absolute = toAbsolutePath(pattern, options.cwd);
+        const stats = await statAsync(absolute);
+        if (stats.isDirectory()) {
+            const expanded = normalizeSlashes(path.join(pattern, '**/*'));
+            return [expanded];
+        }
+    }
+    catch {
+        // ignore missing paths; fall back to original pattern
+    }
+    return [pattern];
+};
+const expandPatternSync = (pattern, options) => {
+    if (hasGlobMagic(pattern)) {
+        return [pattern];
+    }
+    try {
+        const absolute = toAbsolutePath(pattern, options.cwd);
+        const stats = fs.statSync(absolute);
+        if (stats.isDirectory()) {
+            const expanded = normalizeSlashes(path.join(pattern, '**/*'));
+            return [expanded];
+        }
+    }
+    catch {
+        // ignore missing paths; fall back to original pattern
+    }
+    return [pattern];
+};
+const splitPatterns = (patterns) => {
+    const list = Array.isArray(patterns) ? patterns : [patterns];
+    const positive = [];
+    const negative = [];
+    for (const pattern of list) {
+        if (pattern.startsWith('!')) {
+            const negated = pattern.slice(1);
+            if (negated) {
+                negative.push(negated);
+            }
+        }
+        else {
+            positive.push(pattern);
+        }
+    }
+    return { positive, negative };
+};
+const toGlobOptions = (options) => {
+    const globOptions = { withFileTypes: false };
+    if (options.cwd) {
+        globOptions.cwd = options.cwd;
+    }
+    if (options.ignore) {
+        // Node's glob implementation uses `exclude` for ignore patterns
+        globOptions.exclude = options.ignore;
+    }
+    return globOptions;
+};
+const filterFilesAsync = async (candidates, requireFiles) => {
+    if (!requireFiles) {
+        return candidates;
+    }
+    const filtered = await Promise.all(candidates.map(async (candidate) => {
+        try {
+            const stats = await statAsync(candidate.absolutePath);
+            return stats.isFile() ? candidate : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    return filtered.filter(Boolean);
+};
+const filterFilesSync = (candidates, requireFiles) => {
+    if (!requireFiles) {
+        return candidates;
+    }
+    const filtered = [];
+    for (const candidate of candidates) {
+        try {
+            const stats = fs.statSync(candidate.absolutePath);
+            if (stats.isFile()) {
+                filtered.push(candidate);
+            }
+        }
+        catch {
+            // Ignore files that cannot be stat'ed
+        }
+    }
+    return filtered;
+};
+const formatResult = (candidate, options) => {
+    const output = options.absolute ? candidate.absolutePath : candidate.rawPath;
+    return normalizeSlashes(output);
+};
+const collectMatchesAsync = async (pattern, options) => {
+    const matches = [];
+    for await (const match of fsGlob(pattern, toGlobOptions(options))) {
+        matches.push({
+            rawPath: match,
+            absolutePath: toAbsolutePath(match, options.cwd),
+        });
+    }
+    const filtered = await filterFilesAsync(matches, options.onlyFiles);
+    return filtered.map((candidate) => formatResult(candidate, options));
+};
+const collectMatchesSync = (pattern, options) => {
+    const matches = fsGlobSync(pattern, toGlobOptions(options)).map((match) => ({
+        rawPath: match,
+        absolutePath: toAbsolutePath(match, options.cwd),
+    }));
+    const filtered = filterFilesSync(matches, options.onlyFiles);
+    return filtered.map((candidate) => formatResult(candidate, options));
+};
+export const nativeGlobby = Object.assign(async (patterns, options) => {
+    const normalized = normalizeOptions(options);
+    const { positive, negative } = splitPatterns(patterns);
+    const expandedPositives = (await Promise.all(positive.map((pattern) => expandPatternAsync(pattern, normalized)))).flat();
+    const expandedNegatives = (await Promise.all(negative.map((pattern) => expandPatternAsync(pattern, normalized)))).flat();
+    const results = new Set();
+    for (const pattern of expandedPositives) {
+        const matches = await collectMatchesAsync(pattern, normalized);
+        for (const match of matches) {
+            results.add(match);
+        }
+    }
+    for (const pattern of expandedNegatives) {
+        const matches = await collectMatchesAsync(pattern, normalized);
+        for (const match of matches) {
+            results.delete(match);
+        }
+    }
+    return Array.from(results);
+}, {
+    sync(patterns, options) {
+        const normalized = normalizeOptions(options);
+        const { positive, negative } = splitPatterns(patterns);
+        const expandedPositives = positive.flatMap((pattern) => expandPatternSync(pattern, normalized));
+        const expandedNegatives = negative.flatMap((pattern) => expandPatternSync(pattern, normalized));
+        const results = new Set();
+        for (const pattern of expandedPositives) {
+            const matches = collectMatchesSync(pattern, normalized);
+            for (const match of matches) {
+                results.add(match);
+            }
+        }
+        for (const pattern of expandedNegatives) {
+            const matches = collectMatchesSync(pattern, normalized);
+            for (const match of matches) {
+                results.delete(match);
+            }
+        }
+        return Array.from(results);
+    },
+});
+//# sourceMappingURL=nativeGlobby.js.map

package/dist/alphalib/lib/nativeGlobby.js.map

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

package/dist/alphalib/mcache.d.ts

@@ -0,0 +1,65 @@
+import type { SevLogger } from '@transloadit/sev-logger';
+import type { Schema } from 'zod';
+export interface McacheOpts<T> {
+    ttlMs?: number;
+    zodSchema?: Schema;
+    logger?: SevLogger;
+    /**
+     * Maximum number of entries in the cache. When exceeded, oldest entries are removed.
+     * Defaults to 10,000 entries.
+     */
+    maxSize?: number;
+    /**
+     * Custom key generator function. If not provided, uses JSON.stringify.
+     */
+    keyFn?: (...args: unknown[]) => string;
+}
+/**
+ * Memory cache abstraction to help cache function results in-process.
+ *
+ * Example:
+ *
+ *   const cache = new Mcache<Instance[]>({ ttlMs: 1000 * 60 * 10 })
+ *
+ *   async function fetchInstances(region: string): Promise<Instance[]> {
+ *     return cache.get(region, async () => {
+ *       // Do work, e.g. fetch instances from AWS
+ *       return await this._fetchInstances(region)
+ *     })
+ *   }
+ */
+export declare class Mcache<T> {
+    #private;
+    constructor(opts?: McacheOpts<T>);
+    /**
+     * Get a value from cache, or compute it using the provided function.
+     * The cache key is generated from the args using JSON.stringify by default,
+     * or using the custom keyFn if provided.
+     */
+    get(producer: () => Promise<T> | T, ...args: unknown[]): Promise<T>;
+    /**
+     * Set a value in the cache directly.
+     */
+    set(value: T, ...args: unknown[]): void;
+    /**
+     * Check if a key exists in cache and is not expired.
+     */
+    has(...args: unknown[]): boolean;
+    /**
+     * Clear all entries from the cache.
+     */
+    clear(): void;
+    /**
+     * Delete a specific entry from the cache.
+     */
+    delete(...args: unknown[]): boolean;
+    /**
+     * Get the current size of the cache.
+     */
+    get size(): number;
+    /**
+     * Clean up expired entries and enforce size limit.
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=mcache.d.ts.map

package/dist/alphalib/mcache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcache.d.ts","sourceRoot":"","sources":["../../src/alphalib/mcache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAEjC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAA;CACvC;AAOD;;;;;;;;;;;;;GAaG;AACH,qBAAa,MAAM,CAAC,CAAC;;gBAKP,IAAI,GAAE,UAAU,CAAC,CAAC,CAAM;IAWpC;;;;OAIG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BzE;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAWvC;;OAEG;IACH,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO;IAiBhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO;IAKnC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI;CAqChB"}

package/dist/alphalib/mcache.js

@@ -0,0 +1,135 @@
+/**
+ * Memory cache abstraction to help cache function results in-process.
+ *
+ * Example:
+ *
+ *   const cache = new Mcache<Instance[]>({ ttlMs: 1000 * 60 * 10 })
+ *
+ *   async function fetchInstances(region: string): Promise<Instance[]> {
+ *     return cache.get(region, async () => {
+ *       // Do work, e.g. fetch instances from AWS
+ *       return await this._fetchInstances(region)
+ *     })
+ *   }
+ */
+export class Mcache {
+    #cache;
+    #opts;
+    constructor(opts = {}) {
+        this.#cache = new Map();
+        this.#opts = {
+            ttlMs: opts.ttlMs ?? Number.POSITIVE_INFINITY,
+            maxSize: opts.maxSize ?? 10_000,
+            zodSchema: opts.zodSchema,
+            logger: opts.logger,
+            keyFn: opts.keyFn,
+        };
+    }
+    /**
+     * Get a value from cache, or compute it using the provided function.
+     * The cache key is generated from the args using JSON.stringify by default,
+     * or using the custom keyFn if provided.
+     */
+    async get(producer, ...args) {
+        const key = this.#opts.keyFn ? this.#opts.keyFn(...args) : JSON.stringify(args);
+        const cached = this.#cache.get(key);
+        if (cached) {
+            const age = Date.now() - cached.timestamp;
+            if (age <= this.#opts.ttlMs || this.#opts.ttlMs === Number.POSITIVE_INFINITY) {
+                this.#opts.logger?.debug(`Cache hit for key ${key} (age: ${age}ms)`);
+                return cached.value;
+            }
+            this.#opts.logger?.debug(`Cache expired for key ${key} (age: ${age}ms > ${this.#opts.ttlMs}ms)`);
+            this.#cache.delete(key);
+        }
+        this.#opts.logger?.debug(`Cache miss for key ${key}, computing value`);
+        const value = await producer();
+        // Validate if schema provided
+        if (this.#opts.zodSchema) {
+            this.#opts.zodSchema.parse(value);
+        }
+        this.#set(key, value);
+        return value;
+    }
+    /**
+     * Set a value in the cache directly.
+     */
+    set(value, ...args) {
+        const key = this.#opts.keyFn ? this.#opts.keyFn(...args) : JSON.stringify(args);
+        // Validate if schema provided
+        if (this.#opts.zodSchema) {
+            this.#opts.zodSchema.parse(value);
+        }
+        this.#set(key, value);
+    }
+    /**
+     * Check if a key exists in cache and is not expired.
+     */
+    has(...args) {
+        const key = this.#opts.keyFn ? this.#opts.keyFn(...args) : JSON.stringify(args);
+        const cached = this.#cache.get(key);
+        if (!cached) {
+            return false;
+        }
+        const age = Date.now() - cached.timestamp;
+        if (age > this.#opts.ttlMs && this.#opts.ttlMs !== Number.POSITIVE_INFINITY) {
+            this.#cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Clear all entries from the cache.
+     */
+    clear() {
+        this.#cache.clear();
+    }
+    /**
+     * Delete a specific entry from the cache.
+     */
+    delete(...args) {
+        const key = this.#opts.keyFn ? this.#opts.keyFn(...args) : JSON.stringify(args);
+        return this.#cache.delete(key);
+    }
+    /**
+     * Get the current size of the cache.
+     */
+    get size() {
+        return this.#cache.size;
+    }
+    /**
+     * Clean up expired entries and enforce size limit.
+     */
+    cleanup() {
+        const now = Date.now();
+        // Remove expired entries
+        if (this.#opts.ttlMs !== Number.POSITIVE_INFINITY) {
+            for (const [key, entry] of this.#cache.entries()) {
+                if (now - entry.timestamp > this.#opts.ttlMs) {
+                    this.#cache.delete(key);
+                }
+            }
+        }
+        // Enforce size limit by removing oldest entries
+        if (this.#cache.size > this.#opts.maxSize) {
+            const entries = Array.from(this.#cache.entries());
+            entries.sort((a, b) => a[1].timestamp - b[1].timestamp);
+            const toRemove = entries.slice(0, this.#cache.size - this.#opts.maxSize);
+            for (const [key] of toRemove) {
+                this.#cache.delete(key);
+            }
+            this.#opts.logger?.debug(`Cache size limit reached, removed ${toRemove.length} oldest entries`);
+        }
+    }
+    #set(key, value) {
+        this.#cache.set(key, {
+            value,
+            timestamp: Date.now(),
+        });
+        // Trigger cleanup if we're over size limit
+        if (this.#cache.size > this.#opts.maxSize) {
+            this.cleanup();
+        }
+    }
+}
+//# sourceMappingURL=mcache.js.map

package/dist/alphalib/mcache.js.map

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