@ewanc26/atproto 0.2.9 → 0.2.11

package/dist/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,QAAQ,CAqB7E;AAED,eAAO,MAAM,kBAAkB,UAAsD,CAAC;AACtF,eAAO,MAAM,YAAY,UAA6C,CAAC;AAKvE,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqB3F;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAKxF;AAED,wBAAsB,YAAY,CAAC,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,WAAW,UAAQ,EACnB,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuBnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,QAAQ,CAqB7E;AAED,eAAO,MAAM,kBAAkB,UAAsD,CAAC;AACtF,eAAO,MAAM,YAAY,UAA6C,CAAC;AAKvE,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwB3F;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAKxF;AAED,wBAAsB,YAAY,CAAC,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,WAAW,UAAQ,EACnB,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}

package/dist/agents.js

@@ -1,5 +1,19 @@
 import { AtpAgent } from '@atproto/api';
 import { cache } from './cache.js';
+/** Default timeout for individual AT Protocol XRPC calls (ms). */
+const XRPC_TIMEOUT = 8_000;
+/** Default timeout for identity resolution (ms). */
+const IDENTITY_TIMEOUT = 5_000;
+/**
+ * Wraps a promise with a timeout. Rejects with a TimeoutError if the promise
+ * doesn't settle within `ms` milliseconds.
+ */
+function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Timeout after ${ms}ms`)), ms);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (err) => { clearTimeout(timer); reject(err); });
+    });
+}
 export function createAgent(service, fetchFn) {
     const wrappedFetch = fetchFn
         ? async (url, init) => {
@@ -31,7 +45,7 @@ export async function resolveIdentity(did, fetchFn) {
     if (cached)
         return cached;
     const _fetch = fetchFn ?? globalThis.fetch;
-    const response = await _fetch(`https://slingshot.microcosm.blue/xrpc/com.bad-example.identity.resolveMiniDoc?identifier=${encodeURIComponent(did)}`);
+    const response = await withTimeout(_fetch(`https://slingshot.microcosm.blue/xrpc/com.bad-example.identity.resolveMiniDoc?identifier=${encodeURIComponent(did)}`), IDENTITY_TIMEOUT);
     if (!response.ok) {
         throw new Error(`Failed to resolve identifier via Slingshot: ${response.status} ${response.statusText}`);
     }
