@aglyn/plugins-data 1.0.0-beta.219 → 1.0.0-beta.221

package/src/lib/model/dataset-record.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginIndexedRecord } from '@aglyn/aglyn/plugin-manager/plugin-record-index';
+/**
+ * One stored dataset as this plugin shares it with another (AGL-3080) — the
+ * one shape its server index (`dataset-record-index.ts`) and its console list
+ * source (`dataset-record-list.ts`) both answer, so a reader on either side
+ * reads the same record.
+ *
+ * `null` for a deleted dataset. Otherwise its id, its name as the Data page
+ * shows it, and `facts`:
+ *   `fields` — its fields in the dataset page's order, each
+ *   `{ id, name, type }`; `visibleTo` — the scope tokens it is shared
+ *   with, so a reader acting for a member can apply the platform's own
+ *   visibility rule to them; and `installedFrom` — `{ listingId, version }`
+ *   for a dataset installed from a listing (`version` as the install
+ *   stamped it), `null` for one the workspace made. Never a record of it.
+ */
+export declare function datasetIndexedRecord(id: string, data: Readonly<Record<string, unknown>> | undefined): PluginIndexedRecord | null;

package/src/lib/model/dataset-record.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { effectiveDatasetModel } from "@aglyn/aglyn/app-utils/dataset-models";
+import { datasetDisplayName } from "@aglyn/aglyn/app-utils/datasets";
+/**
+ * One stored dataset as this plugin shares it with another (AGL-3080) — the
+ * one shape its server index (`dataset-record-index.ts`) and its console list
+ * source (`dataset-record-list.ts`) both answer, so a reader on either side
+ * reads the same record.
+ *
+ * `null` for a deleted dataset. Otherwise its id, its name as the Data page
+ * shows it, and `facts`:
+ *   `fields` — its fields in the dataset page's order, each
+ *   `{ id, name, type }`; `visibleTo` — the scope tokens it is shared
+ *   with, so a reader acting for a member can apply the platform's own
+ *   visibility rule to them; and `installedFrom` — `{ listingId, version }`
+ *   for a dataset installed from a listing (`version` as the install
+ *   stamped it), `null` for one the workspace made. Never a record of it.
+ */ export function datasetIndexedRecord(id, data) {
+    if (!data || data['deletedAt'] != null) return null;
+    const model = effectiveDatasetModel(data);
+    const text = (value)=>typeof value === 'string' ? value.trim() : '';
+    return {
+        id,
+        name: datasetDisplayName(data) || id,
+        facts: {
+            fields: model.order.map((fieldId)=>{
+                var _ref;
+                var _model_fields_fieldId, _model_fields_fieldId1;
+                return {
+                    id: fieldId,
+                    name: text((_model_fields_fieldId = model.fields[fieldId]) == null ? void 0 : _model_fields_fieldId.name) || fieldId,
+                    type: String((_ref = (_model_fields_fieldId1 = model.fields[fieldId]) == null ? void 0 : _model_fields_fieldId1.type) != null ? _ref : 'text')
+                };
+            }),
+            visibleTo: Array.isArray(data['visibleTo']) ? data['visibleTo'] : [],
+            installedFrom: installedFrom(data['source'])
+        }
+    };
+}
+/**
+ * Where an installed dataset came from. Read from its `source` stamp, which
+ * every dataset install has written — the ones from before install
+ * provenance (AGL-1015) included, which carry no `installedFrom`.
+ */ function installedFrom(source) {
+    var _stamp_version;
+    const stamp = source != null ? source : {};
+    const listingId = typeof stamp['listingId'] === 'string' ? stamp['listingId'] : '';
+    return listingId ? {
+        listingId,
+        version: (_stamp_version = stamp['version']) != null ? _stamp_version : null
+    } : null;
+}
+
+//# sourceMappingURL=dataset-record.js.map

