@synonymdev/pubky 0.1.15 → 0.2.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "@synonymdev/pubky",
   "type": "module",
   "description": "Pubky client",
-  "version": "0.1.15",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -37,5 +37,8 @@
     "esmify": "^2.1.1",
     "tape": "^5.8.1",
     "tape-run": "^11.0.0"
+  },
+  "dependencies": {
+    "fetch-cookie": "^3.0.1"
   }
 }

package/pubky.d.ts

@@ -1,192 +1,185 @@
 /* tslint:disable */
 /* eslint-disable */
 /**
-* Create a recovery file of the `keypair`, containing the secret key encrypted
-* using the `passphrase`.
-* @param {Keypair} keypair
-* @param {string} passphrase
-* @returns {Uint8Array}
-*/
+ * Create a recovery file of the `keypair`, containing the secret key encrypted
+ * using the `passphrase`.
+ * @param {Keypair} keypair
+ * @param {string} passphrase
+ * @returns {Uint8Array}
+ */
 export function createRecoveryFile(keypair: Keypair, passphrase: string): Uint8Array;
 /**
-* Create a recovery file of the `keypair`, containing the secret key encrypted
-* using the `passphrase`.
-* @param {Uint8Array} recovery_file
-* @param {string} passphrase
-* @returns {Keypair}
-*/
+ * Create a recovery file of the `keypair`, containing the secret key encrypted
+ * using the `passphrase`.
+ * @param {Uint8Array} recovery_file
+ * @param {string} passphrase
+ * @returns {Keypair}
+ */
 export function decryptRecoveryFile(recovery_file: Uint8Array, passphrase: string): Keypair;
