@aventurevc/api-schemas 0.7.283

package/dist/entity/entity.d.ts

@@ -0,0 +1,109 @@
+import { z } from "zod/v4";
+/**
+ * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Returned directly by thin-mode (?mode=thin) and alphabetical (?letter=X) list endpoints. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
+ *
+ * @openapiSchema Entity
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @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}/fundraise-rounds
+ * @endpoint GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}
+ * @endpoint GET /v1/entities/{entityId}/investments
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/person-investors
+ * @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/{entityId}/similar
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{newsId}/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/lookup/matches
+ * @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 EntityAcceleratorParticipationSchema
+ * @usedBySchema EntityAcquisitionSchema
+ * @usedBySchema EntityDetailSchema
+ * @usedBySchema EntityFundraiseTransactionEntitySchema
+ * @usedBySchema EntityListSchema
+ * @usedBySchema EntityRelationshipSchema
+ * @usedBySchema PageEntitySchema
+ * @usedBySchema PersonGraphCoInvestorSchema
+ * @usedBySchema PersonInvestedCompanySchema
+ * @contractShape entity.entity
+ * @contractRole canonical
+ */
+export declare const EntitySchema: z.ZodObject<{
+    createdAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    foundedYear: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    id: z.ZodUUID;
+    image: z.ZodType<{
+        isMonogram: boolean;
+        logo?: string | null | undefined;
+        logoSquare?: string | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        isMonogram: boolean;
+        logo?: string | null | undefined;
+        logoSquare?: string | null | undefined;
+    }, unknown>>;
+    lastModifiedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    nameAlias: z.ZodArray<z.ZodType<{
+        displayable?: boolean | null | undefined;
+        name: string;
+        type?: "alternativeDba" | "relatedLegal" | null | undefined;
+    }, unknown, z.core.$ZodTypeInternals<{
+        displayable?: boolean | null | undefined;
+        name: string;
+        type?: "alternativeDba" | "relatedLegal" | null | undefined;
+    }, unknown>>>;
+    nameBrand: z.ZodString;
+    nameLegal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operatingStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publicId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publicUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sitemap: z.ZodOptional<z.ZodNullable<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>>>;
+    slug: z.ZodString;
+    typeRecord: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        "Business Line": "Business Line";
+        Company: "Company";
+        Fund: "Fund";
+        Government: "Government";
+        "Investment Firm": "Investment Firm";
+        Nonprofit: "Nonprofit";
+        Organization: "Organization";
+        Product: "Product";
+        Service: "Service";
+    }>>>;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+}, z.core.$strip>;
+export type Entity = z.infer<typeof EntitySchema>;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity/entity.js

