@opfelmusig/lib 0.0.0-ci.0.sha-3e76884

package/dist/schemas/request.d.ts

@@ -0,0 +1,42 @@
+import z from "zod";
+export declare const RelationshipModeSchema: z.ZodEnum<{
+    include: "include";
+    relate: "relate";
+}>;
+export declare const RelationshipConfigSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    include: "include";
+    relate: "relate";
+}>, z.ZodObject<{
+    mode: z.ZodEnum<{
+        include: "include";
+        relate: "relate";
+    }>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>;
+export declare const ViewConfigSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    limit: z.ZodNumber;
+}, z.core.$strip>]>;
+export declare const ScopeSchema: z.ZodObject<{
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extend: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    relationships: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
+        include: "include";
+        relate: "relate";
+    }>, z.ZodObject<{
+        mode: z.ZodEnum<{
+            include: "include";
+            relate: "relate";
+        }>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>;
+    views: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        limit: z.ZodNumber;
+    }, z.core.$strip>]>>>;
+}, z.core.$strict>;
+export declare const ScopesSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type Scope = z.infer<typeof ScopeSchema>;
+export declare const ShapeSchema: z.ZodObject<{
+    types: z.ZodArray<z.ZodString>;
+    with: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type Shape = z.infer<typeof ShapeSchema>;

package/dist/schemas/request.js

@@ -0,0 +1,28 @@
+import z from "zod";
+export const RelationshipModeSchema = z.enum(["include", "relate"]);
+export const RelationshipConfigSchema = z.union([
+    RelationshipModeSchema,
+    z.object({
+        mode: RelationshipModeSchema,
+        limit: z.number().int().positive().optional(),
+    }),
+]);
+export const ViewConfigSchema = z.union([
+    z.boolean(),
+    z.object({
+        limit: z.number().int().positive(),
+    }),
+]);
+export const ScopeSchema = z
+    .strictObject({
+    fields: z.array(z.string()),
+    extend: z.array(z.string()),
+    relationships: z.record(z.string(), RelationshipConfigSchema),
+    views: z.record(z.string(), ViewConfigSchema),
+})
+    .partial();
+export const ScopesSchema = z.record(z.string(), z.unknown());
+export const ShapeSchema = z.strictObject({
+    types: z.array(z.string()),
+    with: z.array(z.string()).optional(),
+});

package/dist/types/combined.d.ts

@@ -0,0 +1,15 @@
+import type { ResourceOf, ValidateResourceName } from "../types/query/helpers.js";
+export type PinnableResources = ResourceOf<"library-albums" | "library-artists" | "library-music-videos" | "library-playlists" | "library-songs">;
+export type RecentlyAddedResources = ResourceOf<"library-albums" | "library-playlists">;
+export type CatalogResourceTypes = ValidateResourceName<"activities" | "albums" | "apple-curators" | "artists" | "concerts" | "credit-artists" | "curators" | "genres" | "music-videos" | "playlists" | "record-labels" | "role-categories" | "songs" | "stations" | "station-genres" | "lyrics" | "syllable-lyrics" | "venues">;
+export type LibraryResourceTypes = ValidateResourceName<"library-albums" | "library-artists" | "library-music-videos" | "library-playlist-folders" | "library-playlists" | "library-songs">;
+export type MeResourceTypes = ValidateResourceName<"genre-period-summaries" | "playlist-period-summaries" | "artist-period-summaries" | "monthly-song-period-summaries" | "song-period-summaries" | "album-period-summaries" | "music-summaries" | "station-period-summaries" | "personal-social-profiles" | "ratings" | "personal-recommendation">;
+export type SocialResourceTypes = ValidateResourceName<"social-profiles">;
+export type OtherResourceTypes = ValidateResourceName<"storefronts">;
+export type ResourceTypes = ValidateResourceName<CatalogResourceTypes | LibraryResourceTypes | MeResourceTypes | SocialResourceTypes | OtherResourceTypes>;
+export type CatalogResources = ResourceOf<CatalogResourceTypes>;
+export type LibraryResources = ResourceOf<LibraryResourceTypes>;
+export type MeResources = ResourceOf<MeResourceTypes>;
+export type SocialResources = ResourceOf<SocialResourceTypes>;
+export type OtherResources = ResourceOf<OtherResourceTypes>;
+export type Resources = ResourceOf<ResourceTypes>;

package/dist/types/config.d.ts

@@ -0,0 +1,63 @@
+export interface LanguageConfig {
+    /** Default language used for the whole catalog, use one of the users storefront languages */
+    default?: string;
+    /** Default lyrics language */
+    lyrics?: string;
+    /** Default script language, be sure to have lyrics language defined if this is set */
+    script?: string;
+}
+export type TokenProvider = string | null | (() => string | undefined | Promise<string | undefined>);
+export interface HttpEvent {
+    method: string;
+    url: string;
+    status?: number;
+    statusText?: string;
+    durationMs: number;
+    response?: unknown;
+    error?: {
+        name: string;
+        message: string;
+    };
+}
+export interface OpfelMusigConfig {
+    developerToken?: TokenProvider;
+    userToken?: TokenProvider;
+    language?: LanguageConfig;
+    /** The storefront used, be sure to set this to the user storefront */
+    storefront?: string;
+    /**
+     * Override the api base url to add a proxy.
+     *
+     * Proxy the request to `https://amp-api.music.apple.com`
+     */
+    baseUrl?: string;
+    /**
+     * Excludes the origin header for proxies.
+     * Make sure the proxy adds the header back in.
+     *
+     * Required Headers:
+     * - `origin: https://music.apple.com`
+     * - `Authorization: Bearer {DEVELOPER_TOKEN}`
+     *
+     * Optional Headers:
+     * - `Music-User-Token: {USER_TOKEN}` // fetch user library
+     * - `Media-User-Token: {USER_TOKEN}` // streaming
+     *
+     * On your proxy you can import `getDefaultHeaders` from `/helpers`.
+     */
+    excludeOrigin?: boolean;
+    extraHeaders?: Record<string, string>;
+    /**
+     * Custom fetch implementation. Defaults to `globalThis.fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+    onHttpEvent?: (event: HttpEvent) => void | Promise<void>;
+    debug?: boolean;
+}
+export interface RequestConfig {
+    language?: LanguageConfig;
+    storefront?: string;
+    extraParams?: Record<string, string>;
+    extraHeaders?: Record<string, string>;
+    signal?: AbortSignal;
+}

package/dist/types/params.d.ts

@@ -0,0 +1,22 @@
+import type { RequestConfig } from "../types/config.js";
+import type { AnyResult, ResultShape } from "../types/query/results.js";
+import type { ResourceScopes } from "../types/query/scopes.js";
+export interface LimitParam {
+    limit?: number;
+}
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+}
+export interface ConfigParm {
+    config?: RequestConfig;
+}
+export interface DefaultParams<TScopes extends ResourceScopes = {}> extends ConfigParm {
+    scopes?: TScopes & ResourceScopes;
+}
+export interface ResultParams<TResult extends AnyResult, TTypes extends ResultShape<TResult>, TScopes extends ResourceScopes = {}> extends DefaultParams<TScopes> {
+    shape: TTypes & ResultShape<TResult>;
+}
+export interface SortParams<TSort extends string> {
+    sort?: `-${TSort}` | TSort | (string & {});
+}

package/dist/types/playback.d.ts

@@ -0,0 +1,199 @@
+export interface PlaybackSongIds {
+    catalogId?: string;
+    libraryId?: string;
+}
+export interface PlaybackAssetMetadata {
+    bitRate?: number;
+    duration?: number;
+    fileExtension?: string;
+}
+export interface PlaybackAsset {
+    URL: string;
+    flavor?: string;
+    metadata?: PlaybackAssetMetadata;
+}
+export interface PlaybackSong {
+    assets: PlaybackAsset[];
+    needsPlaybackReporting?: boolean;
+    songId: string | number;
+    "widevine-cert-url"?: string;
+    "hls-key-server-url"?: string;
+}
+export interface PlaybackResponse {
+    songList?: PlaybackSong[];
+    status?: number;
+}
+export declare enum PlayActivityEventType {
+    PlayEnd = 0,
+    PlayStart = 1
+}
+export declare enum PlayActivityEndReasonType {
+    NotApplicable = 0,
+    Other = 1,
+    TrackSkippedForwards = 2,
+    PlaybackManuallyPaused = 3,
+    PlaybackSuspended = 4,
+    ManuallySelectedPlaybackOfDifferentItem = 5,
+    PlaybackPausedDueToInactivity = 6,
+    NaturalEndOfTrack = 7,
+    PlaybackStoppedDueToSessionTimeout = 8,
+    TrackBanned = 9,
+    FailedToLoad = 10,
+    PausedOnTimeout = 11,
+    ScrubBegin = 12,
+    ScrubEnd = 13,
+    TrackSkippedBackwards = 14,
+    NotSupportedByClient = 15,
+    QuickPlay = 16,
+    ExitedApplication = 17
+}
+export declare enum PlayActivityEventReasonHintType {
+    NotSpecified = 0,
+    ContainerChanged = 1
+}
+export declare enum PlayActivityContainerType {
+    Unknown = 0,
+    Radio = 1,
+    Playlist = 2,
+    Album = 3,
+    Artist = 4
+}
+export declare enum PlayActivityItemType {
+    Invalid = 0,
+    ItunesStoreContent = 1,
+    NonSongClip = 2,
+    Ad = 3,
+    Stream = 4,
+    AudioAd = 5,
+    VideoAd = 6,
+    TimedMetadataPing = 7,
+    ArtistUploadedContent = 8,
+    AggregateNonCatalogPlayTime = 9,
+    OriginalContentMovies = 10,
+    OriginalContentShows = 11
+}
+export declare enum PlayActivityMediaType {
+    Audio = 0,
+    Video = 1
+}
+export declare enum PlayActivitySourceType {
+    OriginatingDevice = 0,
+    PairedWatch = 1,
+    Sonos = 2,
+    CarPlay = 3,
+    WebAuc = 4,
+    TwitterAuc = 5,
+    MusicSdk = 6,
+    AtvRemote = 7,
+    WebPlayer = 8,
+    WholeHouseAudio = 9,
+    MusicKit = 10,
+    Vw = 11,
+    Unknown = 12,
+    Amazon = 13,
+    Porsche = 14,
+    Chromecast = 15,
+    WebApp = 16,
+    MercedesBenz = 17,
+    ThirdPartyTv = 18,
+    Seat = 19,
+    Cupra = 20
+}
+export declare enum PlayActivityRepeatMode {
+    Unknown = 0,
+    Off = 1,
+    One = 2,
+    All = 3
+}
+export declare enum PlayActivityShuffleMode {
+    Unknown = 0,
+    Off = 1,
+    On = 2
+}
+export declare enum PlayActivityAutoplayMode {
+    Unknown = 0,
+    Off = 1,
+    On = 2,
+    OnContentUnsupported = 3
+}
+export interface PlayActivityIds {
+    "auc-adam-id"?: string | number;
+    "cloud-id"?: string;
+    "lyric-id"?: string | number;
+    "purchased-adam-id"?: string | number;
+    "radio-adam-id"?: string | number;
+    "reporting-adam-id"?: string | number;
+    "subscription-adam-id"?: string | number;
+}
+export interface PlayActivityContainerIds {
+    "album-adam-id"?: string | number;
+    "global-playlist-id"?: string;
+    "station-hash"?: string;
+    "station-id"?: string;
+    "universal-library-id"?: string;
+}
+export interface PlayActivityPlayMode {
+    "auto-play-mode": PlayActivityAutoplayMode;
+    "repeat-play-mode": PlayActivityRepeatMode;
+    "shuffle-play-mode": PlayActivityShuffleMode;
+}
+interface PlayActivityEventBase {
+    "build-version": string;
+    "internal-build": boolean;
+    "media-duration-in-milliseconds": number;
+    "media-type": PlayActivityMediaType;
+    "milliseconds-since-play": number;
+    offline: boolean;
+    "persistent-id": string;
+    "play-mode": PlayActivityPlayMode;
+    "private-enabled": boolean;
+    "sb-enabled": boolean;
+    "siri-initiated": boolean;
+    "source-type": PlayActivitySourceType;
+    "start-position-in-milliseconds": number;
+    "store-front": string;
+    "user-agent": string;
+    "utc-offset-in-seconds": number;
+}
+interface PlayActivityIdentifiedEvent extends PlayActivityEventBase {
+    "container-ids"?: PlayActivityContainerIds;
+    "container-type": PlayActivityContainerType;
+    "feature-name": string;
+    ids: PlayActivityIds;
+    "reco-data"?: string;
+    type: Exclude<PlayActivityItemType, PlayActivityItemType.AggregateNonCatalogPlayTime>;
+}
+export interface PlayActivityStartEvent extends PlayActivityIdentifiedEvent {
+    "end-position-in-milliseconds"?: never;
+    "end-reason-type"?: never;
+    "event-reason-hint-type": PlayActivityEventReasonHintType;
+    "event-type": PlayActivityEventType.PlayStart;
+}
+export interface PlayActivityEndEvent extends PlayActivityIdentifiedEvent {
+    "end-position-in-milliseconds": number;
+    "end-reason-type": PlayActivityEndReasonType;
+    "event-reason-hint-type"?: never;
+    "event-type": PlayActivityEventType.PlayEnd;
+}
+export interface PlayActivityAggregateEndEvent extends PlayActivityEventBase {
+    "container-type"?: never;
+    "end-position-in-milliseconds": number;
+    "end-reason-type": PlayActivityEndReasonType.NotApplicable;
+    "event-reason-hint-type"?: never;
+    "event-type": PlayActivityEventType.PlayEnd;
+    "feature-name"?: never;
+    ids?: never;
+    "play-mode": {
+        "auto-play-mode": PlayActivityAutoplayMode.Unknown;
+        "repeat-play-mode": PlayActivityRepeatMode.Unknown;
+        "shuffle-play-mode": PlayActivityShuffleMode.Unknown;
+    };
+    "start-position-in-milliseconds": 0;
+    type: PlayActivityItemType.AggregateNonCatalogPlayTime;
+    "utc-offset-in-seconds": 0;
+}
+export type PlayActivityEvent = PlayActivityStartEvent | PlayActivityEndEvent | PlayActivityAggregateEndEvent;
+export interface PlayActivityResponse {
+    [key: string]: unknown;
+}
+export {};

package/dist/types/playback.js

@@ -0,0 +1,103 @@
+export var PlayActivityEventType;
+(function (PlayActivityEventType) {
+    PlayActivityEventType[PlayActivityEventType["PlayEnd"] = 0] = "PlayEnd";
+    PlayActivityEventType[PlayActivityEventType["PlayStart"] = 1] = "PlayStart";
+})(PlayActivityEventType || (PlayActivityEventType = {}));
+export var PlayActivityEndReasonType;
+(function (PlayActivityEndReasonType) {
+    PlayActivityEndReasonType[PlayActivityEndReasonType["NotApplicable"] = 0] = "NotApplicable";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["Other"] = 1] = "Other";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["TrackSkippedForwards"] = 2] = "TrackSkippedForwards";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["PlaybackManuallyPaused"] = 3] = "PlaybackManuallyPaused";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["PlaybackSuspended"] = 4] = "PlaybackSuspended";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["ManuallySelectedPlaybackOfDifferentItem"] = 5] = "ManuallySelectedPlaybackOfDifferentItem";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["PlaybackPausedDueToInactivity"] = 6] = "PlaybackPausedDueToInactivity";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["NaturalEndOfTrack"] = 7] = "NaturalEndOfTrack";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["PlaybackStoppedDueToSessionTimeout"] = 8] = "PlaybackStoppedDueToSessionTimeout";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["TrackBanned"] = 9] = "TrackBanned";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["FailedToLoad"] = 10] = "FailedToLoad";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["PausedOnTimeout"] = 11] = "PausedOnTimeout";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["ScrubBegin"] = 12] = "ScrubBegin";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["ScrubEnd"] = 13] = "ScrubEnd";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["TrackSkippedBackwards"] = 14] = "TrackSkippedBackwards";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["NotSupportedByClient"] = 15] = "NotSupportedByClient";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["QuickPlay"] = 16] = "QuickPlay";
+    PlayActivityEndReasonType[PlayActivityEndReasonType["ExitedApplication"] = 17] = "ExitedApplication";
+})(PlayActivityEndReasonType || (PlayActivityEndReasonType = {}));
+export var PlayActivityEventReasonHintType;
+(function (PlayActivityEventReasonHintType) {
+    PlayActivityEventReasonHintType[PlayActivityEventReasonHintType["NotSpecified"] = 0] = "NotSpecified";
+    PlayActivityEventReasonHintType[PlayActivityEventReasonHintType["ContainerChanged"] = 1] = "ContainerChanged";
+})(PlayActivityEventReasonHintType || (PlayActivityEventReasonHintType = {}));
+export var PlayActivityContainerType;
+(function (PlayActivityContainerType) {
+    PlayActivityContainerType[PlayActivityContainerType["Unknown"] = 0] = "Unknown";
+    PlayActivityContainerType[PlayActivityContainerType["Radio"] = 1] = "Radio";
+    PlayActivityContainerType[PlayActivityContainerType["Playlist"] = 2] = "Playlist";
+    PlayActivityContainerType[PlayActivityContainerType["Album"] = 3] = "Album";
+    PlayActivityContainerType[PlayActivityContainerType["Artist"] = 4] = "Artist";
+})(PlayActivityContainerType || (PlayActivityContainerType = {}));
+export var PlayActivityItemType;
+(function (PlayActivityItemType) {
+    PlayActivityItemType[PlayActivityItemType["Invalid"] = 0] = "Invalid";
+    PlayActivityItemType[PlayActivityItemType["ItunesStoreContent"] = 1] = "ItunesStoreContent";
+    PlayActivityItemType[PlayActivityItemType["NonSongClip"] = 2] = "NonSongClip";
+    PlayActivityItemType[PlayActivityItemType["Ad"] = 3] = "Ad";
+    PlayActivityItemType[PlayActivityItemType["Stream"] = 4] = "Stream";
+    PlayActivityItemType[PlayActivityItemType["AudioAd"] = 5] = "AudioAd";
+    PlayActivityItemType[PlayActivityItemType["VideoAd"] = 6] = "VideoAd";
+    PlayActivityItemType[PlayActivityItemType["TimedMetadataPing"] = 7] = "TimedMetadataPing";
+    PlayActivityItemType[PlayActivityItemType["ArtistUploadedContent"] = 8] = "ArtistUploadedContent";
+    PlayActivityItemType[PlayActivityItemType["AggregateNonCatalogPlayTime"] = 9] = "AggregateNonCatalogPlayTime";
+    PlayActivityItemType[PlayActivityItemType["OriginalContentMovies"] = 10] = "OriginalContentMovies";
+    PlayActivityItemType[PlayActivityItemType["OriginalContentShows"] = 11] = "OriginalContentShows";
+})(PlayActivityItemType || (PlayActivityItemType = {}));
+export var PlayActivityMediaType;
+(function (PlayActivityMediaType) {
+    PlayActivityMediaType[PlayActivityMediaType["Audio"] = 0] = "Audio";
+    PlayActivityMediaType[PlayActivityMediaType["Video"] = 1] = "Video";
+})(PlayActivityMediaType || (PlayActivityMediaType = {}));
+export var PlayActivitySourceType;
+(function (PlayActivitySourceType) {
+    PlayActivitySourceType[PlayActivitySourceType["OriginatingDevice"] = 0] = "OriginatingDevice";
+    PlayActivitySourceType[PlayActivitySourceType["PairedWatch"] = 1] = "PairedWatch";
+    PlayActivitySourceType[PlayActivitySourceType["Sonos"] = 2] = "Sonos";
+    PlayActivitySourceType[PlayActivitySourceType["CarPlay"] = 3] = "CarPlay";
+    PlayActivitySourceType[PlayActivitySourceType["WebAuc"] = 4] = "WebAuc";
+    PlayActivitySourceType[PlayActivitySourceType["TwitterAuc"] = 5] = "TwitterAuc";
+    PlayActivitySourceType[PlayActivitySourceType["MusicSdk"] = 6] = "MusicSdk";
+    PlayActivitySourceType[PlayActivitySourceType["AtvRemote"] = 7] = "AtvRemote";
+    PlayActivitySourceType[PlayActivitySourceType["WebPlayer"] = 8] = "WebPlayer";
+    PlayActivitySourceType[PlayActivitySourceType["WholeHouseAudio"] = 9] = "WholeHouseAudio";
+    PlayActivitySourceType[PlayActivitySourceType["MusicKit"] = 10] = "MusicKit";
+    PlayActivitySourceType[PlayActivitySourceType["Vw"] = 11] = "Vw";
+    PlayActivitySourceType[PlayActivitySourceType["Unknown"] = 12] = "Unknown";
+    PlayActivitySourceType[PlayActivitySourceType["Amazon"] = 13] = "Amazon";
+    PlayActivitySourceType[PlayActivitySourceType["Porsche"] = 14] = "Porsche";
+    PlayActivitySourceType[PlayActivitySourceType["Chromecast"] = 15] = "Chromecast";
+    PlayActivitySourceType[PlayActivitySourceType["WebApp"] = 16] = "WebApp";
+    PlayActivitySourceType[PlayActivitySourceType["MercedesBenz"] = 17] = "MercedesBenz";
+    PlayActivitySourceType[PlayActivitySourceType["ThirdPartyTv"] = 18] = "ThirdPartyTv";
+    PlayActivitySourceType[PlayActivitySourceType["Seat"] = 19] = "Seat";
+    PlayActivitySourceType[PlayActivitySourceType["Cupra"] = 20] = "Cupra";
+})(PlayActivitySourceType || (PlayActivitySourceType = {}));
+export var PlayActivityRepeatMode;
+(function (PlayActivityRepeatMode) {
+    PlayActivityRepeatMode[PlayActivityRepeatMode["Unknown"] = 0] = "Unknown";
+    PlayActivityRepeatMode[PlayActivityRepeatMode["Off"] = 1] = "Off";
+    PlayActivityRepeatMode[PlayActivityRepeatMode["One"] = 2] = "One";
+    PlayActivityRepeatMode[PlayActivityRepeatMode["All"] = 3] = "All";
+})(PlayActivityRepeatMode || (PlayActivityRepeatMode = {}));
+export var PlayActivityShuffleMode;
+(function (PlayActivityShuffleMode) {
+    PlayActivityShuffleMode[PlayActivityShuffleMode["Unknown"] = 0] = "Unknown";
+    PlayActivityShuffleMode[PlayActivityShuffleMode["Off"] = 1] = "Off";
+    PlayActivityShuffleMode[PlayActivityShuffleMode["On"] = 2] = "On";
+})(PlayActivityShuffleMode || (PlayActivityShuffleMode = {}));
+export var PlayActivityAutoplayMode;
+(function (PlayActivityAutoplayMode) {
+    PlayActivityAutoplayMode[PlayActivityAutoplayMode["Unknown"] = 0] = "Unknown";
+    PlayActivityAutoplayMode[PlayActivityAutoplayMode["Off"] = 1] = "Off";
+    PlayActivityAutoplayMode[PlayActivityAutoplayMode["On"] = 2] = "On";
+    PlayActivityAutoplayMode[PlayActivityAutoplayMode["OnContentUnsupported"] = 3] = "OnContentUnsupported";
+})(PlayActivityAutoplayMode || (PlayActivityAutoplayMode = {}));

package/dist/types/public.d.ts

@@ -0,0 +1,56 @@
+import type { CatalogActivity } from "../types/resources/catalog/activity.js";
+import type { CatalogAlbum } from "../types/resources/catalog/album.js";
+import type { CatalogArtist } from "../types/resources/catalog/artist.js";
+import type { CatalogConcert } from "../types/resources/catalog/concert.js";
+import type { CatalogCreditArtist } from "../types/resources/catalog/creditArtist.js";
+import type { CatalogAppleCurator, CatalogCurator } from "../types/resources/catalog/curator.js";
+import type { CatalogGenre } from "../types/resources/catalog/genre.js";
+import type { CatalogLyrics } from "../types/resources/catalog/lyrics.js";
+import type { CatalogMusicVideo } from "../types/resources/catalog/musicVideo.js";
+import type { CatalogPlaylist } from "../types/resources/catalog/playlist.js";
+import type { CatalogRecordLabel } from "../types/resources/catalog/recordLabel.js";
+import type { CatalogRoleCategory } from "../types/resources/catalog/roleCategory.js";
+import type { CatalogSong } from "../types/resources/catalog/song.js";
+import type { CatalogStation } from "../types/resources/catalog/station.js";
+import type { CatalogStationGenre } from "../types/resources/catalog/stationGenre.js";
+import type { CatalogSyllableLyrics } from "../types/resources/catalog/syllableLyrics.js";
+import type { CatalogVenue } from "../types/resources/catalog/venue.js";
+import type { LibraryAlbum } from "../types/resources/library/album.js";
+import type { LibraryArtist } from "../types/resources/library/artist.js";
+import type { LibraryMusicVideo } from "../types/resources/library/musicVideo.js";
+import type { LibraryPlaylist } from "../types/resources/library/playlist.js";
+import type { LibraryPlaylistFolder } from "../types/resources/library/playlistFolder.js";
+import type { LibrarySong } from "../types/resources/library/song.js";
+import type { MusicSummary } from "../types/resources/me/musicSummary.js";
+import type { PersonalSocialProfile } from "../types/resources/me/profile.js";
+import type { Rating, RatingResources } from "../types/resources/me/rating.js";
+import type { Recommendation } from "../types/resources/me/recommendation.js";
+import type { AlbumPeriodSummary } from "../types/resources/me/summaries/albumPeriodSummary.js";
+import type { ArtistPeriodSummary } from "../types/resources/me/summaries/artistPeriodSummary.js";
+import type { GenrePeriodSummary } from "../types/resources/me/summaries/genrePeriodSummary.js";
+import type { MonthlySongPeriodSummary } from "../types/resources/me/summaries/monthlySongPeriodSummary.js";
+import type { PlaylistPeriodSummary } from "../types/resources/me/summaries/playlistPeriodSummary.js";
+import type { SongPeriodSummary } from "../types/resources/me/summaries/songPeriodSummary.js";
+import type { StationPeriodSummary } from "../types/resources/me/summaries/stationPeriodSummary.js";
+import type { Storefront } from "../types/resources/other/storefront.js";
+export type { AnyResource } from "../types/query/resource.js";
+export type { Registry } from "../types/query/registry.js";
+export type { ResourceResponse } from "../types/query/response.js";
+export type { ResourceScopes, ScopedResource, ScopedResourceOf } from "../types/query/scopes.js";
+export type { PlayActivityAggregateEndEvent, PlayActivityContainerIds, PlayActivityEndEvent, PlayActivityEvent, PlayActivityIds, PlayActivityPlayMode, PlayActivityResponse, PlayActivityStartEvent, PlaybackAsset, PlaybackAssetMetadata, PlaybackResponse, PlaybackSong, PlaybackSongIds, } from "../types/playback.js";
+export { PlayActivityAutoplayMode, PlayActivityContainerType, PlayActivityEndReasonType, PlayActivityEventReasonHintType, PlayActivityEventType, PlayActivityItemType, PlayActivityMediaType, PlayActivityRepeatMode, PlayActivityShuffleMode, PlayActivitySourceType, } from "../types/playback.js";
+export type { Artwork, ArtworkColor, AudioVariants, ContentRating, Description, EditorialNote, PlayParameters, Preview, RatingValue, MotionVideo, EditorialVideo, } from "../types/shared.js";
+type Song = CatalogSong | LibrarySong;
+export type { CatalogSong, LibrarySong, Song };
+type Album = CatalogAlbum | LibraryAlbum;
+export type { Album, CatalogAlbum, LibraryAlbum };
+type Artist = CatalogArtist | LibraryArtist;
+export type { Artist, CatalogArtist, LibraryArtist };
+type MusicVideo = CatalogMusicVideo | LibraryMusicVideo;
+export type { CatalogMusicVideo, LibraryMusicVideo, MusicVideo };
+type Playlist = CatalogPlaylist | LibraryPlaylist;
+export type { CatalogPlaylist, LibraryPlaylist, Playlist };
+export type { CatalogActivity, CatalogAppleCurator, CatalogConcert, CatalogCreditArtist, CatalogCurator, CatalogGenre, CatalogLyrics, CatalogRecordLabel, CatalogRoleCategory, CatalogStation, CatalogStationGenre, CatalogSyllableLyrics, CatalogVenue, LibraryPlaylistFolder, };
+export type { AlbumPeriodSummary, ArtistPeriodSummary, GenrePeriodSummary, MonthlySongPeriodSummary, MusicSummary, PlaylistPeriodSummary, PersonalSocialProfile, RatingResources, Rating, Recommendation, SongPeriodSummary, StationPeriodSummary, };
+export type { Storefront };
+export type * from "../types/combined.js";

package/dist/types/public.js

@@ -0,0 +1 @@
+export { PlayActivityAutoplayMode, PlayActivityContainerType, PlayActivityEndReasonType, PlayActivityEventReasonHintType, PlayActivityEventType, PlayActivityItemType, PlayActivityMediaType, PlayActivityRepeatMode, PlayActivityShuffleMode, PlayActivitySourceType, } from "../types/playback.js";

package/dist/types/query/helpers.d.ts

@@ -0,0 +1,27 @@
+import type { Registry } from "../../types/query/registry.js";
+import type { AnyResource, AttributeNames, AttributesOf, Collection, ExtendableNames, ExtendablesOf, RelationshipNames, ResourceLink, ViewNames } from "../../types/query/resource.js";
+import type { internalAttributesSymbol, internalExtendablesSymbol, RelationshipItem, ViewItem } from "../../types/query/scopes.js";
+export type ResourceOf<TKey extends keyof Registry> = Registry[TKey];
+export type ValidateResourceName<TKey extends keyof Registry> = TKey;
+type RelationshipCollections<TRelationships> = {
+    [K in keyof TRelationships as K extends string ? K : never]: Collection<NonNullable<TRelationships[K]>>;
+} & Record<never, never>;
+type ResourceTemplateRelationships<TResource extends AnyResource> = {
+    [K in RelationshipNames<TResource>]?: ResourceTemplate<RelationshipItem<TResource, K>>;
+};
+type ResourceTemplateViews<TResource extends AnyResource> = {
+    [K in ViewNames<TResource>]?: ResourceTemplate<ViewItem<TResource, K>>;
+};
+type ResourceTemplateItem<TResource extends AnyResource, TAttributes extends AttributeNames<TResource> = never, TExtendables extends ExtendableNames<TResource> = never, TRelationships = {}, TViews = {}> = ResourceLink<TResource> & {
+    attributes?: Pick<AttributesOf<TResource>, TAttributes> & Pick<ExtendablesOf<TResource>, TExtendables>;
+    [internalAttributesSymbol]?: RequiredProps<AttributesOf<TResource>, TAttributes>;
+    [internalExtendablesSymbol]?: RequiredProps<ExtendablesOf<TResource>, TExtendables>;
+    relationships?: RelationshipCollections<TRelationships>;
+    views?: RelationshipCollections<TViews>;
+};
+export type ResourceTemplate<TResource extends AnyResource, TAttributes extends AttributeNames<TResource> = never, TExtendables extends ExtendableNames<TResource> = never, TRelationships extends ResourceTemplateRelationships<TResource> = {}, TViews extends ResourceTemplateViews<TResource> = {}> = TResource extends AnyResource ? ResourceTemplateItem<TResource, Extract<TAttributes, AttributeNames<TResource>>, Extract<TExtendables, ExtendableNames<TResource>>, Pick<TRelationships, Extract<keyof TRelationships, RelationshipNames<TResource>>>, Pick<TViews, Extract<keyof TViews, ViewNames<TResource>>>> : never;
+export type ResourceTemplateOf<TKey extends keyof Registry, TAttributes extends AttributeNames<ResourceOf<TKey>> = never, TExtendables extends ExtendableNames<ResourceOf<TKey>> = never, TRelationships extends ResourceTemplateRelationships<ResourceOf<TKey>> = {}, TViews extends ResourceTemplateViews<ResourceOf<TKey>> = {}> = ResourceTemplate<ResourceOf<TKey>, TAttributes, TExtendables, TRelationships, TViews>;
+export type RequiredProps<T, K extends keyof T> = {
+    [P in K]-?: T[P];
+};
+export {};