transloadit 4.12.0 → 4.13.0

package/dist/cli/storageReceipts.js

@@ -0,0 +1,242 @@
+import { randomUUID } from 'node:crypto';
+import { chmod, lstat, open, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { z } from 'zod';
+import { storedAssetSchema } from "../alphalib/types/storageAsset.js";
+import { normalizeStoragePublicPrefix } from "../storagePublicPrefixes.js";
+import { ensureError, isErrnoException } from "./types.js";
+// Keep every JSON key verbatim: a Storage filename may be "__proto__", which z.record strips.
+const receiptsSchema = z.custom((value) => typeof value === 'object' && value !== null && !Array.isArray(value));
+const deliveryParameterSchema = z.union([z.string(), z.number(), z.boolean()]);
+/** Project identity and rendering metadata (including optional preview pixels), without credentials. */
+export const storageCatalogSchema = z
+    .object({
+    workspace: z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/),
+    apiOrigin: z.string().url().optional(),
+    public: z.array(z.string().refine((prefix) => {
+        try {
+            return normalizeStoragePublicPrefix(prefix) === prefix;
+        }
+        catch {
+            return false;
+        }
+    }, 'Expected a normalized public directory')),
+    images: receiptsSchema,
+    delivery: z
+        .object({
+        baseUrl: z.string().url().optional(),
+        urlParams: z
+            .record(z.string(), z.union([deliveryParameterSchema, z.array(deliveryParameterSchema)]))
+            .optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+/** Default project catalog; --receipts can select a separate project explicitly. */
+export const defaultStorageCatalog = 'transloadit.images.json';
+/** Non-production login origins are explicit transport overrides, never rendering credentials. */
+export function storageCatalogDelivery(endpoint) {
+    if (!endpoint)
+        return undefined;
+    const { origin } = new URL(endpoint);
+    if (origin === 'https://api2.transloadit.com')
+        return undefined;
+    return { baseUrl: `${origin}/file/{workspace}`, urlParams: { cdn: 'required' } };
+}
+const imageReceiptSchema = storedAssetSchema.extend({
+    width: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+    height: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+});
+const typesHeader = '// Generated by transloadit storage. Commit this file with the image catalog; do not edit.';
+/** The single conventional type-registration file beside a CLI catalog. */
+export function storageTypesPath(catalog) {
+    return join(dirname(catalog), 'transloadit-images.d.ts');
+}
+function catalogTypes(catalog, file) {
+    // Canonical LF keeps generated output deterministic; Git controls checkout-specific EOL conversion.
+    const properties = Object.entries(catalog.images)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .flatMap(([path, receipt]) => {
+        const dimensions = imageReceiptSchema.safeParse(receipt);
+        // Legacy entries remain on disk, but require native recovery before they are usable sources.
+        if (!dimensions.success)
+            return [];
+        const { width, height, asset_id, version_id, workspace } = dimensions.data;
+        const name = JSON.stringify(path);
+        return `    ${name}: { path: ${name}; workspace: ${JSON.stringify(workspace)}; asset_id: ${JSON.stringify(asset_id)}; version_id: ${JSON.stringify(version_id)}; width: ${width}; height: ${height}; thumbhash?: string; hasAlpha?: boolean }`;
+    });
+    return [
+        typesHeader,
+        ...(file === undefined ? [] : [`// Catalog: ${JSON.stringify(basename(file))}`]),
+        "import '@transloadit/viewer/next'",
+        '',
+        "declare module '@transloadit/viewer/next' {",
+        '  interface RegisteredStorageImages {',
+        ...properties,
+        '  }',
+        '}',
+        '',
+    ].join('\n');
+}
+async function readReceipts(file) {
+    try {
+        const info = await lstat(file);
+        if (!info.isFile())
+            throw new Error('Expected a regular JSON file, not a symlink or directory');
+        return {
+            catalog: storageCatalogSchema.parse(JSON.parse(await readFile(file, 'utf8'))),
+            mode: info.mode & 0o777,
+        };
+    }
+    catch (error) {
+        if (isErrnoException(error) && error.code === 'ENOENT')
+            return {};
+        const reason = error instanceof SyntaxError
+            ? 'invalid JSON'
+            : error instanceof z.ZodError
+                ? `invalid catalog field ${error.issues[0]?.path.join('.') || 'workspace/public/images'}`
+                : ensureError(error).message;
+        throw new Error(`Cannot read receipts ${JSON.stringify(file)}: ${reason}`, { cause: error });
+    }
+}
+/** Read a project binding without creating a catalog or making a network request. */
+export async function readStorageCatalog(file) {
+    return (await readReceipts(file)).catalog;
+}
+/** A workspace override selects another workspace, never another key or implicit project rebinding. */
+export function assertStorageWorkspace(actual, project, requested) {
+    if (!storageCatalogSchema.shape.workspace.safeParse(actual).success)
+        throw new Error(`Invalid Storage Workspace ${JSON.stringify(actual)}: expected a URL-safe slug beginning with a letter or digit.`);
+    if (requested !== undefined && requested !== actual)
+        throw new Error(`Selected credentials belong to ${actual}, not ${requested}. Nothing uploaded.`);
+    if (project !== undefined && project !== actual && requested === undefined)
+        throw new Error(`Project uses ${project}; the selected credentials belong to ${actual}. Nothing uploaded.`);
+}
+const receiptOriginSchema = z.object({ apiOrigin: z.string().url().optional() });
+/** Delivery hosts do not prove provenance; a matching Workspace slug is not an API identity. */
+export function assertStorageCatalogOrigin(catalog, endpoint, file) {
+    const mismatch = () => new Error(`Catalog ${JSON.stringify(file)} belongs to another API environment. Use --receipts for a separate catalog; the existing file was preserved.`);
+    if (catalog?.apiOrigin !== undefined && new URL(catalog.apiOrigin).origin !== endpoint)
+        throw mismatch();
+    if (catalog !== undefined &&
+        catalog.apiOrigin === undefined &&
+        Object.keys(catalog.images).length === 0 &&
+        (catalog.public.length > 0 || catalog.delivery !== undefined))
+        throw new Error(`Catalog ${JSON.stringify(file)} has no verified API origin. Run storage receipts sync into a new --receipts file using the original API --endpoint, then review and replace this catalog. The existing file was preserved.`);
+    for (const [path, value] of Object.entries(catalog?.images ?? {})) {
+        const previous = receiptOriginSchema.safeParse(value);
+        if (!previous.success ||
+            (previous.data.apiOrigin === undefined && catalog?.apiOrigin === undefined))
+            throw new Error(`Catalog ${JSON.stringify(file)} has no verified API origin for ${JSON.stringify(path)}. Run storage receipts sync into a new --receipts file using the original API --endpoint, then review and replace this catalog. The existing file was preserved.`);
+        if (previous.data.apiOrigin !== undefined &&
+            new URL(previous.data.apiOrigin).origin !== endpoint)
+            throw mismatch();
+    }
+}
+/**
+ * Serializes CLI receipt writers and replaces a catalog only after the complete update succeeds.
+ * onCheckpoint observes a completed rename even if interruption or cleanup subsequently fails.
+ */
+export async function updateStorageReceipts(file, update, onCheckpoint) {
+    const lockPath = `${file}.lock`;
+    const temporary = join(dirname(file), `.${basename(file)}.${randomUUID()}.tmp`);
+    const typesFile = storageTypesPath(file);
+    if (basename(file) === 'transloadit-images.d.ts')
+        throw new Error('The catalog cannot use the generated declarations filename transloadit-images.d.ts');
+    const typesTemporary = `${temporary}.d.ts`;
+    const cancellation = new AbortController();
+    const cancel = () => cancellation.abort(new Error('Storage command canceled. Check Storage before retrying a write.'));
+    // The first interrupt is cooperative; a forced exit/crash still leaves a lock for inspection.
+    process.once('SIGINT', cancel);
+    process.once('SIGTERM', cancel);
+    let lock;
+    let typesLock;
+    let retainTemporary = false;
+    try {
+        lock = await open(lockPath, 'wx', 0o600).catch((error) => {
+            if (isErrnoException(error) && error.code === 'EEXIST') {
+                throw new Error(`The receipts file is locked by another storage store or receipts sync. Remove ${lockPath} only after confirming no writer is running.`, { cause: error });
+            }
+            throw error;
+        });
+        cancellation.signal.throwIfAborted();
+        // Different catalog filenames still share one ambient type-registration file.
+        typesLock = await open(`${typesFile}.lock`, 'wx', 0o600).catch((error) => {
+            throw new Error(`Generated declarations are locked: ${typesFile}. Wait for the other catalog writer.`, { cause: error });
+        });
+        const { catalog, mode } = await readReceipts(file);
+        const typesInfo = await lstat(typesFile).catch((error) => {
+            if (isErrnoException(error) && error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        });
+        if (typesInfo !== undefined && !typesInfo.isFile())
+            throw new Error(`Expected a regular generated types file: ${typesFile}`);
+        if (typesInfo !== undefined &&
+            (await readFile(typesFile, 'utf8')).split(/\r?\n/, 1)[0] !== typesHeader)
+            throw new Error(`Refusing to overwrite handwritten declarations in ${typesFile}. Move them to a separate file before retrying.`);
+        if (typesInfo !== undefined) {
+            const existing = (await readFile(typesFile, 'utf8')).replaceAll('\r\n', '\n');
+            const owner = existing.split('\n')[1];
+            const expectedOwner = `// Catalog: ${JSON.stringify(basename(file))}`;
+            // Upgrade older generated files only when they exactly describe this existing catalog.
+            if (owner !== expectedOwner && !(catalog !== undefined && existing === catalogTypes(catalog)))
+                throw new Error(`Generated declarations in ${typesFile} belong to ${owner?.startsWith('// Catalog: ') ? owner.slice(12) : 'another catalog'}. Use --receipts in a separate directory; the active catalog was preserved.`);
+        }
+        const updated = await update(catalog, cancellation.signal);
+        // An explicit one-off workspace override must not mix two workspaces in one catalog.
+        if (updated === undefined) {
+            cancellation.signal.throwIfAborted();
+            return;
+        }
+        if (!storageCatalogSchema.safeParse(updated).success)
+            throw new Error('Cannot write an invalid Storage catalog; check its Workspace, public prefixes and delivery configuration.');
+        // Once a remote write returned a receipt, finish its atomic checkpoint even if interrupted.
+        // New catalogs are ordinary source files: let the kernel apply umask, without reading it.
+        await writeFile(temporary, `${JSON.stringify(updated, null, 2)}\n`, {
+            flag: 'wx',
+            mode: mode === undefined ? 0o666 : 0o600,
+        });
+        retainTemporary = true;
+        if (mode !== undefined)
+            await chmod(temporary, mode);
+        await writeFile(typesTemporary, catalogTypes(updated, file), { flag: 'wx', mode: 0o666 });
+        if (typesInfo !== undefined)
+            await chmod(typesTemporary, typesInfo.mode & 0o777);
+        await rename(temporary, file);
+        retainTemporary = false;
+        onCheckpoint?.();
+        // The catalog is the authoritative checkpoint. A failure replacing derived types must
+        // never discard a verified upload; sync can regenerate declarations without another write.
+        await rename(typesTemporary, typesFile).catch((error) => {
+            throw new Error(`Catalog saved, but cannot update ${typesFile}. Run storage receipts sync to regenerate types without re-uploading.`, { cause: error });
+        });
+        cancellation.signal.throwIfAborted();
+    }
+    catch (error) {
+        if (retainTemporary)
+            throw new Error(`${ensureError(error).message}\nComplete catalog retained at ${JSON.stringify(temporary)}.`, { cause: error });
+        throw error;
+    }
+    finally {
+        try {
+            if (typesLock !== undefined) {
+                await typesLock.close();
+                await rm(`${typesFile}.lock`, { force: true });
+            }
+            if (lock !== undefined) {
+                await lock.close();
+                await rm(lockPath, { force: true });
+                if (!retainTemporary)
+                    await rm(temporary, { force: true });
+                await rm(typesTemporary, { force: true });
+            }
+        }
+        finally {
+            process.off('SIGINT', cancel);
+            process.off('SIGTERM', cancel);
+        }
+    }
+}
+//# sourceMappingURL=storageReceipts.js.map

package/dist/cli/storageReceipts.js.map

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

package/dist/cli/storageSnippets.d.ts

@@ -0,0 +1,11 @@
+/** Locate ordinary Next.js app directories without assuming the consumer's source layout. */
+export declare function nextAppRoot(): '' | 'src/' | undefined;
+/** Advice only: never execute or rewrite a consumer's Next config after a successful upload. */
+export declare function storageImageConfigAdvice(): Promise<string>;
+/** Private redirect delivery needs an application authorizer and key, not the CLI login key. */
+export declare function storageImagePrivateAdvice(path: string, receipts?: string): string;
+/** An empty-safe scaffold showing the first receipt in the initialized directory. */
+export declare function storageImagePage(receiptsImport: string, prefix: string, receipts?: string): string;
+/** Rendering-only variable names; values belong in the application's secret configuration. */
+export declare function storageImageEnvBlock(publicOnly: boolean): string;
+//# sourceMappingURL=storageSnippets.d.ts.map

package/dist/cli/storageSnippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageSnippets.d.ts","sourceRoot":"","sources":["../../src/cli/storageSnippets.ts"],"names":[],"mappings":"AAKA,6FAA6F;AAC7F,wBAAgB,WAAW,IAAI,EAAE,GAAG,MAAM,GAAG,SAAS,CAIrD;AAED,gGAAgG;AAChG,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAYhE;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAOjF;AAUD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAwCR;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAEhE"}

package/dist/cli/storageSnippets.js

@@ -0,0 +1,89 @@
+import { statSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { quoteCliArgument } from "./helpers.js";
+/** Locate ordinary Next.js app directories without assuming the consumer's source layout. */
+export function nextAppRoot() {
+    if (statSync('app', { throwIfNoEntry: false })?.isDirectory())
+        return '';
+    if (statSync('src/app', { throwIfNoEntry: false })?.isDirectory())
+        return 'src/';
+    return undefined;
+}
+/** Advice only: never execute or rewrite a consumer's Next config after a successful upload. */
+export async function storageImageConfigAdvice() {
+    for (const file of ['next.config.ts', 'next.config.mjs', 'next.config.js']) {
+        // An unavailable optional hint must not turn a completed Storage write into a CLI failure.
+        const source = await readFile(file, 'utf8').catch(() => undefined);
+        if (source === undefined)
+            continue;
+        if (source.includes('withTransloaditImages'))
+            return '';
+        const commonJsAdvice = file.endsWith('.js')
+            ? '\nFor CommonJS, rename next.config.js to next.config.mjs and convert require/module.exports to import/export before using this ESM example.'
+            : '';
+        return `\n${file} is not wrapped yet. Keep your existing config in nextConfig and wrap its export:${commonJsAdvice}\nimport { withTransloaditImages } from '@transloadit/viewer/next/config'\nexport default withTransloaditImages(nextConfig)`;
+    }
+    return '';
+}
+/** Private redirect delivery needs an application authorizer and key, not the CLI login key. */
+export function storageImagePrivateAdvice(path, receipts) {
+    const prefix = path.slice(0, path.lastIndexOf('/') + 1);
+    if (prefix === '')
+        return '\nThis object is private. Configure per-object authorization explicitly, or store it under a directory to use image init --private. Set TRANSLOADIT_SMART_CDN_KEY/SECRET for rendering.';
+    const catalogOption = receipts === undefined ? '' : ` --receipts=${quoteCliArgument(receipts)}`;
+    // Stop option parsing explicitly: Storage paths are data, including names starting with a dash.
+    return `\nThis directory is private. Rendering needs transloadit.authorize.ts and ${nextAppRoot() ?? ''}app/api/storage-images/route.ts (npx transloadit image init --private${catalogOption} -- ${quoteCliArgument(prefix)}) and TRANSLOADIT_SMART_CDN_KEY/SECRET. Restart next dev after adding them.`;
+}
+function relativeImport(path) {
+    return path.startsWith('./') || path.startsWith('../') ? path : `./${path}`;
+}
+function sourceString(value) {
+    return `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'").replaceAll('\n', '\\n').replaceAll('\r', '\\r').replaceAll('\u2028', '\\u2028').replaceAll('\u2029', '\\u2029')}'`;
+}
+/** An empty-safe scaffold showing the first receipt in the initialized directory. */
+export function storageImagePage(receiptsImport, prefix, receipts) {
+    const catalogOption = receipts === undefined ? '' : ` --receipts=${quoteCliArgument(receipts)}`;
+    const command = `npx transloadit storage store${catalogOption}${prefix.startsWith('-') ? ' --' : ''} ./hero.jpg ${quoteCliArgument(`${prefix}hero.jpg`)}`;
+    return [
+        "import { Image } from '@transloadit/viewer/next'",
+        `import catalog from ${sourceString(relativeImport(receiptsImport))}`,
+        '',
+        'export default function Page() {',
+        `  const path = Object.keys(catalog.images).find((path) => path.startsWith(${sourceString(prefix)}))`,
+        '  if (path === undefined)',
+        '    return (',
+        '      <p>',
+        `        Run <code>{${sourceString(command)}}</code> to add your`,
+        '        first image.',
+        '      </p>',
+        '    )',
+        '  // Object.keys only returns own catalog keys, including when the catalog is still empty.',
+        '  const src = path as keyof typeof catalog.images',
+        '  // Replace the filename-derived alt with a description, or an empty string if decorative.',
+        '  const alt = path',
+        "    .slice(path.lastIndexOf('/') + 1)",
+        "    .replace(/\\.[^.]+$/, '')",
+        "    .replaceAll(/[-_]+/g, ' ')",
+        '  return (',
+        '    <Image',
+        '      storage',
+        '      src={src}',
+        '      alt={alt}',
+        '      width={960}',
+        '      preload',
+        '      errorFallback={',
+        '        <p role="status">',
+        '          This image could not be loaded. Check the Storage path and delivery configuration.',
+        '        </p>',
+        '      }',
+        '    />',
+        '  )',
+        '}',
+        '',
+    ].join('\n');
+}
+/** Rendering-only variable names; values belong in the application's secret configuration. */
+export function storageImageEnvBlock(publicOnly) {
+    return publicOnly ? '' : 'TRANSLOADIT_KEY=\nTRANSLOADIT_SECRET=\n';
+}
+//# sourceMappingURL=storageSnippets.js.map

package/dist/cli/storageSnippets.js.map

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

package/dist/storageImage.d.ts

@@ -0,0 +1,40 @@
+import type { StoredAsset } from './alphalib/types/storageAsset.ts';
+import type { CreateAssemblyOptions, Transloadit } from './Transloadit.ts';
+/**
+ * Verified Storage metadata that can be saved and passed directly to an image renderer.
+ * Width and height reflect EXIF auto-orientation, matching Storage preview delivery.
+ */
+export interface StoredImageReceipt extends Readonly<StoredAsset> {
+    /** Present as true only when the locally decoded original has an alpha channel. */
+    readonly hasAlpha?: boolean;
+    readonly height: number;
+    readonly md5hash: string;
+    /** Optional base64 ThumbHash of the original pixels, for an inline blur placeholder. */
+    readonly thumbhash?: string;
+    readonly width: number;
+}
+/** One explicit destination, with the existing Assembly upload and polling controls. */
+export interface StoreImageOptions extends Pick<CreateAssemblyOptions, 'chunkSize' | 'onAssemblyProgress' | 'onUploadProgress' | 'signal' | 'timeout'> {
+    /** Complete relative Storage filename. Directories and interpolation expressions are rejected. */
+    path: string;
+    /** Explicit opt-in replacement of an existing path; defaults to false. */
+    overwrite?: boolean;
+    /** Observe verified metadata. Not awaited; sync and async observer errors cannot undo a write. */
+    onReceipt?: (receipt: StoredImageReceipt, input: StoredImageExpectation, assemblyId: string | undefined) => void | Promise<void>;
+}
+/** Trusted upload facts used to correlate a stored result with an application-owned upload. */
+export interface StoredImageExpectation {
+    path: string;
+    size: number;
+    md5hash: string;
+}
+/** Recovers one original's receipt without re-uploading or trusting notification payloads. */
+export interface GetStoredImageReceiptOptions {
+    assemblyId: string;
+    expected: StoredImageExpectation;
+}
+/** Stores one original without overwriting; receipt validation occurs after the Storage write. */
+export declare function storeImage(client: Transloadit, filePath: string, options: StoreImageOptions): Promise<StoredImageReceipt>;
+/** Fetches authoritative Assembly status and applies the same validation as a local image store. */
+export declare function getStoredImageReceipt(client: Transloadit, options: GetStoredImageReceiptOptions): Promise<StoredImageReceipt>;
+//# sourceMappingURL=storageImage.d.ts.map

package/dist/storageImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageImage.d.ts","sourceRoot":"","sources":["../src/storageImage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAY1E;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ,CAAC,WAAW,CAAC;IAC/D,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,wFAAwF;AACxF,MAAM,WAAW,iBACf,SAAQ,IAAI,CACV,qBAAqB,EACrB,WAAW,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAC/E;IACD,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kGAAkG;IAClG,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,sBAAsB,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,KAC3B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,+FAA+F;AAC/F,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,8FAA8F;AAC9F,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,sBAAsB,CAAA;CACjC;AAoED,kGAAkG;AAClG,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAyE7B;AAED,oGAAoG;AACpG,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,kBAAkB,CAAC,CAU7B"}

package/dist/storageImage.js

@@ -0,0 +1,181 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import debug from 'debug';
+import { z } from 'zod';
+import { ApiError } from "./ApiError.js";
+import { storedAssetSchema } from "./alphalib/types/storageAsset.js";
+import InconsistentResponseError from "./InconsistentResponseError.js";
+const positiveIntegerSchema = z.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+const receiptRequestSchema = z.object({
+    assemblyId: z.string().regex(/^[A-Za-z0-9_-]+$/),
+    expected: z.object({
+        path: z.string(),
+        size: positiveIntegerSchema,
+        md5hash: z.string().regex(/^[a-f0-9]{32}$/),
+    }),
+});
+const completedImageSchema = z.object({
+    ok: z.literal('ASSEMBLY_COMPLETED'),
+    results: z.object({
+        ':original': z.tuple([
+            storedAssetSchema.extend({
+                md5hash: storedAssetSchema.shape.md5hash.unwrap(),
+                height: positiveIntegerSchema,
+                width: positiveIntegerSchema,
+                size: positiveIntegerSchema,
+            }),
+        ]),
+    }),
+});
+function validateDestination(path) {
+    if (typeof path !== 'string' ||
+        path.trim() !== path ||
+        Buffer.byteLength(path) > 1024 ||
+        path.normalize('NFC') !== path ||
+        /[\p{Cc}\p{Cs}\\|]/u.test(path) ||
+        path.includes('${') ||
+        path.split('/').some((segment) => segment.trim() === '' || segment === '.' || segment === '..')) {
+        throw new TypeError('Storage path must be a complete relative filename without interpolation');
+    }
+}
+async function imagePlaceholderMetadata(bytes) {
+    try {
+        const [{ default: sharp }, { rgbaToThumbHash }] = await Promise.all([
+            import('sharp'),
+            import('thumbhash'),
+        ]);
+        const image = sharp(bytes, { limitInputPixels: 40_000_000 });
+        // Read original-channel metadata, not the alpha channel added for ThumbHash's RGBA input.
+        const { hasAlpha } = await image.metadata();
+        const { data, info } = await image
+            .autoOrient()
+            .resize(100, 100, { fit: 'inside', withoutEnlargement: true })
+            .ensureAlpha()
+            .raw()
+            .timeout({ seconds: 2 })
+            .toBuffer({ resolveWithObject: true });
+        return {
+            thumbhash: Buffer.from(rgbaToThumbHash(info.width, info.height, data)).toString('base64'),
+            ...(hasAlpha ? { hasAlpha: true } : {}),
+        };
+    }
+    catch {
+        // A locally unsupported/oversized image can still be stored and decoded by the origin.
+        debug('transloadit:warn')('Omitted optional ThumbHash: local image decoding was unavailable');
+        return undefined;
+    }
+}
+/** Stores one original without overwriting; receipt validation occurs after the Storage write. */
+export async function storeImage(client, filePath, options) {
+    const { path, chunkSize, onAssemblyProgress, onUploadProgress, onReceipt, overwrite, signal, timeout, } = options;
+    validateDestination(path);
+    if (overwrite !== undefined && typeof overwrite !== 'boolean')
+        throw new TypeError('overwrite must be a boolean');
+    signal?.throwIfAborted();
+    const checksum = createHash('md5');
+    // Reuse the checksum read, bounded independently of file size; uploads still stream from disk.
+    let thumbnailChunks = [];
+    let size = 0;
+    for await (const chunk of createReadStream(filePath, { signal })) {
+        checksum.update(chunk);
+        size += chunk.length;
+        if (size > 32 * 1024 * 1024)
+            thumbnailChunks = undefined;
+        else
+            thumbnailChunks?.push(chunk);
+    }
+    if (size === 0)
+        throw new Error('Cannot store an empty image');
+    const md5hash = checksum.digest('hex');
+    signal?.throwIfAborted();
+    const placeholder = thumbnailChunks === undefined
+        ? undefined
+        : await imagePlaceholderMetadata(Buffer.concat(thumbnailChunks));
+    thumbnailChunks = undefined;
+    signal?.throwIfAborted();
+    const assembly = await client.createAssembly({
+        chunkSize,
+        files: { image: filePath },
+        onAssemblyProgress,
+        onUploadProgress,
+        params: {
+            steps: {
+                stored: {
+                    robot: '/transloadit/store',
+                    use: ':original',
+                    path,
+                    conflict_strategy: overwrite === true ? 'overwrite' : 'error',
+                },
+            },
+        },
+        signal,
+        timeout,
+        waitForCompletion: true,
+    });
+    const input = { path, size, md5hash };
+    // API2 can watermark uploads before Robots run; this exact write's result describes stored bytes.
+    const receipt = validateReceipt(assembly, input, true);
+    // A watermark or other origin-side rewrite makes the local pixels the wrong placeholder.
+    const withPlaceholder = placeholder === undefined || receipt.md5hash !== md5hash || receipt.size !== size
+        ? receipt
+        : { ...receipt, ...placeholder };
+    const observerFailed = () => {
+        debug('transloadit:warn')('Ignored onReceipt observer failure after a completed Storage write');
+    };
+    try {
+        // Neither a stalled observer nor its rejection may hide a successfully stored receipt.
+        void Promise.resolve(onReceipt?.({ ...withPlaceholder }, input, assembly.assembly_id)).catch(observerFailed);
+    }
+    catch {
+        observerFailed();
+    }
+    return withPlaceholder;
+}
+/** Fetches authoritative Assembly status and applies the same validation as a local image store. */
+export async function getStoredImageReceipt(client, options) {
+    const { assemblyId, expected } = receiptRequestSchema.parse(options);
+    validateDestination(expected.path);
+    const assembly = await client.getAssembly(assemblyId);
+    if (assembly.assembly_id !== assemblyId) {
+        throw new InconsistentResponseError('The response did not match the requested Assembly', {
+            cause: { assemblyId },
+        });
+    }
+    return validateReceipt(assembly, expected);
+}
+function validateReceipt(assembly, expected, acceptTransformed = false) {
+    const { path, size, md5hash } = expected;
+    if (typeof assembly.error === 'string')
+        throw new ApiError({ body: assembly });
+    if (assembly.ok === 'ASSEMBLY_CANCELED') {
+        throw new InconsistentResponseError('The Storage Assembly ended with ASSEMBLY_CANCELED', {
+            cause: { assemblyId: assembly.assembly_id },
+        });
+    }
+    if (assembly.ok === 'ASSEMBLY_UPLOADING' ||
+        assembly.ok === 'ASSEMBLY_EXECUTING' ||
+        assembly.ok === 'ASSEMBLY_REPLAYING') {
+        throw new InconsistentResponseError(`The Storage Assembly is not complete (${assembly.ok})`, {
+            cause: { assemblyId: assembly.assembly_id },
+        });
+    }
+    const parsed = completedImageSchema.safeParse(assembly);
+    const result = parsed.success ? parsed.data.results[':original'][0] : undefined;
+    const originals = assembly.results?.[':original'];
+    const receiptCheck = {
+        originalCount: Array.isArray(originals) ? originals.length : 0,
+        metadataValid: parsed.success,
+        pathMatches: result === undefined ? undefined : result.path === path,
+        sizeMatches: result === undefined ? undefined : result.size === size,
+        md5Matches: result === undefined ? undefined : result.md5hash === md5hash,
+    };
+    if (result === undefined ||
+        result.path !== path ||
+        (!acceptTransformed && (!receiptCheck.sizeMatches || !receiptCheck.md5Matches))) {
+        throw new InconsistentResponseError('The Assembly did not return a matching Storage image receipt', {
+            cause: { assemblyId: assembly.assembly_id, receiptCheck },
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=storageImage.js.map

package/dist/storageImage.js.map

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