@aventurevc/api-schemas 0.7.272

package/dist/entity/comparison-signals.d.ts

@@ -0,0 +1,66 @@
+import { z } from "zod/v4";
+/**
+ * Competitive comparison signals for a provider entity — sells-to customers, pricing model, ownership, funding stage, total raised, and website. Projected from entity enrichment for side-by-side comparison; founded year rides the entity core.
+ *
+ * @openapiSchema EntityComparisonSignals
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/relationships
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @usedBySchema EntityRelationshipSchema
+ * @contractShape entity.comparison-signals
+ * @contractRole canonical
+ */
+export declare const EntityComparisonSignalsSchema: z.ZodObject<{
+    fundingStage: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        Acquired: "Acquired";
+        "Acquired Subsidiary": "Acquired Subsidiary";
+        Angel: "Angel";
+        Fund: "Fund";
+        Government: "Government";
+        "Investment Firm": "Investment Firm";
+        Nonprofit: "Nonprofit";
+        "Pre-Seed": "Pre-Seed";
+        Public: "Public";
+        Seed: "Seed";
+        "Series A": "Series A";
+        "Series B": "Series B";
+        "Series C": "Series C";
+        "Series D": "Series D";
+        "Series E": "Series E";
+        "Series F": "Series F";
+        "Series G": "Series G";
+        "Series H": "Series H";
+        "Series I": "Series I";
+        "Series J": "Series J";
+        "Series K": "Series K";
+        "Series L": "Series L";
+        "Series M": "Series M";
+        "Series N": "Series N";
+        "Series O": "Series O";
+        "Series P": "Series P";
+        "Series Q": "Series Q";
+        "Series R": "Series R";
+        "Series S": "Series S";
+        "Series T": "Series T";
+        "Series U": "Series U";
+        "Series V": "Series V";
+        "Series W": "Series W";
+        "Series X": "Series X";
+        "Series Y": "Series Y";
+        "Series Z": "Series Z";
+    }>>>;
+    ownership: z.ZodArray<z.ZodString>;
+    pricingModel: z.ZodArray<z.ZodString>;
+    sellsTo: z.ZodArray<z.ZodString>;
+    totalRaised: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    website: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type EntityComparisonSignals = z.infer<typeof EntityComparisonSignalsSchema>;
+//# sourceMappingURL=comparison-signals.d.ts.map

package/dist/entity/comparison-signals.js

@@ -0,0 +1,36 @@
+// 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 { FundingStageSchema } from "../funding/stage.js";
+/**
+ * Competitive comparison signals for a provider entity — sells-to customers, pricing model, ownership, funding stage, total raised, and website. Projected from entity enrichment for side-by-side comparison; founded year rides the entity core.
+ *
+ * @openapiSchema EntityComparisonSignals
+ * @endpoint GET /v1/entities/detail
+ * @endpoint GET /v1/entities/detail/investors
+ * @endpoint GET /v1/entities/lookup
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/relationships
+ * @endpoint GET /v1/entities/relationships/{relationshipId}
+ * @endpoint POST /v1/entities/batch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @usedBySchema EntityRelationshipSchema
+ * @contractShape entity.comparison-signals
+ * @contractRole canonical
+ */
+export const EntityComparisonSignalsSchema = z.object({
+    /** Latest funding stage when known */
+    fundingStage: FundingStageSchema.nullish(),
+    /** Provider ownership structure (current typeOwnership tags) */
+    ownership: z.array(z.string()),
+    /** Provider pricing/revenue model (current typeRevenue tags) */
+    pricingModel: z.array(z.string()),
+    /** Customer types the provider sells to (current typeCustomer tags) */
+    sellsTo: z.array(z.string()),
+    /** Total capital raised when known */
+    totalRaised: z.number().nullish(),
+    /** Provider website URL when known */
+    website: z.string().nullish(),
+});
+//# sourceMappingURL=comparison-signals.js.map

