@cavuno/board 1.40.0 → 1.42.0

package/dist/{_spec-DRbgPIlN.d.mts → _spec-LdkTxfx0.d.mts}

@@ -1995,6 +1995,28 @@ interface components {
              */
             public: string | null;
         };
+        EmployerJobStat: {
+            /** @enum {string} */
+            object: "employer_job_stat";
+            /** @description The Convex job id these stats belong to. */
+            jobId: string;
+            /** @description Job-detail page-views over the all-time window. */
+            views: number;
+            /** @description Apply-click events over the all-time window. */
+            applyClicks: number;
+            /** @description Native ATS application count, or `null` for an external-apply job (no native pipeline). */
+            applications: number | null;
+        };
+        EmployerJobStatsPoint: {
+            /** @enum {string} */
+            object: "employer_job_stats_point";
+            /** @description The UTC day this bucket covers (`YYYY-MM-DD`). */
+            date: string;
+            /** @description Job-detail page-views on this day. */
+            views: number;
+            /** @description Apply-click events on this day. */
+            applyClicks: number;
+        };
         EmployerJobSummary: {
             /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
             id: string;
@@ -4818,6 +4840,39 @@ interface components {
             /** @description Space-separated list of scopes granted on the issued token. */
             scope: string;
         };
+        Transaction: {
+            id: string;
+            /** @enum {string} */
+            object: "transaction";
+            /** @enum {string} */
+            kind: "card_post" | "invoice" | "subscription";
+            /** @enum {string} */
+            status: "paid" | "open" | "void" | "uncollectible";
+            /** @enum {string} */
+            method: "card" | "invoice";
+            /** @description Amount in Stripe minor units (cents for most currencies). */
+            amountCents: number;
+            currency: string;
+            description: string;
+            customerLabel: string;
+            customerEmail: string | null;
+            /** @description ISO-8601 transaction date. */
+            date: string;
+            /** @description ISO-8601 invoice due date, or null. Past-due is client-derived from this field. */
+            invoiceDueAt: string | null;
+            stripeInvoiceId: string | null;
+            hostedInvoiceUrl: string | null;
+            receiptUrl: string | null;
+            methodBrand: string | null;
+            methodLast4: string | null;
+            methodType: string | null;
+            /** @enum {string|null} */
+            publishTiming: "on_issue" | "on_payment" | null;
+            /** @description jobOrders id when this row is order-sourced. */
+            orderId: string | null;
+            /** @description employerSubscriptions id when this row is a subscription renewal. Cross-link: GET /v1/employer-subscriptions/:id. */
+            subscriptionId: string | null;
+        };
         TransferOwnershipBody: {
             /** @description The user ID of the member who will become the primary owner. */
             newOwnerUserId: string;

package/dist/{_spec-DRbgPIlN.d.ts → _spec-LdkTxfx0.d.ts}

@@ -1995,6 +1995,28 @@ interface components {
              */
             public: string | null;
         };
+        EmployerJobStat: {
+            /** @enum {string} */
+            object: "employer_job_stat";
+            /** @description The Convex job id these stats belong to. */
+            jobId: string;
+            /** @description Job-detail page-views over the all-time window. */
+            views: number;
+            /** @description Apply-click events over the all-time window. */
+            applyClicks: number;
+            /** @description Native ATS application count, or `null` for an external-apply job (no native pipeline). */
+            applications: number | null;
+        };
+        EmployerJobStatsPoint: {
+            /** @enum {string} */
+            object: "employer_job_stats_point";
+            /** @description The UTC day this bucket covers (`YYYY-MM-DD`). */
+            date: string;
+            /** @description Job-detail page-views on this day. */
+            views: number;
+            /** @description Apply-click events on this day. */
+            applyClicks: number;
+        };
         EmployerJobSummary: {
             /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the job endpoints (e.g. `GET /v1/jobs/{id}`). */
             id: string;
@@ -4818,6 +4840,39 @@ interface components {
             /** @description Space-separated list of scopes granted on the issued token. */
             scope: string;
         };
+        Transaction: {
+            id: string;
+            /** @enum {string} */
+            object: "transaction";
+            /** @enum {string} */
+            kind: "card_post" | "invoice" | "subscription";
+            /** @enum {string} */
+            status: "paid" | "open" | "void" | "uncollectible";
+            /** @enum {string} */
+            method: "card" | "invoice";
+            /** @description Amount in Stripe minor units (cents for most currencies). */
+            amountCents: number;
+            currency: string;
+            description: string;
+            customerLabel: string;
+            customerEmail: string | null;
+            /** @description ISO-8601 transaction date. */
+            date: string;
+            /** @description ISO-8601 invoice due date, or null. Past-due is client-derived from this field. */
+            invoiceDueAt: string | null;
+            stripeInvoiceId: string | null;
+            hostedInvoiceUrl: string | null;
+            receiptUrl: string | null;
+            methodBrand: string | null;
+            methodLast4: string | null;
+            methodType: string | null;
+            /** @enum {string|null} */
+            publishTiming: "on_issue" | "on_payment" | null;
+            /** @description jobOrders id when this row is order-sourced. */
+            orderId: string | null;
+            /** @description employerSubscriptions id when this row is a subscription renewal. Cross-link: GET /v1/employer-subscriptions/:id. */
+            subscriptionId: string | null;
+        };
         TransferOwnershipBody: {
             /** @description The user ID of the member who will become the primary owner. */
             newOwnerUserId: string;

package/dist/{board-DCiNpgFf.d.mts → board-Cs93Lf23.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DRbgPIlN.mjs';
+import { S as Schemas } from './_spec-LdkTxfx0.mjs';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/{board-BxPUtrOl.d.ts → board-FxC9Wdhi.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-DRbgPIlN.js';
+import { S as Schemas } from './_spec-LdkTxfx0.js';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/filters.d.mts

@@ -1,6 +1,6 @@
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.mjs';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-DhePKSRe.mjs';
-import './_spec-DRbgPIlN.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-BtazrWfv.mjs';
+import './_spec-LdkTxfx0.mjs';
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**

package/dist/filters.d.ts

@@ -1,6 +1,6 @@
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.js';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-DAGAVHQL.js';
-import './_spec-DRbgPIlN.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-TIAPH3Ol.js';
+import './_spec-LdkTxfx0.js';
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**

package/dist/format.d.mts

@@ -1,8 +1,8 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-DhePKSRe.mjs';
+import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-BtazrWfv.mjs';
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.mjs';
 export { A as AlertsCopy, a as ApplyCopy, b as BlogCopy, c as BreadcrumbsCopy, C as CopyLinkCopy, E as EntityCopy, F as FooterCopy, J as JobCardCopy, d as JobDetailCopy, e as JobSearchCopy, N as NavCopy, P as PUBLIC_LABEL_GROUPS, f as PaginationCopy, S as SalaryCopy, U as UiCopy, u as uiCopy } from './ui-copy-CKfFTtLk.mjs';
-import { C as CustomFieldDefinition } from './board-DCiNpgFf.mjs';
-import './_spec-DRbgPIlN.mjs';
+import { C as CustomFieldDefinition } from './board-Cs93Lf23.mjs';
+import './_spec-LdkTxfx0.mjs';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/format.d.ts

@@ -1,8 +1,8 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-DAGAVHQL.js';
+import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-TIAPH3Ol.js';
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.js';
 export { A as AlertsCopy, a as ApplyCopy, b as BlogCopy, c as BreadcrumbsCopy, C as CopyLinkCopy, E as EntityCopy, F as FooterCopy, J as JobCardCopy, d as JobDetailCopy, e as JobSearchCopy, N as NavCopy, P as PUBLIC_LABEL_GROUPS, f as PaginationCopy, S as SalaryCopy, U as UiCopy, u as uiCopy } from './ui-copy-CKfFTtLk.js';
-import { C as CustomFieldDefinition } from './board-BxPUtrOl.js';
-import './_spec-DRbgPIlN.js';
+import { C as CustomFieldDefinition } from './board-FxC9Wdhi.js';
+import './_spec-LdkTxfx0.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/go.d.mts

@@ -0,0 +1,65 @@
+/**
+ * Pure `/go` indirection for self-deployed SDK boards (LNK-04).
+ *
+ * Mirrors the hosted-app contract:
+ * - `/go/job/<id>` → 302 to jobDetailPath(companySlug, jobSlug)
+ * - `/go/alerts-manage` / `/go/alerts-confirm` → 302 carrying query
+ * - unknown / unresolvable → 302 to BOARD_PATHS.jobs
+ * - every response: `X-Robots-Tag: noindex, nofollow`
+ *
+ * Framework-portable: takes a standard Request, returns a standard
+ * Response. No Next.js imports (same discipline as the sitemap walker).
+ */
+interface ResolvedJobSlugs {
+    companySlug: string;
+    jobSlug: string;
+}
+interface GoRedirectResult {
+    location: string;
+    status: 302;
+}
+/**
+ * Optional job-id → slugs lookup. The public Board API currently exposes
+ * job retrieve **by slug only** (`board.jobs.retrieve(jobSlug)`); there is
+ * no publishable-key endpoint that resolves an immutable job id to slugs.
+ *
+ * When `lookupJob` is omitted, `/go/job/<id>` degrades to the jobs index
+ * (safe, never 404). Pass a custom lookup when a data-plane endpoint lands
+ * (see TODO(LNK-04-followup)).
+ */
+type GoJobLookup = (jobId: string) => Promise<ResolvedJobSlugs | null> | ResolvedJobSlugs | null;
+interface CreateGoHandlerConfig {
+    /**
+     * Optional job resolver. Injected so tests can fake the data client and
+     * so callers can wire a future Board API id-lookup without an SDK release.
+     */
+    lookupJob?: GoJobLookup;
+    /**
+     * Base origin used to absolutize Location (e.g. `https://jobs.example.com`).
+     * When omitted, Location is absolute against the incoming request URL —
+     * correct for same-host mounts.
+     */
+    origin?: string;
+}
+declare function goResponseHeaders(): Record<string, string>;
+/**
+ * Pure role → location resolver. Shared by the handler so unit tests can
+ * assert the contract without spinning a Request.
+ */
+declare function resolveGoRedirect(parts: readonly string[] | undefined, search: string, resolvedJob: ResolvedJobSlugs | null): GoRedirectResult;
+/**
+ * Create a `(request) => Response` handler the starter mounts at `/go/*`.
+ *
+ * @example
+ * // Next.js App Router
+ * import { createGoHandler } from '@cavuno/board/go';
+ * export const GET = createGoHandler({});
+ *
+ * // With a future id-lookup:
+ * export const GET = createGoHandler({
+ *   lookupJob: async (id) => board.jobs.retrieveById?.(id) ?? null,
+ * });
+ */
+declare function createGoHandler(config?: CreateGoHandlerConfig): (request: Request) => Promise<Response>;
+
+export { type CreateGoHandlerConfig, type GoJobLookup, type GoRedirectResult, type ResolvedJobSlugs, createGoHandler, goResponseHeaders, resolveGoRedirect };

package/dist/go.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Pure `/go` indirection for self-deployed SDK boards (LNK-04).
+ *
+ * Mirrors the hosted-app contract:
+ * - `/go/job/<id>` → 302 to jobDetailPath(companySlug, jobSlug)
+ * - `/go/alerts-manage` / `/go/alerts-confirm` → 302 carrying query
+ * - unknown / unresolvable → 302 to BOARD_PATHS.jobs
+ * - every response: `X-Robots-Tag: noindex, nofollow`
+ *
+ * Framework-portable: takes a standard Request, returns a standard
+ * Response. No Next.js imports (same discipline as the sitemap walker).
+ */
+interface ResolvedJobSlugs {
+    companySlug: string;
+    jobSlug: string;
+}
+interface GoRedirectResult {
+    location: string;
+    status: 302;
+}
+/**
+ * Optional job-id → slugs lookup. The public Board API currently exposes
+ * job retrieve **by slug only** (`board.jobs.retrieve(jobSlug)`); there is
+ * no publishable-key endpoint that resolves an immutable job id to slugs.
+ *
+ * When `lookupJob` is omitted, `/go/job/<id>` degrades to the jobs index
+ * (safe, never 404). Pass a custom lookup when a data-plane endpoint lands
+ * (see TODO(LNK-04-followup)).
+ */
+type GoJobLookup = (jobId: string) => Promise<ResolvedJobSlugs | null> | ResolvedJobSlugs | null;
+interface CreateGoHandlerConfig {
+    /**
+     * Optional job resolver. Injected so tests can fake the data client and
+     * so callers can wire a future Board API id-lookup without an SDK release.
+     */
+    lookupJob?: GoJobLookup;
+    /**
+     * Base origin used to absolutize Location (e.g. `https://jobs.example.com`).
+     * When omitted, Location is absolute against the incoming request URL —
+     * correct for same-host mounts.
+     */
+    origin?: string;
+}
+declare function goResponseHeaders(): Record<string, string>;
+/**
+ * Pure role → location resolver. Shared by the handler so unit tests can
+ * assert the contract without spinning a Request.
+ */
+declare function resolveGoRedirect(parts: readonly string[] | undefined, search: string, resolvedJob: ResolvedJobSlugs | null): GoRedirectResult;
+/**
+ * Create a `(request) => Response` handler the starter mounts at `/go/*`.
+ *
+ * @example
+ * // Next.js App Router
+ * import { createGoHandler } from '@cavuno/board/go';
+ * export const GET = createGoHandler({});
+ *
+ * // With a future id-lookup:
+ * export const GET = createGoHandler({
+ *   lookupJob: async (id) => board.jobs.retrieveById?.(id) ?? null,
+ * });
+ */
+declare function createGoHandler(config?: CreateGoHandlerConfig): (request: Request) => Promise<Response>;
+
+export { type CreateGoHandlerConfig, type GoJobLookup, type GoRedirectResult, type ResolvedJobSlugs, createGoHandler, goResponseHeaders, resolveGoRedirect };

package/dist/go.js

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/go/index.ts
+var go_exports = {};
+__export(go_exports, {
+  createGoHandler: () => createGoHandler,
+  goResponseHeaders: () => goResponseHeaders,
+  resolveGoRedirect: () => resolveGoRedirect
+});
+module.exports = __toCommonJS(go_exports);
+
+// src/paths/index.ts
+function jobDetailPath(companySlug, jobSlug) {
+  return `/companies/${companySlug}/jobs/${jobSlug}`;
+}
+var BOARD_PATHS = {
+  home: "/",
+  jobs: "/jobs",
+  companies: "/companies",
+  salaries: "/salaries",
+  salaryCompanies: "/salaries/companies",
+  salaryTitles: "/salaries/titles",
+  salarySkills: "/salaries/skills",
+  salaryLocations: "/salaries/locations",
+  blog: "/blog",
+  about: "/about",
+  privacyPolicy: "/privacy-policy",
+  termsOfService: "/terms-of-service",
+  cookiePolicy: "/cookie-policy",
+  impressum: "/impressum",
+  talent: "/talent",
+  employers: "/employers",
+  /**
+   * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+   * the job-alerts composer so /go indirection and email composition share
+   * one definition.
+   */
+  alertsManage: "/alerts/manage",
+  alertsConfirm: "/alerts/confirm"
+};
+
+// src/go/create-go-handler.ts
+var NOINDEX_ROBOTS = "noindex, nofollow";
+function goResponseHeaders() {
+  return {
+    "X-Robots-Tag": NOINDEX_ROBOTS,
+    "Cache-Control": "private, no-store"
+  };
+}
+function resolveGoRedirect(parts, search, resolvedJob) {
+  const role = parts?.[0];
+  const id = parts?.[1];
+  const query = search.startsWith("?") ? search : search ? `?${search}` : "";
+  if (role === "job") {
+    if (id && resolvedJob?.companySlug && resolvedJob.jobSlug) {
+      return {
+        location: jobDetailPath(resolvedJob.companySlug, resolvedJob.jobSlug),
+        status: 302
+      };
+    }
+    return { location: BOARD_PATHS.jobs, status: 302 };
+  }
+  if (role === "alerts-manage") {
+    return {
+      location: `${BOARD_PATHS.alertsManage}${query}`,
+      status: 302
+    };
+  }
+  if (role === "alerts-confirm") {
+    return {
+      location: `${BOARD_PATHS.alertsConfirm}${query}`,
+      status: 302
+    };
+  }
+  return { location: BOARD_PATHS.jobs, status: 302 };
+}
+function partsFromRequest(request) {
+  const { pathname } = new URL(request.url);
+  const segments = pathname.split("/").map((s) => s.trim()).filter(Boolean);
+  const goIdx = segments.findIndex((s) => s === "go");
+  if (goIdx >= 0) {
+    return segments.slice(goIdx + 1);
+  }
+  return segments;
+}
+function createGoHandler(config = {}) {
+  const { lookupJob, origin } = config;
+  return async function goHandler(request) {
+    const url = new URL(request.url);
+    const parts = partsFromRequest(request);
+    let resolvedJob = null;
+    if (parts[0] === "job" && parts[1]) {
+      if (lookupJob) {
+        try {
+          resolvedJob = await lookupJob(parts[1]) ?? null;
+        } catch {
+          resolvedJob = null;
+        }
+      } else {
+        resolvedJob = null;
+      }
+    }
+    const result = resolveGoRedirect(parts, url.search, resolvedJob);
+    const locationBase = origin ?? url.origin;
+    return new Response(null, {
+      status: result.status,
+      headers: {
+        ...goResponseHeaders(),
+        Location: new URL(result.location, locationBase).toString()
+      }
+    });
+  };
+}

package/dist/go.mjs

@@ -0,0 +1,107 @@
+// src/paths/index.ts
+function jobDetailPath(companySlug, jobSlug) {
+  return `/companies/${companySlug}/jobs/${jobSlug}`;
+}
+var BOARD_PATHS = {
+  home: "/",
+  jobs: "/jobs",
+  companies: "/companies",
+  salaries: "/salaries",
+  salaryCompanies: "/salaries/companies",
+  salaryTitles: "/salaries/titles",
+  salarySkills: "/salaries/skills",
+  salaryLocations: "/salaries/locations",
+  blog: "/blog",
+  about: "/about",
+  privacyPolicy: "/privacy-policy",
+  termsOfService: "/terms-of-service",
+  cookiePolicy: "/cookie-policy",
+  impressum: "/impressum",
+  talent: "/talent",
+  employers: "/employers",
+  /**
+   * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+   * the job-alerts composer so /go indirection and email composition share
+   * one definition.
+   */
+  alertsManage: "/alerts/manage",
+  alertsConfirm: "/alerts/confirm"
+};
+
+// src/go/create-go-handler.ts
+var NOINDEX_ROBOTS = "noindex, nofollow";
+function goResponseHeaders() {
+  return {
+    "X-Robots-Tag": NOINDEX_ROBOTS,
+    "Cache-Control": "private, no-store"
+  };
+}
+function resolveGoRedirect(parts, search, resolvedJob) {
+  const role = parts?.[0];
+  const id = parts?.[1];
+  const query = search.startsWith("?") ? search : search ? `?${search}` : "";
+  if (role === "job") {
+    if (id && resolvedJob?.companySlug && resolvedJob.jobSlug) {
+      return {
+        location: jobDetailPath(resolvedJob.companySlug, resolvedJob.jobSlug),
+        status: 302
+      };
+    }
+    return { location: BOARD_PATHS.jobs, status: 302 };
+  }
+  if (role === "alerts-manage") {
+    return {
+      location: `${BOARD_PATHS.alertsManage}${query}`,
+      status: 302
+    };
+  }
+  if (role === "alerts-confirm") {
+    return {
+      location: `${BOARD_PATHS.alertsConfirm}${query}`,
+      status: 302
+    };
+  }
+  return { location: BOARD_PATHS.jobs, status: 302 };
+}
+function partsFromRequest(request) {
+  const { pathname } = new URL(request.url);
+  const segments = pathname.split("/").map((s) => s.trim()).filter(Boolean);
+  const goIdx = segments.findIndex((s) => s === "go");
+  if (goIdx >= 0) {
+    return segments.slice(goIdx + 1);
+  }
+  return segments;
+}
+function createGoHandler(config = {}) {
+  const { lookupJob, origin } = config;
+  return async function goHandler(request) {
+    const url = new URL(request.url);
+    const parts = partsFromRequest(request);
+    let resolvedJob = null;
+    if (parts[0] === "job" && parts[1]) {
+      if (lookupJob) {
+        try {
+          resolvedJob = await lookupJob(parts[1]) ?? null;
+        } catch {
+          resolvedJob = null;
+        }
+      } else {
+        resolvedJob = null;
+      }
+    }
+    const result = resolveGoRedirect(parts, url.search, resolvedJob);
+    const locationBase = origin ?? url.origin;
+    return new Response(null, {
+      status: result.status,
+      headers: {
+        ...goResponseHeaders(),
+        Location: new URL(result.location, locationBase).toString()
+      }
+    });
+  };
+}
+export {
+  createGoHandler,
+  goResponseHeaders,
+  resolveGoRedirect
+};