@aventurevc/api-schemas 0.8.374 → 0.8.375

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,6 +1,6 @@
1
1
  import { z } from "zod/v4";
2
2
  /**
3
- * Sub-route eligibility GATE for sitemap.xml emission, not a write receipt. Each boolean is true only when the underlying rows EXIST AND every entity that sub-route renders (this entity and any counterpart, e.g. the acquired/acquirer company behind `hasAcquisitions`) currently passes publication visibility (not hidden, on sitemap). Served from the materialized projection `mv_entity_sitemap_url_slots`, which the `sitemap-boundaries-refresh` job rebuilds on `app.materialized-view-refresh.sitemap-boundaries.interval` and which skips write-driven requests within its `min-success-interval` of the last performed refresh. A `false` flag whose qualifying write is newer than that refresh (the `Last-Modified` time that sitemap reads report) is refresh lag that clears on the next performed refresh; polling sooner changes nothing. A `false` flag whose write is older than that refresh is the gate result: an unmet visibility prerequisite -- publish the hidden entity -- confirmed against the owning command-side read.
3
+ * Sub-route eligibility GATE for sitemap.xml emission, not a write receipt. Each boolean is true only when the underlying rows EXIST AND every entity that sub-route renders (this entity and any counterpart, e.g. the acquired/acquirer company behind `hasAcquisitions`) currently passes publication visibility (not hidden, on sitemap). Served from a materialized projection that a scheduled refresh rebuilds; refresh requests made soon after a completed refresh are skipped until the next scheduled run, so polling sooner changes nothing. A `false` flag whose qualifying write committed after the last refresh started is refresh lag that clears on the next refresh. A `false` flag whose write predates that refresh is the gate result: an unmet visibility prerequisite -- publish the hidden entity -- confirmed against the owning command-side read.
4
4
  *
5
5
  * @openapiSchema EntitySitemap
6
6
  * @endpoint GET /v1/entities/brand
@@ -1,7 +1,7 @@
1
1
  // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
2
2
  import { z } from "zod/v4";
3
3
  /**
4
- * Sub-route eligibility GATE for sitemap.xml emission, not a write receipt. Each boolean is true only when the underlying rows EXIST AND every entity that sub-route renders (this entity and any counterpart, e.g. the acquired/acquirer company behind `hasAcquisitions`) currently passes publication visibility (not hidden, on sitemap). Served from the materialized projection `mv_entity_sitemap_url_slots`, which the `sitemap-boundaries-refresh` job rebuilds on `app.materialized-view-refresh.sitemap-boundaries.interval` and which skips write-driven requests within its `min-success-interval` of the last performed refresh. A `false` flag whose qualifying write is newer than that refresh (the `Last-Modified` time that sitemap reads report) is refresh lag that clears on the next performed refresh; polling sooner changes nothing. A `false` flag whose write is older than that refresh is the gate result: an unmet visibility prerequisite -- publish the hidden entity -- confirmed against the owning command-side read.
4
+ * Sub-route eligibility GATE for sitemap.xml emission, not a write receipt. Each boolean is true only when the underlying rows EXIST AND every entity that sub-route renders (this entity and any counterpart, e.g. the acquired/acquirer company behind `hasAcquisitions`) currently passes publication visibility (not hidden, on sitemap). Served from a materialized projection that a scheduled refresh rebuilds; refresh requests made soon after a completed refresh are skipped until the next scheduled run, so polling sooner changes nothing. A `false` flag whose qualifying write committed after the last refresh started is refresh lag that clears on the next refresh. A `false` flag whose write predates that refresh is the gate result: an unmet visibility prerequisite -- publish the hidden entity -- confirmed against the owning command-side read.
5
5
  *
6
6
  * @openapiSchema EntitySitemap
7
7
  * @endpoint GET /v1/entities/brand
@@ -48,7 +48,7 @@ import { z } from "zod/v4";
48
48
  * @contractRole canonical
49
49
  */
