create-sia-app 0.1.1

package/template/tsconfig.app.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "types": ["vite/client"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "paths": {
+      "indexd_wasm": ["./wasm/indexd_wasm/indexd_wasm.d.ts"]
+    },
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}

package/template/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

package/template/tsconfig.node.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "target": "ES2023",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "types": ["node"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["vite.config.ts"]
+}

package/template/vite.config.ts

@@ -0,0 +1,18 @@
+import tailwindcss from '@tailwindcss/vite'
+import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
+import topLevelAwait from 'vite-plugin-top-level-await'
+import wasm from 'vite-plugin-wasm'
+
+export default defineConfig({
+  plugins: [react(), tailwindcss(), wasm(), topLevelAwait()],
+  optimizeDeps: {
+    exclude: ['indexd_wasm'],
+  },
+  resolve: {
+    alias: {
+      indexd_wasm: '/wasm/indexd_wasm/indexd_wasm.js',
+      env: '/src/lib/wasm-env.ts',
+    },
+  },
+})

package/template/wasm/indexd_wasm/indexd_wasm.d.ts

@@ -0,0 +1,309 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Install a panic hook and logging bridge so that Rust panics show a proper
+ * stack trace and `log::debug!()` / `log::info!()` etc. appear in the browser
+ * console.
+ */
+export function init_panic_hook(): void;
+/**
+ * Connects to a host via WebTransport and fetches its settings/prices.
+ *
+ * `address` should be a host address like `host.example.com:9883`.
+ * Returns the host settings as a JS object.
+ */
+export function fetchHostSettings(address: string): Promise<any>;
+/**
+ * Validates a BIP-32 recovery phrase.
+ */
+export function validateRecoveryPhrase(phrase: string): void;
+/**
+ * Generates a new 12-word BIP-32 recovery phrase.
+ */
+export function generateRecoveryPhrase(): string;
+export class AppKey {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Returns the hex-encoded public key.
+   */
+  publicKey(): string;
+  /**
+   * Verifies a signature against a message.
+   */
+  verifySignature(message: Uint8Array, signature: Uint8Array): boolean;
+  /**
+   * Imports an AppKey from a 64-byte ed25519 keypair or a 32-byte seed.
+   */
+  constructor(key: Uint8Array);
+  /**
+   * Signs a message, returning the 64-byte signature.
+   */
+  sign(message: Uint8Array): Uint8Array;
+  /**
+   * Exports the full 64-byte ed25519 keypair.
+   */
+  export(): Uint8Array;
+}
+export class Builder {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Returns the response URL the user must visit to authorize the connection.
+   */
+  responseUrl(): string;
+  /**
+   * Sets the maximum number of concurrent uploads (default: 3).
+   * Lower values = more stable, higher values = faster but may crash browser.
+   */
+  withMaxUploads(max: number): void;
+  /**
+   * Polls for approval. Resolves when the user approves.
+   */
+  waitForApproval(): Promise<void>;
+  /**
+   * Requests a new app connection. Pass app metadata as a JSON object:
+   * ```json
+   * {
+   *   "app_id": [32 bytes as hex],
+   *   "name": "My App",
+   *   "description": "...",
+   *   "service_url": "https://...",
+   *   "logo_url": "https://..." (optional),
+   *   "callback_url": "https://..." (optional)
+   * }
+   * ```
+   */
+  requestConnection(app_meta_json: string): Promise<void>;
+  /**
+   * Sets the maximum number of concurrent downloads (default: 2).
+   * Lower values = more stable, higher values = faster but may crash browser.
+   */
+  withMaxDownloads(max: number): void;
+  /**
+   * Sets the maximum number of concurrent price fetches (default: 1).
+   * Lower values = more stable, higher values = faster but may crash browser.
+   */
+  withMaxPriceFetches(max: number): void;
+  /**
+   * Transitions the builder using a pre-fetched connection response.
+   * Use this when the `POST /auth/connect` call was made out-of-band
+   * (e.g. via curl) to work around CORS restrictions.
+   *
+   * `app_id_hex` is the hex-encoded app ID used in the request.
+   * `response_json` is the JSON response from `POST /auth/connect`.
+   */
+  setConnectionResponse(app_id_hex: string, response_json: string): void;
+  /**
+   * Creates a new SDK builder for the given indexer URL.
+   */
+  constructor(indexer_url: string);
+  /**
+   * Registers the app using the user's recovery phrase and returns the SDK.
+   */
+  register(mnemonic: string): Promise<SDK>;
+  /**
+   * Attempts to connect using an existing app key.
+   *
+   * Returns the SDK if authenticated, or null if the key is not recognized.
+   * Call `requestConnection` if null is returned.
+   */
+  connected(app_key: AppKey): Promise<any>;
+}
+export class PinnedObject {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Updates the metadata.
+   */
+  updateMetadata(metadata: Uint8Array): void;
+  /**
+   * Returns the object's ID as a hex string.
+   */
+  id(): string;
+  /**
+   * Opens a sealed object (JSON) using the provided app key.
+   */
+  static open(app_key: AppKey, sealed_json: string): PinnedObject;
+  /**
+   * Seals the object for offline storage, returning JSON.
+   */
+  seal(app_key: AppKey): string;
+  /**
+   * Returns the total size of the object in bytes.
+   */
+  size(): number;
+  /**
+   * Returns the metadata as a Uint8Array.
+   */
+  metadata(): Uint8Array;
+}
+export class SDK {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Pins an object to the indexer.
+   */
+  pinObject(object: PinnedObject): Promise<void>;
+  /**
+   * Prunes unused slabs from the indexer.
+   */
+  pruneSlabs(): Promise<void>;
+  /**
+   * Creates a share URL for an object, valid until the given timestamp (ms since epoch).
+   */
+  shareObject(object: PinnedObject, valid_until_ms: number): string;
+  /**
+   * Deletes an object from the indexer by its hex-encoded key.
+   */
+  deleteObject(key: string): Promise<void>;
+  /**
+   * Returns object events for syncing. Supports cursor-based pagination.
+   *
+   * `cursor_json` is an optional JSON string: `{"id": "hex...", "after": <epoch_ms>}`
+   * `limit` is the maximum number of events to return.
+   *
+   * Returns a JS array of objects:
+   * `[{ id: string, deleted: bool, updatedAt: number, object: PinnedObject | null }]`
+   */
+  objectEvents(cursor_json: string | null | undefined, limit: number): Promise<any>;
+  /**
+   * Retrieves a shared object from a signed share URL.
+   * Accepts both `https://` and `sia://` schemes.
+   */
+  sharedObject(share_url: string): Promise<PinnedObject>;
+  /**
+   * Downloads an object with streaming chunks.
+   * Fires `on_chunk(bytes)` after each slab is decoded and `on_progress(current, total)` for progress.
+   */
+  downloadStreaming(object: PinnedObject, on_chunk: Function, on_progress: Function): Promise<void>;
+  /**
+   * Uploads a Uint8Array with per-shard progress reporting.
+   *
+   * The `on_progress` callback receives `(current_shards, total_shards)`.
+   */
+  uploadWithProgress(data: Uint8Array, on_progress: Function): Promise<PinnedObject>;
+  /**
+   * Downloads an object's data with per-slab progress reporting.
+   *
+   * The `on_progress` callback receives `(current_slabs, total_slabs)`.
+   */
+  downloadWithProgress(object: PinnedObject, on_progress: Function): Promise<Uint8Array>;
+  /**
+   * Updates the metadata of an object already stored in the indexer.
+   */
+  updateObjectMetadata(object: PinnedObject): Promise<void>;
+  /**
+   * Returns hosts as a JSON array.
+   */
+  hosts(): Promise<any>;
+  /**
+   * Retrieves a pinned object by its hex-encoded key.
+   */
+  object(key: string): Promise<PinnedObject>;
+  /**
+   * Uploads a Uint8Array to the Sia network.
+   *
+   * Returns a PinnedObject containing the metadata needed to download the data.
+   */
+  upload(data: Uint8Array): Promise<PinnedObject>;
+  /**
+   * Returns account information as a JS object.
+   */
+  account(): Promise<any>;
+  /**
+   * Returns the app key used by this SDK instance.
+   */
+  appKey(): AppKey;
+  /**
+   * Downloads an object's data, returning a Uint8Array.
+   */
+  download(object: PinnedObject): Promise<Uint8Array>;
+}
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+  readonly memory: WebAssembly.Memory;
+  readonly __wbg_appkey_free: (a: number, b: number) => void;
+  readonly __wbg_builder_free: (a: number, b: number) => void;
+  readonly __wbg_pinnedobject_free: (a: number, b: number) => void;
+  readonly __wbg_sdk_free: (a: number, b: number) => void;
+  readonly appkey_export: (a: number) => any;
+  readonly appkey_new: (a: number, b: number) => [number, number, number];
+  readonly appkey_publicKey: (a: number) => [number, number];
+  readonly appkey_sign: (a: number, b: number, c: number) => any;
+  readonly appkey_verifySignature: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+  readonly builder_connected: (a: number, b: number) => any;
+  readonly builder_new: (a: number, b: number) => [number, number, number];
+  readonly builder_register: (a: number, b: number, c: number) => any;
+  readonly builder_requestConnection: (a: number, b: number, c: number) => any;
+  readonly builder_responseUrl: (a: number) => [number, number, number, number];
+  readonly builder_setConnectionResponse: (a: number, b: number, c: number, d: number, e: number) => [number, number];
+  readonly builder_waitForApproval: (a: number) => any;
+  readonly builder_withMaxDownloads: (a: number, b: number) => [number, number];
+  readonly builder_withMaxPriceFetches: (a: number, b: number) => [number, number];
+  readonly builder_withMaxUploads: (a: number, b: number) => [number, number];
+  readonly fetchHostSettings: (a: number, b: number) => any;
+  readonly generateRecoveryPhrase: () => [number, number];
+  readonly init_panic_hook: () => void;
+  readonly pinnedobject_id: (a: number) => [number, number, number, number];
+  readonly pinnedobject_metadata: (a: number) => [number, number, number];
+  readonly pinnedobject_open: (a: number, b: number, c: number) => [number, number, number];
+  readonly pinnedobject_seal: (a: number, b: number) => [number, number, number, number];
+  readonly pinnedobject_size: (a: number) => [number, number, number];
+  readonly pinnedobject_updateMetadata: (a: number, b: number, c: number) => [number, number];
+  readonly sdk_account: (a: number) => any;
+  readonly sdk_appKey: (a: number) => number;
+  readonly sdk_deleteObject: (a: number, b: number, c: number) => any;
+  readonly sdk_download: (a: number, b: number) => any;
+  readonly sdk_downloadStreaming: (a: number, b: number, c: any, d: any) => any;
+  readonly sdk_downloadWithProgress: (a: number, b: number, c: any) => any;
+  readonly sdk_hosts: (a: number) => any;
+  readonly sdk_object: (a: number, b: number, c: number) => any;
+  readonly sdk_objectEvents: (a: number, b: number, c: number, d: number) => any;
+  readonly sdk_pinObject: (a: number, b: number) => any;
+  readonly sdk_pruneSlabs: (a: number) => any;
+  readonly sdk_shareObject: (a: number, b: number, c: number) => [number, number, number, number];
+  readonly sdk_sharedObject: (a: number, b: number, c: number) => any;
+  readonly sdk_updateObjectMetadata: (a: number, b: number) => any;
+  readonly sdk_upload: (a: number, b: number, c: number) => any;
+  readonly sdk_uploadWithProgress: (a: number, b: number, c: number, d: any) => any;
+  readonly validateRecoveryPhrase: (a: number, b: number) => [number, number];
+  readonly wasm_bindgen__convert__closures_____invoke__h660d0571ab542b96: (a: number, b: number) => void;
+  readonly wasm_bindgen__closure__destroy__he5035197fb444b8b: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h6280da76965e1dcd: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__h0c75a1a3e92aa554: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__hf411941149947cdb: (a: number, b: number, c: any, d: any) => void;
+  readonly __wbindgen_malloc: (a: number, b: number) => number;
+  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+  readonly __wbindgen_exn_store: (a: number) => void;
+  readonly __externref_table_alloc: () => number;
+  readonly __wbindgen_externrefs: WebAssembly.Table;
+  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+  readonly __externref_table_dealloc: (a: number) => void;
+  readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+/**
+* Instantiates the given `module`, which can either be bytes or
+* a precompiled `WebAssembly.Module`.
+*
+* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+*
+* @returns {InitOutput}
+*/
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+* for everything else, calls `WebAssembly.instantiate` directly.
+*
+* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+*
+* @returns {Promise<InitOutput>}
+*/
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;