@opendatalabs/vana-sdk 4.4.0 → 4.5.0

package/dist/index.node.cjs

@@ -1217,6 +1217,7 @@ __export(index_node_exports, {
   GoogleDriveStorage: () => GoogleDriveStorage,
   InMemoryTokenStore: () => InMemoryTokenStore,
   IngestResponseSchema: () => IngestResponseSchema,
+  InvalidPdppGrantError: () => InvalidPdppGrantError,
   InvalidScopeEntryError: () => InvalidScopeEntryError,
   InvalidSignatureError: () => import_errors16.InvalidSignatureError,
   IpfsStorage: () => IpfsStorage,
@@ -1248,6 +1249,8 @@ __export(index_node_exports, {
   NodeECIESProvider: () => NodeECIESUint8Provider,
   NodePlatformAdapter: () => NodePlatformAdapter,
   OAuthClient: () => OAuthClient,
+  PDPP_SCOPE_NAMESPACE: () => PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX: () => PDPP_SOURCE_ID_PREFIX,
   PERSONAL_SERVER_LITE_OWNER_BINDING_PREFIX: () => PERSONAL_SERVER_LITE_OWNER_BINDING_PREFIX,
   PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE: () => PERSONAL_SERVER_LITE_OWNER_BINDING_PURPOSE,
   PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION: () => PERSONAL_SERVER_LITE_OWNER_BINDING_VERSION,
@@ -1373,6 +1376,7 @@ __export(index_node_exports, {
   getServiceEndpoints: () => getServiceEndpoints,
   grantPermissions: () => grantPermissions,
   grantRegistrationDomain: () => grantRegistrationDomain,
+  grantRequestScopes: () => grantRequestScopes,
   grantRevocationDomain: () => grantRevocationDomain,
   hasAction: () => hasAction,
   isDataPointId: () => isDataPointId,
@@ -1380,6 +1384,7 @@ __export(index_node_exports, {
   isDataPortabilityGatewayConfig: () => isDataPortabilityGatewayConfig,
   isDerivativeStatusSettled: () => isDerivativeStatusSettled,
   isECIESEncrypted: () => isECIESEncrypted,
+  isPdppScopeKey: () => isPdppScopeKey,
   isPlatformSupported: () => isPlatformSupported,
   isRedactedLineageNode: () => isRedactedLineageNode,
   isTombstoneHashes: () => isTombstoneHashes,
@@ -1397,6 +1402,7 @@ __export(index_node_exports, {
   openJobResultStream: () => openJobResultStream,
   openWriteSession: () => openWriteSession,
   parsePSError: () => parsePSError,
+  parsePdppScopeKey: () => parsePdppScopeKey,
   parsePersonalServerPaymentRequired: () => parsePersonalServerPaymentRequired,
   parseScope: () => parseScope,
   parseScopeEntry: () => parseScopeEntry,
@@ -1404,6 +1410,8 @@ __export(index_node_exports, {
   parseWriteMetadataHeader: () => parseWriteMetadataHeader,
   paymentReceiptFromHeader: () => paymentReceiptFromHeader,
   paymentResponseMetadataFromHeader: () => paymentResponseMetadataFromHeader,
+  pdppGrantsToScopes: () => pdppGrantsToScopes,
+  pdppScopeKey: () => pdppScopeKey,
   permissionsToScopes: () => permissionsToScopes,
   personalServerDataReadPath: () => personalServerDataReadPath,
   personalServerLineagePath: () => personalServerLineagePath,
@@ -35787,6 +35795,102 @@ async function readPersonalServerData(params) {
 
 // src/protocol/scopes.ts
 var import_zod3 = require("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 = import_zod3.z.string().refine(
@@ -38261,6 +38365,7 @@ async function parsePSError(response) {
   GoogleDriveStorage,
   InMemoryTokenStore,
   IngestResponseSchema,
+  InvalidPdppGrantError,
   InvalidScopeEntryError,
   InvalidSignatureError,
   IpfsStorage,
@@ -38292,6 +38397,8 @@ async function parsePSError(response) {
   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,
@@ -38417,6 +38524,7 @@ async function parsePSError(response) {
   getServiceEndpoints,
   grantPermissions,
   grantRegistrationDomain,
+  grantRequestScopes,
   grantRevocationDomain,
   hasAction,
   isDataPointId,
@@ -38424,6 +38532,7 @@ async function parsePSError(response) {
   isDataPortabilityGatewayConfig,
   isDerivativeStatusSettled,
   isECIESEncrypted,
+  isPdppScopeKey,
   isPlatformSupported,
   isRedactedLineageNode,
   isTombstoneHashes,
@@ -38441,6 +38550,7 @@ async function parsePSError(response) {
   openJobResultStream,
   openWriteSession,
   parsePSError,
+  parsePdppScopeKey,
   parsePersonalServerPaymentRequired,
   parseScope,
   parseScopeEntry,
@@ -38448,6 +38558,8 @@ async function parsePSError(response) {
   parseWriteMetadataHeader,
   paymentReceiptFromHeader,
   paymentResponseMetadataFromHeader,
+  pdppGrantsToScopes,
+  pdppScopeKey,
   permissionsToScopes,
   personalServerDataReadPath,
   personalServerLineagePath,