audible-api-ts 0.1.0

package/dist/library.d.ts

@@ -0,0 +1,26 @@
+import type { AudibleCredentials, AudibleItem } from './types.js';
+/**
+ * Fetch the user's entire Audible library with automatic pagination.
+ *
+ * @returns All library items and the (potentially refreshed) credentials
+ */
+export declare const fetchLibrary: (credentials: AudibleCredentials) => Promise<{
+    items: AudibleItem[];
+    credentials: AudibleCredentials;
+}>;
+/**
+ * Fetch the user's entire Audible wishlist with automatic pagination.
+ *
+ * @returns All wishlist items and the (potentially refreshed) credentials
+ */
+export declare const fetchWishlist: (credentials: AudibleCredentials) => Promise<{
+    items: AudibleItem[];
+    credentials: AudibleCredentials;
+}>;
+/**
+ * Verify that credentials are valid by making a minimal API call.
+ *
+ * @throws If credentials are invalid or expired
+ */
+export declare const verifyConnection: (credentials: AudibleCredentials) => Promise<void>;
+//# sourceMappingURL=library.d.ts.map

package/dist/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAyFjE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAU,aAAa,kBAAkB;;;EACzB,CAAA;AAEzC;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,aAAa,kBAAkB;;;EACzB,CAAA;AAE1C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,aAAa,kBAAkB,kBAMrE,CAAA"}

package/dist/locales.d.ts

@@ -0,0 +1,4 @@
+import type { AudibleLocale, LocaleConfig } from './types.js';
+/** All supported Audible marketplace configurations indexed by locale */
+export declare const AUDIBLE_LOCALES: Record<AudibleLocale, LocaleConfig>;
+//# sourceMappingURL=locales.d.ts.map

package/dist/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE7D,yEAAyE;AACzE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY,CAWtD,CAAA"}