@@ -54,7 +68,7 @@ export async function getPublicAgent(did, fetchFn) {
         return resolvedAgent;
     try {
         try {
-            const response = await constellationAgent.getProfile({ actor: did });
+            const response = await withTimeout(constellationAgent.getProfile({ actor: did }), XRPC_TIMEOUT);
             if (response.success) {
                 resolvedAgent = constellationAgent;
                 return resolvedAgent;
@@ -88,7 +102,7 @@ export async function withFallback(did, operation, usePDSFirst = false, fetchFn)
     for (const getAgent of agents) {
         try {
             const agent = await getAgent();
-            return await operation(agent);
+            return await withTimeout(operation(agent), XRPC_TIMEOUT);
         }
         catch (error) {
             lastError = error;

package/dist/fetch.d.ts

@@ -1,10 +1,16 @@
-import type { ProfileData, SiteInfoData, LinkData, MusicStatusData, KibunStatusData, TangledReposData, PopfeedReview, SifaProfileData, SifaSkill, SifaProject, SifaLanguage, SifaCertification, SifaExternalAccount } from './types.js';
+import type { ProfileData, SiteInfoData, LinkData, MusicStatusData, KibunStatusData, TangledReposData, PopfeedReview, SifaProfileData, SifaSkill, SifaProject, SifaLanguage, SifaCertification, SifaExternalAccount, SifaPosition, SifaEducation, SifaVolunteering, SifaHonor, SifaCourse, SifaPublication } from './types.js';
 export declare function fetchProfile(did: string, fetchFn?: typeof fetch): Promise<ProfileData>;
 export declare function fetchSiteInfo(did: string, fetchFn?: typeof fetch): Promise<SiteInfoData | null>;
 export declare function fetchLinks(did: string, fetchFn?: typeof fetch): Promise<LinkData | null>;
 export declare function fetchMusicStatus(did: string, fetchFn?: typeof fetch): Promise<MusicStatusData | null>;
 export declare function fetchKibunStatus(did: string, fetchFn?: typeof fetch): Promise<KibunStatusData | null>;
 export declare function fetchRecentPopfeedReviews(did: string, limit?: number, fetchFn?: typeof fetch): Promise<PopfeedReview[]>;
+export declare function fetchSifaPositions(did: string, fetchFn?: typeof fetch): Promise<SifaPosition[]>;
+export declare function fetchSifaEducation(did: string, fetchFn?: typeof fetch): Promise<SifaEducation[]>;
+export declare function fetchSifaVolunteering(did: string, fetchFn?: typeof fetch): Promise<SifaVolunteering[]>;
+export declare function fetchSifaHonors(did: string, fetchFn?: typeof fetch): Promise<SifaHonor[]>;
+export declare function fetchSifaCourses(did: string, fetchFn?: typeof fetch): Promise<SifaCourse[]>;
+export declare function fetchSifaPublications(did: string, fetchFn?: typeof fetch): Promise<SifaPublication[]>;
 export declare function fetchTangledRepos(did: string, fetchFn?: typeof fetch): Promise<TangledReposData | null>;
 export declare function fetchSifaProfile(did: string, fetchFn?: typeof fetch): Promise<SifaProfileData | null>;
 export declare function fetchSifaSkills(did: string, fetchFn?: typeof fetch): Promise<SifaSkill[]>;

package/dist/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,eAAe,EAEf,gBAAgB,EAChB,aAAa,EAGb,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CAgD5F;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgC9B;AAED,wBAAsB,UAAU,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA2B1B;AAED,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkIjC;AAED,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmCjC;AAED,wBAAsB,yBAAyB,CAC9C,GAAG,EAAE,MAAM,EACX,KAAK,SAAI,EACT,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgD1B;AAED,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA2ClC;AAID,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAqCjC;AAED,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAkCtB;AAED,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CA0CxB;AAED,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAkCzB;AAED,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyC9B;AAED,wBAAsB,yBAAyB,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAqChC"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"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"}

package/dist/fetch.js

@@ -283,6 +283,237 @@ export async function fetchRecentPopfeedReviews(did, limit = 5, fetchFn) {
         return [];
     }
 }
+export async function fetchSifaPositions(did, fetchFn) {
+    const cacheKey = `sifa:positions:${did}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const records = await withFallback(did, async (agent) => {
+            const response = await agent.com.atproto.repo.listRecords({
+                repo: did,
+                collection: 'id.sifa.profile.position',
+                limit: 100
+            });
+            return response.data.records;
+        }, true, fetchFn);
+        const data = records.map((record) => {
+            const value = record.value;
+            return {
+                company: value.company,
+                companyDid: value.companyDid,
+                title: value.title,
+                description: value.description,
+                employmentType: value.employmentType,
+                workplaceType: value.workplaceType,
+                location: value.location,
+                startedAt: value.startedAt,
+                endedAt: value.endedAt,
+                skills: value.skills,
+                isPrimary: value.isPrimary,
+                uri: record.uri
+            };
+        });
+        data.sort((a, b) => {
+            if (!a.startedAt)
+                return 1;
+            if (!b.startedAt)
+                return -1;
+            return new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime();
+        });
+        cache.set(cacheKey, data);
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
+export async function fetchSifaEducation(did, fetchFn) {
+    const cacheKey = `sifa:education:${did}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const records = await withFallback(did, async (agent) => {
+            const response = await agent.com.atproto.repo.listRecords({
+                repo: did,
+                collection: 'id.sifa.profile.education',
+                limit: 100
+            });
+            return response.data.records;
+        }, true, fetchFn);
+        const data = records.map((record) => {
+            const value = record.value;
+            return {
+                institution: value.institution,
+                institutionDid: value.institutionDid,
+                degree: value.degree,
+                fieldOfStudy: value.fieldOfStudy,
+                grade: value.grade,
+                activities: value.activities,
+                description: value.description,
+                location: value.location,
+                startedAt: value.startedAt,
+                endedAt: value.endedAt,
+                uri: record.uri
+            };
+        });
+        data.sort((a, b) => {
+            const aEnd = a.endedAt ? new Date(a.endedAt).getTime() : Date.now();
+            const bEnd = b.endedAt ? new Date(b.endedAt).getTime() : Date.now();
+            return bEnd - aEnd;
+        });
+        cache.set(cacheKey, data);
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
+export async function fetchSifaVolunteering(did, fetchFn) {
+    const cacheKey = `sifa:volunteering:${did}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const records = await withFallback(did, async (agent) => {
+            const response = await agent.com.atproto.repo.listRecords({
+                repo: did,
+                collection: 'id.sifa.profile.volunteering',
+                limit: 100
+            });
+            return response.data.records;
+        }, true, fetchFn);
+        const data = records.map((record) => {
+            const value = record.value;
+            return {
+                organization: value.organization,
+                organizationDid: value.organizationDid,
+                role: value.role,
+                cause: value.cause,
+                description: value.description,
+                startedAt: value.startedAt,
+                endedAt: value.endedAt,
+                uri: record.uri
+            };
+        });
+        cache.set(cacheKey, data);
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
+export async function fetchSifaHonors(did, fetchFn) {
+    const cacheKey = `sifa:honors:${did}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const records = await withFallback(did, async (agent) => {
+            const response = await agent.com.atproto.repo.listRecords({
+                repo: did,
+                collection: 'id.sifa.profile.honor',
+                limit: 100
+            });
+            return response.data.records;
+        }, true, fetchFn);
+        const data = records.map((record) => {
+            const value = record.value;
+            return {
+                title: value.title,
+                issuer: value.issuer,
+                issuerDid: value.issuerDid,
+                description: value.description,
+                awardedAt: value.awardedAt,
+                uri: record.uri
+            };
+        });
+        data.sort((a, b) => {
+            if (!a.awardedAt)
+                return 1;
+            if (!b.awardedAt)
+                return -1;
+            return new Date(b.awardedAt).getTime() - new Date(a.awardedAt).getTime();
+        });
+        cache.set(cacheKey, data);
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
+export async function fetchSifaCourses(did, fetchFn) {
+    const cacheKey = `sifa:courses:${did}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const records = await withFallback(did, async (agent) => {
+            const response = await agent.com.atproto.repo.listRecords({
+                repo: did,
+                collection: 'id.sifa.profile.course',
+                limit: 100
+            });
+            return response.data.records;
+        }, true, fetchFn);
+        const data = records.map((record) => {
+            const value = record.value;
+            return {
+                name: value.name,
+                number: value.number,
+                institution: value.institution,
+                education: value.education,
+                uri: record.uri
+            };
+        });
+        cache.set(cacheKey, data);
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
+export async function fetchSifaPublications(did, fetchFn) {
+    const cacheKey = `sifa:publications:${did}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const records = await withFallback(did, async (agent) => {
+            const response = await agent.com.atproto.repo.listRecords({
+                repo: did,
+                collection: 'id.sifa.profile.publication',
+                limit: 100
+            });
+            return response.data.records;
+        }, true, fetchFn);
+        const data = records.map((record) => {
+            const value = record.value;
+            return {
+                title: value.title,
+                publisher: value.publisher,
+                url: value.url,
+                description: value.description,
+                authors: value.authors,
+                publishedAt: value.publishedAt,
+                uri: record.uri
+            };
+        });
+        data.sort((a, b) => {
+            if (!a.publishedAt)
+                return 1;
+            if (!b.publishedAt)
+                return -1;
+            return new Date(b.publishedAt).getTime() - new Date(a.publishedAt).getTime();
+        });
+        cache.set(cacheKey, data);
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
 export async function fetchTangledRepos(did, fetchFn) {
     const cacheKey = `tangled:${did}`;
     const cached = cache.get(cacheKey);

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { PopfeedReview, PopfeedCreativeWorkType, PopfeedMainCreditRole, ProfileData, StatusData, SiteInfoData, LinkData, LinkCard, BlueskyPost, BlogPost, BlogPostsData, PostAuthor, ExternalLink, Facet, Technology, License, BasedOnItem, RelatedService, Repository, Credit, SectionLicense, ResolvedIdentity, CacheEntry, MusicStatusData, MusicArtist, KibunStatusData, TangledRepo, TangledReposData, StandardSitePublication, StandardSitePublicationsData, StandardSiteDocument, StandardSiteDocumentsData, StandardSiteBasicTheme, StandardSiteThemeColor, SifaProfileData, SifaSkill, SifaProject, SifaLanguage, SifaCertification, SifaExternalAccount, SifaLocation } from './types.js';
-export { fetchProfile, fetchSiteInfo, fetchLinks, fetchMusicStatus, fetchKibunStatus, fetchTangledRepos, fetchRecentPopfeedReviews, fetchSifaProfile, fetchSifaSkills, fetchSifaProjects, fetchSifaLanguages, fetchSifaCertifications, fetchSifaExternalAccounts } from './fetch.js';
+export type { PopfeedReview, PopfeedCreativeWorkType, PopfeedMainCreditRole, ProfileData, StatusData, SiteInfoData, LinkData, LinkCard, BlueskyPost, BlogPost, BlogPostsData, PostAuthor, ExternalLink, Facet, Technology, License, BasedOnItem, RelatedService, Repository, Credit, SectionLicense, ResolvedIdentity, CacheEntry, MusicStatusData, MusicArtist, KibunStatusData, TangledRepo, TangledReposData, StandardSitePublication, StandardSitePublicationsData, StandardSiteDocument, StandardSiteDocumentsData, StandardSiteBasicTheme, StandardSiteThemeColor, SifaProfileData, SifaSkill, SifaProject, SifaLanguage, SifaCertification, SifaExternalAccount, SifaLocation, SifaPosition, SifaEducation, SifaVolunteering, SifaHonor, SifaCourse, SifaPublication, SifaPublicationAuthor } from './types.js';
+export { fetchProfile, fetchSiteInfo, fetchLinks, fetchMusicStatus, fetchKibunStatus, fetchTangledRepos, fetchRecentPopfeedReviews, fetchSifaProfile, fetchSifaSkills, fetchSifaProjects, fetchSifaLanguages, fetchSifaCertifications, fetchSifaExternalAccounts, fetchSifaPositions, fetchSifaEducation, fetchSifaVolunteering, fetchSifaHonors, fetchSifaCourses, fetchSifaPublications } from './fetch.js';
 export { fetchPublications, fetchDocuments, fetchRecentDocuments, fetchBlogPosts } from './documents.js';
 export { fetchLatestBlueskyPost, fetchPostFromUri } from './posts.js';
 export { buildPdsBlobUrl, extractCidFromImageObject, extractImageUrlsFromValue } from './media.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACX,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,KAAK,EACL,UAAU,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,UAAU,EACV,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErJ,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gCAAgC,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEvF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACX,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,KAAK,EACL,UAAU,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,UAAU,EACV,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErJ,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gCAAgC,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEvF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -2,7 +2,7 @@
 // Key API difference from the app's src/lib/services/atproto:
 //   All functions that previously read PUBLIC_ATPROTO_DID from the environment
 //   now accept `did: string` as their first argument.
-export { fetchProfile, fetchSiteInfo, fetchLinks, fetchMusicStatus, fetchKibunStatus, fetchTangledRepos, fetchRecentPopfeedReviews, fetchSifaProfile, fetchSifaSkills, fetchSifaProjects, fetchSifaLanguages, fetchSifaCertifications, fetchSifaExternalAccounts } from './fetch.js';
+export { fetchProfile, fetchSiteInfo, fetchLinks, fetchMusicStatus, fetchKibunStatus, fetchTangledRepos, fetchRecentPopfeedReviews, fetchSifaProfile, fetchSifaSkills, fetchSifaProjects, fetchSifaLanguages, fetchSifaCertifications, fetchSifaExternalAccounts, fetchSifaPositions, fetchSifaEducation, fetchSifaVolunteering, fetchSifaHonors, fetchSifaCourses, fetchSifaPublications } from './fetch.js';
 export { fetchPublications, fetchDocuments, fetchRecentDocuments, fetchBlogPosts } from './documents.js';
 export { fetchLatestBlueskyPost, fetchPostFromUri } from './posts.js';
 export { buildPdsBlobUrl, extractCidFromImageObject, extractImageUrlsFromValue } from './media.js';

package/dist/jetstream.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Jetstream WebSocket client for AT Protocol real-time event streaming.
+ *
+ * Jetstream is a simplified JSON event stream that converts the CBOR-encoded
+ * AT Protocol firehose into lightweight, friendly JSON objects.
+ *
+ * @see https://github.com/bluesky-social/jetstream
+ */
+import type { JetstreamOptions, JetstreamEventHandler, JetstreamErrorHandler, JetstreamConnectionState } from './types.js';
+/** Public Jetstream instances operated by Bluesky */
+export declare const JETSTREAM_INSTANCES: {
+    readonly 'us-east-1': "wss://jetstream1.us-east.bsky.network";
+    readonly 'us-east-2': "wss://jetstream2.us-east.bsky.network";
+    readonly 'us-west-1': "wss://jetstream1.us-west.bsky.network";
+    readonly 'us-west-2': "wss://jetstream2.us-west.bsky.network";
+};
+export type JetstreamInstance = keyof typeof JETSTREAM_INSTANCES;
+/**
+ * Client for connecting to AT Protocol Jetstream real-time event stream.
+ *
+ * @example
+ * ```typescript
+ * const client = new JetstreamClient({
+ *   wantedCollections: ['app.bsky.feed.post'],
+ *   wantedDids: ['did:plc:...'],
+ * });
+ *
+ * client.onEvent((event) => {
+ *   console.log('Received event:', event.kind, event.commit?.collection);
+ * });
+ *
+ * client.connect();
+ * ```
+ */
+export declare class JetstreamClient {
+    private ws;
+    private url;
+    private options;
+    private eventHandlers;
+    private errorHandlers;
+    private stateHandlers;
+    private reconnectAttempts;
+    private cursor;
+    private isConnecting;
+    private shouldReconnect;
+    private reconnectTimeout;
+    private _connectionState;
+    constructor(options?: JetstreamOptions);
+    /** Current connection state */
+    get connectionState(): JetstreamConnectionState;
+    /** Get current cursor (last seen time_us) */
+    getCursor(): number | undefined;
+    /** Connect to Jetstream and start receiving events */
+    connect(): void;
+    /** Disconnect from Jetstream */
+    disconnect(): void;
+    /** Subscribe to events */
+    onEvent(handler: JetstreamEventHandler): () => void;
+    /** Subscribe to errors */
+    onError(handler: JetstreamErrorHandler): () => void;
+    /** Subscribe to connection state changes */
+    onStateChange(handler: (state: JetstreamConnectionState) => void): () => void;
+    /** Update subscription filters after connecting */
+    updateFilters(options: Partial<JetstreamOptions>): void;
+    /** Set cursor for replay */
+    setCursor(cursor: number): void;
+    private buildUrl;
+    private setState;
+    private handleError;
+    private scheduleReconnect;
+}
+/**
+ * Create a Jetstream client for a specific DID's data.
+ * Filters events to only include records from the specified DID.
+ */
+export declare function createDidJetstreamClient(did: string, options?: Omit<JetstreamOptions, 'wantedDids'>): JetstreamClient;
+/**
+ * Create a Jetstream client for specific collections.
+ * Receives events for all DIDs but only for the specified collections.
+ */
+export declare function createCollectionJetstreamClient(collections: string[], options?: Omit<JetstreamOptions, 'wantedCollections'>): JetstreamClient;
+/**
+ * Create a Jetstream client for the full firehose (all collections, all DIDs).
+ * Use with caution - this receives a high volume of events.
+ */
+export declare function createFullFirehoseClient(options?: JetstreamOptions): JetstreamClient;
+/**
+ * Get the current time as a Unix microseconds cursor.
+ * Useful for starting live-tail mode.
+ */
+export declare function getCurrentCursor(): number;
+/**
+ * Convert a Unix timestamp (ms) to Jetstream cursor (microseconds).
+ */
+export declare function timestampToCursor(timestampMs: number): number;
+/**
+ * Convert a Jetstream cursor (microseconds) to Unix timestamp (ms).
+ */
+export declare function cursorToTimestamp(cursor: number): number;
+//# sourceMappingURL=jetstream.d.ts.map

package/dist/jetstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jetstream.d.ts","sourceRoot":"","sources":["../src/jetstream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEX,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,MAAM,YAAY,CAAC;AAEpB,qDAAqD;AACrD,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAUjE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,aAAa,CAA6D;IAClF,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,gBAAgB,CAA4C;gBAExD,OAAO,GAAE,gBAAqB;IAM1C,+BAA+B;IAC/B,IAAI,eAAe,IAAI,wBAAwB,CAE9C;IAED,6CAA6C;IAC7C,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B,sDAAsD;IACtD,OAAO,IAAI,IAAI;IA0Df,gCAAgC;IAChC,UAAU,IAAI,IAAI;IAalB,0BAA0B;IAC1B,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAKnD,0BAA0B;IAC1B,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAKnD,4CAA4C;IAC5C,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,GAAG,MAAM,IAAI;IAK7E,mDAAmD;IACnD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAgBvD,4BAA4B;IAC5B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,OAAO,CAAC,QAAQ;IAqChB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,iBAAiB;CAWzB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAM,GAChD,eAAe,CAKjB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC9C,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAM,GACvD,eAAe,CAKjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAExF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD"}