vidspotai-shared 1.0.82 → 1.0.83

package/lib/services/socialOAuth/youtube.oauth.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YouTubeOAuthProvider = void 0;
+const types_1 = require("../../globals/types");
+const logger_1 = require("../../utils/logger");
+/**
+ * YouTube (Google) OAuth 2.0 provider. Phase 1 of the Social Suite — the first
+ * end-to-end platform (cleanest API + native scheduling). See SOCIAL_SUITE_PLAN.md.
+ *
+ * Config (env):
+ *   GOOGLE_OAUTH_CLIENT_ID      — OAuth client id (Web application)
+ *   GOOGLE_OAUTH_CLIENT_SECRET  — OAuth client secret
+ *
+ * Notes:
+ * - `access_type=offline` + `prompt=consent` are required to reliably receive a
+ *   refresh token (Google only returns it on first consent unless prompted).
+ * - While the OAuth app is in "Testing", refresh tokens expire after 7 days —
+ *   publish the consent screen before production. (Plan §3.)
+ */
+const AUTH_ENDPOINT = "https://accounts.google.com/o/oauth2/v2/auth";
+const TOKEN_ENDPOINT = "https://oauth2.googleapis.com/token";
+const REVOKE_ENDPOINT = "https://oauth2.googleapis.com/revoke";
+const CHANNELS_ENDPOINT = "https://www.googleapis.com/youtube/v3/channels?part=snippet&mine=true";
+/** Scopes needed to upload + read analytics + manage comments. */
+const BASE_SCOPES = [
+    "https://www.googleapis.com/auth/youtube.upload",
+    "https://www.googleapis.com/auth/youtube.readonly",
+    "https://www.googleapis.com/auth/yt-analytics.readonly",
+];
+/** force-ssl is required for comment list/insert/moderate (premium engage). */
+const COMMENT_SCOPES = ["https://www.googleapis.com/auth/youtube.force-ssl"];
+class YouTubeOAuthProvider {
+    constructor() {
+        this.provider = types_1.ESocialProvider.YOUTUBE;
+    }
+    clientId() {
+        const id = process.env.GOOGLE_OAUTH_CLIENT_ID;
+        if (!id)
+            throw new Error("YouTubeOAuth: GOOGLE_OAUTH_CLIENT_ID not set");
+        return id;
+    }
+    clientSecret() {
+        const secret = process.env.GOOGLE_OAUTH_CLIENT_SECRET;
+        if (!secret)
+            throw new Error("YouTubeOAuth: GOOGLE_OAUTH_CLIENT_SECRET not set");
+        return secret;
+    }
+    getAuthUrl({ state, redirectUri, requestBusinessScopes, }) {
+        const scopes = requestBusinessScopes
+            ? [...BASE_SCOPES, ...COMMENT_SCOPES]
+            : BASE_SCOPES;
+        const params = new URLSearchParams({
+            client_id: this.clientId(),
+            redirect_uri: redirectUri,
+            response_type: "code",
+            scope: scopes.join(" "),
+            access_type: "offline",
+            include_granted_scopes: "true",
+            prompt: "consent",
+            state,
+        });
+        return `${AUTH_ENDPOINT}?${params.toString()}`;
+    }
+    async exchangeCode({ code, redirectUri, }) {
+        const body = new URLSearchParams({
+            code,
+            client_id: this.clientId(),
+            client_secret: this.clientSecret(),
+            redirect_uri: redirectUri,
+            grant_type: "authorization_code",
+        });
+        const token = await this.postToken(body);
+        if (!token.access_token) {
+            throw new Error("YouTubeOAuth: token exchange returned no access_token");
+        }
+        const tokens = this.toTokens(token);
+        const account = await this.resolveAccount(token.access_token);
+        return { account, tokens };
+    }
+    async refresh(refreshToken) {
+        const body = new URLSearchParams({
+            client_id: this.clientId(),
+            client_secret: this.clientSecret(),
+            refresh_token: refreshToken,
+            grant_type: "refresh_token",
+        });
+        const token = await this.postToken(body);
+        if (!token.access_token) {
+            throw new Error("YouTubeOAuth: refresh returned no access_token");
+        }
+        // Google does not re-issue a refresh token on refresh; preserve the old one.
+        const tokens = this.toTokens(token);
+        if (!tokens.refreshToken)
+            tokens.refreshToken = refreshToken;
+        return tokens;
+    }
+    async revoke(token) {
+        try {
+            await fetch(REVOKE_ENDPOINT, {
+                method: "POST",
+                headers: { "Content-Type": "application/x-www-form-urlencoded" },
+                body: new URLSearchParams({ token }).toString(),
+            });
+        }
+        catch (err) {
+            logger_1.logger.warn("YouTubeOAuth.revoke: failed (non-fatal)", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    async postToken(body) {
+        const resp = await fetch(TOKEN_ENDPOINT, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: body.toString(),
+        });
+        const json = (await resp.json());
+        if (!resp.ok || json.error) {
+            throw new Error(`YouTubeOAuth: token endpoint ${resp.status} ${json.error ?? ""} ${json.error_description ?? ""}`.trim());
+        }
+        return json;
+    }
+    toTokens(token) {
+        const expiresInMs = (token.expires_in ?? 3600) * 1000;
+        return {
+            accessToken: token.access_token,
+            refreshToken: token.refresh_token,
+            expiresAt: Date.now() + expiresInMs,
+            scopes: token.scope ? token.scope.split(" ").filter(Boolean) : [],
+        };
+    }
+    async resolveAccount(accessToken) {
+        const resp = await fetch(CHANNELS_ENDPOINT, {
+            headers: { Authorization: `Bearer ${accessToken}` },
+        });
+        if (!resp.ok) {
+            throw new Error(`YouTubeOAuth: channels lookup ${resp.status}`);
+        }
+        const json = (await resp.json());
+        const channel = json.items?.[0];
+        if (!channel?.id) {
+            throw new Error("YouTubeOAuth: no channel on this Google account");
+        }
+        const thumb = channel.snippet?.thumbnails?.high?.url ??
+            channel.snippet?.thumbnails?.default?.url;
+        return {
+            providerAccountId: channel.id,
+            displayName: channel.snippet?.title ?? "YouTube channel",
+            handle: channel.snippet?.customUrl,
+            avatarUrl: thumb,
+            // YouTube has no API "business" flag; channels are creator-grade by default.
+            kind: types_1.ESocialAccountKind.CREATOR,
+        };
+    }
+}
+exports.YouTubeOAuthProvider = YouTubeOAuthProvider;

package/lib/services/socialPublish/factory.d.ts

@@ -0,0 +1,5 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialPublisher } from "./types";
+export declare function getSocialPublisher(provider: ESocialProvider): ISocialPublisher;
+export declare function isSocialPublishSupported(provider: ESocialProvider): boolean;
+//# sourceMappingURL=factory.d.ts.map

package/lib/services/socialPublish/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/services/socialPublish/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAe3C,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,GACxB,gBAAgB,CAMlB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE3E"}

package/lib/services/socialPublish/factory.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSocialPublisher = getSocialPublisher;
+exports.isSocialPublishSupported = isSocialPublishSupported;
+const types_1 = require("../../globals/types");
+const linkedin_publish_1 = require("./linkedin.publish");
+const meta_publish_1 = require("./meta.publish");
+const pinterest_publish_1 = require("./pinterest.publish");
+const threads_publish_1 = require("./threads.publish");
+const tiktok_publish_1 = require("./tiktok.publish");
+const x_publish_1 = require("./x.publish");
+const youtube_publish_1 = require("./youtube.publish");
+const registry = {
+    [types_1.ESocialProvider.YOUTUBE]: () => new youtube_publish_1.YouTubePublisher(),
+    [types_1.ESocialProvider.INSTAGRAM]: () => new meta_publish_1.InstagramPublisher(),
+    [types_1.ESocialProvider.FACEBOOK]: () => new meta_publish_1.FacebookPublisher(),
+    [types_1.ESocialProvider.TIKTOK]: () => new tiktok_publish_1.TikTokPublisher(),
+    [types_1.ESocialProvider.THREADS]: () => new threads_publish_1.ThreadsPublisher(),
+    [types_1.ESocialProvider.LINKEDIN]: () => new linkedin_publish_1.LinkedInPublisher(),
+    [types_1.ESocialProvider.X]: () => new x_publish_1.XPublisher(),
+    [types_1.ESocialProvider.PINTEREST]: () => new pinterest_publish_1.PinterestPublisher(),
+};
+function getSocialPublisher(provider) {
+    const make = registry[provider];
+    if (!make) {
+        throw new Error(`Social publishing not implemented for '${provider}'`);
+    }
+    return make();
+}
+function isSocialPublishSupported(provider) {
+    return Boolean(registry[provider]);
+}

package/lib/services/socialPublish/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./types";
+export * from "./youtube.publish";
+export * from "./meta.publish";
+export * from "./tiktok.publish";
+export * from "./threads.publish";
+export * from "./linkedin.publish";
+export * from "./x.publish";
+export * from "./pinterest.publish";
+export * from "./factory";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/socialPublish/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/socialPublish/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}

