@wrelik/storage 0.2.0 → 2.0.0

package/.turbo/turbo-build.log

@@ -1,26 +1,27 @@
 
-> @wrelik/storage@0.2.0 build /home/runner/work/wrelik-kit/wrelik-kit/packages/storage
-> tsup src/index.ts src/react-native.ts --format cjs,esm --dts --clean
+> @wrelik/storage@2.0.0 build /home/runner/work/wrelik-kit/wrelik-kit/packages/storage
+> tsup src/server/index.ts src/client/index.ts src/shared/index.ts --format cjs,esm --dts --clean
 
-CLI Building entry: src/index.ts, src/react-native.ts
+CLI Building entry: src/client/index.ts, src/server/index.ts, src/shared/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.1
 CLI Target: es2022
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/index.mjs          1.46 KB
-ESM dist/react-native.mjs   701.00 B
-ESM dist/chunk-6VKCOC6I.mjs 421.00 B
-ESM ⚡️ Build success in 61ms
-CJS dist/index.js        3.10 KB
-CJS dist/react-native.js 2.17 KB
-CJS ⚡️ Build success in 63ms
+CJS dist/server/index.js 4.13 KB
+CJS dist/shared/index.js 1.44 KB
+CJS dist/client/index.js 1.67 KB
+CJS ⚡️ Build success in 82ms
+ESM dist/client/index.mjs 625.00 B
+ESM dist/server/index.mjs 2.86 KB
+ESM dist/shared/index.mjs 433.00 B
+ESM ⚡️ Build success in 82ms
 DTS Build start
-DTS ⚡️ Build success in 4031ms
-DTS dist/index.d.ts            815.00 B
-DTS dist/react-native.d.ts     457.00 B
-DTS dist/shared-DqbBUqiW.d.ts  201.00 B
-DTS dist/index.d.mts           816.00 B
-DTS dist/react-native.d.mts    458.00 B
-DTS dist/shared-DqbBUqiW.d.mts 201.00 B
+DTS ⚡️ Build success in 6479ms
+DTS dist/client/index.d.ts  337.00 B
+DTS dist/server/index.d.ts  1.99 KB
+DTS dist/shared/index.d.ts  193.00 B
+DTS dist/client/index.d.mts 337.00 B
+DTS dist/server/index.d.mts 1.99 KB
+DTS dist/shared/index.d.mts 193.00 B

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @wrelik/storage
 
+## 2.0.0
+
+### Major Changes
+
+- 818ed58: Refactor runtime packages to strict subpath exports (`/server`, `/client`, `/shared`) with side-effect free entrypoints and hard CI/runtime boundary enforcement.
+
+### Minor Changes
+
+- Add platform wrapper packages for Clerk (Next/Expo), Next Sentry client instrumentation, and Upstash server SDK access so apps can avoid direct vendor imports while staying inside the `@wrelik/*` boundary.
+
+  Add temporary deprecated server-side compatibility singleton exports to analytics, email, jobs, and storage to support DRX migration from root-import convenience APIs to runtime subpaths in one cutover.
+
+### Patch Changes
+
+- Updated dependencies [818ed58]
+  - @wrelik/errors@2.0.0
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [2b9cbf7]
+  - @wrelik/errors@0.2.1
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/{react-native.d.ts → client/index.d.mts}

@@ -1,14 +1,11 @@
-import * as node_buffer from 'node:buffer';
-export { v as validateUpload } from './shared-DqbBUqiW.js';
-
 declare function uploadToSignedUrl({ url, file, contentType, headers, }: {
     url: string;
     file: File | Blob;
     contentType: string;
     headers?: Record<string, string>;
-}): Promise<boolean>;
+}): Promise<true>;
 declare function downloadFromSignedUrl({ url }: {
     url: string;
-}): Promise<node_buffer.Blob>;
+}): Promise<Blob>;
 
 export { downloadFromSignedUrl, uploadToSignedUrl };

package/dist/{react-native.d.mts → client/index.d.ts}

@@ -1,14 +1,11 @@
-import * as node_buffer from 'node:buffer';
-export { v as validateUpload } from './shared-DqbBUqiW.mjs';
-
 declare function uploadToSignedUrl({ url, file, contentType, headers, }: {
     url: string;
     file: File | Blob;
     contentType: string;
     headers?: Record<string, string>;
-}): Promise<boolean>;
+}): Promise<true>;
 declare function downloadFromSignedUrl({ url }: {
     url: string;
-}): Promise<node_buffer.Blob>;
+}): Promise<Blob>;
 
 export { downloadFromSignedUrl, uploadToSignedUrl };

package/dist/{react-native.js → client/index.js}

