@jrmc/adonis-attachment 5.2.1 → 6.0.0-alpha.1

package/build/src/integrations/lucid/lucid_variant_generation_service.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentService } from '../../core/attachment_service.js';
+import type { VariantGenerationRequest, VariantGenerator } from '../../core/attachment_job_processor.js';
+import type { VariantGenerationService } from '../../variants/variant_generation_service.js';
+import { LucidAttachmentStore } from './lucid_attachment_store.js';
+export type LucidVariantGenerationServiceOptions = {
+    generator: Pick<VariantGenerationService, 'generateAll'>;
+    attachments: Pick<AttachmentService, 'remove'>;
+    store: Pick<LucidAttachmentStore, 'findById' | 'createVariant'>;
+};
+export declare class LucidVariantGenerationService implements VariantGenerator {
+    #private;
+    constructor(options: LucidVariantGenerationServiceOptions);
+    generate(request: VariantGenerationRequest): Promise<void>;
+}
+export declare class PersistedAttachmentNotFoundError extends Error {
+    constructor(id: string);
+}
+//# sourceMappingURL=lucid_variant_generation_service.d.ts.map

package/build/src/integrations/lucid/lucid_variant_generation_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid_variant_generation_service.d.ts","sourceRoot":"","sources":["../../../../src/integrations/lucid/lucid_variant_generation_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AACxG,OAAO,KAAK,EAAoB,wBAAwB,EAAE,MAAM,8CAA8C,CAAA;AAE9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,MAAM,MAAM,oCAAoC,GAAG;IACjD,SAAS,EAAE,IAAI,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAA;IACxD,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAA;IAC9C,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,eAAe,CAAC,CAAA;CAChE,CAAA;AAED,qBAAa,6BAA8B,YAAW,gBAAgB;;gBAKxD,OAAO,EAAE,oCAAoC;IAMnD,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBjE;AAED,qBAAa,gCAAiC,SAAQ,KAAK;gBAC7C,EAAE,EAAE,MAAM;CAIvB"}

package/build/src/integrations/lucid/lucid_variant_generation_service.js

@@ -0,0 +1,42 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export class LucidVariantGenerationService {
+    #generator;
+    #attachments;
+    #store;
+    constructor(options) {
+        this.#generator = options.generator;
+        this.#attachments = options.attachments;
+        this.#store = options.store;
+    }
+    async generate(request) {
+        const original = await this.#store.findById(request.attachment.id);
+        if (!original) {
+            throw new PersistedAttachmentNotFoundError(request.attachment.id);
+        }
+        const variants = await this.#generator.generateAll(request);
+        for (const variant of variants) {
+            await this.#persist(original, variant);
+        }
+    }
+    async #persist(original, variant) {
+        try {
+            await this.#store.createVariant(original, variant.key, variant.attachment);
+        }
+        catch (error) {
+            await this.#attachments.remove(variant.attachment);
+            throw error;
+        }
+    }
+}
+export class PersistedAttachmentNotFoundError extends Error {
+    constructor(id) {
+        super(`Persisted attachment "${id}" was not found`);
+        this.name = 'PersistedAttachmentNotFoundError';
+    }
+}
+//# sourceMappingURL=lucid_variant_generation_service.js.map

package/build/src/integrations/lucid/lucid_variant_generation_service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid_variant_generation_service.js","sourceRoot":"","sources":["../../../../src/integrations/lucid/lucid_variant_generation_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,OAAO,6BAA6B;IAC/B,UAAU,CAA+C;IACzD,YAAY,CAAmC;IAC/C,MAAM,CAA0D;IAEzE,YAAY,OAA6C;QACvD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAA;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAiC;QAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QAElE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,gCAAgC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACnE,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAC3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAyB,EAAE,OAAyB;QACjE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAClD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IACzD,YAAY,EAAU;QACpB,KAAK,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAA;IAChD,CAAC;CACF"}