@@ -0,0 +1,102 @@
+// 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 { EntityImageSchema } from "./image.js";
+import { EntityNameAliasEntityAliasTypeSchema } from "./name-alias-entity-alias-type.js";
+import { EntitySitemapSchema } from "./sitemap.js";
+import { EntityTypeSchema } from "./type.js";
+/**
+ * Flat entity core record — identity, naming, status, image, and source metadata. An entity is our umbrella record for organizations such as companies, funds, investment firms and investors, accelerators, nonprofits, and government agencies, plus products and services connected to those organizations. Returned directly by thin-mode (?mode=thin) and alphabetical (?letter=X) list endpoints. Nested as .core inside EntityList for default list reads and EntityDetail for detail reads.
+ *
+ * @openapiSchema Entity
+ * @endpoint GET /v1/entities
+ * @endpoint GET /v1/entities/detail
+ * @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}/fundraise-rounds
+ * @endpoint GET /v1/entities/{entityId}/fundraise-rounds/{fundraiseRoundId}
+ * @endpoint GET /v1/entities/{entityId}/investments
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/person-investors
+ * @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/{entityId}/similar
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint GET /v1/news/{newsId}/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/lookup/matches
+ * @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 EntityAcceleratorParticipationSchema
+ * @usedBySchema EntityAcquisitionSchema
+ * @usedBySchema EntityDetailSchema
+ * @usedBySchema EntityFundraiseTransactionEntitySchema
+ * @usedBySchema EntityListSchema
+ * @usedBySchema EntityRelationshipSchema
+ * @usedBySchema PageEntitySchema
+ * @usedBySchema PersonGraphCoInvestorSchema
+ * @usedBySchema PersonInvestedCompanySchema
+ * @contractShape entity.entity
+ * @contractRole canonical
+ */
+export const EntitySchema = z.object({
+    /** Record creation timestamp */
+    createdAt: z.iso.datetime({ offset: true }).nullish(),
+    /** Default currency code (ISO 4217) */
+    defaultCurrency: z.string().nullish(),
+    /** Year the entity was founded */
+    foundedYear: z.int().nullish(),
+    /** Unique entity identifier */
+    id: z.uuid(),
+    /** Logo and monogram image metadata */
+    image: EntityImageSchema,
+    /** Provenance-grounded last-modified watermark (schema.org dateModified). Advances only when a real, consumer-meaningful data point changes via a recorded provenance event — never on timestamp-only writes, migrations, or index refreshes. Pairs with createdAt (dateCreated) and grounds the sitemap lastmod. */
+    lastModifiedAt: z.iso.datetime({ offset: true }).nullish(),
+    /** All names this entity has been known by — current alternates, DBAs, former names, and rebrand-source identities. Naming history (e.g. `Metaphor Systems` for the current `Exa` entity) lives here; never as a separate relationship type or `formerName` field. */
+    nameAlias: z.array(EntityNameAliasEntityAliasTypeSchema),
+    /** Resolved display brand name */
+    nameBrand: z.string(),
+    /** Registered legal name */
+    nameLegal: z.string().nullish(),
+    /** Current operating status. Use Acquired Subsidiary when the entity was acquired and still operates; use Closed (Acquihire) when the entity was acquired for its team and shut down, rendering like Closed everywhere; use Acquired only when it is terminal, folded, or closed. */
+    operatingStatus: z.string().nullish(),
+    /** Stable, immutable public handle (e.g. `eV1StGXR8Z5a`). Never changes once assigned, unlike the slug. Null on projections that do not select it and on rows still awaiting handle backfill. */
+    publicId: z
+        .string()
+        .regex(/^e[0-9A-Za-z]{11}$/)
+        .nullish(),
+    /** Absolute public profile URL on the aVenture front-end, e.g. `https://aventure.vc/non-profits/{slug}`, derived from the typeRecord's canonical route family. Null when the route needs relationship context or the record has no direct public SSR route (Business Line, Organization, Product, Service, or a non-public slug). EntityDetail.publicUrl resolves Business Line parent context. Product/Service pages are provider-nested: compose the provider entity's publicUrl + `/products-services/` + this record's slug, or consume the sitemap-urls slot paths, which already emit the composed child routes. */
+    publicUrl: z.string().nullish(),
+    /** Sub-route eligibility, populated by the sitemap projection. Null on non-sitemap reads to keep thin payloads compact. */
+    sitemap: EntitySitemapSchema.nullish(),
+    /** URL-safe identifier */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255),
+    /** Entity type classification */
+    typeRecord: EntityTypeSchema.nullish(),
+    /** Last modification timestamp */
+    updatedAt: z.iso.datetime({ offset: true }).nullish(),
+});
+//# sourceMappingURL=entity.js.map

