vidspotai-shared 1.0.82 → 1.0.83

package/lib/services/socialInsights/timeBuckets.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * X8 Social Suite — Phase 6 best-time-to-post: per-user timezone bucketing.
+ *
+ * The best-time grid (C4) buckets each published post by (weekday, hour) and
+ * averages its views. v1 bucketed in UTC, which is wrong for the human question
+ * the feature answers — "what hour of *my* day should I post?". A creator in
+ * America/Los_Angeles posting at 6pm local was being filed under hour 02 (next
+ * day UTC), so the heatmap pointed at the wrong row AND the wrong column.
+ *
+ * This module is the pure, dependency-free core: given an epoch-ms timestamp and
+ * an IANA time-zone name, return the local weekday (0=Sun … 6=Sat) and hour
+ * (0–23). It uses `Intl.DateTimeFormat` (built into the runtime — no tz library)
+ * so it's deterministic and unit-testable away from any I/O. Invalid / absent
+ * zones fall back to UTC, preserving the old behaviour rather than throwing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidTimeZone = isValidTimeZone;
+exports.bucketLocal = bucketLocal;
+exports.resolveTimeZone = resolveTimeZone;
+/** Sun-first weekday index, matching `Date.prototype.getUTCDay()`. */
+const WEEKDAY_INDEX = {
+    Sun: 0,
+    Mon: 1,
+    Tue: 2,
+    Wed: 3,
+    Thu: 4,
+    Fri: 5,
+    Sat: 6,
+};
+/**
+ * Is `tz` a time zone the runtime's Intl can resolve? Empty / non-string / made
+ * up names return false (so the caller can fall back to UTC). Cheap enough to
+ * call per request — Intl caches its internal data.
+ */
+function isValidTimeZone(tz) {
+    if (typeof tz !== "string" || tz.trim() === "")
+        return false;
+    try {
+        // Throws RangeError for an unknown zone; succeeds (and is a no-op) for a
+        // valid one. "UTC" and offset-less IANA names both pass.
+        new Intl.DateTimeFormat("en-US", { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Bucket an epoch-ms timestamp into a LOCAL (weekday, hour) pair for the given
+ * IANA time zone. Falls back to UTC when `timeZone` is missing or invalid.
+ *
+ * @param epochMs unix milliseconds (the post's publish time)
+ * @param timeZone IANA name (e.g. "America/New_York"); undefined → UTC
+ */
+function bucketLocal(epochMs, timeZone) {
+    const tz = isValidTimeZone(timeZone) ? timeZone : "UTC";
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        weekday: "short",
+        hour: "2-digit",
+        hour12: false,
+    }).formatToParts(new Date(epochMs));
+    let weekday = 0;
+    let hour = 0;
+    for (const p of parts) {
+        if (p.type === "weekday")
+            weekday = WEEKDAY_INDEX[p.value] ?? 0;
+        // `hour12:false` can emit "24" for midnight in some ICU builds — fold to 0.
+        else if (p.type === "hour")
+            hour = parseInt(p.value, 10) % 24;
+    }
+    return { weekday, hour };
+}
+/** The zone actually used after validation (echoed back to the client). */
+function resolveTimeZone(timeZone) {
+    return isValidTimeZone(timeZone) ? timeZone : "UTC";
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/services/socialMetrics/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAU/C,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,GACxB,oBAAoB,CAMtB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE3E"}

package/lib/services/socialMetrics/factory.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSocialMetricsClient = getSocialMetricsClient;
+exports.isSocialMetricsSupported = isSocialMetricsSupported;
+const types_1 = require("../../globals/types");
+const meta_metrics_1 = require("./meta.metrics");
+const tiktok_metrics_1 = require("./tiktok.metrics");
+const youtube_metrics_1 = require("./youtube.metrics");
+const registry = {
+    [types_1.ESocialProvider.YOUTUBE]: () => new youtube_metrics_1.YouTubeMetricsClient(),
+    [types_1.ESocialProvider.INSTAGRAM]: () => new meta_metrics_1.InstagramMetricsClient(),
+    [types_1.ESocialProvider.FACEBOOK]: () => new meta_metrics_1.FacebookMetricsClient(),
+    [types_1.ESocialProvider.TIKTOK]: () => new tiktok_metrics_1.TikTokMetricsClient(),
+};
+function getSocialMetricsClient(provider) {
+    const make = registry[provider];
+    if (!make) {
+        throw new Error(`Social metrics not implemented for '${provider}'`);
+    }
+    return make();
+}
+function isSocialMetricsSupported(provider) {
+    return Boolean(registry[provider]);
+}

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

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./youtube.metrics";
+export * from "./meta.metrics";
+export * from "./tiktok.metrics";
+export * from "./factory";
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/services/socialMetrics/index.js

@@ -0,0 +1,21 @@
+"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.metrics"), exports);
+__exportStar(require("./meta.metrics"), exports);
+__exportStar(require("./tiktok.metrics"), exports);
+__exportStar(require("./factory"), exports);

package/lib/services/socialMetrics/meta.metrics.d.ts

@@ -0,0 +1,22 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialMetricSnapshot } from "../../models/social.model";
+import { AudienceInput, ISocialAudience, ISocialMetricsClient, MetricsInput } from "./types";
+/** Instagram media insights for a published Reel/media. */
+export declare class InstagramMetricsClient implements ISocialMetricsClient {
+    readonly provider = ESocialProvider.INSTAGRAM;
+    fetchPostMetrics({ accessToken, providerPostId, }: MetricsInput): Promise<ISocialMetricSnapshot>;
+    /**
+     * IG audience demographics via the account-level insights edge. Needs a
+     * business/creator account with ≥100 followers; otherwise Graph errors and we
+     * let the caller degrade to "not supported". `follower_demographics` returns
+     * a breakdown keyed by the requested dimension; `follower_count` (lifetime
+     * total) comes from the user node.
+     */
+    fetchAudience({ accessToken, providerAccountId, }: AudienceInput): Promise<ISocialAudience>;
+}
+/** Facebook Page video metrics via the video object summaries. */
+export declare class FacebookMetricsClient implements ISocialMetricsClient {
+    readonly provider = ESocialProvider.FACEBOOK;
+    fetchPostMetrics({ accessToken, providerPostId, }: MetricsInput): Promise<ISocialMetricSnapshot>;
+}
+//# sourceMappingURL=meta.metrics.d.ts.map

package/lib/services/socialMetrics/meta.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.metrics.d.ts","sourceRoot":"","sources":["../../../src/services/socialMetrics/meta.metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,aAAa,EAEb,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,SAAS,CAAC;AAgCjB,2DAA2D;AAC3D,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,QAAQ,CAAC,QAAQ,6BAA6B;IAExC,gBAAgB,CAAC,EACrB,WAAW,EACX,cAAc,GACf,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiDhD;;;;;;OAMG;IACG,aAAa,CAAC,EAClB,WAAW,EACX,iBAAiB,GAClB,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;CAmD5C;AAoBD,kEAAkE;AAClE,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,QAAQ,CAAC,QAAQ,4BAA4B;IAEvC,gBAAgB,CAAC,EACrB,WAAW,EACX,cAAc,GACf,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAkBjD"}

package/lib/services/socialMetrics/meta.metrics.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FacebookMetricsClient = exports.InstagramMetricsClient = void 0;
+const types_1 = require("../../globals/types");
+/**
+ * Meta metrics clients — Phase 3. Meta deprecated `impressions` in 2025, so we
+ * key analytics on `views`/`reach` (plan §3). Both clients normalize Graph
+ * responses into ISocialMetricSnapshot; missing metrics default to 0 (a fresh
+ * post may not have all insights populated for 24–72h).
+ *
+ * Config (env): META_GRAPH_VERSION (optional, default v21.0).
+ */
+const DEFAULT_GRAPH_VERSION = "v21.0";
+function graph(path) {
+    const v = process.env.META_GRAPH_VERSION || DEFAULT_GRAPH_VERSION;
+    return `https://graph.facebook.com/${v}${path}`;
+}
+function toNum(v) {
+    const n = typeof v === "number" ? v : Number(v);
+    return Number.isFinite(n) ? n : 0;
+}
+/** Instagram media insights for a published Reel/media. */
+class InstagramMetricsClient {
+    constructor() {
+        this.provider = types_1.ESocialProvider.INSTAGRAM;
+    }
+    async fetchPostMetrics({ accessToken, providerPostId, }) {
+        const tokenQs = `access_token=${encodeURIComponent(accessToken)}`;
+        // like_count / comments_count come from the media object itself.
+        const fieldsResp = await fetch(graph(`/${providerPostId}?fields=like_count,comments_count&${tokenQs}`));
+        const fields = (await fieldsResp.json());
+        if (!fieldsResp.ok || fields.error) {
+            throw new Error(`InstagramMetrics: media fields ${fieldsResp.status} ${fields.error?.message ?? ""}`.trim());
+        }
+        // reach / saves / shares / plays(views) come from the insights edge.
+        const snapshot = {
+            likes: toNum(fields.like_count),
+            comments: toNum(fields.comments_count),
+        };
+        try {
+            const insightsResp = await fetch(graph(`/${providerPostId}/insights?metric=reach,saved,shares,plays&${tokenQs}`));
+            const insights = (await insightsResp.json());
+            for (const m of insights.data ?? []) {
+                const value = toNum(m.values?.[0]?.value);
+                switch (m.name) {
+                    case "reach":
+                        snapshot.reach = value;
+                        break;
+                    case "saved":
+                        snapshot.saves = value;
+                        break;
+                    case "shares":
+                        snapshot.shares = value;
+                        break;
+                    case "plays":
+                        snapshot.views = value;
+                        break;
+                }
+            }
+        }
+        catch {
+            // Insights can be unavailable for the first hours — counters still ship.
+        }
+        return snapshot;
+    }
+    /**
+     * IG audience demographics via the account-level insights edge. Needs a
+     * business/creator account with ≥100 followers; otherwise Graph errors and we
+     * let the caller degrade to "not supported". `follower_demographics` returns
+     * a breakdown keyed by the requested dimension; `follower_count` (lifetime
+     * total) comes from the user node.
+     */
+    async fetchAudience({ accessToken, providerAccountId, }) {
+        const tokenQs = `access_token=${encodeURIComponent(accessToken)}`;
+        const audience = {};
+        // Lifetime follower total (cheap, almost always available).
+        try {
+            const resp = await fetch(graph(`/${providerAccountId}?fields=followers_count&${tokenQs}`));
+            const json = (await resp.json());
+            if (resp.ok && typeof json.followers_count === "number") {
+                audience.followerCount = json.followers_count;
+            }
+        }
+        catch {
+            // Non-fatal — demographics below are the real payload.
+        }
+        // One demographic_breakdown call per dimension (Graph requires the
+        // breakdown param to match a single dimension at a time).
+        const dims = [
+            { key: "age", breakdown: "age" },
+            { key: "gender", breakdown: "gender" },
+            { key: "country", breakdown: "country" },
+            { key: "city", breakdown: "city" },
+        ];
+        for (const { key, breakdown } of dims) {
+            try {
+                const resp = await fetch(graph(`/${providerAccountId}/insights?metric=follower_demographics&period=lifetime&metric_type=total_value&breakdown=${breakdown}&${tokenQs}`));
+                const json = (await resp.json());
+                const results = json.data?.[0]?.total_value?.breakdowns?.[0]?.results ?? [];
+                const buckets = results
+                    .map((r) => ({
+                    label: r.dimension_values?.[0] ?? "",
+                    value: toNum(r.value),
+                }))
+                    .filter((b) => b.label !== "")
+                    .sort((a, b) => b.value - a.value);
+                if (buckets.length > 0) {
+                    audience[key] = buckets;
+                }
+            }
+            catch {
+                // Skip any single dimension that errors; others may still resolve.
+            }
+        }
+        return audience;
+    }
+}
+exports.InstagramMetricsClient = InstagramMetricsClient;
+/** Facebook Page video metrics via the video object summaries. */
+class FacebookMetricsClient {
+    constructor() {
+        this.provider = types_1.ESocialProvider.FACEBOOK;
+    }
+    async fetchPostMetrics({ accessToken, providerPostId, }) {
+        const resp = await fetch(graph(`/${providerPostId}?fields=views,likes.summary(true).limit(0),comments.summary(true).limit(0)&access_token=${encodeURIComponent(accessToken)}`));
+        const json = (await resp.json());
+        if (!resp.ok || json.error) {
+            throw new Error(`FacebookMetrics: video fields ${resp.status} ${json.error?.message ?? ""}`.trim());
+        }
+        return {
+            views: toNum(json.views),
+            likes: toNum(json.likes?.summary?.total_count),
+            comments: toNum(json.comments?.summary?.total_count),
+        };
+    }
+}
+exports.FacebookMetricsClient = FacebookMetricsClient;

package/lib/services/socialMetrics/tiktok.metrics.d.ts

@@ -0,0 +1,8 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialMetricSnapshot } from "../../models/social.model";
+import { ISocialMetricsClient, MetricsInput } from "./types";
+export declare class TikTokMetricsClient implements ISocialMetricsClient {
+    readonly provider = ESocialProvider.TIKTOK;
+    fetchPostMetrics(input: MetricsInput): Promise<ISocialMetricSnapshot>;
+}
+//# sourceMappingURL=tiktok.metrics.d.ts.map

