@athenaintel/react 0.40.3 → 0.41.1

package/dist/references/src/formats/uri/asset-mention-uri.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const parse = require("../../anchors/parse.cjs");
+const versionRef = require("../../version-ref.cjs");
+const templatePlaceholder = require("./template-placeholder.cjs");
+function decodeFromAssetMentionUri(url) {
+  const params = url.searchParams;
+  const id = templatePlaceholder.unwrapTemplatePlaceholder(params.get("id") ?? "");
+  const anchor = parse.parseAnchorFromParams(params);
+  const version = versionRef.parseVersionRefFromParams(params);
+  const meta = {};
+  const assetType = params.get("asset_type") ?? params.get("type");
+  if (assetType) meta.assetType = templatePlaceholder.unwrapTemplatePlaceholder(assetType);
+  const excerpt = params.get("excerpt");
+  if (excerpt) meta.excerpt = excerpt;
+  const sheetName = params.get("sheet_name");
+  if (sheetName) meta.sheetName = sheetName;
+  const provider = params.get("provider");
+  if (provider) meta.provider = provider;
+  const providerLocation = params.get("provider_location") || params.get("providerLocation");
+  if (providerLocation) meta.providerLocation = providerLocation;
+  const ref = { referenced: "asset", id };
+  if (anchor) ref.anchor = anchor;
+  if (version) ref.version = version;
+  if (Object.keys(meta).length > 0) ref.meta = meta;
+  return versionRef.normalizeAssetReference(ref);
+}
+exports.decodeFromAssetMentionUri = decodeFromAssetMentionUri;
+//# sourceMappingURL=asset-mention-uri.cjs.map

package/dist/references/src/formats/uri/asset-mention-uri.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-mention-uri.cjs","sources":["../../../../../../references/src/formats/uri/asset-mention-uri.ts"],"sourcesContent":["import { parseAnchorFromParams } from '../../anchors/parse';\nimport { serializeAnchorToParams } from '../../anchors/serialize';\nimport type { AssetMeta, AssetReference } from '../../types';\nimport {\n  normalizeAssetReference,\n  parseVersionRefFromParams,\n  serializeVersionRefToParams,\n} from '../../version-ref';\nimport { unwrapTemplatePlaceholder } from './template-placeholder';\n\n/*\n * Transient asset mention URI — `mention://asset?id=X&...`\n *\n * This format is used in markdown when the full asset type / title is not yet\n * known (e.g. server-side markdown generation) and fetching the asset details\n * would be too expensive. It is NOT the format persisted by the TipTap editor.\n * The editor stores assets as dashboard-spaces URLs (the canonical format):\n *   /dashboard/spaces?asset_ids=<id>&type=<type>\n * See sibling `asset-spaces-url.ts` for the stored dashboard-spaces format.\n *\n * Always prefer the stored dashboard-spaces format when possible.\n */\n\n/**\n * Decode: `mention://asset?id=X&anchor=page&page=5` → AssetReference\n */\nexport function decodeFromAssetMentionUri(url: URL): AssetReference {\n  const params = url.searchParams;\n\n  const id = unwrapTemplatePlaceholder(params.get('id') ?? '');\n  const anchor = parseAnchorFromParams(params);\n  const version = parseVersionRefFromParams(params);\n\n  const meta: AssetMeta = {};\n  const assetType = params.get('asset_type') ?? params.get('type');\n  if (assetType) meta.assetType = unwrapTemplatePlaceholder(assetType);\n\n  const excerpt = params.get('excerpt');\n  if (excerpt) meta.excerpt = excerpt;\n\n  const sheetName = params.get('sheet_name');\n  if (sheetName) meta.sheetName = sheetName;\n\n  const provider = params.get('provider');\n  if (provider) meta.provider = provider;\n\n  const providerLocation =\n    params.get('provider_location') || params.get('providerLocation');\n  if (providerLocation) meta.providerLocation = providerLocation;\n\n  const ref: AssetReference = { referenced: 'asset', id };\n  if (anchor) ref.anchor = anchor;\n  if (version) ref.version = version;\n  if (Object.keys(meta).length > 0) ref.meta = meta;\n\n  return normalizeAssetReference(ref);\n}\n\n/**\n * Encode: AssetReference → `mention://asset?id=X&anchor=page&page=5`\n */\nexport function encodeToAssetMentionUri(reference: AssetReference): string {\n  const ref = normalizeAssetReference(reference);\n  const params = new URLSearchParams();\n  params.set('id', ref.id);\n\n  if (ref.meta?.assetType) {\n    params.set('asset_type', ref.meta.assetType);\n  }\n\n  if (ref.version) {\n    for (const [key, value] of serializeVersionRefToParams(ref.version)) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.meta?.sheetName) {\n    params.set('sheet_name', ref.meta.sheetName);\n  }\n\n  if (ref.anchor) {\n    const anchorParams = serializeAnchorToParams(ref.anchor);\n    for (const [key, value] of anchorParams) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.meta?.excerpt) {\n    params.set('excerpt', ref.meta.excerpt);\n  }\n\n  if (ref.meta?.provider) {\n    params.set('provider', ref.meta.provider);\n  }\n\n  if (ref.meta?.providerLocation) {\n    params.set('provider_location', ref.meta.providerLocation);\n  }\n\n  return `mention://asset?${params.toString()}`;\n}\n"],"names":["unwrapTemplatePlaceholder","parseAnchorFromParams","parseVersionRefFromParams","normalizeAssetReference"],"mappings":";;;;;AA0BO,SAAS,0BAA0B,KAA0B;AAClE,QAAM,SAAS,IAAI;AAEnB,QAAM,KAAKA,oBAAAA,0BAA0B,OAAO,IAAI,IAAI,KAAK,EAAE;AAC3D,QAAM,SAASC,MAAAA,sBAAsB,MAAM;AAC3C,QAAM,UAAUC,WAAAA,0BAA0B,MAAM;AAEhD,QAAM,OAAkB,CAAA;AACxB,QAAM,YAAY,OAAO,IAAI,YAAY,KAAK,OAAO,IAAI,MAAM;AAC/D,MAAI,UAAW,MAAK,YAAYF,oBAAAA,0BAA0B,SAAS;AAEnE,QAAM,UAAU,OAAO,IAAI,SAAS;AACpC,MAAI,cAAc,UAAU;AAE5B,QAAM,YAAY,OAAO,IAAI,YAAY;AACzC,MAAI,gBAAgB,YAAY;AAEhC,QAAM,WAAW,OAAO,IAAI,UAAU;AACtC,MAAI,eAAe,WAAW;AAE9B,QAAM,mBACJ,OAAO,IAAI,mBAAmB,KAAK,OAAO,IAAI,kBAAkB;AAClE,MAAI,uBAAuB,mBAAmB;AAE9C,QAAM,MAAsB,EAAE,YAAY,SAAS,GAAA;AACnD,MAAI,YAAY,SAAS;AACzB,MAAI,aAAa,UAAU;AAC3B,MAAI,OAAO,KAAK,IAAI,EAAE,SAAS,OAAO,OAAO;AAE7C,SAAOG,WAAAA,wBAAwB,GAAG;AACpC;;"}

package/dist/references/src/formats/uri/asset-mention-uri.js

