@go-mondo/identity-sdk 0.0.2-beta.9 → 0.0.2-beta.91

package/dist/cjs/common/schema/metadata.d.ts

@@ -1,55 +1,92 @@
+import * as z from 'zod/v4';
 /**
- * Value
- */
-export declare const MetadataValueSchema: import("arktype").BaseType<string | number | boolean, {}>;
-/**
- * Record
- */
-declare const MetadataRecordSchema: import("arktype/out/methods/object").ObjectType<{
-    [x: string]: string | number | boolean;
-}, {}>;
-export type MetadataRecord = typeof MetadataRecordSchema.inferOut;
-/**
- * Map
- */
-declare const MetadataMapSchema: import("arktype/out/methods/object").ObjectType<Map<string, string | number | boolean>, {}>;
-export type MetadataMap = typeof MetadataMapSchema.inferOut;
-export declare const MetadataPayloadSchema: import("arktype/out/methods/object").ObjectType<(In: {
-    [x: string]: string | number | boolean;
-} | Map<string, string | number | boolean> | null | undefined) => import("arktype").Out<{
-    [x: string]: string | number | boolean;
-} | undefined>, {}>;
-export type MetadataPayload = typeof MetadataPayloadSchema.inferOut;
-export declare const MetadataPayloadPropertySchema: import("arktype/out/methods/object").ObjectType<{
-    metadata?: ((In: {
-        [x: string]: string | number | boolean;
-    } | Map<string, string | number | boolean> | null | undefined) => import("arktype").Out<{
-        [x: string]: string | number | boolean;
-    } | undefined>) | undefined;
-}, {}>;
-export type MetadataPayloadProperty = typeof MetadataPayloadPropertySchema.inferOut;
-export declare const UpsertMetadataPayloadSchema: import("arktype/out/methods/object").ObjectType<(In: {
-    [x: string]: string | number | boolean;
-} | Map<string, string | number | boolean> | null | undefined) => import("arktype").Out<{
-    [x: string]: string | number | boolean;
-} | null>, {}>;
-export type UpsertMetadataInput = typeof UpsertMetadataPayloadSchema.inferIn;
-export type UpsertMetadataPayload = typeof UpsertMetadataPayloadSchema.inferOut;
-export declare const UpsertMetadataPropertyPayloadSchema: import("arktype/out/methods/object").ObjectType<{
-    metadata?: ((In: {
-        [x: string]: string | number | boolean;
-    } | Map<string, string | number | boolean> | null | undefined) => import("arktype").Out<{
-        [x: string]: string | number | boolean;
-    } | null>) | undefined;
-}, {}>;
-export type UpsertMetadataPropertyInput = typeof UpsertMetadataPropertyPayloadSchema.inferIn;
-export type UpsertMetadataPropertyPayload = typeof UpsertMetadataPropertyPayloadSchema.inferOut;
+ * Metadata values supported by the public API.
+ *
+ * Metadata is intentionally limited to primitive scalar values so it can be
+ * represented consistently as either a JavaScript `Map` or a JSON object.
+ */
+export declare const MetadataValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+type MetadataValue = z.output<typeof MetadataValueSchema>;
+/**
+ * JSON-object representation of metadata.
+ */
+export type MetadataRecord = Record<string, MetadataValue>;
+/**
+ * Runtime `Map` representation of metadata.
+ */
+export type MetadataMap = Map<string, MetadataValue>;
+/**
+ * Parses metadata into a `Map`.
+ *
+ * Accepts `null`, `undefined`, metadata records, and metadata maps. Nullish
+ * input is normalized to an empty `Map`.
+ */
+export declare const MetadataMapSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodMap<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<MetadataMap, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>;
+export type MetadataMapInput = z.input<typeof MetadataMapSchema>;
+/**
+ * Parses metadata into a record.
+ *
+ * Accepts `null`, `undefined`, metadata records, and metadata maps. Nullish
+ * input is normalized to `{}`. Empty string values are removed when converting
+ * from a `Map`, matching the payload builder behavior.
+ *
+ * Metadata records are limited to 10 items.
+ */
+export declare const MetadataRecordSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodMap<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<MetadataRecord, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>;
+export type MetadataRecordInput = z.input<typeof MetadataRecordSchema>;
+/**
+ * Object schema for resource models that expose metadata as a `Map`.
+ *
+ * Missing, `undefined`, or `null` `metadata` properties are normalized to an
+ * empty `Map`.
+ */
+export declare const MetadataMapPropertySchema: z.ZodObject<{
+    metadata: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodMap<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<MetadataMap, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>>, z.ZodTransform<MetadataMap, MetadataMap | undefined>>;
+}, z.core.$strip>;
+export type MetadataMapProperty = z.output<typeof MetadataMapPropertySchema>;
+/**
+ * Object schema for payloads that expose metadata as a record.
+ *
+ * Missing, `undefined`, `null`, and empty `metadata` properties are normalized
+ * to `undefined` so empty metadata is omitted from serialized payloads.
+ */
+export declare const MetadataRecordPropertySchema: z.ZodObject<{
+    metadata: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodMap<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<MetadataRecord, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>>, z.ZodTransform<MetadataRecord | undefined, MetadataRecord | undefined>>;
+}, z.core.$strip>;
+export type MetadataRecordPropertyInput = z.input<typeof MetadataRecordPropertySchema>;
+export type MetadataRecordProperty = z.output<typeof MetadataRecordPropertySchema>;
+/**
+ * Object schema for upsert payloads that expose metadata as a record.
+ *
+ * Missing or `undefined` `metadata` stays `undefined`. Explicitly empty or
+ * `null` metadata is normalized to `null`, allowing callers to clear existing
+ * metadata.
+ */
+export declare const UpsertMetadataPropertySchema: z.ZodObject<{
+    metadata: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodUndefined, z.ZodNull, z.ZodMap<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>, z.ZodTransform<MetadataRecord, Record<string, string | number | boolean> | Map<string, string | number | boolean> | null | undefined>>>, z.ZodTransform<MetadataRecord | null | undefined, MetadataRecord | undefined>>;
+}, z.core.$strip>;
+export type UpsertMetadataPropertyInput = z.input<typeof UpsertMetadataPropertySchema>;
+export type UpsertMetadataProperty = z.output<typeof UpsertMetadataPropertySchema>;
+/**
+ * Builds a serialized metadata payload from a map or record.
+ *
+ * Empty maps are returned as `undefined`; map entries with empty-string values
+ * are omitted.
+ */
 export declare function buildMetadataPayload(map: MetadataMap | MetadataRecord): MetadataRecord | undefined;
