@useupup/core 3.3.0

package/dist/server-mode-drive-controller-b5f8ee12.d.cts

@@ -0,0 +1,180 @@
+type DriveFile = {
+    id: string;
+    name: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    isFolder: boolean;
+    thumbnail?: string | undefined;
+    modifiedAt?: string | undefined;
+};
+type DriveFolder = DriveFile & {
+    children: DriveFile[];
+};
+type DriveUser = {
+    name: string;
+    email?: string;
+    picture?: string;
+};
+type DriveState = 'idle' | 'authenticating' | 'authenticated' | 'browsing' | 'session-expired';
+/** The one drive browse-failure surface (F-124). `action` names the operation that failed. */
+type DriveBrowserError = {
+    message: string;
+    action?: string | undefined;
+};
+/**
+ * A page returned by DrivePlugin.loadMoreFiles (F-125). `cursor` is an OPAQUE
+ * string — each plugin encodes its own native continuation token (Dropbox's
+ * raw cursor, Box's "folderId:offset", Google's JSON pageToken, OneDrive's
+ * absolute @odata.nextLink) inside it. The controller stores and hands it
+ * back verbatim; it never branches on provider.
+ */
+type DriveListPage = {
+    files: DriveFile[];
+    hasMore: boolean;
+    cursor?: string | undefined;
+};
+type DriveEventMap = {
+    authenticated: {
+        token: string;
+    };
+    'signed-out': Record<string, never>;
+    'session-expired': Record<string, never>;
+    'files-loaded': {
+        files: DriveFile[];
+        path: string;
+        hasMore?: boolean;
+        cursor?: string;
+    };
+    error: {
+        error: Error;
+        action: string;
+    };
+    'state-change': {
+        state: DriveState;
+    };
+};
+
+/**
+ * Per-provider configuration for the framework-agnostic DriveBrowserController.
+ * The four cloud-drive providers share ~90% of their browse logic; everything
+ * that genuinely differs is captured declaratively here.
+ */
+type DriveAuthKind = 'gis' | 'popup';
+type DriveFolderKey = 'id' | 'path';
+type DriveSelectFolderStrategy = 'cached-children' | 'load-all';
+interface DriveProviderDescriptor {
+    /** Key passed to core.getPlugin(...). Matches the plugin's `id`/`name`. */
+    pluginId: string;
+    /**
+     * Prefix used to build event names for bindDriveEvents(core, eventPrefix, …).
+     */
+    eventPrefix: string;
+    /** Display name for the root folder. */
+    rootFolderName: string;
+    /** Id used to detect/label the root folder in files-loaded payloads. */
+    rootFolderId: string;
+    /** Whether a folder is addressed by `id` (most) or `path` (Dropbox). */
+    folderKey: DriveFolderKey;
+    /** Argument passed to plugin.loadFiles() to list the root folder. */
+    loadFilesRootArg: string | undefined;
+    /** Which field in the files-loaded payload carries the folder identity. */
+    folderIdField: 'folderId' | 'path';
+    /** Auth strategy: GIS popup (Google) or plugin-driven popup (the rest). */
+    auth: DriveAuthKind;
+    /** How onSelectCurrentFolder gathers files. */
+    selectFolder: DriveSelectFolderStrategy;
+    /** Root argument for plugin.loadAllFilesInFolder() (popup providers only). */
+    loadAllRootArg?: string;
+}
+declare const GOOGLE_DRIVE_DESCRIPTOR: DriveProviderDescriptor;
+declare const ONE_DRIVE_DESCRIPTOR: DriveProviderDescriptor;
+declare const DROPBOX_DESCRIPTOR: DriveProviderDescriptor;
+declare const BOX_DESCRIPTOR: DriveProviderDescriptor;
+
+/** The uniform observer surface every hoisted core controller exposes. */
+interface ObservableController<TSnapshot = unknown> {
+    /** Subscribe to change notifications; returns an unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    /** Current immutable snapshot — referentially stable until a change occurs. */
+    getSnapshot(): TSnapshot;
+    /** Tear down internal subscriptions/listeners. Idempotent. */
+    destroy(): void;
+}
+
+type ServerModeProvider = 'google-drive' | 'one-drive' | 'dropbox' | 'box';
+interface ServerDriveFile {
+    id: string;
+    name: string;
+    size?: number;
+    mimeType?: string;
+    thumbnailUrl?: string;
+    isFolder: boolean;
+    modifiedAt?: string;
+}
+type ServerDriveListState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'ready';
+    files: ServerDriveFile[];
+} | {
+    status: 'reauth';
+} | {
+    status: 'error';
+    message: string;
+    code?: string;
+};
+type ServerDriveTransferResult = {
+    status: 'ok';
+    result: unknown;
+} | {
+    status: 'reauth';
+} | {
+    status: 'error';
+    message: string;
+    code?: string;
+};
+interface ServerDriveSnapshot {
+    state: ServerDriveListState;
+    folderId: string | undefined;
+    search: string;
+}
+interface ServerModeDriveDeps {
+    provider: ServerModeProvider;
+    /** Getter so the controller never reads a runtime global at construction. */
+    serverUrl: () => string | undefined;
+}
+declare class ServerModeDriveController implements ObservableController<ServerDriveSnapshot> {
+    private deps;
+    private snapshot;
+    private listeners;
+    private abort;
+    private authListener;
+    constructor(deps: ServerModeDriveDeps);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => ServerDriveSnapshot;
+    private setState;
+    /** Initial list. Call on mount. */
+    init(): void;
+    list(opts?: {
+        folderId?: string;
+        search?: string;
+    }): Promise<void>;
+    refresh(opts?: {
+        folderId?: string;
+        search?: string;
+    }): Promise<void>;
+    transfer(file: ServerDriveFile): Promise<ServerDriveTransferResult>;
+    startAuth(): void;
+    setFolderId(id: string | undefined): void;
+    setSearch(s: string): void;
+    /** Force the reauth view (used by batch consumers on a transfer 401). */
+    requestReauth(): void;
+    /** Force the error view (used by batch consumers on a transfer failure). */
+    setError(message: string): void;
+    destroy(): void;
+}
+
+export { BOX_DESCRIPTOR as B, type DriveUser as D, GOOGLE_DRIVE_DESCRIPTOR as G, ONE_DRIVE_DESCRIPTOR as O, type ServerModeProvider as S, type DriveFile as a, type DriveListPage as b, type DriveState as c, type DriveFolder as d, type DriveEventMap as e, type DriveBrowserError as f, DROPBOX_DESCRIPTOR as g, type ObservableController as h, type ServerDriveFile as i, type ServerDriveListState as j, type DriveProviderDescriptor as k, ServerModeDriveController as l, type ServerDriveTransferResult as m, type ServerDriveSnapshot as n, type ServerModeDriveDeps as o, type DriveAuthKind as p, type DriveFolderKey as q, type DriveSelectFolderStrategy as r };

