Koko210/immich-folio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

release: v0.16.0

Browse Source 
See CHANGELOG.md for the full v0.16.0 entry.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: ralksta <ralksta@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
Co-authored-by: Ralf <rohlenbo79@gmail.com>
Co-authored-by: Paul Thies <110185070+ImScheinox@users.noreply.github.com>
Co-authored-by: lancetm714 <108419425+lancetm714@users.noreply.github.com>
This commit is contained in:
Ralksta
2026-09-22 14:12:13 +02:00
committed by GitHub
parent c3f92ca4ec
commit a3a6319c29
120 changed files with 6818 additions and 975 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
lib/photoHash.ts
View File

@@ -1,14 +1,21 @@
/**
* The `#photo-N` permalink shared by the photo grid and the lightbox.
* Photo permalinks for the grid and the lightbox.
*
* The grid writes and restores it; the lightbox offers a button that copies it
* (#478). The format lives here so the two cannot drift apart.
* `?photo=<assetId>` (assetId is the opaque per-asset token PhotoItem.id
* already carries — see encodeAssetId) is the current format: a query
* parameter, not a hash, because a hash never reaches the server. A hash-only
* permalink got no OG preview card, and it named a *position* in the album
* rather than a photo — reordering the album silently repointed every shared
* link, and so did deleting a photo (#588).
*
* The link is positional, as `gallery.yaml.example` documents: it names a
* place in the album, not an asset, so reordering an album moves where a
* shared link lands.
* `#photo-N` (1-indexed, matching what `gallery.yaml.example` used to
* document) is the format this replaces. Parsing it stays here indefinitely:
* public instances have been sharing those links for months, and this module
* is where the grid and the lightbox both read from, so it cannot drift.
*/
const PHOTO_QUERY_PARAM = 'photo';
/** Parse `#photo-N`. Returns a 0-based index, or null if it is not one. */
export function parsePhotoHash(hash: string): number | null {
const match = hash.match(/^#photo-(\d+)$/);
@@ -17,20 +24,40 @@ export function parsePhotoHash(hash: string): number | null {
return index >= 0 ? index : null;
}
/** The hash for a 0-based index, 1-indexed for the reader. */
/** The legacy hash for a 0-based index, 1-indexed for the reader. */
export function buildPhotoHash(index: number): string {
return `#photo-${index + 1}`;
}
/** Parse `?photo=<assetId>`. Returns the token, or null if it is absent. */
export function parsePhotoQuery(search: string): string | null {
return new URLSearchParams(search).get(PHOTO_QUERY_PARAM);
}
/**
* An absolute permalink to one photo.
* `search`, with `photo` set to `assetId` (or removed, when `assetId` is
* null) and every other query parameter left as it was.
*/
export function buildPhotoQuery(search: string, assetId: string | null): string {
const params = new URLSearchParams(search);
if (assetId === null) {
params.delete(PHOTO_QUERY_PARAM);
} else {
params.set(PHOTO_QUERY_PARAM, assetId);
}
const query = params.toString();
return query ? `?${query}` : '';
}
/**
* An absolute permalink to one photo, addressed by its stable asset id.
*
* Takes the location parts rather than reading `window`, so it is pure and the
* caller does not depend on the grid's hash-sync effect having run yet.
* Takes the location parts rather than reading `window`, so it is pure and
* the caller does not depend on the grid's query-sync effect having run yet.
*/
export function buildPhotoPermalink(
location: { origin: string; pathname: string; search: string },
index: number,
assetId: string,
): string {
return `${location.origin}${location.pathname}${location.search}${buildPhotoHash(index)}`;
return `${location.origin}${location.pathname}${buildPhotoQuery(location.search, assetId)}`;
}