@cavuno/board 3.2.0 → 4.1.0

package/dist/index.js

@@ -312,7 +312,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.2.0";
+var SDK_VERSION = "4.1.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -1114,28 +1114,6 @@ function jobsNamespace(client) {
   };
 }
 
-// src/namespaces/legal.ts
-function legalNamespace(client) {
-  return {
-    /**
-     * Retrieve a board legal/about page — owner-authored prose as portable HTML
-     * (`privacy-policy` / `terms-of-service` / `cookie-policy` / `about`) plus,
-     * for `impressum`, structured legal-entity facts. The starter authors the
-     * layout, breadcrumb labels, and JSON-LD. `impressum` throws
-     * `board_page_not_found` (404) when the board has not enabled it.
-     *
-     * @example
-     * const { title, content } = await board.legal.retrieve('privacy-policy');
-     */
-    retrieve(type, options) {
-      return client.fetch(
-        `/legal/${encodeURIComponent(type)}`,
-        options
-      );
-    }
-  };
-}
-
 // src/namespaces/me.ts
 function meNamespace(client) {
   return {
@@ -2347,6 +2325,40 @@ function meNamespace(client) {
         );
       }
     },
+    /**
+     * My marketing-email consent.
+     *
+     * Consent is a property of the board user, given at sign-up or from the
+     * board's own settings page. Both surfaces render board-authored
+     * disclosure wording — the API records the decision, never the prose, so
+     * whatever you show beside these calls is what the person agreed to.
+     */
+    marketingConsent: {
+      /** My consent, or `null` when no decision has ever been recorded. */
+      retrieve(options) {
+        return client.fetch(
+          "/me/marketing-consent",
+          options
+        );
+      },
+      /**
+       * Grant. Call this only from a surface that displayed your disclosure
+       * copy — nothing server-side can check that you did.
+       */
+      grant(options) {
+        return client.fetch("/me/marketing-consent/grant", {
+          ...options,
+          method: "POST"
+        });
+      },
+      /** Withdraw. Repeating it returns the same state, no new event. */
+      withdraw(options) {
+        return client.fetch(
+          "/me/marketing-consent/withdraw",
+          { ...options, method: "POST" }
+        );
+      }
+    },
     /**
      * The candidate job-access paywall — the authenticated money flow . Enumerate offers publicly with `board.paywall.offers()`, then
      * `checkout` here; poll `retrieveCheckout` until complete and confirm with
@@ -2621,12 +2633,18 @@ function salariesNamespace(client) {
 function searchNamespace(client) {
   return {
     /**
-     * GET /search/suggest — federated keyword suggestions (companies +
-     * taxonomy terms), one interleaved server-ranked list. Order is the
-     * contract: do not re-sort.
+     * GET /search/suggest — federated keyword suggestions (companies,
+     * markets, taxonomy terms), one interleaved server-ranked list. Pass
+     * `types` to restrict kinds; `limit` applies after that filter. Order
+     * is the contract: do not re-sort. Routing is application-side via
+     * `suggestionPath` from `@cavuno/board/paths`.
      *
      * @example
-     * const { items } = await board.search.suggest({ q: 'acme', limit: 10 });
+     * const { items } = await board.search.suggest({
+     *   q: 'acme',
+     *   limit: 10,
+     *   types: ['company', 'skill'],
+     * });
      */
     suggest(query, options) {
       return client.fetch("/search/suggest", {
@@ -2719,14 +2737,6 @@ function taxonomyNamespace(client) {
         );
       }
     },
-    suggestions: {
-      list(query, options) {
-        return client.fetch("/suggestions", {
-          ...options,
-          query
-        });
-      }
-    },
     places: {
       ...taxonomyResolver(client, "places"),
       /**
@@ -2853,7 +2863,6 @@ function createBoardClient(options) {
     embed: embedNamespace(client),
     companies: companiesNamespace(client),
     blog: blogNamespace(client),
-    legal: legalNamespace(client),
     auth: authNamespace(client),
     me: meNamespace(client),
     password: passwordNamespace(client),

package/dist/index.mjs

@@ -39,7 +39,7 @@ function toSearchParams(query) {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.2.0";
+var SDK_VERSION = "4.1.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -841,28 +841,6 @@ function jobsNamespace(client) {
   };
 }
 
-// src/namespaces/legal.ts
-function legalNamespace(client) {
-  return {
-    /**
-     * Retrieve a board legal/about page — owner-authored prose as portable HTML
-     * (`privacy-policy` / `terms-of-service` / `cookie-policy` / `about`) plus,
-     * for `impressum`, structured legal-entity facts. The starter authors the
-     * layout, breadcrumb labels, and JSON-LD. `impressum` throws
-     * `board_page_not_found` (404) when the board has not enabled it.
-     *
-     * @example
-     * const { title, content } = await board.legal.retrieve('privacy-policy');
-     */
-    retrieve(type, options) {
-      return client.fetch(
-        `/legal/${encodeURIComponent(type)}`,
-        options
-      );
-    }
-  };
-}
-
 // src/namespaces/me.ts
 function meNamespace(client) {
   return {
@@ -2074,6 +2052,40 @@ function meNamespace(client) {
         );
       }
     },
