@opencoredev/social-sdk 0.3.0 → 0.4.0

package/dist/cloud/zernio.js

@@ -1,10 +1,10 @@
-/* oxlint-disable anti-slop/no-runtime-typeof -- validated external boundary or fixture contract. */
 import { managedLifecycle } from "./lifecycle.js";
 import { managedMedia } from "./media.js";
 export { MemoryManagedMediaStore, } from "./media.js";
 import { defineAdapter } from "../core/adapter.js";
 import { SocialError } from "../core/errors.js";
-import { array, object, optionalNumber, optionalString, string } from "../transport/validation.js";
+import { definedFields } from "../core/fields.js";
+import { array, isBoolean, isFiniteNumber, isJsonArray, isJsonObject, isString, object, optionalNumber, optionalString, string, } from "../transport/validation.js";
 import { decodeWebhook, verifyZernioWebhook } from "../server/webhooks.js";
 import { accountMatches, capabilityManifest, managedHttp, managedPreparation, managedOptionIssues, optionsObject, platform, publicFields, } from "./common.js";
 import { zernioOutcome } from "./outcomes.js";
@@ -12,7 +12,6 @@ export function zernio(options) {
     const request = managedHttp("https://zernio.com/api", options);
     const mediaPipeline = managedMedia("zernio", options, (body, context) => request("/v1/media/presign", context, body));
     const now = () => (options.clock?.() ?? new Date()).toISOString();
-    // oxlint-disable-next-line anti-slop/no-unknown-parameters -- provider payload is validated at this adapter boundary.
     const account = (value, backend) => {
         const row = object(value);
         const handle = optionalString(row["username"]);
@@ -25,8 +24,7 @@ export function zernio(options) {
                 accountId: string(row["_id"]),
             },
             displayName: optionalString(row["displayName"]) ?? handle ?? string(row["_id"]),
-            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-            ...(handle ? { handle } : {}),
+            ...definedFields({ handle: handle || undefined }),
             status: row["isActive"] === true
                 ? "connected"
                 : row["isActive"] === false
@@ -34,7 +32,6 @@ export function zernio(options) {
                     : "unknown",
         };
     };
-    // oxlint-disable-next-line anti-slop/no-unknown-parameters -- validated by account at this boundary.
     const supportedAccount = (value, backend) => {
         try {
             return account(value, backend);
@@ -127,8 +124,9 @@ export function zernio(options) {
                         const parsed = supportedAccount(value, context.backendInstance);
                         return parsed ? [parsed] : [];
                     }),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(pages !== undefined && page < pages ? { nextCursor: String(page + 1) } : {}),
+                    ...definedFields({
+                        nextCursor: pages !== undefined && page < pages ? String(page + 1) : undefined,
+                    }),
                 };
             },
             async get(ref, context) {
@@ -193,55 +191,33 @@ export function zernio(options) {
                 const rows = array(result["posts"])
                     .map(object)
                     .flatMap((row) => {
-                    const destinations = Array.isArray(row["platforms"])
+                    const destinations = isJsonArray(row["platforms"])
                         ? array(row["platforms"]).map(object)
                         : [];
                     const destination = destinations.find((item) => {
                         const value = item["accountId"];
-                        const id = 
-                        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                        typeof value === "string"
+                        const id = isString(value)
                             ? value
-                            : // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                                value && typeof value === "object"
-                                    ? object(value)["_id"]
-                                    : undefined;
+                            : isJsonObject(value) || isJsonArray(value)
+                                ? object(value)["_id"]
+                                : undefined;
                         return (id === account.accountId &&
                             (item["platform"] === account.platform ||
                                 item["platform"] === (account.platform === "x" ? "twitter" : account.platform)));
                     });
                     if (destination === undefined)
                         return [];
-                    const platformPostId = 
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    typeof destination["platformPostId"] === "string"
-                        ? destination["platformPostId"]
-                        : undefined;
                     return [
-                        // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
                         {
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                            ...(typeof row["_id"] === "string" ? { backendPostId: row["_id"] } : {}),
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                            ...(platformPostId === undefined ? {} : { platformPostId }),
+                            ...definedFields({
+                                backendPostId: optionalString(row["_id"]),
+                                platformPostId: optionalString(destination["platformPostId"]),
+                            }),
                             platform: account.platform,
                             accountId: account.accountId,
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                            ...(typeof destination["platformPostUrl"] === "string"
-                                ? { platformPostUrl: destination["platformPostUrl"] }
-                                : {}),
+                            ...definedFields({
+                                platformPostUrl: optionalString(destination["platformPostUrl"]),
+                            }),
                             ...publicFields(row, [
                                 "content",
                                 "caption",
@@ -257,12 +233,10 @@ export function zernio(options) {
                 const pagination = result["pagination"] === undefined ? {} : object(result["pagination"]);
                 const totalPages = optionalNumber(pagination["pages"]) ?? optionalNumber(pagination["totalPages"]);
                 return {
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
                     items: rows,
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(totalPages !== undefined && page < totalPages
-                        ? { nextCursor: String(page + 1) }
-                        : {}),
+                    ...definedFields({
+                        nextCursor: totalPages !== undefined && page < totalPages ? String(page + 1) : undefined,
+                    }),
                 };
             },
             prepareTarget(target) {
@@ -291,23 +265,20 @@ export function zernio(options) {
                     media.push({
                         type: item.kind,
                         url: await mediaPipeline.resolve(item, target.account, context),
-                        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                        ...(item.altText === undefined ? {} : { altText: item.altText }),
-                        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                        ...(item.mimeType === undefined ? {} : { mimeType: item.mimeType }),
+                        ...definedFields({ altText: item.altText, mimeType: item.mimeType }),
                     });
                 const config = optionsObject(target);
                 const native = {};
                 if (target.account.platform === "youtube") {
                     native["title"] = string(config["title"]);
                     native["visibility"] = string(config["visibility"]);
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    if (typeof config["madeForKids"] === "boolean")
-                        native["madeForKids"] = config["madeForKids"];
+                    const madeForKids = config["madeForKids"];
+                    if (isBoolean(madeForKids))
+                        native["madeForKids"] = madeForKids;
                 }
-                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                if (target.account.platform === "instagram" && typeof config["shareToFeed"] === "boolean")
-                    native["shareToFeed"] = config["shareToFeed"];
+                const shareToFeed = config["shareToFeed"];
+                if (target.account.platform === "instagram" && isBoolean(shareToFeed))
+                    native["shareToFeed"] = shareToFeed;
                 if (target.account.platform === "x" &&
                     config["replySettings"] !== undefined &&
                     config["replySettings"] !== "everyone")
@@ -319,21 +290,24 @@ export function zernio(options) {
                     native["autoAddMusic"] = false;
                     native["allowDuet"] = !config["disableDuet"];
                     native["allowStitch"] = !config["disableStitch"];
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    native["isBrandOrganicPost"] = config["ownBrand"];
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    native["videoMadeWithAi"] = config["aiGenerated"];
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    native["draft"] = config["draft"];
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    if (typeof config["photoCoverIndex"] === "number")
-                        native["photoCoverIndex"] = config["photoCoverIndex"];
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    if (typeof config["disableComments"] === "boolean")
-                        native["allowComment"] = !config["disableComments"];
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    if (typeof config["brandedContent"] === "boolean")
-                        native["brandPartnerPromote"] = config["brandedContent"];
+                    // prepareTarget requires these TikTok choices to be booleans. Skipping an
+                    // absent value sends the same JSON body, since serialization drops undefined.
+                    for (const [nativeKey, optionKey] of [
+                        ["isBrandOrganicPost", "ownBrand"],
+                        ["videoMadeWithAi", "aiGenerated"],
+                        ["draft", "draft"],
+                    ]) {
+                        const value = config[optionKey];
+                        if (value !== undefined)
+                            native[nativeKey] = value;
+                    }
+                    const { photoCoverIndex, disableComments, brandedContent } = config;
+                    if (isFiniteNumber(photoCoverIndex))
+                        native["photoCoverIndex"] = photoCoverIndex;
+                    if (isBoolean(disableComments))
+                        native["allowComment"] = !disableComments;
+                    if (isBoolean(brandedContent))
+                        native["brandPartnerPromote"] = brandedContent;
                 }
                 const response = await request("/v1/posts", context, {
                     content: target.content.text ?? "",
@@ -342,15 +316,15 @@ export function zernio(options) {
                         {
                             platform: target.account.platform === "x" ? "twitter" : target.account.platform,
                             accountId: target.account.accountId,
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                            ...(Object.keys(native).length ? { platformSpecificData: native } : {}),
+                            ...definedFields({
+                                platformSpecificData: Object.keys(native).length ? native : undefined,
+                            }),
                         },
                     ],
                     ...(target.schedule
                         ? {
                             scheduledFor: target.schedule.at,
-                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                            ...(target.schedule.timeZone ? { timezone: target.schedule.timeZone } : {}),
+                            ...definedFields({ timezone: target.schedule.timeZone || undefined }),
                         }
                         : { publishNow: true }),
                 });
@@ -471,8 +445,7 @@ export function zernio(options) {
                 const result = object(await request(`/v1/inbox/comments/${encodeURIComponent(ref.postId)}`, context, undefined, {
                     accountId: ref.accountId,
                     limit: String(limit),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+                    ...definedFields({ cursor: input.cursor }),
                 }));
                 const pagination = result["pagination"] ? object(result["pagination"]) : {};
                 const cursor = optionalString(pagination["cursor"]);
@@ -492,8 +465,7 @@ export function zernio(options) {
                         "canDelete",
                         "canHide",
                     ])),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(hasMore === false || !cursor ? {} : { nextCursor: cursor }),
+                    ...definedFields({ nextCursor: hasMore === false || !cursor ? undefined : cursor }),
                 };
             },
             async reply(ref, content, context) {
@@ -525,8 +497,7 @@ export function zernio(options) {
                 const result = object(await request("/v1/inbox/conversations", context, undefined, {
                     accountId: ref.accountId,
                     limit: String(limit),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+                    ...definedFields({ cursor: input.cursor }),
                 }));
                 const pagination = result["pagination"] === undefined ? {} : object(result["pagination"]);
                 const cursor = optionalString(pagination["nextCursor"]);
@@ -541,8 +512,7 @@ export function zernio(options) {
                         "updatedTime",
                         "unreadCount",
                     ])),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(cursor ? { nextCursor: cursor } : {}),
+                    ...definedFields({ nextCursor: cursor || undefined }),
                 };
             },
             async listMessages(ref, input, context) {
@@ -557,8 +527,7 @@ export function zernio(options) {
                 const result = object(await request(`/v1/inbox/conversations/${encodeURIComponent(ref.conversationId)}/messages`, context, undefined, {
                     accountId: ref.accountId,
                     limit: String(limit),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+                    ...definedFields({ cursor: input.cursor }),
                 }));
                 const pagination = result["pagination"] ? object(result["pagination"]) : {};
                 const cursor = optionalString(pagination["nextCursor"]);
@@ -572,8 +541,7 @@ export function zernio(options) {
                         "createdAt",
                         "deliveryStatus",
                     ])),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(cursor ? { nextCursor: cursor } : {}),
+                    ...definedFields({ nextCursor: cursor || undefined }),
                 };
             },
             async send(ref, content, context) {
@@ -587,8 +555,7 @@ export function zernio(options) {
                     });
                 const data = object(result["data"]);
                 const messageId = optionalString(data["messageId"]);
-                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                return { state: "sent", ...(messageId ? { messageId } : {}) };
+                return { state: "sent", ...definedFields({ messageId: messageId || undefined }) };
             },
         },
         webhooks: {
@@ -613,14 +580,7 @@ export function zernio(options) {
                 const response = object(await request(`/v1/connect/${input.platform === "x" ? "twitter" : encodeURIComponent(input.platform)}`, context, undefined, { profileId: input.profileId, redirect_url: input.redirectUrl }));
                 return {
                     url: string(response["authUrl"]),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                    ...(typeof response["state"] === "string" ? { providerState: response["state"] } : {}),
+                    ...definedFields({ providerState: optionalString(response["state"]) }),
                 };
             },
             async listProfiles(context) {

package/dist/core/client.js

@@ -1,7 +1,7 @@
-/* oxlint-disable anti-slop/require-readable-spacing, anti-slop/no-conditional-empty-object-spread, anti-slop/require-safety-comment-for-type-assertion -- facade dispatch keeps capability-specific branches together. */
 import { decodeCursor, encodeCursor, iterateItems } from "./pagination.js";
 import { createConcurrencyLimiter } from "./concurrency.js";
 import { SocialError } from "./errors.js";
+import { definedFields } from "./fields.js";
 import { deriveTargetIdempotencyKey, fingerprint, } from "./idempotency.js";
 function targetKey(account) {
     return JSON.stringify([account.backend, account.platform, account.accountId]);
@@ -96,10 +96,19 @@ function unsupported(operation, backend) {
         message: `${backend} does not implement ${operation}`,
     });
 }
-// oxlint-disable-next-line anti-slop/no-unknown-parameters -- Adapter rejections enter the error boundary here.
-function outcomeFromError(error, // Transport and adapter rejections can be arbitrary JavaScript values.
-target, observedAt) {
-    if (error instanceof SocialError) {
+/**
+ * Runtime guards for JavaScript callers that bypass the facade's static types.
+ * They are generic so a typed argument keeps its declared type when narrowed.
+ */
+function isObjectInput(value) {
+    return typeof value === "object" && value !== null;
+}
+function isNonBlankStringInput(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+/** `error` is the rejection when it was a SocialError, or undefined for any other thrown value. */
+function outcomeFromError(error, target, observedAt) {
+    if (error !== undefined) {
         if (error.code === "cancelled") {
             return {
                 state: "unknown",
@@ -186,15 +195,15 @@ export function createSocial(config) {
                 message: `Unknown backend instance: ${backend}`,
             });
         }
-        return limiter(signal, operation, work).catch((error) => {
-            if (error instanceof SocialError)
-                throw error;
+        return limiter(signal, operation, work).catch((cause) => {
+            if (cause instanceof SocialError)
+                throw cause;
             throw new SocialError({
                 code: "upstream_failure",
                 operation,
                 backend,
                 message: "The adapter failed while processing the request",
-                cause: error,
+                cause,
             });
         });
     }
@@ -311,15 +320,12 @@ export function createSocial(config) {
         }
     }
     function validateAccountRef(account, operation) {
-        if (account === null ||
-            typeof account !== "object" ||
+        if (!isObjectInput(account) ||
             account.kind !== "connected-account" ||
             account.version !== 1 ||
-            typeof account.backend !== "string" ||
-            !account.backend.trim() ||
+            !isNonBlankStringInput(account.backend) ||
             !account.platform ||
-            typeof account.accountId !== "string" ||
-            !account.accountId.trim())
+            !isNonBlankStringInput(account.accountId))
             throw new SocialError({
                 code: "invalid_input",
                 operation,
@@ -494,7 +500,7 @@ export function createSocial(config) {
                                 observedAt: observedAt(),
                                 reason: "capacity",
                             }
-                            : outcomeFromError(error, target, observedAt());
+                            : outcomeFromError(error instanceof SocialError ? error : undefined, target, observedAt());
             }
             if (claim?.kind === "new" && config.idempotencyStore !== undefined) {
                 try {
@@ -583,16 +589,9 @@ export function createSocial(config) {
     const graphFacade = {
         async getProfile(account, input, callOptions) {
             validateAccountRef(account, "profiles.read");
-            if (input === null ||
-                typeof input !== "object" ||
-                (input.profileId !== undefined &&
-                    input.handle !== undefined &&
-                    typeof input.profileId !== "string" &&
-                    typeof input.handle !== "string") ||
-                (input.profileId !== undefined &&
-                    (typeof input.profileId !== "string" || input.profileId.trim() === "")) ||
-                (input.handle !== undefined &&
-                    (typeof input.handle !== "string" || input.handle.trim() === "")))
+            if (!isObjectInput(input) ||
+                (input.profileId !== undefined && !isNonBlankStringInput(input.profileId)) ||
+                (input.handle !== undefined && !isNonBlankStringInput(input.handle)))
                 throw new SocialError({
                     code: "invalid_input",
                     operation: "profiles.read",
@@ -608,8 +607,7 @@ export function createSocial(config) {
         },
         async listRelationships(account, input, callOptions) {
             validateAccountRef(account, "graph.read");
-            if (input === null ||
-                typeof input !== "object" ||
+            if (!isObjectInput(input) ||
                 !["following", "followers", "blocked", "muted"].includes(input.kind) ||
                 (input.limit !== undefined && (!Number.isSafeInteger(input.limit) || input.limit < 1)))
                 throw new SocialError({
@@ -636,30 +634,52 @@ export function createSocial(config) {
             ]);
             const page = await dispatch(account.backend, callOptions?.signal, "graph.read", () => adapter.graph.listRelationships(account, {
                 ...input,
-                ...(input.cursor === undefined ? {} : { cursor: decodeCursor(scope, input.cursor) }),
+                ...definedFields({
+                    cursor: input.cursor === undefined ? undefined : decodeCursor(scope, input.cursor),
+                }),
             }, makeContext(account.backend, correlationId, callOptions)));
             return encodePage(scope, page);
         },
-        follow: (target, options) => graphMutation(target, "graph.follow", options),
-        unfollow: (target, options) => graphMutation(target, "graph.unfollow", options),
-        block: (target, options) => graphMutation(target, "graph.block", options),
-        unblock: (target, options) => graphMutation(target, "graph.unblock", options),
-        mute: (target, options) => graphMutation(target, "graph.mute", options),
-        unmute: (target, options) => graphMutation(target, "graph.unmute", options),
+        follow: (target, options) => graphMutation(target, "graph.follow", options, async (graph, context) => {
+            if (graph.follow === undefined)
+                unsupported("graph.follow", target.backend);
+            return await graph.follow(target, context);
+        }),
+        unfollow: (target, options) => graphMutation(target, "graph.unfollow", options, async (graph, context) => {
+            if (graph.unfollow === undefined)
+                unsupported("graph.unfollow", target.backend);
+            await graph.unfollow(target, context);
+        }),
+        block: (target, options) => graphMutation(target, "graph.block", options, async (graph, context) => {
+            if (graph.block === undefined)
+                unsupported("graph.block", target.backend);
+            return await graph.block(target, context);
+        }),
+        unblock: (target, options) => graphMutation(target, "graph.unblock", options, async (graph, context) => {
+            if (graph.unblock === undefined)
+                unsupported("graph.unblock", target.backend);
+            await graph.unblock(target, context);
+        }),
+        mute: (target, options) => graphMutation(target, "graph.mute", options, async (graph, context) => {
+            if (graph.mute === undefined)
+                unsupported("graph.mute", target.backend);
+            return await graph.mute(target, context);
+        }),
+        unmute: (target, options) => graphMutation(target, "graph.unmute", options, async (graph, context) => {
+            if (graph.unmute === undefined)
+                unsupported("graph.unmute", target.backend);
+            await graph.unmute(target, context);
+        }),
     };
-    async function graphMutation(target, operation, callOptions) {
-        if (target === null ||
-            typeof target !== "object" ||
+    /** Validates and authorizes a graph mutation, then runs `mutate` inside the backend limiter. */
+    async function graphMutation(target, operation, callOptions, mutate) {
+        if (!isObjectInput(target) ||
             target.kind !== "profile" ||
             target.version !== 1 ||
-            typeof target.backend !== "string" ||
-            target.backend.trim() === "" ||
-            typeof target.platform !== "string" ||
-            target.platform.trim() === "" ||
-            typeof target.accountId !== "string" ||
-            target.accountId.trim() === "" ||
-            typeof target.profileId !== "string" ||
-            target.profileId.trim() === "")
+            !isNonBlankStringInput(target.backend) ||
+            !isNonBlankStringInput(target.platform) ||
+            !isNonBlankStringInput(target.accountId) ||
+            !isNonBlankStringInput(target.profileId))
             throw new SocialError({
                 code: "invalid_input",
                 operation,
@@ -679,37 +699,8 @@ export function createSocial(config) {
         if (adapter.graph === undefined)
             unsupported(operation, target.backend);
         const context = makeContext(target.backend, correlationId, callOptions);
-        return dispatch(target.backend, callOptions?.signal, operation, async () => {
-            switch (operation) {
-                case "graph.follow":
-                    if (adapter.graph.follow === undefined)
-                        unsupported(operation, target.backend);
-                    return await adapter.graph.follow(target, context);
-                case "graph.unfollow":
-                    if (adapter.graph.unfollow === undefined)
-                        unsupported(operation, target.backend);
-                    await adapter.graph.unfollow(target, context);
-                    return undefined;
-                case "graph.block":
-                    if (adapter.graph.block === undefined)
-                        unsupported(operation, target.backend);
-                    return await adapter.graph.block(target, context);
-                case "graph.unblock":
-                    if (adapter.graph.unblock === undefined)
-                        unsupported(operation, target.backend);
-                    await adapter.graph.unblock(target, context);
-                    return undefined;
-                case "graph.mute":
-                    if (adapter.graph.mute === undefined)
-                        unsupported(operation, target.backend);
-                    return await adapter.graph.mute(target, context);
-                case "graph.unmute":
-                    if (adapter.graph.unmute === undefined)
-                        unsupported(operation, target.backend);
-                    await adapter.graph.unmute(target, context);
-                    return undefined;
-            }
-        });
+        const graph = adapter.graph;
+        return dispatch(target.backend, callOptions?.signal, operation, () => mutate(graph, context));
     }
     async function lifecycle(ref, expectedKind, operation, callOptions) {
         if (ref.kind !== expectedKind || ref.version !== 1 || !ref.accountId || !ref.platform)
@@ -780,7 +771,7 @@ export function createSocial(config) {
                     operation: "posts.publishSequence",
                     message: "A sequence requires at least one item",
                 });
-            if (typeof request.idempotencyKey !== "string" || request.idempotencyKey.trim() === "")
+            if (!isNonBlankStringInput(request.idempotencyKey))
                 throw new SocialError({
                     code: "invalid_input",
                     operation: "posts.publishSequence",
@@ -917,13 +908,10 @@ export function createSocial(config) {
             validateAccountRef(account, "search.posts");
             if (input === null ||
                 input === undefined ||
-                typeof input.query !== "string" ||
-                !input.query.trim() ||
+                !isNonBlankStringInput(input.query) ||
                 (input.limit !== undefined && (!Number.isSafeInteger(input.limit) || input.limit < 1)) ||
-                (input.startTime !== undefined &&
-                    (typeof input.startTime !== "string" || !validTimestamp(input.startTime))) ||
-                (input.endTime !== undefined &&
-                    (typeof input.endTime !== "string" || !validTimestamp(input.endTime))) ||
+                (input.startTime !== undefined && !validTimestamp(input.startTime)) ||
+                (input.endTime !== undefined && !validTimestamp(input.endTime)) ||
                 (input.startTime !== undefined &&
                     input.endTime !== undefined &&
                     Date.parse(input.startTime) > Date.parse(input.endTime)) ||
@@ -1010,14 +998,10 @@ export function createSocial(config) {
                 query.from > query.to ||
                 !Array.isArray(query.metrics) ||
                 query.metrics.length === 0 ||
-                query.metrics.some(
-                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- runtime query boundary.
-                (metric) => typeof metric !== "string" || !metric.trim()) ||
+                query.metrics.some((metric) => !isNonBlankStringInput(metric)) ||
                 (query.dimensions !== undefined &&
                     (!Array.isArray(query.dimensions) ||
-                        query.dimensions.some(
-                        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- runtime query boundary.
-                        (dimension) => typeof dimension !== "string" || !dimension.trim()))))
+                        query.dimensions.some((dimension) => !isNonBlankStringInput(dimension)))))
                 throw new SocialError({
                     code: "invalid_input",
                     operation: "analytics.report.read",
@@ -1201,9 +1185,7 @@ export function createSocial(config) {
         },
         async markSeen(account, input = {}, callOptions) {
             validateAccountRef(account, "notifications.seen");
-            if (input === null ||
-                typeof input !== "object" ||
-                (input.seenAt !== undefined && !validTimestamp(input.seenAt)))
+            if (!isObjectInput(input) || (input.seenAt !== undefined && !validTimestamp(input.seenAt)))
                 throw new SocialError({
                     code: "invalid_input",
                     operation: "notifications.seen",
@@ -1264,12 +1246,10 @@ export function createSocial(config) {
     };
 }
 function decodePageOptions(scope, options) {
-    const input = {};
-    if (options?.cursor !== undefined)
-        input.cursor = decodeCursor(scope, options.cursor);
-    if (options?.limit !== undefined)
-        input.limit = options.limit;
-    return input;
+    return definedFields({
+        cursor: options?.cursor === undefined ? undefined : decodeCursor(scope, options.cursor),
+        limit: options?.limit,
+    });
 }
 function encodePage(scope, page) {
     const result = { ...page };

package/dist/core/fields.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fields of `T` with `undefined` removed, each one optional. `T[K] & ({} | null)`
+ * is the form TypeScript narrows a generic `T[K]` to after an `!== undefined`
+ * check. For concrete types it matches `Exclude<T[K], undefined>`, except that an
+ * `unknown` field becomes `{} | null`.
+ */
+export type DefinedFields<T> = {
+    [K in keyof T]?: T[K] & ({} | null);
+};
+/**
+ * Copy only the fields whose value is defined, so optional properties stay
+ * absent under `exactOptionalPropertyTypes` instead of being set to `undefined`.
+ */
+export declare function definedFields<T extends object>(fields: T): DefinedFields<T>;

package/dist/core/fields.js

@@ -0,0 +1,14 @@
+/**
+ * Copy only the fields whose value is defined, so optional properties stay
+ * absent under `exactOptionalPropertyTypes` instead of being set to `undefined`.
+ */
+export function definedFields(fields) {
+    const result = {};
+    for (const key in fields) {
+        const value = fields[key];
+        if (value === undefined)
+            continue;
+        result[key] = value;
+    }
+    return result;
+}