@singi-labs/sifa-sdk 0.19.7 → 0.19.9

package/dist/atproto/index.cjs

@@ -19,7 +19,26 @@ function followUser(agent, subjectDid) {
 function unfollowUser(agent, followUri) {
   return agent.deleteFollow(followUri);
 }
+var ENDORSEMENT_CONFIRMATION_COLLECTION = "id.sifa.endorsement.confirmation";
+async function createEndorsementConfirmation(agent, input) {
+  if (!agent.did) {
+    throw new Error("createEndorsementConfirmation requires an authenticated agent with a did");
+  }
+  const record = {
+    $type: ENDORSEMENT_CONFIRMATION_COLLECTION,
+    endorsement: input.endorsement,
+    ...input.skill ? { skill: input.skill } : {},
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const { data } = await agent.com.atproto.repo.createRecord({
+    repo: agent.did,
+    collection: ENDORSEMENT_CONFIRMATION_COLLECTION,
+    record
+  });
+  return { uri: data.uri, cid: data.cid };
+}
 
+exports.createEndorsementConfirmation = createEndorsementConfirmation;
 exports.followUser = followUser;
 exports.likeRecord = likeRecord;
 exports.repostRecord = repostRecord;

package/dist/atproto/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/atproto/index.ts"],"names":[],"mappings":";;;AAsCO,SAAS,UAAA,CAAW,OAA0B,OAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC5C;AAGO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAgC;AACrF,EAAA,OAAO,KAAA,CAAM,WAAW,OAAO,CAAA;AACjC;AAMO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAwC;AAC7F,EAAA,OAAO,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC9C;AAGO,SAAS,cAAA,CAAe,OAA0B,SAAA,EAAkC;AACzF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC;AAMO,SAAS,UAAA,CAAW,OAA0B,UAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,OAAO,UAAU,CAAA;AAChC;AAGO,SAAS,YAAA,CAAa,OAA0B,SAAA,EAAkC;AACvF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC","file":"index.cjs","sourcesContent":["/**\n * Direct-to-PDS write helpers for AT Protocol interactions (like, repost).\n *\n * The native app performs OAuth on-device and holds its own authenticated agent,\n * then writes records directly to the user's PDS. These helpers are the shared,\n * typed service layer for those writes: the app passes its agent in, and the SDK\n * never constructs one itself. Reads stay on the sifa-api HTTP client (the rest\n * of this package); this subpath is the write side.\n *\n * Kept dependency-free: the agent is described structurally (below) rather than\n * imported from `@atproto/api`, so consuming this subpath adds no dependency.\n * The app's real `Agent` satisfies the structural type.\n */\n\n/** A strong reference to a record: its AT-URI and content id. */\nexport interface StrongRef {\n  uri: string;\n  cid: string;\n}\n\n/**\n * The subset of an authenticated AT Protocol agent (e.g. `@atproto/api`'s\n * `Agent`) that these write helpers use. Declared structurally so the SDK needs\n * no `@atproto/api` dependency.\n */\nexport interface AtprotoWriteAgent {\n  like(uri: string, cid: string): Promise<StrongRef>;\n  deleteLike(likeUri: string): Promise<void>;\n  repost(uri: string, cid: string): Promise<StrongRef>;\n  deleteRepost(repostUri: string): Promise<void>;\n  follow(subjectDid: string): Promise<StrongRef>;\n  deleteFollow(followUri: string): Promise<void>;\n}\n\n/**\n * Like a record. `subject` is the post being liked; the returned ref is the\n * like record itself, which {@link unlikeRecord} needs to undo it.\n */\nexport function likeRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.like(subject.uri, subject.cid);\n}\n\n/** Remove a like, given the like record's AT-URI (from {@link likeRecord}). */\nexport function unlikeRecord(agent: AtprotoWriteAgent, likeUri: string): Promise<void> {\n  return agent.deleteLike(likeUri);\n}\n\n/**\n * Repost a record. `subject` is the post being reposted; the returned ref is the\n * repost record itself, which {@link unrepostRecord} needs to undo it.\n */\nexport function repostRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.repost(subject.uri, subject.cid);\n}\n\n/** Remove a repost, given the repost record's AT-URI (from {@link repostRecord}). */\nexport function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Promise<void> {\n  return agent.deleteRepost(repostUri);\n}\n\n/**\n * Follow an actor by DID. The returned ref is the follow record itself, which\n * {@link unfollowUser} needs to undo it.\n */\nexport function followUser(agent: AtprotoWriteAgent, subjectDid: string): Promise<StrongRef> {\n  return agent.follow(subjectDid);\n}\n\n/** Unfollow, given the follow record's AT-URI (from {@link followUser}). */\nexport function unfollowUser(agent: AtprotoWriteAgent, followUri: string): Promise<void> {\n  return agent.deleteFollow(followUri);\n}\n"]}
+{"version":3,"sources":["../../src/atproto/index.ts"],"names":[],"mappings":";;;AAuCO,SAAS,UAAA,CAAW,OAA0B,OAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC5C;AAGO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAgC;AACrF,EAAA,OAAO,KAAA,CAAM,WAAW,OAAO,CAAA;AACjC;AAMO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAwC;AAC7F,EAAA,OAAO,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC9C;AAGO,SAAS,cAAA,CAAe,OAA0B,SAAA,EAAkC;AACzF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC;AAMO,SAAS,UAAA,CAAW,OAA0B,UAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,OAAO,UAAU,CAAA;AAChC;AAGO,SAAS,YAAA,CAAa,OAA0B,SAAA,EAAkC;AACvF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC;AAGA,IAAM,mCAAA,GAAsC,kCAAA;AAiC5C,eAAsB,6BAAA,CACpB,OACA,KAAA,EACoB;AACpB,EAAA,IAAI,CAAC,MAAM,GAAA,EAAK;AACd,IAAA,MAAM,IAAI,MAAM,0EAA0E,CAAA;AAAA,EAC5F;AACA,EAAA,MAAM,MAAA,GAAkC;AAAA,IACtC,KAAA,EAAO,mCAAA;AAAA,IACP,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,GAAI,MAAM,KAAA,GAAQ,EAAE,OAAO,KAAA,CAAM,KAAA,KAAU,EAAC;AAAA,IAC5C,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,GACpC;AACA,EAAA,MAAM,EAAE,MAAK,GAAI,MAAM,MAAM,GAAA,CAAI,OAAA,CAAQ,KAAK,YAAA,CAAa;AAAA,IACzD,MAAM,KAAA,CAAM,GAAA;AAAA,IACZ,UAAA,EAAY,mCAAA;AAAA,IACZ;AAAA,GACD,CAAA;AACD,EAAA,OAAO,EAAE,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,GAAA,EAAK,KAAK,GAAA,EAAI;AACxC","file":"index.cjs","sourcesContent":["/**\n * Direct-to-PDS write helpers for AT Protocol interactions (like, repost, follow,\n * endorsement confirmation).\n *\n * The native app performs OAuth on-device and holds its own authenticated agent,\n * then writes records directly to the user's PDS. These helpers are the shared,\n * typed service layer for those writes: the app passes its agent in, and the SDK\n * never constructs one itself. Reads stay on the sifa-api HTTP client (the rest\n * of this package); this subpath is the write side.\n *\n * Kept dependency-free: the agent is described structurally (below) rather than\n * imported from `@atproto/api`, so consuming this subpath adds no dependency.\n * The app's real `Agent` satisfies the structural type.\n */\n\n/** A strong reference to a record: its AT-URI and content id. */\nexport interface StrongRef {\n  uri: string;\n  cid: string;\n}\n\n/**\n * The subset of an authenticated AT Protocol agent (e.g. `@atproto/api`'s\n * `Agent`) that these write helpers use. Declared structurally so the SDK needs\n * no `@atproto/api` dependency.\n */\nexport interface AtprotoWriteAgent {\n  like(uri: string, cid: string): Promise<StrongRef>;\n  deleteLike(likeUri: string): Promise<void>;\n  repost(uri: string, cid: string): Promise<StrongRef>;\n  deleteRepost(repostUri: string): Promise<void>;\n  follow(subjectDid: string): Promise<StrongRef>;\n  deleteFollow(followUri: string): Promise<void>;\n}\n\n/**\n * Like a record. `subject` is the post being liked; the returned ref is the\n * like record itself, which {@link unlikeRecord} needs to undo it.\n */\nexport function likeRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.like(subject.uri, subject.cid);\n}\n\n/** Remove a like, given the like record's AT-URI (from {@link likeRecord}). */\nexport function unlikeRecord(agent: AtprotoWriteAgent, likeUri: string): Promise<void> {\n  return agent.deleteLike(likeUri);\n}\n\n/**\n * Repost a record. `subject` is the post being reposted; the returned ref is the\n * repost record itself, which {@link unrepostRecord} needs to undo it.\n */\nexport function repostRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.repost(subject.uri, subject.cid);\n}\n\n/** Remove a repost, given the repost record's AT-URI (from {@link repostRecord}). */\nexport function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Promise<void> {\n  return agent.deleteRepost(repostUri);\n}\n\n/**\n * Follow an actor by DID. The returned ref is the follow record itself, which\n * {@link unfollowUser} needs to undo it.\n */\nexport function followUser(agent: AtprotoWriteAgent, subjectDid: string): Promise<StrongRef> {\n  return agent.follow(subjectDid);\n}\n\n/** Unfollow, given the follow record's AT-URI (from {@link followUser}). */\nexport function unfollowUser(agent: AtprotoWriteAgent, followUri: string): Promise<void> {\n  return agent.deleteFollow(followUri);\n}\n\n/** Collection NSID (and record `$type`) for an endorsement confirmation. */\nconst ENDORSEMENT_CONFIRMATION_COLLECTION = 'id.sifa.endorsement.confirmation';\n\n/**\n * The subset of an authenticated agent used to write a record to an arbitrary\n * collection. Convenience methods like {@link AtprotoWriteAgent.like} do not\n * cover custom `id.sifa.*` collections, so those go through `createRecord`.\n * Declared structurally so the SDK needs no `@atproto/api` dependency; the app's\n * real `Agent` satisfies it. `did` is the authenticated repo the record lands in.\n */\nexport interface AtprotoRecordWriteAgent {\n  did?: string;\n  com: {\n    atproto: {\n      repo: {\n        createRecord(input: {\n          repo: string;\n          collection: string;\n          record: Record<string, unknown>;\n        }): Promise<{ data: { uri: string; cid: string } }>;\n      };\n    };\n  };\n}\n\n/**\n * Confirm an endorsement by writing an `id.sifa.endorsement.confirmation` record\n * to the endorsee's own repository. `endorsement` is a strong ref to the\n * endorser's endorsement record. `skill` links the skill this endorsement\n * applies to: pass it when the endorsement proposed a skill the endorsee then\n * created, or when a proposed name matched a skill the endorsee already had (the\n * endorser cannot write to the endorsee's repo, so the skill record is theirs to\n * create and reference). The returned ref is the confirmation record itself.\n */\nexport async function createEndorsementConfirmation(\n  agent: AtprotoRecordWriteAgent,\n  input: { endorsement: StrongRef; skill?: StrongRef },\n): Promise<StrongRef> {\n  if (!agent.did) {\n    throw new Error('createEndorsementConfirmation requires an authenticated agent with a did');\n  }\n  const record: Record<string, unknown> = {\n    $type: ENDORSEMENT_CONFIRMATION_COLLECTION,\n    endorsement: input.endorsement,\n    ...(input.skill ? { skill: input.skill } : {}),\n    createdAt: new Date().toISOString(),\n  };\n  const { data } = await agent.com.atproto.repo.createRecord({\n    repo: agent.did,\n    collection: ENDORSEMENT_CONFIRMATION_COLLECTION,\n    record,\n  });\n  return { uri: data.uri, cid: data.cid };\n}\n"]}

