chore: prepare repository for upstream PR to s5-dev/s5.js

  Repository Reference Updates:
  - Update package name from @julesl23/s5js to @s5-dev/s5js
  - Update all GitHub URLs from julesl23 to s5-dev organization
  - Update README to use official npm package in examples

  Documentation:
  - Add comprehensive CHANGELOG.md documenting all grant milestones
  - Remove s5-docs-sdk-js/ (delivered separately to S5 maintainers)
  - Update bundle analysis with latest build results

  Preparation for Milestone 8 completion - upstream integration ready.

  All quality checks passing:
  - 437 tests passing
  - TypeScript compilation clean
  - Bundle size: 61 KB (10× under 700 KB grant requirement)

Author: Developer

README.md

@@ -38,43 +38,38 @@ See the [API Documentation](./docs/API.md) for detailed usage examples.
 
 ## Installation
 
-The enhanced path-based API features are currently in development as part of a Sia Foundation grant project.
-
-**Prerequisites:**
-
-- **Node.js** v20+ (for development and testing)
-- **Python 3** (required for browser tests - used to run local HTTP server)
-- **npm** (comes with Node.js)
-
-**For production use:**
+Install the enhanced S5.js SDK with npm:
 
 ```bash
 npm install @s5-dev/s5js
 ```
 
-**To try the enhanced features:**
+**Prerequisites:**
+
+- **Node.js** v20+ (for Node.js environments)
+- Modern browser with ES2022 support (for browser environments)
+
+**For development:**
 
 ```bash
 # Clone the repository
-git clone https://github.com/julesl23/s5.js
+git clone https://github.com/s5-dev/s5.js
 cd s5.js
 
-# Install dependencies (includes TypeScript)
+# Install dependencies
 npm install
 
 # Build the project
 npm run build
 
-# Run tests with real S5 portal
+# Run tests
 npm test
 ```
 
-**Status**: These features are pending review and have not been merged into the main S5.js repository.
-
 ## Quick Start
 
 ```typescript
-import { S5 } from "./dist/src/index.js";
+import { S5 } from "@s5-dev/s5js";
 
 // Create S5 instance and connect to real S5 portal
 const s5 = await S5.create({
@@ -114,7 +109,7 @@ for await (const item of s5.fs.list("home/documents")) {
 ### Advanced Usage
 
 ```typescript
-import { DirectoryWalker, BatchOperations, MediaProcessor } from "./dist/src/index.js";
+import { DirectoryWalker, BatchOperations, MediaProcessor } from "@s5-dev/s5js";
 
 // Recursive directory traversal
 const walker = new DirectoryWalker(s5.fs, '/');

docs/BUNDLE_ANALYSIS.md

@@ -1,6 +1,6 @@
 # S5.js Bundle Analysis Report
 
-**Generated:** 2025-10-27T15:42:51.850Z
+**Generated:** 2025-11-12T18:01:42.819Z
 
 ## Executive Summary
 
@@ -10,20 +10,20 @@ This report analyzes bundle sizes for different entry points of the S5.js librar
 
 | Bundle | Raw | Gzip | Brotli | Status |
 |--------|-----|------|--------|--------|
-| Core | 214.78 KB | 71.77 KB | 59.58 KB | ✅ Pass |
+| Core | 214.66 KB | 71.74 KB | 59.58 KB | ✅ Pass |
 | Media | 35.98 KB | 11.03 KB | 9.79 KB | ✅ Pass |
-| Advanced | 218.69 KB | 72.90 KB | 60.60 KB | ✅ Pass |
-| Full | 221.12 KB | 73.48 KB | 61.14 KB | ✅ Pass |
+| Advanced | 218.57 KB | 72.86 KB | 60.74 KB | ✅ Pass |
+| Full | 221.00 KB | 73.45 KB | 61.12 KB | ✅ Pass |
 
 ## Tree-Shaking Analysis
 
 The modular export structure enables consumers to import only what they need:
 
 - **Core only:** 59.58 KB (excludes media processing)
 - **Media only:** 9.79 KB (media processing modules)
-- **Full bundle:** 61.14 KB (all features)
+- **Full bundle:** 61.12 KB (all features)
 - **Combined (Core + Media):** 69.37 KB
-- **Shared code savings:** 8.23 KB (11.9% efficiency)
+- **Shared code savings:** 8.25 KB (11.9% efficiency)
 
 ## Detailed Breakdown
 
@@ -34,9 +34,9 @@ The modular export structure enables consumers to import only what they need:
 **Entry Point:** `dist/src/exports/core.js`
 
 **Sizes:**
-- Raw: 214.78 KB
-- Gzipped: 71.77 KB (33.4% of raw)
-- Brotli: 59.58 KB (27.7% of raw)
+- Raw: 214.66 KB
+- Gzipped: 71.74 KB (33.4% of raw)
+- Brotli: 59.58 KB (27.8% of raw)
 
 **Metadata:**
 - Input files: 295