@@ -17,28 +17,13 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/react-native.ts
-var react_native_exports = {};
-__export(react_native_exports, {
+// src/client/index.ts
+var client_exports = {};
+__export(client_exports, {
   downloadFromSignedUrl: () => downloadFromSignedUrl,
-  uploadToSignedUrl: () => uploadToSignedUrl,
-  validateUpload: () => validateUpload
+  uploadToSignedUrl: () => uploadToSignedUrl
 });
-module.exports = __toCommonJS(react_native_exports);
-
-// src/shared.ts
-var import_errors = require("@wrelik/errors");
-function validateUpload(file, policy) {
-  if (file.sizeBytes > policy.maxSizeBytes) {
-    throw new import_errors.ValidationError(`File too large. Max ${policy.maxSizeBytes} bytes.`);
-  }
-  if (!policy.allowedTypes.includes(file.contentType)) {
-    throw new import_errors.ValidationError(`Invalid file type ${file.contentType}`);
-  }
-  return true;
-}
-
-// src/react-native.ts
+module.exports = __toCommonJS(client_exports);
 async function uploadToSignedUrl({
   url,
   file,
@@ -68,6 +53,5 @@ async function downloadFromSignedUrl({ url }) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   downloadFromSignedUrl,
-  uploadToSignedUrl,
-  validateUpload
+  uploadToSignedUrl
 });

package/dist/{react-native.mjs → client/index.mjs}

@@ -1,8 +1,4 @@
-import {
-  validateUpload
-} from "./chunk-6VKCOC6I.mjs";
-
-// src/react-native.ts
+// src/client/index.ts
 async function uploadToSignedUrl({
   url,
   file,
@@ -31,6 +27,5 @@ async function downloadFromSignedUrl({ url }) {
 }
 export {
   downloadFromSignedUrl,
-  uploadToSignedUrl,
-  validateUpload
+  uploadToSignedUrl
 };

package/dist/server/index.d.mts

@@ -0,0 +1,39 @@
+interface StorageConfig {
+    accountId: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucketName: string;
+    region?: string;
+}
+interface StorageServer {
+    putObject: (body: Buffer | Uint8Array | Blob | string, key: string, contentType: string, metadata?: Record<string, string>) => Promise<unknown>;
+    getSignedUploadUrl: (key: string, contentType: string, expiresIn?: number) => Promise<string>;
+    getSignedDownloadUrl: (key: string, expiresIn?: number) => Promise<string>;
+}
+interface StorageServerDependencies {
+    client?: {
+        send: (command: unknown) => Promise<unknown>;
+    };
+    signUrl?: (client: unknown, command: unknown, options: {
+        expiresIn: number;
+    }) => Promise<string>;
+}
+declare function createStorageServer(config: StorageConfig, deps?: StorageServerDependencies): StorageServer;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...) and explicit dependency wiring.
+ */
+declare function initStorage(config: StorageConfig, deps?: StorageServerDependencies): void;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).putObject(...)
+ */
+declare function putObject(body: Parameters<StorageServer['putObject']>[0], key: string, contentType: string, metadata?: Record<string, string>): ReturnType<StorageServer['putObject']>;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).getSignedUploadUrl(...)
+ */
+declare function getSignedUploadUrl(key: string, contentType: string, expiresIn?: number): ReturnType<StorageServer['getSignedUploadUrl']>;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).getSignedDownloadUrl(...)
+ */
+declare function getSignedDownloadUrl(key: string, expiresIn?: number): ReturnType<StorageServer['getSignedDownloadUrl']>;
+
+export { type StorageConfig, type StorageServer, type StorageServerDependencies, createStorageServer, getSignedDownloadUrl, getSignedUploadUrl, initStorage, putObject };

package/dist/server/index.d.ts

@@ -0,0 +1,39 @@
+interface StorageConfig {
+    accountId: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucketName: string;
+    region?: string;
+}
+interface StorageServer {
+    putObject: (body: Buffer | Uint8Array | Blob | string, key: string, contentType: string, metadata?: Record<string, string>) => Promise<unknown>;
+    getSignedUploadUrl: (key: string, contentType: string, expiresIn?: number) => Promise<string>;
+    getSignedDownloadUrl: (key: string, expiresIn?: number) => Promise<string>;
+}
+interface StorageServerDependencies {
+    client?: {
+        send: (command: unknown) => Promise<unknown>;
+    };
+    signUrl?: (client: unknown, command: unknown, options: {
+        expiresIn: number;
+    }) => Promise<string>;
+}
+declare function createStorageServer(config: StorageConfig, deps?: StorageServerDependencies): StorageServer;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...) and explicit dependency wiring.
+ */
+declare function initStorage(config: StorageConfig, deps?: StorageServerDependencies): void;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).putObject(...)
+ */
+declare function putObject(body: Parameters<StorageServer['putObject']>[0], key: string, contentType: string, metadata?: Record<string, string>): ReturnType<StorageServer['putObject']>;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).getSignedUploadUrl(...)
+ */
+declare function getSignedUploadUrl(key: string, contentType: string, expiresIn?: number): ReturnType<StorageServer['getSignedUploadUrl']>;
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).getSignedDownloadUrl(...)
+ */
+declare function getSignedDownloadUrl(key: string, expiresIn?: number): ReturnType<StorageServer['getSignedDownloadUrl']>;
+
+export { type StorageConfig, type StorageServer, type StorageServerDependencies, createStorageServer, getSignedDownloadUrl, getSignedUploadUrl, initStorage, putObject };

