@atcute/bluesky 3.2.5 → 3.2.7

package/lib/lexicons/types/app/bsky/embed/video.ts

@@ -4,11 +4,20 @@ import * as AppBskyEmbedDefs from './defs.js';
 
 const _captionSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.embed.video#caption')),
+	/**
+	 * @accept text/vtt
+	 * @maxSize 20000
+	 */
 	file: /*#__PURE__*/ v.blob(),
 	lang: /*#__PURE__*/ v.languageCodeString(),
 });
 const _mainSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.embed.video')),
+	/**
+	 * Alt text description of the video, for accessibility.
+	 * @maxLength 10000
+	 * @maxGraphemes 1000
+	 */
 	alt: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 			/*#__PURE__*/ v.stringLength(0, 10000),
@@ -18,15 +27,27 @@ const _mainSchema = /*#__PURE__*/ v.object({
 	get aspectRatio() {
 		return /*#__PURE__*/ v.optional(AppBskyEmbedDefs.aspectRatioSchema);
 	},
+	/**
+	 * @maxLength 20
+	 */
 	get captions() {
 		return /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.array(captionSchema), [/*#__PURE__*/ v.arrayLength(0, 20)]),
 		);
 	},
+	/**
+	 * The mp4 video file. May be up to 100mb, formerly limited to 50mb.
+	 * @accept video/mp4
+	 * @maxSize 100000000
+	 */
 	video: /*#__PURE__*/ v.blob(),
 });
 const _viewSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.embed.video#view')),
+	/**
+	 * @maxLength 10000
+	 * @maxGraphemes 1000
+	 */
 	alt: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 			/*#__PURE__*/ v.stringLength(0, 10000),

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

@@ -33,6 +33,10 @@ const _contentModeUnspecifiedSchema = /*#__PURE__*/ v.literal('app.bsky.feed.def
 const _contentModeVideoSchema = /*#__PURE__*/ v.literal('app.bsky.feed.defs#contentModeVideo');
 const _feedViewPostSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.feed.defs#feedViewPost')),
+	/**
+	 * Context provided by feed generator that may be passed back alongside interactions.
+	 * @maxLength 2000
+	 */
 	feedContext: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [/*#__PURE__*/ v.stringLength(0, 2000)]),
 	),
@@ -45,6 +49,10 @@ const _feedViewPostSchema = /*#__PURE__*/ v.object({
 	get reply() {
 		return /*#__PURE__*/ v.optional(replyRefSchema);
 	},
+	/**
+	 * Unique identifier per request that may be passed back alongside interactions.
+	 * @maxLength 100
+	 */
 	reqId: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [/*#__PURE__*/ v.stringLength(0, 100)]),
 	),
@@ -62,6 +70,10 @@ const _generatorViewSchema = /*#__PURE__*/ v.object({
 	get creator() {
 		return AppBskyActorDefs.profileViewSchema;
 	},
+	/**
+	 * @maxLength 3000
+	 * @maxGraphemes 300
+	 */
 	description: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 			/*#__PURE__*/ v.stringLength(0, 3000),
@@ -77,6 +89,9 @@ const _generatorViewSchema = /*#__PURE__*/ v.object({
 	get labels() {
 		return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.array(ComAtprotoLabelDefs.labelSchema));
 	},
+	/**
+	 * @minimum 0
+	 */
 	likeCount: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.integer()),
 	uri: /*#__PURE__*/ v.resourceUriString(),
 	get viewer() {
@@ -106,10 +121,18 @@ const _interactionSchema = /*#__PURE__*/ v.object({
 			| (string & {})
 		>(),
 	),
+	/**
+	 * Context on a feed item that was originally supplied by the feed generator on getFeedSkeleton.
+	 * @maxLength 2000
+	 */
 	feedContext: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [/*#__PURE__*/ v.stringLength(0, 2000)]),
 	),
 	item: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.resourceUriString()),
+	/**
+	 * Unique identifier per request that may be passed back alongside interactions.
+	 * @maxLength 100
+	 */
 	reqId: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [/*#__PURE__*/ v.stringLength(0, 100)]),
 	),
@@ -174,6 +197,9 @@ const _reasonRepostSchema = /*#__PURE__*/ v.object({
 });
 const _replyRefSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.feed.defs#replyRef')),
+	/**
+	 * When parent is a reply to another post, this is the author of that post.
+	 */
 	get grandparentAuthor() {
 		return /*#__PURE__*/ v.optional(AppBskyActorDefs.profileViewBasicSchema);
 	},
