@opendatalabs/vana-sdk 4.4.0 → 4.5.0

package/dist/protocol/fixtures/pdpp-scope-keys.json

@@ -0,0 +1,133 @@
+{
+  "description": "Conformance vectors for the PDPP scope key: pdppScopeKey(source_id, stream) = pdpp.<source>.<stream>. source_id must match ^https://registry\\.pdpp\\.dev/sources/([a-z0-9][a-z0-9_]*)$ and stream ^[a-z0-9][a-z0-9_]*$, matched against the whole string (no trailing newline, no trimming). Owned by vana-sdk src/protocol/pdpp-scopes.ts; copy this file verbatim to test another implementation.",
+  "version": 1,
+  "keys": [
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt",
+      "stream": "conversations",
+      "key": "pdpp.chatgpt.conversations"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt",
+      "stream": "messages",
+      "key": "pdpp.chatgpt.messages"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/claude",
+      "stream": "project_documents",
+      "key": "pdpp.claude.project_documents"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/icloud_notes",
+      "stream": "notes",
+      "key": "pdpp.icloud_notes.notes"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/oura",
+      "stream": "sleep",
+      "key": "pdpp.oura.sleep"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/x2",
+      "stream": "v1_items",
+      "key": "pdpp.x2.v1_items"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/0",
+      "stream": "9",
+      "key": "pdpp.0.9"
+    }
+  ],
+  "rejectedSourceIds": [
+    { "source_id": "", "why": "empty" },
+    { "source_id": "chatgpt", "why": "bare source key, not a registry URI" },
+    {
+      "source_id": "http://registry.pdpp.dev/sources/chatgpt",
+      "why": "not https"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/connectors/chatgpt",
+      "why": "connector URI, not a source URI"
+    },
+    {
+      "source_id": "https://REGISTRY.pdpp.dev/sources/chatgpt",
+      "why": "host is matched exactly"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev.example/sources/chatgpt",
+      "why": "other host"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/",
+      "why": "empty source segment"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/ChatGPT",
+      "why": "uppercase"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/spotify-browser",
+      "why": "hyphen (not slugified)"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chat.gpt",
+      "why": "dot would split the scope key"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/_chatgpt",
+      "why": "leading underscore fails ScopeSchema"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt/",
+      "why": "trailing slash"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt/v2",
+      "why": "extra path segment"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt?v=1",
+      "why": "query"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt#x",
+      "why": "fragment"
+    },
+    {
+      "source_id": " https://registry.pdpp.dev/sources/chatgpt",
+      "why": "leading space (no trimming)"
+    },
+    {
+      "source_id": "https://registry.pdpp.dev/sources/chatgpt\n",
+      "why": "trailing newline ($ must not match before it)"
+    }
+  ],
+  "rejectedStreams": [
+    { "stream": "", "why": "empty" },
+    { "stream": "Conversations", "why": "uppercase" },
+    { "stream": "savedTracks", "why": "camelCase" },
+    { "stream": "conversation-items", "why": "hyphen (not slugified)" },
+    { "stream": "conversations.shared", "why": "dot would add a segment" },
+    { "stream": "*", "why": "wildcard is not a stream" },
+    { "stream": "_private", "why": "leading underscore fails ScopeSchema" },
+    { "stream": "write:messages", "why": "operation prefix" },
+    { "stream": "messages ", "why": "trailing space (no trimming)" },
+    { "stream": "messages\n", "why": "trailing newline" }
+  ],
+  "notPdppKeys": [
+    "chatgpt.conversations",
+    "pdpp.chatgpt",
+    "pdpp.chatgpt.*",
+    "pdpp.*",
+    "write:pdpp.chatgpt.conversations",
+    "PDPP.chatgpt.conversations",
+    "pdpp.ChatGPT.conversations",
+    "pdpp.chatgpt.Conversations",
+    "pdpp.chatgpt.conversations.shared",
+    "pdpp.spotify-browser.top_tracks",
+    "pdpp._chatgpt.conversations",
+    "pdpp..conversations",
+    "pdpp.chatgpt.conversations\n",
+    ""
+  ]
+}

package/dist/protocol/pdpp-scopes.cjs

@@ -0,0 +1,134 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pdpp_scopes_exports = {};
+__export(pdpp_scopes_exports, {
+  InvalidPdppGrantError: () => InvalidPdppGrantError,
+  PDPP_SCOPE_NAMESPACE: () => PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX: () => PDPP_SOURCE_ID_PREFIX,
+  grantRequestScopes: () => grantRequestScopes,
+  isPdppScopeKey: () => isPdppScopeKey,
+  parsePdppScopeKey: () => parsePdppScopeKey,
+  pdppGrantsToScopes: () => pdppGrantsToScopes,
+  pdppScopeKey: () => pdppScopeKey
+});
+module.exports = __toCommonJS(pdpp_scopes_exports);
+const PDPP_SCOPE_NAMESPACE = "pdpp";
+const PDPP_SOURCE_ID_PREFIX = "https://registry.pdpp.dev/sources/";
+const SEGMENT = "[a-z0-9][a-z0-9_]*";
+const SOURCE_ID_RE = new RegExp(
+  `^${PDPP_SOURCE_ID_PREFIX.replace(/[.]/g, "\\.")}(${SEGMENT})$`
+);
+const STREAM_RE = new RegExp(`^${SEGMENT}$`);
+const KEY_RE = new RegExp(
+  `^${PDPP_SCOPE_NAMESPACE}\\.(${SEGMENT})\\.(${SEGMENT})$`
+);
+class InvalidPdppGrantError 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];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InvalidPdppGrantError,
+  PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX,
+  grantRequestScopes,
+  isPdppScopeKey,
+  parsePdppScopeKey,
+  pdppGrantsToScopes,
+  pdppScopeKey
+});
+//# sourceMappingURL=pdpp-scopes.cjs.map