package/dist/atproto/index.d.cts

@@ -1,5 +1,6 @@
 /**
- * Direct-to-PDS write helpers for AT Protocol interactions (like, repost).
+ * Direct-to-PDS write helpers for AT Protocol interactions (like, repost, follow,
+ * endorsement confirmation).
  *
  * The native app performs OAuth on-device and holds its own authenticated agent,
  * then writes records directly to the user's PDS. These helpers are the shared,
@@ -50,5 +51,44 @@ declare function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Pr
 declare function followUser(agent: AtprotoWriteAgent, subjectDid: string): Promise<StrongRef>;
 /** Unfollow, given the follow record's AT-URI (from {@link followUser}). */
 declare function unfollowUser(agent: AtprotoWriteAgent, followUri: string): Promise<void>;
+/**
+ * The subset of an authenticated agent used to write a record to an arbitrary
+ * collection. Convenience methods like {@link AtprotoWriteAgent.like} do not
+ * cover custom `id.sifa.*` collections, so those go through `createRecord`.
+ * Declared structurally so the SDK needs no `@atproto/api` dependency; the app's
+ * real `Agent` satisfies it. `did` is the authenticated repo the record lands in.
+ */
+interface AtprotoRecordWriteAgent {
+    did?: string;
+    com: {
+        atproto: {
+            repo: {
+                createRecord(input: {
+                    repo: string;
+                    collection: string;
+                    record: Record<string, unknown>;
+                }): Promise<{
+                    data: {
+                        uri: string;
+                        cid: string;
+                    };
+                }>;
+            };
+        };
+    };
+}
+/**
+ * Confirm an endorsement by writing an `id.sifa.endorsement.confirmation` record
+ * to the endorsee's own repository. `endorsement` is a strong ref to the
+ * endorser's endorsement record. `skill` links the skill this endorsement
+ * applies to: pass it when the endorsement proposed a skill the endorsee then
+ * created, or when a proposed name matched a skill the endorsee already had (the
+ * endorser cannot write to the endorsee's repo, so the skill record is theirs to
+ * create and reference). The returned ref is the confirmation record itself.
+ */
+declare function createEndorsementConfirmation(agent: AtprotoRecordWriteAgent, input: {
+    endorsement: StrongRef;
+    skill?: StrongRef;
+}): Promise<StrongRef>;
 
