Method getSecurity

src/api/pdf.ts:781–829

* Get detailed security information about the document. * * @returns Security information including encryption details and permissions * * @example * ```typescript * const security = pdf.getSecurity(); * console.log(`Algorithm: ${security.algorithm}`); * console.log(`Can copy

()

   * ```
   */
  getSecurity(): SecurityInfo {
    const handler = this.ctx.info.securityHandler;

    if (!this.isEncrypted || !handler) {
      return {
        isEncrypted: false,
        permissions: DEFAULT_PERMISSIONS,
      };
    }

    const encryption = handler.encryption;

    // Map internal algorithm to public API type
    let algorithm: EncryptionAlgorithmOption | undefined;

    switch (encryption.algorithm) {
      case "RC4":
        algorithm = encryption.keyLengthBits <= 40 ? "RC4-40" : "RC4-128";
        break;
      case "AES-128":
        algorithm = "AES-128";
        break;
      case "AES-256":
        algorithm = "AES-256";
        break;
    }

    // Determine how the document was authenticated
    let authenticatedAs: "user" | "owner" | null = null;

    if (handler.isAuthenticated) {
      authenticatedAs = handler.hasOwnerAccess ? "owner" : "user";
    }

    // For owner access, all permissions are granted regardless of flags
    const permissions = handler.hasOwnerAccess ? DEFAULT_PERMISSIONS : handler.permissions;

    return {
      isEncrypted: true,
      algorithm,
      keyLength: encryption.keyLengthBits,
      revision: encryption.revision,
      hasUserPassword: true, // We can't easily detect empty user password after the fact
      hasOwnerPassword: true,
      authenticatedAs,
      permissions,
      encryptMetadata: encryption.encryptMetadata,
    };
  }

  /**
   * Get the current permission flags.