+/**
+ * Builds an upsert metadata payload from a map or record.
+ *
+ * Empty maps are returned as `null`; map entries with empty-string values are
+ * omitted. Use this for update/upsert flows where `null` means "clear".
+ */
 export declare function buildUpsertMetadataPayload(map: MetadataMap | MetadataRecord): MetadataRecord | null;
+/**
+ * Builds an upsert metadata payload from metadata entries.
+ *
+ * Returns `null` for `null`, empty iterables, or iterables whose values are all
+ * empty strings.
+ */
 export declare function buildUpsertMetadataPayloadFromIterable(metadata: Iterable<[string, string | number | boolean]> | null): MetadataRecord | null;
-export declare const MetadataMapPropertySchema: import("arktype/out/methods/object").ObjectType<{
-    metadata: (In: import("arktype/out/attributes").Default<unknown, Map<string, string | number | boolean>>) => import("arktype").Out<Map<string, string | number | boolean>>;
-}, {}>;
-export type MetadataMapProperty = typeof MetadataMapPropertySchema.inferOut;
 export {};
 //# sourceMappingURL=metadata.d.ts.map

package/dist/cjs/common/schema/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../src/common/schema/metadata.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,mBAAmB,2DAAoC,CAAC;AAErE;;GAEG;AACH,QAAA,MAAM,oBAAoB;;MAA4C,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,QAAQ,CAAC;AAElE;;GAEG;AACH,QAAA,MAAM,iBAAiB,6FAEtB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,QAAQ,CAAC;AAoB5D,eAAO,MAAM,qBAAqB;;;;mBAW/B,CAAC;AACJ,MAAM,MAAM,eAAe,GAAG,OAAO,qBAAqB,CAAC,QAAQ,CAAC;AAEpE,eAAO,MAAM,6BAA6B;;;;;;MAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GACjC,OAAO,6BAA6B,CAAC,QAAQ,CAAC;AAEhD,eAAO,MAAM,2BAA2B;;;;cAWrC,CAAC;AACJ,MAAM,MAAM,mBAAmB,GAAG,OAAO,2BAA2B,CAAC,OAAO,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,QAAQ,CAAC;AAEhF,eAAO,MAAM,mCAAmC;;;;;;MAE9C,CAAC;AACH,MAAM,MAAM,2BAA2B,GACrC,OAAO,mCAAmC,CAAC,OAAO,CAAC;AACrD,MAAM,MAAM,6BAA6B,GACvC,OAAO,mCAAmC,CAAC,QAAQ,CAAC;AAEtD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,WAAW,GAAG,cAAc,GAChC,cAAc,GAAG,SAAS,CAgB5B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,WAAW,GAAG,cAAc,GAChC,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,GAC7D,cAAc,GAAG,IAAI,CAgBvB;AAQD,eAAO,MAAM,yBAAyB;;MAEpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,yBAAyB,CAAC,QAAQ,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../src/common/schema/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,+DAI9B,CAAC;AACH,KAAK,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAyErD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,gXAE7B,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,mXAEqB,CAAC;AACvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;iBAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;iBAIvC,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,4BAA4B,CACpC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,4BAA4B,CACpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;iBAEvC,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,4BAA4B,CACpC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,4BAA4B,CACpC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,WAAW,GAAG,cAAc,GAChC,cAAc,GAAG,SAAS,CAE5B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,WAAW,GAAG,cAAc,GAChC,cAAc,GAAG,IAAI,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,GAC7D,cAAc,GAAG,IAAI,CAgBvB"}

