@cavuno/board 1.25.0 → 1.27.0

package/dist/index.js

@@ -18,10 +18,11 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   ACCESS_TOKEN_KEY: () => ACCESS_TOKEN_KEY,
   BOARD_ACCESS_GRANT_KEY: () => BOARD_ACCESS_GRANT_KEY,
+  BOARD_API_ERROR_CODES: () => BOARD_API_ERROR_CODES,
   BoardApiError: () => BoardApiError,
   BoardClient: () => BoardClient,
   REFRESH_TOKEN_KEY: () => REFRESH_TOKEN_KEY,
@@ -34,11 +35,127 @@ __export(index_exports, {
   isNotFound: () => isNotFound,
   isRateLimited: () => isRateLimited,
   isUnauthorized: () => isUnauthorized,
-  isValidationError: () => isValidationError
+  isValidationError: () => isValidationError,
+  paginate: () => paginate
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 
 // src/errors.ts
+var BOARD_API_ERROR_CODES = [
+  // Cross-cutting envelope
+  "internal_error",
+  "validation_bad_request",
+  "validation_payload_too_large",
+  "rate_limited",
+  "rate_limit_unavailable",
+  "search_unavailable",
+  "too_many_filter_values",
+  "pagination_invalid_cursor",
+  "pagination_offset_too_large",
+  "auth_unauthenticated",
+  "auth_forbidden",
+  "plan_upgrade_required",
+  "unknown_error",
+  // Board resolution + custom pages
+  "boards_not_found",
+  "board_page_not_found",
+  // Board-user auth
+  "board_auth_email_taken",
+  "board_auth_invalid_credentials",
+  "board_auth_invalid_token",
+  "board_auth_registration_disabled",
+  "board_auth_token_expired",
+  // Board password gate
+  "board_password_required",
+  "board_password_invalid",
+  // Jobs browse
+  "jobs_not_found",
+  "jobs_invalid_filter",
+  // Taxonomy
+  "categories_not_found",
+  "skills_not_found",
+  "places_not_found",
+  // Companies (public reads)
+  "companies_not_found",
+  "company_markets_not_found",
+  "company_salary_not_found",
+  "company_category_salary_not_found",
+  // Salaries
+  "salaries_title_not_found",
+  "salaries_skill_not_found",
+  "salaries_location_not_found",
+  "salaries_title_location_not_found",
+  "salaries_skill_location_not_found",
+  // Blog (public reads)
+  "blog_post_not_found",
+  "blog_author_not_found",
+  "blog_tag_not_found",
+  // Talent directory
+  "talent_not_found",
+  "talent_directory_not_found",
+  "talent_directory_restricted",
+  // Job alerts (anonymous + authenticated)
+  "job_alert_not_found",
+  "job_alerts_disabled",
+  "candidate_alert_limit_reached",
+  "candidate_alert_not_found",
+  // Candidate account
+  "candidate_entry_not_found",
+  "candidate_handle_taken",
+  "candidate_job_not_found",
+  "resume_invalid_file",
+  "resume_upload_forbidden",
+  // Applications
+  "applications_external_apply_only",
+  "applications_guest_not_allowed",
+  "applications_job_not_found",
+  "applications_not_found",
+  "applications_resume_invalid_file",
+  "applications_unprocessable",
+  // Messaging
+  "messaging_application_not_found",
+  "messaging_application_not_linked",
+  "messaging_blocked",
+  "messaging_cannot_block_self",
+  "messaging_cold_rule",
+  "messaging_conversation_not_found",
+  "messaging_disabled",
+  "messaging_edit_window_expired",
+  "messaging_message_deleted",
+  "messaging_message_not_found",
+  "messaging_not_author",
+  "messaging_not_participant",
+  "messaging_not_permitted",
+  "messaging_not_recipient",
+  "messaging_rate_limited",
+  "messaging_recipient_not_found",
+  "messaging_recipient_not_open",
+  "messaging_unsend_window_expired",
+  // Employer self-service
+  "employer_applicant_not_found",
+  "employer_ats_unprocessable",
+  "employer_checkout_failed",
+  "employer_company_exists",
+  "employer_company_name_taken",
+  "employer_company_not_found",
+  "employer_job_not_found",
+  "employer_job_slug_taken",
+  "employer_jobs_quota_exceeded",
+  "employer_not_member",
+  "employer_payment_required",
+  "employer_pipeline_stage_not_found",
+  // Candidate job-access paywall
+  "paywall_already_active",
+  "paywall_disabled",
+  "paywall_invalid_checkout_session",
+  "paywall_no_candidate_profile",
+  "paywall_no_recurring_subscription",
+  "paywall_offer_not_found",
+  // Public job posting
+  "job_posting_logo_lookup_unavailable",
+  "job_posting_logo_not_found",
+  "job_posting_rejected"
+];
 var BoardApiError = class extends Error {
   status;
   /** `<domain>_<snake_reason>` code from the v1 error envelope. */
@@ -149,7 +266,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.25.0";
+var SDK_VERSION = "1.27.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -785,7 +902,7 @@ function jobPostingNamespace(client) {
     },
     /**
      * Upload a company logo (JPEG/PNG/WebP/GIF, ≤2 MB). Returns the stored
-     * `publicUrl` — pass it back as `submission.logoUrl` on `create(...)`.
+     * `publicUrl` — pass it back as the top-level `logoUrl` on `create(...)`.
      */
     uploadLogo(file, options) {
       const form = new FormData();
@@ -798,7 +915,7 @@ function jobPostingNamespace(client) {
     },
     /**
      * Look up a company logo by domain via Brandfetch, store it, and return its
-     * `publicUrl` — pass it back as `submission.logoUrl` on `create(...)`. A
+     * `publicUrl` — pass it back as the top-level `logoUrl` on `create(...)`. A
      * `BoardApiError` (`job_posting_logo_not_found`) means no usable logo.
      */
     fetchLogoByDomain(domain, options) {
@@ -2400,6 +2517,36 @@ function taxonomyNamespace(client) {
   };
 }
 
+// src/pagination.ts
+function paginate(listFn, query, options) {
+  async function* pages() {
+    let current = query;
+    for (; ; ) {
+      const page = await listFn(current, options);
+      yield page;
+      if (!page.hasMore || page.nextCursor === null) return;
+      const { offset: _offset, ...rest } = current ?? {};
+      current = { ...rest, cursor: page.nextCursor };
+    }
+  }
+  return {
+    pages,
+    async *[Symbol.asyncIterator]() {
+      for await (const page of pages()) {
+        yield* page.data;
+      }
+    },
+    async toArray({ limit }) {
+      const items = [];
+      for await (const page of pages()) {
+        items.push(...page.data);
+        if (items.length >= limit) break;
+      }
+      return items.slice(0, limit);
+    }
+  };
+}
+
 // src/index.ts
 function createBoardClient(options) {
   const client = new BoardClient({

package/dist/index.mjs

@@ -1,4 +1,119 @@
 // src/errors.ts
+var BOARD_API_ERROR_CODES = [
+  // Cross-cutting envelope
+  "internal_error",
+  "validation_bad_request",
+  "validation_payload_too_large",
+  "rate_limited",
+  "rate_limit_unavailable",
+  "search_unavailable",
+  "too_many_filter_values",
+  "pagination_invalid_cursor",
+  "pagination_offset_too_large",
+  "auth_unauthenticated",
+  "auth_forbidden",
+  "plan_upgrade_required",
+  "unknown_error",
+  // Board resolution + custom pages
+  "boards_not_found",
+  "board_page_not_found",
+  // Board-user auth
+  "board_auth_email_taken",
+  "board_auth_invalid_credentials",
+  "board_auth_invalid_token",
+  "board_auth_registration_disabled",
+  "board_auth_token_expired",
+  // Board password gate
+  "board_password_required",
+  "board_password_invalid",
+  // Jobs browse
+  "jobs_not_found",
+  "jobs_invalid_filter",
+  // Taxonomy
+  "categories_not_found",
+  "skills_not_found",
+  "places_not_found",
+  // Companies (public reads)
+  "companies_not_found",
+  "company_markets_not_found",
+  "company_salary_not_found",
+  "company_category_salary_not_found",
+  // Salaries
+  "salaries_title_not_found",
+  "salaries_skill_not_found",
+  "salaries_location_not_found",
+  "salaries_title_location_not_found",
+  "salaries_skill_location_not_found",
+  // Blog (public reads)
+  "blog_post_not_found",
+  "blog_author_not_found",
+  "blog_tag_not_found",
+  // Talent directory
+  "talent_not_found",
+  "talent_directory_not_found",
+  "talent_directory_restricted",
+  // Job alerts (anonymous + authenticated)
+  "job_alert_not_found",
+  "job_alerts_disabled",
+  "candidate_alert_limit_reached",
+  "candidate_alert_not_found",
+  // Candidate account
+  "candidate_entry_not_found",
+  "candidate_handle_taken",
+  "candidate_job_not_found",
+  "resume_invalid_file",
+  "resume_upload_forbidden",
+  // Applications
+  "applications_external_apply_only",
+  "applications_guest_not_allowed",
+  "applications_job_not_found",
+  "applications_not_found",
+  "applications_resume_invalid_file",
+  "applications_unprocessable",
+  // Messaging
+  "messaging_application_not_found",
+  "messaging_application_not_linked",
+  "messaging_blocked",
+  "messaging_cannot_block_self",
+  "messaging_cold_rule",
+  "messaging_conversation_not_found",
+  "messaging_disabled",
+  "messaging_edit_window_expired",
+  "messaging_message_deleted",
+  "messaging_message_not_found",
+  "messaging_not_author",
+  "messaging_not_participant",
+  "messaging_not_permitted",
+  "messaging_not_recipient",
+  "messaging_rate_limited",
+  "messaging_recipient_not_found",
+  "messaging_recipient_not_open",
+  "messaging_unsend_window_expired",
+  // Employer self-service
+  "employer_applicant_not_found",
+  "employer_ats_unprocessable",
+  "employer_checkout_failed",
+  "employer_company_exists",
+  "employer_company_name_taken",
+  "employer_company_not_found",
+  "employer_job_not_found",
+  "employer_job_slug_taken",
+  "employer_jobs_quota_exceeded",
+  "employer_not_member",
+  "employer_payment_required",
+  "employer_pipeline_stage_not_found",
+  // Candidate job-access paywall
+  "paywall_already_active",
+  "paywall_disabled",
+  "paywall_invalid_checkout_session",
+  "paywall_no_candidate_profile",
+  "paywall_no_recurring_subscription",
+  "paywall_offer_not_found",
+  // Public job posting
+  "job_posting_logo_lookup_unavailable",
+  "job_posting_logo_not_found",
+  "job_posting_rejected"
+];
 var BoardApiError = class extends Error {
   status;
   /** `<domain>_<snake_reason>` code from the v1 error envelope. */
@@ -109,7 +224,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.25.0";
+var SDK_VERSION = "1.27.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -745,7 +860,7 @@ function jobPostingNamespace(client) {
     },
     /**
      * Upload a company logo (JPEG/PNG/WebP/GIF, ≤2 MB). Returns the stored
-     * `publicUrl` — pass it back as `submission.logoUrl` on `create(...)`.
+     * `publicUrl` — pass it back as the top-level `logoUrl` on `create(...)`.
      */
     uploadLogo(file, options) {
       const form = new FormData();
@@ -758,7 +873,7 @@ function jobPostingNamespace(client) {
     },
     /**
      * Look up a company logo by domain via Brandfetch, store it, and return its
-     * `publicUrl` — pass it back as `submission.logoUrl` on `create(...)`. A
+     * `publicUrl` — pass it back as the top-level `logoUrl` on `create(...)`. A
      * `BoardApiError` (`job_posting_logo_not_found`) means no usable logo.
      */
     fetchLogoByDomain(domain, options) {
@@ -2360,6 +2475,36 @@ function taxonomyNamespace(client) {
   };
 }
 
+// src/pagination.ts
+function paginate(listFn, query, options) {
+  async function* pages() {
+    let current = query;
+    for (; ; ) {
+      const page = await listFn(current, options);
+      yield page;
+      if (!page.hasMore || page.nextCursor === null) return;
+      const { offset: _offset, ...rest } = current ?? {};
+      current = { ...rest, cursor: page.nextCursor };
+    }
+  }
+  return {
+    pages,
+    async *[Symbol.asyncIterator]() {
+      for await (const page of pages()) {
+        yield* page.data;
+      }
+    },
+    async toArray({ limit }) {
+      const items = [];
+      for await (const page of pages()) {
+        items.push(...page.data);
+        if (items.length >= limit) break;
+      }
+      return items.slice(0, limit);
+    }
+  };
+}
+
 // src/index.ts
 function createBoardClient(options) {
   const client = new BoardClient({
@@ -2419,6 +2564,7 @@ function createBoardClient(options) {
 export {
   ACCESS_TOKEN_KEY,
   BOARD_ACCESS_GRANT_KEY,
+  BOARD_API_ERROR_CODES,
   BoardApiError,
   BoardClient,
   REFRESH_TOKEN_KEY,
@@ -2431,5 +2577,6 @@ export {
   isNotFound,
   isRateLimited,
   isUnauthorized,
-  isValidationError
+  isValidationError,
+  paginate
 };