@tranquilload/core 0.1.0 → 0.1.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @tranquilload/core@0.1.0 build /home/runner/work/Tranquilload/Tranquilload/packages/tranquilload-core
+> @tranquilload/core@0.1.1 build /home/runner/work/Tranquilload/Tranquilload/packages/tranquilload-core
 > tsdown
 
 ℹ tsdown v0.21.0 powered by rolldown v1.0.0-rc.7
@@ -7,82 +7,82 @@
 ℹ entry: src/multipart/index.ts, src/oneshot/index.ts, src/pipeline/index.ts, src/services/index.ts, src/errors/index.ts, src/progress/index.ts
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ [CJS] dist/multipart.cjs                         10.93 kB │ gzip: 2.98 kB
-ℹ [CJS] dist/oneshot.cjs                            2.83 kB │ gzip: 1.12 kB
-ℹ [CJS] dist/pipeline.cjs                           0.92 kB │ gzip: 0.46 kB
-ℹ [CJS] dist/services.cjs                           0.62 kB │ gzip: 0.23 kB
-ℹ [CJS] dist/errors.cjs                             0.61 kB │ gzip: 0.24 kB
-ℹ [CJS] dist/progress.cjs                           0.00 kB │ gzip: 0.02 kB
-ℹ [CJS] dist/multipart.cjs.map                     25.56 kB │ gzip: 6.86 kB
-ℹ [CJS] dist/oneshot.cjs.map                        6.41 kB │ gzip: 2.27 kB
-ℹ [CJS] dist/upload-error-BUexBh08.cjs.map          3.48 kB │ gzip: 0.86 kB
-ℹ [CJS] dist/upload-error-BUexBh08.cjs              2.98 kB │ gzip: 0.65 kB
-ℹ [CJS] dist/pipeline.cjs.map                       2.17 kB │ gzip: 0.81 kB
-ℹ [CJS] dist/normalize-callback-BNBZZ1jT.cjs.map    1.99 kB │ gzip: 0.84 kB
-ℹ [CJS] dist/compression-service-Bn86iTJe.cjs.map   1.73 kB │ gzip: 0.80 kB
-ℹ [CJS] dist/normalize-callback-BNBZZ1jT.cjs        1.30 kB │ gzip: 0.54 kB
-ℹ [CJS] dist/compression-service-Bn86iTJe.cjs       1.24 kB │ gzip: 0.49 kB
-ℹ [CJS] dist/logger-service-cx8vzkXs.cjs.map        0.82 kB │ gzip: 0.48 kB
-ℹ [CJS] dist/logger-service-cx8vzkXs.cjs            0.58 kB │ gzip: 0.32 kB
-ℹ [CJS] 17 files, total: 64.16 kB
-ℹ [CJS] dist/index-Ch8xM6Xt.d.cts.map                1.27 kB │ gzip: 0.49 kB
-ℹ [CJS] dist/upload-error-B2ISUc_k.d.cts.map         0.87 kB │ gzip: 0.30 kB
-ℹ [CJS] dist/upload-event-D77olieX.d.cts.map         0.59 kB │ gzip: 0.23 kB
+ℹ [CJS] dist/multipart.cjs                         15.08 kB │ gzip:  3.94 kB
+ℹ [CJS] dist/oneshot.cjs                            2.83 kB │ gzip:  1.12 kB
+ℹ [CJS] dist/pipeline.cjs                           0.92 kB │ gzip:  0.46 kB
+ℹ [CJS] dist/errors.cjs                             0.75 kB │ gzip:  0.27 kB
+ℹ [CJS] dist/services.cjs                           0.62 kB │ gzip:  0.23 kB
+ℹ [CJS] dist/progress.cjs                           0.00 kB │ gzip:  0.02 kB
+ℹ [CJS] dist/multipart.cjs.map                     37.96 kB │ gzip: 10.59 kB
+ℹ [CJS] dist/oneshot.cjs.map                        6.41 kB │ gzip:  2.27 kB
+ℹ [CJS] dist/upload-error-BG1dOOl3.cjs.map          4.63 kB │ gzip:  1.28 kB
+ℹ [CJS] dist/upload-error-BG1dOOl3.cjs              3.90 kB │ gzip:  0.99 kB
+ℹ [CJS] dist/pipeline.cjs.map                       2.17 kB │ gzip:  0.81 kB
+ℹ [CJS] dist/normalize-callback-BdLtk9jb.cjs.map    1.99 kB │ gzip:  0.84 kB
+ℹ [CJS] dist/compression-service-Bn86iTJe.cjs.map   1.73 kB │ gzip:  0.80 kB
+ℹ [CJS] dist/normalize-callback-BdLtk9jb.cjs        1.30 kB │ gzip:  0.54 kB
+ℹ [CJS] dist/compression-service-Bn86iTJe.cjs       1.24 kB │ gzip:  0.49 kB
+ℹ [CJS] dist/logger-service-cx8vzkXs.cjs.map        0.82 kB │ gzip:  0.48 kB
+ℹ [CJS] dist/logger-service-cx8vzkXs.cjs            0.58 kB │ gzip:  0.32 kB
+ℹ [CJS] 17 files, total: 82.94 kB
+ℹ [CJS] dist/index-BaeUV_fj.d.cts.map                1.61 kB │ gzip: 0.59 kB
+ℹ [CJS] dist/upload-error-DTYVNlaJ.d.cts.map         0.98 kB │ gzip: 0.33 kB
+ℹ [CJS] dist/upload-event-BT_nXgM9.d.cts.map         0.62 kB │ gzip: 0.25 kB
 ℹ [CJS] dist/oneshot.d.cts.map                       0.51 kB │ gzip: 0.27 kB
 ℹ [CJS] dist/middleware-CYcctmlY.d.cts.map           0.42 kB │ gzip: 0.23 kB
 ℹ [CJS] dist/compression-service-CiF7Px08.d.cts.map  0.36 kB │ gzip: 0.24 kB
 ℹ [CJS] dist/logger-service-CbN12RhO.d.cts.map       0.28 kB │ gzip: 0.20 kB
 ℹ [CJS] dist/pipeline.d.cts.map                      0.18 kB │ gzip: 0.15 kB
 ℹ [CJS] dist/oneshot.d.cts                           1.19 kB │ gzip: 0.52 kB
