feat: add wsrv.nl provider (#176)

* Add wsrv.nl provider

* Re-work

* Fix keyMap and test issue, add to async provider map

Author: kevmodrome

data/domains.json

@@ -11,5 +11,6 @@
 	"assets.caisy.io": "bunny",
 	"images.contentstack.io": "contentstack",
 	"ucarecdn.com": "uploadcare",
-	"imagedelivery.net": "cloudflare_images"
+	"imagedelivery.net": "cloudflare_images",
+	"wsrv.nl": "wsrv"
 }

demo/src/examples.json

@@ -95,5 +95,9 @@
 	"appwrite": [
 		"Appwrite",
 		"https://cloud.appwrite.io/v1/storage/buckets/unpic/files/679d127100131f67b6d8/view?project=unpic-test"
+	],
+	"wsrv": [
+		"wsrv.nl",
+		"https://wsrv.nl/?url=images.unsplash.com/photo-1560807707-8cc77767d783"
 	]
 }

deno.jsonc

@@ -29,7 +29,8 @@
 		"./providers/supabase": "./src/providers/supabase.ts",
 		"./providers/uploadcare": "./src/providers/uploadcare.ts",
 		"./providers/vercel": "./src/providers/vercel.ts",
-		"./providers/wordpress": "./src/providers/wordpress.ts"
+		"./providers/wordpress": "./src/providers/wordpress.ts",
+		"./providers/wsrv": "./src/providers/wsrv.ts"
 	},
 	"tasks": {
 		"build:npm": "deno run --allow-all scripts/build_npm.ts"

src/async.ts

@@ -40,6 +40,7 @@ const asyncProviderMap: AsyncProviderMap = {
 	uploadcare: () => import("./providers/uploadcare.ts"),
 	vercel: () => import("./providers/vercel.ts"),
 	wordpress: () => import("./providers/wordpress.ts"),
+	wsrv: () => import("./providers/wsrv.ts"),
 };
 
 /**

src/extract.ts

@@ -33,6 +33,7 @@ import { extract as supabase } from "./providers/supabase.ts";
 import { extract as uploadcare } from "./providers/uploadcare.ts";
 import { extract as vercel } from "./providers/vercel.ts";
 import { extract as wordpress } from "./providers/wordpress.ts";
+import { extract as wsrv } from "./providers/wsrv.ts";
 
 export const parsers: URLExtractorMap = {
 	appwrite,
@@ -62,6 +63,7 @@ export const parsers: URLExtractorMap = {
 	uploadcare,
 	vercel,
 	wordpress,
+	wsrv,
 } as const;
 
 /**

src/providers/types.ts

@@ -37,6 +37,7 @@ import type { SupabaseOperations } from "./supabase.ts";
 import type { UploadcareOperations, UploadcareOptions } from "./uploadcare.ts";
 import type { VercelOperations, VercelOptions } from "./vercel.ts";
 import type { WordPressOperations } from "./wordpress.ts";
+import type { WsrvOperations } from "./wsrv.ts";
 
 export interface ProviderOperations {
 	appwrite: AppwriteOperations;
@@ -66,6 +67,7 @@ export interface ProviderOperations {
 	uploadcare: UploadcareOperations;
 	vercel: VercelOperations;
 	wordpress: WordPressOperations;
+	wsrv: WsrvOperations;
 }
 
 export interface ProviderOptions {
@@ -96,6 +98,7 @@ export interface ProviderOptions {
 	uploadcare: UploadcareOptions;
 	vercel: VercelOptions;
 	wordpress: undefined;
+	wsrv: undefined;
 }
 
 export type URLExtractorMap = {

src/providers/wsrv.test.ts

@@ -0,0 +1,136 @@
+import { extract, generate, transform } from "./wsrv.ts";
+import { assertEqualIgnoringQueryOrder } from "../test-utils.ts";
+import { assertEquals } from "jsr:@std/assert";
+
+const img = "https://example.com/image.jpg";
+
+Deno.test("wsrv extract", async (t) => {
+	await t.step("should parse a basic wsrv URL", () => {
+		const { operations, src } = extract(
+			"https://wsrv.nl/?url=example.com/image.jpg",
+		) ?? {};
+		assertEquals(src, "https://example.com/image.jpg");
+		assertEquals(operations, {});
+	});
+
+	await t.step("should parse operations from URL", () => {
+		const { operations, src } = extract(
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&h=200&q=85&output=webp&fit=cover",
+		) ?? {};
+		assertEquals(src, "https://example.com/image.jpg");
+		assertEquals(operations?.width, 300);
+		assertEquals(operations?.height, 200);
+		assertEquals(operations?.quality, 85);
+		assertEquals(operations?.format, "webp");
+		assertEquals(operations?.fit, "cover");
+	});
+
+	await t.step("should return null for non-wsrv URLs", () => {
+		const result = extract("https://example.com/image.jpg");
+		assertEquals(result, null);
+	});
+});
+
+Deno.test("wsrv generate", async (t) => {
+	await t.step("should format a URL with width and height", () => {
+		const result = generate(img, {
+			width: 300,
+			height: 200,
+		});
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&h=200&fit=cover",
+		);
+	});
+
+	await t.step("should not set height if not provided", () => {
+		const result = generate(img, { width: 300 });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&fit=cover",
+		);
+	});
+
+	await t.step("should format a URL with quality", () => {
+		const result = generate(img, { width: 600, quality: 80 });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=600&q=80&fit=cover",
+		);
+	});
+
+	await t.step("should format a URL with format conversion", () => {
+		const result = generate(img, { width: 400, format: "webp" });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=400&output=webp&fit=cover",
+		);
+	});
+
+	await t.step("should apply default fit=cover", () => {
+		const result = generate(img, { width: 300 });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&fit=cover",
+		);
+	});
+
+	await t.step("should allow overriding fit parameter", () => {
+		const result = generate(img, { width: 300, fit: "contain" });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&fit=contain",
+		);
+	});
+
+	await t.step("should format a URL with provider-specific operations", () => {
+		const result = generate(img, { width: 300, dpr: 2, blur: 5 });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&dpr=2&blur=5&fit=cover",
+		);
+	});
+});
+
+Deno.test("wsrv transform", async (t) => {
+	await t.step("should format a URL with width and height", () => {
+		const result = transform(img, {
+			width: 200,
+			height: 100,
+		});
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=200&h=100&fit=cover",
+		);
+	});
+
+	await t.step("should not set height if not provided", () => {
+		const result = transform(img, { width: 200 });
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=200&fit=cover",
+		);
+	});
+
+	await t.step("should apply defaults to URL", () => {
+		const result = transform(
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300",
+			{},
+		);
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&fit=cover",
+		);
+	});
+
+	await t.step("should override existing parameters", () => {
+		const result = transform(
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&fit=inside",
+			{ fit: "contain" },
+		);
+		assertEqualIgnoringQueryOrder(
+			result,
+			"https://wsrv.nl/?url=example.com/image.jpg&w=300&fit=contain",
+		);
+	});
+});