@@ -188,6 +214,10 @@ const _requestLessSchema = /*#__PURE__*/ v.literal('app.bsky.feed.defs#requestLe
 const _requestMoreSchema = /*#__PURE__*/ v.literal('app.bsky.feed.defs#requestMore');
 const _skeletonFeedPostSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.feed.defs#skeletonFeedPost')),
+	/**
+	 * Context that will be passed through to client and may be passed to feed generator back alongside interactions.
+	 * @maxLength 2000
+	 */
 	feedContext: /*#__PURE__*/ v.optional(
 		/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [/*#__PURE__*/ v.stringLength(0, 2000)]),
 	),

package/lib/lexicons/types/app/bsky/feed/generator.ts

@@ -8,7 +8,14 @@ const _mainSchema = /*#__PURE__*/ v.record(
 	/*#__PURE__*/ v.string(),
 	/*#__PURE__*/ v.object({
 		$type: /*#__PURE__*/ v.literal('app.bsky.feed.generator'),
+		/**
+		 * Declaration that a feed accepts feedback interactions from a client through app.bsky.feed.sendInteractions
+		 */
 		acceptsInteractions: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean()),
+		/**
+		 * @accept image/png, image/jpeg
+		 * @maxSize 1000000
+		 */
 		avatar: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.blob()),
 		contentMode: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.string<
@@ -16,6 +23,10 @@ const _mainSchema = /*#__PURE__*/ v.record(
 			>(),
 		),
 		createdAt: /*#__PURE__*/ v.datetimeString(),
+		/**
+		 * @maxLength 3000
+		 * @maxGraphemes 300
+		 */
 		description: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 				/*#__PURE__*/ v.stringLength(0, 3000),
@@ -26,10 +37,17 @@ const _mainSchema = /*#__PURE__*/ v.record(
 			return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.array(AppBskyRichtextFacet.mainSchema));
 		},
 		did: /*#__PURE__*/ v.didString(),
+		/**
+		 * @maxLength 240
+		 * @maxGraphemes 24
+		 */
 		displayName: /*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 			/*#__PURE__*/ v.stringLength(0, 240),
 			/*#__PURE__*/ v.stringGraphemes(0, 24),
 		]),
+		/**
+		 * Self-label values
+		 */
 		get labels() {
 			return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.variant([ComAtprotoLabelDefs.selfLabelsSchema]));
 		},

package/lib/lexicons/types/app/bsky/feed/getActorFeeds.ts

@@ -7,6 +7,11 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getActorFeeds', {
 	params: /*#__PURE__*/ v.object({
 		actor: /*#__PURE__*/ v.actorIdentifierString(),
 		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/feed/getActorLikes.ts

@@ -7,6 +7,11 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getActorLikes', {
 	params: /*#__PURE__*/ v.object({
 		actor: /*#__PURE__*/ v.actorIdentifierString(),
 		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/feed/getAuthorFeed.ts

@@ -7,6 +7,10 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getAuthorFeed', {
 	params: /*#__PURE__*/ v.object({
 		actor: /*#__PURE__*/ v.actorIdentifierString(),
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * Combinations of post/repost types to include in response.
+		 * @default "posts_with_replies"
+		 */
 		filter: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.string<
 				| 'posts_and_author_threads'
@@ -18,7 +22,15 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getAuthorFeed', {
 			>(),
 			'posts_with_replies',
 		),
+		/**
+		 * @default false
+		 */
 		includePins: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.boolean(), false),
+		/**
+		 * @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/feed/getFeed.ts

@@ -7,6 +7,11 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getFeed', {
 	params: /*#__PURE__*/ v.object({
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
 		feed: /*#__PURE__*/ v.resourceUriString(),
+		/**
+		 * @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/feed/getFeedGenerator.ts

@@ -5,12 +5,21 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getFeedGenerator', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * AT-URI of the feed generator record.
+		 */
 		feed: /*#__PURE__*/ v.resourceUriString(),
 	}),
 	output: {
 		type: 'lex',
 		schema: /*#__PURE__*/ v.object({
+			/**
+			 * Indicates whether the feed generator service has been online recently, or else seems to be inactive.
+			 */
 			isOnline: /*#__PURE__*/ v.boolean(),
+			/**
+			 * Indicates whether the feed generator service is compatible with the record declaration.
+			 */
 			isValid: /*#__PURE__*/ v.boolean(),
 			get view() {
 				return AppBskyFeedDefs.generatorViewSchema;

package/lib/lexicons/types/app/bsky/feed/getFeedGenerators.ts

@@ -5,6 +5,9 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getFeedGenerators', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * @minLength 1
+		 */
 		feeds: /*#__PURE__*/ v.constrain(/*#__PURE__*/ v.array(/*#__PURE__*/ v.resourceUriString()), [
 			/*#__PURE__*/ v.arrayLength(1),
 		]),

package/lib/lexicons/types/app/bsky/feed/getFeedSkeleton.ts

@@ -6,7 +6,15 @@ import * as AppBskyFeedDefs from './defs.js';
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getFeedSkeleton', {
 	params: /*#__PURE__*/ v.object({
 		cursor: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
+		/**
+		 * Reference to feed generator record describing the specific feed being requested.
+		 */
 		feed: /*#__PURE__*/ v.resourceUriString(),
+		/**
+		 * @minimum 1
+		 * @maximum 100
+		 * @default 50
+		 */
 		limit: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(1, 100)]),
 			50,
@@ -19,6 +27,10 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getFeedSkeleton', {
 			get feed() {
 				return /*#__PURE__*/ v.array(AppBskyFeedDefs.skeletonFeedPostSchema);
 			},
+			/**
+			 * Unique identifier per request that may be passed back alongside interactions.
+			 * @maxLength 100
+			 */
 			reqId: /*#__PURE__*/ v.optional(
 				/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [/*#__PURE__*/ v.stringLength(0, 100)]),
 			),

package/lib/lexicons/types/app/bsky/feed/getLikes.ts

@@ -13,12 +13,23 @@ const _likeSchema = /*#__PURE__*/ v.object({
 });
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getLikes', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * CID of the subject record (aka, specific version of record), to filter likes.
+		 */
 		cid: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.cidString()),
 		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,
 		),
+		/**
+		 * AT-URI of the subject (eg, a post record).
+		 */
 		uri: /*#__PURE__*/ v.resourceUriString(),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/feed/getListFeed.ts

@@ -6,10 +6,18 @@ import * as AppBskyFeedDefs from './defs.js';
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getListFeed', {
 	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,
 		),
+		/**
+		 * Reference (AT-URI) to the list record.
+		 */
 		list: /*#__PURE__*/ v.resourceUriString(),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/feed/getPostThread.ts

@@ -5,14 +5,29 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getPostThread', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * How many levels of reply depth should be included in response.
+		 * @minimum 0
+		 * @maximum 1000
+		 * @default 6
+		 */
 		depth: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(0, 1000)]),
 			6,
 		),
+		/**
+		 * How many levels of parent (and grandparent, etc) post to include.
+		 * @minimum 0
+		 * @maximum 1000
+		 * @default 80
+		 */
 		parentHeight: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.integer(), [/*#__PURE__*/ v.integerRange(0, 1000)]),
 			80,
 		),
