@cavuno/board 1.35.0 → 1.35.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- import { b as Schemas, L as ListEnvelope, o as RelatedSearch } from './jobs-BFLMDNEN.js';
1
+ import { b as Schemas, L as ListEnvelope, o as RelatedSearch } from './jobs-Dq2a9oPj.js';
2
2
 
3
3
  /** Author shape embedded on posts (no `object` discriminator). */
4
4
  type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
@@ -1,4 +1,4 @@
1
- import { b as Schemas, L as ListEnvelope, o as RelatedSearch } from './jobs-BFLMDNEN.mjs';
1
+ import { b as Schemas, L as ListEnvelope, o as RelatedSearch } from './jobs-Dq2a9oPj.mjs';
2
2
 
3
3
  /** Author shape embedded on posts (no `object` discriminator). */
4
4
  type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
package/dist/seo.d.mts CHANGED
@@ -1,7 +1,7 @@
1
- import { P as PublicBlogPostSummary, B as BlogAuthorEmbed, C as CompanyCategorySalary, a as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './salaries-pO_vGORE.mjs';
2
- import { P as PublicBoard } from './board-Be8dY9Ba.mjs';
3
- import { P as PublicJob } from './jobs-BFLMDNEN.mjs';
4
- import { B as BoardLabelOverrides } from './ui-copy-rlfoH9P3.mjs';
1
+ import { P as PublicBlogPostSummary, B as BlogAuthorEmbed, C as CompanyCategorySalary, a as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './salaries-CWg82dOz.mjs';
2
+ import { P as PublicBoard } from './board-t_WltBBa.mjs';
3
+ import { P as PublicJob } from './jobs-Dq2a9oPj.mjs';
4
+ import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.mjs';
5
5
 
6
6
  /**
7
7
  * Google for Jobs `JobPosting` structured data on the `@cavuno/board` wire
package/dist/seo.d.ts CHANGED
@@ -1,7 +1,7 @@
1
- import { P as PublicBlogPostSummary, B as BlogAuthorEmbed, C as CompanyCategorySalary, a as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './salaries-negE75t8.js';
2
- import { P as PublicBoard } from './board-DsRbgz_D.js';
3
- import { P as PublicJob } from './jobs-BFLMDNEN.js';
4
- import { B as BoardLabelOverrides } from './ui-copy-rlfoH9P3.js';
1
+ import { P as PublicBlogPostSummary, B as BlogAuthorEmbed, C as CompanyCategorySalary, a as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './salaries-CTin-18R.js';
2
+ import { P as PublicBoard } from './board-Z7hjKDp8.js';
3
+ import { P as PublicJob } from './jobs-Dq2a9oPj.js';
4
+ import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.js';
5
5
 
6
6
  /**
7
7
  * Google for Jobs `JobPosting` structured data on the `@cavuno/board` wire
package/dist/seo.js CHANGED
@@ -217,8 +217,7 @@ var EN = {
217
217
  jobAlertEmailPlaceholder: "you@example.com",
218
218
  jobAlertButtonText: "Get alerts",
219
219
  subscribingLabel: "Subscribing\u2026",
220
- jobAlertSuccessToast: "Check your email to confirm your subscription.",
221
- jobAlertDuplicateToast: "You're already subscribed to this alert.",
220
+ jobAlertSuccessToast: "If this email isn't already subscribed, we've sent a confirmation link \u2014 check your inbox.",
222
221
  jobAlertErrorToast: "Something went wrong. Please try again.",
223
222
  sectionAriaLabel: "Job alerts",
224
223
  emailAriaLabel: "email",
@@ -367,8 +366,7 @@ var DE = {
367
366
  jobAlertEmailPlaceholder: "name@beispiel.de",
368
367
  jobAlertButtonText: "Abonnieren",
369
368
  subscribingLabel: "Wird abonniert \u2026",
370
- jobAlertSuccessToast: "\xDCberpr\xFCfe deine E-Mails, um dein Abonnement zu best\xE4tigen.",
371
- jobAlertDuplicateToast: "Du hast diese Benachrichtigung bereits abonniert.",
369
+ jobAlertSuccessToast: "Falls diese E-Mail noch nicht abonniert ist, haben wir einen Best\xE4tigungslink gesendet \u2014 pr\xFCfe deinen Posteingang.",
372
370
  jobAlertErrorToast: "Etwas ist schiefgelaufen. Bitte versuche es erneut.",
373
371
  sectionAriaLabel: "Job-Benachrichtigungen",
374
372
  emailAriaLabel: "E-Mail",
@@ -517,8 +515,7 @@ var FR = {
517
515
  jobAlertEmailPlaceholder: "vous@exemple.fr",
518
516
  jobAlertButtonText: "Activer les alertes",
519
517
  subscribingLabel: "Abonnement en cours\u2026",
520
- jobAlertSuccessToast: "V\xE9rifiez votre e-mail pour confirmer votre abonnement.",
521
- jobAlertDuplicateToast: "Vous \xEAtes d\xE9j\xE0 abonn\xE9 \xE0 cette alerte.",
518
+ jobAlertSuccessToast: "Si cet e-mail n'est pas d\xE9j\xE0 abonn\xE9, nous avons envoy\xE9 un lien de confirmation \u2014 v\xE9rifiez votre bo\xEEte de r\xE9ception.",
522
519
  jobAlertErrorToast: "Une erreur est survenue. Veuillez r\xE9essayer.",
523
520
  sectionAriaLabel: "Alertes emploi",
524
521
  emailAriaLabel: "e-mail",
package/dist/seo.mjs CHANGED
@@ -169,8 +169,7 @@ var EN = {
169
169
  jobAlertEmailPlaceholder: "you@example.com",
170
170
  jobAlertButtonText: "Get alerts",
171
171
  subscribingLabel: "Subscribing\u2026",
172
- jobAlertSuccessToast: "Check your email to confirm your subscription.",
173
- jobAlertDuplicateToast: "You're already subscribed to this alert.",
172
+ jobAlertSuccessToast: "If this email isn't already subscribed, we've sent a confirmation link \u2014 check your inbox.",
174
173
  jobAlertErrorToast: "Something went wrong. Please try again.",
175
174
  sectionAriaLabel: "Job alerts",
176
175
  emailAriaLabel: "email",
@@ -319,8 +318,7 @@ var DE = {
319
318
  jobAlertEmailPlaceholder: "name@beispiel.de",
320
319
  jobAlertButtonText: "Abonnieren",
321
320
  subscribingLabel: "Wird abonniert \u2026",
322
- jobAlertSuccessToast: "\xDCberpr\xFCfe deine E-Mails, um dein Abonnement zu best\xE4tigen.",
323
- jobAlertDuplicateToast: "Du hast diese Benachrichtigung bereits abonniert.",
321
+ jobAlertSuccessToast: "Falls diese E-Mail noch nicht abonniert ist, haben wir einen Best\xE4tigungslink gesendet \u2014 pr\xFCfe deinen Posteingang.",
324
322
  jobAlertErrorToast: "Etwas ist schiefgelaufen. Bitte versuche es erneut.",
325
323
  sectionAriaLabel: "Job-Benachrichtigungen",
326
324
  emailAriaLabel: "E-Mail",
@@ -469,8 +467,7 @@ var FR = {
469
467
  jobAlertEmailPlaceholder: "vous@exemple.fr",
470
468
  jobAlertButtonText: "Activer les alertes",
471
469
  subscribingLabel: "Abonnement en cours\u2026",
472
- jobAlertSuccessToast: "V\xE9rifiez votre e-mail pour confirmer votre abonnement.",
473
- jobAlertDuplicateToast: "Vous \xEAtes d\xE9j\xE0 abonn\xE9 \xE0 cette alerte.",
470
+ jobAlertSuccessToast: "Si cet e-mail n'est pas d\xE9j\xE0 abonn\xE9, nous avons envoy\xE9 un lien de confirmation \u2014 v\xE9rifiez votre bo\xEEte de r\xE9ception.",
474
471
  jobAlertErrorToast: "Une erreur est survenue. Veuillez r\xE9essayer.",
475
472
  sectionAriaLabel: "Alertes emploi",
476
473
  emailAriaLabel: "e-mail",
package/dist/server.d.mts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { BoardSdk } from './index.mjs';
2
- import './jobs-BFLMDNEN.mjs';
3
- import './board-Be8dY9Ba.mjs';
4
- import './salaries-pO_vGORE.mjs';
2
+ import './jobs-Dq2a9oPj.mjs';
3
+ import './board-t_WltBBa.mjs';
4
+ import './salaries-CWg82dOz.mjs';
5
5
 
6
6
  /**
7
7
  * Session cookie codec — pure (no framework imports, no node imports) so it
package/dist/server.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { BoardSdk } from './index.js';
2
- import './jobs-BFLMDNEN.js';
3
- import './board-DsRbgz_D.js';
4
- import './salaries-negE75t8.js';
2
+ import './jobs-Dq2a9oPj.js';
3
+ import './board-Z7hjKDp8.js';
4
+ import './salaries-CTin-18R.js';
5
5
 
6
6
  /**
7
7
  * Session cookie codec — pure (no framework imports, no node imports) so it
@@ -1,7 +1,7 @@
1
1
  import { BoardSdk } from './index.mjs';
2
- import './jobs-BFLMDNEN.mjs';
3
- import './board-Be8dY9Ba.mjs';
4
- import './salaries-pO_vGORE.mjs';
2
+ import './jobs-Dq2a9oPj.mjs';
3
+ import './board-t_WltBBa.mjs';
4
+ import './salaries-CWg82dOz.mjs';
5
5
 
6
6
  /**
7
7
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board
package/dist/sitemap.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import { BoardSdk } from './index.js';
2
- import './jobs-BFLMDNEN.js';
3
- import './board-DsRbgz_D.js';
4
- import './salaries-negE75t8.js';
2
+ import './jobs-Dq2a9oPj.js';
3
+ import './board-Z7hjKDp8.js';
4
+ import './salaries-CTin-18R.js';
5
5
 
6
6
  /**
7
7
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board
@@ -99,7 +99,6 @@ interface AlertsCopy {
99
99
  jobAlertButtonText: string;
100
100
  subscribingLabel: string;
101
101
  jobAlertSuccessToast: string;
102
- jobAlertDuplicateToast: string;
103
102
  jobAlertErrorToast: string;
104
103
  sectionAriaLabel: string;
105
104
  emailAriaLabel: string;
@@ -99,7 +99,6 @@ interface AlertsCopy {
99
99
  jobAlertButtonText: string;
100
100
  subscribingLabel: string;
101
101
  jobAlertSuccessToast: string;
102
- jobAlertDuplicateToast: string;
103
102
  jobAlertErrorToast: string;
104
103
  sectionAriaLabel: string;
105
104
  emailAriaLabel: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cavuno/board",
3
- "version": "1.35.0",
3
+ "version": "1.35.1",
4
4
  "description": "Typed isomorphic client for the Cavuno Board API",
5
5
  "license": "MIT",
6
6
  "type": "commonjs",
@@ -64,6 +64,46 @@ deliberately offers 5 of the 7 wire values (`volunteer`/`other` exist on
64
64
  jobs but are not filter options). `JOB_SORTS` deliberately excludes
65
65
  `oldest` (ADR-0048); `relevance` is the featured-ranked default.
66
66
 
67
+ ## Load category, skill, and keyword options
68
+
69
+ Use the Board API taxonomy collections for filter/autocomplete options. Items
70
+ are backed by published jobs on this board and already carry the board-language
71
+ display name and canonical URL slug. Keep `sourceSlug` for job filtering and
72
+ `canonicalSlug` for links.
73
+
74
+ ```ts snippet
75
+ const categories = await board.taxonomy.categories.list({ limit: 50 });
76
+ const skills = await board.taxonomy.skills.list({ limit: 50 });
77
+ const suggestions = await board.taxonomy.suggestions.list({
78
+ q: searchText,
79
+ limit: 10,
80
+ });
81
+
82
+ const categoryOptions = categories.data.map((term) => ({
83
+ label: term.displayName,
84
+ filterValue: term.sourceSlug,
85
+ href: `/jobs/${term.canonicalSlug}`,
86
+ }));
87
+ ```
88
+
89
+ Category and skill lists accept `q`, `limit` (1–100), and the opaque
90
+ `cursor` request field. Pass the previous response's `nextCursor` into it:
91
+
92
+ ```ts snippet
93
+ const first = await board.taxonomy.categories.list({ limit: 50 });
94
+ const second = first.nextCursor
95
+ ? await board.taxonomy.categories.list({
96
+ limit: 50,
97
+ cursor: first.nextCursor,
98
+ })
99
+ : null;
100
+ ```
101
+
102
+ Suggestions accept `q` and `limit`;
103
+ a present query under two characters returns no suggestions. Suggestions contain
104
+ categories and skills only. A category and skill may legitimately share a slug,
105
+ so use `type + canonicalSlug` as the option identity.
106
+
67
107
  ## Anti-patterns
68
108
 
69
109
  ```ts no-check
@@ -76,9 +116,9 @@ board.jobs.list({ seniority: rawSearch.seniority });
76
116
 
77
117
  ## Out of scope — do not invent exports
78
118
 
79
- No URL BUILDER (routes are app-owned — serialize with your router), no
80
- category/skill/location taxonomy lists (those come from the API:
81
- `board.taxonomy.*`, `jobs.list` filters), no saved-filter persistence.
119
+ No URL BUILDER (routes are app-owned — serialize with your router), no location
120
+ taxonomy vocabulary (locations come from `board.taxonomy.places`), no
121
+ saved-filter persistence.
82
122
 
83
123
  ## Verify
84
124
 
@@ -31,14 +31,13 @@ const sub = await board.jobAlerts.subscribe({
31
31
  frequency: 'weekly', // the only supported cadence
32
32
  filters: { jobFunctions: ['engineering'], remoteOptions: ['remote'], placeSlugs: ['berlin'] },
33
33
  });
34
- sub.status; // 'created' | 'duplicate'
35
- sub.requiresConfirmation; // true when the opt-in email was sent
34
+ sub.status; // always 'submitted' uniform, never reveals new vs. already-subscribed
36
35
 
37
36
  // Confirm page — token from the email link:
38
37
  const res = await board.jobAlerts.confirm({ token });
39
38
  res.status; // 'confirmed' | 'already_confirmed' | 'expired' | 'not_found'
40
39
  if (res.status === 'expired') {
41
- await board.jobAlerts.resendConfirmation({ email }); // status: 'sent' | 'throttled' | ...
40
+ await board.jobAlerts.resendConfirmation({ email }); // status: always 'submitted'
42
41
  }
43
42
  ```
44
43
 
@@ -107,7 +106,7 @@ await board.me.alerts.update(alertId, {
107
106
 
108
107
  ## Verify
109
108
 
110
- - [ ] Subscribe form sends `consent: true` and handles `status: 'duplicate'` without erroring.
109
+ - [ ] Subscribe form sends `consent: true` and shows a uniform "check your email" message on `status: 'submitted'` (never reveals already-subscribed).
111
110
  - [ ] Confirm page branches on all four statuses (including `expired` → resend).
112
111
  - [ ] Manage page reads `subscription` + `token` from the email link's query string; writes send `subscriptionId` in the body.
113
112
  - [ ] Editing one preference field leaves the others intact (full-replace round-trip, both surfaces).
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: cavuno-board-job-posting
3
- description: Build the anonymous "Post a job" funnel with the @cavuno/board SDK — jobPosting.plans, create and its status-discriminated JobPostingResult (checkout / published / pending_approval / invoice_sent), logo upload + fetchLogoByDomain, and the email-verified billing helpers (checkBilling, sendBillingVerification, getBillingOptions, checkSubscriptionEntitlements).
3
+ description: Build the anonymous "Post a job" funnel with the @cavuno/board SDK — jobPosting.plans, create and its status-discriminated JobPostingResult (checkout / published / pending_approval / invoice_sent), logo upload + fetchLogoByDomain, and the email-verified billing helpers (sendBillingVerification, getBillingOptions).
4
4
  ---
5
5
 
6
6
  # Job posting: the anonymous submission funnel
@@ -87,16 +87,15 @@ The five billing paths map onto those four statuses: paid-Stripe → `checkout`;
87
87
 
88
88
  ## Existing credit: the verified-email branch
89
89
 
90
- A submitter whose email already holds a plan/bundle can post against remaining capacity — no new charge. Verify the email first; an option's fields become `selectedBilling`:
90
+ A submitter whose email already holds a plan/bundle can post against remaining capacity — no new charge. Verification is the gate: there is deliberately no pre-check by bare email (that would let anyone probe whether an address holds billing). Send the verification email, then read the options with the token; an option's fields become `selectedBilling`:
91
91
 
92
92
  ```ts snippet
93
- const { hasActiveBilling } = await board.jobPosting.checkBilling({ email });
94
- if (hasActiveBilling) {
95
- await board.jobPosting.sendBillingVerification({ email }); // emails a token
96
- // …the poster pastes/clicks the token…
97
- const { options } = await board.jobPosting.getBillingOptions({
98
- verificationToken,
99
- });
93
+ await board.jobPosting.sendBillingVerification({ email }); // emails a token
94
+ // …the poster pastes/clicks the token…
95
+ const { options } = await board.jobPosting.getBillingOptions({
96
+ verificationToken,
97
+ });
98
+ if (options.length > 0) {
100
99
  const option = options[0]!;
101
100
  option.jobsRemaining; // capacity left
102
101
  option.featuredRemaining; // featured slots left
@@ -109,19 +108,6 @@ if (hasActiveBilling) {
109
108
  }
110
109
  ```
111
110
 
112
- For subscription holders, gate the "featured" toggle on entitlements:
113
-
114
- ```ts snippet
115
- const ent = await board.jobPosting.checkSubscriptionEntitlements({
116
- email,
117
- planId: plan.id,
118
- });
119
- ent.hasSubscription;
120
- ent.canFeature; // may the wizard offer isFeatured?
121
- ent.featuredSlotsRemaining; // and how many
122
- ent.maxActiveRemaining;
123
- ```
124
-
125
111
  ## Verify
126
112
 
127
113
  - [ ] Every `create` call site handles all four `result.status` variants — no fallthrough that assumes `published`.
@@ -90,7 +90,7 @@ Start the app (dev is fine for this step) and probe its own routes:
90
90
  (idempotent), not a duplicate.
91
91
  - **Paywall** (gated boards): anonymous list shows the `gatedCount` upsell;
92
92
  an entitled login makes the same URL return the ungated view.
93
- - **Alerts**: subscribe → `status: "created"`; repeat → `"duplicate"`.
93
+ - **Alerts**: subscribe → `status: "submitted"`; repeat → same uniform `"submitted"` (never reveals already-subscribed).
94
94
 
95
95
  ## 4 — Production build (mandatory)
96
96
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.35.0",
2
+ "version": "1.35.1",
3
3
  "skills": [
4
4
  {
5
5
  "name": "cavuno-board-account",
@@ -80,7 +80,7 @@
80
80
  },
81
81
  {
82
82
  "name": "cavuno-board-job-posting",
83
- "description": "Build the anonymous \"Post a job\" funnel with the @cavuno/board SDK — jobPosting.plans, create and its status-discriminated JobPostingResult (checkout / published / pending_approval / invoice_sent), logo upload + fetchLogoByDomain, and the email-verified billing helpers (checkBilling, sendBillingVerification, getBillingOptions, checkSubscriptionEntitlements).",
83
+ "description": "Build the anonymous \"Post a job\" funnel with the @cavuno/board SDK — jobPosting.plans, create and its status-discriminated JobPostingResult (checkout / published / pending_approval / invoice_sent), logo upload + fetchLogoByDomain, and the email-verified billing helpers (sendBillingVerification, getBillingOptions).",
84
84
  "path": "skills/cavuno-board-job-posting/SKILL.md",
85
85
  "framework": null,
86
86
  "category": "core"