package/dist/server-mode-drive-controller-b5f8ee12.d.ts

@@ -0,0 +1,180 @@
+type DriveFile = {
+    id: string;
+    name: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    isFolder: boolean;
+    thumbnail?: string | undefined;
+    modifiedAt?: string | undefined;
+};
+type DriveFolder = DriveFile & {
+    children: DriveFile[];
+};
+type DriveUser = {
+    name: string;
+    email?: string;
+    picture?: string;
+};
+type DriveState = 'idle' | 'authenticating' | 'authenticated' | 'browsing' | 'session-expired';
+/** The one drive browse-failure surface (F-124). `action` names the operation that failed. */
+type DriveBrowserError = {
+    message: string;
+    action?: string | undefined;
+};
+/**
+ * A page returned by DrivePlugin.loadMoreFiles (F-125). `cursor` is an OPAQUE
+ * string — each plugin encodes its own native continuation token (Dropbox's
+ * raw cursor, Box's "folderId:offset", Google's JSON pageToken, OneDrive's
+ * absolute @odata.nextLink) inside it. The controller stores and hands it
+ * back verbatim; it never branches on provider.
+ */
+type DriveListPage = {
+    files: DriveFile[];
+    hasMore: boolean;
+    cursor?: string | undefined;
+};
+type DriveEventMap = {
+    authenticated: {
+        token: string;
+    };
+    'signed-out': Record<string, never>;
+    'session-expired': Record<string, never>;
+    'files-loaded': {
+        files: DriveFile[];
+        path: string;
+        hasMore?: boolean;
+        cursor?: string;
+    };
+    error: {
+        error: Error;
+        action: string;
+    };
+    'state-change': {
+        state: DriveState;
+    };
+};
+
+/**
+ * Per-provider configuration for the framework-agnostic DriveBrowserController.
+ * The four cloud-drive providers share ~90% of their browse logic; everything
+ * that genuinely differs is captured declaratively here.
+ */
+type DriveAuthKind = 'gis' | 'popup';
+type DriveFolderKey = 'id' | 'path';
+type DriveSelectFolderStrategy = 'cached-children' | 'load-all';
+interface DriveProviderDescriptor {
+    /** Key passed to core.getPlugin(...). Matches the plugin's `id`/`name`. */
+    pluginId: string;
+    /**
+     * Prefix used to build event names for bindDriveEvents(core, eventPrefix, …).
+     */
+    eventPrefix: string;
+    /** Display name for the root folder. */
+    rootFolderName: string;
+    /** Id used to detect/label the root folder in files-loaded payloads. */
+    rootFolderId: string;
+    /** Whether a folder is addressed by `id` (most) or `path` (Dropbox). */
+    folderKey: DriveFolderKey;
+    /** Argument passed to plugin.loadFiles() to list the root folder. */
+    loadFilesRootArg: string | undefined;
+    /** Which field in the files-loaded payload carries the folder identity. */
+    folderIdField: 'folderId' | 'path';
+    /** Auth strategy: GIS popup (Google) or plugin-driven popup (the rest). */
+    auth: DriveAuthKind;
+    /** How onSelectCurrentFolder gathers files. */
+    selectFolder: DriveSelectFolderStrategy;
+    /** Root argument for plugin.loadAllFilesInFolder() (popup providers only). */
+    loadAllRootArg?: string;
+}
+declare const GOOGLE_DRIVE_DESCRIPTOR: DriveProviderDescriptor;
+declare const ONE_DRIVE_DESCRIPTOR: DriveProviderDescriptor;
+declare const DROPBOX_DESCRIPTOR: DriveProviderDescriptor;
+declare const BOX_DESCRIPTOR: DriveProviderDescriptor;
+
+/** The uniform observer surface every hoisted core controller exposes. */
+interface ObservableController<TSnapshot = unknown> {
+    /** Subscribe to change notifications; returns an unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    /** Current immutable snapshot — referentially stable until a change occurs. */
+    getSnapshot(): TSnapshot;
+    /** Tear down internal subscriptions/listeners. Idempotent. */
+    destroy(): void;
+}
+
+type ServerModeProvider = 'google-drive' | 'one-drive' | 'dropbox' | 'box';
+interface ServerDriveFile {
+    id: string;
+    name: string;
+    size?: number;
+    mimeType?: string;
+    thumbnailUrl?: string;
+    isFolder: boolean;
+    modifiedAt?: string;
+}
+type ServerDriveListState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'ready';
+    files: ServerDriveFile[];
+} | {
+    status: 'reauth';
+} | {
+    status: 'error';
+    message: string;
+    code?: string;
+};
+type ServerDriveTransferResult = {
+    status: 'ok';
+    result: unknown;
+} | {
+    status: 'reauth';
+} | {
+    status: 'error';
+    message: string;
+    code?: string;
+};
+interface ServerDriveSnapshot {
+    state: ServerDriveListState;
+    folderId: string | undefined;
+    search: string;
+}
+interface ServerModeDriveDeps {
+    provider: ServerModeProvider;
+    /** Getter so the controller never reads a runtime global at construction. */
+    serverUrl: () => string | undefined;
+}
+declare class ServerModeDriveController implements ObservableController<ServerDriveSnapshot> {
+    private deps;
+    private snapshot;
+    private listeners;
+    private abort;
+    private authListener;
+    constructor(deps: ServerModeDriveDeps);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => ServerDriveSnapshot;
+    private setState;
+    /** Initial list. Call on mount. */
+    init(): void;
+    list(opts?: {
+        folderId?: string;
+        search?: string;
+    }): Promise<void>;
+    refresh(opts?: {
+        folderId?: string;
+        search?: string;
+    }): Promise<void>;
+    transfer(file: ServerDriveFile): Promise<ServerDriveTransferResult>;
+    startAuth(): void;
+    setFolderId(id: string | undefined): void;
+    setSearch(s: string): void;
+    /** Force the reauth view (used by batch consumers on a transfer 401). */
+    requestReauth(): void;
+    /** Force the error view (used by batch consumers on a transfer failure). */
+    setError(message: string): void;
+    destroy(): void;
+}
+
+export { BOX_DESCRIPTOR as B, type DriveUser as D, GOOGLE_DRIVE_DESCRIPTOR as G, ONE_DRIVE_DESCRIPTOR as O, type ServerModeProvider as S, type DriveFile as a, type DriveListPage as b, type DriveState as c, type DriveFolder as d, type DriveEventMap as e, type DriveBrowserError as f, DROPBOX_DESCRIPTOR as g, type ObservableController as h, type ServerDriveFile as i, type ServerDriveListState as j, type DriveProviderDescriptor as k, ServerModeDriveController as l, type ServerDriveTransferResult as m, type ServerDriveSnapshot as n, type ServerModeDriveDeps as o, type DriveAuthKind as p, type DriveFolderKey as q, type DriveSelectFolderStrategy as r };

