update lock clucknut

2026-04-18 20:32:18 +07:00
parent 4554035227
commit dcaf267458
3359 changed files with 153185 additions and 205489 deletions
--- a/vendor/thecodingmachine/safe/generated/8.2/rnp.php
+++ b/vendor/thecodingmachine/safe/generated/8.2/rnp.php
@@ -5,13 +5,9 @@
 use Safe\Exceptions\RnpException;

 /**
- * Private keys used for decryption should be loaded into the FFI object before calling this function.
- * If password encryption was used, then password provider should be set by calling
- * rnp_ffi_set_pass_provider.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $input Encrypted message.
- * @return string Decrypted message on success.
+ * @param \RnpFFI $ffi
+ * @param string $input
+ * @return string
 * @throws RnpException
 *
 */
@@ -27,11 +23,9 @@ function rnp_decrypt(\RnpFFI $ffi, string $input): string


 /**
- *
- *
- * @param string $input Input string containing OpenPGP data, either in binary or ASCII-armored format.
- * @param int $flags See RNP_JSON_DUMP_* predefined constants.
- * @return string JSON string with dump.
+ * @param string $input
+ * @param int $flags
+ * @return string
 * @throws RnpException
 *
 */
@@ -47,11 +41,9 @@ function rnp_dump_packets_to_json(string $input, int $flags): string


 /**
- *
- *
- * @param string $input Input string containing OpenPGP data, either in binary or ASCII-armored format.
- * @param int $flags See RNP_DUMP_* predefined constants.
- * @return string Text describing packet sequence.
+ * @param string $input
+ * @param int $flags
+ * @return string
 * @throws RnpException
 *
 */
@@ -67,13 +59,9 @@ function rnp_dump_packets(string $input, int $flags): string


 /**
- *
- *
- * @param string $pub_format the format of the public keyring, RNP_KEYSTORE_GPG or other
- * RNP_KEYSTORE_* constant.
- * @param string $sec_format the format of the secret keyring, RNP_KEYSTORE_GPG or other
- * RNP_KEYSTORE_* constant
- * @return \RnpFFI Returns RnpFFI object on success.
+ * @param string $pub_format
+ * @param string $sec_format
+ * @return \RnpFFI
 * @throws RnpException
 *
 */
@@ -89,25 +77,8 @@ function rnp_ffi_create(string $pub_format, string $sec_format): \RnpFFI


 /**
- * Sets password provider function. This function can ask for the password on a standard input
- * (if PHP script is executed in a command line environment), display GUI dialog or provide
- * password in any other possible ways. Requested passwords are used to encrypt or decrypt
- * secret keys or perform symmetric encryption/decryption operations.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param callable $password_callback The function that is to be called for every password request.  It has the following signature:
- *
- * boolpassword_callback
- * stringkey_fp
- * stringpgp_context
- * stringpassword
- *
- *
- * $key_fp - The key fingerprint, if any. Can be empty.
- * $pgp_context - String describing why the key is being requested.
- * $password - Password string reference where provided password should be stored to.
- *
- * Callback function should return TRUE if password was successfully set or FALSE on failure.
+ * @param \RnpFFI $ffi
+ * @param callable $password_callback
 * @throws RnpException
 *
 */
@@ -122,12 +93,10 @@ function rnp_ffi_set_pass_provider(\RnpFFI $ffi, callable $password_callback): v


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $input OpenPGP packets containing key(s) to be loaded. Can be either binary or ASCII armored.
- * @param int $flags See RNP_LOAD_SAVE_* predefined constants.
- * @return string JSON string with information about new and updated keys on success.
+ * @param \RnpFFI $ffi
+ * @param string $input
+ * @param int $flags
+ * @return string
 * @throws RnpException
 *
 */
@@ -143,12 +112,10 @@ function rnp_import_keys(\RnpFFI $ffi, string $input, int $flags): string


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $input OpenPGP packets containing signatures to be imported. Can be either binary or ASCII armored.
- * @param int $flags Currently must be 0.
- * @return string JSON string with information about updated keys on success.
+ * @param \RnpFFI $ffi
+ * @param string $input
+ * @param int $flags
+ * @return string
 * @throws RnpException
 *
 */
@@ -164,17 +131,12 @@ function rnp_import_signatures(\RnpFFI $ffi, string $input, int $flags): string


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $key_fp Primary key fingerprint.
- * @param string $subkey_fp Subkey to export. Can be an empty string
- * to pick the first suitable subkey.
- * @param string $uid User ID to export. Can be an empty string
- * if exported key has only one uid.
- * @param int $flags Only RNP_KEY_EXPORT_BASE64 is currently supported. Enabling
- * it would export base64-encoded key data instead of binary.
- * @return string OpenPGP packets of exported key on success.
+ * @param \RnpFFI $ffi
+ * @param string $key_fp
+ * @param string $subkey_fp
+ * @param string $uid
+ * @param int $flags
+ * @return string
 * @throws RnpException
 *
 */
