@rocksky/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tsiry Sandratraina <tsiry.sndr@rocksky.app>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,279 @@
+# @rocksky/sdk
+
+A TypeScript SDK for the [Rocksky](https://rocksky.app) XRPC API.
+
+- **Type-safe** — every endpoint and parameter is statically typed.
+- **Builder-friendly** — fluent `RockskyClient.builder()` for ergonomic setup.
+- **Pipe-friendly** — composable async operators (`pipe`, `withRetry`, `withTimeout`, `map`, `tap`, `withFallback`, `catchError`).
+- **Zero-dependency** — only uses the platform `fetch` and the standard library. Works on Bun, Node 18+, Deno, browsers, Cloudflare Workers.
+
+## Install
+
+```bash
+bun add @rocksky/sdk
+# or
+npm i @rocksky/sdk
+```
+
+## Quick start
+
+```ts
+import { createClient } from "@rocksky/sdk";
+
+const client = createClient();
+
+const profile = await client.actor.getProfile({ did: "did:plc:7vdlgi2bflelz7mmuxoqjfcr" });
+const topTracks = await client.charts.getTopTracks({ limit: 5 });
+```
+
+## Authentication
+
+The SDK accepts a bearer token either as a string or as a (sync/async) function:
+
+```ts
+import { createClient } from "@rocksky/sdk";
+
+const client = createClient({ auth: process.env.ROCKSKY_TOKEN });
+
+// or — refresh on every call
+const client = createClient({
+  auth: async () => loadTokenFromKeychain(),
+});
+```
+
+Endpoints that require auth throw `RockskyAuthError` when no token is configured.
+
+## Builder
+
+```ts
+import { RockskyClient } from "@rocksky/sdk";
+
+const client = RockskyClient.builder()
+  .baseUrl("https://api.rocksky.app")
+  .bearer(process.env.ROCKSKY_TOKEN!)
+  .userAgent("my-app/1.0")
+  .timeout(10_000)
+  .retries(3)
+  .retryDelay(200)
+  .header("x-trace-id", crypto.randomUUID())
+  .build();
+```
+
+`withAuth(token)` and `withBaseUrl(url)` return a new client without mutating the original — handy for per-request overrides.
+
+## Pipe-style composition
+
+```ts
+import {
+  createClient,
+  map,
+  pipe,
+  tap,
+  withFallback,
+  withRetry,
+  withTimeout,
+} from "@rocksky/sdk";
+
+const client = createClient();
+
+// Pass a thunk so withRetry can re-invoke the network call.
+const handle = await pipe(
+  () => client.actor.getProfile({ did: "did:plc:7vdlgi2bflelz7mmuxoqjfcr" }),
+  withRetry(3, { delayMs: 200 }),
+  withTimeout(5_000),
+  tap((p) => console.log("loaded", p.handle)),
+  map((p) => p.displayName ?? p.handle),
+  withFallback("anonymous"),
+);
+```
+
+`pipe` accepts either a thunk `() => Promise<T>` (preferred — `withRetry` re-runs it) or a bare `Promise<T>` for one-shot composition.
+
+| Operator | Description |
+| --- | --- |
+| `map(fn)` | Transform the resolved value. |
+| `tap(fn)` | Run a side-effect; pass the value through. |
+| `withRetry(n, { delayMs, factor, shouldRetry })` | Retry on rejection with exponential backoff. |
+| `withTimeout(ms)` | Reject with `RockskyTimeoutError` if it exceeds `ms`. |
+| `withFallback(value \| fn)` | Recover from any error with a default. |
+| `catchError(fn)` | Map a thrown error to a value. |
+
+## Namespaces
+
+```
+client.actor        getProfile, getActorAlbums, getActorArtists, getActorSongs,
+                    getActorScrobbles, getActorLovedSongs, getActorPlaylists,
+                    getActorNeighbours, getActorCompatibility
+client.album        getAlbum, getAlbums, getAlbumTracks
+client.apikey       getApikeys, createApikey, updateApikey, removeApikey
+client.artist       getArtist, getArtists, getArtistAlbums, getArtistTracks,
+                    getArtistListeners, getArtistRecentListeners
+client.charts       getScrobblesChart, getTopArtists, getTopTracks
+client.dropbox      getFiles, getMetadata, getTemporaryLink, downloadFile
+client.feed         search, getFeed, getFeedGenerators, getFeedGenerator,
+                    describeFeedGenerator, getFeedSkeleton,
+                    getRecommendations, getArtistRecommendations,
+                    getAlbumRecommendations, getStories
+client.googledrive  getFile, getFiles, downloadFile
+client.graph        followAccount, unfollowAccount, getFollowers, getFollows,
+                    getKnownFollowers
+client.like         likeSong, dislikeSong, likeShout, dislikeShout
+client.mirror       getMirrorSources, putMirrorSource
+client.player       getCurrentlyPlaying, getPlaybackQueue, play, pause, next,
+                    previous, seek, playFile, playDirectory, addItemsToQueue,
+                    addDirectoryToQueue
+client.playlist     getPlaylists, getPlaylist, createPlaylist, removePlaylist,
+                    startPlaylist, insertDirectory, insertFiles, removeTrack
+client.scrobble     createScrobble, getScrobble, getScrobbles
+client.shout        createShout, replyShout, reportShout, removeShout,
+                    getShoutReplies, getProfileShouts, getTrackShouts,
+                    getArtistShouts, getAlbumShouts
+client.song         getSong, getSongs, getSongRecentListeners, matchSong,
+                    createSong
+client.spotify      getCurrentlyPlaying, play, pause, next, previous, seek
+client.stats        getStats, getWrapped
+```
+
+Every method takes a typed parameter object and returns `Promise<T>`. Pass a generic to narrow the response type:
+
+```ts
+type Profile = { handle: string; did: string; displayName?: string };
+const me = await client.actor.getProfile<Profile>({ did: "alice.bsky.social" });
+```
+
+## Escape hatch
+
+For endpoints not yet wrapped, call `xrpc` directly:
+
+```ts
+const result = await client.xrpc<MyType>(
+  "app.rocksky.something.notWrappedYet",
+  "GET",
+  { params: { foo: "bar" } },
+);
+```
+
+## Error handling
+
+The SDK throws four error classes — all extending `RockskyError`:
+
+- `RockskyHttpError` — non-2xx response. Exposes `.status`, `.statusText`, `.url`, `.body`.
+- `RockskyTimeoutError` — request exceeded `timeoutMs`.
+- `RockskyAuthError` — endpoint requires auth but no token was provided.
+- `RockskyError` — base class.
+
+```ts
+import { RockskyHttpError } from "@rocksky/sdk";
+
+try {
+  await client.scrobble.getScrobble({ uri: "at://x" });
+} catch (err) {
+  if (err instanceof RockskyHttpError && err.status === 404) {
+    console.log("not found");
+  } else {
+    throw err;
+  }
+}
+```
+
+## Pagination
+
+`paginate()` (and `client.paginate()`) gives you a typed async iterable over any `{ limit, offset }` or `{ cursor }` endpoint.
+
+```ts
+import { createClient, paginate } from "@rocksky/sdk";
+
+const client = createClient();
+
+// Offset/limit — fetcher returns the items array, helper handles offset.
+for await (const s of paginate({
+  fetch: ({ limit, offset }) =>
+    client.actor.getActorScrobbles({ did, limit, offset }).then((p) => p.scrobbles ?? []),
+  pageSize: 50,
+  maxItems: 200,
+})) {
+  console.log(s.track.title);
+}
+
+// Cursor-based — fetcher returns { items, cursor }.
+const followers = await client
+  .paginate({
+    fetch: async ({ limit, cursor }) => {
+      const page = await client.graph.getFollowers({ actor, limit, cursor });
+      return { items: page.followers, cursor: page.cursor };
+    },
+    pageSize: 100,
+  })
+  .toArray();
+```
+
+Options: `pageSize`, `maxItems`, `signal` (AbortSignal). The helper stops on an empty page, a short page (offset mode), or a missing cursor (cursor mode).
+
+## Realtime (WebSocket)
+
+The Rocksky API exposes a WebSocket endpoint at `/ws` for now-playing events and device control. The SDK ships a typed client with reconnect, ping, and a fluent builder.
+
+```ts
+import { RealtimeClient, createClient } from "@rocksky/sdk";
+
+// Builder style.
+const rt = RealtimeClient.builder()
+  .baseUrl("https://api.rocksky.app")
+  .token(process.env.ROCKSKY_TOKEN!)
+  .clientName("my-app")
+  .pingInterval(20_000)
+  .reconnect({ backoffMs: 1000, maxBackoffMs: 60_000 })
+  .build();
+
+// Or — inherit baseUrl from a RockskyClient.
+const client = createClient({ baseUrl: "https://api.rocksky.app" });
+const rt2 = client.realtime({ token: process.env.ROCKSKY_TOKEN!, clientName: "my-app" });
+
+rt.on("open", () => console.log("connected"));
+rt.on("registered", ({ deviceId }) => console.log("device id:", deviceId));
+rt.on("message", ({ data, device_id }) => console.log(device_id, data));
+rt.on("control", (c) => console.log("control:", c));
+rt.on("close", ({ code, reason }) => console.log("closed", code, reason));
+rt.on("error", (err) => console.error(err));
+
+await rt.connect();
+
+// Broadcast a now-playing update to your devices.
+await rt.sendMessage({
+  type: "track",
+  title: "Heart of Glass",
+  artist: "Blondie",
+});
+
+// Control a target device (or all of them).
+await rt.sendControl({ action: "play", target: "device-id-123" });
+
+await rt.close();
+```
+
+Events: `open`, `close`, `error`, `registered`, `deviceRegistered`, `message`, `control`, `raw`.
+
+For tests, pass a fake `WebSocket` constructor via `.webSocket(FakeWebSocket)`.
+
+## Development
+
+```bash
+bun install
+bun test
+bun run typecheck
+bun run build
+```
+
+Run individual examples:
+
+```bash
+bun run example:quickstart
+bun run example:builder
+bun run example:pipe
+bun run example:scrobble
+bun run example:pagination
+```
+
+## License
+
+[MIT](LICENSE) © Tsiry Sandratraina.

package/dist/client.d.ts

@@ -0,0 +1,107 @@
+import { type HttpClientConfig } from "./http";
+import { type PaginateArgs } from "./paginate";
+import { RealtimeClient, type RealtimeOptions } from "./realtime";
+import { ActorNamespace } from "./namespaces/actor";
+import { AlbumNamespace } from "./namespaces/album";
+import { ApikeyNamespace } from "./namespaces/apikey";
+import { ArtistNamespace } from "./namespaces/artist";
+import { ChartsNamespace } from "./namespaces/charts";
+import { DropboxNamespace } from "./namespaces/dropbox";
+import { FeedNamespace } from "./namespaces/feed";
+import { GoogleDriveNamespace } from "./namespaces/googledrive";
+import { GraphNamespace } from "./namespaces/graph";
+import { LikeNamespace } from "./namespaces/like";
+import { MirrorNamespace } from "./namespaces/mirror";
+import { PlayerNamespace } from "./namespaces/player";
+import { PlaylistNamespace } from "./namespaces/playlist";
+import { ScrobbleNamespace } from "./namespaces/scrobble";
+import { ShoutNamespace } from "./namespaces/shout";
+import { SongNamespace } from "./namespaces/song";
+import { SpotifyNamespace } from "./namespaces/spotify";
+import { StatsNamespace } from "./namespaces/stats";
+import type { AuthProvider, ClientOptions, FetchLike, RequestOptions } from "./types";
+export declare class RockskyClient {
+    readonly config: HttpClientConfig;
+    readonly actor: ActorNamespace;
+    readonly album: AlbumNamespace;
+    readonly apikey: ApikeyNamespace;
+    readonly artist: ArtistNamespace;
+    readonly charts: ChartsNamespace;
+    readonly dropbox: DropboxNamespace;
+    readonly feed: FeedNamespace;
+    readonly googledrive: GoogleDriveNamespace;
+    readonly graph: GraphNamespace;
+    readonly like: LikeNamespace;
+    readonly mirror: MirrorNamespace;
+    readonly player: PlayerNamespace;
+    readonly playlist: PlaylistNamespace;
+    readonly scrobble: ScrobbleNamespace;
+    readonly shout: ShoutNamespace;
+    readonly song: SongNamespace;
+    readonly spotify: SpotifyNamespace;
+    readonly stats: StatsNamespace;
+    constructor(options?: ClientOptions);
+    /** Build a one-off authenticated copy without mutating this client. */
+    withAuth(auth: AuthProvider): RockskyClient;
+    /** Build a copy with an overridden base URL. */
+    withBaseUrl(baseUrl: string): RockskyClient;
+    /**
+     * Open a realtime WebSocket connection to /ws.
+     *
+     *   const rt = client.realtime({ token, clientName: "my-app" });
+     *   rt.on("message", m => console.log(m));
+     *   await rt.connect();
+     *
+     * Defaults `baseUrl` to this client's base URL. Override anything by
+     * passing the option, or use `RealtimeClient.builder()` for full control.
+     */
+    realtime(options: Omit<RealtimeOptions, "baseUrl"> & Partial<Pick<RealtimeOptions, "baseUrl">>): RealtimeClient;
+    /**
+     * Page through any limit/offset or cursor-based endpoint as an async iterable.
+     *
+     *   for await (const s of client.paginate({
+     *     fetch: ({ limit, offset }) =>
+     *       client.actor.getActorScrobbles({ did, limit, offset }),
+     *     pageSize: 50,
+     *   })) { ... }
+     */
+    paginate<T>(args: PaginateArgs<T>): AsyncIterable<T> & {
+        toArray(): Promise<T[]>;
+    };
+    /** Direct escape hatch — call any XRPC endpoint by NSID. */
+    xrpc<T = unknown>(nsid: string, method?: "GET" | "POST", opts?: {
+        params?: Record<string, unknown>;
+        body?: unknown;
+        requireAuth?: boolean;
+    } & RequestOptions): Promise<T>;
+    static builder(): RockskyClientBuilder;
+    private optionsSnapshot;
+}
+/**
+ * Fluent builder.
+ *
+ *   const client = RockskyClient.builder()
+ *     .baseUrl("https://api.rocksky.app")
+ *     .auth(() => loadToken())
+ *     .timeout(10_000)
+ *     .retries(3)
+ *     .userAgent("my-app/1.0")
+ *     .build();
+ */
+export declare class RockskyClientBuilder {
+    private readonly opts;
+    baseUrl(url: string): this;
+    auth(auth: AuthProvider): this;
+    bearer(token: string): this;
+    fetch(impl: FetchLike): this;
+    header(key: string, value: string): this;
+    headers(headers: Record<string, string>): this;
+    userAgent(ua: string): this;
+    timeout(ms: number): this;
+    retries(n: number): this;
+    retryDelay(ms: number): this;
+    build(): RockskyClient;
+}
+/** Convenience factory — equivalent to `new RockskyClient(options)`. */
+export declare function createClient(options?: ClientOptions): RockskyClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+export declare class RockskyError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class RockskyHttpError extends RockskyError {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly body: unknown;
+    constructor(args: {
+        status: number;
+        statusText: string;
+        url: string;
+        body: unknown;
+        message?: string;
+    });
+}
+export declare class RockskyTimeoutError extends RockskyError {
+    constructor(ms: number);
+}
+export declare class RockskyAuthError extends RockskyError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK3D;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAWF;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,SAA4B;CAIhD"}

package/dist/http.d.ts

@@ -0,0 +1,28 @@
+import { type AuthProvider, type FetchLike, type RequestOptions } from "./types";
+export type XrpcCallOptions = RequestOptions & {
+    params?: Record<string, unknown>;
+    body?: unknown;
+    requireAuth?: boolean;
+};
+export type HttpClientConfig = {
+    baseUrl: string;
+    auth?: AuthProvider;
+    fetch: FetchLike;
+    headers: Record<string, string>;
+    timeoutMs: number;
+    retries: number;
+    retryDelayMs: number;
+};
+export declare function buildConfig(opts: {
+    baseUrl?: string;
+    auth?: AuthProvider;
+    fetch?: FetchLike;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    retries?: number;
+    retryDelayMs?: number;
+    userAgent?: string;
+}): HttpClientConfig;
+export declare function serializeParams(params: Record<string, unknown> | undefined): string;
+export declare function xrpcCall<T>(config: HttpClientConfig, nsid: string, method: "GET" | "POST", opts?: XrpcCallOptions): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,gBAAgB,CAenB;AAcD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,MAAM,CAkBR;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,CAAC,CAAC,CA4CZ"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { RockskyClient, RockskyClientBuilder, createClient, } from "./client";
+export { RockskyError, RockskyHttpError, RockskyTimeoutError, RockskyAuthError, } from "./errors";
+export { pipe, map, tap, withRetry, withTimeout, withFallback, catchError, type Op, } from "./pipe";
+export { DEFAULT_BASE_URL, type AuthProvider, type ClientOptions, type FetchLike, type Json, type Pagination, type RequestOptions, } from "./types";
+export { paginate, type PageOpts, type PageResult, type PaginateArgs, } from "./paginate";
+export { RealtimeClient, RealtimeClientBuilder, createRealtimeClient, type RealtimeOptions, type RealtimeEvent, type RealtimeEventMap, type ReconnectOptions, type WebSocketCtor, type WebSocketLike, } from "./realtime";
+export type { GetProfileParams, ActorPagedParams, ActorRangeParams, } from "./namespaces/actor";
+export type { CreateScrobbleInput, GetScrobblesParams, } from "./namespaces/scrobble";
+export type { GetSongParams, GetSongsParams, MatchSongParams, CreateSongInput, } from "./namespaces/song";
+export type { GetAlbumsParams } from "./namespaces/album";
+export type { GetArtistsParams, ArtistListenersParams, GetArtistTracksParams, } from "./namespaces/artist";
+export type { ListApikeysParams, CreateApikeyInput, UpdateApikeyInput, } from "./namespaces/apikey";
+export type { ScrobblesChartParams, TopChartParams, } from "./namespaces/charts";
+export type { FollowListParams, KnownFollowersParams, } from "./namespaces/graph";
+export type { RecommendParams } from "./namespaces/feed";
+export type { LikeInput } from "./namespaces/like";
+export type { PutMirrorSourceInput } from "./namespaces/mirror";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,IAAI,EACJ,GAAG,EACH,GAAG,EACH,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,KAAK,EAAE,GACR,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}