universal-social-sdk 1.0.0 → 1.0.1

package/.env.test.example

@@ -0,0 +1,46 @@
+# Copy this file to .env.test and fill only sandbox credentials.
+# Tests load .env.test first, then .env as fallback.
+
+# X
+X_API_KEY=
+X_API_SECRET=
+X_ACCESS_TOKEN=
+X_ACCESS_SECRET=
+X_TEST_TWEET_ID=
+
+# Facebook
+FB_PAGE_ACCESS_TOKEN=
+FB_PAGE_ID=
+
+# Instagram
+IG_ACCESS_TOKEN=
+IG_USER_ID=
+
+# LinkedIn
+LINKEDIN_ACCESS_TOKEN=
+LINKEDIN_ORG_URN=
+
+# YouTube
+YOUTUBE_ACCESS_TOKEN=
+YOUTUBE_CHANNEL_ID=
+
+# TikTok
+TIKTOK_ACCESS_TOKEN=
+
+# Pinterest
+PINTEREST_ACCESS_TOKEN=
+PINTEREST_BOARD_ID=
+
+# Bluesky
+BLUESKY_IDENTIFIER=
+BLUESKY_APP_PASSWORD=
+BLUESKY_TEST_ACTOR=
+
+# Mastodon
+MASTODON_BASE_URL=
+MASTODON_ACCESS_TOKEN=
+MASTODON_ACCOUNT_ID=
+
+# Threads
+THREADS_ACCESS_TOKEN=
+THREADS_USER_ID=

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.1] - 2026-03-08
+
+### Added
+
+- Runtime validation for public platform methods.
+- Integration test scaffolding for all supported platforms.
+- Repository governance files (`CODE_OF_CONDUCT.md`, `SECURITY.md`, `LICENSE`).
+- Examples folder with runnable scripts.
+- Package metadata fields (`homepage`, `bugs`, `funding`) in `package.json`.
+
+### Changed
+
+- CI and release workflow gating behavior for clearer run outcomes.
+- Documentation coverage for platform matrix, testing, and project structure.
+
+## [1.0.0] - 2026-03-08
+
+### Added
+
+- Initial public release of `universal-social-sdk`.
+- Unified static async APIs for:
+  - X
+  - Facebook
+  - Instagram
+  - LinkedIn
+  - YouTube
+  - TikTok
+  - Pinterest
+  - Bluesky
+  - Mastodon
+  - Threads
+- CLI:
+  - `universal-social-sdk init`
+  - `universal-social-sdk update`
+- Build + type declarations via TypeScript + tsup.
+- Unit and integration test scaffolding.
+- GitHub Actions CI and npm release automation.
+- Comprehensive setup and usage documentation.

package/README.md

@@ -12,6 +12,7 @@ TypeScript-first, ESM-only, zero-bloat Node.js SDK that provides one unified int
 - [Contributing](./docs/CONTRIBUTING.md)
 - [Code of Conduct](./CODE_OF_CONDUCT.md)
 - [Security Policy](./SECURITY.md)
+- [Changelog](./CHANGELOG.md)
 
 ## Install
 
@@ -46,6 +47,22 @@ await Mastodon.createStatus({ text: "Hello Fediverse!" });
 await Threads.postText({ text: "Hello Threads!" });
 ```
 
+## Examples
+
+Run bundled examples:
+
+```bash
+npm run example:x
+npm run example:instagram
+npm run example:bluesky
+```
+
+Files:
+
+- `examples/x-post.mjs`
+- `examples/instagram-reel.mjs`
+- `examples/bluesky-post.mjs`
+
 ## Required Environment Variables
 
 `universal-social-sdk` auto-loads `.env` with `dotenv`.

package/examples/bluesky-post.mjs

@@ -0,0 +1,14 @@
+import { Bluesky } from "universal-social-sdk";
+
+async function main() {
+  const result = await Bluesky.postText({
+    text: "Hello from universal-social-sdk Bluesky example!"
+  });
+
+  console.log("Bluesky post result:", result);
+}
+
+main().catch((error) => {
+  console.error("Failed to create Bluesky post:", error);
+  process.exit(1);
+});

package/examples/instagram-reel.mjs

@@ -0,0 +1,15 @@
+import { Instagram } from "universal-social-sdk";
+
+async function main() {
+  const result = await Instagram.uploadReel({
+    videoUrl: "https://example.com/reel.mp4",
+    caption: "Hello from universal-social-sdk reel example!"
+  });
+
+  console.log("Instagram reel result:", result);
+}
+
+main().catch((error) => {
+  console.error("Failed to publish reel:", error);
+  process.exit(1);
+});

package/examples/x-post.mjs

@@ -0,0 +1,14 @@
+import { X } from "universal-social-sdk";
+
+async function main() {
+  const result = await X.postTweet({
+    text: "Hello from universal-social-sdk example!"
+  });
+
+  console.log("Tweet result:", result);
+}
+
+main().catch((error) => {
+  console.error("Failed to post tweet:", error);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-social-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "TypeScript-first universal social media SDK for Node.js",
   "type": "module",
   "license": "MIT",
@@ -9,6 +9,14 @@
     "type": "git",
     "url": "https://github.com/Gabo-Tech/universal-social-sdk.git"
   },
+  "homepage": "https://github.com/Gabo-Tech/universal-social-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/Gabo-Tech/universal-social-sdk/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/Gabo-Tech"
+  },
   "keywords": [
     "sdk",
     "social-media",
@@ -35,7 +43,10 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     ".env.example",
+    ".env.test.example",
+    "examples",
     "supported-methods.json"
   ],
   "bin": {
@@ -49,6 +60,9 @@
     "test": "vitest run",
     "test:unit": "vitest run tests/unit",
     "test:integration": "vitest run tests/integration",
+    "example:x": "node examples/x-post.mjs",
+    "example:instagram": "node examples/instagram-reel.mjs",
+    "example:bluesky": "node examples/bluesky-post.mjs",
     "test:watch": "vitest",
     "prepare": "npm run build"
   },
@@ -57,7 +71,7 @@
     "chalk": "^5.4.1",
     "cheerio": "^1.0.0",
     "commander": "^13.1.0",
-    "diff": "^7.0.0",
+    "diff": "^8.0.3",
     "dotenv": "^16.4.7",
     "facebook-nodejs-business-sdk": "^24.0.1",
     "inquirer": "^13.3.0",