Skip to main content

​
@adrper79-dot/social

Schedule and publish social posts across Twitter/X, LinkedIn, and Instagram. Depends on @adrper79-dot/content.

​
Installation

npm install @adrper79-dot/social

​
Secrets required

wrangler secret put TWITTER_API_KEY
wrangler secret put LINKEDIN_ACCESS_TOKEN

​
API

​
schedulePost(db, opts)

Persists a post to the social_posts table for later publishing. 
function schedulePost(db: Db, opts: {
  appId: string;
  platform: 'twitter' | 'linkedin' | 'instagram';
  content: string;
  mediaUrls?: string[];
  scheduledAt: Date;
  authorId?: string;
}): Promise<SocialPost>;

​
publishPost(post, credentials)

Immediately publishes a SocialPost to the target platform. 
function publishPost(
  post: SocialPost,
  credentials: PlatformCredentials,
): Promise<{ platformPostId: string }>;

​
getScheduledPosts(db, opts)

Returns posts pending publication within a time window. 
function getScheduledPosts(db: Db, opts: {
  appId: string;
  before?: Date;
  platform?: string;
}): Promise<SocialPost[]>;

​
CREATE_SOCIAL_POSTS_TABLE

DDL constant to create the backing table.

​
Example

import { schedulePost } from '@adrper79-dot/social';

await schedulePost(db, {
  appId: 'focusbro',
  platform: 'twitter',
  content: '🎯 New blog post: Getting Started with Deep Focus. Link in bio.',
  scheduledAt: new Date('2026-04-26T09:00:00Z'),
});