@@ -0,0 +1,29 @@
+import { parseAnchorFromParams } from "../../anchors/parse.js";
+import { parseVersionRefFromParams, normalizeAssetReference } from "../../version-ref.js";
+import { unwrapTemplatePlaceholder } from "./template-placeholder.js";
+function decodeFromAssetMentionUri(url) {
+  const params = url.searchParams;
+  const id = unwrapTemplatePlaceholder(params.get("id") ?? "");
+  const anchor = parseAnchorFromParams(params);
+  const version = parseVersionRefFromParams(params);
+  const meta = {};
+  const assetType = params.get("asset_type") ?? params.get("type");
+  if (assetType) meta.assetType = unwrapTemplatePlaceholder(assetType);
+  const excerpt = params.get("excerpt");
+  if (excerpt) meta.excerpt = excerpt;
+  const sheetName = params.get("sheet_name");
+  if (sheetName) meta.sheetName = sheetName;
+  const provider = params.get("provider");
+  if (provider) meta.provider = provider;
+  const providerLocation = params.get("provider_location") || params.get("providerLocation");
+  if (providerLocation) meta.providerLocation = providerLocation;
+  const ref = { referenced: "asset", id };
+  if (anchor) ref.anchor = anchor;
+  if (version) ref.version = version;
+  if (Object.keys(meta).length > 0) ref.meta = meta;
+  return normalizeAssetReference(ref);
+}
+export {
+  decodeFromAssetMentionUri
+};
+//# sourceMappingURL=asset-mention-uri.js.map

package/dist/references/src/formats/uri/asset-mention-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-mention-uri.js","sources":["../../../../../../references/src/formats/uri/asset-mention-uri.ts"],"sourcesContent":["import { parseAnchorFromParams } from '../../anchors/parse';\nimport { serializeAnchorToParams } from '../../anchors/serialize';\nimport type { AssetMeta, AssetReference } from '../../types';\nimport {\n  normalizeAssetReference,\n  parseVersionRefFromParams,\n  serializeVersionRefToParams,\n} from '../../version-ref';\nimport { unwrapTemplatePlaceholder } from './template-placeholder';\n\n/*\n * Transient asset mention URI — `mention://asset?id=X&...`\n *\n * This format is used in markdown when the full asset type / title is not yet\n * known (e.g. server-side markdown generation) and fetching the asset details\n * would be too expensive. It is NOT the format persisted by the TipTap editor.\n * The editor stores assets as dashboard-spaces URLs (the canonical format):\n *   /dashboard/spaces?asset_ids=<id>&type=<type>\n * See sibling `asset-spaces-url.ts` for the stored dashboard-spaces format.\n *\n * Always prefer the stored dashboard-spaces format when possible.\n */\n\n/**\n * Decode: `mention://asset?id=X&anchor=page&page=5` → AssetReference\n */\nexport function decodeFromAssetMentionUri(url: URL): AssetReference {\n  const params = url.searchParams;\n\n  const id = unwrapTemplatePlaceholder(params.get('id') ?? '');\n  const anchor = parseAnchorFromParams(params);\n  const version = parseVersionRefFromParams(params);\n\n  const meta: AssetMeta = {};\n  const assetType = params.get('asset_type') ?? params.get('type');\n  if (assetType) meta.assetType = unwrapTemplatePlaceholder(assetType);\n\n  const excerpt = params.get('excerpt');\n  if (excerpt) meta.excerpt = excerpt;\n\n  const sheetName = params.get('sheet_name');\n  if (sheetName) meta.sheetName = sheetName;\n\n  const provider = params.get('provider');\n  if (provider) meta.provider = provider;\n\n  const providerLocation =\n    params.get('provider_location') || params.get('providerLocation');\n  if (providerLocation) meta.providerLocation = providerLocation;\n\n  const ref: AssetReference = { referenced: 'asset', id };\n  if (anchor) ref.anchor = anchor;\n  if (version) ref.version = version;\n  if (Object.keys(meta).length > 0) ref.meta = meta;\n\n  return normalizeAssetReference(ref);\n}\n\n/**\n * Encode: AssetReference → `mention://asset?id=X&anchor=page&page=5`\n */\nexport function encodeToAssetMentionUri(reference: AssetReference): string {\n  const ref = normalizeAssetReference(reference);\n  const params = new URLSearchParams();\n  params.set('id', ref.id);\n\n  if (ref.meta?.assetType) {\n    params.set('asset_type', ref.meta.assetType);\n  }\n\n  if (ref.version) {\n    for (const [key, value] of serializeVersionRefToParams(ref.version)) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.meta?.sheetName) {\n    params.set('sheet_name', ref.meta.sheetName);\n  }\n\n  if (ref.anchor) {\n    const anchorParams = serializeAnchorToParams(ref.anchor);\n    for (const [key, value] of anchorParams) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.meta?.excerpt) {\n    params.set('excerpt', ref.meta.excerpt);\n  }\n\n  if (ref.meta?.provider) {\n    params.set('provider', ref.meta.provider);\n  }\n\n  if (ref.meta?.providerLocation) {\n    params.set('provider_location', ref.meta.providerLocation);\n  }\n\n  return `mention://asset?${params.toString()}`;\n}\n"],"names":[],"mappings":";;;AA0BO,SAAS,0BAA0B,KAA0B;AAClE,QAAM,SAAS,IAAI;AAEnB,QAAM,KAAK,0BAA0B,OAAO,IAAI,IAAI,KAAK,EAAE;AAC3D,QAAM,SAAS,sBAAsB,MAAM;AAC3C,QAAM,UAAU,0BAA0B,MAAM;AAEhD,QAAM,OAAkB,CAAA;AACxB,QAAM,YAAY,OAAO,IAAI,YAAY,KAAK,OAAO,IAAI,MAAM;AAC/D,MAAI,UAAW,MAAK,YAAY,0BAA0B,SAAS;AAEnE,QAAM,UAAU,OAAO,IAAI,SAAS;AACpC,MAAI,cAAc,UAAU;AAE5B,QAAM,YAAY,OAAO,IAAI,YAAY;AACzC,MAAI,gBAAgB,YAAY;AAEhC,QAAM,WAAW,OAAO,IAAI,UAAU;AACtC,MAAI,eAAe,WAAW;AAE9B,QAAM,mBACJ,OAAO,IAAI,mBAAmB,KAAK,OAAO,IAAI,kBAAkB;AAClE,MAAI,uBAAuB,mBAAmB;AAE9C,QAAM,MAAsB,EAAE,YAAY,SAAS,GAAA;AACnD,MAAI,YAAY,SAAS;AACzB,MAAI,aAAa,UAAU;AAC3B,MAAI,OAAO,KAAK,IAAI,EAAE,SAAS,OAAO,OAAO;AAE7C,SAAO,wBAAwB,GAAG;AACpC;"}