+ℹ [CJS] dist/errors.d.cts                            0.48 kB │ gzip: 0.22 kB
 ℹ [CJS] dist/pipeline.d.cts                          0.43 kB │ gzip: 0.27 kB
-ℹ [CJS] dist/errors.d.cts                            0.39 kB │ gzip: 0.19 kB
 ℹ [CJS] dist/services.d.cts                          0.38 kB │ gzip: 0.18 kB
 ℹ [CJS] dist/progress.d.cts                          0.36 kB │ gzip: 0.20 kB
-ℹ [CJS] dist/multipart.d.cts                         0.29 kB │ gzip: 0.16 kB
-ℹ [CJS] dist/index-Ch8xM6Xt.d.cts                    2.49 kB │ gzip: 0.86 kB
-ℹ [CJS] dist/upload-error-B2ISUc_k.d.cts             1.81 kB │ gzip: 0.44 kB
-ℹ [CJS] dist/upload-event-D77olieX.d.cts             1.12 kB │ gzip: 0.37 kB
+ℹ [CJS] dist/multipart.d.cts                         0.32 kB │ gzip: 0.18 kB
+ℹ [CJS] dist/index-BaeUV_fj.d.cts                    6.50 kB │ gzip: 2.42 kB
+ℹ [CJS] dist/upload-error-DTYVNlaJ.d.cts             2.82 kB │ gzip: 0.81 kB
+ℹ [CJS] dist/upload-event-BT_nXgM9.d.cts             1.38 kB │ gzip: 0.52 kB
 ℹ [CJS] dist/compression-service-CiF7Px08.d.cts      0.79 kB │ gzip: 0.36 kB
 ℹ [CJS] dist/logger-service-CbN12RhO.d.cts           0.57 kB │ gzip: 0.33 kB
 ℹ [CJS] dist/middleware-CYcctmlY.d.cts               0.50 kB │ gzip: 0.26 kB
