@aventurevc/api-schemas 0.7.272

package/dist/entity/similarity-result.js

@@ -0,0 +1,19 @@
+// 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
+import { z } from "zod/v4";
+import { EntityListSchema } from "./list.js";
+import { EntitySimilarityContextSchema } from "./similarity-context.js";
+const EntitySimilarityResultSchemaDefinition = z.object({
+    entity: EntityListSchema,
+    similarity: EntitySimilarityContextSchema,
+});
+/**
+ * Similar entity list row with the provenance that explains why it appears. Rows carry the EntityList projection; load full detail through the entity detail endpoints.
+ *
+ * @openapiSchema EntitySimilarityResult
+ * @endpoint GET /v1/entities/detail/similar
+ * @usedBySchema PageEntitySimilarityResultSchema
+ * @contractShape entity.similarity-result
+ * @contractRole canonical
+ */
+export const EntitySimilarityResultSchema = EntitySimilarityResultSchemaDefinition;
+//# sourceMappingURL=similarity-result.js.map

package/dist/entity/sitemap-url-type.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod/v4";
+/**
+ * Canonical entity sitemap URL slot kind.
+ *
+ * @openapiSchema EntitySitemapUrlType
+ * @endpoint GET /v1/sitemap/entities/urls
+ * @usedBySchema EntitySitemapUrlSchema
+ * @contractShape entity.sitemap-url-type
+ * @contractRole canonical
+ */
+export declare const EntitySitemapUrlTypeSchema: z.ZodEnum<{
+    acquisitions: "acquisitions";
+    analysis: "analysis";
+    employees: "employees";
+    fundraising: "fundraising";
+    news: "news";
+    overview: "overview";
+    productService: "productService";
+}>;
+export type EntitySitemapUrlType = z.infer<typeof EntitySitemapUrlTypeSchema>;
+//# sourceMappingURL=sitemap-url-type.d.ts.map

package/dist/entity/sitemap-url-type.js

@@ -0,0 +1,21 @@
+// 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
+import { z } from "zod/v4";
+/**
+ * Canonical entity sitemap URL slot kind.
+ *
+ * @openapiSchema EntitySitemapUrlType
+ * @endpoint GET /v1/sitemap/entities/urls
+ * @usedBySchema EntitySitemapUrlSchema
+ * @contractShape entity.sitemap-url-type
+ * @contractRole canonical
+ */
+export const EntitySitemapUrlTypeSchema = z.enum([
+    "overview",
+    "acquisitions",
+    "analysis",
+    "fundraising",
+    "employees",
+    "news",
+    "productService",
+]);
+//# sourceMappingURL=sitemap-url-type.js.map

package/dist/entity/sitemap-url.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod/v4";
+declare const EntitySitemapUrlSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodUUID;
+    lastUpdatedAt: z.ZodISODateTime;
+    path: z.ZodString;
+    productServiceSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    slotKey: z.ZodString;
+    slug: z.ZodString;
+    typeRecord: z.ZodEnum<{
+        "Business Line": "Business Line";
+        Company: "Company";
+        Fund: "Fund";
+        Government: "Government";
+        "Investment Firm": "Investment Firm";
+        Nonprofit: "Nonprofit";
+        Organization: "Organization";
+        Product: "Product";
+        Service: "Service";
+    }>;
+    urlType: z.ZodEnum<{
+        acquisitions: "acquisitions";
+        analysis: "analysis";
+        employees: "employees";
+        fundraising: "fundraising";
+        news: "news";
+        overview: "overview";
+        productService: "productService";
+    }>;
+}, z.core.$strip>;
+type EntitySitemapUrlDefinition = z.infer<typeof EntitySitemapUrlSchemaDefinition>;
+/**
+ * Concrete entity sitemap URL slot with backend-owned path and lastmod.
+ *
+ * @openapiSchema EntitySitemapUrl
+ * @endpoint GET /v1/sitemap/entities/urls
+ * @usedBySchema PageEntitySitemapUrlSchema
+ * @contractShape entity.sitemap-url
+ * @contractRole canonical
+ */
+export declare const EntitySitemapUrlSchema: z.ZodType<EntitySitemapUrlDefinition>;
+export type EntitySitemapUrl = z.infer<typeof EntitySitemapUrlSchema>;
+export {};
+//# sourceMappingURL=sitemap-url.d.ts.map

package/dist/entity/sitemap-url.js

@@ -0,0 +1,40 @@
+// 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
+import { z } from "zod/v4";
+import { EntitySitemapUrlTypeSchema } from "./sitemap-url-type.js";
+import { EntityTypeSchema } from "./type.js";
+const EntitySitemapUrlSchemaDefinition = z.object({
+    /** Entity that owns this sitemap URL slot. */
+    entityId: z.uuid(),
+    /** Latest backend update timestamp affecting this concrete URL. */
+    lastUpdatedAt: z.iso.datetime({ offset: true }),
+    /** Backend-owned public path, relative to the production origin. */
+    path: z.string(),
+    /** Product/service child slug for productService slots. */
+    productServiceSlug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .nullish(),
+    /** Stable cursor and dedupe key for this sitemap URL slot. */
+    slotKey: z.string(),
+    /** Canonical entity slug. */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255),
+    /** Canonical entity type for the owning entity. */
+    typeRecord: EntityTypeSchema,
+    /** Kind of entity URL represented by this slot. */
+    urlType: EntitySitemapUrlTypeSchema,
+});
+/**
+ * Concrete entity sitemap URL slot with backend-owned path and lastmod.
+ *
+ * @openapiSchema EntitySitemapUrl
+ * @endpoint GET /v1/sitemap/entities/urls
+ * @usedBySchema PageEntitySitemapUrlSchema
+ * @contractShape entity.sitemap-url
+ * @contractRole canonical
+ */
+export const EntitySitemapUrlSchema = EntitySitemapUrlSchemaDefinition;
+//# sourceMappingURL=sitemap-url.js.map

