@hasna/connectors 1.3.36 → 1.3.38

package/dist/.types/src/social/http.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared, bundle-safe HTTP helper for the stateless social adapters.
+ *
+ * Provides an injectable `FetchLike` (so tests can mock the network) and a small
+ * JSON request helper. Uses only `globalThis.fetch` / `URLSearchParams` / `Buffer`
+ * — NO `node:fs`, NO `child_process`, NO db/runner/storage imports.
+ */
+/** Injectable fetch so tests can mock the network without real I/O. */
+export type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText?: string;
+    /** Present on real fetch Responses; some adapters (e.g. resumable uploads) read it. */
+    headers?: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}>;
+export declare function resolveFetch(fetchImpl?: FetchLike): FetchLike;
+export interface JsonRequestOptions {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined | null>;
+    /** Override how the error message is extracted from a parsed error body. */
+    errorLabel?: string;
+}
+/**
+ * Perform a JSON request and parse the response. Throws on non-2xx with a useful
+ * message. `body` is JSON-serialized for non-GET requests unless it is already a
+ * string or FormData.
+ */
+export declare function jsonRequest<T>(fetchImpl: FetchLike, url: string, options?: JsonRequestOptions): Promise<T>;

package/dist/.types/src/social/index.d.ts

@@ -0,0 +1,16 @@
+export { ConnectorOperationNotSupported } from "./errors";
+export type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionItem, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialConnectorSlug, SocialOperation, } from "./types";
+export interface RunSocialOperationArgs {
+    connector: string;
+    operation: string;
+    input?: Record<string, unknown>;
+    credentials?: Record<string, unknown>;
+}
+/** List the social connector slugs supported by this SDK. */
+export declare function listSocialConnectors(): string[];
+/** List the normalized operations a connector implements. */
+export declare function getSocialOperations(connector: string): string[];
+/**
+ * Execute one normalized social operation. Stateless: all credentials are passed in.
+ */
+export declare function runSocialOperation(args: RunSocialOperationArgs): Promise<unknown>;

package/dist/.types/src/social/linkedin.d.ts

