@blu1606/create-walrus-app 0.1.4 → 2.0.0

package/templates/gallery/src/components/UploadModal.tsx

@@ -1,45 +0,0 @@
-import { useState } from 'react';
-import { useUpload } from '../hooks/useStorage.js';
-import { addItem } from '../utils/index-manager.js';
-
-interface UploadModalProps {
-  onSuccess: () => void;
-}
-
-export function UploadModal({ onSuccess }: UploadModalProps) {
-  const [file, setFile] = useState<File | null>(null);
-  const upload = useUpload();
-
-  const handleUpload = async () => {
-    if (!file) return;
-
-    upload.mutate(
-      { file, options: { epochs: 1 } },
-      {
-        onSuccess: async (data) => {
-          addItem({
-            blobId: data.blobId,
-            name: file.name,
-            size: file.size,
-            contentType: file.type,
-            uploadedAt: Date.now(),
-          });
-          setFile(null);
-          onSuccess();
-        },
-      }
-    );
-  };
-
-  return (
-    <div className="upload-modal">
-      <input
-        type="file"
-        onChange={(e) => setFile(e.target.files?.[0] || null)}
-      />
-      <button onClick={handleUpload} disabled={!file || upload.isPending}>
-        {upload.isPending ? 'Uploading...' : 'Add to Gallery'}
-      </button>
-    </div>
-  );
-}

package/templates/gallery/src/styles.css

@@ -1,58 +0,0 @@
-.gallery-app {
-  max-width: 1200px;
-  margin: 0 auto;
-}
-
-.upload-modal {
-  margin: 2rem 0;
-  padding: 1.5rem;
-  border: 1px solid #333;
-  border-radius: 8px;
-  display: flex;
-  gap: 1rem;
-  align-items: center;
-}
-
-.gallery-grid {
-  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
-  gap: 1.5rem;
-  margin: 2rem 0;
-}
-
-.file-card {
-  padding: 1.5rem;
-  border: 1px solid #333;
-  border-radius: 8px;
-  background: #1a1a1a;
-}
-
-.file-card h4 {
-  margin: 0 0 1rem 0;
-  color: #fff;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.file-card p {
-  margin: 0.5rem 0;
-  font-size: 0.9rem;
-  color: #aaa;
-}
-
-.file-card .blob-id {
-  font-family: monospace;
-  font-size: 0.8rem;
-  color: #888;
-}
-
-.file-card button {
-  margin-top: 1rem;
-  width: 100%;
-}
-
-button:disabled {
-  opacity: 0.5;
-  cursor: not-allowed;
-}

package/templates/gallery/src/types/gallery.ts

@@ -1,13 +0,0 @@
-export interface GalleryItem {
-  blobId: string;
-  name: string;
-  size: number;
-  contentType: string;
-  uploadedAt: number;
-}
-
-export interface GalleryIndex {
-  version: '1.0';
-  items: GalleryItem[];
-  lastModified: number;
-}

package/templates/react/.eslintrc.json

@@ -1,26 +0,0 @@
-{
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:react/recommended",
-    "plugin:react-hooks/recommended"
-  ],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2020,
-    "sourceType": "module",
-    "ecmaFeatures": {
-      "jsx": true
-    }
-  },
-  "plugins": ["@typescript-eslint", "react", "react-hooks"],
-  "rules": {
-    "no-console": "warn",
-    "react/react-in-jsx-scope": "off"
-  },
-  "settings": {
-    "react": {
-      "version": "detect"
-    }
-  }
-}

package/templates/react/README.md

