@aglyn/plugins-data 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/repeat/dataset-repeat-source.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/data/src/lib/repeat/dataset-repeat-source.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 { FieldComponentType } from '@aglyn/aglyn'\nimport type {\n  RepeatRowsAnswer,\n  RepeatRowsRequest,\n  RepeatSource,\n} from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { useFirestore, useOrgDataScope } from '@aglyn/tenant-feature-instance'\nimport { useEffect, useState } from 'react'\nimport { readDatasetRepeatRows } from './dataset-repeat-rows'\n\n/**\n * The prop a repeat's dataset persists under (AGL-103). The published page's\n * composition expands every node that carries it, whatever its component, so\n * the Stack's stored repeats and any element's read as one shape. Persisted —\n * never rename.\n */\nexport const DATASET_REPEAT_KEY_PROP = 'repeatDataset'\n\n/**\n * A dataset's rows for the canvas, read once per key and site while a canvas\n * element repeats over it.\n *\n * `missing` for a site with no organization: datasets belong to the\n * organization, so there is nothing such a site can repeat over.\n */\nexport function useDatasetRepeatRows(\n  request: RepeatRowsRequest,\n): RepeatRowsAnswer {\n  const { hostId, key } = request\n  const firestore = useFirestore()\n  const { scope, ready } = useOrgDataScope({ hostId })\n  const [answer, setAnswer] = useState<RepeatRowsAnswer>({ status: 'loading' })\n  useEffect(() => {\n    if (!ready) return undefined\n    if (!scope) {\n      setAnswer({ status: 'missing' })\n      return undefined\n    }\n    let active = true\n    setAnswer({ status: 'loading' })\n    readDatasetRepeatRows({ firestore, scope, hostId, key }).then(\n      (next) => {\n        if (active) setAnswer(next)\n      },\n      (error) => {\n        console.error(error)\n        if (active) setAnswer({ status: 'error' })\n      },\n    )\n    return () => {\n      active = false\n    }\n  }, [firestore, scope, ready, hostId, key])\n  return answer\n}\n\n/**\n * Datasets as a repeat source (AGL-3111): what any element can repeat over,\n * picked with the dataset picker and previewed on the canvas from the real\n * rows. Registered by {@link registerDataConsole}, the function the console's\n * plugin loader calls by name.\n */\nexport const DATASET_REPEAT_SOURCE: RepeatSource = {\n  id: 'dataset',\n  label: 'Dataset',\n  keyProp: DATASET_REPEAT_KEY_PROP,\n  keyAttribute: {\n    component: FieldComponentType.DATASET_SELECT,\n    label: 'Repeat over dataset',\n    description:\n      'Render this element once per record of a dataset on the published ' +\n      'site. Use {{item.field}} for a record value. Stored by dataset id — ' +\n      'renames never break the repeat.',\n  },\n  useRows: useDatasetRepeatRows,\n}\n"],"names":["FieldComponentType","useFirestore","useOrgDataScope","useEffect","useState","readDatasetRepeatRows","DATASET_REPEAT_KEY_PROP","useDatasetRepeatRows","request","hostId","key","firestore","scope","ready","answer","setAnswer","status","undefined","active","then","next","error","console","DATASET_REPEAT_SOURCE","id","label","keyProp","keyAttribute","component","DATASET_SELECT","description","useRows"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,kBAAkB,QAAQ,eAAc;AAMjD,SAASC,YAAY,EAAEC,eAAe,QAAQ,iCAAgC;AAC9E,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAC3C,SAASC,qBAAqB,QAAQ,2BAAuB;AAE7D;;;;;CAKC,GACD,OAAO,MAAMC,0BAA0B,gBAAe;AAEtD;;;;;;CAMC,GACD,OAAO,SAASC,qBACdC,OAA0B;IAE1B,MAAM,EAAEC,MAAM,EAAEC,GAAG,EAAE,GAAGF;IACxB,MAAMG,YAAYV;IAClB,MAAM,EAAEW,KAAK,EAAEC,KAAK,EAAE,GAAGX,gBAAgB;QAAEO;IAAO;IAClD,MAAM,CAACK,QAAQC,UAAU,GAAGX,SAA2B;QAAEY,QAAQ;IAAU;IAC3Eb,UAAU;QACR,IAAI,CAACU,OAAO,OAAOI;QACnB,IAAI,CAACL,OAAO;YACVG,UAAU;gBAAEC,QAAQ;YAAU;YAC9B,OAAOC;QACT;QACA,IAAIC,SAAS;QACbH,UAAU;YAAEC,QAAQ;QAAU;QAC9BX,sBAAsB;YAAEM;YAAWC;YAAOH;YAAQC;QAAI,GAAGS,IAAI,CAC3D,CAACC;YACC,IAAIF,QAAQH,UAAUK;QACxB,GACA,CAACC;YACCC,QAAQD,KAAK,CAACA;YACd,IAAIH,QAAQH,UAAU;gBAAEC,QAAQ;YAAQ;QAC1C;QAEF,OAAO;YACLE,SAAS;QACX;IACF,GAAG;QAACP;QAAWC;QAAOC;QAAOJ;QAAQC;KAAI;IACzC,OAAOI;AACT;AAEA;;;;;CAKC,GACD,OAAO,MAAMS,wBAAsC;IACjDC,IAAI;IACJC,OAAO;IACPC,SAASpB;IACTqB,cAAc;QACZC,WAAW5B,mBAAmB6B,cAAc;QAC5CJ,OAAO;QACPK,aACE,uEACA,yEACA;IACJ;IACAC,SAASxB;AACX,EAAC"}
+{"version":3,"sources":["../../../../../../../libs/plugins/data/src/lib/repeat/dataset-repeat-source.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 { FieldComponentType } from '@aglyn/aglyn'\nimport type {\n  RepeatRowsAnswer,\n  RepeatRowsRequest,\n  RepeatSource,\n} from '@aglyn/aglyn/app-utils/repeat-sources'\nimport { useFirestore, useOrgDataScope } from '@aglyn/tenant-feature-instance'\nimport { useEffect, useState } from 'react'\nimport { DATASET_REPEAT_SOURCE_ID } from '../constants/bundle-common'\nimport { readDatasetRepeatRows } from './dataset-repeat-rows'\n\n/**\n * The prop a repeat's dataset persists under (AGL-103). The published page's\n * composition expands every node that carries it, whatever its component, so\n * the Stack's stored repeats and any element's read as one shape. Persisted —\n * never rename.\n */\nexport const DATASET_REPEAT_KEY_PROP = 'repeatDataset'\n\n/**\n * A dataset's rows for the canvas, read once per key and site while a canvas\n * element repeats over it.\n *\n * `missing` for a site with no organization: datasets belong to the\n * organization, so there is nothing such a site can repeat over.\n */\nexport function useDatasetRepeatRows(\n  request: RepeatRowsRequest,\n): RepeatRowsAnswer {\n  const { hostId, key } = request\n  const firestore = useFirestore()\n  const { scope, ready } = useOrgDataScope({ hostId })\n  const [answer, setAnswer] = useState<RepeatRowsAnswer>({ status: 'loading' })\n  useEffect(() => {\n    if (!ready) return undefined\n    if (!scope) {\n      setAnswer({ status: 'missing' })\n      return undefined\n    }\n    let active = true\n    setAnswer({ status: 'loading' })\n    readDatasetRepeatRows({ firestore, scope, hostId, key }).then(\n      (next) => {\n        if (active) setAnswer(next)\n      },\n      (error) => {\n        console.error(error)\n        if (active) setAnswer({ status: 'error' })\n      },\n    )\n    return () => {\n      active = false\n    }\n  }, [firestore, scope, ready, hostId, key])\n  return answer\n}\n\n/**\n * Datasets as a repeat source (AGL-3111): what any element can repeat over,\n * picked with the dataset picker and previewed on the canvas from the real\n * rows. Registered by {@link registerDataConsole}, the function the console's\n * plugin loader calls by name.\n */\nexport const DATASET_REPEAT_SOURCE: RepeatSource = {\n  id: DATASET_REPEAT_SOURCE_ID,\n  label: 'Dataset',\n  keyProp: DATASET_REPEAT_KEY_PROP,\n  entityKind: 'datasets',\n  keyAttribute: {\n    component: FieldComponentType.DATASET_SELECT,\n    label: 'Repeat over dataset',\n    description:\n      'Render this element once per record of a dataset on the published ' +\n      'site. Use {{item.field}} for a record value. Stored by dataset id — ' +\n      'renames never break the repeat.',\n  },\n  useRows: useDatasetRepeatRows,\n}\n"],"names":["FieldComponentType","useFirestore","useOrgDataScope","useEffect","useState","DATASET_REPEAT_SOURCE_ID","readDatasetRepeatRows","DATASET_REPEAT_KEY_PROP","useDatasetRepeatRows","request","hostId","key","firestore","scope","ready","answer","setAnswer","status","undefined","active","then","next","error","console","DATASET_REPEAT_SOURCE","id","label","keyProp","entityKind","keyAttribute","component","DATASET_SELECT","description","useRows"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,kBAAkB,QAAQ,eAAc;AAMjD,SAASC,YAAY,EAAEC,eAAe,QAAQ,iCAAgC;AAC9E,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAC3C,SAASC,wBAAwB,QAAQ,gCAA4B;AACrE,SAASC,qBAAqB,QAAQ,2BAAuB;AAE7D;;;;;CAKC,GACD,OAAO,MAAMC,0BAA0B,gBAAe;AAEtD;;;;;;CAMC,GACD,OAAO,SAASC,qBACdC,OAA0B;IAE1B,MAAM,EAAEC,MAAM,EAAEC,GAAG,EAAE,GAAGF;IACxB,MAAMG,YAAYX;IAClB,MAAM,EAAEY,KAAK,EAAEC,KAAK,EAAE,GAAGZ,gBAAgB;QAAEQ;IAAO;IAClD,MAAM,CAACK,QAAQC,UAAU,GAAGZ,SAA2B;QAAEa,QAAQ;IAAU;IAC3Ed,UAAU;QACR,IAAI,CAACW,OAAO,OAAOI;QACnB,IAAI,CAACL,OAAO;YACVG,UAAU;gBAAEC,QAAQ;YAAU;YAC9B,OAAOC;QACT;QACA,IAAIC,SAAS;QACbH,UAAU;YAAEC,QAAQ;QAAU;QAC9BX,sBAAsB;YAAEM;YAAWC;YAAOH;YAAQC;QAAI,GAAGS,IAAI,CAC3D,CAACC;YACC,IAAIF,QAAQH,UAAUK;QACxB,GACA,CAACC;YACCC,QAAQD,KAAK,CAACA;YACd,IAAIH,QAAQH,UAAU;gBAAEC,QAAQ;YAAQ;QAC1C;QAEF,OAAO;YACLE,SAAS;QACX;IACF,GAAG;QAACP;QAAWC;QAAOC;QAAOJ;QAAQC;KAAI;IACzC,OAAOI;AACT;AAEA;;;;;CAKC,GACD,OAAO,MAAMS,wBAAsC;IACjDC,IAAIpB;IACJqB,OAAO;IACPC,SAASpB;IACTqB,YAAY;IACZC,cAAc;QACZC,WAAW9B,mBAAmB+B,cAAc;QAC5CL,OAAO;QACPM,aACE,uEACA,yEACA;IACJ;IACAC,SAASzB;AACX,EAAC"}

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>;