@singi-labs/sifa-sdk 0.12.69 → 0.12.71

package/dist/query/fetchers/index.d.cts

@@ -9,15 +9,13 @@ import '../../org-settings-CZ_tmAYl.cjs';
 import '../../profile-summary-BTZAwG1z.cjs';
 
 /**
- * Create a new `id.sifa.profile.investment` record on the authenticated user's PDS.
- * The AppView signs and writes via the user's OAuth session.
+ * Typed wrappers over the generic record routes for
+ * `id.sifa.profile.investment`. sifa-api serves every collection without a
+ * bespoke handler through `POST|PUT|DELETE /api/profile/records/<collection>`,
+ * so these exist for call-site readability, not for a different endpoint.
  *
- * `data` should be a lexicon-shaped investment record (without `createdAt` or
- * `rkey`; the AppView fills both). Validate with `InvestmentWriteSchema` first if
- * you want client-side guarantees.
- *
- * Never throws -- inspect `result.success` and use `result.error` / `result.pdsHost`
- * for UI messaging.
+ * Never throw -- inspect `result.success` and use `result.error` /
+ * `result.pdsHost` for UI messaging.
  */
 declare function createInvestment(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
 /** Update an existing investment by `rkey`. */

package/dist/query/fetchers/index.d.ts

@@ -9,15 +9,13 @@ import '../../org-settings-CZ_tmAYl.js';
 import '../../profile-summary-Do5FY7Q0.js';
 
 /**
- * Create a new `id.sifa.profile.investment` record on the authenticated user's PDS.
- * The AppView signs and writes via the user's OAuth session.
+ * Typed wrappers over the generic record routes for
+ * `id.sifa.profile.investment`. sifa-api serves every collection without a
+ * bespoke handler through `POST|PUT|DELETE /api/profile/records/<collection>`,
+ * so these exist for call-site readability, not for a different endpoint.
  *
- * `data` should be a lexicon-shaped investment record (without `createdAt` or
- * `rkey`; the AppView fills both). Validate with `InvestmentWriteSchema` first if
- * you want client-side guarantees.
- *
- * Never throws -- inspect `result.success` and use `result.error` / `result.pdsHost`
- * for UI messaging.
+ * Never throw -- inspect `result.success` and use `result.error` /
+ * `result.pdsHost` for UI messaging.
  */
 declare function createInvestment(config: SifaApiConfig, data: Record<string, unknown>, options?: ApiFetchOptions): Promise<CreateResult>;
 /** Update an existing investment by `rkey`. */

package/dist/query/fetchers/index.js

@@ -1546,19 +1546,140 @@ var sifaQueryKeys = {
     wipePreview: () => ["sifa", "destructive", "wipe-preview"]
   }
 };
