@venturekit-pro/social 0.0.0-dev.20260602192622

package/dist/adapters/instagram.js

@@ -0,0 +1,113 @@
+/**
+ * Instagram (Business / Creator) adapter — Meta Graph Content
+ * Publishing API.
+ *
+ * Two-step protocol — the only one in this package:
+ *   1. `POST /v18.0/<ig-user-id>/media`         → returns `creation_id`
+ *   2. `POST /v18.0/<ig-user-id>/media_publish` → publishes the container
+ *
+ * Auth:  Page-linked IG user access token via
+ *        `Authorization: Bearer …`.
+ *
+ * `credentials.authorRef` carries the IG user id (e.g.
+ * `'ig_user_12345'`). Caption is required; media is required —
+ * Instagram doesn't allow text-only posts.
+ */
+import { vendorFetch } from '../http.js';
+import { validatePost } from '../validation.js';
+const META_GRAPH_BASE = 'https://graph.facebook.com';
+const META_GRAPH_VERSION = 'v18.0';
+export const INSTAGRAM_CONSTRAINTS = {
+    maxBodyChars: 2200,
+    // Instagram doesn't strictly require a caption but a 0-char caption
+    // is universally a smell. Adapter requires 1+ char for a meaningful
+    // post; apps can override.
+    minBodyChars: 1,
+    minHashtags: 5,
+    maxHashtags: 12,
+    allowedMimeTypes: ['image/jpeg'],
+    maxMediaCount: 1, // Carousels require a different multi-step flow; v1 = single
+    allowedAspectRatios: ['1:1', '4:5'],
+    maxMediaSizeBytes: 8 * 1024 * 1024,
+    supportsFirstComment: true,
+    // Text-only posts are rejected by the Content Publishing API; the
+    // validator catches this client-side so the caller doesn't have to
+    // round-trip to Meta to discover it.
+    requiresMedia: true,
+};
+export function createInstagramAdapter(config = {}) {
+    const baseUrl = (config.baseUrl ?? META_GRAPH_BASE).replace(/\/+$/, '');
+    const version = config.graphVersion ?? META_GRAPH_VERSION;
+    const constraints = {
+        ...INSTAGRAM_CONSTRAINTS,
+        ...config.constraints,
+    };
+    return {
+        key: 'instagram',
+        displayName: 'Instagram',
+        constraints,
+        validate(post) {
+            return validatePost(post, constraints);
+        },
+        async publish(post, credentials) {
+            const igUserId = stripIgPrefix(credentials.authorRef);
+            const media = post.media?.[0];
+            if (!media) {
+                // Validation should have caught this, but defensive: IG
+                // refuses text-only posts at the API level.
+                throw new Error('[social/instagram] Instagram requires at least one media item.');
+            }
+            // ─── Step 1: create the container ────────────────────────────
+            const createBody = new URLSearchParams({
+                image_url: media.url,
+                caption: post.body,
+            });
+            const createRes = await vendorFetch('instagram', `${baseUrl}/${version}/${encodeURIComponent(igUserId)}/media`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${credentials.accessToken}`,
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: createBody,
+            });
+            const created = createRes.body;
+            const creationId = created?.id;
+            if (!creationId) {
+                throw new Error('[social/instagram] media-create returned no id; vendor body: ' +
+                    createRes.bodyText.slice(0, 200));
+            }
+            // ─── Step 2: publish the container ──────────────────────────
+            const publishBody = new URLSearchParams({
+                creation_id: creationId,
+            });
+            const publishRes = await vendorFetch('instagram', `${baseUrl}/${version}/${encodeURIComponent(igUserId)}/media_publish`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${credentials.accessToken}`,
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: publishBody,
+            });
+            const published = publishRes.body;
+            const externalRef = published?.id;
+            if (!externalRef) {
+                throw new Error('[social/instagram] media_publish returned no id; vendor body: ' +
+                    publishRes.bodyText.slice(0, 200));
+            }
+            return {
+                externalRef,
+                // IG doesn't expose a deterministic media-permalink at
+                // publish time; the caller can re-fetch via
+                // `GET /<ig-media-id>?fields=permalink` if needed.
+                publishedAt: new Date().toISOString(),
+                idempotencyKey: post.idempotencyKey,
+                correlationId: post.correlationId,
+                raw: { container: created, publish: published },
+            };
+        },
+    };
+}
+function stripIgPrefix(authorRef) {
+    return authorRef.startsWith('ig_user_') ? authorRef.slice(8) : authorRef;
+}
+//# sourceMappingURL=instagram.js.map

