@edgestore/server 0.2.1 → 0.3.0

package/adapters/start/index.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/adapters/start';

package/adapters/start/index.js

@@ -0,0 +1 @@
+module.exports = require('../../dist/adapters/start');

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/azure/index.d.ts

@@ -1,4 +1,17 @@
 import { type Provider } from '@edgestore/shared';
+/**
+ * Options for the Azure provider. Compatible with Azure Blob Storage and Azurite.
+ * Use Azure Storage Explorer for local development with Azurite.
+ * @see https://azure.microsoft.com/de-de/products/storage/storage-explorer
+ * @category Providers
+ * @example
+ *  AzureProvider({
+ *      storageAccountName: 'devstoreaccount1',
+ *      sasToken: 'some-generated-token-from-azure-storage-explorer',
+ *      containerName: 'some-container-name',
+ *      customBaseUrl: 'http://localhost:10000/devstoreaccount1',
+ *  })
+ */
 export type AzureProviderOptions = {
     /**
      * The storage account name for Azure Blob Storage
@@ -15,6 +28,12 @@ export type AzureProviderOptions = {
      * Can also be set via the `ES_AZURE_CONTAINER_NAME` environment variable.
      */
     containerName?: string;
+    /**
+     * Optional base URL for the Azure Blob Storage.
+     * Useful for local development with Azurite. For example: `http://localhost:10000/devstoreaccount1`
+     * Can also be set via the `ES_AZURE_BASE_URL` environment variable.
+     */
+    customBaseUrl?: string;
 };
 export declare function AzureProvider(options?: AzureProviderOptions): Provider;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/azure/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAkEtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/azure/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAoEtE"}

package/dist/providers/azure/index.js

@@ -6,8 +6,8 @@ var storageBlob = require('@azure/storage-blob');
 var uuid = require('uuid');
 
 function AzureProvider(options) {
-    const { storageAccountName = process.env.ES_AZURE_ACCOUNT_NAME, sasToken = process.env.ES_AZURE_SAS_TOKEN, containerName = process.env.ES_AZURE_CONTAINER_NAME } = options ?? {};
-    const baseUrl = `https://${storageAccountName}.blob.core.windows.net`;
+    const { storageAccountName = process.env.ES_AZURE_ACCOUNT_NAME, sasToken = process.env.ES_AZURE_SAS_TOKEN, containerName = process.env.ES_AZURE_CONTAINER_NAME, customBaseUrl = process.env.ES_AZURE_BASE_URL } = options ?? {};
+    const baseUrl = customBaseUrl ?? `https://${storageAccountName}.blob.core.windows.net`;
     const blobServiceClient = new storageBlob.BlobServiceClient(`${baseUrl}?${sasToken}`);
     const containerClient = blobServiceClient.getContainerClient(containerName ?? '');
     return {

package/dist/providers/azure/index.mjs

@@ -2,8 +2,8 @@ import { BlobServiceClient } from '@azure/storage-blob';
 import { v4 } from 'uuid';
 
 function AzureProvider(options) {
-    const { storageAccountName = process.env.ES_AZURE_ACCOUNT_NAME, sasToken = process.env.ES_AZURE_SAS_TOKEN, containerName = process.env.ES_AZURE_CONTAINER_NAME } = options ?? {};
-    const baseUrl = `https://${storageAccountName}.blob.core.windows.net`;
+    const { storageAccountName = process.env.ES_AZURE_ACCOUNT_NAME, sasToken = process.env.ES_AZURE_SAS_TOKEN, containerName = process.env.ES_AZURE_CONTAINER_NAME, customBaseUrl = process.env.ES_AZURE_BASE_URL } = options ?? {};
+    const baseUrl = customBaseUrl ?? `https://${storageAccountName}.blob.core.windows.net`;
     const blobServiceClient = new BlobServiceClient(`${baseUrl}?${sasToken}`);
     const containerClient = blobServiceClient.getContainerClient(containerName ?? '');
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edgestore/server",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "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.2.1",
+    "@edgestore/shared": "0.3.0",
     "@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": "821e2f3e366a83a75aa7b84d4750e6d3e32c992d"
+  "gitHead": "68417701e181eebb273a312b5f954fb65b325fe5"
 }

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/azure/index.ts

@@ -2,6 +2,19 @@ import { BlobServiceClient } from '@azure/storage-blob';
 import { type Provider } from '@edgestore/shared';
 import { v4 as uuidv4 } from 'uuid';
 
+/**
+ * Options for the Azure provider. Compatible with Azure Blob Storage and Azurite.
+ * Use Azure Storage Explorer for local development with Azurite.
+ * @see https://azure.microsoft.com/de-de/products/storage/storage-explorer
+ * @category Providers
+ * @example
+ *  AzureProvider({
+ *      storageAccountName: 'devstoreaccount1',
+ *      sasToken: 'some-generated-token-from-azure-storage-explorer',
+ *      containerName: 'some-container-name',
+ *      customBaseUrl: 'http://localhost:10000/devstoreaccount1',
+ *  })
+ */
 export type AzureProviderOptions = {
   /**
    * The storage account name for Azure Blob Storage
@@ -18,6 +31,12 @@ export type AzureProviderOptions = {
    * Can also be set via the `ES_AZURE_CONTAINER_NAME` environment variable.
    */
   containerName?: string;
+  /**
+   * Optional base URL for the Azure Blob Storage.
+   * Useful for local development with Azurite. For example: `http://localhost:10000/devstoreaccount1`
+   * Can also be set via the `ES_AZURE_BASE_URL` environment variable.
+   */
+  customBaseUrl?: string;
 };
 
 export function AzureProvider(options?: AzureProviderOptions): Provider {
@@ -25,9 +44,11 @@ export function AzureProvider(options?: AzureProviderOptions): Provider {
     storageAccountName = process.env.ES_AZURE_ACCOUNT_NAME,
     sasToken = process.env.ES_AZURE_SAS_TOKEN,
     containerName = process.env.ES_AZURE_CONTAINER_NAME,
+    customBaseUrl = process.env.ES_AZURE_BASE_URL,
   } = options ?? {};
 
-  const baseUrl = `https://${storageAccountName}.blob.core.windows.net`;
+  const baseUrl =
+    customBaseUrl ?? `https://${storageAccountName}.blob.core.windows.net`;
   const blobServiceClient = new BlobServiceClient(`${baseUrl}?${sasToken}`);
   const containerClient = blobServiceClient.getContainerClient(
     containerName ?? '',