Write key-value pair with metadata

type Cloudflare = {

  token: string;

  email: string;

  key: string;

};

/**

 * Write key-value pair with metadata

 * Write a value identified by a key. Use URL-encoding to use special characters (for example, `:`, `!`, `%`) in the key name. Body should be the value to be stored along with JSON metadata to be associated with the key/value pair. Existing values, expirations, and metadata will be overwritten. If neither `expiration` nor `expiration_ttl` is specified, the key-value pair will never expire. If both are set, `expiration_ttl` is used and `expiration` is ignored.

 */

export async function main(

  auth: Cloudflare,

  key_name: string,

  namespace_identifier: string,

  account_identifier: string,

  body: { metadata: string; value: string; [k: string]: unknown }

) {

  const url = new URL(

    `https://api.cloudflare.com/client/v4/accounts/${account_identifier}/storage/kv/namespaces/${namespace_identifier}/values/${key_name}`

  );

  const formData = new FormData();

  for (const [k, v] of Object.entries(body)) {

    if (v !== undefined && v !== "") {

      formData.append(k, String(v));

    }

  }

  const response = await fetch(url, {

    method: "PUT",

    headers: {

      "X-AUTH-EMAIL": auth.email,

      "X-AUTH-KEY": auth.key,

      Authorization: "Bearer " + auth.token,

    },

    body: formData,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}