-export { type AtprotoWriteAgent, type StrongRef, followUser, likeRecord, repostRecord, unfollowUser, unlikeRecord, unrepostRecord };
+export { type AtprotoRecordWriteAgent, type AtprotoWriteAgent, type StrongRef, createEndorsementConfirmation, followUser, likeRecord, repostRecord, unfollowUser, unlikeRecord, unrepostRecord };

package/dist/atproto/index.d.ts

@@ -1,5 +1,6 @@
 /**
- * Direct-to-PDS write helpers for AT Protocol interactions (like, repost).
+ * Direct-to-PDS write helpers for AT Protocol interactions (like, repost, follow,
+ * endorsement confirmation).
  *
  * The native app performs OAuth on-device and holds its own authenticated agent,
  * then writes records directly to the user's PDS. These helpers are the shared,
@@ -50,5 +51,44 @@ declare function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Pr
 declare function followUser(agent: AtprotoWriteAgent, subjectDid: string): Promise<StrongRef>;
 /** Unfollow, given the follow record's AT-URI (from {@link followUser}). */
 declare function unfollowUser(agent: AtprotoWriteAgent, followUri: string): Promise<void>;
+/**
+ * The subset of an authenticated agent used to write a record to an arbitrary
+ * collection. Convenience methods like {@link AtprotoWriteAgent.like} do not
+ * cover custom `id.sifa.*` collections, so those go through `createRecord`.
+ * Declared structurally so the SDK needs no `@atproto/api` dependency; the app's
+ * real `Agent` satisfies it. `did` is the authenticated repo the record lands in.
+ */
+interface AtprotoRecordWriteAgent {
+    did?: string;
+    com: {
+        atproto: {
+            repo: {
+                createRecord(input: {
+                    repo: string;
+                    collection: string;
+                    record: Record<string, unknown>;
+                }): Promise<{
+                    data: {
+                        uri: string;
+                        cid: string;
+                    };
+                }>;
+            };
+        };
+    };
+}
+/**
+ * Confirm an endorsement by writing an `id.sifa.endorsement.confirmation` record
+ * to the endorsee's own repository. `endorsement` is a strong ref to the
+ * endorser's endorsement record. `skill` links the skill this endorsement
+ * applies to: pass it when the endorsement proposed a skill the endorsee then
+ * created, or when a proposed name matched a skill the endorsee already had (the
+ * endorser cannot write to the endorsee's repo, so the skill record is theirs to
+ * create and reference). The returned ref is the confirmation record itself.
+ */
+declare function createEndorsementConfirmation(agent: AtprotoRecordWriteAgent, input: {
+    endorsement: StrongRef;
+    skill?: StrongRef;
+}): Promise<StrongRef>;
 