+    /**
+     * My marketing-email consent.
+     *
+     * Consent is a property of the board user, given at sign-up or from the
+     * board's own settings page. Both surfaces render board-authored
+     * disclosure wording — the API records the decision, never the prose, so
+     * whatever you show beside these calls is what the person agreed to.
+     */
+    marketingConsent: {
+      /** My consent, or `null` when no decision has ever been recorded. */
+      retrieve(options) {
+        return client.fetch(
+          "/me/marketing-consent",
+          options
+        );
+      },
+      /**
+       * Grant. Call this only from a surface that displayed your disclosure
+       * copy — nothing server-side can check that you did.
+       */
+      grant(options) {
+        return client.fetch("/me/marketing-consent/grant", {
+          ...options,
+          method: "POST"
+        });
+      },
+      /** Withdraw. Repeating it returns the same state, no new event. */
+      withdraw(options) {
+        return client.fetch(
+          "/me/marketing-consent/withdraw",
+          { ...options, method: "POST" }
+        );
+      }
+    },
     /**
      * The candidate job-access paywall — the authenticated money flow . Enumerate offers publicly with `board.paywall.offers()`, then
      * `checkout` here; poll `retrieveCheckout` until complete and confirm with
@@ -2348,12 +2360,18 @@ function salariesNamespace(client) {
 function searchNamespace(client) {
   return {
     /**
-     * GET /search/suggest — federated keyword suggestions (companies +
-     * taxonomy terms), one interleaved server-ranked list. Order is the
-     * contract: do not re-sort.
+     * GET /search/suggest — federated keyword suggestions (companies,
+     * markets, taxonomy terms), one interleaved server-ranked list. Pass
+     * `types` to restrict kinds; `limit` applies after that filter. Order
+     * is the contract: do not re-sort. Routing is application-side via
+     * `suggestionPath` from `@cavuno/board/paths`.
      *
      * @example
-     * const { items } = await board.search.suggest({ q: 'acme', limit: 10 });
+     * const { items } = await board.search.suggest({
+     *   q: 'acme',
+     *   limit: 10,
+     *   types: ['company', 'skill'],
+     * });
      */
     suggest(query, options) {
       return client.fetch("/search/suggest", {
@@ -2446,14 +2464,6 @@ function taxonomyNamespace(client) {
         );
       }
     },
-    suggestions: {
-      list(query, options) {
-        return client.fetch("/suggestions", {
-          ...options,
-          query
-        });
-      }
-    },
     places: {
       ...taxonomyResolver(client, "places"),
       /**
@@ -2550,7 +2560,6 @@ function createBoardClient(options) {
     embed: embedNamespace(client),
     companies: companiesNamespace(client),
     blog: blogNamespace(client),
-    legal: legalNamespace(client),
     auth: authNamespace(client),
     me: meNamespace(client),
     password: passwordNamespace(client),

package/dist/{jobs-BiEvL9d7.d.ts → jobs-BX6d_sdd.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-nkWAraS0.js';
+import { S as Schemas } from './_spec-BZDv2dc5.mjs';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -36,8 +36,8 @@ type PublicJob = Schemas['PublicJob'];
 type PublicJobCard = Schemas['PublicJobCard'];
 /**
  * A job's opaque, display-only custom-field values, keyed by each
- * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
- * (`board.context().customFields`).
+ * field's `key`. Resolve labels via the board's job `CustomFieldDefinition`s
+ * (`board.context().customFields.job`).
  */
 type CustomFieldValues = PublicJob['customFieldValues'];
 type CustomFieldValue = CustomFieldValues[string];
@@ -104,4 +104,4 @@ type JobsSimilarQuery = {
 };
 type JobsSearchBody = Schemas['PublicSearchJobsBody'];
 
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, OfficeLocation as O, PublicJob as P, RemoteOption as R, Seniority as S, PublicJobCard as a, JobsListQuery as b, JobCardListEnvelope as c, JobsSearchBody as d, JobCardSearchEnvelope as e, JobsSimilarQuery as f, SearchEnvelope as g, CustomFieldValue as h, EducationRequirement as i, JobCatalogPagination as j, JobCompany as k, OffsetPagination as l, RelatedSearch as m, RemotePermit as n, RemoteTimezone as o, StorefrontPagination as p };
+export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, OfficeLocation as O, PublicJob as P, RemoteOption as R, Seniority as S, JobsListQuery as a, JobCardListEnvelope as b, JobsSearchBody as c, JobCardSearchEnvelope as d, JobsSimilarQuery as e, SearchEnvelope as f, CustomFieldValue as g, EducationRequirement as h, JobCatalogPagination as i, JobCompany as j, OffsetPagination as k, PublicJobCard as l, RelatedSearch as m, RemotePermit as n, RemoteTimezone as o, StorefrontPagination as p };

