@atproto/bsky 0.0.93 → 0.0.95

package/src/config.ts

@@ -41,6 +41,10 @@ export interface ServerConfigValues {
   blobCacheLocation?: string
   statsigKey?: string
   statsigEnv?: string
+  // threads
+  bigThreadUris: Set<string>
+  bigThreadDepth?: number
+  maxThreadDepth?: number
   // client config
   clientCheckEmailConfirmed?: boolean
 }
@@ -133,6 +137,13 @@ export class ServerConfig {
       !indexedAtEpoch || !isNaN(indexedAtEpoch.getTime()),
       'invalid BSKY_INDEXED_AT_EPOCH',
     )
+    const bigThreadUris = new Set(envList(process.env.BSKY_BIG_THREAD_URIS))
+    const bigThreadDepth = process.env.BSKY_BIG_THREAD_DEPTH
+      ? parseInt(process.env.BSKY_BIG_THREAD_DEPTH || '', 10)
+      : undefined
+    const maxThreadDepth = process.env.BSKY_MAX_THREAD_DEPTH
+      ? parseInt(process.env.BSKY_MAX_THREAD_DEPTH || '', 10)
+      : undefined
     return new ServerConfig({
       version,
       debugMode,
@@ -170,6 +181,9 @@ export class ServerConfig {
       statsigEnv,
       clientCheckEmailConfirmed,
       indexedAtEpoch,
+      bigThreadUris,
+      bigThreadDepth,
+      maxThreadDepth,
       ...stripUndefineds(overrides ?? {}),
     })
   }
@@ -330,6 +344,18 @@ export class ServerConfig {
   get indexedAtEpoch() {
     return this.cfg.indexedAtEpoch
   }
+
+  get bigThreadUris() {
+    return this.cfg.bigThreadUris
+  }
+
+  get bigThreadDepth() {
+    return this.cfg.bigThreadDepth
+  }
+
+  get maxThreadDepth() {
+    return this.cfg.maxThreadDepth
+  }
 }
 
 function stripUndefineds(

package/src/data-plane/server/db/migrations/20241114T153108102Z-add-starter-packs-name.ts

@@ -0,0 +1,19 @@
+import { Kysely, sql } from 'kysely'
+
+export async function up(db: Kysely<unknown>): Promise<void> {
+  await db.schema
+    .alterTable('starter_pack')
+    .addColumn('name', 'varchar')
+    .execute()
+
+  await db.schema // Supports starter pack search
+    .createIndex(`starter_pack_name_tgrm_idx`)
+    .on('starter_pack')
+    .using('gist')
+    .expression(sql`"name" gist_trgm_ops`)
+    .execute()
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+  await db.schema.alterTable('starter_pack').dropColumn('name').execute()
+}

package/src/data-plane/server/db/migrations/index.ts

@@ -44,3 +44,4 @@ export * as _20240801T193939827Z from './20240801T193939827Z-post-gate'
 export * as _20240808T224251220Z from './20240808T224251220Z-post-gate-flags'
 export * as _20240829T211238293Z from './20240829T211238293Z-simplify-actor-sync'
 export * as _20240831T134810923Z from './20240831T134810923Z-pinned-posts'
+export * as _20241114T153108102Z from './20241114T153108102Z-add-starter-packs-name'

package/src/data-plane/server/db/tables/starter-pack.ts

@@ -6,6 +6,7 @@ export interface StarterPack {
   uri: string
   cid: string
   creator: string
+  name: string
   createdAt: string
   indexedAt: string
   sortAt: GeneratedAlways<string>

package/src/data-plane/server/indexing/plugins/starter-pack.ts

@@ -24,6 +24,7 @@ const insertFn = async (
       uri: uri.toString(),
       cid: cid.toString(),
       creator: uri.host,
+      name: obj.name,
       createdAt: normalizeDatetimeAlways(obj.createdAt),
       indexedAt: timestamp,
     })

package/src/data-plane/server/routes/search.ts

@@ -55,6 +55,36 @@ export default (db: Database): Partial<ServiceImpl<typeof Service>> => ({
       cursor: keyset.packFromResult(res),
     }
   },
+
+  async searchStarterPacks(req) {
+    const { term, limit, cursor } = req
+    const { ref } = db.db.dynamic
+    let builder = db.db
+      .selectFrom('starter_pack')
+      .where('starter_pack.name', 'ilike', `%${term}%`)
+      .selectAll()
+
+    const keyset = new TimeCidKeyset(
+      ref('starter_pack.sortAt'),
+      ref('starter_pack.cid'),
+    )
+
+    builder = paginate(builder, {
+      limit,
+      cursor,
+      keyset,
+      tryIndex: true,
+    })
+
+    const res = await builder.execute()
+
+    const cur = keyset.packFromResult(res)
+
+    return {
+      uris: res.map((row) => row.uri),
+      cursor: cur,
+    }
+  },
 })
 
 // Remove leading @ in case a handle is input that way

