@aventurevc/api-schemas 0.8.49 → 0.8.52

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

@@ -7,7 +7,7 @@ declare const EntityDetailBatchSchemaDefinition: z.ZodObject<{
 }, z.core.$strict>;
 type EntityDetailBatchDefinition = z.infer<typeof EntityDetailBatchSchemaDefinition>;
 /**
- * Batch request for entity detail retrieval by id, slug, or current joined URL
+ * Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url.
  *
  * @openapiSchema EntityDetailBatch
  * @endpoint POST /v1/entities/lookup-batch

package/dist/entity/detail-batch.js

@@ -1,17 +1,30 @@
 // 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({
+const EntityDetailBatchSchemaDefinition = z
+    .strictObject({
     /** Entity UUID values */
-    entityId: z.array(z.uuid()).optional(),
+    entityId: z.array(z.uuid()).max(200).optional(),
     /** Permit monogram fallbacks */
     permitMonogram: z.boolean().nullable().default(true).optional(),
     /** Entity slug values */
-    slug: z.array(z.string()).optional(),
+    slug: z.array(z.string()).max(200).optional(),
     /** Current joined entity URL values */
-    url: z.array(z.string()).optional(),
+    url: z.array(z.string()).max(200).optional(),
+})
+    .check(({ value, issues }) => {
+    if ((value.entityId?.length ?? 0) + (value.slug?.length ?? 0) + (value.url?.length ?? 0) >
+        200) {
+        issues.push({
+            code: "custom",
+            origin: "custom",
+            path: [],
+            input: value,
+            message: "combined array item count must be at most 200",
+        });
+    }
 });
 /**
- * Batch request for entity detail retrieval by id, slug, or current joined URL
+ * Batch request for entity detail retrieval by id, slug, or current joined URL. Each identifier array accepts at most 200 values, and at most 200 identifiers may be submitted across entityId, slug, and url.
  *
  * @openapiSchema EntityDetailBatch
  * @endpoint POST /v1/entities/lookup-batch

package/dist/http/status-code.d.ts

@@ -11,6 +11,7 @@
  */
 export declare const HTTP_OK: 200;
 export declare const HTTP_CREATED: 201;
+export declare const HTTP_ACCEPTED: 202;
 export declare const HTTP_NO_CONTENT: 204;
 export declare const HTTP_MOVED_PERMANENTLY: 301;
 export declare const HTTP_FOUND: 302;

package/dist/http/status-code.js

@@ -12,6 +12,7 @@
  */
 export const HTTP_OK = 200;
 export const HTTP_CREATED = 201;
+export const HTTP_ACCEPTED = 202;
 export const HTTP_NO_CONTENT = 204;
 export const HTTP_MOVED_PERMANENTLY = 301;
 export const HTTP_FOUND = 302;

package/dist/identification/subject.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * The company, Product, Service, or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.
+ * The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.
  *
  * @openapiSchema IdentificationSubject
  * @endpoint GET /v1/lookup-jobs/{jobId}
@@ -20,7 +20,7 @@ export declare const IdentificationSubjectSchema: z.ZodObject<{
         PERSON: "PERSON";
     }>>>;
     location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    name: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
     sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/identification/subject.js

@@ -2,7 +2,7 @@
 import { z } from "zod/v4";
 import { EntityTypeSchema } from "../entity/type.js";
 /**
- * The company, Product, Service, or person to identify. Send the name plus every URL, location, and source you have; a website or profile URL usually settles the answer without any model call.
+ * The company, Product, Service, or person to identify. Send the name, a URL it owns, or both, plus every location and source you have; a website or profile URL usually settles the answer without any model call.
  *
  * @openapiSchema IdentificationSubject
  * @endpoint GET /v1/lookup-jobs/{jobId}
@@ -22,8 +22,8 @@ export const IdentificationSubjectSchema = z.object({
     kind: z.enum(["ENTITY", "PERSON"]).nullish(),
     /** City, region, or country, such as Austin, TX. Tells namesakes apart; not proof on its own. */
     location: z.string().max(2000).nullish(),
-    /** Name exactly as the source writes it, such as Acme AI or Jane Doe. Required even when url is sent; to read a record from only a URL (an aVenture page, website, or domain) use the exact read instead: entities lookup-exact get --url, or people lookup-exact get --url for a person. */
-    name: z.string().max(200),
+    /** Name exactly as the source writes it, such as Acme AI or Jane Doe. Send name, url, or both; a name that is an absolute http(s) URL is read as url. */
+    name: z.string().max(200).nullish(),
     /** Provider entity id for a Product or Service lookup. Omit it when the provider is unknown. With no typeRecord, searches both Product and Service. Invalid for a company type or a person lookup. */
     providerId: z.uuid().nullish(),
     /** aVenture news id of the article that mentions the subject; an unknown id is a 400. */
@@ -32,7 +32,7 @@ export const IdentificationSubjectSchema = z.object({
     sourceUrl: z.string().max(2000).nullish(),
     /** Entity type to identify. A Product or Service never matches its provider organization, but a record stored under a neighboring type of the same family (Product or Service; Fund, Investment Firm, or Company) still matches, and a Business Line lookup sees both families. Invalid for a person lookup. */
     typeRecord: EntityTypeSchema.nullish(),
-    /** URLs the subject owns: its website, its LinkedIn company or person profile, or a registry page. At most 10. Put articles in sourceUrl. */
+    /** URLs the subject owns: its website, its LinkedIn company or person profile, an aVenture page, or a registry page. At most 10. Required when name is omitted. Put articles in sourceUrl. */
     url: z.array(z.string()).max(10).optional(),
 });
 //# sourceMappingURL=subject.js.map