-/**
-*/
 export class Keypair {
   free(): void;
-/**
-* Generate a random [Keypair]
-* @returns {Keypair}
-*/
+  /**
+   * Generate a random [Keypair]
+   * @returns {Keypair}
+   */
   static random(): Keypair;
-/**
-* Generate a [Keypair] from a secret key.
-* @param {Uint8Array} secret_key
-* @returns {Keypair}
-*/
+  /**
+   * Generate a [Keypair] from a secret key.
+   * @param {Uint8Array} secret_key
+   * @returns {Keypair}
+   */
   static fromSecretKey(secret_key: Uint8Array): Keypair;
-/**
-* Returns the secret key of this keypair.
-* @returns {Uint8Array}
-*/
+  /**
+   * Returns the secret key of this keypair.
+   * @returns {Uint8Array}
+   */
   secretKey(): Uint8Array;
-/**
-* Returns the [PublicKey] of this keypair.
-* @returns {PublicKey}
-*/
+  /**
+   * Returns the [PublicKey] of this keypair.
+   * @returns {PublicKey}
+   */
   publicKey(): PublicKey;
 }
 /**
-*/
+ * A client for Pubky homeserver API, as well as generic HTTP requests to Pubky urls.
+ */
 export class PubkyClient {
   free(): void;
-/**
-*/
   constructor();
-/**
-* Create a client with with configurations appropriate for local testing:
-* - set Pkarr relays to `["http://localhost:15411/pkarr"]` instead of default relay.
-* @returns {PubkyClient}
-*/
+  /**
+   * Create a client with with configurations appropriate for local testing:
+   * - set Pkarr relays to `["http://localhost:15411/pkarr"]` instead of default relay.
+   * @returns {PubkyClient}
+   */
   static testnet(): PubkyClient;
-/**
-* Set Pkarr relays used for publishing and resolving Pkarr packets.
-*
-* By default, [PubkyClient] will use `["https://relay.pkarr.org"]`
-* @param {(string)[]} relays
-* @returns {PubkyClient}
-*/
+  /**
+   * Set Pkarr relays used for publishing and resolving Pkarr packets.
+   *
+   * By default, [PubkyClient] will use `["https://relay.pkarr.org"]`
+   * @param {(string)[]} relays
+   * @returns {PubkyClient}
+   */
   setPkarrRelays(relays: (string)[]): PubkyClient;
-/**
-* @returns {(string)[]}
-*/
+  /**
+   * @returns {(string)[]}
+   */
   getPkarrRelays(): (string)[];
-/**
-* Signup to a homeserver and update Pkarr accordingly.
-*
-* The homeserver is a Pkarr domain name, where the TLD is a Pkarr public key
-* for example "pubky.o4dksfbqk85ogzdb5osziw6befigbuxmuxkuxq8434q89uj56uyy"
-* @param {Keypair} keypair
-* @param {PublicKey} homeserver
-* @returns {Promise<Session>}
-*/
+  /**
+   * Signup to a homeserver and update Pkarr accordingly.
+   *
+   * The homeserver is a Pkarr domain name, where the TLD is a Pkarr public key
+   * for example "pubky.o4dksfbqk85ogzdb5osziw6befigbuxmuxkuxq8434q89uj56uyy"
+   * @param {Keypair} keypair
+   * @param {PublicKey} homeserver
+   * @returns {Promise<Session>}
+   */
   signup(keypair: Keypair, homeserver: PublicKey): Promise<Session>;
-/**
-* Check the current sesison for a given Pubky in its homeserver.
-*
-* Returns [Session] or `None` (if recieved `404 NOT_FOUND`),
-* or throws the recieved error if the response has any other `>=400` status code.
-* @param {PublicKey} pubky
-* @returns {Promise<Session | undefined>}
-*/
+  /**
+   * Check the current sesison for a given Pubky in its homeserver.
+   *
+   * Returns [Session] or `None` (if recieved `404 NOT_FOUND`),
+   * or throws the recieved error if the response has any other `>=400` status code.
+   * @param {PublicKey} pubky
+   * @returns {Promise<Session | undefined>}
+   */
   session(pubky: PublicKey): Promise<Session | undefined>;
-/**
-* Signout from a homeserver.
-* @param {PublicKey} pubky
-* @returns {Promise<void>}
-*/
+  /**
+   * Signout from a homeserver.
+   * @param {PublicKey} pubky
+   * @returns {Promise<void>}
+   */
   signout(pubky: PublicKey): Promise<void>;
-/**
-* Signin to a homeserver using the root Keypair.
-* @param {Keypair} keypair
-* @returns {Promise<void>}
-*/
+  /**
+   * Signin to a homeserver using the root Keypair.
+   * @param {Keypair} keypair
+   * @returns {Promise<void>}
+   */
   signin(keypair: Keypair): Promise<void>;
-/**
-* Return `pubkyauth://` url and wait for the incoming [AuthToken]
-* verifying that AuthToken, and if capabilities were requested, signing in to
-* the Pubky's homeserver and returning the [Session] information.
-*
-* Returns a tuple of [pubkyAuthUrl, Promise<Session>]
-* @param {string} relay
-* @param {string} capabilities
-* @returns {Array<any>}
-*/
+  /**
+   * Return `pubkyauth://` url and wait for the incoming [AuthToken]
+   * verifying that AuthToken, and if capabilities were requested, signing in to
+   * the Pubky's homeserver and returning the [Session] information.
+   *
+   * Returns a tuple of [pubkyAuthUrl, Promise<Session>]
+   * @param {string} relay
+   * @param {string} capabilities
+   * @returns {Array<any>}
+   */
   authRequest(relay: string, capabilities: string): Array<any>;
-/**
-* Sign an [pubky_common::auth::AuthToken], encrypt it and send it to the
-* source of the pubkyauth request url.
-* @param {Keypair} keypair
-* @param {string} pubkyauth_url
-* @returns {Promise<void>}
-*/
+  /**
+   * Sign an [pubky_common::auth::AuthToken], encrypt it and send it to the
+   * source of the pubkyauth request url.
+   * @param {Keypair} keypair
+   * @param {string} pubkyauth_url
+   * @returns {Promise<void>}
+   */
   sendAuthToken(keypair: Keypair, pubkyauth_url: string): Promise<void>;
-/**
-* Upload a small payload to a given path.
-* @param {string} url
-* @param {Uint8Array} content
-* @returns {Promise<void>}
-*/
+  /**
+   * Upload a small payload to a given path.
+   * @param {string} url
+   * @param {Uint8Array} content
+   * @returns {Promise<void>}
+   */
   put(url: string, content: Uint8Array): Promise<void>;
-/**
-* Download a small payload from a given path relative to a pubky author.
-* @param {string} url
-* @returns {Promise<Uint8Array | undefined>}
-*/
+  /**
+   * Download a small payload from a given path relative to a pubky author.
+   * @param {string} url
+   * @returns {Promise<Uint8Array | undefined>}
+   */
   get(url: string): Promise<Uint8Array | undefined>;
-/**
-* Delete a file at a path relative to a pubky author.
-* @param {string} url
-* @returns {Promise<void>}
-*/
+  /**
+   * Delete a file at a path relative to a pubky author.
+   * @param {string} url
+   * @returns {Promise<void>}
+   */
   delete(url: string): Promise<void>;
-/**
-* Returns a list of Pubky urls (as strings).
-*
-* - `url`:     The Pubky url (string) to the directory you want to list its content.
-* - `cursor`:  Either a full `pubky://` Url (from previous list response),
-*                 or a path (to a file or directory) relative to the `url`
-* - `reverse`: List in reverse order
-* - `limit`    Limit the number of urls in the response
-* - `shallow`: List directories and files, instead of flat list of files.
-* @param {string} url
-* @param {string | undefined} [cursor]
-* @param {boolean | undefined} [reverse]
-* @param {number | undefined} [limit]
-* @param {boolean | undefined} [shallow]
-* @returns {Promise<Array<any>>}
-*/
+  /**
+   * Returns a list of Pubky urls (as strings).
+   *
+   * - `url`:     The Pubky url (string) to the directory you want to list its content.
+   * - `cursor`:  Either a full `pubky://` Url (from previous list response),
+   *                 or a path (to a file or directory) relative to the `url`
+   * - `reverse`: List in reverse order
+   * - `limit`    Limit the number of urls in the response
+   * - `shallow`: List directories and files, instead of flat list of files.
+   * @param {string} url
+   * @param {string | undefined} [cursor]
+   * @param {boolean | undefined} [reverse]
+   * @param {number | undefined} [limit]
+   * @param {boolean | undefined} [shallow]
+   * @returns {Promise<Array<any>>}
+   */
   list(url: string, cursor?: string, reverse?: boolean, limit?: number, shallow?: boolean): Promise<Array<any>>;
 }
-/**
-*/
 export class PublicKey {
   free(): void;
-/**
-* Convert the PublicKey to Uint8Array
-* @returns {Uint8Array}
-*/
+  /**
+   * Convert the PublicKey to Uint8Array
+   * @returns {Uint8Array}
+   */
   to_uint8array(): Uint8Array;
-/**
-* Returns the z-base32 encoding of this public key
-* @returns {string}
-*/
+  /**
+   * Returns the z-base32 encoding of this public key
+   * @returns {string}
+   */
   z32(): string;
-/**
-* @throws
-* @param {any} value
-* @returns {PublicKey}
-*/
+  /**
+   * @throws
+   * @param {any} value
+   * @returns {PublicKey}
+   */
   static from(value: any): PublicKey;
 }
-/**
-*/
 export class Session {
   free(): void;
-/**
-* Return the [PublicKey] of this session
-* @returns {PublicKey}
-*/
+  /**
+   * Return the [PublicKey] of this session
+   * @returns {PublicKey}
+   */
   pubky(): PublicKey;
-/**
-* Return the capabilities that this session has.
-* @returns {(string)[]}
-*/
+  /**
+   * Return the capabilities that this session has.
+   * @returns {(string)[]}
+   */
   capabilities(): (string)[];
 }