@aventurevc/api-schemas 0.7.272

package/dist/entity/resolution.js

@@ -0,0 +1,25 @@
+// 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 { EntityDetailSchema } from "./detail.js";
+const EntityResolutionSchemaDefinition = z.object({
+    /** Entity ids that all currently own the queried URL when status is AMBIGUOUS; empty otherwise. Re-query a single id to disambiguate. */
+    candidateEntityId: z.array(z.uuid()),
+    /** Full entity detail when status is MATCHED; absent otherwise. */
+    detail: EntityDetailSchema.nullish(),
+    /** Raw identifier exactly as queried (UUID string, slug, or URL). */
+    input: z.string(),
+    /** Which identifier kind this row was queried by. */
+    inputType: z.enum(["ID", "SLUG", "URL"]),
+    /** Resolution outcome for this input. */
+    status: z.enum(["MATCHED", "AMBIGUOUS", "MISSING"]),
+});
+/**
+ * Resolution of one queried identifier (id, slug, or current joined URL) to its current entity. Echoes the raw input; matched rows carry the full detail, ambiguous rows carry the conflicting candidate ids, missing rows carry neither.
+ *
+ * @openapiSchema EntityResolution
+ * @endpoint POST /v1/entities/detail/resolve
+ * @contractShape entity.resolution
+ * @contractRole canonical
+ */
+export const EntityResolutionSchema = EntityResolutionSchemaDefinition;
+//# sourceMappingURL=resolution.js.map

package/dist/entity/search-param.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+export declare const ENTITY_SEARCH_ENDPOINT: "/v1/entities/search";
+/**
+ * Request-side query params for `POST /v1/entities/search`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/entities/search
+ * @contractShape entity.search-param
+ * @contractRole canonical
+ */
+export declare const EntitySearchParamSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodInt>;
+    size: z.ZodOptional<z.ZodInt>;
+    sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    countOnly: z.ZodOptional<z.ZodBoolean>;
+    cursor: z.ZodOptional<z.ZodString>;
+    includePrivate: z.ZodOptional<z.ZodBoolean>;
+    permitMonogram: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type EntitySearchParam = z.infer<typeof EntitySearchParamSchema>;
+//# sourceMappingURL=search-param.d.ts.map

package/dist/entity/search-param.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 { PageParamSchema } from "../client/pagination/page-param.js";
+export const ENTITY_SEARCH_ENDPOINT = "/v1/entities/search";
+/**
+ * Request-side query params for `POST /v1/entities/search`.
+ *
+ * Generated from inline OpenAPI query parameters published by the backend controller.
+ *
+ * @endpoint POST /v1/entities/search
+ * @contractShape entity.search-param
+ * @contractRole canonical
+ */
+export const EntitySearchParamSchema = PageParamSchema.extend({
+    /** Return only the matching entity count in totalElements. Content is empty by design, so the page empty flag describes content, not whether matches exist. Unsupported with semanticQuery. */
+    countOnly: z.boolean().optional(),
+    /** Opaque sort-aware entity cursor; reuse the same filters and sort. Unsupported with semanticQuery or countOnly. */
+    cursor: z.string().optional(),
+    /** Privileged admin readback scope. Includes hidden or off-sitemap entities. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public. */
+    includePrivate: z.boolean().optional(),
+    /** Allow generated monogram logos in results. */
+    permitMonogram: z.boolean().optional(),
+});
+//# sourceMappingURL=search-param.js.map