package/dist/entity/filter-choice.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const EntityFilterChoiceSchemaDefinition: z.ZodObject<{
+    label: z.ZodString;
+    scope: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        min: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>;
+    value: z.ZodString;
+}, z.core.$strip>;
+type EntityFilterChoiceDefinition = z.infer<typeof EntityFilterChoiceSchemaDefinition>;
+/**
+ * Filter choice payload served by filter endpoints
+ *
+ * @openapiSchema EntityFilterChoice
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterEntrySchema
+ * @contractShape entity.filter-choice
+ * @contractRole canonical
+ */
+export declare const EntityFilterChoiceSchema: z.ZodType<EntityFilterChoiceDefinition>;
+export type EntityFilterChoice = z.infer<typeof EntityFilterChoiceSchema>;
+export {};
+//# sourceMappingURL=filter-choice.d.ts.map

package/dist/entity/filter-choice.js

@@ -0,0 +1,24 @@
+// 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 { EntityFilterScopeSchema } from "./filter-scope.js";
+const EntityFilterChoiceSchemaDefinition = z.object({
+    /** Display label for the option */
+    label: z.string(),
+    /** Optional numeric scope for the option */
+    scope: EntityFilterScopeSchema.nullish(),
+    /** Canonical option value */
+    value: z.string(),
+});
+/**
+ * Filter choice payload served by filter endpoints
+ *
+ * @openapiSchema EntityFilterChoice
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterEntrySchema
+ * @contractShape entity.filter-choice
+ * @contractRole canonical
+ */
+export const EntityFilterChoiceSchema = EntityFilterChoiceSchemaDefinition;
+//# sourceMappingURL=filter-choice.js.map

package/dist/entity/filter-control-type.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+/**
+ * Render control discriminator for filter UI components
+ *
+ * @openapiSchema EntityFilterControlType
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterEntrySchema
+ * @contractShape entity.filter-control-type
+ * @contractRole canonical
+ */
+export declare const EntityFilterControlTypeSchema: z.ZodEnum<{
+    checkbox: "checkbox";
+    currencyRange: "currencyRange";
+    dateRange: "dateRange";
+    range: "range";
+}>;
+export type EntityFilterControlType = z.infer<typeof EntityFilterControlTypeSchema>;
+//# sourceMappingURL=filter-control-type.d.ts.map

package/dist/entity/filter-control-type.js

@@ -0,0 +1,20 @@
+// 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";
+/**
+ * Render control discriminator for filter UI components
+ *
+ * @openapiSchema EntityFilterControlType
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterEntrySchema
+ * @contractShape entity.filter-control-type
+ * @contractRole canonical
+ */
+export const EntityFilterControlTypeSchema = z.enum([
+    "checkbox",
+    "range",
+    "currencyRange",
+    "dateRange",
+]);
+//# sourceMappingURL=filter-control-type.js.map

package/dist/entity/filter-count-meta.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+declare const EntityFilterCountMetaSchemaDefinition: z.ZodObject<{
+    total: z.ZodInt;
+}, z.core.$strip>;
+type EntityFilterCountMetaDefinition = z.infer<typeof EntityFilterCountMetaSchemaDefinition>;
+/**
+ * @openapiSchema EntityFilterCountMeta
+ * @endpoint GET /v1/entities/filters/counts
+ * @endpoint POST /v1/entities/filters/counts
+ * @usedBySchema EntityFilterCountResultSchema
+ * @contractShape entity.filter-count-meta
+ * @contractRole canonical
+ */
+export declare const EntityFilterCountMetaSchema: z.ZodType<EntityFilterCountMetaDefinition>;
+export type EntityFilterCountMeta = z.infer<typeof EntityFilterCountMetaSchema>;
+export {};
+//# sourceMappingURL=filter-count-meta.d.ts.map

package/dist/entity/filter-count-meta.js

@@ -0,0 +1,15 @@
+// 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";
+const EntityFilterCountMetaSchemaDefinition = z.object({
+    total: z.int(),
+});
+/**
+ * @openapiSchema EntityFilterCountMeta
+ * @endpoint GET /v1/entities/filters/counts
+ * @endpoint POST /v1/entities/filters/counts
+ * @usedBySchema EntityFilterCountResultSchema
+ * @contractShape entity.filter-count-meta
+ * @contractRole canonical
+ */
+export const EntityFilterCountMetaSchema = EntityFilterCountMetaSchemaDefinition;
+//# sourceMappingURL=filter-count-meta.js.map

