@edgestore/server 0.3.1 → 0.3.3

package/dist/adapters/start/index.d.ts

@@ -0,0 +1,18 @@
+import { type EdgeStoreRouter, type MaybePromise, type Provider } from '@edgestore/shared';
+import { type LogLevel } from '../../libs/logger';
+export type CreateContextOptions = {
+    req: Request;
+};
+export type Config<TCtx> = {
+    provider?: Provider;
+    router: EdgeStoreRouter<TCtx>;
+    logLevel?: LogLevel;
+} & (TCtx extends Record<string, never> ? object : {
+    provider?: Provider;
+    router: EdgeStoreRouter<TCtx>;
+    createContext: (opts: CreateContextOptions) => MaybePromise<TCtx>;
+});
+export declare function createEdgeStoreStartHandler<TCtx>(config: Config<TCtx>): ({ request }: {
+    request: Request;
+}) => Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/start/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAiB1D,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,IAAI,IAAI;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACnC,MAAM,GACN;IACE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;CACnE,CAAC,CAAC;AAsBP,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;aAM9B,OAAO;wBA4I9C"}

package/dist/adapters/start/index.js

@@ -0,0 +1,190 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var shared = require('@edgestore/shared');
+var utils = require('../../utils-5819d5e1.js');
+var providers_edgestore_index = require('../../providers/edgestore/index.js');
+var shared$1 = require('../../shared-7c700083.js');
+require('../../index-4491caf0.js');
+require('@panva/hkdf');
+require('cookie');
+require('jose');
+require('uuid');
+
+// Helper to extract a cookie from the request's cookie header
+function getCookie(req, cookieName) {
+    const cookieHeader = req.headers.get('cookie');
+    if (!cookieHeader) return undefined;
+    return cookieHeader.split(';').map((cookieStr)=>cookieStr.trim()).reduce((acc, cookieStr)=>{
+        const [name, ...rest] = cookieStr.split('=');
+        if (name && rest.length > 0) {
+            acc[name] = rest.join('=');
+        }
+        return acc;
+    }, {})[cookieName];
+}
+function createEdgeStoreStartHandler(config) {
+    const { provider = providers_edgestore_index.EdgeStoreProvider() } = config;
+    const log = new utils.Logger(config.logLevel);
+    globalThis._EDGE_STORE_LOGGER = log;
+    log.debug('Creating Edge Store TanStack Start handler');
+    return async ({ request })=>{
+        try {
+            const { pathname } = new URL(request.url);
+            if (utils.matchPath(pathname, '/health')) {
+                return new Response('OK', {
+                    status: 200
+                });
+            } else if (utils.matchPath(pathname, '/init')) {
+                let ctx = {};
+                try {
+                    ctx = 'createContext' in config ? await config.createContext({
+                        req: request
+                    }) : {};
+                } catch (err) {
+                    throw new shared.EdgeStoreError({
+                        message: 'Error creating context',
+                        code: 'CREATE_CONTEXT_ERROR',
+                        cause: err instanceof Error ? err : undefined
+                    });
+                }
+                const { newCookies, token, baseUrl } = await shared$1.init({
+                    ctx,
+                    provider,
+                    router: config.router
+                });
+                const headers = new Headers();
+                newCookies.forEach((cookie)=>headers.append('Set-Cookie', cookie));
+                headers.set('Content-Type', 'application/json');
+                return new Response(JSON.stringify({
+                    token,
+                    baseUrl
+                }), {
+                    status: 200,
+                    headers
+                });
+            } else if (utils.matchPath(pathname, '/request-upload')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await shared$1.requestUpload({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (utils.matchPath(pathname, '/request-upload-parts')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await shared$1.requestUploadParts({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (utils.matchPath(pathname, '/complete-multipart-upload')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                await shared$1.completeMultipartUpload({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(null, {
+                    status: 200
+                });
+            } else if (utils.matchPath(pathname, '/confirm-upload')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await shared$1.confirmUpload({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (utils.matchPath(pathname, '/delete-file')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await shared$1.deleteFile({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (utils.matchPath(pathname, '/proxy-file')) {
+                const urlParam = new URL(request.url).searchParams.get('url');
+                if (typeof urlParam === 'string') {
+                    const proxyRes = await fetch(urlParam, {
+                        headers: {
+                            cookie: request.headers.get('cookie') ?? ''
+                        }
+                    });
+                    const data = await proxyRes.arrayBuffer();
+                    const headers = new Headers();
+                    headers.set('Content-Type', proxyRes.headers.get('Content-Type') ?? 'application/octet-stream');
+                    return new Response(data, {
+                        status: proxyRes.status,
+                        headers
+                    });
+                } else {
+                    return new Response(null, {
+                        status: 400
+                    });
+                }
+            } else {
+                return new Response(null, {
+                    status: 404
+                });
+            }
+        } catch (err) {
+            if (err instanceof shared.EdgeStoreError) {
+                log[err.level](err.formattedMessage());
+                if (err.cause) log[err.level](err.cause);
+                const status = shared.EDGE_STORE_ERROR_CODES[err.code] || 500;
+                return new Response(JSON.stringify(err.formattedJson()), {
+                    status,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            }
+            log.error(err);
+            return new Response(JSON.stringify(new shared.EdgeStoreError({
+                message: 'Internal server error',
+                code: 'SERVER_ERROR'
+            }).formattedJson()), {
+                status: 500,
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+    };
+}
+
+exports.createEdgeStoreStartHandler = createEdgeStoreStartHandler;

package/dist/adapters/start/index.mjs

@@ -0,0 +1,186 @@
+import { EdgeStoreError, EDGE_STORE_ERROR_CODES } from '@edgestore/shared';
+import { L as Logger, m as matchPath } from '../../utils-f6f56d38.mjs';
+import { EdgeStoreProvider } from '../../providers/edgestore/index.mjs';
+import { i as init, r as requestUpload, a as requestUploadParts, c as completeMultipartUpload, d as confirmUpload, e as deleteFile } from '../../shared-039276af.mjs';
+import '../../index-28efdacf.mjs';
+import '@panva/hkdf';
+import 'cookie';
+import 'jose';
+import 'uuid';
+
+// Helper to extract a cookie from the request's cookie header
+function getCookie(req, cookieName) {
+    const cookieHeader = req.headers.get('cookie');
+    if (!cookieHeader) return undefined;
+    return cookieHeader.split(';').map((cookieStr)=>cookieStr.trim()).reduce((acc, cookieStr)=>{
+        const [name, ...rest] = cookieStr.split('=');
+        if (name && rest.length > 0) {
+            acc[name] = rest.join('=');
+        }
+        return acc;
+    }, {})[cookieName];
+}
+function createEdgeStoreStartHandler(config) {
+    const { provider = EdgeStoreProvider() } = config;
+    const log = new Logger(config.logLevel);
+    globalThis._EDGE_STORE_LOGGER = log;
+    log.debug('Creating Edge Store TanStack Start handler');
+    return async ({ request })=>{
+        try {
+            const { pathname } = new URL(request.url);
+            if (matchPath(pathname, '/health')) {
+                return new Response('OK', {
+                    status: 200
+                });
+            } else if (matchPath(pathname, '/init')) {
+                let ctx = {};
+                try {
+                    ctx = 'createContext' in config ? await config.createContext({
+                        req: request
+                    }) : {};
+                } catch (err) {
+                    throw new EdgeStoreError({
+                        message: 'Error creating context',
+                        code: 'CREATE_CONTEXT_ERROR',
+                        cause: err instanceof Error ? err : undefined
+                    });
+                }
+                const { newCookies, token, baseUrl } = await init({
+                    ctx,
+                    provider,
+                    router: config.router
+                });
+                const headers = new Headers();
+                newCookies.forEach((cookie)=>headers.append('Set-Cookie', cookie));
+                headers.set('Content-Type', 'application/json');
+                return new Response(JSON.stringify({
+                    token,
+                    baseUrl
+                }), {
+                    status: 200,
+                    headers
+                });
+            } else if (matchPath(pathname, '/request-upload')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await requestUpload({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (matchPath(pathname, '/request-upload-parts')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await requestUploadParts({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (matchPath(pathname, '/complete-multipart-upload')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                await completeMultipartUpload({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(null, {
+                    status: 200
+                });
+            } else if (matchPath(pathname, '/confirm-upload')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await confirmUpload({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (matchPath(pathname, '/delete-file')) {
+                const body = await request.json();
+                const ctxToken = getCookie(request, 'edgestore-ctx');
+                const result = await deleteFile({
+                    provider,
+                    router: config.router,
+                    body: body,
+                    ctxToken
+                });
+                return new Response(JSON.stringify(result), {
+                    status: 200,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            } else if (matchPath(pathname, '/proxy-file')) {
+                const urlParam = new URL(request.url).searchParams.get('url');
+                if (typeof urlParam === 'string') {
+                    const proxyRes = await fetch(urlParam, {
+                        headers: {
+                            cookie: request.headers.get('cookie') ?? ''
+                        }
+                    });
+                    const data = await proxyRes.arrayBuffer();
+                    const headers = new Headers();
+                    headers.set('Content-Type', proxyRes.headers.get('Content-Type') ?? 'application/octet-stream');
+                    return new Response(data, {
+                        status: proxyRes.status,
+                        headers
+                    });
+                } else {
+                    return new Response(null, {
+                        status: 400
+                    });
+                }
+            } else {
+                return new Response(null, {
+                    status: 404
+                });
+            }
+        } catch (err) {
+            if (err instanceof EdgeStoreError) {
+                log[err.level](err.formattedMessage());
+                if (err.cause) log[err.level](err.cause);
+                const status = EDGE_STORE_ERROR_CODES[err.code] || 500;
+                return new Response(JSON.stringify(err.formattedJson()), {
+                    status,
+                    headers: {
+                        'Content-Type': 'application/json'
+                    }
+                });
+            }
+            log.error(err);
+            return new Response(JSON.stringify(new EdgeStoreError({
+                message: 'Internal server error',
+                code: 'SERVER_ERROR'
+            }).formattedJson()), {
+                status: 500,
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            });
+        }
+    };
+}
+
+export { createEdgeStoreStartHandler };

package/dist/providers/aws/index.d.ts

@@ -24,6 +24,17 @@ export type AWSProviderOptions = {
      * Can also be set via the `ES_AWS_BUCKET_NAME` environment variable.
      */
     bucketName?: string;
+    /**
+     * Custom endpoint for S3-compatible storage providers (e.g., MinIO).
+     * Can also be set via the `ES_AWS_ENDPOINT` environment variable.
+     */
+    endpoint?: string;
+    /**
+     * Force path style for S3-compatible storage providers.
+     * Can also be set via the `ES_AWS_FORCE_PATH_STYLE` environment variable.
+     * Defaults to false for AWS S3, but should be true for most S3-compatible providers.
+     */
+    forcePathStyle?: boolean;
     /**
      * Base URL to use for accessing files.
      * Only needed if you are using a custom domain or cloudfront.

package/dist/providers/aws/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/aws/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAqGlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/aws/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CA8GlE"}

package/dist/providers/aws/index.js

@@ -7,15 +7,17 @@ var s3RequestPresigner = require('@aws-sdk/s3-request-presigner');
 var uuid = require('uuid');
 
 function AWSProvider(options) {
-    const { accessKeyId = process.env.ES_AWS_ACCESS_KEY_ID, secretAccessKey = process.env.ES_AWS_SECRET_ACCESS_KEY, region = process.env.ES_AWS_REGION, bucketName = process.env.ES_AWS_BUCKET_NAME } = options ?? {};
-    const baseUrl = options?.baseUrl ?? process.env.EDGE_STORE_BASE_URL ?? `https://${bucketName}.s3.${region}.amazonaws.com`;
+    const { accessKeyId = process.env.ES_AWS_ACCESS_KEY_ID, secretAccessKey = process.env.ES_AWS_SECRET_ACCESS_KEY, region = process.env.ES_AWS_REGION, bucketName = process.env.ES_AWS_BUCKET_NAME, endpoint = process.env.ES_AWS_ENDPOINT, forcePathStyle = process.env.ES_AWS_FORCE_PATH_STYLE === 'true' } = options ?? {};
+    const baseUrl = options?.baseUrl ?? process.env.EDGE_STORE_BASE_URL ?? (endpoint ? `${endpoint}/${bucketName}` : `https://${bucketName}.s3.${region}.amazonaws.com`);
     const credentials = accessKeyId && secretAccessKey ? {
         accessKeyId,
         secretAccessKey
     } : undefined;
     const s3Client = new clientS3.S3Client({
         region,
-        credentials
+        credentials,
+        endpoint,
+        forcePathStyle
     });
     return {
         async init () {

package/dist/providers/aws/index.mjs

@@ -3,15 +3,17 @@ import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
 import { v4 } from 'uuid';
 
 function AWSProvider(options) {
-    const { accessKeyId = process.env.ES_AWS_ACCESS_KEY_ID, secretAccessKey = process.env.ES_AWS_SECRET_ACCESS_KEY, region = process.env.ES_AWS_REGION, bucketName = process.env.ES_AWS_BUCKET_NAME } = options ?? {};
-    const baseUrl = options?.baseUrl ?? process.env.EDGE_STORE_BASE_URL ?? `https://${bucketName}.s3.${region}.amazonaws.com`;
+    const { accessKeyId = process.env.ES_AWS_ACCESS_KEY_ID, secretAccessKey = process.env.ES_AWS_SECRET_ACCESS_KEY, region = process.env.ES_AWS_REGION, bucketName = process.env.ES_AWS_BUCKET_NAME, endpoint = process.env.ES_AWS_ENDPOINT, forcePathStyle = process.env.ES_AWS_FORCE_PATH_STYLE === 'true' } = options ?? {};
+    const baseUrl = options?.baseUrl ?? process.env.EDGE_STORE_BASE_URL ?? (endpoint ? `${endpoint}/${bucketName}` : `https://${bucketName}.s3.${region}.amazonaws.com`);
     const credentials = accessKeyId && secretAccessKey ? {
         accessKeyId,
         secretAccessKey
     } : undefined;
     const s3Client = new S3Client({
         region,
-        credentials
+        credentials,
+        endpoint,
+        forcePathStyle
     });
     return {
         async init () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edgestore/server",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Upload files with ease from React/Next.js",
   "homepage": "https://edgestore.dev",
   "repository": "https://github.com/edgestorejs/edgestore.git",
@@ -52,6 +52,11 @@
       "require": "./dist/adapters/next/app/index.js",
       "default": "./dist/adapters/next/app/index.js"
     },
+    "./adapters/start": {
+      "import": "./dist/adapters/start/index.mjs",
+      "require": "./dist/adapters/start/index.js",
+      "default": "./dist/adapters/start/index.js"
+    },
     "./providers/aws": {
       "import": "./dist/providers/aws/index.mjs",
       "require": "./dist/providers/aws/index.js",
@@ -84,7 +89,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@edgestore/shared": "0.3.1",
+    "@edgestore/shared": "0.3.3",
     "@panva/hkdf": "^1.0.4",
     "cookie": "^0.5.0",
     "jose": "^4.13.1",
@@ -123,5 +128,5 @@
     "typescript": "^5.1.6",
     "zod": "3.21.4"
   },
-  "gitHead": "26e3c5e08530d1b6b6363099ddf3062278673931"
+  "gitHead": "9bc2c36ee2463f79c26cb39cfc69dc77b7569a21"
 }

package/src/adapters/start/index.ts

@@ -0,0 +1,208 @@
+import {
+  EDGE_STORE_ERROR_CODES,
+  EdgeStoreError,
+  type EdgeStoreErrorCodeKey,
+  type EdgeStoreRouter,
+  type MaybePromise,
+  type Provider,
+} from '@edgestore/shared';
+import Logger, { type LogLevel } from '../../libs/logger';
+import { matchPath } from '../../libs/utils';
+import { EdgeStoreProvider } from '../../providers/edgestore';
+import {
+  completeMultipartUpload,
+  confirmUpload,
+  deleteFile,
+  init,
+  requestUpload,
+  requestUploadParts,
+  type CompleteMultipartUploadBody,
+  type ConfirmUploadBody,
+  type DeleteFileBody,
+  type RequestUploadBody,
+  type RequestUploadPartsParams,
+} from '../shared';
+
+export type CreateContextOptions = {
+  req: Request;
+};
+
+export type Config<TCtx> = {
+  provider?: Provider;
+  router: EdgeStoreRouter<TCtx>;
+  logLevel?: LogLevel;
+} & (TCtx extends Record<string, never>
+  ? object
+  : {
+      provider?: Provider;
+      router: EdgeStoreRouter<TCtx>;
+      createContext: (opts: CreateContextOptions) => MaybePromise<TCtx>;
+    });
+
+declare const globalThis: {
+  _EDGE_STORE_LOGGER: Logger;
+};
+
+// Helper to extract a cookie from the request's cookie header
+function getCookie(req: Request, cookieName: string): string | undefined {
+  const cookieHeader = req.headers.get('cookie');
+  if (!cookieHeader) return undefined;
+  return cookieHeader
+    .split(';')
+    .map((cookieStr) => cookieStr.trim())
+    .reduce((acc: Record<string, string>, cookieStr) => {
+      const [name, ...rest] = cookieStr.split('=');
+      if (name && rest.length > 0) {
+        acc[name] = rest.join('=');
+      }
+      return acc;
+    }, {})[cookieName];
+}
+
+export function createEdgeStoreStartHandler<TCtx>(config: Config<TCtx>) {
+  const { provider = EdgeStoreProvider() } = config;
+  const log = new Logger(config.logLevel);
+  globalThis._EDGE_STORE_LOGGER = log;
+  log.debug('Creating Edge Store TanStack Start handler');
+
+  return async ({ request }: { request: Request }) => {
+    try {
+      const { pathname } = new URL(request.url);
+      if (matchPath(pathname, '/health')) {
+        return new Response('OK', { status: 200 });
+      } else if (matchPath(pathname, '/init')) {
+        let ctx = {} as TCtx;
+        try {
+          ctx =
+            'createContext' in config
+              ? await config.createContext({ req: request })
+              : ({} as TCtx);
+        } catch (err) {
+          throw new EdgeStoreError({
+            message: 'Error creating context',
+            code: 'CREATE_CONTEXT_ERROR',
+            cause: err instanceof Error ? err : undefined,
+          });
+        }
+        const { newCookies, token, baseUrl } = await init({
+          ctx,
+          provider,
+          router: config.router,
+        });
+        const headers = new Headers();
+        newCookies.forEach((cookie) => headers.append('Set-Cookie', cookie));
+        headers.set('Content-Type', 'application/json');
+        return new Response(JSON.stringify({ token, baseUrl }), {
+          status: 200,
+          headers,
+        });
+      } else if (matchPath(pathname, '/request-upload')) {
+        const body = await request.json();
+        const ctxToken = getCookie(request, 'edgestore-ctx');
+        const result = await requestUpload({
+          provider,
+          router: config.router,
+          body: body as RequestUploadBody,
+          ctxToken,
+        });
+        return new Response(JSON.stringify(result), {
+          status: 200,
+          headers: { 'Content-Type': 'application/json' },
+        });
+      } else if (matchPath(pathname, '/request-upload-parts')) {
+        const body = await request.json();
+        const ctxToken = getCookie(request, 'edgestore-ctx');
+        const result = await requestUploadParts({
+          provider,
+          router: config.router,
+          body: body as RequestUploadPartsParams,
+          ctxToken,
+        });
+        return new Response(JSON.stringify(result), {
+          status: 200,
+          headers: { 'Content-Type': 'application/json' },
+        });
+      } else if (matchPath(pathname, '/complete-multipart-upload')) {
+        const body = await request.json();
+        const ctxToken = getCookie(request, 'edgestore-ctx');
+        await completeMultipartUpload({
+          provider,
+          router: config.router,
+          body: body as CompleteMultipartUploadBody,
+          ctxToken,
+        });
+        return new Response(null, { status: 200 });
+      } else if (matchPath(pathname, '/confirm-upload')) {
+        const body = await request.json();
+        const ctxToken = getCookie(request, 'edgestore-ctx');
+        const result = await confirmUpload({
+          provider,
+          router: config.router,
+          body: body as ConfirmUploadBody,
+          ctxToken,
+        });
+        return new Response(JSON.stringify(result), {
+          status: 200,
+          headers: { 'Content-Type': 'application/json' },
+        });
+      } else if (matchPath(pathname, '/delete-file')) {
+        const body = await request.json();
+        const ctxToken = getCookie(request, 'edgestore-ctx');
+        const result = await deleteFile({
+          provider,
+          router: config.router,
+          body: body as DeleteFileBody,
+          ctxToken,
+        });
+        return new Response(JSON.stringify(result), {
+          status: 200,
+          headers: { 'Content-Type': 'application/json' },
+        });
+      } else if (matchPath(pathname, '/proxy-file')) {
+        const urlParam = new URL(request.url).searchParams.get('url');
+        if (typeof urlParam === 'string') {
+          const proxyRes = await fetch(urlParam, {
+            headers: {
+              cookie: request.headers.get('cookie') ?? '',
+            },
+          });
+          const data = await proxyRes.arrayBuffer();
+          const headers = new Headers();
+          headers.set(
+            'Content-Type',
+            proxyRes.headers.get('Content-Type') ?? 'application/octet-stream',
+          );
+          return new Response(data, { status: proxyRes.status, headers });
+        } else {
+          return new Response(null, { status: 400 });
+        }
+      } else {
+        return new Response(null, { status: 404 });
+      }
+    } catch (err) {
+      if (err instanceof EdgeStoreError) {
+        log[err.level](err.formattedMessage());
+        if (err.cause) log[err.level](err.cause);
+        const status =
+          EDGE_STORE_ERROR_CODES[err.code as EdgeStoreErrorCodeKey] || 500;
+        return new Response(JSON.stringify(err.formattedJson()), {
+          status,
+          headers: { 'Content-Type': 'application/json' },
+        });
+      }
+      log.error(err);
+      return new Response(
+        JSON.stringify(
+          new EdgeStoreError({
+            message: 'Internal server error',
+            code: 'SERVER_ERROR',
+          }).formattedJson(),
+        ),
+        {
+          status: 500,
+          headers: { 'Content-Type': 'application/json' },
+        },
+      );
+    }
+  };
+}

package/src/providers/aws/index.ts

@@ -33,6 +33,17 @@ export type AWSProviderOptions = {
    * Can also be set via the `ES_AWS_BUCKET_NAME` environment variable.
    */
   bucketName?: string;
+  /**
+   * Custom endpoint for S3-compatible storage providers (e.g., MinIO).
+   * Can also be set via the `ES_AWS_ENDPOINT` environment variable.
+   */
+  endpoint?: string;
+  /**
+   * Force path style for S3-compatible storage providers.
+   * Can also be set via the `ES_AWS_FORCE_PATH_STYLE` environment variable.
+   * Defaults to false for AWS S3, but should be true for most S3-compatible providers.
+   */
+  forcePathStyle?: boolean;
   /**
    * Base URL to use for accessing files.
    * Only needed if you are using a custom domain or cloudfront.
@@ -55,12 +66,16 @@ export function AWSProvider(options?: AWSProviderOptions): Provider {
     secretAccessKey = process.env.ES_AWS_SECRET_ACCESS_KEY,
     region = process.env.ES_AWS_REGION,
     bucketName = process.env.ES_AWS_BUCKET_NAME,
+    endpoint = process.env.ES_AWS_ENDPOINT,
+    forcePathStyle = process.env.ES_AWS_FORCE_PATH_STYLE === 'true',
   } = options ?? {};
 
   const baseUrl =
     options?.baseUrl ??
     process.env.EDGE_STORE_BASE_URL ??
-    `https://${bucketName}.s3.${region}.amazonaws.com`;
+    (endpoint
+      ? `${endpoint}/${bucketName}`
+      : `https://${bucketName}.s3.${region}.amazonaws.com`);
 
   const credentials =
     accessKeyId && secretAccessKey
@@ -69,7 +84,12 @@ export function AWSProvider(options?: AWSProviderOptions): Provider {
           secretAccessKey,
         }
       : undefined;
-  const s3Client = new S3Client({ region, credentials });
+  const s3Client = new S3Client({
+    region,
+    credentials,
+    endpoint,
+    forcePathStyle,
+  });
 
   return {
     async init() {