-ℹ [CJS] 20 files, total: 14.79 kB
-✔ Build complete in 2839ms
-ℹ [ESM] dist/multipart.mjs                           10.01 kB │ gzip: 2.93 kB
-ℹ [ESM] dist/oneshot.mjs                              2.55 kB │ gzip: 1.05 kB
-ℹ [ESM] dist/pipeline.mjs                             0.76 kB │ gzip: 0.39 kB
-ℹ [ESM] dist/errors.mjs                               0.35 kB │ gzip: 0.18 kB
-ℹ [ESM] dist/services.mjs                             0.35 kB │ gzip: 0.17 kB
-ℹ [ESM] dist/progress.mjs                             0.01 kB │ gzip: 0.03 kB
-ℹ [ESM] dist/multipart.mjs.map                       24.41 kB │ gzip: 6.58 kB
-ℹ [ESM] dist/oneshot.mjs.map                          6.07 kB │ gzip: 2.17 kB
-ℹ [ESM] dist/upload-error-zDvpxT9X.mjs.map            3.48 kB │ gzip: 0.87 kB
-ℹ [ESM] dist/upload-error-zDvpxT9X.mjs                2.17 kB │ gzip: 0.58 kB
-ℹ [ESM] dist/pipeline.mjs.map                         2.09 kB │ gzip: 0.80 kB
-ℹ [ESM] dist/normalize-callback-DQ6C4gaV.mjs.map      1.88 kB │ gzip: 0.82 kB
-ℹ [ESM] dist/compression-service-Bm1VBnhT.mjs.map     1.67 kB │ gzip: 0.79 kB
-ℹ [ESM] dist/index-DBGtgXEd.d.mts.map                 1.27 kB │ gzip: 0.49 kB
-ℹ [ESM] dist/normalize-callback-DQ6C4gaV.mjs          1.00 kB │ gzip: 0.48 kB
-ℹ [ESM] dist/compression-service-Bm1VBnhT.mjs         0.91 kB │ gzip: 0.44 kB
-ℹ [ESM] dist/upload-error-jol-eoDW.d.mts.map          0.87 kB │ gzip: 0.30 kB
-ℹ [ESM] dist/logger-service-1J5r_akj.mjs.map          0.79 kB │ gzip: 0.46 kB
-ℹ [ESM] dist/upload-event-C9TOVp5l.d.mts.map          0.59 kB │ gzip: 0.24 kB
-ℹ [ESM] dist/oneshot.d.mts.map                        0.51 kB │ gzip: 0.27 kB
-ℹ [ESM] dist/middleware-CAI0cnW2.d.mts.map            0.42 kB │ gzip: 0.23 kB
-ℹ [ESM] dist/logger-service-1J5r_akj.mjs              0.38 kB │ gzip: 0.26 kB
-ℹ [ESM] dist/compression-service-DI7ZXVxH.d.mts.map   0.36 kB │ gzip: 0.24 kB
-ℹ [ESM] dist/logger-service-BF2pZOHN.d.mts.map        0.28 kB │ gzip: 0.20 kB
-ℹ [ESM] dist/pipeline.d.mts.map                       0.18 kB │ gzip: 0.15 kB
-ℹ [ESM] dist/oneshot.d.mts                            1.19 kB │ gzip: 0.52 kB
-ℹ [ESM] dist/pipeline.d.mts                           0.43 kB │ gzip: 0.27 kB
-ℹ [ESM] dist/errors.d.mts                             0.39 kB │ gzip: 0.19 kB
-ℹ [ESM] dist/services.d.mts                           0.38 kB │ gzip: 0.18 kB
-ℹ [ESM] dist/progress.d.mts                           0.36 kB │ gzip: 0.20 kB
-ℹ [ESM] dist/multipart.d.mts                          0.29 kB │ gzip: 0.17 kB
-ℹ [ESM] dist/index-DBGtgXEd.d.mts                     2.49 kB │ gzip: 0.87 kB
-ℹ [ESM] dist/upload-error-jol-eoDW.d.mts              1.81 kB │ gzip: 0.44 kB
-ℹ [ESM] dist/upload-event-C9TOVp5l.d.mts              1.12 kB │ gzip: 0.37 kB
-ℹ [ESM] dist/compression-service-DI7ZXVxH.d.mts       0.79 kB │ gzip: 0.36 kB
-ℹ [ESM] dist/logger-service-BF2pZOHN.d.mts            0.57 kB │ gzip: 0.33 kB
-ℹ [ESM] dist/middleware-CAI0cnW2.d.mts                0.50 kB │ gzip: 0.27 kB
-ℹ [ESM] 37 files, total: 73.70 kB
-✔ Build complete in 2847ms
+ℹ [CJS] 20 files, total: 20.68 kB
+✔ Build complete in 2670ms
+ℹ [ESM] dist/multipart.mjs                           13.88 kB │ gzip:  3.89 kB
+ℹ [ESM] dist/oneshot.mjs                              2.55 kB │ gzip:  1.05 kB
+ℹ [ESM] dist/pipeline.mjs                             0.76 kB │ gzip:  0.39 kB
+ℹ [ESM] dist/errors.mjs                               0.44 kB │ gzip:  0.21 kB
+ℹ [ESM] dist/services.mjs                             0.35 kB │ gzip:  0.17 kB
+ℹ [ESM] dist/progress.mjs                             0.01 kB │ gzip:  0.03 kB
+ℹ [ESM] dist/multipart.mjs.map                       36.62 kB │ gzip: 10.29 kB
+ℹ [ESM] dist/oneshot.mjs.map                          6.07 kB │ gzip:  2.17 kB
+ℹ [ESM] dist/upload-error-Dbz_9j81.mjs.map            4.63 kB │ gzip:  1.29 kB
+ℹ [ESM] dist/upload-error-Dbz_9j81.mjs                2.99 kB │ gzip:  0.92 kB
+ℹ [ESM] dist/pipeline.mjs.map                         2.09 kB │ gzip:  0.80 kB
+ℹ [ESM] dist/normalize-callback-tcZ_nyq5.mjs.map      1.88 kB │ gzip:  0.82 kB
+ℹ [ESM] dist/compression-service-Bm1VBnhT.mjs.map     1.67 kB │ gzip:  0.79 kB
+ℹ [ESM] dist/index-bpWq6tje.d.mts.map                 1.61 kB │ gzip:  0.59 kB
+ℹ [ESM] dist/normalize-callback-tcZ_nyq5.mjs          1.00 kB │ gzip:  0.48 kB
+ℹ [ESM] dist/upload-error-jBco270d.d.mts.map          0.98 kB │ gzip:  0.33 kB
+ℹ [ESM] dist/compression-service-Bm1VBnhT.mjs         0.91 kB │ gzip:  0.44 kB
+ℹ [ESM] dist/logger-service-1J5r_akj.mjs.map          0.79 kB │ gzip:  0.46 kB
+ℹ [ESM] dist/upload-event-DOGbegxa.d.mts.map          0.62 kB │ gzip:  0.25 kB
+ℹ [ESM] dist/oneshot.d.mts.map                        0.51 kB │ gzip:  0.27 kB
+ℹ [ESM] dist/middleware-CAI0cnW2.d.mts.map            0.42 kB │ gzip:  0.23 kB
+ℹ [ESM] dist/logger-service-1J5r_akj.mjs              0.38 kB │ gzip:  0.26 kB
+ℹ [ESM] dist/compression-service-DI7ZXVxH.d.mts.map   0.36 kB │ gzip:  0.24 kB
+ℹ [ESM] dist/logger-service-BF2pZOHN.d.mts.map        0.28 kB │ gzip:  0.20 kB
+ℹ [ESM] dist/pipeline.d.mts.map                       0.18 kB │ gzip:  0.15 kB
+ℹ [ESM] dist/oneshot.d.mts                            1.19 kB │ gzip:  0.52 kB
+ℹ [ESM] dist/errors.d.mts                             0.48 kB │ gzip:  0.22 kB
+ℹ [ESM] dist/pipeline.d.mts                           0.43 kB │ gzip:  0.27 kB
+ℹ [ESM] dist/services.d.mts                           0.38 kB │ gzip:  0.18 kB
+ℹ [ESM] dist/progress.d.mts                           0.36 kB │ gzip:  0.20 kB
+ℹ [ESM] dist/multipart.d.mts                          0.32 kB │ gzip:  0.18 kB
+ℹ [ESM] dist/index-bpWq6tje.d.mts                     6.50 kB │ gzip:  2.42 kB
+ℹ [ESM] dist/upload-error-jBco270d.d.mts              2.82 kB │ gzip:  0.82 kB
+ℹ [ESM] dist/upload-event-DOGbegxa.d.mts              1.38 kB │ gzip:  0.51 kB
+ℹ [ESM] dist/compression-service-DI7ZXVxH.d.mts       0.79 kB │ gzip:  0.36 kB
+ℹ [ESM] dist/logger-service-BF2pZOHN.d.mts            0.57 kB │ gzip:  0.33 kB
+ℹ [ESM] dist/middleware-CAI0cnW2.d.mts                0.50 kB │ gzip:  0.27 kB
+ℹ [ESM] 37 files, total: 97.73 kB
+✔ Build complete in 2683ms

package/CHANGELOG.md