package/dist/{jobs-lVvKCBCU.d.mts → jobs-BbLJfz1z.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-nkWAraS0.mjs';
+import { S as Schemas } from './_spec-BZDv2dc5.js';
 
 /**
  * Optional pagination metadata returned by Board API list operations.
@@ -36,8 +36,8 @@ type PublicJob = Schemas['PublicJob'];
 type PublicJobCard = Schemas['PublicJobCard'];
 /**
  * A job's opaque, display-only custom-field values, keyed by each
- * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
- * (`board.context().customFields`).
+ * field's `key`. Resolve labels via the board's job `CustomFieldDefinition`s
+ * (`board.context().customFields.job`).
  */
 type CustomFieldValues = PublicJob['customFieldValues'];
 type CustomFieldValue = CustomFieldValues[string];
@@ -104,4 +104,4 @@ type JobsSimilarQuery = {
 };
 type JobsSearchBody = Schemas['PublicSearchJobsBody'];
 
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, OfficeLocation as O, PublicJob as P, RemoteOption as R, Seniority as S, PublicJobCard as a, JobsListQuery as b, JobCardListEnvelope as c, JobsSearchBody as d, JobCardSearchEnvelope as e, JobsSimilarQuery as f, SearchEnvelope as g, CustomFieldValue as h, EducationRequirement as i, JobCatalogPagination as j, JobCompany as k, OffsetPagination as l, RelatedSearch as m, RemotePermit as n, RemoteTimezone as o, StorefrontPagination as p };
+export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, OfficeLocation as O, PublicJob as P, RemoteOption as R, Seniority as S, JobsListQuery as a, JobCardListEnvelope as b, JobsSearchBody as c, JobCardSearchEnvelope as d, JobsSimilarQuery as e, SearchEnvelope as f, CustomFieldValue as g, EducationRequirement as h, JobCatalogPagination as i, JobCompany as j, OffsetPagination as k, PublicJobCard as l, RelatedSearch as m, RemotePermit as n, RemoteTimezone as o, StorefrontPagination as p };

