@singi-labs/sifa-sdk 0.19.93 → 0.19.95

package/README.md

@@ -27,16 +27,17 @@ Published publicly so third-party developers can build their own AT Protocol cli
 
 ## What this package contains
 
-| Area        | What it provides                                                                      |
-| ----------- | ------------------------------------------------------------------------------------- |
-| Types       | TypeScript types for Sifa data structures, generated from `sifa-lexicons`             |
-| Schemas     | Zod schemas mirroring lexicon constraints for runtime validation                      |
-| Query layer | TanStack Query keys, fetchers, and React hooks for calling `sifa-api`                 |
-| ATproto     | Wrapper around `@atproto/api` that accepts an authenticated agent                     |
-| Format      | Pure formatters for dates, locations, profile completeness                            |
-| Logic       | Business-logic predicates (display-only; server-side trust logic lives in `sifa-api`) |
-| Taxonomy    | Constants and enums (continents, industries, skill categories, activity tiers)        |
-| Tokens      | Sifa-brand design tokens, exported via `@singi-labs/sifa-sdk/tokens` (optional)       |
+| Area        | What it provides                                                                                        |
+| ----------- | ------------------------------------------------------------------------------------------------------- |
+| Types       | TypeScript types for Sifa data structures, generated from `sifa-lexicons`                               |
+| Schemas     | Zod schemas mirroring lexicon constraints for runtime validation                                        |
+| Query layer | TanStack Query keys, fetchers, and React hooks for calling `sifa-api`                                   |
+| ATproto     | Wrapper around `@atproto/api` that accepts an authenticated agent                                       |
+| Format      | Pure formatters for dates, locations, profile completeness                                              |
+| Logic       | Business-logic predicates (display-only; server-side trust logic lives in `sifa-api`)                   |
+| Taxonomy    | Constants and enums (continents, industries, skill categories, activity tiers)                          |
+| Tokens      | Sifa-brand design tokens, exported via `@singi-labs/sifa-sdk/tokens` (optional)                         |
+| Testing     | Anonymized profile responses and sample export details, via `@singi-labs/sifa-sdk/testing` (tests only) |
 
 ---
 

package/dist/export-contact-D_krcTBH.d.cts

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+
+/**
+ * Private contact and personal details for exports: email, phone, postal
+ * address, driver's license, right to work and nationality.
+ *
+ * Sifa never stores these and never writes them to the owner's PDS, where they
+ * would be public. The owner types them on the export page, the browser keeps
+ * them, and they go only into the files the owner downloads. This module holds
+ * the shape, the limits and the pick rule, so the export page and the server
+ * that builds a funder CV agree on them.
+ */
+
+/** Longest value accepted per field. 254 is the longest valid email address. */
+declare const EXPORT_CONTACT_LIMITS: {
+    readonly email: 254;
+    readonly phone: 40;
+    readonly address: 500;
+    readonly driversLicense: 60;
+    readonly rightToWork: 200;
+    readonly nationality: 100;
+};
+/** The contact details that go into an export. Absent keys are left out. */
+interface ExportContact {
+    readonly email?: string;
+    readonly phone?: string;
+    /** Free text; lines are separated by `\n`. */
+    readonly address?: string;
+    /** License categories, e.g. "B, BE". */
+    readonly driversLicense?: string;
+    /** e.g. "EU citizen, no sponsorship needed". */
+    readonly rightToWork?: string;
+    readonly nationality?: string;
+}
+/** What the owner has typed, plus which fields they chose to include. */
+interface ExportContactDraft {
+    readonly email?: string;
+    readonly phone?: string;
+    readonly address?: string;
+    readonly driversLicense?: string;
+    readonly rightToWork?: string;
+    readonly nationality?: string;
+    readonly includeEmail?: boolean;
+    readonly includePhone?: boolean;
+    readonly includeAddress?: boolean;
+    readonly includeDriversLicense?: boolean;
+    readonly includeRightToWork?: boolean;
+    readonly includeNationality?: boolean;
+}
+/**
+ * Validates a picked contact. Only lengths are checked: phone numbers and
+ * addresses vary too much between countries, and a wrong-looking email is a
+ * warning for the owner, not a reason to refuse the export.
+ */
+declare const exportContactSchema: z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    driversLicense: z.ZodOptional<z.ZodString>;
+    rightToWork: z.ZodOptional<z.ZodString>;
+    nationality: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * The fields to put in an export: the included ones that are not blank, run
+ * through {@link normalizeExportContact}.
+ */
+declare function pickExportContact(draft: ExportContactDraft): ExportContact;
+/**
+ * Drops blank fields and tidies the rest. Every field but the address becomes
+ * one line with single spaces. An address keeps its line breaks but loses blank lines and the
+ * spaces around each line. Each field is cut at its {@link EXPORT_CONTACT_LIMITS}
+ * length. The emitters call this too, so a caller that skips
+ * {@link pickExportContact} and the schema gets the same bounded output.
+ */
+declare function normalizeExportContact(contact: ExportContact): ExportContact;
+/** A loose shape check for a non-blocking "check this address" hint. */
+declare function looksLikeEmail(value: string): boolean;
+
+export { type ExportContact as E, EXPORT_CONTACT_LIMITS as a, type ExportContactDraft as b, exportContactSchema as e, looksLikeEmail as l, normalizeExportContact as n, pickExportContact as p };

