@atcute/bluesky 3.2.5 → 3.2.6

package/lib/lexicons/types/app/bsky/notification/listNotifications.ts

@@ -7,11 +7,19 @@ import * as ComAtprotoLabelDefs from '@atcute/atproto/types/label/defs';
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.notification.listNotifications', {
 	params: /*#__PURE__*/ v.object({
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 50
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			50,
 		),
 		priority: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean()),
+		/**
+		 * Notification reasons to include in response.
+		 */
 		reasons: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.array(/*#__PURE__*/ v.string())),
 		seenAt: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.datetimeString()),
 	}),
@@ -40,6 +48,9 @@ const _notificationSchema = /*#__PURE__*/ v.object({
 	get labels() {
 		return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.array(ComAtprotoLabelDefs.labelSchema));
 	},
+	/**
+	 * The reason why this notification was delivered - e.g. your post was liked, or you received a new follower.
+	 */
 	reason: /*#__PURE__*/ v.string<
 		| 'follow'
 		| 'like'

package/lib/lexicons/types/app/bsky/notification/registerPush.ts

@@ -7,6 +7,9 @@ const _mainSchema = /*#__PURE__*/ v.procedure('app.bsky.notification.registerPus
 	input: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
+			/**
+			 * Set to true when the actor is age restricted
+			 */
 			ageRestricted: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean()),
 			appId: /*#__PURE__*/ v.string(),
 			platform: /*#__PURE__*/ v.string<'android' | 'ios' | 'web' | (string & {})>(),

package/lib/lexicons/types/app/bsky/richtext/facet.ts

@@ -3,7 +3,13 @@ import * as v from '@atcute/lexicons/validations';
 
 const _byteSliceSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.richtext.facet#byteSlice')),
+	/**
+	 * @minimum 0
+	 */
 	byteEnd: /*#__PURE__*/ v.integer(),
+	/**
+	 * @minimum 0
+	 */
 	byteStart: /*#__PURE__*/ v.integer(),
 });
 const _linkSchema = /*#__PURE__*/ v.object({
@@ -25,6 +31,10 @@ const _mentionSchema = /*#__PURE__*/ v.object({
 });
 const _tagSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.richtext.facet#tag')),
+	/**
+	 * @maxLength 640
+	 * @maxGraphemes 64
+	 */
 	tag: /*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 		/*#__PURE__*/ v.stringLength(0, 640),
 		/*#__PURE__*/ v.stringGraphemes(0, 64),

package/lib/lexicons/types/app/bsky/unspecced/defs.ts

@@ -5,18 +5,48 @@ import * as AppBskyFeedDefs from '../feed/defs.js';
 
 const _ageAssuranceEventSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.unspecced.defs#ageAssuranceEvent')),
+	/**
+	 * The unique identifier for this instance of the age assurance flow, in UUID format.
+	 */
 	attemptId: /*#__PURE__*/ v.string(),
+	/**
+	 * The IP address used when completing the AA flow.
+	 */
 	completeIp: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+	/**
+	 * The user agent used when completing the AA flow.
+	 */
 	completeUa: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+	/**
+	 * The date and time of this write operation.
+	 */
 	createdAt: /*#__PURE__*/ v.datetimeString(),
+	/**
+	 * The email used for AA.
+	 */
 	email: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+	/**
+	 * The IP address used when initiating the AA flow.
+	 */
 	initIp: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+	/**
+	 * The user agent used when initiating the AA flow.
+	 */
 	initUa: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+	/**
+	 * The status of the age assurance process.
+	 */
 	status: /*#__PURE__*/ v.string<'assured' | 'pending' | 'unknown' | (string & {})>(),
 });
 const _ageAssuranceStateSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.unspecced.defs#ageAssuranceState')),
+	/**
+	 * The timestamp when this state was last updated.
+	 */
 	lastInitiatedAt: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.datetimeString()),