package/dist/paths.d.mts

@@ -9,11 +9,27 @@
  * zero-dependency — safe to import in server runtimes, on the edge,
  * and in the browser.
  *
+ * Dynamic path segments are percent-encoded (URI, not bare IRI) so
+ * non-Latin board-language slugs (`SuggestionPathInput.canonicalSlug`)
+ * are legal in sitemap `<loc>`, canonical/`og:url`, and email links.
+ * Separators (`/`) are never encoded; already-encoded input is not
+ * double-encoded.
+ *
  * These paths mirror the hosted board's indexed URLs exactly (migration
  * parity). Do NOT change a pattern here without updating the hosted board
  * and the sitemap golden tests in lockstep — the structure is a locked
  * cross-surface contract.
  */
+/**
+ * Percent-encode one path segment for use in a URL path.
+ * Round-trips already-encoded input so `%E6…` is not double-encoded.
+ * Does not touch path separators — callers encode segments only.
+ *
+ * `:` is left unencoded so route-contract / well-known templates built via
+ * `jobDetailPath(':companySlug', ':jobSlug')` stay RFC-6570-style. Real
+ * board slugs are alphanumeric-plus-hyphen; non-ASCII is still encoded.
+ */
+declare function encodePathSegment(segment: string): string;
 /** Job detail — the canonical, indexed job URL. Requires BOTH slugs. */
 declare function jobDetailPath(companySlug: string, jobSlug: string): string;
 /** Category (keyword) job listing. */
@@ -22,10 +38,81 @@ declare function jobsCategoryPath(categorySlug: string): string;
 declare function jobsSkillPath(skillSlug: string): string;
 /** Location job listing. */
 declare function jobsLocationPath(placeSlug: string): string;
+/**
+ * Location + category combination job listing
+ * (`/jobs/locations/<place>/<category>`).
+ */
+declare function jobsLocationCategoryPath(placeSlug: string, categorySlug: string): string;
+/**
+ * Location + skill combination job listing
+ * (`/jobs/locations/<place>/skills/<skill>`).
+ */
+declare function jobsLocationSkillPath(placeSlug: string, skillSlug: string): string;
 /** Company profile. */
 declare function companyPath(companySlug: string): string;
 /** Company market (sector) listing. */
 declare function companyMarketPath(marketSlug: string): string;
+/**
+ * Suggestion kinds `suggestionPath` understands. Mirrors the wire
+ * `SuggestionItem` discriminators (and `termType` for terms) without
+ * importing generated OpenAPI types into the paths entry.
+ */
+type SuggestionPathInput = {
+    type: 'company';
+    slug: string;
+} | {
+    type: 'market';
+    slug: string;
+} | {
+    type: 'post';
+    slug: string;
+} | {
+    type: 'tag';
+    slug: string;
+} | {
+    type: 'term';
+    termType: 'category' | 'skill';
+    /** Board-language URL slug — use `canonicalSlug` from the wire item. */
+    canonicalSlug: string;
+};
+/** Search scopes that own different destinations for the same suggestion. */
+type SuggestionPathScope = 'jobs' | 'companies' | 'blog';
+type SuggestionPathOptions = {
+    scope: SuggestionPathScope;
+    /**
+     * Active place slug. When set on the `jobs` scope with a category or
+     * skill term, routes into the location combination pages.
+     */
+    location?: string;
+};
+/**
+ * Resolve a suggestion to a board-relative path for the given search scope
+ * The API never returns an `href` because the same
+ * `CompanySuggestion` means "navigate to the company page" under companies
+ * scope and "apply a `companySlug` filter" under jobs scope — only the app
+ * knows which.
+ *
+ * Returns `null` when the selection is not a navigation (jobs-scope company
+ * → filter, or a kind that has no path under the active scope). Compose from
+ * the existing `*Path` helpers; never string-build at the call site.
+ *
+ * | scope | suggestion | result |
+ * | --- | --- | --- |
+ * | jobs | skill | `/jobs/skills/<slug>` |
+ * | jobs | category | `/jobs/<slug>` |
+ * | jobs | skill + location | `/jobs/locations/<loc>/skills/<slug>` |
+ * | jobs | category + location | `/jobs/locations/<loc>/<slug>` |
+ * | jobs | company | `null` (apply `companySlug` filter) |
+ * | jobs | market | `null` |
+ * | jobs | post / tag | `null` |
+ * | companies | company | `/companies/<slug>` |
+ * | companies | market | `/companies/markets/<slug>` |
+ * | companies | term / post / tag | `null` |
+ * | blog | post | `/blog/<slug>` |
+ * | blog | tag | `/blog/tag/<slug>` |
+ * | blog | other | `null` |
+ */
+declare function suggestionPath(suggestion: SuggestionPathInput, options: SuggestionPathOptions): string | null;
 /** A company's salary overview. */
 declare function companySalaryPath(companySlug: string): string;
 /** Salary page for a job title. */