package/dist/export-contact-D_krcTBH.d.ts

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+
+/**
+ * Private contact and personal details for exports: email, phone, postal
+ * address, driver's license, right to work and nationality.
+ *
+ * Sifa never stores these and never writes them to the owner's PDS, where they
+ * would be public. The owner types them on the export page, the browser keeps
+ * them, and they go only into the files the owner downloads. This module holds
+ * the shape, the limits and the pick rule, so the export page and the server
+ * that builds a funder CV agree on them.
+ */
+
+/** Longest value accepted per field. 254 is the longest valid email address. */
+declare const EXPORT_CONTACT_LIMITS: {
+    readonly email: 254;
+    readonly phone: 40;
+    readonly address: 500;
+    readonly driversLicense: 60;
+    readonly rightToWork: 200;
+    readonly nationality: 100;
+};
+/** The contact details that go into an export. Absent keys are left out. */
+interface ExportContact {
+    readonly email?: string;
+    readonly phone?: string;
+    /** Free text; lines are separated by `\n`. */
+    readonly address?: string;
+    /** License categories, e.g. "B, BE". */
+    readonly driversLicense?: string;
+    /** e.g. "EU citizen, no sponsorship needed". */
+    readonly rightToWork?: string;
+    readonly nationality?: string;
+}
+/** What the owner has typed, plus which fields they chose to include. */
+interface ExportContactDraft {
+    readonly email?: string;
+    readonly phone?: string;
+    readonly address?: string;
+    readonly driversLicense?: string;
+    readonly rightToWork?: string;
+    readonly nationality?: string;
+    readonly includeEmail?: boolean;
+    readonly includePhone?: boolean;
+    readonly includeAddress?: boolean;
+    readonly includeDriversLicense?: boolean;
+    readonly includeRightToWork?: boolean;
+    readonly includeNationality?: boolean;
+}
+/**
+ * Validates a picked contact. Only lengths are checked: phone numbers and
+ * addresses vary too much between countries, and a wrong-looking email is a
+ * warning for the owner, not a reason to refuse the export.
+ */
+declare const exportContactSchema: z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    driversLicense: z.ZodOptional<z.ZodString>;
+    rightToWork: z.ZodOptional<z.ZodString>;
+    nationality: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * The fields to put in an export: the included ones that are not blank, run
+ * through {@link normalizeExportContact}.
+ */
+declare function pickExportContact(draft: ExportContactDraft): ExportContact;
+/**
+ * Drops blank fields and tidies the rest. Every field but the address becomes
+ * one line with single spaces. An address keeps its line breaks but loses blank lines and the
+ * spaces around each line. Each field is cut at its {@link EXPORT_CONTACT_LIMITS}
+ * length. The emitters call this too, so a caller that skips
+ * {@link pickExportContact} and the schema gets the same bounded output.
+ */
+declare function normalizeExportContact(contact: ExportContact): ExportContact;
+/** A loose shape check for a non-blocking "check this address" hint. */
+declare function looksLikeEmail(value: string): boolean;
+
+export { type ExportContact as E, EXPORT_CONTACT_LIMITS as a, type ExportContactDraft as b, exportContactSchema as e, looksLikeEmail as l, normalizeExportContact as n, pickExportContact as p };

