Merge branch 'main' into shuuji3/test/setup-bsky-appview

Author: shuuji3

README.md

@@ -0,0 +1 @@
+packages/client/README.md

README.md

@@ -0,0 +1,84 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tsky-dev/tsky/refs/heads/main/.github/assets/tsky-logo.png" width="200" height="200">
+</p>
+
+<h1 align="center">tsky</h1>
+
+<p align="center">
+  A lightweight, fast, universal and typed Bluesky API wrapper for Apps & Bots.
+</p>
+
+## ⚠️ tsky is still in development and is not ready for production use
+
+tsky is still in active development and is not ready for production use. If you want to contribute to the project, please read the [CONTRIBUTING.md](../../CONTRIBUTING.md) file or join our [Discord Server](https://discord.gg/KPD7XPUZn3).
+
+tsky is a lightweight, fast, universal and typed Bluesky API wrapper for Apps & Bots. It's designed to be easy to use, lightweight and straightforward to use. It's built with TypeScript and has full type support.
+
+It was primarily built for the [Nimbus Client](https://github.com/nimbus-town/nimbus) but can be used in any other project that requires Bluesky API integration.
+
+## Installation
+
+```bash
+# NPM
+npm install tsky
+
+# Yarn
+yarn add tsky
+
+# PNPM
+pnpm add tsky
+
+# Bun
+bun add tsky
+```
+
+## Usage
+
+Using a Public Agent
+
+```ts
+import { createAgent } from '@tsky/client';
+
+const agent = await createAgent({
+  options: {
+    service: 'https://public.api.bsky.app',
+  },
+});
+
+// Getting a user from their handle
+// First, we need to get the user's DID
+const did = await agent.resolveDIDFromHandle(handle);
+// Then, we can get the user's profile
+const profile = await agent.actor(did);
+```
+
+Using an Authenticated Agent
+
+```ts
+import { createAgent } from '@tsky/client';
+
+const agent = await createAgent({
+  credentials: {
+    identifier: "handle",
+      password: "password"
+  }
+});
+
+// Getting the profile of the authenticated user
+const user_profile = await agent.user.profile();
+```
+
+## Links
+
+- [📚 tsky Documentation](https://tsky.dev/)
+- [🦋 tsky on Bluesky](https://bsky.app/profile/tsky.dev)
+- [📣 tsky Discord Server](https://discord.gg/KPD7XPUZn3)
+- [🦋 Nimbus on Bluesky](https://bsky.app/profile/nimbus.town)
+
+## Contributing
+
+If you want to contribute to this project, please read the [CONTRIBUTING.md](../../CONTRIBUTING.md) file.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/tsky-dev/tsky/blob/main/LICENSE) file for details.

packages/client/README.md

@@ -1,7 +1,7 @@
 {
   "name": "@tsky/client",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -31,6 +31,15 @@
     "test:coverage": "bash ../internal/dev-infra/with-test-redis-and-db.sh vitest --coverage",
     "test:typescript": "tsc --noEmit"
   },
+  "homepage": "https://tsky.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tsky-dev/tsky.git",
+    "directory": "packages/client"
+  },
+  "bugs": {
+    "url": "https://github.com/tsky-dev/tsky/issues"
+  },
   "dependencies": {
     "@atcute/client": "^2.0.6"
   },

packages/client/package.json

@@ -368,9 +368,25 @@ export const userTypeSchema = t.isOneOf([
 
 export type UserTypeSchema = t.InferType<typeof userTypeSchema>;
 
+/**
+ * represents a namespace identifier (NSID)
+ */
+export type Nsid = `${string}.${string}.${string}`;
+
 const NSID_RE =
-  /^[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)+\.[a-z]{1,63}$/i;
-const nsidType = t.cascade(t.isString(), (value) => NSID_RE.test(value));
+  /^[a-zA-Z](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+\.[a-zA-Z][a-zA-Z0-9]{0,62}?$/;
+
+// #__NO_SIDE_EFFECTS__
+export const isNsid = (input: unknown): input is Nsid => {
+  return (
+    typeof input === 'string' &&
+    input.length >= 5 &&
+    input.length <= 317 &&
+    NSID_RE.test(input)
+  );
+};
+
+const nsidType = t.cascade(t.isString(), (value) => isNsid(value));
 
 export const documentSchema = t.cascade(
   t.isObject({

packages/lex-cli/src/generator/schema.ts

@@ -5,9 +5,9 @@
  * @module
  * Contains type declarations for Bluesky lexicons
  * @generated
- * Generated on: 2025-04-25T03:38:32.224Z
+ * Generated on: 2025-05-21T07:58:36.895Z
  * Version: main
- * Source: https://github.com/bluesky-social/atproto/tree/45354c84f898d79f58c14b5c0da3661beb7353f9/lexicons
+ * Source: https://github.com/bluesky-social/atproto/tree/24e20b96c6d39100cfe016c549e2f4d9184fa770/lexicons
  */
 
 /** Base type with optional type field */
@@ -268,6 +268,7 @@ export declare namespace AppBskyActorDefs {
     displayName?: string;
     indexedAt?: string;
     labels?: ComAtprotoLabelDefs.Label[];
+    status?: StatusView;
     verification?: VerificationState;
     viewer?: ViewerState;
   }
@@ -283,6 +284,7 @@ export declare namespace AppBskyActorDefs {
      */
     displayName?: string;
     labels?: ComAtprotoLabelDefs.Label[];
+    status?: StatusView;
     verification?: VerificationState;
     viewer?: ViewerState;
   }
@@ -310,6 +312,7 @@ export declare namespace AppBskyActorDefs {
     labels?: ComAtprotoLabelDefs.Label[];
     pinnedPost?: ComAtprotoRepoStrongRef.Main;
     postsCount?: number;
+    status?: StatusView;
     verification?: VerificationState;
     viewer?: ViewerState;
   }
@@ -327,6 +330,17 @@ export declare namespace AppBskyActorDefs {
   interface SavedFeedsPrefV2 extends TypedBase {
     items: AppBskyActorDefs.SavedFeed[];
   }
+  interface StatusView extends TypedBase {
+    record: unknown;
+    /** The status for the account. */
+    status: "app.bsky.actor.status#live" | (string & {});
+    /** An optional embed associated with the status. */
+    embed?: TypeUnion<AppBskyEmbedExternal.View>;
+    /** The date when this status will expire. The application might choose to no longer return the status after expiration. */
+    expiresAt?: string;
+    /** True if the status is not expired, false if it is expired. Only present if expiration was set. */
+    isActive?: boolean;
+  }
   interface ThreadViewPref extends TypedBase {
     /** Show followed users at the top of all replies. */
     prioritizeFollowedUsers?: boolean;
@@ -514,6 +528,24 @@ export declare namespace AppBskyActorSearchActorsTypeahead {
   }
 }
 
+export declare namespace AppBskyActorStatus {
+  /** A declaration of a Bluesky account status. */
+  interface Record extends RecordBase {
+    $type: "app.bsky.actor.status";
+    createdAt: string;
+    /** The status for the account. */
+    status: "app.bsky.actor.status#live" | (string & {});
+    /**
+     * The duration of the status in minutes. Applications can choose to impose minimum and maximum limits.
+     * Minimum: 1
+     */
+    durationMinutes?: number;
+    /** An optional embed associated with the status. */
+    embed?: TypeUnion<AppBskyEmbedExternal.Main>;
+  }
+  type Live = "app.bsky.actor.status#live";
+}
+
 export declare namespace AppBskyEmbedDefs {
   /** width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit. */
   interface AspectRatio extends TypedBase {
@@ -698,6 +730,11 @@ export declare namespace AppBskyFeedDefs {
     feedContext?: string;
     reason?: TypeUnion<ReasonPin | ReasonRepost>;
     reply?: ReplyRef;
+    /**
+     * Unique identifier per request that may be passed back alongside interactions.
+     * Maximum string length: 100
+     */
+    reqId?: string;
   }
   interface GeneratorView extends TypedBase {
     cid: At.CID;
@@ -747,6 +784,11 @@ export declare namespace AppBskyFeedDefs {
      */
     feedContext?: string;
     item?: At.Uri;
+    /**
+     * Unique identifier per request that may be passed back alongside interactions.
+     * Maximum string length: 100
+     */
+    reqId?: string;
   }
   type InteractionLike = "app.bsky.feed.defs#interactionLike";
   type InteractionQuote = "app.bsky.feed.defs#interactionQuote";
@@ -1023,6 +1065,11 @@ export declare namespace AppBskyFeedGetFeedSkeleton {
   interface Output extends TypedBase {
     feed: AppBskyFeedDefs.SkeletonFeedPost[];
     cursor?: string;
+    /**
+     * Unique identifier per request that may be passed back alongside interactions.
+     * Maximum string length: 100
+     */
+    reqId?: string;
   }
   interface Errors extends TypedBase {
     UnknownFeed: {};
@@ -1324,7 +1371,7 @@ export declare namespace AppBskyFeedRepost {
   }
 }
 
-/** Find posts matching search criteria, returning views of those posts. */
+/** Find posts matching search criteria, returning views of those posts. Note that this API endpoint may require authentication (eg, not public) for some service providers and implementations. */
 export declare namespace AppBskyFeedSearchPosts {
   interface Params extends TypedBase {
     /** Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. */
@@ -2195,6 +2242,11 @@ export declare namespace AppBskyUnspeccedGetConfig {
   type Input = undefined;
   interface Output extends TypedBase {
     checkEmailConfirmed?: boolean;
+    liveNow?: LiveNowConfig[];
+  }
+  interface LiveNowConfig extends TypedBase {
+    did: At.DID;
+    domains: string[];
   }
 }
 
@@ -6089,6 +6141,7 @@ export declare namespace ToolsOzoneVerificationRevokeVerifications {
 
 export declare interface Records extends RecordBase {
   "app.bsky.actor.profile": AppBskyActorProfile.Record;
+  "app.bsky.actor.status": AppBskyActorStatus.Record;
   "app.bsky.feed.generator": AppBskyFeedGenerator.Record;
   "app.bsky.feed.like": AppBskyFeedLike.Record;
   "app.bsky.feed.post": AppBskyFeedPost.Record;