package/dist/cjs/common/schema/metadata.js

@@ -1,76 +1,176 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetadataMapPropertySchema = exports.UpsertMetadataPropertyPayloadSchema = exports.UpsertMetadataPayloadSchema = exports.MetadataPayloadPropertySchema = exports.MetadataPayloadSchema = exports.MetadataValueSchema = void 0;
+exports.UpsertMetadataPropertySchema = exports.MetadataRecordPropertySchema = exports.MetadataMapPropertySchema = exports.MetadataRecordSchema = exports.MetadataMapSchema = exports.MetadataValueSchema = void 0;
 exports.buildMetadataPayload = buildMetadataPayload;
 exports.buildUpsertMetadataPayload = buildUpsertMetadataPayload;
 exports.buildUpsertMetadataPayloadFromIterable = buildUpsertMetadataPayloadFromIterable;
-const arktype_1 = require("arktype");
+const z = __importStar(require("zod/v4"));
 /**
- * Value
+ * Metadata values supported by the public API.
+ *
+ * Metadata is intentionally limited to primitive scalar values so it can be
+ * represented consistently as either a JavaScript `Map` or a JSON object.
  */
-exports.MetadataValueSchema = (0, arktype_1.type)('string | number | boolean');
+exports.MetadataValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+]);
 /**
- * Record
+ * Input
  */
