@embedpdf/core 2.1.2 → 2.3.0

package/dist/lib/base/base-plugin.d.ts

@@ -1,7 +1,7 @@
 import { IPlugin } from '../types/plugin';
 import { PluginRegistry } from '../registry/plugin-registry';
 import { Action, CoreAction, CoreState, PluginStore, Store, StoreState } from '../store';
-import { Logger, PdfEngine } from '@embedpdf/models';
+import { Logger, PdfEngine, PdfPermissionFlag } from '@embedpdf/models';
 import { DocumentState } from '../store/initial-state';
 export interface StateChangeHandler<TState> {
     (state: TState): void;
@@ -164,4 +164,27 @@ export declare abstract class BasePlugin<TConfig = unknown, TCapability = unknow
      * @throws Error if document not found
      */
     protected getCoreDocumentOrThrow(documentId?: string): DocumentState;
+    /**
+     * Get the effective permission flags for a document.
+     * Applies layered resolution: per-document override → global override → PDF permission.
+     * Returns AllowAll if document not found.
+     * @param documentId Document ID (optional, defaults to active document)
+     */
+    protected getDocumentPermissions(documentId?: string): number;
+    /**
+     * Check if a document has the required permissions (returns boolean).
+     * Applies layered resolution: per-document override → global override → PDF permission.
+     * Useful for conditional UI logic.
+     * @param documentId Document ID (optional, defaults to active document)
+     * @param flags Permission flags to check
+     */
+    protected checkPermission(documentId: string | undefined, ...flags: PdfPermissionFlag[]): boolean;
+    /**
+     * Assert that a document has the required permissions.
+     * Applies layered resolution: per-document override → global override → PDF permission.
+     * Throws PermissionDeniedError if any flag is missing.
+     * @param documentId Document ID (optional, defaults to active document)
+     * @param flags Permission flags to require
+     */
+    protected requirePermission(documentId: string | undefined, ...flags: PdfPermissionFlag[]): void;
 }

package/dist/lib/index.d.ts

@@ -3,6 +3,7 @@ export * from './utils/dependency-resolver';
 export * from './utils/plugin-helpers';
 export * from './types/plugin';
 export * from './types/errors';
+export * from './types/permissions';
 export * from './base/base-plugin';
 export * from './store/types';
 export * from './store/actions';

package/dist/lib/store/actions.d.ts

@@ -1,4 +1,5 @@
 import { PdfDocumentObject, PdfErrorCode, PdfPageObject, Rotation } from '@embedpdf/models';
+import { PermissionConfig } from '../types/permissions';
 export declare const START_LOADING_DOCUMENT = "START_LOADING_DOCUMENT";
 export declare const UPDATE_DOCUMENT_LOADING_PROGRESS = "UPDATE_DOCUMENT_LOADING_PROGRESS";
 export declare const SET_DOCUMENT_LOADED = "SET_DOCUMENT_LOADED";
@@ -8,6 +9,7 @@ export declare const CLOSE_DOCUMENT = "CLOSE_DOCUMENT";
 export declare const SET_ACTIVE_DOCUMENT = "SET_ACTIVE_DOCUMENT";
 export declare const REORDER_DOCUMENTS = "REORDER_DOCUMENTS";
 export declare const MOVE_DOCUMENT = "MOVE_DOCUMENT";
+export declare const UPDATE_DOCUMENT_SECURITY = "UPDATE_DOCUMENT_SECURITY";
 export declare const REFRESH_DOCUMENT = "REFRESH_DOCUMENT";
 export declare const REFRESH_PAGES = "REFRESH_PAGES";
 export declare const SET_PAGES = "SET_PAGES";
@@ -15,7 +17,7 @@ export declare const SET_SCALE = "SET_SCALE";
 export declare const SET_ROTATION = "SET_ROTATION";
 export declare const SET_DEFAULT_SCALE = "SET_DEFAULT_SCALE";
 export declare const SET_DEFAULT_ROTATION = "SET_DEFAULT_ROTATION";