@@ -64,9 +64,9 @@ The modular export structure enables consumers to import only what they need:
 **Entry Point:** `dist/src/exports/advanced.js`
 
 **Sizes:**
-- Raw: 218.69 KB
-- Gzipped: 72.90 KB (33.3% of raw)
-- Brotli: 60.60 KB (27.7% of raw)
+- Raw: 218.57 KB
+- Gzipped: 72.86 KB (33.3% of raw)
+- Brotli: 60.74 KB (27.8% of raw)
 
 **Metadata:**
 - Input files: 298
@@ -79,17 +79,17 @@ The modular export structure enables consumers to import only what they need:
 **Entry Point:** `dist/src/index.js`
 
 **Sizes:**
-- Raw: 221.12 KB
-- Gzipped: 73.48 KB (33.2% of raw)
-- Brotli: 61.14 KB (27.6% of raw)
+- Raw: 221.00 KB
+- Gzipped: 73.45 KB (33.2% of raw)
+- Brotli: 61.12 KB (27.7% of raw)
 
 **Metadata:**
 - Input files: 297
 - Output modules: 1
 
 ## Recommendations
 
-✅ **Full bundle size is within the 700KB limit** (61.14 KB)
+✅ **Full bundle size is within the 700KB limit** (61.12 KB)
 
 ### For Application Developers:
 
@@ -115,9 +115,9 @@ The modular export structure enables consumers to import only what they need:
 
 **Status:** ✅ **COMPLIANT**
 
-- Full bundle (brotli): 61.14 KB
+- Full bundle (brotli): 61.12 KB
 - Target: 700 KB
-- Margin: 638.86 KB under budget
+- Margin: 638.88 KB under budget
 
 ## Technical Implementation
 

docs/bundle-analysis.json

@@ -1,14 +1,14 @@
 {
-  "timestamp": "2025-10-27T15:42:51.851Z",
+  "timestamp": "2025-11-12T18:01:42.821Z",
   "bundles": [
     {
       "name": "Core",
       "description": "File system operations without media processing",
       "entryPoint": "dist/src/exports/core.js",
       "sizes": {
-        "raw": 219933,
-        "gzipped": 73494,
-        "brotli": 61008
+        "raw": 219812,
+        "gzipped": 73458,
+        "brotli": 61006
       },
       "metadata": {
         "inputs": 295,
@@ -34,9 +34,9 @@
       "description": "Advanced CID-aware API with core functionality",
       "entryPoint": "dist/src/exports/advanced.js",
       "sizes": {
-        "raw": 223937,
-        "gzipped": 74646,
-        "brotli": 62056
+        "raw": 223816,
+        "gzipped": 74610,
+        "brotli": 62195
       },
       "metadata": {
         "inputs": 298,
@@ -48,9 +48,9 @@
       "description": "Complete SDK with all features",
       "entryPoint": "dist/src/index.js",
       "sizes": {
-        "raw": 226428,
-        "gzipped": 75247,
-        "brotli": 62607
+        "raw": 226307,
+        "gzipped": 75212,
+        "brotli": 62587
       },
       "metadata": {
         "inputs": 297,
@@ -59,16 +59,16 @@
     }
   ],
   "treeShaking": {
-    "coreSize": 61008,
+    "coreSize": 61006,
     "mediaSize": 10028,
-    "fullSize": 62607,
-    "combined": 71036,
-    "savings": 8429,
-    "efficiency": 11.865814516583141
+    "fullSize": 62587,
+    "combined": 71034,
+    "savings": 8447,
+    "efficiency": 11.891488582932116
   },
   "compliance": {
     "target": 716800,
-    "actual": 62607,
+    "actual": 62587,
     "status": true
   }
 }

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@julesl23/s5js",
+  "name": "@s5-dev/s5js",
   "version": "0.9.0-beta.1",
   "type": "module",
   "description": "Enhanced TypeScript SDK for S5 decentralized storage with path-based API, media processing, and directory utilities",
@@ -54,7 +54,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/julesl23/s5.js.git"
+    "url": "git+https://github.com/s5-dev/s5.js.git"
   },
   "keywords": [
     "s5",
@@ -71,9 +71,9 @@
   ],
   "license": "(MIT OR Apache-2.0)",
   "bugs": {
-    "url": "https://github.com/julesl23/s5.js/issues"
+    "url": "https://github.com/s5-dev/s5.js/issues"
   },
-  "homepage": "https://github.com/julesl23/s5.js#readme",
+  "homepage": "https://github.com/s5-dev/s5.js#readme",
   "dependencies": {
     "@noble/ciphers": "^1.0.0",
     "@noble/ed25519": "^2.1.0",