package/dist/steps/compress.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+var chunk2H5ICKFT_cjs = require('../chunk-2H5ICKFT.cjs');
+var chunkBSGQGINR_cjs = require('../chunk-BSGQGINR.cjs');
+require('../chunk-QK7HZIVY.cjs');
+
+// src/steps/compress.ts
+function compressStep(_options) {
+  return {
+    name: "compress",
+    shouldProcess: (file) => file.type.startsWith("image/"),
+    async process(file, context) {
+      if (await chunk2H5ICKFT_cjs.isAnimatedImage(file)) return file;
+      if (context.worker) {
+        try {
+          const result = await context.worker.execute({
+            type: "compress",
+            data: await file.arrayBuffer(),
+            params: {
+              mime: file.type,
+              name: file.name,
+              maxWidthOrHeight: _options?.maxWidthOrHeight,
+              maxSizeMB: _options?.maxSizeMB,
+              quality: _options?.quality
+            }
+          });
+          if (result.kind === "image")
+            return chunkBSGQGINR_cjs.uploadFileFromImageResult(file, result);
+        } catch {
+        }
+      }
+      const maxBytes = typeof _options?.maxSizeMB === "number" ? _options.maxSizeMB * 1024 * 1024 : void 0;
+      let quality = _options?.quality ?? 0.82;
+      let processed = await chunkBSGQGINR_cjs.encodeImageFile(file, {
+        maxWidthOrHeight: _options?.maxWidthOrHeight ?? 1920,
+        quality,
+        metadata: {
+          originalSize: file.size,
+          compressed: true
+        }
+      });
+      while (processed && maxBytes && processed.size > maxBytes && quality > 0.35) {
+        quality = Math.max(0.35, quality - 0.12);
+        processed = await chunkBSGQGINR_cjs.encodeImageFile(file, {
+          maxWidthOrHeight: _options?.maxWidthOrHeight ?? 1920,
+          quality,
+          metadata: {
+            originalSize: file.size,
+            compressed: true
+          }
+        });
+      }
+      if (!processed) return file;
+      if (processed.size >= file.size && !maxBytes && !_options?.maxWidthOrHeight) {
+        return file;
+      }
+      processed.metadata = {
+        ...processed.metadata,
+        processedSize: processed.size
+      };
+      return processed;
+    }
+  };
+}
+
+exports.compressStep = compressStep;

