@singi-labs/sifa-sdk 0.19.108 → 0.19.109

package/dist/germ-declaration-BQBocGww.d.cts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+
+/**
+ * `showButtonTo` values the Germ lexicon declares. The lexicon lists them as
+ * `knownValues`, not an enum, so the schema accepts any string; consumers must
+ * treat an unknown value as "no button" (see `germButtonAudience`).
+ */
+declare const GERM_SHOW_BUTTON_TO_VALUES: readonly ["none", "usersIFollow", "everyone"];
+type GermShowButtonTo = (typeof GERM_SHOW_BUTTON_TO_VALUES)[number];
+/**
+ * Zod schema for `com.germnetwork.declaration` (rkey `self`), the record a Germ
+ * DM user publishes in their own repo.
+ *
+ * Only the fields an AppView reads are typed. The key material (`currentKey`,
+ * `keyPackage`, `continuityProofs`) is opaque; `currentKey` is checked for shape
+ * only, because an empty key means the DID is no longer bound to Germ. Unknown
+ * keys pass through so a newer record version still parses.
+ *
+ * @see https://lexicon.garden/lexicon/did:plc:qyqmmncrm6qx33kpy7vqndik/com.germnetwork.declaration
+ */
+declare const GermDeclarationRecordSchema: z.ZodObject<{
+    version: z.ZodString;
+    currentKey: z.ZodUnion<readonly [z.ZodObject<{
+        $bytes: z.ZodString;
+    }, z.core.$strip>, z.ZodInstanceOf<Uint8Array<ArrayBuffer>>]>;
+    messageMe: z.ZodOptional<z.ZodObject<{
+        showButtonTo: z.ZodString;
+        messageMeUrl: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+type GermDeclarationRecord = z.infer<typeof GermDeclarationRecordSchema>;
+
+export { type GermDeclarationRecord as G, GERM_SHOW_BUTTON_TO_VALUES as a, GermDeclarationRecordSchema as b, type GermShowButtonTo as c };

package/dist/germ-declaration-BQBocGww.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+
+/**
+ * `showButtonTo` values the Germ lexicon declares. The lexicon lists them as
+ * `knownValues`, not an enum, so the schema accepts any string; consumers must
+ * treat an unknown value as "no button" (see `germButtonAudience`).
+ */
+declare const GERM_SHOW_BUTTON_TO_VALUES: readonly ["none", "usersIFollow", "everyone"];
+type GermShowButtonTo = (typeof GERM_SHOW_BUTTON_TO_VALUES)[number];
+/**
+ * Zod schema for `com.germnetwork.declaration` (rkey `self`), the record a Germ
+ * DM user publishes in their own repo.
+ *
+ * Only the fields an AppView reads are typed. The key material (`currentKey`,
+ * `keyPackage`, `continuityProofs`) is opaque; `currentKey` is checked for shape
+ * only, because an empty key means the DID is no longer bound to Germ. Unknown
+ * keys pass through so a newer record version still parses.
+ *
+ * @see https://lexicon.garden/lexicon/did:plc:qyqmmncrm6qx33kpy7vqndik/com.germnetwork.declaration
+ */
+declare const GermDeclarationRecordSchema: z.ZodObject<{
+    version: z.ZodString;
+    currentKey: z.ZodUnion<readonly [z.ZodObject<{
+        $bytes: z.ZodString;
+    }, z.core.$strip>, z.ZodInstanceOf<Uint8Array<ArrayBuffer>>]>;
+    messageMe: z.ZodOptional<z.ZodObject<{
+        showButtonTo: z.ZodString;
+        messageMeUrl: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+type GermDeclarationRecord = z.infer<typeof GermDeclarationRecordSchema>;
+
+export { type GermDeclarationRecord as G, GERM_SHOW_BUTTON_TO_VALUES as a, GermDeclarationRecordSchema as b, type GermShowButtonTo as c };

package/dist/index.cjs

@@ -6534,6 +6534,69 @@ function excludeSelfApp(apps) {
   return apps.filter((app) => app.id !== SELF_APP_ID);
 }
 
+// src/logic/germ.ts
+var GERM_MESSAGE_HOSTS = ["landing.ger.mx"];
+var MAX_DID_LENGTH = 2048;
+var STRICT_DID = /^did:[a-z]+:(?:[A-Za-z0-9._:-]|%3A)*(?:[A-Za-z0-9._-]|%3A)$/;
+function isStrictDid(value) {
+  return value.length <= MAX_DID_LENGTH && STRICT_DID.test(value);
+}
+function parseGermMessageUrl(raw) {
+  let url;
+  try {
+    url = new URL(raw);
+  } catch {
+    return null;
+  }
+  if (url.protocol !== "https:") return null;
+  if (url.username !== "" || url.password !== "" || url.port !== "") return null;
+  if (!GERM_MESSAGE_HOSTS.includes(url.hostname)) return null;
+  if (url.hash !== "") return null;
+  return url;
+}
+function germButtonAudience(declaration) {
+  if (!declaration) return null;
+  const key = declaration.currentKey;
+  if (key instanceof Uint8Array ? key.length === 0 : key.$bytes === "") return null;
+  const messageMe = declaration.messageMe;
+  if (!messageMe) return null;
+  if (!parseGermMessageUrl(messageMe.messageMeUrl)) return null;
+  if (messageMe.showButtonTo === "everyone" || messageMe.showButtonTo === "usersIFollow") {
+    return messageMe.showButtonTo;
+  }
+  return null;
+}
+function shouldShowGermButton(input) {
+  const { audience, ownerDid, viewerDid, ownerFollowsViewer } = input;
+  if (!audience) return false;
+  if (!isStrictDid(ownerDid)) return false;
+  if (viewerDid !== null && !isStrictDid(viewerDid)) return false;
+  if (viewerDid === ownerDid) return false;
+  if (audience === "everyone") return true;
+  return viewerDid !== null && ownerFollowsViewer === true;
+}
+function buildGermMessageUrl(input) {
+  const { messageMeUrl, ownerDid, viewerDid, platform } = input;
+  if (!isStrictDid(ownerDid)) return null;
+  if (viewerDid !== null && !isStrictDid(viewerDid)) return null;
+  const url = parseGermMessageUrl(messageMeUrl);
+  if (!url) return null;
+  if (platform) {
+    const path = url.pathname;
+    let end = path.length;
+    while (end > 0 && path[end - 1] === "/") end--;
+    url.pathname = `${path.slice(0, end)}/${platform}`;
+  }
+  url.hash = viewerDid ? `${ownerDid}+${viewerDid}` : ownerDid;
+  return url.toString();
+}
+function germPlatformFromUserAgent(userAgent) {
+  if (!userAgent) return "web";
+  if (/\b(iPhone|iPad|iPod)\b/.test(userAgent)) return "iOS";
+  if (/\bAndroid\b/i.test(userAgent)) return "android";
+  return "web";
+}
+
 // src/logic/actor-identity.ts
 function actorShowsIdentity(actor) {
   return !!(actor.confirmed || actor.claimed);
@@ -7069,6 +7132,16 @@ var EndorsementRecordSchema = zod.z.object({
   comment: zod.z.string().refine(maxGraphemes(300)).max(3e3).optional(),
   createdAt: datetimeSchema
 });
+var GERM_SHOW_BUTTON_TO_VALUES = ["none", "usersIFollow", "everyone"];
+var GermDeclarationRecordSchema = zod.z.object({
+  version: zod.z.string().min(5).max(14),
+  // JSON form (`{ $bytes }`, PDS and Jetstream) or decoded CBOR (`Uint8Array`).
+  currentKey: zod.z.union([zod.z.object({ $bytes: zod.z.string() }), zod.z.instanceof(Uint8Array)]),
+  messageMe: zod.z.object({
+    showButtonTo: zod.z.string().min(1).max(100),
+    messageMeUrl: zod.z.string().min(1).max(2047)
+  }).optional()
+}).passthrough();
 var OrgEmploymentAttestationRecordSchema = zod.z.object({
   subject: didSchema,
   position: strongRefSchema.optional(),
@@ -7855,7 +7928,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.108";
+var SIFA_SDK_VERSION = "0.19.109";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -7915,6 +7988,9 @@ exports.FollowFeedItemSchema = FollowFeedItemSchema;
 exports.FollowFeedPageSchema = FollowFeedPageSchema;
 exports.FollowProfilePageSchema = FollowProfilePageSchema;
 exports.FollowProfileSchema = FollowProfileSchema;
+exports.GERM_MESSAGE_HOSTS = GERM_MESSAGE_HOSTS;
+exports.GERM_SHOW_BUTTON_TO_VALUES = GERM_SHOW_BUTTON_TO_VALUES;
+exports.GermDeclarationRecordSchema = GermDeclarationRecordSchema;
 exports.GraphFollowRecordSchema = GraphFollowRecordSchema;
 exports.INDUSTRY_LABELS = INDUSTRY_LABELS;
 exports.INDUSTRY_OPTIONS = INDUSTRY_OPTIONS;
@@ -8000,6 +8076,7 @@ exports.agentRefSchema = agentRefSchema;
 exports.appLinksItems = appLinksItems;
 exports.atUriSchema = atUriSchema;
 exports.blobProxyUrl = blobProxyUrl;
+exports.buildGermMessageUrl = buildGermMessageUrl;
 exports.buildMetaDescription = buildMetaDescription;
 exports.buildProfileHighlights = buildProfileHighlights;
 exports.buildTalkSlug = buildTalkSlug;
@@ -8048,6 +8125,8 @@ exports.formatRelativeTime = formatRelativeTime;
 exports.formatSingleDate = formatSingleDate;
 exports.formatSpanDate = formatSpanDate;
 exports.formatTimelineDate = formatTimelineDate;
+exports.germButtonAudience = germButtonAudience;
+exports.germPlatformFromUserAgent = germPlatformFromUserAgent;
 exports.getActivityTaxonomyVersion = getActivityTaxonomyVersion;
 exports.getActivityTier = getActivityTier;
 exports.getActivityVerbsVersion = getActivityVerbsVersion;
@@ -8111,6 +8190,7 @@ exports.isRoleLineRedundant = isRoleLineRedundant;
 exports.isSectionPopulated = isSectionPopulated;
 exports.isSelfAuthoredRich = isSelfAuthoredRich;
 exports.isSiteActivityPresetActive = isSiteActivityPresetActive;
+exports.isStrictDid = isStrictDid;
 exports.isTeachingCourse = isTeachingCourse;
 exports.isTimelineWorthy = isTimelineWorthy;
 exports.isUpcomingStart = isUpcomingStart;
@@ -8178,6 +8258,7 @@ exports.sanitizeHandleInput = sanitizeHandleInput;
 exports.searchResultDisambiguation = searchResultDisambiguation;
 exports.selfLabelsSchema = selfLabelsSchema;
 exports.shouldRenderHighlights = shouldRenderHighlights;
+exports.shouldShowGermButton = shouldShowGermButton;
 exports.singleDateExtractor = singleDateExtractor;
 exports.siteActivityPresetSchema = siteActivityPresetSchema;
 exports.siteActivityPresetUpdateSchema = siteActivityPresetUpdateSchema;