@singi-labs/sifa-sdk 0.18.19 → 0.18.21

package/dist/atproto/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+// src/atproto/index.ts
+function likeRecord(agent, subject) {
+  return agent.like(subject.uri, subject.cid);
+}
+function unlikeRecord(agent, likeUri) {
+  return agent.deleteLike(likeUri);
+}
+function repostRecord(agent, subject) {
+  return agent.repost(subject.uri, subject.cid);
+}
+function unrepostRecord(agent, repostUri) {
+  return agent.deleteRepost(repostUri);
+}
+
+exports.likeRecord = likeRecord;
+exports.repostRecord = repostRecord;
+exports.unlikeRecord = unlikeRecord;
+exports.unrepostRecord = unrepostRecord;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/atproto/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/atproto/index.ts"],"names":[],"mappings":";;;AAoCO,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","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}\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"]}

package/dist/atproto/index.d.cts

@@ -0,0 +1,45 @@
+/**
+ * Direct-to-PDS write helpers for AT Protocol interactions (like, repost).
+ *
+ * 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,
+ * typed service layer for those writes: the app passes its agent in, and the SDK
+ * never constructs one itself. Reads stay on the sifa-api HTTP client (the rest
+ * of this package); this subpath is the write side.
+ *
+ * Kept dependency-free: the agent is described structurally (below) rather than
+ * imported from `@atproto/api`, so consuming this subpath adds no dependency.
+ * The app's real `Agent` satisfies the structural type.
+ */
+/** A strong reference to a record: its AT-URI and content id. */
+interface StrongRef {
+    uri: string;
+    cid: string;
+}
+/**
+ * The subset of an authenticated AT Protocol agent (e.g. `@atproto/api`'s
+ * `Agent`) that these write helpers use. Declared structurally so the SDK needs
+ * no `@atproto/api` dependency.
+ */
+interface AtprotoWriteAgent {
+    like(uri: string, cid: string): Promise<StrongRef>;
+    deleteLike(likeUri: string): Promise<void>;
+    repost(uri: string, cid: string): Promise<StrongRef>;
+    deleteRepost(repostUri: string): Promise<void>;
+}
+/**
+ * Like a record. `subject` is the post being liked; the returned ref is the
+ * like record itself, which {@link unlikeRecord} needs to undo it.
+ */
+declare function likeRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef>;
+/** Remove a like, given the like record's AT-URI (from {@link likeRecord}). */
+declare function unlikeRecord(agent: AtprotoWriteAgent, likeUri: string): Promise<void>;
+/**
+ * Repost a record. `subject` is the post being reposted; the returned ref is the
+ * repost record itself, which {@link unrepostRecord} needs to undo it.
+ */
+declare function repostRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef>;
+/** Remove a repost, given the repost record's AT-URI (from {@link repostRecord}). */
+declare function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Promise<void>;
+
+export { type AtprotoWriteAgent, type StrongRef, likeRecord, repostRecord, unlikeRecord, unrepostRecord };

package/dist/atproto/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Direct-to-PDS write helpers for AT Protocol interactions (like, repost).
+ *
+ * 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,
+ * typed service layer for those writes: the app passes its agent in, and the SDK
+ * never constructs one itself. Reads stay on the sifa-api HTTP client (the rest
+ * of this package); this subpath is the write side.
+ *
+ * Kept dependency-free: the agent is described structurally (below) rather than
+ * imported from `@atproto/api`, so consuming this subpath adds no dependency.
+ * The app's real `Agent` satisfies the structural type.
+ */
+/** A strong reference to a record: its AT-URI and content id. */
+interface StrongRef {
+    uri: string;
+    cid: string;
+}
+/**
+ * The subset of an authenticated AT Protocol agent (e.g. `@atproto/api`'s
+ * `Agent`) that these write helpers use. Declared structurally so the SDK needs
+ * no `@atproto/api` dependency.
+ */
+interface AtprotoWriteAgent {
+    like(uri: string, cid: string): Promise<StrongRef>;
+    deleteLike(likeUri: string): Promise<void>;
+    repost(uri: string, cid: string): Promise<StrongRef>;
+    deleteRepost(repostUri: string): Promise<void>;
+}
+/**
+ * Like a record. `subject` is the post being liked; the returned ref is the
+ * like record itself, which {@link unlikeRecord} needs to undo it.
+ */
+declare function likeRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef>;
+/** Remove a like, given the like record's AT-URI (from {@link likeRecord}). */
+declare function unlikeRecord(agent: AtprotoWriteAgent, likeUri: string): Promise<void>;
+/**
+ * Repost a record. `subject` is the post being reposted; the returned ref is the
+ * repost record itself, which {@link unrepostRecord} needs to undo it.
+ */
+declare function repostRecord(agent: AtprotoWriteAgent, subject: StrongRef): Promise<StrongRef>;
+/** Remove a repost, given the repost record's AT-URI (from {@link repostRecord}). */
+declare function unrepostRecord(agent: AtprotoWriteAgent, repostUri: string): Promise<void>;
+
+export { type AtprotoWriteAgent, type StrongRef, likeRecord, repostRecord, unlikeRecord, unrepostRecord };