@@ -190,14 +152,11 @@ function rnp_key_export_autocrypt(\RnpFFI $ffi, string $key_fp, string $subkey_f


 /**
- * Note: to revoke a key you'll need to import this signature into the keystore or use
- * rnp_key_revoke function.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $key_fp Key fingerprint of the primary key to be revoked.
- * @param int $flags RNP_KEY_EXPORT_ARMORED or 0.
- * @param array $options An associative array with options.
- * @return string Exported revocation signature on success.
+ * @param \RnpFFI $ffi
+ * @param string $key_fp
+ * @param int $flags
+ * @param array $options
+ * @return string
 * @throws RnpException
 *
 */
@@ -217,13 +176,10 @@ function rnp_key_export_revocation(\RnpFFI $ffi, string $key_fp, int $flags, ?ar


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $key_fp Key fingerprint.
- * @param int $flags See RNP_KEY_EXPORT_* predefined constants
- * (except RNP_KEY_EXPORT_BASE64).
- * @return string OpenPGP packets of exported key (binary or ASCII-armored) on success.
+ * @param \RnpFFI $ffi
+ * @param string $key_fp
+ * @param int $flags
+ * @return string
 * @throws RnpException
 *
 */
@@ -239,11 +195,9 @@ function rnp_key_export(\RnpFFI $ffi, string $key_fp, int $flags): string


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $key_fp Key fingerprint.
- * @return array An associative array with information about the key.
+ * @param \RnpFFI $ffi
+ * @param string $key_fp
+ * @return array
 * @throws RnpException
 *
 */
@@ -259,12 +213,9 @@ function rnp_key_get_info(\RnpFFI $ffi, string $key_fp): array


 /**
- * Note: you need to call rnp_save_keys to write updated keyring(s) out.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $key_fp Key fingerprint.
- * @param int $flags See RNP_KEY_REMOVE_* constants. Flag RNP_KEY_REMOVE_SUBKEYS will work only for
- * the primary key and will remove all of its subkeys as well.
+ * @param \RnpFFI $ffi
+ * @param string $key_fp
+ * @param int $flags
 * @throws RnpException
 *
 */
@@ -279,12 +230,10 @@ function rnp_key_remove(\RnpFFI $ffi, string $key_fp, int $flags): void


 /**
- * Note: you need to call rnp_save_keys to write updated keyring(s) out.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $key_fp Key fingerprint.
- * @param int $flags Currently must be 0.
- * @param array $options An associative array with options.
+ * @param \RnpFFI $ffi
+ * @param string $key_fp
+ * @param int $flags
+ * @param array $options
 * @throws RnpException
 *
 */
@@ -303,11 +252,9 @@ function rnp_key_revoke(\RnpFFI $ffi, string $key_fp, int $flags, ?array $option


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $identifier_type Key identifier type ("userid", "keyid", "grip", "fingerprint").
- * @return array An associative array where key is an identifier string and value is a PGP key fingerprint.
+ * @param \RnpFFI $ffi
+ * @param string $identifier_type
+ * @return array
 * @throws RnpException
 *
 */
@@ -323,12 +270,10 @@ function rnp_list_keys(\RnpFFI $ffi, string $identifier_type): array


 /**
- * Note that for G10, the input must be a directory (which must already exist).
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $format The key format of the data (GPG, KBX, G10).
- * @param string $input_path file or directory containing the keys.
- * @param int $flags See RNP_LOAD_SAVE_* flags description.
+ * @param \RnpFFI $ffi
+ * @param string $format
+ * @param string $input_path
+ * @param int $flags
 * @throws RnpException
 *
 */
@@ -343,12 +288,10 @@ function rnp_load_keys_from_path(\RnpFFI $ffi, string $format, string $input_pat


 /**
- * Note that for G10, the input must be a directory (which must already exist).
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $format The key format of the data (GPG, KBX, G10).
- * @param string $input OpenPGP packets containing key(s) to be loaded. Can be either binary or ASCII armored.
- * @param int $flags See RNP_LOAD_SAVE_* flags description.
+ * @param \RnpFFI $ffi
+ * @param string $format
+ * @param string $input
+ * @param int $flags
 * @throws RnpException
 *
 */
@@ -363,13 +306,10 @@ function rnp_load_keys(\RnpFFI $ffi, string $format, string $input, int $flags):


 /**
- * Note: only valid userids are checked while searching by userid.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $identifier_type Identifier type string: "userid", "keyid", "fingerprint", "grip".
- * @param string $identifier PGP User ID (name and email) for "userid" type, hexadecimal string
- * that represents key id, fingerprint or key grip correspondingly.
- * @return string Returns hexadecimal fingerprint of the key found on success.
+ * @param \RnpFFI $ffi
+ * @param string $identifier_type
+ * @param string $identifier
+ * @return string
 * @throws RnpException
 *
 */
@@ -385,13 +325,11 @@ function rnp_locate_key(\RnpFFI $ffi, string $identifier_type, string $identifie


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $message Message to be encrypted.
- * @param array $recipient_keys_fp Array with fingerprints of recipient's keys. At least one key must be present.
- * @param array $options An associative array with options.
- * @return string Encrypted data on success.
+ * @param \RnpFFI $ffi
+ * @param string $message
+ * @param array $recipient_keys_fp
+ * @param array $options
+ * @return string
 * @throws RnpException
 *
 */
@@ -411,18 +349,12 @@ function rnp_op_encrypt(\RnpFFI $ffi, string $message, array $recipient_keys_fp,


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $userid PGP User ID - text that is intended to represent
- * the name and email address of the key holder.
- * @param string $key_alg Primary key algorithm (i.e. 'RSA', 'DSA', etc).
- * @param string $sub_alg Subkey algorithm. If not set, subkey will not be generated.
- * @param array $options An associative array with options.
- * @return string Fingerprint of the generated primary key. This fingerprint can be used
- * later to reference the key in sign and encrypt operations. The key data is stored in FFI
- * memory context and can be saved using
- * rnp_save_keys or rnp_save_keys_to_path.
+ * @param \RnpFFI $ffi
+ * @param string $userid
+ * @param string $key_alg
+ * @param string $sub_alg
+ * @param array $options
+ * @return string
 * @throws RnpException
 *
 */
@@ -444,15 +376,11 @@ function rnp_op_generate_key(\RnpFFI $ffi, string $userid, string $key_alg, ?str


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $data Data to be signed.
- * @param array $keys_fp Array with key fingerprints. At least one key must be provided.
- * Keys should be present in ffi.
- * @param array $options An associative array with options.
- * @return string Cleartext signed message containing source data with
- * additional headers and ASCII-armored signature on success.
+ * @param \RnpFFI $ffi
+ * @param string $data
+ * @param array $keys_fp
+ * @param array $options
+ * @return string
 * @throws RnpException
 *
 */
@@ -472,14 +400,11 @@ function rnp_op_sign_cleartext(\RnpFFI $ffi, string $data, array $keys_fp, ?arra


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $data Data to be signed.
- * @param array $keys_fp Array with key fingerprints. At least one key must be provided.
- * Keys should be present in ffi.
- * @param array $options An associative array with options.
- * @return string Detached signature(s) data on success.
+ * @param \RnpFFI $ffi
+ * @param string $data
+ * @param array $keys_fp
+ * @param array $options
+ * @return string
 * @throws RnpException
 *
 */
@@ -499,14 +424,11 @@ function rnp_op_sign_detached(\RnpFFI $ffi, string $data, array $keys_fp, ?array


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $data Data to be signed.
- * @param array $keys_fp Array with key fingerprints. At least one key must be provided.
- * Keys should be present in ffi.
- * @param array $options An associative array with options.
- * @return string Data with embedded signature(s) on success.
+ * @param \RnpFFI $ffi
+ * @param string $data
+ * @param array $keys_fp
+ * @param array $options
+ * @return string
 * @throws RnpException
 *
 */
@@ -526,14 +448,10 @@ function rnp_op_sign(\RnpFFI $ffi, string $data, array $keys_fp, ?array $options


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $data Source data.
- * @param string $signature Detached signature data.
- * @return array An associative array with information about verification results.
- *
- * "signatures" sub-array.
+ * @param \RnpFFI $ffi
+ * @param string $data
+ * @param string $signature
+ * @return array
 * @throws RnpException
 *
 */
@@ -549,13 +467,9 @@ function rnp_op_verify_detached(\RnpFFI $ffi, string $data, string $signature):


 /**
- *
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $data Signed data.
- * @return array An associative array with information about verification results.
- *
- * "signatures" sub-array.
+ * @param \RnpFFI $ffi
+ * @param string $data
+ * @return array
 * @throws RnpException
 *
 */
@@ -571,12 +485,10 @@ function rnp_op_verify(\RnpFFI $ffi, string $data): array


 /**
- * Saves keys present in the FFI object (loaded or generated) to the specified file or directory.
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $format The key format of the data (GPG, KBX, G10).
- * @param string $output_path File or directory path where keys should be saved to.
- * @param int $flags See RNP_LOAD_SAVE_* flags description.
+ * @param \RnpFFI $ffi
+ * @param string $format
+ * @param string $output_path
+ * @param int $flags
 * @throws RnpException
 *
 */
@@ -591,12 +503,10 @@ function rnp_save_keys_to_path(\RnpFFI $ffi, string $format, string $output_path


 /**
- * Note that for G10, the output must be a directory (which must already exist).
- *
- * @param \RnpFFI $ffi The FFI object returned by rnp_ffi_create.
- * @param string $format The key format of the data (GPG, KBX, G10).
- * @param string $output key packets will be saved to the string referenced by output.
- * @param int $flags See RNP_LOAD_SAVE_* flags description.
+ * @param \RnpFFI $ffi
+ * @param string $format
+ * @param string $output
+ * @param int $flags
 * @throws RnpException
 *
 */
@@ -611,10 +521,8 @@ function rnp_save_keys(\RnpFFI $ffi, string $format, string &$output, int $flags


 /**
- * Get the JSON formatted string containing array of supported rnp feature values (algorithms, curves, etc) by type.
- *
- * @param string $type See RNP_FEATURE_* constants for supported values.
- * @return string String containing JSON formatted array of supported algorithms, curves, etc.
+ * @param string $type
+ * @return string
 * @throws RnpException
 *
 */