@aventurevc/api-schemas 0.8.421 → 0.8.423

package/dist/entity/detail.d.ts

@@ -4265,6 +4265,15 @@ export declare const EntityDetailSchema: z.ZodObject<{
             valueResearchDetail?: string | null | undefined;
             valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
         }[];
+        financial?: {
+            currency: string | null;
+            entityId: string;
+            functionalCurrency: string | null;
+            id: number;
+            period: string;
+            revenue: string | null;
+            year: number;
+        }[] | null | undefined;
         snippet: {
             compliance?: {
                 characterCount: number;
@@ -4364,6 +4373,15 @@ export declare const EntityDetailSchema: z.ZodObject<{
             valueResearchDetail?: string | null | undefined;
             valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
         }[];
+        financial?: {
+            currency: string | null;
+            entityId: string;
+            functionalCurrency: string | null;
+            id: number;
+            period: string;
+            revenue: string | null;
+            year: number;
+        }[] | null | undefined;
         snippet: {
             compliance?: {
                 characterCount: number;

package/dist/entity/financial.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod/v4";
+declare const EntityFinancialSchemaDefinition: z.ZodObject<{
+    currency: z.ZodNullable<z.ZodString>;
+    entityId: z.ZodUUID;
+    functionalCurrency: z.ZodNullable<z.ZodString>;
+    id: z.ZodInt;
+    period: z.ZodString;
+    revenue: z.ZodNullable<z.ZodString>;
+    year: z.ZodInt;
+}, z.core.$strip>;
+type EntityFinancialDefinition = z.infer<typeof EntityFinancialSchemaDefinition>;
+export interface EntityFinancialSchemaInput extends z.input<typeof EntityFinancialSchemaDefinition> {
+}
+/**
+ * Stored financial facts for one exact year and period
+ *
+ * @openapiSchema EntityFinancial
+ * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/research
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/entities/lookup-batch
+ * @endpoint POST /v1/entities/lookup-matches
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema EntityResearchSchema
+ * @contractShape entity.financial
+ * @contractRole canonical
+ */
+export declare const EntityFinancialSchema: z.ZodType<EntityFinancialDefinition, EntityFinancialSchemaInput>;
+export type EntityFinancial = z.infer<typeof EntityFinancialSchema>;
+export {};
+//# sourceMappingURL=financial.d.ts.map

package/dist/entity/financial.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";
+const EntityFinancialSchemaDefinition = z.object({
+    /** Stored revenue currency, when known */
+    currency: z.string().nullable(),
+    /** Entity that owns this financial row */
+    entityId: z.uuid(),
+    /** Stored functional currency, independent of revenue currency */
+    functionalCurrency: z.string().nullable(),
+    /** Financial row ID for the existing private provenance read */
+    id: z.int(),
+    /** Exact stored period token */
+    period: z.string().max(6),
+    /** Exact stored integer revenue as text; no FX or scale adjustment */
+    revenue: z.string().nullable(),
+    /** Stored reporting year */
+    year: z.int(),
+});
+/**
+ * Stored financial facts for one exact year and period
+ *
+ * @openapiSchema EntityFinancial
+ * @endpoint GET /v1/entities/lookup-exact
+ * @endpoint GET /v1/search/link
+ * @endpoint GET /v1/entities/{entityId}
+ * @endpoint GET /v1/entities/{entityId}/investors
+ * @endpoint GET /v1/entities/{entityId}/research
+ * @endpoint GET /v1/search/link/jobs/{jobId}
+ * @endpoint GET /v1/search/shared/{id}
+ * @endpoint GET /v1/search/shared/slug/{slug}
+ * @endpoint POST /v1/entities/lookup-batch
+ * @endpoint POST /v1/entities/lookup-matches
+ * @endpoint POST /v1/entities/search
+ * @endpoint POST /v1/search
+ * @endpoint POST /v1/search/shared
+ * @usedBySchema EntityResearchSchema
+ * @contractShape entity.financial
+ * @contractRole canonical
+ */
+export const EntityFinancialSchema = EntityFinancialSchemaDefinition;
+//# sourceMappingURL=financial.js.map

package/dist/entity/investor-participation.d.ts

@@ -4243,6 +4243,15 @@ declare const EntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;
@@ -4342,6 +4351,15 @@ declare const EntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;

package/dist/entity/lookup-exact-param.d.ts

@@ -12,6 +12,8 @@ export declare const ENTITY_LOOKUP_EXACT_ENDPOINT: "/v1/entities/lookup-exact";
 export declare const EntityLookupExactParamSchema: z.ZodObject<{
     companySlug: z.ZodOptional<z.ZodString>;
     comparisonEntityId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    financialPeriod: z.ZodOptional<z.ZodString>;
+    financialYear: z.ZodOptional<z.ZodInt>;
     location: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     nameBrand: z.ZodOptional<z.ZodString>;

package/dist/entity/lookup-exact-param.js

@@ -19,6 +19,10 @@ export const EntityLookupExactParamSchema = z.object({
         .optional(),
     /** Exact peer UUIDs in display order for an optional cited comparison on the UUID item JSON read. Exclude the subject and duplicates; subject plus peers must fit the served search answer policy maxEntityEvidence. Uses public stored evidence only, requires the caller's paid natural-search entitlement, and consumes no search allowance or peer views. Omit for ordinary reads; ignored on HEAD and SSE. */
     comparisonEntityId: z.array(z.uuid()).optional(),
+    /** Exact stored financial period token, without trimming or normalization. Supply with financialYear; must be nonblank and at most six characters. Ignored on HEAD and SSE. */
+    financialPeriod: z.string().max(6).optional(),
+    /** Select stored financial facts for this exact year together with financialPeriod. Omit both for ordinary detail reads; ignored on HEAD and SSE. */
+    financialYear: z.int().optional(),
     /** Location candidate: city, state, or country. */
     location: z.string().optional(),
     /** Primary entity name candidate. */

package/dist/entity/research.d.ts

@@ -156,6 +156,23 @@ declare const EntityResearchSchemaDefinition: z.ZodObject<{
         valueResearchDetail?: string | null | undefined;
         valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
     }, import("./research-detail.ts").EntityResearchDetailSchemaInput>>>;
+    financial: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
+        currency: string | null;
+        entityId: string;
+        functionalCurrency: string | null;
+        id: number;
+        period: string;
+        revenue: string | null;
+        year: number;
+    }, import("./financial.ts").EntityFinancialSchemaInput, z.core.$ZodTypeInternals<{
+        currency: string | null;
+        entityId: string;
+        functionalCurrency: string | null;
+        id: number;
+        period: string;
+        revenue: string | null;
+        year: number;
+    }, import("./financial.ts").EntityFinancialSchemaInput>>>>>;
     snippet: z.ZodArray<z.ZodObject<{
         compliance: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             characterCount: z.ZodInt;

package/dist/entity/research.js

@@ -1,6 +1,7 @@
 // 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 { EntityAcceleratorParticipationSchema } from "./accelerator-participation.js";
+import { EntityFinancialSchema } from "./financial.js";
 import { EntityResearchDetailSchema } from "./research-detail.js";
 import { EntityResearchSnippetSchema } from "./research-snippet.js";
 const EntityResearchSchemaDefinition = z.object({
@@ -8,6 +9,8 @@ const EntityResearchSchemaDefinition = z.object({
     acceleratorParticipation: z.array(EntityAcceleratorParticipationSchema),
     /** Structured research details the caller is allowed to see */
     detail: z.array(EntityResearchDetailSchema),
+    /** Stored financial facts selected by financialYear and financialPeriod; omitted when not selected, empty when no matching row exists. Includes no private provenance. */
+    financial: z.array(EntityFinancialSchema).nullish(),
     /** Research text snippets for this entity */
     snippet: z.array(EntityResearchSnippetSchema),
 });

package/dist/entity/resolution.d.ts

@@ -4252,6 +4252,15 @@ export declare const EntityResolutionSchema: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;
@@ -4351,6 +4360,15 @@ export declare const EntityResolutionSchema: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;

package/dist/federated/search.d.ts

@@ -10324,6 +10324,15 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;
@@ -10423,6 +10432,15 @@ declare const FederatedSearchSchemaDefinition: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;

package/dist/link/search.d.ts

@@ -5245,6 +5245,15 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     valueResearchDetail?: string | null | undefined;
                     valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
                 }[];
+                financial?: {
+                    currency: string | null;
+                    entityId: string;
+                    functionalCurrency: string | null;
+                    id: number;
+                    period: string;
+                    revenue: string | null;
+                    year: number;
+                }[] | null | undefined;
                 snippet: {
                     compliance?: {
                         characterCount: number;
@@ -12577,6 +12586,15 @@ declare const LinkSearchSchemaDefinition: z.ZodObject<{
                     valueResearchDetail?: string | null | undefined;
                     valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
                 }[];
+                financial?: {
+                    currency: string | null;
+                    entityId: string;
+                    functionalCurrency: string | null;
+                    id: number;
+                    period: string;
+                    revenue: string | null;
+                    year: number;
+                }[] | null | undefined;
                 snippet: {
                     compliance?: {
                         characterCount: number;

package/dist/openapi-component-manifest.js

@@ -477,6 +477,7 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "entity/filter-ui-meta",
         schemaName: "EntityFilterUiMetaSchema",
     },
+    EntityFinancial: { modulePath: "entity/financial", schemaName: "EntityFinancialSchema" },
     EntityFundingDetail: {
         modulePath: "entity/funding-detail",
         schemaName: "EntityFundingDetailSchema",

package/dist/pagination/schemas.d.ts

@@ -4869,6 +4869,15 @@ declare const PageEntityDetailSchemaDefinition: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;
@@ -4968,6 +4977,15 @@ declare const PageEntityDetailSchemaDefinition: z.ZodObject<{
                 valueResearchDetail?: string | null | undefined;
                 valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
             }[];
+            financial?: {
+                currency: string | null;
+                entityId: string;
+                functionalCurrency: string | null;
+                id: number;
+                period: string;
+                revenue: string | null;
+                year: number;
+            }[] | null | undefined;
             snippet: {
                 compliance?: {
                     characterCount: number;
@@ -7776,6 +7794,15 @@ declare const PageEntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                     valueResearchDetail?: string | null | undefined;
                     valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
                 }[];
+                financial?: {
+                    currency: string | null;
+                    entityId: string;
+                    functionalCurrency: string | null;
+                    id: number;
+                    period: string;
+                    revenue: string | null;
+                    year: number;
+                }[] | null | undefined;
                 snippet: {
                     compliance?: {
                         characterCount: number;
@@ -10043,6 +10070,15 @@ declare const PageEntityInvestorParticipationSchemaDefinition: z.ZodObject<{
                     valueResearchDetail?: string | null | undefined;
                     valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
                 }[];
+                financial?: {
+                    currency: string | null;
+                    entityId: string;
+                    functionalCurrency: string | null;
+                    id: number;
+                    period: string;
+                    revenue: string | null;
+                    year: number;
+                }[] | null | undefined;
                 snippet: {
                     compliance?: {
                         characterCount: number;

package/dist/shared/search.d.ts

@@ -5256,6 +5256,15 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     valueResearchDetail?: string | null | undefined;
                     valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
                 }[];
+                financial?: {
+                    currency: string | null;
+                    entityId: string;
+                    functionalCurrency: string | null;
+                    id: number;
+                    period: string;
+                    revenue: string | null;
+                    year: number;
+                }[] | null | undefined;
                 snippet: {
                     compliance?: {
                         characterCount: number;
@@ -12588,6 +12597,15 @@ declare const SharedSearchSchemaDefinition: z.ZodObject<{
                     valueResearchDetail?: string | null | undefined;
                     valueType: "date" | "monetary" | "numeric" | "percentage" | "text";
                 }[];
+                financial?: {
+                    currency: string | null;
+                    entityId: string;
+                    functionalCurrency: string | null;
+                    id: number;
+                    period: string;
+                    revenue: string | null;
+                    year: number;
+                }[] | null | undefined;
                 snippet: {
                     compliance?: {
                         characterCount: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.421",
+  "version": "0.8.423",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",