+	/**
+	 * The status of the age assurance process.
+	 */
 	status: /*#__PURE__*/ v.string<'assured' | 'blocked' | 'pending' | 'unknown' | (string & {})>(),
 });
 const _skeletonSearchActorSchema = /*#__PURE__*/ v.object({
@@ -60,10 +90,25 @@ const _threadItemNotFoundSchema = /*#__PURE__*/ v.object({
 });
 const _threadItemPostSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.unspecced.defs#threadItemPost')),
+	/**
+	 * The threadgate created by the author indicates this post as a reply to be hidden for everyone consuming the thread.
+	 */
 	hiddenByThreadgate: /*#__PURE__*/ v.boolean(),
+	/**
+	 * This post has more parents that were not present in the response. This is just a boolean, without the number of parents.
+	 */
 	moreParents: /*#__PURE__*/ v.boolean(),
+	/**
+	 * This post has more replies that were not present in the response. This is a numeric value, which is best-effort and might not be accurate.
+	 */
 	moreReplies: /*#__PURE__*/ v.integer(),
+	/**
+	 * This is by an account muted by the viewer requesting it.
+	 */
 	mutedByViewer: /*#__PURE__*/ v.boolean(),
+	/**
+	 * This post is part of a contiguous thread by the OP from the thread root. Many different OP threads can happen in the same thread.
+	 */
 	opThread: /*#__PURE__*/ v.boolean(),
 	get post() {
 		return AppBskyFeedDefs.postViewSchema;

package/lib/lexicons/types/app/bsky/unspecced/getOnboardingSuggestedStarterPacks.ts

@@ -5,6 +5,11 @@ import * as AppBskyGraphDefs from '../graph/defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getOnboardingSuggestedStarterPacks', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,

package/lib/lexicons/types/app/bsky/unspecced/getOnboardingSuggestedStarterPacksSkeleton.ts

@@ -4,10 +4,18 @@ import type {} from '@atcute/lexicons/ambient';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getOnboardingSuggestedStarterPacksSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,
 		),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries).
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/unspecced/getPopularFeedGenerators.ts

@@ -6,6 +6,11 @@ import * as AppBskyFeedDefs from '../feed/defs.js';
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getPopularFeedGenerators', {
 	params: /*#__PURE__*/ v.object({
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 50
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			50,

package/lib/lexicons/types/app/bsky/unspecced/getPostThreadOtherV2.ts

@@ -5,12 +5,22 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getPostThreadOtherV2', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Reference (AT-URI) to post record. This is the anchor post.
+		 */
 		anchor: /*#__PURE__*/ v.resourceUriString(),
+		/**
+		 * Whether to prioritize posts from followed users. It only has effect when the user is authenticated.
+		 * @default false
+		 */
 		prioritizeFollowedUsers: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean(), false),
 	}),
 	output: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
+			/**
+			 * A flat list of other thread items. The depth of each item is indicated by the depth property inside the item.
+			 */
 			get thread() {
 				return /*#__PURE__*/ v.array(threadItemSchema);
 			},
@@ -21,6 +31,9 @@ const _threadItemSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.literal('app.bsky.unspecced.getPostThreadOtherV2#threadItem'),
 	),
+	/**
+	 * The nesting level of this item in the thread. Depth 0 means the anchor item. Items above have negative depths, items below have positive depths.
+	 */
 	depth: /*#__PURE__*/ v.integer(),
 	uri: /*#__PURE__*/ v.resourceUriString(),
 	get value() {

package/lib/lexicons/types/app/bsky/unspecced/getPostThreadV2.ts

@@ -6,17 +6,44 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getPostThreadV2', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Whether to include parents above the anchor.
+		 * @default true
+		 */
 		above: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean(), true),
+		/**
+		 * Reference (AT-URI) to post record. This is the anchor post, and the thread will be built around it. It can be any post in the tree, not necessarily a root post.
+		 */
 		anchor: /*#__PURE__*/ v.resourceUriString(),
+		/**
+		 * How many levels of replies to include below the anchor.
+		 * @minimum 0
+		 * @maximum 20
+		 * @default 6
+		 */
 		below: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(0, 20)]),
 			6,
 		),
+		/**
+		 * Maximum of replies to include at each level of the thread, except for the direct replies to the anchor, which are (NOTE: currently, during unspecced phase) all returned (NOTE: later they might be paginated).
+		 * @minimum 0
+		 * @maximum 100
+		 * @default 10
+		 */
 		branchingFactor: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(0, 100)]),
 			10,
 		),