@@ -90,7 +177,8 @@ declare function goAlertsConfirmPath(): string;
 /**
  * Prefix a board-relative path with the board origin. A trailing slash on
  * the origin is tolerated (stripped) so callers need not normalise first.
+ * Paths from `*Path` helpers already percent-encode dynamic segments.
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath };

package/dist/paths.d.ts

@@ -9,11 +9,27 @@
  * zero-dependency — safe to import in server runtimes, on the edge,
  * and in the browser.
  *
+ * Dynamic path segments are percent-encoded (URI, not bare IRI) so
+ * non-Latin board-language slugs (`SuggestionPathInput.canonicalSlug`)
+ * are legal in sitemap `<loc>`, canonical/`og:url`, and email links.
+ * Separators (`/`) are never encoded; already-encoded input is not
+ * double-encoded.
+ *
  * These paths mirror the hosted board's indexed URLs exactly (migration
  * parity). Do NOT change a pattern here without updating the hosted board
  * and the sitemap golden tests in lockstep — the structure is a locked
  * cross-surface contract.
  */
+/**
+ * Percent-encode one path segment for use in a URL path.
+ * Round-trips already-encoded input so `%E6…` is not double-encoded.
+ * Does not touch path separators — callers encode segments only.
+ *
+ * `:` is left unencoded so route-contract / well-known templates built via
+ * `jobDetailPath(':companySlug', ':jobSlug')` stay RFC-6570-style. Real
+ * board slugs are alphanumeric-plus-hyphen; non-ASCII is still encoded.
+ */
+declare function encodePathSegment(segment: string): string;
 /** Job detail — the canonical, indexed job URL. Requires BOTH slugs. */
 declare function jobDetailPath(companySlug: string, jobSlug: string): string;
 /** Category (keyword) job listing. */
@@ -22,10 +38,81 @@ declare function jobsCategoryPath(categorySlug: string): string;
 declare function jobsSkillPath(skillSlug: string): string;
 /** Location job listing. */
 declare function jobsLocationPath(placeSlug: string): string;
+/**
+ * Location + category combination job listing
+ * (`/jobs/locations/<place>/<category>`).
+ */
+declare function jobsLocationCategoryPath(placeSlug: string, categorySlug: string): string;
+/**
+ * Location + skill combination job listing
+ * (`/jobs/locations/<place>/skills/<skill>`).
+ */
+declare function jobsLocationSkillPath(placeSlug: string, skillSlug: string): string;
 /** Company profile. */
 declare function companyPath(companySlug: string): string;
 /** Company market (sector) listing. */
 declare function companyMarketPath(marketSlug: string): string;