-export declare const CORE_ACTION_TYPES: readonly ["START_LOADING_DOCUMENT", "UPDATE_DOCUMENT_LOADING_PROGRESS", "SET_DOCUMENT_LOADED", "CLOSE_DOCUMENT", "SET_ACTIVE_DOCUMENT", "SET_DOCUMENT_ERROR", "RETRY_LOADING_DOCUMENT", "REFRESH_DOCUMENT", "REFRESH_PAGES", "SET_PAGES", "SET_SCALE", "SET_ROTATION", "SET_DEFAULT_SCALE", "SET_DEFAULT_ROTATION", "REORDER_DOCUMENTS", "MOVE_DOCUMENT"];
+export declare const CORE_ACTION_TYPES: readonly ["START_LOADING_DOCUMENT", "UPDATE_DOCUMENT_LOADING_PROGRESS", "SET_DOCUMENT_LOADED", "CLOSE_DOCUMENT", "SET_ACTIVE_DOCUMENT", "SET_DOCUMENT_ERROR", "RETRY_LOADING_DOCUMENT", "REFRESH_DOCUMENT", "REFRESH_PAGES", "SET_PAGES", "SET_SCALE", "SET_ROTATION", "SET_DEFAULT_SCALE", "SET_DEFAULT_ROTATION", "REORDER_DOCUMENTS", "MOVE_DOCUMENT", "UPDATE_DOCUMENT_SECURITY"];
 export interface StartLoadingDocumentAction {
     type: typeof START_LOADING_DOCUMENT;
     payload: {
@@ -25,6 +27,7 @@ export interface StartLoadingDocumentAction {
         rotation?: Rotation;
         passwordProvided?: boolean;
         autoActivate?: boolean;
+        permissions?: PermissionConfig;
     };
 }
 export interface UpdateDocumentLoadingProgressAction {
@@ -79,6 +82,14 @@ export interface MoveDocumentAction {
         toIndex: number;
     };
 }
+export interface UpdateDocumentSecurityAction {
+    type: typeof UPDATE_DOCUMENT_SECURITY;
+    payload: {
+        documentId: string;
+        permissions: number;
+        isOwnerUnlocked: boolean;
+    };
+}
 export interface RefreshDocumentAction {
     type: typeof REFRESH_DOCUMENT;
     payload: {
@@ -122,9 +133,9 @@ export interface SetDefaultRotationAction {
     type: typeof SET_DEFAULT_ROTATION;
     payload: Rotation;
 }
-export type DocumentAction = StartLoadingDocumentAction | UpdateDocumentLoadingProgressAction | SetDocumentLoadedAction | SetDocumentErrorAction | RetryLoadingDocumentAction | CloseDocumentAction | SetActiveDocumentAction | RefreshDocumentAction | RefreshPagesAction | SetPagesAction | SetScaleAction | SetRotationAction | SetDefaultScaleAction | SetDefaultRotationAction | ReorderDocumentsAction | MoveDocumentAction;
+export type DocumentAction = StartLoadingDocumentAction | UpdateDocumentLoadingProgressAction | SetDocumentLoadedAction | SetDocumentErrorAction | RetryLoadingDocumentAction | CloseDocumentAction | SetActiveDocumentAction | RefreshDocumentAction | RefreshPagesAction | SetPagesAction | SetScaleAction | SetRotationAction | SetDefaultScaleAction | SetDefaultRotationAction | ReorderDocumentsAction | MoveDocumentAction | UpdateDocumentSecurityAction;
 export type CoreAction = DocumentAction;
-export declare const startLoadingDocument: (documentId: string, name?: string, scale?: number, rotation?: Rotation, passwordProvided?: boolean, autoActivate?: boolean) => CoreAction;
+export declare const startLoadingDocument: (documentId: string, name?: string, scale?: number, rotation?: Rotation, passwordProvided?: boolean, autoActivate?: boolean, permissions?: PermissionConfig) => CoreAction;
 export declare const updateDocumentLoadingProgress: (documentId: string, progress: number) => CoreAction;
 export declare const setDocumentLoaded: (documentId: string, document: PdfDocumentObject) => CoreAction;
 export declare const setDocumentError: (documentId: string, error: string, errorCode?: PdfErrorCode, errorDetails?: any) => CoreAction;
@@ -140,3 +151,4 @@ export declare const setDefaultScale: (scale: number) => CoreAction;
 export declare const setDefaultRotation: (rotation: Rotation) => CoreAction;
 export declare const reorderDocuments: (order: string[]) => CoreAction;
 export declare const moveDocument: (documentId: string, toIndex: number) => CoreAction;
+export declare const updateDocumentSecurity: (documentId: string, permissions: number, isOwnerUnlocked: boolean) => CoreAction;

package/dist/lib/store/initial-state.d.ts

@@ -1,5 +1,6 @@
 import { PdfDocumentObject, PdfErrorCode, Rotation } from '@embedpdf/models';
 import { PluginRegistryConfig } from '../types/plugin';
+import { PermissionConfig } from '../types/permissions';
 export type DocumentStatus = 'loading' | 'loaded' | 'error';
 export interface DocumentState {
     id: string;
@@ -14,6 +15,7 @@ export interface DocumentState {
     scale: number;
     rotation: Rotation;
     pageRefreshVersions: Record<number, number>;
+    permissions?: PermissionConfig;
     loadStartedAt: number;
     loadedAt?: number;
 }
@@ -23,5 +25,7 @@ export interface CoreState {
     activeDocumentId: string | null;
     defaultScale: number;
     defaultRotation: Rotation;
+    /** Global permission configuration applied to all documents unless overridden per-document */
+    globalPermissions?: PermissionConfig;
 }
 export declare const initialCoreState: (config?: PluginRegistryConfig) => CoreState;

package/dist/lib/store/selectors.d.ts

@@ -1,3 +1,4 @@
+import { PdfPermissionFlag } from '@embedpdf/models';
 import { CoreState, DocumentState } from './initial-state';
 /**
  * Get the active document state
@@ -19,3 +20,22 @@ export declare const isDocumentLoaded: (state: CoreState, documentId: string) =>
  * Get the number of open documents
  */
 export declare const getDocumentCount: (state: CoreState) => number;
+/**
+ * Check if a specific permission flag is effectively allowed for a document.
+ * Applies layered resolution: per-document override → global override → enforceDocumentPermissions → PDF permission.
+ *
+ * @param state - The core state
+ * @param documentId - The document ID to check permissions for
+ * @param flag - The permission flag to check
+ * @returns true if the permission is allowed, false otherwise
+ */
+export declare function getEffectivePermission(state: CoreState, documentId: string, flag: PdfPermissionFlag): boolean;
+/**
+ * Get all effective permissions as a bitmask for a document.
+ * Combines all individual permission checks into a single bitmask.
+ *
+ * @param state - The core state
+ * @param documentId - The document ID to get permissions for
+ * @returns A bitmask of all effective permissions
+ */
+export declare function getEffectivePermissions(state: CoreState, documentId: string): number;

package/dist/lib/types/permissions.d.ts

@@ -0,0 +1,55 @@
+import { PdfPermissionFlag } from '@embedpdf/models';
+/**
+ * Human-readable permission names for use in configuration.
+ */
+export type PermissionName = 'print' | 'modifyContents' | 'copyContents' | 'modifyAnnotations' | 'fillForms' | 'extractForAccessibility' | 'assembleDocument' | 'printHighQuality';
+/**
+ * Map from human-readable names to PdfPermissionFlag values.
+ */
+export declare const PERMISSION_NAME_TO_FLAG: Record<PermissionName, PdfPermissionFlag>;
+/**
+ * Permission overrides can use either numeric flags or human-readable string names.
+ */
+export type PermissionOverrides = Partial<Record<PdfPermissionFlag, boolean> & Record<PermissionName, boolean>>;
+/**
+ * Configuration for overriding document permissions.
+ * Can be applied globally (at PluginRegistry level) or per-document (when opening).
+ */
+export interface PermissionConfig {
+    /**
+     * When true (default): use PDF's permissions as the base, then apply overrides.
+     * When false: treat document as having all permissions allowed, then apply overrides.
+     */
+    enforceDocumentPermissions?: boolean;
+    /**
+     * Explicit per-flag overrides. Supports both numeric flags and string names.
+     * - true = force allow (even if PDF denies)
+     * - false = force deny (even if PDF allows)
+     * - undefined = use base permissions
+     *
+     * @example
+     * // Using string names (recommended)
+     * overrides: { print: false, modifyAnnotations: true }
+     *
+     * @example
+     * // Using numeric flags
+     * overrides: { [PdfPermissionFlag.Print]: false }
+     */
+    overrides?: PermissionOverrides;
+}
+/**
+ * All permission flags for iteration when computing effective permissions.
+ */
+export declare const ALL_PERMISSION_FLAGS: PdfPermissionFlag[];
+/**
+ * All permission names for iteration.
+ */
+export declare const ALL_PERMISSION_NAMES: PermissionName[];
+/**
+ * Map from PdfPermissionFlag to human-readable name.
+ */
+export declare const PERMISSION_FLAG_TO_NAME: Record<PdfPermissionFlag, PermissionName>;
+/**
+ * Helper to get the override value for a permission flag, checking both numeric and string keys.
+ */
+export declare function getPermissionOverride(overrides: PermissionOverrides | undefined, flag: PdfPermissionFlag): boolean | undefined;

package/dist/lib/types/plugin.d.ts

@@ -2,6 +2,7 @@ import { PluginRegistry } from '../registry/plugin-registry';
 import { Logger, Rotation } from '@embedpdf/models';
 import { Action, Reducer } from '../store/types';
 import { CoreState } from '../store';
+import { PermissionConfig } from './permissions';
 export interface IPlugin<TConfig = unknown> {
     id: string;
     initialize?(config: TConfig): Promise<void>;
@@ -16,6 +17,11 @@ export interface PluginRegistryConfig {
     defaultRotation?: Rotation;
     defaultScale?: number;
     logger?: Logger;
+    /**
+     * Global permission configuration.
+     * Applied to all documents unless overridden per-document.
+     */
+    permissions?: PermissionConfig;
 }
 export interface PluginManifest<TConfig = unknown> {
     id: string;

package/dist/preact/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("preact"),t=require("preact/hooks"),n=require("preact/jsx-runtime"),r=require("@embedpdf/core"),i=e.createContext({registry:null,coreState:null,isInitializing:!0,pluginsReady:!1,activeDocumentId:null,activeDocument:null,documents:{},documentStates:[]});function o({plugins:i,children:o}){const{utilities:u,wrappers:s}=t.useMemo(()=>{const e=[],t=[];for(const n of i){const i=n.package;if(r.hasAutoMountElements(i)){const n=i.autoMountElements()||[];for(const r of n)"utility"===r.type?e.push(r.component):"wrapper"===r.type&&t.push(r.component)}}return{utilities:e,wrappers:t}},[i]),l=s.reduce((e,t)=>n.jsx(t,{children:e}),o);return n.jsxs(e.Fragment,{children:[l,u.map((e,t)=>n.jsx(e,{},`utility-${t}`))]})}function u(){const e=t.useContext(i);if(void 0===e)throw new Error("useCapability must be used within a PDFContext.Provider");const{registry:n,isInitializing:r}=e;if(r)return e;if(null===n)throw new Error("PDF registry failed to initialize properly");return e}function s(e){const{registry:t}=u();if(null===t)return{plugin:null,isLoading:!0,ready:new Promise(()=>{})};const n=t.getPlugin(e);if(!n)throw new Error(`Plugin ${e} not found`);return{plugin:n,isLoading:!1,ready:n.ready()}}function l(){const{coreState:e}=t.useContext(i);return e}exports.EmbedPDF=function({engine:e,logger:u,onInitialized:s,plugins:l,children:c,autoMountDomElements:a=!0}){const[d,p]=t.useState(null),[g,f]=t.useState(null),[y,m]=t.useState(!0),[S,v]=t.useState(!1),x=t.useRef(s);t.useEffect(()=>{x.current=s},[s]),t.useEffect(()=>{const t=new r.PluginRegistry(e,{logger:u});t.registerPluginBatch(l);let n;return(async()=>{var e;if(await t.initialize(),t.isDestroyed())return;const n=t.getStore();f(n.getState().core);const r=n.subscribe((e,t,r)=>{n.isCoreAction(e)&&t.core!==r.core&&f(t.core)});if(await(null==(e=x.current)?void 0:e.call(x,t)),!t.isDestroyed())return t.pluginsReady().then(()=>{t.isDestroyed()||v(!0)}),p(t),m(!1),r;r()})().then(e=>{n=e}).catch(console.error),()=>{null==n||n(),t.destroy(),p(null),f(null),m(!0),v(!1)}},[e,l]);const h=t.useMemo(()=>{const e=(null==g?void 0:g.activeDocumentId)??null,t=(null==g?void 0:g.documents)??{},n=(null==g?void 0:g.documentOrder)??[],r=e&&t[e]?t[e]:null,i=n.map(e=>t[e]).filter(e=>null!=e);return{registry:d,coreState:g,isInitializing:y,pluginsReady:S,activeDocumentId:e,activeDocument:r,documents:t,documentStates:i}},[d,g,y,S]),w="function"==typeof c?c(h):c;return n.jsx(i.Provider,{value:h,children:S&&a?n.jsx(o,{plugins:l,children:w}):w})},exports.PDFContext=i,exports.useCapability=function(e){const{plugin:t,isLoading:n,ready:r}=s(e);if(!t)return{provides:null,isLoading:n,ready:r};if(!t.provides)throw new Error(`Plugin ${e} does not provide a capability`);return{provides:t.provides(),isLoading:n,ready:r}},exports.useCoreState=l,exports.useDocumentState=function(e){const n=l();return t.useMemo(()=>n&&e?n.documents[e]??null:null,[n,e])},exports.usePlugin=s,exports.useRegistry=u,exports.useStoreState=function(){const{registry:e}=u(),[n,r]=t.useState(null);return t.useEffect(()=>{if(!e)return;r(e.getStore().getState());const t=e.getStore().subscribe((e,t)=>{r(t)});return()=>t()},[e]),n};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("preact"),n=require("preact/hooks"),i=require("preact/jsx-runtime"),t=require("@embedpdf/core"),s=require("@embedpdf/models"),o=e.createContext({registry:null,coreState:null,isInitializing:!0,pluginsReady:!1,activeDocumentId:null,activeDocument:null,documents:{},documentStates:[]});function r({plugins:s,children:o}){const{utilities:r,wrappers:l}=n.useMemo(()=>{const e=[],n=[];for(const i of s){const s=i.package;if(t.hasAutoMountElements(s)){const i=s.autoMountElements()||[];for(const t of i)"utility"===t.type?e.push(t.component):"wrapper"===t.type&&n.push(t.component)}}return{utilities:e,wrappers:n}},[s]),u=l.reduce((e,n)=>i.jsx(n,{children:e}),o);return i.jsxs(e.Fragment,{children:[u,r.map((e,n)=>i.jsx(e,{},`utility-${n}`))]})}function l(){const e=n.useContext(o);if(void 0===e)throw new Error("useCapability must be used within a PDFContext.Provider");const{registry:i,isInitializing:t}=e;if(t)return e;if(null===i)throw new Error("PDF registry failed to initialize properly");return e}function u(e){const{registry:n}=l();if(null===n)return{plugin:null,isLoading:!0,ready:new Promise(()=>{})};const i=n.getPlugin(e);if(!i)throw new Error(`Plugin ${e} not found`);return{plugin:i,isLoading:!1,ready:i.ready()}}function a(){const{coreState:e}=n.useContext(o);return e}s.PdfPermissionFlag.Print,s.PdfPermissionFlag.ModifyContents,s.PdfPermissionFlag.CopyContents,s.PdfPermissionFlag.ModifyAnnotations,s.PdfPermissionFlag.FillForms,s.PdfPermissionFlag.ExtractForAccessibility,s.PdfPermissionFlag.AssembleDocument,s.PdfPermissionFlag.PrintHighQuality;const c=[s.PdfPermissionFlag.Print,s.PdfPermissionFlag.ModifyContents,s.PdfPermissionFlag.CopyContents,s.PdfPermissionFlag.ModifyAnnotations,s.PdfPermissionFlag.FillForms,s.PdfPermissionFlag.ExtractForAccessibility,s.PdfPermissionFlag.AssembleDocument,s.PdfPermissionFlag.PrintHighQuality],d={[s.PdfPermissionFlag.Print]:"print",[s.PdfPermissionFlag.ModifyContents]:"modifyContents",[s.PdfPermissionFlag.CopyContents]:"copyContents",[s.PdfPermissionFlag.ModifyAnnotations]:"modifyAnnotations",[s.PdfPermissionFlag.FillForms]:"fillForms",[s.PdfPermissionFlag.ExtractForAccessibility]:"extractForAccessibility",[s.PdfPermissionFlag.AssembleDocument]:"assembleDocument",[s.PdfPermissionFlag.PrintHighQuality]:"printHighQuality"};function m(e,n){if(!e)return;if(n in e)return e[n];const i=d[n];return i&&i in e?e[i]:void 0}function P(e,n,i){var t;const o=e.documents[n],r=null==o?void 0:o.permissions,l=e.globalPermissions,u=(null==(t=null==o?void 0:o.document)?void 0:t.permissions)??s.PdfPermissionFlag.AllowAll,a=m(null==r?void 0:r.overrides,i);if(void 0!==a)return a;const c=m(null==l?void 0:l.overrides,i);if(void 0!==c)return c;return!((null==r?void 0:r.enforceDocumentPermissions)??(null==l?void 0:l.enforceDocumentPermissions)??!0)||0!==(u&i)}exports.EmbedPDF=function({engine:e,config:s,logger:l,onInitialized:u,plugins:a,children:c,autoMountDomElements:d=!0}){const[m,P]=n.useState(null),[f,g]=n.useState(null),[y,p]=n.useState(!0),[F,v]=n.useState(!1),A=n.useRef(u);n.useEffect(()=>{A.current=u},[u]),n.useEffect(()=>{const n={...s,logger:(null==s?void 0:s.logger)??l},i=new t.PluginRegistry(e,n);i.registerPluginBatch(a);let o;return(async()=>{var e;if(await i.initialize(),i.isDestroyed())return;const n=i.getStore();g(n.getState().core);const t=n.subscribe((e,i,t)=>{n.isCoreAction(e)&&i.core!==t.core&&g(i.core)});if(await(null==(e=A.current)?void 0:e.call(A,i)),!i.isDestroyed())return i.pluginsReady().then(()=>{i.isDestroyed()||v(!0)}),P(i),p(!1),t;t()})().then(e=>{o=e}).catch(console.error),()=>{null==o||o(),i.destroy(),P(null),g(null),p(!0),v(!1)}},[e,a]);const h=n.useMemo(()=>{const e=(null==f?void 0:f.activeDocumentId)??null,n=(null==f?void 0:f.documents)??{},i=(null==f?void 0:f.documentOrder)??[],t=e&&n[e]?n[e]:null,s=i.map(e=>n[e]).filter(e=>null!=e);return{registry:m,coreState:f,isInitializing:y,pluginsReady:F,activeDocumentId:e,activeDocument:t,documents:n,documentStates:s}},[m,f,y,F]),C="function"==typeof c?c(h):c;return i.jsx(o.Provider,{value:h,children:F&&d?i.jsx(r,{plugins:a,children:C}):C})},exports.PDFContext=o,exports.useCapability=function(e){const{plugin:n,isLoading:i,ready:t}=u(e);if(!n)return{provides:null,isLoading:i,ready:t};if(!n.provides)throw new Error(`Plugin ${e} does not provide a capability`);return{provides:n.provides(),isLoading:i,ready:t}},exports.useCoreState=a,exports.useDocumentPermissions=function(e){const i=a();return n.useMemo(()=>{var n,t;if(!i)return{permissions:s.PdfPermissionFlag.AllowAll,pdfPermissions:s.PdfPermissionFlag.AllowAll,hasPermission:()=>!0,hasAllPermissions:()=>!0,canPrint:!0,canModifyContents:!0,canCopyContents:!0,canModifyAnnotations:!0,canFillForms:!0,canExtractForAccessibility:!0,canAssembleDocument:!0,canPrintHighQuality:!0};const o=function(e,n){return c.reduce((i,t)=>P(e,n,t)?i|t:i,0)}(i,e),r=n=>P(i,e,n);return{permissions:o,pdfPermissions:(null==(t=null==(n=i.documents[e])?void 0:n.document)?void 0:t.permissions)??s.PdfPermissionFlag.AllowAll,hasPermission:r,hasAllPermissions:(...n)=>n.every(n=>P(i,e,n)),canPrint:r(s.PdfPermissionFlag.Print),canModifyContents:r(s.PdfPermissionFlag.ModifyContents),canCopyContents:r(s.PdfPermissionFlag.CopyContents),canModifyAnnotations:r(s.PdfPermissionFlag.ModifyAnnotations),canFillForms:r(s.PdfPermissionFlag.FillForms),canExtractForAccessibility:r(s.PdfPermissionFlag.ExtractForAccessibility),canAssembleDocument:r(s.PdfPermissionFlag.AssembleDocument),canPrintHighQuality:r(s.PdfPermissionFlag.PrintHighQuality)}},[i,e])},exports.useDocumentState=function(e){const i=a();return n.useMemo(()=>i&&e?i.documents[e]??null:null,[i,e])},exports.usePlugin=u,exports.useRegistry=l,exports.useStoreState=function(){const{registry:e}=l(),[i,t]=n.useState(null);return n.useEffect(()=>{if(!e)return;t(e.getStore().getState());const n=e.getStore().subscribe((e,n)=>{t(n)});return()=>n()},[e]),i};
 //# sourceMappingURL=index.cjs.map

package/dist/preact/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/shared/context.ts","../../src/shared/components/auto-mount.tsx","../../src/shared/hooks/use-registry.ts","../../src/shared/hooks/use-plugin.ts","../../src/shared/hooks/use-core-state.ts","../../src/shared/components/embed-pdf.tsx","../../src/shared/hooks/use-capability.ts","../../src/shared/hooks/use-document-state.ts","../../src/shared/hooks/use-store-state.ts"],"sourcesContent":["import { createContext } from '@framework';\nimport type { CoreState, DocumentState, PluginRegistry } from '@embedpdf/core';\n\nexport interface PDFContextState {\n  registry: PluginRegistry | null;\n  coreState: CoreState | null;\n  isInitializing: boolean;\n  pluginsReady: boolean;\n\n  // Convenience accessors (always safe to use)\n  activeDocumentId: string | null;\n  activeDocument: DocumentState | null;\n  documents: Record<string, DocumentState>;\n  documentStates: DocumentState[];\n}\n\nexport const PDFContext = createContext<PDFContextState>({\n  registry: null,\n  coreState: null,\n  isInitializing: true,\n  pluginsReady: false,\n  activeDocumentId: null,\n  activeDocument: null,\n  documents: {},\n  documentStates: [],\n});\n","import { Fragment, useMemo, ComponentType, ReactNode } from '@framework';\nimport { hasAutoMountElements } from '@embedpdf/core';\nimport type { PluginBatchRegistration, IPlugin } from '@embedpdf/core';\n\ninterface AutoMountProps {\n  plugins: PluginBatchRegistration<IPlugin<any>, any>[];\n  children: ReactNode;\n}\n\nexport function AutoMount({ plugins, children }: AutoMountProps) {\n  const { utilities, wrappers } = useMemo(() => {\n    // React-specific types for internal use\n    const utilities: ComponentType[] = [];\n    const wrappers: ComponentType<{ children: ReactNode }>[] = [];\n\n    for (const reg of plugins) {\n      const pkg = reg.package;\n      if (hasAutoMountElements(pkg)) {\n        const elements = pkg.autoMountElements() || [];\n\n        for (const element of elements) {\n          if (element.type === 'utility') {\n            utilities.push(element.component);\n          } else if (element.type === 'wrapper') {\n            // In React context, we know wrappers need children\n            wrappers.push(element.component);\n          }\n        }\n      }\n    }\n    return { utilities, wrappers };\n  }, [plugins]);\n\n  // React-specific wrapping logic\n  const wrappedContent = wrappers.reduce(\n    (content, Wrapper) => <Wrapper>{content}</Wrapper>,\n    children,\n  );\n\n  return (\n    <Fragment>\n      {wrappedContent}\n      {utilities.map((Utility, i) => (\n        <Utility key={`utility-${i}`} />\n      ))}\n    </Fragment>\n  );\n}\n","import { useContext } from '@framework';\nimport { PDFContext, PDFContextState } from '../context';\n\n/**\n * Hook to access the PDF registry.\n * @returns The PDF registry or null during initialization\n */\nexport function useRegistry(): PDFContextState {\n  const contextValue = useContext(PDFContext);\n\n  // Error if used outside of context\n  if (contextValue === undefined) {\n    throw new Error('useCapability must be used within a PDFContext.Provider');\n  }\n\n  const { registry, isInitializing } = contextValue;\n\n  // During initialization, return null instead of throwing an error\n  if (isInitializing) {\n    return contextValue;\n  }\n\n  // At this point, initialization is complete but registry is still null, which is unexpected\n  if (registry === null) {\n    throw new Error('PDF registry failed to initialize properly');\n  }\n\n  return contextValue;\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\ntype PluginState<T extends BasePlugin> = {\n  plugin: T | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin.\n * @param pluginId The ID of the plugin to access\n * @returns The plugin or null during initialization\n * @example\n * // Get zoom plugin\n * const zoom = usePlugin<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function usePlugin<T extends BasePlugin>(pluginId: T['id']): PluginState<T> {\n  const { registry } = useRegistry();\n\n  if (registry === null) {\n    return {\n      plugin: null,\n      isLoading: true,\n      ready: new Promise(() => {}),\n    };\n  }\n\n  const plugin = registry.getPlugin<T>(pluginId);\n\n  if (!plugin) {\n    throw new Error(`Plugin ${pluginId} not found`);\n  }\n\n  return {\n    plugin,\n    isLoading: false,\n    ready: plugin.ready(),\n  };\n}\n","import { useContext } from '@framework';\nimport { CoreState } from '@embedpdf/core';\nimport { PDFContext } from '../context';\n\n/**\n * Hook that provides access to the current core state.\n *\n * Note: This reads from the context which is already subscribed to core state changes\n * in the EmbedPDF component, so there's no additional subscription overhead.\n */\nexport function useCoreState(): CoreState | null {\n  const { coreState } = useContext(PDFContext);\n  return coreState;\n}\n","import { useState, useEffect, useRef, useMemo, ReactNode } from '@framework';\nimport { Logger, PdfEngine } from '@embedpdf/models';\nimport { PluginRegistry, CoreState, DocumentState } from '@embedpdf/core';\nimport type { PluginBatchRegistrations } from '@embedpdf/core';\n\nimport { PDFContext, PDFContextState } from '../context';\nimport { AutoMount } from './auto-mount';\n\nexport type { PluginBatchRegistrations };\n\ninterface EmbedPDFProps {\n  /**\n   * The PDF engine to use for the PDF viewer.\n   */\n  engine: PdfEngine;\n  /**\n   * The logger to use for the PDF viewer.\n   */\n  logger?: Logger;\n  /**\n   * The callback to call when the PDF viewer is initialized.\n   */\n  onInitialized?: (registry: PluginRegistry) => Promise<void>;\n  /**\n   * The plugins to use for the PDF viewer.\n   */\n  plugins: PluginBatchRegistrations;\n  /**\n   * The children to render for the PDF viewer.\n   */\n  children: ReactNode | ((state: PDFContextState) => ReactNode);\n  /**\n   * Whether to auto-mount specific non-visual DOM elements from plugins.\n   * @default true\n   */\n  autoMountDomElements?: boolean;\n}\n\nexport function EmbedPDF({\n  engine,\n  logger,\n  onInitialized,\n  plugins,\n  children,\n  autoMountDomElements = true,\n}: EmbedPDFProps) {\n  const [registry, setRegistry] = useState<PluginRegistry | null>(null);\n  const [coreState, setCoreState] = useState<CoreState | null>(null);\n  const [isInitializing, setIsInitializing] = useState<boolean>(true);\n  const [pluginsReady, setPluginsReady] = useState<boolean>(false);\n  const initRef = useRef<EmbedPDFProps['onInitialized']>(onInitialized);\n\n  useEffect(() => {\n    initRef.current = onInitialized;\n  }, [onInitialized]);\n\n  useEffect(() => {\n    const pdfViewer = new PluginRegistry(engine, { logger });\n    pdfViewer.registerPluginBatch(plugins);\n\n    const initialize = async () => {\n      await pdfViewer.initialize();\n\n      if (pdfViewer.isDestroyed()) {\n        return;\n      }\n\n      const store = pdfViewer.getStore();\n      setCoreState(store.getState().core);\n\n      const unsubscribe = store.subscribe((action, newState, oldState) => {\n        // Only update if it's a core action and the core state changed\n        if (store.isCoreAction(action) && newState.core !== oldState.core) {\n          setCoreState(newState.core);\n        }\n      });\n\n      /* always call the *latest* callback */\n      await initRef.current?.(pdfViewer);\n\n      if (pdfViewer.isDestroyed()) {\n        unsubscribe();\n        return;\n      }\n\n      pdfViewer.pluginsReady().then(() => {\n        if (!pdfViewer.isDestroyed()) {\n          setPluginsReady(true);\n        }\n      });\n\n      // Provide the registry to children via context\n      setRegistry(pdfViewer);\n      setIsInitializing(false);\n\n      // Return cleanup function\n      return unsubscribe;\n    };\n\n    let cleanup: (() => void) | undefined;\n    initialize()\n      .then((unsub) => {\n        cleanup = unsub;\n      })\n      .catch(console.error);\n\n    return () => {\n      cleanup?.();\n      pdfViewer.destroy();\n      setRegistry(null);\n      setCoreState(null);\n      setIsInitializing(true);\n      setPluginsReady(false);\n    };\n  }, [engine, plugins]);\n\n  // Compute convenience accessors\n  const contextValue: PDFContextState = useMemo(() => {\n    const activeDocumentId = coreState?.activeDocumentId ?? null;\n    const documents = coreState?.documents ?? {};\n    const documentOrder = coreState?.documentOrder ?? [];\n\n    // Compute active document\n    const activeDocument =\n      activeDocumentId && documents[activeDocumentId] ? documents[activeDocumentId] : null;\n\n    // Compute open documents in order\n    const documentStates = documentOrder\n      .map((docId) => documents[docId])\n      .filter((doc): doc is DocumentState => doc !== null && doc !== undefined);\n\n    return {\n      registry,\n      coreState,\n      isInitializing,\n      pluginsReady,\n      // Convenience accessors (always safe to use)\n      activeDocumentId,\n      activeDocument,\n      documents,\n      documentStates,\n    };\n  }, [registry, coreState, isInitializing, pluginsReady]);\n\n  const content = typeof children === 'function' ? children(contextValue) : children;\n\n  return (\n    <PDFContext.Provider value={contextValue}>\n      {pluginsReady && autoMountDomElements ? (\n        <AutoMount plugins={plugins}>{content}</AutoMount>\n      ) : (\n        content\n      )}\n    </PDFContext.Provider>\n  );\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { usePlugin } from './use-plugin';\n\ntype CapabilityState<T extends BasePlugin> = {\n  provides: ReturnType<NonNullable<T['provides']>> | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin's capability.\n * @param pluginId The ID of the plugin to access\n * @returns The capability provided by the plugin or null during initialization\n * @example\n * // Get zoom capability\n * const zoom = useCapability<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function useCapability<T extends BasePlugin>(pluginId: T['id']): CapabilityState<T> {\n  const { plugin, isLoading, ready } = usePlugin<T>(pluginId);\n\n  if (!plugin) {\n    return {\n      provides: null,\n      isLoading,\n      ready,\n    };\n  }\n\n  if (!plugin.provides) {\n    throw new Error(`Plugin ${pluginId} does not provide a capability`);\n  }\n\n  return {\n    provides: plugin.provides() as ReturnType<NonNullable<T['provides']>>,\n    isLoading,\n    ready,\n  };\n}\n","import { useMemo } from '@framework';\nimport { DocumentState } from '@embedpdf/core';\nimport { useCoreState } from './use-core-state';\n\n/**\n * Hook that provides reactive access to a specific document's state from the core store.\n *\n * @param documentId The ID of the document to retrieve.\n * @returns The reactive DocumentState object or null if not found.\n */\nexport function useDocumentState(documentId: string | null): DocumentState | null {\n  const coreState = useCoreState();\n\n  const documentState = useMemo(() => {\n    if (!coreState || !documentId) return null;\n    return coreState.documents[documentId] ?? null;\n  }, [coreState, documentId]);\n\n  return documentState;\n}\n","import { useState, useEffect } from '@framework';\nimport { CoreState, StoreState } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\n/**\n * Hook that provides access to the current global store state\n * and re-renders the component when the state changes\n */\nexport function useStoreState<T = CoreState>(): StoreState<T> | null {\n  const { registry } = useRegistry();\n  const [state, setState] = useState<StoreState<T> | null>(null);\n\n  useEffect(() => {\n    if (!registry) return;\n\n    // Get initial state\n    setState(registry.getStore().getState() as StoreState<T>);\n\n    // Subscribe to store changes\n    const unsubscribe = registry.getStore().subscribe((_action, newState) => {\n      setState(newState as StoreState<T>);\n    });\n\n    return () => unsubscribe();\n  }, [registry]);\n\n  return state;\n}\n"],"names":["PDFContext","createContext","registry","coreState","isInitializing","pluginsReady","activeDocumentId","activeDocument","documents","documentStates","AutoMount","plugins","children","utilities","wrappers","useMemo","reg","pkg","package","hasAutoMountElements","elements","autoMountElements","element","type","push","component","wrappedContent","reduce","content","Wrapper","jsx","Fragment","map","Utility","i","useRegistry","contextValue","useContext","Error","usePlugin","pluginId","plugin","isLoading","ready","Promise","getPlugin","useCoreState","engine","logger","onInitialized","autoMountDomElements","setRegistry","useState","setCoreState","setIsInitializing","setPluginsReady","initRef","useRef","useEffect","current","pdfViewer","PluginRegistry","registerPluginBatch","cleanup","async","initialize","isDestroyed","store","getStore","getState","core","unsubscribe","subscribe","action","newState","oldState","isCoreAction","_a","call","then","unsub","catch","console","error","destroy","documentOrder","docId","filter","doc","Provider","value","provides","documentId","state","setState","_action"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/shared/context.ts","../../src/shared/components/auto-mount.tsx","../../src/shared/hooks/use-registry.ts","../../src/shared/hooks/use-plugin.ts","../../src/shared/hooks/use-core-state.ts","../../src/lib/types/permissions.ts","../../src/lib/store/selectors.ts","../../src/shared/components/embed-pdf.tsx","../../src/shared/hooks/use-capability.ts","../../src/shared/hooks/use-document-permissions.ts","../../src/shared/hooks/use-document-state.ts","../../src/shared/hooks/use-store-state.ts"],"sourcesContent":["import { createContext } from '@framework';\nimport type { CoreState, DocumentState, PluginRegistry } from '@embedpdf/core';\n\nexport interface PDFContextState {\n  registry: PluginRegistry | null;\n  coreState: CoreState | null;\n  isInitializing: boolean;\n  pluginsReady: boolean;\n\n  // Convenience accessors (always safe to use)\n  activeDocumentId: string | null;\n  activeDocument: DocumentState | null;\n  documents: Record<string, DocumentState>;\n  documentStates: DocumentState[];\n}\n\nexport const PDFContext = createContext<PDFContextState>({\n  registry: null,\n  coreState: null,\n  isInitializing: true,\n  pluginsReady: false,\n  activeDocumentId: null,\n  activeDocument: null,\n  documents: {},\n  documentStates: [],\n});\n","import { Fragment, useMemo, ComponentType, ReactNode } from '@framework';\nimport { hasAutoMountElements } from '@embedpdf/core';\nimport type { PluginBatchRegistration, IPlugin } from '@embedpdf/core';\n\ninterface AutoMountProps {\n  plugins: PluginBatchRegistration<IPlugin<any>, any>[];\n  children: ReactNode;\n}\n\nexport function AutoMount({ plugins, children }: AutoMountProps) {\n  const { utilities, wrappers } = useMemo(() => {\n    // React-specific types for internal use\n    const utilities: ComponentType[] = [];\n    const wrappers: ComponentType<{ children: ReactNode }>[] = [];\n\n    for (const reg of plugins) {\n      const pkg = reg.package;\n      if (hasAutoMountElements(pkg)) {\n        const elements = pkg.autoMountElements() || [];\n\n        for (const element of elements) {\n          if (element.type === 'utility') {\n            utilities.push(element.component);\n          } else if (element.type === 'wrapper') {\n            // In React context, we know wrappers need children\n            wrappers.push(element.component);\n          }\n        }\n      }\n    }\n    return { utilities, wrappers };\n  }, [plugins]);\n\n  // React-specific wrapping logic\n  const wrappedContent = wrappers.reduce(\n    (content, Wrapper) => <Wrapper>{content}</Wrapper>,\n    children,\n  );\n\n  return (\n    <Fragment>\n      {wrappedContent}\n      {utilities.map((Utility, i) => (\n        <Utility key={`utility-${i}`} />\n      ))}\n    </Fragment>\n  );\n}\n","import { useContext } from '@framework';\nimport { PDFContext, PDFContextState } from '../context';\n\n/**\n * Hook to access the PDF registry.\n * @returns The PDF registry or null during initialization\n */\nexport function useRegistry(): PDFContextState {\n  const contextValue = useContext(PDFContext);\n\n  // Error if used outside of context\n  if (contextValue === undefined) {\n    throw new Error('useCapability must be used within a PDFContext.Provider');\n  }\n\n  const { registry, isInitializing } = contextValue;\n\n  // During initialization, return null instead of throwing an error\n  if (isInitializing) {\n    return contextValue;\n  }\n\n  // At this point, initialization is complete but registry is still null, which is unexpected\n  if (registry === null) {\n    throw new Error('PDF registry failed to initialize properly');\n  }\n\n  return contextValue;\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\ntype PluginState<T extends BasePlugin> = {\n  plugin: T | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin.\n * @param pluginId The ID of the plugin to access\n * @returns The plugin or null during initialization\n * @example\n * // Get zoom plugin\n * const zoom = usePlugin<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function usePlugin<T extends BasePlugin>(pluginId: T['id']): PluginState<T> {\n  const { registry } = useRegistry();\n\n  if (registry === null) {\n    return {\n      plugin: null,\n      isLoading: true,\n      ready: new Promise(() => {}),\n    };\n  }\n\n  const plugin = registry.getPlugin<T>(pluginId);\n\n  if (!plugin) {\n    throw new Error(`Plugin ${pluginId} not found`);\n  }\n\n  return {\n    plugin,\n    isLoading: false,\n    ready: plugin.ready(),\n  };\n}\n","import { useContext } from '@framework';\nimport { CoreState } from '@embedpdf/core';\nimport { PDFContext } from '../context';\n\n/**\n * Hook that provides access to the current core state.\n *\n * Note: This reads from the context which is already subscribed to core state changes\n * in the EmbedPDF component, so there's no additional subscription overhead.\n */\nexport function useCoreState(): CoreState | null {\n  const { coreState } = useContext(PDFContext);\n  return coreState;\n}\n","import { PdfPermissionFlag } from '@embedpdf/models';\n\n/**\n * Human-readable permission names for use in configuration.\n */\nexport type PermissionName =\n  | 'print'\n  | 'modifyContents'\n  | 'copyContents'\n  | 'modifyAnnotations'\n  | 'fillForms'\n  | 'extractForAccessibility'\n  | 'assembleDocument'\n  | 'printHighQuality';\n\n/**\n * Map from human-readable names to PdfPermissionFlag values.\n */\nexport const PERMISSION_NAME_TO_FLAG: Record<PermissionName, PdfPermissionFlag> = {\n  print: PdfPermissionFlag.Print,\n  modifyContents: PdfPermissionFlag.ModifyContents,\n  copyContents: PdfPermissionFlag.CopyContents,\n  modifyAnnotations: PdfPermissionFlag.ModifyAnnotations,\n  fillForms: PdfPermissionFlag.FillForms,\n  extractForAccessibility: PdfPermissionFlag.ExtractForAccessibility,\n  assembleDocument: PdfPermissionFlag.AssembleDocument,\n  printHighQuality: PdfPermissionFlag.PrintHighQuality,\n};\n\n/**\n * Permission overrides can use either numeric flags or human-readable string names.\n */\nexport type PermissionOverrides = Partial<\n  Record<PdfPermissionFlag, boolean> & Record<PermissionName, boolean>\n>;\n\n/**\n * Configuration for overriding document permissions.\n * Can be applied globally (at PluginRegistry level) or per-document (when opening).\n */\nexport interface PermissionConfig {\n  /**\n   * When true (default): use PDF's permissions as the base, then apply overrides.\n   * When false: treat document as having all permissions allowed, then apply overrides.\n   */\n  enforceDocumentPermissions?: boolean;\n\n  /**\n   * Explicit per-flag overrides. Supports both numeric flags and string names.\n   * - true = force allow (even if PDF denies)\n   * - false = force deny (even if PDF allows)\n   * - undefined = use base permissions\n   *\n   * @example\n   * // Using string names (recommended)\n   * overrides: { print: false, modifyAnnotations: true }\n   *\n   * @example\n   * // Using numeric flags\n   * overrides: { [PdfPermissionFlag.Print]: false }\n   */\n  overrides?: PermissionOverrides;\n}\n\n/**\n * All permission flags for iteration when computing effective permissions.\n */\nexport const ALL_PERMISSION_FLAGS: PdfPermissionFlag[] = [\n  PdfPermissionFlag.Print,\n  PdfPermissionFlag.ModifyContents,\n  PdfPermissionFlag.CopyContents,\n  PdfPermissionFlag.ModifyAnnotations,\n  PdfPermissionFlag.FillForms,\n  PdfPermissionFlag.ExtractForAccessibility,\n  PdfPermissionFlag.AssembleDocument,\n  PdfPermissionFlag.PrintHighQuality,\n];\n\n/**\n * All permission names for iteration.\n */\nexport const ALL_PERMISSION_NAMES: PermissionName[] = [\n  'print',\n  'modifyContents',\n  'copyContents',\n  'modifyAnnotations',\n  'fillForms',\n  'extractForAccessibility',\n  'assembleDocument',\n  'printHighQuality',\n];\n\n/**\n * Map from PdfPermissionFlag to human-readable name.\n */\nexport const PERMISSION_FLAG_TO_NAME: Record<PdfPermissionFlag, PermissionName> = {\n  [PdfPermissionFlag.Print]: 'print',\n  [PdfPermissionFlag.ModifyContents]: 'modifyContents',\n  [PdfPermissionFlag.CopyContents]: 'copyContents',\n  [PdfPermissionFlag.ModifyAnnotations]: 'modifyAnnotations',\n  [PdfPermissionFlag.FillForms]: 'fillForms',\n  [PdfPermissionFlag.ExtractForAccessibility]: 'extractForAccessibility',\n  [PdfPermissionFlag.AssembleDocument]: 'assembleDocument',\n  [PdfPermissionFlag.PrintHighQuality]: 'printHighQuality',\n};\n\n/**\n * Helper to get the override value for a permission flag, checking both numeric and string keys.\n */\nexport function getPermissionOverride(\n  overrides: PermissionOverrides | undefined,\n  flag: PdfPermissionFlag,\n): boolean | undefined {\n  if (!overrides) return undefined;\n\n  // Check numeric key first\n  if (flag in overrides) {\n    return (overrides as Record<PdfPermissionFlag, boolean>)[flag];\n  }\n\n  // Check string key\n  const name = PERMISSION_FLAG_TO_NAME[flag];\n  if (name && name in overrides) {\n    return (overrides as Record<PermissionName, boolean>)[name];\n  }\n\n  return undefined;\n}\n","import { PdfPermissionFlag } from '@embedpdf/models';\nimport { CoreState, DocumentState } from './initial-state';\nimport { ALL_PERMISSION_FLAGS, getPermissionOverride } from '../types/permissions';\n\n/**\n * Get the active document state\n */\nexport const getActiveDocumentState = (state: CoreState): DocumentState | null => {\n  if (!state.activeDocumentId) return null;\n  return state.documents[state.activeDocumentId] ?? null;\n};\n\n/**\n * Get document state by ID\n */\nexport const getDocumentState = (state: CoreState, documentId: string): DocumentState | null => {\n  return state.documents[documentId] ?? null;\n};\n\n/**\n * Get all document IDs\n */\nexport const getDocumentIds = (state: CoreState): string[] => {\n  return Object.keys(state.documents);\n};\n\n/**\n * Check if a document is loaded\n */\nexport const isDocumentLoaded = (state: CoreState, documentId: string): boolean => {\n  return !!state.documents[documentId];\n};\n\n/**\n * Get the number of open documents\n */\nexport const getDocumentCount = (state: CoreState): number => {\n  return Object.keys(state.documents).length;\n};\n\n// ─────────────────────────────────────────────────────────\n// Permission Selectors\n// ─────────────────────────────────────────────────────────\n\n/**\n * Check if a specific permission flag is effectively allowed for a document.\n * Applies layered resolution: per-document override → global override → enforceDocumentPermissions → PDF permission.\n *\n * @param state - The core state\n * @param documentId - The document ID to check permissions for\n * @param flag - The permission flag to check\n * @returns true if the permission is allowed, false otherwise\n */\nexport function getEffectivePermission(\n  state: CoreState,\n  documentId: string,\n  flag: PdfPermissionFlag,\n): boolean {\n  const docState = state.documents[documentId];\n  const docConfig = docState?.permissions;\n  const globalConfig = state.globalPermissions;\n  const pdfPermissions = docState?.document?.permissions ?? PdfPermissionFlag.AllowAll;\n\n  // 1. Per-document override wins (supports both numeric and string keys)\n  const docOverride = getPermissionOverride(docConfig?.overrides, flag);\n  if (docOverride !== undefined) {\n    return docOverride;\n  }\n\n  // 2. Global override (supports both numeric and string keys)\n  const globalOverride = getPermissionOverride(globalConfig?.overrides, flag);\n  if (globalOverride !== undefined) {\n    return globalOverride;\n  }\n\n  // 3. Check enforce setting (per-doc takes precedence over global)\n  const enforce =\n    docConfig?.enforceDocumentPermissions ?? globalConfig?.enforceDocumentPermissions ?? true;\n\n  if (!enforce) return true; // Not enforcing = allow all\n\n  // 4. Use PDF permission\n  return (pdfPermissions & flag) !== 0;\n}\n\n/**\n * Get all effective permissions as a bitmask for a document.\n * Combines all individual permission checks into a single bitmask.\n *\n * @param state - The core state\n * @param documentId - The document ID to get permissions for\n * @returns A bitmask of all effective permissions\n */\nexport function getEffectivePermissions(state: CoreState, documentId: string): number {\n  return ALL_PERMISSION_FLAGS.reduce((acc, flag) => {\n    return getEffectivePermission(state, documentId, flag) ? acc | flag : acc;\n  }, 0);\n}\n","import { useState, useEffect, useRef, useMemo, ReactNode } from '@framework';\nimport { Logger, PdfEngine } from '@embedpdf/models';\nimport { PluginRegistry, CoreState, DocumentState, PluginRegistryConfig } from '@embedpdf/core';\nimport type { PluginBatchRegistrations } from '@embedpdf/core';\n\nimport { PDFContext, PDFContextState } from '../context';\nimport { AutoMount } from './auto-mount';\n\nexport type { PluginBatchRegistrations };\n\ninterface EmbedPDFProps {\n  /**\n   * The PDF engine to use for the PDF viewer.\n   */\n  engine: PdfEngine;\n  /**\n   * Registry configuration including logger, permissions, and defaults.\n   */\n  config?: PluginRegistryConfig;\n  /**\n   * @deprecated Use config.logger instead. Will be removed in next major version.\n   */\n  logger?: Logger;\n  /**\n   * The callback to call when the PDF viewer is initialized.\n   */\n  onInitialized?: (registry: PluginRegistry) => Promise<void>;\n  /**\n   * The plugins to use for the PDF viewer.\n   */\n  plugins: PluginBatchRegistrations;\n  /**\n   * The children to render for the PDF viewer.\n   */\n  children: ReactNode | ((state: PDFContextState) => ReactNode);\n  /**\n   * Whether to auto-mount specific non-visual DOM elements from plugins.\n   * @default true\n   */\n  autoMountDomElements?: boolean;\n}\n\nexport function EmbedPDF({\n  engine,\n  config,\n  logger,\n  onInitialized,\n  plugins,\n  children,\n  autoMountDomElements = true,\n}: EmbedPDFProps) {\n  const [registry, setRegistry] = useState<PluginRegistry | null>(null);\n  const [coreState, setCoreState] = useState<CoreState | null>(null);\n  const [isInitializing, setIsInitializing] = useState<boolean>(true);\n  const [pluginsReady, setPluginsReady] = useState<boolean>(false);\n  const initRef = useRef<EmbedPDFProps['onInitialized']>(onInitialized);\n\n  useEffect(() => {\n    initRef.current = onInitialized;\n  }, [onInitialized]);\n\n  useEffect(() => {\n    // Merge deprecated logger prop into config (config.logger takes precedence)\n    const finalConfig: PluginRegistryConfig = {\n      ...config,\n      logger: config?.logger ?? logger,\n    };\n    const pdfViewer = new PluginRegistry(engine, finalConfig);\n    pdfViewer.registerPluginBatch(plugins);\n\n    const initialize = async () => {\n      await pdfViewer.initialize();\n\n      if (pdfViewer.isDestroyed()) {\n        return;\n      }\n\n      const store = pdfViewer.getStore();\n      setCoreState(store.getState().core);\n\n      const unsubscribe = store.subscribe((action, newState, oldState) => {\n        // Only update if it's a core action and the core state changed\n        if (store.isCoreAction(action) && newState.core !== oldState.core) {\n          setCoreState(newState.core);\n        }\n      });\n\n      /* always call the *latest* callback */\n      await initRef.current?.(pdfViewer);\n\n      if (pdfViewer.isDestroyed()) {\n        unsubscribe();\n        return;\n      }\n\n      pdfViewer.pluginsReady().then(() => {\n        if (!pdfViewer.isDestroyed()) {\n          setPluginsReady(true);\n        }\n      });\n\n      // Provide the registry to children via context\n      setRegistry(pdfViewer);\n      setIsInitializing(false);\n\n      // Return cleanup function\n      return unsubscribe;\n    };\n\n    let cleanup: (() => void) | undefined;\n    initialize()\n      .then((unsub) => {\n        cleanup = unsub;\n      })\n      .catch(console.error);\n\n    return () => {\n      cleanup?.();\n      pdfViewer.destroy();\n      setRegistry(null);\n      setCoreState(null);\n      setIsInitializing(true);\n      setPluginsReady(false);\n    };\n  }, [engine, plugins]);\n\n  // Compute convenience accessors\n  const contextValue: PDFContextState = useMemo(() => {\n    const activeDocumentId = coreState?.activeDocumentId ?? null;\n    const documents = coreState?.documents ?? {};\n    const documentOrder = coreState?.documentOrder ?? [];\n\n    // Compute active document\n    const activeDocument =\n      activeDocumentId && documents[activeDocumentId] ? documents[activeDocumentId] : null;\n\n    // Compute open documents in order\n    const documentStates = documentOrder\n      .map((docId) => documents[docId])\n      .filter((doc): doc is DocumentState => doc !== null && doc !== undefined);\n\n    return {\n      registry,\n      coreState,\n      isInitializing,\n      pluginsReady,\n      // Convenience accessors (always safe to use)\n      activeDocumentId,\n      activeDocument,\n      documents,\n      documentStates,\n    };\n  }, [registry, coreState, isInitializing, pluginsReady]);\n\n  const content = typeof children === 'function' ? children(contextValue) : children;\n\n  return (\n    <PDFContext.Provider value={contextValue}>\n      {pluginsReady && autoMountDomElements ? (\n        <AutoMount plugins={plugins}>{content}</AutoMount>\n      ) : (\n        content\n      )}\n    </PDFContext.Provider>\n  );\n}\n","import type { BasePlugin } from '@embedpdf/core';\nimport { usePlugin } from './use-plugin';\n\ntype CapabilityState<T extends BasePlugin> = {\n  provides: ReturnType<NonNullable<T['provides']>> | null;\n  isLoading: boolean;\n  ready: Promise<void>;\n};\n\n/**\n * Hook to access a plugin's capability.\n * @param pluginId The ID of the plugin to access\n * @returns The capability provided by the plugin or null during initialization\n * @example\n * // Get zoom capability\n * const zoom = useCapability<ZoomPlugin>(ZoomPlugin.id);\n */\nexport function useCapability<T extends BasePlugin>(pluginId: T['id']): CapabilityState<T> {\n  const { plugin, isLoading, ready } = usePlugin<T>(pluginId);\n\n  if (!plugin) {\n    return {\n      provides: null,\n      isLoading,\n      ready,\n    };\n  }\n\n  if (!plugin.provides) {\n    throw new Error(`Plugin ${pluginId} does not provide a capability`);\n  }\n\n  return {\n    provides: plugin.provides() as ReturnType<NonNullable<T['provides']>>,\n    isLoading,\n    ready,\n  };\n}\n","import { useMemo } from '@framework';\nimport { PdfPermissionFlag } from '@embedpdf/models';\nimport { useCoreState } from './use-core-state';\nimport { getEffectivePermission, getEffectivePermissions } from '../../lib/store/selectors';\n\nexport interface DocumentPermissions {\n  /** Effective permission flags after applying overrides */\n  permissions: number;\n  /** Raw PDF permission flags (before overrides) */\n  pdfPermissions: number;\n  /** Check if a specific permission flag is effectively allowed */\n  hasPermission: (flag: PdfPermissionFlag) => boolean;\n  /** Check if all specified flags are effectively allowed */\n  hasAllPermissions: (...flags: PdfPermissionFlag[]) => boolean;\n\n  // Shorthand booleans for all permission flags (using effective permissions):\n  /** Can print (possibly degraded quality) */\n  canPrint: boolean;\n  /** Can modify document contents */\n  canModifyContents: boolean;\n  /** Can copy/extract text and graphics */\n  canCopyContents: boolean;\n  /** Can add/modify annotations and fill forms */\n  canModifyAnnotations: boolean;\n  /** Can fill in existing form fields */\n  canFillForms: boolean;\n  /** Can extract for accessibility */\n  canExtractForAccessibility: boolean;\n  /** Can assemble document (insert, rotate, delete pages) */\n  canAssembleDocument: boolean;\n  /** Can print high quality */\n  canPrintHighQuality: boolean;\n}\n\n/**\n * Hook that provides reactive access to a document's effective permission flags.\n * Applies layered resolution: per-document override → global override → PDF permission.\n *\n * @param documentId The ID of the document to check permissions for.\n * @returns An object with effective permissions, raw PDF permissions, helper functions, and shorthand booleans.\n */\nexport function useDocumentPermissions(documentId: string): DocumentPermissions {\n  const coreState = useCoreState();\n\n  return useMemo(() => {\n    if (!coreState) {\n      return {\n        permissions: PdfPermissionFlag.AllowAll,\n        pdfPermissions: PdfPermissionFlag.AllowAll,\n        hasPermission: () => true,\n        hasAllPermissions: () => true,\n        canPrint: true,\n        canModifyContents: true,\n        canCopyContents: true,\n        canModifyAnnotations: true,\n        canFillForms: true,\n        canExtractForAccessibility: true,\n        canAssembleDocument: true,\n        canPrintHighQuality: true,\n      };\n    }\n\n    const effectivePermissions = getEffectivePermissions(coreState, documentId);\n    const pdfPermissions =\n      coreState.documents[documentId]?.document?.permissions ?? PdfPermissionFlag.AllowAll;\n\n    const hasPermission = (flag: PdfPermissionFlag) =>\n      getEffectivePermission(coreState, documentId, flag);\n    const hasAllPermissions = (...flags: PdfPermissionFlag[]) =>\n      flags.every((flag) => getEffectivePermission(coreState, documentId, flag));\n\n    return {\n      permissions: effectivePermissions,\n      pdfPermissions,\n      hasPermission,\n      hasAllPermissions,\n      // All permission flags as booleans (using effective permissions)\n      canPrint: hasPermission(PdfPermissionFlag.Print),\n      canModifyContents: hasPermission(PdfPermissionFlag.ModifyContents),\n      canCopyContents: hasPermission(PdfPermissionFlag.CopyContents),\n      canModifyAnnotations: hasPermission(PdfPermissionFlag.ModifyAnnotations),\n      canFillForms: hasPermission(PdfPermissionFlag.FillForms),\n      canExtractForAccessibility: hasPermission(PdfPermissionFlag.ExtractForAccessibility),\n      canAssembleDocument: hasPermission(PdfPermissionFlag.AssembleDocument),\n      canPrintHighQuality: hasPermission(PdfPermissionFlag.PrintHighQuality),\n    };\n  }, [coreState, documentId]);\n}\n","import { useMemo } from '@framework';\nimport { DocumentState } from '@embedpdf/core';\nimport { useCoreState } from './use-core-state';\n\n/**\n * Hook that provides reactive access to a specific document's state from the core store.\n *\n * @param documentId The ID of the document to retrieve.\n * @returns The reactive DocumentState object or null if not found.\n */\nexport function useDocumentState(documentId: string | null): DocumentState | null {\n  const coreState = useCoreState();\n\n  const documentState = useMemo(() => {\n    if (!coreState || !documentId) return null;\n    return coreState.documents[documentId] ?? null;\n  }, [coreState, documentId]);\n\n  return documentState;\n}\n","import { useState, useEffect } from '@framework';\nimport { CoreState, StoreState } from '@embedpdf/core';\nimport { useRegistry } from './use-registry';\n\n/**\n * Hook that provides access to the current global store state\n * and re-renders the component when the state changes\n */\nexport function useStoreState<T = CoreState>(): StoreState<T> | null {\n  const { registry } = useRegistry();\n  const [state, setState] = useState<StoreState<T> | null>(null);\n\n  useEffect(() => {\n    if (!registry) return;\n\n    // Get initial state\n    setState(registry.getStore().getState() as StoreState<T>);\n\n    // Subscribe to store changes\n    const unsubscribe = registry.getStore().subscribe((_action, newState) => {\n      setState(newState as StoreState<T>);\n    });\n\n    return () => unsubscribe();\n  }, [registry]);\n\n  return state;\n}\n"],"names":["PDFContext","createContext","registry","coreState","isInitializing","pluginsReady","activeDocumentId","activeDocument","documents","documentStates","AutoMount","plugins","children","utilities","wrappers","useMemo","reg","pkg","package","hasAutoMountElements","elements","autoMountElements","element","type","push","component","wrappedContent","reduce","content","Wrapper","jsx","Fragment","map","Utility","i","useRegistry","contextValue","useContext","Error","usePlugin","pluginId","plugin","isLoading","ready","Promise","getPlugin","useCoreState","PdfPermissionFlag","Print","ModifyContents","CopyContents","ModifyAnnotations","FillForms","ExtractForAccessibility","AssembleDocument","PrintHighQuality","ALL_PERMISSION_FLAGS","PERMISSION_FLAG_TO_NAME","getPermissionOverride","overrides","flag","name","getEffectivePermission","state","documentId","docState","docConfig","permissions","globalConfig","globalPermissions","pdfPermissions","_a","document","AllowAll","docOverride","globalOverride","enforceDocumentPermissions","engine","config","logger","onInitialized","autoMountDomElements","setRegistry","useState","setCoreState","setIsInitializing","setPluginsReady","initRef","useRef","useEffect","current","finalConfig","pdfViewer","PluginRegistry","registerPluginBatch","cleanup","async","initialize","isDestroyed","store","getStore","getState","core","unsubscribe","subscribe","action","newState","oldState","isCoreAction","call","then","unsub","catch","console","error","destroy","documentOrder","docId","filter","doc","Provider","value","provides","hasPermission","hasAllPermissions","canPrint","canModifyContents","canCopyContents","canModifyAnnotations","canFillForms","canExtractForAccessibility","canAssembleDocument","canPrintHighQuality","effectivePermissions","acc","getEffectivePermissions","_b","flags","every","setState","_action"],"mappings":"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"}

package/dist/preact/index.js

@@ -2,6 +2,7 @@ import { createContext, Fragment } from "preact";
 import { useMemo, useState, useRef, useEffect, useContext } from "preact/hooks";
 import { jsx, jsxs } from "preact/jsx-runtime";
 import { hasAutoMountElements, PluginRegistry } from "@embedpdf/core";
+import { PdfPermissionFlag } from "@embedpdf/models";
 const PDFContext = createContext({
   registry: null,
   coreState: null,
@@ -42,6 +43,7 @@ function AutoMount({ plugins, children }) {
 }
 function EmbedPDF({
   engine,
+  config,
   logger,
   onInitialized,
   plugins,
@@ -57,7 +59,11 @@ function EmbedPDF({
     initRef.current = onInitialized;
   }, [onInitialized]);
   useEffect(() => {
-    const pdfViewer = new PluginRegistry(engine, { logger });
+    const finalConfig = {
+      ...config,
+      logger: (config == null ? void 0 : config.logger) ?? logger
+    };
+    const pdfViewer = new PluginRegistry(engine, finalConfig);
     pdfViewer.registerPluginBatch(plugins);
     const initialize = async () => {
       var _a;
@@ -197,11 +203,117 @@ function useDocumentState(documentId) {
   }, [coreState, documentId]);
   return documentState;
 }
+({
+  print: PdfPermissionFlag.Print,
+  modifyContents: PdfPermissionFlag.ModifyContents,
+  copyContents: PdfPermissionFlag.CopyContents,
+  modifyAnnotations: PdfPermissionFlag.ModifyAnnotations,
+  fillForms: PdfPermissionFlag.FillForms,
+  extractForAccessibility: PdfPermissionFlag.ExtractForAccessibility,
+  assembleDocument: PdfPermissionFlag.AssembleDocument,
+  printHighQuality: PdfPermissionFlag.PrintHighQuality
+});
+const ALL_PERMISSION_FLAGS = [
+  PdfPermissionFlag.Print,
+  PdfPermissionFlag.ModifyContents,
+  PdfPermissionFlag.CopyContents,
+  PdfPermissionFlag.ModifyAnnotations,
+  PdfPermissionFlag.FillForms,
+  PdfPermissionFlag.ExtractForAccessibility,
+  PdfPermissionFlag.AssembleDocument,
+  PdfPermissionFlag.PrintHighQuality
+];
+const PERMISSION_FLAG_TO_NAME = {
+  [PdfPermissionFlag.Print]: "print",
+  [PdfPermissionFlag.ModifyContents]: "modifyContents",
+  [PdfPermissionFlag.CopyContents]: "copyContents",
+  [PdfPermissionFlag.ModifyAnnotations]: "modifyAnnotations",
+  [PdfPermissionFlag.FillForms]: "fillForms",
+  [PdfPermissionFlag.ExtractForAccessibility]: "extractForAccessibility",
+  [PdfPermissionFlag.AssembleDocument]: "assembleDocument",
+  [PdfPermissionFlag.PrintHighQuality]: "printHighQuality"
+};
+function getPermissionOverride(overrides, flag) {
+  if (!overrides) return void 0;
+  if (flag in overrides) {
+    return overrides[flag];
+  }
+  const name = PERMISSION_FLAG_TO_NAME[flag];
+  if (name && name in overrides) {
+    return overrides[name];
+  }
+  return void 0;
+}
+function getEffectivePermission(state, documentId, flag) {
+  var _a;
+  const docState = state.documents[documentId];
+  const docConfig = docState == null ? void 0 : docState.permissions;
+  const globalConfig = state.globalPermissions;
+  const pdfPermissions = ((_a = docState == null ? void 0 : docState.document) == null ? void 0 : _a.permissions) ?? PdfPermissionFlag.AllowAll;
+  const docOverride = getPermissionOverride(docConfig == null ? void 0 : docConfig.overrides, flag);
+  if (docOverride !== void 0) {
+    return docOverride;
+  }
+  const globalOverride = getPermissionOverride(globalConfig == null ? void 0 : globalConfig.overrides, flag);
+  if (globalOverride !== void 0) {
+    return globalOverride;
+  }
+  const enforce = (docConfig == null ? void 0 : docConfig.enforceDocumentPermissions) ?? (globalConfig == null ? void 0 : globalConfig.enforceDocumentPermissions) ?? true;
+  if (!enforce) return true;
+  return (pdfPermissions & flag) !== 0;
+}
+function getEffectivePermissions(state, documentId) {
+  return ALL_PERMISSION_FLAGS.reduce((acc, flag) => {
+    return getEffectivePermission(state, documentId, flag) ? acc | flag : acc;
+  }, 0);
+}
+function useDocumentPermissions(documentId) {
+  const coreState = useCoreState();
+  return useMemo(() => {
+    var _a, _b;
+    if (!coreState) {
+      return {
+        permissions: PdfPermissionFlag.AllowAll,
+        pdfPermissions: PdfPermissionFlag.AllowAll,
+        hasPermission: () => true,
+        hasAllPermissions: () => true,
+        canPrint: true,
+        canModifyContents: true,
+        canCopyContents: true,
+        canModifyAnnotations: true,
+        canFillForms: true,
+        canExtractForAccessibility: true,
+        canAssembleDocument: true,
+        canPrintHighQuality: true
+      };
+    }
+    const effectivePermissions = getEffectivePermissions(coreState, documentId);
+    const pdfPermissions = ((_b = (_a = coreState.documents[documentId]) == null ? void 0 : _a.document) == null ? void 0 : _b.permissions) ?? PdfPermissionFlag.AllowAll;
+    const hasPermission = (flag) => getEffectivePermission(coreState, documentId, flag);
+    const hasAllPermissions = (...flags) => flags.every((flag) => getEffectivePermission(coreState, documentId, flag));
+    return {
+      permissions: effectivePermissions,
+      pdfPermissions,
+      hasPermission,
+      hasAllPermissions,
+      // All permission flags as booleans (using effective permissions)
+      canPrint: hasPermission(PdfPermissionFlag.Print),
+      canModifyContents: hasPermission(PdfPermissionFlag.ModifyContents),
+      canCopyContents: hasPermission(PdfPermissionFlag.CopyContents),
+      canModifyAnnotations: hasPermission(PdfPermissionFlag.ModifyAnnotations),
+      canFillForms: hasPermission(PdfPermissionFlag.FillForms),
+      canExtractForAccessibility: hasPermission(PdfPermissionFlag.ExtractForAccessibility),
+      canAssembleDocument: hasPermission(PdfPermissionFlag.AssembleDocument),
+      canPrintHighQuality: hasPermission(PdfPermissionFlag.PrintHighQuality)
+    };
+  }, [coreState, documentId]);
+}
 export {
   EmbedPDF,
   PDFContext,
   useCapability,
   useCoreState,
+  useDocumentPermissions,
   useDocumentState,
   usePlugin,
   useRegistry,