package/src/lib/model/dataset-record.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/data/src/lib/model/dataset-record.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { effectiveDatasetModel, type DatasetModel } from '@aglyn/aglyn/app-utils/dataset-models'\nimport { datasetDisplayName } from '@aglyn/aglyn/app-utils/datasets'\nimport type { PluginIndexedRecord } from '@aglyn/aglyn/plugin-manager/plugin-record-index'\n\n/**\n * One stored dataset as this plugin shares it with another (AGL-3080) — the\n * one shape its server index (`dataset-record-index.ts`) and its console list\n * source (`dataset-record-list.ts`) both answer, so a reader on either side\n * reads the same record.\n *\n * `null` for a deleted dataset. Otherwise its id, its name as the Data page\n * shows it, and `facts`:\n *   `fields` — its fields in the dataset page's order, each\n *   `{ id, name, type }`; `visibleTo` — the scope tokens it is shared\n *   with, so a reader acting for a member can apply the platform's own\n *   visibility rule to them; and `installedFrom` — `{ listingId, version }`\n *   for a dataset installed from a listing (`version` as the install\n *   stamped it), `null` for one the workspace made. Never a record of it.\n */\nexport function datasetIndexedRecord(\n  id: string,\n  data: Readonly<Record<string, unknown>> | undefined,\n): PluginIndexedRecord | null {\n  if (!data || data['deletedAt'] != null) return null\n  const model = effectiveDatasetModel(data as { model?: DatasetModel; fields?: string[] })\n  const text = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n  return {\n    id,\n    name: datasetDisplayName(data) || id,\n    facts: {\n      fields: model.order.map((fieldId) => ({\n        id: fieldId,\n        name: text(model.fields[fieldId]?.name) || fieldId,\n        type: String(model.fields[fieldId]?.type ?? 'text'),\n      })),\n      visibleTo: Array.isArray(data['visibleTo']) ? (data['visibleTo'] as string[]) : [],\n      installedFrom: installedFrom(data['source']),\n    },\n  }\n}\n\n/**\n * Where an installed dataset came from. Read from its `source` stamp, which\n * every dataset install has written — the ones from before install\n * provenance (AGL-1015) included, which carry no `installedFrom`.\n */\nfunction installedFrom(source: unknown): { listingId: string; version: unknown } | null {\n  const stamp = (source ?? {}) as Record<string, unknown>\n  const listingId = typeof stamp['listingId'] === 'string' ? stamp['listingId'] : ''\n  return listingId ? { listingId, version: stamp['version'] ?? null } : null\n}\n"],"names":["effectiveDatasetModel","datasetDisplayName","datasetIndexedRecord","id","data","model","text","value","trim","name","facts","fields","order","map","fieldId","type","String","visibleTo","Array","isArray","installedFrom","source","stamp","listingId","version"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,qBAAqB,QAA2B,wCAAuC;AAChG,SAASC,kBAAkB,QAAQ,kCAAiC;AAGpE;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,qBACdC,EAAU,EACVC,IAAmD;IAEnD,IAAI,CAACA,QAAQA,IAAI,CAAC,YAAY,IAAI,MAAM,OAAO;IAC/C,MAAMC,QAAQL,sBAAsBI;IACpC,MAAME,OAAO,CAACC,QAA4B,OAAOA,UAAU,WAAWA,MAAMC,IAAI,KAAK;IACrF,OAAO;QACLL;QACAM,MAAMR,mBAAmBG,SAASD;QAClCO,OAAO;YACLC,QAAQN,MAAMO,KAAK,CAACC,GAAG,CAAC,CAACC;;oBAEZT,uBACEA;uBAHuB;oBACpCF,IAAIW;oBACJL,MAAMH,MAAKD,wBAAAA,MAAMM,MAAM,CAACG,QAAQ,qBAArBT,sBAAuBI,IAAI,KAAKK;oBAC3CC,MAAMC,gBAAOX,yBAAAA,MAAMM,MAAM,CAACG,QAAQ,qBAArBT,uBAAuBU,IAAI,mBAAI;gBAC9C;;YACAE,WAAWC,MAAMC,OAAO,CAACf,IAAI,CAAC,YAAY,IAAKA,IAAI,CAAC,YAAY,GAAgB,EAAE;YAClFgB,eAAeA,cAAchB,IAAI,CAAC,SAAS;QAC7C;IACF;AACF;AAEA;;;;CAIC,GACD,SAASgB,cAAcC,MAAe;QAGKC;IAFzC,MAAMA,QAASD,iBAAAA,SAAU,CAAC;IAC1B,MAAME,YAAY,OAAOD,KAAK,CAAC,YAAY,KAAK,WAAWA,KAAK,CAAC,YAAY,GAAG;IAChF,OAAOC,YAAY;QAAEA;QAAWC,OAAO,GAAEF,iBAAAA,KAAK,CAAC,UAAU,YAAhBA,iBAAoB;IAAK,IAAI;AACxE"}

