@opencoredev/social-sdk 0.2.1 → 0.4.0

package/dist/platforms/instagram.d.ts

@@ -9,6 +9,8 @@ export interface InstagramOptions {
     readonly fetch?: typeof globalThis.fetch;
     readonly clock?: () => Date;
     readonly workflowStore?: InstagramWorkflowStore;
+    /** App secret that Meta uses to sign webhook deliveries (`X-Hub-Signature-256`). */
+    readonly webhookSecret?: string;
 }
 export interface InstagramNative {
     readonly moderateComment: (input: {

package/dist/platforms/instagram.js

@@ -1,11 +1,13 @@
-/* oxlint-disable anti-slop/no-conditional-empty-object-spread, anti-slop/no-known-value-widening, anti-slop/no-runtime-typeof, anti-slop/no-unsafe-dictionary-type, anti-slop/require-readable-spacing -- provider query and response boundaries are validated locally. */
 import { defineAdapter } from "../core/adapter.js";
 import { SocialError } from "../core/errors.js";
 import { profileRef } from "../core/types.js";
-import { managedHttp, publicFields } from "../cloud/common.js";
+import { managedHttp, optionsObject, publicFields } from "../cloud/common.js";
 import { HttpError } from "../transport/http.js";
-import { array, object, optionalNumber, optionalString, string } from "../transport/validation.js";
+import { definedFields } from "../core/fields.js";
+import { array, isBoolean, isJsonObject, isString, object, optionalNumber, optionalString, string, } from "../transport/validation.js";
 import { httpsUrl } from "../transport/upload.js";
+import { verifyMetaWebhook } from "../server/webhooks.js";
+import { directWebhooks, webhookCapability } from "./webhook-adapter.js";
 class MemoryInstagramWorkflowStore {
     workflows = new Map();
     claims = new Set();
@@ -43,12 +45,10 @@ export function instagram(options) {
         : `https://graph.instagram.com/${apiVersion}`;
     const request = managedHttp(origin, {
         apiKey: options.auth.accessToken,
-        // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
-        ...(options.fetch ? { fetch: options.fetch } : {}),
+        ...definedFields({ fetch: options.fetch }),
     });
     const now = () => (options.clock?.() ?? new Date()).toISOString();
     const workflows = options.workflowStore ?? new MemoryInstagramWorkflowStore();
-    // oxlint-disable-next-line anti-slop/no-unknown-parameters -- provider payload is validated here.
     const validatedObject = (value, operation) => {
         try {
             return object(value);
@@ -73,6 +73,47 @@ export function instagram(options) {
                 retryDisposition: { kind: "never" },
             });
     };
+    // Meta's Instagram Login mentions guide lists only GET /{ig-user-id}/tags and
+    // POST /{ig-user-id}/mentions. The mentioned_media and mentioned_comment field
+    // expansions are documented for Facebook Login only. Sources, accessed 2026-09-24
+    // against Graph API v25.0:
+    // https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions
+    // https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/mentions
+    // https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/tags
+    // https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/mentioned_media
+    const requireFacebookLoginForMentionLookup = (field) => {
+        if (flavor !== "facebook-login")
+            throw new SocialError({
+                code: "unsupported_capability",
+                operation: "instagram.mentions.read",
+                message: `Instagram ${field} lookups require a Facebook Login Graph API access token. Instagram Login supports only the /{ig-user-id}/tags mentions edge.`,
+                retryDisposition: { kind: "never" },
+            });
+    };
+    // Meta documents `DELETE /{ig-media-id}` for Instagram API with Facebook Login only.
+    // Source: https://developers.facebook.com/docs/instagram-platform/reference/instagram-media
+    // (accessed 2026-09-24, Graph API v25.0).
+    const deleteMedia = async (mediaId, context, operation) => {
+        if (flavor !== "facebook-login")
+            throw new SocialError({
+                code: "unsupported_capability",
+                operation,
+                message: `${operation} is not supported with Instagram Login. Meta supports media deletion only through Instagram API with Facebook Login.`,
+                retryDisposition: { kind: "never" },
+            });
+        const result = await request(`/${encodeURIComponent(mediaId)}`, context, undefined, {}, "DELETE");
+        // SAFETY: request validates the Graph response as a JSON field before returning it.
+        const confirmed = isJsonObject(result)
+            ? result["success"]
+            : undefined;
+        if (confirmed !== true)
+            throw new SocialError({
+                code: "ambiguous_outcome",
+                operation,
+                message: "Instagram did not confirm the media deletion. Reconcile before retrying.",
+                retryDisposition: { kind: "reconcile-first" },
+            });
+    };
     const pageLimit = (limit, max = 50) => {
         const value = limit ?? 25;
         if (!Number.isSafeInteger(value) || value < 1 || value > max)
@@ -88,12 +129,10 @@ export function instagram(options) {
         const paging = result["paging"] === undefined ? {} : object(result["paging"]);
         const cursors = paging["cursors"] === undefined ? {} : object(paging["cursors"]);
         // Graph API omits `paging.next` on the last page even when `cursors.after` is present.
-        const nextCursor = typeof paging["next"] === "string" &&
-            typeof cursors["after"] === "string" &&
-            cursors["after"].length > 0
+        const nextCursor = isString(paging["next"]) && isString(cursors["after"]) && cursors["after"].length > 0
             ? cursors["after"]
             : undefined;
-        return { items, ...(nextCursor === undefined ? {} : { nextCursor }) };
+        return { items, ...definedFields({ nextCursor }) };
     };
     const authorize = (ref, context) => {
         if (ref.backend !== context.backendInstance ||
@@ -117,14 +156,13 @@ export function instagram(options) {
                 operation: "posts.list",
                 message: "Instagram feed limit must be an integer from 1 through 100.",
             });
-        // oxlint-disable-next-line anti-slop/no-known-value-widening -- validated boundary or fixture contract.
         const query = {
             fields: "id,caption,media_type,media_product_type,permalink,timestamp,username",
+            ...definedFields({
+                after: input.cursor,
+                limit: input.limit === undefined ? undefined : String(input.limit),
+            }),
         };
-        if (input.cursor !== undefined)
-            query["after"] = input.cursor;
-        if (input.limit !== undefined)
-            query["limit"] = String(input.limit);
         const result = object(await request(`/${encodeURIComponent(selected.accountId)}/media`, context, undefined, query));
         const items = array(result["data"]).map((entry) => publicFields(entry, [
             "id",
@@ -137,15 +175,11 @@ export function instagram(options) {
         ]));
         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 = 
-        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- validated boundary or fixture contract.
-        hasNext && typeof cursors["after"] === "string" ? cursors["after"] : undefined;
+        const hasNext = isString(paging["next"]) && paging["next"].length > 0;
+        const nextCursor = hasNext ? optionalString(cursors["after"]) : undefined;
         return {
             items,
-            // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
-            ...(nextCursor === undefined ? {} : { nextCursor }),
+            ...definedFields({ nextCursor }),
         };
     };
     const getAccountMetrics = async (selected, context) => {
@@ -241,7 +275,6 @@ export function instagram(options) {
             await workflows.update(workflowId, { stage: "unknown" });
         let result;
         try {
-            // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated boundary or fixture contract.
             result = object(await request(`/${encodeURIComponent(account.accountId)}/media_publish`, context, {
                 creation_id: containerId,
             }));
@@ -360,13 +393,12 @@ export function instagram(options) {
     };
     const listMentions = async ({ account, cursor, limit, context, }) => {
         authorize(account, context);
-        requireFacebookLogin("instagram.mentions.read");
+        // Both login flavors expose GET /{ig-user-id}/tags; only the host and scopes differ.
         const query = {
             fields: "id,caption,media_type,media_product_type,permalink,timestamp,username",
             limit: String(pageLimit(limit)),
+            ...definedFields({ after: cursor }),
         };
-        if (cursor !== undefined)
-            query["after"] = cursor;
         const result = validatedObject(await request(`/${encodeURIComponent(account.accountId)}/tags`, context, undefined, query), "instagram.mentions.read");
         return page(result, [
             "id",
@@ -407,6 +439,18 @@ export function instagram(options) {
                         : ["instagram_business_basic", "instagram_business_content_publish"],
                     notes: "Professional accounts, public HTTPS media, explicit native continuation for processing containers. Carousels must have matching aspect ratios to avoid upstream cropping.",
                 },
+                {
+                    platform: "instagram",
+                    operation: "posts.schedule",
+                    availability: "unsupported-by-platform",
+                    notes: "The content publishing API has no publish-time parameter; media_publish publishes immediately and unpublished containers expire after 24 hours.",
+                },
+                {
+                    platform: "instagram",
+                    operation: "posts.update",
+                    availability: "unsupported-by-platform",
+                    notes: "Instagram Graph API does not provide an edit endpoint for published media.",
+                },
                 ...[
                     "accounts.read",
                     "posts.list",
@@ -463,21 +507,24 @@ export function instagram(options) {
                 { platform: "instagram", operation: "stories.publish", availability: "available" },
                 {
                     platform: "instagram",
-                    operation: "posts.delete",
-                    availability: flavor === "facebook-login"
-                        ? "available"
-                        : "not-implemented-by-adapter",
-                    ...(flavor === "facebook-login"
-                        ? { requiredScopes: ["instagram_basic", "pages_read_engagement"] }
-                        : {}),
-                },
-                {
-                    platform: "instagram",
-                    operation: "posts.removeFromPlatform",
-                    availability: flavor === "facebook-login"
-                        ? "available"
-                        : "not-implemented-by-adapter",
+                    operation: "profile.update",
+                    availability: "unsupported-by-platform",
+                    notes: "The IG User node supports reads only. Updating it is not supported.",
                 },
+                ...["posts.delete", "posts.removeFromPlatform"].map((operation) => flavor === "facebook-login"
+                    ? {
+                        platform: "instagram",
+                        operation,
+                        availability: "available",
+                        requiredScopes: ["instagram_basic", "instagram_manage_contents"],
+                        notes: "Deletes non-ad posts, Stories, Reels, and whole carousel albums through DELETE /{ig-media-id}. Individual carousel children cannot be deleted.",
+                    }
+                    : {
+                        platform: "instagram",
+                        operation,
+                        availability: "unsupported-by-platform",
+                        notes: "Meta documents media deletion for Instagram API with Facebook Login only. See https://developers.facebook.com/docs/instagram-platform/reference/instagram-media",
+                    }),
                 ...(flavor === "facebook-login"
                     ? [
                         {
@@ -494,27 +541,17 @@ export function instagram(options) {
                     operation: "publishing.limit.read",
                     availability: "available",
                 },
-                ...(flavor === "facebook-login"
-                    ? [
-                        {
-                            platform: "instagram",
-                            operation: "mentions.read",
-                            availability: "available",
-                            requiredScopes: [
-                                "instagram_basic",
-                                "instagram_manage_comments",
-                                "pages_read_engagement",
-                            ],
-                            notes: "Reads the paginated /{ig-user-id}/tags edge.",
-                        },
-                    ]
-                    : [
-                        {
-                            platform: "instagram",
-                            operation: "mentions.read",
-                            availability: "not-implemented-by-adapter",
-                        },
-                    ]),
+                {
+                    platform: "instagram",
+                    operation: "mentions.read",
+                    availability: "available",
+                    requiredScopes: flavor === "facebook-login"
+                        ? ["instagram_basic", "instagram_manage_comments", "pages_read_engagement"]
+                        : ["instagram_business_basic", "instagram_business_manage_comments"],
+                    notes: flavor === "facebook-login"
+                        ? "Reads the paginated /{ig-user-id}/tags edge. Native mentionedMedia and mentionedComment look up single @mentions. Story mentions and private media are not returned."
+                        : "Reads the paginated /{ig-user-id}/tags edge on graph.instagram.com. mentionedMedia and mentionedComment require Facebook Login. Story mentions and private media are not returned.",
+                },
                 {
                     platform: "instagram",
                     operation: "product.tagging",
@@ -525,8 +562,16 @@ export function instagram(options) {
                     operation: "messages.read",
                     availability: "approval-dependent",
                 },
+                webhookCapability("instagram", "Verifies Meta X-Hub-Signature-256 with the app secret and decodes object=instagram deliveries. Answer the GET handshake with answerMetaWebhookChallenge."),
+                {
+                    platform: "instagram",
+                    operation: "notifications.read",
+                    availability: "unsupported-by-platform",
+                    notes: "The Instagram API has no notifications edge. Use mentions.read, tags, comments, or webhooks instead.",
+                },
             ],
         },
+        webhooks: directWebhooks("instagram", (input) => verifyMetaWebhook({ ...input, secret: options.webhookSecret ?? "" }), now),
         accounts: {
             async list(_input, context) {
                 return { items: [await readAccount(context)] };
@@ -558,6 +603,8 @@ export function instagram(options) {
                         catch {
                             fail("instagram.url", "Use public HTTPS media without local hosts or credentials.");
                         }
+                    if (item.kind === "document")
+                        fail("instagram.document", "Instagram publishing accepts image and video media only.");
                     if (item.kind === "image" && item.mimeType !== "image/jpeg")
                         fail("instagram.jpeg", "Instagram image publishing requires JPEG media.");
                     if (item.kind === "video" &&
@@ -596,29 +643,21 @@ export function instagram(options) {
                                 operation: "posts.publish",
                                 message: "Public HTTPS media required.",
                             });
-                        const config = target.options === undefined ? {} : object(target.options);
+                        const config = optionsObject(target);
+                        const shareToFeed = config["shareToFeed"];
                         await workflows.update(workflow.id, { stage: "unknown" });
                         const created = object(await request(`/${encodeURIComponent(target.account.accountId)}/media`, context, {
                             ...(item.kind === "image"
                                 ? {
                                     image_url: item.source.url,
-                                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
-                                    ...(item.altText === undefined ? {} : { alt_text: item.altText }),
+                                    ...definedFields({ alt_text: item.altText }),
                                 }
                                 : {
                                     video_url: item.source.url,
                                     media_type: media.length > 1 ? "VIDEO" : "REELS",
-                                    // 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 config["shareToFeed"] === "boolean"
-                                        ? { share_to_feed: config["shareToFeed"] }
-                                        : {}),
+                                    ...definedFields({
+                                        share_to_feed: isBoolean(shareToFeed) ? shareToFeed : undefined,
+                                    }),
                                 }),
                             ...(media.length > 1
                                 ? { is_carousel_item: true }
@@ -739,8 +778,7 @@ export function instagram(options) {
             },
             async removeFromPlatform(ref, context) {
                 authorize(ref, context);
-                requireFacebookLogin("instagram.posts.removeFromPlatform");
-                await request(`/${encodeURIComponent(ref.postId)}`, context, undefined, {}, "DELETE");
+                await deleteMedia(ref.postId, context, "instagram.posts.removeFromPlatform");
             },
         },
         comments: {
@@ -749,9 +787,8 @@ export function instagram(options) {
                 const query = {
                     fields: "id,text,timestamp,username",
                     limit: String(pageLimit(input.limit)),
+                    ...definedFields({ after: input.cursor }),
                 };
-                if (input.cursor !== undefined)
-                    query["after"] = input.cursor;
                 const result = validatedObject(await request(`/${encodeURIComponent(ref.postId)}/comments`, context, undefined, query), "instagram.comments.read");
                 return page(result, ["id", "text", "timestamp", "username"]);
             },
@@ -855,12 +892,12 @@ export function instagram(options) {
                         accountId: account.accountId,
                         profileId: id,
                     }),
-                    ...(typeof profile["name"] === "string" ? { displayName: profile["name"] } : {}),
-                    ...(typeof profile["username"] === "string" ? { handle: profile["username"] } : {}),
-                    ...(typeof profile["profile_picture_url"] === "string"
-                        ? { avatarUrl: profile["profile_picture_url"] }
-                        : {}),
-                    ...(typeof profile["biography"] === "string" ? { bio: profile["biography"] } : {}),
+                    ...definedFields({
+                        displayName: optionalString(profile["name"]),
+                        handle: optionalString(profile["username"]),
+                        avatarUrl: optionalString(profile["profile_picture_url"]),
+                        bio: optionalString(profile["biography"]),
+                    }),
                     native: profile,
                 };
             },
@@ -883,37 +920,32 @@ export function instagram(options) {
                 const query = {
                     fields: "id,text,timestamp,username",
                     limit: String(pageLimit(limit)),
+                    ...definedFields({ after: cursor }),
                 };
-                if (cursor !== undefined)
-                    query["after"] = cursor;
                 return page(validatedObject(await request(`/${encodeURIComponent(commentId)}/replies`, context, undefined, query), "instagram.comments.replies.read"), ["id", "text", "timestamp", "username"]);
             },
             listMentions,
             async mentionedMedia({ account, mediaId, context }) {
                 authorize(account, context);
-                requireFacebookLogin("instagram.mentions.read");
-                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated provider object boundary.
+                requireFacebookLoginForMentionLookup("mentioned_media");
                 return validatedObject(await request(`/${encodeURIComponent(account.accountId)}`, context, undefined, {
                     fields: `mentioned_media.media_id(${encodeURIComponent(mediaId)}){id,caption,media_type,media_url,timestamp,username,comments_count,like_count}`,
                 }), "instagram.mentions.read");
             },
             async mentionedComment({ account, commentId, context }) {
                 authorize(account, context);
-                requireFacebookLogin("instagram.mentions.read");
-                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated provider object boundary.
+                requireFacebookLoginForMentionLookup("mentioned_comment");
                 return validatedObject(await request(`/${encodeURIComponent(account.accountId)}`, context, undefined, {
                     fields: `mentioned_comment.comment_id(${encodeURIComponent(commentId)}){id,text,timestamp,like_count,media}`,
                 }), "instagram.mentions.read");
             },
             async listTaggedMedia({ account, cursor, limit, context }) {
                 authorize(account, context);
-                requireFacebookLogin("instagram.mentions.read");
                 const query = {
                     fields: "id,caption,media_type,permalink,timestamp,username",
                     limit: String(pageLimit(limit)),
+                    ...definedFields({ after: cursor }),
                 };
-                if (cursor !== undefined)
-                    query["after"] = cursor;
                 return page(validatedObject(await request(`/${encodeURIComponent(account.accountId)}/tags`, context, undefined, query), "instagram.mentions.read"), ["id", "caption", "media_type", "permalink", "timestamp", "username"]);
             },
             async hashtagMedia({ account, hashtagId, kind, cursor, limit, context }) {
@@ -922,9 +954,8 @@ export function instagram(options) {
                 const query = {
                     fields: "id,caption,media_type,permalink,timestamp,username",
                     limit: String(pageLimit(limit, 50)),
+                    ...definedFields({ after: cursor }),
                 };
-                if (cursor !== undefined)
-                    query["after"] = cursor;
                 return page(validatedObject(await request(`/${encodeURIComponent(hashtagId)}/${kind}_media`, context, undefined, query), "instagram.hashtags.search"), ["id", "caption", "media_type", "permalink", "timestamp", "username"]);
             },
             async businessDiscovery({ account, username, fields, context }) {
@@ -938,7 +969,6 @@ export function instagram(options) {
                     });
                 const selectedFields = fields ??
                     `business_discovery.username(${username}){id,username,name,biography,followers_count,media_count,profile_picture_url,media.limit(25){id,caption,media_type,permalink,timestamp}}`;
-                // oxlint-disable-next-line anti-slop/require-safety-comment-for-type-assertion -- validated provider object boundary.
                 return object(await request(`/${encodeURIComponent(account.accountId)}`, context, undefined, {
                     fields: selectedFields,
                 }));
@@ -973,8 +1003,7 @@ export function instagram(options) {
                 const created = object(await request(`/${encodeURIComponent(account.accountId)}/media`, context, {
                     media_type: "REELS",
                     video_url: videoUrl,
-                    // oxlint-disable-next-line anti-slop/no-conditional-empty-object-spread -- validated boundary or fixture contract.
-                    ...(caption ? { caption } : {}),
+                    ...definedFields({ caption: caption === "" ? undefined : caption }),
                 }));
                 return publishContainer(account, string(created["id"]), context);
             },
@@ -988,8 +1017,7 @@ export function instagram(options) {
             },
             async deletePost({ account, postId, context }) {
                 authorize(account, context);
-                requireFacebookLogin("instagram.posts.delete");
-                await request(`/${encodeURIComponent(postId)}`, context, undefined, {}, "DELETE");
+                await deleteMedia(postId, context, "instagram.posts.delete");
             },
             async hashtagSearch({ account, hashtag, context }) {
                 authorize(account, context);
@@ -1014,15 +1042,12 @@ export function instagram(options) {
             },
             async publishingLimit({ account, context }) {
                 authorize(account, context);
-                // SAFETY: object() establishes an object response; this native method intentionally
-                // preserves Meta's provider-specific config object after validating its outer shape.
                 return object(await request(`/${encodeURIComponent(account.accountId)}/content_publishing_limit`, context, undefined, { fields: "config,quota_usage" }));
             },
             async mentions({ account, cursor, limit, context }) {
                 return listMentions({
                     account,
-                    ...(cursor === undefined ? {} : { cursor }),
-                    ...(limit === undefined ? {} : { limit }),
+                    ...definedFields({ cursor, limit }),
                     context,
                 });
             },

package/dist/platforms/linkedin.d.ts

@@ -1,4 +1,4 @@
-import type { AdapterOperationContext, ConnectedAccountRef, JsonObject, MediaRef } from "../core/types.js";
+import type { AdapterOperationContext, ConnectedAccountRef, JsonObject, MediaRef, Page } from "../core/types.js";
 export interface LinkedInOptions {
     readonly auth: {
         readonly accessToken: string;
@@ -8,6 +8,8 @@ export interface LinkedInOptions {
     readonly apiVersion: string;
     readonly fetch?: typeof globalThis.fetch;
     readonly clock?: () => Date;
+    /** App client secret that LinkedIn uses to sign webhook deliveries (`X-LI-Signature`). */
+    readonly webhookSecret?: string;
 }
 export interface LinkedInTimeInterval {
     readonly granularity: "DAY" | "WEEK" | "MONTH";
@@ -44,8 +46,45 @@ export interface LinkedInShareStatistics {
     readonly interval?: LinkedInTimeInterval | undefined;
     readonly metrics: Readonly<Record<string, number>>;
 }
+/** One approved organization role returned by LinkedIn's `organizationAcls` roleAssignee finder. */
+export interface LinkedInOrganizationRole {
+    readonly organization: `urn:li:organization:${string}`;
+    readonly role: "ADMINISTRATOR";
+    readonly state: "APPROVED";
+}
 export interface LinkedInNative {
+    /**
+     * Lists organizations the authenticated member administers (approved `ADMINISTRATOR` roles).
+     * Requires `rw_organization_admin` or `r_organization_admin`. Use the result to configure
+     * another adapter instance; this instance still acts only as its configured author.
+     */
+    readonly listAdministeredOrganizations: (input: {
+        readonly account: ConnectedAccountRef;
+        readonly cursor?: string;
+        readonly limit?: number;
+        readonly context: AdapterOperationContext;
+    }) => Promise<Page<LinkedInOrganizationRole>>;
     readonly imageStatus: (ref: MediaRef, context: AdapterOperationContext) => Promise<JsonObject>;
+    /**
+     * Reads one uploaded video's owner and processing status with a single GET. Call it again later
+     * while the status is PROCESSING or WAITING_UPLOAD, or use `waitForVideo`. Other methods never
+     * poll on their own.
+     */
+    readonly videoStatus: (ref: MediaRef, context: AdapterOperationContext) => Promise<JsonObject>;
+    /**
+     * Opt-in bounded wait for one uploaded video. Reads the status like `videoStatus`, and while it is
+     * PROCESSING or WAITING_UPLOAD waits `intervalMs` and reads again, up to `maxChecks` reads. It
+     * stops early when the next wait would exceed the context's elapsed budget, and throws
+     * `cancelled` when the context signal aborts. Returns the last status it read, which may still be
+     * PROCESSING; it never throws for slow processing and never creates a post.
+     */
+    readonly waitForVideo: (ref: MediaRef, context: AdapterOperationContext, options?: LinkedInVideoWaitOptions) => Promise<JsonObject>;
+    /** Reads `id`, `owner` and `status` (`WAITING_UPLOAD`, `PROCESSING`, `AVAILABLE`, `PROCESSING_FAILED`). */
+    readonly documentStatus: (ref: MediaRef, context: AdapterOperationContext) => Promise<JsonObject>;
+    /**
+     * @deprecated Upload video bytes with `social.media.upload` and check processing with
+     * `videoStatus`. This method always throws `unsupported_capability`.
+     */
     readonly registerVideo: (input: {
         readonly account: ConnectedAccountRef;
         readonly byteSize: number;
@@ -80,6 +119,18 @@ export interface LinkedInNative {
         readonly postId: string;
         readonly context: AdapterOperationContext;
     }) => Promise<void>;
+    /**
+     * Deletes a comment with the Comments API. `postId` is the share or ugcPost URN, and
+     * `commentId` is the complete `commentUrn` from comment reads. Organization authors are sent
+     * as the `actor`. LinkedIn does not document which comments an actor may delete, so expect
+     * only the configured author's own comments to succeed.
+     */
+    readonly deleteComment: (input: {
+        readonly account: ConnectedAccountRef;
+        readonly postId: string;
+        readonly commentId: string;
+        readonly context: AdapterOperationContext;
+    }) => Promise<void>;
     readonly organizationAnalytics: (input: {
         readonly account: ConnectedAccountRef;
         readonly query?: JsonObject;
@@ -105,4 +156,10 @@ export interface LinkedInNative {
         readonly context: AdapterOperationContext;
     }) => Promise<number | undefined>;
 }
+export interface LinkedInVideoWaitOptions {
+    /** Delay between status reads. Integer from 1,000 to 60,000 ms; defaults to 5,000. */
+    readonly intervalMs?: number;
+    /** Maximum status reads, including the first. Integer from 1 to 60; defaults to 12. */
+    readonly maxChecks?: number;
+}
 export declare function linkedin(options: LinkedInOptions): import("../core/adapter.js").SocialAdapter<LinkedInNative>;