@takuhon/core 0.15.1 → 0.16.0

package/dist/index.d.ts

@@ -3850,6 +3850,41 @@ interface CvDocument {
  */
 declare function deriveCv(localized: LocalizedTakuhon): CvDocument;
 
+/**
+ * Build a Gravatar avatar URL from an email address.
+ *
+ * Gravatar derives an avatar from the SHA-256 hash of a normalized email
+ * (trimmed + lower-cased), served at `https://gravatar.com/avatar/{hash}`. This
+ * helper assembles that URL so a non-GitHub owner can set an avatar from just an
+ * email — no upload required — alongside the existing "paste a URL" and "upload
+ * an image" paths.
+ *
+ * It is a pure, deterministic transform (no IO, no time, no randomness), the
+ * same style as the other core transforms. The email itself is never stored:
+ * only the returned URL is meant to be saved into `profile.avatar.url`.
+ */
+/** Options for {@link gravatarUrl}. Each maps to a Gravatar query parameter. */
+interface GravatarOptions {
+    /** Pixel size, 1–2048 (`?s=`). */
+    size?: number;
+    /**
+     * Default image when the email has no Gravatar (`?d=`): a keyword
+     * (`mp` / `identicon` / `monsterid` / `wavatar` / `retro` / `robohash` /
+     * `blank`), the literal `404`, or an image URL.
+     */
+    defaultImage?: string;
+}
+/**
+ * Build the Gravatar avatar URL for `email`. The email is trimmed + lower-cased,
+ * SHA-256 hashed, and assembled into `https://gravatar.com/avatar/{hash}` with
+ * any {@link GravatarOptions} appended as query parameters.
+ *
+ * Pure and total: a blank or whitespace-only email still yields a deterministic
+ * URL (callers guard against empty input). The result fits well within the
+ * 2048-character limit on `avatar.url`.
+ */
+declare function gravatarUrl(email: string, options?: GravatarOptions): string;
+
 /**
  * MCP (Model Context Protocol) projection of a profile.
  *
@@ -4059,4 +4094,4 @@ declare function stripImageMetadata(bytes: Uint8Array, mime: AcceptedImageMime):
  */
 declare const SCHEMA_VERSION = "0.5.0";
 
-export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LIGHT_PALETTE, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };
+export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type GravatarOptions, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LIGHT_PALETTE, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, gravatarUrl, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };

package/dist/index.js

@@ -11606,6 +11606,163 @@ function deriveCv(localized) {
   };
 }
 