package/src/lib/plugin.js

@@ -19,6 +19,7 @@ import { registerRepeatSource } from "@aglyn/aglyn/app-utils/repeat-sources";
 import { mdiDatabaseOutline } from "@aglyn/shared-data-mdi";
 import { lazy } from "react";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
+import { registerDatasetRecordList } from "./model/dataset-record-list.js";
 import { DATASET_REPEAT_SOURCE } from "./repeat/dataset-repeat-source.js";
 /** Code-split: the Data console page only loads when opened. */ const DataConsolePage = lazy(()=>import("./components/data-console-page.js"));
 /**
@@ -38,6 +39,8 @@ import { DATASET_REPEAT_SOURCE } from "./repeat/dataset-repeat-source.js";
  * imported only to run one (AGL-3025).
  */ export function registerDataConsole() {
     registerRepeatSource(DATASET_REPEAT_SOURCE);
+    // The workspace's datasets, for another plugin's picker (AGL-3080).
+    registerDatasetRecordList();
     Aglyn.registerConsoleExtension({
         // Org datasets card (AGL-419): org/data renders it through the
         // 'orgData' widget slot.

package/src/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/data/src/lib/plugin.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport HostDatasetsCard from './components/host-datasets-card.component'\nimport * as Aglyn from '@aglyn/aglyn'\nimport { registerRepeatSource } from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { mdiDatabaseOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { DATASET_REPEAT_SOURCE } from './repeat/dataset-repeat-source'\n\n/** Code-split: the Data console page only loads when opened. */\nconst DataConsolePage = lazy(() => import('./components/data-console-page'))\n\n/**\n * Data feature plugin (AGL-395). Console-only — datasets are org-shared\n * document collections consumed by repeatable components at render time\n * through binding resolution, not a canvas element of their own, so there\n * is no UI bundle. The console half declares the host Data nav + page\n * through the ConsoleExtension registry, gated by the `dataStore`\n * entitlement. The org Data page (`Route.ORG_DATA`) is an org-scoped app route\n * that imports {@link HostDatasetsCard} directly.\n *\n * It also registers datasets as a repeat source (AGL-3111), which is what puts\n * \"Repeat over dataset\" on every element's Attributes panel and draws a\n * repeat's copies from the real rows on the besigner canvas. Registered here,\n * inside the function the loader calls by name, and never by a module's own\n * load: this package declares no side effects, so a bundler deletes a module\n * imported only to run one (AGL-3025).\n */\nexport function registerDataConsole(): void {\n  registerRepeatSource(DATASET_REPEAT_SOURCE)\n  Aglyn.registerConsoleExtension({\n    // Org datasets card (AGL-419): org/data renders it through the\n    // 'orgData' widget slot.\n    widgets: [\n      {\n        slot: 'orgData',\n        widgetId: 'data-org-datasets',\n        Component: HostDatasetsCard,\n      },\n    ],\n    pluginId: BUNDLE_ID,\n    displayName: 'Data',\n    featureFlag: 'dataStore',\n    navItems: [\n      {\n        label: 'Data',\n        href: '/data',\n        // Reuse the existing release-flag nav-tab so staff-preview gating is\n        // unchanged now that the tab comes from the plugin (AGL-395).\n        navTabId: 'nav-tab-data',\n        icon: { path: mdiDatabaseOutline.path },\n        header: {\n          title: 'Data',\n          icon: { path: mdiDatabaseOutline.path },\n          docsTopic: 'datasets',\n        },\n        Component: DataConsolePage,\n      },\n    ],\n  })\n}\n\nexport { default as HostDatasetsCard } from './components/host-datasets-card.component'\nexport type { HostDatasetsCardProps } from './components/host-datasets-card.component'\n"],"names":["HostDatasetsCard","Aglyn","registerRepeatSource","mdiDatabaseOutline","lazy","BUNDLE_ID","DATASET_REPEAT_SOURCE","DataConsolePage","registerDataConsole","registerConsoleExtension","widgets","slot","widgetId","Component","pluginId","displayName","featureFlag","navItems","label","href","navTabId","icon","path","header","title","docsTopic","default"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,sBAAsB,+CAA2C;AACxE,YAAYC,WAAW,eAAc;AACrC,SAASC,oBAAoB,QAAQ,wCAAuC;AAC5E,SAASC,kBAAkB,QAAQ,yBAAwB;AAC3D,SAASC,IAAI,QAAQ,QAAO;AAC5B,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,qBAAqB,QAAQ,oCAAgC;AAEtE,8DAA8D,GAC9D,MAAMC,kBAAkBH,KAAK,IAAM,MAAM,CAAC;AAE1C;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASI;IACdN,qBAAqBI;IACrBL,MAAMQ,wBAAwB,CAAC;QAC7B,+DAA+D;QAC/D,yBAAyB;QACzBC,SAAS;YACP;gBACEC,MAAM;gBACNC,UAAU;gBACVC,WAAWb;YACb;SACD;QACDc,UAAUT;QACVU,aAAa;QACbC,aAAa;QACbC,UAAU;YACR;gBACEC,OAAO;gBACPC,MAAM;gBACN,qEAAqE;gBACrE,8DAA8D;gBAC9DC,UAAU;gBACVC,MAAM;oBAAEC,MAAMnB,mBAAmBmB,IAAI;gBAAC;gBACtCC,QAAQ;oBACNC,OAAO;oBACPH,MAAM;wBAAEC,MAAMnB,mBAAmBmB,IAAI;oBAAC;oBACtCG,WAAW;gBACb;gBACAZ,WAAWN;YACb;SACD;IACH;AACF;AAEA,SAASmB,WAAW1B,gBAAgB,QAAQ,+CAA2C"}
+{"version":3,"sources":["../../../../../../libs/plugins/data/src/lib/plugin.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport HostDatasetsCard from './components/host-datasets-card.component'\nimport * as Aglyn from '@aglyn/aglyn'\nimport { registerRepeatSource } from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { mdiDatabaseOutline } from '@aglyn/shared-data-mdi'\nimport { lazy } from 'react'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { registerDatasetRecordList } from './model/dataset-record-list'\nimport { DATASET_REPEAT_SOURCE } from './repeat/dataset-repeat-source'\n\n/** Code-split: the Data console page only loads when opened. */\nconst DataConsolePage = lazy(() => import('./components/data-console-page'))\n\n/**\n * Data feature plugin (AGL-395). Console-only — datasets are org-shared\n * document collections consumed by repeatable components at render time\n * through binding resolution, not a canvas element of their own, so there\n * is no UI bundle. The console half declares the host Data nav + page\n * through the ConsoleExtension registry, gated by the `dataStore`\n * entitlement. The org Data page (`Route.ORG_DATA`) is an org-scoped app route\n * that imports {@link HostDatasetsCard} directly.\n *\n * It also registers datasets as a repeat source (AGL-3111), which is what puts\n * \"Repeat over dataset\" on every element's Attributes panel and draws a\n * repeat's copies from the real rows on the besigner canvas. Registered here,\n * inside the function the loader calls by name, and never by a module's own\n * load: this package declares no side effects, so a bundler deletes a module\n * imported only to run one (AGL-3025).\n */\nexport function registerDataConsole(): void {\n  registerRepeatSource(DATASET_REPEAT_SOURCE)\n  // The workspace's datasets, for another plugin's picker (AGL-3080).\n  registerDatasetRecordList()\n  Aglyn.registerConsoleExtension({\n    // Org datasets card (AGL-419): org/data renders it through the\n    // 'orgData' widget slot.\n    widgets: [\n      {\n        slot: 'orgData',\n        widgetId: 'data-org-datasets',\n        Component: HostDatasetsCard,\n      },\n    ],\n    pluginId: BUNDLE_ID,\n    displayName: 'Data',\n    featureFlag: 'dataStore',\n    navItems: [\n      {\n        label: 'Data',\n        href: '/data',\n        // Reuse the existing release-flag nav-tab so staff-preview gating is\n        // unchanged now that the tab comes from the plugin (AGL-395).\n        navTabId: 'nav-tab-data',\n        icon: { path: mdiDatabaseOutline.path },\n        header: {\n          title: 'Data',\n          icon: { path: mdiDatabaseOutline.path },\n          docsTopic: 'datasets',\n        },\n        Component: DataConsolePage,\n      },\n    ],\n  })\n}\n\nexport { default as HostDatasetsCard } from './components/host-datasets-card.component'\nexport type { HostDatasetsCardProps } from './components/host-datasets-card.component'\n"],"names":["HostDatasetsCard","Aglyn","registerRepeatSource","mdiDatabaseOutline","lazy","BUNDLE_ID","registerDatasetRecordList","DATASET_REPEAT_SOURCE","DataConsolePage","registerDataConsole","registerConsoleExtension","widgets","slot","widgetId","Component","pluginId","displayName","featureFlag","navItems","label","href","navTabId","icon","path","header","title","docsTopic","default"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,sBAAsB,+CAA2C;AACxE,YAAYC,WAAW,eAAc;AACrC,SAASC,oBAAoB,QAAQ,wCAAuC;AAC5E,SAASC,kBAAkB,QAAQ,yBAAwB;AAC3D,SAASC,IAAI,QAAQ,QAAO;AAC5B,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,yBAAyB,QAAQ,iCAA6B;AACvE,SAASC,qBAAqB,QAAQ,oCAAgC;AAEtE,8DAA8D,GAC9D,MAAMC,kBAAkBJ,KAAK,IAAM,MAAM,CAAC;AAE1C;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASK;IACdP,qBAAqBK;IACrB,oEAAoE;IACpED;IACAL,MAAMS,wBAAwB,CAAC;QAC7B,+DAA+D;QAC/D,yBAAyB;QACzBC,SAAS;YACP;gBACEC,MAAM;gBACNC,UAAU;gBACVC,WAAWd;YACb;SACD;QACDe,UAAUV;QACVW,aAAa;QACbC,aAAa;QACbC,UAAU;YACR;gBACEC,OAAO;gBACPC,MAAM;gBACN,qEAAqE;gBACrE,8DAA8D;gBAC9DC,UAAU;gBACVC,MAAM;oBAAEC,MAAMpB,mBAAmBoB,IAAI;gBAAC;gBACtCC,QAAQ;oBACNC,OAAO;oBACPH,MAAM;wBAAEC,MAAMpB,mBAAmBoB,IAAI;oBAAC;oBACtCG,WAAW;gBACb;gBACAZ,WAAWN;YACb;SACD;IACH;AACF;AAEA,SAASmB,WAAW3B,gBAAgB,QAAQ,+CAA2C"}

package/src/lib/server/announce-dataset-records.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type DatasetAnnounceResult } from '@aglyn/tenant-data-admin/server/dataset-live-pages';
+import type { Firestore } from 'firebase-admin/firestore';
+/**
+ * Refresh every live page showing this dataset's records, from one of this
+ * plugin's console routes (AGL-3113).
+ *
+ * `announceDatasetRecordChange` works out WHICH pages a record write makes
+ * stale; the drop goes through the platform's site cache. Callers `await` it:
+ * the pages are supposed to be fresh by the time the editor's save returns.
+ * The result is returned rather than swallowed so a route can surface the
+ * shortfall warning — a refusal is the one case where the write landed and
+ * the live pages stay stale for the rest of their window.
+ *
+ * BEST EFFORT, ALWAYS. The record has already been written by the time this
+ * runs, so it never throws and never rejects.
+ */
+export declare function announceDatasetRecords(options: {
+    firestore: Firestore;
+    orgId: string;
+    datasetId: string;
+}): Promise<DatasetAnnounceResult>;

package/src/lib/server/announce-dataset-records.js

@@ -0,0 +1,54 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { dropPluginSiteCache } from "@aglyn/aglyn/plugin-manager/plugin-site-cache";
+import { announceDatasetRecordChange } from "@aglyn/tenant-data-admin/server/dataset-live-pages";
+/**
+ * Drops one site's pages through the platform's site cache, narrowed to the
+ * addresses that repeat over the dataset — the app knows how to drop a page on
+ * every address a site answers at, and this plugin knows which pages.
+ */ const dropThroughSiteCache = async (target)=>{
+    const result = await dropPluginSiteCache({
+        hostIds: [
+            target.hostId
+        ],
+        paths: {
+            [target.hostId]: target.paths
+        },
+        reason: 'dataset records changed'
+    });
+    return result.complete && result.dropped > 0;
+};
+/**
+ * Refresh every live page showing this dataset's records, from one of this
+ * plugin's console routes (AGL-3113).
+ *
+ * `announceDatasetRecordChange` works out WHICH pages a record write makes
+ * stale; the drop goes through the platform's site cache. Callers `await` it:
+ * the pages are supposed to be fresh by the time the editor's save returns.
+ * The result is returned rather than swallowed so a route can surface the
+ * shortfall warning — a refusal is the one case where the write landed and
+ * the live pages stay stale for the rest of their window.
+ *
+ * BEST EFFORT, ALWAYS. The record has already been written by the time this
+ * runs, so it never throws and never rejects.
+ */ export async function announceDatasetRecords(options) {
+    return announceDatasetRecordChange(_extends({}, options, {
+        drop: dropThroughSiteCache
+    }));
+}
+
+//# sourceMappingURL=announce-dataset-records.js.map

package/src/lib/server/announce-dataset-records.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/data/src/lib/server/announce-dataset-records.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { dropPluginSiteCache } from '@aglyn/aglyn/plugin-manager/plugin-site-cache'\nimport {\n  announceDatasetRecordChange,\n  type DatasetAnnounceResult,\n  type LivePageDropper,\n} from '@aglyn/tenant-data-admin/server/dataset-live-pages'\nimport type { Firestore } from 'firebase-admin/firestore'\n\n/**\n * Drops one site's pages through the platform's site cache, narrowed to the\n * addresses that repeat over the dataset — the app knows how to drop a page on\n * every address a site answers at, and this plugin knows which pages.\n */\nconst dropThroughSiteCache: LivePageDropper = async (target) => {\n  const result = await dropPluginSiteCache({\n    hostIds: [target.hostId],\n    paths: { [target.hostId]: target.paths },\n    reason: 'dataset records changed',\n  })\n  return result.complete && result.dropped > 0\n}\n\n/**\n * Refresh every live page showing this dataset's records, from one of this\n * plugin's console routes (AGL-3113).\n *\n * `announceDatasetRecordChange` works out WHICH pages a record write makes\n * stale; the drop goes through the platform's site cache. Callers `await` it:\n * the pages are supposed to be fresh by the time the editor's save returns.\n * The result is returned rather than swallowed so a route can surface the\n * shortfall warning — a refusal is the one case where the write landed and\n * the live pages stay stale for the rest of their window.\n *\n * BEST EFFORT, ALWAYS. The record has already been written by the time this\n * runs, so it never throws and never rejects.\n */\nexport async function announceDatasetRecords(options: {\n  firestore: Firestore\n  orgId: string\n  datasetId: string\n}): Promise<DatasetAnnounceResult> {\n  return announceDatasetRecordChange({ ...options, drop: dropThroughSiteCache })\n}\n"],"names":["dropPluginSiteCache","announceDatasetRecordChange","dropThroughSiteCache","target","result","hostIds","hostId","paths","reason","complete","dropped","announceDatasetRecords","options","drop"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,mBAAmB,QAAQ,gDAA+C;AACnF,SACEC,2BAA2B,QAGtB,qDAAoD;AAG3D;;;;CAIC,GACD,MAAMC,uBAAwC,OAAOC;IACnD,MAAMC,SAAS,MAAMJ,oBAAoB;QACvCK,SAAS;YAACF,OAAOG,MAAM;SAAC;QACxBC,OAAO;YAAE,CAACJ,OAAOG,MAAM,CAAC,EAAEH,OAAOI,KAAK;QAAC;QACvCC,QAAQ;IACV;IACA,OAAOJ,OAAOK,QAAQ,IAAIL,OAAOM,OAAO,GAAG;AAC7C;AAEA;;;;;;;;;;;;;CAaC,GACD,OAAO,eAAeC,uBAAuBC,OAI5C;IACC,OAAOX,4BAA4B,aAAKW;QAASC,MAAMX;;AACzD"}

package/src/lib/server/api-v1/datasets.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type ApiV1Context } from '@aglyn/tenant-data-admin/server/api-v1-kit';
+export declare function handleDatasets(request: Request, ctx: ApiV1Context, segments: string[], url: URL): Promise<Response>;