package/dist/protocol/pdpp-scopes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/pdpp-scopes.ts"],"sourcesContent":["/**\n * PDPP grant requests and the one scope key they map to.\n *\n * @remarks\n * A builder asks for PDPP data as grants: a registry `source_id` and the\n * streams it wants from that source,\n * `{ source_id: \"https://registry.pdpp.dev/sources/chatgpt\", streams: [\"messages\"] }`.\n * Everything downstream (the access request, the signed grant, the gateway,\n * the Personal Server) carries flat scope strings, and a raw URI cannot be\n * one: its `:` collides with the `write:` operation prefix, and `/` and `#`\n * break Personal Server routes and storage paths. So each (source, stream)\n * pair maps to exactly one scope key, `pdpp.<source>.<stream>`, where\n * `<source>` is the last path segment of the `source_id`.\n *\n * The key is an ordinary scope: it passes `ScopeSchema` and the\n * `[operation:]scope` grant-entry grammar unchanged (`write:pdpp.chatgpt.messages`\n * is a write entry), and `pdpp.<source>.*` covers every stream of one source\n * through the usual prefix wildcard. The `pdpp.` namespace keeps these keys\n * apart from legacy `{platform}.{scope}` strings: PDPP's ChatGPT\n * `conversations` stream is not the legacy `chatgpt.conversations` scope, and\n * the gateway keys data by the scope string.\n *\n * The mapping is strict and never slugifies. A `source_id` or stream outside\n * the grammar below throws {@link InvalidPdppGrantError}. This module owns the\n * mapping; other implementations should import it, or test against the\n * vectors in `protocol/fixtures/pdpp-scope-keys.json`.\n *\n * - `source_id`: `^https://registry\\.pdpp\\.dev/sources/([a-z0-9][a-z0-9_]*)$`\n * - `stream`: `^[a-z0-9][a-z0-9_]*$`\n *\n * Both are matched against the whole string, with no trimming.\n *\n * @category Protocol\n * @module protocol/pdpp-scopes\n */\n\n/** First segment of every PDPP scope key. */\nexport const PDPP_SCOPE_NAMESPACE = \"pdpp\";\n\n/** The only `source_id` prefix a PDPP grant may name. */\nexport const PDPP_SOURCE_ID_PREFIX = \"https://registry.pdpp.dev/sources/\";\n\n// A segment must start with a letter or digit: ScopeSchema rejects a scope\n// segment that starts with `_`, so the key would not be a valid scope.\nconst SEGMENT = \"[a-z0-9][a-z0-9_]*\";\nconst SOURCE_ID_RE = new RegExp(\n  `^${PDPP_SOURCE_ID_PREFIX.replace(/[.]/g, \"\\\\.\")}(${SEGMENT})$`,\n);\nconst STREAM_RE = new RegExp(`^${SEGMENT}$`);\nconst KEY_RE = new RegExp(\n  `^${PDPP_SCOPE_NAMESPACE}\\\\.(${SEGMENT})\\\\.(${SEGMENT})$`,\n);\n\n/**\n * What a builder asks for from one PDPP source.\n *\n * @remarks\n * Field names follow PDPP's own wire form (`source_id`), not camelCase, so a\n * grant can be copied from a PDPP manifest as is.\n */\nexport interface PdppGrant {\n  /** Registry URI of the source, e.g. `https://registry.pdpp.dev/sources/chatgpt`. */\n  source_id: string;\n  /** Streams to request from that source, e.g. `[\"conversations\", \"messages\"]`. At least one. */\n  streams: string[];\n}\n\n/** One (source, stream) pair, as recovered from a scope key. */\nexport interface PdppScopeKeyParts {\n  source_id: string;\n  stream: string;\n}\n\n/** Thrown when a PDPP grant, `source_id` or stream does not fit the grammar. */\nexport class InvalidPdppGrantError extends Error {\n  /** Which part was rejected. */\n  readonly field: \"grants\" | \"grant\" | \"source_id\" | \"streams\" | \"stream\";\n  /** The rejected value, verbatim. */\n  readonly value: unknown;\n\n  constructor(\n    field: InvalidPdppGrantError[\"field\"],\n    value: unknown,\n    reason: string,\n  ) {\n    super(\n      `Invalid PDPP ${field}${typeof value === \"string\" ? ` ${JSON.stringify(value)}` : \"\"}: ${reason}`,\n    );\n    this.name = \"InvalidPdppGrantError\";\n    this.field = field;\n    this.value = value;\n  }\n}\n\nfunction sourceSegment(sourceId: string): string {\n  const raw: unknown = sourceId;\n  const match = typeof raw === \"string\" ? SOURCE_ID_RE.exec(raw) : null;\n  if (!match) {\n    throw new InvalidPdppGrantError(\n      \"source_id\",\n      raw,\n      `must be ${PDPP_SOURCE_ID_PREFIX}<source> where <source> is lowercase letters, digits and underscores, not starting with an underscore`,\n    );\n  }\n  return match[1];\n}\n\nfunction assertStream(stream: string): void {\n  const raw: unknown = stream;\n  if (typeof raw !== \"string\" || !STREAM_RE.test(raw)) {\n    throw new InvalidPdppGrantError(\n      \"stream\",\n      raw,\n      \"must be lowercase letters, digits and underscores, not starting with an underscore\",\n    );\n  }\n}\n\n/**\n * The scope key for one stream of one PDPP source.\n *\n * @example\n * ```ts\n * pdppScopeKey(\"https://registry.pdpp.dev/sources/chatgpt\", \"messages\");\n * // \"pdpp.chatgpt.messages\"\n * ```\n *\n * @param source_id - Registry URI of the source.\n * @param stream - Stream name.\n * @returns `pdpp.<source>.<stream>`.\n * @throws InvalidPdppGrantError when either input does not fit the grammar.\n */\nexport function pdppScopeKey(source_id: string, stream: string): string {\n  const source = sourceSegment(source_id);\n  assertStream(stream);\n  return `${PDPP_SCOPE_NAMESPACE}.${source}.${stream}`;\n}\n\n/**\n * Inverse of {@link pdppScopeKey}.\n *\n * @param key - A scope string. Wildcards (`pdpp.chatgpt.*`) and grant entries\n * with an operation prefix (`write:pdpp.chatgpt.messages`) are not keys.\n * @returns The `source_id` and stream, or `null` when `key` is not a PDPP key.\n */\nexport function parsePdppScopeKey(key: string): PdppScopeKeyParts | null {\n  const raw: unknown = key;\n  const match = typeof raw === \"string\" ? KEY_RE.exec(raw) : null;\n  if (!match) return null;\n  return { source_id: `${PDPP_SOURCE_ID_PREFIX}${match[1]}`, stream: match[2] };\n}\n\n/**\n * Is `key` a PDPP scope key?\n *\n * @param key - A scope string.\n * @returns `true` when {@link parsePdppScopeKey} would parse it.\n */\nexport function isPdppScopeKey(key: string): boolean {\n  return parsePdppScopeKey(key) !== null;\n}\n\n/**\n * The scope keys for a list of PDPP grants: one per stream, in grant order,\n * without duplicates.\n *\n * @param grants - The grants a builder requests.\n * @returns The derived scope keys (empty for no grants).\n * @throws InvalidPdppGrantError when a grant is malformed, names no streams,\n * or has a `source_id` or stream outside the grammar.\n */\nexport function pdppGrantsToScopes(grants: readonly PdppGrant[]): string[] {\n  const raw: unknown = grants;\n  if (!Array.isArray(raw)) {\n    throw new InvalidPdppGrantError(\"grants\", raw, \"must be an array\");\n  }\n  const keys = new Set<string>();\n  for (const grant of raw as unknown[]) {\n    if (grant === null || typeof grant !== \"object\") {\n      throw new InvalidPdppGrantError(\"grant\", grant, \"must be an object\");\n    }\n    const { source_id: sourceId, streams } = grant as Partial<PdppGrant>;\n    if (!Array.isArray(streams) || streams.length === 0) {\n      throw new InvalidPdppGrantError(\n        \"streams\",\n        streams,\n        `must name at least one stream${typeof sourceId === \"string\" ? ` for ${sourceId}` : \"\"}`,\n      );\n    }\n    for (const stream of streams) {\n      keys.add(pdppScopeKey(sourceId as string, stream));\n    }\n  }\n  return [...keys];\n}\n\n/**\n * The scope entries one request asks for: legacy `scopes` and the keys\n * derived from `grants`.\n *\n * @remarks\n * Legacy scopes come first and pass through verbatim (order and duplicates\n * included, so a request without grants is byte-for-byte what it was before\n * grants existed). Derived keys follow, minus any already present.\n *\n * @param input - `grants` (structured) and/or legacy `scopes`\n * (`[operation:]scope` entries).\n * @returns The scope entries to request.\n * @throws InvalidPdppGrantError when a grant does not fit the grammar.\n */\nexport function grantRequestScopes(input: {\n  grants?: readonly PdppGrant[];\n  scopes?: readonly string[];\n}): string[] {\n  const legacy = [...(input.scopes ?? [])];\n  const present = new Set(legacy);\n  const derived = pdppGrantsToScopes(input.grants ?? []).filter(\n    (key) => !present.has(key),\n  );\n  return [...legacy, ...derived];\n}\n"],"mappings":"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","names":[]}

