next-image-transformer 0.3.0 → 1.0.0

package/README.md

@@ -71,7 +71,7 @@ import { imageUrlBuilder } from "../lib/imageUrlBuilder";
 export function MyImage() {
   return (
     <img
-      src={imageUrlBuilder.encode({
+      src={imageUrlBuilder({
         source: "https://images.example.com/cat.jpg",
         fmt: "webp",
         w: 800,
@@ -122,10 +122,7 @@ Returns: `(req: Request) => Promise<Response>` (compatible with Next.js Route Ha
 
 Import from: `next-image-transformer`
 
-Returns: a Zod codec that can:
-
-- `encode(config: TransformConfig): string` (builds a URL)
-- `safeDecode(url: string): { data?: TransformConfig; error?: ... }` (parses a URL)
+Returns: a function `(config: TransformConfig) => string` that builds a transform URL.
 
 **Options**
 
@@ -139,20 +136,18 @@ The transform URL uses these query params:
 
 - **`source`**: `string` (required)
   - Absolute `http(s)` URL to the upstream image.
-- **`fmt`**: `"preserve" | "webp" | "avif"` (optional in the URL)
-  - **Default (when decoding)**: `"preserve"`
+- **`fmt`**: `"preserve" | "webp" | "avif"` (optional)
+  - If omitted, it defaults to `"preserve"`.
 - **`w`**: `number` (optional)
   - 32-bit integer
 - **`h`**: `number` (optional)
   - 32-bit integer
 - **`fit`**: `"cover" | "contain" | "fill" | "inside" | "outside"` (optional)
   - Only used when resizing (`w` and/or `h` is provided)
-  - **Default (when decoding)**: `"inside"`
+  - If omitted, it defaults to `"inside"`.
 - **`q`**: `number` (optional)
   - Integer in `[0..100]`
-  - **Default (when transforming)**: `100`
-
-When building URLs, `fmt=preserve` is omitted from the query string (it’s treated as the “default”).
+  - **Default**: `100`
 
 ### License
 

package/dist/createImageUrlBuilder.d.ts

@@ -1,21 +1,9 @@
-import z from "zod";
-export declare const createImageUrlBuilder: ({ apiRouteUrl, }: {
-    apiRouteUrl: string;
-}) => z.ZodCodec<z.ZodURL, z.ZodObject<{
-    w: z.ZodOptional<z.ZodInt32>;
-    h: z.ZodOptional<z.ZodInt32>;
-    fit: z.ZodOptional<z.ZodEnum<{
-        cover: "cover";
-        contain: "contain";
-        fill: "fill";
-        inside: "inside";
-        outside: "outside";
-    }>>;
-    fmt: z.ZodEnum<{
-        preserve: "preserve";
-        webp: "webp";
-        avif: "avif";
-    }>;
-    q: z.ZodOptional<z.ZodInt32>;
-    source: z.ZodString;
-}, z.core.$strip>>;
+import { createImageUrlCodec } from "./createImageUrlCodec";
+export declare const createImageUrlBuilder: (...args: Parameters<typeof createImageUrlCodec>) => (data: {
+    source: string;
+    w?: number | undefined;
+    h?: number | undefined;
+    fit?: "cover" | "contain" | "fill" | "inside" | "outside" | undefined;
+    fmt?: "preserve" | "webp" | "avif" | undefined;
+    q?: number | undefined;
+}, params?: import("zod/v4/core").ParseContext<import("zod/v4/core").$ZodIssue>) => string;

package/dist/{index-mUKn0C6P.js → createImageUrlCodec-Cpmqn0AP.js}

@@ -128,7 +128,7 @@ function H(e, t, i) {
     configurable: !0
   });
 }
-function V(...e) {
+function G(...e) {
   const t = {};
   for (const i of e) {
     const o = Object.getOwnPropertyDescriptors(i);
@@ -137,7 +137,7 @@ function V(...e) {
   return Object.defineProperties({}, t);
 }
 function Sd(e) {
-  return V(e._zod.def);
+  return G(e._zod.def);
 }
 function wd(e, t) {
   return t ? t.reduce((i, o) => i?.[o], e) : e;
@@ -286,7 +286,7 @@ function ji(e, t) {
   const i = e._zod.def, o = i.checks;
   if (o && o.length > 0)
     throw new Error(".pick() cannot be used on object schemas containing refinements");
-  const r = V(e._zod.def, {
+  const r = G(e._zod.def, {
     get shape() {
       const a = {};
       for (const c in t) {
@@ -304,7 +304,7 @@ function Ui(e, t) {
   const i = e._zod.def, o = i.checks;
   if (o && o.length > 0)
     throw new Error(".omit() cannot be used on object schemas containing refinements");
-  const r = V(e._zod.def, {
+  const r = G(e._zod.def, {
     get shape() {
       const a = { ...e._zod.def.shape };
       for (const c in t) {
@@ -328,7 +328,7 @@ function Oi(e, t) {
       if (Object.getOwnPropertyDescriptor(r, a) !== void 0)
         throw new Error("Cannot overwrite keys on object schemas containing refinements. Use `.safeExtend()` instead.");
   }
-  const n = V(e._zod.def, {
+  const n = G(e._zod.def, {
     get shape() {
       const r = { ...e._zod.def.shape, ...t };
       return H(this, "shape", r), r;
@@ -339,7 +339,7 @@ function Oi(e, t) {
 function Di(e, t) {
   if (!ne(t))
     throw new Error("Invalid input to safeExtend: expected a plain object");
-  const i = V(e._zod.def, {
+  const i = G(e._zod.def, {
     get shape() {
       const o = { ...e._zod.def.shape, ...t };
       return H(this, "shape", o), o;
@@ -348,7 +348,7 @@ function Di(e, t) {
   return F(e, i);
 }
 function Ni(e, t) {
-  const i = V(e._zod.def, {
+  const i = G(e._zod.def, {
     get shape() {
       const o = { ...e._zod.def.shape, ...t._zod.def.shape };
       return H(this, "shape", o), o;
@@ -365,7 +365,7 @@ function Pi(e, t, i) {
   const n = t._zod.def.checks;
   if (n && n.length > 0)
     throw new Error(".partial() cannot be used on object schemas containing refinements");
-  const a = V(t._zod.def, {
+  const a = G(t._zod.def, {
     get shape() {
       const c = t._zod.def.shape, l = { ...c };
       if (i)
@@ -390,7 +390,7 @@ function Pi(e, t, i) {
   return F(t, a);
 }
 function Zi(e, t, i) {
-  const o = V(t._zod.def, {
+  const o = G(t._zod.def, {
     get shape() {
       const n = t._zod.def.shape, r = { ...n };
       if (i)
@@ -548,7 +548,7 @@ const Ai = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   joinValues: p,
   jsonStringifyReplacer: Qe,
   merge: Ni,
-  mergeDefs: V,
+  mergeDefs: G,
   normalizeParams: f,
   nullish: ie,
   numKeys: Ud,
@@ -8743,7 +8743,7 @@ const Ju = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     input: be(e, "input"),
     output: be(e, "output")
   }
-}), e.toJSONSchema = Hc(e, {}), e.def = t, e.type = t.type, Object.defineProperty(e, "_def", { value: t }), e.check = (...i) => e.clone(V(t, {
+}), e.toJSONSchema = Hc(e, {}), e.def = t, e.type = t.type, Object.defineProperty(e, "_def", { value: t }), e.check = (...i) => e.clone(G(t, {
   checks: [
     ...t.checks ?? [],
     ...i.map((o) => typeof o == "function" ? { _zod: { check: o, def: { check: "custom" }, onattach: [] } } : o)
@@ -8768,7 +8768,7 @@ const Ju = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   const i = e._zod.bag;
   e.format = i.format ?? null, e.minLength = i.minimum ?? null, e.maxLength = i.maximum ?? null, e.regex = (...o) => e.check(/* @__PURE__ */ pn(...o)), e.includes = (...o) => e.check(/* @__PURE__ */ $n(...o)), e.startsWith = (...o) => e.check(/* @__PURE__ */ hn(...o)), e.endsWith = (...o) => e.check(/* @__PURE__ */ _n(...o)), e.min = (...o) => e.check(/* @__PURE__ */ te(...o)), e.max = (...o) => e.check(/* @__PURE__ */ Te(...o)), e.length = (...o) => e.check(/* @__PURE__ */ Ee(...o)), e.nonempty = (...o) => e.check(/* @__PURE__ */ te(1, ...o)), e.lowercase = (o) => e.check(/* @__PURE__ */ vn(o)), e.uppercase = (o) => e.check(/* @__PURE__ */ gn(o)), e.trim = () => e.check(/* @__PURE__ */ kn()), e.normalize = (...o) => e.check(/* @__PURE__ */ yn(...o)), e.toLowerCase = () => e.check(/* @__PURE__ */ zn()), e.toUpperCase = () => e.check(/* @__PURE__ */ In()), e.slugify = () => e.check(/* @__PURE__ */ Sn());
 }), Le = /* @__PURE__ */ d("ZodString", (e, t) => {
-  Pe.init(e, t), wn.init(e, t), e.email = (i) => e.check(/* @__PURE__ */ Nt(xn, i)), e.url = (i) => e.check(/* @__PURE__ */ fn(Re, i)), e.jwt = (i) => e.check(/* @__PURE__ */ Yt(Cn, i)), e.emoji = (i) => e.check(/* @__PURE__ */ At(jn, i)), e.guid = (i) => e.check(/* @__PURE__ */ tn(ye, i)), e.uuid = (i) => e.check(/* @__PURE__ */ Pt(K, i)), e.uuidv4 = (i) => e.check(/* @__PURE__ */ Zt(K, i)), e.uuidv6 = (i) => e.check(/* @__PURE__ */ Tt(K, i)), e.uuidv7 = (i) => e.check(/* @__PURE__ */ Et(K, i)), e.nanoid = (i) => e.check(/* @__PURE__ */ Lt(Un, i)), e.guid = (i) => e.check(/* @__PURE__ */ tn(ye, i)), e.cuid = (i) => e.check(/* @__PURE__ */ Rt(On, i)), e.cuid2 = (i) => e.check(/* @__PURE__ */ Ft(Dn, i)), e.ulid = (i) => e.check(/* @__PURE__ */ Jt(Nn, i)), e.base64 = (i) => e.check(/* @__PURE__ */ Bt(Rn, i)), e.base64url = (i) => e.check(/* @__PURE__ */ qt(Fn, i)), e.xid = (i) => e.check(/* @__PURE__ */ Ct(Pn, i)), e.ksuid = (i) => e.check(/* @__PURE__ */ Mt(Zn, i)), e.ipv4 = (i) => e.check(/* @__PURE__ */ Kt(Tn, i)), e.ipv6 = (i) => e.check(/* @__PURE__ */ Vt(En, i)), e.cidrv4 = (i) => e.check(/* @__PURE__ */ Gt(An, i)), e.cidrv6 = (i) => e.check(/* @__PURE__ */ Wt(Ln, i)), e.e164 = (i) => e.check(/* @__PURE__ */ Xt(Jn, i)), e.datetime = (i) => e.check(Au(i)), e.date = (i) => e.check(Lu(i)), e.time = (i) => e.check(Ru(i)), e.duration = (i) => e.check(Fu(i));
+  Pe.init(e, t), wn.init(e, t), e.email = (i) => e.check(/* @__PURE__ */ Nt(xn, i)), e.url = (i) => e.check(/* @__PURE__ */ fn(Re, i)), e.jwt = (i) => e.check(/* @__PURE__ */ Yt(Cn, i)), e.emoji = (i) => e.check(/* @__PURE__ */ At(jn, i)), e.guid = (i) => e.check(/* @__PURE__ */ tn(ye, i)), e.uuid = (i) => e.check(/* @__PURE__ */ Pt(V, i)), e.uuidv4 = (i) => e.check(/* @__PURE__ */ Zt(V, i)), e.uuidv6 = (i) => e.check(/* @__PURE__ */ Tt(V, i)), e.uuidv7 = (i) => e.check(/* @__PURE__ */ Et(V, i)), e.nanoid = (i) => e.check(/* @__PURE__ */ Lt(Un, i)), e.guid = (i) => e.check(/* @__PURE__ */ tn(ye, i)), e.cuid = (i) => e.check(/* @__PURE__ */ Rt(On, i)), e.cuid2 = (i) => e.check(/* @__PURE__ */ Ft(Dn, i)), e.ulid = (i) => e.check(/* @__PURE__ */ Jt(Nn, i)), e.base64 = (i) => e.check(/* @__PURE__ */ Bt(Rn, i)), e.base64url = (i) => e.check(/* @__PURE__ */ qt(Fn, i)), e.xid = (i) => e.check(/* @__PURE__ */ Ct(Pn, i)), e.ksuid = (i) => e.check(/* @__PURE__ */ Mt(Zn, i)), e.ipv4 = (i) => e.check(/* @__PURE__ */ Kt(Tn, i)), e.ipv6 = (i) => e.check(/* @__PURE__ */ Vt(En, i)), e.cidrv4 = (i) => e.check(/* @__PURE__ */ Gt(An, i)), e.cidrv6 = (i) => e.check(/* @__PURE__ */ Wt(Ln, i)), e.e164 = (i) => e.check(/* @__PURE__ */ Xt(Jn, i)), e.datetime = (i) => e.check(Au(i)), e.date = (i) => e.check(Lu(i)), e.time = (i) => e.check(Ru(i)), e.duration = (i) => e.check(Fu(i));
 });
 function rn(e) {
   return /* @__PURE__ */ mc(Le, e);
@@ -8787,20 +8787,20 @@ const ye = /* @__PURE__ */ d("ZodGUID", (e, t) => {
 function tl(e) {
   return /* @__PURE__ */ tn(ye, e);
 }
-const K = /* @__PURE__ */ d("ZodUUID", (e, t) => {
+const V = /* @__PURE__ */ d("ZodUUID", (e, t) => {
   Wo.init(e, t), w.init(e, t);
 });
 function rl(e) {
-  return /* @__PURE__ */ Pt(K, e);
+  return /* @__PURE__ */ Pt(V, e);
 }
 function il(e) {
-  return /* @__PURE__ */ Zt(K, e);
+  return /* @__PURE__ */ Zt(V, e);
 }
 function ol(e) {
-  return /* @__PURE__ */ Tt(K, e);
+  return /* @__PURE__ */ Tt(V, e);
 }
 function al(e) {
-  return /* @__PURE__ */ Et(K, e);
+  return /* @__PURE__ */ Et(V, e);
 }
 const Re = /* @__PURE__ */ d("ZodURL", (e, t) => {
   qo.init(e, t), w.init(e, t);
@@ -9534,7 +9534,7 @@ const Df = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   ZodType: y,
   ZodULID: Nn,
   ZodURL: Re,
-  ZodUUID: K,
+  ZodUUID: V,
   ZodUndefined: fr,
   ZodUnion: Ve,
   ZodUnknown: $r,
@@ -10041,7 +10041,7 @@ const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   ZodType: y,
   ZodULID: Nn,
   ZodURL: Re,
-  ZodUUID: K,
+  ZodUUID: V,
   ZodUndefined: fr,
   ZodUnion: Ve,
   ZodUnknown: $r,
@@ -10212,10 +10212,10 @@ const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
    * Defaults to `"inside"` when omitted.
    */
   fit: U.enum(["cover", "contain", "fill", "inside", "outside"]).optional(),
-  fmt: U.enum(["preserve", "webp", "avif"]),
+  fmt: U.enum(["preserve", "webp", "avif"]).optional(),
   q: U.int32().min(0).max(100).optional(),
   source: U.string()
-}), G = (e) => e != null, Qn = U.codec(
+}), K = (e) => e != null, Qn = U.codec(
   U.string().regex(U.regexes.integer),
   U.int(),
   {
@@ -10228,14 +10228,14 @@ const U = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   {
     encode: (e) => {
       const t = new URLSearchParams();
-      return G(e.w) && t.set("w", String(e.w)), G(e.h) && t.set("h", String(e.h)), G(e.fit) && e.fit !== "inside" && t.set("fit", e.fit), e.fmt !== "preserve" && t.set("fmt", e.fmt), G(e.q) && t.set("q", String(e.q)), t.set("source", e.source), t;
+      return K(e.w) && t.set("w", String(e.w)), K(e.h) && t.set("h", String(e.h)), K(e.fit) && t.set("fit", e.fit), K(e.fmt) && t.set("fmt", e.fmt), K(e.q) && t.set("q", String(e.q)), t.set("source", e.source), t;
     },
     decode: (e) => ({
-      w: G(e.get("w")) ? Qn.decode(e.get("w") ?? "") : void 0,
-      h: G(e.get("h")) ? Qn.decode(e.get("h") ?? "") : void 0,
-      fit: G(e.get("fit")) ? U.enum(["cover", "contain", "fill", "inside", "outside"]).parse(e.get("fit")) : "inside",
-      fmt: G(e.get("fmt")) ? U.enum(["preserve", "webp", "avif"]).parse(e.get("fmt")) : "preserve",
-      q: G(e.get("q")) ? Qn.decode(e.get("q") ?? "") : void 0,
+      w: K(e.get("w")) ? Qn.decode(e.get("w") ?? "") : void 0,
+      h: K(e.get("h")) ? Qn.decode(e.get("h") ?? "") : void 0,
+      fit: K(e.get("fit")) ? U.enum(["cover", "contain", "fill", "inside", "outside"]).parse(e.get("fit")) : void 0,
+      fmt: K(e.get("fmt")) ? U.enum(["preserve", "webp", "avif"]).parse(e.get("fmt")) : void 0,
+      q: K(e.get("q")) ? Qn.decode(e.get("q") ?? "") : void 0,
       source: U.string().parse(e.get("source"))
     })
   }

package/dist/createImageUrlCodec.d.ts

@@ -0,0 +1,21 @@
+import z from "zod";
+export declare const createImageUrlCodec: ({ apiRouteUrl, }: {
+    apiRouteUrl: string;
+}) => z.ZodCodec<z.ZodURL, z.ZodObject<{
+    w: z.ZodOptional<z.ZodInt32>;
+    h: z.ZodOptional<z.ZodInt32>;
+    fit: z.ZodOptional<z.ZodEnum<{
+        cover: "cover";
+        contain: "contain";
+        fill: "fill";
+        inside: "inside";
+        outside: "outside";
+    }>>;
+    fmt: z.ZodOptional<z.ZodEnum<{
+        preserve: "preserve";
+        webp: "webp";
+        avif: "avif";
+    }>>;
+    q: z.ZodOptional<z.ZodInt32>;
+    source: z.ZodString;
+}, z.core.$strip>>;

package/dist/index.js

@@ -1,4 +1,5 @@
-import { c as a } from "./index-mUKn0C6P.js";
+import { c as r } from "./createImageUrlCodec-Cpmqn0AP.js";
+const a = (...e) => r(...e).encode;
 export {
   a as createImageUrlBuilder
 };

package/dist/searchParamsToTransformConfigCodec.d.ts

@@ -9,11 +9,11 @@ export declare const searchParamsToTransformConfigCodec: z.ZodCodec<z.ZodCustom<
         inside: "inside";
         outside: "outside";
     }>>;
-    fmt: z.ZodEnum<{
+    fmt: z.ZodOptional<z.ZodEnum<{
         preserve: "preserve";
         webp: "webp";
         avif: "avif";
-    }>;
+    }>>;
     q: z.ZodOptional<z.ZodInt32>;
     source: z.ZodString;
 }, z.core.$strip>>;

package/dist/server.js

@@ -1,5 +1,5 @@
 import h from "node:path";
-import { z as C, c as B } from "./index-mUKn0C6P.js";
+import { z as T, c as B } from "./createImageUrlCodec-Cpmqn0AP.js";
 import { createHash as U } from "node:crypto";
 import m from "node:fs/promises";
 import b from "sharp";
@@ -30,8 +30,8 @@ async function q({
       m.readFile(a, "utf8")
     ]), o = (() => {
       try {
-        const i = JSON.parse(u), e = C.object({
-          contentType: C.string()
+        const i = JSON.parse(u), e = T.object({
+          contentType: T.string()
         }).loose().safeParse(i);
         return e.success ? e.data : null;
       } catch {
@@ -170,24 +170,24 @@ const O = ({
             throw new Error(`Unreachable case: ${e.fmt}`);
         }
       }
-    ).toBuffer(), $ = new Uint8Array(R), T = (() => {
+    ).toBuffer(), $ = new Uint8Array(R), C = (() => {
       switch (e.fmt) {
-        case "preserve":
-          return w.headers.get("content-type") ?? "application/octet-stream";
         case "avif":
           return "image/avif";
         case "webp":
           return "image/webp";
+        default:
+          return w.headers.get("content-type") ?? "application/octet-stream";
       }
     })();
     return await A({
       cacheKey: g,
       body: R,
-      meta: { contentType: T },
+      meta: { contentType: C },
       cacheDir: n
     }), new Response($, {
       headers: {
-        "Content-Type": T,
+        "Content-Type": C,
         "Cache-Control": s
       }
     });

package/dist/transformConfigSchema.d.ts

@@ -9,11 +9,11 @@ export declare const transformConfigSchema: z.ZodObject<{
         inside: "inside";
         outside: "outside";
     }>>;
-    fmt: z.ZodEnum<{
+    fmt: z.ZodOptional<z.ZodEnum<{
         preserve: "preserve";
         webp: "webp";
         avif: "avif";
-    }>;
+    }>>;
     q: z.ZodOptional<z.ZodInt32>;
     source: z.ZodString;
 }, z.core.$strip>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-image-transformer",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {