@interfere/build 0.2.2 → 0.3.1

package/README.md

@@ -6,3 +6,20 @@ Use `@interfere/javascript` to call release endpoints directly. This package
 provides build configuration resolution, release metadata, ordered source-map
 chunk uploads, and local artifact cleanup. Framework integrations own the sequence
 of API calls and only delete source maps after the server accepts the full batch.
+
+Source-map uploads use 20 concurrent workers by default. Set
+`INTERFERE_SOURCEMAP_UPLOAD_CONCURRENCY` to a positive integer to change the limit;
+the `uploadSourceMapChunks` `concurrency` option takes precedence. Next.js and Vite
+share this setting. Pass the variable through your build runner when it filters
+environment variables, such as Turborepo's strict environment mode.
+
+Next.js and Vite use gzip only when the signed upload session advertises support,
+with identity uploads for payloads that do not shrink. Older servers receive
+uncompressed chunks of at most 512 KiB. Servers advertising gzip accept chunks
+of up to 8 MiB. Chunk offsets and reported byte counts refer to the original,
+uncompressed content.
+
+When calling `uploadSourceMapChunks` directly, construct the API client with
+`fetch: sourceMapUploadFetch` from `@interfere/build/source-map-upload-fetch` and
+pass `compression: "gzip"` to the uploader. Direct callers retain identity uploads
+unless they opt in; Next.js and Vite configure both automatically.

package/dist/release-request.d.cts