@@ -0,0 +1,67 @@
+# @tranquilload/core
+
+## 0.1.1
+
+### Patch Changes
+
+- 6ca9186: Resume safety: opaque `ResumeState`, content-digest validation, pipeline-identity check.
+
+  The pre-v0.2 resume pattern (re-passing a stored `uploadId` via `initiate`)
+  had three silent-corruption gaps: chunkSize drift, content swap, and pipeline
+  drift. This release ships an opaque `ResumeState` that the lib produces, you
+  persist, and the lib re-validates before any byte is uploaded.
+
+  **New surface:**
+
+  - `ResumeState` — opaque, JSON-serializable resume metadata carrying `version`,
+    `uploadId`, `chunkSize`, optional `pipelineIdentity`, optional `contentDigest`,
+    and the `contentDigestCaptured` flag.
+  - `resumeFrom: ResumeState` option on `uploadMultipart` — validates match
+    synchronously (version, chunkSize, pipelineIdentity, captured-but-dropped
+    digest) and asynchronously (digest value), then uses `resumeFrom.uploadId`
+    directly (skipping `initiate`).
+  - `getContentDigest: () => string | Promise<string> | Effect<string, UploadError>`
+    option — lightweight stable identifier of the source content. Captured on
+    fresh init, compared on resume. Stable patterns:
+    `` `${name}|${size}|${lastModified}` `` for browser files;
+    `` `${path}|${stat.size}|${stat.mtimeMs}` `` for Node fs.
+  - `pipelineIdentity: string` option — opaque, strict-equality identifier for
+    the upstream pipeline composition.
+  - `resumeState: Promise<ResumeState>` on `uploadMultipart`'s return — resolves
+    with the state you should persist.
+  - `ResumeMismatchError` — new `UploadError` variant with a `reason`
+    discriminant: `version_mismatch | chunksize_mismatch | pipeline_mismatch |
+content_mismatch`. Dispatch with `Match.value(err.reason)` inside the
+    `Match.tag("ResumeMismatchError", ...)` handler.
+
+  **Behaviour change (semver-minor under pre-1.0 SemVer):** `initiate` semantics
+  are now "always fresh". Users on the v0.1.x legacy pattern (`initiate +
+reconcileCompletedParts + no resumeFrom`) get an unconditional `console.warn`
+  pointing at `MIGRATION.md`. A second warning fires when `pipeline` is set
+  without `pipelineIdentity` — without an identity, pipeline-mismatch protection
+  on resume is disabled.
+
+  **Resume is now silent.** On the resume branch, the lib does **not** emit a
+  synthetic `UploadInitiated` event; the first event after setup is whatever
+  the parts stream emits next (`PartCompleted` or `ProgressTick`). The
+  `uploadId` Promise resolves synchronously with `resumeFrom.uploadId`. The
+  existing fresh-init flow is unchanged.
+
+  **Bundled fix:** `CircuitOpenError` is now exported from
+  `@tranquilload/core/errors`. It was defined internally but had never been
+  re-exported, so callers had no way to `instanceof`-check it.
+
+  **NOT in this release** (explicit non-feature note): auto-re-initiate on dead
+  `uploadId` was considered but deferred to a future version. If your stored
+  `uploadId` is no longer valid server-side, you'll currently see
+  `PartUploadError(1, 1, <404>)` on the first part upload — same as before.
+
+  See `MIGRATION.md` for the migration guide.
+
+- 6ca9186: Validate `chunkSize > 0` in `uploadMultipart` / `uploadMultipartEffect`.
+
+  Previously, passing `chunkSize: 0` (or `NaN`, `Infinity`, negative values) caused an infinite loop on the first byte of the source stream — the chunking loop `while (buffer.length >= chunkSize)` never terminated.
+
+  Now: `uploadMultipart` (and the `.effect` escape hatch) throws `TypeError` synchronously at construction time when `chunkSize` is not a positive finite number. Behaviour for all valid `chunkSize` values is unchanged.
+
+  This is a behaviour change for users who were passing invalid `chunkSize` — but those uploads never worked (they hung forever), so this is semver-patch.

package/dist/errors.cjs

@@ -1,9 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_upload_error = require("./upload-error-BUexBh08.cjs");
+const require_upload_error = require("./upload-error-BG1dOOl3.cjs");
 exports.AbortError = require_upload_error.AbortError;
+exports.CircuitOpenError = require_upload_error.CircuitOpenError;
 exports.CompleteUploadError = require_upload_error.CompleteUploadError;
 exports.InitiateUploadError = require_upload_error.InitiateUploadError;
 exports.MaxRetriesExceededError = require_upload_error.MaxRetriesExceededError;
 exports.PartUploadError = require_upload_error.PartUploadError;
 exports.PresignedUrlError = require_upload_error.PresignedUrlError;
 exports.ReconcileError = require_upload_error.ReconcileError;
+exports.ResumeMismatchError = require_upload_error.ResumeMismatchError;

package/dist/errors.d.cts

@@ -1,2 +1,2 @@
-import { a as PartUploadError, c as UploadError, i as MaxRetriesExceededError, n as CompleteUploadError, o as PresignedUrlError, r as InitiateUploadError, s as ReconcileError, t as AbortError } from "./upload-error-B2ISUc_k.cjs";
-export { AbortError, CompleteUploadError, InitiateUploadError, MaxRetriesExceededError, PartUploadError, PresignedUrlError, ReconcileError, type UploadError };
+import { a as MaxRetriesExceededError, c as ReconcileError, i as InitiateUploadError, l as ResumeMismatchError, n as CircuitOpenError, o as PartUploadError, r as CompleteUploadError, s as PresignedUrlError, t as AbortError, u as UploadError } from "./upload-error-DTYVNlaJ.cjs";
+export { AbortError, CircuitOpenError, CompleteUploadError, InitiateUploadError, MaxRetriesExceededError, PartUploadError, PresignedUrlError, ReconcileError, ResumeMismatchError, type UploadError };

