@atcute/util-fetch 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @atcute/util-fetch
+
+random fetch utilities.

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+export declare class FetchResponseError extends Error {
+    name: string;
+}
+export declare class FailedResponseError extends FetchResponseError {
+    status: number;
+    name: string;
+    constructor(status: number, reason: string);
+}
+export declare class ImproperContentTypeError extends FetchResponseError {
+    contentType: string | null;
+    name: string;
+    constructor(contentType: string | null, reason: string);
+}
+export declare class ImproperContentLengthError extends FetchResponseError {
+    expectedSize: number;
+    actualSize: number | null;
+    name: string;
+    constructor(expectedSize: number, actualSize: number | null, reason: string);
+}
+export declare class ImproperResponseError extends FetchResponseError {
+    name: string;
+    constructor(reason: string, options?: ErrorOptions);
+}

package/dist/errors.js

@@ -0,0 +1,36 @@
+export class FetchResponseError extends Error {
+    name = 'FetchResponseError';
+}
+export class FailedResponseError extends FetchResponseError {
+    status;
+    name = 'FailedResponseError';
+    constructor(status, reason) {
+        super(reason);
+        this.status = status;
+    }
+}
+export class ImproperContentTypeError extends FetchResponseError {
+    contentType;
+    name = 'ImproperContentTypeError';
+    constructor(contentType, reason) {
+        super(reason);
+        this.contentType = contentType;
+    }
+}
+export class ImproperContentLengthError extends FetchResponseError {
+    expectedSize;
+    actualSize;
+    name = 'ImproperContentLengthError';
+    constructor(expectedSize, actualSize, reason) {
+        super(reason);
+        this.expectedSize = expectedSize;
+        this.actualSize = actualSize;
+    }
+}
+export class ImproperResponseError extends FetchResponseError {
+    name = 'ImproperResponseError';
+    constructor(reason, options) {
+        super(reason, options);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACnC,IAAI,GAAG,oBAAoB,CAAC;CACrC;AAED,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAIlD;IAHC,IAAI,GAAG,qBAAqB,CAAC;IAEtC,YACQ,MAAc,EACrB,MAAc;QAEd,KAAK,CAAC,MAAM,CAAC,CAAC;QAHP,WAAM,GAAN,MAAM,CAAQ;IAItB,CAAC;CACD;AAED,MAAM,OAAO,wBAAyB,SAAQ,kBAAkB;IAIvD;IAHC,IAAI,GAAG,0BAA0B,CAAC;IAE3C,YACQ,WAA0B,EACjC,MAAc;QAEd,KAAK,CAAC,MAAM,CAAC,CAAC;QAHP,gBAAW,GAAX,WAAW,CAAe;IAIlC,CAAC;CACD;AAED,MAAM,OAAO,0BAA2B,SAAQ,kBAAkB;IAIzD;IACA;IAJC,IAAI,GAAG,4BAA4B,CAAC;IAE7C,YACQ,YAAoB,EACpB,UAAyB,EAChC,MAAc;QAEd,KAAK,CAAC,MAAM,CAAC,CAAC;QAJP,iBAAY,GAAZ,YAAY,CAAQ;QACpB,eAAU,GAAV,UAAU,CAAe;IAIjC,CAAC;CACD;AAED,MAAM,OAAO,qBAAsB,SAAQ,kBAAkB;IACnD,IAAI,GAAG,uBAAuB,CAAC;IAExC,YAAY,MAAc,EAAE,OAAsB;QACjD,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxB,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './errors.js';
+export * from './pipeline.js';
+export * from './transformers.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './errors.js';
+export * from './pipeline.js';
+export * from './transformers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,7 @@
+type Transformer<I, O = I> = (input: I) => Promise<O>;
+type PipelineInput<T extends readonly Transformer<any>[]> = T extends [Transformer<infer I, any>, ...any[]] ? I : T extends Transformer<infer I, any>[] ? I : never;
+type PipelineOutput<T extends readonly Transformer<any>[]> = T extends [...any[], Transformer<any, infer O>] ? O : T extends Transformer<any, infer O>[] ? O : never;
+type Pipeline<F extends readonly Transformer<any>[], Acc extends readonly Transformer<any>[] = []> = F extends [Transformer<infer I, infer O>] ? [...Acc, Transformer<I, O>] : F extends [Transformer<infer A, any>, ...infer Tail] ? Tail extends [Transformer<infer B, any>, ...any[]] ? Pipeline<Tail, [...Acc, Transformer<A, B>]> : Acc : Acc;
+export declare function pipe(): never;
+export declare function pipe<T extends readonly Transformer<any>[]>(...pipeline: Pipeline<T> extends T ? T : Pipeline<T>): (input: PipelineInput<T>) => Promise<PipelineOutput<T>>;
+export {};

package/dist/pipeline.js

@@ -0,0 +1,7 @@
+export function pipe(...pipeline) {
+    return pipeline.reduce(pipeTwo);
+}
+const pipeTwo = (first, second) => {
+    return (input) => first(input).then(second);
+};
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../lib/pipeline.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,IAAI,CACnB,GAAG,QAAiD;IAEpD,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,OAAO,GAAG,CACf,KAAwB,EACxB,MAAyB,EACI,EAAE;IAC/B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/streams/size-limit.d.ts

@@ -0,0 +1,3 @@
+export declare class SizeLimitStream extends TransformStream<Uint8Array, Uint8Array> {
+    constructor(maxSize: number);
+}

package/dist/streams/size-limit.js

@@ -0,0 +1,17 @@
+import * as err from '../errors.js';
+export class SizeLimitStream extends TransformStream {
+    constructor(maxSize) {
+        let bytesRead = 0;
+        super({
+            transform(chunk, controller) {
+                bytesRead += chunk.length;
+                if (bytesRead > maxSize) {
+                    controller.error(new err.ImproperContentLengthError(maxSize, bytesRead, `response content-length too large`));
+                    return;
+                }
+                controller.enqueue(chunk);
+            },
+        });
+    }
+}
+//# sourceMappingURL=size-limit.js.map

package/dist/streams/size-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-limit.js","sourceRoot":"","sources":["../../lib/streams/size-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,MAAM,OAAO,eAAgB,SAAQ,eAAuC;IAC3E,YAAY,OAAe;QAC1B,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,CAAC;YACL,SAAS,CAAC,KAAK,EAAE,UAAU;gBAC1B,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;gBAE1B,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;oBACzB,UAAU,CAAC,KAAK,CACf,IAAI,GAAG,CAAC,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,mCAAmC,CAAC,CAC3F,CAAC;oBAEF,OAAO;gBACR,CAAC;gBAED,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/transformers.d.ts

@@ -0,0 +1,15 @@
+import * as v from '@badrap/valita';
+export type TextResponse = {
+    response: Response;
+    text: string;
+};
+export type ParsedJsonResponse<T = unknown> = {
+    response: Response;
+    json: T;
+};
+export declare const isResponseOk: (response: Response) => Promise<Response>;
+export declare const readResponseAsText: (maxSize: number) => (response: Response) => Promise<TextResponse>;
+export declare const parseResponseAsJson: (typeRegex: RegExp, maxSize: number) => (response: Response) => Promise<ParsedJsonResponse>;
+type ParseOptions = NonNullable<Parameters<v.Type['parse']>[1]>;
+export declare const validateJsonWith: <T>(schema: v.Type<T>, options?: ParseOptions) => (parsed: ParsedJsonResponse) => Promise<ParsedJsonResponse<T>>;
+export {};

package/dist/transformers.js

@@ -0,0 +1,69 @@
+import * as v from '@badrap/valita';
+import * as err from './errors.js';
+import { SizeLimitStream } from './streams/size-limit.js';
+export const isResponseOk = async (response) => {
+    if (response.ok) {
+        return response;
+    }
+    if (response.body) {
+        await response.body.cancel();
+    }
+    throw new err.FailedResponseError(response.status, `got http ${response.status}`);
+};
+export const readResponseAsText = (maxSize) => async (response) => {
+    const text = await readResponse(response, maxSize);
+    return { response, text };
+};
+export const parseResponseAsJson = (typeRegex, maxSize) => async (response) => {
+    assertContentType(response, typeRegex);
+    const text = await readResponse(response, maxSize);
+    try {
+        const json = JSON.parse(text);
+        return { response, json };
+    }
+    catch (error) {
+        throw new err.ImproperResponseError(`unexpected json data`, { cause: error });
+    }
+};
+export const validateJsonWith = (schema, options) => async (parsed) => {
+    const json = schema.parse(parsed.json, options);
+    return { response: parsed.response, json };
+};
+const assertContentType = async (response, typeRegex) => {
+    const type = response.headers.get('content-type')?.split(';', 1)[0].trim();
+    if (type === undefined) {
+        if (response.body) {
+            await response.body.cancel();
+        }
+        throw new err.ImproperContentTypeError(null, `missing response content-type`);
+    }
+    if (!typeRegex.test(type)) {
+        if (response.body) {
+            await response.body.cancel();
+        }
+        throw new err.ImproperContentTypeError(type, `unexpected response content-type`);
+    }
+};
+const readResponse = async (response, maxSize) => {
+    const rawSize = response.headers.get('content-length');
+    if (rawSize !== null) {
+        const size = Number(rawSize);
+        if (!Number.isSafeInteger(size) || size <= 0) {
+            response.body?.cancel();
+            throw new err.ImproperContentLengthError(maxSize, null, `invalid response content-length`);
+        }
+        if (size > maxSize) {
+            response.body?.cancel();
+            throw new err.ImproperContentLengthError(maxSize, size, `response content-length too large`);
+        }
+    }
+    const stream = response
+        .body.pipeThrough(new SizeLimitStream(maxSize))
+        .pipeThrough(new TextDecoderStream());
+    let text = '';
+    for await (const chunk of stream) {
+        text += chunk;
+    }
+    return text;
+};
+//# sourceMappingURL=transformers.js.map

package/dist/transformers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformers.js","sourceRoot":"","sources":["../lib/transformers.ts"],"names":[],"mappings":"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"}

package/lib/errors.ts

@@ -0,0 +1,45 @@
+export class FetchResponseError extends Error {
+	override name = 'FetchResponseError';
+}
+
+export class FailedResponseError extends FetchResponseError {
+	override name = 'FailedResponseError';
+
+	constructor(
+		public status: number,
+		reason: string,
+	) {
+		super(reason);
+	}
+}
+
+export class ImproperContentTypeError extends FetchResponseError {
+	override name = 'ImproperContentTypeError';
+
+	constructor(
+		public contentType: string | null,
+		reason: string,
+	) {
+		super(reason);
+	}
+}
+
+export class ImproperContentLengthError extends FetchResponseError {
+	override name = 'ImproperContentLengthError';
+
+	constructor(
+		public expectedSize: number,
+		public actualSize: number | null,
+		reason: string,
+	) {
+		super(reason);
+	}
+}
+
+export class ImproperResponseError extends FetchResponseError {
+	override name = 'ImproperResponseError';
+
+	constructor(reason: string, options?: ErrorOptions) {
+		super(reason, options);
+	}
+}

package/lib/index.ts

@@ -0,0 +1,3 @@
+export * from './errors.js';
+export * from './pipeline.js';
+export * from './transformers.js';

package/lib/pipeline.ts

@@ -0,0 +1,41 @@
+type Transformer<I, O = I> = (input: I) => Promise<O>;
+
+type PipelineInput<T extends readonly Transformer<any>[]> = T extends [Transformer<infer I, any>, ...any[]]
+	? I
+	: T extends Transformer<infer I, any>[]
+		? I
+		: never;
+
+type PipelineOutput<T extends readonly Transformer<any>[]> = T extends [...any[], Transformer<any, infer O>]
+	? O
+	: T extends Transformer<any, infer O>[]
+		? O
+		: never;
+
+type Pipeline<
+	F extends readonly Transformer<any>[],
+	Acc extends readonly Transformer<any>[] = [],
+> = F extends [Transformer<infer I, infer O>]
+	? [...Acc, Transformer<I, O>]
+	: F extends [Transformer<infer A, any>, ...infer Tail]
+		? Tail extends [Transformer<infer B, any>, ...any[]]
+			? Pipeline<Tail, [...Acc, Transformer<A, B>]>
+			: Acc
+		: Acc;
+
+export function pipe(): never;
+export function pipe<T extends readonly Transformer<any>[]>(
+	...pipeline: Pipeline<T> extends T ? T : Pipeline<T>
+): (input: PipelineInput<T>) => Promise<PipelineOutput<T>>;
+export function pipe<T extends readonly Transformer<any>[]>(
+	...pipeline: Pipeline<T> extends T ? T : Pipeline<T>
+): (input: PipelineInput<T>) => Promise<PipelineOutput<T>> {
+	return pipeline.reduce(pipeTwo);
+}
+
+const pipeTwo = <I, O, X = unknown>(
+	first: Transformer<I, X>,
+	second: Transformer<X, O>,
+): ((input: I) => Promise<O>) => {
+	return (input) => first(input).then(second);
+};

package/lib/streams/size-limit.ts

@@ -0,0 +1,23 @@
+import * as err from '../errors.js';
+
+export class SizeLimitStream extends TransformStream<Uint8Array, Uint8Array> {
+	constructor(maxSize: number) {
+		let bytesRead = 0;
+
+		super({
+			transform(chunk, controller) {
+				bytesRead += chunk.length;
+
+				if (bytesRead > maxSize) {
+					controller.error(
+						new err.ImproperContentLengthError(maxSize, bytesRead, `response content-length too large`),
+					);
+
+					return;
+				}
+
+				controller.enqueue(chunk);
+			},
+		});
+	}
+}

package/lib/transformers.ts

@@ -0,0 +1,105 @@
+import * as v from '@badrap/valita';
+
+import * as err from './errors.js';
+import { SizeLimitStream } from './streams/size-limit.js';
+
+export type TextResponse = {
+	response: Response;
+	text: string;
+};
+
+export type ParsedJsonResponse<T = unknown> = {
+	response: Response;
+	json: T;
+};
+
+export const isResponseOk = async (response: Response): Promise<Response> => {
+	if (response.ok) {
+		return response;
+	}
+
+	if (response.body) {
+		await response.body.cancel();
+	}
+
+	throw new err.FailedResponseError(response.status, `got http ${response.status}`);
+};
+
+export const readResponseAsText =
+	(maxSize: number) =>
+	async (response: Response): Promise<TextResponse> => {
+		const text = await readResponse(response, maxSize);
+		return { response, text };
+	};
+
+export const parseResponseAsJson =
+	(typeRegex: RegExp, maxSize: number) =>
+	async (response: Response): Promise<ParsedJsonResponse> => {
+		assertContentType(response, typeRegex);
+
+		const text = await readResponse(response, maxSize);
+
+		try {
+			const json = JSON.parse(text);
+			return { response, json };
+		} catch (error) {
+			throw new err.ImproperResponseError(`unexpected json data`, { cause: error });
+		}
+	};
+
+type ParseOptions = NonNullable<Parameters<v.Type['parse']>[1]>;
+
+export const validateJsonWith =
+	<T>(schema: v.Type<T>, options?: ParseOptions) =>
+	async (parsed: ParsedJsonResponse): Promise<ParsedJsonResponse<T>> => {
+		const json = schema.parse(parsed.json, options);
+		return { response: parsed.response, json };
+	};
+
+const assertContentType = async (response: Response, typeRegex: RegExp): Promise<void> => {
+	const type = response.headers.get('content-type')?.split(';', 1)[0].trim();
+
+	if (type === undefined) {
+		if (response.body) {
+			await response.body.cancel();
+		}
+
+		throw new err.ImproperContentTypeError(null, `missing response content-type`);
+	}
+
+	if (!typeRegex.test(type)) {
+		if (response.body) {
+			await response.body.cancel();
+		}
+
+		throw new err.ImproperContentTypeError(type, `unexpected response content-type`);
+	}
+};
+
+const readResponse = async (response: Response, maxSize: number): Promise<string> => {
+	const rawSize = response.headers.get('content-length');
+	if (rawSize !== null) {
+		const size = Number(rawSize);
+
+		if (!Number.isSafeInteger(size) || size <= 0) {
+			response.body?.cancel();
+			throw new err.ImproperContentLengthError(maxSize, null, `invalid response content-length`);
+		}
+
+		if (size > maxSize) {
+			response.body?.cancel();
+			throw new err.ImproperContentLengthError(maxSize, size, `response content-length too large`);
+		}
+	}
+
+	const stream = response
+		.body!.pipeThrough(new SizeLimitStream(maxSize))
+		.pipeThrough(new TextDecoderStream());
+
+	let text = '';
+	for await (const chunk of stream) {
+		text += chunk;
+	}
+
+	return text;
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "type": "module",
+  "name": "@atcute/util-fetch",
+  "version": "1.0.0",
+  "description": "atproto DID to DID document resolution",
+  "keywords": [
+    "atproto",
+    "did"
+  ],
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/mary-ext/atcute",
+    "directory": "packages/misc/util-fetch"
+  },
+  "files": [
+    "dist/",
+    "lib/",
+    "!lib/**/*.bench.ts",
+    "!lib/**/*.test.ts"
+  ],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "@types/bun": "^1.2.1"
+  },
+  "dependencies": {
+    "@badrap/valita": "^0.4.2"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "bun test --coverage",
+    "prepublish": "rm -rf dist; pnpm run build"
+  }
+}