package/dist/references/src/formats/uri/asset-spaces-url.cjs

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const parse = require("../../anchors/parse.cjs");
+const serialize = require("../../anchors/serialize.cjs");
+const versionRef = require("../../version-ref.cjs");
+const templatePlaceholder = require("./template-placeholder.cjs");
+function decodeFromAssetSpacesUrl(url) {
+  const params = url.searchParams;
+  const id = templatePlaceholder.unwrapTemplatePlaceholder(params.get("asset_ids") ?? "");
+  const anchor = parse.parseAnchorFromParams(params);
+  const version = versionRef.parseVersionRefFromParams(params);
+  const meta = {};
+  const assetType = params.get("type") ?? params.get("asset_type");
+  if (assetType) meta.assetType = templatePlaceholder.unwrapTemplatePlaceholder(assetType);
+  const excerpt = params.get("excerpt");
+  if (excerpt) meta.excerpt = excerpt;
+  const sheetName = params.get("sheet_name");
+  if (sheetName) meta.sheetName = sheetName;
+  const provider = params.get("provider");
+  if (provider) meta.provider = provider;
+  const providerLocation = params.get("provider_location") || params.get("providerLocation");
+  if (providerLocation) meta.providerLocation = providerLocation;
+  const ref = { referenced: "asset", id };
+  if (anchor) ref.anchor = anchor;
+  if (version) ref.version = version;
+  if (Object.keys(meta).length > 0) ref.meta = meta;
+  return versionRef.normalizeAssetReference(ref);
+}
+function encodeToAssetSpacesUrl(reference) {
+  var _a, _b, _c, _d, _e;
+  const ref = versionRef.normalizeAssetReference(reference);
+  const params = new URLSearchParams();
+  params.set("asset_ids", ref.id);
+  if ((_a = ref.meta) == null ? void 0 : _a.assetType) {
+    params.set("type", ref.meta.assetType);
+  }
+  if (ref.version) {
+    for (const [key, value] of versionRef.serializeVersionRefToParams(ref.version)) {
+      params.set(key, value);
+    }
+  }
+  if (ref.anchor) {
+    const anchorParams = serialize.serializeAnchorToParams(ref.anchor);
+    for (const [key, value] of anchorParams) {
+      params.set(key, value);
+    }
+  }
+  if ((_b = ref.meta) == null ? void 0 : _b.excerpt) {
+    params.set("excerpt", ref.meta.excerpt);
+  }
+  if ((_c = ref.meta) == null ? void 0 : _c.sheetName) {
+    params.set("sheet_name", ref.meta.sheetName);
+  }
+  if ((_d = ref.meta) == null ? void 0 : _d.provider) {
+    params.set("provider", ref.meta.provider);
+  }
+  if ((_e = ref.meta) == null ? void 0 : _e.providerLocation) {
+    params.set("provider_location", ref.meta.providerLocation);
+  }
+  return `/dashboard/spaces?${params.toString()}`;
+}
+exports.decodeFromAssetSpacesUrl = decodeFromAssetSpacesUrl;
+exports.encodeToAssetSpacesUrl = encodeToAssetSpacesUrl;
+//# sourceMappingURL=asset-spaces-url.cjs.map