package/dist/errors.d.mts

@@ -1,2 +1,2 @@
-import { a as PartUploadError, c as UploadError, i as MaxRetriesExceededError, n as CompleteUploadError, o as PresignedUrlError, r as InitiateUploadError, s as ReconcileError, t as AbortError } from "./upload-error-jol-eoDW.mjs";
-export { AbortError, CompleteUploadError, InitiateUploadError, MaxRetriesExceededError, PartUploadError, PresignedUrlError, ReconcileError, type UploadError };
+import { a as MaxRetriesExceededError, c as ReconcileError, i as InitiateUploadError, l as ResumeMismatchError, n as CircuitOpenError, o as PartUploadError, r as CompleteUploadError, s as PresignedUrlError, t as AbortError, u as UploadError } from "./upload-error-jBco270d.mjs";
+export { AbortError, CircuitOpenError, CompleteUploadError, InitiateUploadError, MaxRetriesExceededError, PartUploadError, PresignedUrlError, ReconcileError, ResumeMismatchError, type UploadError };

package/dist/errors.mjs

@@ -1,2 +1,2 @@
-import { a as MaxRetriesExceededError, c as ReconcileError, i as InitiateUploadError, o as PartUploadError, r as CompleteUploadError, s as PresignedUrlError, t as AbortError } from "./upload-error-zDvpxT9X.mjs";
-export { AbortError, CompleteUploadError, InitiateUploadError, MaxRetriesExceededError, PartUploadError, PresignedUrlError, ReconcileError };
+import { a as MaxRetriesExceededError, c as ReconcileError, i as InitiateUploadError, l as ResumeMismatchError, n as CircuitOpenError, o as PartUploadError, r as CompleteUploadError, s as PresignedUrlError, t as AbortError } from "./upload-error-Dbz_9j81.mjs";
+export { AbortError, CircuitOpenError, CompleteUploadError, InitiateUploadError, MaxRetriesExceededError, PartUploadError, PresignedUrlError, ReconcileError, ResumeMismatchError };

package/dist/index-BaeUV_fj.d.cts

@@ -0,0 +1,139 @@
+import { o as PartUploadError, u as UploadError } from "./upload-error-DTYVNlaJ.cjs";
+import { n as LoggerService } from "./logger-service-CbN12RhO.cjs";
+import { a as UploadEvent, i as UploadCompleted } from "./upload-event-BT_nXgM9.cjs";
+import { t as Transform } from "./middleware-CYcctmlY.cjs";
+import { Effect, Option, Schedule, Stream } from "effect";
+
+//#region src/multipart/circuit-breaker.d.ts
+interface CircuitBreakerConfig {
+  readonly threshold: number;
+  readonly cooldown: number;
+}
+//#endregion
+//#region src/multipart/upload-stream.d.ts
+interface CompletedPart {
+  readonly partNumber: number;
+  readonly etag: string;
+}
+/**
+ * Opaque resume metadata returned by `uploadMultipart` and persisted by the
+ * caller (typically `JSON.stringify` → localStorage). Pass it back as
+ * `resumeFrom` on the next session.
+ *
+ * The lib validates `version`, `chunkSize`, `pipelineIdentity`, and the content
+ * digest before any byte is uploaded. A mismatch fails the upload with a typed
+ * `ResumeMismatchError` — preventing the silent-corruption classes documented
+ * in the v0.2.x release notes.
+ *
+ * **Schema versioning.** The `version: 1` literal is a tripwire for schema
+ * evolution: future v2 schemas widen this union, and a persisted v1 state
+ * passed to a future v2 lib will fail with `ResumeMismatchError("version_mismatch")`
+ * rather than silently misinterpreting old fields.
+ */
+interface ResumeState {
+  readonly version: 1;
+  readonly uploadId: string;
+  readonly chunkSize: number;
+  readonly pipelineIdentity?: string;
+  readonly contentDigest?: string;
+  /**
+   * True if the original session captured a digest. Detects persistence layers
+   * that drop the `contentDigest` field (which would otherwise silently bypass
+   * content-mismatch validation).
+   */
+  readonly contentDigestCaptured: boolean;
+}
+interface UploadMultipartOptions {
+  readonly stream: ReadableStream<Uint8Array>;
+  readonly chunkSize: number;
+  readonly uploadPart: (partNumber: number, chunk: Uint8Array) => string | Promise<string> | Effect.Effect<string, UploadError>;
+  readonly completeUpload: (uploadId: string, parts: ReadonlyArray<CompletedPart>) => void | Promise<void> | Effect.Effect<void, UploadError>;
+  readonly initiate?: () => {
+    uploadId: string;
+  } | Promise<{
+    uploadId: string;
+  }> | Effect.Effect<{
+    uploadId: string;
+  }, UploadError>;
+  readonly reconcileCompletedParts?: () => ReadonlyArray<CompletedPart> | Promise<ReadonlyArray<CompletedPart>> | Effect.Effect<ReadonlyArray<CompletedPart>, UploadError>;
+  /**
+   * Resume metadata persisted from a previous session. When set, the lib skips
+   * the `initiate` callback (the `uploadId` is read from `resumeFrom`) and
+   * validates `version`, `chunkSize`, `pipelineIdentity`, and `contentDigest`
+   * before any byte is uploaded. A mismatch fails the upload with
+   * `ResumeMismatchError`.
+   *
+   * Synchronous (pre-flight) validation happens at `uploadMultipart()` call
+   * time — `TypeError` for an empty `uploadId`, `ResumeMismatchError` for the
+   * rest. The asynchronous content-digest *value* match is verified inside
+   * the Effect once the upload stream is consumed.
+   */
+  readonly resumeFrom?: ResumeState;
+  /**
+   * Called once on fresh initiate to capture a digest of the source content.
+   * On a subsequent resume session, called again and compared to
+   * `resumeFrom.contentDigest`; a mismatch fails the upload with
+   * `ResumeMismatchError("content_mismatch")` before any byte is uploaded.
+   *
+   * **MUST be lightweight and stable across sessions.** Suggested patterns:
+   * - Browser `File`: `` `${name}|${size}|${lastModified}` ``
+   * - Node `Readable` from a file: `` `${path}|${stat.size}|${stat.mtimeMs}` ``
+   * - Synchronous strings; avoid full-file crypto hashes on the synchronous path.
+   *
+   * **MUST NOT consume bytes from the source stream** (passed in
+   * `options.stream`). The lib calls `getContentDigest` before any chunk is
+   * pulled from the source; consuming from the source here will produce a
+   * zero-byte upload because no bytes remain for `chunkStream`.
+   */
+  readonly getContentDigest?: () => string | Promise<string> | Effect.Effect<string, UploadError>;
+  /**
+   * An opaque, stable identifier for the upstream pipeline composition.
+   * Captured in `ResumeState` and validated strict-equality on resume.
+   * **You own keeping this stable** — if you configure `compress("deflate-raw")`
+   * in session A, you must pass the same `pipelineIdentity` on resume.
+   *
+   * **Strict equality limitation:** a pipeline that is logically identical but
+   * produces different identifier strings (e.g. tag bumps, version-stamped
+   * strings) triggers `ResumeMismatchError("pipeline_mismatch")`. Pick a stable
+   * string (e.g. `"deflate-raw-v1"`) and only change it when the pipeline's
+   * *byte-level output* changes.
+   *
+   * **Compression non-determinism caveat:** even with identical
+   * `pipelineIdentity`, a non-deterministic pipeline (e.g. gzip with `mtime`
+   * headers, encryption with random salt) produces different bytes per run.
+   * Resume against the same uploaded parts only works if the pipeline is
+   * byte-deterministic. Verify your pipeline's determinism before relying on
+   * this.
+   */
+  readonly pipelineIdentity?: string;
+  readonly maxConcurrency?: number;
+  readonly signal?: AbortSignal;
+  readonly retrySchedule?: Schedule.Schedule<unknown, PartUploadError>;
+  readonly circuitBreaker?: CircuitBreakerConfig;
+}
+//#endregion
+//#region src/multipart/index.d.ts
+type UploadResult = UploadCompleted;
+interface Progress {
+  readonly bytesUploaded: number;
+  readonly totalBytes: Option.Option<number>;
+}
+interface MultipartPublicOptions extends UploadMultipartOptions {
+  readonly totalBytes?: number;
+  readonly pipeline?: Transform | Effect.Effect<Transform, unknown, unknown>;
+}
+declare const uploadMultipart: {
+  (options: MultipartPublicOptions): {
+    events: ReadableStream<UploadEvent>;
+    result: Promise<UploadResult>;
+    getProgress: (() => Promise<Progress>) & {
+      effect: Effect.Effect<Progress>;
+    };
+    uploadId: Promise<string>;
+    resumeState: Promise<ResumeState>;
+  };
+  effect: (options: UploadMultipartOptions) => Stream.Stream<UploadEvent, UploadError, LoggerService>;
+};
+//#endregion
+export { CompletedPart as a, uploadMultipart as i, Progress as n, ResumeState as o, UploadResult as r, UploadMultipartOptions as s, MultipartPublicOptions as t };
+//# sourceMappingURL=index-BaeUV_fj.d.cts.map