package/dist/adapters/instagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.js","sourceRoot":"","sources":["../../src/adapters/instagram.ts"],"names":[],"mappings":"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"}

package/dist/adapters/linkedin.d.ts

@@ -0,0 +1,28 @@
+/**
+ * LinkedIn adapter — UGC Posts API (v2).
+ *
+ * Endpoint: `POST https://api.linkedin.com/v2/ugcPosts`
+ * Auth:     OAuth 2.0 bearer token in `Authorization: Bearer …`
+ * Author:   `urn:li:organization:<id>` or `urn:li:person:<id>`
+ *           — caller supplies via `credentials.authorRef`.
+ *
+ * The adapter only implements text + image posts (the 95% case for
+ * editorial content). Article / video / multi-image carousels are
+ * out of scope for the v1 ship and require the staged-upload
+ * endpoint; deliberately deferred.
+ */
+import type { SocialAdapter } from '../adapter.js';
+import type { SocialPlatformConstraints } from '../types.js';
+export declare const LINKEDIN_CONSTRAINTS: SocialPlatformConstraints;
+export interface LinkedInAdapterConfig {
+    /** Override the API host — for testing against `wiremock` etc. */
+    baseUrl?: string;
+    /** Per-platform constraint overrides (e.g. stricter byline rules). */
+    constraints?: Partial<SocialPlatformConstraints>;
+}
+/**
+ * Construct a LinkedIn adapter. Constraints can be overridden for
+ * tenants on premium plans / sandbox endpoints.
+ */
+export declare function createLinkedInAdapter(config?: LinkedInAdapterConfig): SocialAdapter;
+//# sourceMappingURL=linkedin.d.ts.map

package/dist/adapters/linkedin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin.d.ts","sourceRoot":"","sources":["../../src/adapters/linkedin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAIV,yBAAyB,EAE1B,MAAM,aAAa,CAAC;AAMrB,eAAO,MAAM,oBAAoB,EAAE,yBAUlC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,qBAA0B,GACjC,aAAa,CAyDf"}

package/dist/adapters/linkedin.js

