@jrmc/adonis-attachment 6.0.0-alpha.2 → 6.0.0-alpha.3

package/build/src/media/blurhash.js

@@ -0,0 +1,46 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { MissingOptionalDependencyError } from '../errors.js';
+/** Builds a generator from injected Sharp and blurhash implementations. */
+export function createSharpBlurhashGenerator(sharp, encode) {
+    return {
+        async generate({ body, componentX, componentY }) {
+            const { data, info } = await sharp(body).raw().ensureAlpha().toBuffer({ resolveWithObject: true });
+            return encode(new Uint8ClampedArray(data), info.width, info.height, componentX, componentY);
+        },
+    };
+}
+/** Loads the optional Sharp and blurhash dependencies only when a converter enables blurhash. */
+export class DynamicBlurhashGenerator {
+    #generator;
+    generate(input) {
+        this.#generator ??= loadGenerator();
+        return this.#generator.then((generator) => generator.generate(input));
+    }
+}
+export function isBlurhashEnabled(options) {
+    return options === true || (typeof options === 'object' && options.enabled);
+}
+export function resolveBlurhashComponents(options) {
+    return {
+        componentX: typeof options === 'object' ? options.componentX ?? 4 : 4,
+        componentY: typeof options === 'object' ? options.componentY ?? 4 : 4,
+    };
+}
+async function loadGenerator() {
+    const sharpSpecifier = 'sharp';
+    const blurhashSpecifier = 'blurhash';
+    const [sharpModule, blurhashModule] = await Promise.all([
+        import(sharpSpecifier),
+        import(blurhashSpecifier),
+    ]);
+    if (typeof sharpModule.default !== 'function' || typeof blurhashModule.encode !== 'function') {
+        throw new MissingOptionalDependencyError(['sharp', 'blurhash']);
+    }
+    return createSharpBlurhashGenerator(sharpModule.default, blurhashModule.encode);
+}
+//# sourceMappingURL=blurhash.js.map

package/build/src/media/blurhash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blurhash.js","sourceRoot":"","sources":["../../../src/media/blurhash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA;AA0C7D,2EAA2E;AAC3E,MAAM,UAAU,4BAA4B,CAC1C,KAA2B,EAC3B,MAAuB;IAEvB,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE;YAC7C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAA;YAElG,OAAO,MAAM,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;QAC7F,CAAC;KACF,CAAA;AACH,CAAC;AAED,iGAAiG;AACjG,MAAM,OAAO,wBAAwB;IACnC,UAAU,CAAwC;IAElD,QAAQ,CAAC,KAA6B;QACpC,IAAI,CAAC,UAAU,KAAK,aAAa,EAAE,CAAA;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACvE,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAoC;IACpE,OAAO,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAoC;IAEpC,OAAO;QACL,UAAU,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,UAAU,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;KACtE,CAAA;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,cAAc,GAAG,OAAO,CAAA;IAC9B,MAAM,iBAAiB,GAAG,UAAU,CAAA;IACpC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtD,MAAM,CAAC,cAAc,CAAmC;QACxD,MAAM,CAAC,iBAAiB,CAAkC;KAC3D,CAAC,CAAA;IAEF,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU,IAAI,OAAO,cAAc,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC7F,MAAM,IAAI,8BAA8B,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;IACjE,CAAC;IAED,OAAO,4BAA4B,CACjC,WAAW,CAAC,OAA+B,EAC3C,cAAc,CAAC,MAAyB,CACzC,CAAA;AACH,CAAC"}

package/build/src/media/exif.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { MediaMetadataExtractor } from './media_metadata.js';
+export type ExifReaderTag = {
+    value?: unknown;
+    description?: string;
+};
+export type ExifReaderTags = Record<string, Record<string, ExifReaderTag | undefined> | undefined>;
+export interface ExifReader {
+    load(input: Uint8Array, options?: {
+        expanded?: boolean;
+    }): ExifReaderTags | Promise<ExifReaderTags>;
+}
+export type ExifMetadataExtractorOptions = {
+    reader?: ExifReader | (() => Promise<ExifReader>);
+};
+/** Extracts the v5 EXIF, PNG, ICC, and GPS metadata shape for image attachments. */
+export declare function createExifMetadataExtractor(options?: ExifMetadataExtractorOptions): MediaMetadataExtractor;
+//# sourceMappingURL=exif.d.ts.map