package/dist/index-BaeUV_fj.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BaeUV_fj.d.cts","names":[],"sources":["../src/multipart/circuit-breaker.ts","../src/multipart/upload-stream.ts","../src/multipart/index.ts"],"mappings":";;;;;;;UAIiB,oBAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;AAAA;;;UCIM,aAAA;EAAA,SACN,UAAA;EAAA,SACA,IAAA;AAAA;;;;;;AAFX;;;;;AAoBA;;;;;UAAiB,WAAA;EAAA,SACN,OAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA;EAAA,SACA,gBAAA;EAAA,SACA,aAAA;EAMqB;AAGhC;;;;EAHgC,SAArB,qBAAA;AAAA;AAAA,UAGM,sBAAA;EAAA,SACN,MAAA,EAAQ,cAAA,CAAe,UAAA;EAAA,SACvB,SAAA;EAAA,SACA,UAAA,GACP,UAAA,UACA,KAAA,EAAO,UAAA,cACK,OAAA,WAAkB,MAAA,CAAO,MAAA,SAAe,WAAA;EAAA,SAC7C,cAAA,GACP,QAAA,UACA,KAAA,EAAO,aAAA,CAAc,aAAA,aACX,OAAA,SAAgB,MAAA,CAAO,MAAA,OAAa,WAAA;EAAA,SACvC,QAAA;IACH,QAAA;EAAA,IACF,OAAA;IAAU,QAAA;EAAA,KACV,MAAA,CAAO,MAAA;IAAS,QAAA;EAAA,GAAoB,WAAA;EAAA,SAC/B,uBAAA,SACL,aAAA,CAAc,aAAA,IACd,OAAA,CAAQ,aAAA,CAAc,aAAA,KACtB,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,aAAA,GAAgB,WAAA;EADtB;;;;;;;;;;;;EAAA,SAcjB,UAAA,GAAa,WAAA;EA2CG;;;;;;;;;;;;;;;;EAAA,SA1BhB,gBAAA,kBAEL,OAAA,WACA,MAAA,CAAO,MAAA,SAAe,WAAA;EA3CxB;;;;;;;;;;;;;;;;;;;EAAA,SA+DO,gBAAA;EAAA,SACA,cAAA;EAAA,SACA,MAAA,GAAS,WAAA;EAAA,SACT,aAAA,GAAgB,QAAA,CAAS,QAAA,UAAkB,eAAA;EAAA,SAC3C,cAAA,GAAiB,oBAAA;AAAA;;;KChHhB,YAAA,GAAe,eAAA;AAAA,UAGV,QAAA;EAAA,SACN,aAAA;EAAA,SACA,UAAA,EAAY,MAAA,CAAO,MAAA;AAAA;AAAA,UAGb,sBAAA,SAA+B,sBAAA;EAAA,SACrC,UAAA;EAAA,SACA,QAAA,GAAW,SAAA,GAAY,MAAA,CAAO,MAAA,CAAO,SAAA;AAAA;AAAA,cAMnC,eAAA;EAAA,UACF,sBAAA;IAET,MAAA,EAAQ,cAAA,CAAe,WAAA;IACvB,MAAA,EAAQ,OAAA,CAAQ,YAAA;IAChB,WAAA,SAAoB,OAAA,CAAQ,QAAA;MAAe,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,QAAA;IAAA;IACjE,QAAA,EAAU,OAAA;IACV,WAAA,EAAa,OAAA,CAAQ,WAAA;EAAA"}

package/dist/index-bpWq6tje.d.mts

@@ -0,0 +1,139 @@
+import { o as PartUploadError, u as UploadError } from "./upload-error-jBco270d.mjs";
+import { n as LoggerService } from "./logger-service-BF2pZOHN.mjs";
+import { a as UploadEvent, i as UploadCompleted } from "./upload-event-DOGbegxa.mjs";
+import { t as Transform } from "./middleware-CAI0cnW2.mjs";
+import { Effect, Option, Schedule, Stream } from "effect";
+
+//#region src/multipart/circuit-breaker.d.ts
+interface CircuitBreakerConfig {
+  readonly threshold: number;
+  readonly cooldown: number;
+}
+//#endregion
+//#region src/multipart/upload-stream.d.ts
+interface CompletedPart {
+  readonly partNumber: number;
+  readonly etag: string;
+}
+/**
+ * Opaque resume metadata returned by `uploadMultipart` and persisted by the
+ * caller (typically `JSON.stringify` → localStorage). Pass it back as
+ * `resumeFrom` on the next session.
+ *
+ * The lib validates `version`, `chunkSize`, `pipelineIdentity`, and the content
+ * digest before any byte is uploaded. A mismatch fails the upload with a typed
+ * `ResumeMismatchError` — preventing the silent-corruption classes documented
+ * in the v0.2.x release notes.
+ *
+ * **Schema versioning.** The `version: 1` literal is a tripwire for schema
+ * evolution: future v2 schemas widen this union, and a persisted v1 state
+ * passed to a future v2 lib will fail with `ResumeMismatchError("version_mismatch")`
+ * rather than silently misinterpreting old fields.
+ */
+interface ResumeState {
+  readonly version: 1;
+  readonly uploadId: string;
+  readonly chunkSize: number;
+  readonly pipelineIdentity?: string;
+  readonly contentDigest?: string;
+  /**
+   * True if the original session captured a digest. Detects persistence layers
+   * that drop the `contentDigest` field (which would otherwise silently bypass
+   * content-mismatch validation).
+   */
+  readonly contentDigestCaptured: boolean;
+}
+interface UploadMultipartOptions {
+  readonly stream: ReadableStream<Uint8Array>;
+  readonly chunkSize: number;
+  readonly uploadPart: (partNumber: number, chunk: Uint8Array) => string | Promise<string> | Effect.Effect<string, UploadError>;
+  readonly completeUpload: (uploadId: string, parts: ReadonlyArray<CompletedPart>) => void | Promise<void> | Effect.Effect<void, UploadError>;
+  readonly initiate?: () => {
+    uploadId: string;
+  } | Promise<{
+    uploadId: string;
+  }> | Effect.Effect<{
+    uploadId: string;
+  }, UploadError>;
+  readonly reconcileCompletedParts?: () => ReadonlyArray<CompletedPart> | Promise<ReadonlyArray<CompletedPart>> | Effect.Effect<ReadonlyArray<CompletedPart>, UploadError>;
+  /**
+   * Resume metadata persisted from a previous session. When set, the lib skips
+   * the `initiate` callback (the `uploadId` is read from `resumeFrom`) and
+   * validates `version`, `chunkSize`, `pipelineIdentity`, and `contentDigest`
+   * before any byte is uploaded. A mismatch fails the upload with
+   * `ResumeMismatchError`.
+   *
+   * Synchronous (pre-flight) validation happens at `uploadMultipart()` call
+   * time — `TypeError` for an empty `uploadId`, `ResumeMismatchError` for the
+   * rest. The asynchronous content-digest *value* match is verified inside
+   * the Effect once the upload stream is consumed.
+   */
+  readonly resumeFrom?: ResumeState;
+  /**
+   * Called once on fresh initiate to capture a digest of the source content.
+   * On a subsequent resume session, called again and compared to
+   * `resumeFrom.contentDigest`; a mismatch fails the upload with
+   * `ResumeMismatchError("content_mismatch")` before any byte is uploaded.
+   *
+   * **MUST be lightweight and stable across sessions.** Suggested patterns:
+   * - Browser `File`: `` `${name}|${size}|${lastModified}` ``
+   * - Node `Readable` from a file: `` `${path}|${stat.size}|${stat.mtimeMs}` ``
+   * - Synchronous strings; avoid full-file crypto hashes on the synchronous path.
+   *
+   * **MUST NOT consume bytes from the source stream** (passed in
+   * `options.stream`). The lib calls `getContentDigest` before any chunk is
+   * pulled from the source; consuming from the source here will produce a
+   * zero-byte upload because no bytes remain for `chunkStream`.
+   */
+  readonly getContentDigest?: () => string | Promise<string> | Effect.Effect<string, UploadError>;
+  /**
+   * An opaque, stable identifier for the upstream pipeline composition.
+   * Captured in `ResumeState` and validated strict-equality on resume.
+   * **You own keeping this stable** — if you configure `compress("deflate-raw")`
+   * in session A, you must pass the same `pipelineIdentity` on resume.
+   *
+   * **Strict equality limitation:** a pipeline that is logically identical but
+   * produces different identifier strings (e.g. tag bumps, version-stamped
+   * strings) triggers `ResumeMismatchError("pipeline_mismatch")`. Pick a stable
+   * string (e.g. `"deflate-raw-v1"`) and only change it when the pipeline's
+   * *byte-level output* changes.
+   *
+   * **Compression non-determinism caveat:** even with identical
+   * `pipelineIdentity`, a non-deterministic pipeline (e.g. gzip with `mtime`
+   * headers, encryption with random salt) produces different bytes per run.
+   * Resume against the same uploaded parts only works if the pipeline is
+   * byte-deterministic. Verify your pipeline's determinism before relying on
+   * this.
+   */
+  readonly pipelineIdentity?: string;
+  readonly maxConcurrency?: number;
+  readonly signal?: AbortSignal;
+  readonly retrySchedule?: Schedule.Schedule<unknown, PartUploadError>;
+  readonly circuitBreaker?: CircuitBreakerConfig;
+}
+//#endregion
+//#region src/multipart/index.d.ts
+type UploadResult = UploadCompleted;
+interface Progress {
+  readonly bytesUploaded: number;
+  readonly totalBytes: Option.Option<number>;
+}
+interface MultipartPublicOptions extends UploadMultipartOptions {
+  readonly totalBytes?: number;
+  readonly pipeline?: Transform | Effect.Effect<Transform, unknown, unknown>;
+}
+declare const uploadMultipart: {
+  (options: MultipartPublicOptions): {
+    events: ReadableStream<UploadEvent>;
+    result: Promise<UploadResult>;
+    getProgress: (() => Promise<Progress>) & {
+      effect: Effect.Effect<Progress>;
+    };
+    uploadId: Promise<string>;
+    resumeState: Promise<ResumeState>;
+  };
+  effect: (options: UploadMultipartOptions) => Stream.Stream<UploadEvent, UploadError, LoggerService>;
+};
+//#endregion
+export { CompletedPart as a, uploadMultipart as i, Progress as n, ResumeState as o, UploadResult as r, UploadMultipartOptions as s, MultipartPublicOptions as t };
+//# sourceMappingURL=index-bpWq6tje.d.mts.map

