@hasna/connectors 1.3.35 → 1.3.37

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/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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";
+/** 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[];
+}
+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/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 {};