package/build/src/media/exif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exif.d.ts","sourceRoot":"","sources":["../../../src/media/exif.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAsB,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAGrF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,CAAA;AAElG,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACpG;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;CAClD,CAAA;AAED,oFAAoF;AACpF,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,sBAAsB,CAYxB"}

package/build/src/media/exif.js

@@ -0,0 +1,98 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { MissingOptionalDependencyError } from '../errors.js';
+/** Extracts the v5 EXIF, PNG, ICC, and GPS metadata shape for image attachments. */
+export function createExifMetadataExtractor(options = {}) {
+    let reader;
+    return {
+        supports({ attachment }) {
+            return attachment.mimeType.startsWith('image/');
+        },
+        async extract({ body }) {
+            reader ??= resolveReader(options.reader);
+            return normalizeMetadata(await (await reader).load(body, { expanded: true }));
+        },
+    };
+}
+async function resolveReader(source) {
+    if (typeof source === 'function') {
+        return source();
+    }
+    if (source) {
+        return source;
+    }
+    const specifier = 'exifreader';
+    const module = await import(specifier);
+    const reader = module.default ?? module;
+    if (!isExifReader(reader)) {
+        throw new MissingOptionalDependencyError('exifreader');
+    }
+    return reader;
+}
+function isExifReader(value) {
+    return !!value && typeof value === 'object' && 'load' in value && typeof value.load === 'function';
+}
+function normalizeMetadata(tags) {
+    const exif = tags.exif;
+    const png = tags.png;
+    const pngFile = tags.pngFile;
+    const file = tags.file;
+    const icc = tags.icc;
+    const width = numberTag(exif?.PixelXDimension)
+        ?? numberTag(png?.['Image Width'])
+        ?? numberTag(pngFile?.['Image Width'])
+        ?? numberTag(file?.['Image Width'])
+        ?? numberTag(icc?.['Image Width']);
+    const height = numberTag(exif?.PixelYDimension)
+        ?? numberTag(png?.['Image Height'])
+        ?? numberTag(pngFile?.['Image Height'])
+        ?? numberTag(file?.['Image Height'])
+        ?? numberTag(icc?.['Image Height']);
+    const orientation = numberTag(exif?.Orientation);
+    const date = stringTag(exif?.DateTime) ?? stringTag(png?.['Creation Time']) ?? stringTag(icc?.['Creation Time']);
+    const host = stringTag(exif?.Software) ?? stringTag(png?.Software) ?? stringTag(icc?.Software);
+    const metadata = {
+        ...(date ? { date } : {}),
+        ...(host ? { host } : {}),
+        ...(width !== undefined && height !== undefined ? { dimension: { width, height } } : {}),
+        ...(orientation !== undefined
+            ? {
+                orientation: {
+                    value: orientation,
+                    ...(exif?.Orientation?.description ? { description: exif.Orientation.description } : {}),
+                },
+            }
+            : {}),
+        ...gpsMetadata(tags.gps),
+    };
+    return Object.keys(metadata).length > 0 ? metadata : undefined;
+}
+function gpsMetadata(tags) {
+    const latitude = numberTag(tags?.Latitude);
+    const longitude = numberTag(tags?.Longitude);
+    const altitude = numberTag(tags?.Altitude);
+    if (latitude === undefined && longitude === undefined && altitude === undefined) {
+        return {};
+    }
+    return {
+        gps: {
+            ...(latitude !== undefined ? { latitude } : {}),
+            ...(longitude !== undefined ? { longitude } : {}),
+            ...(altitude !== undefined ? { altitude } : {}),
+        },
+    };
+}
+function numberTag(tag) {
+    const value = tag?.value;
+    const number = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+    return Number.isFinite(number) ? number : undefined;
+}
+function stringTag(tag) {
+    const value = tag?.description ?? tag?.value;
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=exif.js.map

package/build/src/media/exif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exif.js","sourceRoot":"","sources":["../../../src/media/exif.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA;AAiB7D,oFAAoF;AACpF,MAAM,UAAU,2BAA2B,CACzC,UAAwC,EAAE;IAE1C,IAAI,MAAuC,CAAA;IAE3C,OAAO;QACL,QAAQ,CAAC,EAAE,UAAU,EAAE;YACrB,OAAO,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QACjD,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE;YACpB,MAAM,KAAK,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YACxC,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC/E,CAAC;KACF,CAAA;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAA8C;IACzE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,MAAM,EAAE,CAAA;IACjB,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAA;IAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAA0B,CAAA;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAA;IAEvC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,8BAA8B,CAAC,YAAY,CAAC,CAAA;IACxD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAA;AACpG,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAoB;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;IACpB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC;WACzC,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;WAC/B,SAAS,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;WACnC,SAAS,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC;WAChC,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC;WAC1C,SAAS,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;WAChC,SAAS,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,CAAC;WACpC,SAAS,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,CAAC;WACjC,SAAS,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC,CAAA;IACrC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAChD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,CAAA;IAChH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IAC9F,MAAM,QAAQ,GAAuB;QACnC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,WAAW,KAAK,SAAS;YAC3B,CAAC,CAAC;gBACE,WAAW,EAAE;oBACX,KAAK,EAAE,WAAW;oBAClB,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzF;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;KACzB,CAAA;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,IAA2D;IAC9E,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAE1C,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChF,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO;QACL,GAAG,EAAE;YACH,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD;KACF,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAA8B;IAC/C,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,CAAA;IACxB,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAElG,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,GAA8B;IAC/C,MAAM,KAAK,GAAG,GAAG,EAAE,WAAW,IAAI,GAAG,EAAE,KAAK,CAAA;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1E,CAAC"}

package/build/src/media/media_metadata.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from '../core/attachment.js';
+/** Stable metadata shape preserved from v5, with room for application-specific fields. */
+export type AttachmentMetadata = {
+    orientation?: {
+        value: number;
+        description?: string;
+    };
+    date?: string;
+    host?: string;
+    gps?: {
+        latitude?: number;
+        longitude?: number;
+        altitude?: number;
+    };
+    dimension?: {
+        width: number;
+        height: number;
+    };
+    duration?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+    pages?: number;
+    version?: string;
+    bitRate?: number;
+    format?: string;
+    density?: number;
+    hasAlpha?: boolean;
+    pageHeight?: number;
+    [key: string]: unknown;
+};
+export type MediaMetadataInput = {
+    attachment: Attachment;
+    body: Uint8Array;
+};
+/**
+ * Extracts technical metadata from one attachment source. Implementations may
+ * opt out of an input by returning false from `supports`.
+ */
+export interface MediaMetadataExtractor {
+    supports?(input: Pick<MediaMetadataInput, 'attachment'>): boolean | Promise<boolean>;
+    extract(input: MediaMetadataInput): Promise<AttachmentMetadata | undefined>;
+}
+/** Runs matching metadata extractors in declaration order. */
+export declare class MediaMetadataService {
+    #private;
+    constructor(extractors: readonly MediaMetadataExtractor[]);
+    extract(input: MediaMetadataInput): Promise<AttachmentMetadata | undefined>;
+}
+//# sourceMappingURL=media_metadata.d.ts.map

package/build/src/media/media_metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_metadata.d.ts","sourceRoot":"","sources":["../../../src/media/media_metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE;QACJ,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,UAAU,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpF,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAA;CAC5E;AAED,8DAA8D;AAC9D,qBAAa,oBAAoB;;gBAGnB,UAAU,EAAE,SAAS,sBAAsB,EAAE;IAInD,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;CAiBlF"}

package/build/src/media/media_metadata.js

@@ -0,0 +1,27 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+/** Runs matching metadata extractors in declaration order. */
+export class MediaMetadataService {
+    #extractors;
+    constructor(extractors) {
+        this.#extractors = extractors;
+    }
+    async extract(input) {
+        let metadata;
+        for (const extractor of this.#extractors) {
+            if (extractor.supports && !(await extractor.supports({ attachment: input.attachment }))) {
+                continue;
+            }
+            const extracted = await extractor.extract(input);
+            if (extracted) {
+                metadata = { ...metadata, ...extracted };
+            }
+        }
+        return metadata;
+    }
+}
+//# sourceMappingURL=media_metadata.js.map

package/build/src/media/media_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_metadata.js","sourceRoot":"","sources":["../../../src/media/media_metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgDH,8DAA8D;AAC9D,MAAM,OAAO,oBAAoB;IACtB,WAAW,CAAmC;IAEvD,YAAY,UAA6C;QACvD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAyB;QACrC,IAAI,QAAwC,CAAA;QAE5C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC;gBACxF,SAAQ;YACV,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAEhD,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAA;YAC1C,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF"}

package/build/src/media/sharp.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { MediaMetadataExtractor } from './media_metadata.js';
+import type { VariantConverter, VariantConversionInput } from '../variants/variant_converter.js';
+import { type SharpFormat, type SharpFormatOptions, type SharpResizeOptions } from '../converters/converter.js';
+export type { SharpFormat, SharpFormatOptions, SharpOutputFormat, SharpResizeOptions } from '../converters/converter.js';
+export type SharpMetadata = {
+    width?: number;
+    height?: number;
+    format?: string;
+    size?: number;
+    density?: number;
+    hasAlpha?: boolean;
+    pages?: number;
+    pageHeight?: number;
+    orientation?: number;
+};
+export interface SharpImage {
+    metadata(): Promise<SharpMetadata>;
+    autoOrient?(): SharpImage;
+    resize(width?: number, height?: number, options?: SharpResizeOptions): SharpImage;
+    toFormat(format: string, options?: SharpFormatOptions): SharpImage;
+    toBuffer(): Promise<Uint8Array>;
+}
+export type SharpFactory = (input: Uint8Array) => SharpImage;
+export type SharpVariantOptions = {
+    key: string;
+    sharp: SharpFactory;
+    width?: number;
+    height?: number;
+    resize?: SharpResizeOptions;
+    format?: SharpFormat;
+    autoOrient?: boolean;
+    folder?: string;
+    transform?: (image: SharpImage, input: VariantConversionInput) => SharpImage | Promise<SharpImage>;
+};
+/** Creates an image-only metadata extractor backed by a caller-provided Sharp factory. */
+export declare function createSharpMetadataExtractor(sharp: SharpFactory): MediaMetadataExtractor;
+/** Creates a Sharp-backed converter for one configured image variant. */
+export declare function createSharpVariantConverter(options: SharpVariantOptions): VariantConverter;
+//# sourceMappingURL=sharp.d.ts.map

package/build/src/media/sharp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.d.ts","sourceRoot":"","sources":["../../../src/media/sharp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAsB,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAChG,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EAEvB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAA;AAEnC,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAExH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;IAClC,UAAU,CAAC,IAAI,UAAU,CAAA;IACzB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,UAAU,CAAA;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,UAAU,CAAA;IAClE,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAA;CAChC;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAA;AAE5D,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,sBAAsB,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACnG,CAAA;AAED,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,YAAY,GAAG,sBAAsB,CASxF;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CA+B1F"}

package/build/src/media/sharp.js

@@ -0,0 +1,76 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { normalizeSharpFormat, } from '../converters/converter.js';
+/** Creates an image-only metadata extractor backed by a caller-provided Sharp factory. */
+export function createSharpMetadataExtractor(sharp) {
+    return {
+        supports({ attachment }) {
+            return attachment.mimeType.startsWith('image/');
+        },
+        async extract({ body }) {
+            return compactMetadata(await sharp(body).metadata());
+        },
+    };
+}
+/** Creates a Sharp-backed converter for one configured image variant. */
+export function createSharpVariantConverter(options) {
+    return {
+        key: options.key,
+        async convert(input) {
+            let image = options.sharp(input.body);
+            if (options.autoOrient && image.autoOrient) {
+                image = image.autoOrient();
+            }
+            if (options.transform) {
+                image = await options.transform(image, input);
+            }
+            else if (options.width !== undefined || options.height !== undefined) {
+                image = image.resize(options.width, options.height, options.resize);
+            }
+            const outputFormat = options.format ? normalizeSharpFormat(options.format) : undefined;
+            if (outputFormat) {
+                image = image.toFormat(outputFormat.format, outputFormat.options);
+            }
+            const format = outputFormat?.format ?? input.attachment.extname;
+            const extension = format || 'bin';
+            return {
+                body: await image.toBuffer(),
+                fileName: `${options.key}.${extension}`,
+                mimeType: mimeTypeForFormat(format) ?? input.attachment.mimeType,
+                ...(options.folder ? { folder: options.folder } : {}),
+            };
+        },
+    };
+}
+function compactMetadata(metadata) {
+    const compact = {
+        ...(metadata.width !== undefined && metadata.height !== undefined
+            ? { dimension: { width: metadata.width, height: metadata.height } }
+            : {}),
+        ...(metadata.format !== undefined ? { format: metadata.format } : {}),
+        ...(metadata.density !== undefined ? { density: metadata.density } : {}),
+        ...(metadata.hasAlpha !== undefined ? { hasAlpha: metadata.hasAlpha } : {}),
+        ...(metadata.pages !== undefined ? { pages: metadata.pages } : {}),
+        ...(metadata.pageHeight !== undefined ? { pageHeight: metadata.pageHeight } : {}),
+        ...(metadata.orientation !== undefined ? { orientation: { value: metadata.orientation } } : {}),
+    };
+    return Object.keys(compact).length > 0 ? compact : undefined;
+}
+function mimeTypeForFormat(format) {
+    switch (format) {
+        case 'avif': return 'image/avif';
+        case 'jpeg': return 'image/jpeg';
+        case 'gif': return 'image/gif';
+        case 'heif': return 'image/heif';
+        case 'png': return 'image/png';
+        case 'raw': return 'application/octet-stream';
+        case 'tiff': return 'image/tiff';
+        case 'webp': return 'image/webp';
+        default: return undefined;
+    }
+}
+//# sourceMappingURL=sharp.js.map

package/build/src/media/sharp.js.map

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

package/build/src/media/v5_metadata.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { type FfprobeMetadataExtractorOptions, type PdfInfoMetadataExtractorOptions } from './binaries.js';
+import { type ExifMetadataExtractorOptions } from './exif.js';
+import type { MediaMetadataExtractor } from './media_metadata.js';
+export type V5CompatibleMetadataExtractorOptions = {
+    exif?: false | ExifMetadataExtractorOptions;
+    ffprobe?: false | FfprobeMetadataExtractorOptions;
+    pdfinfo?: false | PdfInfoMetadataExtractorOptions;
+};
+/**
+ * Creates the v5 metadata profile: EXIF for images, ffprobe for media, and
+ * pdfinfo for PDFs. Each extractor can be disabled or pointed at a custom binary.
+ */
+export declare function createV5CompatibleMetadataExtractors(options?: V5CompatibleMetadataExtractorOptions): readonly MediaMetadataExtractor[];
+//# sourceMappingURL=v5_metadata.d.ts.map

package/build/src/media/v5_metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v5_metadata.d.ts","sourceRoot":"","sources":["../../../src/media/v5_metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAkE,KAAK,+BAA+B,EAAE,KAAK,+BAA+B,EAAE,MAAM,eAAe,CAAA;AAC1K,OAAO,EAA+B,KAAK,4BAA4B,EAAE,MAAM,WAAW,CAAA;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEjE,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,CAAC,EAAE,KAAK,GAAG,4BAA4B,CAAA;IAC3C,OAAO,CAAC,EAAE,KAAK,GAAG,+BAA+B,CAAA;IACjD,OAAO,CAAC,EAAE,KAAK,GAAG,+BAA+B,CAAA;CAClD,CAAA;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,GAAE,oCAAyC,GACjD,SAAS,sBAAsB,EAAE,CAMnC"}

package/build/src/media/v5_metadata.js

@@ -0,0 +1,20 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { createPdfInfoMetadataExtractor, createFfprobeMetadataExtractor } from './binaries.js';
+import { createExifMetadataExtractor } from './exif.js';
+/**
+ * Creates the v5 metadata profile: EXIF for images, ffprobe for media, and
+ * pdfinfo for PDFs. Each extractor can be disabled or pointed at a custom binary.
+ */
+export function createV5CompatibleMetadataExtractors(options = {}) {
+    return [
+        ...(options.exif === false ? [] : [createExifMetadataExtractor(options.exif)]),
+        ...(options.ffprobe === false ? [] : [createFfprobeMetadataExtractor(options.ffprobe)]),
+        ...(options.pdfinfo === false ? [] : [createPdfInfoMetadataExtractor(options.pdfinfo)]),
+    ];
+}
+//# sourceMappingURL=v5_metadata.js.map

package/build/src/media/v5_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v5_metadata.js","sourceRoot":"","sources":["../../../src/media/v5_metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAA8E,MAAM,eAAe,CAAA;AAC1K,OAAO,EAAE,2BAA2B,EAAqC,MAAM,WAAW,CAAA;AAS1F;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAClD,UAAgD,EAAE;IAElD,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACvF,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;KACxF,CAAA;AACH,CAAC"}

package/build/src/queues/memory_queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory_queue.d.ts","sourceRoot":"","sources":["../../../src/queues/memory_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE5F,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,oBAAoB,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzE,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;;gBAQ/C,OAAO,EAAE,4BAA4B;IAU3C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0C7B"}
+{"version":3,"file":"memory_queue.d.ts","sourceRoot":"","sources":["../../../src/queues/memory_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAG5F,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,oBAAoB,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzE,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;;gBAQ/C,OAAO,EAAE,4BAA4B;IAY3C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0C7B"}

package/build/src/queues/memory_queue.js

@@ -4,6 +4,7 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
+import { AttachmentError } from '../errors.js';
 /**
  * In-process default queue for local development and applications without a worker.
  */
@@ -16,7 +17,9 @@ export class MemoryAttachmentQueue {
     #drainWaiters = [];
     constructor(options) {
         if (!Number.isInteger(options.concurrency ?? 1) || (options.concurrency ?? 1) < 1) {
-            throw new Error('Memory queue concurrency must be a positive integer');
+            throw new AttachmentError('Memory queue concurrency must be a positive integer', {
+                code: 'E_INVALID_QUEUE_CONCURRENCY',
+            });
         }
         this.#handler = options.handler;
         this.#onFailure = options.onFailure;

package/build/src/queues/memory_queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory_queue.js","sourceRoot":"","sources":["../../../src/queues/memory_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACvB,QAAQ,CAAsB;IAC9B,UAAU,CAA4E;IACtF,YAAY,CAAQ;IACpB,QAAQ,GAAoB,EAAE,CAAA;IACvC,OAAO,GAAG,CAAC,CAAA;IACX,aAAa,GAAsB,EAAE,CAAA;IAErC,YAAY,OAAqC;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACxE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAA;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,QAAQ,EAAE,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,IAAI,CAAC,oBAAoB,EAAE,CAAA;gBAC3B,OAAM;YACR,CAAC;YAED,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YACjB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAA;QACjB,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAA;QAClC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IACzC,CAAC;CACF"}
+{"version":3,"file":"memory_queue.js","sourceRoot":"","sources":["../../../src/queues/memory_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAQ9C;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACvB,QAAQ,CAAsB;IAC9B,UAAU,CAA4E;IACtF,YAAY,CAAQ;IACpB,QAAQ,GAAoB,EAAE,CAAA;IACvC,OAAO,GAAG,CAAC,CAAA;IACX,aAAa,GAAsB,EAAE,CAAA;IAErC,YAAY,OAAqC;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,eAAe,CAAC,qDAAqD,EAAE;gBAC/E,IAAI,EAAE,6BAA6B;aACpC,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAA;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,QAAQ,EAAE,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,IAAI,CAAC,oBAAoB,EAAE,CAAA;gBAC3B,OAAM;YACR,CAAC;YAED,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YACjB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAA;QACjB,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAA;QAClC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IACzC,CAAC;CACF"}

package/build/src/sources/attachment_manager.d.ts

@@ -47,7 +47,5 @@ export declare class AttachmentManager {
     createFromFile(input: MultipartAttachmentFile, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
     createFromFiles(inputs: readonly MultipartAttachmentFile[], options?: AttachmentSourceOptions): Promise<AttachmentDraft[]>;
 }
-export declare class AttachmentSourceError extends Error {
-    constructor(message: string);
-}
+export { AttachmentSourceError } from '../errors.js';
 //# sourceMappingURL=attachment_manager.d.ts.map

package/build/src/sources/attachment_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment_manager.d.ts","sourceRoot":"","sources":["../../../src/sources/attachment_manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACnF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,4BAA4B,GAAG;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,GAAG,GAAG,MAAM,KAChB,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAEtC,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,qBAAa,iBAAiB;;gBAKhB,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,OAAO,GAAE,wBAA6B;IAUvG,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAQpG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAU1F,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAa9F,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBlG,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAyBzG,cAAc,CAAC,KAAK,EAAE,uBAAuB,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAY/G,eAAe,CACb,MAAM,EAAE,SAAS,uBAAuB,EAAE,EAC1C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,EAAE,CAAC;CAkC9B;AAaD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"attachment_manager.d.ts","sourceRoot":"","sources":["../../../src/sources/attachment_manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACnF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGtE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,4BAA4B,GAAG;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,GAAG,GAAG,MAAM,KAChB,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAEtC,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,qBAAa,iBAAiB;;gBAKhB,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,OAAO,GAAE,wBAA6B;IAYvG,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAQpG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAU1F,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAa9F,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAmBlG,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BzG,cAAc,CAAC,KAAK,EAAE,uBAAuB,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAc/G,eAAe,CACb,MAAM,EAAE,SAAS,uBAAuB,EAAE,EAC1C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,EAAE,CAAC;CAuC9B;AAaD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA"}

package/build/src/sources/attachment_manager.js

@@ -6,6 +6,7 @@
  */
 import { basename, extname } from 'node:path';
 import { readFile, stat } from 'node:fs/promises';
+import { AttachmentSourceError } from '../errors.js';
 /**
  * Normalizes common input sources into drafts. The file is written only when the
  * caller invokes `draft.persist()` or an integration persists it automatically.
@@ -16,7 +17,9 @@ export class AttachmentManager {
     #fetch;
     constructor(attachments, options = {}) {
         if (options.maxBytes !== undefined && (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 1)) {
-            throw new Error('Attachment source maxBytes must be a positive integer');
+            throw new AttachmentSourceError('Attachment source maxBytes must be a positive integer', {
+                code: 'E_INVALID_ATTACHMENT_SOURCE_OPTIONS',
+            });
         }
         this.#attachments = attachments;
         this.#maxBytes = options.maxBytes;
@@ -67,7 +70,7 @@ export class AttachmentManager {
     async createFromUrl(input, options = {}) {
         const response = await this.#fetch(input);
         if (!response.ok) {
-            throw new AttachmentSourceError(`Unable to download attachment source: ${response.status} ${response.statusText}`);
+            throw new AttachmentSourceError(`Unable to download attachment source: ${response.status} ${response.statusText}`, { code: 'E_ATTACHMENT_SOURCE_DOWNLOAD_FAILED', status: 502 });
         }
         const contentLength = response.headers.get('content-length');
         if (contentLength && Number.isSafeInteger(Number(contentLength))) {
@@ -84,7 +87,9 @@ export class AttachmentManager {
     }
     createFromFile(input, options = {}) {
         if (!input.tmpPath) {
-            throw new AttachmentSourceError('Multipart attachment file has no temporary path');
+            throw new AttachmentSourceError('Multipart attachment file has no temporary path', {
+                code: 'E_MULTIPART_SOURCE_PATH_MISSING',
+            });
         }
         return this.createFromPath(input.tmpPath, {
             ...options,
@@ -106,7 +111,9 @@ export class AttachmentManager {
     }
     #assertSize(size, override) {
         if (override !== undefined && (!Number.isSafeInteger(override) || override < 1)) {
-            throw new Error('Attachment source maxBytes must be a positive integer');
+            throw new AttachmentSourceError('Attachment source maxBytes must be a positive integer', {
+                code: 'E_INVALID_ATTACHMENT_SOURCE_OPTIONS',
+            });
         }
         const maxBytes = override === undefined
             ? this.#maxBytes
@@ -114,7 +121,10 @@ export class AttachmentManager {
                 ? override
                 : Math.min(override, this.#maxBytes);
         if (maxBytes !== undefined && size > maxBytes) {
-            throw new AttachmentSourceError(`Attachment source exceeds the ${maxBytes}-byte limit`);
+            throw new AttachmentSourceError(`Attachment source exceeds the ${maxBytes}-byte limit`, {
+                code: 'E_ATTACHMENT_SOURCE_TOO_LARGE',
+                status: 413,
+            });
         }
     }
 }
@@ -128,18 +138,15 @@ function toPersistenceOptions(options) {
         ...(options.variants !== undefined ? { variants: options.variants } : {}),
     };
 }
-export class AttachmentSourceError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'AttachmentSourceError';
-    }
-}
+export { AttachmentSourceError } from '../errors.js';
 function parseBase64(input) {
     const dataUri = /^data:([^;,]+)?;base64,([A-Za-z0-9+/\s]*={0,2})$/i.exec(input);
     const mimeType = dataUri?.[1];
     const value = (dataUri?.[2] ?? input).replaceAll(/\s/g, '');
     if (!isBase64(value)) {
-        throw new AttachmentSourceError('Attachment source must be valid Base64 data');
+        throw new AttachmentSourceError('Attachment source must be valid Base64 data', {
+            code: 'E_ISNOT_BASE64',
+        });
     }
     return { body: Buffer.from(value, 'base64'), ...(mimeType ? { mimeType } : {}) };
 }