@contember/bindx-uploader 0.1.0

package/dist/internal/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { useUploadState, type UseUploadStateResult } from './useUploadState.js';
+export { useUploaderDoUpload } from './useUploaderDoUpload.js';
+export { useGetPreviewUrls } from './useGetPreviewUrls.js';
+export { useFillEntity, type UseFillEntityArgs } from './useFillEntity.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/internal/hooks/useFillEntity.d.ts

@@ -0,0 +1,17 @@
+import type { EntityRef, HasOneRef } from '@contember/bindx';
+import type { FileType, UploaderEvents } from '../../types.js';
+export interface UseFillEntityArgs<TEntity = Record<string, unknown>> extends UploaderEvents {
+    /**
+     * The entity to fill. Can be:
+     * - EntityRef: fill the entity directly
+     * - HasOneRef: fill the related entity (disconnect first on upload start)
+     */
+    entity: EntityRef<TEntity> | HasOneRef<TEntity>;
+    fileType: FileType<TEntity>;
+}
+/**
+ * Hook that connects upload events to entity field population.
+ * Handles both direct EntityRef and HasOneRef (for has-one relations).
+ */
+export declare const useFillEntity: <TEntity extends Record<string, unknown>>({ entity, fileType, ...events }: UseFillEntityArgs<TEntity>) => UploaderEvents;
+//# sourceMappingURL=useFillEntity.d.ts.map

package/dist/internal/hooks/useFillEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFillEntity.d.ts","sourceRoot":"","sources":["../../../src/internal/hooks/useFillEntity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAoB,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAIhF,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,cAAc;IAC3F;;;;OAIG;IACH,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAC/C,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CAC3B;AAoBD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,iCAIpE,iBAAiB,CAAC,OAAO,CAAC,KAAG,cA8C/B,CAAA"}

package/dist/internal/hooks/useGetPreviewUrls.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hook that manages preview URL creation and cleanup.
+ * Returns a function that creates object URLs for file preview.
+ */
+export declare const useGetPreviewUrls: () => ((file: File) => string);
+//# sourceMappingURL=useGetPreviewUrls.d.ts.map

package/dist/internal/hooks/useGetPreviewUrls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetPreviewUrls.d.ts","sourceRoot":"","sources":["../../../src/internal/hooks/useGetPreviewUrls.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAmB3D,CAAA"}

package/dist/internal/hooks/useUploadState.d.ts

@@ -0,0 +1,12 @@
+import type { UploaderEvents, UploaderState } from '../../types.js';
+export interface UseUploadStateResult extends UploaderEvents {
+    files: UploaderState;
+    purgeFinal: () => void;
+    purgeAll: () => void;
+}
+/**
+ * Hook that manages the upload state machine.
+ * Tracks file states through the upload lifecycle: initial -> uploading -> finalizing -> success/error
+ */
+export declare const useUploadState: ({ onBeforeUpload, onStartUpload, onSuccess, onError, onProgress, onAfterUpload, }: UploaderEvents) => UseUploadStateResult;
+//# sourceMappingURL=useUploadState.d.ts.map

package/dist/internal/hooks/useUploadState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUploadState.d.ts","sourceRoot":"","sources":["../../../src/internal/hooks/useUploadState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAOX,cAAc,EAEd,aAAa,EACb,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC3D,KAAK,EAAE,aAAa,CAAA;IACpB,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,mFAO5B,cAAc,KAAG,oBAgInB,CAAA"}

package/dist/internal/hooks/useUploaderDoUpload.d.ts

@@ -0,0 +1,7 @@
+import type { UploaderEvents } from '../../types.js';
+/**
+ * Hook that orchestrates the file upload process.
+ * Handles file preparation, validation, and upload execution.
+ */
+export declare const useUploaderDoUpload: ({ onBeforeUpload, onError, onProgress, onSuccess, onStartUpload, onAfterUpload, }: UploaderEvents) => ((files: File[]) => Promise<void>);
+//# sourceMappingURL=useUploaderDoUpload.d.ts.map

package/dist/internal/hooks/useUploaderDoUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUploaderDoUpload.d.ts","sourceRoot":"","sources":["../../../src/internal/hooks/useUploaderDoUpload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAKlE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,mFAOjC,cAAc,KAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CA+GpD,CAAA"}