package/dist/entity/sitemap.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod/v4";
+/**
+ * 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). A `false` flag when you know the data exists means an unmet visibility prerequisite -- publish the hidden entity -- confirmed against the owning command-side read; it is an active gate result, not refresh lag, and a flag being `false` says nothing succeeded-and-is-fine. Served from a materialized projection (`mv_entity_sitemap_url_slots`) refreshed asynchronously, so a `true` flag can trail a gate that was just satisfied, but a successful write alone does not flip any flag.
+ *
+ * @openapiSchema EntitySitemap
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/fundraise-rounds
+ * @endpoint GET /v1/entities/detail/investments
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/investments
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/sitemap/entities/routes
+ * @endpoint GET /v1/addresses/locations/{scope}/{slug}
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/acquisitions
+ * @endpoint GET /v1/entities/{entityId}/acquisitions/{relationshipId}
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @endpoint GET /v1/entities/{entityId}/research
+ * @endpoint GET /v1/entities/detail/fundraise-rounds/{transactionId}
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{id}/related-companies
+ * @endpoint GET /v1/people/{personId}
+ * @endpoint GET /v1/people/{personId}/graph
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/detail/batch
+ * @endpoint POST /v1/people/lookup/batch
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityDetailSchema
+ * @usedBySchema EntitySchema
+ * @contractShape entity.sitemap
+ * @contractRole canonical
+ */
+export declare const EntitySitemapSchema: z.ZodObject<{
+    hasAcquisitions: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    hasAnalysis: z.ZodBoolean;
+    hasEmployees: z.ZodBoolean;
+    hasFundraising: z.ZodBoolean;
+    hasNews: z.ZodBoolean;
+    productServiceSlug: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type EntitySitemap = z.infer<typeof EntitySitemapSchema>;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/entity/sitemap.js

@@ -0,0 +1,63 @@
+// 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
+import { z } from "zod/v4";
+/**
+ * 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). A `false` flag when you know the data exists means an unmet visibility prerequisite -- publish the hidden entity -- confirmed against the owning command-side read; it is an active gate result, not refresh lag, and a flag being `false` says nothing succeeded-and-is-fine. Served from a materialized projection (`mv_entity_sitemap_url_slots`) refreshed asynchronously, so a `true` flag can trail a gate that was just satisfied, but a successful write alone does not flip any flag.
+ *
+ * @openapiSchema EntitySitemap
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/fundraise-rounds
+ * @endpoint GET /v1/entities/detail/investments
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/detail/person-investors
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/entities/summary
+ * @endpoint GET /v1/people/detail
+ * @endpoint GET /v1/people/detail/investments
+ * @endpoint GET /v1/people/lookup
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/sitemap/entities/routes
+ * @endpoint GET /v1/addresses/locations/{scope}/{slug}
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/acquisitions
+ * @endpoint GET /v1/entities/{entityId}/acquisitions/{relationshipId}
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @endpoint GET /v1/entities/{entityId}/research
+ * @endpoint GET /v1/entities/detail/fundraise-rounds/{transactionId}
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{id}/related-companies
+ * @endpoint GET /v1/people/{personId}
+ * @endpoint GET /v1/people/{personId}/graph
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @endpoint POST /v1/entities/natural-search
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/people/batch
+ * @endpoint POST /v1/people/detail/batch
+ * @endpoint POST /v1/people/lookup/batch
+ * @endpoint POST /v1/search/all
+ * @usedBySchema EntityDetailSchema
+ * @usedBySchema EntitySchema
+ * @contractShape entity.sitemap
+ * @contractRole canonical
+ */
+export const EntitySitemapSchema = z.object({
+    /** 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 with this flag `false` (or with `entities acquisitions list` returning zero rows) means a counterpart entity is still hidden -- publish it -- it is a visibility gate, not list lag. */
+    hasAcquisitions: z.boolean().default(false).optional(),
+    /** Whether the profile Analysis sub-route should be emitted. */
+    hasAnalysis: z.boolean(),
+    /** Whether the profile Employees sub-route should be emitted. */
+    hasEmployees: z.boolean(),
+    /** Whether the profile Fundraising sub-route should be emitted. */
+    hasFundraising: z.boolean(),
+    /** Whether the profile News sub-route should be emitted. */
+    hasNews: z.boolean(),
+    /** Slugs of related Product/Service entities that should each get their own `/companies/<slug>/products-services/<productSlug>` URL, capped at `MAX_PRODUCT_SERVICE_SLUGS` server-side. Derived from current `productService` relationships in either stored direction; the entity relationships resource is the authoritative, read-your-writes view of those joins. */
+    productServiceSlug: z.array(z.string()),
+});
+//# sourceMappingURL=sitemap.js.map