package/lib/services/socialPublish/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./youtube.publish"), exports);
+__exportStar(require("./meta.publish"), exports);
+__exportStar(require("./tiktok.publish"), exports);
+__exportStar(require("./threads.publish"), exports);
+__exportStar(require("./linkedin.publish"), exports);
+__exportStar(require("./x.publish"), exports);
+__exportStar(require("./pinterest.publish"), exports);
+__exportStar(require("./factory"), exports);

package/lib/services/socialPublish/linkedin.publish.d.ts

@@ -0,0 +1,9 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialPublisher, PublishInput, PublishResult } from "./types";
+export declare class LinkedInPublisher implements ISocialPublisher {
+    readonly provider = ESocialProvider.LINKEDIN;
+    publish(input: PublishInput): Promise<PublishResult>;
+    private resolveVisibility;
+    private buildCommentary;
+}
+//# sourceMappingURL=linkedin.publish.d.ts.map

package/lib/services/socialPublish/linkedin.publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin.publish.d.ts","sourceRoot":"","sources":["../../../src/services/socialPublish/linkedin.publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA0CxE,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,QAAQ,CAAC,QAAQ,4BAA4B;IAEvC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAwG1D,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,eAAe;CAQxB"}

package/lib/services/socialPublish/linkedin.publish.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkedInPublisher = void 0;
+const types_1 = require("../../globals/types");
+const logger_1 = require("../../utils/logger");
+/**
+ * LinkedIn publisher — Phase 6. Member-feed video via the versioned Videos +
+ * Posts REST API:
+ *   1. POST /rest/videos?action=initializeUpload → video URN + upload URL(s)
+ *   2. PUT the bytes to each upload URL → collect ETags
+ *   3. POST /rest/videos?action=finalizeUpload (uploadedPartIds = ETags)
+ *   4. POST /rest/posts (author, commentary, content.media = video URN)
+ *
+ * Author = urn:li:person:{providerAccountId}. Company-page posting (author =
+ * urn:li:organization:{id}) is a business-tier follow-on. No native scheduling.
+ *
+ * Config (env): LINKEDIN_API_VERSION (optional, default "202401").
+ */
+const REST_BASE = "https://api.linkedin.com/rest";
+function apiVersion() {
+    return process.env.LINKEDIN_API_VERSION || "202401";
+}
+function headers(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+        "LinkedIn-Version": apiVersion(),
+        "X-Restli-Protocol-Version": "2.0.0",
+    };
+}
+class LinkedInPublisher {
+    constructor() {
+        this.provider = types_1.ESocialProvider.LINKEDIN;
+    }
+    async publish(input) {
+        const memberId = input.providerAccountId;
+        if (!memberId) {
+            throw new Error("LinkedInPublisher: missing providerAccountId (member id)");
+        }
+        const author = `urn:li:person:${memberId}`;
+        const token = input.accessToken;
+        // 0. Fetch the media bytes (worker passes a public/rendered URL).
+        const mediaResp = await fetch(input.mediaUrl);
+        if (!mediaResp.ok) {
+            throw new Error(`LinkedInPublisher: media fetch ${mediaResp.status}`);
+        }
+        const bytes = Buffer.from(await mediaResp.arrayBuffer());
+        // 1. Initialize the upload.
+        const initResp = await fetch(`${REST_BASE}/videos?action=initializeUpload`, {
+            method: "POST",
+            headers: headers(token),
+            body: JSON.stringify({
+                initializeUploadRequest: {
+                    owner: author,
+                    fileSizeBytes: bytes.length,
+                    uploadCaptions: false,
+                    uploadThumbnail: false,
+                },
+            }),
+        });
+        const init = (await initResp.json());
+        const videoUrn = init.value?.video;
+        const instructions = init.value?.uploadInstructions ?? [];
+        if (!initResp.ok || !videoUrn || instructions.length === 0) {
+            throw new Error(`LinkedInPublisher: initializeUpload ${initResp.status} ${init.error?.message ?? ""}`.trim());
+        }
+        // 2. Upload each byte range; collect ETags in order.
+        const uploadedPartIds = [];
+        for (const instr of instructions) {
+            if (!instr.uploadUrl)
+                continue;
+            const first = instr.firstByte ?? 0;
+            const last = instr.lastByte ?? bytes.length - 1;
+            const chunk = bytes.subarray(first, last + 1);
+            const putResp = await fetch(instr.uploadUrl, {
+                method: "PUT",
+                headers: { Authorization: `Bearer ${token}` },
+                body: chunk,
+            });
+            if (!putResp.ok) {
+                throw new Error(`LinkedInPublisher: chunk upload ${putResp.status}`);
+            }
+            const etag = putResp.headers.get("etag");
+            if (etag)
+                uploadedPartIds.push(etag.replace(/"/g, ""));
+        }
+        // 3. Finalize the upload.
+        const finalizeResp = await fetch(`${REST_BASE}/videos?action=finalizeUpload`, {
+            method: "POST",
+            headers: headers(token),
+            body: JSON.stringify({
+                finalizeUploadRequest: { video: videoUrn, uploadToken: "", uploadedPartIds },
+            }),
+        });
+        if (!finalizeResp.ok) {
+            const text = await finalizeResp.text();
+            throw new Error(`LinkedInPublisher: finalizeUpload ${finalizeResp.status} ${text}`);
+        }
+        // 4. Create the post referencing the video URN.
+        const postResp = await fetch(`${REST_BASE}/posts`, {
+            method: "POST",
+            headers: headers(token),
+            body: JSON.stringify({
+                author,
+                commentary: this.buildCommentary(input),
+                visibility: this.resolveVisibility(input),
+                distribution: {
+                    feedDistribution: "MAIN_FEED",
+                    targetEntities: [],
+                    thirdPartyDistributionChannels: [],
+                },
+                content: { media: { id: videoUrn, title: (input.title ?? "").slice(0, 200) } },
+                lifecycleState: "PUBLISHED",
+                isReshareDisabledByAuthor: false,
+            }),
+        });
+        if (!postResp.ok) {
+            const text = await postResp.text();
+            throw new Error(`LinkedInPublisher: create post ${postResp.status} ${text}`);
+        }
+        // The new post URN is returned in the x-restli-id (or x-linkedin-id) header.
+        const postUrn = postResp.headers.get("x-restli-id") ??
+            postResp.headers.get("x-linkedin-id") ??
+            videoUrn;
+        logger_1.logger.info("LinkedInPublisher: published", { postUrn });
+        return {
+            providerPostId: postUrn,
+            publishedUrl: `https://www.linkedin.com/feed/update/${postUrn}`,
+        };
+    }
+    resolveVisibility(input) {
+        const p = (input.privacy ?? "public").toUpperCase();
+        return p === "CONNECTIONS" ? "CONNECTIONS" : "PUBLIC";
+    }
+    buildCommentary(input) {
+        const tags = input.hashtags && input.hashtags.length
+            ? "\n\n" +
+                input.hashtags.map((h) => (h.startsWith("#") ? h : `#${h}`)).join(" ")
+            : "";
+        return `${input.caption ?? ""}${tags}`.trim().slice(0, 3000);
+    }
+}
+exports.LinkedInPublisher = LinkedInPublisher;

package/lib/services/socialPublish/meta.publish.d.ts

@@ -0,0 +1,28 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialPublisher, PublishInput, PublishResult } from "./types";
+/**
+ * Instagram publisher — Reels via the two-step container flow:
+ *   1. POST /{ig-user-id}/media (media_type=REELS, video_url, caption) → container
+ *   2. Poll /{container-id}?fields=status_code until FINISHED
+ *   3. POST /{ig-user-id}/media_publish (creation_id) → media id
+ * IG has no native API scheduling — the worker schedules via BullMQ delay, so we
+ * always publish immediately here.
+ */
+export declare class InstagramPublisher implements ISocialPublisher {
+    readonly provider = ESocialProvider.INSTAGRAM;
+    private readonly maxPolls;
+    private readonly pollDelayMs;
+    publish(input: PublishInput): Promise<PublishResult>;
+    private waitForContainer;
+    private resolvePermalink;
+}
+/**
+ * Facebook Page publisher — posts a video to the Page via /{page-id}/videos with
+ * a hosted `file_url` (Graph downloads it). Supports native scheduling through
+ * `published=false` + `scheduled_publish_time` (unix seconds, 10m–6mo out).
+ */
+export declare class FacebookPublisher implements ISocialPublisher {
+    readonly provider = ESocialProvider.FACEBOOK;
+    publish(input: PublishInput): Promise<PublishResult>;
+}
+//# sourceMappingURL=meta.publish.d.ts.map

package/lib/services/socialPublish/meta.publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.publish.d.ts","sourceRoot":"","sources":["../../../src/services/socialPublish/meta.publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA+DxE;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,QAAQ,6BAA6B;IAE9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE9B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;YAsC5C,gBAAgB;YAyBhB,gBAAgB;CAgB/B;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,QAAQ,CAAC,QAAQ,4BAA4B;IAEvC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAmC3D"}

package/lib/services/socialPublish/meta.publish.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FacebookPublisher = exports.InstagramPublisher = void 0;
+const types_1 = require("../../globals/types");
+const logger_1 = require("../../utils/logger");
+/**
+ * Meta publishers — Phase 3. Instagram and Facebook both run on the Graph API
+ * but with different publish flows, so they are separate ISocialPublisher impls
+ * (registered under INSTAGRAM / FACEBOOK).
+ *
+ * Both take the managing Page access token (provided by MetaOAuthProvider) and
+ * the account's providerAccountId (IG user id / FB Page id) via PublishInput.
+ *
+ * Config (env): META_GRAPH_VERSION (optional, default v21.0).
+ */
+const DEFAULT_GRAPH_VERSION = "v21.0";
+function graphVersion() {
+    return process.env.META_GRAPH_VERSION || DEFAULT_GRAPH_VERSION;
+}
+function graph(path) {
+    return `https://graph.facebook.com/${graphVersion()}${path}`;
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function buildCaption(input) {
+    const tags = input.hashtags && input.hashtags.length
+        ? "\n\n" +
+            input.hashtags.map((h) => (h.startsWith("#") ? h : `#${h}`)).join(" ")
+        : "";
+    return `${input.caption ?? ""}${tags}`.trim();
+}
+async function postForm(url, form) {
+    const resp = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: form.toString(),
+    });
+    const json = (await resp.json());
+    if (!resp.ok || json.error || !json.id) {
+        throw new Error(`Meta graph POST ${resp.status} ${json.error?.message ?? "no id returned"}`);
+    }
+    return json;
+}
+/**
+ * Instagram publisher — Reels via the two-step container flow:
+ *   1. POST /{ig-user-id}/media (media_type=REELS, video_url, caption) → container
+ *   2. Poll /{container-id}?fields=status_code until FINISHED
+ *   3. POST /{ig-user-id}/media_publish (creation_id) → media id
+ * IG has no native API scheduling — the worker schedules via BullMQ delay, so we
+ * always publish immediately here.
+ */
+class InstagramPublisher {
+    constructor() {
+        this.provider = types_1.ESocialProvider.INSTAGRAM;
+        this.maxPolls = 30;
+        this.pollDelayMs = 5000;
+    }
+    async publish(input) {
+        const igUserId = input.providerAccountId;
+        if (!igUserId) {
+            throw new Error("InstagramPublisher: missing providerAccountId (IG user id)");
+        }
+        // 1. Create the media container.
+        const container = await postForm(graph(`/${igUserId}/media`), new URLSearchParams({
+            media_type: "REELS",
+            video_url: input.mediaUrl,
+            caption: buildCaption(input),
+            access_token: input.accessToken,
+        }));
+        const creationId = container.id;
+        // 2. Poll until the upload/transcode finishes.
+        await this.waitForContainer(creationId, input.accessToken);
+        // 3. Publish the container.
+        const published = await postForm(graph(`/${igUserId}/media_publish`), new URLSearchParams({
+            creation_id: creationId,
+            access_token: input.accessToken,
+        }));
+        const mediaId = published.id;
+        logger_1.logger.info("InstagramPublisher: published", { igUserId, mediaId });
+        return {
+            providerPostId: mediaId,
+            publishedUrl: await this.resolvePermalink(mediaId, input.accessToken),
+        };
+    }
+    async waitForContainer(containerId, accessToken) {
+        for (let i = 0; i < this.maxPolls; i++) {
+            const resp = await fetch(graph(`/${containerId}?fields=status_code,status&access_token=${encodeURIComponent(accessToken)}`));
+            const json = (await resp.json());
+            const code = json.status_code;
+            if (code === "FINISHED")
+                return;
+            if (code === "ERROR" || code === "EXPIRED") {
+                throw new Error(`InstagramPublisher: container ${code} ${json.status ?? ""}`.trim());
+            }
+            await sleep(this.pollDelayMs);
+        }
+        throw new Error(`InstagramPublisher: container not ready after ${this.maxPolls} polls`);
+    }
+    async resolvePermalink(mediaId, accessToken) {
+        try {
+            const resp = await fetch(graph(`/${mediaId}?fields=permalink&access_token=${encodeURIComponent(accessToken)}`));
+            const json = (await resp.json());
+            return json.permalink;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+exports.InstagramPublisher = InstagramPublisher;
+/**
+ * Facebook Page publisher — posts a video to the Page via /{page-id}/videos with
+ * a hosted `file_url` (Graph downloads it). Supports native scheduling through
+ * `published=false` + `scheduled_publish_time` (unix seconds, 10m–6mo out).
+ */
+class FacebookPublisher {
+    constructor() {
+        this.provider = types_1.ESocialProvider.FACEBOOK;
+    }
+    async publish(input) {
+        const pageId = input.providerAccountId;
+        if (!pageId) {
+            throw new Error("FacebookPublisher: missing providerAccountId (Page id)");
+        }
+        const form = new URLSearchParams({
+            file_url: input.mediaUrl,
+            description: buildCaption(input),
+            access_token: input.accessToken,
+        });
+        if (input.title)
+            form.set("title", input.title);
+        // Native scheduling: FB requires published=false + a unix-seconds timestamp.
+        if (input.scheduledAt && input.scheduledAt > Date.now()) {
+            form.set("published", "false");
+            form.set("scheduled_publish_time", String(Math.floor(input.scheduledAt / 1000)));
+        }
+        const result = await postForm(graph(`/${pageId}/videos`), form);
+        const videoId = result.id;
+        logger_1.logger.info("FacebookPublisher: published", {
+            pageId,
+            videoId,
+            scheduled: Boolean(input.scheduledAt),
+        });
+        return {
+            providerPostId: videoId,
+            publishedUrl: `https://www.facebook.com/watch/?v=${videoId}`,
+        };
+    }
+}
+exports.FacebookPublisher = FacebookPublisher;

package/lib/services/socialPublish/pinterest.publish.d.ts

@@ -0,0 +1,13 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialPublisher, PublishInput, PublishResult } from "./types";
+export declare class PinterestPublisher implements ISocialPublisher {
+    readonly provider = ESocialProvider.PINTEREST;
+    private readonly maxPolls;
+    private readonly pollDelayMs;
+    publish(input: PublishInput): Promise<PublishResult>;
+    private firstBoardId;
+    private pollMedia;
+    private json;
+    private buildDescription;
+}
+//# sourceMappingURL=pinterest.publish.d.ts.map

package/lib/services/socialPublish/pinterest.publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinterest.publish.d.ts","sourceRoot":"","sources":["../../../src/services/socialPublish/pinterest.publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAoCxE,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,QAAQ,6BAA6B;IAE9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE9B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;YA0E5C,YAAY;YAgBZ,SAAS;YAiBT,IAAI;IAQlB,OAAO,CAAC,gBAAgB;CAQzB"}