@powerhousedao/reactor-attachments 6.2.3 → 6.3.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","names":[],"sources":["../src/concurrency.ts","../src/progress.ts","../src/client.ts"],"sourcesContent":["/**\n * Ordered result of one batch item. `index` always mirrors the input\n * position, so callers can correlate results with inputs regardless of\n * completion order, and successes are retained when siblings fail.\n */\nexport type BatchItemResult<R> =\n | { index: number; status: \"fulfilled\"; value: R }\n | { index: number; status: \"rejected\"; error: unknown };\n\nexport type RunWithConcurrencyOptions<R = unknown> = {\n /** Maximum simultaneously running workers. Must be a positive integer. */\n concurrency: number;\n /**\n * Whole-batch cancellation: unstarted items are rejected with the signal's\n * reason without ever starting, while already-started items keep running —\n * per-item signals are the mechanism for interrupting active work.\n */\n signal?: AbortSignal;\n /**\n * Called once per item as it settles, in completion order, including items\n * the signal skipped before they ever started. That completeness is the\n * point: a caller counting settlements must still reach `items.length`\n * after a whole-batch abort.\n */\n onSettled?: (result: BatchItemResult<R>) => void;\n};\n\n/**\n * Runs `worker` over `items` with a hard upper bound on simultaneous\n * executions. Bounding starts (not just transfers) is what keeps memory flat:\n * an item's preprocessing (hashing/buffering) only begins when a slot frees.\n */\nexport async function runWithConcurrency<T, R>(\n items: readonly T[],\n worker: (item: T, index: number) => Promise<R>,\n options: RunWithConcurrencyOptions<R>,\n): Promise<BatchItemResult<R>[]> {\n const { concurrency, signal, onSettled } = options;\n if (!Number.isInteger(concurrency) || concurrency < 1) {\n throw new Error(\n `concurrency must be a positive integer, got: ${concurrency}`,\n );\n }\n\n const results: BatchItemResult<R>[] = new Array<BatchItemResult<R>>(\n items.length,\n );\n let nextIndex = 0;\n\n async function runLane(): Promise<void> {\n for (;;) {\n const index = nextIndex++;\n if (index >= items.length) return;\n if (signal?.aborted) {\n results[index] = {\n index,\n status: \"rejected\",\n error: signalReason(signal),\n };\n onSettled?.(results[index]);\n continue;\n }\n try {\n const value = await worker(items[index], index);\n results[index] = { index, status: \"fulfilled\", value };\n } catch (error) {\n results[index] = { index, status: \"rejected\", error };\n }\n onSettled?.(results[index]);\n }\n }\n\n const lanes = Array.from(\n { length: Math.min(concurrency, items.length) },\n () => runLane(),\n );\n await Promise.all(lanes);\n return results;\n}\n\nfunction signalReason(signal: AbortSignal): unknown {\n return (\n (signal as { reason?: unknown }).reason ??\n new DOMException(\"The operation was aborted\", \"AbortError\")\n );\n}\n","/**\n * Byte-level progress for attachment transfers.\n *\n * `loaded`/`total` are per-stage, never per-operation. A per-operation\n * denominator would have to weight hashing against transfer, and a confirmed\n * dedup would shrink it mid-flight from 2N to N — the bar would run backwards.\n * Choosing that weighting is a UI decision the client cannot make.\n */\n\nexport type AttachmentStage =\n | \"hashing\"\n | \"reserving\"\n | \"uploading\"\n | \"requesting-download-target\"\n | \"downloading\"\n | \"done\"\n | \"error\";\n\nexport type AttachmentProgress = {\n stage: AttachmentStage;\n /** Bytes moved so far within `stage`. */\n loaded: number;\n /** Denominator for `stage`: file.size for uploads, header.sizeBytes for downloads. */\n total: number | undefined;\n /** True when the stage is running but bytes cannot (yet) be observed. */\n indeterminate: boolean;\n /** Only on a terminal `done` where dedup skipped the transfer entirely. */\n deduped?: true;\n};\n\nexport type AttachmentProgressListener = (progress: AttachmentProgress) => void;\n\nexport type AttachmentProgressOptions = {\n onProgress?: AttachmentProgressListener;\n /** Min ms between byte events within a stage. Default 100. 0 emits every observation. */\n throttleMs?: number;\n};\n\nexport const DEFAULT_PROGRESS_THROTTLE_MS = 100;\n\n/**\n * Fraction in 0..1 for a progress event. Indeterminate and unknown-total\n * events read as 0 — a bar cannot honestly show a position it does not know.\n * A zero total is complete by definition (the dedup case moves no bytes).\n */\nexport function progressFraction(progress: AttachmentProgress): number {\n if (progress.indeterminate) return 0;\n if (progress.total === undefined) return 0;\n if (progress.total === 0) return 1;\n const fraction = progress.loaded / progress.total;\n if (fraction < 0) return 0;\n return fraction > 1 ? 1 : fraction;\n}\n\nexport type ProgressEmitterOptions = AttachmentProgressOptions & {\n /** Injected clock so throttle tests stay synchronous. */\n now?: () => number;\n};\n\n/**\n * Emits `AttachmentProgress` for one single-item operation, upholding:\n *\n * - **I1** exactly one terminal event (`done` or `error`) — never both, never twice.\n * - **I2** on `done`: `indeterminate === false`, `total` is a number, `loaded === total`.\n * - **I3** `loaded` is non-decreasing within a stage and resets to 0 on stage change.\n * - **I4** the terminal event bypasses the throttle unconditionally.\n * - **I5** `error` carries the last known `loaded`/`total`.\n *\n * Leading edge: the first `bytes()` after a `stage()` always emits, so a bar\n * leaves 0 immediately. There is deliberately no trailing-edge timer — it\n * would leak on throw, could fire after the terminal event and violate I1's\n * ordering, and is unnecessary because `finish()` always emits\n * `loaded === total`, making a dropped last intra-stage tick invisible.\n */\nexport class ProgressEmitter {\n private readonly listener: AttachmentProgressListener | undefined;\n private readonly throttleMs: number;\n private readonly now: () => number;\n\n private currentStage: AttachmentStage | undefined;\n private loaded = 0;\n private total: number | undefined;\n private emittedBytesInStage = false;\n private lastEmitAt = Number.NEGATIVE_INFINITY;\n private settled = false;\n\n constructor(options?: ProgressEmitterOptions) {\n this.listener = options?.onProgress;\n this.throttleMs = options?.throttleMs ?? DEFAULT_PROGRESS_THROTTLE_MS;\n this.now = options?.now ?? (() => Date.now());\n }\n\n /** True when a listener is attached; lets callers skip instrumentation entirely. */\n get active(): boolean {\n return this.listener !== undefined;\n }\n\n /**\n * Enter a stage. Always emits and resets `loaded` to 0. Entry is always\n * indeterminate: no bytes have moved yet, and whether they can be observed\n * at all is only proven by a transport actually calling back.\n */\n stage(stage: AttachmentStage, options?: { total?: number }): void {\n if (this.settled) return;\n this.currentStage = stage;\n this.loaded = 0;\n this.total = options?.total;\n this.emittedBytesInStage = false;\n this.emit({\n stage,\n loaded: 0,\n total: this.total,\n indeterminate: true,\n });\n }\n\n /**\n * Report observed bytes within the current stage. Throttled by time, with\n * the first observation after a stage change always emitted.\n */\n bytes(loaded: number, total?: number): void {\n if (this.settled || this.currentStage === undefined) return;\n if (total !== undefined) this.total = total;\n if (loaded > this.loaded) this.loaded = loaded;\n\n const leadingEdge = !this.emittedBytesInStage;\n if (!leadingEdge && this.now() - this.lastEmitAt < this.throttleMs) return;\n this.emittedBytesInStage = true;\n this.emit({\n stage: this.currentStage,\n loaded: this.loaded,\n total: this.total,\n indeterminate: false,\n });\n }\n\n /**\n * Terminal success. `total` defaults to the bytes actually seen so a stage\n * with no known denominator still satisfies I2.\n */\n finish(override?: { loaded?: number; total?: number; deduped?: true }): void {\n if (this.settled) return;\n this.settled = true;\n const total = override?.total ?? this.total ?? this.loaded;\n const loaded = override?.loaded ?? total;\n this.emit({\n stage: \"done\",\n loaded,\n total,\n indeterminate: false,\n ...(override?.deduped ? { deduped: true as const } : {}),\n });\n }\n\n /** Terminal success for a confirmed dedup: no bytes moved, and none needed to. */\n finishDeduped(): void {\n this.finish({ loaded: 0, total: 0, deduped: true });\n }\n\n /** Terminal failure, carrying the last known byte counts. */\n fail(): void {\n if (this.settled) return;\n this.settled = true;\n this.emit({\n stage: \"error\",\n loaded: this.loaded,\n total: this.total,\n indeterminate: false,\n });\n }\n\n private emit(progress: AttachmentProgress): void {\n this.lastEmitAt = this.now();\n this.listener?.(progress);\n }\n}\n\nexport type ByteProgressHooks = {\n /** Cumulative bytes handed to the consumer. */\n onBytes?: (loaded: number) => void;\n /** The source ended and every byte reached the consumer. */\n onDone?: () => void;\n onError?: (error: unknown) => void;\n};\n\n/**\n * Count bytes as a consumer reads them.\n *\n * Uses the manual-reader form rather than `pipeThrough`, whose internal queue\n * reads far ahead of the consumer and would make `loaded` overstate what was\n * actually received. `highWaterMark: 0` is load-bearing for the same reason:\n * at the default of 1 the wrapper pulls one chunk the instant it is\n * constructed, so a caller who never reads still sees bytes counted.\n *\n * `cancel` propagates to the source, which is what keeps reader refcounts\n * (e.g. `KyselyAttachmentStore`'s) correct. Cancelling is an abandonment, not\n * a completion, so it reports `onError` — never `onDone` — carrying the\n * cancel reason the way an `AbortSignal` carries its own, with the DOM's\n * default `AbortError` when the canceller gave none.\n *\n * Returns `source` unchanged when no hook is supplied, so a caller with no\n * listener pays nothing.\n */\nexport function withByteProgress(\n source: ReadableStream<Uint8Array>,\n hooks: ByteProgressHooks,\n): ReadableStream<Uint8Array> {\n if (!hooks.onBytes && !hooks.onDone && !hooks.onError) return source;\n\n let loaded = 0;\n let cancelled = false;\n const reader = source.getReader();\n return new ReadableStream<Uint8Array>(\n {\n async pull(controller) {\n try {\n const { done, value } = await reader.read();\n // A cancel that lands while this read is in flight resolves it as\n // `done`, and closes the stream. Bailing out here is what stops an\n // abandoned transfer from reporting completion, and stops the\n // already-closed controller from throwing a fabricated error into\n // the catch below.\n if (cancelled) return;\n if (done) {\n hooks.onDone?.();\n controller.close();\n return;\n }\n loaded += value.byteLength;\n hooks.onBytes?.(loaded);\n controller.enqueue(value);\n } catch (err) {\n if (cancelled) return;\n hooks.onError?.(err);\n controller.error(err);\n }\n },\n cancel(reason) {\n cancelled = true;\n reader.cancel(reason).catch(() => {});\n hooks.onError?.(reason ?? abortError());\n },\n },\n { highWaterMark: 0 },\n );\n}\n\n/** What an `AbortSignal` carries when `abort()` is called with no reason. */\nfunction abortError(): DOMException {\n return new DOMException(\"The operation was aborted\", \"AbortError\");\n}\n","import type { AttachmentHash, AttachmentRef } from \"@powerhousedao/reactor\";\nimport {\n runWithConcurrency,\n type BatchItemResult,\n type RunWithConcurrencyOptions,\n} from \"./concurrency.js\";\nimport { AttachmentAlreadyExists } from \"./errors.js\";\nexport type { AttachmentTransferStage } from \"./errors.js\";\nexport {\n runWithConcurrency,\n type BatchItemResult,\n type RunWithConcurrencyOptions,\n} from \"./concurrency.js\";\nimport type { IAttachmentService, IAttachmentUpload } from \"./interfaces.js\";\nimport {\n ProgressEmitter,\n withByteProgress,\n type AttachmentProgress,\n type AttachmentProgressOptions,\n} from \"./progress.js\";\nimport { createRef } from \"./ref.js\";\nimport type {\n AttachmentHeader,\n AttachmentResponse,\n AttachmentSendOptions,\n AttachmentUploadResult,\n HashFirstReserveAttachmentOptions,\n} from \"./types.js\";\n\nexport { AttachmentService } from \"./attachment-service.js\";\nexport {\n AttachmentAlreadyExists,\n AttachmentNotFound,\n AttachmentPending,\n AttachmentTransferError,\n HashMismatch,\n InvalidAttachmentRef,\n ReservationNotFound,\n SizeMismatch,\n UploadTooLarge,\n} from \"./errors.js\";\nexport type {\n IAttachmentReader,\n IAttachmentService,\n IAttachmentStore,\n IAttachmentTransport,\n IAttachmentTransportFactory,\n IAttachmentUpload,\n IAttachmentUploadFactory,\n IReservationStore,\n} from \"./interfaces.js\";\nexport { parseRef, createRef } from \"./ref.js\";\nexport type { ParsedRef } from \"./ref.js\";\nexport type {\n AttachmentDownloadOptions,\n AttachmentDownloadTarget,\n AttachmentDownloadTargetOptions,\n AttachmentHeader,\n AttachmentMetadata,\n AttachmentResponse,\n AttachmentSendOptions,\n AttachmentStatOptions,\n AttachmentStatus,\n AttachmentTransportConfig,\n AttachmentUploadResult,\n AttachmentTargetHeaders,\n AttachmentUploadTarget,\n HashFirstReserveAttachmentOptions,\n UploadFirstReserveAttachmentOptions,\n Reservation,\n ReserveAttachmentOptions,\n TransportFetchResult,\n TransportResponse,\n} from \"./types.js\";\nexport {\n parseAttachmentDownloadTarget,\n parseAttachmentUploadTarget,\n} from \"./targets.js\";\nexport {\n SwitchboardAttachmentTransport,\n type SwitchboardTransportConfig,\n RemoteReservationStore,\n type SwitchboardClientConfig,\n RemoteAttachmentUpload,\n RemoteAttachmentUploadFactory,\n RemoteAttachmentStore,\n createRemoteAttachmentService,\n createFetchUploadTransport,\n createXhrUploadTransport,\n type AttachmentUploadRequest,\n type AttachmentUploadResponse,\n type AttachmentUploadTransport,\n type XhrUploadTransportOptions,\n} from \"./switchboard/index.js\";\nexport { NullAttachmentTransport } from \"./null-attachment-transport.js\";\nexport {\n DEFAULT_PROGRESS_THROTTLE_MS,\n progressFraction,\n ProgressEmitter,\n withByteProgress,\n type AttachmentProgress,\n type AttachmentProgressListener,\n type AttachmentProgressOptions,\n type AttachmentStage,\n type ByteProgressHooks,\n type ProgressEmitterOptions,\n} from \"./progress.js\";\n\nexport type PreprocessResult = {\n ref: AttachmentRef;\n hash: AttachmentHash;\n sizeBytes: number;\n options: HashFirstReserveAttachmentOptions;\n data: ReadableStream<Uint8Array>;\n stream: () => ReadableStream<Uint8Array>;\n};\n\nexport type AttachmentUploadInput = {\n file: Blob;\n fileName?: string;\n mimeType?: string;\n /** Per-item cancellation, checked between stages. */\n signal?: AbortSignal;\n};\n\n/**\n * Upload bytes that were already hashed by a separate `preprocess()` call.\n *\n * This is the canonical two-call flow: the ref must reach the document before\n * the bytes are committed, so callers preprocess, dispatch the operation, then\n * upload. Passing the result back in skips the hashing stage rather than\n * faking a zero-millisecond one.\n */\nexport type AttachmentPreprocessedUploadInput = {\n preprocessed: PreprocessResult;\n signal?: AbortSignal;\n};\n\n/**\n * Every remote download names the document that authorizes its ref; batches\n * may freely mix documents because the anchor travels with each item.\n */\nexport type AttachmentDownloadInput = {\n documentId: string;\n ref: AttachmentRef;\n signal?: AbortSignal;\n};\n\n/**\n * The document keeps its own name and type for an attachment (the same\n * bytes may appear under different names in different documents), so the\n * blob-producing conveniences let callers override what the server header\n * reports from upload time.\n */\nexport type AttachmentBlobOptions = {\n mimeType?: string;\n};\n\nexport type AttachmentSaveOptions = {\n fileName?: string;\n mimeType?: string;\n};\n\nexport type AttachmentBlobResult = {\n blob: Blob;\n header: AttachmentHeader;\n};\n\nexport type AttachmentObjectUrl = {\n /** Ready for img/iframe/video src. Pins memory until revoke() is called. */\n url: string;\n header: AttachmentHeader;\n revoke: () => void;\n};\n\nexport type AttachmentShareLinkInput = {\n documentId: string;\n ref: AttachmentRef;\n /** Requested link lifetime in seconds; the server clamps to its maximum. */\n expiresIn?: number;\n signal?: AbortSignal;\n};\n\n/**\n * A self-contained public URL: anyone holding it can fetch the bytes until\n * expiresAtUtc, with no login and no document access. Minting one requires\n * document read access; once minted it cannot be revoked before expiry.\n */\nexport type AttachmentShareLink = {\n url: string;\n expiresAtUtc: string;\n};\n\n/**\n * Batch progress is per item, carrying the item's `index`. There is\n * deliberately no batch-wide byte total: weighting items against each other is\n * a presentation decision the client cannot make, and a confirmed dedup would\n * shrink the denominator mid-flight.\n */\nexport type AttachmentBatchOptions = {\n /** Bounds preprocessing and transfer together. Defaults to 4. */\n concurrency?: number;\n /** Whole-batch cancellation: stops unstarted items. */\n signal?: AbortSignal;\n onProgress?: (progress: AttachmentProgress & { index: number }) => void;\n /**\n * Fired as each item settles, including items the signal skipped before they\n * started, so `settled` always reaches `total`.\n */\n onItemSettled?: (counts: AttachmentBatchCounts) => void;\n /** Min ms between byte events, applied per item rather than batch-wide. */\n throttleMs?: number;\n};\n\nexport type AttachmentBatchCounts = {\n settled: number;\n completed: number;\n failed: number;\n total: number;\n};\n\nexport const DEFAULT_ATTACHMENT_BATCH_CONCURRENCY = 4;\n\nexport interface IAttachmentClient {\n preprocess(\n file: Blob,\n opts?: { fileName?: string; mimeType?: string },\n ): Promise<PreprocessResult>;\n reserve(\n options: HashFirstReserveAttachmentOptions,\n send: (handle: IAttachmentUpload) => Promise<AttachmentUploadResult>,\n ): Promise<AttachmentUploadResult>;\n /**\n * Hash, reserve, and transfer one file; a confirmed dedup skips the transfer\n * and reports a terminal `done` carrying `deduped: true` and zero bytes.\n *\n * Also accepts an already-preprocessed payload, so the canonical\n * preprocess -> dispatch -> upload flow reports progress too.\n */\n upload(\n input: AttachmentUploadInput | AttachmentPreprocessedUploadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentUploadResult>;\n /**\n * Document-authorized download of one ref.\n *\n * Resolves as soon as the byte stream is available, with `downloading` as\n * the last event emitted and `loaded: 0`. Byte events and the terminal\n * `done` arrive as the caller reads the stream — and never arrive at all if\n * the caller abandons it.\n */\n download(\n input: AttachmentDownloadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentResponse>;\n /**\n * Document-authorized download materialized as a typed Blob. The Blob's\n * type comes from the server header unless overridden — that's what makes\n * browsers render PDFs inline and images correctly.\n */\n downloadBlob(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentBlobResult>;\n /**\n * Download and hand the bytes to the browser's save-file flow. Browser\n * only. fileName defaults to the server header's; pass the document's own\n * name for per-document naming.\n */\n saveAttachment(\n input: AttachmentDownloadInput,\n options?: AttachmentSaveOptions & AttachmentProgressOptions,\n ): Promise<void>;\n /**\n * Download and expose the bytes as an object URL for inline rendering\n * (img/iframe/video src). Callers MUST call revoke() when done — the URL\n * pins the blob in memory until then.\n */\n downloadObjectUrl(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentObjectUrl>;\n /**\n * Mint a public share link: a presigned URL anyone can fetch until it\n * expires, with no login. Authorized exactly like a download (document\n * read access + the reference index). Requires a presigned-capable\n * storage backend (S3); rejects when the server answers with an\n * authenticated switchboard target, which would not be public.\n */\n getShareLink(input: AttachmentShareLinkInput): Promise<AttachmentShareLink>;\n uploadMany(\n inputs: readonly AttachmentUploadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentUploadResult>[]>;\n downloadMany(\n inputs: readonly AttachmentDownloadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentResponse>[]>;\n}\n\n/**\n * Duck-typed dedup detection: bundlers (notably Vite dev pre-bundling) can\n * load two copies of this package's error classes, one for the service and\n * one for the client wrapper, making a plain instanceof check miss the\n * cross-copy throw. Name plus payload shape identifies the error reliably.\n */\nfunction isAttachmentAlreadyExists(\n err: unknown,\n): err is AttachmentAlreadyExists {\n if (err instanceof AttachmentAlreadyExists) return true;\n return (\n err instanceof Error &&\n err.name === \"AttachmentAlreadyExists\" &&\n typeof (err as { hash?: unknown }).hash === \"string\" &&\n typeof (err as { ref?: unknown }).ref === \"string\"\n );\n}\n\n// Nothing references the blob yet, so the server header is not readable.\nfunction dedupedHeader(\n hash: AttachmentHash,\n options: HashFirstReserveAttachmentOptions,\n): AttachmentHeader {\n const now = new Date().toISOString();\n return {\n hash,\n mimeType: options.mimeType,\n fileName: options.fileName,\n sizeBytes: options.sizeBytes,\n extension: options.extension ?? null,\n status: \"available\",\n source: \"local\",\n createdAtUtc: now,\n lastAccessedAtUtc: now,\n expiresAtUtc: null,\n };\n}\n\nfunction streamFromBuffer(buf: Uint8Array): ReadableStream<Uint8Array> {\n return new ReadableStream({\n start(controller) {\n controller.enqueue(buf);\n controller.close();\n },\n });\n}\n\n/** Stamps an item's index onto its progress events. */\nfunction itemProgress(\n options: AttachmentBatchOptions | undefined,\n index: number,\n): AttachmentProgressOptions | undefined {\n if (!options?.onProgress && options?.throttleMs === undefined) {\n return undefined;\n }\n return {\n ...(options.onProgress\n ? {\n onProgress: (progress: AttachmentProgress) =>\n options.onProgress?.({ ...progress, index }),\n }\n : {}),\n ...(options.throttleMs !== undefined\n ? { throttleMs: options.throttleMs }\n : {}),\n };\n}\n\nfunction batchRunOptions<R>(\n total: number,\n options: AttachmentBatchOptions | undefined,\n): RunWithConcurrencyOptions<R> {\n const onItemSettled = options?.onItemSettled;\n let settled = 0;\n let completed = 0;\n let failed = 0;\n return {\n concurrency: options?.concurrency ?? DEFAULT_ATTACHMENT_BATCH_CONCURRENCY,\n ...(options?.signal ? { signal: options.signal } : {}),\n ...(onItemSettled\n ? {\n onSettled: (result: BatchItemResult<R>) => {\n settled += 1;\n if (result.status === \"fulfilled\") completed += 1;\n else failed += 1;\n onItemSettled({ settled, completed, failed, total });\n },\n }\n : {}),\n };\n}\n\nclass AttachmentClientImpl implements IAttachmentClient {\n constructor(private readonly service: IAttachmentService) {}\n\n async preprocess(\n file: Blob,\n opts?: { fileName?: string; mimeType?: string },\n ): Promise<PreprocessResult> {\n const buf = await file.arrayBuffer();\n const bytes = new Uint8Array(buf);\n const digest = await globalThis.crypto.subtle.digest(\"SHA-256\", bytes);\n const hash = Array.from(new Uint8Array(digest))\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\") as AttachmentHash;\n const ref = createRef(hash);\n const sizeBytes = file.size;\n const mimeType = opts?.mimeType ?? file.type;\n const fileName =\n opts?.fileName ?? (file instanceof File ? file.name : \"attachment\");\n const options: HashFirstReserveAttachmentOptions = {\n mimeType,\n fileName,\n clientHash: hash,\n sizeBytes,\n };\n const data = streamFromBuffer(bytes);\n const stream = (): ReadableStream<Uint8Array> => streamFromBuffer(bytes);\n return { ref, hash, sizeBytes, options, data, stream };\n }\n\n /**\n * Reserve, distinguishing a confirmed dedup from a live upload handle in the\n * type rather than with a flag: the two outcomes move a different number of\n * bytes, and every caller has to account for that.\n */\n private async reserveOrDedup(\n options: HashFirstReserveAttachmentOptions,\n ): Promise<\n | { kind: \"handle\"; handle: IAttachmentUpload }\n | { kind: \"deduped\"; result: AttachmentUploadResult }\n > {\n try {\n return { kind: \"handle\", handle: await this.service.reserve(options) };\n } catch (err) {\n if (!isAttachmentAlreadyExists(err)) throw err;\n return {\n kind: \"deduped\",\n result: {\n hash: err.hash,\n ref: err.ref,\n header: dedupedHeader(err.hash, options),\n },\n };\n }\n }\n\n async reserve(\n options: HashFirstReserveAttachmentOptions,\n send: (handle: IAttachmentUpload) => Promise<AttachmentUploadResult>,\n ): Promise<AttachmentUploadResult> {\n const outcome = await this.reserveOrDedup(options);\n if (outcome.kind === \"deduped\") return outcome.result;\n return send(outcome.handle);\n }\n\n async upload(\n input: AttachmentUploadInput | AttachmentPreprocessedUploadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentUploadResult> {\n const emitter = new ProgressEmitter(options);\n const signal = input.signal;\n try {\n signal?.throwIfAborted();\n\n let preprocessed: PreprocessResult;\n if (\"preprocessed\" in input) {\n preprocessed = input.preprocessed;\n } else {\n // Hashing is genuinely unobservable: preprocess() runs one\n // crypto.subtle.digest over the whole buffer and WebCrypto has no\n // streaming digest. The stage is still reported, with a denominator\n // and indeterminate never cleared, so a UI can name what it waits on.\n emitter.stage(\"hashing\", { total: input.file.size });\n preprocessed = await this.preprocess(input.file, {\n ...(input.fileName !== undefined ? { fileName: input.fileName } : {}),\n ...(input.mimeType !== undefined ? { mimeType: input.mimeType } : {}),\n });\n }\n const sizeBytes = preprocessed.sizeBytes;\n\n signal?.throwIfAborted();\n emitter.stage(\"reserving\");\n const outcome = await this.reserveOrDedup(preprocessed.options);\n\n // A confirmed dedup never enters `uploading` — the server already holds\n // these bytes, so none are sent. Reporting zero of zero keeps the byte\n // model honest instead of stalling at 0 and then jumping to done.\n if (outcome.kind === \"deduped\") {\n emitter.finishDeduped();\n return outcome.result;\n }\n\n signal?.throwIfAborted();\n emitter.stage(\"uploading\", { total: sizeBytes });\n // `onProgress` only when someone is listening. The XHR transport keys\n // its `upload.onprogress` registration off the option being present, and\n // that registration alone forces a CORS preflight on a presigned PUT —\n // a cost an unwatched upload must not pay for a callback that would\n // discard every event anyway.\n const sendOptions: AttachmentSendOptions = {\n ...(emitter.active\n ? {\n onProgress: (loaded: number, total?: number) =>\n emitter.bytes(loaded, total ?? sizeBytes),\n }\n : {}),\n ...(signal ? { signal } : {}),\n };\n const result = await outcome.handle.send(\n preprocessed.stream(),\n sendOptions,\n );\n emitter.finish();\n return result;\n } catch (err) {\n emitter.fail();\n throw err;\n }\n }\n\n /**\n * The single site where download bytes are instrumented.\n *\n * It sits here, above the service, rather than in any store or transport:\n * one logical get can be several byte streams underneath (an evicted\n * attachment is fetched from the transport, written to disk, then re-read),\n * so counting lower down would double-count that path and still miss\n * local-filesystem reads. Wrapping what `service.get` returns covers the\n * presigned, switchboard, legacy and local paths by construction, and\n * `downloadBlob`/`saveAttachment`/`downloadObjectUrl` inherit it.\n */\n private async getWithProgress(\n input: AttachmentDownloadInput,\n emitter: ProgressEmitter,\n ): Promise<AttachmentResponse> {\n const { header, body } = await this.service.get(input.ref, {\n documentId: input.documentId,\n signal: input.signal,\n });\n emitter.stage(\"downloading\", { total: header.sizeBytes });\n if (!emitter.active) return { header, body };\n return {\n header,\n body: withByteProgress(body, {\n onBytes: (loaded) => emitter.bytes(loaded),\n onDone: () => emitter.finish(),\n onError: () => emitter.fail(),\n }),\n };\n }\n\n async download(\n input: AttachmentDownloadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentResponse> {\n const emitter = new ProgressEmitter(options);\n try {\n input.signal?.throwIfAborted();\n emitter.stage(\"requesting-download-target\");\n return await this.getWithProgress(input, emitter);\n } catch (err) {\n emitter.fail();\n throw err;\n }\n }\n\n async downloadBlob(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentBlobResult> {\n const emitter = new ProgressEmitter(options);\n try {\n input.signal?.throwIfAborted();\n emitter.stage(\"requesting-download-target\");\n const { header, body } = await this.getWithProgress(input, emitter);\n const reader = body.getReader();\n const chunks: BlobPart[] = [];\n for (;;) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value as BlobPart);\n }\n const blob = new Blob(chunks, {\n type: options?.mimeType ?? header.mimeType,\n });\n // Draining the stream already finished the emitter; latching makes this\n // a no-op there, and a guarantee for any body that closes without one.\n emitter.finish();\n return { blob, header };\n } catch (err) {\n emitter.fail();\n throw err;\n }\n }\n\n async saveAttachment(\n input: AttachmentDownloadInput,\n options?: AttachmentSaveOptions & AttachmentProgressOptions,\n ): Promise<void> {\n if (typeof document === \"undefined\") {\n throw new Error(\n \"saveAttachment requires a browser environment; use downloadBlob elsewhere\",\n );\n }\n const { blob, header } = await this.downloadBlob(input, options);\n const url = URL.createObjectURL(blob);\n try {\n const anchor = document.createElement(\"a\");\n anchor.href = url;\n anchor.download = options?.fileName ?? header.fileName;\n anchor.click();\n } finally {\n URL.revokeObjectURL(url);\n }\n }\n\n async downloadObjectUrl(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentObjectUrl> {\n const { blob, header } = await this.downloadBlob(input, options);\n const url = URL.createObjectURL(blob);\n let revoked = false;\n return {\n url,\n header,\n revoke: () => {\n if (revoked) return;\n revoked = true;\n URL.revokeObjectURL(url);\n },\n };\n }\n\n async getShareLink(\n input: AttachmentShareLinkInput,\n ): Promise<AttachmentShareLink> {\n input.signal?.throwIfAborted();\n const target = await this.service.getDownloadTarget(input.ref, {\n documentId: input.documentId,\n ...(input.expiresIn !== undefined ? { expiresIn: input.expiresIn } : {}),\n ...(input.signal !== undefined ? { signal: input.signal } : {}),\n });\n if (target.kind !== \"presigned-get\") {\n throw new Error(\n \"Public share links require a presigned-capable storage backend (S3); this server answered with an authenticated target\",\n );\n }\n return { url: target.url, expiresAtUtc: target.expiresAtUtc };\n }\n\n uploadMany(\n inputs: readonly AttachmentUploadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentUploadResult>[]> {\n return runWithConcurrency(\n inputs,\n (input, index) => this.upload(input, itemProgress(options, index)),\n batchRunOptions(inputs.length, options),\n );\n }\n\n /**\n * `concurrency` bounds download-target negotiation, not simultaneous byte\n * transfer: each item resolves when its stream is handed over, and the bytes\n * move only as the caller reads. Byte progress makes that pre-existing\n * behavior visible; it does not change it.\n */\n downloadMany(\n inputs: readonly AttachmentDownloadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentResponse>[]> {\n return runWithConcurrency(\n inputs,\n (input, index) => this.download(input, itemProgress(options, index)),\n batchRunOptions(inputs.length, options),\n );\n }\n}\n\nexport function createAttachmentClient(\n service: IAttachmentService,\n): IAttachmentClient {\n return new AttachmentClientImpl(service);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"client.js","names":[],"sources":["../src/concurrency.ts","../src/progress.ts","../src/client.ts"],"sourcesContent":["/**\n * Ordered result of one batch item. `index` always mirrors the input\n * position, so callers can correlate results with inputs regardless of\n * completion order, and successes are retained when siblings fail.\n */\nexport type BatchItemResult<R> =\n | { index: number; status: \"fulfilled\"; value: R }\n | { index: number; status: \"rejected\"; error: unknown };\n\nexport type RunWithConcurrencyOptions<R = unknown> = {\n /** Maximum simultaneously running workers. Must be a positive integer. */\n concurrency: number;\n /**\n * Whole-batch cancellation: unstarted items are rejected with the signal's\n * reason without ever starting, while already-started items keep running —\n * per-item signals are the mechanism for interrupting active work.\n */\n signal?: AbortSignal;\n /**\n * Called once per item as it settles, in completion order, including items\n * the signal skipped before they ever started. That completeness is the\n * point: a caller counting settlements must still reach `items.length`\n * after a whole-batch abort.\n */\n onSettled?: (result: BatchItemResult<R>) => void;\n};\n\n/**\n * Runs `worker` over `items` with a hard upper bound on simultaneous\n * executions. Bounding starts (not just transfers) is what keeps memory flat:\n * an item's preprocessing (hashing/buffering) only begins when a slot frees.\n */\nexport async function runWithConcurrency<T, R>(\n items: readonly T[],\n worker: (item: T, index: number) => Promise<R>,\n options: RunWithConcurrencyOptions<R>,\n): Promise<BatchItemResult<R>[]> {\n const { concurrency, signal, onSettled } = options;\n if (!Number.isInteger(concurrency) || concurrency < 1) {\n throw new Error(\n `concurrency must be a positive integer, got: ${concurrency}`,\n );\n }\n\n const results: BatchItemResult<R>[] = new Array<BatchItemResult<R>>(\n items.length,\n );\n let nextIndex = 0;\n\n async function runLane(): Promise<void> {\n for (;;) {\n const index = nextIndex++;\n if (index >= items.length) return;\n if (signal?.aborted) {\n results[index] = {\n index,\n status: \"rejected\",\n error: signalReason(signal),\n };\n onSettled?.(results[index]);\n continue;\n }\n try {\n const value = await worker(items[index], index);\n results[index] = { index, status: \"fulfilled\", value };\n } catch (error) {\n results[index] = { index, status: \"rejected\", error };\n }\n onSettled?.(results[index]);\n }\n }\n\n const lanes = Array.from(\n { length: Math.min(concurrency, items.length) },\n () => runLane(),\n );\n await Promise.all(lanes);\n return results;\n}\n\nfunction signalReason(signal: AbortSignal): unknown {\n return (\n (signal as { reason?: unknown }).reason ??\n new DOMException(\"The operation was aborted\", \"AbortError\")\n );\n}\n","/**\n * Byte-level progress for attachment transfers.\n *\n * `loaded`/`total` are per-stage, never per-operation. A per-operation\n * denominator would have to weight hashing against transfer, and a confirmed\n * dedup would shrink it mid-flight from 2N to N — the bar would run backwards.\n * Choosing that weighting is a UI decision the client cannot make.\n */\n\nexport type AttachmentStage =\n | \"hashing\"\n | \"reserving\"\n | \"uploading\"\n | \"requesting-download-target\"\n | \"downloading\"\n | \"done\"\n | \"error\";\n\nexport type AttachmentProgress = {\n stage: AttachmentStage;\n /** Bytes moved so far within `stage`. */\n loaded: number;\n /** Denominator for `stage`: file.size for uploads, header.sizeBytes for downloads. */\n total: number | undefined;\n /** True when the stage is running but bytes cannot (yet) be observed. */\n indeterminate: boolean;\n /** Only on a terminal `done` where dedup skipped the transfer entirely. */\n deduped?: true;\n};\n\nexport type AttachmentProgressListener = (progress: AttachmentProgress) => void;\n\nexport type AttachmentProgressOptions = {\n onProgress?: AttachmentProgressListener;\n /** Min ms between byte events within a stage. Default 100. 0 emits every observation. */\n throttleMs?: number;\n};\n\nexport const DEFAULT_PROGRESS_THROTTLE_MS = 100;\n\n/**\n * Fraction in 0..1 for a progress event. Indeterminate and unknown-total\n * events read as 0 — a bar cannot honestly show a position it does not know.\n * A zero total is complete by definition (the dedup case moves no bytes).\n */\nexport function progressFraction(progress: AttachmentProgress): number {\n if (progress.indeterminate) return 0;\n if (progress.total === undefined) return 0;\n if (progress.total === 0) return 1;\n const fraction = progress.loaded / progress.total;\n if (fraction < 0) return 0;\n return fraction > 1 ? 1 : fraction;\n}\n\nexport type ProgressEmitterOptions = AttachmentProgressOptions & {\n /** Injected clock so throttle tests stay synchronous. */\n now?: () => number;\n};\n\n/**\n * Emits `AttachmentProgress` for one single-item operation, upholding:\n *\n * - **I1** exactly one terminal event (`done` or `error`) — never both, never twice.\n * - **I2** on `done`: `indeterminate === false`, `total` is a number, `loaded === total`.\n * - **I3** `loaded` is non-decreasing within a stage and resets to 0 on stage change.\n * - **I4** the terminal event bypasses the throttle unconditionally.\n * - **I5** `error` carries the last known `loaded`/`total`.\n *\n * Leading edge: the first `bytes()` after a `stage()` always emits, so a bar\n * leaves 0 immediately. There is deliberately no trailing-edge timer — it\n * would leak on throw, could fire after the terminal event and violate I1's\n * ordering, and is unnecessary because `finish()` always emits\n * `loaded === total`, making a dropped last intra-stage tick invisible.\n */\nexport class ProgressEmitter {\n private readonly listener: AttachmentProgressListener | undefined;\n private readonly throttleMs: number;\n private readonly now: () => number;\n\n private currentStage: AttachmentStage | undefined;\n private loaded = 0;\n private total: number | undefined;\n private emittedBytesInStage = false;\n private lastEmitAt = Number.NEGATIVE_INFINITY;\n private settled = false;\n\n constructor(options?: ProgressEmitterOptions) {\n this.listener = options?.onProgress;\n this.throttleMs = options?.throttleMs ?? DEFAULT_PROGRESS_THROTTLE_MS;\n this.now = options?.now ?? (() => Date.now());\n }\n\n /** True when a listener is attached; lets callers skip instrumentation entirely. */\n get active(): boolean {\n return this.listener !== undefined;\n }\n\n /**\n * Enter a stage. Always emits and resets `loaded` to 0. Entry is always\n * indeterminate: no bytes have moved yet, and whether they can be observed\n * at all is only proven by a transport actually calling back.\n */\n stage(stage: AttachmentStage, options?: { total?: number }): void {\n if (this.settled) return;\n this.currentStage = stage;\n this.loaded = 0;\n this.total = options?.total;\n this.emittedBytesInStage = false;\n this.emit({\n stage,\n loaded: 0,\n total: this.total,\n indeterminate: true,\n });\n }\n\n /**\n * Report observed bytes within the current stage. Throttled by time, with\n * the first observation after a stage change always emitted.\n */\n bytes(loaded: number, total?: number): void {\n if (this.settled || this.currentStage === undefined) return;\n if (total !== undefined) this.total = total;\n if (loaded > this.loaded) this.loaded = loaded;\n\n const leadingEdge = !this.emittedBytesInStage;\n if (!leadingEdge && this.now() - this.lastEmitAt < this.throttleMs) return;\n this.emittedBytesInStage = true;\n this.emit({\n stage: this.currentStage,\n loaded: this.loaded,\n total: this.total,\n indeterminate: false,\n });\n }\n\n /**\n * Terminal success. `total` defaults to the bytes actually seen so a stage\n * with no known denominator still satisfies I2.\n */\n finish(override?: { loaded?: number; total?: number; deduped?: true }): void {\n if (this.settled) return;\n this.settled = true;\n const total = override?.total ?? this.total ?? this.loaded;\n const loaded = override?.loaded ?? total;\n this.emit({\n stage: \"done\",\n loaded,\n total,\n indeterminate: false,\n ...(override?.deduped ? { deduped: true as const } : {}),\n });\n }\n\n /** Terminal success for a confirmed dedup: no bytes moved, and none needed to. */\n finishDeduped(): void {\n this.finish({ loaded: 0, total: 0, deduped: true });\n }\n\n /** Terminal failure, carrying the last known byte counts. */\n fail(): void {\n if (this.settled) return;\n this.settled = true;\n this.emit({\n stage: \"error\",\n loaded: this.loaded,\n total: this.total,\n indeterminate: false,\n });\n }\n\n private emit(progress: AttachmentProgress): void {\n this.lastEmitAt = this.now();\n this.listener?.(progress);\n }\n}\n\nexport type ByteProgressHooks = {\n /** Cumulative bytes handed to the consumer. */\n onBytes?: (loaded: number) => void;\n /** The source ended and every byte reached the consumer. */\n onDone?: () => void;\n onError?: (error: unknown) => void;\n};\n\n/**\n * Count bytes as a consumer reads them.\n *\n * Uses the manual-reader form rather than `pipeThrough`, whose internal queue\n * reads far ahead of the consumer and would make `loaded` overstate what was\n * actually received. `highWaterMark: 0` is load-bearing for the same reason:\n * at the default of 1 the wrapper pulls one chunk the instant it is\n * constructed, so a caller who never reads still sees bytes counted.\n *\n * `cancel` propagates to the source, which is what keeps reader refcounts\n * (e.g. `KyselyAttachmentStore`'s) correct. Cancelling is an abandonment, not\n * a completion, so it reports `onError` — never `onDone` — carrying the\n * cancel reason the way an `AbortSignal` carries its own, with the DOM's\n * default `AbortError` when the canceller gave none.\n *\n * Returns `source` unchanged when no hook is supplied, so a caller with no\n * listener pays nothing.\n */\nexport function withByteProgress(\n source: ReadableStream<Uint8Array>,\n hooks: ByteProgressHooks,\n): ReadableStream<Uint8Array> {\n if (!hooks.onBytes && !hooks.onDone && !hooks.onError) return source;\n\n let loaded = 0;\n let cancelled = false;\n const reader = source.getReader();\n return new ReadableStream<Uint8Array>(\n {\n async pull(controller) {\n try {\n const { done, value } = await reader.read();\n // A cancel that lands while this read is in flight resolves it as\n // `done`, and closes the stream. Bailing out here is what stops an\n // abandoned transfer from reporting completion, and stops the\n // already-closed controller from throwing a fabricated error into\n // the catch below.\n if (cancelled) return;\n if (done) {\n hooks.onDone?.();\n controller.close();\n return;\n }\n loaded += value.byteLength;\n hooks.onBytes?.(loaded);\n controller.enqueue(value);\n } catch (err) {\n if (cancelled) return;\n hooks.onError?.(err);\n controller.error(err);\n }\n },\n cancel(reason) {\n cancelled = true;\n reader.cancel(reason).catch(() => {});\n hooks.onError?.(reason ?? abortError());\n },\n },\n { highWaterMark: 0 },\n );\n}\n\n/** What an `AbortSignal` carries when `abort()` is called with no reason. */\nfunction abortError(): DOMException {\n return new DOMException(\"The operation was aborted\", \"AbortError\");\n}\n","import type { AttachmentHash, AttachmentRef } from \"@powerhousedao/reactor\";\nimport { blobStream } from \"./blob.js\";\nimport {\n runWithConcurrency,\n type BatchItemResult,\n type RunWithConcurrencyOptions,\n} from \"./concurrency.js\";\nimport { AttachmentAlreadyExists } from \"./errors.js\";\nexport type { AttachmentTransferStage } from \"./errors.js\";\nexport {\n runWithConcurrency,\n type BatchItemResult,\n type RunWithConcurrencyOptions,\n} from \"./concurrency.js\";\nimport type { IAttachmentService, IAttachmentUpload } from \"./interfaces.js\";\nimport {\n ProgressEmitter,\n withByteProgress,\n type AttachmentProgress,\n type AttachmentProgressOptions,\n} from \"./progress.js\";\nimport { createRef } from \"./ref.js\";\nimport { sha256HexOfBlob } from \"./replication/hash.js\";\nimport type {\n AttachmentHeader,\n AttachmentResponse,\n AttachmentSendOptions,\n AttachmentUploadResult,\n HashFirstReserveAttachmentOptions,\n} from \"./types.js\";\n\nexport { AttachmentService } from \"./attachment-service.js\";\nexport {\n AttachmentAlreadyExists,\n AttachmentNotFound,\n AttachmentPending,\n AttachmentTransferError,\n HashMismatch,\n InvalidAttachmentRef,\n ReservationNotFound,\n SizeMismatch,\n UploadTooLarge,\n} from \"./errors.js\";\nexport type {\n IAttachmentReader,\n IAttachmentService,\n IAttachmentStore,\n IAttachmentTransport,\n IAttachmentTransportFactory,\n IAttachmentUpload,\n IAttachmentUploadFactory,\n IReservationStore,\n} from \"./interfaces.js\";\nexport { parseRef, createRef } from \"./ref.js\";\nexport type { ParsedRef } from \"./ref.js\";\nexport type {\n AttachmentDownloadOptions,\n AttachmentDownloadTarget,\n AttachmentDownloadTargetOptions,\n AttachmentHeader,\n AttachmentMetadata,\n AttachmentResponse,\n AttachmentSendOptions,\n AttachmentStatOptions,\n AttachmentStatus,\n AttachmentTransportConfig,\n AttachmentUploadResult,\n AttachmentTargetHeaders,\n AttachmentUploadTarget,\n HashFirstReserveAttachmentOptions,\n UploadFirstReserveAttachmentOptions,\n Reservation,\n ReserveAttachmentOptions,\n TransportFetchResult,\n TransportResponse,\n} from \"./types.js\";\nexport {\n parseAttachmentDownloadTarget,\n parseAttachmentUploadTarget,\n} from \"./targets.js\";\nexport {\n SwitchboardAttachmentTransport,\n type SwitchboardTransportConfig,\n RemoteReservationStore,\n type SwitchboardClientConfig,\n RemoteAttachmentUpload,\n RemoteAttachmentUploadFactory,\n RemoteAttachmentStore,\n createRemoteAttachmentService,\n createFetchUploadTransport,\n createXhrUploadTransport,\n type AttachmentUploadRequest,\n type AttachmentUploadResponse,\n type AttachmentUploadTransport,\n type XhrUploadTransportOptions,\n} from \"./switchboard/index.js\";\nexport { NullAttachmentTransport } from \"./null-attachment-transport.js\";\nexport {\n RoutingAttachmentService,\n type AttachmentRouteResolver,\n} from \"./routing/routing-attachment-service.js\";\nexport {\n DEFAULT_PROGRESS_THROTTLE_MS,\n progressFraction,\n ProgressEmitter,\n withByteProgress,\n type AttachmentProgress,\n type AttachmentProgressListener,\n type AttachmentProgressOptions,\n type AttachmentStage,\n type ByteProgressHooks,\n type ProgressEmitterOptions,\n} from \"./progress.js\";\n\nexport type PreprocessOptions = {\n fileName?: string;\n mimeType?: string;\n /** The document the attachment is for; see `ReserveAttachmentOptions`. */\n documentId?: string;\n};\n\nexport type PreprocessResult = {\n ref: AttachmentRef;\n hash: AttachmentHash;\n sizeBytes: number;\n options: HashFirstReserveAttachmentOptions;\n /** @deprecated Read `blob`; this is a stream of its bytes. */\n data: ReadableStream<Uint8Array>;\n /** @deprecated Read `blob`; each call is a new stream of its bytes. */\n stream: () => ReadableStream<Uint8Array>;\n /** The file itself; uploads send it as-is, so a browser streams it from disk. */\n blob: Blob;\n};\n\nexport type AttachmentUploadInput = {\n file: Blob;\n fileName?: string;\n mimeType?: string;\n /** The document the attachment is for; see `ReserveAttachmentOptions`. */\n documentId?: string;\n /** Per-item cancellation, checked between stages. */\n signal?: AbortSignal;\n};\n\n/**\n * Upload bytes that were already hashed by a separate `preprocess()` call.\n *\n * This is the canonical two-call flow: the ref must reach the document before\n * the bytes are committed, so callers preprocess, dispatch the operation, then\n * upload. Passing the result back in skips the hashing stage rather than\n * faking a zero-millisecond one.\n */\nexport type AttachmentPreprocessedUploadInput = {\n preprocessed: PreprocessResult;\n signal?: AbortSignal;\n};\n\n/**\n * Every remote download names the document that authorizes its ref; batches\n * may freely mix documents because the anchor travels with each item.\n */\nexport type AttachmentDownloadInput = {\n documentId: string;\n ref: AttachmentRef;\n signal?: AbortSignal;\n};\n\n/**\n * The document keeps its own name and type for an attachment (the same\n * bytes may appear under different names in different documents), so the\n * blob-producing conveniences let callers override what the server header\n * reports from upload time.\n */\nexport type AttachmentBlobOptions = {\n mimeType?: string;\n};\n\nexport type AttachmentSaveOptions = {\n fileName?: string;\n mimeType?: string;\n};\n\nexport type AttachmentBlobResult = {\n blob: Blob;\n header: AttachmentHeader;\n};\n\nexport type AttachmentObjectUrl = {\n /** Ready for img/iframe/video src. Pins memory until revoke() is called. */\n url: string;\n header: AttachmentHeader;\n revoke: () => void;\n};\n\nexport type AttachmentShareLinkInput = {\n documentId: string;\n ref: AttachmentRef;\n /** Requested link lifetime in seconds; the server clamps to its maximum. */\n expiresIn?: number;\n signal?: AbortSignal;\n};\n\n/**\n * A self-contained public URL: anyone holding it can fetch the bytes until\n * expiresAtUtc, with no login and no document access. Minting one requires\n * document read access; once minted it cannot be revoked before expiry.\n */\nexport type AttachmentShareLink = {\n url: string;\n expiresAtUtc: string;\n};\n\n/**\n * Batch progress is per item, carrying the item's `index`. There is\n * deliberately no batch-wide byte total: weighting items against each other is\n * a presentation decision the client cannot make, and a confirmed dedup would\n * shrink the denominator mid-flight.\n */\nexport type AttachmentBatchOptions = {\n /** Bounds preprocessing and transfer together. Defaults to 4. */\n concurrency?: number;\n /** Whole-batch cancellation: stops unstarted items. */\n signal?: AbortSignal;\n onProgress?: (progress: AttachmentProgress & { index: number }) => void;\n /**\n * Fired as each item settles, including items the signal skipped before they\n * started, so `settled` always reaches `total`.\n */\n onItemSettled?: (counts: AttachmentBatchCounts) => void;\n /** Min ms between byte events, applied per item rather than batch-wide. */\n throttleMs?: number;\n};\n\nexport type AttachmentBatchCounts = {\n settled: number;\n completed: number;\n failed: number;\n total: number;\n};\n\nexport const DEFAULT_ATTACHMENT_BATCH_CONCURRENCY = 4;\n\nexport interface IAttachmentClient {\n preprocess(file: Blob, opts?: PreprocessOptions): Promise<PreprocessResult>;\n reserve(\n options: HashFirstReserveAttachmentOptions,\n send: (handle: IAttachmentUpload) => Promise<AttachmentUploadResult>,\n ): Promise<AttachmentUploadResult>;\n /**\n * Hash, reserve, and transfer one file; a confirmed dedup skips the transfer\n * and reports a terminal `done` carrying `deduped: true` and zero bytes.\n *\n * Also accepts an already-preprocessed payload, so the canonical\n * preprocess -> dispatch -> upload flow reports progress too.\n */\n upload(\n input: AttachmentUploadInput | AttachmentPreprocessedUploadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentUploadResult>;\n /**\n * Document-authorized download of one ref.\n *\n * Resolves as soon as the byte stream is available, with `downloading` as\n * the last event emitted and `loaded: 0`. Byte events and the terminal\n * `done` arrive as the caller reads the stream — and never arrive at all if\n * the caller abandons it.\n */\n download(\n input: AttachmentDownloadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentResponse>;\n /**\n * Document-authorized download materialized as a typed Blob. The Blob's\n * type comes from the server header unless overridden — that's what makes\n * browsers render PDFs inline and images correctly.\n */\n downloadBlob(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentBlobResult>;\n /**\n * Download and hand the bytes to the browser's save-file flow. Browser\n * only. fileName defaults to the server header's; pass the document's own\n * name for per-document naming.\n */\n saveAttachment(\n input: AttachmentDownloadInput,\n options?: AttachmentSaveOptions & AttachmentProgressOptions,\n ): Promise<void>;\n /**\n * Download and expose the bytes as an object URL for inline rendering\n * (img/iframe/video src). Callers MUST call revoke() when done — the URL\n * pins the blob in memory until then.\n */\n downloadObjectUrl(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentObjectUrl>;\n /**\n * Mint a public share link: a presigned URL anyone can fetch until it\n * expires, with no login. Authorized exactly like a download (document\n * read access + the reference index). Requires a presigned-capable\n * storage backend (S3); rejects when the server answers with an\n * authenticated switchboard target, which would not be public.\n */\n getShareLink(input: AttachmentShareLinkInput): Promise<AttachmentShareLink>;\n uploadMany(\n inputs: readonly AttachmentUploadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentUploadResult>[]>;\n downloadMany(\n inputs: readonly AttachmentDownloadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentResponse>[]>;\n}\n\n/**\n * Duck-typed dedup detection: bundlers (notably Vite dev pre-bundling) can\n * load two copies of this package's error classes, one for the service and\n * one for the client wrapper, making a plain instanceof check miss the\n * cross-copy throw. Name plus payload shape identifies the error reliably.\n */\nfunction isAttachmentAlreadyExists(\n err: unknown,\n): err is AttachmentAlreadyExists {\n if (err instanceof AttachmentAlreadyExists) return true;\n return (\n err instanceof Error &&\n err.name === \"AttachmentAlreadyExists\" &&\n typeof (err as { hash?: unknown }).hash === \"string\" &&\n typeof (err as { ref?: unknown }).ref === \"string\"\n );\n}\n\n// Nothing references the blob yet, so the server header is not readable.\nfunction dedupedHeader(\n hash: AttachmentHash,\n options: HashFirstReserveAttachmentOptions,\n): AttachmentHeader {\n const now = new Date().toISOString();\n return {\n hash,\n mimeType: options.mimeType,\n fileName: options.fileName,\n sizeBytes: options.sizeBytes,\n extension: options.extension ?? null,\n status: \"available\",\n source: \"local\",\n createdAtUtc: now,\n lastAccessedAtUtc: now,\n expiresAtUtc: null,\n };\n}\n\n/** Stamps an item's index onto its progress events. */\nfunction itemProgress(\n options: AttachmentBatchOptions | undefined,\n index: number,\n): AttachmentProgressOptions | undefined {\n if (!options?.onProgress && options?.throttleMs === undefined) {\n return undefined;\n }\n return {\n ...(options.onProgress\n ? {\n onProgress: (progress: AttachmentProgress) =>\n options.onProgress?.({ ...progress, index }),\n }\n : {}),\n ...(options.throttleMs !== undefined\n ? { throttleMs: options.throttleMs }\n : {}),\n };\n}\n\nfunction batchRunOptions<R>(\n total: number,\n options: AttachmentBatchOptions | undefined,\n): RunWithConcurrencyOptions<R> {\n const onItemSettled = options?.onItemSettled;\n let settled = 0;\n let completed = 0;\n let failed = 0;\n return {\n concurrency: options?.concurrency ?? DEFAULT_ATTACHMENT_BATCH_CONCURRENCY,\n ...(options?.signal ? { signal: options.signal } : {}),\n ...(onItemSettled\n ? {\n onSettled: (result: BatchItemResult<R>) => {\n settled += 1;\n if (result.status === \"fulfilled\") completed += 1;\n else failed += 1;\n onItemSettled({ settled, completed, failed, total });\n },\n }\n : {}),\n };\n}\n\nclass AttachmentClientImpl implements IAttachmentClient {\n constructor(private readonly service: IAttachmentService) {}\n\n preprocess(file: Blob, opts?: PreprocessOptions): Promise<PreprocessResult> {\n return this.hashFile(file, opts);\n }\n\n private async hashFile(\n file: Blob,\n opts?: PreprocessOptions,\n signal?: AbortSignal,\n ): Promise<PreprocessResult> {\n const hash = await sha256HexOfBlob(file, signal ? { signal } : undefined);\n const ref = createRef(hash);\n const sizeBytes = file.size;\n const mimeType = opts?.mimeType ?? file.type;\n const fileName =\n opts?.fileName ?? (file instanceof File ? file.name : \"attachment\");\n const options: HashFirstReserveAttachmentOptions = {\n mimeType,\n fileName,\n clientHash: hash,\n sizeBytes,\n ...(opts?.documentId !== undefined\n ? { documentId: opts.documentId }\n : {}),\n };\n const data = blobStream(file);\n const stream = (): ReadableStream<Uint8Array> => blobStream(file);\n return { ref, hash, sizeBytes, options, data, stream, blob: file };\n }\n\n /**\n * Reserve, distinguishing a confirmed dedup from a live upload handle in the\n * type rather than with a flag: the two outcomes move a different number of\n * bytes, and every caller has to account for that.\n */\n private async reserveOrDedup(\n options: HashFirstReserveAttachmentOptions,\n ): Promise<\n | { kind: \"handle\"; handle: IAttachmentUpload }\n | { kind: \"deduped\"; result: AttachmentUploadResult }\n > {\n try {\n return { kind: \"handle\", handle: await this.service.reserve(options) };\n } catch (err) {\n if (!isAttachmentAlreadyExists(err)) throw err;\n return {\n kind: \"deduped\",\n result: {\n hash: err.hash,\n ref: err.ref,\n header: dedupedHeader(err.hash, options),\n },\n };\n }\n }\n\n async reserve(\n options: HashFirstReserveAttachmentOptions,\n send: (handle: IAttachmentUpload) => Promise<AttachmentUploadResult>,\n ): Promise<AttachmentUploadResult> {\n const outcome = await this.reserveOrDedup(options);\n if (outcome.kind === \"deduped\") return outcome.result;\n return send(outcome.handle);\n }\n\n async upload(\n input: AttachmentUploadInput | AttachmentPreprocessedUploadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentUploadResult> {\n const emitter = new ProgressEmitter(options);\n const signal = input.signal;\n try {\n signal?.throwIfAborted();\n\n let preprocessed: PreprocessResult;\n if (\"preprocessed\" in input) {\n preprocessed = input.preprocessed;\n } else {\n // Hashing reports no bytes, so the stage stays indeterminate; a UI\n // can still name the wait. The signal stops it between slices.\n emitter.stage(\"hashing\", { total: input.file.size });\n preprocessed = await this.hashFile(\n input.file,\n {\n ...(input.fileName !== undefined\n ? { fileName: input.fileName }\n : {}),\n ...(input.mimeType !== undefined\n ? { mimeType: input.mimeType }\n : {}),\n ...(input.documentId !== undefined\n ? { documentId: input.documentId }\n : {}),\n },\n signal,\n );\n }\n const sizeBytes = preprocessed.sizeBytes;\n\n signal?.throwIfAborted();\n emitter.stage(\"reserving\");\n const outcome = await this.reserveOrDedup(preprocessed.options);\n\n // A confirmed dedup never enters `uploading` — the server already holds\n // these bytes, so none are sent. Reporting zero of zero keeps the byte\n // model honest instead of stalling at 0 and then jumping to done.\n if (outcome.kind === \"deduped\") {\n emitter.finishDeduped();\n return outcome.result;\n }\n\n signal?.throwIfAborted();\n emitter.stage(\"uploading\", { total: sizeBytes });\n // `onProgress` only when someone is listening. The XHR transport keys\n // its `upload.onprogress` registration off the option being present, and\n // that registration alone forces a CORS preflight on a presigned PUT —\n // a cost an unwatched upload must not pay for a callback that would\n // discard every event anyway.\n const sendOptions: AttachmentSendOptions = {\n ...(emitter.active\n ? {\n onProgress: (loaded: number, total?: number) =>\n emitter.bytes(loaded, total ?? sizeBytes),\n }\n : {}),\n ...(signal ? { signal } : {}),\n };\n const result = await outcome.handle.send(preprocessed.blob, sendOptions);\n emitter.finish();\n return result;\n } catch (err) {\n emitter.fail();\n throw err;\n }\n }\n\n /**\n * The single site where download bytes are instrumented.\n *\n * It sits here, above the service, rather than in any store or transport:\n * one logical get can be several byte streams underneath (an evicted\n * attachment is fetched from the transport, written to disk, then re-read),\n * so counting lower down would double-count that path and still miss\n * local-filesystem reads. Wrapping what `service.get` returns covers the\n * presigned, switchboard, legacy and local paths by construction, and\n * `downloadBlob`/`saveAttachment`/`downloadObjectUrl` inherit it.\n */\n private async getWithProgress(\n input: AttachmentDownloadInput,\n emitter: ProgressEmitter,\n ): Promise<AttachmentResponse> {\n const { header, body } = await this.service.get(input.ref, {\n documentId: input.documentId,\n signal: input.signal,\n });\n emitter.stage(\"downloading\", { total: header.sizeBytes });\n if (!emitter.active) return { header, body };\n return {\n header,\n body: withByteProgress(body, {\n onBytes: (loaded) => emitter.bytes(loaded),\n onDone: () => emitter.finish(),\n onError: () => emitter.fail(),\n }),\n };\n }\n\n async download(\n input: AttachmentDownloadInput,\n options?: AttachmentProgressOptions,\n ): Promise<AttachmentResponse> {\n const emitter = new ProgressEmitter(options);\n try {\n input.signal?.throwIfAborted();\n emitter.stage(\"requesting-download-target\");\n return await this.getWithProgress(input, emitter);\n } catch (err) {\n emitter.fail();\n throw err;\n }\n }\n\n async downloadBlob(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentBlobResult> {\n const emitter = new ProgressEmitter(options);\n try {\n input.signal?.throwIfAborted();\n emitter.stage(\"requesting-download-target\");\n const { header, body } = await this.getWithProgress(input, emitter);\n const reader = body.getReader();\n const chunks: BlobPart[] = [];\n for (;;) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value as BlobPart);\n }\n const blob = new Blob(chunks, {\n type: options?.mimeType ?? header.mimeType,\n });\n // Draining the stream already finished the emitter; latching makes this\n // a no-op there, and a guarantee for any body that closes without one.\n emitter.finish();\n return { blob, header };\n } catch (err) {\n emitter.fail();\n throw err;\n }\n }\n\n async saveAttachment(\n input: AttachmentDownloadInput,\n options?: AttachmentSaveOptions & AttachmentProgressOptions,\n ): Promise<void> {\n if (typeof document === \"undefined\") {\n throw new Error(\n \"saveAttachment requires a browser environment; use downloadBlob elsewhere\",\n );\n }\n const { blob, header } = await this.downloadBlob(input, options);\n const url = URL.createObjectURL(blob);\n try {\n const anchor = document.createElement(\"a\");\n anchor.href = url;\n anchor.download = options?.fileName ?? header.fileName;\n anchor.click();\n } finally {\n URL.revokeObjectURL(url);\n }\n }\n\n async downloadObjectUrl(\n input: AttachmentDownloadInput,\n options?: AttachmentBlobOptions & AttachmentProgressOptions,\n ): Promise<AttachmentObjectUrl> {\n const { blob, header } = await this.downloadBlob(input, options);\n const url = URL.createObjectURL(blob);\n let revoked = false;\n return {\n url,\n header,\n revoke: () => {\n if (revoked) return;\n revoked = true;\n URL.revokeObjectURL(url);\n },\n };\n }\n\n async getShareLink(\n input: AttachmentShareLinkInput,\n ): Promise<AttachmentShareLink> {\n input.signal?.throwIfAborted();\n const target = await this.service.getDownloadTarget(input.ref, {\n documentId: input.documentId,\n ...(input.expiresIn !== undefined ? { expiresIn: input.expiresIn } : {}),\n ...(input.signal !== undefined ? { signal: input.signal } : {}),\n });\n if (target.kind !== \"presigned-get\") {\n throw new Error(\n \"Public share links require a presigned-capable storage backend (S3); this server answered with an authenticated target\",\n );\n }\n return { url: target.url, expiresAtUtc: target.expiresAtUtc };\n }\n\n uploadMany(\n inputs: readonly AttachmentUploadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentUploadResult>[]> {\n return runWithConcurrency(\n inputs,\n (input, index) => this.upload(input, itemProgress(options, index)),\n batchRunOptions(inputs.length, options),\n );\n }\n\n /**\n * `concurrency` bounds download-target negotiation, not simultaneous byte\n * transfer: each item resolves when its stream is handed over, and the bytes\n * move only as the caller reads. Byte progress makes that pre-existing\n * behavior visible; it does not change it.\n */\n downloadMany(\n inputs: readonly AttachmentDownloadInput[],\n options?: AttachmentBatchOptions,\n ): Promise<BatchItemResult<AttachmentResponse>[]> {\n return runWithConcurrency(\n inputs,\n (input, index) => this.download(input, itemProgress(options, index)),\n batchRunOptions(inputs.length, options),\n );\n }\n}\n\nexport function createAttachmentClient(\n service: IAttachmentService,\n): IAttachmentClient {\n return new AttachmentClientImpl(service);\n}\n"],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import { sha256 } from "@noble/hashes/sha2.js";
2
+ import { bytesToHex } from "@noble/hashes/utils.js";
3
+ const nodeCrypto = globalThis.process?.getBuiltinModule?.("node:crypto");
4
+ /** Native SHA-256 from node:crypto, or undefined outside Node. */
5
+ function nodeSha256() {
6
+ if (!nodeCrypto) return void 0;
7
+ const hash = nodeCrypto.createHash("sha256");
8
+ return {
9
+ update: (bytes) => void hash.update(bytes),
10
+ hex: () => hash.digest("hex")
11
+ };
12
+ }
13
+ /** SHA-256 in JavaScript, for browsers; about 10x slower than native. */
14
+ function jsSha256() {
15
+ const hash = sha256.create();
16
+ return {
17
+ update: (bytes) => void hash.update(bytes),
18
+ hex: () => bytesToHex(hash.digest())
19
+ };
20
+ }
21
+ /**
22
+ * Lowercase SHA-256 hex of `bytes` -- the `attachment://v1:` hash format
23
+ * (`packages/reactor/src/attachments/types.ts`).
24
+ *
25
+ * WebCrypto, so the same code runs in Node and in a browser realm. There is no
26
+ * streaming digest in WebCrypto, which is why verification happens over
27
+ * collected bytes.
28
+ */
29
+ async function sha256Hex(bytes) {
30
+ const digest = await globalThis.crypto.subtle.digest("SHA-256", digestable(bytes));
31
+ return Array.from(new Uint8Array(digest)).map((byte) => byte.toString(16).padStart(2, "0")).join("");
32
+ }
33
+ /** WebCrypto refuses a SharedArrayBuffer-backed view, so only that one is copied. */
34
+ function digestable(bytes) {
35
+ if (typeof SharedArrayBuffer !== "undefined" && bytes.buffer instanceof SharedArrayBuffer) {
36
+ const copy = new Uint8Array(bytes.byteLength);
37
+ copy.set(bytes);
38
+ return copy;
39
+ }
40
+ return bytes;
41
+ }
42
+ /** Same digest as `sha256Hex`, in bounded memory: natively in slices in Node, and in a
43
+ * browser whole up to `oneShotMaxBytes`, then in JavaScript slices (no ~2 GB read). */
44
+ async function sha256HexOfBlob(blob, options) {
45
+ const chunkBytes = options?.chunkBytes ?? 8388608;
46
+ if (!Number.isInteger(chunkBytes) || chunkBytes <= 0) throw new RangeError("chunkBytes must be a positive integer");
47
+ options?.signal?.throwIfAborted();
48
+ let hasher = (options?.native ?? nodeSha256)();
49
+ if (!hasher) {
50
+ if (blob.size <= (options?.oneShotMaxBytes ?? 268435456)) return sha256Hex(new Uint8Array(await blob.arrayBuffer()));
51
+ hasher = jsSha256();
52
+ }
53
+ for (let offset = 0; offset < blob.size; offset += chunkBytes) {
54
+ options?.signal?.throwIfAborted();
55
+ const chunk = blob.slice(offset, offset + chunkBytes);
56
+ hasher.update(new Uint8Array(await chunk.arrayBuffer()));
57
+ }
58
+ return hasher.hex();
59
+ }
60
+ //#endregion
61
+ export { sha256HexOfBlob as n, sha256Hex as t };
62
+
63
+ //# sourceMappingURL=hash-BobbR4r4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash-BobbR4r4.js","names":[],"sources":["../src/replication/hash.ts"],"sourcesContent":["import { sha256 } from \"@noble/hashes/sha2.js\";\nimport { bytesToHex } from \"@noble/hashes/utils.js\";\nimport type { AttachmentHash } from \"@powerhousedao/reactor\";\n\n/** Bytes read per `Blob.slice` when hashing a Blob incrementally. */\nexport const DEFAULT_HASH_CHUNK_BYTES = 8 * 1024 * 1024;\n\n/** Largest Blob a browser hashes in one native WebCrypto call; it is held in memory. */\nexport const ONE_SHOT_HASH_MAX_BYTES = 256 * 1024 * 1024;\n\n/** An incremental SHA-256: WebCrypto has none, so these fill the gap. */\nexport type IncrementalSha256 = {\n update(bytes: Uint8Array): void;\n hex(): string;\n};\n\ntype NodeCrypto = {\n createHash(algorithm: \"sha256\"): {\n update(bytes: Uint8Array): unknown;\n digest(encoding: \"hex\"): string;\n };\n};\n\n// A call, not an import, so browser bundles never see node:crypto.\nconst nodeCrypto = (\n globalThis as {\n process?: { getBuiltinModule?: (id: string) => unknown };\n }\n).process?.getBuiltinModule?.(\"node:crypto\") as NodeCrypto | undefined;\n\n/** Native SHA-256 from node:crypto, or undefined outside Node. */\nexport function nodeSha256(): IncrementalSha256 | undefined {\n if (!nodeCrypto) return undefined;\n const hash = nodeCrypto.createHash(\"sha256\");\n return {\n update: (bytes) => void hash.update(bytes),\n hex: () => hash.digest(\"hex\"),\n };\n}\n\n/** SHA-256 in JavaScript, for browsers; about 10x slower than native. */\nexport function jsSha256(): IncrementalSha256 {\n const hash = sha256.create();\n return {\n update: (bytes) => void hash.update(bytes),\n hex: () => bytesToHex(hash.digest()),\n };\n}\n\n/**\n * Lowercase SHA-256 hex of `bytes` -- the `attachment://v1:` hash format\n * (`packages/reactor/src/attachments/types.ts`).\n *\n * WebCrypto, so the same code runs in Node and in a browser realm. There is no\n * streaming digest in WebCrypto, which is why verification happens over\n * collected bytes.\n */\nexport async function sha256Hex(bytes: Uint8Array): Promise<AttachmentHash> {\n const digest = await globalThis.crypto.subtle.digest(\n \"SHA-256\",\n digestable(bytes),\n );\n return Array.from(new Uint8Array(digest))\n .map((byte) => byte.toString(16).padStart(2, \"0\"))\n .join(\"\");\n}\n\n/** WebCrypto refuses a SharedArrayBuffer-backed view, so only that one is copied. */\nfunction digestable(bytes: Uint8Array): Uint8Array<ArrayBuffer> {\n if (\n typeof SharedArrayBuffer !== \"undefined\" &&\n bytes.buffer instanceof SharedArrayBuffer\n ) {\n const copy = new Uint8Array(bytes.byteLength);\n copy.set(bytes);\n return copy;\n }\n return bytes as Uint8Array<ArrayBuffer>;\n}\n\nexport type BlobHashOptions = {\n chunkBytes?: number;\n /** Without a native hasher: up to this size, one WebCrypto call over the whole Blob. */\n oneShotMaxBytes?: number;\n /** The native incremental hasher; defaults to node:crypto, absent in a browser. */\n native?: () => IncrementalSha256 | undefined;\n signal?: AbortSignal;\n};\n\n/** Same digest as `sha256Hex`, in bounded memory: natively in slices in Node, and in a\n * browser whole up to `oneShotMaxBytes`, then in JavaScript slices (no ~2 GB read). */\nexport async function sha256HexOfBlob(\n blob: Blob,\n options?: BlobHashOptions,\n): Promise<AttachmentHash> {\n const chunkBytes = options?.chunkBytes ?? DEFAULT_HASH_CHUNK_BYTES;\n if (!Number.isInteger(chunkBytes) || chunkBytes <= 0) {\n throw new RangeError(\"chunkBytes must be a positive integer\");\n }\n options?.signal?.throwIfAborted();\n let hasher = (options?.native ?? nodeSha256)();\n if (!hasher) {\n if (blob.size <= (options?.oneShotMaxBytes ?? ONE_SHOT_HASH_MAX_BYTES)) {\n return sha256Hex(new Uint8Array(await blob.arrayBuffer()));\n }\n hasher = jsSha256();\n }\n for (let offset = 0; offset < blob.size; offset += chunkBytes) {\n options?.signal?.throwIfAborted();\n const chunk = blob.slice(offset, offset + chunkBytes);\n hasher.update(new Uint8Array(await chunk.arrayBuffer()));\n }\n return hasher.hex();\n}\n"],"mappings":";;AAwBA,MAAM,aACJ,WAGA,SAAS,mBAAmB,aAAa;;AAG3C,SAAgB,aAA4C;CAC1D,IAAI,CAAC,YAAY,OAAO,KAAA;CACxB,MAAM,OAAO,WAAW,WAAW,QAAQ;CAC3C,OAAO;EACL,SAAS,UAAU,KAAK,KAAK,OAAO,KAAK;EACzC,WAAW,KAAK,OAAO,KAAK;CAC9B;AACF;;AAGA,SAAgB,WAA8B;CAC5C,MAAM,OAAO,OAAO,OAAO;CAC3B,OAAO;EACL,SAAS,UAAU,KAAK,KAAK,OAAO,KAAK;EACzC,WAAW,WAAW,KAAK,OAAO,CAAC;CACrC;AACF;;;;;;;;;AAUA,eAAsB,UAAU,OAA4C;CAC1E,MAAM,SAAS,MAAM,WAAW,OAAO,OAAO,OAC5C,WACA,WAAW,KAAK,CAClB;CACA,OAAO,MAAM,KAAK,IAAI,WAAW,MAAM,CAAC,CAAC,CACtC,KAAK,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CACjD,KAAK,EAAE;AACZ;;AAGA,SAAS,WAAW,OAA4C;CAC9D,IACE,OAAO,sBAAsB,eAC7B,MAAM,kBAAkB,mBACxB;EACA,MAAM,OAAO,IAAI,WAAW,MAAM,UAAU;EAC5C,KAAK,IAAI,KAAK;EACd,OAAO;CACT;CACA,OAAO;AACT;;;AAaA,eAAsB,gBACpB,MACA,SACyB;CACzB,MAAM,aAAa,SAAS,cAAA;CAC5B,IAAI,CAAC,OAAO,UAAU,UAAU,KAAK,cAAc,GACjD,MAAM,IAAI,WAAW,uCAAuC;CAE9D,SAAS,QAAQ,eAAe;CAChC,IAAI,UAAU,SAAS,UAAU,WAAA,CAAY;CAC7C,IAAI,CAAC,QAAQ;EACX,IAAI,KAAK,SAAS,SAAS,mBAAA,YACzB,OAAO,UAAU,IAAI,WAAW,MAAM,KAAK,YAAY,CAAC,CAAC;EAE3D,SAAS,SAAS;CACpB;CACA,KAAK,IAAI,SAAS,GAAG,SAAS,KAAK,MAAM,UAAU,YAAY;EAC7D,SAAS,QAAQ,eAAe;EAChC,MAAM,QAAQ,KAAK,MAAM,QAAQ,SAAS,UAAU;EACpD,OAAO,OAAO,IAAI,WAAW,MAAM,MAAM,YAAY,CAAC,CAAC;CACzD;CACA,OAAO,OAAO,IAAI;AACpB"}
package/dist/index.d.ts CHANGED
@@ -1,7 +1,24 @@
1
- import { $ as AttachmentNotFound, A as IReservationStore, B as AttachmentStatOptions, C as IAttachmentReader, D as IAttachmentTransportFactory, E as IAttachmentTransport, G as AttachmentUploadTarget, H as AttachmentTargetHeaders, I as AttachmentHeader, J as ReserveAttachmentOptions, K as HashFirstReserveAttachmentOptions, L as AttachmentMetadata, M as AttachmentBackendKind, N as AttachmentDownloadOptions, O as IAttachmentUpload, P as AttachmentDownloadTarget, Q as AttachmentAlreadyExists, R as AttachmentResponse, S as IAttachmentBackend, T as IAttachmentStore, U as AttachmentTransportConfig, V as AttachmentStatus, W as AttachmentUploadResult, X as TransportResponse, Y as TransportFetchResult, Z as UploadFirstReserveAttachmentOptions, _ as createRef, a as RemoteAttachmentUpload, at as ReservationNotFound, b as parseAttachmentDownloadTarget, c as XhrUploadTransportOptions, d as AttachmentUploadResponse, et as AttachmentPending, f as AttachmentUploadTransport, g as ParsedRef, h as SwitchboardTransportConfig, i as RemoteAttachmentUploadFactory, it as InvalidAttachmentRef, j as AttachmentBackendHealth, k as IAttachmentUploadFactory, l as createXhrUploadTransport, m as SwitchboardAttachmentTransport, n as createRemoteAttachmentService, nt as AttachmentTransferStage, o as RemoteReservationStore, ot as SizeMismatch, p as createFetchUploadTransport, q as Reservation, r as RemoteAttachmentStore, rt as HashMismatch, s as SwitchboardClientConfig, st as UploadTooLarge, t as NullAttachmentTransport, tt as AttachmentTransferError, u as AttachmentUploadRequest, v as parseRef, w as IAttachmentService, x as parseAttachmentUploadTarget, y as AttachmentService, z as AttachmentSendOptions } from "./null-attachment-transport-BkM6rq4R.js";
1
+ import { A as HashMismatch, C as parseAttachmentUploadTarget, D as AttachmentPending, E as AttachmentNotFound, F as UploadTooLarge, M as InvalidAttachmentRef, N as ReservationNotFound, O as AttachmentTransferError, P as SizeMismatch, S as parseAttachmentDownloadTarget, T as AttachmentMetadataField, _ as SwitchboardTransportConfig, a as RemoteAttachmentStore, b as parseRef, c as RemoteReservationStore, d as createXhrUploadTransport, f as AttachmentUploadRequest, g as SwitchboardAttachmentTransport, h as createFetchUploadTransport, i as createRemoteAttachmentService, j as InvalidAttachmentMetadata, k as AttachmentTransferStage, l as SwitchboardClientConfig, m as AttachmentUploadTransport, n as RoutingAttachmentService, o as RemoteAttachmentUploadFactory, p as AttachmentUploadResponse, r as NullAttachmentTransport, s as RemoteAttachmentUpload, t as AttachmentRouteResolver, u as XhrUploadTransportOptions, v as ParsedRef, w as AttachmentAlreadyExists, x as AttachmentService, y as createRef } from "./routing-attachment-service-Dri6e2Vz.js";
2
+ import { A as UploadFirstReserveAttachmentOptions, C as AttachmentUploadResult, D as ReserveAttachmentOptions, E as Reservation, O as TransportFetchResult, S as AttachmentTransportConfig, T as HashFirstReserveAttachmentOptions, _ as AttachmentResponse, a as IAttachmentTransport, b as AttachmentStatus, c as IAttachmentUploadFactory, d as AttachmentBackendKind, f as AttachmentDownloadOptions, g as AttachmentMetadata, h as AttachmentHeader, i as IAttachmentStore, k as TransportResponse, l as IReservationStore, m as AttachmentDownloadTargetOptions, n as IAttachmentReader, o as IAttachmentTransportFactory, p as AttachmentDownloadTarget, r as IAttachmentService, s as IAttachmentUpload, t as IAttachmentBackend, u as AttachmentBackendHealth, v as AttachmentSendOptions, w as AttachmentUploadTarget, x as AttachmentTargetHeaders, y as AttachmentStatOptions } from "./interfaces-cFMtcMqR.js";
3
+ import { a as IAttachmentReferenceScanner, c as IAttachmentSchemaCompiler, i as IAttachmentReferenceReader, n as AttachmentReferencePageResult, o as IAttachmentReferenceWriter, s as CompiledAttachmentExtractor, t as AttachmentReferenceInput } from "./types-AagIcjTD.js";
2
4
  import { Kysely } from "kysely";
3
5
  import { AttachmentHash, AttachmentRef, BaseReadModel, DocumentViewDatabase, IConsistencyTracker, IDocumentModelRegistry, IOperationIndex, IWriteCache } from "@powerhousedao/reactor";
4
- import { Action, DocumentModelModule, OperationWithContext } from "@powerhousedao/shared/document-model";
6
+ import { DocumentModelModule, OperationWithContext } from "@powerhousedao/shared/document-model";
7
+ //#region src/reserve-metadata.d.ts
8
+ /** The descriptive fields of a reservation, as a caller supplies them. */
9
+ type ReserveMetadata = {
10
+ mimeType: string;
11
+ fileName: string;
12
+ extension?: string | null;
13
+ };
14
+ /**
15
+ * Validates reserve metadata with the rules the switchboard reserve route
16
+ * applies.
17
+ *
18
+ * @throws InvalidAttachmentMetadata naming the first field that fails.
19
+ */
20
+ export declare function validateReserveMetadata(meta: ReserveMetadata): void;
21
+ //#endregion
5
22
  //#region src/storage/kysely/types.d.ts
6
23
  interface AttachmentTable {
7
24
  hash: string;
@@ -83,7 +100,7 @@ export declare class DirectAttachmentUpload implements IAttachmentUpload {
83
100
  readonly ref: AttachmentRef | null;
84
101
  readonly expiresAtUtc: string;
85
102
  constructor(reservation: Reservation, db: Kysely<AttachmentDatabase>, basePath: string, reservations: IReservationStore, maxBytes?: number | undefined);
86
- send(data: ReadableStream<Uint8Array>, options?: AttachmentSendOptions): Promise<AttachmentUploadResult>;
103
+ send(data: ReadableStream<Uint8Array> | Blob, options?: AttachmentSendOptions): Promise<AttachmentUploadResult>;
87
104
  }
88
105
  //#endregion
89
106
  //#region src/direct/direct-attachment-upload-factory.d.ts
@@ -154,38 +171,12 @@ export declare class AttachmentBuilder {
154
171
  build(): Promise<AttachmentBuildResult>;
155
172
  }
156
173
  //#endregion
157
- //#region src/reference-index/types.d.ts
158
- interface CompiledAttachmentExtractor {
159
- extract(action: Action): AttachmentRef[];
160
- }
161
- interface IAttachmentSchemaCompiler {
162
- forModuleAction(module: DocumentModelModule, actionType: string): CompiledAttachmentExtractor;
163
- }
164
- //#endregion
165
174
  //#region src/reference-index/attachment-schema-compiler.d.ts
166
175
  export declare class AttachmentSchemaCompiler implements IAttachmentSchemaCompiler {
167
176
  private readonly cache;
168
177
  forModuleAction(module: DocumentModelModule, actionType: string): CompiledAttachmentExtractor;
169
178
  }
170
179
  //#endregion
171
- //#region src/read-models/attachment-reference/types.d.ts
172
- interface AttachmentReferenceInput {
173
- documentId: string;
174
- ref: AttachmentRef;
175
- operationId: string;
176
- branch: string;
177
- scope: string;
178
- ordinal: number;
179
- }
180
- interface IAttachmentReferenceReader {
181
- hasReference(documentId: string, ref: AttachmentRef): Promise<boolean>;
182
- /** The scopes whose operations reference the attachment; empty when none. */
183
- referencingScopes(documentId: string, ref: AttachmentRef): Promise<string[]>;
184
- }
185
- interface IAttachmentReferenceWriter {
186
- addReferences(references: readonly AttachmentReferenceInput[]): Promise<void>;
187
- }
188
- //#endregion
189
180
  //#region src/read-models/attachment-reference/index-builder.d.ts
190
181
  type AttachmentReferenceIndexBuildResult = {
191
182
  store: IAttachmentReferenceReader & IAttachmentReferenceWriter;
@@ -204,6 +195,9 @@ export declare const ATTACHMENT_REFERENCE_READ_MODEL_ID = "attachment-reference-
204
195
  * Each reference row stands on its own and is written insert-or-do-nothing, so
205
196
  * a batch that commits in pieces exposes no partial structure, and re-indexing
206
197
  * the same range writes nothing new: the catch-up sweep needs no stream suffix.
198
+ *
199
+ * The rows live on another handle, so the purge fence is "skip": a tombstoned
200
+ * id's operations are dropped at commit and its marker deletes its rows.
207
201
  */
208
202
  export declare class AttachmentReferenceReadModel extends BaseReadModel {
209
203
  private readonly documentModelRegistry;
@@ -229,12 +223,20 @@ interface AttachmentReferenceDatabase {
229
223
  }
230
224
  //#endregion
231
225
  //#region src/read-models/attachment-reference/kysely-attachment-reference-store.d.ts
232
- export declare class KyselyAttachmentReferenceStore implements IAttachmentReferenceReader, IAttachmentReferenceWriter {
226
+ export declare class KyselyAttachmentReferenceStore implements IAttachmentReferenceReader, IAttachmentReferenceScanner, IAttachmentReferenceWriter {
233
227
  private readonly db;
234
228
  constructor(db: Kysely<AttachmentReferenceDatabase>);
235
229
  hasReference(documentId: string, ref: AttachmentRef): Promise<boolean>;
236
230
  referencingScopes(documentId: string, ref: AttachmentRef): Promise<string[]>;
231
+ /**
232
+ * Keyset paging over the unique `(document_id, attachment_ref)` constraint,
233
+ * rather than OFFSET: a scan that runs while the read model is still
234
+ * indexing must not skip or repeat a row because rows appeared behind the
235
+ * cursor. That is exactly the boot case the replicator's re-scan runs in.
236
+ */
237
+ listReferences(cursor: string | undefined, limit: number): Promise<AttachmentReferencePageResult>;
237
238
  addReferences(references: readonly AttachmentReferenceInput[]): Promise<void>;
239
+ removeDocuments(documentIds: readonly string[]): Promise<void>;
238
240
  }
239
241
  //#endregion
240
242
  //#region src/read-models/attachment-reference/storage/migrations/migrator.d.ts
@@ -335,6 +337,6 @@ export declare class S3AttachmentUploadFactory implements IAttachmentUploadFacto
335
337
  createUpload(reservation: Reservation): IAttachmentUpload;
336
338
  }
337
339
  //#endregion
338
- export { AttachmentAlreadyExists, type AttachmentBackendHealth, type AttachmentBackendKind, type AttachmentBuildResult, type AttachmentDatabase, type AttachmentDownloadOptions, type AttachmentDownloadTarget, type AttachmentHeader, type AttachmentMetadata, AttachmentNotFound, AttachmentPending, type AttachmentReferenceIndexBuildResult, type AttachmentReferenceInput, type AttachmentReferenceMigrationResult, type AttachmentResponse, type AttachmentSendOptions, AttachmentService, type AttachmentStatOptions, type AttachmentStatus, type AttachmentStorageConfig, type AttachmentTargetHeaders, AttachmentTransferError, type AttachmentTransferStage, type AttachmentTransportConfig, type AttachmentUploadRequest, type AttachmentUploadResponse, type AttachmentUploadResult, type AttachmentUploadTarget, type AttachmentUploadTransport, type CompiledAttachmentExtractor, type FilesystemAttachmentBackendConfig, type HashFirstReserveAttachmentOptions, HashMismatch, type IAttachmentBackend, type IAttachmentReader, type IAttachmentReferenceReader, type IAttachmentReferenceWriter, type IAttachmentSchemaCompiler, type IAttachmentService, type IAttachmentStore, type IAttachmentTransport, type IAttachmentTransportFactory, type IAttachmentUpload, type IAttachmentUploadFactory, type IReservationStore, InvalidAttachmentRef, NullAttachmentTransport, type ParsedRef, RemoteAttachmentStore, RemoteAttachmentUpload, RemoteAttachmentUploadFactory, RemoteReservationStore, type Reservation, ReservationNotFound, type ReserveAttachmentOptions, type S3AttachmentBackendDependencies, type S3AttachmentConfig, type S3CommandClient, type S3Presigner, SizeMismatch, SwitchboardAttachmentTransport, type SwitchboardClientConfig, type SwitchboardTransportConfig, type TransportFetchResult, type TransportResponse, type UploadFirstReserveAttachmentOptions, UploadTooLarge, type XhrUploadTransportOptions, createFetchUploadTransport, createRef, createRemoteAttachmentService, createXhrUploadTransport, parseAttachmentDownloadTarget, parseAttachmentUploadTarget, parseRef };
340
+ export { AttachmentAlreadyExists, type AttachmentBackendHealth, type AttachmentBackendKind, type AttachmentBuildResult, type AttachmentDatabase, type AttachmentDownloadOptions, type AttachmentDownloadTarget, type AttachmentDownloadTargetOptions, type AttachmentHeader, type AttachmentMetadata, type AttachmentMetadataField, AttachmentNotFound, AttachmentPending, type AttachmentReferenceIndexBuildResult, type AttachmentReferenceInput, type AttachmentReferenceMigrationResult, type AttachmentResponse, type AttachmentRouteResolver, type AttachmentSendOptions, AttachmentService, type AttachmentStatOptions, type AttachmentStatus, type AttachmentStorageConfig, type AttachmentTargetHeaders, AttachmentTransferError, type AttachmentTransferStage, type AttachmentTransportConfig, type AttachmentUploadRequest, type AttachmentUploadResponse, type AttachmentUploadResult, type AttachmentUploadTarget, type AttachmentUploadTransport, type CompiledAttachmentExtractor, type FilesystemAttachmentBackendConfig, type HashFirstReserveAttachmentOptions, HashMismatch, type IAttachmentBackend, type IAttachmentReader, type IAttachmentReferenceReader, type IAttachmentReferenceWriter, type IAttachmentSchemaCompiler, type IAttachmentService, type IAttachmentStore, type IAttachmentTransport, type IAttachmentTransportFactory, type IAttachmentUpload, type IAttachmentUploadFactory, type IReservationStore, InvalidAttachmentMetadata, InvalidAttachmentRef, NullAttachmentTransport, type ParsedRef, RemoteAttachmentStore, RemoteAttachmentUpload, RemoteAttachmentUploadFactory, RemoteReservationStore, type Reservation, ReservationNotFound, type ReserveAttachmentOptions, type ReserveMetadata, RoutingAttachmentService, type S3AttachmentBackendDependencies, type S3AttachmentConfig, type S3CommandClient, type S3Presigner, SizeMismatch, SwitchboardAttachmentTransport, type SwitchboardClientConfig, type SwitchboardTransportConfig, type TransportFetchResult, type TransportResponse, type UploadFirstReserveAttachmentOptions, UploadTooLarge, type XhrUploadTransportOptions, createFetchUploadTransport, createRef, createRemoteAttachmentService, createXhrUploadTransport, parseAttachmentDownloadTarget, parseAttachmentUploadTarget, parseRef };
339
341
  export {};
340
342
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/storage/kysely/types.ts","../src/storage/kysely/attachment-store.ts","../src/storage/kysely/reservation-store.ts","../src/storage/migrations/migrator.ts","../src/direct/direct-attachment-upload.ts","../src/direct/direct-attachment-upload-factory.ts","../src/direct/filesystem-attachment-backend.ts","../src/attachment-builder.ts","../src/reference-index/types.ts","../src/reference-index/attachment-schema-compiler.ts","../src/read-models/attachment-reference/types.ts","../src/read-models/attachment-reference/index-builder.ts","../src/read-models/attachment-reference/attachment-reference-read-model.ts","../src/read-models/attachment-reference/storage/types.ts","../src/read-models/attachment-reference/kysely-attachment-reference-store.ts","../src/read-models/attachment-reference/storage/migrations/migrator.ts","../src/storage/s3/config.ts","../src/storage/s3/keying.ts","../src/storage/s3/primitives.ts","../src/storage/s3/backend.ts","../src/storage/s3/upload-factory.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/reserve-metadata.ts","../src/storage/kysely/types.ts","../src/storage/kysely/attachment-store.ts","../src/storage/kysely/reservation-store.ts","../src/storage/migrations/migrator.ts","../src/direct/direct-attachment-upload.ts","../src/direct/direct-attachment-upload-factory.ts","../src/direct/filesystem-attachment-backend.ts","../src/attachment-builder.ts","../src/reference-index/attachment-schema-compiler.ts","../src/read-models/attachment-reference/index-builder.ts","../src/read-models/attachment-reference/attachment-reference-read-model.ts","../src/read-models/attachment-reference/storage/types.ts","../src/read-models/attachment-reference/kysely-attachment-reference-store.ts","../src/read-models/attachment-reference/storage/migrations/migrator.ts","../src/storage/s3/config.ts","../src/storage/s3/keying.ts","../src/storage/s3/primitives.ts","../src/storage/s3/backend.ts","../src/storage/s3/upload-factory.ts"],"mappings":"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"}