shamela 1.3.2 → 1.3.4

package/dist/types-C693UiUs.d.ts

@@ -0,0 +1,226 @@
+//#region src/db/types.d.ts
+
+/**
+ * A record that can be deleted by patches.
+ */
+type Deletable = {
+  /** Indicates if it was deleted in the patch if it is set to '1 */
+  is_deleted?: string;
+};
+type Unique = {
+  /** Unique identifier */
+  id: number;
+};
+/**
+ * Database row structure for the author table.
+ */
+type AuthorRow = Deletable & Unique & {
+  /** Author biography */
+  biography: string;
+  /** Death year */
+  death_number: string;
+  /** The death year as a text */
+  death_text: string;
+  /** Author name */
+  name: string;
+};
+/**
+ * Database row structure for the book table.
+ */
+type BookRow = Deletable & Unique & {
+  /** Serialized author ID(s) "2747, 3147" or "513" */
+  author: string;
+  /** Bibliography information */
+  bibliography: string;
+  /** Category ID */
+  category: string;
+  /** Publication date (or 99999 for unavailable) */
+  date: string;
+  /** Hint or description */
+  hint: string;
+  /** Major version */
+  major_release: string;
+  /** Serialized metadata */
+  metadata: string;
+  /** Minor version */
+  minor_release: string;
+  /** Book name */
+  name: string;
+  /** Serialized PDF links */
+  pdf_links: string;
+  /** Printed flag */
+  printed: string;
+  /** Book type */
+  type: string;
+};
+/**
+ * Database row structure for the category table.
+ */
+type CategoryRow = Deletable & Unique & {
+  /** Category name */
+  name: string;
+  /** Category order in the list to show. */
+  order: string;
+};
+/**
+ * Database row structure for the page table.
+ */
+type PageRow = Deletable & Unique & {
+  /** Page content */
+  content: string;
+  /** Page number */
+  number: string | null;
+  /** Page reference */
+  page: string | null;
+  /** Part number */
+  part: string | null;
+  /** Additional metadata */
+  services: string | null;
+};
+/**
+ * Database row structure for the title table.
+ */
+type TitleRow = Deletable & Unique & {
+  /** Title content */
+  content: string;
+  /** Page number */
+  page: string;
+  /** Parent title ID */
+  parent: string | null;
+};
+//#endregion
+//#region src/types.d.ts
+/**
+ * Represents an author entity.
+ */
+type Author = AuthorRow;
+/**
+ * Represents a book entity.
+ */
+type Book = BookRow;
+/**
+ * A category for a book.
+ */
+type Category = CategoryRow;
+/**
+ * A page in a book.
+ */
+type Page = Pick<PageRow, 'id' | 'content'> & {
+  page?: number;
+  part?: string;
+  number?: string;
+};
+/**
+ * A title heading in a book.
+ */
+type Title = Pick<TitleRow, 'id' | 'content'> & {
+  page: number;
+  parent?: number;
+};
+/**
+ * Represents book content data.
+ */
+type BookData = {
+  /** Array of pages in the book */
+  pages: Page[];
+  /** Array of titles/chapters */
+  titles: Title[];
+};
+/**
+ * Master data structure containing all core entities.
+ */
+type MasterData = {
+  /** Array of all authors */
+  authors: Author[];
+  /** Array of all books */
+  books: Book[];
+  /** Array of all categories */
+  categories: Category[];
+  /** Version number for the downloaded master database */
+  version: number;
+};
+/**
+ * Options for downloading a book.
+ */
+type DownloadBookOptions = {
+  /** Optional book metadata */
+  bookMetadata?: GetBookMetadataResponsePayload;
+  /** Output file configuration */
+  outputFile: OutputOptions;
+};
+/**
+ * Options for downloading master data.
+ */
+type DownloadMasterOptions = {
+  /** Optional master metadata */
+  masterMetadata?: GetMasterMetadataResponsePayload;
+  /** Output file configuration */
+  outputFile: OutputOptions;
+};
+/**
+ * Options for getting book metadata.
+ */
+type GetBookMetadataOptions = {
+  /** Major version number */
+  majorVersion: number;
+  /** Minor version number */
+  minorVersion: number;
+};
+/**
+ * Response payload for book metadata requests.
+ */
+type GetBookMetadataResponsePayload = {
+  /** Major release version */
+  majorRelease: number;
+  /** URL for major release download */
+  majorReleaseUrl: string;
+  /** Optional minor release version */
+  minorRelease?: number;
+  /** Optional URL for minor release download */
+  minorReleaseUrl?: string;
+};
+/**
+ * Response payload for master metadata requests.
+ */
+type GetMasterMetadataResponsePayload = {
+  /** Download URL */
+  url: string;
+  /** Version number */
+  version: number;
+};
+type NodeJSOutput = {
+  /** Output file path (Node.js only) */
+  path: string;
+  writer?: never;
+};
+type CustomOutput = {
+  /** Custom writer used when path is not provided */
+  writer: (payload: string | Uint8Array) => Promise<void> | void;
+  path?: undefined;
+};
+/**
+ * Output file options.
+ */
+type OutputOptions = NodeJSOutput | CustomOutput;
+/**
+ * Runtime configuration for the library.
+ */
+type ShamelaConfig = {
+  /** API key used to authenticate against Shamela services */
+  apiKey?: string;
+  /** Endpoint used for book metadata */
+  booksEndpoint?: string;
+  /** Endpoint used for master metadata */
+  masterPatchEndpoint?: string;
+  /** Optional override for the sql.js wasm asset location */
+  sqlJsWasmUrl?: string;
+  /** Optional custom fetch implementation for environments without a global fetch */
+  fetchImplementation?: typeof fetch;
+};
+/**
+ * Valid configuration keys.
+ */
+type ShamelaConfigKey = keyof ShamelaConfig;
+//#endregion
+export { DownloadBookOptions as a, GetBookMetadataResponsePayload as c, OutputOptions as d, Page as f, Title as h, Category as i, GetMasterMetadataResponsePayload as l, ShamelaConfigKey as m, Book as n, DownloadMasterOptions as o, ShamelaConfig as p, BookData as r, GetBookMetadataOptions as s, Author as t, MasterData as u };
+//# sourceMappingURL=types-C693UiUs.d.ts.map

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+import { a as DownloadBookOptions, c as GetBookMetadataResponsePayload, d as OutputOptions, f as Page, h as Title, i as Category, l as GetMasterMetadataResponsePayload, m as ShamelaConfigKey, n as Book, o as DownloadMasterOptions, p as ShamelaConfig, r as BookData, s as GetBookMetadataOptions, t as Author, u as MasterData } from "./types-C693UiUs.js";
+export { Author, Book, BookData, Category, DownloadBookOptions, DownloadMasterOptions, GetBookMetadataOptions, GetBookMetadataResponsePayload, GetMasterMetadataResponsePayload, MasterData, OutputOptions, Page, ShamelaConfig, ShamelaConfigKey, Title };