package/dist/protocol/pdpp-scopes.d.ts

@@ -0,0 +1,123 @@
+/**
+ * PDPP grant requests and the one scope key they map to.
+ *
+ * @remarks
+ * A builder asks for PDPP data as grants: a registry `source_id` and the
+ * streams it wants from that source,
+ * `{ source_id: "https://registry.pdpp.dev/sources/chatgpt", streams: ["messages"] }`.
+ * Everything downstream (the access request, the signed grant, the gateway,
+ * the Personal Server) carries flat scope strings, and a raw URI cannot be
+ * one: its `:` collides with the `write:` operation prefix, and `/` and `#`
+ * break Personal Server routes and storage paths. So each (source, stream)
+ * pair maps to exactly one scope key, `pdpp.<source>.<stream>`, where
+ * `<source>` is the last path segment of the `source_id`.
+ *
+ * The key is an ordinary scope: it passes `ScopeSchema` and the
+ * `[operation:]scope` grant-entry grammar unchanged (`write:pdpp.chatgpt.messages`
+ * is a write entry), and `pdpp.<source>.*` covers every stream of one source
+ * through the usual prefix wildcard. The `pdpp.` namespace keeps these keys
+ * apart from legacy `{platform}.{scope}` strings: PDPP's ChatGPT
+ * `conversations` stream is not the legacy `chatgpt.conversations` scope, and
+ * the gateway keys data by the scope string.
+ *
+ * The mapping is strict and never slugifies. A `source_id` or stream outside
+ * the grammar below throws {@link InvalidPdppGrantError}. This module owns the
+ * mapping; other implementations should import it, or test against the
+ * vectors in `protocol/fixtures/pdpp-scope-keys.json`.
+ *
+ * - `source_id`: `^https://registry\.pdpp\.dev/sources/([a-z0-9][a-z0-9_]*)$`
+ * - `stream`: `^[a-z0-9][a-z0-9_]*$`
+ *
+ * Both are matched against the whole string, with no trimming.
+ *
+ * @category Protocol
+ * @module protocol/pdpp-scopes
+ */
+/** First segment of every PDPP scope key. */
+export declare const PDPP_SCOPE_NAMESPACE = "pdpp";
+/** The only `source_id` prefix a PDPP grant may name. */
+export declare const PDPP_SOURCE_ID_PREFIX = "https://registry.pdpp.dev/sources/";
+/**
+ * What a builder asks for from one PDPP source.
+ *
+ * @remarks
+ * Field names follow PDPP's own wire form (`source_id`), not camelCase, so a
+ * grant can be copied from a PDPP manifest as is.
+ */
+export interface PdppGrant {
+    /** Registry URI of the source, e.g. `https://registry.pdpp.dev/sources/chatgpt`. */
+    source_id: string;
+    /** Streams to request from that source, e.g. `["conversations", "messages"]`. At least one. */
+    streams: string[];
+}
+/** One (source, stream) pair, as recovered from a scope key. */
+export interface PdppScopeKeyParts {
+    source_id: string;
+    stream: string;
+}
+/** Thrown when a PDPP grant, `source_id` or stream does not fit the grammar. */
+export declare class InvalidPdppGrantError extends Error {
+    /** Which part was rejected. */
+    readonly field: "grants" | "grant" | "source_id" | "streams" | "stream";
+    /** The rejected value, verbatim. */
+    readonly value: unknown;
+    constructor(field: InvalidPdppGrantError["field"], value: unknown, reason: string);
+}
+/**
+ * The scope key for one stream of one PDPP source.
+ *
+ * @example
+ * ```ts
+ * pdppScopeKey("https://registry.pdpp.dev/sources/chatgpt", "messages");
+ * // "pdpp.chatgpt.messages"
+ * ```
+ *
+ * @param source_id - Registry URI of the source.
+ * @param stream - Stream name.
+ * @returns `pdpp.<source>.<stream>`.
+ * @throws InvalidPdppGrantError when either input does not fit the grammar.
+ */
+export declare function pdppScopeKey(source_id: string, stream: string): string;
+/**
+ * Inverse of {@link pdppScopeKey}.
+ *
+ * @param key - A scope string. Wildcards (`pdpp.chatgpt.*`) and grant entries
+ * with an operation prefix (`write:pdpp.chatgpt.messages`) are not keys.
+ * @returns The `source_id` and stream, or `null` when `key` is not a PDPP key.
+ */
+export declare function parsePdppScopeKey(key: string): PdppScopeKeyParts | null;
+/**
+ * Is `key` a PDPP scope key?
+ *
+ * @param key - A scope string.
+ * @returns `true` when {@link parsePdppScopeKey} would parse it.
+ */
+export declare function isPdppScopeKey(key: string): boolean;
+/**
+ * The scope keys for a list of PDPP grants: one per stream, in grant order,
+ * without duplicates.
+ *
+ * @param grants - The grants a builder requests.
+ * @returns The derived scope keys (empty for no grants).
+ * @throws InvalidPdppGrantError when a grant is malformed, names no streams,
+ * or has a `source_id` or stream outside the grammar.
+ */
+export declare function pdppGrantsToScopes(grants: readonly PdppGrant[]): string[];
+/**
+ * The scope entries one request asks for: legacy `scopes` and the keys
+ * derived from `grants`.
+ *
+ * @remarks
+ * Legacy scopes come first and pass through verbatim (order and duplicates
+ * included, so a request without grants is byte-for-byte what it was before
+ * grants existed). Derived keys follow, minus any already present.
+ *
+ * @param input - `grants` (structured) and/or legacy `scopes`
+ * (`[operation:]scope` entries).
+ * @returns The scope entries to request.
+ * @throws InvalidPdppGrantError when a grant does not fit the grammar.
+ */
+export declare function grantRequestScopes(input: {
+    grants?: readonly PdppGrant[];
+    scopes?: readonly string[];
+}): string[];

