@atproto/pds 0.3.13 → 0.3.14

package/dist/lexicon/index.d.ts

@@ -114,6 +114,7 @@ import * as AppBskyNotificationListNotifications from './types/app/bsky/notifica
 import * as AppBskyNotificationRegisterPush from './types/app/bsky/notification/registerPush';
 import * as AppBskyNotificationUpdateSeen from './types/app/bsky/notification/updateSeen';
 import * as AppBskyUnspeccedGetPopularFeedGenerators from './types/app/bsky/unspecced/getPopularFeedGenerators';
+import * as AppBskyUnspeccedGetTaggedSuggestions from './types/app/bsky/unspecced/getTaggedSuggestions';
 import * as AppBskyUnspeccedGetTimelineSkeleton from './types/app/bsky/unspecced/getTimelineSkeleton';
 import * as AppBskyUnspeccedSearchActorsSkeleton from './types/app/bsky/unspecced/searchActorsSkeleton';
 import * as AppBskyUnspeccedSearchPostsSkeleton from './types/app/bsky/unspecced/searchPostsSkeleton';
@@ -349,6 +350,7 @@ export declare class AppBskyUnspeccedNS {
     _server: Server;
     constructor(server: Server);
     getPopularFeedGenerators<AV extends AuthVerifier>(cfg: ConfigOf<AV, AppBskyUnspeccedGetPopularFeedGenerators.Handler<ExtractAuth<AV>>, AppBskyUnspeccedGetPopularFeedGenerators.HandlerReqCtx<ExtractAuth<AV>>>): void;
+    getTaggedSuggestions<AV extends AuthVerifier>(cfg: ConfigOf<AV, AppBskyUnspeccedGetTaggedSuggestions.Handler<ExtractAuth<AV>>, AppBskyUnspeccedGetTaggedSuggestions.HandlerReqCtx<ExtractAuth<AV>>>): void;
     getTimelineSkeleton<AV extends AuthVerifier>(cfg: ConfigOf<AV, AppBskyUnspeccedGetTimelineSkeleton.Handler<ExtractAuth<AV>>, AppBskyUnspeccedGetTimelineSkeleton.HandlerReqCtx<ExtractAuth<AV>>>): void;
     searchActorsSkeleton<AV extends AuthVerifier>(cfg: ConfigOf<AV, AppBskyUnspeccedSearchActorsSkeleton.Handler<ExtractAuth<AV>>, AppBskyUnspeccedSearchActorsSkeleton.HandlerReqCtx<ExtractAuth<AV>>>): void;
     searchPostsSkeleton<AV extends AuthVerifier>(cfg: ConfigOf<AV, AppBskyUnspeccedSearchPostsSkeleton.Handler<ExtractAuth<AV>>, AppBskyUnspeccedSearchPostsSkeleton.HandlerReqCtx<ExtractAuth<AV>>>): void;

package/dist/lexicon/lexicons.d.ts

@@ -7423,6 +7423,53 @@ export declare const schemaDict: {
             };
         };
     };