package/dist/entity/filter-count-result.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod/v4";
+declare const EntityFilterCountResultSchemaDefinition: z.ZodObject<{
+    count: z.ZodArray<z.ZodType<{
+        count: number;
+        name: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        count: number;
+        name: string;
+    }, unknown>>>;
+    meta: z.ZodType<{
+        total: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        total: number;
+    }, unknown>>;
+}, z.core.$strip>;
+type EntityFilterCountResultDefinition = z.infer<typeof EntityFilterCountResultSchemaDefinition>;
+/**
+ * @openapiSchema EntityFilterCountResult
+ * @endpoint GET /v1/entities/filters/counts
+ * @endpoint POST /v1/entities/filters/counts
+ * @contractShape entity.filter-count-result
+ * @contractRole canonical
+ */
+export declare const EntityFilterCountResultSchema: z.ZodType<EntityFilterCountResultDefinition>;
+export type EntityFilterCountResult = z.infer<typeof EntityFilterCountResultSchema>;
+export {};
+//# sourceMappingURL=filter-count-result.d.ts.map

package/dist/entity/filter-count-result.js

@@ -0,0 +1,17 @@
+// 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 { EntityFilterCountMetaSchema } from "./filter-count-meta.js";
+import { EntityTagCountSchema } from "./tag-count.js";
+const EntityFilterCountResultSchemaDefinition = z.object({
+    count: z.array(EntityTagCountSchema),
+    meta: EntityFilterCountMetaSchema,
+});
+/**
+ * @openapiSchema EntityFilterCountResult
+ * @endpoint GET /v1/entities/filters/counts
+ * @endpoint POST /v1/entities/filters/counts
+ * @contractShape entity.filter-count-result
+ * @contractRole canonical
+ */
+export const EntityFilterCountResultSchema = EntityFilterCountResultSchemaDefinition;
+//# sourceMappingURL=filter-count-result.js.map

