@blorp-labs/piefed-api-client 0.0.0-b0dfa6b → 0.0.0-cc3101d

package/README.md

@@ -10,18 +10,70 @@ Includes:
 ## Installation
 
 ```sh
-# .npmrc — point @blorp-labs scope to GitHub Packages
-echo "@blorp-labs:registry=https://npm.pkg.github.com" >> .npmrc
-
 pnpm add @blorp-labs/piefed-api-client
 ```
 
 ## Usage
 
+### Basic
+
+```ts
+import { createClient } from '@blorp-labs/piefed-api-client';
+
+const client = createClient('https://piefed.social');
+const site = await client.getApiAlphaSite();
+```
+
+### With authentication
+
 ```ts
-import { getCommunity, GetCommunityParams } from '@blorp-labs/piefed-api-client';
+const client = createClient('https://piefed.social', {
+  headers: { Authorization: 'Bearer <token>' },
+});
+```
+
+### With default fetch options
+
+Any [`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit) option (except `body` and `method`) can be set as a default:
+
+```ts
+const client = createClient('https://piefed.social', {
+  cache: 'no-store',
+  headers: { Authorization: 'Bearer <token>' },
+});
+```
+
+Per-call options override the defaults; headers are merged.
 
-const community = await getCommunity({ id: 123 });
+### Multiple instances
+
+```ts
+const a = createClient('https://instance-a.com');
+const b = createClient('https://instance-b.com');
+```
+
+### Error handling
+
+Errors throw an `ApiError` with `.status` and `.data`:
+
+```ts
+import { createClient, ApiError } from '@blorp-labs/piefed-api-client';
+
+try {
+  const site = await client.getApiAlphaSite();
+} catch (e) {
+  if (e instanceof ApiError) {
+    console.error(e.status, e.data);
+  }
+}
+```
+
+### Zod schemas
+
+Zod schemas are exported from the `/zod` subpath:
+
+```ts
+import { getApiAlphaSiteQueryParams } from '@blorp-labs/piefed-api-client/zod';
 ```
 
 ## Development
@@ -37,8 +89,7 @@ pnpm build      # compile TypeScript → dist/
 
 ## Automation
 
-A GitHub Actions workflow runs daily and on `workflow_dispatch`. If the OpenAPI spec has changed, it:
-1. Regenerates `src/`
-2. Bumps the patch version
-3. Commits & tags the change
-4. Publishes to GitHub Packages
+A GitHub Actions workflow triggers on every push to `main`. It:
+1. Regenerates `src/` from the live OpenAPI spec
+2. Sets the version to `0.0.0-{commit-sha}`
+3. Builds and publishes to npm

package/dist/create-client.d.ts

@@ -1,232 +1,20 @@
-declare const allFns: {
-    getPostApiAlphaDomainBlockUrl: () => string;
-    postApiAlphaDomainBlock: (domainBlockRequest: import("./schemas").DomainBlockRequest, options?: RequestInit) => Promise<import("./schemas").DomainBlockResponse>;
-    getGetApiAlphaUserUrl: (params?: import("./schemas").GetApiAlphaUserParams) => string;
-    getApiAlphaUser: (params?: import("./schemas").GetApiAlphaUserParams, options?: RequestInit) => Promise<import("./schemas").GetUserResponse>;
-    getGetApiAlphaUserMeUrl: () => string;
-    getApiAlphaUserMe: (options?: RequestInit) => Promise<import("./schemas").UserMeResponse>;
-    getPostApiAlphaUserLoginUrl: () => string;
-    postApiAlphaUserLogin: (userLoginRequest: import("./schemas").UserLoginRequest, options?: RequestInit) => Promise<import("./schemas").UserLoginResponse>;
-    getGetApiAlphaUserUnreadCountUrl: () => string;
-    getApiAlphaUserUnreadCount: (options?: RequestInit) => Promise<import("./schemas").UserUnreadCountsResponse>;
-    getGetApiAlphaUserRepliesUrl: (params?: import("./schemas").GetApiAlphaUserRepliesParams) => string;
-    getApiAlphaUserReplies: (params?: import("./schemas").GetApiAlphaUserRepliesParams, options?: RequestInit) => Promise<import("./schemas").UserRepliesResponse>;
-    getGetApiAlphaUserMentionsUrl: (params?: import("./schemas").GetApiAlphaUserMentionsParams) => string;
-    getApiAlphaUserMentions: (params?: import("./schemas").GetApiAlphaUserMentionsParams, options?: RequestInit) => Promise<import("./schemas").UserMentionsResponse>;
-    getGetApiAlphaUserMediaUrl: (params?: import("./schemas").GetApiAlphaUserMediaParams) => string;
-    getApiAlphaUserMedia: (params?: import("./schemas").GetApiAlphaUserMediaParams, options?: RequestInit) => Promise<import("./schemas").UserMediaResponse>;
-    getPostApiAlphaUserBlockUrl: () => string;
-    postApiAlphaUserBlock: (userBlockRequest: import("./schemas").UserBlockRequest, options?: RequestInit) => Promise<import("./schemas").UserBlockResponse>;
-    getPostApiAlphaUserMarkAllAsReadUrl: () => string;
-    postApiAlphaUserMarkAllAsRead: (options?: RequestInit) => Promise<import("./schemas").UserMarkAllReadResponse>;
-    getPutApiAlphaUserSubscribeUrl: () => string;
-    putApiAlphaUserSubscribe: (userSubscribeRequest: import("./schemas").UserSubscribeRequest, options?: RequestInit) => Promise<import("./schemas").UserSubscribeResponse>;
-    getPutApiAlphaUserSaveUserSettingsUrl: () => string;
-    putApiAlphaUserSaveUserSettings: (userSaveSettingsRequest: import("./schemas").UserSaveSettingsRequest, options?: RequestInit) => Promise<import("./schemas").UserSaveSettingsResponse>;
-    getGetApiAlphaUserNotificationsUrl: (params: import("./schemas").GetApiAlphaUserNotificationsParams) => string;
-    getApiAlphaUserNotifications: (params: import("./schemas").GetApiAlphaUserNotificationsParams, options?: RequestInit) => Promise<import("./schemas").UserNotificationsResponse>;
-    getPutApiAlphaUserNotificationStateUrl: () => string;
-    putApiAlphaUserNotificationState: (userNotificationStateRequest: import("./schemas").UserNotificationStateRequest, options?: RequestInit) => Promise<import("./schemas").UserNotificationItemView>;
-    getGetApiAlphaUserNotificationsCountUrl: () => string;
-    getApiAlphaUserNotificationsCount: (options?: RequestInit) => Promise<import("./schemas").UserNotificationsCountResponse>;
-    getPutApiAlphaUserMarkAllNotificationsReadUrl: () => string;
-    putApiAlphaUserMarkAllNotificationsRead: (options?: RequestInit) => Promise<import("./schemas").UserMarkAllNotifsReadResponse>;
-    getPostApiAlphaUserVerifyCredentialsUrl: () => string;
-    postApiAlphaUserVerifyCredentials: (userLoginRequest: import("./schemas").UserLoginRequest, options?: RequestInit) => Promise<void>;
-    getPostApiAlphaUserSetFlairUrl: () => string;
-    postApiAlphaUserSetFlair: (userSetFlairRequest: import("./schemas").UserSetFlairRequest, options?: RequestInit) => Promise<import("./schemas").UserSetFlairResponse>;
-    getPostApiAlphaUserNoteUrl: () => string;
-    postApiAlphaUserNote: (userSetNoteRequest: import("./schemas").UserSetNoteRequest, options?: RequestInit) => Promise<import("./schemas").UserSetNoteResponse>;
-    getPostApiAlphaUserBanUrl: () => string;
-    postApiAlphaUserBan: (userBanRequest: import("./schemas").UserBanRequest, options?: RequestInit) => Promise<import("./schemas").UserBanResponse>;
-    getPostApiAlphaUserUnbanUrl: () => string;
-    postApiAlphaUserUnban: (userUnbanRequest: import("./schemas").UserUnbanRequest, options?: RequestInit) => Promise<import("./schemas").UserBanResponse>;
-    getPostApiAlphaUploadImageUrl: () => string;
-    postApiAlphaUploadImage: (imageUploadRequest: import("./schemas").ImageUploadRequest, options?: RequestInit) => Promise<import("./schemas").ImageUploadResponse>;
-    getPostApiAlphaUploadCommunityImageUrl: () => string;
-    postApiAlphaUploadCommunityImage: (imageUploadRequest: import("./schemas").ImageUploadRequest, options?: RequestInit) => Promise<import("./schemas").ImageUploadResponse>;
-    getPostApiAlphaUploadUserImageUrl: () => string;
-    postApiAlphaUploadUserImage: (imageUploadRequest: import("./schemas").ImageUploadRequest, options?: RequestInit) => Promise<import("./schemas").ImageUploadResponse>;
-    getPostApiAlphaImageDeleteUrl: () => string;
-    postApiAlphaImageDelete: (imageDeleteRequest: import("./schemas").ImageDeleteRequest, options?: RequestInit) => Promise<import("./schemas").ImageDeleteResponse>;
-    getGetApiAlphaTopicListUrl: (params?: import("./schemas").GetApiAlphaTopicListParams) => string;
-    getApiAlphaTopicList: (params?: import("./schemas").GetApiAlphaTopicListParams, options?: RequestInit) => Promise<import("./schemas").TopicListResponse>;
-    getGetApiAlphaSiteUrl: () => string;
-    getApiAlphaSite: (options?: RequestInit) => Promise<import("./schemas").GetSiteResponse>;
-    getGetApiAlphaSiteVersionUrl: () => string;
-    getApiAlphaSiteVersion: (options?: RequestInit) => Promise<import("./schemas").GetSiteVersionResponse>;
-    getPostApiAlphaSiteBlockUrl: () => string;
-    postApiAlphaSiteBlock: (blockInstanceRequest: import("./schemas").BlockInstanceRequest, options?: RequestInit) => Promise<import("./schemas").BlockInstanceResponse>;
-    getGetApiAlphaSiteInstanceChooserUrl: () => string;
-    getApiAlphaSiteInstanceChooser: (options?: RequestInit) => Promise<import("./schemas").GetSiteInstanceChooserResponse>;
-    getGetApiAlphaSiteInstanceChooserSearchUrl: (params?: import("./schemas").GetApiAlphaSiteInstanceChooserSearchParams) => string;
-    getApiAlphaSiteInstanceChooserSearch: (params?: import("./schemas").GetApiAlphaSiteInstanceChooserSearchParams, options?: RequestInit) => Promise<import("./schemas").GetSiteInstanceChooserSearchResponse>;
-    getGetApiAlphaPrivateMessageListUrl: (params?: import("./schemas").GetApiAlphaPrivateMessageListParams) => string;
-    getApiAlphaPrivateMessageList: (params?: import("./schemas").GetApiAlphaPrivateMessageListParams, options?: RequestInit) => Promise<import("./schemas").ListPrivateMessagesResponse>;
-    getGetApiAlphaPrivateMessageConversationUrl: (params?: import("./schemas").GetApiAlphaPrivateMessageConversationParams) => string;
-    getApiAlphaPrivateMessageConversation: (params?: import("./schemas").GetApiAlphaPrivateMessageConversationParams, options?: RequestInit) => Promise<import("./schemas").GetPrivateMessageConversationResponse>;
-    getPostApiAlphaPrivateMessageConversationLeaveUrl: () => string;
-    postApiAlphaPrivateMessageConversationLeave: (leaveConversationRequest: import("./schemas").LeaveConversationRequest, options?: RequestInit) => Promise<void>;
-    getPostApiAlphaPrivateMessageUrl: () => string;
-    postApiAlphaPrivateMessage: (createPrivateMessageRequest: import("./schemas").CreatePrivateMessageRequest, options?: RequestInit) => Promise<import("./schemas").PrivateMessageResponse>;
-    getPutApiAlphaPrivateMessageUrl: () => string;
-    putApiAlphaPrivateMessage: (editPrivateMessageRequest: import("./schemas").EditPrivateMessageRequest, options?: RequestInit) => Promise<import("./schemas").PrivateMessageResponse>;
-    getPostApiAlphaPrivateMessageMarkAsReadUrl: () => string;
-    postApiAlphaPrivateMessageMarkAsRead: (markPrivateMessageAsReadRequest: import("./schemas").MarkPrivateMessageAsReadRequest, options?: RequestInit) => Promise<import("./schemas").PrivateMessageResponse>;
-    getPostApiAlphaPrivateMessageDeleteUrl: () => string;
-    postApiAlphaPrivateMessageDelete: (deletePrivateMessageRequest: import("./schemas").DeletePrivateMessageRequest, options?: RequestInit) => Promise<import("./schemas").PrivateMessageResponse>;
-    getPostApiAlphaPrivateMessageReportUrl: () => string;
-    postApiAlphaPrivateMessageReport: (reportPrivateMessageRequest: import("./schemas").ReportPrivateMessageRequest, options?: RequestInit) => Promise<import("./schemas").PrivateMessageResponse>;
-    getGetApiAlphaPostListUrl: (params?: import("./schemas").GetApiAlphaPostListParams) => string;
-    getApiAlphaPostList: (// Two instances at the same time:
-    params?: import("./schemas").GetApiAlphaPostListParams, options?: RequestInit) => Promise<import("./schemas").ListPostsResponse>;
-    getGetApiAlphaPostList2Url: (params?: import("./schemas").GetApiAlphaPostList2Params) => string;
-    getApiAlphaPostList2: (params?: import("./schemas").GetApiAlphaPostList2Params, options?: RequestInit) => Promise<import("./schemas").ListPostsResponse>;
-    getGetApiAlphaPostUrl: (params: import("./schemas").GetApiAlphaPostParams) => string;
-    getApiAlphaPost: (params: import("./schemas").GetApiAlphaPostParams, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostUrl: () => string;
-    postApiAlphaPost: (createPostRequest: import("./schemas").CreatePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPutApiAlphaPostUrl: () => string;
-    putApiAlphaPost: (editPostRequest: import("./schemas").EditPostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getGetApiAlphaPostRepliesUrl: (params?: import("./schemas").GetApiAlphaPostRepliesParams) => string;
-    getApiAlphaPostReplies: (params?: import("./schemas").GetApiAlphaPostRepliesParams, options?: RequestInit) => Promise<import("./schemas").GetPostRepliesResponse>;
-    getGetApiAlphaPostSiteMetadataUrl: (params?: import("./schemas").GetApiAlphaPostSiteMetadataParams) => string;
-    getApiAlphaPostSiteMetadata: (params?: import("./schemas").GetApiAlphaPostSiteMetadataParams, options?: RequestInit) => Promise<import("./schemas").GetSiteMetadataResponse>;
-    getPostApiAlphaPostLikeUrl: () => string;
-    postApiAlphaPostLike: (likePostRequest: import("./schemas").LikePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPutApiAlphaPostSaveUrl: () => string;
-    putApiAlphaPostSave: (savePostRequest: import("./schemas").SavePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPutApiAlphaPostSubscribeUrl: () => string;
-    putApiAlphaPostSubscribe: (subscribePostRequest: import("./schemas").SubscribePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostDeleteUrl: () => string;
-    postApiAlphaPostDelete: (deletePostRequest: import("./schemas").DeletePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostReportUrl: () => string;
-    postApiAlphaPostReport: (reportPostRequest: import("./schemas").ReportPostRequest, options?: RequestInit) => Promise<import("./schemas").PostReportResponse>;
-    getPostApiAlphaPostLockUrl: () => string;
-    postApiAlphaPostLock: (lockPostRequest: import("./schemas").LockPostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostHideUrl: () => string;
-    postApiAlphaPostHide: (hidePostRequest: import("./schemas").HidePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostFeatureUrl: () => string;
-    postApiAlphaPostFeature: (featurePostRequest: import("./schemas").FeaturePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostRemoveUrl: () => string;
-    postApiAlphaPostRemove: (removePostRequest: import("./schemas").RemovePostRequest, options?: RequestInit) => Promise<import("./schemas").GetPostResponse>;
-    getPostApiAlphaPostMarkAsReadUrl: () => string;
-    postApiAlphaPostMarkAsRead: (markPostAsReadRequest: import("./schemas").MarkPostAsReadRequest, options?: RequestInit) => Promise<import("./schemas").SuccessResponse>;
-    getGetApiAlphaPostLikeListUrl: (params: import("./schemas").GetApiAlphaPostLikeListParams) => string;
-    getApiAlphaPostLikeList: (params: import("./schemas").GetApiAlphaPostLikeListParams, options?: RequestInit) => Promise<import("./schemas").ListPostLikesResponse>;
-    getPostApiAlphaPostAssignFlairUrl: () => string;
-    postApiAlphaPostAssignFlair: (postSetFlairRequest: import("./schemas").PostSetFlairRequest, options?: RequestInit) => Promise<import("./schemas").PostSetFlairResponse>;
-    getPostApiAlphaPostPollVoteUrl: () => string;
-    postApiAlphaPostPollVote: (pollVoteRequest: import("./schemas").PollVoteRequest, options?: RequestInit) => Promise<import("./schemas").PollVoteResponse>;
-    getGetApiAlphaSearchUrl: (params: import("./schemas").GetApiAlphaSearchParams) => string;
-    getApiAlphaSearch: (params: import("./schemas").GetApiAlphaSearchParams, options?: RequestInit) => Promise<import("./schemas").SearchResponse>;
-    getGetApiAlphaResolveObjectUrl: (params: import("./schemas").GetApiAlphaResolveObjectParams) => string;
-    getApiAlphaResolveObject: (params: import("./schemas").GetApiAlphaResolveObjectParams, // options is always the last argument; inject baseUrl and defaults into it
-    options?: RequestInit) => Promise<import("./schemas").ResolveObjectResponse>;
-    getGetApiAlphaFederatedInstancesUrl: () => string;
-    getApiAlphaFederatedInstances: (options?: RequestInit) => Promise<import("./schemas").GetFederatedInstancesResponse>;
-    getGetApiAlphaSuggestCompletionUrl: (params?: import("./schemas").GetApiAlphaSuggestCompletionParams) => string;
-    getApiAlphaSuggestCompletion: (params?: import("./schemas").GetApiAlphaSuggestCompletionParams, options?: RequestInit) => Promise<import("./schemas").GetSuggestCompletionResponse>;
-    getGetApiAlphaModlogUrl: (params?: import("./schemas").GetApiAlphaModlogParams) => string;
-    getApiAlphaModlog: (params?: import("./schemas").GetApiAlphaModlogParams, options?: RequestInit) => Promise<import("./schemas").GetModLogResponse>;
-    getGetApiAlphaFeedUrl: (params?: import("./schemas").GetApiAlphaFeedParams) => string;
-    getApiAlphaFeed: (params?: import("./schemas").GetApiAlphaFeedParams, options?: RequestInit) => Promise<import("./schemas").FeedView>;
-    getPostApiAlphaFeedUrl: () => string;
-    postApiAlphaFeed: (createFeedRequest: import("./schemas").CreateFeedRequest, options?: RequestInit) => Promise<import("./schemas").FeedView>;
-    getPutApiAlphaFeedUrl: () => string;
-    putApiAlphaFeed: (editFeedRequest: import("./schemas").EditFeedRequest, options?: RequestInit) => Promise<import("./schemas").FeedView>;
-    getGetApiAlphaFeedListUrl: (params?: import("./schemas").GetApiAlphaFeedListParams) => string;
-    getApiAlphaFeedList: (params?: import("./schemas").GetApiAlphaFeedListParams, options?: RequestInit) => Promise<import("./schemas").FeedListResponse>;
-    getPostApiAlphaFeedFollowUrl: () => string;
-    postApiAlphaFeedFollow: (followFeedRequest: import("./schemas").FollowFeedRequest, options?: RequestInit) => Promise<import("./schemas").FeedView>;
-    getPostApiAlphaFeedDeleteUrl: () => string;
-    postApiAlphaFeedDelete: (deleteFeedRequest: import("./schemas").DeleteFeedRequest, options?: RequestInit) => Promise<import("./schemas").FeedView>;
-    getGetApiAlphaCommunityUrl: (params?: import("./schemas").GetApiAlphaCommunityParams) => string;
-    getApiAlphaCommunity: (params?: import("./schemas").GetApiAlphaCommunityParams, options?: RequestInit) => Promise<import("./schemas").GetCommunityResponse>;
-    getPostApiAlphaCommunityUrl: () => string;
-    postApiAlphaCommunity: (createCommunityRequest: import("./schemas").CreateCommunityRequest, options?: RequestInit) => Promise<import("./schemas").CommunityResponse>;
-    getPutApiAlphaCommunityUrl: () => string;
-    putApiAlphaCommunity: (editCommunityRequest: import("./schemas").EditCommunityRequest, options?: RequestInit) => Promise<import("./schemas").CommunityResponse>;
-    getGetApiAlphaCommunityListUrl: (params?: import("./schemas").GetApiAlphaCommunityListParams) => string;
-    getApiAlphaCommunityList: (params?: import("./schemas").GetApiAlphaCommunityListParams, options?: RequestInit) => Promise<import("./schemas").ListCommunitiesResponse>;
-    getPostApiAlphaCommunityFollowUrl: () => string;
-    postApiAlphaCommunityFollow: (followCommunityRequest: import("./schemas").FollowCommunityRequest, options?: RequestInit) => Promise<import("./schemas").CommunityResponse>;
-    getPostApiAlphaCommunityLeaveAllUrl: () => string;
-    postApiAlphaCommunityLeaveAll: (options?: RequestInit) => Promise<import("./schemas").UserMeResponse>;
-    getPostApiAlphaCommunityBlockUrl: () => string;
-    postApiAlphaCommunityBlock: (blockCommunityRequest: import("./schemas").BlockCommunityRequest, options?: RequestInit) => Promise<import("./schemas").BlockCommunityResponse>;
-    getPutApiAlphaCommunitySubscribeUrl: () => string;
-    putApiAlphaCommunitySubscribe: (subscribeCommunityRequest: import("./schemas").SubscribeCommunityRequest, options?: RequestInit) => Promise<import("./schemas").CommunityResponse>;
-    getPostApiAlphaCommunityDeleteUrl: () => string;
-    postApiAlphaCommunityDelete: (deleteCommunityRequest: import("./schemas").DeleteCommunityRequest, options?: RequestInit) => Promise<import("./schemas").CommunityResponse>;
-    getPostApiAlphaCommunityModUrl: () => string;
-    postApiAlphaCommunityMod: (modCommunityRequest: import("./schemas").ModCommunityRequest, options?: RequestInit) => Promise<import("./schemas").ModCommunityResponse>;
-    getGetApiAlphaCommunityModerateBansUrl: (params: import("./schemas").GetApiAlphaCommunityModerateBansParams) => string;
-    getApiAlphaCommunityModerateBans: (params: import("./schemas").GetApiAlphaCommunityModerateBansParams, options?: RequestInit) => Promise<import("./schemas").CommunityModerationBansListResponse>;
-    getPutApiAlphaCommunityModerateUnbanUrl: () => string;
-    putApiAlphaCommunityModerateUnban: (communityModerationUnbanRequest: import("./schemas").CommunityModerationUnbanRequest, options?: RequestInit) => Promise<import("./schemas").CommunityModerationBanItem>;
-    getPostApiAlphaCommunityModerateBanUrl: () => string;
-    postApiAlphaCommunityModerateBan: (communityModerationBanRequest: import("./schemas").CommunityModerationBanRequest, options?: RequestInit) => Promise<import("./schemas").CommunityModerationBanItem>;
-    getPostApiAlphaCommunityModeratePostNsfwUrl: () => string;
-    postApiAlphaCommunityModeratePostNsfw: (communityModerationNsfwRequest: import("./schemas").CommunityModerationNsfwRequest, options?: RequestInit) => Promise<import("./schemas").PostView>;
-    getPostApiAlphaCommunityFlairUrl: () => string;
-    postApiAlphaCommunityFlair: (communityFlairCreateRequest: import("./schemas").CommunityFlairCreateRequest, options?: RequestInit) => Promise<import("./schemas").CommunityFlairCreateResponse>;
-    getPutApiAlphaCommunityFlairUrl: () => string;
-    putApiAlphaCommunityFlair: (communityFlairEditRequest: import("./schemas").CommunityFlairEditRequest, options?: RequestInit) => Promise<import("./schemas").CommunityFlairEditResponse>;
-    getPostApiAlphaCommunityFlairDeleteUrl: () => string;
-    postApiAlphaCommunityFlairDelete: (communityFlairDeleteRequest: import("./schemas").CommunityFlairDeleteRequest, options?: RequestInit) => Promise<import("./schemas").CommunityFlairDeleteResponse>;
-    getGetApiAlphaCommentListUrl: (params?: import("./schemas").GetApiAlphaCommentListParams) => string;
-    getApiAlphaCommentList: (params?: import("./schemas").GetApiAlphaCommentListParams, options?: RequestInit) => Promise<import("./schemas").ListCommentsResponse>;
-    getPostApiAlphaCommentLikeUrl: () => string;
-    postApiAlphaCommentLike: (likeCommentRequest: import("./schemas").LikeCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPutApiAlphaCommentSaveUrl: () => string;
-    putApiAlphaCommentSave: (saveCommentRequest: import("./schemas").SaveCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPutApiAlphaCommentSubscribeUrl: () => string;
-    putApiAlphaCommentSubscribe: (subscribeCommentRequest: import("./schemas").SubscribeCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPostApiAlphaCommentUrl: () => string;
-    postApiAlphaComment: (createCommentRequest: import("./schemas").CreateCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPutApiAlphaCommentUrl: () => string;
-    putApiAlphaComment: (editCommentRequest: import("./schemas").EditCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getGetApiAlphaCommentUrl: (params: import("./schemas").GetApiAlphaCommentParams) => string;
-    getApiAlphaComment: (params: import("./schemas").GetApiAlphaCommentParams, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPostApiAlphaCommentDeleteUrl: () => string;
-    postApiAlphaCommentDelete: (deleteCommentRequest: import("./schemas").DeleteCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPostApiAlphaCommentReportUrl: () => string;
-    postApiAlphaCommentReport: (reportCommentRequest: import("./schemas").ReportCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentReportResponse>;
-    getPostApiAlphaCommentRemoveUrl: () => string;
-    postApiAlphaCommentRemove: (removeCommentRequest: import("./schemas").RemoveCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getPostApiAlphaCommentMarkAsReadUrl: () => string;
-    postApiAlphaCommentMarkAsRead: (markCommentAsReadRequest: import("./schemas").MarkCommentAsReadRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentReplyResponse>;
-    getPostApiAlphaCommentMarkAsAnswerUrl: () => string;
-    postApiAlphaCommentMarkAsAnswer: (markCommentAsAnswerRequest: import("./schemas").MarkCommentAsAnswerRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentReplyResponse>;
-    getPostApiAlphaCommentLockUrl: () => string;
-    postApiAlphaCommentLock: (lockCommentRequest: import("./schemas").LockCommentRequest, options?: RequestInit) => Promise<import("./schemas").GetCommentResponse>;
-    getGetApiAlphaCommentLikeListUrl: (params: import("./schemas").GetApiAlphaCommentLikeListParams) => string;
-    getApiAlphaCommentLikeList: (params: import("./schemas").GetApiAlphaCommentLikeListParams, options?: RequestInit) => Promise<import("./schemas").ListCommentLikesResponse>;
-    getGetApiAlphaAdminRegistrationApplicationListUrl: (params?: import("./schemas").GetApiAlphaAdminRegistrationApplicationListParams) => string;
-    getApiAlphaAdminRegistrationApplicationList: (params?: import("./schemas").GetApiAlphaAdminRegistrationApplicationListParams, options?: RequestInit /**
-     * Create a client bound to a specific PieFed instance.
-     *
-     * @example
-     * const client = createClient('https://piefed.social');
-     * const site = await client.getApiAlphaSite();
-     *
-     * // With auth:
-     * const client = createClient('https://piefed.social', {
-     *   headers: { Authorization: 'Bearer <token>' },
-     * });
-     *
-     * // Two instances at the same time:
-     * const a = createClient('https://instance-a.com');
-     * const b = createClient('https://instance-b.com');
-     */) => Promise<import("./schemas").GetRegistrationListResponse>;
-    getPutApiAlphaAdminRegistrationApplicationApproveUrl: () => string;
-    putApiAlphaAdminRegistrationApplicationApprove: (registrationApproveRequest: import("./schemas").RegistrationApproveRequest, options?: RequestInit) => Promise<void>;
-};
+import * as admin from './client/admin/admin';
+import * as comment from './client/comment/comment';
+import * as community from './client/community/community';
+import * as feed from './client/feed/feed';
+import * as misc from './client/misc/misc';
+import * as post from './client/post/post';
+import * as privateMessage from './client/private-message/private-message';
+import * as site from './client/site/site';
+import * as topic from './client/topic/topic';
+import * as upload from './client/upload/upload';
+import * as user from './client/user/user';
 type AsyncFn = (...args: any[]) => Promise<any>;
-type ApiFunctions = {
-    [K in keyof typeof allFns as (typeof allFns)[K] extends AsyncFn ? K : never]: (typeof allFns)[K];
-};
+type AllModules = typeof admin & typeof comment & typeof community & typeof feed & typeof misc & typeof post & typeof privateMessage & typeof site & typeof topic & typeof upload & typeof user;
+type AsyncKeys = {
+    [K in keyof AllModules]: AllModules[K] extends AsyncFn ? K : never;
+}[keyof AllModules];
+type ApiFunctions = Pick<AllModules, AsyncKeys>;
 interface CreateClientOptions extends Omit<RequestInit, 'body' | 'method'> {
     /** Default headers merged into every request (e.g. Authorization). */
     headers?: Record<string, string>;

package/dist/create-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../src/create-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../src/create-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,SAAS,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,cAAc,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAiB3C,KAAK,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAChD,KAAK,UAAU,GACb,OAAO,KAAK,GAAG,OAAO,OAAO,GAAG,OAAO,SAAS,GAAG,OAAO,IAAI,GAAG,OAAO,IAAI,GAC5E,OAAO,IAAI,GAAG,OAAO,cAAc,GAAG,OAAO,IAAI,GAAG,OAAO,KAAK,GAAG,OAAO,MAAM,GAAG,OAAO,IAAI,CAAC;AACjG,KAAK,SAAS,GAAG;KAAG,CAAC,IAAI,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,UAAU,CAAC,CAAC;AAC1G,KAAK,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEhD,UAAU,mBAAoB,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxE,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA+B7F"}

package/dist/create-client.js

@@ -79,31 +79,23 @@ function createClient(baseUrl, options = {}) {
     for (const [key, fn] of Object.entries(allFns)) {
         if (typeof fn !== 'function')
             continue;
+        // fn.length is the total param count; options is always the last param
+        const optionsIndex = fn.length - 1;
         boundFns[key] = (...args) => {
-            // options is always the last argument; inject baseUrl and defaults into it
-            const last = args[args.length - 1];
+            // Pad args so options index is always reachable
+            while (args.length <= optionsIndex)
+                args.push(undefined);
             const { headers: defaultHeaders, ...defaultInit } = options;
             const extra = { ...defaultInit, baseUrl };
-            if (last !== null && typeof last === 'object' && !Array.isArray(last)) {
-                const lastObj = last;
-                args[args.length - 1] = {
-                    ...extra,
-                    ...lastObj,
-                    // per-call headers win, but default headers fill in any gaps
-                    headers: { ...defaultHeaders, ...lastObj.headers },
-                };
-            }
-            else if (last === undefined || args.length === 0) {
-                if (args.length > 0) {
-                    args[args.length - 1] = { ...extra, headers: defaultHeaders };
-                }
-                else {
-                    args.push({ ...extra, headers: defaultHeaders });
-                }
-            }
-            else {
-                args.push({ ...extra, headers: defaultHeaders });
-            }
+            const existing = args[optionsIndex];
+            args[optionsIndex] = {
+                ...extra,
+                ...existing,
+                headers: {
+                    ...defaultHeaders,
+                    ...existing?.headers,
+                },
+            };
             return fn(...args);
         };
     }

package/dist/create-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../src/create-client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,oCAiCC;AAtFD,4DAA8C;AAC9C,kEAAoD;AACpD,wEAA0D;AAC1D,yDAA2C;AAC3C,yDAA2C;AAC3C,yDAA2C;AAC3C,yFAA2E;AAC3E,yDAA2C;AAC3C,4DAA8C;AAC9C,+DAAiD;AACjD,yDAA2C;AAE3C,MAAM,MAAM,GAAG;IACb,GAAG,KAAK;IACR,GAAG,OAAO;IACV,GAAG,SAAS;IACZ,GAAG,IAAI;IACP,GAAG,IAAI;IACP,GAAG,IAAI;IACP,GAAG,cAAc;IACjB,GAAG,IAAI;IACP,GAAG,KAAK;IACR,GAAG,MAAM;IACT,GAAG,IAAI;CACR,CAAC;AAaF;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY,CAAC,OAAe,EAAE,UAA+B,EAAE;IAC7E,MAAM,QAAQ,GAAG,EAA6B,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,EAAE,KAAK,UAAU;YAAE,SAAS;QAEvC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACrC,2EAA2E;YAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;YAC5D,MAAM,KAAK,GAAsC,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,CAAC;YAC7E,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,MAAM,OAAO,GAAG,IAA0C,CAAC;gBAC3D,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;oBACtB,GAAG,KAAK;oBACR,GAAG,OAAO;oBACV,6DAA6D;oBAC7D,OAAO,EAAE,EAAE,GAAG,cAAc,EAAE,GAAI,OAAO,CAAC,OAA8C,EAAE;iBAC3F,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;gBAChE,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAQ,EAAc,CAAC,GAAG,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,QAAwB,CAAC;AAClC,CAAC"}
+{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../src/create-client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,oCA+BC;AAtFD,4DAA8C;AAC9C,kEAAoD;AACpD,wEAA0D;AAC1D,yDAA2C;AAC3C,yDAA2C;AAC3C,yDAA2C;AAC3C,yFAA2E;AAC3E,yDAA2C;AAC3C,4DAA8C;AAC9C,+DAAiD;AACjD,yDAA2C;AAE3C,MAAM,MAAM,GAAG;IACb,GAAG,KAAK;IACR,GAAG,OAAO;IACV,GAAG,SAAS;IACZ,GAAG,IAAI;IACP,GAAG,IAAI;IACP,GAAG,IAAI;IACP,GAAG,cAAc;IACjB,GAAG,IAAI;IACP,GAAG,KAAK;IACR,GAAG,MAAM;IACT,GAAG,IAAI;CACR,CAAC;AAeF;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY,CAAC,OAAe,EAAE,UAA+B,EAAE;IAC7E,MAAM,QAAQ,GAAG,EAA6B,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,EAAE,KAAK,UAAU;YAAE,SAAS;QAEvC,uEAAuE;QACvE,MAAM,YAAY,GAAI,EAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACrC,gDAAgD;YAChD,OAAO,IAAI,CAAC,MAAM,IAAI,YAAY;gBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAEzD,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;YAC5D,MAAM,KAAK,GAAsC,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,CAAC;YAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAqD,CAAC;YAExF,IAAI,CAAC,YAAY,CAAC,GAAG;gBACnB,GAAG,KAAK;gBACR,GAAG,QAAQ;gBACX,OAAO,EAAE;oBACP,GAAG,cAAc;oBACjB,GAAI,QAAQ,EAAE,OAA8C;iBAC7D;aACF,CAAC;YAEF,OAAQ,EAAc,CAAC,GAAG,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,QAAwB,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { configure, ApiError } from './mutator/custom-fetch';
+export { ApiError } from './mutator/custom-fetch';
 export { createClient } from './create-client';
 export * from './schemas/index';
 export * from './client/admin/admin';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0CAA0C,CAAC;AACzD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0CAA0C,CAAC;AACzD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -14,10 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createClient = exports.ApiError = exports.configure = void 0;
+exports.createClient = exports.ApiError = void 0;
 // Configuration and client factory
 var custom_fetch_1 = require("./mutator/custom-fetch");
-Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return custom_fetch_1.configure; } });
 Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return custom_fetch_1.ApiError; } });
 var create_client_1 = require("./create-client");
 Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return create_client_1.createClient; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAmC;AACnC,uDAA6D;AAApD,yGAAA,SAAS,OAAA;AAAE,wGAAA,QAAQ,OAAA;AAC5B,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,+CAA+C;AAC/C,kDAAgC;AAEhC,0DAA0D;AAC1D,uDAAqC;AACrC,2DAAyC;AACzC,+DAA6C;AAC7C,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,2EAAyD;AACzD,qDAAmC;AACnC,uDAAqC;AACrC,yDAAuC;AACvC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAmC;AACnC,uDAAkD;AAAzC,wGAAA,QAAQ,OAAA;AACjB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,+CAA+C;AAC/C,kDAAgC;AAEhC,0DAA0D;AAC1D,uDAAqC;AACrC,2DAAyC;AACzC,+DAA6C;AAC7C,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,2EAAyD;AACzD,qDAAmC;AACnC,uDAAqC;AACrC,yDAAuC;AACvC,qDAAmC"}

package/dist/mutator/custom-fetch.d.ts

@@ -4,9 +4,6 @@ declare global {
         baseUrl?: string;
     }
 }
-export declare function configure(options: {
-    baseUrl: string;
-}): void;
 export declare class ApiError extends Error {
     readonly status: number;
     readonly data: unknown;

package/dist/mutator/custom-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-fetch.d.ts","sourceRoot":"","sources":["../../src/mutator/custom-fetch.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,2DAA2D;QAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,QAErD;AAED,qBAAa,QAAS,SAAQ,KAAK;aAEf,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;gBADb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO;CAKhC;AAED,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,KAAK,MAAM,EACX,UAAU,WAAW,KACpB,OAAO,CAAC,CAAC,CAaX,CAAC"}
+{"version":3,"file":"custom-fetch.d.ts","sourceRoot":"","sources":["../../src/mutator/custom-fetch.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,2DAA2D;QAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,qBAAa,QAAS,SAAQ,KAAK;aAEf,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;gBADb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO;CAKhC;AAED,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,KAAK,MAAM,EACX,UAAU,WAAW,KACpB,OAAO,CAAC,CAAC,CAcX,CAAC"}

package/dist/mutator/custom-fetch.js

@@ -1,11 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.customFetch = exports.ApiError = void 0;
-exports.configure = configure;
-let _defaultBaseUrl = 'https://piefed.social';
-function configure(options) {
-    _defaultBaseUrl = options.baseUrl.replace(/\/$/, '');
-}
 class ApiError extends Error {
     status;
     data;
@@ -18,7 +13,9 @@ class ApiError extends Error {
 }
 exports.ApiError = ApiError;
 const customFetch = async (url, options) => {
-    const { baseUrl = _defaultBaseUrl, ...fetchOptions } = options ?? {};
+    const { baseUrl, ...fetchOptions } = options ?? {};
+    if (!baseUrl)
+        throw new Error('baseUrl is required — use createClient() to make requests');
     const base = baseUrl.replace(/\/$/, '');
     const res = await fetch(`${base}${url}`, fetchOptions);
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();

package/dist/mutator/custom-fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-fetch.js","sourceRoot":"","sources":["../../src/mutator/custom-fetch.ts"],"names":[],"mappings":";;;AAWA,8BAEC;AAJD,IAAI,eAAe,GAAG,uBAAuB,CAAC;AAE9C,SAAgB,SAAS,CAAC,OAA4B;IACpD,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAa,QAAS,SAAQ,KAAK;IAEf;IACA;IAFlB,YACkB,MAAc,EACd,IAAa;QAE7B,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QAHb,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AARD,4BAQC;AAEM,MAAM,WAAW,GAAG,KAAK,EAC9B,GAAW,EACX,OAAqB,EACT,EAAE;IACd,MAAM,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,IAAS,CAAC;AACnB,CAAC,CAAC;AAhBW,QAAA,WAAW,eAgBtB"}
+{"version":3,"file":"custom-fetch.js","sourceRoot":"","sources":["../../src/mutator/custom-fetch.ts"],"names":[],"mappings":";;;AASA,MAAa,QAAS,SAAQ,KAAK;IAEf;IACA;IAFlB,YACkB,MAAc,EACd,IAAa;QAE7B,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;QAHb,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AARD,4BAQC;AAEM,MAAM,WAAW,GAAG,KAAK,EAC9B,GAAW,EACX,OAAqB,EACT,EAAE;IACd,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,IAAS,CAAC;AACnB,CAAC,CAAC;AAjBW,QAAA,WAAW,eAiBtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blorp-labs/piefed-api-client",
-  "version": "0.0.0-b0dfa6b",
+  "version": "0.0.0-cc3101d",
   "description": "Typed TypeScript client for the PieFed API, generated from the OpenAPI spec",
   "packageManager": "pnpm@10.6.5",
   "main": "./dist/index.js",
@@ -22,14 +22,16 @@
   "scripts": {
     "generate": "orval --config orval.config.ts",
     "build": "tsc",
-    "prepublishOnly": "pnpm build"
+    "prepublishOnly": "pnpm build",
+    "test": "vitest run"
   },
   "dependencies": {
     "zod": "^3.23.8"
   },
   "devDependencies": {
     "orval": "^7.3.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "vitest": "^2.0.0"
   },
   "repository": {
     "type": "git",

package/src/__tests__/create-client.test.ts

@@ -0,0 +1,269 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { createClient } from '../create-client';
+import { ApiError } from '../mutator/custom-fetch';
+
+const BASE_URL = 'https://test.example.com';
+
+function makeResponse(body: unknown, status = 200) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  });
+}
+
+let fetchSpy: ReturnType<typeof vi.fn>;
+
+beforeEach(() => {
+  fetchSpy = vi.fn().mockImplementation(() => Promise.resolve(makeResponse({ ok: true })));
+  vi.stubGlobal('fetch', fetchSpy);
+});
+
+afterEach(() => vi.unstubAllGlobals());
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function lastCall() {
+  return fetchSpy.mock.calls[fetchSpy.mock.calls.length - 1] as [string, RequestInit];
+}
+
+function lastUrl() {
+  return lastCall()[0];
+}
+
+function lastOptions() {
+  return lastCall()[1];
+}
+
+function lastHeaders(): Record<string, string> {
+  return (lastOptions().headers ?? {}) as Record<string, string>;
+}
+
+// ---------------------------------------------------------------------------
+// GET no-params  (fn.length = 1): getApiAlphaSite(options?)
+// ---------------------------------------------------------------------------
+
+describe('getApiAlphaSite — GET, no params', () => {
+  it('forwards default headers', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer tok' },
+    });
+    await client.getApiAlphaSite();
+    expect(lastHeaders()['Authorization']).toBe('Bearer tok');
+  });
+
+  it('merges per-call headers on top of defaults (per-call wins)', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer default', 'X-Custom': 'base' },
+    });
+    await client.getApiAlphaSite({ headers: { Authorization: 'Bearer override' } });
+    expect(lastHeaders()['Authorization']).toBe('Bearer override');
+    expect(lastHeaders()['X-Custom']).toBe('base');
+  });
+
+  it('forwards default RequestInit options (e.g. cache)', async () => {
+    const client = createClient(BASE_URL, { cache: 'no-store' });
+    await client.getApiAlphaSite();
+    expect(lastOptions().cache).toBe('no-store');
+  });
+
+  it('per-call RequestInit options override defaults', async () => {
+    const client = createClient(BASE_URL, { cache: 'no-store' });
+    await client.getApiAlphaSite({ cache: 'force-cache' });
+    expect(lastOptions().cache).toBe('force-cache');
+  });
+
+  it('prepends baseUrl to the path', async () => {
+    const client = createClient(BASE_URL);
+    await client.getApiAlphaSite();
+    expect(lastUrl()).toBe(`${BASE_URL}/api/alpha/site`);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// GET optional-params  (fn.length = 2): getApiAlphaPostList(params?, options?)
+// ---------------------------------------------------------------------------
+
+describe('getApiAlphaPostList — GET, optional params', () => {
+  it('forwards default headers when params are provided', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer tok' },
+    });
+    await client.getApiAlphaPostList({ page: 1 });
+    expect(lastHeaders()['Authorization']).toBe('Bearer tok');
+  });
+
+  it('forwards default headers when params are omitted', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer tok' },
+    });
+    await client.getApiAlphaPostList();
+    expect(lastHeaders()['Authorization']).toBe('Bearer tok');
+  });
+
+  it('merges per-call headers (options as second arg)', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer default' },
+    });
+    await client.getApiAlphaPostList(
+      { page: 1 },
+      { headers: { Authorization: 'Bearer override' } },
+    );
+    expect(lastHeaders()['Authorization']).toBe('Bearer override');
+  });
+
+  it('constructs correct URL with query params', async () => {
+    const client = createClient(BASE_URL);
+    await client.getApiAlphaPostList({ page: 2 });
+    expect(lastUrl()).toContain(`${BASE_URL}/api/alpha/post/list`);
+    expect(lastUrl()).toContain('page=2');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// GET required-params  (fn.length = 2): getApiAlphaPost(params, options?)
+// ---------------------------------------------------------------------------
+
+describe('getApiAlphaPost — GET, required params', () => {
+  const params = { id: 42 };
+
+  it('forwards default headers', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer tok' },
+    });
+    await client.getApiAlphaPost(params);
+    expect(lastHeaders()['Authorization']).toBe('Bearer tok');
+  });
+
+  it('merges per-call headers', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer default' },
+    });
+    await client.getApiAlphaPost(params, { headers: { Authorization: 'Bearer override' } });
+    expect(lastHeaders()['Authorization']).toBe('Bearer override');
+  });
+
+  it('forwards default cache option', async () => {
+    const client = createClient(BASE_URL, { cache: 'no-store' });
+    await client.getApiAlphaPost(params);
+    expect(lastOptions().cache).toBe('no-store');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// POST required-body  (fn.length = 2): postApiAlphaSiteBlock(body, options?)
+// ---------------------------------------------------------------------------
+
+describe('postApiAlphaSiteBlock — POST, required body', () => {
+  const body = { instance: 'spam.example.com', block: true };
+
+  it('sends the body correctly (not corrupted)', async () => {
+    const client = createClient(BASE_URL);
+    await client.postApiAlphaSiteBlock(body);
+    expect(lastOptions().body).toBe(JSON.stringify(body));
+  });
+
+  it('forwards default headers alongside Content-Type', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer tok' },
+    });
+    await client.postApiAlphaSiteBlock(body);
+    expect(lastHeaders()['Authorization']).toBe('Bearer tok');
+    expect(lastHeaders()['Content-Type']).toBe('application/json');
+  });
+
+  it('merges per-call headers without losing body', async () => {
+    const client = createClient(BASE_URL, {
+      headers: { Authorization: 'Bearer default' },
+    });
+    await client.postApiAlphaSiteBlock(body, {
+      headers: { Authorization: 'Bearer override' },
+    });
+    expect(lastHeaders()['Authorization']).toBe('Bearer override');
+    expect(lastOptions().body).toBe(JSON.stringify(body));
+  });
+
+  it('uses POST method', async () => {
+    const client = createClient(BASE_URL);
+    await client.postApiAlphaSiteBlock(body);
+    expect(lastOptions().method).toBe('POST');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Error handling
+// ---------------------------------------------------------------------------
+
+describe('ApiError', () => {
+  it('throws ApiError with correct status and data on 4xx', async () => {
+    fetchSpy.mockImplementation(() => Promise.resolve(makeResponse({ error: 'not found' }, 404)));
+    const client = createClient(BASE_URL);
+
+    await expect(client.getApiAlphaSite()).rejects.toMatchObject({
+      name: 'ApiError',
+      status: 404,
+      data: { error: 'not found' },
+    });
+  });
+
+  it('throws ApiError on 5xx', async () => {
+    fetchSpy.mockImplementation(() => Promise.resolve(makeResponse({ error: 'server error' }, 500)));
+    const client = createClient(BASE_URL);
+
+    const err = await client.getApiAlphaSite().catch((e) => e);
+    expect(err).toBeInstanceOf(ApiError);
+    expect(err.status).toBe(500);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// AbortController
+// ---------------------------------------------------------------------------
+
+describe('AbortController', () => {
+  it('forwards signal to fetch', async () => {
+    const controller = new AbortController();
+    const client = createClient(BASE_URL);
+    await client.getApiAlphaSite({ signal: controller.signal });
+    expect(lastOptions().signal).toBe(controller.signal);
+  });
+
+  it('propagates abort error when signal is already aborted', async () => {
+    const controller = new AbortController();
+    controller.abort();
+    fetchSpy.mockImplementation((_url: string, opts: RequestInit) => {
+      if (opts.signal?.aborted) return Promise.reject(new DOMException('Aborted', 'AbortError'));
+      return Promise.resolve(makeResponse({ ok: true }));
+    });
+    const client = createClient(BASE_URL);
+    const err = await client.getApiAlphaSite({ signal: controller.signal }).catch((e) => e);
+    expect(err.name).toBe('AbortError');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// baseUrl
+// ---------------------------------------------------------------------------
+
+describe('baseUrl construction', () => {
+  it('trims trailing slash from baseUrl', async () => {
+    const client = createClient('https://test.example.com/');
+    await client.getApiAlphaSite();
+    expect(lastUrl()).toBe('https://test.example.com/api/alpha/site');
+  });
+
+  it('different clients use their own baseUrl', async () => {
+    const a = createClient('https://instance-a.com');
+    const b = createClient('https://instance-b.com');
+
+    await a.getApiAlphaSite();
+    const urlA = lastUrl();
+
+    await b.getApiAlphaSite();
+    const urlB = lastUrl();
+
+    expect(urlA).toBe('https://instance-a.com/api/alpha/site');
+    expect(urlB).toBe('https://instance-b.com/api/alpha/site');
+  });
+});

package/src/create-client.ts

@@ -26,9 +26,11 @@ const allFns = {
 
 // Only the async API functions (not URL helpers or type exports)
 type AsyncFn = (...args: any[]) => Promise<any>;
-type ApiFunctions = {
-  [K in keyof typeof allFns as (typeof allFns)[K] extends AsyncFn ? K : never]: (typeof allFns)[K];
-};
+type AllModules =
+  typeof admin & typeof comment & typeof community & typeof feed & typeof misc &
+  typeof post & typeof privateMessage & typeof site & typeof topic & typeof upload & typeof user;
+type AsyncKeys = { [K in keyof AllModules]: AllModules[K] extends AsyncFn ? K : never }[keyof AllModules];
+type ApiFunctions = Pick<AllModules, AsyncKeys>;
 
 interface CreateClientOptions extends Omit<RequestInit, 'body' | 'method'> {
   /** Default headers merged into every request (e.g. Authorization). */
@@ -57,28 +59,26 @@ export function createClient(baseUrl: string, options: CreateClientOptions = {})
   for (const [key, fn] of Object.entries(allFns)) {
     if (typeof fn !== 'function') continue;
 
+    // fn.length is the total param count; options is always the last param
+    const optionsIndex = (fn as AsyncFn).length - 1;
+
     boundFns[key] = (...args: unknown[]) => {
-      // options is always the last argument; inject baseUrl and defaults into it
-      const last = args[args.length - 1];
+      // Pad args so options index is always reachable
+      while (args.length <= optionsIndex) args.push(undefined);
+
       const { headers: defaultHeaders, ...defaultInit } = options;
       const extra: RequestInit & { baseUrl: string } = { ...defaultInit, baseUrl };
-      if (last !== null && typeof last === 'object' && !Array.isArray(last)) {
-        const lastObj = last as RequestInit & { baseUrl?: string };
-        args[args.length - 1] = {
-          ...extra,
-          ...lastObj,
-          // per-call headers win, but default headers fill in any gaps
-          headers: { ...defaultHeaders, ...(lastObj.headers as Record<string, string> | undefined) },
-        };
-      } else if (last === undefined || args.length === 0) {
-        if (args.length > 0) {
-          args[args.length - 1] = { ...extra, headers: defaultHeaders };
-        } else {
-          args.push({ ...extra, headers: defaultHeaders });
-        }
-      } else {
-        args.push({ ...extra, headers: defaultHeaders });
-      }
+      const existing = args[optionsIndex] as (RequestInit & { baseUrl?: string }) | undefined;
+
+      args[optionsIndex] = {
+        ...extra,
+        ...existing,
+        headers: {
+          ...defaultHeaders,
+          ...(existing?.headers as Record<string, string> | undefined),
+        },
+      };
+
       return (fn as AsyncFn)(...args);
     };
   }

package/src/index.ts

@@ -1,5 +1,5 @@
 // Configuration and client factory
-export { configure, ApiError } from './mutator/custom-fetch';
+export { ApiError } from './mutator/custom-fetch';
 export { createClient } from './create-client';
 
 // Re-export generated TypeScript types/schemas

package/src/mutator/custom-fetch.ts

@@ -7,12 +7,6 @@ declare global {
   }
 }
 
-let _defaultBaseUrl = 'https://piefed.social';
-
-export function configure(options: { baseUrl: string }) {
-  _defaultBaseUrl = options.baseUrl.replace(/\/$/, '');
-}
-
 export class ApiError extends Error {
   constructor(
     public readonly status: number,
@@ -27,7 +21,8 @@ export const customFetch = async <T>(
   url: string,
   options?: RequestInit,
 ): Promise<T> => {
-  const { baseUrl = _defaultBaseUrl, ...fetchOptions } = options ?? {};
+  const { baseUrl, ...fetchOptions } = options ?? {};
+  if (!baseUrl) throw new Error('baseUrl is required — use createClient() to make requests');
   const base = baseUrl.replace(/\/$/, '');
 
   const res = await fetch(`${base}${url}`, fetchOptions);