@opencoredev/social-sdk 0.3.0 → 0.4.0

package/dist/cloud/lifecycle.js

@@ -1,5 +1,6 @@
 import { SocialError } from "../core/errors.js";
-import { array, object, string } from "../transport/validation.js";
+import { definedFields } from "../core/fields.js";
+import { array, isString, object, string } from "../transport/validation.js";
 import { accountMatches } from "./common.js";
 const reject = (message) => {
     throw new SocialError({ code: "invalid_input", operation: "posts.lifecycle", message });
@@ -28,8 +29,7 @@ export function managedLifecycle(provider, request, now) {
             reject("This operation requires a backend record with exactly one destination.");
         const entry = entries[0];
         const rawId = provider === "zernio" ? entry["accountId"] : entry["id"];
-        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-        const accountId = typeof rawId === "string" ? rawId : object(rawId)["_id"];
+        const accountId = isString(rawId) ? rawId : object(rawId)["_id"];
         const platform = entry["platform"] === "twitter" ? "x" : entry["platform"];
         if (accountId !== ref.accountId || platform !== ref.platform)
             throw new SocialError({
@@ -46,13 +46,26 @@ export function managedLifecycle(provider, request, now) {
             : response["message"] !== "Post deleted successfully")
             unconfirmed();
     }
+    async function removeFromPlatform(ref, context) {
+        if (!["x", "threads", "bluesky", "youtube", "linkedin", "facebook"].includes(ref.platform))
+            reject("Zernio does not support native removal for this platform.");
+        const id = string(ref.native?.["backendRecordId"]);
+        const record = await owned(ref, id, context);
+        const entry = object(array(record["platforms"])[0]);
+        if (entry["status"] !== "published" || entry["platformPostId"] !== ref.postId)
+            reject("The backend record does not identify this published native post.");
+        const result = object(await request(`${path(id)}/unpublish`, context, {
+            platform: ref.platform === "x" ? "twitter" : ref.platform,
+        }));
+        if (result["success"] !== true)
+            unconfirmed();
+    }
     return {
         async cancelScheduled(ref, context) {
             const record = await owned(ref, ref.jobId, context);
             const scheduledAt = record[provider === "zernio" ? "scheduledFor" : "scheduled_at"];
             if (record["status"] !== "scheduled" ||
-                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                typeof scheduledAt !== "string" ||
+                !isString(scheduledAt) ||
                 !Number.isFinite(Date.parse(scheduledAt)) ||
                 Date.parse(scheduledAt) <= Date.parse(now()))
                 reject("Only a future scheduled record can be cancelled. Reconcile a due or dispatched post.");
@@ -61,23 +74,22 @@ export function managedLifecycle(provider, request, now) {
                 return { state: "cancelled", backendRecord: "deleted" };
             }
             // A missing/null scheduled_at means publish immediately. Keep the timestamp.
-            // oxlint-disable-next-line anti-slop/no-known-value-widening -- provider payload is validated at this adapter boundary.
+            const copied = [
+                "media",
+                "platform_configurations",
+                "account_configurations",
+                "external_id",
+            ].flatMap((key) => {
+                const value = record[key];
+                return value === undefined || value === null ? [] : [[key, value]];
+            });
             const body = {
                 caption: string(record["caption"]),
                 social_accounts: [ref.accountId],
                 scheduled_at: string(scheduledAt),
                 isDraft: true,
+                ...Object.fromEntries(copied),
             };
-            for (const key of [
-                "media",
-                "platform_configurations",
-                "account_configurations",
-                "external_id",
-            ]) {
-                if (record[key] !== undefined && record[key] !== null)
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    body[key] = record[key];
-            }
             const result = object(await request(path(ref.jobId), context, body, {}, "PUT"));
             if (result["id"] !== ref.jobId || result["status"] !== "draft")
                 unconfirmed();
@@ -89,24 +101,8 @@ export function managedLifecycle(provider, request, now) {
                 reject("Delete only a draft backend record. Cancel a future schedule explicitly; never infer native deletion.");
             await deleteRecord(ref.recordId, context);
         },
-        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-        ...(provider === "zernio"
-            ? {
-                async removeFromPlatform(ref, context) {
-                    if (!["x", "threads", "bluesky", "youtube", "linkedin", "facebook"].includes(ref.platform))
-                        reject("Zernio does not support native removal for this platform.");
-                    const id = string(ref.native?.["backendRecordId"]);
-                    const record = await owned(ref, id, context);
-                    const entry = object(array(record["platforms"])[0]);
-                    if (entry["status"] !== "published" || entry["platformPostId"] !== ref.postId)
-                        reject("The backend record does not identify this published native post.");
-                    const result = object(await request(`${path(id)}/unpublish`, context, {
-                        platform: ref.platform === "x" ? "twitter" : ref.platform,
-                    }));
-                    if (result["success"] !== true)
-                        unconfirmed();
-                },
-            }
-            : {}),
+        ...definedFields({
+            removeFromPlatform: provider === "zernio" ? removeFromPlatform : undefined,
+        }),
     };
 }

package/dist/cloud/media.d.ts

@@ -1,4 +1,4 @@
-import type { AdapterOperationContext, ConnectedAccountRef, JsonObject, MediaAttachment, MediaRef } from "../core/types.js";
+import type { AdapterOperationContext, ConnectedAccountRef, JsonObject, JsonValue, MediaAttachment, MediaRef } from "../core/types.js";
 import { type ManagedOptions } from "./common.js";
 /** Keep this record server-side. A provider storage URL may grant access to the asset. */
 export interface ManagedMediaRecord {
@@ -17,7 +17,7 @@ export declare class MemoryManagedMediaStore implements ManagedMediaStore {
     put(record: ManagedMediaRecord): Promise<void>;
     get(mediaId: string): Promise<ManagedMediaRecord | undefined>;
 }
-export declare function managedMedia(provider: "zernio" | "post-for-me", options: ManagedOptions, presign: (body: JsonObject, context: AdapterOperationContext) => Promise<unknown>): {
+export declare function managedMedia(provider: "zernio" | "post-for-me", options: ManagedOptions, presign: (body: JsonObject, context: AdapterOperationContext) => Promise<JsonValue>): {
     resolve: (item: MediaAttachment, account: ConnectedAccountRef, context: AdapterOperationContext) => Promise<string>;
     upload(item: MediaAttachment, account: ConnectedAccountRef, context: AdapterOperationContext): Promise<MediaRef>;
 };

package/dist/cloud/media.js

@@ -10,12 +10,16 @@ export class MemoryManagedMediaStore {
         return record ? structuredClone(record) : undefined;
     }
 }
-export function managedMedia(provider, options, 
-// oxlint-disable-next-line anti-slop/no-unknown-returns -- provider payload is validated at this adapter boundary.
-presign) {
+export function managedMedia(provider, options, presign) {
     const store = options.mediaStore ?? new MemoryManagedMediaStore();
     async function resolve(item, account, context) {
         accountMatches(account, context);
+        if (item.kind === "document")
+            throw new SocialError({
+                code: "unsupported_capability",
+                operation: "media.resolve",
+                message: "Managed backends accept image and video media only through this adapter.",
+            });
         if (item.source.kind !== "media-ref")
             return uploadManagedMedia(item, (body) => presign(body, context), {
                 options,
@@ -61,6 +65,12 @@ presign) {
         resolve,
         async upload(item, account, context) {
             accountMatches(account, context);
+            if (item.kind === "document")
+                throw new SocialError({
+                    code: "unsupported_capability",
+                    operation: "media.upload",
+                    message: "Managed backends accept image and video media only through this adapter.",
+                });
             if (item.source.kind === "media-ref") {
                 await resolve(item, account, context);
                 return item.source.ref;

package/dist/cloud/outcomes.d.ts

@@ -1,9 +1,10 @@
-import type { ConnectedAccountRef, DeliveryOutcome } from "../core/types.js";
+import type { ConnectedAccountRef, DeliveryOutcome, JsonValue } from "../core/types.js";
+import { type JsonField } from "../transport/validation.js";
 export interface OutcomeContext {
     account: ConnectedAccountRef;
     targetIndex: number;
     observedAt: string;
 }
 /** Never infer destination success from the aggregate HTTP/parent status. */
-export declare function zernioOutcome(value: unknown, context: OutcomeContext): DeliveryOutcome;
-export declare function postForMeOutcome(parentValue: unknown, resultsValue: unknown | undefined, context: OutcomeContext): DeliveryOutcome;
+export declare function zernioOutcome(value: JsonValue, context: OutcomeContext): DeliveryOutcome;
+export declare function postForMeOutcome(parentValue: JsonValue, resultsValue: JsonField, context: OutcomeContext): DeliveryOutcome;

package/dist/cloud/outcomes.js

@@ -1,4 +1,4 @@
-import { array, object, optionalString, string } from "../transport/validation.js";
+import { array, isJsonArray, isJsonObject, isString, object, optionalString, string, } from "../transport/validation.js";
 function delivery(context, deliveryId) {
     return {
         kind: "delivery",
@@ -10,7 +10,6 @@ function delivery(context, deliveryId) {
     };
 }
 /** Never infer destination success from the aggregate HTTP/parent status. */
-// oxlint-disable-next-line anti-slop/no-unknown-parameters -- provider payload is validated at this adapter boundary.
 export function zernioOutcome(value, context) {
     const response = object(value);
     const post = object(response["post"] ?? response["existingPost"] ?? response);
@@ -18,14 +17,12 @@ export function zernioOutcome(value, context) {
     const platform = context.account.platform === "x" ? "twitter" : context.account.platform;
     const entries = array(post["platforms"]).map(object);
     const matches = entries.filter((entry) => {
-        const accountId = 
-        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-        typeof entry["accountId"] === "string"
-            ? entry["accountId"]
-            : // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                entry["accountId"] && typeof entry["accountId"] === "object"
-                    ? optionalString(object(entry["accountId"])["_id"])
-                    : undefined;
+        const rawAccountId = entry["accountId"];
+        const accountId = isString(rawAccountId)
+            ? rawAccountId
+            : isJsonObject(rawAccountId) || isJsonArray(rawAccountId)
+                ? optionalString(object(rawAccountId)["_id"])
+                : undefined;
         return entry["platform"] === platform && accountId === context.account.accountId;
     });
     const base = { ...context, delivery: delivery(context, postId) };
@@ -104,11 +101,7 @@ export function zernioOutcome(value, context) {
             };
     }
 }
-export function postForMeOutcome(
-// oxlint-disable-next-line anti-slop/no-unknown-parameters -- provider payload is validated at this adapter boundary.
-parentValue, 
-// oxlint-disable-next-line anti-slop/no-unknown-parameters -- provider payload is validated at this adapter boundary.
-resultsValue, context) {
+export function postForMeOutcome(parentValue, resultsValue, context) {
     const parent = object(parentValue);
     const postId = string(parent["id"]);
     const backendState = optionalString(parent["status"]) ?? "unknown";

package/dist/cloud/post-for-me.js

@@ -1,10 +1,10 @@
-/* oxlint-disable anti-slop/require-safety-comment-for-type-assertion -- 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, object, optionalNumber, optionalString, string, } from "../transport/validation.js";
 import { verifyPostForMeWebhook, decodeWebhook } from "../server/webhooks.js";
 import { accountMatches, capabilityManifest, managedHttp, managedPreparation, managedOptionIssues, optionsObject, platform, publicFields, } from "./common.js";
 import { postForMeOutcome } from "./outcomes.js";
@@ -12,7 +12,6 @@ export function postForMe(options) {
     const request = managedHttp("https://api.postforme.dev", options);
     const mediaPipeline = managedMedia("post-for-me", options, (body, context) => request("/v1/media/create-upload-url", 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 postForMe(options) {
                 accountId: string(row["id"]),
             },
             displayName: handle ?? string(row["user_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["status"] === "connected"
                 ? "connected"
                 : row["status"] === "disconnected"
@@ -34,7 +32,6 @@ export function postForMe(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);
@@ -47,9 +44,11 @@ export function postForMe(options) {
     };
     const feed = async (ref, context, metrics) => {
         accountMatches(ref, context);
-        const result = object(await request(`/v1/social-account-feeds/${encodeURIComponent(ref.accountId)}`, context, undefined, 
-        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-        { platform_post_id: ref.postId, limit: "1", ...(metrics ? { expand: "metrics" } : {}) }));
+        const result = object(await request(`/v1/social-account-feeds/${encodeURIComponent(ref.accountId)}`, context, undefined, {
+            platform_post_id: ref.postId,
+            limit: "1",
+            ...definedFields({ expand: metrics ? "metrics" : undefined }),
+        }));
         const row = array(result["data"])
             .map(object)
             .find((item) => item["platform_post_id"] === ref.postId && item["social_account_id"] === ref.accountId);
@@ -102,8 +101,7 @@ export function postForMe(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.
-                    ...(next ? { nextCursor: next } : {}),
+                    ...definedFields({ nextCursor: next }),
                 };
             },
             async get(ref, context) {
@@ -131,8 +129,7 @@ export function postForMe(options) {
                     });
                 const result = object(await request(`/v1/social-account-feeds/${encodeURIComponent(account.accountId)}`, context, undefined, {
                     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 rows = array(result["data"])
                     .map(object)
@@ -159,14 +156,7 @@ export function postForMe(options) {
                         : optionalString(meta["next"]) && cursor
                             ? cursor
                             : undefined;
-                // 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/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 -- validated external boundary or fixture contract.
-                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- 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/require-safety-comment-for-type-assertion -- validated external boundary or fixture contract.
-                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated external boundary or fixture contract.
-                return { items: rows, ...(next === undefined ? {} : { nextCursor: next }) };
+                return { items: rows, ...definedFields({ nextCursor: next }) };
             },
             prepareTarget(target) {
                 const issues = [
@@ -200,9 +190,9 @@ export function postForMe(options) {
                     media.push({ url: await mediaPipeline.resolve(item, target.account, context) });
                 const config = optionsObject(target);
                 const platformConfig = {};
-                // 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")
-                    platformConfig["share_to_feed"] = config["shareToFeed"];
+                const shareToFeed = config["shareToFeed"];
+                if (target.account.platform === "instagram" && isBoolean(shareToFeed))
+                    platformConfig["share_to_feed"] = shareToFeed;
                 if (target.account.platform === "x" &&
                     config["replySettings"] !== undefined &&
                     config["replySettings"] !== "everyone")
@@ -210,9 +200,9 @@ export function postForMe(options) {
                 if (target.account.platform === "youtube") {
                     platformConfig["title"] = string(config["title"]);
                     platformConfig["privacy_status"] = 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")
-                        platformConfig["made_for_kids"] = config["madeForKids"];
+                    const madeForKids = config["madeForKids"];
+                    if (isBoolean(madeForKids))
+                        platformConfig["made_for_kids"] = madeForKids;
                 }
                 if (target.account.platform === "tiktok") {
                     platformConfig["privacy_status"] =
@@ -220,31 +210,34 @@ export function postForMe(options) {
                     platformConfig["auto_add_music"] = false;
                     platformConfig["allow_duet"] = !config["disableDuet"];
                     platformConfig["allow_stitch"] = !config["disableStitch"];
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    platformConfig["disclose_your_brand"] = config["ownBrand"];
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    platformConfig["is_ai_generated"] = config["aiGenerated"];
-                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- provider payload is validated at this adapter boundary.
-                    platformConfig["is_draft"] = config["draft"];
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    if (typeof config["disableComments"] === "boolean")
-                        platformConfig["allow_comment"] = !config["disableComments"];
-                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
-                    if (typeof config["brandedContent"] === "boolean")
-                        platformConfig["disclose_branded_content"] = 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 [
+                        ["disclose_your_brand", "ownBrand"],
+                        ["is_ai_generated", "aiGenerated"],
+                        ["is_draft", "draft"],
+                    ]) {
+                        const value = config[optionKey];
+                        if (value !== undefined)
+                            platformConfig[nativeKey] = value;
+                    }
+                    const { disableComments, brandedContent } = config;
+                    if (isBoolean(disableComments))
+                        platformConfig["allow_comment"] = !disableComments;
+                    if (isBoolean(brandedContent))
+                        platformConfig["disclose_branded_content"] = brandedContent;
                 }
                 const response = await request("/v1/social-posts", context, {
                     caption: target.content.text ?? "",
                     social_accounts: [target.account.accountId],
                     media,
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(target.schedule ? { scheduled_at: target.schedule.at } : {}),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(context.targetIdempotencyKey ? { external_id: context.targetIdempotencyKey } : {}),
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(Object.keys(platformConfig).length
-                        ? { platform_configurations: { [target.account.platform]: platformConfig } }
-                        : {}),
+                    ...definedFields({
+                        scheduled_at: target.schedule?.at,
+                        external_id: context.targetIdempotencyKey || undefined,
+                        platform_configurations: Object.keys(platformConfig).length
+                            ? { [target.account.platform]: platformConfig }
+                            : undefined,
+                    }),
                 });
                 const parent = object(response);
                 let results;
@@ -385,8 +378,7 @@ export function postForMe(options) {
                     platform: input.platform,
                     external_id: input.externalId,
                     permissions: input.permissions,
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- provider payload is validated at this adapter boundary.
-                    ...(input.redirectUrl ? { redirect_url_override: input.redirectUrl } : {}),
+                    ...definedFields({ redirect_url_override: input.redirectUrl || undefined }),
                 }));
                 return { url: string(result["url"]), platform: string(result["platform"]) };
             },