package/dist/internal/utils/executeExtractors.d.ts

@@ -0,0 +1,16 @@
+import type { EntityRef } from '@contember/bindx';
+import type { FileType, FileWithMeta, FileUploadResult } from '../../types.js';
+interface ExecuteExtractorsArgs {
+    fileType: FileType;
+    file: FileWithMeta;
+    result: FileUploadResult;
+}
+/**
+ * Executes all extractors for a file type and returns a populator function
+ * that can be used to fill entity fields.
+ */
+export declare const executeExtractors: ({ fileType, file, result, }: ExecuteExtractorsArgs) => Promise<((options: {
+    entity: EntityRef<unknown>;
+}) => void) | undefined>;
+export {};
+//# sourceMappingURL=executeExtractors.d.ts.map

package/dist/internal/utils/executeExtractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeExtractors.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/executeExtractors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE9E,UAAU,qBAAqB;IAC9B,QAAQ,EAAE,QAAQ,CAAA;IAClB,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAU,6BAIrC,qBAAqB,KAAG,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CA4BjG,CAAA"}

package/dist/internal/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveAcceptingSingleType } from './resolveAccept.js';
+export { executeExtractors } from './executeExtractors.js';
+export { uploaderErrorHandler } from './uploaderErrorHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/internal/utils/resolveAccept.d.ts

@@ -0,0 +1,7 @@
+import type { FileType, FileWithMeta } from '../../types.js';
+/**
+ * Checks if a file is accepted by a single file type.
+ * Returns false if rejected, true if accepted.
+ */
+export declare const resolveAcceptingSingleType: (file: FileWithMeta, fileType: FileType) => Promise<boolean>;
+//# sourceMappingURL=resolveAccept.d.ts.map

package/dist/internal/utils/resolveAccept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAccept.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/resolveAccept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG5D;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACtC,MAAM,YAAY,EAClB,UAAU,QAAQ,KAChB,OAAO,CAAC,OAAO,CAejB,CAAA"}

package/dist/internal/utils/uploaderErrorHandler.d.ts

@@ -0,0 +1,7 @@
+import type { ErrorEvent } from '../../types.js';
+/**
+ * Default error handler that filters out expected errors (fileRejected, aborted)
+ * and logs unexpected errors.
+ */
+export declare const uploaderErrorHandler: (event: ErrorEvent) => void;
+//# sourceMappingURL=uploaderErrorHandler.d.ts.map