package/dist/protocol/pdpp-scopes.js

@@ -0,0 +1,103 @@
+const PDPP_SCOPE_NAMESPACE = "pdpp";
+const PDPP_SOURCE_ID_PREFIX = "https://registry.pdpp.dev/sources/";
+const SEGMENT = "[a-z0-9][a-z0-9_]*";
+const SOURCE_ID_RE = new RegExp(
+  `^${PDPP_SOURCE_ID_PREFIX.replace(/[.]/g, "\\.")}(${SEGMENT})$`
+);
+const STREAM_RE = new RegExp(`^${SEGMENT}$`);
+const KEY_RE = new RegExp(
+  `^${PDPP_SCOPE_NAMESPACE}\\.(${SEGMENT})\\.(${SEGMENT})$`
+);
+class InvalidPdppGrantError 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];
+}
+export {
+  InvalidPdppGrantError,
+  PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX,
+  grantRequestScopes,
+  isPdppScopeKey,
+  parsePdppScopeKey,
+  pdppGrantsToScopes,
+  pdppScopeKey
+};
+//# sourceMappingURL=pdpp-scopes.js.map

package/dist/protocol/pdpp-scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/pdpp-scopes.ts"],"sourcesContent":["/**\n * PDPP grant requests and the one scope key they map to.\n *\n * @remarks\n * A builder asks for PDPP data as grants: a registry `source_id` and the\n * streams it wants from that source,\n * `{ source_id: \"https://registry.pdpp.dev/sources/chatgpt\", streams: [\"messages\"] }`.\n * Everything downstream (the access request, the signed grant, the gateway,\n * the Personal Server) carries flat scope strings, and a raw URI cannot be\n * one: its `:` collides with the `write:` operation prefix, and `/` and `#`\n * break Personal Server routes and storage paths. So each (source, stream)\n * pair maps to exactly one scope key, `pdpp.<source>.<stream>`, where\n * `<source>` is the last path segment of the `source_id`.\n *\n * The key is an ordinary scope: it passes `ScopeSchema` and the\n * `[operation:]scope` grant-entry grammar unchanged (`write:pdpp.chatgpt.messages`\n * is a write entry), and `pdpp.<source>.*` covers every stream of one source\n * through the usual prefix wildcard. The `pdpp.` namespace keeps these keys\n * apart from legacy `{platform}.{scope}` strings: PDPP's ChatGPT\n * `conversations` stream is not the legacy `chatgpt.conversations` scope, and\n * the gateway keys data by the scope string.\n *\n * The mapping is strict and never slugifies. A `source_id` or stream outside\n * the grammar below throws {@link InvalidPdppGrantError}. This module owns the\n * mapping; other implementations should import it, or test against the\n * vectors in `protocol/fixtures/pdpp-scope-keys.json`.\n *\n * - `source_id`: `^https://registry\\.pdpp\\.dev/sources/([a-z0-9][a-z0-9_]*)$`\n * - `stream`: `^[a-z0-9][a-z0-9_]*$`\n *\n * Both are matched against the whole string, with no trimming.\n *\n * @category Protocol\n * @module protocol/pdpp-scopes\n */\n\n/** First segment of every PDPP scope key. */\nexport const PDPP_SCOPE_NAMESPACE = \"pdpp\";\n\n/** The only `source_id` prefix a PDPP grant may name. */\nexport const PDPP_SOURCE_ID_PREFIX = \"https://registry.pdpp.dev/sources/\";\n\n// A segment must start with a letter or digit: ScopeSchema rejects a scope\n// segment that starts with `_`, so the key would not be a valid scope.\nconst SEGMENT = \"[a-z0-9][a-z0-9_]*\";\nconst SOURCE_ID_RE = new RegExp(\n  `^${PDPP_SOURCE_ID_PREFIX.replace(/[.]/g, \"\\\\.\")}(${SEGMENT})$`,\n);\nconst STREAM_RE = new RegExp(`^${SEGMENT}$`);\nconst KEY_RE = new RegExp(\n  `^${PDPP_SCOPE_NAMESPACE}\\\\.(${SEGMENT})\\\\.(${SEGMENT})$`,\n);\n\n/**\n * What a builder asks for from one PDPP source.\n *\n * @remarks\n * Field names follow PDPP's own wire form (`source_id`), not camelCase, so a\n * grant can be copied from a PDPP manifest as is.\n */\nexport interface PdppGrant {\n  /** Registry URI of the source, e.g. `https://registry.pdpp.dev/sources/chatgpt`. */\n  source_id: string;\n  /** Streams to request from that source, e.g. `[\"conversations\", \"messages\"]`. At least one. */\n  streams: string[];\n}\n\n/** One (source, stream) pair, as recovered from a scope key. */\nexport interface PdppScopeKeyParts {\n  source_id: string;\n  stream: string;\n}\n\n/** Thrown when a PDPP grant, `source_id` or stream does not fit the grammar. */\nexport class InvalidPdppGrantError extends Error {\n  /** Which part was rejected. */\n  readonly field: \"grants\" | \"grant\" | \"source_id\" | \"streams\" | \"stream\";\n  /** The rejected value, verbatim. */\n  readonly value: unknown;\n\n  constructor(\n    field: InvalidPdppGrantError[\"field\"],\n    value: unknown,\n    reason: string,\n  ) {\n    super(\n      `Invalid PDPP ${field}${typeof value === \"string\" ? ` ${JSON.stringify(value)}` : \"\"}: ${reason}`,\n    );\n    this.name = \"InvalidPdppGrantError\";\n    this.field = field;\n    this.value = value;\n  }\n}\n\nfunction sourceSegment(sourceId: string): string {\n  const raw: unknown = sourceId;\n  const match = typeof raw === \"string\" ? SOURCE_ID_RE.exec(raw) : null;\n  if (!match) {\n    throw new InvalidPdppGrantError(\n      \"source_id\",\n      raw,\n      `must be ${PDPP_SOURCE_ID_PREFIX}<source> where <source> is lowercase letters, digits and underscores, not starting with an underscore`,\n    );\n  }\n  return match[1];\n}\n\nfunction assertStream(stream: string): void {\n  const raw: unknown = stream;\n  if (typeof raw !== \"string\" || !STREAM_RE.test(raw)) {\n    throw new InvalidPdppGrantError(\n      \"stream\",\n      raw,\n      \"must be lowercase letters, digits and underscores, not starting with an underscore\",\n    );\n  }\n}\n\n/**\n * The scope key for one stream of one PDPP source.\n *\n * @example\n * ```ts\n * pdppScopeKey(\"https://registry.pdpp.dev/sources/chatgpt\", \"messages\");\n * // \"pdpp.chatgpt.messages\"\n * ```\n *\n * @param source_id - Registry URI of the source.\n * @param stream - Stream name.\n * @returns `pdpp.<source>.<stream>`.\n * @throws InvalidPdppGrantError when either input does not fit the grammar.\n */\nexport function pdppScopeKey(source_id: string, stream: string): string {\n  const source = sourceSegment(source_id);\n  assertStream(stream);\n  return `${PDPP_SCOPE_NAMESPACE}.${source}.${stream}`;\n}\n\n/**\n * Inverse of {@link pdppScopeKey}.\n *\n * @param key - A scope string. Wildcards (`pdpp.chatgpt.*`) and grant entries\n * with an operation prefix (`write:pdpp.chatgpt.messages`) are not keys.\n * @returns The `source_id` and stream, or `null` when `key` is not a PDPP key.\n */\nexport function parsePdppScopeKey(key: string): PdppScopeKeyParts | null {\n  const raw: unknown = key;\n  const match = typeof raw === \"string\" ? KEY_RE.exec(raw) : null;\n  if (!match) return null;\n  return { source_id: `${PDPP_SOURCE_ID_PREFIX}${match[1]}`, stream: match[2] };\n}\n\n/**\n * Is `key` a PDPP scope key?\n *\n * @param key - A scope string.\n * @returns `true` when {@link parsePdppScopeKey} would parse it.\n */\nexport function isPdppScopeKey(key: string): boolean {\n  return parsePdppScopeKey(key) !== null;\n}\n\n/**\n * The scope keys for a list of PDPP grants: one per stream, in grant order,\n * without duplicates.\n *\n * @param grants - The grants a builder requests.\n * @returns The derived scope keys (empty for no grants).\n * @throws InvalidPdppGrantError when a grant is malformed, names no streams,\n * or has a `source_id` or stream outside the grammar.\n */\nexport function pdppGrantsToScopes(grants: readonly PdppGrant[]): string[] {\n  const raw: unknown = grants;\n  if (!Array.isArray(raw)) {\n    throw new InvalidPdppGrantError(\"grants\", raw, \"must be an array\");\n  }\n  const keys = new Set<string>();\n  for (const grant of raw as unknown[]) {\n    if (grant === null || typeof grant !== \"object\") {\n      throw new InvalidPdppGrantError(\"grant\", grant, \"must be an object\");\n    }\n    const { source_id: sourceId, streams } = grant as Partial<PdppGrant>;\n    if (!Array.isArray(streams) || streams.length === 0) {\n      throw new InvalidPdppGrantError(\n        \"streams\",\n        streams,\n        `must name at least one stream${typeof sourceId === \"string\" ? ` for ${sourceId}` : \"\"}`,\n      );\n    }\n    for (const stream of streams) {\n      keys.add(pdppScopeKey(sourceId as string, stream));\n    }\n  }\n  return [...keys];\n}\n\n/**\n * The scope entries one request asks for: legacy `scopes` and the keys\n * derived from `grants`.\n *\n * @remarks\n * Legacy scopes come first and pass through verbatim (order and duplicates\n * included, so a request without grants is byte-for-byte what it was before\n * grants existed). Derived keys follow, minus any already present.\n *\n * @param input - `grants` (structured) and/or legacy `scopes`\n * (`[operation:]scope` entries).\n * @returns The scope entries to request.\n * @throws InvalidPdppGrantError when a grant does not fit the grammar.\n */\nexport function grantRequestScopes(input: {\n  grants?: readonly PdppGrant[];\n  scopes?: readonly string[];\n}): string[] {\n  const legacy = [...(input.scopes ?? [])];\n  const present = new Set(legacy);\n  const derived = pdppGrantsToScopes(input.grants ?? []).filter(\n    (key) => !present.has(key),\n  );\n  return [...legacy, ...derived];\n}\n"],"mappings":"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","names":[]}