50
50
  export const EntitySitemapSchema = z.object({
51
- /** Whether `/companies/<slug>/acquisitions` should be emitted. True only when an acquisition relationship exists AND both the acquired and acquirer entities are publicly visible. A confirmed acquisition relationship row older than the projection's last refresh with this flag `false` (or with `entities acquisitions list` returning zero rows) means a counterpart entity is still hidden -- publish it; a newer row is refresh lag (see `EntitySitemap`). */
51
+ /** Whether `/companies/<slug>/acquisitions` should be emitted. True only when an acquisition relationship exists AND both the acquired and acquirer entities are publicly visible. `entities acquisitions list` returning zero rows for a confirmed acquisition relationship always means a counterpart entity is still hidden -- publish it; that list reads live rows and never lags. A `false` flag on a row newer than the last refresh is refresh lag (see `EntitySitemap`). */
52
52
  hasAcquisitions: z.boolean().default(false).optional(),
53
53
  /** Whether the profile Analysis sub-route should be emitted. */
54
54
  hasAnalysis: z.boolean(),
@@ -63,6 +63,7 @@ export declare const ProblemDetailSchema: z.ZodObject<{
63
63
  clerk_m2m_unavailable: "clerk_m2m_unavailable";
64
64
  clerk_oauth_unavailable: "clerk_oauth_unavailable";
65
65
  cvc_inherited_headcount: "cvc_inherited_headcount";
66
+ entity_name_casing_rejected: "entity_name_casing_rejected";
66
67
  frontend_cache_epoch_mode_not_targeted: "frontend_cache_epoch_mode_not_targeted";
67
68
  fundraise_evidence_unsupported: "fundraise_evidence_unsupported";
68
69
  geocode_provider_error: "geocode_provider_error";
@@ -66,6 +66,8 @@ export const ProblemDetailSchema = z.object({
66
66
  "suspected_shell_strip",
67
67
  /** Entity text or a research snippet failed its prose judge or contract. Rewrite every ProblemDetail.proseViolation passage and resend the whole text. ProblemDetail.hint names an override only when every violation is overridable. */
68
68
  "prose_rejected",
69
+ /** Name casing failed policy or source check; follow ProblemDetail.hint. */
70
+ "entity_name_casing_rejected",
69
71
  /** Cited source does not establish this round or role; follow its detail. */
70
72
  "fundraise_evidence_unsupported",
71
73
  /** Not the company's own live site; settle its state, then see detail. */
@@ -5,7 +5,7 @@ import { SearchAnswerWebSourceSchema } from "./answer-web-source.js";
5
5
  const SearchAnswerParagraphSchemaDefinition = z.object({
6
6
  /** Evidence this paragraph rests on, most important first. */
7
7
  citation: z.array(SearchAnswerCitationSchema),
8
- /** Paragraph text in plain prose, including attributed unchanged source quotations. */
8
+ /** Paragraph text in plain prose, including unchanged source quotations, attributed except on a quoted company profile. */
9
9
  text: z.string(),
10
10
  /** Short label naming the category, market, or segment this paragraph covers, such as "Smartphones · North America"; absent on the lead paragraph. */
11
11
  topic: z.string().nullish(),
@@ -34,7 +34,7 @@ export const SearchAnswerSchema = z.object({
34
34
  description: z.string().nullish(),
35
35
  /** The question as the answer page's heading: the asker's own words in title case, with record names in their stored casing; it never adds, drops, or corrects a word. Absent when the answer abstains. */
36
36
  heading: z.string().nullish(),
37
- /** The answer's paragraphs in reading order, each citing the evidence it rests on; empty when the answer abstains. A first paragraph without `topic` is the lead, written as a standalone answer of one or two sentences that reads complete when shown alone; later paragraphs expand it by topic without restating it. Source financial answers render recorded funding facts literally, followed by attributed unchanged admitted source passages; a recorded total is not a round. */
37
+ /** The answer's paragraphs in reading order, each citing the evidence it rests on; empty when the answer abstains. A first paragraph without `topic` is the lead, written as a standalone answer of one or two sentences that reads complete when shown alone; later paragraphs expand it by topic without restating it. Source financial answers render recorded funding facts literally; a requested company profile follows the lead as one quoted "Products and services" paragraph, then other recorded transactions and attributed unchanged admitted source passages; a recorded total is not a round. */
38
38
  paragraph: z.array(SearchAnswerParagraphSchema),
39
39
  /** Up to five follow-up searches grounded in the cited evidence; empty when the answer abstains. */
40
40
  relatedQuery: z.array(z.string()),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aventurevc/api-schemas",
3
- "version": "0.8.374",
3
+ "version": "0.8.375",
4
4
  "private": false,
5
5
  "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
6
6
  "license": "Apache-2.0",