-export { type AtprotoWriteAgent, type StrongRef, followUser, likeRecord, repostRecord, unfollowUser, unlikeRecord, unrepostRecord };
+export { type AtprotoRecordWriteAgent, type AtprotoWriteAgent, type StrongRef, createEndorsementConfirmation, followUser, likeRecord, repostRecord, unfollowUser, unlikeRecord, unrepostRecord };

package/dist/atproto/index.js

@@ -17,7 +17,25 @@ function followUser(agent, subjectDid) {
 function unfollowUser(agent, followUri) {
   return agent.deleteFollow(followUri);
 }
+var ENDORSEMENT_CONFIRMATION_COLLECTION = "id.sifa.endorsement.confirmation";
+async function createEndorsementConfirmation(agent, input) {
+  if (!agent.did) {
+    throw new Error("createEndorsementConfirmation requires an authenticated agent with a did");
+  }
+  const record = {
+    $type: ENDORSEMENT_CONFIRMATION_COLLECTION,
+    endorsement: input.endorsement,
+    ...input.skill ? { skill: input.skill } : {},
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const { data } = await agent.com.atproto.repo.createRecord({
+    repo: agent.did,
+    collection: ENDORSEMENT_CONFIRMATION_COLLECTION,
+    record
+  });
+  return { uri: data.uri, cid: data.cid };
+}
 
-export { followUser, likeRecord, repostRecord, unfollowUser, unlikeRecord, unrepostRecord };
+export { createEndorsementConfirmation, followUser, likeRecord, repostRecord, unfollowUser, unlikeRecord, unrepostRecord };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/atproto/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/atproto/index.ts"],"names":[],"mappings":";AAsCO,SAAS,UAAA,CAAW,OAA0B,OAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC5C;AAGO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAgC;AACrF,EAAA,OAAO,KAAA,CAAM,WAAW,OAAO,CAAA;AACjC;AAMO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAwC;AAC7F,EAAA,OAAO,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC9C;AAGO,SAAS,cAAA,CAAe,OAA0B,SAAA,EAAkC;AACzF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC;AAMO,SAAS,UAAA,CAAW,OAA0B,UAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,OAAO,UAAU,CAAA;AAChC;AAGO,SAAS,YAAA,CAAa,OAA0B,SAAA,EAAkC;AACvF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC","file":"index.js","sourcesContent":["/**\n * Direct-to-PDS write helpers for AT Protocol interactions (like, repost).\n *\n * The native app performs OAuth on-device and holds its own authenticated agent,\n * then writes records directly to the user's PDS. These helpers are the shared,\n * typed service layer for those writes: the app passes its agent in, and the SDK\n * never constructs one itself. Reads stay on the sifa-api HTTP client (the rest\n * of this package); this subpath is the write side.\n *\n * Kept dependency-free: the agent is described structurally (below) rather than\n * imported from `@atproto/api`, so consuming this subpath adds no dependency.\n * The app's real `Agent` satisfies the structural type.\n */\n\n/** A strong reference to a record: its AT-URI and content id. */\nexport interface StrongRef {\n  uri: string;\n  cid: string;\n}\n\n/**\n * The subset of an authenticated AT Protocol agent (e.g. `@atproto/api`'s\n * `Agent`) that these write helpers use. Declared structurally so the SDK needs\n * no `@atproto/api` dependency.\n */\nexport interface AtprotoWriteAgent {\n  like(uri: string, cid: string): Promise<StrongRef>;\n  deleteLike(likeUri: string): Promise<void>;\n  repost(uri: string, cid: string): Promise<StrongRef>;\n  deleteRepost(repostUri: string): Promise<void>;\n  follow(subjectDid: string): Promise<StrongRef>;\n  deleteFollow(followUri: string): Promise<void>;\n}\n\n/**\n * Like a record. `subject` is the post being liked; the returned ref is the\n * like record itself, which {@link unlikeRecord} needs to undo it.\n */\nexport function likeRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.like(subject.uri, subject.cid);\n}\n\n/** Remove a like, given the like record's AT-URI (from {@link likeRecord}). */\nexport function unlikeRecord(agent: AtprotoWriteAgent, likeUri: string): Promise<void> {\n  return agent.deleteLike(likeUri);\n}\n\n/**\n * Repost a record. `subject` is the post being reposted; the returned ref is the\n * repost record itself, which {@link unrepostRecord} needs to undo it.\n */\nexport function repostRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.repost(subject.uri, subject.cid);\n}\n\n/** Remove a repost, given the repost record's AT-URI (from {@link repostRecord}). */\nexport function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Promise<void> {\n  return agent.deleteRepost(repostUri);\n}\n\n/**\n * Follow an actor by DID. The returned ref is the follow record itself, which\n * {@link unfollowUser} needs to undo it.\n */\nexport function followUser(agent: AtprotoWriteAgent, subjectDid: string): Promise<StrongRef> {\n  return agent.follow(subjectDid);\n}\n\n/** Unfollow, given the follow record's AT-URI (from {@link followUser}). */\nexport function unfollowUser(agent: AtprotoWriteAgent, followUri: string): Promise<void> {\n  return agent.deleteFollow(followUri);\n}\n"]}
+{"version":3,"sources":["../../src/atproto/index.ts"],"names":[],"mappings":";AAuCO,SAAS,UAAA,CAAW,OAA0B,OAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC5C;AAGO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAgC;AACrF,EAAA,OAAO,KAAA,CAAM,WAAW,OAAO,CAAA;AACjC;AAMO,SAAS,YAAA,CAAa,OAA0B,OAAA,EAAwC;AAC7F,EAAA,OAAO,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,GAAA,EAAK,QAAQ,GAAG,CAAA;AAC9C;AAGO,SAAS,cAAA,CAAe,OAA0B,SAAA,EAAkC;AACzF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC;AAMO,SAAS,UAAA,CAAW,OAA0B,UAAA,EAAwC;AAC3F,EAAA,OAAO,KAAA,CAAM,OAAO,UAAU,CAAA;AAChC;AAGO,SAAS,YAAA,CAAa,OAA0B,SAAA,EAAkC;AACvF,EAAA,OAAO,KAAA,CAAM,aAAa,SAAS,CAAA;AACrC;AAGA,IAAM,mCAAA,GAAsC,kCAAA;AAiC5C,eAAsB,6BAAA,CACpB,OACA,KAAA,EACoB;AACpB,EAAA,IAAI,CAAC,MAAM,GAAA,EAAK;AACd,IAAA,MAAM,IAAI,MAAM,0EAA0E,CAAA;AAAA,EAC5F;AACA,EAAA,MAAM,MAAA,GAAkC;AAAA,IACtC,KAAA,EAAO,mCAAA;AAAA,IACP,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,GAAI,MAAM,KAAA,GAAQ,EAAE,OAAO,KAAA,CAAM,KAAA,KAAU,EAAC;AAAA,IAC5C,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,GACpC;AACA,EAAA,MAAM,EAAE,MAAK,GAAI,MAAM,MAAM,GAAA,CAAI,OAAA,CAAQ,KAAK,YAAA,CAAa;AAAA,IACzD,MAAM,KAAA,CAAM,GAAA;AAAA,IACZ,UAAA,EAAY,mCAAA;AAAA,IACZ;AAAA,GACD,CAAA;AACD,EAAA,OAAO,EAAE,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,GAAA,EAAK,KAAK,GAAA,EAAI;AACxC","file":"index.js","sourcesContent":["/**\n * Direct-to-PDS write helpers for AT Protocol interactions (like, repost, follow,\n * endorsement confirmation).\n *\n * The native app performs OAuth on-device and holds its own authenticated agent,\n * then writes records directly to the user's PDS. These helpers are the shared,\n * typed service layer for those writes: the app passes its agent in, and the SDK\n * never constructs one itself. Reads stay on the sifa-api HTTP client (the rest\n * of this package); this subpath is the write side.\n *\n * Kept dependency-free: the agent is described structurally (below) rather than\n * imported from `@atproto/api`, so consuming this subpath adds no dependency.\n * The app's real `Agent` satisfies the structural type.\n */\n\n/** A strong reference to a record: its AT-URI and content id. */\nexport interface StrongRef {\n  uri: string;\n  cid: string;\n}\n\n/**\n * The subset of an authenticated AT Protocol agent (e.g. `@atproto/api`'s\n * `Agent`) that these write helpers use. Declared structurally so the SDK needs\n * no `@atproto/api` dependency.\n */\nexport interface AtprotoWriteAgent {\n  like(uri: string, cid: string): Promise<StrongRef>;\n  deleteLike(likeUri: string): Promise<void>;\n  repost(uri: string, cid: string): Promise<StrongRef>;\n  deleteRepost(repostUri: string): Promise<void>;\n  follow(subjectDid: string): Promise<StrongRef>;\n  deleteFollow(followUri: string): Promise<void>;\n}\n\n/**\n * Like a record. `subject` is the post being liked; the returned ref is the\n * like record itself, which {@link unlikeRecord} needs to undo it.\n */\nexport function likeRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.like(subject.uri, subject.cid);\n}\n\n/** Remove a like, given the like record's AT-URI (from {@link likeRecord}). */\nexport function unlikeRecord(agent: AtprotoWriteAgent, likeUri: string): Promise<void> {\n  return agent.deleteLike(likeUri);\n}\n\n/**\n * Repost a record. `subject` is the post being reposted; the returned ref is the\n * repost record itself, which {@link unrepostRecord} needs to undo it.\n */\nexport function repostRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef> {\n  return agent.repost(subject.uri, subject.cid);\n}\n\n/** Remove a repost, given the repost record's AT-URI (from {@link repostRecord}). */\nexport function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Promise<void> {\n  return agent.deleteRepost(repostUri);\n}\n\n/**\n * Follow an actor by DID. The returned ref is the follow record itself, which\n * {@link unfollowUser} needs to undo it.\n */\nexport function followUser(agent: AtprotoWriteAgent, subjectDid: string): Promise<StrongRef> {\n  return agent.follow(subjectDid);\n}\n\n/** Unfollow, given the follow record's AT-URI (from {@link followUser}). */\nexport function unfollowUser(agent: AtprotoWriteAgent, followUri: string): Promise<void> {\n  return agent.deleteFollow(followUri);\n}\n\n/** Collection NSID (and record `$type`) for an endorsement confirmation. */\nconst ENDORSEMENT_CONFIRMATION_COLLECTION = 'id.sifa.endorsement.confirmation';\n\n/**\n * The subset of an authenticated agent used to write a record to an arbitrary\n * collection. Convenience methods like {@link AtprotoWriteAgent.like} do not\n * cover custom `id.sifa.*` collections, so those go through `createRecord`.\n * Declared structurally so the SDK needs no `@atproto/api` dependency; the app's\n * real `Agent` satisfies it. `did` is the authenticated repo the record lands in.\n */\nexport interface AtprotoRecordWriteAgent {\n  did?: string;\n  com: {\n    atproto: {\n      repo: {\n        createRecord(input: {\n          repo: string;\n          collection: string;\n          record: Record<string, unknown>;\n        }): Promise<{ data: { uri: string; cid: string } }>;\n      };\n    };\n  };\n}\n\n/**\n * Confirm an endorsement by writing an `id.sifa.endorsement.confirmation` record\n * to the endorsee's own repository. `endorsement` is a strong ref to the\n * endorser's endorsement record. `skill` links the skill this endorsement\n * applies to: pass it when the endorsement proposed a skill the endorsee then\n * created, or when a proposed name matched a skill the endorsee already had (the\n * endorser cannot write to the endorsee's repo, so the skill record is theirs to\n * create and reference). The returned ref is the confirmation record itself.\n */\nexport async function createEndorsementConfirmation(\n  agent: AtprotoRecordWriteAgent,\n  input: { endorsement: StrongRef; skill?: StrongRef },\n): Promise<StrongRef> {\n  if (!agent.did) {\n    throw new Error('createEndorsementConfirmation requires an authenticated agent with a did');\n  }\n  const record: Record<string, unknown> = {\n    $type: ENDORSEMENT_CONFIRMATION_COLLECTION,\n    endorsement: input.endorsement,\n    ...(input.skill ? { skill: input.skill } : {}),\n    createdAt: new Date().toISOString(),\n  };\n  const { data } = await agent.com.atproto.repo.createRecord({\n    repo: agent.did,\n    collection: ENDORSEMENT_CONFIRMATION_COLLECTION,\n    record,\n  });\n  return { uri: data.uri, cid: data.cid };\n}\n"]}

