audible-api-ts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thibaut
+
+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,71 @@
+# audible-api-ts
+
+[![CI](https://github.com/moifort/audible-api-ts/actions/workflows/ci.yml/badge.svg)](https://github.com/moifort/audible-api-ts/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/audible-api-ts)](https://www.npmjs.com/package/audible-api-ts)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+
+**A fully typed TypeScript client for the Audible API.**
+
+Authentication, library, wishlist — all with complete type safety. The first maintained TypeScript alternative to [mkb79/Audible](https://github.com/mkb79/Audible) (Python).
+
+**[Documentation](https://moifort.github.io/audible-api-ts)**
+
+## Features
+
+- **Complete PKCE authentication** — Same OAuth flow as the official Audible iOS app
+- **Signed API requests** — RSA SHA256 request signing with device private key
+- **Library & wishlist** — Fetch all audiobooks with automatic pagination
+- **10 locales** — US, UK, France, Germany, Italy, Spain, Canada, Australia, India, Japan
+- **Fully typed** — Every function, response, and credential has TypeScript types
+- **Minimal dependencies** — Only `zod` for response validation
+
+## Install
+
+```bash
+bun add audible-api-ts
+# or
+npm install audible-api-ts
+```
+
+Requires Node.js 18+ (for native `fetch` and `crypto`).
+
+## Quick Start
+
+```typescript
+import {
+  generateLoginUrl,
+  registerDevice,
+  fetchLibrary,
+} from 'audible-api-ts'
+
+// 1. Generate login URL
+const { loginUrl, session, cookies } = await generateLoginUrl('com')
+// → Redirect user to loginUrl (set cookies first)
+
+// 2. After login, register the device
+const credentials = await registerDevice(authorizationCode, session)
+
+// 3. Fetch the library
+const { items } = await fetchLibrary(credentials)
+
+items.map((book) => console.log(`${book.title} by ${book.authors.join(', ')}`))
+// → "Dune by Frank Herbert"
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `generateLoginUrl(locale)` | Generate PKCE login URL + session + cookies |
+| `registerDevice(code, session)` | Exchange auth code for credentials |
+| `refreshAccessToken(credentials)` | Refresh an expired access token |
+| `fetchLibrary(credentials)` | Fetch all library audiobooks |
+| `fetchWishlist(credentials)` | Fetch all wishlist audiobooks |
+| `verifyConnection(credentials)` | Check if credentials are valid |
+
+See the **[full documentation](https://moifort.github.io/audible-api-ts)** for guides and API reference.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+import type { AudibleCookie, AudibleCredentials, AudibleLocale, AuthSession } from './types.js';
+/**
+ * Generate a login URL for the Audible PKCE OAuth flow.
+ *
+ * Returns the URL to redirect the user to, the session to pass back to `registerDevice`,
+ * and the cookies to set in the browser before redirecting.
+ */
+export declare const generateLoginUrl: (locale: AudibleLocale) => Promise<{
+    readonly loginUrl: string;
+    readonly session: AuthSession;
+    readonly cookies: AudibleCookie[];
+}>;
+/**
+ * Complete device registration using the authorization code from the OAuth callback.
+ *
+ * @param authorizationCode - The code received from the OAuth callback URL
+ * @param session - The auth session returned by `generateLoginUrl`
+ * @returns The credentials to use for all subsequent API calls
+ */
+export declare const registerDevice: (authorizationCode: string, session: AuthSession) => Promise<{
+    accessToken: string;
+    refreshToken: string;
+    adpToken: string;
+    devicePrivateKey: string;
+    serial: string;
+    locale: AudibleLocale;
+    expiresAt: Date;
+}>;
+/**
+ * Refresh an expired access token using the refresh token.
+ *
+ * @returns Updated credentials with the new access token and expiration
+ */
+export declare const refreshAccessToken: (credentials: AudibleCredentials) => Promise<{
+    accessToken: string;
+    expiresAt: Date;
+    refreshToken: string;
+    adpToken: string;
+    devicePrivateKey: string;
+    serial: string;
+    locale: AudibleLocale;
+}>;
+//# 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":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAO/F;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,aAAa;;;;EAkE3D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAU,mBAAmB,MAAM,EAAE,SAAS,WAAW;;;;;;;;EA8DnF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAU,aAAa,kBAAkB;;;;;;;;EA0BvE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { generateLoginUrl, refreshAccessToken, registerDevice } from './client.js';
+export { fetchLibrary, fetchWishlist, verifyConnection } from './library.js';
+export { AUDIBLE_LOCALES } from './locales.js';
+export type { AudibleCookie, AudibleCredentials, AudibleItem, AudibleLocale, AuthSession, LocaleConfig, } from './types.js';
+//# 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":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGlF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG5E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA"}