pdfjs-serverless 0.1.0 → 0.2.0

package/README.md

@@ -1,14 +1,10 @@
 # pdfjs-serverless
 
-> **Note**
->
-> Work in progress.
-
-A redistribution of Mozilla's [PDF.js](https://github.com/mozilla/pdf.js) for serverless enviroments, like Deno Deploy and Cloudflare Workers.
+A nodeless/serverless redistribution of Mozilla's [PDF.js](https://github.com/mozilla/pdf.js) for serverless enviroments, like Deno Deploy and Cloudflare Workers with zero dependencies.
 
 ## How It Works
 
-First, some string replacements of the `pdf.js` library is necessary, i.e. removing browser context references. Additionally, we enforce Node.js (might sound paradox at first, bear with me) compatibility, i.e. polyfilling the `canvas` module and setting the `isNodeJS` flag to `true`.
+First, some string replacements of the `pdf.js` library is necessary, i.e. removing browser context references. Additionally, we enforce Node.js (might sound paradox at first, bear with me) compatibility, i.e. mocking the `canvas` module and setting the `isNodeJS` flag to `true`.
 
 To achieve a nodeless build, [`unenv`](https://github.com/unjs/unenv) does the heavy lifting by converting Node.js specific code to be platform-agnostic.
 
@@ -29,7 +25,7 @@ npm install pdfjs-serverless
 yarn add pdfjs-serverless
 ```
 
-## Usage
+## Example Usage
 
 ### Deno
 
@@ -40,6 +36,13 @@ const data = Deno.readFileSync('./dummy.pdf')
 const doc = await getDocument(data).promise
 
 console.log(await doc.getMetadata())
+
+for (let i = 1; i <= doc.numPages; i++) {
+  const page = await doc.getPage(i)
+  const textContent = await page.getTextContent()
+  const contents = textContent.items.map(item => item.str).join(' ')
+  console.log(contents)
+}
 ```
 
 ### In Combination With `unpdf`
@@ -68,7 +71,7 @@ const { totalPages, text } = await extractPDFText(
 
 ## Inspiration
 
-- [`pdf.mjs`](https://github.com/bru02/pdf.mjs)
+- [`pdf.mjs`](https://github.com/bru02/pdf.mjs), a nodeless build of PDF.js v2.
 
 ## License
 

package/dist/index.d.ts

@@ -1 +1 @@
-export * from 'pdfjs-dist/types/src/pdf.d.ts'
+export * from './types/src/pdf.d.ts'

package/dist/types/src/display/annotation_layer.d.ts

@@ -0,0 +1,203 @@
+export type PDFPageProxy = import("./api").PDFPageProxy;
+export type PageViewport = import("./display_utils").PageViewport;
+export type IDownloadManager = any;
+export type IPDFLinkService = import("../../web/interfaces").IPDFLinkService;
+export type AnnotationElementParameters = {
+    data: Object;
+    layer: HTMLDivElement;
+    linkService: IPDFLinkService;
+    downloadManager: any;
+    annotationStorage?: AnnotationStorage | undefined;
+    /**
+     * - Path for image resources, mainly
+     * for annotation icons. Include trailing slash.
+     */
+    imageResourcesPath?: string | undefined;
+    renderForms: boolean;
+    svgFactory: Object;
+    enableScripting?: boolean | undefined;
+    hasJSActions?: boolean | undefined;
+    fieldObjects?: Object | undefined;
+};
+export type AnnotationLayerParameters = {
+    viewport: PageViewport;
+    div: HTMLDivElement;
+    annotations: any[];
+    page: PDFPageProxy;
+    linkService: IPDFLinkService;
+    downloadManager: any;
+    annotationStorage?: AnnotationStorage | undefined;
+    /**
+     * - Path for image resources, mainly
+     * for annotation icons. Include trailing slash.
+     */
+    imageResourcesPath?: string | undefined;
+    renderForms: boolean;
+    /**
+     * - Enable embedded script execution.
+     */
+    enableScripting?: boolean | undefined;
+    /**
+     * - Some fields have JS actions.
+     * The default value is `false`.
+     */
+    hasJSActions?: boolean | undefined;
+    fieldObjects?: {
+        [x: string]: Object[];
+    } | null | undefined;
+    annotationCanvasMap?: Map<string, HTMLCanvasElement> | undefined;
+    accessibilityManager?: any;
+};
+/**
+ * @typedef {Object} AnnotationLayerParameters
+ * @property {PageViewport} viewport
+ * @property {HTMLDivElement} div
+ * @property {Array} annotations
+ * @property {PDFPageProxy} page
+ * @property {IPDFLinkService} linkService
+ * @property {IDownloadManager} downloadManager
+ * @property {AnnotationStorage} [annotationStorage]
+ * @property {string} [imageResourcesPath] - Path for image resources, mainly
+ *   for annotation icons. Include trailing slash.
+ * @property {boolean} renderForms
+ * @property {boolean} [enableScripting] - Enable embedded script execution.
+ * @property {boolean} [hasJSActions] - Some fields have JS actions.
+ *   The default value is `false`.
+ * @property {Object<string, Array<Object>> | null} [fieldObjects]
+ * @property {Map<string, HTMLCanvasElement>} [annotationCanvasMap]
+ * @property {TextAccessibilityManager} [accessibilityManager]
+ */
+/**
+ * Manage the layer containing all the annotations.
+ */
+export class AnnotationLayer {
+    constructor({ div, accessibilityManager, annotationCanvasMap, l10n, page, viewport, }: {
+        div: any;
+        accessibilityManager: any;
+        annotationCanvasMap: any;
+        l10n: any;
+        page: any;
+        viewport: any;
+    });
+    div: any;
+    l10n: any;
+    page: any;
+    viewport: any;
+    zIndex: number;
+    popupShow: any[] | undefined;
+    /**
+     * Render a new annotation layer with all annotation elements.
+     *
+     * @param {AnnotationLayerParameters} params
+     * @memberof AnnotationLayer
+     */
+    render(params: AnnotationLayerParameters): Promise<void>;
+    /**
+     * Update the annotation elements on existing annotation layer.
+     *
+     * @param {AnnotationLayerParameters} viewport
+     * @memberof AnnotationLayer
+     */
+    update({ viewport }: AnnotationLayerParameters): void;
+    getEditableAnnotations(): any[];
+    getEditableAnnotation(id: any): any;
+    #private;
+}
+export class FreeTextAnnotationElement extends AnnotationElement {
+    constructor(parameters: any);
+    textContent: any;
+    textPosition: any;
+    annotationEditorType: number;
+    render(): HTMLElement | undefined;
+}
+export class InkAnnotationElement extends AnnotationElement {
+    constructor(parameters: any);
+    containerClassName: string;
+    svgElementName: string;
+    annotationEditorType: number;
+    render(): HTMLElement | undefined;
+    getElementsToTriggerPopup(): any[];
+    #private;
+}
+export class StampAnnotationElement extends AnnotationElement {
+    constructor(parameters: any);
+    render(): HTMLElement | undefined;
+}
+import { AnnotationStorage } from "./annotation_storage.js";
+declare class AnnotationElement {
+    constructor(parameters: any, { isRenderable, ignoreBorder, createQuadrilaterals, }?: {
+        isRenderable?: boolean | undefined;
+        ignoreBorder?: boolean | undefined;
+        createQuadrilaterals?: boolean | undefined;
+    });
+    isRenderable: boolean;
+    data: any;
+    layer: any;
+    linkService: any;
+    downloadManager: any;
+    imageResourcesPath: any;
+    renderForms: any;
+    svgFactory: any;
+    annotationStorage: any;
+    enableScripting: any;
+    hasJSActions: any;
+    _fieldObjects: any;
+    parent: any;
+    container: HTMLElement | undefined;
+    /**
+     * Create an empty container for the annotation's HTML element.
+     *
+     * @private
+     * @param {boolean} ignoreBorder
+     * @memberof AnnotationElement
+     * @returns {HTMLElement} A section element.
+     */
+    private _createContainer;
+    setRotation(angle: any, container?: HTMLElement | undefined): void;
+    get _commonActions(): any;
+    _dispatchEventFromSandbox(actions: any, jsEvent: any): void;
+    _setDefaultPropertiesFromJS(element: any): void;
+    /**
+     * Create quadrilaterals from the annotation's quadpoints.
+     *
+     * @private
+     * @memberof AnnotationElement
+     */
+    private _createQuadrilaterals;
+    /**
+     * Create a popup for the annotation's HTML element. This is used for
+     * annotations that do not have a Popup entry in the dictionary, but
+     * are of a type that works with popups (such as Highlight annotations).
+     *
+     * @private
+     * @memberof AnnotationElement
+     */
+    private _createPopup;
+    /**
+     * Render the annotation's HTML element(s).
+     *
+     * @public
+     * @memberof AnnotationElement
+     */
+    public render(): void;
+    /**
+     * @private
+     * @returns {Array}
+     */
+    private _getElementsByName;
+    show(): void;
+    hide(): void;
+    /**
+     * Get the HTML element(s) which can trigger a popup when clicked or hovered.
+     *
+     * @public
+     * @memberof AnnotationElement
+     * @returns {Array<HTMLElement>|HTMLElement} An array of elements or an
+     *          element.
+     */
+    public getElementsToTriggerPopup(): Array<HTMLElement> | HTMLElement;
+    addHighlightArea(): void;
+    _editOnDoubleClick(): void;
+    #private;
+}
+export {};

package/dist/types/src/display/annotation_storage.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Key/value storage for annotation data in forms.
+ */
+export class AnnotationStorage {
+    onSetModified: any;
+    onResetModified: any;
+    onAnnotationEditor: any;
+    /**
+     * Get the value for a given key if it exists, or return the default value.
+     * @param {string} key
+     * @param {Object} defaultValue
+     * @returns {Object}
+     */
+    getValue(key: string, defaultValue: Object): Object;
+    /**
+     * Get the value for a given key.
+     * @param {string} key
+     * @returns {Object}
+     */
+    getRawValue(key: string): Object;
+    /**
+     * Remove a value from the storage.
+     * @param {string} key
+     */
+    remove(key: string): void;
+    /**
+     * Set the value for a given key
+     * @param {string} key
+     * @param {Object} value
+     */
+    setValue(key: string, value: Object): void;
+    /**
+     * Check if the storage contains the given key.
+     * @param {string} key
+     * @returns {boolean}
+     */
+    has(key: string): boolean;
+    /**
+     * @returns {Object | null}
+     */
+    getAll(): Object | null;
+    /**
+     * @param {Object} obj
+     */
+    setAll(obj: Object): void;
+    get size(): number;
+    resetModified(): void;
+    /**
+     * @returns {PrintAnnotationStorage}
+     */
+    get print(): PrintAnnotationStorage;
+    /**
+     * PLEASE NOTE: Only intended for usage within the API itself.
+     * @ignore
+     */
+    get serializable(): Readonly<{
+        map: null;
+        hash: "";
+        transfers: undefined;
+    }> | {
+        map: Map<any, any>;
+        hash: string;
+        transfers: any[];
+    };
+    #private;
+}
+/**
+ * A special `AnnotationStorage` for use during printing, where the serializable
+ * data is *frozen* upon initialization, to prevent scripting from modifying its
+ * contents. (Necessary since printing is triggered synchronously in browsers.)
+ */
+export class PrintAnnotationStorage extends AnnotationStorage {
+    constructor(parent: any);
+    /**
+     * PLEASE NOTE: Only intended for usage within the API itself.
+     * @ignore
+     */
+    get serializable(): {
+        map: any;
+        hash: any;
+        transfers: any;
+    };
+    #private;
+}
+export const SerializableEmpty: Readonly<{
+    map: null;
+    hash: "";
+    transfers: undefined;
+}>;