package/dist/index.cjs

@@ -6447,7 +6447,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.7";
+var SIFA_SDK_VERSION = "0.19.9";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;

package/dist/index.js

@@ -6445,7 +6445,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.7";
+var SIFA_SDK_VERSION = "0.19.9";
 
 export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ADULT_CONTENT_LABELS, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, ArtifactLinkSchema, AtmosphereFeedItemSchema, BlobRefSchema, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPANY_PAGE_MIN_FIRMOGRAPHIC_FIELDS, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, DIMENSIONS_MAX_SCORE, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, EntityImportSearchResponseSchema, EntityMintDomainResponseSchema, EntityResolveDomainRequestSchema, EntityResolveDomainResponseSchema, EntitySearchResponseSchema, EntitySearchResultSchema, EntitySelectRequestSchema, EntitySelectResponseSchema, FEATURE_FLAGS, FeatureAllowlistEntrySchema, FeedActorSchema, FollowFeedItemSchema, FollowFeedPageSchema, FollowProfilePageSchema, FollowProfileSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, INVESTMENT_ROLE_LABELS, INVESTMENT_ROLE_OPTIONS, INVESTMENT_STAGE_LABELS, INVESTMENT_STAGE_OPTIONS, INVESTMENT_STATUS_LABELS, INVESTMENT_STATUS_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, InvestmentAmountSchema, MIN_SKILLS, ON_BEHALF_OF_EMPLOYMENT_TYPES, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, OrgEmploymentAttestationRecordSchema, OrgProfileRecordSchema, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PROFILE_INVESTMENT_NSID, PROFILE_INVOLVEMENT_NSID, PROJECT_ROLES, PUBLICATION_TYPE_LABELS, PUBLICATION_TYPE_OPTIONS, PUBLISHERS, PresentationDurationSchema, PresentationLinkSchema, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileInvestmentRecordSchema, ProfileInvolvementRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, ROADMAP_ISSUES_REPO, ROADMAP_ITEM_META, SECTION_GROUPS, SECTION_LABELS, SELF_APP_ID, SIFA_REPO_GROUPS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, SifaFeedItemSchema, VERIFICATION_PROVIDERS, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, actorShowsIdentity, agentRefSchema, atUriSchema, buildMetaDescription, buildProfileHighlights, buildTalkSlug, categoryForApp, certDateExtractor, cidSchema, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countRecentActivity, countryCodeToFlag, dateRangeExtractor, datetimeSchema, decodeFeedCursor, dedupeSkills, describeSifaRecord, detectPdsProvider, didSchema, dimensionsFromInputs, durationFromMinutes, encodeFeedCursor, entityDisambiguationLabel, entityResultKey, excludeSelfApp, externalRecordRefSchema, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDisplayUrl, formatDistanceToNow, formatEventDate, formatLocation, formatPresentationDuration, formatRelativeTime, formatSingleDate, formatSpanDate, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvestmentRoleLabel, getInvestmentStageLabel, getInvestmentStatusLabel, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublicationTypeLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, groupSkillsBySubCategory, groupSkillsForDisplay, hasAdultContent, hasPersonalProfileContent, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isOnBehalfOfApplicable, isPseudoEmployer, isRegistrableDomainHandle, isRoleLineRedundant, isSectionPopulated, isValidRgbColor, isVisibleActivityItem, languageTagSchema, lexiconDateExtractor, limitCombiningMarks, locationSegments, looksLikeDomain, makeGraphFollowRecordSchema, maxGraphemes, meetsContrastAA, normalizeCompanyKey, normalizeDoi, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeSkillCategory, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseIntendedAudiences, parseLocationString, parsePresentationDuration, parseTalkRkey, partialDateSchema, pdsProviderFromApi, pickPrimaryFlagged, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, rendersCompanyProfile, rendersPersonalProfile, repoGroupForCollection, resolveAccountFacetMode, resolveAgentRef, resolveCardHealth, resolveCardUrl, resolveEmbed, resolveVerifierProvider, rgbToString, roadmapIssueUrl, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, selfLabelsSchema, shouldRenderHighlights, singleDateExtractor, skillRefSchema, slugifyTitle, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamAuthorSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, strongRefSchema, summarizePresentationDeliveries, summarizeProfileView, toStreamCardVM, toStreamCardVMs, truncateGraphemes, uriSchema, verbForCollection, visibleItems, youtubeThumbnailUrl, youtubeVideoId };
 //# sourceMappingURL=index.js.map

