@embedpdf/core 2.1.2 → 2.2.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Rotation, NoopLogger } from "@embedpdf/models";
+import { Rotation, PdfPermissionFlag, NoopLogger, PermissionDeniedError } from "@embedpdf/models";
 class DependencyResolver {
   constructor() {
     this.dependencyGraph = /* @__PURE__ */ new Map();
@@ -170,6 +170,7 @@ const CLOSE_DOCUMENT = "CLOSE_DOCUMENT";
 const SET_ACTIVE_DOCUMENT = "SET_ACTIVE_DOCUMENT";
 const REORDER_DOCUMENTS = "REORDER_DOCUMENTS";
 const MOVE_DOCUMENT = "MOVE_DOCUMENT";
+const UPDATE_DOCUMENT_SECURITY = "UPDATE_DOCUMENT_SECURITY";
 const REFRESH_DOCUMENT = "REFRESH_DOCUMENT";
 const REFRESH_PAGES = "REFRESH_PAGES";
 const SET_PAGES = "SET_PAGES";
@@ -193,11 +194,12 @@ const CORE_ACTION_TYPES = [
   SET_DEFAULT_SCALE,
   SET_DEFAULT_ROTATION,
   REORDER_DOCUMENTS,
-  MOVE_DOCUMENT
+  MOVE_DOCUMENT,
+  UPDATE_DOCUMENT_SECURITY
 ];
-const startLoadingDocument = (documentId, name, scale, rotation, passwordProvided, autoActivate) => ({
+const startLoadingDocument = (documentId, name, scale, rotation, passwordProvided, autoActivate, permissions) => ({
   type: START_LOADING_DOCUMENT,
-  payload: { documentId, name, scale, rotation, passwordProvided, autoActivate }
+  payload: { documentId, name, scale, rotation, passwordProvided, autoActivate, permissions }
 });
 const updateDocumentLoadingProgress = (documentId, progress) => ({
   type: UPDATE_DOCUMENT_LOADING_PROGRESS,
@@ -259,6 +261,10 @@ const moveDocument = (documentId, toIndex) => ({
   type: MOVE_DOCUMENT,
   payload: { documentId, toIndex }
 });
+const updateDocumentSecurity = (documentId, permissions, isOwnerUnlocked) => ({
+  type: UPDATE_DOCUMENT_SECURITY,
+  payload: { documentId, permissions, isOwnerUnlocked }
+});
 class Store {
   /**
    * Initializes the store with the provided core state.
@@ -519,8 +525,60 @@ const initialCoreState = (config) => ({
   documentOrder: [],
   activeDocumentId: null,
   defaultScale: (config == null ? void 0 : config.defaultScale) ?? 1,
-  defaultRotation: (config == null ? void 0 : config.defaultRotation) ?? Rotation.Degree0
+  defaultRotation: (config == null ? void 0 : config.defaultRotation) ?? Rotation.Degree0,
+  globalPermissions: config == null ? void 0 : config.permissions
 });
+const PERMISSION_NAME_TO_FLAG = {
+  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 ALL_PERMISSION_NAMES = [
+  "print",
+  "modifyContents",
+  "copyContents",
+  "modifyAnnotations",
+  "fillForms",
+  "extractForAccessibility",
+  "assembleDocument",
+  "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;
+}
 const getActiveDocumentState = (state) => {
   if (!state.activeDocumentId) return null;
   return state.documents[state.activeDocumentId] ?? null;
@@ -537,6 +595,29 @@ const isDocumentLoaded = (state, documentId) => {
 const getDocumentCount = (state) => {
   return Object.keys(state.documents).length;
 };
+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 calculateNextActiveDocument(state, closingDocumentId, explicitNext) {
   const currentActiveId = state.activeDocumentId;
   if (currentActiveId !== closingDocumentId) {
@@ -576,7 +657,8 @@ const coreReducer = (state, action) => {
         scale,
         rotation,
         passwordProvided,
-        autoActivate = true
+        autoActivate = true,
+        permissions
       } = action.payload;
       const newDocState = {
         id: documentId,
@@ -589,6 +671,7 @@ const coreReducer = (state, action) => {
         rotation: rotation ?? state.defaultRotation,
         passwordProvided: passwordProvided ?? false,
         pageRefreshVersions: {},
+        permissions,
         loadStartedAt: Date.now()
       };
       return {
@@ -761,6 +844,25 @@ const coreReducer = (state, action) => {
         }
       };
     }
+    case UPDATE_DOCUMENT_SECURITY: {
+      const { documentId, permissions, isOwnerUnlocked } = action.payload;
+      const docState = state.documents[documentId];
+      if (!(docState == null ? void 0 : docState.document)) return state;
+      return {
+        ...state,
+        documents: {
+          ...state.documents,
+          [documentId]: {
+            ...docState,
+            document: {
+              ...docState.document,
+              permissions,
+              isOwnerUnlocked
+            }
+          }
+        }
+      };
+    }
     default:
       return state;
   }
@@ -1474,6 +1576,53 @@ class BasePlugin {
     }
     return doc;
   }
+  // ─────────────────────────────────────────────────────────
+  // Permission Helpers
+  // ─────────────────────────────────────────────────────────
+  /**
+   * 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)
+   */
+  getDocumentPermissions(documentId) {
+    const docId = documentId ?? this.coreState.core.activeDocumentId;
+    if (!docId) return PdfPermissionFlag.AllowAll;
+    return getEffectivePermissions(this.coreState.core, docId);
+  }
+  /**
+   * 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
+   */
+  checkPermission(documentId, ...flags) {
+    const docId = documentId ?? this.coreState.core.activeDocumentId;
+    if (!docId) return true;
+    return flags.every((flag) => getEffectivePermission(this.coreState.core, docId, flag));
+  }
+  /**
+   * 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
+   */
+  requirePermission(documentId, ...flags) {
+    const docId = documentId ?? this.coreState.core.activeDocumentId;
+    if (!docId) return;
+    const missingFlags = [];
+    for (const flag of flags) {
+      if (!getEffectivePermission(this.coreState.core, docId, flag)) {
+        missingFlags.push(flag);
+      }
+    }
+    if (missingFlags.length > 0) {
+      const effectivePermissions = getEffectivePermissions(this.coreState.core, docId);
+      throw new PermissionDeniedError(missingFlags, effectivePermissions);
+    }
+  }
 }
 class EventControl {
   constructor(handler, options) {
@@ -1902,6 +2051,8 @@ function createPluginPackage(basePackage) {
   return new PluginPackageBuilder(basePackage);
 }
 export {
+  ALL_PERMISSION_FLAGS,
+  ALL_PERMISSION_NAMES,
   BasePlugin,
   CLOSE_DOCUMENT,
   CORE_ACTION_TYPES,
@@ -1912,6 +2063,8 @@ export {
   EventControl,
   KeyedEventControl,
   MOVE_DOCUMENT,
+  PERMISSION_FLAG_TO_NAME,
+  PERMISSION_NAME_TO_FLAG,
   PluginConfigurationError,
   PluginInitializationError,
   PluginNotFoundError,
@@ -1932,6 +2085,7 @@ export {
   SET_SCALE,
   START_LOADING_DOCUMENT,
   UPDATE_DOCUMENT_LOADING_PROGRESS,
+  UPDATE_DOCUMENT_SECURITY,
   arePropsEqual,
   clamp,
   closeDocument,
@@ -1945,6 +2099,9 @@ export {
   getDocumentCount,
   getDocumentIds,
   getDocumentState,
+  getEffectivePermission,
+  getEffectivePermissions,
+  getPermissionOverride,
   hasAutoMountElements,
   initialCoreState,
   isDocumentLoaded,
@@ -1963,6 +2120,7 @@ export {
   setRotation,
   setScale,
   startLoadingDocument,
-  updateDocumentLoadingProgress
+  updateDocumentLoadingProgress,
+  updateDocumentSecurity
 };
 //# sourceMappingURL=index.js.map