package/dist/schemas.d.ts

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+/** Zod schema for parsing raw Audible API item responses */
+export declare const audibleRawItemSchema: z.ZodObject<{
+    asin: z.ZodString;
+    title: z.ZodString;
+    authors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>, "many">>;
+    narrators: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>, "many">>;
+    runtime_length_min: z.ZodDefault<z.ZodNumber>;
+    publisher_name: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
+    language: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
+    release_date: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
+    product_images: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>, Record<string, string> | undefined, Record<string, string> | null | undefined>;
+    series: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        asin: z.ZodString;
+        title: z.ZodString;
+        sequence: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        asin: string;
+        title: string;
+        sequence?: string | undefined;
+    }, {
+        asin: string;
+        title: string;
+        sequence?: string | null | undefined;
+    }>, "many">>>, {
+        asin: string;
+        title: string;
+        sequence?: string | undefined;
+    }[], {
+        asin: string;
+        title: string;
+        sequence?: string | null | undefined;
+    }[] | null | undefined>;
+    listening_status: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        is_finished: z.ZodOptional<z.ZodBoolean>;
+        percent_complete: z.ZodOptional<z.ZodNumber>;
+        finished_at_timestamp: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        is_finished?: boolean | undefined;
+        percent_complete?: number | undefined;
+        finished_at_timestamp?: string | null | undefined;
+    }, {
+        is_finished?: boolean | undefined;
+        percent_complete?: number | undefined;
+        finished_at_timestamp?: string | null | undefined;
+    }>>>, {
+        is_finished?: boolean | undefined;
+        percent_complete?: number | undefined;
+        finished_at_timestamp?: string | null | undefined;
+    } | undefined, {
+        is_finished?: boolean | undefined;
+        percent_complete?: number | undefined;
+        finished_at_timestamp?: string | null | undefined;
+    } | null | undefined>;
+}, "strip", z.ZodTypeAny, {
+    asin: string;
+    title: string;
+    authors: {
+        name: string;
+    }[];
+    narrators: {
+        name: string;
+    }[];
+    runtime_length_min: number;
+    series: {
+        asin: string;
+        title: string;
+        sequence?: string | undefined;
+    }[];
+    publisher_name?: string | undefined;
+    language?: string | undefined;
+    release_date?: string | undefined;
+    product_images?: Record<string, string> | undefined;
+    listening_status?: {
+        is_finished?: boolean | undefined;
+        percent_complete?: number | undefined;
+        finished_at_timestamp?: string | null | undefined;
+    } | undefined;
+}, {
+    asin: string;
+    title: string;
+    authors?: {
+        name: string;
+    }[] | undefined;
+    narrators?: {
+        name: string;
+    }[] | undefined;
+    runtime_length_min?: number | undefined;
+    publisher_name?: string | null | undefined;
+    language?: string | null | undefined;
+    release_date?: string | null | undefined;
+    product_images?: Record<string, string> | null | undefined;
+    series?: {
+        asin: string;
+        title: string;
+        sequence?: string | null | undefined;
+    }[] | null | undefined;
+    listening_status?: {
+        is_finished?: boolean | undefined;
+        percent_complete?: number | undefined;
+        finished_at_timestamp?: string | null | undefined;
+    } | null | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2C/B,CAAA"}

package/dist/signing.d.ts

@@ -0,0 +1,8 @@
+import type { AudibleCredentials } from './types.js';
+/** Sign an Audible API request using RSA SHA256 with the device private key */
+export declare const signRequest: (method: string, path: string, body: string, credentials: AudibleCredentials) => {
+    'x-adp-token': string;
+    'x-adp-alg': string;
+    'x-adp-signature': string;
+};
+//# sourceMappingURL=signing.d.ts.map

package/dist/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,aAAa,kBAAkB;;;;CAchC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+/** Supported Audible marketplace locales */
+export type AudibleLocale = 'fr' | 'com' | 'co.uk' | 'de' | 'it' | 'es' | 'ca' | 'com.au' | 'in' | 'co.jp';
+/** Marketplace configuration for a given locale */
+export type LocaleConfig = {
+    domain: string;
+    marketplaceId: string;
+    countryCode: string;
+};
+/** Credentials obtained after device registration */
+export type AudibleCredentials = {
+    accessToken: string;
+    refreshToken: string;
+    adpToken: string;
+    devicePrivateKey: string;
+    serial: string;
+    locale: AudibleLocale;
+    expiresAt: Date;
+};
+/** An audiobook item from Audible's catalog */
+export type AudibleItem = {
+    asin: string;
+    title: string;
+    authors: string[];
+    narrators: string[];
+    durationMinutes: number;
+    publisher?: string;
+    language?: string;
+    releaseDate?: Date;
+    coverUrl?: string;
+    series?: {
+        name: string;
+        position?: number;
+    };
+    finishedAt?: Date;
+};
+/** PKCE auth session — returned by generateLoginUrl, passed back to registerDevice */
+export type AuthSession = {
+    codeVerifier: string;
+    serial: string;
+    locale: AudibleLocale;
+    createdAt: Date;
+};
+/** Cookie to set in the browser before redirecting to the login URL */
+export type AudibleCookie = {
+    name: string;
+    value: string;
+    domain: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,KAAK,GACL,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,QAAQ,GACR,IAAI,GACJ,OAAO,CAAA;AAEX,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,IAAI,CAAA;CAChB,CAAA;AAED,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,UAAU,CAAC,EAAE,IAAI,CAAA;CAClB,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,IAAI,CAAA;CAChB,CAAA;AAED,uEAAuE;AACvE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+import { Buffer } from 'node:buffer';
+export declare const base64url: (buffer: Buffer) => string;
+export declare const base64nopad: (buffer: Buffer) => string;
+export declare const toHexString: (input: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,WAC8C,CAAA;AAEtF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,WAAiD,CAAA;AAE3F,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,WAAgD,CAAA"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "audible-api-ts",
+  "version": "0.1.0",
+  "description": "A fully typed TypeScript client for the Audible API — authentication, library, and wishlist",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "bun run build:js && bun run build:types",
+    "build:js": "bun build ./src/index.ts --outdir ./dist --target node --format esm --splitting",
+    "build:types": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "lint": "bunx biome check",
+    "lint:fix": "bunx biome check --write",
+    "docs:dev": "cd docs && bun run dev",
+    "docs:build": "cd docs && bun run build",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "audible",
+    "audiobook",
+    "amazon",
+    "api",
+    "typescript",
+    "library",
+    "wishlist",
+    "pkce",
+    "oauth"
+  ],
+  "author": "Thibaut",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moifort/audible-api-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/moifort/audible-api-ts/issues"
+  },
+  "homepage": "https://moifort.github.io/audible-api-ts",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/bun": "^1.2.0",
+    "typescript": "^5.7.0"
+  }
+}