package/dist/entity/detail-batch-param.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+export declare const ENTITY_DETAIL_BATCH_ENDPOINT: "/v1/entities/detail/batch";
+/**
+ * Request-side query params for `POST /v1/entities/detail/batch`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/entities/detail/batch
+ * @contractShape entity.detail-batch-param
+ * @contractRole canonical
+ */
+export declare const EntityDetailBatchParamSchema: z.ZodObject<{
+    includePrivate: z.ZodOptional<z.ZodBoolean>;
+    page: z.ZodOptional<z.ZodInt>;
+    size: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+export type EntityDetailBatchParam = z.infer<typeof EntityDetailBatchParamSchema>;
+//# sourceMappingURL=detail-batch-param.d.ts.map

package/dist/entity/detail-batch-param.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";
+export const ENTITY_DETAIL_BATCH_ENDPOINT = "/v1/entities/detail/batch";
+/**
+ * Request-side query params for `POST /v1/entities/detail/batch`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/entities/detail/batch
+ * @contractShape entity.detail-batch-param
+ * @contractRole canonical
+ */
+export const EntityDetailBatchParamSchema = z.object({
+    /** Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published entities are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    includePrivate: z.boolean().optional(),
+    /** Zero-based page index (0..N); omit page and size for the full batch. */
+    page: z.int().optional(),
+    /** The size of the page to be returned; omit page and size for the full batch. */
+    size: z.int().optional(),
+});
+//# sourceMappingURL=detail-batch-param.js.map

package/dist/entity/detail-batch.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+declare const EntityDetailBatchSchemaDefinition: z.ZodObject<{
+    entityId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    permitMonogram: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodBoolean>>>;
+    slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    url: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type EntityDetailBatchDefinition = z.infer<typeof EntityDetailBatchSchemaDefinition>;
+/**
+ * Batch request for entity detail retrieval by id, slug, or current joined URL
+ *
+ * @openapiSchema EntityDetailBatch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @contractShape entity.detail-batch
+ * @contractRole canonical
+ */
+export declare const EntityDetailBatchSchema: z.ZodType<EntityDetailBatchDefinition>;
+export type EntityDetailBatch = z.infer<typeof EntityDetailBatchSchema>;
+export {};
+//# sourceMappingURL=detail-batch.d.ts.map

package/dist/entity/detail-batch.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";
+const EntityDetailBatchSchemaDefinition = z.strictObject({
+    /** Entity UUID values */
+    entityId: z.array(z.uuid()).optional(),
+    /** Permit monogram fallbacks */
+    permitMonogram: z.boolean().nullable().default(true).optional(),
+    /** Entity slug values */
+    slug: z.array(z.string()).optional(),
+    /** Current joined entity URL values */
+    url: z.array(z.string()).optional(),
+});
+/**
+ * Batch request for entity detail retrieval by id, slug, or current joined URL
+ *
+ * @openapiSchema EntityDetailBatch
+ * @endpoint POST /v1/entities/detail/batch
+ * @endpoint POST /v1/entities/detail/resolve
+ * @endpoint POST /v1/entities/lookup/batch
+ * @contractShape entity.detail-batch
+ * @contractRole canonical
+ */
+export const EntityDetailBatchSchema = EntityDetailBatchSchemaDefinition;
+//# sourceMappingURL=detail-batch.js.map

package/dist/entity/detail-coverage-slot.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+declare const EntityDetailCoverageSlotSchemaDefinition: z.ZodObject<{
+    count: z.ZodInt;
+    coverage: z.ZodEnum<{
+        ABSENT: "ABSENT";
+        NOT_EVALUABLE: "NOT_EVALUABLE";
+        PRESENT: "PRESENT";
+    }>;
+    gateId: z.ZodString;
+    howToObtain: z.ZodString;
+    label: z.ZodString;
+    owningRead: z.ZodString;
+    parentPersonId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    parentProductServiceId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    required: z.ZodBoolean;
+    unobtainableAllowed: z.ZodBoolean;
+}, z.core.$strip>;
+type EntityDetailCoverageSlotDefinition = z.infer<typeof EntityDetailCoverageSlotSchemaDefinition>;
+/**
+ * One completion gate evaluated against the assembled entity detail.
+ *
+ * @openapiSchema EntityDetailCoverageSlot
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @usedBySchema EntitySuggestionResultSchema
+ * @contractShape entity.detail-coverage-slot
+ * @contractRole canonical
+ */
+export declare const EntityDetailCoverageSlotSchema: z.ZodType<EntityDetailCoverageSlotDefinition>;
+export type EntityDetailCoverageSlot = z.infer<typeof EntityDetailCoverageSlotSchema>;
+export {};
+//# sourceMappingURL=detail-coverage-slot.d.ts.map

package/dist/entity/detail-coverage-slot.js

@@ -0,0 +1,37 @@
+// 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 { CompletionGateCoverageSchema } from "../completion/gate-coverage.js";
+const EntityDetailCoverageSlotSchemaDefinition = z.object({
+    /** Resolved row/value count backing this gate. */
+    count: z.int(),
+    /** Coverage verdict for this gate on the assembled detail. NOT_EVALUABLE means the detail does not carry the gate, so it is neither satisfied nor unsatisfied here — grade it from owningRead instead of treating it as an unmet gate. */
+    coverage: CompletionGateCoverageSchema,
+    /** Canonical dotted completion gate id. */
+    gateId: z.string(),
+    /** What to do to obtain this gate when it is not present. */
+    howToObtain: z.string(),
+    /** Human-readable gate name. */
+    label: z.string(),
+    /** OpenAPI operationId of the canonical read that proves the gate. */
+    owningRead: z.string(),
+    /** Parent person this slot was instantiated for when indexed per person. Null on flat and Product/Service-indexed gates. Two per-person slots sharing a gateId are distinguished by this id; per-person slots remain advisory rather than required. */
+    parentPersonId: z.uuid().nullish(),
+    /** Parent Product/Service this slot was instantiated for when indexed per offering. Null on flat and per-person gates. Required Product/Service slots sharing a gateId are addressed independently by this id. */
+    parentProductServiceId: z.uuid().nullish(),
+    /** Whether this read can decide and demand the gate. True for mandatory flat-floor gates and for server-decidable indexed Product/Service gates. False for indexed per-person slots: their source-backed unobtainable relief lives only in the run completion ledger, so the server cannot terminally decide them. */
+    required: z.boolean(),
+    /** Whether the governed completion contract permits source-backed unobtainable evidence to relieve this exact absent slot. */
+    unobtainableAllowed: z.boolean(),
+});
+/**
+ * One completion gate evaluated against the assembled entity detail.
+ *
+ * @openapiSchema EntityDetailCoverageSlot
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @usedBySchema EntitySuggestionResultSchema
+ * @contractShape entity.detail-coverage-slot
+ * @contractRole canonical
+ */
+export const EntityDetailCoverageSlotSchema = EntityDetailCoverageSlotSchemaDefinition;
+//# sourceMappingURL=detail-coverage-slot.js.map

package/dist/entity/detail-similar-param.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+export declare const ENTITY_DETAIL_SIMILAR_ENDPOINT: "/v1/entities/detail/similar";
+/**
+ * Request-side query params for `GET /v1/entities/detail/similar`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/entities/detail/similar
+ * @contractShape entity.detail-similar-param
+ * @contractRole canonical
+ */
+export declare const EntityDetailSimilarParamSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodUUID>;
+    page: z.ZodOptional<z.ZodDefault<z.ZodInt>>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+    relationshipType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodDefault<z.ZodInt>>;
+    slug: z.ZodOptional<z.ZodString>;
+    typeRecord: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type EntityDetailSimilarParam = z.infer<typeof EntityDetailSimilarParamSchema>;
+//# sourceMappingURL=detail-similar-param.d.ts.map

package/dist/entity/detail-similar-param.js

@@ -0,0 +1,33 @@
+// 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";
+export const ENTITY_DETAIL_SIMILAR_ENDPOINT = "/v1/entities/detail/similar";
+/**
+ * Request-side query params for `GET /v1/entities/detail/similar`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint GET /v1/entities/detail/similar
+ * @contractShape entity.detail-similar-param
+ * @contractRole canonical
+ */
+export const EntityDetailSimilarParamSchema = z.object({
+    /** Entity unique identifier (UUID) — at least one of id or slug required */
+    id: z.uuid().optional(),
+    /** Zero-based page index (0..N) */
+    page: z.int().min(0).default(0).optional(),
+    /** Permit monogram fallback */
+    permitMonogram: z.boolean().optional(),
+    /** Filter by stored relationship type, one of: acceleratorParticipant, acquirer, affinity, calculated, competingProductService, competitor, customer, fundManagerFirm, parent, productService, serviceProvider, similarCompany, spinOffFrom, successor. */
+    relationshipType: z.string().optional(),
+    /** The size of the page to be returned */
+    size: z.int().min(1).default(10).optional(),
+    /** Entity URL-friendly identifier (slug) — at least one of id or slug required */
+    slug: z
+        .string()
+        .regex(/^[a-z0-9_-]+$/)
+        .max(255)
+        .optional(),
+    /** Optional entity typeRecord filter. Repeat to allow multiple entity types. */
+    typeRecord: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=detail-similar-param.js.map