@singi-labs/sifa-sdk 0.19.107 → 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

@@ -3798,6 +3798,106 @@ var presentationLinkSchema = zod.z.object({
   label: zod.z.string().max(640).nullable().optional(),
   type: zod.z.string().max(256).nullable().optional()
 });
+function maxGraphemes(max) {
+  return (value) => {
+    const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+    let count = 0;
+    for (const _ of segmenter.segment(value)) {
+      count++;
+      if (count > max) return false;
+    }
+    return true;
+  };
+}
+var didSchema = zod.z.string().regex(/^did:[a-z]+:[a-zA-Z0-9._:%-]+$/, "Invalid DID");
+var datetimeSchema = zod.z.string().datetime({ offset: true });
+var partialDateSchema = zod.z.string().regex(/^\d{4}(-\d{2}(-\d{2}(T.+)?)?)?$/, "Expected YYYY, YYYY-MM, YYYY-MM-DD, or a datetime");
+var atUriSchema = zod.z.string().regex(/^at:\/\/[^\s]+$/, "Invalid AT-URI");
+var cidSchema = zod.z.string().regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z0-9+/=]+)$/, "Invalid CID");
+var languageTagSchema = zod.z.string().regex(/^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$/, "Invalid BCP 47 language tag");
+var uriSchema = zod.z.string().url();
+var strongRefSchema = zod.z.object({
+  uri: atUriSchema,
+  cid: cidSchema
+});
+var skillRefSchema2 = zod.z.object({
+  uri: atUriSchema
+});
+var externalRecordRefSchema2 = zod.z.object({
+  uri: atUriSchema,
+  cid: cidSchema.optional()
+});
+var agentRefSchema = zod.z.object({
+  name: zod.z.string().min(1).refine(maxGraphemes(256)).max(2560),
+  did: didSchema.optional(),
+  entityRef: uriSchema.optional()
+}).passthrough();
+var selfLabelsSchema = zod.z.object({
+  $type: zod.z.literal("com.atproto.label.defs#selfLabels").optional(),
+  values: zod.z.array(zod.z.object({ val: zod.z.string() }))
+});
+
+// src/schemas/org-profile.ts
+var orgAddressSchema = zod.z.object({
+  country: zod.z.string().optional(),
+  postalCode: zod.z.string().optional(),
+  region: zod.z.string().optional(),
+  locality: zod.z.string().optional(),
+  street: zod.z.string().optional(),
+  name: zod.z.string().optional()
+});
+var orgLinkSchema = zod.z.object({
+  name: zod.z.string().refine(maxGraphemes(60)).max(600),
+  url: uriSchema.max(2048)
+});
+var orgNameField = zod.z.string().min(1).refine(maxGraphemes(200)).max(2e3);
+var orgDescriptionField = zod.z.string().refine(maxGraphemes(5e3)).max(5e4);
+var orgAliasField = zod.z.string().refine(maxGraphemes(200)).max(2e3);
+var OrgProfileRecordSchema = zod.z.object({
+  name: orgNameField,
+  description: orgDescriptionField.optional(),
+  /** Blob ref for the org logo (`image/png` | `image/jpeg`). Not deeply validated client-side. */
+  logo: zod.z.unknown().optional(),
+  website: uriSchema.optional(),
+  entityRefs: zod.z.array(uriSchema).max(20).optional(),
+  /** Contact email. NOT rendered publicly; validated as email at the app layer. */
+  contact: zod.z.string().optional(),
+  /** Physical addresses (headquarters, offices). */
+  addresses: zod.z.array(orgAddressSchema).max(10).optional(),
+  /**
+   * Self-selected headcount range (a declared bucket, never a calculated count).
+   * Open enum (bare-string knownValues in the lexicon): `1-10`, `11-50`,
+   * `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000`, `10001+`. Any
+   * string is accepted so future ranges do not break older records.
+   */
+  companySize: zod.z.string().optional(),
+  companyType: zod.z.string().optional(),
+  /** Featured links or content surfaced on the org profile. */
+  links: zod.z.array(orgLinkSchema).max(10).optional(),
+  /**
+   * Self-declared industry/domain pairs (same shape as the person profile's
+   * `industries`). Registry-sourced classifications are layered separately.
+   */
+  industries: zod.z.array(
+    zod.z.object({
+      industry: zod.z.string().max(100),
+      domain: zod.z.string().max(100).optional()
+    })
+  ).max(10).optional(),
+  /** Self-declared founding date: a year (YYYY), month (YYYY-MM), or full date (YYYY-MM-DD). */
+  founded: zod.z.string().max(10).optional(),
+  /** Self-declared alternative names / acronyms ("also known as"). */
+  aliases: zod.z.array(orgAliasField).max(20).optional(),
+  /**
+   * Whether the account holder's personal profile stays visible alongside this
+   * org profile. For sole traders whose personal domain is also their trade
+   * name: one account, two facets, both pages render. Absent or false means the
+   * account presents solely as an organization.
+   */
+  personalProfileVisible: zod.z.boolean().optional(),
+  labels: selfLabelsSchema.optional(),
+  createdAt: datetimeSchema
+});
 var PresentationDeliveryWriteSchema = zod.z.object({
   presentationRef: externalRecordRefSchema.optional(),
   /**
@@ -3843,44 +3943,6 @@ var PresentationWriteSchema = zod.z.object({
   writeupRef: externalRecordRefSchema.optional(),
   coverImage: BlobRefSchema.nullable().optional()
 });
-function maxGraphemes(max) {
-  return (value) => {
-    const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
-    let count = 0;
-    for (const _ of segmenter.segment(value)) {
-      count++;
-      if (count > max) return false;
-    }
-    return true;
-  };
-}
-var didSchema = zod.z.string().regex(/^did:[a-z]+:[a-zA-Z0-9._:%-]+$/, "Invalid DID");
-var datetimeSchema = zod.z.string().datetime({ offset: true });
-var partialDateSchema = zod.z.string().regex(/^\d{4}(-\d{2}(-\d{2}(T.+)?)?)?$/, "Expected YYYY, YYYY-MM, YYYY-MM-DD, or a datetime");
-var atUriSchema = zod.z.string().regex(/^at:\/\/[^\s]+$/, "Invalid AT-URI");
-var cidSchema = zod.z.string().regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z0-9+/=]+)$/, "Invalid CID");
-var languageTagSchema = zod.z.string().regex(/^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$/, "Invalid BCP 47 language tag");
-var uriSchema = zod.z.string().url();
-var strongRefSchema = zod.z.object({
-  uri: atUriSchema,
-  cid: cidSchema
-});
-var skillRefSchema2 = zod.z.object({
-  uri: atUriSchema
-});
-var externalRecordRefSchema2 = zod.z.object({
-  uri: atUriSchema,
-  cid: cidSchema.optional()
-});
-var agentRefSchema = zod.z.object({
-  name: zod.z.string().min(1).refine(maxGraphemes(256)).max(2560),
-  did: didSchema.optional(),
-  entityRef: uriSchema.optional()
-}).passthrough();
-var selfLabelsSchema = zod.z.object({
-  $type: zod.z.literal("com.atproto.label.defs#selfLabels").optional(),
-  values: zod.z.array(zod.z.object({ val: zod.z.string() }))
-});
 
 // src/import/talks-import-validation.ts
 var PRESENTATION_URL_COLUMNS = ["slides_url", "recording_url", "writeup_url"];
@@ -6472,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);
@@ -7007,63 +7132,16 @@ var EndorsementRecordSchema = zod.z.object({
   comment: zod.z.string().refine(maxGraphemes(300)).max(3e3).optional(),
   createdAt: datetimeSchema
 });
-var orgAddressSchema = zod.z.object({
-  country: zod.z.string().optional(),
-  postalCode: zod.z.string().optional(),
-  region: zod.z.string().optional(),
-  locality: zod.z.string().optional(),
-  street: zod.z.string().optional(),
-  name: zod.z.string().optional()
-});
-var orgLinkSchema = zod.z.object({
-  name: zod.z.string().refine(maxGraphemes(60)).max(600),
-  url: uriSchema.max(2048)
-});
-var OrgProfileRecordSchema = zod.z.object({
-  name: zod.z.string().min(1).refine(maxGraphemes(200)).max(2e3),
-  description: zod.z.string().refine(maxGraphemes(5e3)).max(5e4).optional(),
-  /** Blob ref for the org logo (`image/png` | `image/jpeg`). Not deeply validated client-side. */
-  logo: zod.z.unknown().optional(),
-  website: uriSchema.optional(),
-  entityRefs: zod.z.array(uriSchema).max(20).optional(),
-  /** Contact email. NOT rendered publicly; validated as email at the app layer. */
-  contact: zod.z.string().optional(),
-  /** Physical addresses (headquarters, offices). */
-  addresses: zod.z.array(orgAddressSchema).max(10).optional(),
-  /**
-   * Self-selected headcount range (a declared bucket, never a calculated count).
-   * Open enum (bare-string knownValues in the lexicon): `1-10`, `11-50`,
-   * `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000`, `10001+`. Any
-   * string is accepted so future ranges do not break older records.
-   */
-  companySize: zod.z.string().optional(),
-  companyType: zod.z.string().optional(),
-  /** Featured links or content surfaced on the org profile. */
-  links: zod.z.array(orgLinkSchema).max(10).optional(),
-  /**
-   * Self-declared industry/domain pairs (same shape as the person profile's
-   * `industries`). Registry-sourced classifications are layered separately.
-   */
-  industries: zod.z.array(
-    zod.z.object({
-      industry: zod.z.string().max(100),
-      domain: zod.z.string().max(100).optional()
-    })
-  ).max(10).optional(),
-  /** Self-declared founding date: a year (YYYY), month (YYYY-MM), or full date (YYYY-MM-DD). */
-  founded: zod.z.string().max(10).optional(),
-  /** Self-declared alternative names / acronyms ("also known as"). */
-  aliases: zod.z.array(zod.z.string().refine(maxGraphemes(200)).max(2e3)).max(20).optional(),
-  /**
-   * Whether the account holder's personal profile stays visible alongside this
-   * org profile. For sole traders whose personal domain is also their trade
-   * name: one account, two facets, both pages render. Absent or false means the
-   * account presents solely as an organization.
-   */
-  personalProfileVisible: zod.z.boolean().optional(),
-  labels: selfLabelsSchema.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(),
@@ -7850,7 +7928,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.107";
+var SIFA_SDK_VERSION = "0.19.109";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -7910,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;
@@ -7995,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;
@@ -8043,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;
@@ -8106,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;
@@ -8173,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;