package/dist/internal/utils/uploaderErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploaderErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/internal/utils/uploaderErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,UAAU,KAAG,IAOxD,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+import type { EntityRef } from '@contember/bindx';
+export interface UploadClient<Options = unknown, Result extends FileUploadResult = FileUploadResult> {
+    upload: (args: UploadClientUploadArgs & Omit<Options, keyof UploadClientUploadArgs>) => Promise<Result>;
+}
+export interface FileUploadResult {
+    publicUrl: string;
+}
+export interface FileUploadProgress {
+    progress: number;
+    uploadedBytes: number;
+    totalBytes: number;
+}
+export interface UploadClientUploadArgs {
+    file: File;
+    signal: AbortSignal;
+    onProgress: (progress: FileUploadProgress) => void;
+}
+export interface FileWithMeta {
+    id: string;
+    file: File;
+    previewUrl: string;
+    abortController: AbortController;
+}
+export interface UploaderFileStateInitial {
+    state: 'initial';
+    file: FileWithMeta;
+}
+export interface UploaderFileStateUploading {
+    state: 'uploading';
+    file: FileWithMeta;
+    progress: FileUploadProgress;
+}
+export interface UploaderFileStateFinalizing {
+    state: 'finalizing';
+    file: FileWithMeta;
+    result: FileUploadResult;
+}
+export interface UploaderFileStateSuccess {
+    state: 'success';
+    file: FileWithMeta;
+    result: FileUploadResult;
+    dismiss: () => void;
+}
+export interface UploaderFileStateError {
+    state: 'error';
+    file: FileWithMeta;
+    error: unknown;
+    dismiss: () => void;
+}
+export type UploaderFileState = UploaderFileStateInitial | UploaderFileStateUploading | UploaderFileStateFinalizing | UploaderFileStateSuccess | UploaderFileStateError;
+export type UploaderState = UploaderFileState[];
+export interface BeforeUploadEvent {
+    file: FileWithMeta;
+    reject: (reason: string) => never;
+}
+export interface StartUploadEvent {
+    file: FileWithMeta;
+    fileType: FileType;
+}
+export interface ProgressEvent {
+    file: FileWithMeta;
+    progress: FileUploadProgress;
+    fileType: FileType;
+}
+export interface SuccessEvent {
+    file: FileWithMeta;
+    result: FileUploadResult;
+    fileType: FileType;
+}
+export interface AfterUploadEvent {
+    file: FileWithMeta;
+    result: FileUploadResult;
+    fileType: FileType;
+}
+export interface ErrorEvent {
+    file: FileWithMeta;
+    error: unknown;
+    fileType?: FileType;
+}
+export interface UploaderEvents {
+    onBeforeUpload: (event: BeforeUploadEvent) => Promise<FileType | undefined>;
+    onStartUpload: (event: StartUploadEvent) => void;
+    onProgress: (event: ProgressEvent) => void;
+    onAfterUpload: (event: AfterUploadEvent) => Promise<void> | void;
+    onSuccess: (event: SuccessEvent) => void;
+    onError: (event: ErrorEvent) => void;
+}
+/**
+ * Extract string keys from entity type (field names).
+ */
+export type FieldName<TEntity> = keyof TEntity & string;
+/**
+ * Result from file data extraction that can populate entity fields
+ */
+export type FileDataExtractorPopulator<TEntity> = (options: {
+    entity: EntityRef<TEntity>;
+    result: FileUploadResult;
+}) => void;
+/**
+ * File data extractor interface for bindx.
+ * Provides field names for selection collection and data extraction/population methods.
+ */
+export interface FileDataExtractor<TEntity = Record<string, unknown>> {
+    /**
+     * Returns the field names this extractor will populate.
+     * Used by the selection system to know which fields to fetch.
+     */
+    getFieldNames: () => FieldName<TEntity>[];
+    /**
+     * Extract data from the file (async, e.g., image dimensions)
+     */
+    extractFileData?: (file: FileWithMeta) => Promise<FileDataExtractorPopulator<TEntity> | undefined> | FileDataExtractorPopulator<TEntity> | undefined;
+    /**
+     * Populate entity fields synchronously (e.g., URL field from upload result)
+     */
+    populateFields?: (options: {
+        entity: EntityRef<TEntity>;
+        result: FileUploadResult;
+    }) => void;
+}
+/**
+ * Configuration for a file type that defines how files are handled.
+ */
+export interface FileType<TEntity = Record<string, unknown>> {
+    /**
+     * Accepted MIME types and extensions.
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/window/showOpenFilePicker#accept
+     * undefined means "any mime type"
+     */
+    accept?: Record<string, string[]> | undefined;
+    /**
+     * Custom file validation. Optionally reject with rejection reason.
+     */
+    acceptFile?: ((file: FileWithMeta) => boolean | Promise<void>) | undefined;
+    /**
+     * Data extractors for this file type
+     */
+    extractors?: FileDataExtractor<TEntity>[];
+    /**
+     * Custom upload client (overrides default)
+     */
+    uploader?: UploadClient<unknown>;
+}
+/**
+ * File type with optional base field for discriminated uploads.
+ */
+export interface DiscriminatedFileType<TEntity = Record<string, unknown>> extends FileType<TEntity> {
+    /**
+     * Base field name for has-one relation (e.g., 'image' for article.image)
+     */
+    baseField?: string;
+}
+/**
+ * Map of discriminator values to file types for polymorphic file handling.
+ */
+export type DiscriminatedFileTypeMap<TEntity = Record<string, unknown>> = Record<string, DiscriminatedFileType<TEntity>>;
+export interface UploaderOptions {
+    accept?: Record<string, string[]>;
+    multiple: boolean;
+}
+export type UploaderErrorType = 'fileRejected' | 'networkError' | 'httpError' | 'aborted' | 'timeout';
+export interface UploaderErrorOptions {
+    type: UploaderErrorType;
+    endUserMessage?: string;
+    developerMessage?: string;
+    error?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmC,MAAM,kBAAkB,CAAA;AAMlF,MAAM,WAAW,YAAY,CAC5B,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,gBAAgB,GAAG,gBAAgB;IAElD,MAAM,EAAE,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,sBAAsB,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACvG;AAED,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;CAClD;AAMD,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,eAAe,CAAA;CAChC;AAMD,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,YAAY,CAAA;CAClB;AAED,MAAM,WAAW,0BAA0B;IAC1C,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,kBAAkB,CAAA;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC3C,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;CACxB;AAED,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,MAAM,iBAAiB,GAC1B,wBAAwB,GACxB,0BAA0B,GAC1B,2BAA2B,GAC3B,wBAAwB,GACxB,sBAAsB,CAAA;AAEzB,MAAM,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAA;AAM/C,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,QAAQ,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;IAC3E,aAAa,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAC1C,aAAa,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChE,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IACxC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACpC;AAMD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,OAAO,IAAI,MAAM,OAAO,GAAG,MAAM,CAAA;AAEvD;;GAEG;AACH,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE;IAC3D,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;IAC1B,MAAM,EAAE,gBAAgB,CAAA;CACxB,KAAK,IAAI,CAAA;AAEV;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE;;;OAGG;IACH,aAAa,EAAE,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAA;IAEzC;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,GAAG,0BAA0B,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;IAEpJ;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAA;CAC5F;AAMD;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,CAAA;IAE7C;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IAE1E;;OAEG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAA;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,QAAQ,CAAC,OAAO,CAAC;IAClG;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAA;AAMxH,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACjC,QAAQ,EAAE,OAAO,CAAA;CACjB;AAMD,MAAM,MAAM,iBAAiB,GAC1B,cAAc,GACd,cAAc,GACd,WAAW,GACX,SAAS,GACT,SAAS,CAAA;AAEZ,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,iBAAiB,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf"}

package/dist/uploadClient/S3UploadClient.d.ts

@@ -0,0 +1,19 @@
+import type { UploadClient, UploadClientUploadArgs } from '../types.js';
+import type { S3FileParameters, S3UrlSigner } from './types.js';
+export interface S3UploadClientOptions {
+    signUrl: S3UrlSigner;
+    getUploadOptions?: (file: File) => Partial<S3FileParameters>;
+    concurrency?: number;
+}
+export type S3FileOptions = Partial<S3FileParameters>;
+export declare class S3UploadClient implements UploadClient<S3FileOptions> {
+    readonly options: S3UploadClientOptions;
+    private activeCount;
+    private resolverQueue;
+    constructor(options: S3UploadClientOptions);
+    upload({ file, signal, onProgress, ...options }: UploadClientUploadArgs & S3FileOptions): Promise<{
+        publicUrl: string;
+    }>;
+    private uploadSingleFile;
+}
+//# sourceMappingURL=S3UploadClient.d.ts.map

package/dist/uploadClient/S3UploadClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3UploadClient.d.ts","sourceRoot":"","sources":["../../src/uploadClient/S3UploadClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAuB,WAAW,EAAE,MAAM,YAAY,CAAA;AAGpF,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,WAAW,CAAA;IACpB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAErD,qBAAa,cAAe,YAAW,YAAY,CAAC,aAAa,CAAC;aAI9B,OAAO,EAAE,qBAAqB;IAHjE,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,aAAa,CAAwB;gBAEV,OAAO,EAAE,qBAAqB;IAEpD,MAAM,CAAC,EACnB,IAAI,EACJ,MAAM,EACN,UAAU,EACV,GAAG,OAAO,EACV,EAAE,sBAAsB,GAAG,aAAa,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;YAe5D,gBAAgB;CAgB9B"}

package/dist/uploadClient/index.d.ts

@@ -0,0 +1,3 @@
+export { S3UploadClient, type S3UploadClientOptions, type S3FileOptions } from './S3UploadClient.js';
+export type { S3Acl, S3FileParameters, S3SignedUrlResponse, S3UrlSigner } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/uploadClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uploadClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACpG,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/uploadClient/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * S3 upload URL signing types.
+ * These types mirror @contember/client's GenerateUploadUrlMutationBuilder types
+ * but are self-contained for bindx-uploader.
+ */
+export type S3Acl = 'PUBLIC_READ' | 'PRIVATE' | 'NONE';
+export interface S3FileParameters {
+    contentType: string;
+    expiration?: number;
+    size?: number;
+    prefix?: string;
+    extension?: string;
+    suffix?: string;
+    fileName?: string;
+    acl?: S3Acl;
+}
+export interface S3SignedUrlResponse {
+    url: string;
+    publicUrl: string;
+    method: string;
+    headers: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+export type S3UrlSigner = (args: S3FileParameters & {
+    file: File;
+}) => Promise<S3SignedUrlResponse>;
+//# sourceMappingURL=types.d.ts.map

package/dist/uploadClient/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/uploadClient/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,KAAK,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,KAAK,CAAA;CACX;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;CACF;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA"}

package/dist/utils/attrAccept.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Check if a file type matches an accept specification.
+ * Ported from react-dropzone's attr-accept utility.
+ *
+ * @param file - File or object with type and name properties
+ * @param accept - Accept specification (MIME type, extension, or wildcard)
+ */
+export declare function attrAccept(file: {
+    type?: string;
+    name?: string;
+}, accept?: string | string[] | Record<string, string[]>): boolean;
+/**
+ * Convert accept record to a flat string for input accept attribute.
+ */
+export declare function acceptToString(accept?: Record<string, string[]>): string | undefined;
+//# sourceMappingURL=attrAccept.d.ts.map

package/dist/utils/attrAccept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrAccept.d.ts","sourceRoot":"","sources":["../../src/utils/attrAccept.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnD,OAAO,CAiCT;AA0BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAcpF"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { createContentApiS3Signer } from './urlSigner.js';
+export { attrAccept, acceptToString } from './attrAccept.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/utils/urlSigner.d.ts

@@ -0,0 +1,8 @@
+import type { GraphQlClient } from '@contember/graphql-client';
+import type { S3FileParameters, S3SignedUrlResponse } from '../uploadClient/types.js';
+/**
+ * Creates an S3 URL signer that batches requests to reduce API calls.
+ * Uses microtask scheduling to batch concurrent signing requests into a single GraphQL mutation.
+ */
+export declare const createContentApiS3Signer: (client: GraphQlClient) => ((parameters: S3FileParameters) => Promise<S3SignedUrlResponse>);
+//# sourceMappingURL=urlSigner.d.ts.map

package/dist/utils/urlSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlSigner.d.ts","sourceRoot":"","sources":["../../src/utils/urlSigner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAErF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACpC,QAAQ,aAAa,KACnB,CAAC,CAAC,UAAU,EAAE,gBAAgB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAiCjE,CAAA"}

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@contember/bindx-uploader",
+	"version": "0.1.0",
+	"description": "File upload components for bindx data binding",
+	"type": "module",
+	"main": "./src/index.ts",
+	"exports": {
+		".": "./src/index.ts"
+	},
+	"scripts": {
+		"build": "tsc --build",
+		"typecheck": "tsc --build"
+	},
+	"peerDependencies": {
+		"react": ">=18.0.0"
+	},
+	"dependencies": {
+		"@contember/bindx": "0.1.0",
+		"@contember/bindx-react": "0.1.0",
+		"@contember/bindx-repeater": "0.1.0",
+		"@contember/graphql-client": "*",
+		"@radix-ui/react-slot": "^1.2.3",
+		"react-dropzone": "^14.3.8"
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/contember/bindx.git",
+		"directory": "packages/bindx-uploader"
+	}
+}

package/src/UploaderError.ts

@@ -0,0 +1,7 @@
+import type { UploaderErrorOptions } from './types.js'
+
+export class UploaderError extends Error {
+	public constructor(public readonly options: UploaderErrorOptions) {
+		super(`File upload failed: ${options.type}`)
+	}
+}