package/dist/server/index.js

@@ -0,0 +1,118 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  createStorageServer: () => createStorageServer,
+  getSignedDownloadUrl: () => getSignedDownloadUrl,
+  getSignedUploadUrl: () => getSignedUploadUrl,
+  initStorage: () => initStorage,
+  putObject: () => putObject
+});
+module.exports = __toCommonJS(server_exports);
+var import_client_s3 = require("@aws-sdk/client-s3");
+var import_s3_request_presigner = require("@aws-sdk/s3-request-presigner");
+var import_shared = require("@wrelik/errors/shared");
+function assertNonEmpty(value, field) {
+  if (!value?.trim()) {
+    throw new import_shared.ValidationError(`${field} is required`);
+  }
+}
+function assertExpiresIn(expiresIn) {
+  if (!Number.isInteger(expiresIn) || expiresIn <= 0) {
+    throw new import_shared.ValidationError("expiresIn must be a positive integer");
+  }
+}
+function createStorageServer(config, deps) {
+  const endpoint = `https://${config.accountId}.r2.cloudflarestorage.com`;
+  const client = deps?.client ?? new import_client_s3.S3Client({
+    region: config.region ?? "auto",
+    endpoint,
+    credentials: {
+      accessKeyId: config.accessKeyId,
+      secretAccessKey: config.secretAccessKey
+    }
+  });
+  const signUrl = deps?.signUrl ?? ((client2, command, options) => (0, import_s3_request_presigner.getSignedUrl)(client2, command, options));
+  return {
+    putObject(body, key, contentType, metadata) {
+      assertNonEmpty(key, "key");
+      assertNonEmpty(contentType, "contentType");
+      return client.send(
+        new import_client_s3.PutObjectCommand({
+          Bucket: config.bucketName,
+          Key: key,
+          Body: body,
+          ContentType: contentType,
+          Metadata: metadata
+        })
+      );
+    },
+    getSignedUploadUrl(key, contentType, expiresIn = 3600) {
+      assertNonEmpty(key, "key");
+      assertNonEmpty(contentType, "contentType");
+      assertExpiresIn(expiresIn);
+      const command = new import_client_s3.PutObjectCommand({
+        Bucket: config.bucketName,
+        Key: key,
+        ContentType: contentType
+      });
+      return signUrl(client, command, { expiresIn });
+    },
+    getSignedDownloadUrl(key, expiresIn = 3600) {
+      assertNonEmpty(key, "key");
+      assertExpiresIn(expiresIn);
+      const command = new import_client_s3.GetObjectCommand({
+        Bucket: config.bucketName,
+        Key: key
+      });
+      return signUrl(client, command, { expiresIn });
+    }
+  };
+}
+var storageSingleton = null;
+function requireStorageSingleton() {
+  if (!storageSingleton) {
+    throw new Error(
+      "@wrelik/storage/server compatibility API is not initialized. Call initStorage(config) before putObject/getSignedUploadUrl/getSignedDownloadUrl."
+    );
+  }
+  return storageSingleton;
+}
+function initStorage(config, deps) {
+  storageSingleton = createStorageServer(config, deps);
+}
+function putObject(body, key, contentType, metadata) {
+  return requireStorageSingleton().putObject(body, key, contentType, metadata);
+}
+function getSignedUploadUrl(key, contentType, expiresIn) {
+  return requireStorageSingleton().getSignedUploadUrl(key, contentType, expiresIn);
+}
+function getSignedDownloadUrl(key, expiresIn) {
+  return requireStorageSingleton().getSignedDownloadUrl(key, expiresIn);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createStorageServer,
+  getSignedDownloadUrl,
+  getSignedUploadUrl,
+  initStorage,
+  putObject
+});

package/dist/server/index.mjs