@@ -0,0 +1,121 @@
+/**
+ * LinkedIn adapter — UGC Posts API (v2).
+ *
+ * Endpoint: `POST https://api.linkedin.com/v2/ugcPosts`
+ * Auth:     OAuth 2.0 bearer token in `Authorization: Bearer …`
+ * Author:   `urn:li:organization:<id>` or `urn:li:person:<id>`
+ *           — caller supplies via `credentials.authorRef`.
+ *
+ * The adapter only implements text + image posts (the 95% case for
+ * editorial content). Article / video / multi-image carousels are
+ * out of scope for the v1 ship and require the staged-upload
+ * endpoint; deliberately deferred.
+ */
+import { vendorFetch } from '../http.js';
+import { validatePost } from '../validation.js';
+const LINKEDIN_API_BASE = 'https://api.linkedin.com';
+export const LINKEDIN_CONSTRAINTS = {
+    maxBodyChars: 3000,
+    minBodyChars: 1,
+    minHashtags: 2,
+    maxHashtags: 5,
+    allowedMimeTypes: ['image/jpeg', 'image/png', 'image/webp'],
+    maxMediaCount: 9,
+    allowedAspectRatios: ['1:1', '4:3', '16:9', '4:5'],
+    maxMediaSizeBytes: 20 * 1024 * 1024, // 20MB per LinkedIn docs
+    supportsFirstComment: true,
+};
+/**
+ * Construct a LinkedIn adapter. Constraints can be overridden for
+ * tenants on premium plans / sandbox endpoints.
+ */
+export function createLinkedInAdapter(config = {}) {
+    const baseUrl = (config.baseUrl ?? LINKEDIN_API_BASE).replace(/\/+$/, '');
+    const constraints = {
+        ...LINKEDIN_CONSTRAINTS,
+        ...config.constraints,
+    };
+    return {
+        key: 'linkedin',
+        displayName: 'LinkedIn',
+        constraints,
+        validate(post) {
+            return validatePost(post, constraints);
+        },
+        async publish(post, credentials) {
+            const body = buildUgcPost(post, credentials);
+            const headers = {
+                Authorization: `Bearer ${credentials.accessToken}`,
+                'Content-Type': 'application/json',
+                'X-Restli-Protocol-Version': '2.0.0',
+            };
+            if (post.idempotencyKey) {
+                // LinkedIn doesn't have a native Idempotency-Key header for
+                // UGC Posts; the value travels via the `originToken` field
+                // on the post body which LinkedIn dedupes against.
+                // (Implemented in buildUgcPost.)
+            }
+            const res = await vendorFetch('linkedin', `${baseUrl}/v2/ugcPosts`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+            });
+            const json = res.body;
+            const externalRef = json?.id ?? res.headers.get('x-linkedin-id') ?? '';
+            if (!externalRef) {
+                // LinkedIn always returns 201 with an id; if we didn't get
+                // one, the post probably WASN'T accepted — fail loud.
+                throw new Error('[social/linkedin] Publish returned no id; vendor body: ' + res.bodyText.slice(0, 200));
+            }
+            return {
+                externalRef,
+                // The public URL form is `https://www.linkedin.com/feed/update/<urn>`.
+                publishedUrl: `https://www.linkedin.com/feed/update/${encodeURIComponent(externalRef)}`,
+                publishedAt: new Date().toISOString(),
+                idempotencyKey: post.idempotencyKey,
+                correlationId: post.correlationId,
+                raw: json,
+            };
+        },
+    };
+}
+function buildUgcPost(post, credentials) {
+    const media = post.media ?? [];
+    const hasMedia = media.length > 0;
+    const hasArticleLink = !hasMedia && !!post.link;
+    const body = {
+        author: credentials.authorRef,
+        lifecycleState: 'PUBLISHED',
+        specificContent: {
+            'com.linkedin.ugc.ShareContent': {
+                shareCommentary: { text: post.body },
+                shareMediaCategory: hasMedia ? 'IMAGE' : hasArticleLink ? 'ARTICLE' : 'NONE',
+            },
+        },
+        visibility: { 'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC' },
+    };
+    if (post.idempotencyKey) {
+        body.originToken = post.idempotencyKey;
+    }
+    if (hasMedia) {
+        body.specificContent['com.linkedin.ugc.ShareContent'].media = media.map((m) => ({
+            status: 'READY',
+            ...(m.altText ? { description: { text: m.altText } } : {}),
+            // LinkedIn expects an image URN (`urn:li:digitalmediaAsset:…`),
+            // not a public URL. For v1 we assume the caller has already
+            // staged the upload + put the URN in `media.url`. Caller-side
+            // staging is documented in the README.
+            media: m.url,
+        }));
+    }
+    else if (hasArticleLink) {
+        body.specificContent['com.linkedin.ugc.ShareContent'].media = [
+            {
+                status: 'READY',
+                originalUrl: post.link,
+            },
+        ];
+    }
+    return body;
+}
+//# sourceMappingURL=linkedin.js.map

package/dist/adapters/linkedin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin.js","sourceRoot":"","sources":["../../src/adapters/linkedin.ts"],"names":[],"mappings":"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"}

package/dist/adapters/x.d.ts

