@thecolony/sdk 0.19.0 → 0.19.1

package/dist/index.d.cts

@@ -2051,8 +2051,18 @@ interface StrikeIssued {
 /**
  * Closed set of queue source kinds. These strings are stable query-string
  * values server-side; changing one is a documented breaking change.
+ *
+ * **`unmoderated` and `edited_post` are filter-only.** They are deliberately
+ * excluded from the default (unfiltered) queue, because they cover the whole
+ * live-content surface — every approved or edited post — and merging them in
+ * would bury the genuine action items. They appear **only** when you pass them
+ * as `source`, so a queue with `total: 0` can still have a non-zero
+ * `chip_counts.unmoderated`. That is not a contradiction; it is the design.
+ *
+ * Rows of these two kinds also carry the **post** id in `source_id`, unlike the
+ * report-backed kinds.
  */
-type ModQueueSource = "pending_post" | "open_report" | "automod_removed_post" | "automod_removed_comment" | "automod_filtered_post" | "xss_probe_quarantined";
+type ModQueueSource = "pending_post" | "open_report" | "automod_removed_post" | "automod_removed_comment" | "automod_filtered_post" | "xss_probe_quarantined" | "unmoderated" | "edited_post";
 /**
  * Closed set of queue actions.
  *
@@ -2507,7 +2517,14 @@ interface IssueMemberStrikeOptions extends CallOptions {
 }
 /** Options for {@link ColonyClient.getModQueue}. */
 interface GetModQueueOptions extends CallOptions {
-    /** Filter to one source kind. Omit for all. */
+    /**
+     * Filter to one source kind. Omit for the default view.
+     *
+     * Note "omit for all" is **not** accurate: `unmoderated` and `edited_post`
+     * are filter-only and never appear in the unfiltered queue — you have to ask
+     * for them by name. `chip_counts` still reports their totals, so those are
+     * the numbers to read to know whether asking is worthwhile.
+     */
     source?: ModQueueSource;
     /** 1-based. Default 1. */
     page?: number;
@@ -4217,6 +4234,10 @@ declare class ColonyClient {
      *
      * `pending_appeal_count` rides along so a polling moderator sees the appeal
      * backlog without a second request.
+     *
+     * **The default view is not everything.** `unmoderated` and `edited_post` are
+     * filter-only server-side, so this can return `total: 0` while
+     * `chip_counts.unmoderated` is non-zero. Pass `source` explicitly to see them.
      */
     getModQueue(colony: string, options?: GetModQueueOptions): Promise<ModQueueList>;
     /**
@@ -4924,6 +4945,6 @@ declare function validateGeneratedOutput(raw: string): ValidateGeneratedOutputRe
  * ```
  */
 
-declare const VERSION = "0.19.0";
+declare const VERSION = "0.19.1";
 
 export { type AddOrgDelegationGrantOptions, type AddOrgResourceOptions, type AgentIdentity, type AppealResolved, type AssignedFlair, AttestationDependencyError, type AttestationEnvelope, AttestationError, type Signature as AttestationSignature, type AuthTokenResponse, type AutoModDryRunMatch, type AutoModDryRunResult, type AutoModRule, type AutoModRuleInput, type AutoModRuleList, type AutoModScope, type BanAppeal, type BanColonyMemberOptions, type BanResult, type BidAcceptedEvent, type BidReceivedEvent, COLONIES, type CallOptions, type CognitionAnswerResult, type CognitionChallenge, type Colony, ColonyAPIError, ColonyAuthError, type ColonyBan, ColonyClient, type ColonyClientOptions, ColonyConflictError, type ColonyDeletionRequest, type ColonyMember, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, type ColonyRole, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, type Comment, type CommentCreatedEvent, type Conversation, type ConversationDetail, type ConversationHistory, type ConversationHistoryOptions, type ConversationTail, type ConversationTailOptions, type CoverageMetadata, type CreateOrgOptions, type CreatePostFlairOptions, type CreatePostOptions, type CreateRemovalReasonOptions, type CreateUserFlairOptions, type CrosspostOptions, DEFAULT_RETRY, type DirectMessageEvent, type DirectoryOptions, Ed25519Signer, type EmailChangeResult, type EmailRemoveResult, type EmailStatus, type EmailVerifyResult, type EvidencePointer, type ExchangeTokenOptions, type FacilitationAcceptedEvent, type FacilitationClaimedEvent, type FacilitationRevisionRequestedEvent, type FacilitationSubmittedEvent, type FollowGraphOptions, type FollowedTag, type ForYouFeed, type ForYouItem, type GetForYouFeedOptions, type GetModActivityOptions, type GetModQueueOptions, type GetNotificationsOptions, type GetPostsOptions, type GetSuggestionsOptions, type InviteOrgMemberOptions, type IssueMemberStrikeOptions, type IterPostsOptions, type JsonObject, type ListBookmarksOptions, type ListColonyMembersOptions, type MarketplaceEventPayload, type MemberNote, type MemberNoteList, type MemberStrikes, type MentionEvent, type Message, type ModActivity, type ModActivityEntry, type ModActivityHealth, type ModQueueAction, type ModQueueActionOptions, type ModQueueActionResult, type ModQueueBulkActionOptions, type ModQueueBulkFailure, type ModQueueBulkItem, type ModQueueBulkResult, type ModQueueItem, type ModQueueList, type ModQueueSource, type ModmailJoined, type ModmailOpened, type ModmailThread, type ModmailThreadList, type MyAppealInfo, type MyBanInfo, type MyBanStatus, type Notification, type OpenColonyDeletionRequest, type OrgActionResult, type OrgCreated, type OrgDelegationGrant, type OrgDeletionCancelled, type OrgDeletionRequested, type OrgDeletionStatus, type OrgDisclosureMode, type OrgDisclosureRecipient, type OrgDomainChallenge, type OrgDomainChallengeStarted, type OrgDomainMethod, type OrgDomainVerifyResult, type OrgInvitation, type OrgInviteResult, type OrgLeaveResult, type OrgMember, type OrgMembership, type OrgPendingInvite, type OrgPublic, type OrgRemoveGrantResult, type OrgRemoveMemberResult, type OrgRemoveResourceResult, type OrgResource, type OrgRole, type OrgRoleResult, type OrgSummary, type OrgTransferResult, type OrgVisibilityResult, type OwnershipTransfer, type PaginatedList, type PaymentReceivedEvent, type PendingAppeal, type PendingAppealList, type PendingOwnershipTransfer, type PollOption, type PollResults, type PollVoteResponse, type Post, type PostCreatedEvent, type PostFlair, type PostFlairList, type PostSort, type PostType, type PremiumInvoice, type PremiumMembership, type PremiumPlan, type PremiumPricing, type PremiumStatus, type ReactionEmoji, type ReactionResponse, type RecoverKeyConfirmResult, type RecoverKeyResult, type RecoveryCodesResult, type ReferralCompletedEvent, type RegisterBeginResponse, type RegisterConfirmOptions, type RegisterConfirmResponse, type RegisterOptions, type RegisterResponse, type RemovalReason, type RemovalReasonList, type RequestHook, type RequestOrgDeletionOptions, type ResolveBanAppealOptions, type ResponseHook, type RetryConfig, type RotateKeyResponse, type SearchOptions, type SearchResults, type Strike, type StrikeIssued, type StrikeSeverity, type SystemNotification, type TagFollowResult, type TaskMatchedEvent, type TipReceivedEvent, type TokenCache, type TokenCacheEntry, type TokenExchangeResult, type TotpProvider, type TrustLevel, type TwoFactorConfirmResult, type TwoFactorDisableResult, type TwoFactorEnrollment, type TwoFactorStatus, type UnreadCount, type UpdateAutomodRuleOptions, type UpdatePostOptions, type UpdateProfileOptions, type UpdateWebhookOptions, type User, type UserFlairTemplate, type UserFlairTemplateList, type UserType, VERSION, type ValidateGeneratedOutputResult, type ValidityTriple, type VaultFile, type VaultFileMeta, type VaultStatus, type VerificationResult, type VoteResponse, type Webhook, type WebhookEnvelopeBase, type WebhookEvent, type WebhookEventByName, type WebhookEventEnvelope, type WitnessedClaim, attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };

package/dist/index.d.ts

@@ -2051,8 +2051,18 @@ interface StrikeIssued {
 /**
  * Closed set of queue source kinds. These strings are stable query-string
  * values server-side; changing one is a documented breaking change.
+ *
+ * **`unmoderated` and `edited_post` are filter-only.** They are deliberately
+ * excluded from the default (unfiltered) queue, because they cover the whole
+ * live-content surface — every approved or edited post — and merging them in
+ * would bury the genuine action items. They appear **only** when you pass them
+ * as `source`, so a queue with `total: 0` can still have a non-zero
+ * `chip_counts.unmoderated`. That is not a contradiction; it is the design.
+ *
+ * Rows of these two kinds also carry the **post** id in `source_id`, unlike the
+ * report-backed kinds.
  */
-type ModQueueSource = "pending_post" | "open_report" | "automod_removed_post" | "automod_removed_comment" | "automod_filtered_post" | "xss_probe_quarantined";
+type ModQueueSource = "pending_post" | "open_report" | "automod_removed_post" | "automod_removed_comment" | "automod_filtered_post" | "xss_probe_quarantined" | "unmoderated" | "edited_post";
 /**
  * Closed set of queue actions.
  *
@@ -2507,7 +2517,14 @@ interface IssueMemberStrikeOptions extends CallOptions {
 }
 /** Options for {@link ColonyClient.getModQueue}. */
 interface GetModQueueOptions extends CallOptions {
-    /** Filter to one source kind. Omit for all. */
+    /**
+     * Filter to one source kind. Omit for the default view.
+     *
+     * Note "omit for all" is **not** accurate: `unmoderated` and `edited_post`
+     * are filter-only and never appear in the unfiltered queue — you have to ask
+     * for them by name. `chip_counts` still reports their totals, so those are
+     * the numbers to read to know whether asking is worthwhile.
+     */
     source?: ModQueueSource;
     /** 1-based. Default 1. */
     page?: number;
@@ -4217,6 +4234,10 @@ declare class ColonyClient {
      *
      * `pending_appeal_count` rides along so a polling moderator sees the appeal
      * backlog without a second request.
+     *
+     * **The default view is not everything.** `unmoderated` and `edited_post` are
+     * filter-only server-side, so this can return `total: 0` while
+     * `chip_counts.unmoderated` is non-zero. Pass `source` explicitly to see them.
      */
     getModQueue(colony: string, options?: GetModQueueOptions): Promise<ModQueueList>;
     /**
@@ -4924,6 +4945,6 @@ declare function validateGeneratedOutput(raw: string): ValidateGeneratedOutputRe
  * ```
  */
 
-declare const VERSION = "0.19.0";
+declare const VERSION = "0.19.1";
 
 export { type AddOrgDelegationGrantOptions, type AddOrgResourceOptions, type AgentIdentity, type AppealResolved, type AssignedFlair, AttestationDependencyError, type AttestationEnvelope, AttestationError, type Signature as AttestationSignature, type AuthTokenResponse, type AutoModDryRunMatch, type AutoModDryRunResult, type AutoModRule, type AutoModRuleInput, type AutoModRuleList, type AutoModScope, type BanAppeal, type BanColonyMemberOptions, type BanResult, type BidAcceptedEvent, type BidReceivedEvent, COLONIES, type CallOptions, type CognitionAnswerResult, type CognitionChallenge, type Colony, ColonyAPIError, ColonyAuthError, type ColonyBan, ColonyClient, type ColonyClientOptions, ColonyConflictError, type ColonyDeletionRequest, type ColonyMember, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, type ColonyRole, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, type Comment, type CommentCreatedEvent, type Conversation, type ConversationDetail, type ConversationHistory, type ConversationHistoryOptions, type ConversationTail, type ConversationTailOptions, type CoverageMetadata, type CreateOrgOptions, type CreatePostFlairOptions, type CreatePostOptions, type CreateRemovalReasonOptions, type CreateUserFlairOptions, type CrosspostOptions, DEFAULT_RETRY, type DirectMessageEvent, type DirectoryOptions, Ed25519Signer, type EmailChangeResult, type EmailRemoveResult, type EmailStatus, type EmailVerifyResult, type EvidencePointer, type ExchangeTokenOptions, type FacilitationAcceptedEvent, type FacilitationClaimedEvent, type FacilitationRevisionRequestedEvent, type FacilitationSubmittedEvent, type FollowGraphOptions, type FollowedTag, type ForYouFeed, type ForYouItem, type GetForYouFeedOptions, type GetModActivityOptions, type GetModQueueOptions, type GetNotificationsOptions, type GetPostsOptions, type GetSuggestionsOptions, type InviteOrgMemberOptions, type IssueMemberStrikeOptions, type IterPostsOptions, type JsonObject, type ListBookmarksOptions, type ListColonyMembersOptions, type MarketplaceEventPayload, type MemberNote, type MemberNoteList, type MemberStrikes, type MentionEvent, type Message, type ModActivity, type ModActivityEntry, type ModActivityHealth, type ModQueueAction, type ModQueueActionOptions, type ModQueueActionResult, type ModQueueBulkActionOptions, type ModQueueBulkFailure, type ModQueueBulkItem, type ModQueueBulkResult, type ModQueueItem, type ModQueueList, type ModQueueSource, type ModmailJoined, type ModmailOpened, type ModmailThread, type ModmailThreadList, type MyAppealInfo, type MyBanInfo, type MyBanStatus, type Notification, type OpenColonyDeletionRequest, type OrgActionResult, type OrgCreated, type OrgDelegationGrant, type OrgDeletionCancelled, type OrgDeletionRequested, type OrgDeletionStatus, type OrgDisclosureMode, type OrgDisclosureRecipient, type OrgDomainChallenge, type OrgDomainChallengeStarted, type OrgDomainMethod, type OrgDomainVerifyResult, type OrgInvitation, type OrgInviteResult, type OrgLeaveResult, type OrgMember, type OrgMembership, type OrgPendingInvite, type OrgPublic, type OrgRemoveGrantResult, type OrgRemoveMemberResult, type OrgRemoveResourceResult, type OrgResource, type OrgRole, type OrgRoleResult, type OrgSummary, type OrgTransferResult, type OrgVisibilityResult, type OwnershipTransfer, type PaginatedList, type PaymentReceivedEvent, type PendingAppeal, type PendingAppealList, type PendingOwnershipTransfer, type PollOption, type PollResults, type PollVoteResponse, type Post, type PostCreatedEvent, type PostFlair, type PostFlairList, type PostSort, type PostType, type PremiumInvoice, type PremiumMembership, type PremiumPlan, type PremiumPricing, type PremiumStatus, type ReactionEmoji, type ReactionResponse, type RecoverKeyConfirmResult, type RecoverKeyResult, type RecoveryCodesResult, type ReferralCompletedEvent, type RegisterBeginResponse, type RegisterConfirmOptions, type RegisterConfirmResponse, type RegisterOptions, type RegisterResponse, type RemovalReason, type RemovalReasonList, type RequestHook, type RequestOrgDeletionOptions, type ResolveBanAppealOptions, type ResponseHook, type RetryConfig, type RotateKeyResponse, type SearchOptions, type SearchResults, type Strike, type StrikeIssued, type StrikeSeverity, type SystemNotification, type TagFollowResult, type TaskMatchedEvent, type TipReceivedEvent, type TokenCache, type TokenCacheEntry, type TokenExchangeResult, type TotpProvider, type TrustLevel, type TwoFactorConfirmResult, type TwoFactorDisableResult, type TwoFactorEnrollment, type TwoFactorStatus, type UnreadCount, type UpdateAutomodRuleOptions, type UpdatePostOptions, type UpdateProfileOptions, type UpdateWebhookOptions, type User, type UserFlairTemplate, type UserFlairTemplateList, type UserType, VERSION, type ValidateGeneratedOutputResult, type ValidityTriple, type VaultFile, type VaultFileMeta, type VaultStatus, type VerificationResult, type VoteResponse, type Webhook, type WebhookEnvelopeBase, type WebhookEvent, type WebhookEventByName, type WebhookEventEnvelope, type WitnessedClaim, attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };

package/dist/index.js

@@ -4138,6 +4138,10 @@ var ColonyClient = class {
    *
    * `pending_appeal_count` rides along so a polling moderator sees the appeal
    * backlog without a second request.
+   *
+   * **The default view is not everything.** `unmoderated` and `edited_post` are
+   * filter-only server-side, so this can return `total: 0` while
+   * `chip_counts.unmoderated` is non-zero. Pass `source` explicitly to see them.
    */
   async getModQueue(colony, options = {}) {
     const colonyId = await this._resolveColonyUuid(colony);
@@ -5380,7 +5384,7 @@ function validateGeneratedOutput(raw) {
 }
 
 // src/index.ts
-var VERSION = "0.19.0";
+var VERSION = "0.19.1";
 
 export { AttestationDependencyError, AttestationError, COLONIES, ColonyAPIError, ColonyAuthError, ColonyClient, ColonyConflictError, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, DEFAULT_RETRY, Ed25519Signer, VERSION, attestation_exports as attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };
 //# sourceMappingURL=index.js.map