+		/**
+		 * Whether to prioritize posts from followed users. It only has effect when the user is authenticated.
+		 * @default false
+		 */
 		prioritizeFollowedUsers: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean(), false),
+		/**
+		 * Sorting for the thread replies.
+		 * @default "oldest"
+		 */
 		sort: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.string<'newest' | 'oldest' | 'top' | (string & {})>(),
 			'oldest',
@@ -25,7 +52,13 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getPostThreadV2',
 	output: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
+			/**
+			 * Whether this thread has additional replies. If true, a call can be made to the `getPostThreadOtherV2` endpoint to retrieve them.
+			 */
 			hasOtherReplies: /*#__PURE__*/ v.boolean(),
+			/**
+			 * A flat list of thread items. The depth of each item is indicated by the depth property inside the item.
+			 */
 			get thread() {
 				return /*#__PURE__*/ v.array(threadItemSchema);
 			},
@@ -37,6 +70,9 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getPostThreadV2',
 });
 const _threadItemSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.unspecced.getPostThreadV2#threadItem')),
+	/**
+	 * The nesting level of this item in the thread. Depth 0 means the anchor item. Items above have negative depths, items below have positive depths.
+	 */
 	depth: /*#__PURE__*/ v.integer(),
 	uri: /*#__PURE__*/ v.resourceUriString(),
 	get value() {

package/lib/lexicons/types/app/bsky/unspecced/getSuggestedFeeds.ts

@@ -5,6 +5,11 @@ import * as AppBskyFeedDefs from '../feed/defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestedFeeds', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,

package/lib/lexicons/types/app/bsky/unspecced/getSuggestedFeedsSkeleton.ts

@@ -4,10 +4,18 @@ import type {} from '@atcute/lexicons/ambient';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestedFeedsSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,
 		),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries).
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/unspecced/getSuggestedStarterPacks.ts

@@ -5,6 +5,11 @@ import * as AppBskyGraphDefs from '../graph/defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestedStarterPacks', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,

package/lib/lexicons/types/app/bsky/unspecced/getSuggestedStarterPacksSkeleton.ts

@@ -4,10 +4,18 @@ import type {} from '@atcute/lexicons/ambient';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestedStarterPacksSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,
 		),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries).
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/unspecced/getSuggestedUsers.ts

@@ -5,7 +5,15 @@ import * as AppBskyActorDefs from '../actor/defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestedUsers', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Category of users to get suggestions for.
+		 */
 		category: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 50
+		 * @default 25
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 50)]),
 			25,

package/lib/lexicons/types/app/bsky/unspecced/getSuggestedUsersSkeleton.ts

@@ -4,11 +4,22 @@ import type {} from '@atcute/lexicons/ambient';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestedUsersSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Category of users to get suggestions for.
+		 */
 		category: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 50
+		 * @default 25
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 50)]),
 			25,
 		),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries).
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/unspecced/getSuggestionsSkeleton.ts

@@ -6,11 +6,22 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestionsSkeleton', {
 	params: /*#__PURE__*/ v.object({
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 50
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			50,
 		),
+		/**
+		 * DID of the account to get suggestions relative to. If not provided, suggestions will be based on the viewer.
+		 */
 		relativeToDid: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries). Used to boost followed accounts in ranking.
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {
@@ -20,7 +31,13 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getSuggestionsSkel
 				return /*#__PURE__*/ v.array(AppBskyUnspeccedDefs.skeletonSearchActorSchema);
 			},
 			cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+			/**
+			 * Snowflake for this recommendation, use when submitting recommendation events.
+			 */
 			recId: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.integer()),
+			/**
+			 * DID of the account these suggestions are relative to. If this is returned undefined, suggestions are based on the viewer.
+			 */
 			relativeToDid: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 		}),
 	},

package/lib/lexicons/types/app/bsky/unspecced/getTrendingTopics.ts

@@ -5,10 +5,18 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getTrendingTopics', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,
 		),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries). Used to boost followed accounts in ranking.
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/unspecced/getTrends.ts

@@ -5,6 +5,11 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getTrends', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,