package/dist/entity/filter-count.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+declare const EntityFilterCountSchemaDefinition: z.ZodObject<{
+    minCount: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    name: z.ZodArray<z.ZodString>;
+    size: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    typeRecord: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type EntityFilterCountDefinition = z.infer<typeof EntityFilterCountSchemaDefinition>;
+/**
+ * Entity filter tag count criteria
+ *
+ * @openapiSchema EntityFilterCount
+ * @endpoint POST /v1/entities/filters/counts
+ * @contractShape entity.filter-count
+ * @contractRole canonical
+ */
+export declare const EntityFilterCountSchema: z.ZodType<EntityFilterCountDefinition>;
+export type EntityFilterCount = z.infer<typeof EntityFilterCountSchema>;
+export {};
+//# sourceMappingURL=filter-count.d.ts.map

package/dist/entity/filter-count.js

@@ -0,0 +1,22 @@
+// 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";
+const EntityFilterCountSchemaDefinition = z.object({
+    /** Minimum count threshold */
+    minCount: z.int().min(0).nullish(),
+    /** Tag name values to filter counts */
+    name: z.array(z.string()).max(100),
+    /** Maximum number of results */
+    size: z.int().min(1).max(200).nullish(),
+    /** Entity type (Company, Investment Firm, etc.) */
+    typeRecord: z.string().nullish(),
+});
+/**
+ * Entity filter tag count criteria
+ *
+ * @openapiSchema EntityFilterCount
+ * @endpoint POST /v1/entities/filters/counts
+ * @contractShape entity.filter-count
+ * @contractRole canonical
+ */
+export const EntityFilterCountSchema = EntityFilterCountSchemaDefinition;
+//# sourceMappingURL=filter-count.js.map

package/dist/entity/filter-entry.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod/v4";
+declare const EntityFilterEntrySchemaDefinition: z.ZodObject<{
+    chart: z.ZodArray<z.ZodType<{
+        amount: number;
+        end: number;
+        start: number;
+    }, unknown, z.core.$ZodTypeInternals<{
+        amount: number;
+        end: number;
+        start: number;
+    }, unknown>>>;
+    choiceOption: z.ZodArray<z.ZodType<{
+        label: string;
+        scope?: {
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        } | null | undefined;
+        value: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        label: string;
+        scope?: {
+            max?: number | null | undefined;
+            min?: number | null | undefined;
+        } | null | undefined;
+        value: string;
+    }, unknown>>>;
+    choiceOptionTotal: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    choiceOptionTruncated: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    controlType: z.ZodEnum<{
+        checkbox: "checkbox";
+        currencyRange: "currencyRange";
+        dateRange: "dateRange";
+        range: "range";
+    }>;
+    filterKey: z.ZodString;
+    filterMeta: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        ui: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            headquartersOption: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                country: z.ZodArray<z.ZodType<{
+                    country: string;
+                    state: {
+                        city: string[];
+                        state: string;
+                    }[];
+                }, unknown, z.core.$ZodTypeInternals<{
+                    country: string;
+                    state: {
+                        city: string[];
+                        state: string;
+                    }[];
+                }, unknown>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    label: z.ZodString;
+    scope: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        max: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        min: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>>;
+}, z.core.$strip>;
+type EntityFilterEntryDefinition = z.infer<typeof EntityFilterEntrySchemaDefinition>;
+/**
+ * Filter entry payload served by list filter endpoints
+ *
+ * @openapiSchema EntityFilterEntry
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterOptionSetSchema
+ * @usedBySchema EntityFilterRefinedFiltersSchema
+ * @contractShape entity.filter-entry
+ * @contractRole canonical
+ */
+export declare const EntityFilterEntrySchema: z.ZodType<EntityFilterEntryDefinition>;
+export type EntityFilterEntry = z.infer<typeof EntityFilterEntrySchema>;
+export {};
+//# sourceMappingURL=filter-entry.d.ts.map

package/dist/entity/filter-entry.js

@@ -0,0 +1,41 @@
+// 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 { ChartBucketSchema } from "../chart/bucket.js";
+import { EntityFilterChoiceSchema } from "./filter-choice.js";
+import { EntityFilterControlTypeSchema } from "./filter-control-type.js";
+import { EntityFilterMetaSchema } from "./filter-meta.js";
+import { EntityFilterScopeSchema } from "./filter-scope.js";
+const EntityFilterEntrySchemaDefinition = z.object({
+    /** Chart filter values */
+    chart: z.array(ChartBucketSchema),
+    /** Choice option filter values */
+    choiceOption: z.array(EntityFilterChoiceSchema),
+    /** Total eligible choice option values for this filter */
+    choiceOptionTotal: z.int().nullish(),
+    /** Whether additional eligible choices exist beyond choiceOption */
+    choiceOptionTruncated: z.boolean().nullish(),
+    /** Control type used to render the filter */
+    controlType: EntityFilterControlTypeSchema,
+    /** Canonical filter key */
+    filterKey: z.string(),
+    /** Optional entity-specific filter metadata */
+    filterMeta: EntityFilterMetaSchema.nullish(),
+    /** Display label for the filter */
+    label: z.string(),
+    /** Optional numeric scope for the filter */
+    scope: EntityFilterScopeSchema.nullish(),
+});
+/**
+ * Filter entry payload served by list filter endpoints
+ *
+ * @openapiSchema EntityFilterEntry
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterOptionSetSchema
+ * @usedBySchema EntityFilterRefinedFiltersSchema
+ * @contractShape entity.filter-entry
+ * @contractRole canonical
+ */
+export const EntityFilterEntrySchema = EntityFilterEntrySchemaDefinition;
+//# sourceMappingURL=filter-entry.js.map

package/dist/entity/filter-headquarters-country.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod/v4";
+declare const EntityFilterHeadquartersCountrySchemaDefinition: z.ZodObject<{
+    country: z.ZodString;
+    state: z.ZodArray<z.ZodType<{
+        city: string[];
+        state: string;
+    }, unknown, z.core.$ZodTypeInternals<{
+        city: string[];
+        state: string;
+    }, unknown>>>;
+}, z.core.$strip>;
+type EntityFilterHeadquartersCountryDefinition = z.infer<typeof EntityFilterHeadquartersCountrySchemaDefinition>;
+/**
+ * Country with its states (and optionally cities)
+ *
+ * @openapiSchema EntityFilterHeadquartersCountry
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterHeadquartersOptionSetSchema
+ * @contractShape entity.filter-headquarters-country
+ * @contractRole canonical
+ */
+export declare const EntityFilterHeadquartersCountrySchema: z.ZodType<EntityFilterHeadquartersCountryDefinition>;
+export type EntityFilterHeadquartersCountry = z.infer<typeof EntityFilterHeadquartersCountrySchema>;
+export {};
+//# sourceMappingURL=filter-headquarters-country.d.ts.map

package/dist/entity/filter-headquarters-country.js

@@ -0,0 +1,22 @@
+// 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 { EntityFilterHeadquartersStateCitySchema } from "./filter-headquarters-state-city.js";
+const EntityFilterHeadquartersCountrySchemaDefinition = z.object({
+    /** Country name */
+    country: z.string(),
+    /** States within the country */
+    state: z.array(EntityFilterHeadquartersStateCitySchema),
+});
+/**
+ * Country with its states (and optionally cities)
+ *
+ * @openapiSchema EntityFilterHeadquartersCountry
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterHeadquartersOptionSetSchema
+ * @contractShape entity.filter-headquarters-country
+ * @contractRole canonical
+ */
+export const EntityFilterHeadquartersCountrySchema = EntityFilterHeadquartersCountrySchemaDefinition;
+//# sourceMappingURL=filter-headquarters-country.js.map

package/dist/entity/filter-headquarters-option-set.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod/v4";
+/**
+ * Headquarters option hierarchy
+ *
+ * @openapiSchema EntityFilterHeadquartersOptionSet
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterUiMetaSchema
+ * @contractShape entity.filter-headquarters-option-set
+ * @contractRole canonical
+ */
+export declare const EntityFilterHeadquartersOptionSetSchema: z.ZodObject<{
+    country: z.ZodArray<z.ZodType<{
+        country: string;
+        state: {
+            city: string[];
+            state: string;
+        }[];
+    }, unknown, z.core.$ZodTypeInternals<{
+        country: string;
+        state: {
+            city: string[];
+            state: string;
+        }[];
+    }, unknown>>>;
+}, z.core.$strip>;
+export type EntityFilterHeadquartersOptionSet = z.infer<typeof EntityFilterHeadquartersOptionSetSchema>;
+//# sourceMappingURL=filter-headquarters-option-set.d.ts.map

package/dist/entity/filter-headquarters-option-set.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 { EntityFilterHeadquartersCountrySchema } from "./filter-headquarters-country.js";
+/**
+ * Headquarters option hierarchy
+ *
+ * @openapiSchema EntityFilterHeadquartersOptionSet
+ * @endpoint GET /v1/entities/filters
+ * @endpoint GET /v1/people/filters
+ * @endpoint POST /v1/entities/filters/refine
+ * @usedBySchema EntityFilterUiMetaSchema
+ * @contractShape entity.filter-headquarters-option-set
+ * @contractRole canonical
+ */
+export const EntityFilterHeadquartersOptionSetSchema = z.object({
+    /** Countries with their states and cities */
+    country: z.array(EntityFilterHeadquartersCountrySchema),
+});
+//# sourceMappingURL=filter-headquarters-option-set.js.map