+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 = z.string().regex(/^did:[a-z]+:[a-zA-Z0-9._:%-]+$/, "Invalid DID");
+var datetimeSchema = z.string().datetime({ offset: true });
+var partialDateSchema = z.string().regex(/^\d{4}(-\d{2}(-\d{2}(T.+)?)?)?$/, "Expected YYYY, YYYY-MM, YYYY-MM-DD, or a datetime");
+var atUriSchema = z.string().regex(/^at:\/\/[^\s]+$/, "Invalid AT-URI");
+var cidSchema = z.string().regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z0-9+/=]+)$/, "Invalid CID");
+z.string().regex(/^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$/, "Invalid BCP 47 language tag");
+var uriSchema = z.string().url();
+var strongRefSchema = z.object({
+  uri: atUriSchema,
+  cid: cidSchema
+});
+z.object({
+  uri: atUriSchema
+});
+var externalRecordRefSchema = z.object({
+  uri: atUriSchema,
+  cid: cidSchema.optional()
+});
+var selfLabelsSchema = z.object({
+  $type: z.literal("com.atproto.label.defs#selfLabels").optional(),
+  values: z.array(z.object({ val: z.string() }))
+});
+var projectMemberRefSchema = z.object({
+  did: didSchema,
+  role: z.string().optional(),
+  title: z.string().refine(maxGraphemes(128)).max(1280).optional()
+});
+z.object({
+  name: z.string().min(1).refine(maxGraphemes(256)).max(2560),
+  description: z.string().refine(maxGraphemes(5e3)).max(5e4).optional(),
+  url: uriSchema.optional(),
+  members: z.array(projectMemberRefSchema).max(50).optional(),
+  /**
+   * The canonical `id.sifa.project.self` this personal entry corresponds to.
+   * A composition link. For the same project recorded on someone else's
+   * profile, see `sameAs`.
+   */
+  projectRef: strongRefSchema.optional(),
+  /**
+   * The same project as recorded on another person's profile. Each side stays
+   * 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(),
+  position: strongRefSchema.optional(),
+  startedAt: partialDateSchema.optional(),
+  endedAt: partialDateSchema.optional(),
+  labels: selfLabelsSchema.optional(),
+  createdAt: datetimeSchema
+});
+
+// src/schemas/profile-involvement.ts
+var ArtifactLinkSchema = z.object({
+  url: uriSchema,
+  kind: z.string().optional(),
+  label: z.string().refine(maxGraphemes(200)).max(2e3).optional()
+}).passthrough();
+z.object({
+  kind: z.string(),
+  upstream: z.string().refine(maxGraphemes(256)).max(2560).optional(),
+  upstreamDid: didSchema.optional(),
+  upstreamUrl: uriSchema.optional(),
+  role: z.string().refine(maxGraphemes(256)).max(2560).optional(),
+  description: z.string().refine(maxGraphemes(5e3)).max(5e4).optional(),
+  startedAt: partialDateSchema.optional(),
+  endedAt: partialDateSchema.optional(),
+  links: z.array(ArtifactLinkSchema).max(50).optional(),
+  // Portable org entity identifier (Wikidata/ROR/LEI URI) from the resolver
+  // typeahead, constrained to http(s) so a script scheme is never a valid ref.
+  entityRef: z.string().url().refine((s) => /^https?:\/\//i.test(s), { message: "entityRef must be an http(s) URL" }).max(2048).optional(),
+  // community.lexicon.location.address — validated at the app layer.
+  location: z.unknown().optional(),
+  // id.sifa.defs#skillRef references (at-uri to a skill record in the same repo).
+  skills: z.array(z.object({ uri: z.string() })).max(50).optional(),
+  labels: selfLabelsSchema.optional(),
+  collaborators: z.array(projectMemberRefSchema).max(50).optional(),
+  sameAs: externalRecordRefSchema.optional(),
+  createdAt: datetimeSchema
+}).passthrough();
+
+// src/schemas/profile-investment.ts
+var entityRefField = z.string().url().refine((s) => /^https?:\/\//i.test(s), { message: "entityRef must be an http(s) URL" }).max(2048).optional();
+var InvestmentAmountSchema = z.object({
+  /** Whole major currency units (euros, not cents). Cheque sizes are round numbers. */
+  value: z.number().int().min(0),
+  /** ISO 4217 three-letter code, uppercase. */
+  currency: z.string().length(3)
+});
+var PROFILE_INVESTMENT_NSID = "id.sifa.profile.investment";
+z.object({
+  /** For a limited-partner entry this names the fund, not a portfolio company. */
+  company: z.string().min(1).refine(maxGraphemes(256)).max(2560),
+  companyDid: didSchema.optional(),
+  entityRef: entityRefField,
+  role: z.string().optional(),
+  stage: z.string().optional(),
+  status: z.string().optional(),
+  /** The vehicle the capital went through. Absent for a cheque in the person's own name. */
+  via: z.string().refine(maxGraphemes(256)).max(2560).optional(),
+  viaDid: didSchema.optional(),
+  viaEntityRef: entityRefField,
+  /**
+   * Optional and empty by default. Cheque size is a personal financial disclosure,
+   * and clients must not prompt for it.
+   */
+  amount: InvestmentAmountSchema.optional(),
+  startedAt: partialDateSchema.optional(),
+  endedAt: partialDateSchema.optional(),
+  description: z.string().refine(maxGraphemes(5e3)).max(5e4).optional(),
+  links: z.array(ArtifactLinkSchema).max(50).optional(),
+  labels: selfLabelsSchema.optional(),
+  createdAt: datetimeSchema
+}).passthrough();
 
 // src/query/fetchers/investments.ts
 function createInvestment(config, data, options = {}) {
-  return apiWriteCreate(config, "/api/profile/investment", data, options);
+  return createRecord(config, PROFILE_INVESTMENT_NSID, data, options);
 }
 function updateInvestment(config, rkey, data, options = {}) {
-  return apiWrite(config, `/api/profile/investment/${encodeURIComponent(rkey)}`, "PUT", {
-    body: data,
-    ...options
-  });
+  return updateRecord(config, PROFILE_INVESTMENT_NSID, rkey, data, options);
 }
 function deleteInvestment(config, rkey, options = {}) {
-  return apiWrite(config, `/api/profile/investment/${encodeURIComponent(rkey)}`, "DELETE", options);
+  return deleteRecord(config, PROFILE_INVESTMENT_NSID, rkey, options);
 }
 
 export { ApiError, HIDDEN_ITEM_SOURCES, HIDDEN_ITEM_TYPES, QUOTED_POSTS_BATCH_MAX, addFeatureAllowlist, addOrgNotificationEmail, apiFetch, apiFetchOrNull, apiWrite, apiWriteCreate, bulkHideProfileItems, bulkHideStandardPublications, bulkUnhideProfileItems, bulkUnhideStandardPublications, castRoadmapVote, checkAppAccount, checkNetworkMapJobStatus, confirmEndorsement, createConfirmation, createEducation, createEndorsement, createExternalAccount, createInvestment, createPosition, createProfileLocation, createReaction, createRecord, createSkill, deleteAccount, deleteAvatarOverride, deleteEducation, deleteExternalAccount, deleteInvestment, deletePosition, deleteProfileLocation, deleteReaction, deleteRecord, deleteRepoRecords, deleteSkill, dismissConfirmation, dismissEndorsement, fetchActivityFeed, fetchActivityTeaser, fetchAppsRegistry, fetchAtFundLink, fetchEndorsementCount, fetchEntitySearch, fetchExternalAccounts, fetchFeaturedProfile, fetchFollowing, fetchGetProfileView, fetchGivenConfirmations, fetchHeatmapData, fetchHiddenApps, fetchMyGithubPullRequests, fetchMyRoadmapVotes, fetchNetworkMap, fetchNetworkStreamCount, fetchPendingConfirmations, fetchPendingEndorsements, fetchProfile, fetchProfileSummary, fetchReactionStatus, fetchRepoInventory, fetchRoadmapVotes, fetchSearchFilters, fetchSearchProfiles, fetchSimilarProfiles, fetchSkillSuggestions, fetchStats, fetchSuggestionCount, fetchSuggestions, fetchWipePreview, followUser, getAdminReviewQueues, getBlueskySuggestions, getFollowers, getFollowing, getFollowingFeed, getMutuals, hideKeytraceClaim, hideOrcidPublication, hideProfileItem, hideSifaPublication, hideStandardPublication, importSearchEntities, initiateNetworkMapGeneration, isNetworkMapResponse, linkSkillToPosition, listFeatureAllowlist, refreshOrcidPublications, refreshPds, removeFeatureAllowlist, removeOrgNotificationEmail, repoExportUrl, requestOrgDomainChallenge, resetProfile, resolveQuotedPosts, retractRoadmapVote, revealMarqueDomain, revokeConfirmation, searchSkills, selectEntity, setExternalAccountPrimary, setPositionPrimary, sifaQueryKeys, submitOrgClaim, unfollowUser, unhideKeytraceClaim, unhideOrcidPublication, unhideProfileItem, unhideSifaPublication, unhideStandardPublication, unlinkSkillFromPosition, unrevealMarqueDomain, unsetExternalAccountPrimary, unsetPositionPrimary, updateEducation, updateExternalAccount, updateInvestment, updateOrgProfile, updatePosition, updateProfileLocation, updateProfileOverride, updateProfileSelf, updateRecord, updateSkill, uploadAvatar, verifyExternalAccount, verifyOrgDomain };