package/build/src/integrations/lucid/migrate_legacy_attachment.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export type LegacyAttachment = {
+    name: string;
+    originalName?: string;
+    size: number;
+    extname: string;
+    mimeType: string;
+    disk?: string;
+    path?: string;
+    meta?: Record<string, unknown>;
+    variants?: LegacyVariant[];
+};
+export type LegacyVariant = {
+    key: string;
+    name: string;
+    size: number;
+    extname: string;
+    mimeType: string;
+    disk?: string;
+    path?: string;
+    meta?: Record<string, unknown>;
+};
+import { type AttachmentOwner } from "./attachment_owner.js";
+import type { Attachment } from "../../core/attachment.js";
+export type { AttachmentOwner } from "./attachment_owner.js";
+export type MigratedAttachmentRow = {
+    id: string;
+    attachableType: string;
+    attachableId: string;
+    field: string;
+    ownerKey: string | null;
+    parentId: string | null;
+    variantKey: string | null;
+    disk: string;
+    path: string;
+    name: string;
+    originalName: string;
+    mimeType: string;
+    extname: string;
+    size: number;
+    metadata: Record<string, unknown> | null;
+};
+export type MigrateLegacyAttachmentOptions = {
+    owner: AttachmentOwner;
+    defaultDisk: string;
+    createId: () => string;
+};
+export type MigrateLegacyAttachmentColumnOptions = Omit<MigrateLegacyAttachmentOptions, "owner">;
+/**
+ * Converts one v5 JSON attachment document into rows for the polymorphic table.
+ * Callers can run it from an Ace command, another ORM migration, or a one-off script.
+ */
+export declare function migrateLegacyAttachment(value: LegacyAttachment | string, options: MigrateLegacyAttachmentOptions): MigratedAttachmentRow[];
+/**
+ * Converts one v5 JSON value for a retained single attachment column. Legacy
+ * variants require the polymorphic table and therefore cannot be kept here.
+ */
+export declare function migrateLegacyAttachmentColumn(value: LegacyAttachment | string, options: MigrateLegacyAttachmentColumnOptions): Attachment;
+//# sourceMappingURL=migrate_legacy_attachment.d.ts.map

package/build/src/integrations/lucid/migrate_legacy_attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate_legacy_attachment.d.ts","sourceRoot":"","sources":["../../../../src/integrations/lucid/migrate_legacy_attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,IAAI,CACrD,8BAA8B,EAC9B,OAAO,CACR,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAChC,OAAO,EAAE,8BAA8B,GACtC,qBAAqB,EAAE,CA+BzB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAChC,OAAO,EAAE,oCAAoC,GAC5C,UAAU,CAuBZ"}

package/build/src/integrations/lucid/migrate_legacy_attachment.js

@@ -0,0 +1,89 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { createAttachmentOwnerKey, } from "./attachment_owner.js";
+/**
+ * Converts one v5 JSON attachment document into rows for the polymorphic table.
+ * Callers can run it from an Ace command, another ORM migration, or a one-off script.
+ */
+export function migrateLegacyAttachment(value, options) {
+    const attachment = typeof value === "string" ? parseLegacyAttachment(value) : value;
+    const id = options.createId();
+    const originalName = attachment.originalName ?? attachment.name;
+    const original = toRow({
+        id,
+        attachment,
+        owner: options.owner,
+        ownerKey: createAttachmentOwnerKey(options.owner),
+        parentId: null,
+        variantKey: null,
+        originalName,
+        defaultDisk: options.defaultDisk,
+    });
+    return [
+        original,
+        ...(attachment.variants ?? []).map((variant) => toRow({
+            id: options.createId(),
+            attachment: variant,
+            owner: options.owner,
+            ownerKey: null,
+            parentId: id,
+            variantKey: variant.key,
+            originalName,
+            defaultDisk: options.defaultDisk,
+        })),
+    ];
+}
+/**
+ * Converts one v5 JSON value for a retained single attachment column. Legacy
+ * variants require the polymorphic table and therefore cannot be kept here.
+ */
+export function migrateLegacyAttachmentColumn(value, options) {
+    const attachment = typeof value === "string" ? parseLegacyAttachment(value) : value;
+    if (attachment.variants?.length) {
+        throw new Error("Legacy attachments with variants must migrate to the polymorphic table");
+    }
+    const originalName = attachment.originalName ?? attachment.name;
+    return {
+        id: options.createId(),
+        disk: attachment.disk ?? options.defaultDisk,
+        path: attachment.path ?? attachment.name,
+        name: attachment.name,
+        originalName,
+        mimeType: attachment.mimeType,
+        extname: attachment.extname,
+        size: attachment.size,
+        ...(attachment.meta ? { metadata: attachment.meta } : {}),
+    };
+}
+function parseLegacyAttachment(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new Error("Legacy attachment value must be valid JSON");
+    }
+}
+function toRow({ id, attachment, owner, ownerKey, parentId, variantKey, originalName, defaultDisk, }) {
+    return {
+        id,
+        attachableType: owner.type,
+        attachableId: owner.id,
+        field: owner.field,
+        ownerKey,
+        parentId,
+        variantKey,
+        disk: attachment.disk ?? defaultDisk,
+        path: attachment.path ?? attachment.name,
+        name: attachment.name,
+        originalName,
+        mimeType: attachment.mimeType,
+        extname: attachment.extname,
+        size: attachment.size,
+        metadata: attachment.meta ?? null,
+    };
+}
+//# sourceMappingURL=migrate_legacy_attachment.js.map

