@singi-labs/sifa-sdk 0.9.19 → 0.9.20

package/dist/feed-DHTy7fUN.d.cts

@@ -0,0 +1,254 @@
+import { z } from 'zod';
+
+/**
+ * Profile row shared across `/api/following`, `/api/profile/:handleOrDid/mutuals`,
+ * and `/api/me/bluesky-suggestions`. Matches the existing `FollowProfile` TS
+ * interface byte-for-byte but adds runtime validation for the SDK's pagination
+ * helpers and the upcoming `sifa-app` consumer (where we can't trust the wire).
+ *
+ * Per `sifa-api#674` PR body: mutuals + bluesky-suggestions reuse this shape
+ * exactly, so a single Zod schema covers all three endpoints.
+ */
+declare const FollowProfileSchema: z.ZodObject<{
+    did: z.ZodString;
+    handle: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    headline: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    source: z.ZodString;
+    claimed: z.ZodBoolean;
+    followedAt: z.ZodString;
+    blueskyVerified: z.ZodOptional<z.ZodBoolean>;
+    blueskyVerifiedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type FollowProfileItem = z.infer<typeof FollowProfileSchema>;
+/**
+ * Cursor-paginated page of {@link FollowProfileSchema} rows. Used by mutuals
+ * + bluesky-suggestions. The legacy `/api/following` endpoint uses a different
+ * wrapper key (`follows` instead of `items`) and is intentionally NOT covered
+ * by this schema.
+ */
+declare const FollowProfilePageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        headline: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+        claimed: z.ZodBoolean;
+        followedAt: z.ZodString;
+        blueskyVerified: z.ZodOptional<z.ZodBoolean>;
+        blueskyVerifiedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type FollowProfilePage = z.infer<typeof FollowProfilePageSchema>;
+/**
+ * Per-flag allowlist row returned by `GET /api/admin/feature-allowlists/:flag`.
+ * Mirrors the `feature_allowlists` table; `note` is optional free-form text.
+ */
+declare const FeatureAllowlistEntrySchema: z.ZodObject<{
+    did: z.ZodString;
+    addedAt: z.ZodString;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type FeatureAllowlistEntry = z.infer<typeof FeatureAllowlistEntrySchema>;
+/**
+ * Known feature flags accepted by the admin allowlist endpoints. Mirrors the
+ * server-side `FEATURE_FLAGS` const in `sifa-api`. Kept as a `const` tuple so
+ * consumers can `as const`-narrow when building UIs.
+ */
+declare const FEATURE_FLAGS: readonly ["FEED_V5_ENABLED"];
+type FeatureFlag = (typeof FEATURE_FLAGS)[number];
+
+/**
+ * Feed item from `GET /api/following/feed`. Discriminated on `source`:
+ *
+ * - `sifa`: a Sifa-native event (e.g. profile update, endorsement).
+ * - `atmosphere`: a curated creation event from another ATproto app
+ *   (Barazo post, etc.). Payload is the hydrated `app.bsky.embed.*#view`
+ *   shape, NOT the raw record (per memory `sifa-hydrated-view-embed-types`).
+ *
+ * Both variants share `actor`, `indexedAt`, and `id` (the materialized
+ * `feed_events.id` row identifier, used in the cursor).
+ */
+declare const FeedActorSchema: z.ZodObject<{
+    did: z.ZodString;
+    handle: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type FeedActor = z.infer<typeof FeedActorSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const SifaFeedItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"sifa">;
+    appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type SifaFeedItem = z.infer<typeof SifaFeedItemSchema>;
+/**
+ * ATmosphere feed item. `payload` is intentionally permissive: it carries
+ * a hydrated `app.bsky.embed.*#view` shape that varies by source app. The
+ * AppView resolves the hydration; clients render via the existing
+ * embed-view union (mirrors `sifa-web/src/components/stream/`).
+ *
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const AtmosphereFeedItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"atmosphere">;
+    appId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    cid: z.ZodOptional<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type AtmosphereFeedItem = z.infer<typeof AtmosphereFeedItemSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const FollowFeedItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"sifa">;
+    appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"atmosphere">;
+    appId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    cid: z.ZodOptional<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>], "source">;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type FollowFeedItem = z.infer<typeof FollowFeedItemSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const FollowFeedPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        indexedAt: z.ZodString;
+        eventType: z.ZodString;
+        source: z.ZodLiteral<"sifa">;
+        appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        indexedAt: z.ZodString;
+        eventType: z.ZodString;
+        source: z.ZodLiteral<"atmosphere">;
+        appId: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        cid: z.ZodOptional<z.ZodString>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>], "source">>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type FollowFeedPage = z.infer<typeof FollowFeedPageSchema>;
+/**
+ * Composite feed cursor `(indexedAt DESC, source, id)`. Encoded as a
+ * URL-safe base64 string so it survives `URLSearchParams` round-trips
+ * without further encoding. Decoupling encode/decode from the API call
+ * lets consumers persist cursors (e.g. for "jump-back-here" UX) and
+ * lets us unit-test the format.
+ */
+interface FeedCursor {
+    indexedAt: string;
+    source: 'sifa' | 'atmosphere';
+    id: string;
+}
+declare function encodeFeedCursor(cursor: FeedCursor): string;
+declare function decodeFeedCursor(encoded: string): FeedCursor;
+
+export { type AtmosphereFeedItem as A, type FollowFeedPage as F, type SifaFeedItem as S, type FollowProfileItem as a, type FeatureAllowlistEntry as b, type FeatureFlag as c, AtmosphereFeedItemSchema as d, FEATURE_FLAGS as e, FeatureAllowlistEntrySchema as f, type FeedActor as g, FeedActorSchema as h, type FeedCursor as i, type FollowFeedItem as j, FollowFeedItemSchema as k, FollowFeedPageSchema as l, type FollowProfilePage as m, FollowProfilePageSchema as n, FollowProfileSchema as o, SifaFeedItemSchema as p, decodeFeedCursor as q, encodeFeedCursor as r };

package/dist/feed-DHTy7fUN.d.ts

@@ -0,0 +1,254 @@
+import { z } from 'zod';
+
+/**
+ * Profile row shared across `/api/following`, `/api/profile/:handleOrDid/mutuals`,
+ * and `/api/me/bluesky-suggestions`. Matches the existing `FollowProfile` TS
+ * interface byte-for-byte but adds runtime validation for the SDK's pagination
+ * helpers and the upcoming `sifa-app` consumer (where we can't trust the wire).
+ *
+ * Per `sifa-api#674` PR body: mutuals + bluesky-suggestions reuse this shape
+ * exactly, so a single Zod schema covers all three endpoints.
+ */
+declare const FollowProfileSchema: z.ZodObject<{
+    did: z.ZodString;
+    handle: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    headline: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    source: z.ZodString;
+    claimed: z.ZodBoolean;
+    followedAt: z.ZodString;
+    blueskyVerified: z.ZodOptional<z.ZodBoolean>;
+    blueskyVerifiedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type FollowProfileItem = z.infer<typeof FollowProfileSchema>;
+/**
+ * Cursor-paginated page of {@link FollowProfileSchema} rows. Used by mutuals
+ * + bluesky-suggestions. The legacy `/api/following` endpoint uses a different
+ * wrapper key (`follows` instead of `items`) and is intentionally NOT covered
+ * by this schema.
+ */
+declare const FollowProfilePageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        headline: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+        claimed: z.ZodBoolean;
+        followedAt: z.ZodString;
+        blueskyVerified: z.ZodOptional<z.ZodBoolean>;
+        blueskyVerifiedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type FollowProfilePage = z.infer<typeof FollowProfilePageSchema>;
+/**
+ * Per-flag allowlist row returned by `GET /api/admin/feature-allowlists/:flag`.
+ * Mirrors the `feature_allowlists` table; `note` is optional free-form text.
+ */
+declare const FeatureAllowlistEntrySchema: z.ZodObject<{
+    did: z.ZodString;
+    addedAt: z.ZodString;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type FeatureAllowlistEntry = z.infer<typeof FeatureAllowlistEntrySchema>;
+/**
+ * Known feature flags accepted by the admin allowlist endpoints. Mirrors the
+ * server-side `FEATURE_FLAGS` const in `sifa-api`. Kept as a `const` tuple so
+ * consumers can `as const`-narrow when building UIs.
+ */
+declare const FEATURE_FLAGS: readonly ["FEED_V5_ENABLED"];
+type FeatureFlag = (typeof FEATURE_FLAGS)[number];
+
+/**
+ * Feed item from `GET /api/following/feed`. Discriminated on `source`:
+ *
+ * - `sifa`: a Sifa-native event (e.g. profile update, endorsement).
+ * - `atmosphere`: a curated creation event from another ATproto app
+ *   (Barazo post, etc.). Payload is the hydrated `app.bsky.embed.*#view`
+ *   shape, NOT the raw record (per memory `sifa-hydrated-view-embed-types`).
+ *
+ * Both variants share `actor`, `indexedAt`, and `id` (the materialized
+ * `feed_events.id` row identifier, used in the cursor).
+ */
+declare const FeedActorSchema: z.ZodObject<{
+    did: z.ZodString;
+    handle: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type FeedActor = z.infer<typeof FeedActorSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const SifaFeedItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"sifa">;
+    appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type SifaFeedItem = z.infer<typeof SifaFeedItemSchema>;
+/**
+ * ATmosphere feed item. `payload` is intentionally permissive: it carries
+ * a hydrated `app.bsky.embed.*#view` shape that varies by source app. The
+ * AppView resolves the hydration; clients render via the existing
+ * embed-view union (mirrors `sifa-web/src/components/stream/`).
+ *
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const AtmosphereFeedItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"atmosphere">;
+    appId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    cid: z.ZodOptional<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type AtmosphereFeedItem = z.infer<typeof AtmosphereFeedItemSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const FollowFeedItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"sifa">;
+    appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    actor: z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    indexedAt: z.ZodString;
+    eventType: z.ZodString;
+    source: z.ZodLiteral<"atmosphere">;
+    appId: z.ZodString;
+    uri: z.ZodOptional<z.ZodString>;
+    cid: z.ZodOptional<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>], "source">;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type FollowFeedItem = z.infer<typeof FollowFeedItemSchema>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+declare const FollowFeedPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        indexedAt: z.ZodString;
+        eventType: z.ZodString;
+        source: z.ZodLiteral<"sifa">;
+        appId: z.ZodOptional<z.ZodLiteral<"sifa">>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        actor: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatarUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        indexedAt: z.ZodString;
+        eventType: z.ZodString;
+        source: z.ZodLiteral<"atmosphere">;
+        appId: z.ZodString;
+        uri: z.ZodOptional<z.ZodString>;
+        cid: z.ZodOptional<z.ZodString>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>], "source">>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * @deprecated The `/api/following/feed` surface was reverted (sifa-api#674).
+ *   Per `decisions/activity-data-strategy.md` the Sifa Timeline + ATmosphere
+ *   Stream are two distinct surfaces with different data paths (Barazo API
+ *   for Timeline, live PDS reads + Valkey for Stream). These collapsed feed
+ *   types are no longer consumed. Scheduled for removal in next major bump.
+ */
+type FollowFeedPage = z.infer<typeof FollowFeedPageSchema>;
+/**
+ * Composite feed cursor `(indexedAt DESC, source, id)`. Encoded as a
+ * URL-safe base64 string so it survives `URLSearchParams` round-trips
+ * without further encoding. Decoupling encode/decode from the API call
+ * lets consumers persist cursors (e.g. for "jump-back-here" UX) and
+ * lets us unit-test the format.
+ */
+interface FeedCursor {
+    indexedAt: string;
+    source: 'sifa' | 'atmosphere';
+    id: string;
+}
+declare function encodeFeedCursor(cursor: FeedCursor): string;
+declare function decodeFeedCursor(encoded: string): FeedCursor;
+
+export { type AtmosphereFeedItem as A, type FollowFeedPage as F, type SifaFeedItem as S, type FollowProfileItem as a, type FeatureAllowlistEntry as b, type FeatureFlag as c, AtmosphereFeedItemSchema as d, FEATURE_FLAGS as e, FeatureAllowlistEntrySchema as f, type FeedActor as g, FeedActorSchema as h, type FeedCursor as i, type FollowFeedItem as j, FollowFeedItemSchema as k, FollowFeedPageSchema as l, type FollowProfilePage as m, FollowProfilePageSchema as n, FollowProfileSchema as o, SifaFeedItemSchema as p, decodeFeedCursor as q, encodeFeedCursor as r };

package/dist/{index-DCpMh2Ny.d.cts → index-DYUYJxOs.d.cts}

@@ -318,4 +318,4 @@ interface Profile {
     externalAccounts?: ExternalAccount[];
 }
 
-export type { ActiveApp as A, Endorsement as E, FeedItem as F, LocationValue as L, ProfileSkill as P, SkillRef as S, TrustStat as T, VerifiedAccount as V, PdsProviderInfo as a, Profile as b, EndorsementData as c, ExternalAccount as d, ExternalAccountKeytraceClaim as e, LanguageProficiency as f, ProfileCertification as g, ProfileCourse as h, ProfileEducation as i, ProfileHonor as j, ProfileIndustry as k, ProfileLanguage as l, ProfileLocation as m, ProfileOverrideSource as n, ProfilePosition as o, ProfileProject as p, ProfilePublication as q, ProfileVolunteering as r, PublicationContributor as s, SkillSuggestion as t };
+export type { ActiveApp as A, ExternalAccount as E, FeedItem as F, LocationValue as L, ProfileSkill as P, SkillSuggestion as S, TrustStat as T, VerifiedAccount as V, PdsProviderInfo as a, Profile as b, Endorsement as c, EndorsementData as d, ExternalAccountKeytraceClaim as e, LanguageProficiency as f, ProfileCertification as g, ProfileCourse as h, ProfileEducation as i, ProfileHonor as j, ProfileIndustry as k, ProfileLanguage as l, ProfileLocation as m, ProfileOverrideSource as n, ProfilePosition as o, ProfileProject as p, ProfilePublication as q, ProfileVolunteering as r, PublicationContributor as s, SkillRef as t };

package/dist/{index-DCpMh2Ny.d.ts → index-DYUYJxOs.d.ts}

@@ -318,4 +318,4 @@ interface Profile {
     externalAccounts?: ExternalAccount[];
 }
 
-export type { ActiveApp as A, Endorsement as E, FeedItem as F, LocationValue as L, ProfileSkill as P, SkillRef as S, TrustStat as T, VerifiedAccount as V, PdsProviderInfo as a, Profile as b, EndorsementData as c, ExternalAccount as d, ExternalAccountKeytraceClaim as e, LanguageProficiency as f, ProfileCertification as g, ProfileCourse as h, ProfileEducation as i, ProfileHonor as j, ProfileIndustry as k, ProfileLanguage as l, ProfileLocation as m, ProfileOverrideSource as n, ProfilePosition as o, ProfileProject as p, ProfilePublication as q, ProfileVolunteering as r, PublicationContributor as s, SkillSuggestion as t };
+export type { ActiveApp as A, ExternalAccount as E, FeedItem as F, LocationValue as L, ProfileSkill as P, SkillSuggestion as S, TrustStat as T, VerifiedAccount as V, PdsProviderInfo as a, Profile as b, Endorsement as c, EndorsementData as d, ExternalAccountKeytraceClaim as e, LanguageProficiency as f, ProfileCertification as g, ProfileCourse as h, ProfileEducation as i, ProfileHonor as j, ProfileIndustry as k, ProfileLanguage as l, ProfileLocation as m, ProfileOverrideSource as n, ProfilePosition as o, ProfileProject as p, ProfilePublication as q, ProfileVolunteering as r, PublicationContributor as s, SkillRef as t };

package/dist/index.cjs

@@ -1754,8 +1754,97 @@ var EndorsementRecordSchema = zod.z.object({
 });
 var GraphFollowRecordSchema = zod.z.object({
   subject: didSchema,
-  createdAt: datetimeSchema
+  createdAt: datetimeSchema,
+  note: zod.z.string().refine(maxGraphemes(200), "note must be at most 200 graphemes").optional()
+});
+function makeGraphFollowRecordSchema(followerDid) {
+  return GraphFollowRecordSchema.refine((record) => record.subject !== followerDid, {
+    message: "Self-follow is not allowed",
+    path: ["subject"]
+  });
+}
+var FollowProfileSchema = zod.z.object({
+  did: didSchema,
+  handle: zod.z.string(),
+  displayName: zod.z.string().optional(),
+  headline: zod.z.string().optional(),
+  avatarUrl: zod.z.string().optional(),
+  source: zod.z.string(),
+  claimed: zod.z.boolean(),
+  followedAt: datetimeSchema,
+  blueskyVerified: zod.z.boolean().optional(),
+  blueskyVerifiedAt: datetimeSchema.nullable().optional()
+});
+var FollowProfilePageSchema = zod.z.object({
+  items: zod.z.array(FollowProfileSchema),
+  cursor: zod.z.string().nullable()
+});
+var FeatureAllowlistEntrySchema = zod.z.object({
+  did: didSchema,
+  addedAt: datetimeSchema,
+  note: zod.z.string().nullable().optional()
+});
+var FEATURE_FLAGS = ["FEED_V5_ENABLED"];
+var FeedActorSchema = zod.z.object({
+  did: didSchema,
+  handle: zod.z.string(),
+  displayName: zod.z.string().optional(),
+  avatarUrl: zod.z.string().optional()
+});
+var FeedItemBaseSchema = zod.z.object({
+  id: zod.z.string(),
+  actor: FeedActorSchema,
+  indexedAt: datetimeSchema,
+  eventType: zod.z.string()
+});
+var SifaFeedItemSchema = FeedItemBaseSchema.extend({
+  source: zod.z.literal("sifa"),
+  appId: zod.z.literal("sifa").optional(),
+  payload: zod.z.record(zod.z.string(), zod.z.unknown())
 });
+var AtmosphereFeedItemSchema = FeedItemBaseSchema.extend({
+  source: zod.z.literal("atmosphere"),
+  appId: zod.z.string(),
+  uri: atUriSchema.optional(),
+  cid: cidSchema.optional(),
+  payload: zod.z.record(zod.z.string(), zod.z.unknown())
+});
+var FollowFeedItemSchema = zod.z.discriminatedUnion("source", [
+  SifaFeedItemSchema,
+  AtmosphereFeedItemSchema
+]);
+var FollowFeedPageSchema = zod.z.object({
+  items: zod.z.array(FollowFeedItemSchema),
+  cursor: zod.z.string().nullable()
+});
+var FeedCursorSchema = zod.z.object({
+  indexedAt: datetimeSchema,
+  source: zod.z.union([zod.z.literal("sifa"), zod.z.literal("atmosphere")]),
+  id: zod.z.string().min(1)
+});
+function toBase64Url(input) {
+  const g = globalThis;
+  const b64 = typeof g.btoa === "function" ? g.btoa(unescape(encodeURIComponent(input))) : g.Buffer.from(input, "utf-8").toString("base64");
+  let end = b64.length;
+  while (end > 0 && b64.charCodeAt(end - 1) === 61) end--;
+  return b64.slice(0, end).replace(/\+/g, "-").replace(/\//g, "_");
+}
+function fromBase64Url(input) {
+  const padded = input.replace(/-/g, "+").replace(/_/g, "/") + "===".slice((input.length + 3) % 4);
+  const g = globalThis;
+  if (typeof g.atob === "function") {
+    return decodeURIComponent(escape(g.atob(padded)));
+  }
+  return g.Buffer.from(padded, "base64").toString("utf-8");
+}
+function encodeFeedCursor(cursor) {
+  return toBase64Url(JSON.stringify(cursor));
+}
+function decodeFeedCursor(encoded) {
+  const json = fromBase64Url(encoded);
+  const parsed2 = JSON.parse(json);
+  return FeedCursorSchema.parse(parsed2);
+}
 var ProfileCertificationRecordSchema = zod.z.object({
   name: zod.z.string().min(1).refine(maxGraphemes(100)).max(1e3),
   authority: zod.z.string().refine(maxGraphemes(100)).max(1e3).optional(),
@@ -1877,11 +1966,12 @@ var ProfileVolunteeringRecordSchema = zod.z.object({
 });
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.9.19";
+var SIFA_SDK_VERSION = "0.9.20";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VISIBILITY_RULES = ACTIVITY_VISIBILITY_RULES;
 exports.APP_URL_PATTERNS = APP_URL_PATTERNS;
+exports.AtmosphereFeedItemSchema = AtmosphereFeedItemSchema;
 exports.CATEGORY_LABELS = CATEGORY_LABELS;
 exports.CATEGORY_ORDER = CATEGORY_ORDER;
 exports.COLLECTION_TO_APP = COLLECTION_TO_APP;
@@ -1893,6 +1983,13 @@ exports.EMPLOYMENT_TYPE_GROUPS = EMPLOYMENT_TYPE_GROUPS;
 exports.EMPLOYMENT_TYPE_LABELS = EMPLOYMENT_TYPE_LABELS;
 exports.EndorsementConfirmationRecordSchema = EndorsementConfirmationRecordSchema;
 exports.EndorsementRecordSchema = EndorsementRecordSchema;
+exports.FEATURE_FLAGS = FEATURE_FLAGS;
+exports.FeatureAllowlistEntrySchema = FeatureAllowlistEntrySchema;
+exports.FeedActorSchema = FeedActorSchema;
+exports.FollowFeedItemSchema = FollowFeedItemSchema;
+exports.FollowFeedPageSchema = FollowFeedPageSchema;
+exports.FollowProfilePageSchema = FollowProfilePageSchema;
+exports.FollowProfileSchema = FollowProfileSchema;
 exports.GraphFollowRecordSchema = GraphFollowRecordSchema;
 exports.INDUSTRY_OPTIONS = INDUSTRY_OPTIONS;
 exports.MIN_SKILLS = MIN_SKILLS;
@@ -1914,6 +2011,7 @@ exports.ProfileVolunteeringRecordSchema = ProfileVolunteeringRecordSchema;
 exports.PublicationAuthorSchema = PublicationAuthorSchema;
 exports.SIFA_SDK_VERSION = SIFA_SDK_VERSION;
 exports.SKILL_CATEGORIES = SKILL_CATEGORIES;
+exports.SifaFeedItemSchema = SifaFeedItemSchema;
 exports.WORKPLACE_TYPE_LABELS = WORKPLACE_TYPE_LABELS;
 exports.WORKPLACE_TYPE_OPTIONS = WORKPLACE_TYPE_OPTIONS;
 exports.atUriSchema = atUriSchema;
@@ -1926,10 +2024,12 @@ exports.countFilledDimensions = countFilledDimensions;
 exports.countryCodeToFlag = countryCodeToFlag;
 exports.dateRangeExtractor = dateRangeExtractor;
 exports.datetimeSchema = datetimeSchema;
+exports.decodeFeedCursor = decodeFeedCursor;
 exports.dedupeSkills = dedupeSkills;
 exports.detectPdsProvider = detectPdsProvider;
 exports.didSchema = didSchema;
 exports.dimensionsFromInputs = dimensionsFromInputs;
+exports.encodeFeedCursor = encodeFeedCursor;
 exports.findIndustry = findIndustry;
 exports.formatDistanceToNow = formatDistanceToNow;
 exports.formatLocation = formatLocation;
@@ -1957,6 +2057,7 @@ exports.isVisibleActivityItem = isVisibleActivityItem;
 exports.languageTagSchema = languageTagSchema;
 exports.lexiconDateExtractor = lexiconDateExtractor;
 exports.limitCombiningMarks = limitCombiningMarks;
+exports.makeGraphFollowRecordSchema = makeGraphFollowRecordSchema;
 exports.maxGraphemes = maxGraphemes;
 exports.meetsContrastAA = meetsContrastAA;
 exports.parseLocationString = parseLocationString;