@@ -0,0 +1,29 @@
+import { type FetchLike } from "./http";
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+export interface LinkedInCredentials {
+    accessToken: string;
+    /** Author URN, e.g. "urn:li:person:abc123". Resolved from /me if omitted. */
+    authorUrn?: string;
+    baseUrl?: string;
+}
+/** LinkedIn `post.create` extras. */
+export interface LinkedInPostExtras {
+    /** Visibility: PUBLIC (default) or CONNECTIONS. */
+    visibility?: "PUBLIC" | "CONNECTIONS";
+}
+export declare class LinkedInAdapter implements SocialAdapter {
+    private readonly accessToken;
+    private readonly baseUrl;
+    private authorUrn?;
+    private readonly fetchImpl;
+    constructor(creds: LinkedInCredentials, fetchImpl?: FetchLike);
+    static fromCredentials(creds: LinkedInCredentials, fetchImpl?: FetchLike): LinkedInAdapter;
+    private headers;
+    private resolveAuthorUrn;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput & LinkedInPostExtras): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput): Promise<MediaUploadResult>;
+    mentionsList(_input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(_input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/mastodon.d.ts

@@ -0,0 +1,32 @@
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+/** Injectable fetch so tests can mock the network. */
+export type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText?: string;
+    text(): Promise<string>;
+}>;
+export interface MastodonCredentials {
+    accessToken: string;
+    baseUrl: string;
+}
+export declare class MastodonAdapter implements SocialAdapter {
+    private readonly accessToken;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(creds: MastodonCredentials, fetchImpl?: FetchLike);
+    static fromCredentials(creds: MastodonCredentials, fetchImpl?: FetchLike): MastodonAdapter;
+    private call;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput): Promise<{
+        mediaId: string;
+    }>;
+    mentionsList(input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/pinterest.d.ts

@@ -0,0 +1,31 @@
+import { type FetchLike } from "./http";
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+export interface PinterestCredentials {
+    accessToken: string;
+    boardId?: string;
+}
+/** Pinterest `post.create` extras. A pin needs an image: a mediaId or an imageUrl. */
+export interface PinterestPostExtras {
+    /** Board to pin to (REQUIRED unless provided via credentials). */
+    boardId?: string;
+    /** Public image URL (used when no uploaded mediaId is supplied). */
+    imageUrl?: string;
+    /** Destination link for the pin. */
+    link?: string;
+    /** Pin title (defaults to undefined; `text` becomes the description). */
+    title?: string;
+}
+export declare class PinterestAdapter implements SocialAdapter {
+    private readonly accessToken;
+    private readonly defaultBoardId?;
+    private readonly fetchImpl;
+    constructor(creds: PinterestCredentials, fetchImpl?: FetchLike);
+    static fromCredentials(creds: PinterestCredentials, fetchImpl?: FetchLike): PinterestAdapter;
+    private headers;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput & PinterestPostExtras): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput): Promise<MediaUploadResult>;
+    mentionsList(_input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/reddit.d.ts

@@ -0,0 +1,31 @@
+import { type FetchLike } from "./http";
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+export interface RedditCredentials {
+    accessToken: string;
+    userAgent?: string;
+}
+/** Reddit `post.create` extras (title + subreddit are required). */
+export interface RedditPostExtras {
+    title: string;
+    subreddit: string;
+    /** "self" (text post, default) or "link" (url post). */
+    kind?: "self" | "link";
+    /** URL for a `kind: "link"` post. */
+    url?: string;
+}
+export declare class RedditAdapter implements SocialAdapter {
+    private readonly accessToken;
+    private readonly userAgent;
+    private readonly fetchImpl;
+    constructor(creds: RedditCredentials, fetchImpl?: FetchLike);
+    static fromCredentials(creds: RedditCredentials, fetchImpl?: FetchLike): RedditAdapter;
+    private headers;
+    /** Reddit form endpoints want application/x-www-form-urlencoded. */
+    private form;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput & Partial<RedditPostExtras>): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(_input: MediaUploadInput): Promise<MediaUploadResult>;
+    mentionsList(input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/tiktok.d.ts

@@ -0,0 +1,24 @@
+import { type FetchLike } from "./http";
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+export interface TikTokCredentials {
+    accessToken: string;
+    openId?: string;
+}
+/** TikTok `post.create` extras. */
+export interface TikTokPostExtras {
+    /** PUBLIC_TO_EVERYONE (default), MUTUAL_FOLLOW_FRIENDS, SELF_ONLY. */
+    privacyLevel?: string;
+}
+export declare class TikTokAdapter implements SocialAdapter {
+    private readonly accessToken;
+    private readonly fetchImpl;
+    constructor(creds: TikTokCredentials, fetchImpl?: FetchLike);
+    static fromCredentials(creds: TikTokCredentials, fetchImpl?: FetchLike): TikTokAdapter;
+    private headers;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput & TikTokPostExtras): Promise<PostCreateResult>;
+    postDelete(_input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput): Promise<MediaUploadResult>;
+    mentionsList(_input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(_input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Normalized, network-agnostic types for the stateless social transport SDK.
+ *
+ * These types are intentionally self-contained: the public `@hasna/connectors/social`
+ * surface must NOT leak connector-internal types. Everything here is plain data so the
+ * entry point stays bundle-safe (no fs/db/runner imports).
+ */
+/** Slugs supported by this deliverable. */
+export type SocialConnectorSlug = "x" | "mastodon" | "bluesky" | "linkedin" | "reddit" | "tiktok" | "youtube" | "pinterest" | "googlebusinessprofile";
+/** Normalized operation names. */
+export type SocialOperation = "account.me" | "post.create" | "post.delete" | "media.upload" | "mentions.list" | "analytics.post";
+export interface AccountMeResult {
+    id: string;
+    username?: string;
+    displayName?: string;
+    url?: string;
+}
+export interface PostCreateInput {
+    text: string;
+    replyToId?: string;
+    mediaIds?: string[];
+    /**
+     * Network-specific extras (e.g. reddit `title`/`subreddit`, pinterest `boardId`,
+     * googlebusinessprofile `accountId`/`locationId`). Each adapter reads the ones it
+     * needs; see each adapter's `*PostExtras` interface.
+     */
+    [key: string]: unknown;
+}
+export interface PostCreateResult {
+    id: string;
+    url?: string;
+}
+export interface PostDeleteInput {
+    id: string;
+}
+export interface PostDeleteResult {
+    id: string;
+    deleted: boolean;
+}
+export interface MediaUploadInput {
+    dataBase64: string;
+    mimeType: string;
+    altText?: string;
+}
+export interface MediaUploadResult {
+    mediaId: string;
+}
+export interface MentionsListInput {
+    sinceId?: string;
+    limit?: number;
+}
+export interface MentionItem {
+    id: string;
+    text: string;
+    authorId?: string;
+    authorHandle?: string;
+    createdAt?: string;
+}
+export interface MentionsListResult {
+    items: MentionItem[];
+}
+export interface AnalyticsPostInput {
+    id: string;
+}
+export interface AnalyticsPostResult {
+    metrics: Record<string, number>;
+}
+/**
+ * A connector adapter: maps each normalized operation onto a network's transport.
+ * Credentials are caller-owned and passed in per construction — no local storage.
+ */
+export interface SocialAdapter {
+    accountMe(input?: Record<string, unknown>): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput): Promise<MediaUploadResult>;
+    mentionsList(input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Decode a base64 string into a Buffer. Uses the global `Buffer` (available in
+ * Bun and Node) — no `node:fs`, so this stays bundle-safe.
+ */
+export declare function decodeBase64(dataBase64: string): Buffer;

package/dist/.types/src/social/x.d.ts

@@ -0,0 +1,82 @@
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+/** Minimal structural type for the X transport so tests can inject a mock. */
+export interface XTransport {
+    tweets: {
+        create(opts: {
+            text: string;
+            replyToTweetId?: string;
+            mediaIds?: string[];
+        }): Promise<{
+            data: {
+                id: string;
+                text: string;
+            };
+        }>;
+        delete(id: string): Promise<{
+            data: {
+                deleted: boolean;
+            };
+        }>;
+        get(id: string, options?: unknown): Promise<{
+            data: {
+                id: string;
+                public_metrics?: Record<string, number>;
+            };
+        }>;
+        getUserMentions(userId: string, options?: unknown): Promise<{
+            data: Array<{
+                id: string;
+                text: string;
+                author_id?: string;
+                created_at?: string;
+            }>;
+            includes?: {
+                users?: Array<{
+                    id: string;
+                    username: string;
+                }>;
+            };
+        }>;
+    };
+    users: {
+        me(): Promise<{
+            data: {
+                id: string;
+                username: string;
+                name?: string;
+            };
+        }>;
+    };
+    media?: {
+        uploadBuffer(data: Buffer, mimeType: string, options?: {
+            altText?: string;
+        }): Promise<{
+            media_id_string: string;
+        }>;
+    };
+}
+export interface XCredentials {
+    apiKey: string;
+    apiSecret: string;
+    accessToken?: string;
+    refreshToken?: string;
+    bearerToken?: string;
+    oauth1AccessToken?: string;
+    oauth1AccessTokenSecret?: string;
+    clientId?: string;
+    clientSecret?: string;
+}
+export declare class XAdapter implements SocialAdapter {
+    private readonly x;
+    /** Cached authenticated user (id + username) to build URLs / mentions. */
+    private me?;
+    constructor(x: XTransport);
+    static fromCredentials(creds: XCredentials): XAdapter;
+    private resolveMe;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput): Promise<MediaUploadResult>;
+    mentionsList(input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/.types/src/social/youtube.d.ts

@@ -0,0 +1,29 @@
+import { type FetchLike } from "./http";
+import type { AccountMeResult, AnalyticsPostInput, AnalyticsPostResult, MediaUploadInput, MediaUploadResult, MentionsListInput, MentionsListResult, PostCreateInput, PostCreateResult, PostDeleteInput, PostDeleteResult, SocialAdapter } from "./types";
+export interface YouTubeCredentials {
+    accessToken: string;
+    refreshToken?: string;
+    clientId?: string;
+    clientSecret?: string;
+}
+/** YouTube `post.create` extras. */
+export interface YouTubePostExtras {
+    title?: string;
+    description?: string;
+    privacyStatus?: "public" | "private" | "unlisted";
+    /** Numeric category id (default "22" = People & Blogs). */
+    categoryId?: string;
+}
+export declare class YouTubeAdapter implements SocialAdapter {
+    private readonly accessToken;
+    private readonly fetchImpl;
+    constructor(creds: YouTubeCredentials, fetchImpl?: FetchLike);
+    static fromCredentials(creds: YouTubeCredentials, fetchImpl?: FetchLike): YouTubeAdapter;
+    private headers;
+    accountMe(): Promise<AccountMeResult>;
+    postCreate(input: PostCreateInput & YouTubePostExtras): Promise<PostCreateResult>;
+    postDelete(input: PostDeleteInput): Promise<PostDeleteResult>;
+    mediaUpload(input: MediaUploadInput & YouTubePostExtras): Promise<MediaUploadResult>;
+    mentionsList(_input?: MentionsListInput): Promise<MentionsListResult>;
+    analyticsPost(input: AnalyticsPostInput): Promise<AnalyticsPostResult>;
+}

package/dist/cli/components/App.d.ts

@@ -1,7 +1,6 @@
-import React from "react";
 interface AppProps {
     initialConnectors?: string[];
     overwrite?: boolean;
 }
-export declare function App({ initialConnectors, overwrite }: AppProps): React.JSX.Element;
+export declare function App({ initialConnectors, overwrite }: AppProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/cli/components/CategorySelect.d.ts

@@ -1,7 +1,6 @@
-import React from "react";
 interface CategorySelectProps {
     onSelect: (category: string) => void;
     onBack?: () => void;
 }
-export declare function CategorySelect({ onSelect, onBack }: CategorySelectProps): React.JSX.Element;
+export declare function CategorySelect({ onSelect, onBack }: CategorySelectProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/cli/components/ConnectorSelect.d.ts

@@ -1,4 +1,3 @@
-import React from "react";
 import { ConnectorMeta } from "../../lib/registry.js";
 interface ConnectorSelectProps {
     connectors: ConnectorMeta[];
@@ -7,5 +6,5 @@ interface ConnectorSelectProps {
     onConfirm: () => void;
     onBack: () => void;
 }
-export declare function ConnectorSelect({ connectors, selected, onToggle, onConfirm, onBack, }: ConnectorSelectProps): React.JSX.Element;
+export declare function ConnectorSelect({ connectors, selected, onToggle, onConfirm, onBack, }: ConnectorSelectProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/cli/components/Header.d.ts

@@ -1,7 +1,6 @@
-import React from "react";
 interface HeaderProps {
     title?: string;
     subtitle?: string;
 }
-export declare function Header({ title, subtitle }: HeaderProps): React.JSX.Element;
+export declare function Header({ title, subtitle }: HeaderProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/cli/components/InstallProgress.d.ts

@@ -1,9 +1,8 @@
-import React from "react";
 import { InstallResult } from "../../lib/installer.js";
 interface InstallProgressProps {
     connectors: string[];
     overwrite?: boolean;
     onComplete: (results: InstallResult[]) => void;
 }
-export declare function InstallProgress({ connectors, overwrite, onComplete, }: InstallProgressProps): React.JSX.Element;
+export declare function InstallProgress({ connectors, overwrite, onComplete, }: InstallProgressProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/cli/components/SearchView.d.ts

@@ -1,9 +1,8 @@
-import React from "react";
 interface SearchViewProps {
     selected: Set<string>;
     onToggle: (name: string) => void;
     onConfirm: () => void;
     onBack: () => void;
 }
-export declare function SearchView({ selected, onToggle, onConfirm, onBack, }: SearchViewProps): React.JSX.Element;
+export declare function SearchView({ selected, onToggle, onConfirm, onBack, }: SearchViewProps): import("react/jsx-runtime").JSX.Element;
 export {};