@aventurevc/api-schemas 0.7.302 → 0.7.328

package/dist/person/graph.d.ts

@@ -29,7 +29,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
         } | null | undefined;
         entity: {
             core: {
-                createdAt?: string | null | undefined;
                 defaultCurrency?: string | null | undefined;
                 foundedYear?: number | null | undefined;
                 id: string;
@@ -62,6 +61,7 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
                 updatedAt?: string | null | undefined;
             };
             fundingDetail?: {
+                currency?: string | null | undefined;
                 fundingRoundCount: number;
                 investorCount: number;
                 latestValuation?: number | null | undefined;
@@ -122,7 +122,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
             id: number;
             newsImageThumbnail?: string | null | undefined;
             newsUrlOriginal?: string | null | undefined;
-            pendingApproval?: number | null | undefined;
             publication?: string | null | undefined;
             publishedAt?: string | null | undefined;
             slug?: string | null | undefined;
@@ -132,7 +131,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
         similarEntity: {
             entity: {
                 core: {
-                    createdAt?: string | null | undefined;
                     defaultCurrency?: string | null | undefined;
                     foundedYear?: number | null | undefined;
                     id: string;
@@ -165,6 +163,7 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
                     updatedAt?: string | null | undefined;
                 };
                 fundingDetail?: {
+                    currency?: string | null | undefined;
                     fundingRoundCount: number;
                     investorCount: number;
                     latestValuation?: number | null | undefined;
@@ -215,7 +214,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
         } | null | undefined;
         entity: {
             core: {
-                createdAt?: string | null | undefined;
                 defaultCurrency?: string | null | undefined;
                 foundedYear?: number | null | undefined;
                 id: string;
@@ -248,6 +246,7 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
                 updatedAt?: string | null | undefined;
             };
             fundingDetail?: {
+                currency?: string | null | undefined;
                 fundingRoundCount: number;
                 investorCount: number;
                 latestValuation?: number | null | undefined;
@@ -308,7 +307,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
             id: number;
             newsImageThumbnail?: string | null | undefined;
             newsUrlOriginal?: string | null | undefined;
-            pendingApproval?: number | null | undefined;
             publication?: string | null | undefined;
             publishedAt?: string | null | undefined;
             slug?: string | null | undefined;
@@ -318,7 +316,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
         similarEntity: {
             entity: {
                 core: {
-                    createdAt?: string | null | undefined;
                     defaultCurrency?: string | null | undefined;
                     foundedYear?: number | null | undefined;
                     id: string;
@@ -351,6 +348,7 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
                     updatedAt?: string | null | undefined;
                 };
                 fundingDetail?: {
+                    currency?: string | null | undefined;
                     fundingRoundCount: number;
                     investorCount: number;
                     latestValuation?: number | null | undefined;
@@ -388,7 +386,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
         };
         round?: string | null | undefined;
         sharedEntity?: {
-            createdAt?: string | null | undefined;
             defaultCurrency?: string | null | undefined;
             foundedYear?: number | null | undefined;
             id: string;
@@ -436,7 +433,6 @@ declare const PersonGraphSchemaDefinition: z.ZodObject<{
         };
         round?: string | null | undefined;
         sharedEntity?: {
-            createdAt?: string | null | undefined;
             defaultCurrency?: string | null | undefined;
             foundedYear?: number | null | undefined;
             id: string;

package/dist/person/image.d.ts

@@ -8,10 +8,7 @@ type PersonImageDefinition = z.infer<typeof PersonImageSchemaDefinition>;
  * Read projection: person image fields for detail/list responses
  *
  * @openapiSchema PersonImage
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -24,17 +21,14 @@ type PersonImageDefinition = z.infer<typeof PersonImageSchemaDefinition>;
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @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/people/natural-search
  * @endpoint POST /v1/people/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema EntityPersonAssociationSchema
  * @usedBySchema PersonGraphMemberSchema
  * @usedBySchema PersonSchema

package/dist/person/image.js

@@ -9,10 +9,7 @@ const PersonImageSchemaDefinition = z.object({
  * Read projection: person image fields for detail/list responses
  *
  * @openapiSchema PersonImage
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -25,17 +22,14 @@ const PersonImageSchemaDefinition = z.object({
  * @endpoint GET /v1/people/{personId}/entities/{associationId}
  * @endpoint GET /v1/people/{personId}/graph
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @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/people/natural-search
  * @endpoint POST /v1/people/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema EntityPersonAssociationSchema
  * @usedBySchema PersonGraphMemberSchema
  * @usedBySchema PersonSchema

package/dist/person/invested-company.d.ts

@@ -1,7 +1,6 @@
 import { z } from "zod/v4";
 declare const PersonInvestedCompanySchemaDefinition: z.ZodObject<{
     entity: 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;
@@ -57,22 +56,16 @@ type PersonInvestedCompanyDefinition = z.infer<typeof PersonInvestedCompanySchem
  * Company metadata associated with a person investment
  *
  * @openapiSchema PersonInvestedCompany
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
- * @endpoint GET /v1/people/detail/investments
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/entities/{entityId}
  * @endpoint GET /v1/entities/{entityId}/investors
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/people/{personId}
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
+ * @endpoint GET /v1/people/{personId}/investments
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @usedBySchema PersonInvestmentSchema
  * @contractShape person.invested-company

package/dist/person/invested-company.js

@@ -8,22 +8,16 @@ const PersonInvestedCompanySchemaDefinition = z.object({
  * Company metadata associated with a person investment
  *
  * @openapiSchema PersonInvestedCompany
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
- * @endpoint GET /v1/people/detail/investments
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/entities/{entityId}
  * @endpoint GET /v1/entities/{entityId}/investors
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/people/{personId}
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
+ * @endpoint GET /v1/people/{personId}/investments
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @usedBySchema PersonInvestmentSchema
  * @contractShape person.invested-company

package/dist/person/investment.d.ts

@@ -3,7 +3,6 @@ declare const PersonInvestmentSchemaDefinition: z.ZodObject<{
     amount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     company: z.ZodType<{
         entity: {
-            createdAt?: string | null | undefined;
             defaultCurrency?: string | null | undefined;
             foundedYear?: number | null | undefined;
             id: string;
@@ -37,7 +36,6 @@ declare const PersonInvestmentSchemaDefinition: z.ZodObject<{
         };
     }, unknown, z.core.$ZodTypeInternals<{
         entity: {
-            createdAt?: string | null | undefined;
             defaultCurrency?: string | null | undefined;
             foundedYear?: number | null | undefined;
             id: string;
@@ -116,22 +114,16 @@ type PersonInvestmentDefinition = z.infer<typeof PersonInvestmentSchemaDefinitio
  * Domain model for a person's investment in an entity (fundraise transaction)
  *
  * @openapiSchema PersonInvestment
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
- * @endpoint GET /v1/people/detail/investments
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/entities/{entityId}
  * @endpoint GET /v1/entities/{entityId}/investors
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/people/{personId}
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
+ * @endpoint GET /v1/people/{personId}/investments
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @usedBySchema PagePersonInvestmentSchema
  * @usedBySchema PersonDetailSchema

package/dist/person/investment.js

@@ -20,22 +20,16 @@ const PersonInvestmentSchemaDefinition = z.object({
  * Domain model for a person's investment in an entity (fundraise transaction)
  *
  * @openapiSchema PersonInvestment
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people/detail
- * @endpoint GET /v1/people/detail/investments
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/entities/{entityId}
  * @endpoint GET /v1/entities/{entityId}/investors
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/people/{personId}
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
+ * @endpoint GET /v1/people/{personId}/investments
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @endpoint POST /v1/entities/search
- * @endpoint POST /v1/people/batch
- * @endpoint POST /v1/people/detail/batch
  * @endpoint POST /v1/people/lookup/batch
  * @usedBySchema PagePersonInvestmentSchema
  * @usedBySchema PersonDetailSchema

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

@@ -20,8 +20,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
         articleCount?: number | null | undefined;
         association: {
             associationId: number;
-            createdAt?: string | null | undefined;
-            creator?: string | null | undefined;
             endDate?: string | null | undefined;
             entityAddress: {
                 address?: number | null | undefined;
@@ -167,7 +165,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
             titleId?: number | null | undefined;
             titleLevel?: string | null | undefined;
             titleName?: string | null | undefined;
-            updatedAt?: string | null | undefined;
         }[];
         core: {
             createdAt?: string | null | undefined;
@@ -202,15 +199,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
                 sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
             } | null | undefined;
             slug: string;
-            source: {
-                changedAt?: string | null | undefined;
-                dataSourceUpdatedAt?: string | null | undefined;
-                detail?: string | null | undefined;
-                kind?: string | null | undefined;
-                pendingApproval?: number | null | undefined;
-                sourceId?: string | null | undefined;
-                status?: string | null | undefined;
-            };
             suffix?: string | null | undefined;
             text: {
                 expanded?: string | null | undefined;
@@ -285,7 +273,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
             amount?: number | null | undefined;
             company: {
                 entity: {
-                    createdAt?: string | null | undefined;
                     defaultCurrency?: string | null | undefined;
                     foundedYear?: number | null | undefined;
                     id: string;
@@ -357,13 +344,10 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
             name: string;
             type?: "formerName" | "maidenName" | "nickname" | "stageName" | null | undefined;
         }[];
-        pendingApproval?: number | null | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         articleCount?: number | null | undefined;
         association: {
             associationId: number;
-            createdAt?: string | null | undefined;
-            creator?: string | null | undefined;
             endDate?: string | null | undefined;
             entityAddress: {
                 address?: number | null | undefined;
@@ -509,7 +493,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
             titleId?: number | null | undefined;
             titleLevel?: string | null | undefined;
             titleName?: string | null | undefined;
-            updatedAt?: string | null | undefined;
         }[];
         core: {
             createdAt?: string | null | undefined;
@@ -544,15 +527,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
                 sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
             } | null | undefined;
             slug: string;
-            source: {
-                changedAt?: string | null | undefined;
-                dataSourceUpdatedAt?: string | null | undefined;
-                detail?: string | null | undefined;
-                kind?: string | null | undefined;
-                pendingApproval?: number | null | undefined;
-                sourceId?: string | null | undefined;
-                status?: string | null | undefined;
-            };
             suffix?: string | null | undefined;
             text: {
                 expanded?: string | null | undefined;
@@ -627,7 +601,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
             amount?: number | null | undefined;
             company: {
                 entity: {
-                    createdAt?: string | null | undefined;
                     defaultCurrency?: string | null | undefined;
                     foundedYear?: number | null | undefined;
                     id: string;
@@ -699,7 +672,6 @@ declare const PersonInvestorParticipationSchemaDefinition: z.ZodObject<{
             name: string;
             type?: "formerName" | "maidenName" | "nickname" | "stageName" | null | undefined;
         }[];
-        pendingApproval?: number | null | undefined;
     }, unknown>>;
     round: z.ZodArray<z.ZodObject<{
         round: z.ZodString;

package/dist/person/list-array-filter.d.ts

@@ -4,10 +4,10 @@ import { z } from "zod/v4";
  *
  * @openapiSchema PersonListArrayFilter
  * @endpoint GET /v1/search/link
- * @endpoint POST /v1/people/batch
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/people/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema PersonFilterSchema
  * @contractShape person.list-array-filter
  * @contractRole canonical

package/dist/person/list-array-filter.js

@@ -8,10 +8,10 @@ import { IntRangeSchema } from "../int/range.js";
  *
  * @openapiSchema PersonListArrayFilter
  * @endpoint GET /v1/search/link
- * @endpoint POST /v1/people/batch
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/people/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema PersonFilterSchema
  * @contractShape person.list-array-filter
  * @contractRole canonical

package/dist/person/lookup-batch-param.d.ts

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

package/dist/person/lookup-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 PERSON_LOOKUP_BATCH_ENDPOINT = "/v1/people/lookup/batch";
+/**
+ * Request-side query params for `POST /v1/people/lookup/batch`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/people/lookup/batch
+ * @contractShape person.lookup-batch-param
+ * @contractRole canonical
+ */
+export const PersonLookupBatchParamSchema = z.object({
+    /** Includes private fields when the caller has private-visibility authority. Omit to use the caller's default visibility. */
+    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=lookup-batch-param.js.map

package/dist/person/{detail-batch.d.ts → lookup-batch.d.ts}

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-declare const PersonDetailBatchSchemaDefinition: z.ZodObject<{
+declare const PersonLookupBatchSchemaDefinition: z.ZodObject<{
     hasImageFirst: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     includeAddress: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     includeAssociation: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
@@ -10,17 +10,16 @@ declare const PersonDetailBatchSchemaDefinition: z.ZodObject<{
     slug: z.ZodOptional<z.ZodArray<z.ZodString>>;
     url: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
-type PersonDetailBatchDefinition = z.infer<typeof PersonDetailBatchSchemaDefinition>;
+type PersonLookupBatchDefinition = z.infer<typeof PersonLookupBatchSchemaDefinition>;
 /**
  * Batch request for person detail enrichment. Each selector array accepts at most 200 values, and at most 200 selectors may be submitted across personId, slug, and url.
  *
- * @openapiSchema PersonDetailBatch
- * @endpoint POST /v1/people/detail/batch
+ * @openapiSchema PersonLookupBatch
  * @endpoint POST /v1/people/lookup/batch
- * @contractShape person.detail-batch
+ * @contractShape person.lookup-batch
  * @contractRole canonical
  */
-export declare const PersonDetailBatchSchema: z.ZodType<PersonDetailBatchDefinition>;
-export type PersonDetailBatch = z.infer<typeof PersonDetailBatchSchema>;
+export declare const PersonLookupBatchSchema: z.ZodType<PersonLookupBatchDefinition>;
+export type PersonLookupBatch = z.infer<typeof PersonLookupBatchSchema>;
 export {};
-//# sourceMappingURL=detail-batch.d.ts.map
+//# sourceMappingURL=lookup-batch.d.ts.map

package/dist/person/{detail-batch.js → lookup-batch.js}

@@ -1,6 +1,6 @@
 // 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 PersonDetailBatchSchemaDefinition = z
+const PersonLookupBatchSchemaDefinition = z
     .strictObject({
     /** Sort results by image presence */
     hasImageFirst: z.boolean().default(false).optional(),
@@ -41,11 +41,10 @@ const PersonDetailBatchSchemaDefinition = z
 /**
  * Batch request for person detail enrichment. Each selector array accepts at most 200 values, and at most 200 selectors may be submitted across personId, slug, and url.
  *
- * @openapiSchema PersonDetailBatch
- * @endpoint POST /v1/people/detail/batch
+ * @openapiSchema PersonLookupBatch
  * @endpoint POST /v1/people/lookup/batch
- * @contractShape person.detail-batch
+ * @contractShape person.lookup-batch
  * @contractRole canonical
  */
-export const PersonDetailBatchSchema = PersonDetailBatchSchemaDefinition;
-//# sourceMappingURL=detail-batch.js.map
+export const PersonLookupBatchSchema = PersonLookupBatchSchemaDefinition;
+//# sourceMappingURL=lookup-batch.js.map

package/dist/person/lookup-param.js

@@ -15,7 +15,7 @@ export const PersonLookupParamSchema = z.object({
     includeAddress: z.boolean().optional(),
     /** Projection qualifier — include association values (default: true). Set false to omit association array. */
     includeAssociation: z.boolean().optional(),
-    /** Privileged admin readback scope. Includes hidden or off-sitemap people and privileged private fields. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    /** Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority. */
     includePrivate: z.boolean().optional(),
     /** Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array. */
     includeUrl: z.boolean().optional(),

package/dist/person/natural-search-result.d.ts

@@ -57,6 +57,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
             isCurrent?: boolean | null | undefined;
             lastName?: string | null | undefined;
             letter?: string | null | undefined;
+            personId?: string[] | undefined;
             personName?: string[] | undefined;
             role?: string | null | undefined;
             search?: string | null | undefined;
@@ -129,6 +130,7 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
             isCurrent?: boolean | null | undefined;
             lastName?: string | null | undefined;
             letter?: string | null | undefined;
+            personId?: string[] | undefined;
             personName?: string[] | undefined;
             role?: string | null | undefined;
             search?: string | null | undefined;
@@ -179,15 +181,6 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
                 sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
             } | null | undefined;
             slug: string;
-            source: {
-                changedAt?: string | null | undefined;
-                dataSourceUpdatedAt?: string | null | undefined;
-                detail?: string | null | undefined;
-                kind?: string | null | undefined;
-                pendingApproval?: number | null | undefined;
-                sourceId?: string | null | undefined;
-                status?: string | null | undefined;
-            };
             suffix?: string | null | undefined;
             text: {
                 expanded?: string | null | undefined;
@@ -234,15 +227,6 @@ declare const PersonNaturalSearchResultSchemaDefinition: z.ZodObject<{
                 sourceType: "agentHelpDoc" | "blogPost" | "classificationCode" | "classificationTag" | "entity" | "newsArticle" | "person" | "product" | "service" | "text";
             } | null | undefined;
             slug: string;
-            source: {
-                changedAt?: string | null | undefined;
-                dataSourceUpdatedAt?: string | null | undefined;
-                detail?: string | null | undefined;
-                kind?: string | null | undefined;
-                pendingApproval?: number | null | undefined;
-                sourceId?: string | null | undefined;
-                status?: string | null | undefined;
-            };
             suffix?: string | null | undefined;
             text: {
                 expanded?: string | null | undefined;
@@ -265,6 +249,7 @@ type PersonNaturalSearchResultDefinition = z.infer<typeof PersonNaturalSearchRes
  * @endpoint GET /v1/search/link
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema FederatedSearchSchema
  * @contractShape person.natural-search-result
  * @contractRole canonical

package/dist/person/natural-search-result.js

@@ -15,6 +15,7 @@ const PersonNaturalSearchResultSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link
  * @endpoint POST /v1/people/natural-search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema FederatedSearchSchema
  * @contractShape person.natural-search-result
  * @contractRole canonical

package/dist/person/natural-search.d.ts

@@ -84,6 +84,7 @@ declare const PersonNaturalSearchSchemaDefinition: z.ZodObject<{
         isCurrent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         lastName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         letter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        personId: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
         personName: z.ZodOptional<z.ZodArray<z.ZodString>>;
         role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         search: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -106,6 +107,7 @@ type PersonNaturalSearchDefinition = z.infer<typeof PersonNaturalSearchSchemaDef
  *
  * @openapiSchema PersonNaturalSearch
  * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/natural/people
  * @contractShape person.natural-search
  * @contractRole canonical
  */

package/dist/person/natural-search.js

@@ -13,6 +13,7 @@ const PersonNaturalSearchSchemaDefinition = z.object({
  *
  * @openapiSchema PersonNaturalSearch
  * @endpoint POST /v1/people/natural-search
+ * @endpoint POST /v1/search/natural/people
  * @contractShape person.natural-search
  * @contractRole canonical
  */

package/dist/person/person.d.ts

@@ -50,15 +50,6 @@ declare const PersonSchemaDefinition: z.ZodObject<{
         }>;
     }, z.core.$strip>>>;
     slug: z.ZodString;
-    source: z.ZodObject<{
-        changedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
-        dataSourceUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
-        detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        pendingApproval: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-        sourceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>;
     suffix: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     text: z.ZodType<{
         expanded?: string | null | undefined;
@@ -76,10 +67,7 @@ type PersonDefinition = z.infer<typeof PersonSchemaDefinition>;
  * Canonical person core record
  *
  * @openapiSchema Person
- * @endpoint GET /v1/entities/detail
  * @endpoint GET /v1/entities/lookup
- * @endpoint GET /v1/people
- * @endpoint GET /v1/people/detail
  * @endpoint GET /v1/people/lookup
  * @endpoint GET /v1/search/link
  * @endpoint GET /v1/entities/{entityId}
@@ -87,17 +75,14 @@ type PersonDefinition = z.infer<typeof PersonSchemaDefinition>;
  * @endpoint GET /v1/entities/{entityId}/person-investors
  * @endpoint GET /v1/people/{personId}
  * @endpoint GET /v1/people/{personId}/similar
- * @endpoint POST /v1/entities/batch
- * @endpoint POST /v1/entities/detail/batch
  * @endpoint POST /v1/entities/lookup/batch
  * @endpoint POST /v1/entities/lookup/matches
  * @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/people/natural-search
  * @endpoint POST /v1/people/search
  * @endpoint POST /v1/search/all
+ * @endpoint POST /v1/search/natural/people
  * @usedBySchema PagePersonSchema
  * @usedBySchema PageResultPersonSchema
  * @usedBySchema PersonDetailSchema