package/build/src/integrations/lucid/migrate_legacy_attachment.js.map

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

package/build/src/integrations/lucid/migrate_legacy_attachment_records.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentOwner } from './attachment_owner.js';
+import { type LegacyAttachment, type MigratedAttachmentRow } from './migrate_legacy_attachment.js';
+export type LegacyAttachmentMigrationRecord = {
+    owner: AttachmentOwner;
+    value: LegacyAttachment | string | null | undefined;
+};
+export type LegacyAttachmentMigrationWriter = {
+    insert(rows: readonly MigratedAttachmentRow[]): Promise<void>;
+};
+export type MigrateLegacyAttachmentRecordsOptions = {
+    records: Iterable<LegacyAttachmentMigrationRecord> | AsyncIterable<LegacyAttachmentMigrationRecord>;
+    defaultDisk: string;
+    createId: () => string;
+    writer: LegacyAttachmentMigrationWriter;
+    batchSize?: number;
+};
+export type LegacyAttachmentMigrationResult = {
+    attachments: number;
+    variants: number;
+    skipped: number;
+};
+/**
+ * Migrates a stream of legacy v5 JSON values into attachment-table rows.
+ * The caller owns source-model iteration and database transactions; this keeps
+ * the migration compatible with custom Lucid models and other persistence layouts.
+ */
+export declare function migrateLegacyAttachmentRecords(options: MigrateLegacyAttachmentRecordsOptions): Promise<LegacyAttachmentMigrationResult>;
+//# sourceMappingURL=migrate_legacy_attachment_records.d.ts.map

package/build/src/integrations/lucid/migrate_legacy_attachment_records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate_legacy_attachment_records.d.ts","sourceRoot":"","sources":["../../../../src/integrations/lucid/migrate_legacy_attachment_records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAA;AAEvC,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,eAAe,CAAA;IACtB,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CACpD,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9D,CAAA;AAED,MAAM,MAAM,qCAAqC,GAAG;IAClD,OAAO,EAAE,QAAQ,CAAC,+BAA+B,CAAC,GAAG,aAAa,CAAC,+BAA+B,CAAC,CAAA;IACnG,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,MAAM,CAAA;IACtB,MAAM,EAAE,+BAA+B,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,+BAA+B,CAAC,CAyC1C"}

package/build/src/integrations/lucid/migrate_legacy_attachment_records.js

@@ -0,0 +1,47 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { migrateLegacyAttachment, } from './migrate_legacy_attachment.js';
+/**
+ * Migrates a stream of legacy v5 JSON values into attachment-table rows.
+ * The caller owns source-model iteration and database transactions; this keeps
+ * the migration compatible with custom Lucid models and other persistence layouts.
+ */
+export async function migrateLegacyAttachmentRecords(options) {
+    const batchSize = options.batchSize ?? 100;
+    if (!Number.isSafeInteger(batchSize) || batchSize < 1) {
+        throw new Error('Legacy attachment migration batchSize must be a positive integer');
+    }
+    const result = {
+        attachments: 0,
+        variants: 0,
+        skipped: 0,
+    };
+    let batch = [];
+    for await (const record of options.records) {
+        if (record.value === null || record.value === undefined) {
+            result.skipped += 1;
+            continue;
+        }
+        const rows = migrateLegacyAttachment(record.value, {
+            owner: record.owner,
+            defaultDisk: options.defaultDisk,
+            createId: options.createId,
+        });
+        result.attachments += 1;
+        result.variants += rows.length - 1;
+        batch.push(...rows);
+        if (batch.length >= batchSize) {
+            await options.writer.insert(batch);
+            batch = [];
+        }
+    }
+    if (batch.length > 0) {
+        await options.writer.insert(batch);
+    }
+    return result;
+}
+//# sourceMappingURL=migrate_legacy_attachment_records.js.map