package/dist/index.cjs

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

package/dist/index.js

@@ -377,7 +377,7 @@ import {
   roadmapIssueUrl
 } from "./roadmap/index.js";
 import { SIFA_REPO_GROUPS, describeSifaRecord, repoGroupForCollection } from "./repo/index.js";
-var SIFA_SDK_VERSION = "0.19.93";
+var SIFA_SDK_VERSION = "0.19.95";
 export {
   ACTIVITY_TIERS,
   ACTIVITY_VERBS,

package/dist/resume/index.cjs

@@ -255,6 +255,13 @@ function mapLocation(profile, s) {
   ];
   return candidates.find((c) => Object.keys(c).length > 0);
 }
+function link(value, s) {
+  const t = value?.replace(/\s+/g, "");
+  if (!t) return void 0;
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(t)) return URL.canParse(t) ? s(t) : void 0;
+  const withScheme = `https://${t}`;
+  return /^[^\s/]+\.[^\s/]+/.test(t) && URL.canParse(withScheme) ? s(withScheme) : void 0;
+}
 function text(value, s) {
   const trimmed = value?.trim();
   return trimmed ? s(trimmed) : void 0;
@@ -272,7 +279,7 @@ function profileToJsonResume(profile, options = {}) {
     (account) => compact({
       network: s(account.platform),
       username: text(account.label, s),
-      url: text(account.url, s)
+      url: link(account.url, s)
     })
   );
   const basics = compact({
@@ -281,7 +288,7 @@ function profileToJsonResume(profile, options = {}) {
     image: text(profile.avatar, s),
     email: text(contact.email, s),
     phone: text(contact.phone, s),
-    url: text(profile.website, s) ?? canonical,
+    url: link(profile.website, s) ?? canonical,
     summary: text(profile.about, s),
     location: withAddress(mapLocation(profile, s), text(contact.address, s)),
     ...section("profiles", profiles)
@@ -328,7 +335,7 @@ function profileToJsonResume(profile, options = {}) {
       // `issuingOrg` is the deprecated read-view alias for `authority`; records
       // indexed before the rename carry only the alias.
       issuer: orgName(cert.entityName, cert.authority ?? cert.issuingOrg, s),
-      url: text(cert.credentialUrl, s)
+      url: link(cert.credentialUrl, s)
     })
   );
   const publications = sortPublications(filterHidden(profile.publications)).map(
@@ -336,7 +343,7 @@ function profileToJsonResume(profile, options = {}) {
       name: s(publication.title),
       publisher: text(publication.publisher, s),
       releaseDate: toResumeDate(publication.date),
-      url: text(publication.url, s),
+      url: link(publication.url, s),
       summary: text(publication.description, s)
     })
   );
@@ -351,7 +358,7 @@ function profileToJsonResume(profile, options = {}) {
     (project) => compact({
       name: s(project.name),
       description: text(project.description, s),
-      url: text(project.url, s),
+      url: link(project.url, s),
       startDate: toResumeDate(project.startDate),
       endDate: toResumeDate(project.endDate)
     })