@howells/stow-next 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Stow
+
+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/dist/image-loader.d.mts

@@ -38,11 +38,13 @@
  * }
  * ```
  */
+/** Next.js image loader input contract. */
 interface ImageLoaderProps {
     quality?: number;
     src: string;
     width: number;
 }
+/** Configuration for `createStowLoader`. */
 interface StowLoaderConfig {
     /**
      * Fixed aspect ratio (width / height).

package/dist/image-loader.d.ts

@@ -38,11 +38,13 @@
  * }
  * ```
  */
+/** Next.js image loader input contract. */
 interface ImageLoaderProps {
     quality?: number;
     src: string;
     width: number;
 }
+/** Configuration for `createStowLoader`. */
 interface StowLoaderConfig {
     /**
      * Fixed aspect ratio (width / height).

package/dist/index.d.mts

@@ -23,6 +23,7 @@ export { StowLoaderConfig, createStowLoader, stowLoader } from './image-loader.m
  * ```
  */
 
+/** CORS options applied to generated route handlers. */
 interface CorsConfig {
     /** Allowed headers (default: ["Content-Type"]) */
     allowedHeaders?: string[];
@@ -37,6 +38,7 @@ interface CorsConfig {
  * Create an OPTIONS handler for CORS preflight requests
  */
 declare function createCorsPreflightHandler(config?: CorsConfig): () => NextResponse;
+/** Minimal server SDK shape required by handler factories. */
 interface StowServerLike {
     confirmUpload: (request: {
         fileKey: string;
@@ -62,11 +64,11 @@ interface StowServerLike {
     } | {
         fileKey: string;
         uploadUrl: string;
-        r2Key: string;
         confirmUrl: string;
         dedupe?: false;
     }>;
 }
+/** Options for `createPresignHandler`. */
 interface PresignHandlerConfig {
     /** Allowed content types (supports wildcards like "image/*") */
     allowedTypes?: string[];
@@ -85,6 +87,7 @@ interface PresignHandlerConfig {
         size: number;
     }) => Promise<boolean | string> | boolean | string;
 }
+/** Options for `createConfirmHandler`. */
 interface ConfirmHandlerConfig {
     /** CORS configuration (enabled by default for browser uploads) */
     cors?: CorsConfig | false;
@@ -112,6 +115,7 @@ declare function createPresignHandler(config: PresignHandlerConfig): (request: N
  * Returns both POST handler and OPTIONS handler for CORS preflight.
  */
 declare function createConfirmHandler(config: ConfirmHandlerConfig): (request: NextRequest) => Promise<NextResponse>;
+/** Minimal combined shape for single-route upload handlers. */
 interface StowLike {
     uploadFile: (file: Blob, options?: {
         filename?: string;
@@ -124,6 +128,7 @@ interface StowLike {
         contentType: string;
     }>;
 }
+/** Options for `createUploadHandler`. */
 interface UploadHandlerConfig {
     /** Allowed content types (supports wildcards like "image/*") */
     allowedTypes?: string[];

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export { StowLoaderConfig, createStowLoader, stowLoader } from './image-loader.j
  * ```
  */
 
+/** CORS options applied to generated route handlers. */
 interface CorsConfig {
     /** Allowed headers (default: ["Content-Type"]) */
     allowedHeaders?: string[];
@@ -37,6 +38,7 @@ interface CorsConfig {
  * Create an OPTIONS handler for CORS preflight requests
  */
 declare function createCorsPreflightHandler(config?: CorsConfig): () => NextResponse;
+/** Minimal server SDK shape required by handler factories. */
 interface StowServerLike {
     confirmUpload: (request: {
         fileKey: string;
@@ -62,11 +64,11 @@ interface StowServerLike {
     } | {
         fileKey: string;
         uploadUrl: string;
-        r2Key: string;
         confirmUrl: string;
         dedupe?: false;
     }>;
 }
+/** Options for `createPresignHandler`. */
 interface PresignHandlerConfig {
     /** Allowed content types (supports wildcards like "image/*") */
     allowedTypes?: string[];
@@ -85,6 +87,7 @@ interface PresignHandlerConfig {
         size: number;
     }) => Promise<boolean | string> | boolean | string;
 }
+/** Options for `createConfirmHandler`. */
 interface ConfirmHandlerConfig {
     /** CORS configuration (enabled by default for browser uploads) */
     cors?: CorsConfig | false;
@@ -112,6 +115,7 @@ declare function createPresignHandler(config: PresignHandlerConfig): (request: N
  * Returns both POST handler and OPTIONS handler for CORS preflight.
  */
 declare function createConfirmHandler(config: ConfirmHandlerConfig): (request: NextRequest) => Promise<NextResponse>;
+/** Minimal combined shape for single-route upload handlers. */
 interface StowLike {
     uploadFile: (file: Blob, options?: {
         filename?: string;
@@ -124,6 +128,7 @@ interface StowLike {
         contentType: string;
     }>;
 }
+/** Options for `createUploadHandler`. */
 interface UploadHandlerConfig {
     /** Allowed content types (supports wildcards like "image/*") */
     allowedTypes?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/stow-next",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Next.js integration for Stow file storage",
   "license": "MIT",
   "repository": {
@@ -34,23 +34,23 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts src/image-loader.ts --format cjs,esm --dts --external next --external react",
-    "dev": "tsup src/index.ts src/image-loader.ts --format cjs,esm --dts --external next --external react --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "peerDependencies": {
     "next": "^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@stow/typescript-config": "workspace:*",
     "@types/react": "19.2.14",
     "next": "16.1.6",
     "react": "^19.2.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "@stow/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/image-loader.ts --format cjs,esm --dts --external next --external react",
+    "dev": "tsup src/index.ts src/image-loader.ts --format cjs,esm --dts --external next --external react --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/dist/chunk-DZDX7UVD.mjs

@@ -1,39 +0,0 @@
-// src/image-loader.ts
-function createStowLoader(config = {}) {
-  const {
-    baseUrl = "https://stow.sh",
-    defaultQuality = 75,
-    defaultFormat
-  } = config;
-  return function stowLoader2({
-    src,
-    width,
-    quality
-  }) {
-    if (src.startsWith(baseUrl) || src.startsWith("/files/")) {
-      const url = new URL(src, baseUrl);
-      const pathname = url.pathname;
-      const params = new URLSearchParams();
-      params.set("w", width.toString());
-      params.set("q", (quality || defaultQuality).toString());
-      if (defaultFormat) {
-        params.set("f", defaultFormat);
-      }
-      if (pathname.startsWith("/files/")) {
-        const transformPath = pathname.replace("/files/", "/transform/");
-        return `${baseUrl}${transformPath}?${params.toString()}`;
-      }
-      if (pathname.startsWith("/transform/")) {
-        return `${baseUrl}${pathname}?${params.toString()}`;
-      }
-      return `${src}${src.includes("?") ? "&" : "?"}${params.toString()}`;
-    }
-    return src;
-  };
-}
-var stowLoader = createStowLoader();
-
-export {
-  createStowLoader,
-  stowLoader
-};

package/dist/chunk-HRAABMBJ.mjs

@@ -1,87 +0,0 @@
-// src/image-loader.ts
-var STOW_DOMAIN_PATTERN = /\.stow\.sh$/;
-function isStowUrl(src) {
-  try {
-    const url = new URL(src);
-    return STOW_DOMAIN_PATTERN.test(url.hostname);
-  } catch {
-    return false;
-  }
-}
-function buildTransformParams(width, quality, config) {
-  const params = new URLSearchParams();
-  params.set("w", width.toString());
-  if (config.aspectRatio) {
-    params.set("h", Math.round(width / config.aspectRatio).toString());
-  }
-  params.set("q", quality.toString());
-  if (config.fit) {
-    params.set("fit", config.fit);
-  }
-  if (config.gravity) {
-    params.set("gravity", config.gravity);
-  }
-  if (config.defaultFormat) {
-    params.set("f", config.defaultFormat);
-  }
-  return params;
-}
-function transformStowUrl(src, baseUrl, params) {
-  const url = new URL(src, baseUrl);
-  const pathname = url.pathname;
-  if (pathname.startsWith("/files/")) {
-    const transformPath = pathname.replace("/files/", "/transform/");
-    return `${baseUrl}${transformPath}?${params.toString()}`;
-  }
-  if (pathname.startsWith("/transform/")) {
-    return `${baseUrl}${pathname}?${params.toString()}`;
-  }
-  return `${src}${src.includes("?") ? "&" : "?"}${params.toString()}`;
-}
-function createStowLoader(config = {}) {
-  const {
-    baseUrl = "https://stow.sh",
-    defaultQuality = 75,
-    defaultFormat,
-    proxySlug,
-    fit,
-    gravity,
-    aspectRatio
-  } = config;
-  return function stowLoader2({
-    src,
-    width,
-    quality
-  }) {
-    const resolvedQuality = quality || defaultQuality;
-    const paramConfig = { defaultFormat, fit, gravity, aspectRatio };
-    if (isStowUrl(src)) {
-      const params = buildTransformParams(width, resolvedQuality, paramConfig);
-      return `${src}${src.includes("?") ? "&" : "?"}${params.toString()}`;
-    }
-    if (src.startsWith(baseUrl) || src.startsWith("/files/")) {
-      const params = buildTransformParams(width, resolvedQuality, paramConfig);
-      return transformStowUrl(src, baseUrl, params);
-    }
-    if (proxySlug && (src.startsWith("http://") || src.startsWith("https://"))) {
-      const params = new URLSearchParams();
-      params.set("url", src);
-      params.set("w", width.toString());
-      if (aspectRatio) {
-        params.set("h", Math.round(width / aspectRatio).toString());
-      }
-      params.set("q", resolvedQuality.toString());
-      if (fit) params.set("fit", fit);
-      if (gravity) params.set("gravity", gravity);
-      if (defaultFormat) params.set("f", defaultFormat);
-      return `https://proxy.stow.sh/${proxySlug}/?${params.toString()}`;
-    }
-    return src;
-  };
-}
-var stowLoader = createStowLoader();
-
-export {
-  createStowLoader,
-  stowLoader
-};

package/dist/chunk-HYKV6KDZ.mjs

@@ -1,31 +0,0 @@
-// src/image-loader.ts
-function createObliqLoader(config = {}) {
-  const { baseUrl = "https://obliq.co", defaultQuality = 75, defaultFormat } = config;
-  return function obliqLoader2({ src, width, quality }) {
-    if (src.startsWith(baseUrl) || src.startsWith("/files/")) {
-      const url = new URL(src, baseUrl);
-      const pathname = url.pathname;
-      const params = new URLSearchParams();
-      params.set("w", width.toString());
-      params.set("q", (quality || defaultQuality).toString());
-      if (defaultFormat) {
-        params.set("f", defaultFormat);
-      }
-      if (pathname.startsWith("/files/")) {
-        const transformPath = pathname.replace("/files/", "/transform/");
-        return `${baseUrl}${transformPath}?${params.toString()}`;
-      }
-      if (pathname.startsWith("/transform/")) {
-        return `${baseUrl}${pathname}?${params.toString()}`;
-      }
-      return `${src}${src.includes("?") ? "&" : "?"}${params.toString()}`;
-    }
-    return src;
-  };
-}
-var obliqLoader = createObliqLoader();
-
-export {
-  createObliqLoader,
-  obliqLoader
-};

package/dist/chunk-WWNT32U5.mjs

@@ -1,62 +0,0 @@
-// src/image-loader.ts
-function buildTransformParams(width, quality, defaultFormat) {
-  const params = new URLSearchParams();
-  params.set("w", width.toString());
-  params.set("q", quality.toString());
-  if (defaultFormat) {
-    params.set("f", defaultFormat);
-  }
-  return params;
-}
-function transformStowUrl(src, baseUrl, params) {
-  const url = new URL(src, baseUrl);
-  const pathname = url.pathname;
-  if (pathname.startsWith("/files/")) {
-    const transformPath = pathname.replace("/files/", "/transform/");
-    return `${baseUrl}${transformPath}?${params.toString()}`;
-  }
-  if (pathname.startsWith("/transform/")) {
-    return `${baseUrl}${pathname}?${params.toString()}`;
-  }
-  return `${src}${src.includes("?") ? "&" : "?"}${params.toString()}`;
-}
-function createStowLoader(config = {}) {
-  const {
-    baseUrl = "https://stow.sh",
-    defaultQuality = 75,
-    defaultFormat,
-    proxySlug
-  } = config;
-  return function stowLoader2({
-    src,
-    width,
-    quality
-  }) {
-    const resolvedQuality = quality || defaultQuality;
-    if (src.startsWith(baseUrl) || src.startsWith("/files/")) {
-      const params = buildTransformParams(
-        width,
-        resolvedQuality,
-        defaultFormat
-      );
-      return transformStowUrl(src, baseUrl, params);
-    }
-    if (proxySlug && (src.startsWith("http://") || src.startsWith("https://"))) {
-      const params = new URLSearchParams();
-      params.set("url", src);
-      params.set("w", width.toString());
-      params.set("q", resolvedQuality.toString());
-      if (defaultFormat) {
-        params.set("f", defaultFormat);
-      }
-      return `https://proxy.stow.sh/${proxySlug}/?${params.toString()}`;
-    }
-    return src;
-  };
-}
-var stowLoader = createStowLoader();
-
-export {
-  createStowLoader,
-  stowLoader
-};

package/dist/chunk-X2Y24T4H.mjs

@@ -1,31 +0,0 @@
-// src/image-loader.ts
-function createStowLoader(config = {}) {
-  const { baseUrl = "https://stow.sh", defaultQuality = 75, defaultFormat } = config;
-  return function stowLoader2({ src, width, quality }) {
-    if (src.startsWith(baseUrl) || src.startsWith("/files/")) {
-      const url = new URL(src, baseUrl);
-      const pathname = url.pathname;
-      const params = new URLSearchParams();
-      params.set("w", width.toString());
-      params.set("q", (quality || defaultQuality).toString());
-      if (defaultFormat) {
-        params.set("f", defaultFormat);
-      }
-      if (pathname.startsWith("/files/")) {
-        const transformPath = pathname.replace("/files/", "/transform/");
-        return `${baseUrl}${transformPath}?${params.toString()}`;
-      }
-      if (pathname.startsWith("/transform/")) {
-        return `${baseUrl}${pathname}?${params.toString()}`;
-      }
-      return `${src}${src.includes("?") ? "&" : "?"}${params.toString()}`;
-    }
-    return src;
-  };
-}
-var stowLoader = createStowLoader();
-
-export {
-  createStowLoader,
-  stowLoader
-};