@@ -36,6 +36,8 @@ export declare function resolveReleaseRequest(input: {
       environmentName: string | null;
       environmentTarget: string | null;
       provider: "cloudflare";
+      deploymentId?: string | null | undefined;
+      trafficPercentage?: number | null | undefined;
       scriptName: string | null;
       versionId: string | null;
     } | {

package/dist/release-request.d.mts

@@ -36,6 +36,8 @@ export declare function resolveReleaseRequest(input: {
       environmentName: string | null;
       environmentTarget: string | null;
       provider: "cloudflare";
+      deploymentId?: string | null | undefined;
+      trafficPercentage?: number | null | undefined;
       scriptName: string | null;
       versionId: string | null;
     } | {

package/dist/source-map-upload-fetch.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let node_util=require("node:util"),node_zlib=require("node:zlib");const compress=(0,node_util.promisify)(node_zlib.gzip),sourceMapUploadFetch=Object.assign(async(input,init)=>{let request=new Request(input,init);if(request.method===`POST`&&new URL(request.url).pathname.endsWith(`/source-maps/sign`)&&request.headers.set(`x-interfere-source-map-compression`,`gzip`),request.headers.get(`content-encoding`)!==`gzip`)return fetch(request);let bytes=await request.arrayBuffer(),body=await compress(bytes),headers=new Headers(request.headers);return headers.delete(`content-length`),body.byteLength>=bytes.byteLength?(headers.delete(`content-encoding`),fetch(new Request(request,{body:bytes,headers,method:request.method}))):fetch(new Request(request,{body,headers,method:request.method}))},fetch);exports.sourceMapUploadFetch=sourceMapUploadFetch;

package/dist/source-map-upload-fetch.d.cts

@@ -0,0 +1,4 @@
+//#region src/source-map-upload-fetch.d.ts
+/** Compresses requests marked with Content-Encoding: gzip by the source-map uploader. */
+export declare const sourceMapUploadFetch: typeof fetch;
+//#endregion

package/dist/source-map-upload-fetch.d.mts

@@ -0,0 +1,4 @@
+//#region src/source-map-upload-fetch.d.ts
+/** Compresses requests marked with Content-Encoding: gzip by the source-map uploader. */
+export declare const sourceMapUploadFetch: typeof fetch;
+//#endregion

package/dist/source-map-upload-fetch.mjs

@@ -0,0 +1 @@
+import{promisify}from"node:util";import{gzip}from"node:zlib";const compress=promisify(gzip),sourceMapUploadFetch=Object.assign(async(input,init)=>{let request=new Request(input,init);if(request.method===`POST`&&new URL(request.url).pathname.endsWith(`/source-maps/sign`)&&request.headers.set(`x-interfere-source-map-compression`,`gzip`),request.headers.get(`content-encoding`)!==`gzip`)return fetch(request);let bytes=await request.arrayBuffer(),body=await compress(bytes),headers=new Headers(request.headers);return headers.delete(`content-length`),body.byteLength>=bytes.byteLength?(headers.delete(`content-encoding`),fetch(new Request(request,{body:bytes,headers,method:request.method}))):fetch(new Request(request,{body,headers,method:request.method}))},fetch);export{sourceMapUploadFetch};

package/dist/upload-source-map-chunks.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_upload_source_map_batch=require("./upload-source-map-batch.cjs"),require_upload_source_map_request=require("./upload-source-map-request.cjs"),CHUNK_BYTES=524288;async function uploadSourceMapChunks(options){let{client,environment,files,releaseSlug,signed}=options,controller=new AbortController;try{let sessionDeadlineMs=signed.expiresAt*1e3,assertSessionOpen=()=>{if(!Number.isFinite(sessionDeadlineMs)||Date.now()>=sessionDeadlineMs)throw Error(`Source-map upload session expired`)};assertSessionOpen();let abortSignal=AbortSignal.any([controller.signal,AbortSignal.timeout(sessionDeadlineMs-Date.now())]),expected=new Set(files.map(file=>file.path));if(signed.uploads.length!==files.length||new Set(signed.uploads.map(file=>file.path)).size!==files.length||signed.uploads.some(file=>!expected.has(file.path)))throw Error(`Source-map server returned a different batch`);let jobs=require_upload_source_map_batch.sourceMapUploadJobs(files,signed.batchUpload),totalBytes=0;return await Promise.all(Array.from({length:Math.min(4,files.length)},async()=>{for(let job of jobs){if(abortSignal.throwIfAborted(),assertSessionOpen(),job.chunks){await require_upload_source_map_request.uploadSourceMapRequest(async()=>await client.releases.uploadSourceMapBatch({releaseSlug,environment,chunks:job.chunks},{abortSignal}),abortSignal),totalBytes+=job.rawBytes;continue}let{file}=job,bytes=new TextEncoder().encode(file.content);for(let offset=0;offset<bytes.byteLength;offset+=CHUNK_BYTES)assertSessionOpen(),await require_upload_source_map_request.uploadSourceMapRequest(async()=>await client.releases.uploadSourceMap(new Blob([bytes.slice(offset,offset+CHUNK_BYTES)]),releaseSlug,{environment,path:file.path,offset},{abortSignal}),abortSignal);totalBytes+=bytes.byteLength}})),assertSessionOpen(),totalBytes}finally{controller.abort()}}exports.uploadSourceMapChunks=uploadSourceMapChunks;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_upload_source_map_batch=require("./upload-source-map-batch.cjs"),require_upload_source_map_request=require("./upload-source-map-request.cjs");let _interfere_types_data_source_map_upload_batch=require("@interfere/types/data/source-map-upload-batch");async function uploadSourceMapChunks(options){let{client,environment,files,releaseSlug,signed}=options,concurrency=options.concurrency??Number(process.env.INTERFERE_SOURCEMAP_UPLOAD_CONCURRENCY??20);if(!Number.isSafeInteger(concurrency)||concurrency<1)throw Error(`Source-map upload concurrency must be a positive integer`);let capability=_interfere_types_data_source_map_upload_batch.sourceMapBatchCapability.safeParse(signed.batchUpload),supportsGzip=capability.success&&capability.data.compression===`gzip`,chunkBytes=supportsGzip?8388608:524288,headers=options.compression===`gzip`&&supportsGzip?{"content-encoding":`gzip`}:void 0,controller=new AbortController;try{let sessionDeadlineMs=signed.expiresAt*1e3,assertSessionOpen=()=>{if(!Number.isFinite(sessionDeadlineMs)||Date.now()>=sessionDeadlineMs)throw Error(`Source-map upload session expired`)};assertSessionOpen();let abortSignal=AbortSignal.any([controller.signal,AbortSignal.timeout(sessionDeadlineMs-Date.now())]),expected=new Set(files.map(file=>file.path));if(signed.uploads.length!==files.length||new Set(signed.uploads.map(file=>file.path)).size!==files.length||signed.uploads.some(file=>!expected.has(file.path)))throw Error(`Source-map server returned a different batch`);let jobs=require_upload_source_map_batch.sourceMapUploadJobs(files,signed.batchUpload),totalBytes=0;return await Promise.all(Array.from({length:Math.min(concurrency,files.length)},async()=>{for(let job of jobs){if(abortSignal.throwIfAborted(),assertSessionOpen(),job.chunks){await require_upload_source_map_request.uploadSourceMapRequest(async()=>await client.releases.uploadSourceMapBatch({releaseSlug,environment,chunks:job.chunks},{abortSignal,headers}),abortSignal),totalBytes+=job.rawBytes;continue}let{file}=job,bytes=new TextEncoder().encode(file.content);for(let offset=0;offset<bytes.byteLength;offset+=chunkBytes){assertSessionOpen();let chunk=new Blob([bytes.subarray(offset,offset+chunkBytes)]);await require_upload_source_map_request.uploadSourceMapRequest(async()=>await client.releases.uploadSourceMap(chunk,releaseSlug,{environment,path:file.path,offset},{abortSignal,headers:{...headers,"x-interfere-source-map-size":String(chunk.size)}}),abortSignal)}totalBytes+=bytes.byteLength}})),assertSessionOpen(),totalBytes}finally{controller.abort()}}exports.uploadSourceMapChunks=uploadSourceMapChunks;

package/dist/upload-source-map-chunks.d.cts

@@ -5,6 +5,9 @@ export declare function uploadSourceMapChunks(options: {
   releaseSlug: string;
   environment?: string | undefined;
   signed: Interfere.SourceMapUploadSessionResponse;
+  concurrency?: number;
+  /** Requires sourceMapUploadFetch on the client; defaults to identity. */
+  compression?: "gzip";
   files: readonly (Interfere.CompleteSourceMapFile & {
     content: string;
   })[];

package/dist/upload-source-map-chunks.d.mts

@@ -5,6 +5,9 @@ export declare function uploadSourceMapChunks(options: {
   releaseSlug: string;
   environment?: string | undefined;
   signed: Interfere.SourceMapUploadSessionResponse;
+  concurrency?: number;
+  /** Requires sourceMapUploadFetch on the client; defaults to identity. */
+  compression?: "gzip";
   files: readonly (Interfere.CompleteSourceMapFile & {
     content: string;
   })[];

package/dist/upload-source-map-chunks.mjs

@@ -1 +1 @@
-import{sourceMapUploadJobs}from"./upload-source-map-batch.mjs";import{uploadSourceMapRequest}from"./upload-source-map-request.mjs";const CHUNK_BYTES=524288;async function uploadSourceMapChunks(options){let{client,environment,files,releaseSlug,signed}=options,controller=new AbortController;try{let sessionDeadlineMs=signed.expiresAt*1e3,assertSessionOpen=()=>{if(!Number.isFinite(sessionDeadlineMs)||Date.now()>=sessionDeadlineMs)throw Error(`Source-map upload session expired`)};assertSessionOpen();let abortSignal=AbortSignal.any([controller.signal,AbortSignal.timeout(sessionDeadlineMs-Date.now())]),expected=new Set(files.map(file=>file.path));if(signed.uploads.length!==files.length||new Set(signed.uploads.map(file=>file.path)).size!==files.length||signed.uploads.some(file=>!expected.has(file.path)))throw Error(`Source-map server returned a different batch`);let jobs=sourceMapUploadJobs(files,signed.batchUpload),totalBytes=0;return await Promise.all(Array.from({length:Math.min(4,files.length)},async()=>{for(let job of jobs){if(abortSignal.throwIfAborted(),assertSessionOpen(),job.chunks){await uploadSourceMapRequest(async()=>await client.releases.uploadSourceMapBatch({releaseSlug,environment,chunks:job.chunks},{abortSignal}),abortSignal),totalBytes+=job.rawBytes;continue}let{file}=job,bytes=new TextEncoder().encode(file.content);for(let offset=0;offset<bytes.byteLength;offset+=CHUNK_BYTES)assertSessionOpen(),await uploadSourceMapRequest(async()=>await client.releases.uploadSourceMap(new Blob([bytes.slice(offset,offset+CHUNK_BYTES)]),releaseSlug,{environment,path:file.path,offset},{abortSignal}),abortSignal);totalBytes+=bytes.byteLength}})),assertSessionOpen(),totalBytes}finally{controller.abort()}}export{uploadSourceMapChunks};
+import{sourceMapUploadJobs}from"./upload-source-map-batch.mjs";import{uploadSourceMapRequest}from"./upload-source-map-request.mjs";import{sourceMapBatchCapability}from"@interfere/types/data/source-map-upload-batch";async function uploadSourceMapChunks(options){let{client,environment,files,releaseSlug,signed}=options,concurrency=options.concurrency??Number(process.env.INTERFERE_SOURCEMAP_UPLOAD_CONCURRENCY??20);if(!Number.isSafeInteger(concurrency)||concurrency<1)throw Error(`Source-map upload concurrency must be a positive integer`);let capability=sourceMapBatchCapability.safeParse(signed.batchUpload),supportsGzip=capability.success&&capability.data.compression===`gzip`,chunkBytes=supportsGzip?8388608:524288,headers=options.compression===`gzip`&&supportsGzip?{"content-encoding":`gzip`}:void 0,controller=new AbortController;try{let sessionDeadlineMs=signed.expiresAt*1e3,assertSessionOpen=()=>{if(!Number.isFinite(sessionDeadlineMs)||Date.now()>=sessionDeadlineMs)throw Error(`Source-map upload session expired`)};assertSessionOpen();let abortSignal=AbortSignal.any([controller.signal,AbortSignal.timeout(sessionDeadlineMs-Date.now())]),expected=new Set(files.map(file=>file.path));if(signed.uploads.length!==files.length||new Set(signed.uploads.map(file=>file.path)).size!==files.length||signed.uploads.some(file=>!expected.has(file.path)))throw Error(`Source-map server returned a different batch`);let jobs=sourceMapUploadJobs(files,signed.batchUpload),totalBytes=0;return await Promise.all(Array.from({length:Math.min(concurrency,files.length)},async()=>{for(let job of jobs){if(abortSignal.throwIfAborted(),assertSessionOpen(),job.chunks){await uploadSourceMapRequest(async()=>await client.releases.uploadSourceMapBatch({releaseSlug,environment,chunks:job.chunks},{abortSignal,headers}),abortSignal),totalBytes+=job.rawBytes;continue}let{file}=job,bytes=new TextEncoder().encode(file.content);for(let offset=0;offset<bytes.byteLength;offset+=chunkBytes){assertSessionOpen();let chunk=new Blob([bytes.subarray(offset,offset+chunkBytes)]);await uploadSourceMapRequest(async()=>await client.releases.uploadSourceMap(chunk,releaseSlug,{environment,path:file.path,offset},{abortSignal,headers:{...headers,"x-interfere-source-map-size":String(chunk.size)}}),abortSignal)}totalBytes+=bytes.byteLength}})),assertSessionOpen(),totalBytes}finally{controller.abort()}}export{uploadSourceMapChunks};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/build",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Release preparation for Interfere build integrations.",
   "keywords": [
     "build",
@@ -71,6 +71,17 @@
         "types": "./dist/upload-source-map-chunks.d.cts",
         "default": "./dist/upload-source-map-chunks.cjs"
       }
+    },
+    "./source-map-upload-fetch": {
+      "monorepo": "./src/source-map-upload-fetch.ts",
+      "import": {
+        "types": "./dist/source-map-upload-fetch.d.mts",
+        "default": "./dist/source-map-upload-fetch.mjs"
+      },
+      "require": {
+        "types": "./dist/source-map-upload-fetch.d.cts",
+        "default": "./dist/source-map-upload-fetch.cjs"
+      }
     }
   },
   "publishConfig": {
@@ -83,16 +94,16 @@
   },
   "dependencies": {
     "@interfere/javascript": "^0.2.1",
-    "@interfere/types": "^10.2.1"
+    "@interfere/types": "^10.3.0"
   },
   "devDependencies": {
     "@interfere/typescript-config": "^9.0.2",
     "@interfere/vitest-config": "0.0.0",
     "@types/node": "^26.4.1",
-    "@vitest/coverage-v8": "5.0.1",
+    "@vitest/coverage-v8": "5.0.5",
     "msw": "^2.14.6",
     "tsdown": "^0.23.0",
     "typescript": "^7.0.2",
-    "vitest": "5.0.1"
+    "vitest": "5.0.5"
   }
 }