package/dist/steps/compress.d.cts

@@ -0,0 +1,10 @@
+import { P as PipelineStep } from '../contracts-pipeline-cf177270.cjs';
+
+interface ImageCompressionOptions {
+    maxWidthOrHeight?: number;
+    maxSizeMB?: number;
+    quality?: number;
+}
+declare function compressStep(_options?: ImageCompressionOptions): PipelineStep;
+
+export { type ImageCompressionOptions, compressStep };

package/dist/steps/compress.d.ts

@@ -0,0 +1,10 @@
+import { P as PipelineStep } from '../contracts-pipeline-cf177270.js';
+
+interface ImageCompressionOptions {
+    maxWidthOrHeight?: number;
+    maxSizeMB?: number;
+    quality?: number;
+}
+declare function compressStep(_options?: ImageCompressionOptions): PipelineStep;
+
+export { type ImageCompressionOptions, compressStep };

package/dist/steps/compress.js

@@ -0,0 +1,64 @@
+import { isAnimatedImage } from '../chunk-FMURBCZ7.js';
+import { uploadFileFromImageResult, encodeImageFile } from '../chunk-6S5DQDQH.js';
+import '../chunk-GE4LIVXP.js';
+
+// src/steps/compress.ts
+function compressStep(_options) {
+  return {
+    name: "compress",
+    shouldProcess: (file) => file.type.startsWith("image/"),
+    async process(file, context) {
+      if (await isAnimatedImage(file)) return file;
+      if (context.worker) {
+        try {
+          const result = await context.worker.execute({
+            type: "compress",
+            data: await file.arrayBuffer(),
+            params: {
+              mime: file.type,
+              name: file.name,
+              maxWidthOrHeight: _options?.maxWidthOrHeight,
+              maxSizeMB: _options?.maxSizeMB,
+              quality: _options?.quality
+            }
+          });
+          if (result.kind === "image")
+            return uploadFileFromImageResult(file, result);
+        } catch {
+        }
+      }
+      const maxBytes = typeof _options?.maxSizeMB === "number" ? _options.maxSizeMB * 1024 * 1024 : void 0;
+      let quality = _options?.quality ?? 0.82;
+      let processed = await encodeImageFile(file, {
+        maxWidthOrHeight: _options?.maxWidthOrHeight ?? 1920,
+        quality,
+        metadata: {
+          originalSize: file.size,
+          compressed: true
+        }
+      });
+      while (processed && maxBytes && processed.size > maxBytes && quality > 0.35) {
+        quality = Math.max(0.35, quality - 0.12);
+        processed = await encodeImageFile(file, {
+          maxWidthOrHeight: _options?.maxWidthOrHeight ?? 1920,
+          quality,
+          metadata: {
+            originalSize: file.size,
+            compressed: true
+          }
+        });
+      }
+      if (!processed) return file;
+      if (processed.size >= file.size && !maxBytes && !_options?.maxWidthOrHeight) {
+        return file;
+      }
+      processed.metadata = {
+        ...processed.metadata,
+        processedSize: processed.size
+      };
+      return processed;
+    }
+  };
+}
+
+export { compressStep };

