@aethervtt/shard-platform-tauri 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -7,5 +7,12 @@ export interface TauriPlatformOptions {
      * `<appDataDir>/<project>`. Default `<projectRoot>/.shard/user`.
      */
     dataDir?: string;
+    /** Host-authorized media URL for a project artifact. The host grants its protocol scope first. */
+    mediaUrl?: (projectPath: string) => string;
 }
+/** Host locations for Studio; SDK imports stay behind the platform boundary. */
+export declare function tauriDirectories(): Promise<{
+    home: string;
+    data: string;
+}>;
 export declare function createTauriPlatform(options: TauriPlatformOptions): Platform;

package/dist/index.js

@@ -1,16 +1,24 @@
 import { createWebAudioBackend, createWebWorkers } from "@aethervtt/shard-platform-web";
+import { appDataDir, homeDir } from "@tauri-apps/api/path";
 import {
   exists,
   mkdir,
+  open,
   readDir,
   readFile,
   readTextFile,
   remove,
   rename,
+  SeekMode,
+  stat,
   watch,
   writeFile,
   writeTextFile
 } from "@tauri-apps/plugin-fs";
+import { projectFileChanges } from "./watch-events.js";
+async function tauriDirectories() {
+  return { home: await homeDir(), data: (await appDataDir()).replace(/\/+$/, "") };
+}
 function createTauriStorage(dir) {
   const path = (key) => `${dir}/${key}`;
   const parent = (p) => p.slice(0, p.lastIndexOf("/"));
@@ -43,20 +51,44 @@ function createTauriStorage(dir) {
 function createTauriPlatform(options) {
   const root = options.projectRoot.replace(/\/+$/, "");
   const resolve = (path) => path.startsWith("/") ? path : `${root}/${path}`;
-  const relative = (path) => path.startsWith(`${root}/`) ? path.slice(root.length + 1) : path;
-  const toChange = (event) => {
-    const type = event.type;
-    const kind = typeof type === "object" && "create" in type ? "create" : typeof type === "object" && "remove" in type ? "remove" : "modify";
-    return event.paths.map((path) => ({ kind, path: relative(path) }));
-  };
   const fs = {
     writable: true,
+    ...options.mediaUrl ? { resolveUrl: options.mediaUrl } : {},
     readText: (path) => readTextFile(resolve(path)),
     readBytes: (path) => readFile(resolve(path)),
+    readRange: async (path, offset, length) => {
+      const file = await open(resolve(path), { read: true });
+      try {
+        await file.seek(offset, SeekMode.Start);
+        const out = new Uint8Array(length);
+        let got = 0;
+        while (got < length) {
+          const n = await file.read(out.subarray(got));
+          if (!n) break;
+          got += n;
+        }
+        return got === length ? out : out.subarray(0, got);
+      } finally {
+        await file.close();
+      }
+    },
     writeText: (path, data) => writeTextFile(resolve(path), data),
     writeBytes: (path, data) => writeFile(resolve(path), data),
     exists: (path) => exists(resolve(path)),
-    watch: async (path, onChange) => watch(resolve(path), (event) => toChange(event).forEach(onChange), {
+    remove: async (path) => {
+      if (await exists(resolve(path))) await remove(resolve(path));
+    },
+    stat: async (path) => {
+      if (!await exists(resolve(path))) return void 0;
+      const info = await stat(resolve(path));
+      return { size: info.size, mtime: info.mtime?.getTime() ?? 0 };
+    },
+    list: async (path) => {
+      if (!await exists(resolve(path))) return [];
+      const entries = await readDir(resolve(path));
+      return entries.filter((entry) => entry.isDirectory || entry.isFile).map((entry) => ({ name: entry.name, kind: entry.isDirectory ? "dir" : "file" }));
+    },
+    watch: async (path, onChange) => watch(resolve(path), (event) => projectFileChanges(root, event).forEach(onChange), {
       recursive: true,
       delayMs: 50
     })
@@ -84,5 +116,6 @@ function createTauriPlatform(options) {
   };
 }
 export {
-  createTauriPlatform
+  createTauriPlatform,
+  tauriDirectories
 };

package/dist/watch-events.d.ts

@@ -0,0 +1,4 @@
+import type { FileChangeEvent } from '@aethervtt/shard-platform';
+import type { WatchEvent } from '@tauri-apps/plugin-fs';
+/** Reads must never invalidate the source that an observer has just read. */
+export declare function projectFileChanges(root: string, event: WatchEvent): FileChangeEvent[];

package/dist/watch-events.js

@@ -0,0 +1,20 @@
+function projectFileChanges(root, event) {
+  const projectRoot = root.replaceAll("\\", "/").replace(/\/+$/, "");
+  const type = event.type;
+  if (typeof type === "object") {
+    if ("access" in type) return [];
+    if ("modify" in type && type.modify.kind === "metadata" && type.modify.mode === "access-time")
+      return [];
+  }
+  const kind = typeof type === "object" && "create" in type ? "create" : typeof type === "object" && "remove" in type ? "remove" : "modify";
+  return event.paths.map((nativePath) => {
+    const path = nativePath.replaceAll("\\", "/");
+    return {
+      kind,
+      path: path.startsWith(`${projectRoot}/`) ? path.slice(projectRoot.length + 1) : path
+    };
+  });
+}
+export {
+  projectFileChanges
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-platform-tauri",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -16,9 +16,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@aethervtt/shard-core": "0.1.0",
-    "@aethervtt/shard-platform": "0.1.0",
-    "@aethervtt/shard-platform-web": "0.1.0",
+    "@aethervtt/shard-core": "0.2.1",
+    "@aethervtt/shard-platform": "0.2.1",
+    "@aethervtt/shard-platform-web": "0.2.1",
     "@tauri-apps/api": "^2.11.1",
     "@tauri-apps/plugin-fs": "^2.5.2"
   },
@@ -32,6 +32,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "8e14c9896f82a3554b156f1ffdd68f2cc3e7d78a"
+    "buildSha": "772eb0d2b8a5fc499105708f4ae92c58788cc9ea"
   }
 }