package/dist/index-bpWq6tje.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-bpWq6tje.d.mts","names":[],"sources":["../src/multipart/circuit-breaker.ts","../src/multipart/upload-stream.ts","../src/multipart/index.ts"],"mappings":";;;;;;;UAIiB,oBAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;AAAA;;;UCIM,aAAA;EAAA,SACN,UAAA;EAAA,SACA,IAAA;AAAA;;;;;;AAFX;;;;;AAoBA;;;;;UAAiB,WAAA;EAAA,SACN,OAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA;EAAA,SACA,gBAAA;EAAA,SACA,aAAA;EAMqB;AAGhC;;;;EAHgC,SAArB,qBAAA;AAAA;AAAA,UAGM,sBAAA;EAAA,SACN,MAAA,EAAQ,cAAA,CAAe,UAAA;EAAA,SACvB,SAAA;EAAA,SACA,UAAA,GACP,UAAA,UACA,KAAA,EAAO,UAAA,cACK,OAAA,WAAkB,MAAA,CAAO,MAAA,SAAe,WAAA;EAAA,SAC7C,cAAA,GACP,QAAA,UACA,KAAA,EAAO,aAAA,CAAc,aAAA,aACX,OAAA,SAAgB,MAAA,CAAO,MAAA,OAAa,WAAA;EAAA,SACvC,QAAA;IACH,QAAA;EAAA,IACF,OAAA;IAAU,QAAA;EAAA,KACV,MAAA,CAAO,MAAA;IAAS,QAAA;EAAA,GAAoB,WAAA;EAAA,SAC/B,uBAAA,SACL,aAAA,CAAc,aAAA,IACd,OAAA,CAAQ,aAAA,CAAc,aAAA,KACtB,MAAA,CAAO,MAAA,CAAO,aAAA,CAAc,aAAA,GAAgB,WAAA;EADtB;;;;;;;;;;;;EAAA,SAcjB,UAAA,GAAa,WAAA;EA2CG;;;;;;;;;;;;;;;;EAAA,SA1BhB,gBAAA,kBAEL,OAAA,WACA,MAAA,CAAO,MAAA,SAAe,WAAA;EA3CxB;;;;;;;;;;;;;;;;;;;EAAA,SA+DO,gBAAA;EAAA,SACA,cAAA;EAAA,SACA,MAAA,GAAS,WAAA;EAAA,SACT,aAAA,GAAgB,QAAA,CAAS,QAAA,UAAkB,eAAA;EAAA,SAC3C,cAAA,GAAiB,oBAAA;AAAA;;;KChHhB,YAAA,GAAe,eAAA;AAAA,UAGV,QAAA;EAAA,SACN,aAAA;EAAA,SACA,UAAA,EAAY,MAAA,CAAO,MAAA;AAAA;AAAA,UAGb,sBAAA,SAA+B,sBAAA;EAAA,SACrC,UAAA;EAAA,SACA,QAAA,GAAW,SAAA,GAAY,MAAA,CAAO,MAAA,CAAO,SAAA;AAAA;AAAA,cAMnC,eAAA;EAAA,UACF,sBAAA;IAET,MAAA,EAAQ,cAAA,CAAe,WAAA;IACvB,MAAA,EAAQ,OAAA,CAAQ,YAAA;IAChB,WAAA,SAAoB,OAAA,CAAQ,QAAA;MAAe,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,QAAA;IAAA;IACjE,QAAA,EAAU,OAAA;IACV,WAAA,EAAa,OAAA,CAAQ,WAAA;EAAA"}