@synonymdev/pubky 0.4.0-rc2 → 0.4.0

package/package.json

@@ -2,14 +2,14 @@
   "name": "@synonymdev/pubky",
   "type": "module",
   "description": "Pubky client",
-  "version": "0.4.0-rc2",
+  "version": "0.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/pubky/pubky-core.git"
   },
   "scripts": {
-    "testnet": "cargo run -p pubky-homeserver -- --testnet",
+    "testnet": "cargo run -p pubky-testnet",
     "test": "npm run test-nodejs && npm run test-browser",
     "test-nodejs": "tape test/*.js -cov",
     "test-browser": "browserify test/*.js -p esmify | npx tape-run",

package/pubky.d.ts

@@ -11,9 +11,25 @@ export function createRecoveryFile(keypair: Keypair, passphrase: string): Uint8A
  * using the `passphrase`.
  */
 export function decryptRecoveryFile(recovery_file: Uint8Array, passphrase: string): Keypair;
-/**
- * A client for Pubky homeserver API, as well as generic HTTP requests to Pubky urls.
- */
+export class AuthRequest {
+  private constructor();
+  free(): void;
+  /**
+   * Returns the Pubky Auth url, which you should show to the user
+   * to request an authentication or authorization token.
+   *
+   * Wait for this token using `this.response()`.
+   */
+  url(): string;
+  /**
+   * Wait for the user to send an authentication or authorization proof.
+   *
+   * If successful, you should expect an instance of [PublicKey]
+   *
+   * Otherwise it will throw an error.
+   */
+  response(): Promise<PublicKey>;
+}
 export class Client {
   free(): void;
   /**
@@ -27,6 +43,18 @@ export class Client {
    *     and read the homeserver HTTP port from the [reserved service parameter key](pubky_common::constants::reserved_param_keys::HTTP_PORT)
    */
   static testnet(): Client;
+  fetch(url: string, request_init?: any | null): Promise<Promise<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.
+   */
+  list(url: string, cursor?: string | null, reverse?: boolean | null, limit?: number | null, shallow?: boolean | null): Promise<Array<any>>;
   /**
    * Signup to a homeserver and update Pkarr accordingly.
    *
@@ -35,10 +63,10 @@ export class Client {
    */
   signup(keypair: Keypair, homeserver: PublicKey): Promise<Session>;
   /**
-   * Check the current sesison for a given Pubky in its homeserver.
+   * Check the current session 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.
+   * Returns [Session] or `None` (if received `404 NOT_FOUND`),
+   * or throws the received error if the response has any other `>=400` status code.
    */
   session(pubky: PublicKey): Promise<Session | undefined>;
   /**
@@ -54,26 +82,14 @@ export class Client {
    * 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>]
+   * Returns a [AuthRequest]
    */
-  authRequest(relay: string, capabilities: string): Array<any>;
+  authRequest(relay: string, capabilities: string): AuthRequest;
   /**
    * Sign an [pubky_common::auth::AuthToken], encrypt it and send it to the
    * source of the pubkyauth request url.
    */
   sendAuthToken(keypair: Keypair, pubkyauth_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.
-   */
-  list(url: string, cursor?: string, reverse?: boolean, limit?: number, shallow?: boolean): Promise<Array<any>>;
-  fetch(url: string, request_init?: any): Promise<Promise<any>>;
 }
 export class Keypair {
   private constructor();
@@ -121,5 +137,5 @@ export class Session {
   /**
    * Return the capabilities that this session has.
    */
-  capabilities(): (string)[];
+  capabilities(): string[];
 }