package/dist/protocol/pdpp-scopes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/protocol/scopes.cjs

@@ -18,14 +18,23 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var scopes_exports = {};
 __export(scopes_exports, {
+  InvalidPdppGrantError: () => import_pdpp_scopes.InvalidPdppGrantError,
+  PDPP_SCOPE_NAMESPACE: () => import_pdpp_scopes.PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX: () => import_pdpp_scopes.PDPP_SOURCE_ID_PREFIX,
   ScopeSchema: () => ScopeSchema,
+  grantRequestScopes: () => import_pdpp_scopes.grantRequestScopes,
+  isPdppScopeKey: () => import_pdpp_scopes.isPdppScopeKey,
+  parsePdppScopeKey: () => import_pdpp_scopes.parsePdppScopeKey,
   parseScope: () => parseScope,
+  pdppGrantsToScopes: () => import_pdpp_scopes.pdppGrantsToScopes,
+  pdppScopeKey: () => import_pdpp_scopes.pdppScopeKey,
   scopeCoveredByGrant: () => scopeCoveredByGrant,
   scopeMatchesPattern: () => scopeMatchesPattern,
   scopeToPathSegments: () => scopeToPathSegments
 });
 module.exports = __toCommonJS(scopes_exports);
 var import_zod = require("zod");
