feat(playlists): share playlists with revocable read-only links

packages/core/src/index.ts

@@ -22,7 +22,7 @@ export {
   type Track,
 } from './player';
 export { normalizeGain, TARGET_LUFS } from './gain';
-export { trackShareUrl } from './share';
+export { playlistShareUrl, trackShareUrl } from './share';
 export { checkServer, normalizeServerUrl, type ServerCheck } from './server';
 export { initialWaveState, mix, rgb, rgba, step, WAVE_COLORS, wavePalette, waveScale, type Rgb, type WaveState } from './wave-anim';
 

packages/core/src/share.test.ts

@@ -1,9 +1,14 @@
 import { describe, expect, it } from 'vitest';
 
-import { trackShareUrl } from './share';
+import { playlistShareUrl, trackShareUrl } from './share';
 
 describe('trackShareUrl', () => {
   it('builds a page URL without stream credentials', () => {
     expect(trackShareUrl('https://music.example', 'ab/cd')).toBe('https://music.example/track/ab%2Fcd');
   });
 });
+
+
+it('builds a shared playlist URL from the server without stream credentials', () => {
+  expect(playlistShareUrl('https://music.example/api/v1', 'ab/cd')).toBe('https://music.example/shared/playlist/ab%2Fcd');
+});

packages/core/src/share.ts

@@ -2,3 +2,8 @@
 export function trackShareUrl(server: string, trackId: string): string {
   return new URL(`/track/${encodeURIComponent(trackId)}`, server).href;
 }
+
+/** Revocable read-only playlist page; requires a listener account on this server. */
+export function playlistShareUrl(server: string, shareId: string): string {
+  return new URL(`/shared/playlist/${encodeURIComponent(shareId)}`, server).href;
+}