@@ -0,0 +1,89 @@
+// src/server/index.ts
+import { GetObjectCommand, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+import { ValidationError } from "@wrelik/errors/shared";
+function assertNonEmpty(value, field) {
+  if (!value?.trim()) {
+    throw new ValidationError(`${field} is required`);
+  }
+}
+function assertExpiresIn(expiresIn) {
+  if (!Number.isInteger(expiresIn) || expiresIn <= 0) {
+    throw new ValidationError("expiresIn must be a positive integer");
+  }
+}
+function createStorageServer(config, deps) {
+  const endpoint = `https://${config.accountId}.r2.cloudflarestorage.com`;
+  const client = deps?.client ?? new S3Client({
+    region: config.region ?? "auto",
+    endpoint,
+    credentials: {
+      accessKeyId: config.accessKeyId,
+      secretAccessKey: config.secretAccessKey
+    }
+  });
+  const signUrl = deps?.signUrl ?? ((client2, command, options) => getSignedUrl(client2, command, options));
+  return {
+    putObject(body, key, contentType, metadata) {
+      assertNonEmpty(key, "key");
+      assertNonEmpty(contentType, "contentType");
+      return client.send(
+        new PutObjectCommand({
+          Bucket: config.bucketName,
+          Key: key,
+          Body: body,
+          ContentType: contentType,
+          Metadata: metadata
+        })
+      );
+    },
+    getSignedUploadUrl(key, contentType, expiresIn = 3600) {
+      assertNonEmpty(key, "key");
+      assertNonEmpty(contentType, "contentType");
+      assertExpiresIn(expiresIn);
+      const command = new PutObjectCommand({
+        Bucket: config.bucketName,
+        Key: key,
+        ContentType: contentType
+      });
+      return signUrl(client, command, { expiresIn });
+    },
+    getSignedDownloadUrl(key, expiresIn = 3600) {
+      assertNonEmpty(key, "key");
+      assertExpiresIn(expiresIn);
+      const command = new GetObjectCommand({
+        Bucket: config.bucketName,
+        Key: key
+      });
+      return signUrl(client, command, { expiresIn });
+    }
+  };
+}
+var storageSingleton = null;
+function requireStorageSingleton() {
+  if (!storageSingleton) {
+    throw new Error(
+      "@wrelik/storage/server compatibility API is not initialized. Call initStorage(config) before putObject/getSignedUploadUrl/getSignedDownloadUrl."
+    );
+  }
+  return storageSingleton;
+}
+function initStorage(config, deps) {
+  storageSingleton = createStorageServer(config, deps);
+}
+function putObject(body, key, contentType, metadata) {
+  return requireStorageSingleton().putObject(body, key, contentType, metadata);
+}
+function getSignedUploadUrl(key, contentType, expiresIn) {
+  return requireStorageSingleton().getSignedUploadUrl(key, contentType, expiresIn);
+}
+function getSignedDownloadUrl(key, expiresIn) {
+  return requireStorageSingleton().getSignedDownloadUrl(key, expiresIn);
+}
+export {
+  createStorageServer,
+  getSignedDownloadUrl,
+  getSignedUploadUrl,
+  initStorage,
+  putObject
+};

package/dist/{shared-DqbBUqiW.d.mts → shared/index.d.mts}

@@ -4,6 +4,6 @@ declare function validateUpload(file: {
 }, policy: {
     maxSizeBytes: number;
     allowedTypes: string[];
-}): boolean;
+}): true;
 
-export { validateUpload as v };
+export { validateUpload };

package/dist/{shared-DqbBUqiW.d.ts → shared/index.d.ts}

@@ -4,6 +4,6 @@ declare function validateUpload(file: {
 }, policy: {
     maxSizeBytes: number;
     allowedTypes: string[];
-}): boolean;
+}): true;
 
-export { validateUpload as v };
+export { validateUpload };

package/dist/shared/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/shared/index.ts
+var shared_exports = {};
+__export(shared_exports, {
+  validateUpload: () => validateUpload
+});
+module.exports = __toCommonJS(shared_exports);
+var import_shared = require("@wrelik/errors/shared");
+function validateUpload(file, policy) {
+  if (file.sizeBytes > policy.maxSizeBytes) {
+    throw new import_shared.ValidationError(`File too large. Max ${policy.maxSizeBytes} bytes.`);
+  }
+  if (!policy.allowedTypes.includes(file.contentType)) {
+    throw new import_shared.ValidationError(`Invalid file type ${file.contentType}`);
+  }
+  return true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateUpload
+});

package/dist/{chunk-6VKCOC6I.mjs → shared/index.mjs}

@@ -1,5 +1,5 @@
-// src/shared.ts
-import { ValidationError } from "@wrelik/errors";
+// src/shared/index.ts
+import { ValidationError } from "@wrelik/errors/shared";
 function validateUpload(file, policy) {
   if (file.sizeBytes > policy.maxSizeBytes) {
     throw new ValidationError(`File too large. Max ${policy.maxSizeBytes} bytes.`);
@@ -9,7 +9,6 @@ function validateUpload(file, policy) {
   }
   return true;
 }
-
 export {
   validateUpload
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrelik/storage",
-  "version": "0.2.0",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -9,25 +9,48 @@
     "url": "https://github.com/lwhite702/wrelik-kit.git",
     "directory": "packages/storage"
   },
+  "sideEffects": false,
   "exports": {
-    ".": "./dist/index.js",
-    "./react-native": "./dist/react-native.js"
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "import": "./dist/shared/index.mjs",
+      "require": "./dist/shared/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.500.0",
     "@aws-sdk/s3-request-presigner": "^3.500.0",
-    "@wrelik/errors": "0.2.0"
+    "@wrelik/errors": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.2.0",
     "tsup": "^8.0.1",
     "vitest": "^1.2.2",
-    "@wrelik/eslint-config": "0.1.1",
-    "@wrelik/tsconfig": "0.1.1"
+    "@wrelik/tsconfig": "0.1.1",
+    "@wrelik/eslint-config": "0.1.1"
+  },
+  "wrelik": {
+    "runtimes": [
+      "server",
+      "client",
+      "shared"
+    ]
   },
   "scripts": {
-    "build": "tsup src/index.ts src/react-native.ts --format cjs,esm --dts --clean",
+    "build": "tsup src/server/index.ts src/client/index.ts src/shared/index.ts --format cjs,esm --dts --clean",
     "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run --passWithNoTests"
   }
 }

