@singi-labs/sifa-sdk 0.19.85 → 0.19.86

package/dist/index.cjs

@@ -3621,6 +3621,7 @@ var ROLE_TOKENS = {
   workshop: "id.sifa.defs#workshop",
   host: "id.sifa.defs#host"
 };
+var PRESENTATION_ROLE_VALUES = Object.keys(ROLE_TOKENS);
 function normalizePresentationRole(value) {
   const v = clean2(value).toLowerCase();
   if (!v) return void 0;
@@ -3646,6 +3647,7 @@ var MODE_FRAGMENTS = {
   remote: "#virtual",
   hybrid: "#hybrid"
 };
+var PRESENTATION_MODE_VALUES = Object.keys(MODE_FRAGMENTS);
 function normalizePresentationMode(value) {
   const v = clean2(value).toLowerCase();
   if (!v) return void 0;
@@ -3694,6 +3696,297 @@ function presentationDeliveryCsvRowToRecord(row) {
   if (links.length) record.links = links;
   return { presentationKey: clean2(row.presentation_key) || void 0, record };
 }
+var writeLocationSchema = zod.z.union([
+  zod.z.object({
+    country: zod.z.string().nullish(),
+    countryCode: zod.z.string().length(2).nullish(),
+    region: zod.z.string().nullish(),
+    city: zod.z.string().nullish(),
+    locality: zod.z.string().nullish(),
+    street: zod.z.string().nullish(),
+    postalCode: zod.z.string().nullish(),
+    name: zod.z.string().nullish()
+  }),
+  zod.z.string()
+]).nullable().optional();
+zod.z.object({
+  uri: zod.z.string()
+});
+function httpUrlOrNull(input) {
+  if (typeof input !== "string") return null;
+  try {
+    const url = new URL(input);
+    return url.protocol === "http:" || url.protocol === "https:" ? input : null;
+  } catch {
+    return null;
+  }
+}
+var DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+function isValidDateOnly(input) {
+  if (typeof input !== "string" || !DATE_ONLY_RE.test(input)) return false;
+  const parsed3 = /* @__PURE__ */ new Date(`${input}T00:00:00Z`);
+  return !Number.isNaN(parsed3.getTime()) && parsed3.toISOString().startsWith(input);
+}
+var PARTIAL_DATE_RE = /^\d{4}(-(0[1-9]|1[0-2]))?$/;
+function isValidPartialDate(input) {
+  if (typeof input !== "string") return false;
+  return PARTIAL_DATE_RE.test(input) || isValidDateOnly(input);
+}
+zod.z.string().url().refine((s) => /^https?:\/\//i.test(s), { message: "entityRef must be an http(s) URL" }).max(2048).optional();
+zod.z.object({
+  url: zod.z.string().max(2048).refine((v) => httpUrlOrNull(v) !== null, "must be an http(s) URL"),
+  kind: zod.z.string().max(64).nullable().optional(),
+  label: zod.z.string().max(2e3).nullable().optional()
+});
+var externalRecordRefSchema = zod.z.object({
+  uri: zod.z.string().regex(/^at:\/\/[^/\s]+\/[^/\s]+\/[^/\s]+$/, "must be an at-uri"),
+  // CIDv0 (`Qm…`) or CIDv1 (base32, `b…`). Loose but rejects arbitrary strings.
+  cid: zod.z.string().max(256).regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z2-7]+)$/, "must be a CID").optional()
+});
+var presentationLinkSchema = zod.z.object({
+  uri: zod.z.string().max(2048).refine((v) => httpUrlOrNull(v) !== null, "must be an http(s) URL"),
+  label: zod.z.string().max(640).nullable().optional(),
+  type: zod.z.string().max(256).nullable().optional()
+});
+var PresentationDeliveryWriteSchema = zod.z.object({
+  presentationRef: externalRecordRefSchema.optional(),
+  /**
+   * The same session as recorded on another person's profile. Distinct from
+   * presentationRef above, which points at the talk this session delivered.
+   */
+  sameAs: externalRecordRefSchema.optional(),
+  title: zod.z.string().max(3e3).nullable().optional(),
+  role: zod.z.string().max(640).nullable().optional(),
+  eventName: zod.z.string().max(3e3).nullable().optional(),
+  // YYYY-MM-DD, or YYYY-MM / YYYY when the exact day is unknown.
+  date: zod.z.string().refine(isValidPartialDate, "must be a valid YYYY, YYYY-MM or YYYY-MM-DD date").nullable().optional(),
+  location: zod.z.string().max(2560).nullable().optional(),
+  // Structured community.lexicon.location.address; `location` above stays as
+  // the legacy free-text fallback. writeLocationSchema is already nullable+optional.
+  address: writeLocationSchema,
+  mode: zod.z.string().max(256).nullable().optional(),
+  status: zod.z.string().max(256).nullable().optional(),
+  links: zod.z.array(presentationLinkSchema).max(20).optional(),
+  eventRef: externalRecordRefSchema.optional(),
+  coSpeakers: zod.z.array(zod.z.string().regex(/^did:[a-z]+:[^\s]+$/, "must be a DID")).max(20).optional()
+});
+var BlobRefSchema = zod.z.object({
+  $type: zod.z.literal("blob"),
+  ref: zod.z.object({ $link: zod.z.string().min(1) }),
+  mimeType: zod.z.string().min(1).max(255),
+  size: zod.z.number().int().nonnegative()
+});
+
+// src/schemas/write/presentation.ts
+var PresentationWriteSchema = zod.z.object({
+  title: zod.z.string().min(1).max(3e3),
+  description: zod.z.string().max(5e4).nullable().optional(),
+  duration: zod.z.object({
+    minMinutes: zod.z.number().int().min(1),
+    maxMinutes: zod.z.number().int().min(1).optional()
+  }).refine((d) => d.maxMinutes === void 0 || d.maxMinutes >= d.minMinutes, {
+    message: "maxMinutes must be greater than or equal to minMinutes",
+    path: ["maxMinutes"]
+  }).optional(),
+  intendedAudiences: zod.z.array(zod.z.string().max(1e3)).max(20).optional(),
+  links: zod.z.array(presentationLinkSchema).max(20).optional(),
+  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"];
+var DELIVERY_URL_COLUMNS = ["event_url", "recording_url"];
+var RECORD_FIELD_COLUMNS = {
+  title: "title",
+  description: "description",
+  intendedAudiences: "intended_audiences",
+  eventName: "event_name",
+  location: "location"
+};
+function schemaErrorColumn(error) {
+  const field = error.issues[0]?.path[0];
+  return typeof field === "string" ? RECORD_FIELD_COLUMNS[field] : void 0;
+}
+function cell(row, column) {
+  return (row[column] ?? "").trim();
+}
+function urlIssues(row, rowNumber, file, columns) {
+  return columns.flatMap((column) => {
+    const value = cell(row, column);
+    return value && httpUrlOrNull(value) === null ? [{ file, row: rowNumber, column, value, code: "invalidUrl", severity: "error" }] : [];
+  });
+}
+function validateTalksImport(input, now = /* @__PURE__ */ new Date()) {
+  const issues = [];
+  const presentations = [];
+  const deliveries = [];
+  const validKeys = /* @__PURE__ */ new Set();
+  const skippedKeys = /* @__PURE__ */ new Set();
+  input.presentationRows.forEach((row, index) => {
+    const rowNumber = index + 2;
+    const rowIssues = [];
+    const parsed3 = presentationCsvRowToRecord(row);
+    if (!parsed3.record.title) {
+      rowIssues.push({
+        file: "presentations",
+        row: rowNumber,
+        column: "title",
+        code: "missingTitle",
+        severity: "error"
+      });
+    }
+    rowIssues.push(...urlIssues(row, rowNumber, "presentations", PRESENTATION_URL_COLUMNS));
+    const schema = rowIssues.length === 0 ? PresentationWriteSchema.safeParse(parsed3.record) : null;
+    if (schema && !schema.success) {
+      const column = schemaErrorColumn(schema.error);
+      rowIssues.push({
+        file: "presentations",
+        row: rowNumber,
+        ...column ? { column } : {},
+        code: "invalidRecord",
+        severity: "error"
+      });
+    }
+    issues.push(...rowIssues);
+    if (rowIssues.length > 0) {
+      if (parsed3.key) skippedKeys.add(parsed3.key);
+      return;
+    }
+    presentations.push(parsed3);
+    if (parsed3.key) validKeys.add(parsed3.key);
+  });
+  input.deliveryRows.forEach((row, index) => {
+    const rowNumber = index + 2;
+    const rowIssues = [];
+    const parsed3 = presentationDeliveryCsvRowToRecord(row);
+    const { record, presentationKey } = parsed3;
+    const linked = presentationKey !== void 0 && validKeys.has(presentationKey);
+    if (presentationKey !== void 0 && skippedKeys.has(presentationKey) && !linked) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        column: "presentation_key",
+        value: presentationKey,
+        code: "linkedTalkSkipped",
+        severity: "error"
+      });
+    } else if (presentationKey !== void 0 && !linked) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        column: "presentation_key",
+        value: presentationKey,
+        code: "unknownPresentationKey",
+        severity: "warning"
+      });
+    }
+    if (!record.title && !record.eventName && !linked && !skippedKeys.has(presentationKey ?? "")) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        code: "missingTitleOrEvent",
+        severity: "error"
+      });
+    }
+    if (record.date && !isValidPartialDate(record.date)) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        column: "date",
+        value: record.date,
+        code: "invalidDate",
+        severity: "error"
+      });
+    } else if (record.date && isBeyondLookahead(record.date, DATE_LOOKAHEAD_MONTHS.talk, now)) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        column: "date",
+        value: record.date,
+        code: "dateTooFarAhead",
+        severity: "error"
+      });
+    }
+    rowIssues.push(...urlIssues(row, rowNumber, "deliveries", DELIVERY_URL_COLUMNS));
+    const role = cell(row, "role");
+    if (role && !record.role) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        column: "role",
+        value: role,
+        code: "unknownRole",
+        severity: "warning"
+      });
+    }
+    const mode = cell(row, "mode");
+    if (mode && !record.mode) {
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        column: "mode",
+        value: mode,
+        code: "unknownMode",
+        severity: "warning"
+      });
+    }
+    let hasError = rowIssues.some((i) => i.severity === "error");
+    const schema = hasError ? null : PresentationDeliveryWriteSchema.safeParse(record);
+    if (schema && !schema.success) {
+      const column = schemaErrorColumn(schema.error);
+      rowIssues.push({
+        file: "deliveries",
+        row: rowNumber,
+        ...column ? { column } : {},
+        code: "invalidRecord",
+        severity: "error"
+      });
+      hasError = true;
+    }
+    issues.push(...rowIssues);
+    if (!hasError) deliveries.push(parsed3);
+  });
+  return { presentations, deliveries, issues };
+}
 
 // src/cards/app-url-patterns.ts
 var APP_URL_PATTERNS = Object.freeze({
@@ -4787,44 +5080,6 @@ var streamCardVMSchema = zod.z.lazy(
     certifiedDetails: certifiedDetailsSchema.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 skillRefSchema = zod.z.object({
-  uri: atUriSchema
-});
-var externalRecordRefSchema = 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/publishing/registry.ts
 var STANDARD_SITE_PUBLISHERS = Object.freeze([
@@ -6448,12 +6703,6 @@ function buildProfileHighlights(profile, { today }) {
 function shouldRenderHighlights(rows) {
   return rows.row1.length + rows.row2.length >= 2;
 }
-var BlobRefSchema = zod.z.object({
-  $type: zod.z.literal("blob"),
-  ref: zod.z.object({ $link: zod.z.string().min(1) }),
-  mimeType: zod.z.string().min(1).max(255),
-  size: zod.z.number().int().nonnegative()
-});
 var EndorsementConfirmationRecordSchema = zod.z.object({
   endorsement: strongRefSchema,
   /**
@@ -6631,7 +6880,7 @@ var VERIFICATION_METHOD_TOKENS = [
 var EmploymentVerificationRecordSchema = zod.z.object({
   $type: zod.z.literal("id.sifa.verification.employment").optional(),
   subject: didSchema,
-  position: externalRecordRefSchema,
+  position: externalRecordRefSchema2,
   status: zod.z.enum(EMPLOYMENT_STATUS_TOKENS),
   // Open on purpose, like the lexicon's knownValues: a method Sifa adds
   // later must not make an older client reject the whole record. Compare
@@ -6642,7 +6891,7 @@ var EmploymentVerificationRecordSchema = zod.z.object({
   endedAt: partialDateSchema.optional(),
   entityRef: uriSchema.optional(),
   organization: didSchema.optional(),
-  evidence: zod.z.array(externalRecordRefSchema).max(20).optional(),
+  evidence: zod.z.array(externalRecordRefSchema2).max(20).optional(),
   verifiedAt: datetimeSchema,
   expiresAt: datetimeSchema.optional(),
   createdAt: datetimeSchema
@@ -6865,7 +7114,7 @@ var ProfileProjectRecordSchema = zod.z.object({
    * its own record; this only says the two describe one thing. Resolves by
    * AT-URI, since they will keep editing their copy.
    */
-  sameAs: externalRecordRefSchema.optional(),
+  sameAs: externalRecordRefSchema2.optional(),
   position: strongRefSchema.optional(),
   startedAt: partialDateSchema.optional(),
   endedAt: partialDateSchema.optional(),
@@ -6900,7 +7149,7 @@ var ProfileInvolvementRecordSchema = zod.z.object({
   skills: zod.z.array(zod.z.object({ uri: zod.z.string() })).max(50).optional(),
   labels: selfLabelsSchema.optional(),
   collaborators: zod.z.array(projectMemberRefSchema).max(50).optional(),
-  sameAs: externalRecordRefSchema.optional(),
+  sameAs: externalRecordRefSchema2.optional(),
   isPrimary: zod.z.boolean().optional(),
   createdAt: datetimeSchema
 }).passthrough();
@@ -6932,7 +7181,7 @@ var ProfilePositionRecordSchema = zod.z.object({
   endedAt: partialDateSchema.optional(),
   // id.sifa.defs#skillRef -- at-uri only, no cid. Skills are mutable records
   // in the same repo, so the ref resolves live rather than pinning a version.
-  skills: zod.z.array(skillRefSchema).max(50).optional(),
+  skills: zod.z.array(skillRefSchema2).max(50).optional(),
   isPrimary: zod.z.boolean().optional(),
   labels: selfLabelsSchema.optional(),
   createdAt: datetimeSchema
@@ -6957,7 +7206,7 @@ var ProfilePresentationRecordSchema = zod.z.object({
   links: zod.z.array(PresentationLinkSchema).max(20).optional(),
   // Optional reference to a long-form write-up (pub.leaflet.document or
   // site.standard.document). Plain at-uri + optional cid so it tracks edits.
-  writeupRef: externalRecordRefSchema.optional(),
+  writeupRef: externalRecordRefSchema2.optional(),
   // Optional uploaded cover image for the talk page.
   coverImage: BlobRefSchema.optional(),
   isPrimary: zod.z.boolean().optional(),
@@ -6973,7 +7222,7 @@ var communityAddressSchema = zod.z.object({
 });
 var ProfilePresentationDeliveryRecordSchema = zod.z.object({
   // Optional reference to the id.sifa.profile.presentation delivered here.
-  presentationRef: externalRecordRefSchema.optional(),
+  presentationRef: externalRecordRefSchema2.optional(),
   // Fallback title used when there is no presentationRef.
   title: zod.z.string().refine(maxGraphemes(300)).max(3e3).optional(),
   role: zod.z.string().refine(maxGraphemes(64)).max(640).optional(),
@@ -6988,7 +7237,7 @@ var ProfilePresentationDeliveryRecordSchema = zod.z.object({
   status: zod.z.string().optional(),
   links: zod.z.array(PresentationLinkSchema).max(20).optional(),
   // Optional reference to a community.lexicon.calendar.event for this occasion.
-  eventRef: externalRecordRefSchema.optional(),
+  eventRef: externalRecordRefSchema2.optional(),
   // DIDs of co-speakers who presented alongside the author at this occasion.
   coSpeakers: zod.z.array(zod.z.string().regex(/^did:[a-z]+:[^\s]+$/, "must be a DID")).max(20).optional(),
   createdAt: datetimeSchema
@@ -7379,7 +7628,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.85";
+var SIFA_SDK_VERSION = "0.19.86";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;
@@ -7467,8 +7716,10 @@ exports.PLATFORM_LABELS = PLATFORM_LABELS;
 exports.PLATFORM_OPTIONS = PLATFORM_OPTIONS;
 exports.PRESENTATION_LINK_TYPE_LABELS = PRESENTATION_LINK_TYPE_LABELS;
 exports.PRESENTATION_LINK_TYPE_OPTIONS = PRESENTATION_LINK_TYPE_OPTIONS;
+exports.PRESENTATION_MODE_VALUES = PRESENTATION_MODE_VALUES;
 exports.PRESENTATION_ROLE_LABELS = PRESENTATION_ROLE_LABELS;
 exports.PRESENTATION_ROLE_OPTIONS = PRESENTATION_ROLE_OPTIONS;
+exports.PRESENTATION_ROLE_VALUES = PRESENTATION_ROLE_VALUES;
 exports.PROFILE_INVESTMENT_NSID = PROFILE_INVESTMENT_NSID;
 exports.PROFILE_INVOLVEMENT_NSID = PROFILE_INVOLVEMENT_NSID;
 exports.PROJECT_ROLES = PROJECT_ROLES;
@@ -7545,7 +7796,7 @@ exports.encodeFeedCursor = encodeFeedCursor;
 exports.entityDisambiguationLabel = entityDisambiguationLabel;
 exports.entityResultKey = entityResultKey;
 exports.excludeSelfApp = excludeSelfApp;
-exports.externalRecordRefSchema = externalRecordRefSchema;
+exports.externalRecordRefSchema = externalRecordRefSchema2;
 exports.filterHidden = filterHidden;
 exports.findIndustry = findIndustry;
 exports.followingFeedFallbackApp = followingFeedFallbackApp;
@@ -7692,7 +7943,7 @@ exports.shouldRenderHighlights = shouldRenderHighlights;
 exports.singleDateExtractor = singleDateExtractor;
 exports.siteActivityPresetSchema = siteActivityPresetSchema;
 exports.siteActivityPresetUpdateSchema = siteActivityPresetUpdateSchema;
-exports.skillRefSchema = skillRefSchema;
+exports.skillRefSchema = skillRefSchema2;
 exports.slugifyTitle = slugifyTitle;
 exports.sortByActiveDateRange = sortByActiveDateRange;
 exports.sortByDateDesc = sortByDateDesc;
@@ -7729,6 +7980,7 @@ exports.toStreamCardVM = toStreamCardVM;
 exports.toStreamCardVMs = toStreamCardVMs;
 exports.truncateGraphemes = truncateGraphemes;
 exports.uriSchema = uriSchema;
+exports.validateTalksImport = validateTalksImport;
 exports.verbForCollection = verbForCollection;
 exports.visibleItems = visibleItems;
 exports.youtubeThumbnailUrl = youtubeThumbnailUrl;