package/dist/job/enqueue.d.ts

@@ -14,6 +14,7 @@ type JobEnqueueDefinition = z.infer<typeof JobEnqueueSchemaDefinition>;
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
  * @endpoint POST /v1/lookup-jobs
  * @contractShape job.enqueue
  * @contractRole canonical

package/dist/job/enqueue.js

@@ -15,6 +15,7 @@ const JobEnqueueSchemaDefinition = z.object({
  * @endpoint GET /v1/search/link/jobs/{jobId}
  * @endpoint GET /v1/web/searches/jobs/{jobId}
  * @endpoint POST /v1/entities/lookup
+ * @endpoint POST /v1/lookup
  * @endpoint POST /v1/lookup-jobs
  * @contractShape job.enqueue
  * @contractRole canonical

package/dist/lookup/job-mutation.d.ts

@@ -20,7 +20,7 @@ declare const LookupJobMutationSchemaDefinition: z.ZodObject<{
             PERSON: "PERSON";
         }>>>;
         location: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        name: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         providerId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
         sourceNewsId: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         sourceUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/lookup/job.d.ts

@@ -1428,7 +1428,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             context?: string | null | undefined;
             kind?: "ENTITY" | "PERSON" | null | undefined;
             location?: string | null | undefined;
-            name: string;
+            name?: string | null | undefined;
             providerId?: string | null | undefined;
             sourceNewsId?: number | null | undefined;
             sourceUrl?: string | null | undefined;
@@ -1448,7 +1448,7 @@ declare const LookupJobSchemaDefinition: z.ZodObject<{
             context?: string | null | undefined;
             kind?: "ENTITY" | "PERSON" | null | undefined;
             location?: string | null | undefined;
-            name: string;
+            name?: string | null | undefined;
             providerId?: string | null | undefined;
             sourceNewsId?: number | null | undefined;
             sourceUrl?: string | null | undefined;

package/dist/news/param.d.ts

@@ -13,14 +13,8 @@ export declare const NewsParamSchema: z.ZodObject<{
     page: z.ZodOptional<z.ZodInt>;
     size: z.ZodOptional<z.ZodInt>;
     sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
-    authorInitial: z.ZodOptional<z.ZodString>;
     category: z.ZodOptional<z.ZodString>;
-    cursor: z.ZodOptional<z.ZodString>;
     excludeId: z.ZodOptional<z.ZodInt>;
-    letter: z.ZodOptional<z.ZodString>;
-    mode: z.ZodOptional<z.ZodEnum<{
-        thin: "thin";
-    }>>;
     "owner.entityId": z.ZodOptional<z.ZodUUID>;
     "owner.personId": z.ZodOptional<z.ZodUUID>;
     publishedAfter: z.ZodOptional<z.ZodISODate>;

package/dist/news/param.js

@@ -12,18 +12,10 @@ export const NEWS_ENDPOINT = "/v1/news";
  * @contractRole canonical
  */
 export const NewsParamSchema = PageParamSchema.extend({
-    /** Author initial filter. */
-    authorInitial: z.string().optional(),
     /** News category slug to include or exclude. */
     category: z.string().optional(),
-    /** Cursor token returned by the previous thin page. */
-    cursor: z.string().optional(),
     /** Exclude one news article by id. */
     excludeId: z.int().optional(),
-    /** Deprecated: use the author-initial filter. */
-    letter: z.string().optional(),
-    /** Response mode: thin returns cursor-paginated index rows; omit for the standard list. */
-    mode: z.enum(["thin"]).optional(),
     /** Owning entity id; set only when personId is absent. */
     "owner.entityId": z.uuid().optional(),
     /** Owning person id; set only when entityId is absent. */
@@ -34,15 +26,5 @@ export const NewsParamSchema = PageParamSchema.extend({
     publishedBefore: z.iso.date().optional(),
     /** Full-text news search term. */
     search: z.string().optional(),
-}).check(({ value, issues }) => {
-    if (value.cursor !== undefined && value.cursor !== "" && value.sort !== undefined) {
-        issues.push({
-            code: "custom",
-            origin: "custom",
-            path: ["sort"],
-            input: value.sort,
-            message: "sort is not supported when cursor is provided",
-        });
-    }
 });
 //# sourceMappingURL=param.js.map

package/dist/publication/publication.js

@@ -23,7 +23,7 @@ const PublicationSchemaDefinition = z.object({
     summary: z.string().nullish(),
     /** Human title or best available display label. webPage rows restate the page URL when the crawl captured no label; renderers may humanize that fallback. */
     title: z.string(),
-    /** Single canonical topic key (web-crawl section or news-event topic) or source category (repository language); null when the source has no classified topic. */
+    /** Single canonical topic key (web-crawl section or news-event topic) or source category (repository language, or GitHub for a profile or a repository without one); null while the source awaits classification. */
     topic: z.string().nullish(),
     /** Publication row update instant when known. */
     updatedAt: z.iso.datetime({ offset: true }).nullish(),

package/package.json

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