@od-oneapp/storage 2026.1.1301

package/src/server-edge.ts

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview Server-side storage exports for Edge Runtime
+ *
+ * This file provides server-side storage functionality specifically for Edge Runtime environments.
+ * Uses Web APIs only - no Node.js APIs allowed.
+ *
+ * Only Vercel Blob provider is supported in edge runtime.
+ *
+ * @module @repo/storage/server/edge
+ */
+
+import { safeEnv } from '../env';
+import { VercelBlobProvider } from '../providers/vercel-blob';
+
+// Re-export edge-compatible types
+export type {
+  ListOptions,
+  StorageObject,
+  StorageProvider,
+  StorageProviderType,
+  UploadOptions,
+} from '../types';
+
+// Re-export environment utilities (edge-safe)
+export { safeEnv } from '../env';
+export { VercelBlobProvider };
+
+// Re-export key utilities
+export {
+  generateMultipleKeys,
+  generateStorageKey,
+  isKeyPattern,
+  normalizeStorageKey,
+  parseStorageKey,
+  sanitizeStorageKey,
+  validateStorageKey,
+  type KeyGenerationOptions,
+  type KeyPattern,
+} from '../keys';
+
+/**
+ * Edge-compatible storage factory
+ * Only supports Vercel Blob in edge runtime
+ *
+ * @param token - Vercel Blob token
+ * @returns Vercel Blob provider instance
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeStorageProvider } from '@repo/storage/server/edge';
+ *
+ * const storage = createEdgeStorageProvider(process.env.VERCEL_BLOB_READ_WRITE_TOKEN!);
+ * await storage.upload('file.jpg', fileData);
+ * ```
+ */
+export function createEdgeStorageProvider(token: string): VercelBlobProvider {
+  if (!token) {
+    throw new Error('VERCEL_BLOB_READ_WRITE_TOKEN is required for edge storage');
+  }
+
+  return new VercelBlobProvider(token);
+}
+
+/**
+ * Get edge storage provider from environment
+ *
+ * @returns Vercel Blob provider instance
+ *
+ * @example
+ * ```typescript
+ * import { getEdgeStorage } from '@repo/storage/server/edge';
+ *
+ * const storage = getEdgeStorage();
+ * await storage.upload('file.jpg', fileData);
+ * ```
+ */
+export function getEdgeStorage(): VercelBlobProvider {
+  const env = safeEnv();
+
+  if (!env.VERCEL_BLOB_READ_WRITE_TOKEN) {
+    throw new Error('VERCEL_BLOB_READ_WRITE_TOKEN is required for edge storage');
+  }
+
+  return new VercelBlobProvider(env.VERCEL_BLOB_READ_WRITE_TOKEN);
+}
+
+/**
+ * Edge storage helper functions
+ * Direct access to Vercel Blob methods
+ */
+import type { ListOptions, UploadOptions } from '../types';
+
+export const edgeStorage = {
+  delete: (key: string) => getEdgeStorage().delete(key),
+  download: (key: string) => getEdgeStorage().download(key),
+  exists: (key: string) => getEdgeStorage().exists(key),
+  getMetadata: (key: string) => getEdgeStorage().getMetadata(key),
+  getUrl: (key: string, options?: { expiresIn?: number }) => getEdgeStorage().getUrl(key, options),
+  list: (options?: ListOptions) => getEdgeStorage().list(options),
+  upload: (
+    key: string,
+    data: ArrayBuffer | Blob | Buffer | File | ReadableStream,
+    options?: UploadOptions,
+  ) => getEdgeStorage().upload(key, data, options),
+};
+
+/**
+ * Edge runtime limitations notice
+ *
+ * Edge Runtime has the following limitations:
+ * - Only Vercel Blob is supported (R2 requires Node.js APIs)
+ * - No file system access
+ * - Limited to Web APIs only
+ * - No multipart uploads (use Vercel Blob's built-in multipart)
+ * - No presigned URLs (use Vercel Blob's direct upload)
+ *
+ * For full functionality, use @repo/storage/server/next instead.
+ */
+export const EDGE_LIMITATIONS = {
+  supportedProviders: ['vercel-blob'] as const,
+  unsupportedFeatures: [
+    'Cloudflare R2 (requires Node.js APIs)',
+    'Cloudflare Images (requires Node.js APIs)',
+    'Custom multipart uploads (use Vercel Blob built-in)',
+    'Presigned URL generation (use Vercel Blob direct upload)',
+    'File system operations',
+  ],
+  recommendedAlternative: '@repo/storage/server/next',
+} as const;

package/src/server-next.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Server-side storage exports for Next.js
+ *
+ * This file provides server-side storage functionality specifically for Next.js applications.
+ * Includes server actions for file uploads and storage operations.
+ *
+ * @module @repo/storage/server/next
+ */
+
+// Re-export all server functionality
+export * from './server';
+
+// Export server actions
+export * from './actions';