DLsiteGameVaultPlugin 0.2.0

DLsiteGameVaultPlugin 0.2.0

Install dlsite-0.2.0.zip with its matching
SHA256SUMS, not a source archive. Target: GameVault 17.0.1 / 859d71e.

Required environment migration

Rename every explicitly configured old variable before restarting:

0.1.0 name (removed)	0.2.0 name	Default
PLUGIN_GAMESGAO_DLSITE_LOCALE	PLUGIN_DLSITE_LOCALE	ja_JP
PLUGIN_GAMESGAO_DLSITE_PRIORITY	PLUGIN_DLSITE_PRIORITY	20
PLUGIN_GAMESGAO_DLSITE_REQUEST_INTERVAL_MS	PLUGIN_DLSITE_REQUEST_INTERVAL_MS	500

There are no legacy aliases; leaving old names silently results in the normal
defaults because they are no longer read. Users without explicit variables
need no configuration migration. GameVault's VOLUMES_PLUGINS is unchanged.
Stop the server, replace the whole plugin directory, remove its stale injected
copy where applicable, then restart; see installation.

Optional plugin-only proxy

Set PLUGIN_DLSITE_PROXY_URL=http://proxy.example:8080, or an HTTPS proxy URI.
Optional authentication uses http://USERNAME:PASSWORD@proxy.example:8080;
percent-encode special characters in the username and password separately.
Supported schemes are HTTP and HTTPS, both using CONNECT for HTTPS
destinations. SOCKS is not supported.

The proxy must be reachable from inside the GameVault container.
127.0.0.1 there refers to that container, not the host or another device.
Do not publish your credential-bearing URI in logs or issue reports.

One reusable plugin-owned Undici 7.30.1 agent handles HTML, redirects, JSON
ratings, manual search and cover/background downloads. IGDB and other host
requests are unaffected. No proxy setting means default transport; proxy
failure never falls back to direct access. TLS certificate verification
remains enabled for DLsite and HTTPS proxies; no insecure bypass is offered.
The agent closes on plugin shutdown and transport errors omit raw nested
causes that could contain proxy credentials.

GameVault still validates image bytes, writes files, owns media rows and
performs cleanup. Original image source URLs are explicitly persisted for
same-ID reuse after restart. Failure preservation and user metadata priority
remain intact.

Evidence and limits

Local synthetic HTTPS/CONNECT fixtures verify routing and auth isolation;
the real packaged-plugin host harness verifies media database/file persistence,
same-ID reuse, failures, restart/replacement and removal. Fixtures are not
live DLsite responses. The coordinating agent independently reran all 244
tests, package and proxy/host checks locally. The updated Ubuntu 24.04 / Node
24.21.0 hosted gates also passed,
and the downloaded build artifact passed SHA256 and ZIP integrity checks. No NAS, live-DLsite,
Docker, PostgreSQL, GUI or real 0.1.0-to-0.2.0 persisted upgrade test was run.
See verification for actual commands, counts and coverage.

DLsiteGameVaultPlugin v0.1.0

DLsiteGameVaultPlugin 0.1.0

First native DLsite metadata provider release for GameVault. Matches explicit
work IDs in filenames, supports manual title/ID/work-URL search and remapping,
and saves public metadata plus actual covers/backgrounds through the host.
User metadata wins; (NC) keeps its normal host behavior. No DLsite account,
sidecar, game download or Playnite runtime is required.

Installation

Download the dlsite-0.1.0.zip and SHA256SUMS attachments, not GitHub's
source archives. Verify with shasum -a 256 -c SHA256SUMS. Back up the database
and media, stop GameVault, and extract the ZIP into VOLUMES_PLUGINS
(normally /plugins), yielding dlsite/dlsite.plugin.module.js. Restart and
check the authenticated provider list for exactly one enabled dlsite.
No dependency install is required inside the plugin.

默认日语 ja_JP。解压发布附件到服务端插件目录后重启；文件名有明确 ID 时
自动匹配，无 ID 时手动搜索映射。可设置
PLUGIN_GAMESGAO_DLSITE_LOCALE=zh_CN，但不是自动翻译。
详细安装、配置和排错见 README。

Compatibility and evidence

Tested: GameVault 17.0.1 / 859d71e, Node 26.7.0, SQLite 3.53.4, native macOS.
The package follows the official 17.0.1 ESM loader; it includes no NestJS,
backend implementation or native binaries. Do not assume compatibility with
older CommonJS hosts or every build sharing the 17.0.1 version string.

Local gates passed: 165 core/client tests and 59 adapter tests; line/function/
branch coverage respectively 99.72/100/97.37% and 100/100/93.96%;
typecheck, build and formatting passed. No CI result is claimed.
Opt-in acceptance exercised real authenticated API indexing of synthetic ZIPs,
two public Japanese RJ works, four saved JPEGs, manual remap, forced refresh,
user priority, injected network-failure preservation, restart, same-version
replacement and removal. See
verification.

Important limits

Node 24 LTS is intended but untested here. PostgreSQL, Linux/Windows hosts,
Docker, NAS, GUI and Playnite synchronization were not tested. Live checks do
not cover all ID prefixes, locales or historical catalog layouts. Series and
Features become prefixed tags; Icon has no native destination. Official
Playnite integration does not automatically synchronize this server metadata.

Replace the whole plugin directory while stopped. Persistent source/native
installs must also remove the copied dist/src/modules/dlsite or rebuild clean
host output; deleting only the volume folder can leave the plugin active.
Removal is not a data purge, and only same-version replacement was exercised.
DLsite availability, HTML, ratings and image URLs can change.