package/dist/jsonld/index.cjs

@@ -285,6 +285,13 @@ var term_mappings_default = {
       match: "exactMatch",
       terms: ["bibo:abstract", "schema:abstract"]
     },
+    {
+      lexicon: "id.sifa.profile.publication",
+      field: "doi",
+      match: "exactMatch",
+      terms: ["bibo:doi", "prism:doi"],
+      note: "schema:identifier with a PropertyValue of propertyID 'doi' is the JSON-LD serialization; bibo:doi is the direct term."
+    },
     {
       lexicon: "id.sifa.profile.publication",
       field: "publishedAt",
@@ -309,6 +316,13 @@ var term_mappings_default = {
       match: "exactMatch",
       terms: ["dcterms:title", "schema:name"]
     },
+    {
+      lexicon: "id.sifa.profile.publication",
+      field: "type",
+      match: "closeMatch",
+      terms: ["dcterms:type", "schema:additionalType"],
+      note: "COAR Resource Types is the anchor a consumer should map to. The values here are ORCID's because that is the vocabulary the data arrives in; deviating from the id.sifa.defs token convention is deliberate, since the vocabulary is ORCID's rather than Sifa's."
+    },
     {
       lexicon: "id.sifa.profile.publication",
       field: "url",
@@ -372,13 +386,6 @@ var term_mappings_default = {
       lexicon: "id.sifa.profile.volunteering",
       match: "closeMatch",
       terms: ["org:Membership", "schema:OrganizationRole"]
-    },
-    {
-      lexicon: "id.sifa.profile.publication",
-      field: "doi",
-      terms: ["bibo:doi", "prism:doi"],
-      match: "exactMatch",
-      note: "Present on the AppView view type (ORCID-sourced), not yet on the id.sifa.profile.publication lexicon, so user-authored publications cannot carry one."
     }
   ],
   unmapped: [