fix biome lint and clarify w3ds documentation examples

Author: coodos

infrastructure/web3-adapter/MAPPING_RULES.md

@@ -94,8 +94,15 @@ Uploads inline file payloads to the owner eVault's object storage and replaces
 them with a stable `w3ds://file` URI. On the way back, the URI is dereferenced
 to the file's public URL.
 
+Same global field name as the local field:
+
 ```json
 "avatar": "__file(avatar)"
+```
+
+Different global field name (via a `,alias` suffix):
+
+```json
 "avatar": "__file(avatar),avatarUri"
 ```
 

infrastructure/web3-adapter/W3DS_URI.md

@@ -5,7 +5,7 @@ files within the MetaState ecosystem.
 
 ## Format
 
-```
+```text
 w3ds://file?id=@<user-ename>/<meta-envelope-id>
 ```
 
@@ -19,7 +19,7 @@ w3ds://file?id=@<user-ename>/<meta-envelope-id>
 
 Example:
 
-```
+```text
 w3ds://file?id=@alice/envelope-abc123
 ```
 
@@ -52,7 +52,7 @@ There are two dereferencers:
 
 ### HTTP — eVault core
 
-```
+```http
 GET /files/:metaEnvelopeId        (header: X-ENAME: @<user-ename>)
 ```
 

infrastructure/web3-adapter/src/mapper/file-directive.test.ts

@@ -1,8 +1,8 @@
 import { describe, expect, it, vi } from "vitest";
-import type { EVaultClient } from "../evault/evault";
 import type { MappingDatabase } from "../db";
-import type { IMapping } from "./mapper.types";
+import type { EVaultClient } from "../evault/evault";
 import { fromGlobal, toGlobal } from "./mapper";
+import type { IMapping } from "./mapper.types";
 
 // Minimal stubs — the `__file()` directive paths never touch the mapping store.
 const mappingStore = {} as MappingDatabase;
@@ -15,8 +15,7 @@ function mockClient(): EVaultClient {
 		uploadFile: vi.fn(async (_w3id: string, input: { filename: string }) => ({
 			uri: "w3ds://file?id=@owner/env-123",
 			metaEnvelopeId: "env-123",
-			publicUrl:
-				"https://cdn.example.com/files/owner/env-123-" + input.filename,
+			publicUrl: `https://cdn.example.com/files/owner/env-123-${input.filename}`,
 		})),
 		fetchMetaEnvelope: vi.fn(async (id: string) => ({
 			id,

infrastructure/web3-adapter/src/w3ds/resolver.ts

@@ -6,7 +6,7 @@
  *   file's public object-storage URL plus its descriptive metadata.
  */
 import type { EVaultClient, UploadFileInput } from "../evault/evault";
-import { parseFileUri, W3DS_FILE_HOST, W3DS_SCHEME } from "./uri";
+import { W3DS_FILE_HOST, W3DS_SCHEME, parseFileUri } from "./uri";
 
 /** Minimal MIME → file extension map for naming uploaded files. */
 const MIME_EXTENSIONS: Record<string, string> = {

infrastructure/web3-adapter/src/w3ds/uri.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from "vitest";
 import {
-	buildFileUri,
 	InvalidW3dsUriError,
+	buildFileUri,
 	isFileUri,
 	parseFileUri,
 } from "./uri";