@@ -0,0 +1,21 @@
+/**
+ * X (formerly Twitter) adapter — v2 Tweets API.
+ *
+ * Endpoint: `POST https://api.twitter.com/2/tweets`
+ * Auth:     OAuth 2.0 user-context bearer token
+ *
+ * Media uploads go through the v1.1 `media/upload.json` endpoint
+ * which is a separate pre-upload step; v1 of this adapter assumes
+ * the caller has already uploaded media and stashes the resulting
+ * `media_id` in `media.url` (we treat `url` as a generic "platform
+ * media reference" for every adapter).
+ */
+import type { SocialAdapter } from '../adapter.js';
+import type { SocialPlatformConstraints } from '../types.js';
+export declare const X_CONSTRAINTS: SocialPlatformConstraints;
+export interface XAdapterConfig {
+    baseUrl?: string;
+    constraints?: Partial<SocialPlatformConstraints>;
+}
+export declare function createXAdapter(config?: XAdapterConfig): SocialAdapter;
+//# sourceMappingURL=x.d.ts.map

package/dist/adapters/x.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x.d.ts","sourceRoot":"","sources":["../../src/adapters/x.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAIV,yBAAyB,EAE1B,MAAM,aAAa,CAAC;AAMrB,eAAO,MAAM,aAAa,EAAE,yBAU3B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAClD;AAED,wBAAgB,cAAc,CAAC,MAAM,GAAE,cAAmB,GAAG,aAAa,CAiDzE"}

package/dist/adapters/x.js

@@ -0,0 +1,80 @@
+/**
+ * X (formerly Twitter) adapter — v2 Tweets API.
+ *
+ * Endpoint: `POST https://api.twitter.com/2/tweets`
+ * Auth:     OAuth 2.0 user-context bearer token
+ *
+ * Media uploads go through the v1.1 `media/upload.json` endpoint
+ * which is a separate pre-upload step; v1 of this adapter assumes
+ * the caller has already uploaded media and stashes the resulting
+ * `media_id` in `media.url` (we treat `url` as a generic "platform
+ * media reference" for every adapter).
+ */
+import { vendorFetch } from '../http.js';
+import { validatePost } from '../validation.js';
+const X_API_BASE = 'https://api.twitter.com';
+export const X_CONSTRAINTS = {
+    maxBodyChars: 280,
+    minBodyChars: 1,
+    minHashtags: 1,
+    maxHashtags: 3,
+    allowedMimeTypes: ['image/jpeg', 'image/png', 'image/webp', 'image/gif'],
+    maxMediaCount: 4,
+    allowedAspectRatios: ['16:9', '4:3', '1:1'],
+    maxMediaSizeBytes: 5 * 1024 * 1024,
+    supportsFirstComment: true,
+};
+export function createXAdapter(config = {}) {
+    const baseUrl = (config.baseUrl ?? X_API_BASE).replace(/\/+$/, '');
+    const constraints = {
+        ...X_CONSTRAINTS,
+        ...config.constraints,
+    };
+    return {
+        key: 'x',
+        displayName: 'X',
+        constraints,
+        validate(post) {
+            return validatePost(post, constraints);
+        },
+        async publish(post, credentials) {
+            const body = buildTweetBody(post);
+            const res = await vendorFetch('x', `${baseUrl}/2/tweets`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${credentials.accessToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+            });
+            const json = res.body;
+            const externalRef = json?.data?.id;
+            if (!externalRef) {
+                throw new Error('[social/x] Publish returned no tweet id; vendor body: ' + res.bodyText.slice(0, 200));
+            }
+            // X's public URL form requires the username, which we don't
+            // necessarily have at publish time. Use the canonical `i/web`
+            // form which works for any tweet and lets the browser redirect.
+            return {
+                externalRef,
+                publishedUrl: `https://x.com/i/web/status/${encodeURIComponent(externalRef)}`,
+                publishedAt: new Date().toISOString(),
+                idempotencyKey: post.idempotencyKey,
+                correlationId: post.correlationId,
+                raw: json,
+            };
+        },
+    };
+}
+function buildTweetBody(post) {
+    const body = { text: post.body };
+    const media = post.media ?? [];
+    if (media.length > 0) {
+        // For X, `media.url` carries the v1.1 `media_id_string` value
+        // produced by the upload step (the adapter doesn't perform that
+        // upload — apps stage media before calling publish).
+        body.media = { media_ids: media.map((m) => m.url) };
+    }
+    return body;
+}
+//# sourceMappingURL=x.js.map