-const MetadataRecordSchema = (0, arktype_1.type)({ '[string]': exports.MetadataValueSchema });
-/**
- * Map
- */
-const MetadataMapSchema = arktype_1.type.instanceOf((Map));
-/**
- * Record To Map
- */
-const MetadataMapMatch = (0, arktype_1.match)({
-    undefined: () => new Map(),
-})
-    .case(MetadataMapSchema, (s) => new Map(s))
-    .case(MetadataRecordSchema, (s) => new Map(Object.entries(s || {}).map(([key, value]) => [key, value])))
-    .default(() => new Map());
-exports.MetadataPayloadSchema = (0, arktype_1.type)('undefined | null')
-    .or(MetadataMapSchema)
-    .or(MetadataRecordSchema)
-    .pipe((map) => (map ? buildMetadataPayload(map) : undefined))
-    .narrow((n, ctx) => n && Object.keys(n).length > 10
-    ? ctx.reject({
-        expected: '10 items or less',
-        actual: `${Object.keys(n).length}`,
-    })
-    : true);
-exports.MetadataPayloadPropertySchema = (0, arktype_1.type)({
-    'metadata?': exports.MetadataPayloadSchema,
-});
-exports.UpsertMetadataPayloadSchema = (0, arktype_1.type)('undefined | null')
-    .or(MetadataMapSchema)
-    .or(MetadataRecordSchema)
-    .pipe((map) => (map ? buildUpsertMetadataPayload(map) || null : null))
-    .narrow((n, ctx) => n && Object.keys(n).length > 10
-    ? ctx.reject({
-        expected: '10 items or less',
-        actual: `${Object.keys(n).length}`,
-    })
-    : true);
-exports.UpsertMetadataPropertyPayloadSchema = (0, arktype_1.type)({
-    'metadata?': exports.UpsertMetadataPayloadSchema,
-});
-function buildMetadataPayload(map) {
-    if (!(map instanceof Map)) {
-        return map;
+const MetadataRecordInputSchema = z.record(z.string(), exports.MetadataValueSchema);
+const MetadataMapInputSchema = z.map(z.string(), exports.MetadataValueSchema);
+const MetadataInputSchema = z.union([
+    z.undefined(),
+    z.null(),
+    MetadataMapInputSchema,
+    MetadataRecordInputSchema,
+]);
+function isMetadataMap(input) {
+    return input instanceof Map;
+}
+function transformToMetadataMap(input) {
+    if (input == null) {
+        return new Map();
     }
-    const result = Array.from(map.entries()).reduce((result, [key, value]) => {
+    if (isMetadataMap(input)) {
+        return new Map(input);
+    }
+    return new Map(Object.entries(input));
+}
+function transformToMetadataRecord(input) {
+    if (input == null) {
+        return {};
+    }
+    if (!isMetadataMap(input)) {
+        return input;
+    }
+    return Array.from(input.entries()).reduce((result, [key, value]) => {
         if (value == null || value === '') {
             return result;
         }
         Object.assign(result, { [key]: value });
         return result;
     }, {});
-    return Object.keys(result).length ? result : undefined;
 }
-function buildUpsertMetadataPayload(map) {
-    if (!(map instanceof Map)) {
-        return map;
+function emptyRecordToUndefined(record) {
+    return Object.keys(record).length ? record : undefined;
+}
+function emptyRecordToNull(record) {
+    if (record == null) {
+        return record;
     }
-    return buildUpsertMetadataPayloadFromIterable(map.entries());
+    return Object.keys(record).length ? record : null;
+}
+function hasTenOrFewerItems(record) {
+    return !record || Object.keys(record).length <= 10;
+}
+const metadataItemsLimitConfig = {
+    message: 'Metadata must have 10 items or less',
+};
+/**
+ * Parses metadata into a `Map`.
+ *
+ * Accepts `null`, `undefined`, metadata records, and metadata maps. Nullish
+ * input is normalized to an empty `Map`.
+ */
+exports.MetadataMapSchema = MetadataInputSchema.transform(transformToMetadataMap);
+/**
+ * Parses metadata into a record.
+ *
+ * Accepts `null`, `undefined`, metadata records, and metadata maps. Nullish
+ * input is normalized to `{}`. Empty string values are removed when converting
+ * from a `Map`, matching the payload builder behavior.
+ *
+ * Metadata records are limited to 10 items.
+ */
+exports.MetadataRecordSchema = MetadataInputSchema.transform(transformToMetadataRecord).refine(hasTenOrFewerItems, metadataItemsLimitConfig);
+/**
+ * Object schema for resource models that expose metadata as a `Map`.
+ *
+ * Missing, `undefined`, or `null` `metadata` properties are normalized to an
+ * empty `Map`.
+ */
+exports.MetadataMapPropertySchema = z.object({
+    metadata: exports.MetadataMapSchema.optional().transform((metadata) => metadata ?? new Map()),
+});
+/**
+ * Object schema for payloads that expose metadata as a record.
+ *
+ * Missing, `undefined`, `null`, and empty `metadata` properties are normalized
+ * to `undefined` so empty metadata is omitted from serialized payloads.
+ */
+exports.MetadataRecordPropertySchema = z.object({
+    metadata: exports.MetadataRecordSchema.optional().transform((metadata) => metadata ? emptyRecordToUndefined(metadata) : undefined),
+});
+/**
+ * Object schema for upsert payloads that expose metadata as a record.
+ *
+ * Missing or `undefined` `metadata` stays `undefined`. Explicitly empty or
+ * `null` metadata is normalized to `null`, allowing callers to clear existing
+ * metadata.
+ */
+exports.UpsertMetadataPropertySchema = z.object({
+    metadata: exports.MetadataRecordSchema.optional().transform(emptyRecordToNull),
+});
+/**
+ * Builds a serialized metadata payload from a map or record.
+ *
+ * Empty maps are returned as `undefined`; map entries with empty-string values
+ * are omitted.
+ */
+function buildMetadataPayload(map) {
+    return emptyRecordToUndefined(transformToMetadataRecord(map));
+}
+/**
+ * Builds an upsert metadata payload from a map or record.
+ *
+ * Empty maps are returned as `null`; map entries with empty-string values are
+ * omitted. Use this for update/upsert flows where `null` means "clear".
+ */
+function buildUpsertMetadataPayload(map) {
+    return emptyRecordToNull(transformToMetadataRecord(map)) ?? null;
 }
+/**
+ * Builds an upsert metadata payload from metadata entries.
+ *
+ * Returns `null` for `null`, empty iterables, or iterables whose values are all
+ * empty strings.
+ */
 function buildUpsertMetadataPayloadFromIterable(metadata) {
     if (metadata == null) {
         return null;
@@ -84,24 +184,3 @@ function buildUpsertMetadataPayloadFromIterable(metadata) {
     }, {});
     return Object.keys(result).length ? result : null;
 }
-/**
- * Map
- */
-const ToMetadataMapSchema = MetadataMapMatch.default(() => new Map());
-exports.MetadataMapPropertySchema = (0, arktype_1.type)({
-    metadata: ToMetadataMapSchema,
-});
-// export const metadataAttributeScope = scope({
-//   metadata: MetadataAttributeMatch.default(
-//     () => new Map<string, typeof MetadataAttributeValueSchema.inferOut>(),
-//   ),
-// });
-// export const metadataPropertyScope = scope({
-//   'metadata?': MetadataPropertyItemSchema,
-// });
-// export const serializedMetadataScope = scope({
-//   metadata: SerializedMetadataSchema,
-// });
-// export const storageMetadataScope = scope({
-//   metadata: StorageMetadataSchema,
-// });