@cavuno/board 1.19.0 → 1.20.0

package/dist/index.js

@@ -149,7 +149,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.19.0";
+var SDK_VERSION = "1.20.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -374,6 +374,74 @@ function authNamespace(client) {
         method: "POST",
         body
       });
+    },
+    /**
+     * Request a passwordless magic link. The API always resolves 204
+     * when the request is accepted; the email link lands on the
+     * board/starter `/auth/magic-link` route.
+     *
+     * @example
+     * await board.auth.requestMagicLink({
+     *   email: 'a@b.com',
+     *   returnTo: '/account',
+     * });
+     */
+    requestMagicLink(body, options) {
+      return client.fetch("/auth/magic-link", {
+        ...options,
+        method: "POST",
+        body
+      });
+    },
+    /**
+     * Consume a magic-link token and persist the returned bearer pair.
+     *
+     * @example
+     * await board.auth.consumeMagicLink({ token });
+     */
+    async consumeMagicLink(body, options) {
+      const session = await client.fetch(
+        "/auth/magic-link/consume",
+        {
+          ...options,
+          method: "POST",
+          body
+        }
+      );
+      return persist(session);
+    },
+    /**
+     * Build a provider authorization URL. The SDK returns the URL; the
+     * host app owns browser navigation.
+     *
+     * @example
+     * const { authorizeUrl } = await board.auth.getOAuthAuthorizationUrl('google');
+     * window.location.href = authorizeUrl;
+     */
+    getOAuthAuthorizationUrl(provider, query, options) {
+      return client.fetch(`/auth/oauth/${provider}`, {
+        ...options,
+        method: "GET",
+        query
+      });
+    },
+    /**
+     * Exchange the provider callback one-time token and persist the
+     * returned bearer pair.
+     *
+     * @example
+     * await board.auth.exchangeOAuth({ token });
+     */
+    async exchangeOAuth(body, options) {
+      const session = await client.fetch(
+        "/auth/oauth/exchange",
+        {
+          ...options,
+          method: "POST",
+          body
+        }
+      );
+      return persist(session);
     }
   };
 }
