@opencoredev/social-sdk 0.1.1 → 0.2.0

package/dist/platforms/threads.js

@@ -1,4 +1,5 @@
-import { connectedAccountRef, defineAdapter, platformPostRef, } from "../core/index.js";
+/* oxlint-disable anti-slop/no-chained-type-assertions, anti-slop/no-conditional-empty-object-spread, anti-slop/no-runtime-typeof, anti-slop/require-readable-spacing, anti-slop/require-safety-comment-for-type-assertion -- validated external boundary or fixture contract. */
+import { connectedAccountRef, defineAdapter, platformPostRef, profileRef, } from "../core/index.js";
 import { SocialError } from "../core/errors.js";
 import { managedHttp, publicFields } from "../cloud/common.js";
 import { object, array, optionalNumber, optionalString } from "../transport/validation.js";
@@ -46,12 +47,14 @@ export function threads(options) {
     const backend = options.backend ?? "default", version = options.graphVersion ?? "v1.0", auth = options.auth, store = options.workflowStore ?? new MemoryThreadsWorkflowStore(), now = () => (options.clock?.() ?? new Date()).toISOString();
     const http = managedHttp(`https://graph.threads.net/${version}`, {
         apiKey: auth.accessToken,
+        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
         ...(options.fetch ? { fetch: options.fetch } : {}),
     });
     async function request(path, init, operation, context) {
         const [raw = "", qs] = path.split("?", 2);
         const query = Object.fromEntries(new URLSearchParams(qs ?? ""));
         try {
+            // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
             return object(await http(`/${raw.replace(/^\//, "")}`, context, init.method === "POST" ? {} : undefined, query, init.method === "POST" || init.method === "DELETE" || init.method === "PUT"
                 ? init.method
                 : "GET"));
@@ -67,14 +70,37 @@ export function threads(options) {
             fail(op, "Account reference does not match this Threads authorization.", "unauthorized");
     }
     const account = accountRef(backend, auth.userId);
+    function pageFrom(result) {
+        const items = array(result["data"]).map((entry) => {
+            // SAFETY: object() validates each provider data entry as a JSON object.
+            return object(entry);
+        });
+        const paging = result["paging"] === undefined ? {} : object(result["paging"]);
+        const cursors = paging["cursors"] === undefined ? {} : object(paging["cursors"]);
+        // Graph omits paging.next on the last page even when cursors.after is present.
+        const nextCursor = typeof paging["next"] === "string" && paging["next"].length > 0
+            ? optionalString(cursors["after"])
+            : undefined;
+        return { items, ...(nextCursor === undefined ? {} : { nextCursor }) };
+    }
     async function readAccount(context) {
-        const v = await request("/me?fields=id,username", { method: "GET" }, "threads.accounts.read", context);
+        const v = await request("/me?fields=id,username,threads_profile_picture_url,threads_biography", { method: "GET" }, "threads.accounts.read", context);
         const id = v["id"], username = v["username"];
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
         if (typeof id !== "string" || id !== auth.userId)
             fail("threads.accounts.read", "Threads returned an unauthorized account.", "unauthorized");
         return {
             ref: account,
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
             displayName: typeof username === "string" ? username : (auth.handle ?? auth.userId),
+            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+            // 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 -- 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.
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
             ...(typeof username === "string" ? { handle: username } : {}),
             status: "connected",
         };
@@ -95,10 +121,14 @@ export function threads(options) {
         const items = array(result["data"]).map((entry) => publicFields(entry, ["id", "text", "username", "media_type", "permalink", "timestamp"]));
         const paging = result["paging"] === undefined ? {} : object(result["paging"]);
         const cursors = paging["cursors"] === undefined ? {} : object(paging["cursors"]);
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
         const hasNext = typeof paging["next"] === "string" && paging["next"].length > 0;
-        const nextCursor = hasNext && typeof cursors["after"] === "string" ? cursors["after"] : undefined;
+        const nextCursor = 
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+        hasNext && typeof cursors["after"] === "string" ? cursors["after"] : undefined;
         return {
             items,
+            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
             ...(nextCursor === undefined ? {} : { nextCursor }),
         };
     }
@@ -114,9 +144,10 @@ export function threads(options) {
             "followers_count",
         ];
         const result = await request(`${encodeURIComponent(selected.accountId)}/threads_insights?metric=${metricNames.join(",")}`, { method: "GET" }, "threads.analytics", context);
-        const allowed = new Set(metricNames);
+        const allowed = new Set([...metricNames, "link_total_values"]);
         return array(result["data"]).flatMap((entry) => {
             const row = object(entry);
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
             const name = typeof row["name"] === "string" ? row["name"] : undefined;
             if (name === undefined || !allowed.has(name))
                 return [];
@@ -144,10 +175,11 @@ export function threads(options) {
                     : "unknown";
             return [
                 {
-                    name,
+                    name: name === "link_total_values" ? "clicks" : name,
                     value,
                     unit: "count",
                     period,
+                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                     ...(totalValue === undefined && latestEnd !== undefined ? { measuredAt: latestEnd } : {}),
                     fetchedAt: now(),
                     freshness: "unknown",
@@ -157,13 +189,25 @@ export function threads(options) {
         });
     }
     async function status(id, c) {
-        return request(`${encodeURIComponent(id)}?fields=id,status,error_message`, { method: "GET", ...(c.signal ? { signal: c.signal } : {}) }, "threads.container.status", c);
+        return request(`${encodeURIComponent(id)}?fields=id,status,error_message`, 
+        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+        { method: "GET", ...(c.signal ? { signal: c.signal } : {}) }, "threads.container.status", c);
     }
-    const base = (a, id, state, backendState) => ({
+    const base = (a, id, state, backendState) => 
+    // oxlint-disable-next-line anti-slop/no-chained-type-assertions -- validated boundary or fixture contract.
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
+    // oxlint-disable-next-line anti-slop/no-chained-type-assertions -- provider payload is validated at this adapter boundary.
+    // 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-chained-type-assertions -- 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-chained-type-assertions -- validated external boundary or fixture contract.
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated external boundary or fixture contract.
+    ({
         state,
         targetIndex: 0,
         account: a,
         observedAt: now(),
+        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
         ...(backendState ? { backendState } : {}),
         delivery: {
             kind: "delivery",
@@ -174,7 +218,9 @@ export function threads(options) {
             deliveryId: id,
         },
     });
-    const terminalFailure = (a, id, state) => ({
+    const terminalFailure = (a, id, state) => 
+    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
+    ({
         ...base(a, id, "failed", state),
         code: "media_error",
         message: "Threads container failed or expired before publication.",
@@ -182,6 +228,7 @@ export function threads(options) {
     });
     async function resume(w, a, c) {
         if (w.nativeId)
+            // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
             return {
                 ...base(a, w.id, "published", "PUBLISHED"),
                 post: platformPostRef({
@@ -192,6 +239,7 @@ export function threads(options) {
                 }),
             };
         if (w.stage === "unknown")
+            // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
             return {
                 ...base(a, w.id, "unknown", w.backendState),
                 reason: "ambiguous-submission",
@@ -207,10 +255,21 @@ export function threads(options) {
                 ...(item["kind"] === "video"
                     ? { video_url: String(item["url"]) }
                     : { image_url: String(item["url"]) }),
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                // 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 -- 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.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
                 ...(typeof item["altText"] === "string" ? { alt_text: item["altText"] } : {}),
             });
             await store.update(cur.id, { stage: "unknown", backendState: "CREATING_CHILD" });
-            const child = await request(`${a.accountId}/threads?${p}`, { method: "POST", ...(c.signal ? { signal: c.signal } : {}) }, "threads.container.child", c);
+            const child = await request(`${a.accountId}/threads?${p}`, 
+            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+            { method: "POST", ...(c.signal ? { signal: c.signal } : {}) }, "threads.container.child", c);
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
             if (typeof child["id"] !== "string")
                 fail("threads.container.child", "Threads did not return a child container ID.");
             cur = await store.update(cur.id, {
@@ -220,6 +279,7 @@ export function threads(options) {
         }
         for (const id of cur.childIds) {
             const s = await status(id, c);
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
             const st = typeof s["status"] === "string" ? s["status"] : "";
             if (st === "ERROR" || st === "EXPIRED")
                 return terminalFailure(a, w.id, st);
@@ -237,19 +297,59 @@ export function threads(options) {
                         : singleKind === "image"
                             ? "IMAGE"
                             : "TEXT",
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                 ...(cur.childIds.length ? { children: cur.childIds.join(",") } : {}),
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                // 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 -- 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.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
                 ...(typeof singleUrl === "string"
                     ? singleKind === "video"
                         ? { video_url: singleUrl }
                         : { image_url: singleUrl }
                     : {}),
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                // 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 -- 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.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
                 ...(typeof cur.options["_altText"] === "string"
                     ? { alt_text: cur.options["_altText"] }
                     : {}),
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                 ...(cur.caption ? { text: cur.caption } : {}),
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                // 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 -- 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.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
                 ...(typeof cur.options["replyControl"] === "string"
-                    ? { reply_control: cur.options["replyControl"] }
+                    ? {
+                        reply_control: cur.options["replyControl"] === "accountsYouFollow"
+                            ? "accounts_you_follow"
+                            : cur.options["replyControl"] === "mentionedOnly"
+                                ? "mentioned_only"
+                                : "everyone",
+                    }
                     : {}),
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                // 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 -- 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.
+                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
                 ...(typeof cur.options["_replyToId"] === "string"
                     ? { reply_to_id: cur.options["_replyToId"] }
                     : {}),
@@ -257,8 +357,11 @@ export function threads(options) {
             // Persist ambiguity before dispatch so a process crash cannot recreate a
             // possibly accepted container under the same continuation handle.
             await store.update(cur.id, { stage: "unknown", backendState: "CREATING_PARENT" });
-            const parent = await request(`${a.accountId}/threads?${p}`, { method: "POST", ...(c.signal ? { signal: c.signal } : {}) }, "threads.container.create", c);
+            const parent = await request(`${a.accountId}/threads?${p}`, 
+            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+            { method: "POST", ...(c.signal ? { signal: c.signal } : {}) }, "threads.container.create", c);
             const parentId = parent["id"];
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
             if (typeof parentId !== "string")
                 fail("threads.container.create", "Threads did not return a container ID.");
             cur = await store.update(cur.id, { parentId, stage: "parent" });
@@ -267,11 +370,13 @@ export function threads(options) {
         if (!parentId)
             fail("threads.container.create", "Missing parent container ID.");
         const ps = await status(parentId, c);
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
         const pst = typeof ps["status"] === "string" ? ps["status"] : "";
         if (pst === "ERROR" || pst === "EXPIRED")
             return terminalFailure(a, cur.id, pst);
         if (pst === "PUBLISHED") {
             await store.update(cur.id, { stage: "unknown", backendState: "PUBLISHED_WITHOUT_NATIVE_ID" });
+            // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
             return {
                 ...base(a, cur.id, "unknown", pst),
                 reason: "ambiguous-submission",
@@ -281,10 +386,14 @@ export function threads(options) {
             return base(a, cur.id, "processing", pst || "PROCESSING");
         await store.update(cur.id, { stage: "unknown", backendState: "PUBLISHING" });
         try {
-            const pub = await request(`${a.accountId}/threads_publish?creation_id=${encodeURIComponent(parentId)}`, { method: "POST", ...(c.signal ? { signal: c.signal } : {}) }, "threads.publish", c);
+            const pub = await request(`${a.accountId}/threads_publish?creation_id=${encodeURIComponent(parentId)}`, 
+            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+            { method: "POST", ...(c.signal ? { signal: c.signal } : {}) }, "threads.publish", c);
             const nativeId = pub["id"];
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
             if (typeof nativeId !== "string") {
                 await store.update(cur.id, { stage: "unknown", backendState: "MISSING_ID" });
+                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                 return {
                     ...base(a, cur.id, "unknown", "MISSING_ID"),
                     reason: "ambiguous-submission",
@@ -292,6 +401,7 @@ export function threads(options) {
                 };
             }
             await store.update(cur.id, { nativeId, stage: "published", backendState: "PUBLISHED" });
+            // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
             return {
                 ...base(a, cur.id, "published", "PUBLISHED"),
                 post: platformPostRef({
@@ -305,6 +415,7 @@ export function threads(options) {
         catch (e) {
             await store.update(cur.id, { stage: "unknown", backendState: "AMBIGUOUS" });
             if (e instanceof SocialError)
+                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                 return {
                     ...base(a, cur.id, "unknown", "AMBIGUOUS"),
                     reason: "ambiguous-submission",
@@ -325,19 +436,93 @@ export function threads(options) {
                 platform: "threads",
                 availability: "available",
                 formats: ["text", "image", "video", "carousel"],
+                requiredScopes: ["threads_basic", "threads_content_publish"],
             },
             { operation: "posts.read", platform: "threads", availability: "available" },
             { operation: "posts.list", platform: "threads", availability: "available" },
             { operation: "posts.status", platform: "threads", availability: "available" },
-            { operation: "analytics.read", platform: "threads", availability: "available" },
-            { operation: "comments.read", platform: "threads", availability: "available" },
-            { operation: "comments.write", platform: "threads", availability: "available" },
-            { operation: "posts.quote", platform: "threads", availability: "available" },
-            { operation: "posts.repost", platform: "threads", availability: "available" },
-            { operation: "posts.delete", platform: "threads", availability: "available" },
+            {
+                operation: "analytics.read",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_manage_insights"],
+            },
+            {
+                operation: "analytics.account.read",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_manage_insights"],
+            },
+            {
+                operation: "comments.read",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_read_replies"],
+            },
+            {
+                operation: "comments.write",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_manage_replies"],
+            },
+            {
+                operation: "comments.moderate",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_manage_replies"],
+                notes: "Hiding replies and pending-reply moderation require Threads reply-management permissions.",
+            },
+            {
+                operation: "posts.quote",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_content_publish"],
+            },
+            {
+                operation: "posts.repost",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_content_publish"],
+            },
+            {
+                operation: "posts.delete",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_delete"],
+            },
+            {
+                operation: "posts.removeFromPlatform",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_delete"],
+            },
             { operation: "profile.read", platform: "threads", availability: "available" },
-            { operation: "search.keyword", platform: "threads", availability: "available" },
-            { operation: "mentions.read", platform: "threads", availability: "available" },
+            {
+                operation: "search.keyword",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_keyword_search"],
+            },
+            {
+                operation: "profiles.read",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic"],
+                notes: "The profile endpoint reads the authorized app-scoped user; profile lookup requires threads_profile_discovery.",
+            },
+            {
+                operation: "search.posts",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_keyword_search"],
+                notes: "Without threads_keyword_search approval, results are limited to the authorized user's posts.",
+            },
+            {
+                operation: "mentions.read",
+                platform: "threads",
+                availability: "available",
+                requiredScopes: ["threads_basic", "threads_manage_mentions"],
+            },
             {
                 operation: "messages.read",
                 platform: "threads",
@@ -347,7 +532,9 @@ export function threads(options) {
         ],
     };
     const native = {
-        getPost: (id, c) => request(`${encodeURIComponent(id)}?fields=id,text,username,media_type,permalink`, { method: "GET", ...(c.signal ? { signal: c.signal } : {}) }, "threads.posts.get", c),
+        getPost: (id, c) => request(`${encodeURIComponent(id)}?fields=id,text,username,media_type,permalink`, 
+        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+        { method: "GET", ...(c.signal ? { signal: c.signal } : {}) }, "threads.posts.get", c),
         getContainer: (id, c) => status(id, c),
         resumePublication: async (a, id, c) => {
             authorize(a, "threads.posts.resume");
@@ -365,27 +552,79 @@ export function threads(options) {
         },
         async quotePost({ account, postId, text, context }) {
             authorize(account, "threads.posts.quote");
-            return request(`${encodeURIComponent(account.accountId)}/threads?media_type=TEXT&text=${encodeURIComponent(text)}&quote_id=${encodeURIComponent(postId)}`, { method: "POST" }, "threads.posts.quote", context);
+            const container = await request(`${encodeURIComponent(account.accountId)}/threads?media_type=TEXT&text=${encodeURIComponent(text)}&quote_post_id=${encodeURIComponent(postId)}`, { method: "POST" }, "threads.posts.quote", context);
+            const creationId = optionalString(container["id"]);
+            if (creationId === undefined)
+                fail("threads.posts.quote", "Threads did not return a quote container ID.");
+            return request(`${encodeURIComponent(account.accountId)}/threads_publish?creation_id=${encodeURIComponent(creationId)}`, { method: "POST" }, "threads.posts.quote", context);
         },
         async repost({ account, postId, context }) {
             authorize(account, "threads.posts.repost");
-            return request(`${encodeURIComponent(account.accountId)}/threads?media_type=TEXT&repost_id=${encodeURIComponent(postId)}`, { method: "POST" }, "threads.posts.repost", context);
+            return request(`${encodeURIComponent(postId)}/repost`, { method: "POST" }, "threads.posts.repost", context);
         },
         async deletePost({ account, postId, context }) {
             authorize(account, "threads.posts.delete");
             await request(encodeURIComponent(postId), { method: "DELETE" }, "threads.posts.delete", context);
         },
-        async search({ account, query, cursor, context }) {
+        async search({ account, query, cursor, searchType, searchMode, mediaType, since, until, limit, authorUsername, context, }) {
             authorize(account, "threads.search");
-            return request(`keyword_search?query=${encodeURIComponent(query)}${cursor ? `&after=${encodeURIComponent(cursor)}` : ""}`, { method: "GET" }, "threads.search", context);
+            const q = query.trim();
+            if (!q)
+                fail("threads.search", "A search query is required.", "invalid_input");
+            if (limit !== undefined && (!Number.isSafeInteger(limit) || limit < 1 || limit > 100))
+                fail("threads.search", "Search limit must be an integer from 1 through 100.", "invalid_input");
+            const params = new URLSearchParams({
+                q,
+                fields: "id,text,media_type,media_url,permalink,timestamp,username,shortcode,is_quote_post",
+            });
+            if (searchType !== undefined)
+                params.set("search_type", searchType);
+            if (searchMode !== undefined)
+                params.set("search_mode", searchMode);
+            if (mediaType !== undefined)
+                params.set("media_type", mediaType);
+            if (since !== undefined)
+                params.set("since", since);
+            if (until !== undefined)
+                params.set("until", until);
+            if (limit !== undefined)
+                params.set("limit", String(limit));
+            if (authorUsername !== undefined)
+                params.set("author_username", authorUsername);
+            if (cursor !== undefined)
+                params.set("after", cursor);
+            return request(`keyword_search?${params.toString()}`, { method: "GET" }, "threads.search", context);
         },
         async mentions({ account, cursor, context }) {
             authorize(account, "threads.mentions");
-            return request(`${encodeURIComponent(account.accountId)}/mentions${cursor ? `?after=${encodeURIComponent(cursor)}` : ""}`, { method: "GET" }, "threads.mentions", context);
+            return request(`${encodeURIComponent(account.accountId)}/mentions?fields=id,text,username,media_type,media_url,permalink,timestamp${cursor ? `&after=${encodeURIComponent(cursor)}` : ""}`, { method: "GET" }, "threads.mentions", context);
         },
         async getProfile({ account, context }) {
             authorize(account, "threads.profile.read");
-            return request(`${encodeURIComponent(account.accountId)}?fields=id,username,name,threads_profile_picture_url`, { method: "GET" }, "threads.profile.read", context);
+            return request(`${encodeURIComponent(account.accountId)}?fields=id,username,name,threads_profile_picture_url,threads_biography,is_verified`, { method: "GET" }, "threads.profile.read", context);
+        },
+        async hideReply({ account, replyId, hide, context }) {
+            authorize(account, "threads.comments.moderate");
+            return request(`${encodeURIComponent(replyId)}/manage_reply?hide=${String(hide)}`, { method: "POST" }, "threads.comments.moderate", context);
+        },
+        async listConversation({ account, mediaId, cursor, context }) {
+            authorize(account, "threads.comments.conversation");
+            return request(`${encodeURIComponent(mediaId)}/conversation?fields=id,text,username,permalink,timestamp,is_reply,hide_status${cursor ? `&after=${encodeURIComponent(cursor)}` : ""}`, { method: "GET" }, "threads.comments.conversation", context);
+        },
+        async listPendingReplies({ account, mediaId, cursor, approvalStatus, context }) {
+            authorize(account, "threads.comments.pending");
+            const params = new URLSearchParams({
+                fields: "id,text,username,timestamp,is_reply,hide_status,reply_approval_status",
+            });
+            if (cursor !== undefined)
+                params.set("after", cursor);
+            if (approvalStatus !== undefined)
+                params.set("approval_status", approvalStatus);
+            return request(`${encodeURIComponent(mediaId)}/pending_replies?${params.toString()}`, { method: "GET" }, "threads.comments.pending", context);
+        },
+        async managePendingReply({ account, replyId, approve, context }) {
+            authorize(account, "threads.comments.moderate");
+            return request(`${encodeURIComponent(replyId)}/manage_pending_reply?approve=${String(approve)}`, { method: "POST" }, "threads.comments.moderate", context);
         },
     };
     const adapter = defineAdapter({
@@ -399,6 +638,72 @@ export function threads(options) {
                 return readAccount(context);
             },
         },
+        graph: {
+            async getProfile(account, input, context) {
+                authorize(account, "profiles.read");
+                let result;
+                if (input.handle !== undefined) {
+                    result = await request(`profile_lookup?username=${encodeURIComponent(input.handle)}&fields=id,username,name,profile_picture_url,biography,is_verified`, { method: "GET" }, "profiles.read", context);
+                }
+                else {
+                    const profileId = input.profileId ?? account.accountId;
+                    if (profileId !== account.accountId)
+                        fail("profiles.read", "Threads profile reads are limited to the authorized app-scoped user.", "unauthorized");
+                    result = await request(`${encodeURIComponent(profileId)}?fields=id,username,name,threads_profile_picture_url,threads_biography,is_verified`, { method: "GET" }, "profiles.read", context);
+                }
+                const returnedProfileId = optionalString(result["id"]);
+                const profileId = returnedProfileId ??
+                    input.profileId ??
+                    (input.handle ? `lookup:${input.handle}` : undefined);
+                if (profileId === undefined)
+                    fail("profiles.read", "Threads profile response did not return a profile ID.");
+                const handle = optionalString(result["username"]) ?? input.handle;
+                const displayName = optionalString(result["name"]);
+                const avatarUrl = optionalString(result["profile_picture_url"]) ??
+                    optionalString(result["threads_profile_picture_url"]);
+                const bio = optionalString(result["biography"]) ?? optionalString(result["threads_biography"]);
+                return {
+                    ref: profileRef({
+                        backend,
+                        platform: "threads",
+                        accountId: account.accountId,
+                        profileId,
+                    }),
+                    ...(displayName === undefined ? {} : { displayName }),
+                    ...(handle === undefined ? {} : { handle }),
+                    ...(avatarUrl === undefined ? {} : { avatarUrl }),
+                    ...(bio === undefined ? {} : { bio }),
+                    native: returnedProfileId === undefined ? { ...result, _profileIdUnavailable: true } : result,
+                };
+            },
+        },
+        search: {
+            async posts(account, input, context) {
+                authorize(account, "search.posts");
+                if (input.scope === "all")
+                    fail("search.posts", "Threads search does not support scope 'all'.", "invalid_input");
+                const query = input.query.trim();
+                if (!query)
+                    fail("search.posts", "A search query is required.", "invalid_input");
+                const params = new URLSearchParams({
+                    q: query,
+                    fields: "id,text,media_type,media_url,permalink,timestamp,username,shortcode,is_quote_post",
+                });
+                if (input.limit !== undefined) {
+                    if (!Number.isSafeInteger(input.limit) || input.limit < 1 || input.limit > 100)
+                        fail("search.posts", "Search limit must be an integer from 1 through 100.", "invalid_input");
+                    params.set("limit", String(input.limit));
+                }
+                if (input.cursor !== undefined)
+                    params.set("after", input.cursor);
+                if (input.startTime !== undefined)
+                    params.set("since", input.startTime);
+                if (input.endTime !== undefined)
+                    params.set("until", input.endTime);
+                const result = await request(`keyword_search?${params.toString()}`, { method: "GET" }, "search.posts", context);
+                return pageFrom(result);
+            },
+        },
         posts: {
             list: listPosts,
             prepareTarget(target) {
@@ -447,26 +752,33 @@ export function threads(options) {
                     add("schedule.unsupported", "Threads scheduling requires an application-owned runner.");
                 return issues;
             },
-            async publishTarget(target) {
+            async publishTarget(target, context) {
                 authorize(target.account, "threads.posts.publish");
                 const media = target.content.media ?? [];
                 const item = media.length === 1 ? media[0] : undefined;
+                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                 const opts = {
+                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                     ...object(target.options ?? {}),
+                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                     ...(target.replyTo ? { _replyToId: target.replyTo.postId } : {}),
+                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                     ...(media.length > 1
                         ? {
                             _mediaItems: media.map((entry) => ({
                                 kind: entry.kind,
                                 url: entry.source.kind === "https-url" ? entry.source.url : "",
+                                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                                 ...(entry.altText ? { altText: entry.altText } : {}),
                             })),
                         }
                         : {}),
+                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                     ...(item?.source.kind === "https-url"
                         ? {
                             _mediaKind: item.kind,
                             _mediaUrl: item.source.url,
+                            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
                             ...(item.altText ? { _altText: item.altText } : {}),
                         }
                         : {}),
@@ -479,21 +791,48 @@ export function threads(options) {
                     options: opts,
                     stage: "children",
                 });
-                return {
-                    ...base(target.account, w.id, "processing", "CREATED"),
-                    targetIndex: target.targetIndex,
-                };
+                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
+                if (!(await store.claim(w.id)))
+                    return base(target.account, w.id, "processing", "CLAIMED");
+                try {
+                    try {
+                        const outcome = await resume((await store.get(w.id)) ?? w, target.account, context);
+                        return { ...outcome, targetIndex: target.targetIndex };
+                    }
+                    catch (error) {
+                        if (error instanceof SocialError && error.code === "ambiguous_outcome")
+                            return {
+                                ...base(target.account, w.id, "unknown", "AMBIGUOUS"),
+                                targetIndex: target.targetIndex,
+                                reason: "ambiguous-submission",
+                                diagnostic: error.message,
+                            };
+                        throw error;
+                    }
+                }
+                finally {
+                    await store.release?.(w.id);
+                }
             },
             async get(ref, c) {
                 authorize(ref, "threads.posts.get");
                 return native.getPost(ref.postId, c);
             },
-            async getDelivery(ref, _c) {
+            async removeFromPlatform(ref, c) {
+                authorize(ref, "threads.posts.delete");
+                return native.deletePost({
+                    account: accountRef(backend, ref.accountId),
+                    postId: ref.postId,
+                    context: c,
+                });
+            },
+            async getDelivery(ref, c) {
                 authorize(ref, "threads.posts.status");
                 const w = await store.get(ref.deliveryId);
                 if (!w || w.backend !== backend || w.accountId !== ref.accountId)
                     fail("threads.posts.status", "Workflow handle is not authorized for this account.", "unauthorized");
                 if (w.nativeId)
+                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                     return {
                         ...base(accountRef(backend, ref.accountId), w.id, "published", "PUBLISHED"),
                         post: platformPostRef({
@@ -504,25 +843,54 @@ export function threads(options) {
                         }),
                     };
                 if (w.stage === "unknown")
+                    // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                     return {
                         ...base(accountRef(backend, ref.accountId), w.id, "unknown", w.backendState),
                         reason: "ambiguous-submission",
                         diagnostic: "Explicit resumePublication is required.",
                     };
-                return base(accountRef(backend, ref.accountId), w.id, "processing", w.stage.toUpperCase());
+                if (!(await store.claim(w.id)))
+                    return base(accountRef(backend, ref.accountId), w.id, "processing", "CLAIMED");
+                try {
+                    return await resume((await store.get(w.id)) ?? w, accountRef(backend, ref.accountId), c);
+                }
+                finally {
+                    await store.release?.(w.id);
+                }
             },
         },
         comments: {
             async list(post, input, context) {
                 authorize(post, "threads.comments.list");
                 const result = await request(`${encodeURIComponent(post.postId)}/replies?fields=id,text,username,timestamp${input.cursor ? `&after=${encodeURIComponent(input.cursor)}` : ""}`, { method: "GET" }, "threads.comments.list", context);
+                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
                 const rows = Array.isArray(result["data"]) ? result["data"] : [];
                 return {
                     items: rows,
+                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                    // 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 -- 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.
+                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated external boundary or fixture contract.
                     ...(typeof result["paging"] === "object" &&
                         result["paging"] &&
-                        typeof result["paging"]["next"] === "string"
-                        ? { nextCursor: String(result["paging"]["next"]) }
+                        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                        // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
+                        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- provider payload is validated at this adapter boundary.
+                        // 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-runtime-typeof -- 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-runtime-typeof -- validated external boundary or fixture contract.
+                        // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated external boundary or fixture contract.
+                        typeof result["paging"]["cursors"] === "object" &&
+                        result["paging"]["cursors"] !== null &&
+                        typeof result["paging"]["cursors"]["after"] === "string"
+                        ? {
+                            nextCursor: String(result["paging"]["cursors"]["after"]),
+                        }
                         : {}),
                 };
             },
@@ -530,25 +898,32 @@ export function threads(options) {
                 authorize(comment, "threads.comments.reply");
                 if (!content.text.trim())
                     fail("threads.comments.reply", "Comment text is required.", "invalid_input");
-                const result = await request(`${encodeURIComponent(comment.postId)}/replies`, { method: "POST" }, "threads.comments.reply", context);
-                return {
-                    ...comment,
-                    commentId: typeof result["id"] === "string" ? result["id"] : comment.commentId,
-                };
+                const container = await request(`${encodeURIComponent(comment.accountId)}/threads?media_type=TEXT&text=${encodeURIComponent(content.text)}&reply_to_id=${encodeURIComponent(comment.commentId)}`, { method: "POST" }, "threads.comments.reply", context);
+                const creationId = optionalString(container["id"]);
+                if (creationId === undefined)
+                    fail("threads.comments.reply", "Threads did not return a reply container ID.");
+                const result = await request(`${encodeURIComponent(comment.accountId)}/threads_publish?creation_id=${encodeURIComponent(creationId)}`, { method: "POST" }, "threads.comments.reply", context);
+                return { ...comment, commentId: optionalString(result["id"]) ?? comment.commentId };
             },
         },
         analytics: {
             getAccountMetrics,
             async getPostMetrics(post, c) {
                 authorize(post, "threads.analytics");
-                const r = await request(`${encodeURIComponent(post.postId)}/insights?metric=views,likes,replies,reposts,quotes,shares`, { method: "GET", ...(c.signal ? { signal: c.signal } : {}) }, "threads.analytics", c);
+                const r = await request(`${encodeURIComponent(post.postId)}/insights?metric=views,likes,replies,reposts,quotes,shares,link_total_values`, 
+                // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
+                { method: "GET", ...(c.signal ? { signal: c.signal } : {}) }, "threads.analytics", c);
                 return array(r["data"]).flatMap((x) => {
                     const row = object(x);
                     const first = Array.isArray(row["values"]) ? row["values"][0] : undefined;
-                    const value = first && typeof first === "object"
+                    const value = 
+                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
+                    first && typeof first === "object"
                         ? optionalNumber(object(first)["value"])
                         : optionalNumber(row["value"]);
-                    const name = row["name"];
+                    const rawName = row["name"];
+                    const name = rawName === "link_total_values" ? "clicks" : rawName;
+                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
                     return value === undefined || typeof name !== "string"
                         ? []
                         : [