package/dist/adapters/x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x.js","sourceRoot":"","sources":["../../src/adapters/x.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC;IACxE,aAAa,EAAE,CAAC;IAChB,mBAAmB,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IAC3C,iBAAiB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAClC,oBAAoB,EAAE,IAAI;CAC3B,CAAC;AAOF,MAAM,UAAU,cAAc,CAAC,SAAyB,EAAE;IACxD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,WAAW,GAA8B;QAC7C,GAAG,aAAa;QAChB,GAAG,MAAM,CAAC,WAAW;KACtB,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,GAAG;QACR,WAAW,EAAE,GAAG;QAChB,WAAW;QAEX,QAAQ,CAAC,IAAgB;YACvB,OAAO,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW;YAC7B,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YAElC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,WAAW,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,WAAW,CAAC,WAAW,EAAE;oBAClD,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAwD,CAAC;YAC1E,MAAM,WAAW,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,wDAAwD,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CACtF,CAAC;YACJ,CAAC;YAED,4DAA4D;YAC5D,8DAA8D;YAC9D,gEAAgE;YAChE,OAAO;gBACL,WAAW;gBACX,YAAY,EAAE,8BAA8B,kBAAkB,CAAC,WAAW,CAAC,EAAE;gBAC7E,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,GAAG,EAAE,IAAI;aACV,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAQD,SAAS,cAAc,CAAC,IAAgB;IACtC,MAAM,IAAI,GAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,8DAA8D;QAC9D,gEAAgE;QAChE,qDAAqD;QACrD,IAAI,CAAC,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Tiny fetch wrapper shared by every adapter.
+ *
+ * Centralizes:
+ *   - AbortController-backed timeout (default 30s, override per call)
+ *   - Vendor-status → typed-error mapping (401/403 → SocialAuthError,
+ *     429 → SocialRateLimitError, 4xx → SocialValidationError,
+ *     5xx → SocialPublishError)
+ *   - Retry-After parsing for rate-limit responses
+ *
+ * Adapter-level retry / fallback orchestration is the caller's
+ * concern (the CMS wraps publish() in its `withJob` retry logic, and
+ * apps can reuse `@venturekit-pro/ai`'s `retryWithBackoff` if they
+ * want exponential jitter — these are not LLM-specific).
+ */
+import { type SocialPlatformKey } from './types.js';
+export interface FetchOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: string | URLSearchParams;
+    timeoutMs?: number;
+    /** Override the abort signal — e.g. when the caller propagates its own. */
+    signal?: AbortSignal;
+}
+export interface FetchResult {
+    status: number;
+    headers: Headers;
+    body: unknown;
+    bodyText: string;
+}
+/**
+ * POST/PUT/GET with vendor-status mapping. Returns the parsed body
+ * on success; throws a typed error on failure.
+ *
+ * `body` is forwarded verbatim — caller is responsible for setting
+ * the right Content-Type header (`application/json` is the package
+ * default when one isn't supplied).
+ */
+export declare function vendorFetch(platform: SocialPlatformKey, url: string, opts?: FetchOptions): Promise<FetchResult>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,WAAW,CAAC,CA+FtB"}

package/dist/http.js