package/build/src/integrations/lucid/migrate_legacy_attachment_records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate_legacy_attachment_records.js","sourceRoot":"","sources":["../../../../src/integrations/lucid/migrate_legacy_attachment_records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,uBAAuB,GAGxB,MAAM,gCAAgC,CAAA;AAyBvC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAA8C;IAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAA;IAE1C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IACrF,CAAC;IAED,MAAM,MAAM,GAAoC;QAC9C,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;KACX,CAAA;IACD,IAAI,KAAK,GAA4B,EAAE,CAAA;IAEvC,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,CAAC,OAAO,IAAI,CAAC,CAAA;YACnB,SAAQ;QACV,CAAC;QAED,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,KAAK,EAAE;YACjD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAA;QAEF,MAAM,CAAC,WAAW,IAAI,CAAC,CAAA;QACvB,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QAEnB,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAClC,KAAK,GAAG,EAAE,CAAA;QACZ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export type RenderLegacyAttachmentMigrationScriptOptions = {
+    defaultDisk?: string;
+};
+export declare function renderLegacyAttachmentMigrationScript(options?: RenderLegacyAttachmentMigrationScriptOptions): string;
+//# sourceMappingURL=render_legacy_attachment_migration_script.d.ts.map

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_legacy_attachment_migration_script.d.ts","sourceRoot":"","sources":["../../../../src/integrations/lucid/render_legacy_attachment_migration_script.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,4CAA4C,GAAG;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,4CAAiD,GACzD,MAAM,CAkCR"}

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.js

@@ -0,0 +1,41 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export function renderLegacyAttachmentMigrationScript(options = {}) {
+    const defaultDisk = options.defaultDisk ?? 'public';
+    return `import { randomUUID } from 'node:crypto'
+
+import {
+  AttachmentModel,
+  migrateLegacyAttachmentRecords,
+  type LegacyAttachmentMigrationRecord,
+} from '@jrmc/adonis-attachment/lucid'
+
+async function main(): Promise<void> {
+  const result = await migrateLegacyAttachmentRecords({
+    records: legacyAttachmentRecords(),
+    defaultDisk: '${defaultDisk}',
+    createId: randomUUID,
+    writer: {
+      insert: (rows) => AttachmentModel.createMany(rows),
+    },
+  })
+
+  console.info(
+    \`Migrated \${result.attachments} attachments and \${result.variants} variants; skipped \${result.skipped} empty values.\`
+  )
+}
+
+async function* legacyAttachmentRecords(): AsyncGenerator<LegacyAttachmentMigrationRecord> {
+  // Iterate over the legacy model and yield one value per attachment field.
+  // Example owner: { type: 'users', id: user.id.toString(), field: 'avatar' }
+  throw new Error('Implement legacyAttachmentRecords before running this script')
+}
+
+void main()
+`;
+}
+//# sourceMappingURL=render_legacy_attachment_migration_script.js.map

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_legacy_attachment_migration_script.js","sourceRoot":"","sources":["../../../../src/integrations/lucid/render_legacy_attachment_migration_script.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,UAAU,qCAAqC,CACnD,UAAwD,EAAE;IAE1D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAA;IAEnD,OAAO;;;;;;;;;;;oBAWW,WAAW;;;;;;;;;;;;;;;;;;;CAmB9B,CAAA;AACD,CAAC"}

package/build/src/queues/adonis_queue.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentJob, AttachmentQueue } from '../core/queue.js';
+export type AdonisQueueDispatcher = {
+    toQueue(name: string): AdonisQueueDispatcher;
+    run(): Promise<unknown>;
+};
+export type AdonisAttachmentJob = {
+    dispatch(payload: AttachmentJob): AdonisQueueDispatcher;
+};
+export type AdonisAttachmentQueueOptions = {
+    job: AdonisAttachmentJob;
+    queue?: string;
+};
+/**
+ * Dispatches attachment jobs through an application-defined @adonisjs/queue Job class.
+ */
+export declare class AdonisAttachmentQueue implements AttachmentQueue {
+    #private;
+    constructor(options: AdonisAttachmentQueueOptions);
+    enqueue(job: AttachmentJob): Promise<void>;
+}
+//# sourceMappingURL=adonis_queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adonis_queue.d.ts","sourceRoot":"","sources":["../../../src/queues/adonis_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAA;IAC5C,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,qBAAqB,CAAA;CACxD,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,GAAG,EAAE,mBAAmB,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;;gBAI/C,OAAO,EAAE,4BAA4B;IAK3C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjD"}

package/build/src/queues/adonis_queue.js