+/**
+ * Suggestion kinds `suggestionPath` understands. Mirrors the wire
+ * `SuggestionItem` discriminators (and `termType` for terms) without
+ * importing generated OpenAPI types into the paths entry.
+ */
+type SuggestionPathInput = {
+    type: 'company';
+    slug: string;
+} | {
+    type: 'market';
+    slug: string;
+} | {
+    type: 'post';
+    slug: string;
+} | {
+    type: 'tag';
+    slug: string;
+} | {
+    type: 'term';
+    termType: 'category' | 'skill';
+    /** Board-language URL slug — use `canonicalSlug` from the wire item. */
+    canonicalSlug: string;
+};
+/** Search scopes that own different destinations for the same suggestion. */
+type SuggestionPathScope = 'jobs' | 'companies' | 'blog';
+type SuggestionPathOptions = {
+    scope: SuggestionPathScope;
+    /**
+     * Active place slug. When set on the `jobs` scope with a category or
+     * skill term, routes into the location combination pages.
+     */
+    location?: string;
+};
+/**
+ * Resolve a suggestion to a board-relative path for the given search scope
+ * The API never returns an `href` because the same
+ * `CompanySuggestion` means "navigate to the company page" under companies
+ * scope and "apply a `companySlug` filter" under jobs scope — only the app
+ * knows which.
+ *
+ * Returns `null` when the selection is not a navigation (jobs-scope company
+ * → filter, or a kind that has no path under the active scope). Compose from
+ * the existing `*Path` helpers; never string-build at the call site.
+ *
+ * | scope | suggestion | result |
+ * | --- | --- | --- |
+ * | jobs | skill | `/jobs/skills/<slug>` |
+ * | jobs | category | `/jobs/<slug>` |
+ * | jobs | skill + location | `/jobs/locations/<loc>/skills/<slug>` |
+ * | jobs | category + location | `/jobs/locations/<loc>/<slug>` |
+ * | jobs | company | `null` (apply `companySlug` filter) |
+ * | jobs | market | `null` |
+ * | jobs | post / tag | `null` |
+ * | companies | company | `/companies/<slug>` |
+ * | companies | market | `/companies/markets/<slug>` |
+ * | companies | term / post / tag | `null` |
+ * | blog | post | `/blog/<slug>` |
+ * | blog | tag | `/blog/tag/<slug>` |
+ * | blog | other | `null` |
+ */
+declare function suggestionPath(suggestion: SuggestionPathInput, options: SuggestionPathOptions): string | null;
 /** A company's salary overview. */
 declare function companySalaryPath(companySlug: string): string;
 /** Salary page for a job title. */