package/src/{react-native.ts → client/index.ts}

@@ -1,5 +1,3 @@
-export * from './shared';
-
 export async function uploadToSignedUrl({
   url,
   file,
@@ -10,7 +8,7 @@ export async function uploadToSignedUrl({
   file: File | Blob;
   contentType: string;
   headers?: Record<string, string>;
-}) {
+}): Promise<true> {
   const result = await fetch(url, {
     method: 'PUT',
     body: file,
@@ -27,10 +25,11 @@ export async function uploadToSignedUrl({
   return true;
 }
 
-export async function downloadFromSignedUrl({ url }: { url: string }) {
+export async function downloadFromSignedUrl({ url }: { url: string }): Promise<Blob> {
   const result = await fetch(url);
   if (!result.ok) {
     throw new Error(`Download failed with status ${result.status}`);
   }
+
   return result.blob();
 }

package/src/server/index.test.ts

@@ -0,0 +1,71 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { ValidationError } from '@wrelik/errors/shared';
+import { createStorageServer } from './index';
+
+const config = {
+  accountId: 'acct',
+  accessKeyId: 'key',
+  secretAccessKey: 'secret',
+  bucketName: 'bucket',
+};
+
+afterEach(() => {
+  vi.resetModules();
+  vi.clearAllMocks();
+});
+
+describe('@wrelik/storage/server', () => {
+  it('generates signed URL shapes with configured signer', async () => {
+    const signUrl = vi.fn(async (_client, command, options: { expiresIn: number }) => {
+      const input = (command as { input: { Key: string } }).input;
+      return `https://signed.example/${input.Key}?expiresIn=${options.expiresIn}`;
+    });
+
+    const storage = createStorageServer(config, {
+      client: { send: vi.fn() },
+      signUrl,
+    });
+
+    await expect(storage.getSignedUploadUrl('uploads/a.png', 'image/png', 60)).resolves.toBe(
+      'https://signed.example/uploads/a.png?expiresIn=60',
+    );
+    await expect(storage.getSignedDownloadUrl('uploads/a.png', 120)).resolves.toBe(
+      'https://signed.example/uploads/a.png?expiresIn=120',
+    );
+  });
+
+  it('validates signed URL input rules', async () => {
+    const storage = createStorageServer(config, {
+      client: { send: vi.fn() },
+      signUrl: vi.fn(async () => 'https://signed.example/ok'),
+    });
+
+    expect(() => storage.getSignedUploadUrl('', 'image/png')).toThrow(ValidationError);
+    expect(() => storage.getSignedUploadUrl('a.png', '', 60)).toThrow(ValidationError);
+    expect(() => storage.getSignedDownloadUrl('a.png', 0)).toThrow(/positive integer/);
+  });
+
+  it('compatibility singleton throws before initStorage', async () => {
+    const mod = await import('./index.js');
+    expect(() => mod.getSignedDownloadUrl('uploads/a.png', 60)).toThrow(/initStorage/i);
+  });
+
+  it('compatibility singleton delegates after initStorage', async () => {
+    const send = vi.fn(async () => ({ etag: 'etag_1' }));
+    const signUrl = vi.fn(async (_client, command, options: { expiresIn: number }) => {
+      const input = (command as { input: { Key: string } }).input;
+      return `https://signed.example/${input.Key}?expiresIn=${options.expiresIn}`;
+    });
+    const mod = await import('./index.js');
+
+    mod.initStorage(config, { client: { send }, signUrl });
+
+    await mod.putObject('body', 'uploads/a.png', 'image/png');
+    await expect(mod.getSignedUploadUrl('uploads/a.png', 'image/png', 30)).resolves.toBe(
+      'https://signed.example/uploads/a.png?expiresIn=30',
+    );
+
+    expect(send).toHaveBeenCalledTimes(1);
+    expect(signUrl).toHaveBeenCalledTimes(1);
+  });
+});

package/src/server/index.ts

@@ -0,0 +1,147 @@
+/* eslint-disable no-restricted-imports */
+import { GetObjectCommand, PutObjectCommand, S3Client } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { ValidationError } from '@wrelik/errors/shared';
+
+export interface StorageConfig {
+  accountId: string;
+  accessKeyId: string;
+  secretAccessKey: string;
+  bucketName: string;
+  region?: string;
+}
+
+export interface StorageServer {
+  putObject: (
+    body: Buffer | Uint8Array | Blob | string,
+    key: string,
+    contentType: string,
+    metadata?: Record<string, string>,
+  ) => Promise<unknown>;
+  getSignedUploadUrl: (key: string, contentType: string, expiresIn?: number) => Promise<string>;
+  getSignedDownloadUrl: (key: string, expiresIn?: number) => Promise<string>;
+}
+
+export interface StorageServerDependencies {
+  client?: {
+    send: (command: unknown) => Promise<unknown>;
+  };
+  signUrl?: (client: unknown, command: unknown, options: { expiresIn: number }) => Promise<string>;
+}
+
+function assertNonEmpty(value: string, field: string): void {
+  if (!value?.trim()) {
+    throw new ValidationError(`${field} is required`);
+  }
+}
+
+function assertExpiresIn(expiresIn: number): void {
+  if (!Number.isInteger(expiresIn) || expiresIn <= 0) {
+    throw new ValidationError('expiresIn must be a positive integer');
+  }
+}
+
+export function createStorageServer(config: StorageConfig, deps?: StorageServerDependencies): StorageServer {
+  const endpoint = `https://${config.accountId}.r2.cloudflarestorage.com`;
+  const client =
+    deps?.client ??
+    new S3Client({
+      region: config.region ?? 'auto',
+      endpoint,
+      credentials: {
+        accessKeyId: config.accessKeyId,
+        secretAccessKey: config.secretAccessKey,
+      },
+    });
+  const signUrl =
+    deps?.signUrl ??
+    ((client: unknown, command: unknown, options: { expiresIn: number }) =>
+      getSignedUrl(client as S3Client, command as PutObjectCommand | GetObjectCommand, options));
+
+  return {
+    putObject(body, key, contentType, metadata) {
+      assertNonEmpty(key, 'key');
+      assertNonEmpty(contentType, 'contentType');
+      return client.send(
+        new PutObjectCommand({
+          Bucket: config.bucketName,
+          Key: key,
+          Body: body,
+          ContentType: contentType,
+          Metadata: metadata,
+        }),
+      );
+    },
+
+    getSignedUploadUrl(key, contentType, expiresIn = 3600) {
+      assertNonEmpty(key, 'key');
+      assertNonEmpty(contentType, 'contentType');
+      assertExpiresIn(expiresIn);
+      const command = new PutObjectCommand({
+        Bucket: config.bucketName,
+        Key: key,
+        ContentType: contentType,
+      });
+      return signUrl(client, command, { expiresIn });
+    },
+
+    getSignedDownloadUrl(key, expiresIn = 3600) {
+      assertNonEmpty(key, 'key');
+      assertExpiresIn(expiresIn);
+      const command = new GetObjectCommand({
+        Bucket: config.bucketName,
+        Key: key,
+      });
+      return signUrl(client, command, { expiresIn });
+    },
+  };
+}
+
+let storageSingleton: StorageServer | null = null;
+
+function requireStorageSingleton(): StorageServer {
+  if (!storageSingleton) {
+    throw new Error(
+      '@wrelik/storage/server compatibility API is not initialized. Call initStorage(config) before putObject/getSignedUploadUrl/getSignedDownloadUrl.',
+    );
+  }
+
+  return storageSingleton;
+}
+
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...) and explicit dependency wiring.
+ */
+export function initStorage(config: StorageConfig, deps?: StorageServerDependencies): void {
+  storageSingleton = createStorageServer(config, deps);
+}
+
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).putObject(...)
+ */
+export function putObject(
+  body: Parameters<StorageServer['putObject']>[0],
+  key: string,
+  contentType: string,
+  metadata?: Record<string, string>,
+): ReturnType<StorageServer['putObject']> {
+  return requireStorageSingleton().putObject(body, key, contentType, metadata);
+}
+
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).getSignedUploadUrl(...)
+ */
+export function getSignedUploadUrl(
+  key: string,
+  contentType: string,
+  expiresIn?: number,
+): ReturnType<StorageServer['getSignedUploadUrl']> {
+  return requireStorageSingleton().getSignedUploadUrl(key, contentType, expiresIn);
+}
+
+/**
+ * @deprecated Temporary DRX compatibility singleton. Prefer createStorageServer(...).getSignedDownloadUrl(...)
+ */
+export function getSignedDownloadUrl(key: string, expiresIn?: number): ReturnType<StorageServer['getSignedDownloadUrl']> {
+  return requireStorageSingleton().getSignedDownloadUrl(key, expiresIn);
+}

package/src/{shared.test.ts → shared/index.test.ts}

@@ -1,12 +1,11 @@
-import { describe, it, expect } from 'vitest';
-import { validateUpload } from './shared';
+import { describe, expect, it } from 'vitest';
+import { validateUpload } from './index';
 
-describe('Storage Shared', () => {
+describe('@wrelik/storage/shared', () => {
   it('validates upload policy', () => {
     const policy = { maxSizeBytes: 100, allowedTypes: ['image/png'] };
 
     expect(() => validateUpload({ contentType: 'image/png', sizeBytes: 50 }, policy)).not.toThrow();
-
     expect(() => validateUpload({ contentType: 'image/jpeg', sizeBytes: 50 }, policy)).toThrow(
       /Invalid file type/,
     );

package/src/{shared.ts → shared/index.ts}

@@ -1,14 +1,16 @@
-import { ValidationError } from '@wrelik/errors';
+import { ValidationError } from '@wrelik/errors/shared';
 
 export function validateUpload(
   file: { contentType: string; sizeBytes: number },
   policy: { maxSizeBytes: number; allowedTypes: string[] },
-) {
+): true {
   if (file.sizeBytes > policy.maxSizeBytes) {
     throw new ValidationError(`File too large. Max ${policy.maxSizeBytes} bytes.`);
   }
+
   if (!policy.allowedTypes.includes(file.contentType)) {
     throw new ValidationError(`Invalid file type ${file.contentType}`);
   }
+
   return true;
 }

package/tsconfig.json

@@ -1,7 +1,9 @@
 {
   "extends": "@wrelik/tsconfig/node.json",
   "compilerOptions": {
-    "outDir": "dist", "skipLibCheck": true
+    "outDir": "dist",
+    "skipLibCheck": true,
+    "lib": ["DOM", "DOM.Iterable", "ES2022"]
   },
   "include": ["src"]
 }

package/dist/index.d.mts

@@ -1,16 +0,0 @@
-import * as _aws_sdk_client_s3 from '@aws-sdk/client-s3';
-export { v as validateUpload } from './shared-DqbBUqiW.mjs';
-
-interface StorageConfig {
-    accountId: string;
-    accessKeyId: string;
-    secretAccessKey: string;
-    bucketName: string;
-    region?: string;
-}
-declare function initStorage(config: StorageConfig): void;
-declare function putObject(body: Buffer | Uint8Array | Blob | string, key: string, contentType: string, metadata?: Record<string, string>): Promise<_aws_sdk_client_s3.PutObjectCommandOutput>;
-declare function getSignedUploadUrl(key: string, contentType: string, expiresIn?: number): Promise<string>;
-declare function getSignedDownloadUrl(key: string, expiresIn?: number): Promise<string>;
-
-export { type StorageConfig, getSignedDownloadUrl, getSignedUploadUrl, initStorage, putObject };

package/dist/index.d.ts

@@ -1,16 +0,0 @@
-import * as _aws_sdk_client_s3 from '@aws-sdk/client-s3';
-export { v as validateUpload } from './shared-DqbBUqiW.js';
-
-interface StorageConfig {
-    accountId: string;
-    accessKeyId: string;
-    secretAccessKey: string;
-    bucketName: string;
-    region?: string;
-}
-declare function initStorage(config: StorageConfig): void;
-declare function putObject(body: Buffer | Uint8Array | Blob | string, key: string, contentType: string, metadata?: Record<string, string>): Promise<_aws_sdk_client_s3.PutObjectCommandOutput>;
-declare function getSignedUploadUrl(key: string, contentType: string, expiresIn?: number): Promise<string>;
-declare function getSignedDownloadUrl(key: string, expiresIn?: number): Promise<string>;
-
-export { type StorageConfig, getSignedDownloadUrl, getSignedUploadUrl, initStorage, putObject };

package/dist/index.js

@@ -1,96 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  getSignedDownloadUrl: () => getSignedDownloadUrl,
-  getSignedUploadUrl: () => getSignedUploadUrl,
-  initStorage: () => initStorage,
-  putObject: () => putObject,
-  validateUpload: () => validateUpload
-});
-module.exports = __toCommonJS(index_exports);
-var import_client_s3 = require("@aws-sdk/client-s3");
-var import_s3_request_presigner = require("@aws-sdk/s3-request-presigner");
-
-// src/shared.ts
-var import_errors = require("@wrelik/errors");
-function validateUpload(file, policy) {
-  if (file.sizeBytes > policy.maxSizeBytes) {
-    throw new import_errors.ValidationError(`File too large. Max ${policy.maxSizeBytes} bytes.`);
-  }
-  if (!policy.allowedTypes.includes(file.contentType)) {
-    throw new import_errors.ValidationError(`Invalid file type ${file.contentType}`);
-  }
-  return true;
-}
-
-// src/index.ts
-var client;
-var bucket;
-function initStorage(config) {
-  const endpoint = `https://${config.accountId}.r2.cloudflarestorage.com`;
-  client = new import_client_s3.S3Client({
-    region: config.region || "auto",
-    endpoint,
-    credentials: {
-      accessKeyId: config.accessKeyId,
-      secretAccessKey: config.secretAccessKey
-    }
-  });
-  bucket = config.bucketName;
-}
-function getClient() {
-  if (!client) throw new Error("Storage not initialized. Call initStorage first.");
-  return client;
-}
-async function putObject(body, key, contentType, metadata) {
-  const command = new import_client_s3.PutObjectCommand({
-    Bucket: bucket,
-    Key: key,
-    Body: body,
-    ContentType: contentType,
-    Metadata: metadata
-  });
-  return getClient().send(command);
-}
-async function getSignedUploadUrl(key, contentType, expiresIn = 3600) {
-  const command = new import_client_s3.PutObjectCommand({
-    Bucket: bucket,
-    Key: key,
-    ContentType: contentType
-  });
-  return (0, import_s3_request_presigner.getSignedUrl)(getClient(), command, { expiresIn });
-}
-async function getSignedDownloadUrl(key, expiresIn = 3600) {
-  const command = new import_client_s3.GetObjectCommand({
-    Bucket: bucket,
-    Key: key
-  });
-  return (0, import_s3_request_presigner.getSignedUrl)(getClient(), command, { expiresIn });
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getSignedDownloadUrl,
-  getSignedUploadUrl,
-  initStorage,
-  putObject,
-  validateUpload
-});

package/dist/index.mjs

@@ -1,57 +0,0 @@
-import {
-  validateUpload
-} from "./chunk-6VKCOC6I.mjs";
-
-// src/index.ts
-import { S3Client, PutObjectCommand, GetObjectCommand } from "@aws-sdk/client-s3";
-import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
-var client;
-var bucket;
-function initStorage(config) {
-  const endpoint = `https://${config.accountId}.r2.cloudflarestorage.com`;
-  client = new S3Client({
-    region: config.region || "auto",
-    endpoint,
-    credentials: {
-      accessKeyId: config.accessKeyId,
-      secretAccessKey: config.secretAccessKey
-    }
-  });
-  bucket = config.bucketName;
-}
-function getClient() {
-  if (!client) throw new Error("Storage not initialized. Call initStorage first.");
-  return client;
-}
-async function putObject(body, key, contentType, metadata) {
-  const command = new PutObjectCommand({
-    Bucket: bucket,
-    Key: key,
-    Body: body,
-    ContentType: contentType,
-    Metadata: metadata
-  });
-  return getClient().send(command);
-}
-async function getSignedUploadUrl(key, contentType, expiresIn = 3600) {
-  const command = new PutObjectCommand({
-    Bucket: bucket,
-    Key: key,
-    ContentType: contentType
-  });
-  return getSignedUrl(getClient(), command, { expiresIn });
-}
-async function getSignedDownloadUrl(key, expiresIn = 3600) {
-  const command = new GetObjectCommand({
-    Bucket: bucket,
-    Key: key
-  });
-  return getSignedUrl(getClient(), command, { expiresIn });
-}
-export {
-  getSignedDownloadUrl,
-  getSignedUploadUrl,
-  initStorage,
-  putObject,
-  validateUpload
-};

package/src/index.ts

@@ -1,73 +0,0 @@
-/* eslint-disable no-restricted-imports */
-import { S3Client, PutObjectCommand, GetObjectCommand } from '@aws-sdk/client-s3';
-import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
-
-export interface StorageConfig {
-  accountId: string;
-  accessKeyId: string;
-  secretAccessKey: string;
-  bucketName: string;
-  region?: string;
-}
-
-let client: S3Client;
-let bucket: string;
-
-export function initStorage(config: StorageConfig) {
-  // For R2, endpoint: https://<accountid>.r2.cloudflarestorage.com
-  const endpoint = `https://${config.accountId}.r2.cloudflarestorage.com`;
-
-  client = new S3Client({
-    region: config.region || 'auto',
-    endpoint,
-    credentials: {
-      accessKeyId: config.accessKeyId,
-      secretAccessKey: config.secretAccessKey,
-    },
-  });
-
-  bucket = config.bucketName;
-}
-
-function getClient() {
-  if (!client) throw new Error('Storage not initialized. Call initStorage first.');
-  return client;
-}
-
-export async function putObject(
-  body: Buffer | Uint8Array | Blob | string,
-  key: string,
-  contentType: string,
-  metadata?: Record<string, string>,
-) {
-  const command = new PutObjectCommand({
-    Bucket: bucket,
-    Key: key,
-    Body: body,
-    ContentType: contentType,
-    Metadata: metadata,
-  });
-
-  return getClient().send(command);
-}
-
-export async function getSignedUploadUrl(key: string, contentType: string, expiresIn = 3600) {
-  const command = new PutObjectCommand({
-    Bucket: bucket,
-    Key: key,
-    ContentType: contentType,
-  });
-
-  return getSignedUrl(getClient(), command, { expiresIn });
-}
-
-export async function getSignedDownloadUrl(key: string, expiresIn = 3600) {
-  const command = new GetObjectCommand({
-    Bucket: bucket,
-    Key: key,
-  });
-
-  return getSignedUrl(getClient(), command, { expiresIn });
-}
-
-export * from './shared';