@singi-labs/sifa-sdk 0.11.21 → 0.11.23

package/dist/shared-CHCY7Lst.d.cts

@@ -0,0 +1,416 @@
+import { z } from 'zod';
+
+/**
+ * Duration of a presentation, in minutes. Mirrors
+ * `id.sifa.profile.presentation#duration`: a fixed length (minMinutes only) or
+ * a range (minMinutes to maxMinutes).
+ */
+declare const PresentationDurationSchema: z.ZodObject<{
+    minMinutes: z.ZodNumber;
+    maxMinutes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type PresentationDuration = z.infer<typeof PresentationDurationSchema>;
+/**
+ * A related link for a presentation or one of its deliveries. Mirrors
+ * `id.sifa.defs#presentationLink`. `type` is an open enum (knownValues), so any
+ * string is accepted.
+ */
+declare const PresentationLinkSchema: z.ZodObject<{
+    uri: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type PresentationLink = z.infer<typeof PresentationLinkSchema>;
+/** Zod schema for `id.sifa.profile.presentation` records (the reusable content). */
+declare const ProfilePresentationRecordSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodObject<{
+        minMinutes: z.ZodNumber;
+        maxMinutes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    intendedAudiences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    writeupRef: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfilePresentationRecord = z.infer<typeof ProfilePresentationRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.endorsement.confirmation` records.
+ * Lives in the endorsee's PDS to approve display of an endorsement.
+ */
+declare const EndorsementConfirmationRecordSchema: z.ZodObject<{
+    endorsement: z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type EndorsementConfirmationRecord = z.infer<typeof EndorsementConfirmationRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.endorsement` records. Lives in the endorser's PDS;
+ * the endorser identity is implicit (whoever owns the repository).
+ */
+declare const EndorsementRecordSchema: z.ZodObject<{
+    subject: z.ZodString;
+    skill: z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>;
+    skillName: z.ZodString;
+    comment: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type EndorsementRecord = z.infer<typeof EndorsementRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.graph.follow` records.
+ *
+ * One-way professional follow; the record lives in the follower's PDS. Per
+ * iter-1 decisions (`plans/2026-06-01-in-sifa-follow-primitive.md`), this is
+ * a **distinct** graph from `app.bsky.graph.follow`, not a superset — but
+ * the required field shape (`subject` + `createdAt`) is intentionally
+ * identical so generic Bluesky `listRecords` consumers get usable records.
+ *
+ * `note` is a Sifa addition: an optional reason for the follow ("why I
+ * followed"). Capped at 200 graphemes to match other profile-flavored
+ * lexicon fields.
+ */
+declare const GraphFollowRecordSchema: z.ZodObject<{
+    subject: z.ZodString;
+    createdAt: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GraphFollowRecord = z.infer<typeof GraphFollowRecordSchema>;
+/**
+ * Build a `GraphFollowRecordSchema` that rejects self-follow at the Zod
+ * layer (CLAUDE.md mandatory standards #3 — input validation; sifa-api#673
+ * E8 — defence in depth).
+ *
+ * Use this on the **client side** when constructing a new follow record
+ * (the follower DID is the authenticated user). The plain
+ * {@link GraphFollowRecordSchema} stays without the refine so firehose
+ * consumers can validate records without context.
+ */
+declare function makeGraphFollowRecordSchema(followerDid: string): z.ZodObject<{
+    subject: z.ZodString;
+    createdAt: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+/** Zod schema for `id.sifa.profile.certification` records. */
+declare const ProfileCertificationRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    authority: z.ZodOptional<z.ZodString>;
+    authorityDid: z.ZodOptional<z.ZodString>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    credentialId: z.ZodOptional<z.ZodString>;
+    credentialUrl: z.ZodOptional<z.ZodString>;
+    issuedAt: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileCertificationRecord = z.infer<typeof ProfileCertificationRecordSchema>;
+
+/** Zod schema for `id.sifa.profile.course` records. */
+declare const ProfileCourseRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    number: z.ZodOptional<z.ZodString>;
+    institution: z.ZodOptional<z.ZodString>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    education: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>>;
+    credential: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileCourseRecord = z.infer<typeof ProfileCourseRecordSchema>;
+
+/** Zod schema for `id.sifa.profile.education` records. */
+declare const ProfileEducationRecordSchema: z.ZodObject<{
+    institution: z.ZodString;
+    institutionDid: z.ZodOptional<z.ZodString>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    degree: z.ZodOptional<z.ZodString>;
+    fieldOfStudy: z.ZodOptional<z.ZodString>;
+    grade: z.ZodOptional<z.ZodString>;
+    activities: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodUnknown>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileEducationRecord = z.infer<typeof ProfileEducationRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.profile.externalAccount` records.
+ *
+ * `platform` is advisory (`knownValues` in the lexicon) -- known values live
+ * under `id.sifa.defs#platform*` but unknown values are accepted.
+ */
+declare const ProfileExternalAccountRecordSchema: z.ZodObject<{
+    platform: z.ZodString;
+    url: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    feedUrl: z.ZodOptional<z.ZodString>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileExternalAccountRecord = z.infer<typeof ProfileExternalAccountRecordSchema>;
+
+/** Zod schema for `id.sifa.profile.honor` records. */
+declare const ProfileHonorRecordSchema: z.ZodObject<{
+    title: z.ZodString;
+    issuer: z.ZodOptional<z.ZodString>;
+    issuerDid: z.ZodOptional<z.ZodString>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    awardedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileHonorRecord = z.infer<typeof ProfileHonorRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.profile.language` records.
+ *
+ * `proficiency` is advisory (`knownValues` in the lexicon) -- known values
+ * are the five-level LinkedIn-compatible scale under `id.sifa.defs#*`.
+ */
+declare const ProfileLanguageRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    proficiency: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileLanguageRecord = z.infer<typeof ProfileLanguageRecordSchema>;
+
+/** Zod schema for `id.sifa.profile.position` records. */
+declare const ProfilePositionRecordSchema: z.ZodObject<{
+    company: z.ZodOptional<z.ZodString>;
+    companyDid: z.ZodOptional<z.ZodString>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    employmentType: z.ZodOptional<z.ZodString>;
+    workplaceType: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodUnknown>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfilePositionRecord = z.infer<typeof ProfilePositionRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.profile.presentationDelivery` records (one occasion
+ * on which a presentation was delivered). Works standalone or linked to a
+ * presentation and/or a calendar event. `role`, `mode`, and `status` are open
+ * enums (knownValues); `mode`/`status` store the full
+ * `community.lexicon.calendar.event` token.
+ */
+declare const ProfilePresentationDeliveryRecordSchema: z.ZodObject<{
+    presentationRef: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    title: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    eventName: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    eventRef: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    coSpeakers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfilePresentationDeliveryRecord = z.infer<typeof ProfilePresentationDeliveryRecordSchema>;
+
+/** Zod schema for `id.sifa.profile.project` records. */
+declare const ProfileProjectRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileProjectRecord = z.infer<typeof ProfileProjectRecordSchema>;
+
+/** Author shape from `id.sifa.profile.publication#author`. */
+declare const PublicationAuthorSchema: z.ZodObject<{
+    name: z.ZodString;
+    did: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type PublicationAuthor = z.infer<typeof PublicationAuthorSchema>;
+/** Zod schema for `id.sifa.profile.publication` records. */
+declare const ProfilePublicationRecordSchema: z.ZodObject<{
+    title: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    publisher: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        did: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    publishedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfilePublicationRecord = z.infer<typeof ProfilePublicationRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.profile.self` records. Singleton (record key `self`).
+ *
+ * `knownValues` on `openTo` and `preferredWorkplace` are advisory per the
+ * lexicon spec -- unknown values are allowed, but documented options live
+ * under the `id.sifa.defs#*` namespace.
+ */
+declare const ProfileSelfRecordSchema: z.ZodObject<{
+    headline: z.ZodOptional<z.ZodString>;
+    about: z.ZodOptional<z.ZodString>;
+    industry: z.ZodOptional<z.ZodString>;
+    givenName: z.ZodOptional<z.ZodString>;
+    familyName: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodUnknown>;
+    openTo: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    preferredWorkplace: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    langs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    discoverable: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileSelfRecord = z.infer<typeof ProfileSelfRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.profile.skill` records.
+ *
+ * `category` is advisory (`knownValues` in the lexicon) -- known values live
+ * under `id.sifa.defs#*` but unknown values are accepted.
+ */
+declare const ProfileSkillRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileSkillRecord = z.infer<typeof ProfileSkillRecordSchema>;
+
+/** Zod schema for `id.sifa.profile.volunteering` records. */
+declare const ProfileVolunteeringRecordSchema: z.ZodObject<{
+    organization: z.ZodString;
+    organizationDid: z.ZodOptional<z.ZodString>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    cause: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfileVolunteeringRecord = z.infer<typeof ProfileVolunteeringRecordSchema>;
+
+/**
+ * Grapheme-aware refinement matching the AT Protocol lexicon `maxGraphemes`
+ * constraint. JS strings are sequences of UTF-16 code units, but lexicon
+ * `maxGraphemes` counts user-perceived characters (grapheme clusters), so
+ * emoji sequences, regional indicators, ZWJ joins, and combining marks all
+ * count as one unit each. We use `Intl.Segmenter` to enforce this correctly.
+ */
+declare function maxGraphemes(max: number): (value: string) => boolean;
+/** Decentralized identifier, AT Protocol `format: did`. */
+declare const didSchema: z.ZodString;
+/** RFC 3339 datetime with timezone offset, AT Protocol `format: datetime`. */
+declare const datetimeSchema: z.ZodString;
+/** Generic AT-URI, AT Protocol `format: at-uri`. */
+declare const atUriSchema: z.ZodString;
+/** Content identifier, AT Protocol `format: cid`. Loose validation -- accepts CIDv0 and CIDv1. */
+declare const cidSchema: z.ZodString;
+/** BCP 47 language tag, AT Protocol `format: language`. */
+declare const languageTagSchema: z.ZodString;
+/** Generic URI, AT Protocol `format: uri`. */
+declare const uriSchema: z.ZodString;
+/**
+ * StrongRef shape from `com.atproto.repo.strongRef` -- pins a record by both
+ * AT-URI (identity) and CID (version).
+ */
+declare const strongRefSchema: z.ZodObject<{
+    uri: z.ZodString;
+    cid: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Reference to a record by AT-URI, with an optional CID. Mirrors
+ * `id.sifa.defs#externalRecordRef`. Unlike a strongRef the CID is optional:
+ * consumers resolve the AT-URI live so the reference tracks edits to the
+ * target, and the CID is a best-effort integrity hint only.
+ */
+declare const externalRecordRefSchema: z.ZodObject<{
+    uri: z.ZodString;
+    cid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Self-labels shape from `com.atproto.label.defs#selfLabels`. Modelled
+ * permissively because clients rarely construct this directly; the AppView
+ * handles label validation.
+ */
+declare const selfLabelsSchema: z.ZodObject<{
+    $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+    values: z.ZodArray<z.ZodObject<{
+        val: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export { ProfileProjectRecordSchema as A, type ProfilePublicationRecord as B, ProfilePublicationRecordSchema as C, type ProfileSelfRecord as D, type EndorsementConfirmationRecord as E, ProfileSelfRecordSchema as F, type GraphFollowRecord as G, type ProfileSkillRecord as H, ProfileSkillRecordSchema as I, type ProfileVolunteeringRecord as J, ProfileVolunteeringRecordSchema as K, type PublicationAuthor as L, PublicationAuthorSchema as M, atUriSchema as N, cidSchema as O, type PresentationDuration as P, datetimeSchema as Q, didSchema as R, externalRecordRefSchema as S, languageTagSchema as T, makeGraphFollowRecordSchema as U, maxGraphemes as V, selfLabelsSchema as W, strongRefSchema as X, uriSchema as Y, EndorsementConfirmationRecordSchema as a, type EndorsementRecord as b, EndorsementRecordSchema as c, GraphFollowRecordSchema as d, PresentationDurationSchema as e, type PresentationLink as f, PresentationLinkSchema as g, type ProfileCertificationRecord as h, ProfileCertificationRecordSchema as i, type ProfileCourseRecord as j, ProfileCourseRecordSchema as k, type ProfileEducationRecord as l, ProfileEducationRecordSchema as m, type ProfileExternalAccountRecord as n, ProfileExternalAccountRecordSchema as o, type ProfileHonorRecord as p, ProfileHonorRecordSchema as q, type ProfileLanguageRecord as r, ProfileLanguageRecordSchema as s, type ProfilePositionRecord as t, ProfilePositionRecordSchema as u, type ProfilePresentationDeliveryRecord as v, ProfilePresentationDeliveryRecordSchema as w, type ProfilePresentationRecord as x, ProfilePresentationRecordSchema as y, type ProfileProjectRecord as z };