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

package/build/commands/make/attachment_v5_migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment_v5_migration.d.ts","sourceRoot":"","sources":["../../../commands/make/attachment_v5_migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAIhD,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,MAAM,CAAC,WAAW,SAAiC;IACnD,MAAM,CAAC,WAAW,SAA4D;IAC9E,MAAM,CAAC,OAAO;;;MAGb;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3B"}
+{"version":3,"file":"attachment_v5_migration.d.ts","sourceRoot":"","sources":["../../../commands/make/attachment_v5_migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKhD,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,MAAM,CAAC,WAAW,SAAiC;IACnD,MAAM,CAAC,WAAW,SAA4D;IAC9E,MAAM,CAAC,OAAO;;;MAGb;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAY3B"}

package/build/commands/make/attachment_v5_migration.js

@@ -5,7 +5,8 @@
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
 import { BaseCommand } from '@adonisjs/core/ace';
-import { createLegacyAttachmentMigrationScript } from '../../src/integrations/lucid/create_legacy_attachment_migration_script.js';
+import { stubsRoot } from '../../stubs/main.js';
+import { createLegacyAttachmentMigrationStubState } from '../../src/integrations/lucid/migrations/legacy/legacy_attachment_migration_stub.js';
 export default class MakeAttachmentV5Migration extends BaseCommand {
     static commandName = 'make:attachment-v5-migration';
     static description = 'Create a script for migrating v5 attachment JSON values';
@@ -16,11 +17,13 @@ export default class MakeAttachmentV5Migration extends BaseCommand {
     async run() {
         const flags = this.parsed.flags;
         const folder = flags.folder ?? 'database/scripts';
-        const filePath = await createLegacyAttachmentMigrationScript({
+        const state = createLegacyAttachmentMigrationStubState({
             directory: this.app.makePath(folder),
             ...(flags.disk ? { defaultDisk: flags.disk } : {}),
         });
-        this.logger.success(`Created ${filePath}`);
+        const codemods = await this.createCodemods();
+        await codemods.makeUsingStub(stubsRoot, 'migrations/legacy_attachment_migration.stub', state);
+        this.logger.success(`Created ${state.destination}`);
     }
 }
 //# sourceMappingURL=attachment_v5_migration.js.map

package/build/commands/make/attachment_v5_migration.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment_v5_migration.js","sourceRoot":"","sources":["../../../commands/make/attachment_v5_migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,qCAAqC,EAAE,MAAM,2EAA2E,CAAA;AAEjI,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,MAAM,CAAC,WAAW,GAAG,8BAA8B,CAAA;IACnD,MAAM,CAAC,WAAW,GAAG,yDAAyD,CAAA;IAC9E,MAAM,CAAC,OAAO,GAAG;QACf,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;KACxB,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAA2C,CAAA;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,kBAAkB,CAAA;QACjD,MAAM,QAAQ,GAAG,MAAM,qCAAqC,CAAC;YAC3D,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAA;IAC5C,CAAC"}
+{"version":3,"file":"attachment_v5_migration.js","sourceRoot":"","sources":["../../../commands/make/attachment_v5_migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,wCAAwC,EAAE,MAAM,oFAAoF,CAAA;AAE7I,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,MAAM,CAAC,WAAW,GAAG,8BAA8B,CAAA;IACnD,MAAM,CAAC,WAAW,GAAG,yDAAyD,CAAA;IAC9E,MAAM,CAAC,OAAO,GAAG;QACf,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;KACxB,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAA2C,CAAA;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,kBAAkB,CAAA;QACjD,MAAM,KAAK,GAAG,wCAAwC,CAAC;YACrD,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;QAE5C,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,6CAA6C,EAAE,KAAK,CAAC,CAAA;QAC7F,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACrD,CAAC"}

package/build/commands/make/attachments_table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments_table.d.ts","sourceRoot":"","sources":["../../../commands/make/attachments_table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKhD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,WAAW;IAC3D,MAAM,CAAC,WAAW,SAA2B;IAC7C,MAAM,CAAC,WAAW,SAAuD;IACzE,MAAM,CAAC,OAAO;;;MAGb;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3B"}
+{"version":3,"file":"attachments_table.d.ts","sourceRoot":"","sources":["../../../commands/make/attachments_table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAQhD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,WAAW;IAC3D,MAAM,CAAC,WAAW,SAA2B;IAC7C,MAAM,CAAC,WAAW,SAAuD;IACzE,MAAM,CAAC,OAAO;;;MAGb;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3B"}

package/build/commands/make/attachments_table.js

@@ -5,8 +5,9 @@
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
 import { BaseCommand } from '@adonisjs/core/ace';
+import { configProvider } from '@adonisjs/core';
 import { stubsRoot } from '../../stubs/main.js';
-import { createAttachmentsTableStubState } from '../../src/integrations/lucid/attachments_table_stub.js';
+import { createAttachmentsTableStubState } from '../../src/integrations/lucid/schema/attachments_table_stub.js';
 export default class MakeAttachmentsTable extends BaseCommand {
     static commandName = 'make:attachments-table';
     static description = 'Create the polymorphic attachments table migration';
@@ -16,7 +17,7 @@ export default class MakeAttachmentsTable extends BaseCommand {
     };
     async run() {
         const flags = this.parsed.flags;
-        const tableName = flags.table ?? 'attachments';
+        const tableName = flags.table ?? (await configuredTableName(this.app));
         const folder = flags.folder ?? 'database/migrations';
         const state = createAttachmentsTableStubState({
             directory: this.app.makePath(folder),
@@ -27,4 +28,9 @@ export default class MakeAttachmentsTable extends BaseCommand {
         this.logger.success(`Created ${state.destination}`);
     }
 }
+async function configuredTableName(app) {
+    const attachmentConfig = app.config.get('attachment');
+    const config = await configProvider.resolve(app, attachmentConfig);
+    return config?.integrations?.lucid?.tableName ?? 'attachments';
+}
 //# sourceMappingURL=attachments_table.js.map

package/build/commands/make/attachments_table.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachments_table.js","sourceRoot":"","sources":["../../../commands/make/attachments_table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,wDAAwD,CAAA;AAExG,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,WAAW;IAC3D,MAAM,CAAC,WAAW,GAAG,wBAAwB,CAAA;IAC7C,MAAM,CAAC,WAAW,GAAG,oDAAoD,CAAA;IACzE,MAAM,CAAC,OAAO,GAAG;QACf,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;KACxB,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAA4C,CAAA;QACtE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,aAAa,CAAA;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,qBAAqB,CAAA;QACpD,MAAM,KAAK,GAAG,+BAA+B,CAAC;YAC5C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpC,SAAS;SACV,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;QAE5C,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mCAAmC,EAAE,KAAK,CAAC,CAAA;QACnF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACrD,CAAC"}
+{"version":3,"file":"attachments_table.js","sourceRoot":"","sources":["../../../commands/make/attachments_table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,+DAA+D,CAAA;AAI/G,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,WAAW;IAC3D,MAAM,CAAC,WAAW,GAAG,wBAAwB,CAAA;IAC7C,MAAM,CAAC,WAAW,GAAG,oDAAoD,CAAA;IACzE,MAAM,CAAC,OAAO,GAAG;QACf,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;KACxB,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAA4C,CAAA;QACtE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACtE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,qBAAqB,CAAA;QACpD,MAAM,KAAK,GAAG,+BAA+B,CAAC;YAC5C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpC,SAAS;SACV,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;QAE5C,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mCAAmC,EAAE,KAAK,CAAC,CAAA;QACnF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACrD,CAAC;;AAGH,KAAK,UAAU,mBAAmB,CAAC,GAAuB;IACxD,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAA2B,GAAG,EAAE,gBAAgB,CAAC,CAAA;IAE5F,OAAO,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,IAAI,aAAa,CAAA;AAChE,CAAC"}

package/build/index.d.ts

@@ -1,27 +1,28 @@
-import type { AttachmentService } from './src/core/attachment_service.js';
-import type { AttachmentRepository } from './src/core/attachment_repository.js';
-import type { AttachmentManager } from './src/sources/attachment_manager.js';
-import attachmentManager from './services/main.js';
-declare module '@adonisjs/core/types' {
+import type { AttachmentService } from "./src/core/attachment_service.js";
+import type { AttachmentRepository } from "./src/core/attachment_repository.js";
+import type { AttachmentManager } from "./src/sources/attachment_manager.js";
+import attachmentManager from "./services/main.js";
+declare module "@adonisjs/core/types" {
     interface ContainerBindings {
-        'jrmc.attachment': AttachmentService;
-        'jrmc.attachment.manager': AttachmentManager;
-        'jrmc.attachment.repository': AttachmentRepository;
+        "jrmc.attachment": AttachmentService;
+        "jrmc.attachment.manager": AttachmentManager;
+        "jrmc.attachment.repository": AttachmentRepository;
     }
 }
-export * from './src/core/index.js';
-export { configure } from './configure.js';
+export * from "./src/core/index.js";
+export { configure } from "./configure.js";
 export { attachmentManager };
-export { defineConfig, type AttachmentConfig, type ResolvedAttachmentConfig } from './src/define_config.js';
-export { AdonisDriveStorage } from './src/adapters/adonis_drive_storage.js';
-export { LocalFileStorage, type LocalFileStorageOptions } from './src/adapters/local_file_storage.js';
-export { attachment } from './src/integrations/lucid/attachment_column.js';
-export { VariantGenerationService, UnknownVariantConverterError, type GeneratedVariant, type VariantGenerationServiceOptions, } from './src/variants/variant_generation_service.js';
-export { type VariantConverter, type VariantConversionInput, type VariantConversionOutput, } from './src/variants/variant_converter.js';
-export { MemoryAttachmentQueue } from './src/queues/memory_queue.js';
-export { AttachmentManager, AttachmentSourceError, type AttachmentManagerOptions, type AttachmentSourceFetch, type AttachmentSourceOptions, type AttachmentSourceResponse, type MultipartAttachmentFile, } from './src/sources/attachment_manager.js';
-export { AdonisAttachmentQueue, type AdonisAttachmentJob, type AdonisAttachmentQueueOptions, type AdonisQueueDispatcher, } from './src/queues/adonis_queue.js';
-export { migrateLegacyAttachment, type AttachmentOwner, type LegacyAttachment, type LegacyVariant, type MigratedAttachmentRow, } from './src/integrations/lucid/migrate_legacy_attachment.js';
-export { createAttachmentOwnerKey } from './src/integrations/lucid/attachment_owner.js';
-export { createAttachmentsTableStubState } from './src/integrations/lucid/attachments_table_stub.js';
+export { defineConfig, type AttachmentIntegrationsConfig, type AttachmentConfig, type LucidAttachmentConfig, type ResolvedAttachmentConfig, } from "./src/define_config.js";
+export { AdonisDriveStorage } from "./src/adapters/adonis_drive_storage.js";
+export { LocalFileStorage, type LocalFileStorageOptions, } from "./src/adapters/local_file_storage.js";
+export { attachment, type LucidAttachmentOptions, } from "./src/integrations/lucid/column/attachment_column.js";
+export { attachmentRelation, attachmentsRelation, AttachmentRelation, AttachmentCollectionRelation, type AttachmentRelationOptions, } from "./src/integrations/lucid/relations/attachment_relation.js";
+export { VariantGenerationService, UnknownVariantConverterError, type GeneratedVariant, type VariantGenerationServiceOptions, } from "./src/variants/variant_generation_service.js";
+export { type VariantConverter, type VariantConversionInput, type VariantConversionOutput, } from "./src/variants/variant_converter.js";
+export { MemoryAttachmentQueue } from "./src/queues/memory_queue.js";
+export { AttachmentManager, AttachmentSourceError, type AttachmentManagerOptions, type AttachmentSourceFetch, type AttachmentSourceOptions, type AttachmentSourceResponse, type MultipartAttachmentFile, } from "./src/sources/attachment_manager.js";
+export { AdonisAttachmentQueue, type AdonisAttachmentJob, type AdonisAttachmentQueueOptions, type AdonisQueueDispatcher, } from "./src/queues/adonis_queue.js";
+export { migrateLegacyAttachment, migrateLegacyAttachmentColumn, type AttachmentOwner, type LegacyAttachment, type LegacyVariant, type MigrateLegacyAttachmentColumnOptions, type MigratedAttachmentBlob, type MigratedAttachmentLink, type MigratedAttachmentRows, } from "./src/integrations/lucid/migrations/legacy/migrate_legacy_attachment.js";
+export { createAttachmentOwnerKey } from "./src/integrations/lucid/relations/attachment_owner.js";
+export { createAttachmentsTableStubState } from "./src/integrations/lucid/schema/attachments_table_stub.js";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAE5E,OAAO,iBAAiB,MAAM,oBAAoB,CAAA;AAElD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAiB,iBAAiB;QAChC,iBAAiB,EAAE,iBAAiB,CAAA;QACpC,yBAAyB,EAAE,iBAAiB,CAAA;QAC5C,4BAA4B,EAAE,oBAAoB,CAAA;KACnD;CACF;AAED,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAA;AAC1E,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,GACrC,MAAM,8CAA8C,CAAA;AACrD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,uDAAuD,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAA;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AAEnD,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAiB,iBAAiB;QAChC,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,yBAAyB,EAAE,iBAAiB,CAAC;QAC7C,4BAA4B,EAAE,oBAAoB,CAAC;KACpD;CACF;AAED,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,KAAK,sBAAsB,GAC5B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,2DAA2D,CAAC;AACnE,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,GACrC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,oCAAoC,EACzC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,yEAAyE,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC"}

package/build/index.js

@@ -1,16 +1,17 @@
-import attachmentManager from './services/main.js';
-export * from './src/core/index.js';
-export { configure } from './configure.js';
+import attachmentManager from "./services/main.js";
+export * from "./src/core/index.js";
+export { configure } from "./configure.js";
 export { attachmentManager };
-export { defineConfig } from './src/define_config.js';
-export { AdonisDriveStorage } from './src/adapters/adonis_drive_storage.js';
-export { LocalFileStorage } from './src/adapters/local_file_storage.js';
-export { attachment } from './src/integrations/lucid/attachment_column.js';
-export { VariantGenerationService, UnknownVariantConverterError, } from './src/variants/variant_generation_service.js';
-export { MemoryAttachmentQueue } from './src/queues/memory_queue.js';
-export { AttachmentManager, AttachmentSourceError, } from './src/sources/attachment_manager.js';
-export { AdonisAttachmentQueue, } from './src/queues/adonis_queue.js';
-export { migrateLegacyAttachment, } from './src/integrations/lucid/migrate_legacy_attachment.js';
-export { createAttachmentOwnerKey } from './src/integrations/lucid/attachment_owner.js';
-export { createAttachmentsTableStubState } from './src/integrations/lucid/attachments_table_stub.js';
+export { defineConfig, } from "./src/define_config.js";
+export { AdonisDriveStorage } from "./src/adapters/adonis_drive_storage.js";
+export { LocalFileStorage, } from "./src/adapters/local_file_storage.js";
+export { attachment, } from "./src/integrations/lucid/column/attachment_column.js";
+export { attachmentRelation, attachmentsRelation, AttachmentRelation, AttachmentCollectionRelation, } from "./src/integrations/lucid/relations/attachment_relation.js";
+export { VariantGenerationService, UnknownVariantConverterError, } from "./src/variants/variant_generation_service.js";
+export { MemoryAttachmentQueue } from "./src/queues/memory_queue.js";
+export { AttachmentManager, AttachmentSourceError, } from "./src/sources/attachment_manager.js";
+export { AdonisAttachmentQueue, } from "./src/queues/adonis_queue.js";
+export { migrateLegacyAttachment, migrateLegacyAttachmentColumn, } from "./src/integrations/lucid/migrations/legacy/migrate_legacy_attachment.js";
+export { createAttachmentOwnerKey } from "./src/integrations/lucid/relations/attachment_owner.js";
+export { createAttachmentsTableStubState } from "./src/integrations/lucid/schema/attachments_table_stub.js";
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,iBAAiB,MAAM,oBAAoB,CAAA;AAUlD,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAwD,MAAM,wBAAwB,CAAA;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAgC,MAAM,sCAAsC,CAAA;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAA;AAC1E,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAG7B,MAAM,8CAA8C,CAAA;AAMrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAMtB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,qBAAqB,GAItB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,uBAAuB,GAKxB,MAAM,uDAAuD,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAA;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AAUnD,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,OAAO,EACL,YAAY,GAKb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EACL,gBAAgB,GAEjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,UAAU,GAEX,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,GAE7B,MAAM,2DAA2D,CAAC;AACnE,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAG7B,MAAM,8CAA8C,CAAC;AAMtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAMtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,qBAAqB,GAItB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAQ9B,MAAM,yEAAyE,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC"}

package/build/providers/attachment_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment_provider.d.ts","sourceRoot":"","sources":["../../providers/attachment_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACzB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ,IAAI,IAAI;IA2CV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB5B"}
+{"version":3,"file":"attachment_provider.d.ts","sourceRoot":"","sources":["../../providers/attachment_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG9D,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACzB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ,IAAI,IAAI;IAkDV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB5B"}

package/build/providers/attachment_provider.js

@@ -20,6 +20,7 @@ export default class AttachmentProvider {
             if (!config) {
                 throw new Error('Invalid attachment config. Export the result of defineConfig from config/attachment.ts');
             }
+            await applyLucidConfig(config);
             return new AttachmentService(config);
         });
         this.app.container.singleton('jrmc.attachment.repository', async () => {
@@ -28,11 +29,15 @@ export default class AttachmentProvider {
             if (!config?.repository) {
                 throw new Error('Attachment routes require a repository in config/attachment.ts');
             }
+            await applyLucidConfig(config);
             return config.repository;
         });
         this.app.container.singleton('jrmc.attachment.manager', async () => {
             const attachmentConfig = this.app.config.get('attachment');
             const config = await configProvider.resolve(this.app, attachmentConfig);
+            if (config) {
+                await applyLucidConfig(config);
+            }
             const attachments = await this.app.container.make('jrmc.attachment');
             return new AttachmentManager(attachments, config?.sources);
         });
@@ -40,6 +45,9 @@ export default class AttachmentProvider {
     async boot() {
         const attachmentConfig = this.app.config.get('attachment');
         const config = await configProvider.resolve(this.app, attachmentConfig);
+        if (config) {
+            await applyLucidConfig(config);
+        }
         if (!config || config.route === false || !config.repository) {
             return;
         }
@@ -51,4 +59,12 @@ export default class AttachmentProvider {
         });
     }
 }
+async function applyLucidConfig(config) {
+    const lucid = config.integrations?.lucid;
+    if (!lucid) {
+        return;
+    }
+    const { configureLucidAttachmentTables } = await import('../src/integrations/lucid/schema/configure_lucid_attachment_tables.js');
+    configureLucidAttachmentTables(lucid.tableName);
+}
 //# sourceMappingURL=attachment_provider.js.map

package/build/providers/attachment_provider.js.map

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

package/build/src/core/attachment.d.ts

@@ -4,6 +4,7 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
+import type { AttachmentPersistenceContext, AttachmentPersistenceOptions } from './attachment_options.js';
 export type Attachment = Readonly<{
     id: string;
     disk: string;
@@ -13,8 +14,13 @@ export type Attachment = Readonly<{
     size: number;
     extname: string;
     mimeType: string;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, unknown> | undefined;
 }>;
+export type AttachmentPersistRequest<Model = any> = {
+    options?: AttachmentPersistenceOptions<Model>;
+    context?: Omit<AttachmentPersistenceContext<Model>, 'originalName'>;
+};
+export type AttachmentDraftPersistence = (draft: AttachmentDraft, request?: AttachmentPersistRequest<any>) => Promise<Attachment>;
 export type CreateAttachmentInput = {
     body: Uint8Array;
     originalName: string;
@@ -23,6 +29,30 @@ export type CreateAttachmentInput = {
     folder?: string;
     metadata?: Record<string, unknown>;
 };
+/**
+ * A source-backed attachment that has not been written to storage yet.
+ * Its public properties become final after `persist()` resolves.
+ */
+export declare class AttachmentDraft implements Attachment {
+    #private;
+    readonly id: string;
+    disk: string;
+    name: string;
+    originalName: string;
+    path: string;
+    size: number;
+    extname: string;
+    mimeType: string;
+    metadata?: Record<string, unknown> | undefined;
+    constructor(source: CreateAttachmentInput, provisional: Attachment, options: AttachmentPersistenceOptions, persistence: AttachmentDraftPersistence);
+    get isPersisted(): boolean;
+    get source(): Readonly<CreateAttachmentInput>;
+    get options(): Readonly<AttachmentPersistenceOptions>;
+    persist(request?: AttachmentPersistRequest<any>): Promise<Attachment>;
+    toJSON(): Attachment;
+    toAttachment(): Attachment;
+}
+export declare function isAttachmentDraft(value: unknown): value is AttachmentDraft;
 export type AttachmentFactoryOptions = {
     defaultDisk: string;
     createId?: () => string;
@@ -30,6 +60,11 @@ export type AttachmentFactoryOptions = {
 export declare class AttachmentFactory {
     #private;
     constructor(options: AttachmentFactoryOptions);
-    create(input: CreateAttachmentInput): Attachment;
+    create(input: CreateAttachmentInput, options?: {
+        id?: string;
+        name?: string;
+        disk?: string;
+        folder?: string;
+    }): Attachment;
 }
 //# sourceMappingURL=attachment.d.ts.map

package/build/src/core/attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../../src/core/attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,UAAU,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,iBAAiB;;gBAIhB,OAAO,EAAE,wBAAwB;IAK7C,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU;CAkBjD"}
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../../src/core/attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,yBAAyB,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAC/C,CAAC,CAAA;AAEF,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,GAAG,IAAI;IAClD,OAAO,CAAC,EAAE,4BAA4B,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,CAAC,EAAE,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,CAAA;CACpE,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,wBAAwB,CAAC,GAAG,CAAC,KACpC,OAAO,CAAC,UAAU,CAAC,CAAA;AAExB,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,UAAU,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,UAAU;;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;gBAS5C,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,4BAA4B,EACrC,WAAW,EAAE,0BAA0B;IAkBzC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,MAAM,IAAI,QAAQ,CAAC,qBAAqB,CAAC,CAM5C;IAED,IAAI,OAAO,IAAI,QAAQ,CAAC,4BAA4B,CAAC,CAEpD;IAED,OAAO,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCrE,MAAM,IAAI,UAAU;IAQpB,YAAY,IAAI,UAAU;CAa3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,iBAAiB;;gBAIhB,OAAO,EAAE,wBAAwB;IAK7C,MAAM,CACJ,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,UAAU;CAkBd"}

package/build/src/core/attachment.js

@@ -6,6 +6,106 @@
  */
 import { randomUUID } from 'node:crypto';
 import { extname } from 'node:path';
+/**
+ * A source-backed attachment that has not been written to storage yet.
+ * Its public properties become final after `persist()` resolves.
+ */
+export class AttachmentDraft {
+    id;
+    disk;
+    name;
+    originalName;
+    path;
+    size;
+    extname;
+    mimeType;
+    metadata;
+    #options;
+    #source;
+    #persisted = false;
+    #persisting;
+    #persistence;
+    constructor(source, provisional, options, persistence) {
+        this.id = provisional.id;
+        this.disk = provisional.disk;
+        this.name = provisional.name;
+        this.originalName = provisional.originalName;
+        this.path = provisional.path;
+        this.size = provisional.size;
+        this.extname = provisional.extname;
+        this.mimeType = provisional.mimeType;
+        if (provisional.metadata) {
+            this.metadata = provisional.metadata;
+        }
+        this.#source = source;
+        this.#options = options;
+        this.#persistence = persistence;
+    }
+    get isPersisted() {
+        return this.#persisted;
+    }
+    get source() {
+        if (!this.#source) {
+            throw new Error('Attachment draft source is no longer available after persistence');
+        }
+        return this.#source;
+    }
+    get options() {
+        return this.#options;
+    }
+    persist(request) {
+        if (this.#persisted) {
+            return Promise.resolve(this);
+        }
+        if (!this.#persisting) {
+            this.#persisting = this.#persistence(this, request)
+                .then((attachment) => {
+                this.disk = attachment.disk;
+                this.name = attachment.name;
+                this.path = attachment.path;
+                this.size = attachment.size;
+                this.extname = attachment.extname;
+                this.mimeType = attachment.mimeType;
+                if (attachment.metadata) {
+                    this.metadata = attachment.metadata;
+                }
+                else {
+                    delete this.metadata;
+                }
+                this.#source = undefined;
+                this.#persisted = true;
+                return this;
+            })
+                .catch((error) => {
+                this.#persisting = undefined;
+                throw error;
+            });
+        }
+        return this.#persisting;
+    }
+    toJSON() {
+        if (!this.#persisted) {
+            throw new Error('Attachment drafts must be persisted before serialization');
+        }
+        return this.toAttachment();
+    }
+    toAttachment() {
+        return {
+            id: this.id,
+            disk: this.disk,
+            name: this.name,
+            originalName: this.originalName,
+            path: this.path,
+            size: this.size,
+            extname: this.extname,
+            mimeType: this.mimeType,
+            ...(this.metadata ? { metadata: this.metadata } : {}),
+        };
+    }
+}
+export function isAttachmentDraft(value) {
+    return value instanceof AttachmentDraft;
+}
 export class AttachmentFactory {
     #defaultDisk;
     #createId;
@@ -13,14 +113,14 @@ export class AttachmentFactory {
         this.#defaultDisk = options.defaultDisk;
         this.#createId = options.createId ?? randomUUID;
     }
-    create(input) {
-        const id = this.#createId();
+    create(input, options = {}) {
+        const id = options.id ?? this.#createId();
         const extension = getExtension(input.originalName);
-        const name = extension ? `${id}.${extension}` : id;
-        const path = joinPath(input.folder, name);
+        const name = options.name ?? (extension ? `${id}.${extension}` : id);
+        const path = joinPath(options.folder ?? input.folder, name);
         return {
             id,
-            disk: input.disk ?? this.#defaultDisk,
+            disk: options.disk ?? input.disk ?? this.#defaultDisk,
             name,
             originalName: input.originalName,
             path,
@@ -35,6 +135,9 @@ function getExtension(fileName) {
     return extname(fileName).slice(1).toLowerCase();
 }
 function joinPath(folder, name) {
+    if (name.includes('/') || name.includes('\\') || name === '.' || name === '..') {
+        throw new Error('Attachment names must not contain path separators');
+    }
     if (!folder) {
         return name;
     }

package/build/src/core/attachment.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../../src/core/attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA4BnC,MAAM,OAAO,iBAAiB;IACnB,YAAY,CAAQ;IACpB,SAAS,CAAc;IAEhC,YAAY,OAAiC;QAC3C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAA;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAA;IACjD,CAAC;IAED,MAAM,CAAC,KAA4B;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC3B,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAClD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAEzC,OAAO;YACL,EAAE;YACF,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY;YACrC,IAAI;YACJ,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,IAAI;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,0BAA0B;YACtD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAA;IACH,CAAC;CACF;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,MAA0B,EAAE,IAAY;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IAE/E,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACtF,CAAC;IAED,OAAO,GAAG,gBAAgB,IAAI,IAAI,EAAE,CAAA;AACtC,CAAC"}
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../../src/core/attachment.ts"],"names":[],"mappings":"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"}

package/build/src/core/attachment_options.d.ts

@@ -0,0 +1,32 @@
+export type AttachmentPersistenceContext<Model = unknown> = {
+    model?: Model;
+    field?: string;
+    originalName: string;
+};
+export type AttachmentFolder<Model = unknown> = string | ((context: AttachmentPersistenceContext<Model>) => string | Promise<string>);
+export type AttachmentRename<Model = unknown> = boolean | ((context: AttachmentPersistenceContext<Model>) => string | Promise<string>);
+/**
+ * File-persistence settings. `null` explicitly disables an inherited setting.
+ */
+export type AttachmentPersistenceOptions<Model = unknown> = {
+    disk?: string | null;
+    folder?: AttachmentFolder<Model> | null;
+    rename?: AttachmentRename<Model> | null;
+    meta?: boolean | null;
+    preComputeUrl?: boolean | null;
+    variants?: readonly string[] | null;
+};
+export type ResolvedAttachmentPersistenceOptions<Model = unknown> = {
+    disk?: string;
+    folder?: AttachmentFolder<Model>;
+    rename?: AttachmentRename<Model>;
+    meta?: boolean;
+    preComputeUrl?: boolean;
+    variants?: readonly string[];
+};
+/**
+ * Resolves options from lowest to highest priority. An explicit `null` clears
+ * the inherited value for one setting.
+ */
+export declare function resolveAttachmentPersistenceOptions<Model = unknown>(...layers: ReadonlyArray<AttachmentPersistenceOptions<Model> | undefined>): ResolvedAttachmentPersistenceOptions<Model>;
+//# sourceMappingURL=attachment_options.d.ts.map

package/build/src/core/attachment_options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_options.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,4BAA4B,CAAC,KAAK,GAAG,OAAO,IAAI;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IACxC,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,4BAA4B,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhF,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IACxC,OAAO,GACP,CAAC,CAAC,OAAO,EAAE,4BAA4B,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhF;;GAEG;AACH,MAAM,MAAM,4BAA4B,CAAC,KAAK,GAAG,OAAO,IAAI;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACrB,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,oCAAoC,CAAC,KAAK,GAAG,OAAO,IAAI;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,GAAG,OAAO,EACjE,GAAG,MAAM,EAAE,aAAa,CAAC,4BAA4B,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,GACxE,oCAAoC,CAAC,KAAK,CAAC,CAS7C"}

package/build/src/core/attachment_options.js

@@ -0,0 +1,24 @@
+/**
+ * Resolves options from lowest to highest priority. An explicit `null` clears
+ * the inherited value for one setting.
+ */
+export function resolveAttachmentPersistenceOptions(...layers) {
+    return {
+        ...resolveOption('disk', layers),
+        ...resolveOption('folder', layers),
+        ...resolveOption('rename', layers),
+        ...resolveOption('meta', layers),
+        ...resolveOption('preComputeUrl', layers),
+        ...resolveOption('variants', layers),
+    };
+}
+function resolveOption(key, layers) {
+    for (const layer of [...layers].reverse()) {
+        const value = layer?.[key];
+        if (value !== undefined) {
+            return value === null ? {} : { [key]: value };
+        }
+    }
+    return {};
+}
+//# sourceMappingURL=attachment_options.js.map

package/build/src/core/attachment_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_options.js","sourceRoot":"","sources":["../../../src/core/attachment_options.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CACjD,GAAG,MAAsE;IAEzE,OAAO;QACL,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QAChC,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;QAClC,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;QAClC,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QAChC,GAAG,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC;QACzC,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC;KACrC,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CACpB,GAAQ,EACR,MAAsE;IAEtE,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;QAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC"}

package/build/src/core/attachment_service.d.ts

@@ -4,7 +4,8 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-import { type Attachment, type CreateAttachmentInput } from './attachment.js';
+import { AttachmentDraft, type Attachment, type CreateAttachmentInput } from './attachment.js';
+import { type AttachmentPersistenceOptions } from './attachment_options.js';
 import type { AttachmentQueue } from './queue.js';
 import type { AttachmentStorage } from './storage.js';
 export type AttachmentServiceOptions = {
@@ -12,6 +13,7 @@ export type AttachmentServiceOptions = {
     queue: AttachmentQueue;
     defaultDisk: string;
     createId?: () => string;
+    defaults?: AttachmentPersistenceOptions;
 };
 /**
  * Creates files and delegates persistence to the configured storage backend.
@@ -20,6 +22,10 @@ export type AttachmentServiceOptions = {
 export declare class AttachmentService {
     #private;
     constructor(options: AttachmentServiceOptions);
+    createDraft(input: CreateAttachmentInput, options?: AttachmentPersistenceOptions): AttachmentDraft;
+    /**
+     * Backward-compatible immediate persistence for direct service consumers.
+     */
     create(input: CreateAttachmentInput): Promise<Attachment>;
     remove(attachment: Attachment): Promise<void>;
     read(attachment: Attachment): Promise<Uint8Array>;

package/build/src/core/attachment_service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment_service.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB,CAAA;AAED;;;GAGG;AACH,qBAAa,iBAAiB;;gBAKhB,OAAO,EAAE,wBAAwB;IAMvC,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAc/D,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjD,yBAAyB,CACvB,UAAU,EAAE,UAAU,EACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;CAOjB"}
+{"version":3,"file":"attachment_service.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EAEf,KAAK,UAAU,EAEf,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAIL,KAAK,4BAA4B,EAElC,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,4BAA4B,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,qBAAa,iBAAiB;;gBAMhB,OAAO,EAAE,wBAAwB;IAO7C,WAAW,CACT,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,eAAe;IAgBlB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAmC/D,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjD,yBAAyB,CACvB,UAAU,EAAE,UAAU,EACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;CAOjB"}