@opendatalabs/vana-sdk 4.4.0 → 4.5.0

package/dist/index.node.d.ts

@@ -53,6 +53,7 @@ export { TOMBSTONE_DATA_HASH, TOMBSTONE_METADATA_HASH, TOMBSTONE_DATA_HASH_PREIM
 export { personalServerDataReadPath, buildPersonalServerDataReadRequest, readPersonalServerData, type BuildPersonalServerDataReadRequestParams, type ReadPersonalServerDataParams, } from "./protocol/personal-server-data.js";
 export { ScopeSchema, parseScope, scopeToPathSegments, scopeMatchesPattern, scopeCoveredByGrant, type Scope, type ParsedScope, } from "./protocol/scopes.js";
 export { SCOPE_ACTIONS, InvalidScopeEntryError, parseScopeEntry, formatScopeEntry, grantPermissions, permissionsToScopes, tryGrantPermissions, hasAction, type ScopeAction, type ParsedScopeEntry, type GrantPermission, } from "./protocol/scope-actions.js";
+export { PDPP_SCOPE_NAMESPACE, PDPP_SOURCE_ID_PREFIX, InvalidPdppGrantError, pdppScopeKey, parsePdppScopeKey, isPdppScopeKey, pdppGrantsToScopes, grantRequestScopes, type PdppGrant, type PdppScopeKeyParts, } from "./protocol/pdpp-scopes.js";
 export { WRITE_SESSION_PATH, WRITE_SIGNATURE_HEADER, WRITE_METADATA_HEADER, WRITE_FILENAME_HEADER, WRITE_CONTENT_DISPOSITION_HEADER, WRITER_ATTRIBUTION_KEY, LINEAGE_KEY, LINEAGE_FIELD, MAX_LINEAGE_SOURCES, RESERVED_WRITE_KEYS, openWriteSession, writeData, writePersonalServerData, sessionCoversScope, binaryWriteSignedBytes, normalizeBinaryMimeType, parseWriteMetadataHeader, encodeWriteMetadataHeader, type WriteTransportRetryOptions, type WriteSession, type OpenWriteSessionParams, type WriteBinaryPayload, type LineageSource, type WriteJsonDataParams, type WriteBinaryDataParams, type WriteDataParams, type WriteDataResult, type WritePersonalServerDataParams, type WritePersonalServerDataResult, type BinaryWriteSignedBytesInput, } from "./protocol/personal-server-write.js";
 export { resolveWriteSigner, type WriteSigner, type WriteSignerSource, type ViemWriteAccount, type ViemWriteWalletClient, type ResolveWriteSignerOptions, } from "./protocol/write-signer.js";
 export { DERIVATIVE_QUESTIONS_PATH, MAX_QUESTION_SOURCE_SCOPES, MAX_QUESTION_CHARS, MAX_QUESTION_MODEL_CHARS, DEFAULT_QUESTION_TIMEOUT_MS, DEFAULT_QUESTION_POLL_INTERVAL_MS, QUESTION_STATUSES, DERIVATIVE_ERROR_CODES, DerivativeErrorCodeSchema, type DerivativeErrorCode, registerQuestion, getQuestion, listQuestions, recomputeQuestion, deleteQuestion, waitForQuestion, askPersonalServer, QuestionStatusSchema, QuestionRegisteredBySchema, DerivativeQuestionSchema, QuestionRecomputeResultSchema, QuestionDeleteResultSchema, type QuestionStatus, type QuestionRegisteredBy, type DerivativeQuestion, type QuestionRecomputeResult, type QuestionDeleteResult, type DerivativeQuestionAuthParams, type RegisterQuestionParams, type GetQuestionParams, type ListQuestionsParams, type RecomputeQuestionParams, type DeleteQuestionParams, type WaitForQuestionParams, type AskPersonalServerParams, type AskPersonalServerResult, } from "./protocol/derivative-questions.js";

package/dist/index.node.js

@@ -35551,6 +35551,102 @@ async function readPersonalServerData(params) {
 
 // src/protocol/scopes.ts
 import { z as z3 } from "zod";
+
+// src/protocol/pdpp-scopes.ts
+var PDPP_SCOPE_NAMESPACE = "pdpp";
+var PDPP_SOURCE_ID_PREFIX = "https://registry.pdpp.dev/sources/";
+var SEGMENT = "[a-z0-9][a-z0-9_]*";
+var SOURCE_ID_RE = new RegExp(
+  `^${PDPP_SOURCE_ID_PREFIX.replace(/[.]/g, "\\.")}(${SEGMENT})$`
+);
+var STREAM_RE = new RegExp(`^${SEGMENT}$`);
+var KEY_RE = new RegExp(
+  `^${PDPP_SCOPE_NAMESPACE}\\.(${SEGMENT})\\.(${SEGMENT})$`
+);
+var InvalidPdppGrantError = class extends Error {
+  /** Which part was rejected. */
+  field;
+  /** The rejected value, verbatim. */
+  value;
+  constructor(field, value, reason) {
+    super(
+      `Invalid PDPP ${field}${typeof value === "string" ? ` ${JSON.stringify(value)}` : ""}: ${reason}`
+    );
+    this.name = "InvalidPdppGrantError";
+    this.field = field;
+    this.value = value;
+  }
+};
+function sourceSegment(sourceId) {
+  const raw = sourceId;
+  const match = typeof raw === "string" ? SOURCE_ID_RE.exec(raw) : null;
+  if (!match) {
+    throw new InvalidPdppGrantError(
+      "source_id",
+      raw,
+      `must be ${PDPP_SOURCE_ID_PREFIX}<source> where <source> is lowercase letters, digits and underscores, not starting with an underscore`
+    );
+  }
+  return match[1];
+}
+function assertStream(stream) {
+  const raw = stream;
+  if (typeof raw !== "string" || !STREAM_RE.test(raw)) {
+    throw new InvalidPdppGrantError(
+      "stream",
+      raw,
+      "must be lowercase letters, digits and underscores, not starting with an underscore"
+    );
+  }
+}
+function pdppScopeKey(source_id, stream) {
+  const source = sourceSegment(source_id);
+  assertStream(stream);
+  return `${PDPP_SCOPE_NAMESPACE}.${source}.${stream}`;
+}
+function parsePdppScopeKey(key) {
+  const raw = key;
+  const match = typeof raw === "string" ? KEY_RE.exec(raw) : null;
+  if (!match) return null;
+  return { source_id: `${PDPP_SOURCE_ID_PREFIX}${match[1]}`, stream: match[2] };
+}
+function isPdppScopeKey(key) {
+  return parsePdppScopeKey(key) !== null;
+}
+function pdppGrantsToScopes(grants) {
+  const raw = grants;
+  if (!Array.isArray(raw)) {
+    throw new InvalidPdppGrantError("grants", raw, "must be an array");
+  }
+  const keys = /* @__PURE__ */ new Set();
+  for (const grant of raw) {
+    if (grant === null || typeof grant !== "object") {
+      throw new InvalidPdppGrantError("grant", grant, "must be an object");
+    }
+    const { source_id: sourceId, streams } = grant;
+    if (!Array.isArray(streams) || streams.length === 0) {
+      throw new InvalidPdppGrantError(
+        "streams",
+        streams,
+        `must name at least one stream${typeof sourceId === "string" ? ` for ${sourceId}` : ""}`
+      );
+    }
+    for (const stream of streams) {
+      keys.add(pdppScopeKey(sourceId, stream));
+    }
+  }
+  return [...keys];
+}
+function grantRequestScopes(input) {
+  const legacy = [...input.scopes ?? []];
+  const present = new Set(legacy);
+  const derived = pdppGrantsToScopes(input.grants ?? []).filter(
+    (key) => !present.has(key)
+  );
+  return [...legacy, ...derived];
+}
+
+// src/protocol/scopes.ts
 var SOURCE_RE = /^[a-z0-9][a-z0-9_]*$/;
 var TAIL_SEGMENT_RE = /^[a-zA-Z0-9][a-zA-Z0-9_]*$/;
 var ScopeSchema = z3.string().refine(
@@ -38060,6 +38156,7 @@ export {
   GoogleDriveStorage,
   InMemoryTokenStore,
   IngestResponseSchema,
+  InvalidPdppGrantError,
   InvalidScopeEntryError,
   InvalidSignatureError2 as InvalidSignatureError,
   IpfsStorage,
@@ -38091,6 +38188,8 @@ export {
   NodeECIESUint8Provider as NodeECIESProvider,
   NodePlatformAdapter,
   OAuthClient,
+  PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX,
   PERSONAL_SERVER_LITE_OWNER_BINDING_PREFIX,
   PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE,
   PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION,
@@ -38216,6 +38315,7 @@ export {
   getServiceEndpoints,
   grantPermissions,
   grantRegistrationDomain,
+  grantRequestScopes,
   grantRevocationDomain,
   hasAction,
   isDataPointId,
@@ -38223,6 +38323,7 @@ export {
   isDataPortabilityGatewayConfig,
   isDerivativeStatusSettled,
   isECIESEncrypted,
+  isPdppScopeKey,
   isPlatformSupported,
   isRedactedLineageNode,
   isTombstoneHashes,
@@ -38240,6 +38341,7 @@ export {
   openJobResultStream,
   openWriteSession,
   parsePSError,
+  parsePdppScopeKey,
   parsePersonalServerPaymentRequired,
   parseScope,
   parseScopeEntry,
@@ -38247,6 +38349,8 @@ export {
   parseWriteMetadataHeader,
   paymentReceiptFromHeader,
   paymentResponseMetadataFromHeader,
+  pdppGrantsToScopes,
+  pdppScopeKey,
   permissionsToScopes,
   personalServerDataReadPath,
   personalServerLineagePath,