// GPG4Browsers - An OpenPGP implementation in javascript // Copyright (C) 2011 Recurity Labs GmbH // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License as published by the Free Software Foundation; either // version 3.0 of the License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA /** * @requires encoding/armor * @requires packet * @requires enums * @module signature */ import armor from './encoding/armor'; import { PacketList, SignaturePacket } from './packet'; import enums from './enums'; /** * Class that represents an OpenPGP signature. */ export class Signature { /** * @param {PacketList} packetlist The signature packets */ constructor(packetlist) { this.packets = packetlist || new PacketList(); } /** * Returns binary encoded signature * @returns {ReadableStream} binary signature */ write() { return this.packets.write(); } /** * Returns ASCII armored text of signature * @returns {ReadableStream} ASCII armor */ armor() { return armor.encode(enums.armor.signature, this.write()); } } /** * reads an OpenPGP armored signature and returns a signature object * @param {String | ReadableStream} armoredText text to be parsed * @returns {Signature} new signature object * @async * @static */ export async function readArmored(armoredText) { const input = await armor.decode(armoredText); return read(input.data); } /** * reads an OpenPGP signature as byte array and returns a signature object * @param {Uint8Array | ReadableStream} input binary signature * @returns {Signature} new signature object * @async * @static */ export async function read(input) { const packetlist = new PacketList(); await packetlist.read(input, { SignaturePacket }); return new Signature(packetlist); }