@aventurevc/api-schemas 0.8.215 → 0.8.217

package/dist/entity/url-link.js

@@ -13,7 +13,7 @@ const EntityUrlLinkSchemaDefinition = z.object({
     id: z.int().nullish(),
     /** `true` = owner currently uses this URL; `false` = historical/former (rebrand source domain, deprecated platform handle). The lifecycle state lives here, NEVER in the `urlType` discriminator. */
     isCurrent: z.boolean().nullish(),
-    /** `true` = canonical/primary URL of this `urlType` for this owner. Only one row per (owner, urlType) may be `isCurrent=true` AND `isPrimary=true`. */
+    /** `true` = canonical/primary URL of this `urlType` for this owner. Only one row per (owner, urlType) may be `isCurrent=true` AND `isPrimary=true`. Retired rows are always non-primary, including when a write requests otherwise. */
     isPrimary: z.boolean().nullish(),
     /** Owning record, nested ids only: owner.entityId or owner.personId — exactly one is set, and no name fields. Writes are scoped by the owning entity/person route; owner is never a write field. */
     owner: EntityPersonOwnerSchema.nullish(),
@@ -23,7 +23,7 @@ const EntityUrlLinkSchemaDefinition = z.object({
     /** Time of the latest URL status observation. */
     statusChecked: z.iso.datetime({ offset: true }).nullish(),
     updatedAt: z.iso.datetime({ offset: true }).nullish(),
-    /** Canonical absolute HTTP URL value - validates scheme + host at construction */
+    /** Canonical absolute URL after storage and live same-site host normalization. */
     url: z.string(),
     urlType: EntityUrlTypeSchema,
 });

package/dist/http/openapi-metadata.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod/v4";
+/**
+ * Mechanical file-only projection: null path segments mean array items, never object keys.
+ * @usedByEndpoint none:external-root
+ * @shared primitive:multi OpenAPI file-map boundary metadata; not direct because consumers project schema structure rather than endpoint payloads
+ * @contractShape http.openapi-request-body-file-map
+ * @contractRole canonical
+ * @ownerModule http/openapi-metadata.ts
+ */
+export declare const RequestBodyFileMapSchema: z.ZodObject<{
+    bodyPath: z.ZodString;
+    valueField: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        path: z.ZodReadonly<z.ZodArray<z.ZodNullable<z.ZodString>>>;
+        type: z.ZodEnum<{
+            array: "array";
+            boolean: "boolean";
+            integer: "integer";
+            number: "number";
+            object: "object";
+            string: "string";
+        }>;
+        nullable: z.ZodBoolean;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RequestBodyFileMap = z.infer<typeof RequestBodyFileMapSchema>;
+/**
+ * @usedByEndpoint none:external-root
+ * @shared primitive:multi OpenAPI readback boundary metadata; not direct because consumers interpret source-owned extension values rather than endpoint payloads
+ * @contractShape http.openapi-mutation-readback
+ * @contractRole canonical
+ * @ownerModule http/openapi-metadata.ts
+ */
+export declare const OpenApiWriteReadbackSchema: z.ZodObject<{
+    readOperationId: z.ZodString;
+    writePointer: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+    readPointer: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+    readParameter: z.ZodOptional<z.ZodString>;
+    submittedMap: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        bodyPointer: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+        readPointer: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+        identityPointer: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type OpenApiWriteReadback = z.infer<typeof OpenApiWriteReadbackSchema>;
+//# sourceMappingURL=openapi-metadata.d.ts.map

package/dist/http/openapi-metadata.js

@@ -0,0 +1,46 @@
+// Generated alternate api-schemas support copy from TypeScript source api-schemas/http/openapi-metadata.ts
+import { z } from "zod/v4";
+/**
+ * Mechanical file-only projection: null path segments mean array items, never object keys.
+ * @usedByEndpoint none:external-root
+ * @shared primitive:multi OpenAPI file-map boundary metadata; not direct because consumers project schema structure rather than endpoint payloads
+ * @contractShape http.openapi-request-body-file-map
+ * @contractRole canonical
+ * @ownerModule http/openapi-metadata.ts
+ */
+export const RequestBodyFileMapSchema = z.object({
+    bodyPath: z.string(),
+    valueField: z
+        .array(z.object({
+        path: z.array(z.string().nullable()).readonly(),
+        type: z.enum(["object", "array", "string", "number", "integer", "boolean"]),
+        nullable: z.boolean(),
+    }))
+        .readonly(),
+});
+const OpenApiJsonPointerSchema = z.union([
+    z.literal(""),
+    z.string().regex(/^(?:\/(?:[^~/]|~[01])*)+$/),
+]);
+/**
+ * @usedByEndpoint none:external-root
+ * @shared primitive:multi OpenAPI readback boundary metadata; not direct because consumers interpret source-owned extension values rather than endpoint payloads
+ * @contractShape http.openapi-mutation-readback
+ * @contractRole canonical
+ * @ownerModule http/openapi-metadata.ts
+ */
+export const OpenApiWriteReadbackSchema = z.strictObject({
+    readOperationId: z.string().min(1),
+    writePointer: OpenApiJsonPointerSchema,
+    readPointer: OpenApiJsonPointerSchema,
+    readParameter: z.string().min(1).optional(),
+    submittedMap: z
+        .array(z.strictObject({
+        bodyPointer: OpenApiJsonPointerSchema,
+        readPointer: OpenApiJsonPointerSchema,
+        identityPointer: OpenApiJsonPointerSchema,
+    }))
+        .min(1)
+        .optional(),
+});
+//# sourceMappingURL=openapi-metadata.js.map

package/package.json

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