+// src/sha256.ts
+var K = new Uint32Array([
+  1116352408,
+  1899447441,
+  3049323471,
+  3921009573,
+  961987163,
+  1508970993,
+  2453635748,
+  2870763221,
+  3624381080,
+  310598401,
+  607225278,
+  1426881987,
+  1925078388,
+  2162078206,
+  2614888103,
+  3248222580,
+  3835390401,
+  4022224774,
+  264347078,
+  604807628,
+  770255983,
+  1249150122,
+  1555081692,
+  1996064986,
+  2554220882,
+  2821834349,
+  2952996808,
+  3210313671,
+  3336571891,
+  3584528711,
+  113926993,
+  338241895,
+  666307205,
+  773529912,
+  1294757372,
+  1396182291,
+  1695183700,
+  1986661051,
+  2177026350,
+  2456956037,
+  2730485921,
+  2820302411,
+  3259730800,
+  3345764771,
+  3516065817,
+  3600352804,
+  4094571909,
+  275423344,
+  430227734,
+  506948616,
+  659060556,
+  883997877,
+  958139571,
+  1322822218,
+  1537002063,
+  1747873779,
+  1955562222,
+  2024104815,
+  2227730452,
+  2361852424,
+  2428436474,
+  2756734187,
+  3204031479,
+  3329325298
+]);
+function rotr(x, n) {
+  return x >>> n | x << 32 - n;
+}
+function hex8(x) {
+  return (x >>> 0).toString(16).padStart(8, "0");
+}
+function sha256hex(bytes) {
+  let h0 = 1779033703;
+  let h1 = 3144134277;
+  let h2 = 1013904242;
+  let h3 = 2773480762;
+  let h4 = 1359893119;
+  let h5 = 2600822924;
+  let h6 = 528734635;
+  let h7 = 1541459225;
+  const bitLen = bytes.length * 8;
+  const withOne = bytes.length + 1;
+  const padZeros = ((56 - withOne % 64) % 64 + 64) % 64;
+  const totalLen = withOne + padZeros + 8;
+  const msg = new Uint8Array(totalLen);
+  msg.set(bytes);
+  msg[bytes.length] = 128;
+  const hi = Math.floor(bitLen / 4294967296);
+  const lo = bitLen >>> 0;
+  msg[totalLen - 8] = hi >>> 24 & 255;
+  msg[totalLen - 7] = hi >>> 16 & 255;
+  msg[totalLen - 6] = hi >>> 8 & 255;
+  msg[totalLen - 5] = hi & 255;
+  msg[totalLen - 4] = lo >>> 24 & 255;
+  msg[totalLen - 3] = lo >>> 16 & 255;
+  msg[totalLen - 2] = lo >>> 8 & 255;
+  msg[totalLen - 1] = lo & 255;
+  const w = new Uint32Array(64);
+  for (let chunk = 0; chunk < totalLen; chunk += 64) {
+    for (let i = 0; i < 16; i++) {
+      const o = chunk + i * 4;
+      w[i] = (msg[o] << 24 | msg[o + 1] << 16 | msg[o + 2] << 8 | msg[o + 3]) >>> 0;
+    }
+    for (let i = 16; i < 64; i++) {
+      const s0 = rotr(w[i - 15], 7) ^ rotr(w[i - 15], 18) ^ w[i - 15] >>> 3;
+      const s1 = rotr(w[i - 2], 17) ^ rotr(w[i - 2], 19) ^ w[i - 2] >>> 10;
+      w[i] = w[i - 16] + s0 + w[i - 7] + s1 >>> 0;
+    }
+    let a = h0;
+    let b = h1;
+    let c = h2;
+    let d = h3;
+    let e = h4;
+    let f = h5;
+    let g = h6;
+    let h = h7;
+    for (let i = 0; i < 64; i++) {
+      const big1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25);
+      const ch = e & f ^ ~e & g;
+      const t1 = h + big1 + ch + K[i] + w[i] >>> 0;
+      const big0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22);
+      const maj = a & b ^ a & c ^ b & c;
+      const t2 = big0 + maj >>> 0;
+      h = g;
+      g = f;
+      f = e;
+      e = d + t1 >>> 0;
+      d = c;
+      c = b;
+      b = a;
+      a = t1 + t2 >>> 0;
+    }
+    h0 = h0 + a >>> 0;
+    h1 = h1 + b >>> 0;
+    h2 = h2 + c >>> 0;
+    h3 = h3 + d >>> 0;
+    h4 = h4 + e >>> 0;
+    h5 = h5 + f >>> 0;
+    h6 = h6 + g >>> 0;
+    h7 = h7 + h >>> 0;
+  }
+  return hex8(h0) + hex8(h1) + hex8(h2) + hex8(h3) + hex8(h4) + hex8(h5) + hex8(h6) + hex8(h7);
+}
+
+// src/gravatar.ts
+var GRAVATAR_AVATAR_BASE = "https://gravatar.com/avatar/";
+function gravatarUrl(email, options) {
+  const hash = sha256hex(new TextEncoder().encode(email.trim().toLowerCase()));
+  const params = new URLSearchParams();
+  if (options?.size !== void 0) params.set("s", String(options.size));
+  if (options?.defaultImage !== void 0) params.set("d", options.defaultImage);
+  const query = params.toString();
+  return query ? `${GRAVATAR_AVATAR_BASE}${hash}?${query}` : `${GRAVATAR_AVATAR_BASE}${hash}`;
+}
+
 // src/mcp.ts
 var MCP_PROFILE_SECTIONS = [
   "profile",
@@ -12126,6 +12283,7 @@ export {
   generateJsonLd,
   generatePersonJsonLd,
   generateProfilePageJsonLd,
+  gravatarUrl,
   importTakuhon,
   isActivitySnapshot,
   migrateTakuhon,