+var import_pdpp_scopes = require("./pdpp-scopes");
 const SOURCE_RE = /^[a-z0-9][a-z0-9_]*$/;
 const TAIL_SEGMENT_RE = /^[a-zA-Z0-9][a-zA-Z0-9_]*$/;
 const ScopeSchema = import_zod.z.string().refine(
@@ -72,8 +81,16 @@ function scopeCoveredByGrant(requestedScope, grantedScopes) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  InvalidPdppGrantError,
+  PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX,
   ScopeSchema,
+  grantRequestScopes,
+  isPdppScopeKey,
+  parsePdppScopeKey,
   parseScope,
+  pdppGrantsToScopes,
+  pdppScopeKey,
   scopeCoveredByGrant,
   scopeMatchesPattern,
   scopeToPathSegments

package/dist/protocol/scopes.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/protocol/scopes.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// The source_id (first segment) must stay lowercase. Tail segments may keep\n// the historical camelCase form the contract-freeze spec explicitly preserves\n// (e.g. spotify.savedTracks, youtube.playlistItems) — the chain never validates\n// scope strings, so the SDK must not be stricter than the protocol.\nconst SOURCE_RE = /^[a-z0-9][a-z0-9_]*$/;\nconst TAIL_SEGMENT_RE = /^[a-zA-Z0-9][a-zA-Z0-9_]*$/;\n\nexport const ScopeSchema = z.string().refine(\n  (scope) => {\n    const parts = scope.split(\".\");\n    if (parts.length < 2 || parts.length > 3) return false;\n    const [source, ...tail] = parts;\n    return (\n      SOURCE_RE.test(source) && tail.every((part) => TAIL_SEGMENT_RE.test(part))\n    );\n  },\n  {\n    message:\n      \"Scope must be {source}.{category}[.{subcategory}]; source lowercase, tail may keep the historical camelCase form (e.g. spotify.savedTracks)\",\n  },\n);\n\nexport type Scope = z.infer<typeof ScopeSchema>;\n\nexport interface ParsedScope {\n  source: string;\n  category: string;\n  subcategory?: string;\n  raw: string;\n}\n\nexport function parseScope(scope: string): ParsedScope {\n  const validated = ScopeSchema.parse(scope);\n  const parts = validated.split(\".\");\n  return {\n    source: parts[0],\n    category: parts[1],\n    subcategory: parts[2],\n    raw: validated,\n  };\n}\n\nexport function scopeToPathSegments(scope: string): string[] {\n  const parsed = parseScope(scope);\n  const segments = [parsed.source, parsed.category];\n  if (parsed.subcategory) {\n    segments.push(parsed.subcategory);\n  }\n  return segments;\n}\n\nexport function scopeMatchesPattern(\n  requestedScope: string,\n  grantPattern: string,\n): boolean {\n  if (grantPattern === \"*\") return true;\n\n  if (grantPattern.endsWith(\".*\")) {\n    const prefix = grantPattern.slice(0, -1);\n    return requestedScope.startsWith(prefix);\n  }\n\n  return requestedScope === grantPattern;\n}\n\nexport function scopeCoveredByGrant(\n  requestedScope: string,\n  grantedScopes: string[],\n): boolean {\n  return grantedScopes.some((pattern) =>\n    scopeMatchesPattern(requestedScope, pattern),\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAMlB,MAAM,YAAY;AAClB,MAAM,kBAAkB;AAEjB,MAAM,cAAc,aAAE,OAAO,EAAE;AAAA,EACpC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,QAAI,MAAM,SAAS,KAAK,MAAM,SAAS,EAAG,QAAO;AACjD,UAAM,CAAC,QAAQ,GAAG,IAAI,IAAI;AAC1B,WACE,UAAU,KAAK,MAAM,KAAK,KAAK,MAAM,CAAC,SAAS,gBAAgB,KAAK,IAAI,CAAC;AAAA,EAE7E;AAAA,EACA;AAAA,IACE,SACE;AAAA,EACJ;AACF;AAWO,SAAS,WAAW,OAA4B;AACrD,QAAM,YAAY,YAAY,MAAM,KAAK;AACzC,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,SAAO;AAAA,IACL,QAAQ,MAAM,CAAC;AAAA,IACf,UAAU,MAAM,CAAC;AAAA,IACjB,aAAa,MAAM,CAAC;AAAA,IACpB,KAAK;AAAA,EACP;AACF;AAEO,SAAS,oBAAoB,OAAyB;AAC3D,QAAM,SAAS,WAAW,KAAK;AAC/B,QAAM,WAAW,CAAC,OAAO,QAAQ,OAAO,QAAQ;AAChD,MAAI,OAAO,aAAa;AACtB,aAAS,KAAK,OAAO,WAAW;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,oBACd,gBACA,cACS;AACT,MAAI,iBAAiB,IAAK,QAAO;AAEjC,MAAI,aAAa,SAAS,IAAI,GAAG;AAC/B,UAAM,SAAS,aAAa,MAAM,GAAG,EAAE;AACvC,WAAO,eAAe,WAAW,MAAM;AAAA,EACzC;AAEA,SAAO,mBAAmB;AAC5B;AAEO,SAAS,oBACd,gBACA,eACS;AACT,SAAO,cAAc;AAAA,IAAK,CAAC,YACzB,oBAAoB,gBAAgB,OAAO;AAAA,EAC7C;AACF;","names":[]}
+{"version":3,"sources":["../../src/protocol/scopes.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// The source_id (first segment) must stay lowercase. Tail segments may keep\n// the historical camelCase form the contract-freeze spec explicitly preserves\n// (e.g. spotify.savedTracks, youtube.playlistItems) — the chain never validates\n// scope strings, so the SDK must not be stricter than the protocol.\nconst SOURCE_RE = /^[a-z0-9][a-z0-9_]*$/;\nconst TAIL_SEGMENT_RE = /^[a-zA-Z0-9][a-zA-Z0-9_]*$/;\n\nexport const ScopeSchema = z.string().refine(\n  (scope) => {\n    const parts = scope.split(\".\");\n    if (parts.length < 2 || parts.length > 3) return false;\n    const [source, ...tail] = parts;\n    return (\n      SOURCE_RE.test(source) && tail.every((part) => TAIL_SEGMENT_RE.test(part))\n    );\n  },\n  {\n    message:\n      \"Scope must be {source}.{category}[.{subcategory}]; source lowercase, tail may keep the historical camelCase form (e.g. spotify.savedTracks)\",\n  },\n);\n\nexport type Scope = z.infer<typeof ScopeSchema>;\n\nexport interface ParsedScope {\n  source: string;\n  category: string;\n  subcategory?: string;\n  raw: string;\n}\n\nexport function parseScope(scope: string): ParsedScope {\n  const validated = ScopeSchema.parse(scope);\n  const parts = validated.split(\".\");\n  return {\n    source: parts[0],\n    category: parts[1],\n    subcategory: parts[2],\n    raw: validated,\n  };\n}\n\nexport function scopeToPathSegments(scope: string): string[] {\n  const parsed = parseScope(scope);\n  const segments = [parsed.source, parsed.category];\n  if (parsed.subcategory) {\n    segments.push(parsed.subcategory);\n  }\n  return segments;\n}\n\nexport function scopeMatchesPattern(\n  requestedScope: string,\n  grantPattern: string,\n): boolean {\n  if (grantPattern === \"*\") return true;\n\n  if (grantPattern.endsWith(\".*\")) {\n    const prefix = grantPattern.slice(0, -1);\n    return requestedScope.startsWith(prefix);\n  }\n\n  return requestedScope === grantPattern;\n}\n\nexport function scopeCoveredByGrant(\n  requestedScope: string,\n  grantedScopes: string[],\n): boolean {\n  return grantedScopes.some((pattern) =>\n    scopeMatchesPattern(requestedScope, pattern),\n  );\n}\n\n// PDPP grants map to scope keys in this same grammar; re-exported so the\n// scope contract has one import path (`@opendatalabs/vana-sdk/protocol/scopes`).\nexport {\n  PDPP_SCOPE_NAMESPACE,\n  PDPP_SOURCE_ID_PREFIX,\n  InvalidPdppGrantError,\n  pdppScopeKey,\n  parsePdppScopeKey,\n  isPdppScopeKey,\n  pdppGrantsToScopes,\n  grantRequestScopes,\n  type PdppGrant,\n  type PdppScopeKeyParts,\n} from \"./pdpp-scopes\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AA8ElB,yBAWO;AAnFP,MAAM,YAAY;AAClB,MAAM,kBAAkB;AAEjB,MAAM,cAAc,aAAE,OAAO,EAAE;AAAA,EACpC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,QAAI,MAAM,SAAS,KAAK,MAAM,SAAS,EAAG,QAAO;AACjD,UAAM,CAAC,QAAQ,GAAG,IAAI,IAAI;AAC1B,WACE,UAAU,KAAK,MAAM,KAAK,KAAK,MAAM,CAAC,SAAS,gBAAgB,KAAK,IAAI,CAAC;AAAA,EAE7E;AAAA,EACA;AAAA,IACE,SACE;AAAA,EACJ;AACF;AAWO,SAAS,WAAW,OAA4B;AACrD,QAAM,YAAY,YAAY,MAAM,KAAK;AACzC,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,SAAO;AAAA,IACL,QAAQ,MAAM,CAAC;AAAA,IACf,UAAU,MAAM,CAAC;AAAA,IACjB,aAAa,MAAM,CAAC;AAAA,IACpB,KAAK;AAAA,EACP;AACF;AAEO,SAAS,oBAAoB,OAAyB;AAC3D,QAAM,SAAS,WAAW,KAAK;AAC/B,QAAM,WAAW,CAAC,OAAO,QAAQ,OAAO,QAAQ;AAChD,MAAI,OAAO,aAAa;AACtB,aAAS,KAAK,OAAO,WAAW;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,oBACd,gBACA,cACS;AACT,MAAI,iBAAiB,IAAK,QAAO;AAEjC,MAAI,aAAa,SAAS,IAAI,GAAG;AAC/B,UAAM,SAAS,aAAa,MAAM,GAAG,EAAE;AACvC,WAAO,eAAe,WAAW,MAAM;AAAA,EACzC;AAEA,SAAO,mBAAmB;AAC5B;AAEO,SAAS,oBACd,gBACA,eACS;AACT,SAAO,cAAc;AAAA,IAAK,CAAC,YACzB,oBAAoB,gBAAgB,OAAO;AAAA,EAC7C;AACF;","names":[]}

package/dist/protocol/scopes.d.ts

@@ -11,3 +11,4 @@ export declare function parseScope(scope: string): ParsedScope;
 export declare function scopeToPathSegments(scope: string): string[];
 export declare function scopeMatchesPattern(requestedScope: string, grantPattern: string): boolean;
 export declare function scopeCoveredByGrant(requestedScope: string, grantedScopes: string[]): boolean;
+export { PDPP_SCOPE_NAMESPACE, PDPP_SOURCE_ID_PREFIX, InvalidPdppGrantError, pdppScopeKey, parsePdppScopeKey, isPdppScopeKey, pdppGrantsToScopes, grantRequestScopes, type PdppGrant, type PdppScopeKeyParts, } from "./pdpp-scopes.js";

package/dist/protocol/scopes.js

@@ -43,9 +43,27 @@ function scopeCoveredByGrant(requestedScope, grantedScopes) {
     (pattern) => scopeMatchesPattern(requestedScope, pattern)
   );
 }
+import {
+  PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX,
+  InvalidPdppGrantError,
+  pdppScopeKey,
+  parsePdppScopeKey,
+  isPdppScopeKey,
+  pdppGrantsToScopes,
+  grantRequestScopes
+} from "./pdpp-scopes.js";
 export {
+  InvalidPdppGrantError,
+  PDPP_SCOPE_NAMESPACE,
+  PDPP_SOURCE_ID_PREFIX,
   ScopeSchema,
+  grantRequestScopes,
+  isPdppScopeKey,
+  parsePdppScopeKey,
   parseScope,
+  pdppGrantsToScopes,
+  pdppScopeKey,
   scopeCoveredByGrant,
   scopeMatchesPattern,
   scopeToPathSegments

package/dist/protocol/scopes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/protocol/scopes.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// The source_id (first segment) must stay lowercase. Tail segments may keep\n// the historical camelCase form the contract-freeze spec explicitly preserves\n// (e.g. spotify.savedTracks, youtube.playlistItems) — the chain never validates\n// scope strings, so the SDK must not be stricter than the protocol.\nconst SOURCE_RE = /^[a-z0-9][a-z0-9_]*$/;\nconst TAIL_SEGMENT_RE = /^[a-zA-Z0-9][a-zA-Z0-9_]*$/;\n\nexport const ScopeSchema = z.string().refine(\n  (scope) => {\n    const parts = scope.split(\".\");\n    if (parts.length < 2 || parts.length > 3) return false;\n    const [source, ...tail] = parts;\n    return (\n      SOURCE_RE.test(source) && tail.every((part) => TAIL_SEGMENT_RE.test(part))\n    );\n  },\n  {\n    message:\n      \"Scope must be {source}.{category}[.{subcategory}]; source lowercase, tail may keep the historical camelCase form (e.g. spotify.savedTracks)\",\n  },\n);\n\nexport type Scope = z.infer<typeof ScopeSchema>;\n\nexport interface ParsedScope {\n  source: string;\n  category: string;\n  subcategory?: string;\n  raw: string;\n}\n\nexport function parseScope(scope: string): ParsedScope {\n  const validated = ScopeSchema.parse(scope);\n  const parts = validated.split(\".\");\n  return {\n    source: parts[0],\n    category: parts[1],\n    subcategory: parts[2],\n    raw: validated,\n  };\n}\n\nexport function scopeToPathSegments(scope: string): string[] {\n  const parsed = parseScope(scope);\n  const segments = [parsed.source, parsed.category];\n  if (parsed.subcategory) {\n    segments.push(parsed.subcategory);\n  }\n  return segments;\n}\n\nexport function scopeMatchesPattern(\n  requestedScope: string,\n  grantPattern: string,\n): boolean {\n  if (grantPattern === \"*\") return true;\n\n  if (grantPattern.endsWith(\".*\")) {\n    const prefix = grantPattern.slice(0, -1);\n    return requestedScope.startsWith(prefix);\n  }\n\n  return requestedScope === grantPattern;\n}\n\nexport function scopeCoveredByGrant(\n  requestedScope: string,\n  grantedScopes: string[],\n): boolean {\n  return grantedScopes.some((pattern) =>\n    scopeMatchesPattern(requestedScope, pattern),\n  );\n}\n"],"mappings":"AAAA,SAAS,SAAS;AAMlB,MAAM,YAAY;AAClB,MAAM,kBAAkB;AAEjB,MAAM,cAAc,EAAE,OAAO,EAAE;AAAA,EACpC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,QAAI,MAAM,SAAS,KAAK,MAAM,SAAS,EAAG,QAAO;AACjD,UAAM,CAAC,QAAQ,GAAG,IAAI,IAAI;AAC1B,WACE,UAAU,KAAK,MAAM,KAAK,KAAK,MAAM,CAAC,SAAS,gBAAgB,KAAK,IAAI,CAAC;AAAA,EAE7E;AAAA,EACA;AAAA,IACE,SACE;AAAA,EACJ;AACF;AAWO,SAAS,WAAW,OAA4B;AACrD,QAAM,YAAY,YAAY,MAAM,KAAK;AACzC,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,SAAO;AAAA,IACL,QAAQ,MAAM,CAAC;AAAA,IACf,UAAU,MAAM,CAAC;AAAA,IACjB,aAAa,MAAM,CAAC;AAAA,IACpB,KAAK;AAAA,EACP;AACF;AAEO,SAAS,oBAAoB,OAAyB;AAC3D,QAAM,SAAS,WAAW,KAAK;AAC/B,QAAM,WAAW,CAAC,OAAO,QAAQ,OAAO,QAAQ;AAChD,MAAI,OAAO,aAAa;AACtB,aAAS,KAAK,OAAO,WAAW;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,oBACd,gBACA,cACS;AACT,MAAI,iBAAiB,IAAK,QAAO;AAEjC,MAAI,aAAa,SAAS,IAAI,GAAG;AAC/B,UAAM,SAAS,aAAa,MAAM,GAAG,EAAE;AACvC,WAAO,eAAe,WAAW,MAAM;AAAA,EACzC;AAEA,SAAO,mBAAmB;AAC5B;AAEO,SAAS,oBACd,gBACA,eACS;AACT,SAAO,cAAc;AAAA,IAAK,CAAC,YACzB,oBAAoB,gBAAgB,OAAO;AAAA,EAC7C;AACF;","names":[]}
+{"version":3,"sources":["../../src/protocol/scopes.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// The source_id (first segment) must stay lowercase. Tail segments may keep\n// the historical camelCase form the contract-freeze spec explicitly preserves\n// (e.g. spotify.savedTracks, youtube.playlistItems) — the chain never validates\n// scope strings, so the SDK must not be stricter than the protocol.\nconst SOURCE_RE = /^[a-z0-9][a-z0-9_]*$/;\nconst TAIL_SEGMENT_RE = /^[a-zA-Z0-9][a-zA-Z0-9_]*$/;\n\nexport const ScopeSchema = z.string().refine(\n  (scope) => {\n    const parts = scope.split(\".\");\n    if (parts.length < 2 || parts.length > 3) return false;\n    const [source, ...tail] = parts;\n    return (\n      SOURCE_RE.test(source) && tail.every((part) => TAIL_SEGMENT_RE.test(part))\n    );\n  },\n  {\n    message:\n      \"Scope must be {source}.{category}[.{subcategory}]; source lowercase, tail may keep the historical camelCase form (e.g. spotify.savedTracks)\",\n  },\n);\n\nexport type Scope = z.infer<typeof ScopeSchema>;\n\nexport interface ParsedScope {\n  source: string;\n  category: string;\n  subcategory?: string;\n  raw: string;\n}\n\nexport function parseScope(scope: string): ParsedScope {\n  const validated = ScopeSchema.parse(scope);\n  const parts = validated.split(\".\");\n  return {\n    source: parts[0],\n    category: parts[1],\n    subcategory: parts[2],\n    raw: validated,\n  };\n}\n\nexport function scopeToPathSegments(scope: string): string[] {\n  const parsed = parseScope(scope);\n  const segments = [parsed.source, parsed.category];\n  if (parsed.subcategory) {\n    segments.push(parsed.subcategory);\n  }\n  return segments;\n}\n\nexport function scopeMatchesPattern(\n  requestedScope: string,\n  grantPattern: string,\n): boolean {\n  if (grantPattern === \"*\") return true;\n\n  if (grantPattern.endsWith(\".*\")) {\n    const prefix = grantPattern.slice(0, -1);\n    return requestedScope.startsWith(prefix);\n  }\n\n  return requestedScope === grantPattern;\n}\n\nexport function scopeCoveredByGrant(\n  requestedScope: string,\n  grantedScopes: string[],\n): boolean {\n  return grantedScopes.some((pattern) =>\n    scopeMatchesPattern(requestedScope, pattern),\n  );\n}\n\n// PDPP grants map to scope keys in this same grammar; re-exported so the\n// scope contract has one import path (`@opendatalabs/vana-sdk/protocol/scopes`).\nexport {\n  PDPP_SCOPE_NAMESPACE,\n  PDPP_SOURCE_ID_PREFIX,\n  InvalidPdppGrantError,\n  pdppScopeKey,\n  parsePdppScopeKey,\n  isPdppScopeKey,\n  pdppGrantsToScopes,\n  grantRequestScopes,\n  type PdppGrant,\n  type PdppScopeKeyParts,\n} from \"./pdpp-scopes\";\n"],"mappings":"AAAA,SAAS,SAAS;AAMlB,MAAM,YAAY;AAClB,MAAM,kBAAkB;AAEjB,MAAM,cAAc,EAAE,OAAO,EAAE;AAAA,EACpC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,GAAG;AAC7B,QAAI,MAAM,SAAS,KAAK,MAAM,SAAS,EAAG,QAAO;AACjD,UAAM,CAAC,QAAQ,GAAG,IAAI,IAAI;AAC1B,WACE,UAAU,KAAK,MAAM,KAAK,KAAK,MAAM,CAAC,SAAS,gBAAgB,KAAK,IAAI,CAAC;AAAA,EAE7E;AAAA,EACA;AAAA,IACE,SACE;AAAA,EACJ;AACF;AAWO,SAAS,WAAW,OAA4B;AACrD,QAAM,YAAY,YAAY,MAAM,KAAK;AACzC,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,SAAO;AAAA,IACL,QAAQ,MAAM,CAAC;AAAA,IACf,UAAU,MAAM,CAAC;AAAA,IACjB,aAAa,MAAM,CAAC;AAAA,IACpB,KAAK;AAAA,EACP;AACF;AAEO,SAAS,oBAAoB,OAAyB;AAC3D,QAAM,SAAS,WAAW,KAAK;AAC/B,QAAM,WAAW,CAAC,OAAO,QAAQ,OAAO,QAAQ;AAChD,MAAI,OAAO,aAAa;AACtB,aAAS,KAAK,OAAO,WAAW;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,oBACd,gBACA,cACS;AACT,MAAI,iBAAiB,IAAK,QAAO;AAEjC,MAAI,aAAa,SAAS,IAAI,GAAG;AAC/B,UAAM,SAAS,aAAa,MAAM,GAAG,EAAE;AACvC,WAAO,eAAe,WAAW,MAAM;AAAA,EACzC;AAEA,SAAO,mBAAmB;AAC5B;AAEO,SAAS,oBACd,gBACA,eACS;AACT,SAAO,cAAc;AAAA,IAAK,CAAC,YACzB,oBAAoB,gBAAgB,OAAO;AAAA,EAC7C;AACF;AAIA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;","names":[]}