+		/**
+		 * Reference (AT-URI) to post record.
+		 */
 		uri: /*#__PURE__*/ v.resourceUriString(),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/feed/getPosts.ts

@@ -5,6 +5,11 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getPosts', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * List of post AT-URIs to return hydrated views for.
+		 * @minLength 1
+		 * @maxLength 25
+		 */
 		uris: /*#__PURE__*/ v.constrain(/*#__PURE__*/ v.array(/*#__PURE__*/ v.resourceUriString()), [
 			/*#__PURE__*/ v.arrayLength(1, 25),
 		]),

package/lib/lexicons/types/app/bsky/feed/getQuotes.ts

@@ -5,12 +5,23 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getQuotes', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * If supplied, filters to quotes of specific version (by CID) of the post record.
+		 */
 		cid: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.cidString()),
 		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,
 		),
+		/**
+		 * Reference (AT-URI) of post record
+		 */
 		uri: /*#__PURE__*/ v.resourceUriString(),
 	}),
 	output: {

package/lib/lexicons/types/app/bsky/feed/getRepostedBy.ts

@@ -5,12 +5,23 @@ import * as AppBskyActorDefs from '../actor/defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getRepostedBy', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * If supplied, filters to reposts of specific version (by CID) of the post record.
+		 */
 		cid: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.cidString()),
 		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,
 		),