+    AppBskyUnspeccedGetTaggedSuggestions: {
+        lexicon: number;
+        id: string;
+        defs: {
+            main: {
+                type: string;
+                description: string;
+                parameters: {
+                    type: string;
+                    properties: {};
+                };
+                output: {
+                    encoding: string;
+                    schema: {
+                        type: string;
+                        required: string[];
+                        properties: {
+                            suggestions: {
+                                type: string;
+                                items: {
+                                    type: string;
+                                    ref: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            suggestion: {
+                type: string;
+                required: string[];
+                properties: {
+                    tag: {
+                        type: string;
+                    };
+                    subjectType: {
+                        type: string;
+                        knownValues: string[];
+                    };
+                    subject: {
+                        type: string;
+                        format: string;
+                    };
+                };
+            };
+        };
+    };
     AppBskyUnspeccedGetTimelineSkeleton: {
         lexicon: number;
         id: string;
@@ -7729,6 +7776,7 @@ export declare const ids: {
     AppBskyRichtextFacet: string;
     AppBskyUnspeccedDefs: string;
     AppBskyUnspeccedGetPopularFeedGenerators: string;
+    AppBskyUnspeccedGetTaggedSuggestions: string;
     AppBskyUnspeccedGetTimelineSkeleton: string;
     AppBskyUnspeccedSearchActorsSkeleton: string;
     AppBskyUnspeccedSearchPostsSkeleton: string;

package/dist/lexicon/types/app/bsky/unspecced/getTaggedSuggestions.d.ts

@@ -0,0 +1,39 @@
+import express from 'express';
+import { ValidationResult } from '@atproto/lexicon';
+import { HandlerAuth } from '@atproto/xrpc-server';
+export interface QueryParams {
+}
+export type InputSchema = undefined;
+export interface OutputSchema {
+    suggestions: Suggestion[];
+    [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;
+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;
+export interface Suggestion {
+    tag: string;
+    subjectType: 'actor' | 'feed' | (string & {});
+    subject: string;
+    [k: string]: unknown;
+}
+export declare function isSuggestion(v: unknown): v is Suggestion;
+export declare function validateSuggestion(v: unknown): ValidationResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/pds",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "license": "MIT",
   "description": "Reference implementation of atproto Personal Data Server (PDS)",
   "keywords": [
@@ -44,7 +44,7 @@
     "typed-emitter": "^2.1.0",
     "uint8arrays": "3.0.0",
     "zod": "^3.21.4",
-    "@atproto/api": "^0.9.2",
+    "@atproto/api": "^0.9.3",
     "@atproto/aws": "^0.1.6",
     "@atproto/common": "^0.3.3",
     "@atproto/crypto": "^0.3.0",
@@ -68,9 +68,9 @@
     "axios": "^0.27.2",
     "get-port": "^6.1.2",
     "ws": "^8.12.0",
-    "@atproto/api": "^0.9.2",
-    "@atproto/bsky": "^0.0.25",
-    "@atproto/dev-env": "^0.2.25",
+    "@atproto/api": "^0.9.3",
+    "@atproto/bsky": "^0.0.26",
+    "@atproto/dev-env": "^0.2.26",
     "@atproto/lex-cli": "^0.3.0"
   },
   "scripts": {

package/src/api/app/bsky/unspecced/getTaggedSuggestions.ts

@@ -0,0 +1,21 @@
+import { Server } from '../../../../lexicon'
+import AppContext from '../../../../context'
+
+// THIS IS A TEMPORARY UNSPECCED ROUTE
+export default function (server: Server, ctx: AppContext) {
+  server.app.bsky.unspecced.getTaggedSuggestions({
+    auth: ctx.authVerifier.access,
+    handler: async ({ auth, params }) => {
+      const requester = auth.credentials.did
+      const res =
+        await ctx.appViewAgent.api.app.bsky.unspecced.getTaggedSuggestions(
+          params,
+          await ctx.appviewAuthHeaders(requester),
+        )
+      return {
+        encoding: 'application/json',
+        body: res.data,
+      }
+    },
+  })
+}

package/src/api/app/bsky/unspecced/index.ts

@@ -1,8 +1,10 @@
 import { Server } from '../../../../lexicon'
 import AppContext from '../../../../context'
 import getPopularFeedGenerators from './getPopularFeedGenerators'
+import getTaggedSuggestions from './getTaggedSuggestions'
 
 // THIS IS A TEMPORARY UNSPECCED ROUTE
 export default function (server: Server, ctx: AppContext) {
   getPopularFeedGenerators(server, ctx)
+  getTaggedSuggestions(server, ctx)
 }

package/src/lexicon/index.ts

@@ -124,6 +124,7 @@ import * as AppBskyNotificationListNotifications from './types/app/bsky/notifica
 import * as AppBskyNotificationRegisterPush from './types/app/bsky/notification/registerPush'
 import * as AppBskyNotificationUpdateSeen from './types/app/bsky/notification/updateSeen'
 import * as AppBskyUnspeccedGetPopularFeedGenerators from './types/app/bsky/unspecced/getPopularFeedGenerators'
+import * as AppBskyUnspeccedGetTaggedSuggestions from './types/app/bsky/unspecced/getTaggedSuggestions'
 import * as AppBskyUnspeccedGetTimelineSkeleton from './types/app/bsky/unspecced/getTimelineSkeleton'
 import * as AppBskyUnspeccedSearchActorsSkeleton from './types/app/bsky/unspecced/searchActorsSkeleton'
 import * as AppBskyUnspeccedSearchPostsSkeleton from './types/app/bsky/unspecced/searchPostsSkeleton'
@@ -1613,6 +1614,17 @@ export class AppBskyUnspeccedNS {
     return this._server.xrpc.method(nsid, cfg)
   }
 
+  getTaggedSuggestions<AV extends AuthVerifier>(
+    cfg: ConfigOf<
+      AV,
+      AppBskyUnspeccedGetTaggedSuggestions.Handler<ExtractAuth<AV>>,
+      AppBskyUnspeccedGetTaggedSuggestions.HandlerReqCtx<ExtractAuth<AV>>
+    >,
+  ) {
+    const nsid = 'app.bsky.unspecced.getTaggedSuggestions' // @ts-ignore
+    return this._server.xrpc.method(nsid, cfg)
+  }
+
   getTimelineSkeleton<AV extends AuthVerifier>(
     cfg: ConfigOf<
       AV,

package/src/lexicon/lexicons.ts

@@ -7908,6 +7908,54 @@ export const schemaDict = {
       },
     },
   },
+  AppBskyUnspeccedGetTaggedSuggestions: {
+    lexicon: 1,
+    id: 'app.bsky.unspecced.getTaggedSuggestions',
+    defs: {
+      main: {
+        type: 'query',
+        description:
+          'Get a list of suggestions (feeds and users) tagged with categories',
+        parameters: {
+          type: 'params',
+          properties: {},
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['suggestions'],
+            properties: {
+              suggestions: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:app.bsky.unspecced.getTaggedSuggestions#suggestion',
+                },
+              },
+            },
+          },
+        },
+      },
+      suggestion: {
+        type: 'object',
+        required: ['tag', 'subjectType', 'subject'],
+        properties: {
+          tag: {
+            type: 'string',
+          },
+          subjectType: {
+            type: 'string',
+            knownValues: ['actor', 'feed'],
+          },
+          subject: {
+            type: 'string',
+            format: 'uri',
+          },
+        },
+      },
+    },
+  },
   AppBskyUnspeccedGetTimelineSkeleton: {
     lexicon: 1,
     id: 'app.bsky.unspecced.getTimelineSkeleton',
@@ -8242,6 +8290,8 @@ export const ids = {
   AppBskyUnspeccedDefs: 'app.bsky.unspecced.defs',
   AppBskyUnspeccedGetPopularFeedGenerators:
     'app.bsky.unspecced.getPopularFeedGenerators',
+  AppBskyUnspeccedGetTaggedSuggestions:
+    'app.bsky.unspecced.getTaggedSuggestions',
   AppBskyUnspeccedGetTimelineSkeleton: 'app.bsky.unspecced.getTimelineSkeleton',
   AppBskyUnspeccedSearchActorsSkeleton:
     'app.bsky.unspecced.searchActorsSkeleton',

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

@@ -0,0 +1,65 @@
+/**
+ * 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 } from '@atproto/xrpc-server'
+
+export interface QueryParams {}
+
+export type InputSchema = undefined
+
+export interface OutputSchema {
+  suggestions: Suggestion[]
+  [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
+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
+
+export interface Suggestion {
+  tag: string
+  subjectType: 'actor' | 'feed' | (string & {})
+  subject: string
+  [k: string]: unknown
+}
+
+export function isSuggestion(v: unknown): v is Suggestion {
+  return (
+    isObj(v) &&
+    hasProp(v, '$type') &&
+    v.$type === 'app.bsky.unspecced.getTaggedSuggestions#suggestion'
+  )
+}
+
+export function validateSuggestion(v: unknown): ValidationResult {
+  return lexicons.validate(
+    'app.bsky.unspecced.getTaggedSuggestions#suggestion',
+    v,
+  )
+}