package/src/hydration/actor.ts

@@ -189,11 +189,17 @@ export class ActorHydrator {
     viewer: string | null,
   ): Promise<KnownFollowers> {
     if (!viewer) return new HydrationMap<ProfileViewerState['knownFollowers']>()
-    const { results: knownFollowersResults } =
-      await this.dataplane.getFollowsFollowing({
-        actorDid: viewer,
-        targetDids: dids,
-      })
+    const { results: knownFollowersResults } = await this.dataplane
+      .getFollowsFollowing(
+        {
+          actorDid: viewer,
+          targetDids: dids,
+        },
+        {
+          signal: AbortSignal.timeout(100),
+        },
+      )
+      .catch(() => ({ results: [] }))
     return dids.reduce((acc, did, i) => {
       const result = knownFollowersResults[i]?.dids
       return acc.set(

package/src/hydration/label.ts

@@ -17,6 +17,7 @@ export type { Label } from '../lexicon/types/com/atproto/label/defs'
 
 export type SubjectLabels = {
   isTakendown: boolean
+  needsReview: boolean
   labels: HydrationMap<Label> // src + val -> label
 }
 
@@ -84,6 +85,7 @@ export class LabelHydrator {
       if (!entry) {
         entry = {
           isTakendown: false,
+          needsReview: false,
           labels: new HydrationMap(),
         }
         acc.set(label.uri, entry)
@@ -96,6 +98,13 @@ export class LabelHydrator {
       ) {
         entry.isTakendown = true
       }
+      if (
+        label.val === NEEDS_REVIEW_LABEL &&
+        !label.neg &&
+        labelers.redact.has(label.src)
+      ) {
+        entry.needsReview = true
+      }
       return acc
     }, new Labels())
   }
@@ -147,3 +156,4 @@ const labelerDidToUri = (did: string): string => {
 }
 
 const TAKEDOWN_LABELS = ['!takedown', '!suspend']
+const NEEDS_REVIEW_LABEL = 'needs-review'

package/src/lexicon/index.ts

@@ -80,6 +80,7 @@ import * as ComAtprotoSyncListRepos from './types/com/atproto/sync/listRepos'
 import * as ComAtprotoSyncNotifyOfUpdate from './types/com/atproto/sync/notifyOfUpdate'
 import * as ComAtprotoSyncRequestCrawl from './types/com/atproto/sync/requestCrawl'
 import * as ComAtprotoSyncSubscribeRepos from './types/com/atproto/sync/subscribeRepos'
+import * as ComAtprotoTempAddReservedHandle from './types/com/atproto/temp/addReservedHandle'
 import * as ComAtprotoTempCheckSignupQueue from './types/com/atproto/temp/checkSignupQueue'
 import * as ComAtprotoTempFetchLabels from './types/com/atproto/temp/fetchLabels'
 import * as ComAtprotoTempRequestPhoneVerification from './types/com/atproto/temp/requestPhoneVerification'
@@ -125,6 +126,7 @@ import * as AppBskyGraphGetSuggestedFollowsByActor from './types/app/bsky/graph/
 import * as AppBskyGraphMuteActor from './types/app/bsky/graph/muteActor'
 import * as AppBskyGraphMuteActorList from './types/app/bsky/graph/muteActorList'
 import * as AppBskyGraphMuteThread from './types/app/bsky/graph/muteThread'
+import * as AppBskyGraphSearchStarterPacks from './types/app/bsky/graph/searchStarterPacks'
 import * as AppBskyGraphUnmuteActor from './types/app/bsky/graph/unmuteActor'
 import * as AppBskyGraphUnmuteActorList from './types/app/bsky/graph/unmuteActorList'
 import * as AppBskyGraphUnmuteThread from './types/app/bsky/graph/unmuteThread'
@@ -140,6 +142,7 @@ import * as AppBskyUnspeccedGetSuggestionsSkeleton from './types/app/bsky/unspec
 import * as AppBskyUnspeccedGetTaggedSuggestions from './types/app/bsky/unspecced/getTaggedSuggestions'
 import * as AppBskyUnspeccedSearchActorsSkeleton from './types/app/bsky/unspecced/searchActorsSkeleton'
 import * as AppBskyUnspeccedSearchPostsSkeleton from './types/app/bsky/unspecced/searchPostsSkeleton'
+import * as AppBskyUnspeccedSearchStarterPacksSkeleton from './types/app/bsky/unspecced/searchStarterPacksSkeleton'
 import * as AppBskyVideoGetJobStatus from './types/app/bsky/video/getJobStatus'
 import * as AppBskyVideoGetUploadLimits from './types/app/bsky/video/getUploadLimits'
 import * as AppBskyVideoUploadVideo from './types/app/bsky/video/uploadVideo'
@@ -1090,6 +1093,17 @@ export class ComAtprotoTempNS {
     this._server = server
   }
 
+  addReservedHandle<AV extends AuthVerifier>(
+    cfg: ConfigOf<
+      AV,
+      ComAtprotoTempAddReservedHandle.Handler<ExtractAuth<AV>>,
+      ComAtprotoTempAddReservedHandle.HandlerReqCtx<ExtractAuth<AV>>
+    >,
+  ) {
+    const nsid = 'com.atproto.temp.addReservedHandle' // @ts-ignore
+    return this._server.xrpc.method(nsid, cfg)
+  }
+
   checkSignupQueue<AV extends AuthVerifier>(
     cfg: ConfigOf<
       AV,
@@ -1653,6 +1667,17 @@ export class AppBskyGraphNS {
     return this._server.xrpc.method(nsid, cfg)
   }
 
+  searchStarterPacks<AV extends AuthVerifier>(
+    cfg: ConfigOf<
+      AV,
+      AppBskyGraphSearchStarterPacks.Handler<ExtractAuth<AV>>,
+      AppBskyGraphSearchStarterPacks.HandlerReqCtx<ExtractAuth<AV>>
+    >,
+  ) {
+    const nsid = 'app.bsky.graph.searchStarterPacks' // @ts-ignore
+    return this._server.xrpc.method(nsid, cfg)
+  }
+
   unmuteActor<AV extends AuthVerifier>(
     cfg: ConfigOf<
       AV,
@@ -1849,6 +1874,17 @@ export class AppBskyUnspeccedNS {
     const nsid = 'app.bsky.unspecced.searchPostsSkeleton' // @ts-ignore
     return this._server.xrpc.method(nsid, cfg)
   }
+
+  searchStarterPacksSkeleton<AV extends AuthVerifier>(
+    cfg: ConfigOf<
+      AV,
+      AppBskyUnspeccedSearchStarterPacksSkeleton.Handler<ExtractAuth<AV>>,
+      AppBskyUnspeccedSearchStarterPacksSkeleton.HandlerReqCtx<ExtractAuth<AV>>
+    >,
+  ) {
+    const nsid = 'app.bsky.unspecced.searchStarterPacksSkeleton' // @ts-ignore
+    return this._server.xrpc.method(nsid, cfg)
+  }
 }
 
 export class AppBskyVideoNS {

package/src/lexicon/lexicons.ts

@@ -3959,6 +3959,35 @@ export const schemaDict = {
       },
     },
   },
+  ComAtprotoTempAddReservedHandle: {
+    lexicon: 1,
+    id: 'com.atproto.temp.addReservedHandle',
+    defs: {
+      main: {
+        type: 'procedure',
+        description: 'Add a handle to the set of reserved handles.',
+        input: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['handle'],
+            properties: {
+              handle: {
+                type: 'string',
+              },
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            properties: {},
+          },
+        },
+      },
+    },
+  },
   ComAtprotoTempCheckSignupQueue: {
     lexicon: 1,
     id: 'com.atproto.temp.checkSignupQueue',
@@ -8488,6 +8517,56 @@ export const schemaDict = {
       },
     },
   },
+  AppBskyGraphSearchStarterPacks: {
+    lexicon: 1,
+    id: 'app.bsky.graph.searchStarterPacks',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          'Find starter packs matching search criteria. Does not require auth.',
+        parameters: {
+          type: 'params',
+          required: ['q'],
+          properties: {
+            q: {
+              type: 'string',
+              description:
+                'Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 100,
+              default: 25,
+            },
+            cursor: {
+              type: 'string',
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['starterPacks'],
+            properties: {
+              cursor: {
+                type: 'string',
+              },
+              starterPacks: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.graph.defs#starterPackViewBasic',
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
   AppBskyGraphStarterpack: {
     lexicon: 1,
     id: 'app.bsky.graph.starterpack',
@@ -9153,6 +9232,16 @@ export const schemaDict = {
           },
         },
       },
+      skeletonSearchStarterPack: {
+        type: 'object',
+        required: ['uri'],
+        properties: {
+          uri: {
+            type: 'string',
+            format: 'at-uri',
+          },
+        },
+      },
     },
   },
   AppBskyUnspeccedGetConfig: {
@@ -9526,6 +9615,73 @@ export const schemaDict = {
       },
     },
   },
+  AppBskyUnspeccedSearchStarterPacksSkeleton: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.searchStarterPacksSkeleton',
+    defs: {
+      main: {
+        type: 'query',
+        description: 'Backend Starter Pack search, returns only skeleton.',
+        parameters: {
+          type: 'params',
+          required: ['q'],
+          properties: {
+            q: {
+              type: 'string',
+              description:
+                'Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.',
+            },
+            viewer: {
+              type: 'string',
+              format: 'did',
+              description:
+                'DID of the account making the request (not included for public/unauthenticated queries).',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 100,
+              default: 25,
+            },
+            cursor: {
+              type: 'string',
+              description:
+                'Optional pagination mechanism; may not necessarily allow scrolling through entire result set.',
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['starterPacks'],
+            properties: {
+              cursor: {
+                type: 'string',
+              },
+              hitsTotal: {
+                type: 'integer',
+                description:
+                  'Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits.',
+              },
+              starterPacks: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.unspecced.defs#skeletonSearchStarterPack',
+                },
+              },
+            },
+          },
+        },
+        errors: [
+          {
+            name: 'BadQueryString',
+          },
+        ],
+      },
+    },
+  },
   AppBskyVideoDefs: {
     lexicon: 1,
     id: 'app.bsky.video.defs',
@@ -9893,6 +10049,9 @@ export const schemaDict = {
           muted: {
             type: 'boolean',
           },
+          opened: {
+            type: 'boolean',
+          },
           unreadCount: {
             type: 'integer',
           },
@@ -10563,8 +10722,9 @@ export const schemaDict = {
       },
     },
   },
