Method setProtection

src/api/pdf.ts:986–998

* Add or change document encryption. * * If the document is already encrypted, requires owner access to change. * If unencrypted, can be called without restrictions. * * @param options - Protection options (passwords, permissions, algorithm) * @throws {PermissionDeniedError} If ins

(options: ProtectionOptions)

   * ```
   */
  setProtection(options: ProtectionOptions): void {
    // If encrypted, need owner access to change
    if (this.isEncrypted) {
      const handler = this.ctx.info.securityHandler;

      if (handler && !handler.hasOwnerAccess) {
        throw new PermissionDeniedError("Cannot change protection: requires owner access");
      }
    }

    // Mark that encryption should be applied on save
    this._pendingSecurity = { action: "encrypt", options };
  }

  // ─────────────────────────────────────────────────────────────────────────────
  // Metadata