@@ -0,0 +1,22 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+/**
+ * Dispatches attachment jobs through an application-defined @adonisjs/queue Job class.
+ */
+export class AdonisAttachmentQueue {
+    #job;
+    #queue;
+    constructor(options) {
+        this.#job = options.job;
+        this.#queue = options.queue;
+    }
+    async enqueue(job) {
+        const dispatcher = this.#job.dispatch(job);
+        await (this.#queue ? dispatcher.toQueue(this.#queue) : dispatcher).run();
+    }
+}
+//# sourceMappingURL=adonis_queue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adonis_queue.js","sourceRoot":"","sources":["../../../src/queues/adonis_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACvB,IAAI,CAAqB;IACzB,MAAM,CAAoB;IAEnC,YAAY,OAAqC;QAC/C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAA;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAA;IAC1E,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentJob, AttachmentJobHandler, AttachmentQueue } from '../core/queue.js';
+export type MemoryAttachmentQueueOptions = {
+    handler: AttachmentJobHandler;
+    concurrency?: number;
+    onFailure?: (job: AttachmentJob, error: unknown) => void | Promise<void>;
+};
+/**
+ * In-process default queue for local development and applications without a worker.
+ */
+export declare class MemoryAttachmentQueue implements AttachmentQueue {
+    #private;
+    constructor(options: MemoryAttachmentQueueOptions);
+    enqueue(job: AttachmentJob): Promise<void>;
+    drain(): Promise<void>;
+}
+//# sourceMappingURL=memory_queue.d.ts.map

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

@@ -0,0 +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"}

package/build/src/queues/memory_queue.js

@@ -0,0 +1,67 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+/**
+ * In-process default queue for local development and applications without a worker.
+ */
+export class MemoryAttachmentQueue {
+    #handler;
+    #onFailure;
+    #concurrency;
+    #pending = [];
+    #active = 0;
+    #drainWaiters = [];
+    constructor(options) {
+        if (!Number.isInteger(options.concurrency ?? 1) || (options.concurrency ?? 1) < 1) {
+            throw new Error('Memory queue concurrency must be a positive integer');
+        }
+        this.#handler = options.handler;
+        this.#onFailure = options.onFailure;
+        this.#concurrency = options.concurrency ?? 1;
+    }
+    async enqueue(job) {
+        this.#pending.push(job);
+        this.#process();
+    }
+    async drain() {
+        if (this.#pending.length === 0 && this.#active === 0) {
+            return;
+        }
+        await new Promise((resolve) => this.#drainWaiters.push(resolve));
+    }
+    #process() {
+        while (this.#active < this.#concurrency) {
+            const job = this.#pending.shift();
+            if (!job) {
+                this.#resolveDrainWaiters();
+                return;
+            }
+            this.#active += 1;
+            void this.#run(job);
+        }
+    }
+    async #run(job) {
+        try {
+            await this.#handler(job);
+        }
+        catch (error) {
+            await this.#onFailure?.(job, error);
+        }
+        finally {
+            this.#active -= 1;
+            this.#process();
+        }
+    }
+    #resolveDrainWaiters() {
+        if (this.#active !== 0 || this.#pending.length !== 0) {
+            return;
+        }
+        const waiters = this.#drainWaiters;
+        this.#drainWaiters = [];
+        waiters.forEach((resolve) => resolve());
+    }
+}
+//# sourceMappingURL=memory_queue.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,53 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Readable } from 'node:stream';
+import type { AttachmentDraft, CreateAttachmentInput } from '../core/attachment.js';
+import type { AttachmentPersistenceOptions } from '../core/attachment_options.js';
+import type { AttachmentService } from '../core/attachment_service.js';
+export type MultipartAttachmentFile = {
+    tmpPath?: string;
+    clientName: string;
+    type?: string;
+    subtype?: string;
+};
+export type AttachmentSourceOptions = AttachmentPersistenceOptions & {
+    originalName?: string;
+    mimeType?: string;
+    metadata?: CreateAttachmentInput['metadata'];
+    maxBytes?: number;
+};
+export type AttachmentSourceResponse = {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Pick<Headers, 'get'>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+};
+export type AttachmentSourceFetch = (input: URL | string) => Promise<AttachmentSourceResponse>;
+export type AttachmentManagerOptions = {
+    maxBytes?: number;
+    fetch?: AttachmentSourceFetch;
+};
+/**
+ * Normalizes common input sources into drafts. The file is written only when the
+ * caller invokes `draft.persist()` or an integration persists it automatically.
+ */
+export declare class AttachmentManager {
+    #private;
+    constructor(attachments: Pick<AttachmentService, 'createDraft'>, options?: AttachmentManagerOptions);
+    createFromBuffer(input: Uint8Array, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
+    createFromBase64(input: string, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
+    createFromPath(input: string, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
+    createFromStream(input: Readable, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
+    createFromUrl(input: URL | string, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
+    createFromFile(input: MultipartAttachmentFile, options?: AttachmentSourceOptions): Promise<AttachmentDraft>;
+    createFromFiles(inputs: readonly MultipartAttachmentFile[], options?: AttachmentSourceOptions): Promise<AttachmentDraft[]>;
+}
+export declare class AttachmentSourceError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=attachment_manager.d.ts.map

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

@@ -0,0 +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"}