@singi-labs/sifa-sdk 0.12.43 → 0.12.45

package/dist/shared-CNr-iMpc.d.ts

@@ -0,0 +1,614 @@
+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>>;
+    coverImage: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodLiteral<"blob">;
+        ref: z.ZodObject<{
+            $link: z.ZodString;
+        }, z.core.$strip>;
+        mimeType: z.ZodString;
+        size: z.ZodNumber;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type ProfilePresentationRecord = z.infer<typeof ProfilePresentationRecordSchema>;
+
+/**
+ * Blob-ref passthrough shared by records that carry an uploaded blob (org logo,
+ * presentation cover image, ...). Mirrors the `blobRefSchema` validated by the
+ * sifa-api write endpoints -- the shape is validated, then written to the PDS
+ * verbatim.
+ */
+declare const BlobRefSchema: z.ZodObject<{
+    $type: z.ZodLiteral<"blob">;
+    ref: z.ZodObject<{
+        $link: z.ZodString;
+    }, z.core.$strip>;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+type BlobRef = z.infer<typeof BlobRefSchema>;
+
+/**
+ * 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>;
+    skill: z.ZodOptional<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.ZodOptional<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.org.profile` records -- the self-declared
+ * organization profile. Singleton (record key `self`), lives in the org's PDS.
+ * Presence of this record marks the account as presenting as an organization;
+ * trust is layered separately (rendering floor, verification labels).
+ *
+ * Mirrors the lexicon wire shape (grapheme + byte caps, blob logo, uri refs).
+ * For the sifa-api write-endpoint contract, use the schemas under
+ * `@singi-labs/sifa-sdk/schemas/write` instead.
+ */
+declare const OrgProfileRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodUnknown>;
+    website: z.ZodOptional<z.ZodString>;
+    entityRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contact: z.ZodOptional<z.ZodString>;
+    addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        country: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        locality: z.ZodOptional<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    companySize: z.ZodOptional<z.ZodString>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>>;
+    personalProfileVisible: z.ZodOptional<z.ZodBoolean>;
+    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 OrgProfileRecord = z.infer<typeof OrgProfileRecordSchema>;
+
+/**
+ * Zod schema for `id.sifa.org.employmentAttestation` records -- an
+ * organization's attestation that a person is or was employed in a specific
+ * position. Lives in the org's PDS (the org is implicit: whoever owns the repo).
+ *
+ * The position identity is pinned via a snapshot triple (`title`, `startedAt`,
+ * and the entity identifier `entityRef` | `companyDid`) so editing those pinned
+ * fields on the referenced position record voids the attestation. The free-text
+ * company name is never pinned (a rebrand must not invalidate the attestation).
+ *
+ * `startedAt` / `endedAt` mirror the position lexicon's freeform `YYYY-MM` /
+ * `YYYY-MM-DD` date shape, not strict `datetime`.
+ */
+declare const OrgEmploymentAttestationRecordSchema: z.ZodObject<{
+    subject: z.ZodString;
+    position: z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodEnum<{
+        current: "current";
+        past: "past";
+    }>;
+    title: z.ZodString;
+    startedAt: z.ZodString;
+    entityRef: z.ZodOptional<z.ZodString>;
+    companyDid: z.ZodOptional<z.ZodString>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    comment: 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 OrgEmploymentAttestationRecord = z.infer<typeof OrgEmploymentAttestationRecordSchema>;
+
+/**
+ * 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>;
+    completedAt: 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>;
+
+/** Collection NSID for involvement records. Pass to the generic record helpers. */
+declare const PROFILE_INVOLVEMENT_NSID = "id.sifa.profile.involvement";
+/**
+ * A public artifact proving a piece of work. Mirrors `id.sifa.defs#artifactLink`.
+ * `kind` is an open enum (bare-string knownValues), so any string is accepted.
+ * `.passthrough()` keeps unknown fields a newer client or co-writer may emit.
+ */
+declare const ArtifactLinkSchema: z.ZodObject<{
+    url: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type ArtifactLink = z.infer<typeof ArtifactLinkSchema>;
+/**
+ * Zod schema for `id.sifa.profile.involvement` records.
+ *
+ * `.passthrough()` (not `.strict()`): external apps (Verak, weareonhire)
+ * co-write `id.sifa.*`, so an older SDK must not reject a record carrying a
+ * field it doesn't know yet. `kind` is an open enum matching the lexicon's
+ * knownValues but accepting any string for the same forward-compat reason.
+ */
+declare const ProfileInvolvementRecordSchema: z.ZodObject<{
+    kind: z.ZodString;
+    upstream: z.ZodOptional<z.ZodString>;
+    upstreamDid: z.ZodOptional<z.ZodString>;
+    upstreamUrl: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    endedAt: z.ZodOptional<z.ZodString>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodUnknown>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: 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.$loose>;
+type ProfileInvolvementRecord = z.infer<typeof ProfileInvolvementRecordSchema>;
+
+/**
+ * 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;
+    }, z.core.$strip>>>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
+    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.$loose>;
+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>;
+    address: z.ZodOptional<z.ZodObject<{
+        country: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        locality: z.ZodOptional<z.ZodString>;
+        street: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    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>;
+    members: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        did: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    projectRef: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>>;
+    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. `subCategory` is a
+ * freeform user-defined grouping label nested under `category` (no known
+ * values); renderers decide its display label.
+ */
+declare const ProfileSkillRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    subCategory: 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;
+/**
+ * Freeform calendar date for user-facing profile dates (start/end, issued,
+ * completed, awarded, published, etc.). Accepts a bare year, year-month,
+ * year-month-day, or a full datetime (so a legacy record's RFC-3339 date maps
+ * through on backfill without loss). NOT strict `datetime` -- users typically
+ * remember only month/year, and LinkedIn-importer writes carry partial dates,
+ * so the lexicons document these as freeform `YYYY-MM` / `YYYY-MM-DD`. Record
+ * metadata like `createdAt` stays on `datetimeSchema`.
+ */
+declare const partialDateSchema: 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 an `id.sifa.profile.skill` record by AT-URI. Mirrors
+ * `id.sifa.defs#skillRef`, which carries no CID at all: skills are mutable
+ * records in the same user's repo, so the reference resolves live and tracks
+ * edits to the target.
+ */
+declare const skillRefSchema: z.ZodObject<{
+    uri: 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 { datetimeSchema as $, type ArtifactLink as A, type BlobRef as B, ProfileLanguageRecordSchema as C, type ProfilePositionRecord as D, type EndorsementConfirmationRecord as E, ProfilePositionRecordSchema as F, type GraphFollowRecord as G, type ProfilePresentationDeliveryRecord as H, ProfilePresentationDeliveryRecordSchema as I, type ProfilePresentationRecord as J, ProfilePresentationRecordSchema as K, type ProfileProjectRecord as L, ProfileProjectRecordSchema as M, type ProfilePublicationRecord as N, type OrgEmploymentAttestationRecord as O, PROFILE_INVOLVEMENT_NSID as P, ProfilePublicationRecordSchema as Q, type ProfileSelfRecord as R, ProfileSelfRecordSchema as S, type ProfileSkillRecord as T, ProfileSkillRecordSchema as U, type ProfileVolunteeringRecord as V, ProfileVolunteeringRecordSchema as W, type PublicationAuthor as X, PublicationAuthorSchema as Y, atUriSchema as Z, cidSchema as _, ArtifactLinkSchema as a, didSchema as a0, externalRecordRefSchema as a1, languageTagSchema as a2, makeGraphFollowRecordSchema as a3, maxGraphemes as a4, partialDateSchema as a5, selfLabelsSchema as a6, skillRefSchema as a7, strongRefSchema as a8, uriSchema as a9, BlobRefSchema as b, EndorsementConfirmationRecordSchema as c, type EndorsementRecord as d, EndorsementRecordSchema as e, GraphFollowRecordSchema as f, OrgEmploymentAttestationRecordSchema as g, type OrgProfileRecord as h, OrgProfileRecordSchema as i, type PresentationDuration as j, PresentationDurationSchema as k, type PresentationLink as l, PresentationLinkSchema as m, type ProfileCertificationRecord as n, ProfileCertificationRecordSchema as o, type ProfileCourseRecord as p, ProfileCourseRecordSchema as q, type ProfileEducationRecord as r, ProfileEducationRecordSchema as s, type ProfileExternalAccountRecord as t, ProfileExternalAccountRecordSchema as u, type ProfileHonorRecord as v, ProfileHonorRecordSchema as w, type ProfileInvolvementRecord as x, ProfileInvolvementRecordSchema as y, type ProfileLanguageRecord as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singi-labs/sifa-sdk",
-  "version": "0.12.43",
+  "version": "0.12.45",
   "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
   "license": "MIT",
   "type": "module",