-}
-export const schemas: LexiconDoc[] = Object.values(schemaDict) as LexiconDoc[]
+} as const satisfies Record<string, LexiconDoc>
+
+export const schemas = Object.values(schemaDict)
 export const lexicons: Lexicons = new Lexicons(schemas)
 export const ids = {
   ComAtprotoAdminDefs: 'com.atproto.admin.defs',
@@ -10653,6 +10813,7 @@ export const ids = {
   ComAtprotoSyncNotifyOfUpdate: 'com.atproto.sync.notifyOfUpdate',
   ComAtprotoSyncRequestCrawl: 'com.atproto.sync.requestCrawl',
   ComAtprotoSyncSubscribeRepos: 'com.atproto.sync.subscribeRepos',
+  ComAtprotoTempAddReservedHandle: 'com.atproto.temp.addReservedHandle',
   ComAtprotoTempCheckSignupQueue: 'com.atproto.temp.checkSignupQueue',
   ComAtprotoTempFetchLabels: 'com.atproto.temp.fetchLabels',
   ComAtprotoTempRequestPhoneVerification:
@@ -10721,6 +10882,7 @@ export const ids = {
   AppBskyGraphMuteActor: 'app.bsky.graph.muteActor',
   AppBskyGraphMuteActorList: 'app.bsky.graph.muteActorList',
   AppBskyGraphMuteThread: 'app.bsky.graph.muteThread',
+  AppBskyGraphSearchStarterPacks: 'app.bsky.graph.searchStarterPacks',
   AppBskyGraphStarterpack: 'app.bsky.graph.starterpack',
   AppBskyGraphUnmuteActor: 'app.bsky.graph.unmuteActor',
   AppBskyGraphUnmuteActorList: 'app.bsky.graph.unmuteActorList',
@@ -10746,6 +10908,8 @@ export const ids = {
   AppBskyUnspeccedSearchActorsSkeleton:
     'app.bsky.unspecced.searchActorsSkeleton',
   AppBskyUnspeccedSearchPostsSkeleton: 'app.bsky.unspecced.searchPostsSkeleton',
+  AppBskyUnspeccedSearchStarterPacksSkeleton:
+    'app.bsky.unspecced.searchStarterPacksSkeleton',
   AppBskyVideoDefs: 'app.bsky.video.defs',
   AppBskyVideoGetJobStatus: 'app.bsky.video.getJobStatus',
   AppBskyVideoGetUploadLimits: 'app.bsky.video.getUploadLimits',

package/src/lexicon/types/app/bsky/graph/searchStarterPacks.ts

@@ -0,0 +1,50 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import express from 'express'
+import { ValidationResult, BlobRef } from '@atproto/lexicon'
+import { lexicons } from '../../../../lexicons'
+import { isObj, hasProp } from '../../../../util'
+import { CID } from 'multiformats/cid'
+import { HandlerAuth, HandlerPipeThrough } from '@atproto/xrpc-server'
+import * as AppBskyGraphDefs from './defs'
+
+export interface QueryParams {
+  /** Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. */
+  q: string
+  limit: number
+  cursor?: string
+}
+
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  cursor?: string
+  starterPacks: AppBskyGraphDefs.StarterPackViewBasic[]
+  [k: string]: unknown
+}
+
+export type HandlerInput = undefined
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess | HandlerPipeThrough
+export type HandlerReqCtx<HA extends HandlerAuth = never> = {
+  auth: HA
+  params: QueryParams
+  input: HandlerInput
+  req: express.Request
+  res: express.Response
+}
+export type Handler<HA extends HandlerAuth = never> = (
+  ctx: HandlerReqCtx<HA>,
+) => Promise<HandlerOutput> | HandlerOutput

package/src/lexicon/types/app/bsky/unspecced/defs.ts

@@ -39,3 +39,27 @@ export function isSkeletonSearchActor(v: unknown): v is SkeletonSearchActor {
 export function validateSkeletonSearchActor(v: unknown): ValidationResult {
   return lexicons.validate('app.bsky.unspecced.defs#skeletonSearchActor', v)
 }
+
+export interface SkeletonSearchStarterPack {
+  uri: string
+  [k: string]: unknown
+}
+
+export function isSkeletonSearchStarterPack(
+  v: unknown,
+): v is SkeletonSearchStarterPack {
+  return (
+    isObj(v) &&
+    hasProp(v, '$type') &&
+    v.$type === 'app.bsky.unspecced.defs#skeletonSearchStarterPack'
+  )
+}
+
+export function validateSkeletonSearchStarterPack(
+  v: unknown,
+): ValidationResult {
+  return lexicons.validate(
+    'app.bsky.unspecced.defs#skeletonSearchStarterPack',
+    v,
+  )
+}

package/src/lexicon/types/app/bsky/unspecced/searchStarterPacksSkeleton.ts

@@ -0,0 +1,56 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import express from 'express'
+import { ValidationResult, BlobRef } from '@atproto/lexicon'
+import { lexicons } from '../../../../lexicons'
+import { isObj, hasProp } from '../../../../util'
+import { CID } from 'multiformats/cid'
+import { HandlerAuth, HandlerPipeThrough } from '@atproto/xrpc-server'
+import * as AppBskyUnspeccedDefs from './defs'
+
+export interface QueryParams {
+  /** Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. */
+  q: string
+  /** DID of the account making the request (not included for public/unauthenticated queries). */
+  viewer?: string
+  limit: number
+  /** Optional pagination mechanism; may not necessarily allow scrolling through entire result set. */
+  cursor?: string
+}
+
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  cursor?: string
+  /** Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits. */
+  hitsTotal?: number
+  starterPacks: AppBskyUnspeccedDefs.SkeletonSearchStarterPack[]
+  [k: string]: unknown
+}
+
+export type HandlerInput = undefined
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+  error?: 'BadQueryString'
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess | HandlerPipeThrough
+export type HandlerReqCtx<HA extends HandlerAuth = never> = {
+  auth: HA
+  params: QueryParams
+  input: HandlerInput
+  req: express.Request
+  res: express.Response
+}
+export type Handler<HA extends HandlerAuth = never> = (
+  ctx: HandlerReqCtx<HA>,
+) => Promise<HandlerOutput> | HandlerOutput

package/src/lexicon/types/chat/bsky/convo/defs.ts

@@ -118,6 +118,7 @@ export interface ConvoView {
     | DeletedMessageView
     | { $type: string; [k: string]: unknown }
   muted: boolean
+  opened?: boolean
   unreadCount: number
   [k: string]: unknown
 }

package/src/lexicon/types/com/atproto/temp/addReservedHandle.ts

@@ -0,0 +1,48 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import express from 'express'
+import { ValidationResult, BlobRef } from '@atproto/lexicon'
+import { lexicons } from '../../../../lexicons'
+import { isObj, hasProp } from '../../../../util'
+import { CID } from 'multiformats/cid'
+import { HandlerAuth, HandlerPipeThrough } from '@atproto/xrpc-server'
+
+export interface QueryParams {}
+
+export interface InputSchema {
+  handle: string
+  [k: string]: unknown
+}
+
+export interface OutputSchema {
+  [k: string]: unknown
+}
+
+export interface HandlerInput {
+  encoding: 'application/json'
+  body: InputSchema
+}
+
+export interface HandlerSuccess {
+  encoding: 'application/json'
+  body: OutputSchema
+  headers?: { [key: string]: string }
+}
+
+export interface HandlerError {
+  status: number
+  message?: string
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess | HandlerPipeThrough
+export type HandlerReqCtx<HA extends HandlerAuth = never> = {
+  auth: HA
+  params: QueryParams
+  input: HandlerInput
+  req: express.Request
+  res: express.Response
+}
+export type Handler<HA extends HandlerAuth = never> = (
+  ctx: HandlerReqCtx<HA>,
+) => Promise<HandlerOutput> | HandlerOutput