@arcote.tech/arc-files 0.8.2 → 0.8.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arcote.tech/arc-files",
   "type": "module",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "private": false,
   "description": "Generic file upload fragment for Arc framework — S3 presigned upload + provider file_id binding",
   "main": "./src/index.ts",
@@ -10,9 +10,9 @@
     "type-check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@arcote.tech/arc": "^0.8.2",
-    "@arcote.tech/arc-ds": "^0.8.2",
-    "@arcote.tech/platform": "^0.8.2",
+    "@arcote.tech/arc": "^0.8.3",
+    "@arcote.tech/arc-ds": "^0.8.3",
+    "@arcote.tech/platform": "^0.8.3",
     "@aws-sdk/client-s3": "^3.658.0",
     "@aws-sdk/s3-request-presigner": "^3.658.0",
     "lucide-react": ">=0.400.0",

package/src/s3/s3-client.ts

@@ -14,9 +14,13 @@ import type { S3Config } from "../types";
  * parsing 10 MB SDK. Pierwsze użycie ma ~100-200 ms overhead lazy load
  * (acceptable dla async S3 operation).
  *
- * Cały moduł guard'owany przez `ONLY_SERVER` — w browser bundle bundler
- * tree-shake'uje konstruktor (nigdy nie istnieje), więc browser nie widzi
- * aws-sdk w ogóle.
+ * KAŻDY `import("@aws-sdk/...")` MUSI być owinięty w `ONLY_SERVER ? … : null`
+ * (helpery #s3 / #presigner niżej). Sam `if (!ONLY_SERVER) throw` NIE
+ * wystarcza — bundler nie robi analizy przepływu, więc gołe `import(...)` w
+ * ciele metody zostaje w grafie i (bez splittingu w buildContextPackages)
+ * ląduje INLINE w dist/browser konsumenta. W NDT dało to ~840 KB AWS SDK +
+ * ~600 KB polyfilli node:crypto/stream w KAŻDYM wejściu. Z guardem `define
+ * ONLY_SERVER=false` składa martwą gałąź do `null` → aws-sdk znika z klienta.
  */
 export class S3Bridge {
   readonly bucket: string;
@@ -28,17 +32,30 @@ export class S3Bridge {
     this.#config = config;
   }
 
+  /** Guarded loader — na przeglądarce (ONLY_SERVER=false) cała gałąź importu
+   *  jest martwa i wypada z bundla; na serwerze ładuje aws-sdk lazy. */
+  async #s3() {
+    const mod = ONLY_SERVER ? await import("@aws-sdk/client-s3") : null;
+    if (!mod) throw new Error("S3Bridge not available in browser context");
+    return mod;
+  }
+
+  async #presigner() {
+    const mod = ONLY_SERVER
+      ? await import("@aws-sdk/s3-request-presigner")
+      : null;
+    if (!mod) throw new Error("S3Bridge not available in browser context");
+    return mod;
+  }
+
   /**
    * Lazy client construction. Pierwszy call odpala dynamic import aws-sdk
    * + `new S3Client(...)`; kolejne calle reużywają cached Promise.
    */
   async #client(): Promise<S3ClientLike> {
-    if (!ONLY_SERVER) {
-      throw new Error("S3Bridge not available in browser context");
-    }
     if (!this.#clientPromise) {
       this.#clientPromise = (async () => {
-        const { S3Client } = await import("@aws-sdk/client-s3");
+        const { S3Client } = await this.#s3();
         return new S3Client({
           region: this.#config.region,
           endpoint: this.#config.endpoint,
@@ -57,8 +74,8 @@ export class S3Bridge {
   async presignUpload(key: string, mime: string, expiresIn = 300) {
     const [client, { PutObjectCommand }, { getSignedUrl }] = await Promise.all([
       this.#client(),
-      import("@aws-sdk/client-s3"),
-      import("@aws-sdk/s3-request-presigner"),
+      this.#s3(),
+      this.#presigner(),
     ]);
     return getSignedUrl(
       client as any,
@@ -74,8 +91,8 @@ export class S3Bridge {
   async presignDownload(key: string, expiresIn = 3600) {
     const [client, { GetObjectCommand }, { getSignedUrl }] = await Promise.all([
       this.#client(),
-      import("@aws-sdk/client-s3"),
-      import("@aws-sdk/s3-request-presigner"),
+      this.#s3(),
+      this.#presigner(),
     ]);
     return getSignedUrl(
       client as any,
@@ -87,7 +104,7 @@ export class S3Bridge {
   async downloadObject(key: string): Promise<Buffer> {
     const [client, { GetObjectCommand }] = await Promise.all([
       this.#client(),
-      import("@aws-sdk/client-s3"),
+      this.#s3(),
     ]);
     const out = await client.send(
       new GetObjectCommand({ Bucket: this.bucket, Key: key }),
@@ -101,7 +118,7 @@ export class S3Bridge {
   async deleteObject(key: string): Promise<void> {
     const [client, { DeleteObjectCommand }] = await Promise.all([
       this.#client(),
-      import("@aws-sdk/client-s3"),
+      this.#s3(),
     ]);
     await client.send(
       new DeleteObjectCommand({ Bucket: this.bucket, Key: key }),