@@ -1,80 +0,0 @@
-# React + Vite Framework Layer
-
-Modern React 18 application with Vite build system.
-
-## Features
-
-✅ **React 18** - Hooks, Suspense, Concurrent features  
-✅ **Vite 5** - Lightning-fast HMR and builds  
-✅ **TanStack Query** - Async state management  
-✅ **@mysten/dapp-kit** - Sui wallet integration  
-✅ **TypeScript** - Full type safety
-
-## Project Structure
-
-```
-src/
-├── components/     # Reusable UI components
-├── providers/      # Context providers
-├── hooks/          # Custom React hooks
-├── App.tsx         # Root component
-└── main.tsx        # Entry point
-```
-
-## Custom Hooks
-
-### `useUpload()`
-
-Upload files to Walrus:
-
-```typescript
-const upload = useUpload();
-
-upload.mutate({ file: myFile, options: { epochs: 1 } });
-```
-
-### `useDownload(blobId)`
-
-Download blob data:
-
-```typescript
-const { data, isLoading } = useDownload(blobId);
-```
-
-### `useMetadata(blobId)`
-
-Fetch blob metadata:
-
-```typescript
-const { data: metadata } = useMetadata(blobId);
-console.log(`Size: ${metadata.size} bytes`);
-```
-
-### `useWallet()`
-
-Access wallet state:
-
-```typescript
-const { isConnected, address } = useWallet();
-```
-
-## Development
-
-```bash
-npm run dev        # Start dev server (http://localhost:3000)
-npm run build      # Build for production
-npm run preview    # Preview production build
-```
-
-## Wallet Setup
-
-1. Install Sui Wallet browser extension
-2. Get testnet SUI from faucet
-3. Connect wallet in the app
-
-## Resources
-
-- [React Docs](https://react.dev)
-- [Vite Docs](https://vitejs.dev)
-- [TanStack Query](https://tanstack.com/query)
-- [@mysten/dapp-kit](https://sdk.mystenlabs.com/dapp-kit)

package/templates/react/src/App.tsx

@@ -1,14 +0,0 @@
-import { Layout } from './components/Layout.js';
-
-function App() {
-  return (
-    <Layout>
-      <div className="welcome">
-        <h2>Welcome to Walrus Starter Kit</h2>
-        <p>This app will be customized by the use case layer</p>
-      </div>
-    </Layout>
-  );
-}
-
-export default App;

package/templates/react/src/components/Layout.tsx

@@ -1,21 +0,0 @@
-import { ReactNode } from 'react';
-import { WalletConnect } from './WalletConnect.js';
-
-interface LayoutProps {
-  children: ReactNode;
-}
-
-export function Layout({ children }: LayoutProps) {
-  return (
-    <div className="app-layout">
-      <header className="app-header">
-        <h1>🌊 Walrus App</h1>
-        <WalletConnect />
-      </header>
-      <main className="app-main">{children}</main>
-      <footer className="app-footer">
-        <p>Powered by Walrus & Sui</p>
-      </footer>
-    </div>
-  );
-}

package/templates/react/src/dapp-kit.css

@@ -1 +0,0 @@
-@import '@mysten/dapp-kit/dist/index.css';

package/templates/react/src/index.css

@@ -1,50 +0,0 @@
-:root {
-  font-family: Inter, system-ui, Avenir, Helvetica, Arial, sans-serif;
-  line-height: 1.5;
-  font-weight: 400;
-
-  color-scheme: light dark;
-  color: rgba(255, 255, 255, 0.87);
-  background-color: #242424;
-
-  font-synthesis: none;
-  text-rendering: optimizeLegibility;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-}
-
-body {
-  margin: 0;
-  display: flex;
-  place-items: center;
-  min-width: 320px;
-  min-height: 100vh;
-}
-
-#root {
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 2rem;
-  text-align: center;
-}
-
-button {
-  border-radius: 8px;
-  border: 1px solid transparent;
-  padding: 0.6em 1.2em;
-  font-size: 1em;
-  font-weight: 500;
-  font-family: inherit;
-  background-color: #1a1a1a;
-  cursor: pointer;
-  transition: border-color 0.25s;
-}
-
-button:hover {
-  border-color: #646cff;
-}
-
-button:focus,
-button:focus-visible {
-  outline: 4px auto -webkit-focus-ring-color;
-}

package/templates/react/src/index.ts

@@ -1,10 +0,0 @@
-// Re-export storage adapter from SDK layer for use case templates
-export { storageAdapter } from './adapters/storage.js';
-
-// Re-export base adapter types
-export type {
-  StorageAdapter,
-  BlobMetadata,
-  UploadOptions,
-  DownloadOptions,
-} from './adapters/storage.js';

package/templates/sdk-mysten/README.md

@@ -1,65 +0,0 @@
-# Mysten Walrus SDK Layer
-
-Official [Mysten Labs](https://mystenlabs.com/) SDK implementation for Walrus storage.
-
-## Features
-
-✅ **Relay Upload** - Browser-optimized uploads via relay nodes  
-✅ **Direct Download** - Fast blob retrieval  
-✅ **Metadata Queries** - Size, type, creation date  
-✅ **Network Support** - Testnet, Mainnet, Devnet  
-✅ **Type Safety** - Full TypeScript support
-
-## Usage
-
-```typescript
-import { storageAdapter } from './sdk-mysten';
-
-// Upload file
-const blobId = await storageAdapter.upload(fileData, { epochs: 1 });
-
-// Download file
-const data = await storageAdapter.download(blobId);
-
-// Get metadata
-const metadata = await storageAdapter.getMetadata(blobId);
-console.log(`Blob size: ${metadata.size} bytes`);
-```
-
-## Configuration
-
-Set environment variables:
-
-```bash
-VITE_WALRUS_NETWORK=testnet
-VITE_WALRUS_PUBLISHER=https://publisher.walrus-testnet.walrus.space
-VITE_WALRUS_AGGREGATOR=https://aggregator.walrus-testnet.walrus.space
-VITE_SUI_RPC=https://fullnode.testnet.sui.io:443
-```
-
-## API Reference
-
-### `storageAdapter`
-
-Singleton instance implementing `StorageAdapter` interface.
-
-### `getWalrusClient()`
-
-Get WalrusClient singleton (lazy initialization).
-
-### `getNetworkConfig(network)`
-
-Get network-specific configuration.
-
-## Network Defaults
-
-| Network | Publisher                                       | Aggregator                                       |
-| ------- | ----------------------------------------------- | ------------------------------------------------ |
-| testnet | `https://publisher.walrus-testnet.walrus.space` | `https://aggregator.walrus-testnet.walrus.space` |
-| mainnet | `https://publisher.walrus.space`                | `https://aggregator.walrus.space`                |
-
-## Resources
-
-- [Walrus SDK Docs](https://sdk.mystenlabs.com/walrus)
-- [Walrus Documentation](https://docs.walrus.site)
-- [npm: @mysten/walrus](https://www.npmjs.com/package/@mysten/walrus)

package/templates/sdk-mysten/package.json

@@ -1,14 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "description": "Mysten Walrus SDK layer for walrus-starter-kit",
-  "dependencies": {
-    "@mysten/walrus": "^0.9.0",
-    "@mysten/sui": "^1.10.0"
-  },
-  "peerDependencies": {
-    "typescript": "^5.3.0"
-  }
-}

package/templates/sdk-mysten/src/adapter.ts

@@ -1,80 +0,0 @@
-import type {
-  StorageAdapter,
-  BlobMetadata,
-  UploadOptions,
-  DownloadOptions,
-} from '../adapters/storage.js';
-import { getWalrusClient } from './client.js';
-
-export class MystenStorageAdapter implements StorageAdapter {
-  async upload(
-    data: File | Uint8Array,
-    options?: UploadOptions
-  ): Promise<string> {
-    const client = getWalrusClient();
-
-    const bytes =
-      data instanceof File ? new Uint8Array(await data.arrayBuffer()) : data;
-
-    try {
-      const result = await client.writeBlobToUploadRelay(bytes, {
-        nEpochs: options?.epochs || 1,
-      });
-
-      const blobId = result.newlyCreated.blobObject.blobId;
-
-      return blobId;
-    } catch (error) {
-      throw new Error(
-        `Upload failed: ${error instanceof Error ? error.message : 'Unknown error'}`
-      );
-    }
-  }
-
-  async download(
-    blobId: string,
-    options?: DownloadOptions
-  ): Promise<Uint8Array> {
-    const client = getWalrusClient();
-
-    try {
-      const data = await client.readBlob(blobId);
-
-      return data;
-    } catch (error) {
-      throw new Error(
-        `Download failed for blob ${blobId}: ${error instanceof Error ? error.message : 'Unknown error'}`
-      );
-    }
-  }
-
-  async getMetadata(blobId: string): Promise<BlobMetadata> {
-    const client = getWalrusClient();
-
-    try {
-      const metadata = await client.getBlobMetadata(blobId);
-
-      return {
-        blobId,
-        size: metadata.size,
-        contentType: metadata.contentType,
-        createdAt: metadata.createdAt || Date.now(),
-      };
-    } catch (error) {
-      throw new Error(
-        `Failed to get metadata for blob ${blobId}: ${error instanceof Error ? error.message : 'Unknown error'}`
-      );
-    }
-  }
-
-  async exists(blobId: string): Promise<boolean> {
-    try {
-      await this.getMetadata(blobId);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-}
-
-export const storageAdapter = new MystenStorageAdapter();

package/templates/sdk-mysten/src/client.ts

@@ -1,45 +0,0 @@
-import { WalrusClient } from '@mysten/walrus';
-import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';
-import { loadEnv } from '../utils/env.js';
-import { getNetworkConfig } from './config.js';
-import type { WalrusNetwork } from '../types/walrus.js';
-
-let walrusClient: WalrusClient | null = null;
-
-export function getWalrusClient(): WalrusClient {
-  if (walrusClient) {
-    return walrusClient;
-  }
-
-  const env = loadEnv();
-
-  // Validate network value before casting
-  const allowedNetworks: WalrusNetwork[] = ['testnet', 'mainnet', 'devnet'];
-  if (!allowedNetworks.includes(env.walrusNetwork as WalrusNetwork)) {
-    throw new Error(
-      `Invalid WALRUS_NETWORK: ${env.walrusNetwork}. Must be one of: ${allowedNetworks.join(', ')}`
-    );
-  }
-  const network = env.walrusNetwork as WalrusNetwork;
-  const config = getNetworkConfig(network);
-
-  const suiClient = new SuiClient({
-    url:
-      env.suiRpc ||
-      config.suiRpcUrl ||
-      getFullnodeUrl(network === 'testnet' ? 'testnet' : 'mainnet'),
-  });
-
-  walrusClient = new WalrusClient({
-    network,
-    suiClient,
-    ...(env.walrusPublisher && { publisherUrl: env.walrusPublisher }),
-    ...(env.walrusAggregator && { aggregatorUrl: env.walrusAggregator }),
-  });
-
-  return walrusClient;
-}
-
-export function resetWalrusClient(): void {
-  walrusClient = null;
-}

package/templates/sdk-mysten/src/config.ts

@@ -1,33 +0,0 @@
-import type { WalrusNetwork } from '../types/walrus.js';
-
-export interface MystenWalrusConfig {
-  network: WalrusNetwork;
-  publisherUrl?: string;
-  aggregatorUrl?: string;
-  suiRpcUrl?: string;
-}
-
-export const NETWORK_CONFIGS: Record<WalrusNetwork, MystenWalrusConfig> = {
-  testnet: {
-    network: 'testnet',
-    publisherUrl: 'https://publisher.walrus-testnet.walrus.space',
-    aggregatorUrl: 'https://aggregator.walrus-testnet.walrus.space',
-    suiRpcUrl: 'https://fullnode.testnet.sui.io:443',
-  },
-  mainnet: {
-    network: 'mainnet',
-    publisherUrl: 'https://publisher.walrus.space',
-    aggregatorUrl: 'https://aggregator.walrus.space',
-    suiRpcUrl: 'https://fullnode.mainnet.sui.io:443',
-  },
-  devnet: {
-    network: 'devnet',
-    publisherUrl: 'http://localhost:8080',
-    aggregatorUrl: 'http://localhost:8081',
-    suiRpcUrl: 'http://localhost:9000',
-  },
-};
-
-export function getNetworkConfig(network: WalrusNetwork): MystenWalrusConfig {
-  return NETWORK_CONFIGS[network];
-}

package/templates/sdk-mysten/src/index.ts

@@ -1,11 +0,0 @@
-export { getWalrusClient, resetWalrusClient } from './client.js';
-export { MystenStorageAdapter, storageAdapter } from './adapter.js';
-export { getNetworkConfig, NETWORK_CONFIGS } from './config.js';
-export type { MystenUploadResult, MystenBlobMetadata } from './types.js';
-
-export type {
-  StorageAdapter,
-  BlobMetadata,
-  UploadOptions,
-  DownloadOptions,
-} from '../adapters/storage.js';

package/templates/sdk-mysten/src/types.ts

@@ -1,19 +0,0 @@
-/**
- * Mysten-specific type extensions
- */
-
-export interface MystenUploadResult {
-  newlyCreated: {
-    blobObject: {
-      blobId: string;
-      size: number;
-    };
-  };
-}
-
-export interface MystenBlobMetadata {
-  size: number;
-  encodingType: string;
-  contentType?: string;
-  createdAt?: number;
-}

package/templates/sdk-mysten/test/adapter.test.ts

@@ -1,20 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { MystenStorageAdapter } from '../src/adapter.js';
-
-describe('MystenStorageAdapter', () => {
-  it('should implement StorageAdapter interface', () => {
-    const adapter = new MystenStorageAdapter();
-
-    expect(adapter).toHaveProperty('upload');
-    expect(adapter).toHaveProperty('download');
-    expect(adapter).toHaveProperty('getMetadata');
-    expect(adapter).toHaveProperty('exists');
-  });
-
-  it('should handle upload errors gracefully', async () => {
-    const adapter = new MystenStorageAdapter();
-    const invalidData = new Uint8Array(0);
-
-    await expect(adapter.upload(invalidData)).rejects.toThrow('Upload failed');
-  });
-});

package/templates/simple-upload/package.json

@@ -1,6 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.1.0",
-  "private": true,
-  "dependencies": {}
-}

package/templates/simple-upload/src/App.tsx

@@ -1,27 +0,0 @@
-import { Layout } from './components/Layout.js';
-import { UploadForm } from './components/UploadForm.js';
-import { FilePreview } from './components/FilePreview.js';
-import './styles.css';
-
-function App() {
-  return (
-    <Layout>
-      <div className="simple-upload-app">
-        <h2>📤 Simple Upload</h2>
-        <p>Upload a file to Walrus and download it by Blob ID</p>
-
-        <section className="upload-section">
-          <h3>Upload File</h3>
-          <UploadForm />
-        </section>
-
-        <section className="download-section">
-          <h3>Download File</h3>
-          <FilePreview />
-        </section>
-      </div>
-    </Layout>
-  );
-}
-
-export default App;