@@ -842,6 +910,196 @@ function meNamespace(client) {
     retrieve(query, options) {
       return client.fetch("/me", { ...options, query });
     },
+    /**
+     * Permanently delete my account and all dependent data (profile,
+     * collections, saved jobs, alerts, avatar/resume files). Synchronous and
+     * irreversible — resolves void once the cascade completes (204).
+     *
+     * @example
+     * await board.me.delete();
+     */
+    delete(options) {
+      return client.fetch("/me", { ...options, method: "DELETE" });
+    },
+    /**
+     * The authenticated candidate's own account self-service (doc 32).
+     * `profile.*` is the lean profile singleton + (commit 2+) its
+     * experience / education / skills / languages collections + avatar.
+     */
+    profile: {
+      /**
+       * Retrieve my lean candidate profile.
+       *
+       * @example
+       * const profile = await board.me.profile.retrieve();
+       */
+      retrieve(query, options) {
+        return client.fetch("/me/profile", {
+          ...options,
+          query
+        });
+      },
+      /**
+       * Update my candidate profile. Optional-field merge-patch — omitted
+       * fields stay unchanged.
+       *
+       * @example
+       * await board.me.profile.update({ headline: 'Staff Engineer' });
+       */
+      update(body, query, options) {
+        return client.fetch("/me/profile", {
+          ...options,
+          method: "PATCH",
+          body,
+          query
+        });
+      },
+      /**
+       * Check whether a handle is available for me on this board (my own
+       * current handle counts as available). Advisory — `update` re-checks.
+       *
+       * @example
+       * const { available } = await board.me.profile.handleAvailable('jane');
+       */
+      handleAvailable(handle, options) {
+        return client.fetch(
+          "/me/profile/handle-available",
+          { ...options, query: { handle } }
+        );
+      },
+      /** List my experience entries. */
+      listExperience(options) {
+        return client.fetch(
+          "/me/profile/experience",
+          options
+        );
+      },
+      /** Add an experience entry. */
+      createExperience(body, options) {
+        return client.fetch("/me/profile/experience", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /** Update an experience entry (merge-patch). */
+      updateExperience(id, body, options) {
+        return client.fetch(
+          `/me/profile/experience/${encodeURIComponent(id)}`,
+          { ...options, method: "PATCH", body }
+        );
+      },
+      /** Delete an experience entry. */
+      deleteExperience(id, options) {
+        return client.fetch(
+          `/me/profile/experience/${encodeURIComponent(id)}`,
+          { ...options, method: "DELETE" }
+        );
+      },
+      /** List my education entries. */
+      listEducation(options) {
+        return client.fetch(
+          "/me/profile/education",
+          options
+        );
+      },
+      /** Add an education entry. */
+      createEducation(body, options) {
+        return client.fetch("/me/profile/education", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /** Update an education entry (merge-patch). */
+      updateEducation(id, body, options) {
+        return client.fetch(
+          `/me/profile/education/${encodeURIComponent(id)}`,
+          { ...options, method: "PATCH", body }
+        );
+      },
+      /** Delete an education entry. */
+      deleteEducation(id, options) {
+        return client.fetch(
+          `/me/profile/education/${encodeURIComponent(id)}`,
+          { ...options, method: "DELETE" }
+        );
+      },
+      /** List my skills. */
+      listSkills(options) {
+        return client.fetch(
+          "/me/profile/skills",
+          options
+        );
+      },
+      /** Replace my skills with the provided ordered names. */
+      updateSkills(body, options) {
+        return client.fetch(
+          "/me/profile/skills",
+          { ...options, method: "PUT", body }
+        );
+      },
+      /** List my languages. */
+      listLanguages(options) {
+        return client.fetch(
+          "/me/profile/languages",
+          options
+        );
+      },
+      /** Replace my languages with the provided ordered set. */
+      updateLanguages(body, options) {
+        return client.fetch(
+          "/me/profile/languages",
+          { ...options, method: "PUT", body }
+        );
+      },
+      /**
+       * Upload my avatar (JPEG/PNG/WebP, ≤5 MB) via a single multipart POST.
+       *
+       * @example
+       * await board.me.profile.uploadAvatar(file);
+       */
+      uploadAvatar(file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return client.fetch("/me/profile/avatar", {
+          ...options,
+          method: "POST",
+          body: form
+        });
+      }
+    },
+    /**
+     * Signed-in notification preferences + the anonymous email-link
+     * unsubscribe branch (doc 32).
+     */
+    notificationPreferences: {
+      /** List every notification channel + its subscribed state. */
+      retrieve(options) {
+        return client.fetch(
+          "/me/notification-preferences",
+          options
+        );
+      },
+      /** Toggle one channel; returns the full updated set. */
+      update(body, options) {
+        return client.fetch(
+          "/me/notification-preferences",
+          { ...options, method: "PUT", body }
+        );
+      },
+      /**
+       * Anonymous one-click unsubscribe via an HMAC email-link token — no
+       * session. Resolves void on success (204).
+       */
+      unsubscribeWithToken(body, options) {
+        return client.fetch("/me/notification-preferences/unsubscribe", {
+          ...options,
+          method: "POST",
+          body
+        });
+      }
+    },
     savedJobs: {
       /**
        * List the authenticated user's saved jobs (each embeds the full

package/dist/index.mjs

@@ -109,7 +109,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.19.0";
+var SDK_VERSION = "1.20.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -334,6 +334,74 @@ function authNamespace(client) {
         method: "POST",
         body
       });
+    },
+    /**
+     * Request a passwordless magic link. The API always resolves 204
+     * when the request is accepted; the email link lands on the
+     * board/starter `/auth/magic-link` route.
+     *
+     * @example
+     * await board.auth.requestMagicLink({
+     *   email: 'a@b.com',
+     *   returnTo: '/account',
+     * });
+     */
+    requestMagicLink(body, options) {
+      return client.fetch("/auth/magic-link", {
+        ...options,
+        method: "POST",
+        body
+      });
+    },
+    /**
+     * Consume a magic-link token and persist the returned bearer pair.
+     *
+     * @example
+     * await board.auth.consumeMagicLink({ token });
+     */
+    async consumeMagicLink(body, options) {
+      const session = await client.fetch(
+        "/auth/magic-link/consume",
+        {
+          ...options,
+          method: "POST",
+          body
+        }
+      );
+      return persist(session);
+    },
+    /**
+     * Build a provider authorization URL. The SDK returns the URL; the
+     * host app owns browser navigation.
+     *
+     * @example
+     * const { authorizeUrl } = await board.auth.getOAuthAuthorizationUrl('google');
+     * window.location.href = authorizeUrl;
+     */
+    getOAuthAuthorizationUrl(provider, query, options) {
+      return client.fetch(`/auth/oauth/${provider}`, {
+        ...options,
+        method: "GET",
+        query
+      });
+    },
+    /**
+     * Exchange the provider callback one-time token and persist the
+     * returned bearer pair.
+     *
+     * @example
+     * await board.auth.exchangeOAuth({ token });
+     */
+    async exchangeOAuth(body, options) {
+      const session = await client.fetch(
+        "/auth/oauth/exchange",
+        {
+          ...options,
+          method: "POST",
+          body
+        }
+      );
+      return persist(session);
     }
   };
 }
@@ -802,6 +870,196 @@ function meNamespace(client) {
     retrieve(query, options) {
       return client.fetch("/me", { ...options, query });
     },
+    /**
+     * Permanently delete my account and all dependent data (profile,
+     * collections, saved jobs, alerts, avatar/resume files). Synchronous and
+     * irreversible — resolves void once the cascade completes (204).
+     *
+     * @example
+     * await board.me.delete();
+     */
+    delete(options) {
+      return client.fetch("/me", { ...options, method: "DELETE" });
+    },
+    /**
+     * The authenticated candidate's own account self-service (doc 32).
+     * `profile.*` is the lean profile singleton + (commit 2+) its
+     * experience / education / skills / languages collections + avatar.
+     */
+    profile: {
+      /**
+       * Retrieve my lean candidate profile.
+       *
+       * @example
+       * const profile = await board.me.profile.retrieve();
+       */
+      retrieve(query, options) {
+        return client.fetch("/me/profile", {
+          ...options,
+          query
+        });
+      },
+      /**
+       * Update my candidate profile. Optional-field merge-patch — omitted
+       * fields stay unchanged.
+       *
+       * @example
+       * await board.me.profile.update({ headline: 'Staff Engineer' });
+       */
+      update(body, query, options) {
+        return client.fetch("/me/profile", {
+          ...options,
+          method: "PATCH",
+          body,
+          query
+        });
+      },
+      /**
+       * Check whether a handle is available for me on this board (my own
+       * current handle counts as available). Advisory — `update` re-checks.
+       *
+       * @example
+       * const { available } = await board.me.profile.handleAvailable('jane');
+       */
+      handleAvailable(handle, options) {
+        return client.fetch(
+          "/me/profile/handle-available",
+          { ...options, query: { handle } }
+        );
+      },
+      /** List my experience entries. */
+      listExperience(options) {
+        return client.fetch(
+          "/me/profile/experience",
+          options
+        );
+      },
+      /** Add an experience entry. */
+      createExperience(body, options) {
+        return client.fetch("/me/profile/experience", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /** Update an experience entry (merge-patch). */
+      updateExperience(id, body, options) {
+        return client.fetch(
+          `/me/profile/experience/${encodeURIComponent(id)}`,
+          { ...options, method: "PATCH", body }
+        );
+      },
+      /** Delete an experience entry. */
+      deleteExperience(id, options) {
+        return client.fetch(
+          `/me/profile/experience/${encodeURIComponent(id)}`,
+          { ...options, method: "DELETE" }
+        );
+      },
+      /** List my education entries. */
+      listEducation(options) {
+        return client.fetch(
+          "/me/profile/education",
+          options
+        );
+      },
+      /** Add an education entry. */
+      createEducation(body, options) {
+        return client.fetch("/me/profile/education", {
+          ...options,
+          method: "POST",
+          body
+        });
+      },
+      /** Update an education entry (merge-patch). */
+      updateEducation(id, body, options) {
+        return client.fetch(
+          `/me/profile/education/${encodeURIComponent(id)}`,
+          { ...options, method: "PATCH", body }
+        );
+      },
+      /** Delete an education entry. */
+      deleteEducation(id, options) {
+        return client.fetch(
+          `/me/profile/education/${encodeURIComponent(id)}`,
+          { ...options, method: "DELETE" }
+        );
+      },
+      /** List my skills. */
+      listSkills(options) {
+        return client.fetch(
+          "/me/profile/skills",
+          options
+        );
+      },
+      /** Replace my skills with the provided ordered names. */
+      updateSkills(body, options) {
+        return client.fetch(
+          "/me/profile/skills",
+          { ...options, method: "PUT", body }
+        );
+      },
+      /** List my languages. */
+      listLanguages(options) {
+        return client.fetch(
+          "/me/profile/languages",
+          options
+        );
+      },
+      /** Replace my languages with the provided ordered set. */
+      updateLanguages(body, options) {
+        return client.fetch(
+          "/me/profile/languages",
+          { ...options, method: "PUT", body }
+        );
+      },
+      /**
+       * Upload my avatar (JPEG/PNG/WebP, ≤5 MB) via a single multipart POST.
+       *
+       * @example
+       * await board.me.profile.uploadAvatar(file);
+       */
+      uploadAvatar(file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return client.fetch("/me/profile/avatar", {
+          ...options,
+          method: "POST",
+          body: form
+        });
+      }
+    },
+    /**
+     * Signed-in notification preferences + the anonymous email-link
+     * unsubscribe branch (doc 32).
+     */
+    notificationPreferences: {
+      /** List every notification channel + its subscribed state. */
+      retrieve(options) {
+        return client.fetch(
+          "/me/notification-preferences",
+          options
+        );
+      },
+      /** Toggle one channel; returns the full updated set. */
+      update(body, options) {
+        return client.fetch(
+          "/me/notification-preferences",
+          { ...options, method: "PUT", body }
+        );
+      },
+      /**
+       * Anonymous one-click unsubscribe via an HMAC email-link token — no
+       * session. Resolves void on success (204).
+       */
+      unsubscribeWithToken(body, options) {
+        return client.fetch("/me/notification-preferences/unsubscribe", {
+          ...options,
+          method: "POST",
+          body
+        });
+      }
+    },
     savedJobs: {
       /**
        * List the authenticated user's saved jobs (each embeds the full

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Typed isomorphic client for the Cavuno Board API",
   "license": "MIT",
   "repository": {

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.19.0",
+  "version": "1.20.0",
   "skills": [
     {
       "name": "cavuno-board-auth",