@opendatalabs/vana-sdk 4.4.0 → 4.5.0

package/dist/index.browser.js

@@ -33704,6 +33704,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(
@@ -36004,6 +36100,7 @@ export {
   GoogleDriveStorage,
   InMemoryTokenStore,
   IngestResponseSchema,
+  InvalidPdppGrantError,
   InvalidScopeEntryError,
   InvalidSignatureError2 as InvalidSignatureError,
   IpfsStorage,
@@ -36033,6 +36130,8 @@ export {
   NATIVE_ASSET_ADDRESS,
   NATIVE_VANA_ASSET,
   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,
@@ -36149,6 +36248,7 @@ export {
   getServiceEndpoints,
   grantPermissions,
   grantRegistrationDomain,
+  grantRequestScopes,
   grantRevocationDomain,
   hasAction,
   isDataPointId,
@@ -36156,6 +36256,7 @@ export {
   isDataPortabilityGatewayConfig,
   isDerivativeStatusSettled,
   isECIESEncrypted,
+  isPdppScopeKey,
   isPlatformSupported,
   isRedactedLineageNode,
   isTombstoneHashes,
@@ -36173,10 +36274,13 @@ export {
   openJobResultStream,
   openWriteSession,
   parsePSError,
+  parsePdppScopeKey,
   parseScope,
   parseScopeEntry,
   parseWeb3SignedHeader,
   parseWriteMetadataHeader,
+  pdppGrantsToScopes,
+  pdppScopeKey,
   permissionsToScopes,
   personalServerDataReadPath,
   personalServerLineagePath,