package/dist/atproto/index.js

@@ -0,0 +1,17 @@
+// src/atproto/index.ts
+function likeRecord(agent, subject) {
+  return agent.like(subject.uri, subject.cid);
+}
+function unlikeRecord(agent, likeUri) {
+  return agent.deleteLike(likeUri);
+}
+function repostRecord(agent, subject) {
+  return agent.repost(subject.uri, subject.cid);
+}
+function unrepostRecord(agent, repostUri) {
+  return agent.deleteRepost(repostUri);
+}
+
+export { likeRecord, repostRecord, unlikeRecord, unrepostRecord };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/atproto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/atproto/index.ts"],"names":[],"mappings":";AAoCO,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","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}\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"]}

package/dist/{index-E2qQbMnv.d.ts → index-66ul8ibE.d.cts}

@@ -1,3 +1,5 @@
+import { A as AgentRef } from './shared-v0vl5hov.cjs';
+
 interface LocationValue {
     city?: string;
     /** community.lexicon.location.address field -- preferred over `city`. */
@@ -32,6 +34,12 @@ interface ProfilePosition {
      * `company`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     /**
      * Company-page slug for a durably-linked position, resolved by the AppView at
      * read time alongside `entityName` (#159). Lets a consumer link the company
@@ -82,6 +90,12 @@ interface ProfileEducation {
      * `institution`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     degree?: string;
     fieldOfStudy?: string;
     description?: string;
@@ -185,6 +199,12 @@ interface ProfileCertification {
      * `authority`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     issueDate?: string;
     expiryDate?: string;
     credentialUrl?: string;
@@ -290,6 +310,12 @@ interface ProfileVolunteering {
      * `organization`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     role?: string;
     cause?: string;
     startDate?: string;
@@ -313,6 +339,12 @@ interface ProfileHonor {
      * entry. Absent for free-text or unresolved entries (fall back to `issuer`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     date?: string;
     description?: string;
     hidden?: boolean;
@@ -358,6 +390,12 @@ interface ProfileInvestment {
     entityRef?: string;
     /** Resolved canonical name of the linked company. Render over `company` when present. */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     /** How the capital went in. Angel, syndicate member or LP -- never GP. */
     role?: string;
     /** The company's funding stage at the time of the investment, not its stage today. */
@@ -403,6 +441,12 @@ interface ProfileInvolvement {
      * free-text or unresolved entries.
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     location?: LocationValue | null;
     skills?: SkillRef[];
     /** Skill records resolved from `skills`, for display. */
@@ -445,6 +489,12 @@ interface ProfileCourse {
      * `institution`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     number?: string;
     /** rkey of the associated certification, resolved from the course's
      * `credential` at-uri. Used to join the course to a certification in the

package/dist/{index-E2qQbMnv.d.cts → index-C13I8diU.d.ts}

@@ -1,3 +1,5 @@
+import { A as AgentRef } from './shared-v0vl5hov.js';
+
 interface LocationValue {
     city?: string;
     /** community.lexicon.location.address field -- preferred over `city`. */
@@ -32,6 +34,12 @@ interface ProfilePosition {
      * `company`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     /**
      * Company-page slug for a durably-linked position, resolved by the AppView at
      * read time alongside `entityName` (#159). Lets a consumer link the company
@@ -82,6 +90,12 @@ interface ProfileEducation {
      * `institution`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     degree?: string;
     fieldOfStudy?: string;
     description?: string;
@@ -185,6 +199,12 @@ interface ProfileCertification {
      * `authority`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     issueDate?: string;
     expiryDate?: string;
     credentialUrl?: string;
@@ -290,6 +310,12 @@ interface ProfileVolunteering {
      * `organization`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     role?: string;
     cause?: string;
     startDate?: string;
@@ -313,6 +339,12 @@ interface ProfileHonor {
      * entry. Absent for free-text or unresolved entries (fall back to `issuer`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     date?: string;
     description?: string;
     hidden?: boolean;
@@ -358,6 +390,12 @@ interface ProfileInvestment {
     entityRef?: string;
     /** Resolved canonical name of the linked company. Render over `company` when present. */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     /** How the capital went in. Angel, syndicate member or LP -- never GP. */
     role?: string;
     /** The company's funding stage at the time of the investment, not its stage today. */
@@ -403,6 +441,12 @@ interface ProfileInvolvement {
      * free-text or unresolved entries.
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     location?: LocationValue | null;
     skills?: SkillRef[];
     /** Skill records resolved from `skills`, for display. */
@@ -445,6 +489,12 @@ interface ProfileCourse {
      * `institution`).
      */
     entityName?: string;
+    /**
+     * Canonical org reference (#511): a nested mirror of the flat
+     * name / did / entityRef fields. Prefer it when present; the nested
+     * shape wins over the flat fields (resolveAgentRef precedence).
+     */
+    agentRef?: AgentRef;
     number?: string;
     /** rkey of the associated certification, resolved from the course's
      * `credential` at-uri. Used to join the course to a certification in the

package/dist/index.cjs

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