package/dist/steps/exif.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+var chunk2H5ICKFT_cjs = require('../chunk-2H5ICKFT.cjs');
+var chunkBSGQGINR_cjs = require('../chunk-BSGQGINR.cjs');
+require('../chunk-QK7HZIVY.cjs');
+
+// src/steps/exif.ts
+function exifStep() {
+  return {
+    name: "exif",
+    shouldProcess: (file) => file.type.startsWith("image/"),
+    async process(file, context) {
+      if (await chunk2H5ICKFT_cjs.isAnimatedImage(file)) return file;
+      if (context.worker) {
+        try {
+          const result = await context.worker.execute({
+            type: "exif",
+            data: await file.arrayBuffer(),
+            params: { mime: file.type, name: file.name }
+          });
+          if (result.kind === "image")
+            return chunkBSGQGINR_cjs.uploadFileFromImageResult(file, result);
+        } catch {
+        }
+      }
+      const processed = await chunkBSGQGINR_cjs.encodeImageFile(file, {
+        type: file.type || "image/jpeg",
+        quality: 0.92,
+        metadata: {
+          originalSize: file.size,
+          exifStripped: true
+        }
+      });
+      if (!processed) return file;
+      processed.metadata = {
+        ...processed.metadata,
+        processedSize: processed.size
+      };
+      return processed;
+    }
+  };
+}
+
+exports.exifStep = exifStep;

