@venturekit-pro/social 0.0.0-dev.20260701100017 → 0.0.1

package/README.md

@@ -23,6 +23,10 @@ calling-app concept. Apps compose those on top.
   retry policies that match the failure mode.
 - **Pre-publish validation** — `validatePost()` enforces per-platform
   body / hashtag / media constraints and surfaces both errors and warnings.
+- **First-comment threads** — set `SocialPost.firstComment` and any adapter
+  whose `constraints.supportsFirstComment` is `true` (LinkedIn, X, Instagram)
+  posts it as a companion comment / reply after the main post. Best-effort:
+  a failed comment never unwinds the already-live post.
 
 ## Wire-up
 

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

@@ -1 +1 @@
-{"version":3,"file":"instagram.d.ts","sourceRoot":"","sources":["../../src/adapters/instagram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAIV,yBAAyB,EAE1B,MAAM,aAAa,CAAC;AAOrB,eAAO,MAAM,qBAAqB,EAAE,yBAiBnC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAClD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,sBAA2B,GAClC,aAAa,CA2Ff"}
+{"version":3,"file":"instagram.d.ts","sourceRoot":"","sources":["../../src/adapters/instagram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAIV,yBAAyB,EAE1B,MAAM,aAAa,CAAC;AAOrB,eAAO,MAAM,qBAAqB,EAAE,yBAiBnC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAClD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,sBAA2B,GAClC,aAAa,CAkGf"}

package/dist/adapters/instagram.js

@@ -94,6 +94,12 @@ export function createInstagramAdapter(config = {}) {
                 throw new Error('[social/instagram] media_publish returned no id; vendor body: ' +
                     publishRes.bodyText.slice(0, 200));
             }
+            // First-comment (commonly used to park the hashtag block off the
+            // caption). Best-effort: the media is already live, so a failed
+            // comment must not unwind the publish.
+            if (post.firstComment && constraints.supportsFirstComment) {
+                await postFirstComment(baseUrl, version, credentials, externalRef, post.firstComment);
+            }
             return {
                 externalRef,
                 // IG doesn't expose a deterministic media-permalink at
@@ -110,4 +116,26 @@ export function createInstagramAdapter(config = {}) {
 function stripIgPrefix(authorRef) {
     return authorRef.startsWith('ig_user_') ? authorRef.slice(8) : authorRef;
 }
+/**
+ * Post a first-comment on a just-published IG media item via the
+ * `/{ig-media-id}/comments` endpoint.
+ *
+ * Best-effort by contract: the media is already live, so a failed
+ * comment must never unwind the publish. Vendor errors are swallowed.
+ */
+async function postFirstComment(baseUrl, version, credentials, mediaId, text) {
+    try {
+        await vendorFetch('instagram', `${baseUrl}/${version}/${encodeURIComponent(mediaId)}/comments`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${credentials.accessToken}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: new URLSearchParams({ message: text }),
+        });
+    }
+    catch {
+        // Swallowed — see doc comment.
+    }
+}
 //# sourceMappingURL=instagram.js.map

package/dist/adapters/instagram.js.map

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

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

@@ -1 +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"}
+{"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,CA+Df"}

package/dist/adapters/linkedin.js

@@ -67,6 +67,11 @@ export function createLinkedInAdapter(config = {}) {
                 // 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));
             }
+            // First-comment companion thread. Best-effort: the post is
+            // already live, so a failed comment must NOT unwind the publish.
+            if (post.firstComment && constraints.supportsFirstComment) {
+                await postFirstComment(baseUrl, credentials, externalRef, post.firstComment);
+            }
             return {
                 externalRef,
                 // The public URL form is `https://www.linkedin.com/feed/update/<urn>`.
@@ -79,6 +84,36 @@ export function createLinkedInAdapter(config = {}) {
         },
     };
 }
+// ─── Internal: first-comment ──────────────────────────────────────────
+/**
+ * Post a first-comment under a freshly-published UGC post via the
+ * `socialActions/{urn}/comments` endpoint. The comment is authored by
+ * the same actor as the post (`credentials.authorRef`).
+ *
+ * Best-effort by contract: the post is already live, so a failed
+ * comment must never unwind a successful publish. We swallow vendor
+ * errors here and let the caller's publish result stand.
+ */
+async function postFirstComment(baseUrl, credentials, postUrn, text) {
+    try {
+        await vendorFetch('linkedin', `${baseUrl}/v2/socialActions/${encodeURIComponent(postUrn)}/comments`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${credentials.accessToken}`,
+                'Content-Type': 'application/json',
+                'X-Restli-Protocol-Version': '2.0.0',
+            },
+            body: JSON.stringify({
+                actor: credentials.authorRef,
+                object: postUrn,
+                message: { text },
+            }),
+        });
+    }
+    catch {
+        // Swallowed — see doc comment.
+    }
+}
 function buildUgcPost(post, credentials) {
     const media = post.media ?? [];
     const hasMedia = media.length > 0;

package/dist/adapters/linkedin.js.map

@@ -1 +1 @@
-{"version":3,"file":"linkedin.js","sourceRoot":"","sources":["../../src/adapters/linkedin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"linkedin.js","sourceRoot":"","sources":["../../src/adapters/linkedin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAA8B;IAC7D,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IAC3D,aAAa,EAAE,CAAC;IAChB,mBAAmB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;IAClD,iBAAiB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,yBAAyB;IAC9D,oBAAoB,EAAE,IAAI;CAC3B,CAAC;AASF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAgC,EAAE;IAElC,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,WAAW,GAA8B;QAC7C,GAAG,oBAAoB;QACvB,GAAG,MAAM,CAAC,WAAW;KACtB,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,UAAU;QACf,WAAW,EAAE,UAAU;QACvB,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,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC7C,MAAM,OAAO,GAA2B;gBACtC,aAAa,EAAE,UAAU,WAAW,CAAC,WAAW,EAAE;gBAClD,cAAc,EAAE,kBAAkB;gBAClC,2BAA2B,EAAE,OAAO;aACrC,CAAC;YACF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,4DAA4D;gBAC5D,2DAA2D;gBAC3D,mDAAmD;gBACnD,iCAAiC;YACnC,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,GAAG,OAAO,cAAc,EAAE;gBAClE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,GAAG,CAAC,IAA8B,CAAC;YAChD,MAAM,WAAW,GAAG,IAAI,EAAE,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;YACvE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,2DAA2D;gBAC3D,sDAAsD;gBACtD,MAAM,IAAI,KAAK,CACb,yDAAyD,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CACvF,CAAC;YACJ,CAAC;YAED,2DAA2D;YAC3D,iEAAiE;YACjE,IAAI,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC,oBAAoB,EAAE,CAAC;gBAC1D,MAAM,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC/E,CAAC;YAED,OAAO;gBACL,WAAW;gBACX,uEAAuE;gBACvE,YAAY,EAAE,wCAAwC,kBAAkB,CAAC,WAAW,CAAC,EAAE;gBACvF,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;AAED,yEAAyE;AAEzE;;;;;;;;GAQG;AACH,KAAK,UAAU,gBAAgB,CAC7B,OAAe,EACf,WAA6B,EAC7B,OAAe,EACf,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,WAAW,CACf,UAAU,EACV,GAAG,OAAO,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,WAAW,EACrE;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,CAAC,WAAW,EAAE;gBAClD,cAAc,EAAE,kBAAkB;gBAClC,2BAA2B,EAAE,OAAO;aACrC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,WAAW,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,EAAE,IAAI,EAAE;aAClB,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC;AAwBD,SAAS,YAAY,CAAC,IAAgB,EAAE,WAA6B;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,MAAM,cAAc,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAEhD,MAAM,IAAI,GAAgB;QACxB,MAAM,EAAE,WAAW,CAAC,SAAS;QAC7B,cAAc,EAAE,WAAW;QAC3B,eAAe,EAAE;YACf,+BAA+B,EAAE;gBAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;gBACpC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;aAC7E;SACF;QACD,UAAU,EAAE,EAAE,0CAA0C,EAAE,QAAQ,EAAE;KACrE,CAAC;IAEF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,eAAe,CAAC,+BAA+B,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9E,MAAM,EAAE,OAAO;YACf,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,gEAAgE;YAChE,4DAA4D;YAC5D,8DAA8D;YAC9D,uCAAuC;YACvC,KAAK,EAAE,CAAC,CAAC,GAAG;SACb,CAAC,CAAC,CAAC;IACN,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,IAAI,CAAC,eAAe,CAAC,+BAA+B,CAAC,CAAC,KAAK,GAAG;YAC5D;gBACE,MAAM,EAAE,OAAO;gBACf,WAAW,EAAE,IAAI,CAAC,IAAK;aACxB;SACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -1 +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"}
+{"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,CAwDzE"}

package/dist/adapters/x.js

@@ -52,6 +52,12 @@ export function createXAdapter(config = {}) {
             if (!externalRef) {
                 throw new Error('[social/x] Publish returned no tweet id; vendor body: ' + res.bodyText.slice(0, 200));
             }
+            // First-comment = a reply tweet threaded under the published one.
+            // Best-effort: the parent is already live, so a failed reply must
+            // not unwind the publish.
+            if (post.firstComment && constraints.supportsFirstComment) {
+                await postReply(baseUrl, credentials, externalRef, post.firstComment);
+            }
             // 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.
@@ -66,6 +72,29 @@ export function createXAdapter(config = {}) {
         },
     };
 }
+/**
+ * Post a reply tweet threaded under a just-published tweet (the X
+ * equivalent of a "first comment").
+ *
+ * Best-effort by contract: the parent tweet is already live, so a
+ * failed reply must never unwind the publish. Vendor errors are
+ * swallowed here.
+ */
+async function postReply(baseUrl, credentials, inReplyToTweetId, text) {
+    try {
+        await vendorFetch('x', `${baseUrl}/2/tweets`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${credentials.accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ text, reply: { in_reply_to_tweet_id: inReplyToTweetId } }),
+        });
+    }
+    catch {
+        // Swallowed — see doc comment.
+    }
+}
 function buildTweetBody(post) {
     const body = { text: post.body };
     const media = post.media ?? [];

package/dist/adapters/x.js.map

@@ -1 +1 @@
-{"version":3,"file":"x.js","sourceRoot":"","sources":["../../src/adapters/x.ts"],"names":[],"mappings":"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"}
+{"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,kEAAkE;YAClE,kEAAkE;YAClE,0BAA0B;YAC1B,IAAI,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC,oBAAoB,EAAE,CAAC;gBAC1D,MAAM,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YACxE,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;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,SAAS,CACtB,OAAe,EACf,WAA6B,EAC7B,gBAAwB,EACxB,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,WAAW,EAAE;YAC5C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,CAAC,WAAW,EAAE;gBAClD,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,EAAE,CAAC;SAClF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,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/catalog/crud.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CRUD over `vk_social_platforms` — the platform-admin-owned catalog.
+ *
+ * Pure SQL against a caller-supplied `Querier`; no `@venturekit/data`
+ * import so the package stays decoupled from the data layer (it's an
+ * optional peer). Consumers pass their `query` / transaction querier in.
+ *
+ * Lifecycle-timestamp convention (matches the LLM model catalog):
+ * flipping `status` into `deprecated` / `disabled` auto-stamps the
+ * matching timestamp; flipping back to `available` clears both.
+ */
+import type { CreateSocialPlatformInput, PatchSocialPlatformInput, Querier, SocialPlatformRow } from './types.js';
+/**
+ * List every catalog row. Ordered by status (available → deprecated →
+ * disabled) so admin pickers show the useful rows up top, then
+ * alphabetically within each group.
+ */
+export declare function listSocialPlatforms(querier: Querier): Promise<SocialPlatformRow[]>;
+/** Fetch one catalog row by its `key` PK, or `null` when absent. */
+export declare function getSocialPlatformByKey(querier: Querier, key: string): Promise<SocialPlatformRow | null>;
+/**
+ * Insert a new catalog row. The `key` PK is DB-enforced; callers map
+ * `23505` to a 409 via `isUniqueViolation`.
+ *
+ * When the row is created already in a `deprecated` / `disabled` state
+ * the matching lifecycle timestamp is auto-stamped to `NOW()` so the
+ * happy path stays one-shot.
+ */
+export declare function createSocialPlatform(querier: Querier, input: CreateSocialPlatformInput): Promise<SocialPlatformRow>;
+/**
+ * Patch any subset of mutable fields. `key` is immutable (it's the PK
+ * and is referenced by `vk_tenant_social_platforms` ON DELETE RESTRICT;
+ * renaming would break those FKs). A status flip stamps / clears the
+ * matching lifecycle timestamp. A no-op patch returns the current row.
+ */
+export declare function patchSocialPlatform(querier: Querier, key: string, patch: PatchSocialPlatformInput): Promise<SocialPlatformRow | null>;
+/**
+ * Delete a catalog row. RESTRICTed by the `vk_tenant_social_platforms`
+ * FK — a row in use by any tenant raises `23503`; callers translate
+ * that to a friendly 409. Returns `true` when a row was removed.
+ */
+export declare function deleteSocialPlatform(querier: Querier, key: string): Promise<boolean>;
+/** True when `err` is a Postgres `unique_violation` (23505). */
+export declare function isUniqueViolation(err: unknown): boolean;
+/**
+ * True when `err` is a Postgres `foreign_key_violation` (23503) — used
+ * to map a delete blocked by `vk_tenant_social_platforms` into a 409.
+ */
+export declare function isForeignKeyViolation(err: unknown): boolean;
+//# sourceMappingURL=crud.d.ts.map

package/dist/catalog/crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/catalog/crud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,OAAO,EACP,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAmBpB;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9B;AAED,oEAAoE;AACpE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAMnC;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAwB5B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAyCnC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAMlB;AAID,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK3D"}

package/dist/catalog/crud.js

@@ -0,0 +1,152 @@
+/**
+ * CRUD over `vk_social_platforms` — the platform-admin-owned catalog.
+ *
+ * Pure SQL against a caller-supplied `Querier`; no `@venturekit/data`
+ * import so the package stays decoupled from the data layer (it's an
+ * optional peer). Consumers pass their `query` / transaction querier in.
+ *
+ * Lifecycle-timestamp convention (matches the LLM model catalog):
+ * flipping `status` into `deprecated` / `disabled` auto-stamps the
+ * matching timestamp; flipping back to `available` clears both.
+ */
+// Shared projection so reads + read-backs return an identical shape
+// regardless of the consumer's mapper config (explicit aliases don't
+// depend on the snake→camel auto-mapper being enabled).
+const PLATFORM_SELECT = `
+  SELECT
+    key,
+    display_name   AS "displayName",
+    status,
+    description,
+    meta,
+    introduced_at  AS "introducedAt",
+    deprecated_at  AS "deprecatedAt",
+    disabled_at    AS "disabledAt",
+    created_at     AS "createdAt",
+    updated_at     AS "updatedAt"
+  FROM vk_social_platforms`;
+/**
+ * List every catalog row. Ordered by status (available → deprecated →
+ * disabled) so admin pickers show the useful rows up top, then
+ * alphabetically within each group.
+ */
+export async function listSocialPlatforms(querier) {
+    return querier(`${PLATFORM_SELECT}
+     ORDER BY
+       CASE status
+         WHEN 'available' THEN 0
+         WHEN 'deprecated' THEN 1
+         WHEN 'disabled' THEN 2
+       END,
+       display_name ASC`);
+}
+/** Fetch one catalog row by its `key` PK, or `null` when absent. */
+export async function getSocialPlatformByKey(querier, key) {
+    const rows = await querier(`${PLATFORM_SELECT} WHERE key = $1 LIMIT 1`, [key]);
+    return rows[0] ?? null;
+}
+/**
+ * Insert a new catalog row. The `key` PK is DB-enforced; callers map
+ * `23505` to a 409 via `isUniqueViolation`.
+ *
+ * When the row is created already in a `deprecated` / `disabled` state
+ * the matching lifecycle timestamp is auto-stamped to `NOW()` so the
+ * happy path stays one-shot.
+ */
+export async function createSocialPlatform(querier, input) {
+    const status = input.status ?? 'available';
+    const deprecatedAt = status === 'deprecated' ? 'NOW()' : 'NULL';
+    const disabledAt = status === 'disabled' ? 'NOW()' : 'NULL';
+    await querier(`INSERT INTO vk_social_platforms
+       (key, display_name, description, status, meta, deprecated_at, disabled_at)
+     VALUES
+       ($1, $2, $3, $4::vk_social_platform_status, $5::jsonb, ${deprecatedAt}, ${disabledAt})`, [
+        input.key,
+        input.displayName,
+        input.description ?? null,
+        status,
+        JSON.stringify(input.meta ?? {}),
+    ]);
+    const row = await getSocialPlatformByKey(querier, input.key);
+    if (!row) {
+        throw new Error(`Insert into vk_social_platforms succeeded but read-back returned null for key=${input.key}`);
+    }
+    return row;
+}
+/**
+ * Patch any subset of mutable fields. `key` is immutable (it's the PK
+ * and is referenced by `vk_tenant_social_platforms` ON DELETE RESTRICT;
+ * renaming would break those FKs). A status flip stamps / clears the
+ * matching lifecycle timestamp. A no-op patch returns the current row.
+ */
+export async function patchSocialPlatform(querier, key, patch) {
+    const sets = [];
+    const params = [];
+    let idx = 1;
+    if (patch.displayName !== undefined) {
+        sets.push(`display_name = $${idx++}`);
+        params.push(patch.displayName);
+    }
+    if (patch.description !== undefined) {
+        sets.push(`description = $${idx++}`);
+        params.push(patch.description);
+    }
+    if (patch.meta !== undefined) {
+        sets.push(`meta = $${idx++}::jsonb`);
+        params.push(JSON.stringify(patch.meta));
+    }
+    if (patch.status !== undefined) {
+        sets.push(`status = $${idx++}::vk_social_platform_status`);
+        params.push(patch.status);
+        if (patch.status === 'deprecated') {
+            sets.push(`deprecated_at = COALESCE(deprecated_at, NOW())`);
+            sets.push(`disabled_at = NULL`);
+        }
+        else if (patch.status === 'disabled') {
+            sets.push(`disabled_at = COALESCE(disabled_at, NOW())`);
+        }
+        else if (patch.status === 'available') {
+            sets.push(`deprecated_at = NULL`);
+            sets.push(`disabled_at = NULL`);
+        }
+    }
+    if (sets.length === 0) {
+        return getSocialPlatformByKey(querier, key);
+    }
+    sets.push(`updated_at = NOW()`);
+    params.push(key);
+    await querier(`UPDATE vk_social_platforms
+        SET ${sets.join(', ')}
+      WHERE key = $${idx}`, params);
+    return getSocialPlatformByKey(querier, key);
+}
+/**
+ * Delete a catalog row. RESTRICTed by the `vk_tenant_social_platforms`
+ * FK — a row in use by any tenant raises `23503`; callers translate
+ * that to a friendly 409. Returns `true` when a row was removed.
+ */
+export async function deleteSocialPlatform(querier, key) {
+    const result = await querier(`DELETE FROM vk_social_platforms WHERE key = $1 RETURNING key`, [key]);
+    return result.length > 0;
+}
+// ─── PG error helpers ───────────────────────────────────────────────
+/** True when `err` is a Postgres `unique_violation` (23505). */
+export function isUniqueViolation(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        if (err.code === '23505')
+            return true;
+    }
+    return false;
+}
+/**
+ * True when `err` is a Postgres `foreign_key_violation` (23503) — used
+ * to map a delete blocked by `vk_tenant_social_platforms` into a 409.
+ */
+export function isForeignKeyViolation(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        if (err.code === '23503')
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=crud.js.map

package/dist/catalog/crud.js.map

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

package/dist/catalog/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `vk_social_platforms` catalog — CRUD + types.
+ *
+ * The platform-admin-owned list of supported social networks. Consuming
+ * apps expose this read-write to their platform admins and read-only to
+ * tenants. Pair with `vk_tenant_social_platforms` (per-tenant enable +
+ * author-ref) which the package also ships.
+ */
+export type { SocialPlatformStatus, SocialPlatformRow, CreateSocialPlatformInput, PatchSocialPlatformInput, Querier, } from './types.js';
+export { listSocialPlatforms, getSocialPlatformByKey, createSocialPlatform, patchSocialPlatform, deleteSocialPlatform, isUniqueViolation, isForeignKeyViolation, } from './crud.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/catalog/index.js

@@ -0,0 +1,10 @@
+/**
+ * `vk_social_platforms` catalog — CRUD + types.
+ *
+ * The platform-admin-owned list of supported social networks. Consuming
+ * apps expose this read-write to their platform admins and read-only to
+ * tenants. Pair with `vk_tenant_social_platforms` (per-tenant enable +
+ * author-ref) which the package also ships.
+ */
+export { listSocialPlatforms, getSocialPlatformByKey, createSocialPlatform, patchSocialPlatform, deleteSocialPlatform, isUniqueViolation, isForeignKeyViolation, } from './crud.js';
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/catalog/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Types for the `vk_social_platforms` catalog CRUD module.
+ *
+ * The catalog is the platform-admin-owned list of every social network
+ * the package supports (schema in `vk_social_0001_init.sql`). One row
+ * per `(provider, adapter version)`. Consuming apps (e.g. the CMS) expose
+ * CRUD over this same table to their platform-admin users; tenants only
+ * enumerate it.
+ */
+/**
+ * Lifecycle status — mirrors the DB enum `vk_social_platform_status`:
+ *   - `available`  — renders in pickers.
+ *   - `deprecated` — still callable, UI nudges a swap.
+ *   - `disabled`   — refuses to publish at the adapter-resolution boundary.
+ */
+export type SocialPlatformStatus = 'available' | 'deprecated' | 'disabled';
+/**
+ * One row of `vk_social_platforms`, post-mapping (snake_case →
+ * camelCase). `meta` is intentionally loose (`Record<string, unknown>`)
+ * — the package documents `{ iconKey, brandColor }` but apps may stamp
+ * extra rendering keys.
+ */
+export interface SocialPlatformRow {
+    key: string;
+    displayName: string;
+    status: SocialPlatformStatus;
+    description: string | null;
+    meta: Record<string, unknown>;
+    introducedAt: Date;
+    deprecatedAt: Date | null;
+    disabledAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateSocialPlatformInput {
+    key: string;
+    displayName: string;
+    description?: string | null;
+    status?: SocialPlatformStatus;
+    meta?: Record<string, unknown>;
+}
+export interface PatchSocialPlatformInput {
+    displayName?: string;
+    description?: string | null;
+    status?: SocialPlatformStatus;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Querier — same shape as the rest of the workspace (`@venturekit/data`'s
+ * `query` / a bound transaction `tx.query`). Declared locally so this
+ * module carries no hard dependency on `@venturekit/data` (it's an
+ * optional peer); the consumer passes their querier in.
+ */
+export type Querier = <T = Record<string, unknown>[]>(sql: string, params?: unknown[]) => Promise<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,YAAY,EAAE,IAAI,CAAC;IACnB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClD,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,KACf,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/catalog/types.js

@@ -0,0 +1,11 @@
+/**
+ * Types for the `vk_social_platforms` catalog CRUD module.
+ *
+ * The catalog is the platform-admin-owned list of every social network
+ * the package supports (schema in `vk_social_0001_init.sql`). One row
+ * per `(provider, adapter version)`. Consuming apps (e.g. the CMS) expose
+ * CRUD over this same table to their platform-admin users; tenants only
+ * enumerate it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/index.d.ts

@@ -10,6 +10,8 @@
  *     `createXAdapter` /
  *     `createFacebookAdapter` /
  *     `createInstagramAdapter`      — v1 adapters.
+ *   - `listSocialPlatforms` / `createSocialPlatform` / …
+ *                                   — CRUD over the `vk_social_platforms` catalog.
  *   - `getSocialMigrationsDir`      — path to `vk_social_*.sql` for `vk migrate`.
  *
  * Documentation: https://venturekit.dev
@@ -24,5 +26,7 @@ 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 { listSocialPlatforms, getSocialPlatformByKey, createSocialPlatform, patchSocialPlatform, deleteSocialPlatform, isUniqueViolation, isForeignKeyViolation, } from './catalog/index.js';
+export type { SocialPlatformStatus, SocialPlatformRow, CreateSocialPlatformInput, PatchSocialPlatformInput, } from './catalog/index.js';
 export { getSocialMigrationsDir } from './path.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;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,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -10,6 +10,8 @@
  *     `createXAdapter` /
  *     `createFacebookAdapter` /
  *     `createInstagramAdapter`      — v1 adapters.
+ *   - `listSocialPlatforms` / `createSocialPlatform` / …
+ *                                   — CRUD over the `vk_social_platforms` catalog.
  *   - `getSocialMigrationsDir`      — path to `vk_social_*.sql` for `vk migrate`.
  *
  * Documentation: https://venturekit.dev
@@ -22,6 +24,8 @@ export { validatePost, simplifyRatio } from './validation.js';
 export { vendorFetch } from './http.js';
 // ─── V1 adapters ─────────────────────────────────────────────────────
 export { createLinkedInAdapter, LINKEDIN_CONSTRAINTS, createXAdapter, X_CONSTRAINTS, createFacebookAdapter, FACEBOOK_CONSTRAINTS, createInstagramAdapter, INSTAGRAM_CONSTRAINTS, } from './adapters/index.js';
+// ─── Platform catalog (vk_social_platforms CRUD) ─────────────────────
+export { listSocialPlatforms, getSocialPlatformByKey, createSocialPlatform, patchSocialPlatform, deleteSocialPlatform, isUniqueViolation, isForeignKeyViolation, } from './catalog/index.js';
 // ─── Migrations wiring ───────────────────────────────────────────────
 export { getSocialMigrationsDir } from './path.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;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,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAQ5B,wEAAwE;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/migrations/vk_social_0001_init.sql

@@ -35,7 +35,7 @@ BEGIN
 END
 $$;
 
-CREATE TABLE IF NOT EXISTS social_platforms (
+CREATE TABLE IF NOT EXISTS vk_social_platforms (
   key            varchar(64)               PRIMARY KEY,
   display_name   varchar(255)              NOT NULL,
   -- Lifecycle: `available` rows render in pickers; `deprecated` ones
@@ -65,9 +65,9 @@ CREATE TABLE IF NOT EXISTS social_platforms (
 -- author ref (the platform-side id we publish into), and optional
 -- vendor metadata.
 
-CREATE TABLE IF NOT EXISTS tenant_social_platforms (
+CREATE TABLE IF NOT EXISTS vk_tenant_social_platforms (
   tenant_id        uuid                     NOT NULL,
-  platform_key     varchar(64)              NOT NULL REFERENCES social_platforms(key) ON DELETE RESTRICT,
+  platform_key     varchar(64)              NOT NULL REFERENCES vk_social_platforms(key) ON DELETE RESTRICT,
   enabled          boolean                  NOT NULL DEFAULT TRUE,
   -- Platform-side identifier this tenant publishes to. URN / page id /
   -- ig user id. Required when enabled = TRUE; the application enforces
@@ -84,7 +84,7 @@ CREATE TABLE IF NOT EXISTS tenant_social_platforms (
 );
 
 CREATE INDEX IF NOT EXISTS tenant_social_platforms_enabled_idx
-  ON tenant_social_platforms (tenant_id)
+  ON vk_tenant_social_platforms (tenant_id)
   WHERE enabled;
 
 -- ─── Catalog seed ───────────────────────────────────────────────────
@@ -93,7 +93,7 @@ CREATE INDEX IF NOT EXISTS tenant_social_platforms_enabled_idx
 -- an already-seeded DB is a no-op. Tenants who want to add custom
 -- adapters (e.g. Mastodon, Bluesky) insert their own row at app boot.
 
-INSERT INTO social_platforms (key, display_name, description, meta) VALUES
+INSERT INTO vk_social_platforms (key, display_name, description, meta) VALUES
   (
     'linkedin',
     'LinkedIn',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venturekit-pro/social",
-  "version": "0.0.0-dev.20260701100017",
+  "version": "0.0.1",
   "description": "Social-platform publishing adapters + catalog for VentureKit applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,10 +55,10 @@
     "publishing"
   ],
   "dependencies": {
-    "@venturekit/core": "0.0.0-dev.20260701100017"
+    "@venturekit/core": "0.0.1"
   },
   "peerDependencies": {
-    "@venturekit/data": "0.0.0-dev.20260701100017"
+    "@venturekit/data": "0.0.1"
   },
   "peerDependenciesMeta": {
     "@venturekit/data": {
@@ -67,7 +67,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@venturekit/data": "0.0.0-dev.20260701100017",
+    "@venturekit/data": "0.0.1",
     "typescript": "^5.3.0"
   },
   "scripts": {

package/src/migrations/vk_social_0001_init.sql

@@ -35,7 +35,7 @@ BEGIN
 END
 $$;
 
-CREATE TABLE IF NOT EXISTS social_platforms (
+CREATE TABLE IF NOT EXISTS vk_social_platforms (
   key            varchar(64)               PRIMARY KEY,
   display_name   varchar(255)              NOT NULL,
   -- Lifecycle: `available` rows render in pickers; `deprecated` ones
@@ -65,9 +65,9 @@ CREATE TABLE IF NOT EXISTS social_platforms (
 -- author ref (the platform-side id we publish into), and optional
 -- vendor metadata.
 
-CREATE TABLE IF NOT EXISTS tenant_social_platforms (
+CREATE TABLE IF NOT EXISTS vk_tenant_social_platforms (
   tenant_id        uuid                     NOT NULL,
-  platform_key     varchar(64)              NOT NULL REFERENCES social_platforms(key) ON DELETE RESTRICT,
+  platform_key     varchar(64)              NOT NULL REFERENCES vk_social_platforms(key) ON DELETE RESTRICT,
   enabled          boolean                  NOT NULL DEFAULT TRUE,
   -- Platform-side identifier this tenant publishes to. URN / page id /
   -- ig user id. Required when enabled = TRUE; the application enforces
@@ -84,7 +84,7 @@ CREATE TABLE IF NOT EXISTS tenant_social_platforms (
 );
 
 CREATE INDEX IF NOT EXISTS tenant_social_platforms_enabled_idx
-  ON tenant_social_platforms (tenant_id)
+  ON vk_tenant_social_platforms (tenant_id)
   WHERE enabled;
 
 -- ─── Catalog seed ───────────────────────────────────────────────────
@@ -93,7 +93,7 @@ CREATE INDEX IF NOT EXISTS tenant_social_platforms_enabled_idx
 -- an already-seeded DB is a no-op. Tenants who want to add custom
 -- adapters (e.g. Mastodon, Bluesky) insert their own row at app boot.
 
-INSERT INTO social_platforms (key, display_name, description, meta) VALUES
+INSERT INTO vk_social_platforms (key, display_name, description, meta) VALUES
   (
     'linkedin',
     'LinkedIn',