package/dist/references/src/formats/uri/asset-spaces-url.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-spaces-url.cjs","sources":["../../../../../../references/src/formats/uri/asset-spaces-url.ts"],"sourcesContent":["import { parseAnchorFromParams } from '../../anchors/parse';\nimport { serializeAnchorToParams } from '../../anchors/serialize';\nimport type { AssetMeta, AssetReference } from '../../types';\nimport {\n  normalizeAssetReference,\n  parseVersionRefFromParams,\n  serializeVersionRefToParams,\n} from '../../version-ref';\nimport { unwrapTemplatePlaceholder } from './template-placeholder';\n\n/**\n * Decode: `/dashboard/spaces?asset_ids=X&...` → AssetReference\n */\nexport function decodeFromAssetSpacesUrl(url: URL): AssetReference {\n  const params = url.searchParams;\n\n  const id = unwrapTemplatePlaceholder(params.get('asset_ids') ?? '');\n  const anchor = parseAnchorFromParams(params);\n  const version = parseVersionRefFromParams(params);\n\n  const meta: AssetMeta = {};\n  const assetType = params.get('type') ?? params.get('asset_type');\n  if (assetType) meta.assetType = unwrapTemplatePlaceholder(assetType);\n\n  const excerpt = params.get('excerpt');\n  if (excerpt) meta.excerpt = excerpt;\n\n  const sheetName = params.get('sheet_name');\n  if (sheetName) meta.sheetName = sheetName;\n\n  const provider = params.get('provider');\n  if (provider) meta.provider = provider;\n\n  const providerLocation =\n    params.get('provider_location') || params.get('providerLocation');\n  if (providerLocation) meta.providerLocation = providerLocation;\n\n  const ref: AssetReference = { referenced: 'asset', id };\n  if (anchor) ref.anchor = anchor;\n  if (version) ref.version = version;\n  if (Object.keys(meta).length > 0) ref.meta = meta;\n\n  // `asset_ids=asset_x@ver` is the legacy spelling of `&version=ver`.\n  return normalizeAssetReference(ref);\n}\n\n/**\n * Encode: AssetReference → `/dashboard/spaces?asset_ids=X&...`\n */\nexport function encodeToAssetSpacesUrl(reference: AssetReference): string {\n  const ref = normalizeAssetReference(reference);\n  const params = new URLSearchParams();\n  params.set('asset_ids', ref.id);\n\n  if (ref.meta?.assetType) {\n    params.set('type', ref.meta.assetType);\n  }\n\n  if (ref.version) {\n    for (const [key, value] of serializeVersionRefToParams(ref.version)) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.anchor) {\n    const anchorParams = serializeAnchorToParams(ref.anchor);\n    for (const [key, value] of anchorParams) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.meta?.excerpt) {\n    params.set('excerpt', ref.meta.excerpt);\n  }\n\n  if (ref.meta?.sheetName) {\n    params.set('sheet_name', ref.meta.sheetName);\n  }\n\n  if (ref.meta?.provider) {\n    params.set('provider', ref.meta.provider);\n  }\n\n  if (ref.meta?.providerLocation) {\n    params.set('provider_location', ref.meta.providerLocation);\n  }\n\n  return `/dashboard/spaces?${params.toString()}`;\n}\n"],"names":["unwrapTemplatePlaceholder","parseAnchorFromParams","parseVersionRefFromParams","normalizeAssetReference","serializeVersionRefToParams","serializeAnchorToParams"],"mappings":";;;;;;AAaO,SAAS,yBAAyB,KAA0B;AACjE,QAAM,SAAS,IAAI;AAEnB,QAAM,KAAKA,oBAAAA,0BAA0B,OAAO,IAAI,WAAW,KAAK,EAAE;AAClE,QAAM,SAASC,MAAAA,sBAAsB,MAAM;AAC3C,QAAM,UAAUC,WAAAA,0BAA0B,MAAM;AAEhD,QAAM,OAAkB,CAAA;AACxB,QAAM,YAAY,OAAO,IAAI,MAAM,KAAK,OAAO,IAAI,YAAY;AAC/D,MAAI,UAAW,MAAK,YAAYF,oBAAAA,0BAA0B,SAAS;AAEnE,QAAM,UAAU,OAAO,IAAI,SAAS;AACpC,MAAI,cAAc,UAAU;AAE5B,QAAM,YAAY,OAAO,IAAI,YAAY;AACzC,MAAI,gBAAgB,YAAY;AAEhC,QAAM,WAAW,OAAO,IAAI,UAAU;AACtC,MAAI,eAAe,WAAW;AAE9B,QAAM,mBACJ,OAAO,IAAI,mBAAmB,KAAK,OAAO,IAAI,kBAAkB;AAClE,MAAI,uBAAuB,mBAAmB;AAE9C,QAAM,MAAsB,EAAE,YAAY,SAAS,GAAA;AACnD,MAAI,YAAY,SAAS;AACzB,MAAI,aAAa,UAAU;AAC3B,MAAI,OAAO,KAAK,IAAI,EAAE,SAAS,OAAO,OAAO;AAG7C,SAAOG,WAAAA,wBAAwB,GAAG;AACpC;AAKO,SAAS,uBAAuB,WAAmC;;AACxE,QAAM,MAAMA,WAAAA,wBAAwB,SAAS;AAC7C,QAAM,SAAS,IAAI,gBAAA;AACnB,SAAO,IAAI,aAAa,IAAI,EAAE;AAE9B,OAAI,SAAI,SAAJ,mBAAU,WAAW;AACvB,WAAO,IAAI,QAAQ,IAAI,KAAK,SAAS;AAAA,EACvC;AAEA,MAAI,IAAI,SAAS;AACf,eAAW,CAAC,KAAK,KAAK,KAAKC,WAAAA,4BAA4B,IAAI,OAAO,GAAG;AACnE,aAAO,IAAI,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AAEA,MAAI,IAAI,QAAQ;AACd,UAAM,eAAeC,UAAAA,wBAAwB,IAAI,MAAM;AACvD,eAAW,CAAC,KAAK,KAAK,KAAK,cAAc;AACvC,aAAO,IAAI,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AAEA,OAAI,SAAI,SAAJ,mBAAU,SAAS;AACrB,WAAO,IAAI,WAAW,IAAI,KAAK,OAAO;AAAA,EACxC;AAEA,OAAI,SAAI,SAAJ,mBAAU,WAAW;AACvB,WAAO,IAAI,cAAc,IAAI,KAAK,SAAS;AAAA,EAC7C;AAEA,OAAI,SAAI,SAAJ,mBAAU,UAAU;AACtB,WAAO,IAAI,YAAY,IAAI,KAAK,QAAQ;AAAA,EAC1C;AAEA,OAAI,SAAI,SAAJ,mBAAU,kBAAkB;AAC9B,WAAO,IAAI,qBAAqB,IAAI,KAAK,gBAAgB;AAAA,EAC3D;AAEA,SAAO,qBAAqB,OAAO,SAAA,CAAU;AAC/C;;;"}

package/dist/references/src/formats/uri/asset-spaces-url.js

@@ -0,0 +1,64 @@
+import { parseAnchorFromParams } from "../../anchors/parse.js";
+import { serializeAnchorToParams } from "../../anchors/serialize.js";
+import { parseVersionRefFromParams, normalizeAssetReference, serializeVersionRefToParams } from "../../version-ref.js";
+import { unwrapTemplatePlaceholder } from "./template-placeholder.js";
+function decodeFromAssetSpacesUrl(url) {
+  const params = url.searchParams;
+  const id = unwrapTemplatePlaceholder(params.get("asset_ids") ?? "");
+  const anchor = parseAnchorFromParams(params);
+  const version = parseVersionRefFromParams(params);
+  const meta = {};
+  const assetType = params.get("type") ?? params.get("asset_type");
+  if (assetType) meta.assetType = unwrapTemplatePlaceholder(assetType);
+  const excerpt = params.get("excerpt");
+  if (excerpt) meta.excerpt = excerpt;
+  const sheetName = params.get("sheet_name");
+  if (sheetName) meta.sheetName = sheetName;
+  const provider = params.get("provider");
+  if (provider) meta.provider = provider;
+  const providerLocation = params.get("provider_location") || params.get("providerLocation");
+  if (providerLocation) meta.providerLocation = providerLocation;
+  const ref = { referenced: "asset", id };
+  if (anchor) ref.anchor = anchor;
+  if (version) ref.version = version;
+  if (Object.keys(meta).length > 0) ref.meta = meta;
+  return normalizeAssetReference(ref);
+}
+function encodeToAssetSpacesUrl(reference) {
+  var _a, _b, _c, _d, _e;
+  const ref = normalizeAssetReference(reference);
+  const params = new URLSearchParams();
+  params.set("asset_ids", ref.id);
+  if ((_a = ref.meta) == null ? void 0 : _a.assetType) {
+    params.set("type", ref.meta.assetType);
+  }
+  if (ref.version) {
+    for (const [key, value] of serializeVersionRefToParams(ref.version)) {
+      params.set(key, value);
+    }
+  }
+  if (ref.anchor) {
+    const anchorParams = serializeAnchorToParams(ref.anchor);
+    for (const [key, value] of anchorParams) {
+      params.set(key, value);
+    }
+  }
+  if ((_b = ref.meta) == null ? void 0 : _b.excerpt) {
+    params.set("excerpt", ref.meta.excerpt);
+  }
+  if ((_c = ref.meta) == null ? void 0 : _c.sheetName) {
+    params.set("sheet_name", ref.meta.sheetName);
+  }
+  if ((_d = ref.meta) == null ? void 0 : _d.provider) {
+    params.set("provider", ref.meta.provider);
+  }
+  if ((_e = ref.meta) == null ? void 0 : _e.providerLocation) {
+    params.set("provider_location", ref.meta.providerLocation);
+  }
+  return `/dashboard/spaces?${params.toString()}`;
+}
+export {
+  decodeFromAssetSpacesUrl,
+  encodeToAssetSpacesUrl
+};
+//# sourceMappingURL=asset-spaces-url.js.map

package/dist/references/src/formats/uri/asset-spaces-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-spaces-url.js","sources":["../../../../../../references/src/formats/uri/asset-spaces-url.ts"],"sourcesContent":["import { parseAnchorFromParams } from '../../anchors/parse';\nimport { serializeAnchorToParams } from '../../anchors/serialize';\nimport type { AssetMeta, AssetReference } from '../../types';\nimport {\n  normalizeAssetReference,\n  parseVersionRefFromParams,\n  serializeVersionRefToParams,\n} from '../../version-ref';\nimport { unwrapTemplatePlaceholder } from './template-placeholder';\n\n/**\n * Decode: `/dashboard/spaces?asset_ids=X&...` → AssetReference\n */\nexport function decodeFromAssetSpacesUrl(url: URL): AssetReference {\n  const params = url.searchParams;\n\n  const id = unwrapTemplatePlaceholder(params.get('asset_ids') ?? '');\n  const anchor = parseAnchorFromParams(params);\n  const version = parseVersionRefFromParams(params);\n\n  const meta: AssetMeta = {};\n  const assetType = params.get('type') ?? params.get('asset_type');\n  if (assetType) meta.assetType = unwrapTemplatePlaceholder(assetType);\n\n  const excerpt = params.get('excerpt');\n  if (excerpt) meta.excerpt = excerpt;\n\n  const sheetName = params.get('sheet_name');\n  if (sheetName) meta.sheetName = sheetName;\n\n  const provider = params.get('provider');\n  if (provider) meta.provider = provider;\n\n  const providerLocation =\n    params.get('provider_location') || params.get('providerLocation');\n  if (providerLocation) meta.providerLocation = providerLocation;\n\n  const ref: AssetReference = { referenced: 'asset', id };\n  if (anchor) ref.anchor = anchor;\n  if (version) ref.version = version;\n  if (Object.keys(meta).length > 0) ref.meta = meta;\n\n  // `asset_ids=asset_x@ver` is the legacy spelling of `&version=ver`.\n  return normalizeAssetReference(ref);\n}\n\n/**\n * Encode: AssetReference → `/dashboard/spaces?asset_ids=X&...`\n */\nexport function encodeToAssetSpacesUrl(reference: AssetReference): string {\n  const ref = normalizeAssetReference(reference);\n  const params = new URLSearchParams();\n  params.set('asset_ids', ref.id);\n\n  if (ref.meta?.assetType) {\n    params.set('type', ref.meta.assetType);\n  }\n\n  if (ref.version) {\n    for (const [key, value] of serializeVersionRefToParams(ref.version)) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.anchor) {\n    const anchorParams = serializeAnchorToParams(ref.anchor);\n    for (const [key, value] of anchorParams) {\n      params.set(key, value);\n    }\n  }\n\n  if (ref.meta?.excerpt) {\n    params.set('excerpt', ref.meta.excerpt);\n  }\n\n  if (ref.meta?.sheetName) {\n    params.set('sheet_name', ref.meta.sheetName);\n  }\n\n  if (ref.meta?.provider) {\n    params.set('provider', ref.meta.provider);\n  }\n\n  if (ref.meta?.providerLocation) {\n    params.set('provider_location', ref.meta.providerLocation);\n  }\n\n  return `/dashboard/spaces?${params.toString()}`;\n}\n"],"names":[],"mappings":";;;;AAaO,SAAS,yBAAyB,KAA0B;AACjE,QAAM,SAAS,IAAI;AAEnB,QAAM,KAAK,0BAA0B,OAAO,IAAI,WAAW,KAAK,EAAE;AAClE,QAAM,SAAS,sBAAsB,MAAM;AAC3C,QAAM,UAAU,0BAA0B,MAAM;AAEhD,QAAM,OAAkB,CAAA;AACxB,QAAM,YAAY,OAAO,IAAI,MAAM,KAAK,OAAO,IAAI,YAAY;AAC/D,MAAI,UAAW,MAAK,YAAY,0BAA0B,SAAS;AAEnE,QAAM,UAAU,OAAO,IAAI,SAAS;AACpC,MAAI,cAAc,UAAU;AAE5B,QAAM,YAAY,OAAO,IAAI,YAAY;AACzC,MAAI,gBAAgB,YAAY;AAEhC,QAAM,WAAW,OAAO,IAAI,UAAU;AACtC,MAAI,eAAe,WAAW;AAE9B,QAAM,mBACJ,OAAO,IAAI,mBAAmB,KAAK,OAAO,IAAI,kBAAkB;AAClE,MAAI,uBAAuB,mBAAmB;AAE9C,QAAM,MAAsB,EAAE,YAAY,SAAS,GAAA;AACnD,MAAI,YAAY,SAAS;AACzB,MAAI,aAAa,UAAU;AAC3B,MAAI,OAAO,KAAK,IAAI,EAAE,SAAS,OAAO,OAAO;AAG7C,SAAO,wBAAwB,GAAG;AACpC;AAKO,SAAS,uBAAuB,WAAmC;;AACxE,QAAM,MAAM,wBAAwB,SAAS;AAC7C,QAAM,SAAS,IAAI,gBAAA;AACnB,SAAO,IAAI,aAAa,IAAI,EAAE;AAE9B,OAAI,SAAI,SAAJ,mBAAU,WAAW;AACvB,WAAO,IAAI,QAAQ,IAAI,KAAK,SAAS;AAAA,EACvC;AAEA,MAAI,IAAI,SAAS;AACf,eAAW,CAAC,KAAK,KAAK,KAAK,4BAA4B,IAAI,OAAO,GAAG;AACnE,aAAO,IAAI,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AAEA,MAAI,IAAI,QAAQ;AACd,UAAM,eAAe,wBAAwB,IAAI,MAAM;AACvD,eAAW,CAAC,KAAK,KAAK,KAAK,cAAc;AACvC,aAAO,IAAI,KAAK,KAAK;AAAA,IACvB;AAAA,EACF;AAEA,OAAI,SAAI,SAAJ,mBAAU,SAAS;AACrB,WAAO,IAAI,WAAW,IAAI,KAAK,OAAO;AAAA,EACxC;AAEA,OAAI,SAAI,SAAJ,mBAAU,WAAW;AACvB,WAAO,IAAI,cAAc,IAAI,KAAK,SAAS;AAAA,EAC7C;AAEA,OAAI,SAAI,SAAJ,mBAAU,UAAU;AACtB,WAAO,IAAI,YAAY,IAAI,KAAK,QAAQ;AAAA,EAC1C;AAEA,OAAI,SAAI,SAAJ,mBAAU,kBAAkB;AAC9B,WAAO,IAAI,qBAAqB,IAAI,KAAK,gBAAgB;AAAA,EAC3D;AAEA,SAAO,qBAAqB,OAAO,SAAA,CAAU;AAC/C;"}

package/dist/references/src/formats/uri/template-placeholder.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function unwrapTemplatePlaceholder(value) {
+  const match = /^\[([^[\],\s]+)\]$/.exec(value.trim());
+  if (!match || /^[A-Z][A-Z0-9_]*$/.test(match[1])) return value;
+  return match[1];
+}
+exports.unwrapTemplatePlaceholder = unwrapTemplatePlaceholder;
+//# sourceMappingURL=template-placeholder.cjs.map

package/dist/references/src/formats/uri/template-placeholder.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-placeholder.cjs","sources":["../../../../../../references/src/formats/uri/template-placeholder.ts"],"sourcesContent":["/**\n * Unwraps a query value an agent copied from a link template with the\n * template's brackets kept, e.g. `asset_ids=[asset_x]` from\n * `asset_ids=[ASSET_ID]`. Kept verbatim, the id never resolves and the mention\n * reads \"Asset Not Found\" for an asset that exists.\n *\n * Only a single bracketed token is unwrapped; anything containing a comma,\n * whitespace or nested brackets is returned unchanged. So is the template's own\n * placeholder (`[ASSET_ID]`, `[ASSET_TYPE]`): a prompt that teaches the link\n * template must read back exactly as written.\n */\nexport function unwrapTemplatePlaceholder(value: string): string {\n\tconst match = /^\\[([^[\\],\\s]+)\\]$/.exec(value.trim());\n\tif (!match || /^[A-Z][A-Z0-9_]*$/.test(match[1])) return value;\n\treturn match[1];\n}\n"],"names":[],"mappings":";;AAWO,SAAS,0BAA0B,OAAuB;AAChE,QAAM,QAAQ,qBAAqB,KAAK,MAAM,MAAM;AACpD,MAAI,CAAC,SAAS,oBAAoB,KAAK,MAAM,CAAC,CAAC,EAAG,QAAO;AACzD,SAAO,MAAM,CAAC;AACf;;"}

package/dist/references/src/formats/uri/template-placeholder.js

@@ -0,0 +1,9 @@
+function unwrapTemplatePlaceholder(value) {
+  const match = /^\[([^[\],\s]+)\]$/.exec(value.trim());
+  if (!match || /^[A-Z][A-Z0-9_]*$/.test(match[1])) return value;
+  return match[1];
+}
+export {
+  unwrapTemplatePlaceholder
+};
+//# sourceMappingURL=template-placeholder.js.map

package/dist/references/src/formats/uri/template-placeholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-placeholder.js","sources":["../../../../../../references/src/formats/uri/template-placeholder.ts"],"sourcesContent":["/**\n * Unwraps a query value an agent copied from a link template with the\n * template's brackets kept, e.g. `asset_ids=[asset_x]` from\n * `asset_ids=[ASSET_ID]`. Kept verbatim, the id never resolves and the mention\n * reads \"Asset Not Found\" for an asset that exists.\n *\n * Only a single bracketed token is unwrapped; anything containing a comma,\n * whitespace or nested brackets is returned unchanged. So is the template's own\n * placeholder (`[ASSET_ID]`, `[ASSET_TYPE]`): a prompt that teaches the link\n * template must read back exactly as written.\n */\nexport function unwrapTemplatePlaceholder(value: string): string {\n\tconst match = /^\\[([^[\\],\\s]+)\\]$/.exec(value.trim());\n\tif (!match || /^[A-Z][A-Z0-9_]*$/.test(match[1])) return value;\n\treturn match[1];\n}\n"],"names":[],"mappings":"AAWO,SAAS,0BAA0B,OAAuB;AAChE,QAAM,QAAQ,qBAAqB,KAAK,MAAM,MAAM;AACpD,MAAI,CAAC,SAAS,oBAAoB,KAAK,MAAM,CAAC,CAAC,EAAG,QAAO;AACzD,SAAO,MAAM,CAAC;AACf;"}

package/dist/references/src/sheet-name.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function quoteSheetName(name) {
+  if (/\s|[^a-zA-Z0-9]/.test(name)) {
+    return `'${name.replace(/'/g, "''")}'`;
+  }
+  return name;
+}
+exports.quoteSheetName = quoteSheetName;
+//# sourceMappingURL=sheet-name.cjs.map

package/dist/references/src/sheet-name.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-name.cjs","sources":["../../../../references/src/sheet-name.ts"],"sourcesContent":["/**\n * Quote a sheet name for Excel cross-sheet reference notation.\n *\n * A name that is not a bare run of ASCII letters and digits is wrapped in\n * single quotes with embedded apostrophes doubled, so `1. Form Factor SKUs`\n * renders as `'1. Form Factor SKUs'` and `O'Brien` as `'O''Brien'`. Mirrors\n * `sanitizeSheetName` in `@rowsncolumns/utils` (kept local so the citation\n * label formatter does not import the sheets engine).\n */\nexport function quoteSheetName(name: string): string {\n  if (/\\s|[^a-zA-Z0-9]/.test(name)) {\n    return `'${name.replace(/'/g, \"''\")}'`;\n  }\n  return name;\n}\n"],"names":[],"mappings":";;AASO,SAAS,eAAe,MAAsB;AACnD,MAAI,kBAAkB,KAAK,IAAI,GAAG;AAChC,WAAO,IAAI,KAAK,QAAQ,MAAM,IAAI,CAAC;AAAA,EACrC;AACA,SAAO;AACT;;"}

package/dist/references/src/sheet-name.js

@@ -0,0 +1,10 @@
+function quoteSheetName(name) {
+  if (/\s|[^a-zA-Z0-9]/.test(name)) {
+    return `'${name.replace(/'/g, "''")}'`;
+  }
+  return name;
+}
+export {
+  quoteSheetName
+};
+//# sourceMappingURL=sheet-name.js.map

package/dist/references/src/sheet-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-name.js","sources":["../../../../references/src/sheet-name.ts"],"sourcesContent":["/**\n * Quote a sheet name for Excel cross-sheet reference notation.\n *\n * A name that is not a bare run of ASCII letters and digits is wrapped in\n * single quotes with embedded apostrophes doubled, so `1. Form Factor SKUs`\n * renders as `'1. Form Factor SKUs'` and `O'Brien` as `'O''Brien'`. Mirrors\n * `sanitizeSheetName` in `@rowsncolumns/utils` (kept local so the citation\n * label formatter does not import the sheets engine).\n */\nexport function quoteSheetName(name: string): string {\n  if (/\\s|[^a-zA-Z0-9]/.test(name)) {\n    return `'${name.replace(/'/g, \"''\")}'`;\n  }\n  return name;\n}\n"],"names":[],"mappings":"AASO,SAAS,eAAe,MAAsB;AACnD,MAAI,kBAAkB,KAAK,IAAI,GAAG;AAChC,WAAO,IAAI,KAAK,QAAQ,MAAM,IAAI,CAAC;AAAA,EACrC;AACA,SAAO;AACT;"}

package/dist/references/src/version-ref.cjs

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const VERSION_PARAM = "version";
+const AS_OF_PARAM = "as_of";
+const KERYX_CLOCK_PARAM = "keryx_clock";
+const MOVING_ALIASES = /* @__PURE__ */ new Set(["latest", "live", "head"]);
+const VERSIONED_ASSET_ID = /^(asset_[^_@]+)@([A-Za-z0-9._-]+)$/;
+function splitVersionedAssetId(assetId) {
+  const match = VERSIONED_ASSET_ID.exec(assetId);
+  if (!match) return void 0;
+  return { baseId: match[1], version: match[2] };
+}
+function parseVersionRefFromParams(params) {
+  const versionId = params.get(VERSION_PARAM);
+  if (versionId && !MOVING_ALIASES.has(versionId.toLowerCase())) {
+    return { kind: "pinned", versionId };
+  }
+  if (versionId) {
+    return { kind: "latest" };
+  }
+  const asOf = params.get(AS_OF_PARAM);
+  if (asOf) {
+    const rawClock = params.get(KERYX_CLOCK_PARAM);
+    return rawClock != null && /^\d+$/.test(rawClock) ? { kind: "as_of", at: asOf, keryxClock: Number(rawClock) } : { kind: "as_of", at: asOf };
+  }
+  return void 0;
+}
+function serializeVersionRefToParams(version) {
+  const params = new URLSearchParams();
+  if (version.kind === "pinned") {
+    params.set(VERSION_PARAM, version.versionId);
+    return params;
+  }
+  if (version.kind === "as_of") {
+    params.set(AS_OF_PARAM, version.at);
+    if (version.keryxClock != null) {
+      params.set(KERYX_CLOCK_PARAM, String(version.keryxClock));
+    }
+  }
+  return params;
+}
+function normalizeAssetReference(ref) {
+  const split = splitVersionedAssetId(ref.id);
+  if (!split) return ref;
+  if (ref.version) {
+    return { ...ref, id: split.baseId };
+  }
+  if (MOVING_ALIASES.has(split.version.toLowerCase())) {
+    return { ...ref, id: split.baseId, version: { kind: "latest" } };
+  }
+  return {
+    ...ref,
+    id: split.baseId,
+    version: { kind: "pinned", versionId: split.version }
+  };
+}
+exports.normalizeAssetReference = normalizeAssetReference;
+exports.parseVersionRefFromParams = parseVersionRefFromParams;
+exports.serializeVersionRefToParams = serializeVersionRefToParams;
+exports.splitVersionedAssetId = splitVersionedAssetId;
+//# sourceMappingURL=version-ref.cjs.map

package/dist/references/src/version-ref.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-ref.cjs","sources":["../../../../references/src/version-ref.ts"],"sourcesContent":["/**\n * Asset version references — *which state* of a source a reference points at.\n *\n * An anchor says *where* in a document a reference points; a version ref says\n * *when*. Without one, an anchor silently re-resolves against whatever the\n * source says today, which is the drift problem versioned citations solve.\n *\n * The discriminator is `kind`, matching the shipped `VersionPolicy` in\n * `@athenaintel/source-binding` so the two stay one concept.\n */\n\nimport type { AssetReference, AssetVersionRef } from './types';\n\n/** Query param carrying a pinned version id (also the legacy spelling). */\nconst VERSION_PARAM = 'version';\n/** Query param carrying a point-in-time timestamp. */\nconst AS_OF_PARAM = 'as_of';\n/** Query param carrying the Keryx clock a point-in-time state maps to. */\nconst KERYX_CLOCK_PARAM = 'keryx_clock';\n\n/**\n * Version aliases that name a moving target rather than a fixed state.\n * `asset_x@latest` is an alias, not a pin — treating it as one would freeze a\n * reference that was explicitly asked to follow the document.\n */\nconst MOVING_ALIASES = new Set(['latest', 'live', 'head']);\n\n/**\n * Matches the legacy `asset_<id>@<version>` addressing form. The base must be a\n * plain `asset_<id>` — live-asset ids (`asset_<uuid>_<providerId>`, whose\n * provider-controlled segment may itself contain `@`) and thread ids\n * (`asset_thread_<uuid>`) are never versioned, mirroring agora's anchored\n * `_VERSIONED_ASSET_ID_PATTERN`.\n */\nconst VERSIONED_ASSET_ID = /^(asset_[^_@]+)@([A-Za-z0-9._-]+)$/;\n\n/** Split a legacy versioned asset id into its base id and version segment. */\nexport function splitVersionedAssetId(\n  assetId: string\n): { baseId: string; version: string } | undefined {\n  const match = VERSIONED_ASSET_ID.exec(assetId);\n  if (!match) return undefined;\n  return { baseId: match[1], version: match[2] };\n}\n\n/** Decode a version ref from URL params, or `undefined` when unversioned. */\nexport function parseVersionRefFromParams(\n  params: URLSearchParams\n): AssetVersionRef | undefined {\n  const versionId = params.get(VERSION_PARAM);\n  if (versionId && !MOVING_ALIASES.has(versionId.toLowerCase())) {\n    return { kind: 'pinned', versionId };\n  }\n  if (versionId) {\n    return { kind: 'latest' };\n  }\n\n  const asOf = params.get(AS_OF_PARAM);\n  if (asOf) {\n    // Digits-only, mirroring the Python codec's `int()` — `Number('')` is 0 and\n    // `Number()` accepts floats/hex, which would decode to a clock the other\n    // side rejects.\n    const rawClock = params.get(KERYX_CLOCK_PARAM);\n    return rawClock != null && /^\\d+$/.test(rawClock)\n      ? { kind: 'as_of', at: asOf, keryxClock: Number(rawClock) }\n      : { kind: 'as_of', at: asOf };\n  }\n\n  return undefined;\n}\n\n/** Encode a version ref to URL params. `latest` is the default, so it is a no-op. */\nexport function serializeVersionRefToParams(version: AssetVersionRef): URLSearchParams {\n  const params = new URLSearchParams();\n\n  if (version.kind === 'pinned') {\n    params.set(VERSION_PARAM, version.versionId);\n    return params;\n  }\n\n  if (version.kind === 'as_of') {\n    params.set(AS_OF_PARAM, version.at);\n    if (version.keryxClock != null) {\n      params.set(KERYX_CLOCK_PARAM, String(version.keryxClock));\n    }\n  }\n\n  return params;\n}\n\n/**\n * Move a legacy `id@versionId` into the `version` field, leaving `id` a plain\n * asset id. Callers can then read `ref.version` instead of re-deriving it with\n * `id.split('@')`, which is how versions got silently dropped.\n *\n * Already-normalized references and unversioned ids pass through untouched.\n */\nexport function normalizeAssetReference(ref: AssetReference): AssetReference {\n  const split = splitVersionedAssetId(ref.id);\n  if (!split) return ref;\n\n  // An explicit `version` wins — the id suffix is the legacy spelling of it.\n  if (ref.version) {\n    return { ...ref, id: split.baseId };\n  }\n\n  if (MOVING_ALIASES.has(split.version.toLowerCase())) {\n    return { ...ref, id: split.baseId, version: { kind: 'latest' } };\n  }\n\n  return {\n    ...ref,\n    id: split.baseId,\n    version: { kind: 'pinned', versionId: split.version },\n  };\n}\n\n/** The pinned version id a reference resolves to, if it names a fixed state. */\nexport function getPinnedVersionId(ref: AssetReference): string | undefined {\n  const normalized = normalizeAssetReference(ref);\n  return normalized.version?.kind === 'pinned' ? normalized.version.versionId : undefined;\n}\n"],"names":[],"mappings":";;AAcA,MAAM,gBAAgB;AAEtB,MAAM,cAAc;AAEpB,MAAM,oBAAoB;AAO1B,MAAM,iBAAiB,oBAAI,IAAI,CAAC,UAAU,QAAQ,MAAM,CAAC;AASzD,MAAM,qBAAqB;AAGpB,SAAS,sBACd,SACiD;AACjD,QAAM,QAAQ,mBAAmB,KAAK,OAAO;AAC7C,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,EAAE,QAAQ,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,EAAA;AAC7C;AAGO,SAAS,0BACd,QAC6B;AAC7B,QAAM,YAAY,OAAO,IAAI,aAAa;AAC1C,MAAI,aAAa,CAAC,eAAe,IAAI,UAAU,YAAA,CAAa,GAAG;AAC7D,WAAO,EAAE,MAAM,UAAU,UAAA;AAAA,EAC3B;AACA,MAAI,WAAW;AACb,WAAO,EAAE,MAAM,SAAA;AAAA,EACjB;AAEA,QAAM,OAAO,OAAO,IAAI,WAAW;AACnC,MAAI,MAAM;AAIR,UAAM,WAAW,OAAO,IAAI,iBAAiB;AAC7C,WAAO,YAAY,QAAQ,QAAQ,KAAK,QAAQ,IAC5C,EAAE,MAAM,SAAS,IAAI,MAAM,YAAY,OAAO,QAAQ,EAAA,IACtD,EAAE,MAAM,SAAS,IAAI,KAAA;AAAA,EAC3B;AAEA,SAAO;AACT;AAGO,SAAS,4BAA4B,SAA2C;AACrF,QAAM,SAAS,IAAI,gBAAA;AAEnB,MAAI,QAAQ,SAAS,UAAU;AAC7B,WAAO,IAAI,eAAe,QAAQ,SAAS;AAC3C,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,SAAS,SAAS;AAC5B,WAAO,IAAI,aAAa,QAAQ,EAAE;AAClC,QAAI,QAAQ,cAAc,MAAM;AAC9B,aAAO,IAAI,mBAAmB,OAAO,QAAQ,UAAU,CAAC;AAAA,IAC1D;AAAA,EACF;AAEA,SAAO;AACT;AASO,SAAS,wBAAwB,KAAqC;AAC3E,QAAM,QAAQ,sBAAsB,IAAI,EAAE;AAC1C,MAAI,CAAC,MAAO,QAAO;AAGnB,MAAI,IAAI,SAAS;AACf,WAAO,EAAE,GAAG,KAAK,IAAI,MAAM,OAAA;AAAA,EAC7B;AAEA,MAAI,eAAe,IAAI,MAAM,QAAQ,YAAA,CAAa,GAAG;AACnD,WAAO,EAAE,GAAG,KAAK,IAAI,MAAM,QAAQ,SAAS,EAAE,MAAM,WAAS;AAAA,EAC/D;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,MAAM;AAAA,IACV,SAAS,EAAE,MAAM,UAAU,WAAW,MAAM,QAAA;AAAA,EAAQ;AAExD;;;;;"}

package/dist/references/src/version-ref.js

@@ -0,0 +1,61 @@
+const VERSION_PARAM = "version";
+const AS_OF_PARAM = "as_of";
+const KERYX_CLOCK_PARAM = "keryx_clock";
+const MOVING_ALIASES = /* @__PURE__ */ new Set(["latest", "live", "head"]);
+const VERSIONED_ASSET_ID = /^(asset_[^_@]+)@([A-Za-z0-9._-]+)$/;
+function splitVersionedAssetId(assetId) {
+  const match = VERSIONED_ASSET_ID.exec(assetId);
+  if (!match) return void 0;
+  return { baseId: match[1], version: match[2] };
+}
+function parseVersionRefFromParams(params) {
+  const versionId = params.get(VERSION_PARAM);
+  if (versionId && !MOVING_ALIASES.has(versionId.toLowerCase())) {
+    return { kind: "pinned", versionId };
+  }
+  if (versionId) {
+    return { kind: "latest" };
+  }
+  const asOf = params.get(AS_OF_PARAM);
+  if (asOf) {
+    const rawClock = params.get(KERYX_CLOCK_PARAM);
+    return rawClock != null && /^\d+$/.test(rawClock) ? { kind: "as_of", at: asOf, keryxClock: Number(rawClock) } : { kind: "as_of", at: asOf };
+  }
+  return void 0;
+}
+function serializeVersionRefToParams(version) {
+  const params = new URLSearchParams();
+  if (version.kind === "pinned") {
+    params.set(VERSION_PARAM, version.versionId);
+    return params;
+  }
+  if (version.kind === "as_of") {
+    params.set(AS_OF_PARAM, version.at);
+    if (version.keryxClock != null) {
+      params.set(KERYX_CLOCK_PARAM, String(version.keryxClock));
+    }
+  }
+  return params;
+}
+function normalizeAssetReference(ref) {
+  const split = splitVersionedAssetId(ref.id);
+  if (!split) return ref;
+  if (ref.version) {
+    return { ...ref, id: split.baseId };
+  }
+  if (MOVING_ALIASES.has(split.version.toLowerCase())) {
+    return { ...ref, id: split.baseId, version: { kind: "latest" } };
+  }
+  return {
+    ...ref,
+    id: split.baseId,
+    version: { kind: "pinned", versionId: split.version }
+  };
+}
+export {
+  normalizeAssetReference,
+  parseVersionRefFromParams,
+  serializeVersionRefToParams,
+  splitVersionedAssetId
+};
+//# sourceMappingURL=version-ref.js.map

package/dist/references/src/version-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-ref.js","sources":["../../../../references/src/version-ref.ts"],"sourcesContent":["/**\n * Asset version references — *which state* of a source a reference points at.\n *\n * An anchor says *where* in a document a reference points; a version ref says\n * *when*. Without one, an anchor silently re-resolves against whatever the\n * source says today, which is the drift problem versioned citations solve.\n *\n * The discriminator is `kind`, matching the shipped `VersionPolicy` in\n * `@athenaintel/source-binding` so the two stay one concept.\n */\n\nimport type { AssetReference, AssetVersionRef } from './types';\n\n/** Query param carrying a pinned version id (also the legacy spelling). */\nconst VERSION_PARAM = 'version';\n/** Query param carrying a point-in-time timestamp. */\nconst AS_OF_PARAM = 'as_of';\n/** Query param carrying the Keryx clock a point-in-time state maps to. */\nconst KERYX_CLOCK_PARAM = 'keryx_clock';\n\n/**\n * Version aliases that name a moving target rather than a fixed state.\n * `asset_x@latest` is an alias, not a pin — treating it as one would freeze a\n * reference that was explicitly asked to follow the document.\n */\nconst MOVING_ALIASES = new Set(['latest', 'live', 'head']);\n\n/**\n * Matches the legacy `asset_<id>@<version>` addressing form. The base must be a\n * plain `asset_<id>` — live-asset ids (`asset_<uuid>_<providerId>`, whose\n * provider-controlled segment may itself contain `@`) and thread ids\n * (`asset_thread_<uuid>`) are never versioned, mirroring agora's anchored\n * `_VERSIONED_ASSET_ID_PATTERN`.\n */\nconst VERSIONED_ASSET_ID = /^(asset_[^_@]+)@([A-Za-z0-9._-]+)$/;\n\n/** Split a legacy versioned asset id into its base id and version segment. */\nexport function splitVersionedAssetId(\n  assetId: string\n): { baseId: string; version: string } | undefined {\n  const match = VERSIONED_ASSET_ID.exec(assetId);\n  if (!match) return undefined;\n  return { baseId: match[1], version: match[2] };\n}\n\n/** Decode a version ref from URL params, or `undefined` when unversioned. */\nexport function parseVersionRefFromParams(\n  params: URLSearchParams\n): AssetVersionRef | undefined {\n  const versionId = params.get(VERSION_PARAM);\n  if (versionId && !MOVING_ALIASES.has(versionId.toLowerCase())) {\n    return { kind: 'pinned', versionId };\n  }\n  if (versionId) {\n    return { kind: 'latest' };\n  }\n\n  const asOf = params.get(AS_OF_PARAM);\n  if (asOf) {\n    // Digits-only, mirroring the Python codec's `int()` — `Number('')` is 0 and\n    // `Number()` accepts floats/hex, which would decode to a clock the other\n    // side rejects.\n    const rawClock = params.get(KERYX_CLOCK_PARAM);\n    return rawClock != null && /^\\d+$/.test(rawClock)\n      ? { kind: 'as_of', at: asOf, keryxClock: Number(rawClock) }\n      : { kind: 'as_of', at: asOf };\n  }\n\n  return undefined;\n}\n\n/** Encode a version ref to URL params. `latest` is the default, so it is a no-op. */\nexport function serializeVersionRefToParams(version: AssetVersionRef): URLSearchParams {\n  const params = new URLSearchParams();\n\n  if (version.kind === 'pinned') {\n    params.set(VERSION_PARAM, version.versionId);\n    return params;\n  }\n\n  if (version.kind === 'as_of') {\n    params.set(AS_OF_PARAM, version.at);\n    if (version.keryxClock != null) {\n      params.set(KERYX_CLOCK_PARAM, String(version.keryxClock));\n    }\n  }\n\n  return params;\n}\n\n/**\n * Move a legacy `id@versionId` into the `version` field, leaving `id` a plain\n * asset id. Callers can then read `ref.version` instead of re-deriving it with\n * `id.split('@')`, which is how versions got silently dropped.\n *\n * Already-normalized references and unversioned ids pass through untouched.\n */\nexport function normalizeAssetReference(ref: AssetReference): AssetReference {\n  const split = splitVersionedAssetId(ref.id);\n  if (!split) return ref;\n\n  // An explicit `version` wins — the id suffix is the legacy spelling of it.\n  if (ref.version) {\n    return { ...ref, id: split.baseId };\n  }\n\n  if (MOVING_ALIASES.has(split.version.toLowerCase())) {\n    return { ...ref, id: split.baseId, version: { kind: 'latest' } };\n  }\n\n  return {\n    ...ref,\n    id: split.baseId,\n    version: { kind: 'pinned', versionId: split.version },\n  };\n}\n\n/** The pinned version id a reference resolves to, if it names a fixed state. */\nexport function getPinnedVersionId(ref: AssetReference): string | undefined {\n  const normalized = normalizeAssetReference(ref);\n  return normalized.version?.kind === 'pinned' ? normalized.version.versionId : undefined;\n}\n"],"names":[],"mappings":"AAcA,MAAM,gBAAgB;AAEtB,MAAM,cAAc;AAEpB,MAAM,oBAAoB;AAO1B,MAAM,iBAAiB,oBAAI,IAAI,CAAC,UAAU,QAAQ,MAAM,CAAC;AASzD,MAAM,qBAAqB;AAGpB,SAAS,sBACd,SACiD;AACjD,QAAM,QAAQ,mBAAmB,KAAK,OAAO;AAC7C,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,EAAE,QAAQ,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,EAAA;AAC7C;AAGO,SAAS,0BACd,QAC6B;AAC7B,QAAM,YAAY,OAAO,IAAI,aAAa;AAC1C,MAAI,aAAa,CAAC,eAAe,IAAI,UAAU,YAAA,CAAa,GAAG;AAC7D,WAAO,EAAE,MAAM,UAAU,UAAA;AAAA,EAC3B;AACA,MAAI,WAAW;AACb,WAAO,EAAE,MAAM,SAAA;AAAA,EACjB;AAEA,QAAM,OAAO,OAAO,IAAI,WAAW;AACnC,MAAI,MAAM;AAIR,UAAM,WAAW,OAAO,IAAI,iBAAiB;AAC7C,WAAO,YAAY,QAAQ,QAAQ,KAAK,QAAQ,IAC5C,EAAE,MAAM,SAAS,IAAI,MAAM,YAAY,OAAO,QAAQ,EAAA,IACtD,EAAE,MAAM,SAAS,IAAI,KAAA;AAAA,EAC3B;AAEA,SAAO;AACT;AAGO,SAAS,4BAA4B,SAA2C;AACrF,QAAM,SAAS,IAAI,gBAAA;AAEnB,MAAI,QAAQ,SAAS,UAAU;AAC7B,WAAO,IAAI,eAAe,QAAQ,SAAS;AAC3C,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,SAAS,SAAS;AAC5B,WAAO,IAAI,aAAa,QAAQ,EAAE;AAClC,QAAI,QAAQ,cAAc,MAAM;AAC9B,aAAO,IAAI,mBAAmB,OAAO,QAAQ,UAAU,CAAC;AAAA,IAC1D;AAAA,EACF;AAEA,SAAO;AACT;AASO,SAAS,wBAAwB,KAAqC;AAC3E,QAAM,QAAQ,sBAAsB,IAAI,EAAE;AAC1C,MAAI,CAAC,MAAO,QAAO;AAGnB,MAAI,IAAI,SAAS;AACf,WAAO,EAAE,GAAG,KAAK,IAAI,MAAM,OAAA;AAAA,EAC7B;AAEA,MAAI,eAAe,IAAI,MAAM,QAAQ,YAAA,CAAa,GAAG;AACnD,WAAO,EAAE,GAAG,KAAK,IAAI,MAAM,QAAQ,SAAS,EAAE,MAAM,WAAS;AAAA,EAC/D;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,MAAM;AAAA,IACV,SAAS,EAAE,MAAM,UAAU,WAAW,MAAM,QAAA;AAAA,EAAQ;AAExD;"}