package/dist/steps/exif.d.cts

@@ -0,0 +1,5 @@
+import { P as PipelineStep } from '../contracts-pipeline-cf177270.cjs';
+
+declare function exifStep(): PipelineStep;
+
+export { exifStep };

package/dist/steps/exif.d.ts

@@ -0,0 +1,5 @@
+import { P as PipelineStep } from '../contracts-pipeline-cf177270.js';
+
+declare function exifStep(): PipelineStep;
+
+export { exifStep };

package/dist/steps/exif.js

@@ -0,0 +1,42 @@
+import { isAnimatedImage } from '../chunk-FMURBCZ7.js';
+import { uploadFileFromImageResult, encodeImageFile } from '../chunk-6S5DQDQH.js';
+import '../chunk-GE4LIVXP.js';
+
+// src/steps/exif.ts
+function exifStep() {
+  return {
+    name: "exif",
+    shouldProcess: (file) => file.type.startsWith("image/"),
+    async process(file, context) {
+      if (await isAnimatedImage(file)) return file;
+      if (context.worker) {
+        try {
+          const result = await context.worker.execute({
+            type: "exif",
+            data: await file.arrayBuffer(),
+            params: { mime: file.type, name: file.name }
+          });
+          if (result.kind === "image")
+            return uploadFileFromImageResult(file, result);
+        } catch {
+        }
+      }
+      const processed = await encodeImageFile(file, {
+        type: file.type || "image/jpeg",
+        quality: 0.92,
+        metadata: {
+          originalSize: file.size,
+          exifStripped: true
+        }
+      });
+      if (!processed) return file;
+      processed.metadata = {
+        ...processed.metadata,
+        processedSize: processed.size
+      };
+      return processed;
+    }
+  };
+}
+
+export { exifStep };

package/dist/steps/hash.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+// src/steps/hash.ts
+async function computeSHA256(buffer) {
+  const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function hashStep() {
+  return {
+    name: "hash",
+    async process(file, context) {
+      if (context.worker) {
+        try {
+          const result = await context.worker.execute({
+            type: "hash",
+            data: await file.arrayBuffer()
+          });
+          if (result.kind === "hash") {
+            file.metadata = {
+              ...file.metadata,
+              checksum: result.checksum,
+              originalContentHash: result.checksum
+            };
+            return Object.assign(file, {
+              checksumSHA256: result.checksum
+            });
+          }
+        } catch {
+        }
+      }
+      const buffer = await file.arrayBuffer();
+      const hash = await computeSHA256(buffer);
+      file.metadata = {
+        ...file.metadata,
+        checksum: hash,
+        originalContentHash: hash
+      };
+      return Object.assign(file, { checksumSHA256: hash });
+    }
+  };
+}
+
+exports.hashStep = hashStep;

package/dist/steps/hash.d.cts

@@ -0,0 +1,5 @@
+import { P as PipelineStep } from '../contracts-pipeline-cf177270.cjs';
+
+declare function hashStep(): PipelineStep;
+
+export { hashStep };

package/dist/steps/hash.d.ts

@@ -0,0 +1,5 @@
+import { P as PipelineStep } from '../contracts-pipeline-cf177270.js';
+
+declare function hashStep(): PipelineStep;
+
+export { hashStep };