@@ -90,7 +177,8 @@ declare function goAlertsConfirmPath(): string;
 /**
  * Prefix a board-relative path with the board origin. A trailing slash on
  * the origin is tolerated (stripped) so callers need not normalise first.
+ * Paths from `*Path` helpers already percent-encode dynamic segments.
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath };

package/dist/paths.js

@@ -28,56 +28,104 @@ __export(paths_exports, {
   companyMarketPath: () => companyMarketPath,
   companyPath: () => companyPath,
   companySalaryPath: () => companySalaryPath,
+  encodePathSegment: () => encodePathSegment,
   goAlertsConfirmPath: () => goAlertsConfirmPath,
   goAlertsManagePath: () => goAlertsManagePath,
   goJobPath: () => goJobPath,
   jobDetailPath: () => jobDetailPath,
   jobsCategoryPath: () => jobsCategoryPath,
+  jobsLocationCategoryPath: () => jobsLocationCategoryPath,
   jobsLocationPath: () => jobsLocationPath,
+  jobsLocationSkillPath: () => jobsLocationSkillPath,
   jobsSkillPath: () => jobsSkillPath,
   salaryLocationPath: () => salaryLocationPath,
   salarySkillPath: () => salarySkillPath,
-  salaryTitlePath: () => salaryTitlePath
+  salaryTitlePath: () => salaryTitlePath,
+  suggestionPath: () => suggestionPath
 });
 module.exports = __toCommonJS(paths_exports);
+function encodePathSegment(segment) {
+  try {
+    return encodeURIComponent(decodeURIComponent(segment)).replace(
+      /%3A/gi,
+      ":"
+    );
+  } catch {
+    return encodeURIComponent(segment).replace(/%3A/gi, ":");
+  }
+}
 function jobDetailPath(companySlug, jobSlug) {
-  return `/companies/${companySlug}/jobs/${jobSlug}`;
+  return `/companies/${encodePathSegment(companySlug)}/jobs/${encodePathSegment(jobSlug)}`;
 }
 function jobsCategoryPath(categorySlug) {
-  return `/jobs/${categorySlug}`;
+  return `/jobs/${encodePathSegment(categorySlug)}`;
 }
 function jobsSkillPath(skillSlug) {
-  return `/jobs/skills/${skillSlug}`;
+  return `/jobs/skills/${encodePathSegment(skillSlug)}`;
 }
 function jobsLocationPath(placeSlug) {
-  return `/jobs/locations/${placeSlug}`;
+  return `/jobs/locations/${encodePathSegment(placeSlug)}`;
+}
+function jobsLocationCategoryPath(placeSlug, categorySlug) {
+  return `${jobsLocationPath(placeSlug)}/${encodePathSegment(categorySlug)}`;
+}
+function jobsLocationSkillPath(placeSlug, skillSlug) {
+  return `${jobsLocationPath(placeSlug)}/skills/${encodePathSegment(skillSlug)}`;
 }
 function companyPath(companySlug) {
-  return `/companies/${companySlug}`;
+  return `/companies/${encodePathSegment(companySlug)}`;
 }
 function companyMarketPath(marketSlug) {
-  return `/companies/markets/${marketSlug}`;
+  return `/companies/markets/${encodePathSegment(marketSlug)}`;
+}
+function suggestionPath(suggestion, options) {
+  const location = options.location?.trim() || void 0;
+  if (options.scope === "blog") {
+    if (suggestion.type === "post") {
+      return blogPostPath(suggestion.slug);
+    }
+    if (suggestion.type === "tag") {
+      return blogTagPath(suggestion.slug);
+    }
+    return null;
+  }
+  if (options.scope === "jobs") {
+    if (suggestion.type === "company" || suggestion.type === "market" || suggestion.type === "post" || suggestion.type === "tag") {
+      return null;
+    }
+    if (suggestion.termType === "skill") {
+      return location ? jobsLocationSkillPath(location, suggestion.canonicalSlug) : jobsSkillPath(suggestion.canonicalSlug);
+    }
+    return location ? jobsLocationCategoryPath(location, suggestion.canonicalSlug) : jobsCategoryPath(suggestion.canonicalSlug);
+  }
+  if (suggestion.type === "company") {
+    return companyPath(suggestion.slug);
+  }
+  if (suggestion.type === "market") {
+    return companyMarketPath(suggestion.slug);
+  }
+  return null;
 }
 function companySalaryPath(companySlug) {
-  return `/companies/${companySlug}/salaries`;
+  return `/companies/${encodePathSegment(companySlug)}/salaries`;
 }
 function salaryTitlePath(titleSlug) {
-  return `/salaries/titles/${titleSlug}`;
+  return `/salaries/titles/${encodePathSegment(titleSlug)}`;
 }
 function salarySkillPath(skillSlug) {
-  return `/salaries/skills/${skillSlug}`;
+  return `/salaries/skills/${encodePathSegment(skillSlug)}`;
 }
 function salaryLocationPath(placeSlug) {
-  return `/salaries/locations/${placeSlug}`;
+  return `/salaries/locations/${encodePathSegment(placeSlug)}`;
 }
 function blogPostPath(postSlug) {
-  return `/blog/${postSlug}`;
+  return `/blog/${encodePathSegment(postSlug)}`;
 }
 function blogTagPath(tagSlug) {
-  return `/blog/tag/${tagSlug}`;
+  return `/blog/tag/${encodePathSegment(tagSlug)}`;
 }
 function blogAuthorPath(authorSlug) {
-  return `/blog/author/${authorSlug}`;
+  return `/blog/author/${encodePathSegment(authorSlug)}`;
 }
 var BOARD_PATHS = {
   home: "/",