@cavuno/board 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -1,3 +1,244 @@
+/**
+ * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
+ * server MAY add top-level fields; consumers MUST ignore unknown
+ * fields.
+ */
+/**
+ * Medusa-style storefront pagination fields (ADR-0037 §7), populated only by
+ * the board jobs catalog reads (browse / search / company-jobs); absent on
+ * every other list/search. `nextCursor` is preserved alongside (offset-encoded).
+ */
+interface StorefrontPagination {
+    /** Total matching results ("X jobs"). */
+    count?: number;
+    /** The page size used for this response. */
+    limit?: number;
+    /** Number of items skipped before this page. */
+    offset?: number;
+    /** Items hidden behind the candidate paywall for the current viewer; absent/0 when entitled. */
+    gatedCount?: number;
+}
+interface ListEnvelope<T> extends StorefrontPagination {
+    object: 'list';
+    url: string;
+    hasMore: boolean;
+    /** `null` when `hasMore` is false — always present, never undefined. */
+    nextCursor: string | null;
+    data: T[];
+}
+interface SearchEnvelope<T> extends StorefrontPagination {
+    object: 'search_result';
+    url: string;
+    hasMore: boolean;
+    nextCursor: string | null;
+    data: T[];
+}
+
+type RemoteOption = 'on_site' | 'hybrid' | 'remote';
+type EmploymentType = 'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary' | 'volunteer' | 'other';
+type Seniority = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
+type EducationRequirement = 'high_school' | 'associate_degree' | 'bachelor_degree' | 'professional_certificate' | 'postgraduate_degree' | 'no_requirements';
+interface OfficeLocation {
+    countryCode: string | null;
+    country: string | null;
+    locality: string | null;
+    city: string | null;
+    region: string | null;
+    regionCode: string | null;
+    postalCode: string | null;
+    displayName: string | null;
+}
+interface JobCompany {
+    id: string;
+    name: string | null;
+    slug: string | null;
+    logoUrl: string | null;
+    website: string | null;
+}
+interface RemotePermit {
+    type: string;
+    value: string;
+}
+interface RemoteTimezone {
+    type: string;
+    value: string;
+    plusMinus?: number;
+}
+interface PublicJob {
+    id: string;
+    object: 'public_job';
+    title: string;
+    slug: string | null;
+    status: string;
+    companyId: string | null;
+    employmentType: string | null;
+    remoteOption: string | null;
+    seniority: string | null;
+    salaryMin: number | null;
+    salaryMax: number | null;
+    salaryCurrency: string | null;
+    salaryTimeframe: string | null;
+    isFeatured: boolean;
+    publishedAt: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    description: string | null;
+    applicationUrl: string | null;
+    /** Canonical hierarchical permit selection. */
+    remotePermits: RemotePermit[];
+    /** Read-only — derived from `remotePermits`. */
+    remoteWorldwide: boolean | null;
+    /** Canonical hierarchical timezone selection. */
+    remoteTimezones: RemoteTimezone[];
+    /** Read-only — derived from `remoteTimezones`. */
+    remoteAllowedTzOffsets: number[];
+    /** Read-only — derived from `remotePermits`. */
+    remoteWorkPermitCountryCodes: string[];
+    /** Read-only — derived from `remotePermits`. */
+    remoteWorkPermitSubdivisionCodes: string[];
+    remoteSponsorship: 'yes' | 'no' | 'unknown';
+    educationRequirements: EducationRequirement[];
+    experienceMonths: number | null;
+    experienceInPlaceOfEducation: boolean | null;
+    inOfficePeriod: 'per_week' | 'per_month' | 'per_year' | null;
+    inOfficeFrequency: number | null;
+    company: JobCompany | null;
+    officeLocations: OfficeLocation[];
+    /** Resolved taxonomy — same `{slug,name}` shape as `PublicJobCard`; names joined server-side. */
+    categories: Array<{
+        slug: string;
+        name: string;
+    }>;
+    skills: Array<{
+        slug: string;
+        name: string;
+    }>;
+    /**
+     * Place ancestor chain (country → region → city) for the breadcrumb. Each
+     * `slug` is the English SOURCE slug — the key `taxonomy.places.resolve()`
+     * accepts. On a localized board it may differ from the canonical
+     * board-language URL slug (the board router 308-redirects the source slug to
+     * the canonical one); link via `/jobs/locations/:slug`.
+     */
+    placeHierarchy: Array<{
+        slug: string;
+        name: string;
+    }>;
+    links: {
+        public: string | null;
+    };
+}
+/**
+ * The slim listing card (ADR-0037 §1) returned by `jobs.list` / `jobs.search`
+ * / `companies.listJobs`. Full enrichment (description, officeLocations, the
+ * structured remote blocks, …) lives on `jobs.retrieve` (`PublicJob`).
+ * Transcribed from `serializeJobCard`.
+ */
+interface PublicJobCard {
+    id: string;
+    object: 'job_card';
+    slug: string;
+    title: string;
+    publishedAt: string | null;
+    employmentType: string | null;
+    remoteOption: string | null;
+    /** Remote-region label for remote jobs (e.g. "Worldwide"); `null` otherwise. */
+    remoteLocationLabel: string | null;
+    salaryMin: number | null;
+    salaryMax: number | null;
+    salaryCurrency: string | null;
+    salaryTimeframe: string | null;
+    isFeatured: boolean;
+    locationLabel: string | null;
+    company: {
+        slug: string;
+        name: string;
+        logoUrl: string | null;
+    } | null;
+    categories: Array<{
+        slug: string;
+        name: string;
+    }>;
+    skills: Array<{
+        slug: string;
+        name: string;
+    }>;
+    links: {
+        public: string | null;
+    };
+    /**
+     * Long-form description (HTML), or `null`. Present ONLY when the list/search
+     * was called with `fields: '+description'` (the RSS feed's sparse-fieldset
+     * opt-in); `undefined`/absent on the default slim card.
+     */
+    description?: string | null;
+}
+/** Derived category/skill suggestion on the jobs browse list (ADR-0037 §8). */
+interface RelatedSearch {
+    type: 'category' | 'skill';
+    slug: string;
+    term: string;
+    count: number;
+}
+/** The browse list envelope — `PublicJobCard`s + storefront fields + `relatedSearches`. */
+interface JobCardListEnvelope extends ListEnvelope<PublicJobCard> {
+    relatedSearches?: RelatedSearch[];
+}
+/** The search envelope — `PublicJobCard`s + storefront fields. */
+type JobCardSearchEnvelope = SearchEnvelope<PublicJobCard>;
+type JobsListQuery = {
+    cursor?: string;
+    /** 1–100. */
+    limit?: number;
+    /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
+    offset?: number;
+    /** Single or repeated (up to 10) — repeated params are OR-matched. */
+    companyId?: string | string[];
+    remoteOption?: RemoteOption | RemoteOption[];
+    employmentType?: EmploymentType | EmploymentType[];
+    seniority?: Seniority | Seniority[];
+    /** Place slug for a geo radius search; unresolvable slugs are ignored. */
+    location?: string;
+    /** Radius in km around `location` (10–250; default 50). */
+    radius?: number;
+    /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
+    category?: string;
+    /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
+    skill?: string;
+    /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
+    fields?: string;
+};
+type JobsSimilarQuery = {
+    /** How many similar jobs to return (1–20; default 5). */
+    limit?: number;
+};
+interface JobsSearchBody {
+    /** Free-text query, up to 200 characters. */
+    query?: string;
+    filters?: {
+        /** Up to 10 values each. */
+        companyId?: string[];
+        remoteOption?: RemoteOption[];
+        employmentType?: EmploymentType[];
+        seniority?: Seniority[];
+        /** ISO 8601 datetime bounds. */
+        publishedAt?: {
+            gte?: string;
+            lte?: string;
+        };
+        /** Place slug for a geo radius search. */
+        location?: string;
+        /** Radius in km around `location` (10–250; default 50). */
+        radius?: number;
+    };
+    cursor?: string;
+    /** 1–100. */
+    limit?: number;
+    /** Storefront page offset; takes precedence over `cursor`. */
+    offset?: number;
+}
+
 type Awaitable<T> = T | Promise<T>;
 /**
  * Async token storage. The SDK reads the access token from storage on
@@ -104,6 +345,27 @@ interface PublicBoard {
     theme: PublicBoardTheme | null;
 }
 
+/**
+ * The public SEO-infra payload (`board.seo()`). The four values a headless
+ * frontend rebuilds `robots.txt` / `ads.txt` / `indexnow-key.txt` (+ the Google
+ * site-verification `<meta>`) from — byte-identically to the hosted board.
+ */
+interface BoardSeo {
+    object: 'board_seo';
+    /** Verbatim `ads.txt` content, or `null` when not configured (the handler 404s). */
+    adsTxt: string | null;
+    /** IndexNow key-file content, or `null` when not configured (the handler 404s). */
+    indexNowKey: string | null;
+    /** Google site-verification token for the `<meta>` tag, or `null`. */
+    googleSiteVerification: string | null;
+    /**
+     * The board's canonical base URL (honours a configured custom domain). Build
+     * the `robots.txt` `Sitemap:` line (`${canonicalBase}/sitemap.xml`) and
+     * canonical links from it — NOT the request origin.
+     */
+    canonicalBase: string;
+}
+
 /**
  * Error raised for every non-2xx Board API response.
  *
@@ -151,7 +413,7 @@ declare function isConflict(e: unknown): e is BoardApiError;
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.2.0";
 
 interface BoardUser {
     id: string;
@@ -202,6 +464,19 @@ interface ResetPasswordBody {
     password: string;
 }
 
+/**
+ * The result of resolving a path against the board's configured redirects
+ * (`board.redirects.resolve()`). A headless frontend 308s to `target`, or 404s
+ * when it's `null`.
+ */
+interface RedirectResolution {
+    object: 'redirect_resolution';
+    /** The path that was resolved. */
+    path: string;
+    /** The redirect target (board-relative), or `null` when no redirect matches. */
+    target: string | null;
+}
+
 /** Author shape embedded on posts (no `object` discriminator). */
 interface BlogAuthorEmbed {
     id: string;
@@ -268,27 +543,6 @@ interface BlogSearchBody {
     limit?: number;
 }
 
-/**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
- */
-interface ListEnvelope<T> {
-    object: 'list';
-    url: string;
-    hasMore: boolean;
-    /** `null` when `hasMore` is false — always present, never undefined. */
-    nextCursor: string | null;
-    data: T[];
-}
-interface SearchEnvelope<T> {
-    object: 'search_result';
-    url: string;
-    hasMore: boolean;
-    nextCursor: string | null;
-    data: T[];
-}
-
 interface PublicCompany {
     id: string;
     object: 'public_company';
@@ -321,110 +575,6 @@ interface CompaniesSearchBody {
     limit?: number;
 }
 
-type RemoteOption = 'on_site' | 'hybrid' | 'remote';
-type EmploymentType = 'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary' | 'volunteer' | 'other';
-type Seniority = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
-type EducationRequirement = 'high_school' | 'associate_degree' | 'bachelor_degree' | 'professional_certificate' | 'postgraduate_degree' | 'no_requirements';
-interface OfficeLocation {
-    countryCode: string | null;
-    country: string | null;
-    locality: string | null;
-    city: string | null;
-    region: string | null;
-    regionCode: string | null;
-    postalCode: string | null;
-    displayName: string | null;
-}
-interface JobCompany {
-    id: string;
-    name: string | null;
-    slug: string | null;
-    logoUrl: string | null;
-    website: string | null;
-}
-interface RemotePermit {
-    type: string;
-    value: string;
-}
-interface RemoteTimezone {
-    type: string;
-    value: string;
-    plusMinus?: number;
-}
-interface PublicJob {
-    id: string;
-    object: 'public_job';
-    title: string;
-    slug: string | null;
-    status: string;
-    companyId: string | null;
-    employmentType: string | null;
-    remoteOption: string | null;
-    seniority: string | null;
-    salaryMin: number | null;
-    salaryMax: number | null;
-    salaryCurrency: string | null;
-    salaryTimeframe: string | null;
-    isFeatured: boolean;
-    publishedAt: string | null;
-    expiresAt: string | null;
-    createdAt: string;
-    updatedAt: string;
-    description: string | null;
-    applicationUrl: string | null;
-    /** Canonical hierarchical permit selection. */
-    remotePermits: RemotePermit[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorldwide: boolean | null;
-    /** Canonical hierarchical timezone selection. */
-    remoteTimezones: RemoteTimezone[];
-    /** Read-only — derived from `remoteTimezones`. */
-    remoteAllowedTzOffsets: number[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorkPermitCountryCodes: string[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorkPermitSubdivisionCodes: string[];
-    remoteSponsorship: 'yes' | 'no' | 'unknown';
-    educationRequirements: EducationRequirement[];
-    experienceMonths: number | null;
-    experienceInPlaceOfEducation: boolean | null;
-    inOfficePeriod: 'per_week' | 'per_month' | 'per_year' | null;
-    inOfficeFrequency: number | null;
-    company: JobCompany | null;
-    officeLocations: OfficeLocation[];
-    links: {
-        public: string | null;
-    };
-}
-type JobsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    companyId?: string;
-    remoteOption?: RemoteOption;
-    employmentType?: EmploymentType;
-    seniority?: Seniority;
-};
-interface JobsSearchBody {
-    /** Free-text query, up to 200 characters. */
-    query?: string;
-    filters?: {
-        /** Up to 10 values each. */
-        companyId?: string[];
-        remoteOption?: RemoteOption[];
-        employmentType?: EmploymentType[];
-        seniority?: Seniority[];
-        /** ISO 8601 datetime bounds. */
-        publishedAt?: {
-            gte?: string;
-            lte?: string;
-        };
-    };
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-}
-
 /**
  * The embedded `job` is the SAME `public_job` shape the anonymous jobs
  * list emits — saved rows and search rows render with one component.
@@ -446,6 +596,53 @@ interface SaveJobBody {
     jobId: string;
 }
 
+interface TaxonomyGeo {
+    lat: number | null;
+    lng: number | null;
+    countryCode: string | null;
+    regionCode: string | null;
+    region: string | null;
+    city: string | null;
+    locality: string | null;
+    placeType: string | null;
+}
+/**
+ * Page-meta for a resolved taxonomy slug. `sourceSlug` is the immutable
+ * English search key; `canonicalSlug` is the board-language URL; `redirectTo`
+ * is the canonical slug to 308 to when the inbound slug isn't canonical (the
+ * host app emits the redirect — the SDK never navigates). `geo` is set for
+ * place resolutions only.
+ */
+interface TaxonomyResolution {
+    object: 'taxonomy_resolution';
+    type: 'category' | 'skill' | 'place';
+    sourceSlug: string;
+    canonicalSlug: string;
+    displayName: string;
+    redirectTo: string | null;
+    geo: TaxonomyGeo | null;
+}
+/**
+ * A place in the board's locations directory (`taxonomy.places.list()` →
+ * `GET /places`), the data the `/jobs/locations/` index renders. `jobCount` is
+ * subtree-summed (a parent counts its descendants); `id`/`parentId` carry the
+ * hierarchy so consumers rebuild the same nested tree the hosted index shows.
+ */
+interface PublicPlace {
+    object: 'place';
+    /** Stable place identity (locations-tree edge endpoint). */
+    id: string;
+    /** Parent place's `id`; `null` for a root place. */
+    parentId: string | null;
+    /** Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
+    slug: string | null;
+    name: string;
+    placeType: string;
+    countryCode: string | null;
+    regionCode: string | null;
+    jobCount: number;
+}
+
 interface CreateBoardClientOptions {
     baseUrl: string;
     /** Board identifier: `pk_…` key (provisioned default) | `boards_…` ID | slug. */
@@ -489,16 +686,26 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
      * const { name, theme } = await board.context();
      */
     context(options?: FetchOptions): Promise<PublicBoard>;
+    /**
+     * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
+     * the canonical base URL. Rebuild `robots.txt` / `ads.txt` /
+     * `indexnow-key.txt` from it.
+     *
+     * @example
+     * const { adsTxt, canonicalBase } = await board.seo();
+     */
+    seo(options?: FetchOptions): Promise<BoardSeo>;
     jobs: {
-        list(query?: JobsListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJob>>;
+        list(query?: JobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
         retrieve(jobSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicJob>;
-        search(body: JobsSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<PublicJob>>;
+        search(body: JobsSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<JobCardSearchEnvelope>;
+        similar(jobSlug: string, query?: JobsSimilarQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJobCard>>;
     };
     companies: {
         list(query?: CompaniesListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicCompany>>;
         retrieve(companySlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicCompany>;
         search(body: CompaniesSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<PublicCompany>>;
-        listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJob>>;
+        listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
     };
     blog: {
         posts: {
@@ -532,7 +739,22 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             unsave(jobId: string, query?: Record<string, never>, options?: FetchOptions): Promise<void>;
         };
     };
+    taxonomy: {
+        categories: {
+            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+        };
+        skills: {
+            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+        };
+        places: {
+            list(options?: FetchOptions): Promise<ListEnvelope<PublicPlace>>;
+            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+        };
+    };
+    redirects: {
+        resolve(path: string, options?: FetchOptions): Promise<RedirectResolution>;
+    };
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { ACCESS_TOKEN_KEY, type Awaitable, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogTagEmbed, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardUser, type CompaniesListQuery, type CompaniesSearchBody, type CompanyJobsListQuery, type CreateBoardClientOptions, type CustomStorage, type EducationRequirement, type EmploymentType, type FetchOptions, type ForgotPasswordBody, type JobCompany, type JobsListQuery, type JobsSearchBody, type ListEnvelope, type Logger, type LoginBody, type LogoutBody, type OfficeLocation, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicJob, REFRESH_TOKEN_KEY, type RefreshBody, type RegisterBody, type RemoteOption, type RemotePermit, type RemoteTimezone, type ResetPasswordBody, SDK_VERSION, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type Seniority, type StorageMode, type VerifyEmailBody, createBoardClient, isBoardApiError, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };
+export { ACCESS_TOKEN_KEY, type Awaitable, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogTagEmbed, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type CompaniesListQuery, type CompaniesSearchBody, type CompanyJobsListQuery, type CreateBoardClientOptions, type CustomStorage, type EducationRequirement, type EmploymentType, type FetchOptions, type ForgotPasswordBody, type JobCardListEnvelope, type JobCardSearchEnvelope, type JobCompany, type JobsListQuery, type JobsSearchBody, type ListEnvelope, type Logger, type LoginBody, type LogoutBody, type OfficeLocation, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicJob, type PublicJobCard, type PublicPlace, REFRESH_TOKEN_KEY, type RedirectResolution, type RefreshBody, type RegisterBody, type RelatedSearch, type RemoteOption, type RemotePermit, type RemoteTimezone, type ResetPasswordBody, SDK_VERSION, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type Seniority, type StorageMode, type StorefrontPagination, type TaxonomyGeo, type TaxonomyResolution, type VerifyEmailBody, createBoardClient, isBoardApiError, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };

package/dist/index.d.ts

@@ -1,3 +1,244 @@
+/**
+ * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
+ * server MAY add top-level fields; consumers MUST ignore unknown
+ * fields.
+ */
+/**
+ * Medusa-style storefront pagination fields (ADR-0037 §7), populated only by
+ * the board jobs catalog reads (browse / search / company-jobs); absent on
+ * every other list/search. `nextCursor` is preserved alongside (offset-encoded).
+ */
+interface StorefrontPagination {
+    /** Total matching results ("X jobs"). */
+    count?: number;
+    /** The page size used for this response. */
+    limit?: number;
+    /** Number of items skipped before this page. */
+    offset?: number;
+    /** Items hidden behind the candidate paywall for the current viewer; absent/0 when entitled. */
+    gatedCount?: number;
+}
+interface ListEnvelope<T> extends StorefrontPagination {
+    object: 'list';
+    url: string;
+    hasMore: boolean;
+    /** `null` when `hasMore` is false — always present, never undefined. */
+    nextCursor: string | null;
+    data: T[];
+}
+interface SearchEnvelope<T> extends StorefrontPagination {
+    object: 'search_result';
+    url: string;
+    hasMore: boolean;
+    nextCursor: string | null;
+    data: T[];
+}
+
+type RemoteOption = 'on_site' | 'hybrid' | 'remote';
+type EmploymentType = 'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary' | 'volunteer' | 'other';
+type Seniority = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
+type EducationRequirement = 'high_school' | 'associate_degree' | 'bachelor_degree' | 'professional_certificate' | 'postgraduate_degree' | 'no_requirements';
+interface OfficeLocation {
+    countryCode: string | null;
+    country: string | null;
+    locality: string | null;
+    city: string | null;
+    region: string | null;
+    regionCode: string | null;
+    postalCode: string | null;
+    displayName: string | null;
+}
+interface JobCompany {
+    id: string;
+    name: string | null;
+    slug: string | null;
+    logoUrl: string | null;
+    website: string | null;
+}
+interface RemotePermit {
+    type: string;
+    value: string;
+}
+interface RemoteTimezone {
+    type: string;
+    value: string;
+    plusMinus?: number;
+}
+interface PublicJob {
+    id: string;
+    object: 'public_job';
+    title: string;
+    slug: string | null;
+    status: string;
+    companyId: string | null;
+    employmentType: string | null;
+    remoteOption: string | null;
+    seniority: string | null;
+    salaryMin: number | null;
+    salaryMax: number | null;
+    salaryCurrency: string | null;
+    salaryTimeframe: string | null;
+    isFeatured: boolean;
+    publishedAt: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    description: string | null;
+    applicationUrl: string | null;
+    /** Canonical hierarchical permit selection. */
+    remotePermits: RemotePermit[];
+    /** Read-only — derived from `remotePermits`. */
+    remoteWorldwide: boolean | null;
+    /** Canonical hierarchical timezone selection. */
+    remoteTimezones: RemoteTimezone[];
+    /** Read-only — derived from `remoteTimezones`. */
+    remoteAllowedTzOffsets: number[];
+    /** Read-only — derived from `remotePermits`. */
+    remoteWorkPermitCountryCodes: string[];
+    /** Read-only — derived from `remotePermits`. */
+    remoteWorkPermitSubdivisionCodes: string[];
+    remoteSponsorship: 'yes' | 'no' | 'unknown';
+    educationRequirements: EducationRequirement[];
+    experienceMonths: number | null;
+    experienceInPlaceOfEducation: boolean | null;
+    inOfficePeriod: 'per_week' | 'per_month' | 'per_year' | null;
+    inOfficeFrequency: number | null;
+    company: JobCompany | null;
+    officeLocations: OfficeLocation[];
+    /** Resolved taxonomy — same `{slug,name}` shape as `PublicJobCard`; names joined server-side. */
+    categories: Array<{
+        slug: string;
+        name: string;
+    }>;
+    skills: Array<{
+        slug: string;
+        name: string;
+    }>;
+    /**
+     * Place ancestor chain (country → region → city) for the breadcrumb. Each
+     * `slug` is the English SOURCE slug — the key `taxonomy.places.resolve()`
+     * accepts. On a localized board it may differ from the canonical
+     * board-language URL slug (the board router 308-redirects the source slug to
+     * the canonical one); link via `/jobs/locations/:slug`.
+     */
+    placeHierarchy: Array<{
+        slug: string;
+        name: string;
+    }>;
+    links: {
+        public: string | null;
+    };
+}
+/**
+ * The slim listing card (ADR-0037 §1) returned by `jobs.list` / `jobs.search`
+ * / `companies.listJobs`. Full enrichment (description, officeLocations, the
+ * structured remote blocks, …) lives on `jobs.retrieve` (`PublicJob`).
+ * Transcribed from `serializeJobCard`.
+ */
+interface PublicJobCard {
+    id: string;
+    object: 'job_card';
+    slug: string;
+    title: string;
+    publishedAt: string | null;
+    employmentType: string | null;
+    remoteOption: string | null;
+    /** Remote-region label for remote jobs (e.g. "Worldwide"); `null` otherwise. */
+    remoteLocationLabel: string | null;
+    salaryMin: number | null;
+    salaryMax: number | null;
+    salaryCurrency: string | null;
+    salaryTimeframe: string | null;
+    isFeatured: boolean;
+    locationLabel: string | null;
+    company: {
+        slug: string;
+        name: string;
+        logoUrl: string | null;
+    } | null;
+    categories: Array<{
+        slug: string;
+        name: string;
+    }>;
+    skills: Array<{
+        slug: string;
+        name: string;
+    }>;
+    links: {
+        public: string | null;
+    };
+    /**
+     * Long-form description (HTML), or `null`. Present ONLY when the list/search
+     * was called with `fields: '+description'` (the RSS feed's sparse-fieldset
+     * opt-in); `undefined`/absent on the default slim card.
+     */
+    description?: string | null;
+}
+/** Derived category/skill suggestion on the jobs browse list (ADR-0037 §8). */
+interface RelatedSearch {
+    type: 'category' | 'skill';
+    slug: string;
+    term: string;
+    count: number;
+}
+/** The browse list envelope — `PublicJobCard`s + storefront fields + `relatedSearches`. */
+interface JobCardListEnvelope extends ListEnvelope<PublicJobCard> {
+    relatedSearches?: RelatedSearch[];
+}
+/** The search envelope — `PublicJobCard`s + storefront fields. */
+type JobCardSearchEnvelope = SearchEnvelope<PublicJobCard>;
+type JobsListQuery = {
+    cursor?: string;
+    /** 1–100. */
+    limit?: number;
+    /** Storefront page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
+    offset?: number;
+    /** Single or repeated (up to 10) — repeated params are OR-matched. */
+    companyId?: string | string[];
+    remoteOption?: RemoteOption | RemoteOption[];
+    employmentType?: EmploymentType | EmploymentType[];
+    seniority?: Seniority | Seniority[];
+    /** Place slug for a geo radius search; unresolvable slugs are ignored. */
+    location?: string;
+    /** Radius in km around `location` (10–250; default 50). */
+    radius?: number;
+    /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
+    category?: string;
+    /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
+    skill?: string;
+    /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
+    fields?: string;
+};
+type JobsSimilarQuery = {
+    /** How many similar jobs to return (1–20; default 5). */
+    limit?: number;
+};
+interface JobsSearchBody {
+    /** Free-text query, up to 200 characters. */
+    query?: string;
+    filters?: {
+        /** Up to 10 values each. */
+        companyId?: string[];
+        remoteOption?: RemoteOption[];
+        employmentType?: EmploymentType[];
+        seniority?: Seniority[];
+        /** ISO 8601 datetime bounds. */
+        publishedAt?: {
+            gte?: string;
+            lte?: string;
+        };
+        /** Place slug for a geo radius search. */
+        location?: string;
+        /** Radius in km around `location` (10–250; default 50). */
+        radius?: number;
+    };
+    cursor?: string;
+    /** 1–100. */
+    limit?: number;
+    /** Storefront page offset; takes precedence over `cursor`. */
+    offset?: number;
+}
+
 type Awaitable<T> = T | Promise<T>;
 /**
  * Async token storage. The SDK reads the access token from storage on
@@ -104,6 +345,27 @@ interface PublicBoard {
     theme: PublicBoardTheme | null;
 }
 
+/**
+ * The public SEO-infra payload (`board.seo()`). The four values a headless
+ * frontend rebuilds `robots.txt` / `ads.txt` / `indexnow-key.txt` (+ the Google
+ * site-verification `<meta>`) from — byte-identically to the hosted board.
+ */
+interface BoardSeo {
+    object: 'board_seo';
+    /** Verbatim `ads.txt` content, or `null` when not configured (the handler 404s). */
+    adsTxt: string | null;
+    /** IndexNow key-file content, or `null` when not configured (the handler 404s). */
+    indexNowKey: string | null;
+    /** Google site-verification token for the `<meta>` tag, or `null`. */
+    googleSiteVerification: string | null;
+    /**
+     * The board's canonical base URL (honours a configured custom domain). Build
+     * the `robots.txt` `Sitemap:` line (`${canonicalBase}/sitemap.xml`) and
+     * canonical links from it — NOT the request origin.
+     */
+    canonicalBase: string;
+}
+
 /**
  * Error raised for every non-2xx Board API response.
  *
@@ -151,7 +413,7 @@ declare function isConflict(e: unknown): e is BoardApiError;
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.2.0";
 
 interface BoardUser {
     id: string;
@@ -202,6 +464,19 @@ interface ResetPasswordBody {
     password: string;
 }
 
+/**
+ * The result of resolving a path against the board's configured redirects
+ * (`board.redirects.resolve()`). A headless frontend 308s to `target`, or 404s
+ * when it's `null`.
+ */
+interface RedirectResolution {
+    object: 'redirect_resolution';
+    /** The path that was resolved. */
+    path: string;
+    /** The redirect target (board-relative), or `null` when no redirect matches. */
+    target: string | null;
+}
+
 /** Author shape embedded on posts (no `object` discriminator). */
 interface BlogAuthorEmbed {
     id: string;
@@ -268,27 +543,6 @@ interface BlogSearchBody {
     limit?: number;
 }
 
-/**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
- */
-interface ListEnvelope<T> {
-    object: 'list';
-    url: string;
-    hasMore: boolean;
-    /** `null` when `hasMore` is false — always present, never undefined. */
-    nextCursor: string | null;
-    data: T[];
-}
-interface SearchEnvelope<T> {
-    object: 'search_result';
-    url: string;
-    hasMore: boolean;
-    nextCursor: string | null;
-    data: T[];
-}
-
 interface PublicCompany {
     id: string;
     object: 'public_company';
@@ -321,110 +575,6 @@ interface CompaniesSearchBody {
     limit?: number;
 }
 
-type RemoteOption = 'on_site' | 'hybrid' | 'remote';
-type EmploymentType = 'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary' | 'volunteer' | 'other';
-type Seniority = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
-type EducationRequirement = 'high_school' | 'associate_degree' | 'bachelor_degree' | 'professional_certificate' | 'postgraduate_degree' | 'no_requirements';
-interface OfficeLocation {
-    countryCode: string | null;
-    country: string | null;
-    locality: string | null;
-    city: string | null;
-    region: string | null;
-    regionCode: string | null;
-    postalCode: string | null;
-    displayName: string | null;
-}
-interface JobCompany {
-    id: string;
-    name: string | null;
-    slug: string | null;
-    logoUrl: string | null;
-    website: string | null;
-}
-interface RemotePermit {
-    type: string;
-    value: string;
-}
-interface RemoteTimezone {
-    type: string;
-    value: string;
-    plusMinus?: number;
-}
-interface PublicJob {
-    id: string;
-    object: 'public_job';
-    title: string;
-    slug: string | null;
-    status: string;
-    companyId: string | null;
-    employmentType: string | null;
-    remoteOption: string | null;
-    seniority: string | null;
-    salaryMin: number | null;
-    salaryMax: number | null;
-    salaryCurrency: string | null;
-    salaryTimeframe: string | null;
-    isFeatured: boolean;
-    publishedAt: string | null;
-    expiresAt: string | null;
-    createdAt: string;
-    updatedAt: string;
-    description: string | null;
-    applicationUrl: string | null;
-    /** Canonical hierarchical permit selection. */
-    remotePermits: RemotePermit[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorldwide: boolean | null;
-    /** Canonical hierarchical timezone selection. */
-    remoteTimezones: RemoteTimezone[];
-    /** Read-only — derived from `remoteTimezones`. */
-    remoteAllowedTzOffsets: number[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorkPermitCountryCodes: string[];
-    /** Read-only — derived from `remotePermits`. */
-    remoteWorkPermitSubdivisionCodes: string[];
-    remoteSponsorship: 'yes' | 'no' | 'unknown';
-    educationRequirements: EducationRequirement[];
-    experienceMonths: number | null;
-    experienceInPlaceOfEducation: boolean | null;
-    inOfficePeriod: 'per_week' | 'per_month' | 'per_year' | null;
-    inOfficeFrequency: number | null;
-    company: JobCompany | null;
-    officeLocations: OfficeLocation[];
-    links: {
-        public: string | null;
-    };
-}
-type JobsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    companyId?: string;
-    remoteOption?: RemoteOption;
-    employmentType?: EmploymentType;
-    seniority?: Seniority;
-};
-interface JobsSearchBody {
-    /** Free-text query, up to 200 characters. */
-    query?: string;
-    filters?: {
-        /** Up to 10 values each. */
-        companyId?: string[];
-        remoteOption?: RemoteOption[];
-        employmentType?: EmploymentType[];
-        seniority?: Seniority[];
-        /** ISO 8601 datetime bounds. */
-        publishedAt?: {
-            gte?: string;
-            lte?: string;
-        };
-    };
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-}
-
 /**
  * The embedded `job` is the SAME `public_job` shape the anonymous jobs
  * list emits — saved rows and search rows render with one component.
@@ -446,6 +596,53 @@ interface SaveJobBody {
     jobId: string;
 }
 
+interface TaxonomyGeo {
+    lat: number | null;
+    lng: number | null;
+    countryCode: string | null;
+    regionCode: string | null;
+    region: string | null;
+    city: string | null;
+    locality: string | null;
+    placeType: string | null;
+}
+/**
+ * Page-meta for a resolved taxonomy slug. `sourceSlug` is the immutable
+ * English search key; `canonicalSlug` is the board-language URL; `redirectTo`
+ * is the canonical slug to 308 to when the inbound slug isn't canonical (the
+ * host app emits the redirect — the SDK never navigates). `geo` is set for
+ * place resolutions only.
+ */
+interface TaxonomyResolution {
+    object: 'taxonomy_resolution';
+    type: 'category' | 'skill' | 'place';
+    sourceSlug: string;
+    canonicalSlug: string;
+    displayName: string;
+    redirectTo: string | null;
+    geo: TaxonomyGeo | null;
+}
+/**
+ * A place in the board's locations directory (`taxonomy.places.list()` →
+ * `GET /places`), the data the `/jobs/locations/` index renders. `jobCount` is
+ * subtree-summed (a parent counts its descendants); `id`/`parentId` carry the
+ * hierarchy so consumers rebuild the same nested tree the hosted index shows.
+ */
+interface PublicPlace {
+    object: 'place';
+    /** Stable place identity (locations-tree edge endpoint). */
+    id: string;
+    /** Parent place's `id`; `null` for a root place. */
+    parentId: string | null;
+    /** Public slug (links to `/jobs/locations/:slug`); `null` if unslugged. */
+    slug: string | null;
+    name: string;
+    placeType: string;
+    countryCode: string | null;
+    regionCode: string | null;
+    jobCount: number;
+}
+
 interface CreateBoardClientOptions {
     baseUrl: string;
     /** Board identifier: `pk_…` key (provisioned default) | `boards_…` ID | slug. */
@@ -489,16 +686,26 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
      * const { name, theme } = await board.context();
      */
     context(options?: FetchOptions): Promise<PublicBoard>;
+    /**
+     * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
+     * the canonical base URL. Rebuild `robots.txt` / `ads.txt` /
+     * `indexnow-key.txt` from it.
+     *
+     * @example
+     * const { adsTxt, canonicalBase } = await board.seo();
+     */
+    seo(options?: FetchOptions): Promise<BoardSeo>;
     jobs: {
-        list(query?: JobsListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJob>>;
+        list(query?: JobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
         retrieve(jobSlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicJob>;
-        search(body: JobsSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<PublicJob>>;
+        search(body: JobsSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<JobCardSearchEnvelope>;
+        similar(jobSlug: string, query?: JobsSimilarQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJobCard>>;
     };
     companies: {
         list(query?: CompaniesListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicCompany>>;
         retrieve(companySlug: string, query?: Record<string, never>, options?: FetchOptions): Promise<PublicCompany>;
         search(body: CompaniesSearchBody, query?: Record<string, never>, options?: FetchOptions): Promise<SearchEnvelope<PublicCompany>>;
-        listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<ListEnvelope<PublicJob>>;
+        listJobs(companySlug: string, query?: CompanyJobsListQuery, options?: FetchOptions): Promise<JobCardListEnvelope>;
     };
     blog: {
         posts: {
@@ -532,7 +739,22 @@ declare function createBoardClient(options: CreateBoardClientOptions): {
             unsave(jobId: string, query?: Record<string, never>, options?: FetchOptions): Promise<void>;
         };
     };
+    taxonomy: {
+        categories: {
+            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+        };
+        skills: {
+            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+        };
+        places: {
+            list(options?: FetchOptions): Promise<ListEnvelope<PublicPlace>>;
+            resolve(slug: string, options?: FetchOptions): Promise<TaxonomyResolution>;
+        };
+    };
+    redirects: {
+        resolve(path: string, options?: FetchOptions): Promise<RedirectResolution>;
+    };
 };
 type BoardSdk = ReturnType<typeof createBoardClient>;
 
-export { ACCESS_TOKEN_KEY, type Awaitable, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogTagEmbed, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardUser, type CompaniesListQuery, type CompaniesSearchBody, type CompanyJobsListQuery, type CreateBoardClientOptions, type CustomStorage, type EducationRequirement, type EmploymentType, type FetchOptions, type ForgotPasswordBody, type JobCompany, type JobsListQuery, type JobsSearchBody, type ListEnvelope, type Logger, type LoginBody, type LogoutBody, type OfficeLocation, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicJob, REFRESH_TOKEN_KEY, type RefreshBody, type RegisterBody, type RemoteOption, type RemotePermit, type RemoteTimezone, type ResetPasswordBody, SDK_VERSION, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type Seniority, type StorageMode, type VerifyEmailBody, createBoardClient, isBoardApiError, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };
+export { ACCESS_TOKEN_KEY, type Awaitable, type BlogAuthorEmbed, type BlogPostsListQuery, type BlogSearchBody, type BlogTagEmbed, BoardApiError, type BoardAuthSession, BoardClient, type BoardRequest, type BoardSdk, type BoardSeo, type BoardUser, type CompaniesListQuery, type CompaniesSearchBody, type CompanyJobsListQuery, type CreateBoardClientOptions, type CustomStorage, type EducationRequirement, type EmploymentType, type FetchOptions, type ForgotPasswordBody, type JobCardListEnvelope, type JobCardSearchEnvelope, type JobCompany, type JobsListQuery, type JobsSearchBody, type ListEnvelope, type Logger, type LoginBody, type LogoutBody, type OfficeLocation, type PublicBlogAuthor, type PublicBlogPost, type PublicBlogPostSummary, type PublicBlogTag, type PublicBoard, type PublicBoardAnalytics, type PublicBoardFeatures, type PublicBoardTheme, type PublicCompany, type PublicJob, type PublicJobCard, type PublicPlace, REFRESH_TOKEN_KEY, type RedirectResolution, type RefreshBody, type RegisterBody, type RelatedSearch, type RemoteOption, type RemotePermit, type RemoteTimezone, type ResetPasswordBody, SDK_VERSION, type SaveJobBody, type SavedJob, type SavedJobsListQuery, type SearchEnvelope, type Seniority, type StorageMode, type StorefrontPagination, type TaxonomyGeo, type TaxonomyResolution, type VerifyEmailBody, createBoardClient, isBoardApiError, isConflict, isForbidden, isNotFound, isRateLimited, isUnauthorized, isValidationError };

package/dist/index.js

@@ -143,7 +143,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.2.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -544,6 +544,23 @@ function jobsNamespace(client) {
         body,
         query
       });
+    },
+    /**
+     * List jobs similar to one job — the same ranking that powers the
+     * on-page similar-jobs rail. Returns up to `limit` slim cards (default
+     * 5), excluding the job itself and any role at the same company.
+     *
+     * @example
+     * const { data } = await board.jobs.similar('senior-chef', { limit: 5 });
+     */
+    similar(jobSlug, query, options) {
+      return client.fetch(
+        `/jobs/${encodeURIComponent(jobSlug)}/similar`,
+        {
+          ...options,
+          query
+        }
+      );
     }
   };
 }
@@ -608,6 +625,55 @@ function meNamespace(client) {
   };
 }
 
+// src/namespaces/redirects.ts
+function redirectsNamespace(client) {
+  return {
+    /**
+     * Resolve a board-relative path against the board's configured redirects —
+     * the same resolution the hosted board's catch-all performs. 308 to
+     * `target`, or 404 when `target` is `null`.
+     *
+     * @example
+     * const { target } = await board.redirects.resolve('/old-jobs')
+     */
+    resolve(path, options) {
+      return client.fetch("/redirects/resolve", {
+        ...options,
+        query: { path }
+      });
+    }
+  };
+}
+
+// src/namespaces/taxonomy.ts
+function taxonomyResolver(client, kind) {
+  return {
+    /**
+     * Resolve a (board-language or English) taxonomy slug to its page-meta.
+     * Rejects with a `not_found` `BoardApiError` when the slug doesn't resolve.
+     */
+    resolve(slug, options) {
+      return client.fetch(
+        `/${kind}/${encodeURIComponent(slug)}`,
+        options
+      );
+    }
+  };
+}
+function taxonomyNamespace(client) {
+  return {
+    categories: taxonomyResolver(client, "categories"),
+    skills: taxonomyResolver(client, "skills"),
+    places: {
+      ...taxonomyResolver(client, "places"),
+      /** List every place used by a published job, with its live job count. */
+      list(options) {
+        return client.fetch("/places", options);
+      }
+    }
+  };
+}
+
 // src/index.ts
 function createBoardClient(options) {
   const client = new BoardClient({
@@ -635,10 +701,23 @@ function createBoardClient(options) {
     context(options2) {
       return client.fetch("", options2);
     },
+    /**
+     * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
+     * the canonical base URL. Rebuild `robots.txt` / `ads.txt` /
+     * `indexnow-key.txt` from it.
+     *
+     * @example
+     * const { adsTxt, canonicalBase } = await board.seo();
+     */
+    seo(options2) {
+      return client.fetch("/seo", options2);
+    },
     jobs: jobsNamespace(client),
     companies: companiesNamespace(client),
     blog: blogNamespace(client),
     auth: authNamespace(client),
-    me: meNamespace(client)
+    me: meNamespace(client),
+    taxonomy: taxonomyNamespace(client),
+    redirects: redirectsNamespace(client)
   };
 }

package/dist/index.mjs

@@ -105,7 +105,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.2.0";
 
 // src/client.ts
 function isRawBody(body) {
@@ -506,6 +506,23 @@ function jobsNamespace(client) {
         body,
         query
       });
+    },
+    /**
+     * List jobs similar to one job — the same ranking that powers the
+     * on-page similar-jobs rail. Returns up to `limit` slim cards (default
+     * 5), excluding the job itself and any role at the same company.
+     *
+     * @example
+     * const { data } = await board.jobs.similar('senior-chef', { limit: 5 });
+     */
+    similar(jobSlug, query, options) {
+      return client.fetch(
+        `/jobs/${encodeURIComponent(jobSlug)}/similar`,
+        {
+          ...options,
+          query
+        }
+      );
     }
   };
 }
@@ -570,6 +587,55 @@ function meNamespace(client) {
   };
 }
 
+// src/namespaces/redirects.ts
+function redirectsNamespace(client) {
+  return {
+    /**
+     * Resolve a board-relative path against the board's configured redirects —
+     * the same resolution the hosted board's catch-all performs. 308 to
+     * `target`, or 404 when `target` is `null`.
+     *
+     * @example
+     * const { target } = await board.redirects.resolve('/old-jobs')
+     */
+    resolve(path, options) {
+      return client.fetch("/redirects/resolve", {
+        ...options,
+        query: { path }
+      });
+    }
+  };
+}
+
+// src/namespaces/taxonomy.ts
+function taxonomyResolver(client, kind) {
+  return {
+    /**
+     * Resolve a (board-language or English) taxonomy slug to its page-meta.
+     * Rejects with a `not_found` `BoardApiError` when the slug doesn't resolve.
+     */
+    resolve(slug, options) {
+      return client.fetch(
+        `/${kind}/${encodeURIComponent(slug)}`,
+        options
+      );
+    }
+  };
+}
+function taxonomyNamespace(client) {
+  return {
+    categories: taxonomyResolver(client, "categories"),
+    skills: taxonomyResolver(client, "skills"),
+    places: {
+      ...taxonomyResolver(client, "places"),
+      /** List every place used by a published job, with its live job count. */
+      list(options) {
+        return client.fetch("/places", options);
+      }
+    }
+  };
+}
+
 // src/index.ts
 function createBoardClient(options) {
   const client = new BoardClient({
@@ -597,11 +663,24 @@ function createBoardClient(options) {
     context(options2) {
       return client.fetch("", options2);
     },
+    /**
+     * Board SEO infra — `ads.txt`, IndexNow key, Google site-verification, and
+     * the canonical base URL. Rebuild `robots.txt` / `ads.txt` /
+     * `indexnow-key.txt` from it.
+     *
+     * @example
+     * const { adsTxt, canonicalBase } = await board.seo();
+     */
+    seo(options2) {
+      return client.fetch("/seo", options2);
+    },
     jobs: jobsNamespace(client),
     companies: companiesNamespace(client),
     blog: blogNamespace(client),
     auth: authNamespace(client),
-    me: meNamespace(client)
+    me: meNamespace(client),
+    taxonomy: taxonomyNamespace(client),
+    redirects: redirectsNamespace(client)
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Typed isomorphic client for the Cavuno Board API",
   "license": "MIT",
   "repository": {
@@ -33,17 +33,18 @@
   "publishConfig": {
     "access": "public"
   },
-  "devDependencies": {
-    "@types/node": "24.9.1",
-    "tsup": "^8.4.0",
-    "vitest": "^2.1.9",
-    "@kit/tsconfig": "0.1.0"
-  },
   "scripts": {
     "build": "tsup",
     "clean": "git clean -xdf .turbo dist node_modules",
     "typecheck": "tsgo --noEmit",
     "test": "vitest run",
-    "assert-publish-target": "node -e \"const p=require('./package.json'); if(p.name!=='@cavuno/board'){throw new Error('Refusing to publish: package.json name is '+p.name+', expected @cavuno/board')}; if(p.private){throw new Error('Refusing to publish: package.json has private:true')}\""
+    "assert-publish-target": "node -e \"const p=require('./package.json'); if(p.name!=='@cavuno/board'){throw new Error('Refusing to publish: package.json name is '+p.name+', expected @cavuno/board')}; if(p.private){throw new Error('Refusing to publish: package.json has private:true')}\"",
+    "prepublishOnly": "pnpm run assert-publish-target && pnpm run build"
+  },
+  "devDependencies": {
+    "@kit/tsconfig": "workspace:*",
+    "@types/node": "catalog:",
+    "tsup": "^8.4.0",
+    "vitest": "^2.1.9"
   }
-}
+}