@hoardodile/host 0.1.2 → 0.1.4

package/dist/chunks/worker-entry.mjs

@@ -43,6 +43,7 @@ const HOOK_NAMES = [
 	"coverLocal",
 	"listFiles",
 	"imageHashes",
+	"onInstall",
 ]
 
 const API_METHOD_NAMES = [
@@ -283,7 +284,11 @@ function send(message) {
 function approxByteSize(value) {
 	if (value instanceof Uint8Array) return value.byteLength
 	try {
-		return JSON.stringify(value).length * 2
+		// `undefined` (hooks that legitimately return nothing — e.g.
+		// `onInstall`) stringifies to `undefined`, not a string: an empty
+		// payload must size 0, never throw into the Infinity branch.
+		const text = JSON.stringify(value)
+		return (typeof text === "string" ? text : "").length * 2
 	} catch {
 		return Infinity
 	}

package/dist/hoard/index.d.ts

@@ -188,7 +188,8 @@ declare const RESOURCE_DATA_DIR_NAME = "data";
  *   per-version database snapshot), `db-backups/` (manual backups,
  *   only kept for the current version), `snapshots/` (automatic daily
  *   snapshots, only kept for the current version), `resources/<id>/`,
- *   `characters/<id>/`, `plugins/<id>/` (installed content plugins
+ *   `characters/<id>/`, `tags/<id>/` (tag art — see {@link VersionPaths.tag}),
+ *   `plugins/<id>/` (installed content plugins
  *   frozen with that version; the builtin `file` plugin is not stored
  *   here). Old versions are FROZEN: no writes ever land in
  *   `versions/<v>` once a `versions/<v+1>` exists.
@@ -245,10 +246,18 @@ type VersionPaths = {
     resources(): string;
     /** Root folder of all characters in this version: `<root>/versions/<v>/characters`. */
     characters(): string;
+    /** Root folder of all tags in this version: `<root>/versions/<v>/tags`. */
+    tags(): string;
     /** Root folder of all documents in this version: `<root>/versions/<v>/documents`. */
     documents(): string;
     /** Root folder of a character: `<root>/versions/<v>/characters/<id>`. */
     character(id: string): string;
+    /**
+     * Root folder of a tag: `<root>/versions/<v>/tags/<id>`. Holds the
+     * tag's single image slot (`image.<ext>`), the same convention as
+     * character avatar/fullbody slots.
+     */
+    tag(id: string): string;
     /** Root of manual backups: `<root>/versions/<v>/db-backups`. */
     dbBackups(): string;
     /** Path to one manual backup: `<root>/versions/<v>/db-backups/<name>`. */
@@ -263,7 +272,7 @@ type VersionPaths = {
      * delete cannot remove a folder whose files live under frozen past
      * archives.
      */
-    deletedMarker(kind: "resources" | "characters", id: string): string;
+    deletedMarker(kind: "resources" | "characters" | "tags", id: string): string;
     /** Root folder of a document: `<root>/versions/<v>/documents/<id>`. */
     document(id: string): string;
     /**
@@ -290,11 +299,11 @@ type LocalPaths = {
     logs(): string;
     /**
      * Path to a local derived cover/thumb variant:
-     * `<localRoot>/cache/<resources|characters>/<id>/<variant>.<format>`.
+     * `<localRoot>/cache/<resources|characters|tags>/<id>/<variant>.<format>`.
      * Holds synthesized covers (resource covers, character avatars and
-     * fullbody images); re-rendered when cleared.
+     * fullbody images, tag art); re-rendered when cleared.
      */
-    localCover(subjectKind: "resource" | "character", id: string, variant: string, format?: string): string;
+    localCover(subjectKind: "resource" | "character" | "tag", id: string, variant: string, format?: string): string;
     /**
      * Per-file derived image variant:
      * `<localRoot>/cache/resources/<id>/file-preview/<sourceCacheId>__<variantKey>.<format>`.
@@ -320,6 +329,13 @@ type LocalPaths = {
      * (b) thumbnail variants (`avatar.webp`, `fullbody.webp`).
      */
     character(id: string): string;
+    /**
+     * Root of the local per-tag directory:
+     * `<localRoot>/cache/tags/<id>`.
+     * Holds (a) versioned copies of replaced tag art and (b) the tag
+     * thumbnail variant (`image.avif`).
+     */
+    tag(id: string): string;
     /** Root of the trash: `<localRoot>/trash`. */
     trash(): string;
     /** Path to a single trashed item: `<localRoot>/trash/<id>`. */
@@ -677,6 +693,7 @@ declare function versionedDbFile(root: string, v: number): string;
  */
 declare function versionedPath(root: string, v: number): string;
 
+type VersionedFolderSubjectKind = "resource" | "character" | "tag";
 type VersionedFolderOps = {
     /** Ensure the current-version entity folder exists. */
     ensureFolder(id: string): Promise<void>;
@@ -696,21 +713,9 @@ type VersionedFolderOps = {
      */
     moveFolderToTrash(id: string): Promise<string>;
 };
-/**
- * The four lifecycle operations shared by the resource and character
- * file-system layers. They differ only in which versioned folder they
- * target and how the trash / placeholder names are derived.
- *
- * `moveFolderToTrash` treats `EPERM`/`EBUSY`/`UNKNOWN` as transient Windows
- * locks (a file inside the folder is still open) and leaves the source in
- * place; a boot-time orphan sweep reclaims it later.
- *
- * `readOnly` is a live `{ current: boolean }` ref (the server's runtime
- * read-only flag), so a version switch mid-request re-reads it.
- */
 declare function buildVersionedFolderOps(paths: StoragePaths, readOnly: {
     readonly current: boolean;
-}, kind: "resource" | "character"): VersionedFolderOps;
+}, kind: VersionedFolderSubjectKind): VersionedFolderOps;
 /**
  * Move every file in `sourceFolder` whose name matches `match` into
  * `destFolder` under a timestamped archive name (`<prefix><stamp><ext>`, or
@@ -748,4 +753,4 @@ type VersionedWriteCommand<T> = (paths: StoragePaths["latest"]) => T | Promise<T
  */
 declare function writeVersioned<T>(paths: StoragePaths, readOnly: boolean, cmd: VersionedWriteCommand<T>): Promise<T>;
 
-export { type CreateNextVersionResult, type CreateStoragePathsOptions, type DirSizeOptions, type LocalPaths, ORDER_MANIFEST_NAME, type OccupiedNames, PluginVaultPathError, RESOURCE_DATA_DIR_NAME, type StoragePaths, type VaultCommitResult, type VersionPaths, type VersionedFolderOps, type VersionedWriteCommand, archiveStaleFiles, assertInside, assertSafeSegment, buildVersionedFolderOps, commitVaultFile, createNextVersion, createOccupiedNames, createStoragePaths, currentVersion, discardVaultTempFile, ensureBootstrapVersion, extractArchiveInto, findStagedArchiveFile, findStagedPoolFile, imageVariantKey, listArchiveEntries, listVersions, naturalSort, occupyEntryName, orderEntries, orderManifestPath, parseOrderManifest, parsePluginVaultDest, readActiveVersion, readOrderManifest, removeStagedPoolFile, resolveStagedPoolFiles, sanitizeEntryName, sumDirSizes, uniqueEntryName, validateArchiveBudget, vaultFileSha256, vaultReadFile, vaultRemoveFile, vaultStatFile, vaultTempFile, vaultTotalSize, versionedDbFile, versionedPath, writeActiveVersion, writeOrderManifest, writeStagedArchiveFile, writeStagedPoolFile, writeVersioned };
+export { type CreateNextVersionResult, type CreateStoragePathsOptions, type DirSizeOptions, type LocalPaths, ORDER_MANIFEST_NAME, type OccupiedNames, PluginVaultPathError, RESOURCE_DATA_DIR_NAME, type StoragePaths, type VaultCommitResult, type VersionPaths, type VersionedFolderOps, type VersionedFolderSubjectKind, type VersionedWriteCommand, archiveStaleFiles, assertInside, assertSafeSegment, buildVersionedFolderOps, commitVaultFile, createNextVersion, createOccupiedNames, createStoragePaths, currentVersion, discardVaultTempFile, ensureBootstrapVersion, extractArchiveInto, findStagedArchiveFile, findStagedPoolFile, imageVariantKey, listArchiveEntries, listVersions, naturalSort, occupyEntryName, orderEntries, orderManifestPath, parseOrderManifest, parsePluginVaultDest, readActiveVersion, readOrderManifest, removeStagedPoolFile, resolveStagedPoolFiles, sanitizeEntryName, sumDirSizes, uniqueEntryName, validateArchiveBudget, vaultFileSha256, vaultReadFile, vaultRemoveFile, vaultStatFile, vaultTempFile, vaultTotalSize, versionedDbFile, versionedPath, writeActiveVersion, writeOrderManifest, writeStagedArchiveFile, writeStagedPoolFile, writeVersioned };

package/dist/hoard/index.js

@@ -1375,8 +1375,10 @@ function createStoragePaths(opts) {
       resourceData: (id) => join6(vRoot, "resources", assertSafeSegment(id), RESOURCE_DATA_DIR_NAME),
       resources: () => join6(vRoot, "resources"),
       characters: () => join6(vRoot, "characters"),
+      tags: () => join6(vRoot, "tags"),
       documents: () => join6(vRoot, "documents"),
       character: (id) => join6(vRoot, "characters", assertSafeSegment(id)),
+      tag: (id) => join6(vRoot, "tags", assertSafeSegment(id)),
       dbBackups: () => join6(vRoot, "db-backups"),
       dbBackup: (name) => join6(vRoot, "db-backups", assertSafeSegment(name)),
       snapshots: () => join6(vRoot, "snapshots"),
@@ -1412,6 +1414,7 @@ function createStoragePaths(opts) {
     resFilesCache: (id) => join6(cacheRoot, "resources", assertSafeSegment(id), "files-cache.json"),
     resource: (id) => join6(cacheRoot, "resources", assertSafeSegment(id)),
     character: (id) => join6(cacheRoot, "characters", assertSafeSegment(id)),
+    tag: (id) => join6(cacheRoot, "tags", assertSafeSegment(id)),
     trash: () => join6(localRoot, "trash"),
     trashItem: (id) => join6(localRoot, "trash", assertSafeSegment(id)),
     tmp: () => join6(cacheRoot, "tmp"),
@@ -1469,7 +1472,7 @@ function createStoragePaths(opts) {
   };
 }
 function localCoverSubjectDir(subjectKind) {
-  return subjectKind === "resource" ? "resources" : "characters";
+  return subjectKind === "resource" ? "resources" : subjectKind === "character" ? "characters" : "tags";
 }
 function toCacheBasename(filename) {
   const dot = filename.lastIndexOf(".");
@@ -1858,10 +1861,25 @@ async function writeVersioned(paths, readOnly, cmd) {
 }
 
 // src/hoard/versioned-folder-ops.ts
+var KIND_LAYOUT = {
+  resource: { trashPrefix: "resources-", deletedKind: "resources" },
+  character: { trashPrefix: "characters-", deletedKind: "characters" },
+  tag: { trashPrefix: "tags-", deletedKind: "tags" }
+};
 function buildVersionedFolderOps(paths, readOnly, kind) {
-  const folderOf = (id) => (current) => kind === "resource" ? current.resource(id) : current.character(id);
-  const trashPrefix = kind === "resource" ? "resources-" : "characters-";
-  const deletedKind = kind === "resource" ? "resources" : "characters";
+  const folderOf = (id) => (current) => {
+    switch (kind) {
+      case "resource":
+        return current.resource(id);
+      case "character":
+        return current.character(id);
+      case "tag":
+        return current.tag(id);
+    }
+  };
+  const layout = KIND_LAYOUT[kind];
+  const trashPrefix = layout.trashPrefix;
+  const deletedKind = layout.deletedKind;
   async function ensureFolder(id) {
     await writeVersioned(
       paths,