package/lib/services/socialMetrics/tiktok.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok.metrics.d.ts","sourceRoot":"","sources":["../../../src/services/socialMetrics/tiktok.metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA8B7D,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,QAAQ,CAAC,QAAQ,0BAA0B;IAErC,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAuB5E"}

package/lib/services/socialMetrics/tiktok.metrics.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TikTokMetricsClient = void 0;
+const types_1 = require("../../globals/types");
+/**
+ * TikTok metrics client — Phase 6. Queries the Display/Video API for a single
+ * video's lifetime counts and normalizes into ISocialMetricSnapshot.
+ *
+ * POST /v2/video/query/?fields=id,like_count,comment_count,share_count,view_count
+ *   body: { filters: { video_ids: [providerPostId] } }
+ *
+ * Requires the `video.list` scope (granted only with business scopes). When the
+ * scope is absent the call 403s and the metrics worker logs + reschedules
+ * (non-fatal), so this stays best-effort like the other clients.
+ */
+const QUERY_ENDPOINT = "https://open.tiktokapis.com/v2/video/query/?fields=id,like_count,comment_count,share_count,view_count";
+class TikTokMetricsClient {
+    constructor() {
+        this.provider = types_1.ESocialProvider.TIKTOK;
+    }
+    async fetchPostMetrics(input) {
+        const resp = await fetch(QUERY_ENDPOINT, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${input.accessToken}`,
+                "Content-Type": "application/json; charset=UTF-8",
+            },
+            body: JSON.stringify({ filters: { video_ids: [input.providerPostId] } }),
+        });
+        const json = (await resp.json());
+        if (!resp.ok || json.error?.code) {
+            throw new Error(`TikTokMetrics: video query ${resp.status} ${json.error?.message ?? ""}`.trim());
+        }
+        const v = json.data?.videos?.[0];
+        return {
+            views: v?.view_count ?? 0,
+            likes: v?.like_count ?? 0,
+            comments: v?.comment_count ?? 0,
+            shares: v?.share_count ?? 0,
+        };
+    }
+}
+exports.TikTokMetricsClient = TikTokMetricsClient;

package/lib/services/socialMetrics/types.d.ts

@@ -0,0 +1,54 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialMetricSnapshot } from "../../models/social.model";
+/**
+ * X8 Social Suite — analytics client abstraction. No platform pushes analytics
+ * and data lags 24–72h, so the metrics worker polls each published post on a
+ * schedule and snapshots into the `socialAnalytics` time-series. One
+ * implementation per platform normalizes provider metrics into
+ * `ISocialMetricSnapshot` (views-centric — impressions are deprecated on Meta).
+ * See notes/SOCIAL_SUITE_PLAN.md §3/§4.
+ */
+export interface MetricsInput {
+    /** Cleartext access token for the owning account (already refreshed). */
+    accessToken: string;
+    /** Provider's post/video id to fetch metrics for. */
+    providerPostId: string;
+}
+export interface AudienceInput {
+    /** Cleartext access token for the owning account (already refreshed). */
+    accessToken: string;
+    /** Provider's account id (IG user id / channel id / Page id). */
+    providerAccountId: string;
+}
+/** One bucket of an audience breakdown, e.g. { label: "25-34", value: 0.32 }. */
+export interface IAudienceBucket {
+    label: string;
+    /** Share 0..1 (preferred) or an absolute count where shares aren't given. */
+    value: number;
+}
+/**
+ * Normalized audience demographics (C7 / G3). Owner-account only and gated to
+ * business-tier accounts on Meta (≥100 followers). Any dimension the provider
+ * doesn't expose is simply omitted.
+ */
+export interface ISocialAudience {
+    followerCount?: number;
+    age?: IAudienceBucket[];
+    gender?: IAudienceBucket[];
+    country?: IAudienceBucket[];
+    city?: IAudienceBucket[];
+    /** Active hours 0..23 (engaged-follower online time) where available. */
+    activeHours?: IAudienceBucket[];
+}
+export interface ISocialMetricsClient {
+    readonly provider: ESocialProvider;
+    /** Fetch the current lifetime metrics for one post. */
+    fetchPostMetrics(input: MetricsInput): Promise<ISocialMetricSnapshot>;
+    /**
+     * Fetch audience demographics for the account (owner-only, business-tier).
+     * Optional: providers/accounts without the capability omit it, and callers
+     * degrade gracefully to "not supported". See plan §C7/§2B-G3.
+     */
+    fetchAudience?(input: AudienceInput): Promise<ISocialAudience>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/services/socialMetrics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/socialMetrics/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IACzB,yEAAyE;IACzE,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,uDAAuD;IACvD,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACtE;;;;OAIG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE"}

package/lib/services/socialMetrics/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/services/socialMetrics/youtube.metrics.d.ts

@@ -0,0 +1,8 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialMetricSnapshot } from "../../models/social.model";
+import { ISocialMetricsClient, MetricsInput } from "./types";
+export declare class YouTubeMetricsClient implements ISocialMetricsClient {
+    readonly provider = ESocialProvider.YOUTUBE;
+    fetchPostMetrics({ accessToken, providerPostId, }: MetricsInput): Promise<ISocialMetricSnapshot>;
+}
+//# sourceMappingURL=youtube.metrics.d.ts.map

package/lib/services/socialMetrics/youtube.metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.metrics.d.ts","sourceRoot":"","sources":["../../../src/services/socialMetrics/youtube.metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAuB7D,qBAAa,oBAAqB,YAAW,oBAAoB;IAC/D,QAAQ,CAAC,QAAQ,2BAA2B;IAEtC,gBAAgB,CAAC,EACrB,WAAW,EACX,cAAc,GACf,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAmBjD"}

package/lib/services/socialMetrics/youtube.metrics.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YouTubeMetricsClient = void 0;
+const types_1 = require("../../globals/types");
+/**
+ * YouTube metrics client. Uses the Data API `videos.list?part=statistics` for
+ * lifetime counters (views/likes/comments) — cheap (1 quota unit) and available
+ * to any channel. Watch-time / CTR / impressions live in the YouTube Analytics
+ * API and lag ~48–72h; we add those in Phase 4 (plan §3). Phase 1 ships the
+ * core counters so the analytics card has real data.
+ */
+const STATS_ENDPOINT = "https://www.googleapis.com/youtube/v3/videos?part=statistics";
+class YouTubeMetricsClient {
+    constructor() {
+        this.provider = types_1.ESocialProvider.YOUTUBE;
+    }
+    async fetchPostMetrics({ accessToken, providerPostId, }) {
+        const url = `${STATS_ENDPOINT}&id=${encodeURIComponent(providerPostId)}`;
+        const resp = await fetch(url, {
+            headers: { Authorization: `Bearer ${accessToken}` },
+        });
+        if (!resp.ok) {
+            throw new Error(`YouTubeMetrics: videos.list ${resp.status}`);
+        }
+        const json = (await resp.json());
+        const stats = json.items?.[0]?.statistics;
+        if (!stats) {
+            throw new Error(`YouTubeMetrics: no stats for video ${providerPostId}`);
+        }
+        return {
+            views: toNum(stats.viewCount),
+            likes: toNum(stats.likeCount),
+            comments: toNum(stats.commentCount),
+        };
+    }
+}
+exports.YouTubeMetricsClient = YouTubeMetricsClient;
+function toNum(v) {
+    if (v === undefined)
+        return 0;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+}

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

@@ -0,0 +1,7 @@
+import { ESocialProvider } from "../../globals/types";
+import { ISocialOAuthProvider } from "./types";
+/** Returns the OAuth provider for a platform, or throws if not yet supported. */
+export declare function getSocialOAuthProvider(provider: ESocialProvider): ISocialOAuthProvider;
+/** True when a platform's OAuth is wired up (used to gate the connect UI). */
+export declare function isSocialOAuthSupported(provider: ESocialProvider): boolean;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/services/socialOAuth/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAyB/C,iFAAiF;AACjF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,GACxB,oBAAoB,CAMtB;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAEzE"}

package/lib/services/socialOAuth/factory.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSocialOAuthProvider = getSocialOAuthProvider;
+exports.isSocialOAuthSupported = isSocialOAuthSupported;
+const types_1 = require("../../globals/types");
+const linkedin_oauth_1 = require("./linkedin.oauth");
+const meta_oauth_1 = require("./meta.oauth");
+const pinterest_oauth_1 = require("./pinterest.oauth");
+const threads_oauth_1 = require("./threads.oauth");
+const tiktok_oauth_1 = require("./tiktok.oauth");
+const x_oauth_1 = require("./x.oauth");
+const youtube_oauth_1 = require("./youtube.oauth");
+/**
+ * OAuth provider factory. Mirrors the aiGenFactory pattern: map a provider enum
+ * to its implementation. Add TikTok/LinkedIn here as their phases land.
+ *
+ * Meta backs both FACEBOOK and INSTAGRAM: one Facebook Login grant resolves the
+ * user's Pages (FACEBOOK) or their linked IG Business accounts (INSTAGRAM); the
+ * `target` ctor arg selects which the callback persists.
+ */
+const registry = {
+    [types_1.ESocialProvider.YOUTUBE]: () => new youtube_oauth_1.YouTubeOAuthProvider(),
+    [types_1.ESocialProvider.FACEBOOK]: () => new meta_oauth_1.MetaOAuthProvider(types_1.ESocialProvider.FACEBOOK),
+    [types_1.ESocialProvider.INSTAGRAM]: () => new meta_oauth_1.MetaOAuthProvider(types_1.ESocialProvider.INSTAGRAM),
+    [types_1.ESocialProvider.TIKTOK]: () => new tiktok_oauth_1.TikTokOAuthProvider(),
+    [types_1.ESocialProvider.THREADS]: () => new threads_oauth_1.ThreadsOAuthProvider(),
+    [types_1.ESocialProvider.LINKEDIN]: () => new linkedin_oauth_1.LinkedInOAuthProvider(),
+    [types_1.ESocialProvider.X]: () => new x_oauth_1.XOAuthProvider(),
+    [types_1.ESocialProvider.PINTEREST]: () => new pinterest_oauth_1.PinterestOAuthProvider(),
+};
+/** Returns the OAuth provider for a platform, or throws if not yet supported. */
+function getSocialOAuthProvider(provider) {
+    const make = registry[provider];
+    if (!make) {
+        throw new Error(`Social OAuth not implemented for provider '${provider}'`);
+    }
+    return make();
+}
+/** True when a platform's OAuth is wired up (used to gate the connect UI). */
+function isSocialOAuthSupported(provider) {
+    return Boolean(registry[provider]);
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/socialOAuth/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/lib/services/socialOAuth/index.js

@@ -0,0 +1,26 @@
+"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.oauth"), exports);
+__exportStar(require("./meta.oauth"), exports);
+__exportStar(require("./tiktok.oauth"), exports);
+__exportStar(require("./threads.oauth"), exports);
+__exportStar(require("./linkedin.oauth"), exports);
+__exportStar(require("./x.oauth"), exports);
+__exportStar(require("./pinterest.oauth"), exports);
+__exportStar(require("./oauthState"), exports);
+__exportStar(require("./factory"), exports);

package/lib/services/socialOAuth/linkedin.oauth.d.ts

@@ -0,0 +1,14 @@
+import { ESocialProvider } from "../../globals/types";
+import { AuthUrlParams, ConnectResult, ExchangeCodeParams, ISocialOAuthProvider, OAuthTokens } from "./types";
+export declare class LinkedInOAuthProvider implements ISocialOAuthProvider {
+    readonly provider = ESocialProvider.LINKEDIN;
+    private clientId;
+    private clientSecret;
+    getAuthUrl({ state, redirectUri, requestBusinessScopes, }: AuthUrlParams): string;
+    exchangeCode({ code, redirectUri, }: ExchangeCodeParams): Promise<ConnectResult>;
+    refresh(refreshToken: string): Promise<OAuthTokens>;
+    private postToken;
+    private toTokens;
+    private resolveAccount;
+}
+//# sourceMappingURL=linkedin.oauth.d.ts.map

package/lib/services/socialOAuth/linkedin.oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin.oauth.d.ts","sourceRoot":"","sources":["../../../src/services/socialOAuth/linkedin.oauth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACZ,MAAM,SAAS,CAAC;AAyCjB,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,QAAQ,CAAC,QAAQ,4BAA4B;IAE7C,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;IAMpB,UAAU,CAAC,EACT,KAAK,EACL,WAAW,EACX,qBAAqB,GACtB,EAAE,aAAa,GAAG,MAAM;IAcnB,YAAY,CAAC,EACjB,IAAI,EACJ,WAAW,GACZ,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBxC,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAiB3C,SAAS;IAmBvB,OAAO,CAAC,QAAQ;YAaF,cAAc;CAiB7B"}