+		/**
+		 * Reference (AT-URI) of post record
+		 */
 		uri: /*#__PURE__*/ v.resourceUriString(),
 	}),
 	output: {

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

@@ -6,6 +6,11 @@ import * as AppBskyFeedDefs from './defs.js';
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getSuggestedFeeds', {
 	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/feed/getTimeline.ts

@@ -5,8 +5,16 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.getTimeline', {
 	params: /*#__PURE__*/ v.object({
+		/**
+		 * Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.
+		 */
 		algorithm: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.string()),
 		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/feed/post.ts

@@ -15,6 +15,9 @@ const _entitySchema = /*#__PURE__*/ v.object({
 	get index() {
 		return textSliceSchema;
 	},
+	/**
+	 * Expected values are 'mention' and 'link'.
+	 */
 	type: /*#__PURE__*/ v.string(),
 	value: /*#__PURE__*/ v.string(),
 });
@@ -22,6 +25,9 @@ const _mainSchema = /*#__PURE__*/ v.record(
 	/*#__PURE__*/ v.tidString(),
 	/*#__PURE__*/ v.object({
 		$type: /*#__PURE__*/ v.literal('app.bsky.feed.post'),
+		/**
+		 * Client-declared timestamp when this post was originally created.
+		 */
 		createdAt: /*#__PURE__*/ v.datetimeString(),
 		get embed() {
 			return /*#__PURE__*/ v.optional(
@@ -34,15 +40,29 @@ const _mainSchema = /*#__PURE__*/ v.record(
 				]),
 			);
 		},
+		/**
+		 * DEPRECATED: replaced by app.bsky.richtext.facet.
+		 * @deprecated
+		 */
 		get entities() {
 			return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.array(entitySchema));
 		},
+		/**
+		 * Annotations of text (mentions, URLs, hashtags, etc)
+		 */
 		get facets() {
 			return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.array(AppBskyRichtextFacet.mainSchema));
 		},
+		/**
+		 * Self-label values for this post. Effectively content warnings.
+		 */
 		get labels() {
 			return /*#__PURE__*/ v.optional(/*#__PURE__*/ v.variant([ComAtprotoLabelDefs.selfLabelsSchema]));
 		},
+		/**
+		 * Indicates human language of post primary text content.
+		 * @maxLength 3
+		 */
 		langs: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.array(/*#__PURE__*/ v.languageCodeString()), [
 				/*#__PURE__*/ v.arrayLength(0, 3),
@@ -51,6 +71,10 @@ const _mainSchema = /*#__PURE__*/ v.record(
 		get reply() {
 			return /*#__PURE__*/ v.optional(replyRefSchema);
 		},
+		/**
+		 * Additional hashtags, in addition to any included in post text and facets.
+		 * @maxLength 8
+		 */
 		tags: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(
 				/*#__PURE__*/ v.array(
@@ -62,6 +86,11 @@ const _mainSchema = /*#__PURE__*/ v.record(
 				[/*#__PURE__*/ v.arrayLength(0, 8)],
 			),
 		),
+		/**
+		 * The primary post content. May be an empty string, if there are embeds.
+		 * @maxLength 3000
+		 * @maxGraphemes 300
+		 */
 		text: /*#__PURE__*/ v.constrain(/*#__PURE__*/ v.string(), [
 			/*#__PURE__*/ v.stringLength(0, 3000),
 			/*#__PURE__*/ v.stringGraphemes(0, 300),
@@ -79,7 +108,13 @@ const _replyRefSchema = /*#__PURE__*/ v.object({
 });
 const _textSliceSchema = /*#__PURE__*/ v.object({
 	$type: /*#__PURE__*/ v.optional(/*#__PURE__*/ v.literal('app.bsky.feed.post#textSlice')),
+	/**
+	 * @minimum 0
+	 */
 	end: /*#__PURE__*/ v.integer(),
+	/**
+	 * @minimum 0
+	 */
 	start: /*#__PURE__*/ v.integer(),
 });
 

package/lib/lexicons/types/app/bsky/feed/postgate.ts

@@ -10,11 +10,19 @@ const _mainSchema = /*#__PURE__*/ v.record(
 	/*#__PURE__*/ v.object({
 		$type: /*#__PURE__*/ v.literal('app.bsky.feed.postgate'),
 		createdAt: /*#__PURE__*/ v.datetimeString(),
+		/**
+		 * List of AT-URIs embedding this post that the author has detached from.
+		 * @maxLength 50
+		 */
 		detachedEmbeddingUris: /*#__PURE__*/ v.optional(
 			/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.array(/*#__PURE__*/ v.resourceUriString()), [
 				/*#__PURE__*/ v.arrayLength(0, 50),
 			]),
 		),
+		/**
+		 * List of rules defining who can embed this post. If value is an empty array or is undefined, no particular rules apply and anyone can embed.
+		 * @maxLength 5
+		 */
 		get embeddingRules() {
 			return /*#__PURE__*/ v.optional(
 				/*#__PURE__*/ v.constrain(/*#__PURE__*/ v.array(/*#__PURE__*/ v.variant([disableRuleSchema])), [
@@ -22,6 +30,9 @@ const _mainSchema = /*#__PURE__*/ v.record(
 				]),
 			);
 		},
+		/**
+		 * Reference (AT-URI) to the post record.
+		 */
 		post: /*#__PURE__*/ v.resourceUriString(),
 	}),
 );

package/lib/lexicons/types/app/bsky/feed/searchPosts.ts

@@ -5,18 +5,51 @@ import * as AppBskyFeedDefs from './defs.js';
 
 const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.searchPosts', {
 	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,13 +58,22 @@ const _mainSchema = /*#__PURE__*/ v.query('app.bsky.feed.searchPosts', {
 				]),
 			),
 		),
+		/**
+		 * 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()),
 	}),
 	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(AppBskyFeedDefs.postViewSchema);