package/dist/entity/similarity-context.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod/v4";
+declare const EntitySimilarityContextSchemaDefinition: z.ZodObject<{
+    compositeScore: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cosineScore: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    curatedAsOf: z.ZodOptional<z.ZodNullable<z.ZodISODate>>;
+    curatedRelationshipType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    curatedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    derivedFromEntityId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    matchedSectionWeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    origin: z.ZodEnum<{
+        computed: "computed";
+        curated: "curated";
+        derived: "derived";
+        precomputed: "precomputed";
+        semantic: "semantic";
+    }>;
+    rank: z.ZodInt;
+    sharedSectionCount: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+}, z.core.$strip>;
+type EntitySimilarityContextDefinition = z.infer<typeof EntitySimilarityContextSchemaDefinition>;
+/**
+ * Per-row provenance for a similar-entity result
+ *
+ * @openapiSchema EntitySimilarityContext
+ * @endpoint GET /v1/entities/detail/similar
+ * @usedBySchema EntitySimilarityResultSchema
+ * @contractShape entity.similarity-context
+ * @contractRole canonical
+ */
+export declare const EntitySimilarityContextSchema: z.ZodType<EntitySimilarityContextDefinition>;
+export type EntitySimilarityContext = z.infer<typeof EntitySimilarityContextSchema>;
+export {};
+//# sourceMappingURL=similarity-context.d.ts.map

package/dist/entity/similarity-context.js

@@ -0,0 +1,35 @@
+// 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 { EntitySimilarityOriginSchema } from "./similarity-origin.js";
+const EntitySimilarityContextSchemaDefinition = z.object({
+    /** Composite (section-fusion) score. Populated only when origin=precomputed. */
+    compositeScore: z.number().nullish(),
+    /** Cosine similarity when origin=precomputed */
+    cosineScore: z.number().nullish(),
+    /** Curated as-of date when origin=curated */
+    curatedAsOf: z.iso.date().nullish(),
+    /** Curated relationship type when origin=curated */
+    curatedRelationshipType: z.string().nullish(),
+    /** Curated source URL/note when origin=curated */
+    curatedSource: z.string().nullish(),
+    /** Curated peer id that produced this row when origin=derived */
+    derivedFromEntityId: z.uuid().nullish(),
+    /** Total normalized source-section weight matched when origin=precomputed */
+    matchedSectionWeight: z.number().nullish(),
+    origin: EntitySimilarityOriginSchema,
+    /** 1-based position in the merged result page */
+    rank: z.int(),
+    /** Number of source/target sections compared when origin=precomputed */
+    sharedSectionCount: z.int().nullish(),
+});
+/**
+ * Per-row provenance for a similar-entity result
+ *
+ * @openapiSchema EntitySimilarityContext
+ * @endpoint GET /v1/entities/detail/similar
+ * @usedBySchema EntitySimilarityResultSchema
+ * @contractShape entity.similarity-context
+ * @contractRole canonical
+ */
+export const EntitySimilarityContextSchema = EntitySimilarityContextSchemaDefinition;
+//# sourceMappingURL=similarity-context.js.map

package/dist/entity/similarity-origin.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+/**
+ * Provenance origin for a similar-entity result row.
+ *
+ * @openapiSchema EntitySimilarityOrigin
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @usedBySchema EntitySimilarityContextSchema
+ * @usedBySchema EntitySuggestionSchema
+ * @contractShape entity.similarity-origin
+ * @contractRole canonical
+ */
+export declare const EntitySimilarityOriginSchema: z.ZodEnum<{
+    computed: "computed";
+    curated: "curated";
+    derived: "derived";
+    precomputed: "precomputed";
+    semantic: "semantic";
+}>;
+export type EntitySimilarityOrigin = z.infer<typeof EntitySimilarityOriginSchema>;
+//# sourceMappingURL=similarity-origin.d.ts.map

package/dist/entity/similarity-origin.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";
+/**
+ * Provenance origin for a similar-entity result row.
+ *
+ * @openapiSchema EntitySimilarityOrigin
+ * @endpoint GET /v1/entities/detail/similar
+ * @endpoint GET /v1/entities/{entityId}/products/suggestions
+ * @endpoint GET /v1/entities/{entityId}/relationships/suggestions
+ * @usedBySchema EntitySimilarityContextSchema
+ * @usedBySchema EntitySuggestionSchema
+ * @contractShape entity.similarity-origin
+ * @contractRole canonical
+ */
+export const EntitySimilarityOriginSchema = z.enum([
+    "curated",
+    "semantic",
+    "precomputed",
+    "derived",
+    "computed",
+]);
+//# sourceMappingURL=similarity-origin.js.map