package/package.json

@@ -7,30 +7,40 @@
     },
     "description": "Library to interact with the Maktabah Shamela v4 APIs",
     "devDependencies": {
-        "@biomejs/biome": "^2.2.7",
-        "@types/node": "^24.9.1",
-        "@types/react": "^19.2.2",
-        "@types/react-dom": "^19.2.2",
+        "@biomejs/biome": "^2.3.8",
+        "@types/bun": "^1.3.3",
+        "@types/node": "^24.10.1",
+        "@types/react": "^19.2.7",
+        "@types/react-dom": "^19.2.3",
         "@types/sql.js": "^1.4.9",
-        "next": "^16.0.0",
-        "react": "^19.2.0",
-        "react-dom": "^19.2.0",
-        "semantic-release": "^25.0.1",
-        "tsdown": "^0.15.9",
+        "next": "^16.0.7",
+        "react": "^19.2.1",
+        "react-dom": "^19.2.1",
+        "semantic-release": "^25.0.2",
+        "tsdown": "^0.17.0",
         "typescript": "^5.9.3"
     },
     "engines": {
-        "bun": ">=1.3.0",
+        "bun": ">=1.3.2",
         "node": ">=22.0.0"
     },
     "exports": {
         ".": {
+            "default": "./dist/index.js",
             "import": "./dist/index.js",
             "types": "./dist/index.d.ts"
+        },
+        "./content": {
+            "default": "./dist/content.js",
+            "import": "./dist/content.js",
+            "types": "./dist/content.d.ts"
+        },
+        "./types": {
+            "types": "./dist/types.d.ts"
         }
     },
     "files": [
-        "dist/**"
+        "dist"
     ],
     "homepage": "https://github.com/ragaeeb/shamela",
     "keywords": [
@@ -52,13 +62,13 @@
         "demo": "next dev demo",
         "demo:build": "next build demo",
         "demo:start": "next start demo",
+        "e2e": "RUN_E2E=true bun test e2e",
         "format": "biome format --write .",
-        "lint": "biome check .",
-        "test": "bun test src --coverage --coverage-reporter=lcov"
+        "lint": "biome check ."
     },
     "sideEffects": false,
     "source": "src/index.ts",
     "type": "module",
     "types": "dist/index.d.ts",
-    "version": "1.3.2"
+    "version": "1.3.4"
 }