yoni56.XSharpSdk 1.0.0

XSharp

XSharp is a .NET 10 Clean Architecture client SDK for the X (formerly Twitter) API v2. It wraps the vast majority of X's public REST surface — Posts, Users, Likes, Reposts, Quotes, Media, Lists, Spaces, Communities, Community Notes, Direct Messages, Webhooks, X Activity, Usage, Stream Connections, Compliance, Articles, Trends and News — behind clean, testable Application-layer interfaces, with a RestSharp + AutoMapper + Autofac powered Infrastructure implementation that talks to api.x.com.

Solution Layout

The solution (XSharp.slnx) follows Clean Architecture with strict inward-facing dependencies:

XSharp.Domain          <-- no dependencies (entities only)
   ^
XSharp.Application      <-- depends on Domain (DTOs + service interfaces)
   ^
XSharp.Infrastructure   <-- depends on Application + Domain (RestSharp clients, AutoMapper, Autofac)
   ^
XSharp.Api              <-- depends on all three (ASP.NET Core host / composition root)

XSharp.Client           <-- depends on Domain + Application + Infrastructure (packable NuGet SDK)

Feature Coverage

Each X API domain is represented by an I*Service interface in XSharp.Application and a matching *Client implementation in XSharp.Infrastructure:

Technology Stack

• .NET 10 / C#
• RestSharp — HTTP transport for all X API calls (XApiRestClientBase)
• AutoMapper — maps wire-format *Dto contracts (XSharp.Infrastructure/Contracts) to Domain entities (XApiMappingProfile)
• Autofac — dependency injection container, wired into the ASP.NET Core host via Autofac.Extensions.DependencyInjection
• OAuth 1.0a (OAuth1Signer) — required for classic chunked media upload endpoints
• OAuth2 Bearer (XApiBearerAuthenticator) — used for all standard /2/... JSON endpoints

Configuration

X API credentials are configured under the XApi section (see XSharp.Api/appsettings.json):

{
  "XApi": {
	"BaseUrl": "https://api.x.com",
	"UploadBaseUrl": "https://upload.twitter.com",
	"BearerToken": "",
	"ConsumerKey": "",
	"ConsumerSecret": "",
	"AccessToken": "",
	"AccessTokenSecret": ""
  }
}

• BearerToken — used for OAuth2 App-only / user-context Bearer authentication on /2/... endpoints.
• ConsumerKey / ConsumerSecret / AccessToken / AccessTokenSecret — used for OAuth 1.0a signing of classic chunked media upload requests (upload.twitter.com).

Building

dotnet build XSharp.slnx

Running the API host

dotnet run --project XSharp.Api\XSharp.Api.csproj

Note: XSharp.Api currently serves as the DI composition root only; add Controllers or Minimal API endpoints under XSharp.Api to expose the registered services over HTTP.

Packing the client SDK

XSharp.Client bundles XSharp.Domain, XSharp.Application and XSharp.Infrastructure into a single NuGet package:

dotnet pack XSharp.Client\XSharp.Client.csproj -c Release

Output: XSharp.Client\bin\Release\XSharp.Client.<version>.nupkg (plus a .snupkg symbol package).

Consuming a Service

All services are resolved via Autofac using their Application-layer interface, e.g.:

public sealed class MyFeature
{
	private readonly IPostsService _posts;

	public MyFeature(IPostsService posts) => _posts = posts;

	public async Task<string> CreateTweetAsync(string text)
	{
		var result = await _posts.CreatePostAsync(new CreatePostRequest(text));
		return result.Id;
	}
}

Project Dependency Graph

XSharp.Domain
   ↑
XSharp.Application
   ↑
XSharp.Infrastructure  ──uses──> RestSharp, AutoMapper, Autofac
   ↑
XSharp.Api  /  XSharp.Client