package/lib/lexicons/types/app/bsky/unspecced/getTrendsSkeleton.ts

@@ -5,10 +5,18 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.getTrendsSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minimum 1
+		 * @maximum 25
+		 * @default 10
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 25)]),
 			10,
 		),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries).
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/unspecced/initAgeAssurance.ts

@@ -8,8 +8,17 @@ const _mainSchema = /*#__PURE__*/ v.procedure('app.bsky.unspecced.initAgeAssuran
 	input: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
+			/**
+			 * An ISO 3166-1 alpha-2 code of the user's location.
+			 */
 			countryCode: /*#__PURE__*/ v.string(),
+			/**
+			 * The user's email address to receive assurance instructions.
+			 */
 			email: /*#__PURE__*/ v.string(),
+			/**
+			 * The user's preferred language for communication during the assurance process.
+			 */
 			language: /*#__PURE__*/ v.string(),
 		}),
 	},

package/lib/lexicons/types/app/bsky/unspecced/searchActorsSkeleton.ts

@@ -5,13 +5,30 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.searchActorsSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Optional pagination mechanism; may not necessarily allow scrolling through entire result set.
+		 */
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 25
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			25,
 		),
+		/**
+		 * Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. For typeahead search, only simple term match is supported, not full syntax.
+		 */
 		q: /*#__PURE__*/ v.string(),
+		/**
+		 * If true, acts as fast/simple 'typeahead' query.
+		 */
 		typeahead: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean()),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries). Used to boost followed accounts in ranking.
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {
@@ -21,6 +38,9 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.searchActorsSkelet
 				return /*#__PURE__*/ v.array(AppBskyUnspeccedDefs.skeletonSearchActorSchema);
 			},
 			cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+			/**
+			 * Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits.
+			 */
 			hitsTotal: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.integer()),
 		}),
 	},

package/lib/lexicons/types/app/bsky/unspecced/searchPostsSkeleton.ts

@@ -5,18 +5,51 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.searchPostsSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Filter to posts by the given account. Handles are resolved to DID before query-time.
+		 */
 		author: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.actorIdentifierString()),
+		/**
+		 * Optional pagination mechanism; may not necessarily allow scrolling through entire result set.
+		 */
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.
+		 */
 		domain: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.
+		 */
 		lang: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.languageCodeString()),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 25
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			25,
 		),
+		/**
+		 * Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.
+		 */
 		mentions: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.actorIdentifierString()),
+		/**
+		 * Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.
+		 */
 		q: /*#__PURE__*/ v.string(),
+		/**
+		 * Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD).
+		 */
 		since: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * Specifies the ranking order of results.
+		 * @default "latest"
+		 */
 		sort: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string<'latest' | 'top' | (string & {})>(), 'latest'),
+		/**
+		 * Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix. Multiple tags can be specified, with 'AND' matching.
+		 */
 		tag: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.array(
 				/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
@@ -25,14 +58,26 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.searchPostsSkeleto
 				]),
 			),
 		),
+		/**
+		 * Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD).
+		 */
 		until: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.
+		 */
 		url: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.genericUriString()),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries). Used for 'from:me' queries.
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
 			cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+			/**
+			 * Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits.
+			 */
 			hitsTotal: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.integer()),
 			get posts() {
 				return /*#__PURE__*/ v.array(AppBskyUnspeccedDefs.skeletonSearchPostSchema);

package/lib/lexicons/types/app/bsky/unspecced/searchStarterPacksSkeleton.ts

@@ -5,18 +5,35 @@ import * as AppBskyUnspeccedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.unspecced.searchStarterPacksSkeleton', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Optional pagination mechanism; may not necessarily allow scrolling through entire result set.
+		 */
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 25
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			25,
 		),
+		/**
+		 * Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.
+		 */
 		q: /*#__PURE__*/ v.string(),
+		/**
+		 * DID of the account making the request (not included for public/unauthenticated queries).
+		 */
 		viewer: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.didString()),
 	}),
 	output: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
 			cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+			/**
+			 * Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits.
+			 */
 			hitsTotal: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.integer()),
 			get starterPacks() {
 				return /*#__PURE__*/ v.array(AppBskyUnspeccedDefs.skeletonSearchStarterPackSchema);