@@ -0,0 +1,127 @@
+/**
+ * Tiny fetch wrapper shared by every adapter.
+ *
+ * Centralizes:
+ *   - AbortController-backed timeout (default 30s, override per call)
+ *   - Vendor-status → typed-error mapping (401/403 → SocialAuthError,
+ *     429 → SocialRateLimitError, 4xx → SocialValidationError,
+ *     5xx → SocialPublishError)
+ *   - Retry-After parsing for rate-limit responses
+ *
+ * Adapter-level retry / fallback orchestration is the caller's
+ * concern (the CMS wraps publish() in its `withJob` retry logic, and
+ * apps can reuse `@venturekit-pro/ai`'s `retryWithBackoff` if they
+ * want exponential jitter — these are not LLM-specific).
+ */
+import { SocialAuthError, SocialPublishError, SocialRateLimitError, SocialValidationError, } from './types.js';
+/**
+ * POST/PUT/GET with vendor-status mapping. Returns the parsed body
+ * on success; throws a typed error on failure.
+ *
+ * `body` is forwarded verbatim — caller is responsible for setting
+ * the right Content-Type header (`application/json` is the package
+ * default when one isn't supplied).
+ */
+export async function vendorFetch(platform, url, opts = {}) {
+    const controller = new AbortController();
+    const timeoutMs = opts.timeoutMs ?? 30_000;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    // If the caller passed their own signal, forward both.
+    if (opts.signal) {
+        if (opts.signal.aborted) {
+            clearTimeout(timer);
+            throw new SocialPublishError('Aborted before request', { platform });
+        }
+        opts.signal.addEventListener('abort', () => controller.abort(), { once: true });
+    }
+    let response;
+    try {
+        response = await fetch(url, {
+            method: opts.method ?? 'GET',
+            headers: {
+                Accept: 'application/json',
+                ...(opts.body && !('Content-Type' in (opts.headers ?? {}))
+                    ? { 'Content-Type': 'application/json' }
+                    : {}),
+                ...(opts.headers ?? {}),
+            },
+            body: opts.body,
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err.name === 'AbortError') {
+            throw new SocialPublishError(`Request to ${url} timed out after ${timeoutMs}ms`, {
+                platform,
+            });
+        }
+        throw new SocialPublishError(`Network error talking to ${url}: ${err.message}`, { platform });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const bodyText = await response.text();
+    let parsedBody;
+    try {
+        parsedBody = bodyText ? JSON.parse(bodyText) : null;
+    }
+    catch {
+        parsedBody = bodyText;
+    }
+    if (response.ok) {
+        return {
+            status: response.status,
+            headers: response.headers,
+            body: parsedBody,
+            bodyText,
+        };
+    }
+    // ─── Map vendor status → typed error ────────────────────────────
+    const truncated = bodyText.length > 1024 ? bodyText.slice(0, 1024) + '…' : bodyText;
+    const message = `${response.status} ${response.statusText}: ${truncated}`;
+    if (response.status === 401 || response.status === 403) {
+        throw new SocialAuthError(message, {
+            platform,
+            status: response.status,
+            raw: parsedBody,
+        });
+    }
+    if (response.status === 429) {
+        const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
+        throw new SocialRateLimitError(message, {
+            platform,
+            status: response.status,
+            raw: parsedBody,
+            retryAfterSeconds: retryAfter,
+        });
+    }
+    if (response.status >= 400 && response.status < 500) {
+        throw new SocialValidationError(message, {
+            platform,
+            status: response.status,
+            raw: parsedBody,
+        });
+    }
+    throw new SocialPublishError(message, {
+        platform,
+        status: response.status,
+        raw: parsedBody,
+    });
+}
+function parseRetryAfter(header) {
+    if (!header)
+        return undefined;
+    // Numeric form: seconds to wait.
+    const n = Number(header);
+    if (Number.isFinite(n) && n >= 0)
+        return n;
+    // HTTP-date form: difference from now.
+    const t = Date.parse(header);
+    if (Number.isFinite(t)) {
+        const seconds = Math.max(0, Math.ceil((t - Date.now()) / 1000));
+        return seconds;
+    }
+    return undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,YAAY,CAAC;AAkBpB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAA2B,EAC3B,GAAW,EACX,OAAqB,EAAE;IAEvB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,uDAAuD;IACvD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;oBACxD,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBACxC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;aACxB;YACD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAK,GAAyB,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACrD,MAAM,IAAI,kBAAkB,CAAC,cAAc,GAAG,oBAAoB,SAAS,IAAI,EAAE;gBAC/E,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,GAAG,KAAM,GAAa,CAAC,OAAO,EAAE,EAC5D,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,UAAmB,CAAC;IACxB,IAAI,CAAC;QACH,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,UAAU;YAChB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpF,MAAM,OAAO,GAAG,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;IAE1E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvD,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE;YACjC,QAAQ;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QACxE,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE;YACtC,QAAQ;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,EAAE,UAAU;YACf,iBAAiB,EAAE,UAAU;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,qBAAqB,CAAC,OAAO,EAAE;YACvC,QAAQ;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,kBAAkB,CAAC,OAAO,EAAE;QACpC,QAAQ;QACR,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,EAAE,UAAU;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,MAAqB;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,iCAAiC;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,uCAAuC;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @venturekit-pro/social
+ *
+ * Generic social-platform publishing adapters + tenant catalog.
+ *
+ *   - `SocialAdapter`               — adapter contract (validate + publish + optional verify/parseWebhook).
+ *   - `createAdapterRegistry`       — lookup table for the consumer to populate.
+ *   - `validatePost`                — generic constraint validator reused by every adapter.
+ *   - `createLinkedInAdapter` /
+ *     `createXAdapter` /
+ *     `createFacebookAdapter` /
+ *     `createInstagramAdapter`      — v1 adapters.
+ *   - `getSocialMigrationsDir`      — path to `vk_social_*.sql` for `vk migrate`.
+ *
+ * Documentation: https://venturekit.dev
+ */
+export type { SocialPlatformKey, SocialPost, SocialMedia, SocialPlatformConstraints, SocialValidationCode, SocialValidationIssue, SocialValidationResult, OAuthCredentials, PublishResult, VerifyResult, WebhookEvent, } from './types.js';
+export { SocialPublishError, SocialAuthError, SocialRateLimitError, SocialValidationError, } from './types.js';
+export type { SocialAdapter } from './adapter.js';
+export type { AdapterRegistry } from './registry.js';
+export { createAdapterRegistry } from './registry.js';
+export { validatePost, simplifyRatio } from './validation.js';
+export { vendorFetch } from './http.js';
+export type { FetchOptions, FetchResult } from './http.js';
+export { createLinkedInAdapter, LINKEDIN_CONSTRAINTS, createXAdapter, X_CONSTRAINTS, createFacebookAdapter, FACEBOOK_CONSTRAINTS, createInstagramAdapter, INSTAGRAM_CONSTRAINTS, } from './adapters/index.js';
+export type { LinkedInAdapterConfig, XAdapterConfig, FacebookAdapterConfig, InstagramAdapterConfig, } from './adapters/index.js';
+export { getSocialMigrationsDir } from './path.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @venturekit-pro/social
+ *
+ * Generic social-platform publishing adapters + tenant catalog.
+ *
+ *   - `SocialAdapter`               — adapter contract (validate + publish + optional verify/parseWebhook).
+ *   - `createAdapterRegistry`       — lookup table for the consumer to populate.
+ *   - `validatePost`                — generic constraint validator reused by every adapter.
+ *   - `createLinkedInAdapter` /
+ *     `createXAdapter` /
+ *     `createFacebookAdapter` /
+ *     `createInstagramAdapter`      — v1 adapters.
+ *   - `getSocialMigrationsDir`      — path to `vk_social_*.sql` for `vk migrate`.
+ *
+ * Documentation: https://venturekit.dev
+ */
+export { SocialPublishError, SocialAuthError, SocialRateLimitError, SocialValidationError, } from './types.js';
+export { createAdapterRegistry } from './registry.js';
+// ─── Validation helpers ──────────────────────────────────────────────
+export { validatePost, simplifyRatio } from './validation.js';
+// ─── HTTP helper (exposed for adapter authors building their own) ───
+export { vendorFetch } from './http.js';
+// ─── V1 adapters ─────────────────────────────────────────────────────
+export { createLinkedInAdapter, LINKEDIN_CONSTRAINTS, createXAdapter, X_CONSTRAINTS, createFacebookAdapter, FACEBOOK_CONSTRAINTS, createInstagramAdapter, INSTAGRAM_CONSTRAINTS, } from './adapters/index.js';
+// ─── Migrations wiring ───────────────────────────────────────────────
+export { getSocialMigrationsDir } from './path.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,wEAAwE;AACxE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D,uEAAuE;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,wEAAwE;AACxE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAQ7B,wEAAwE;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}