@rslsp1/fa-app-tools 7.0.1 → 7.2.0

package/dist/szenen.js

@@ -54,6 +54,9 @@ __export(szenen_exports, {
   SZENEN_EVENT_TYPES: () => SZENEN_EVENT_TYPES,
   SZENEN_ITEM_PREFIX: () => SZENEN_ITEM_PREFIX,
   SZENEN_SCHEMAS: () => SZENEN_SCHEMAS,
+  SZENEN_SNAPSHOT_FILE: () => SZENEN_SNAPSHOT_FILE,
+  SZENEN_SNAPSHOT_PREFIX: () => SZENEN_SNAPSHOT_PREFIX,
+  SZENEN_SNAPSHOT_SCHEMA_VERSION: () => SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView: () => SzenenView,
   UNCHECKED_PUBLISH_RULES: () => UNCHECKED_PUBLISH_RULES,
   UPLOAD_MAX_BYTES: () => UPLOAD_MAX_BYTES,
@@ -66,6 +69,7 @@ __export(szenen_exports, {
   buildDerivationSystemInstruction: () => buildSystemInstruction2,
   buildDerivationUserPrompt: () => buildUserPrompt2,
   buildSystemInstruction: () => buildSystemInstruction,
+  buildSzenenSnapshot: () => buildSzenenSnapshot,
   buildUserPrompt: () => buildUserPrompt,
   buildVersionDag: () => buildVersionDag,
   callOptional: () => callOptional,
@@ -156,6 +160,7 @@ __export(szenen_exports, {
   isOk: () => isOk,
   isProjectionCurrent: () => isProjectionCurrent,
   isSzenenItemId: () => isSzenenItemId,
+  istSzenenSnapshotDatei: () => istSzenenSnapshotDatei,
   istZipDatei: () => istZipDatei,
   itemIdForRun: () => itemIdForRun,
   ladeVorschauen: () => ladeVorschauen,
@@ -163,6 +168,7 @@ __export(szenen_exports, {
   linkFor: () => linkFor,
   locatorTeile: () => locatorTeile,
   logRevisionOf: () => logRevisionOf,
+  mergeSnapshotAndPending: () => mergeSnapshotAndPending,
   mergeSzenenBatchOrigin: () => mergeSzenenBatchOrigin,
   mitDefaultVorlage: () => mitDefaultVorlage,
   noticeFor: () => noticeFor,
@@ -171,6 +177,7 @@ __export(szenen_exports, {
   parseDerivationResponse: () => parseDerivationResponse,
   parseRunResponse: () => parseRunResponse,
   parseSeedListe: () => parseSeedListe,
+  parseSzenenSnapshot: () => parseSzenenSnapshot,
   preferredHeadRevisionOf: () => preferredHeadRevisionOf,
   preferredVersionId: () => preferredVersionId,
   promptDiagnosticsOf: () => promptDiagnosticsOf,
@@ -198,6 +205,7 @@ __export(szenen_exports, {
   selectableTargetModels: () => selectableTargetModels,
   showChain: () => showChain,
   simulatedAnswerFor: () => simulatedAnswerFor,
+  szenenSnapshotFilename: () => szenenSnapshotFilename,
   totalModelCalls: () => totalModelCalls,
   typAusBytes: () => typAusBytes,
   unclassifiedPublishRules: () => unclassifiedPublishRules,
@@ -8291,6 +8299,85 @@ function bildEndungFuer(mimeType) {
   return "jpg";
 }
 
+// src/lib/szenen/szenenSnapshot.ts
+var SZENEN_SNAPSHOT_SCHEMA_VERSION = 1;
+var SZENEN_SNAPSHOT_PREFIX = "szenen-state-";
+var SZENEN_SNAPSHOT_FILE = "szenen-state.json";
+function szenenSnapshotFilename(maxTs) {
+  const stamp = new Date(maxTs).toISOString().replace(/:/g, "-").replace(".", "-");
+  return `${SZENEN_SNAPSHOT_PREFIX}${stamp}.json`;
+}
+function istSzenenSnapshotDatei(name) {
+  return name.startsWith(SZENEN_SNAPSHOT_PREFIX) && name.endsWith(".json");
+}
+var maxTsOf = (events) => {
+  let max = 0;
+  for (const event of events) if (event.ts > max) max = event.ts;
+  return max;
+};
+function buildSzenenSnapshot(base, neue, neuePfade = []) {
+  const events = [...base?.events ?? [], ...neue];
+  const paths = [...base?.consumed.paths ?? [], ...neuePfade.map(basisname)];
+  return {
+    schema_version: SZENEN_SNAPSHOT_SCHEMA_VERSION,
+    consumed: { count: events.length, max_ts: maxTsOf(events), paths },
+    events
+  };
+}
+function basisname(pfad) {
+  return pfad.split("/").pop() ?? pfad;
+}
+function aufgenommeneDateien(snapshot) {
+  return new Set(snapshot ? snapshot.consumed.paths : []);
+}
+function parseSzenenSnapshot(raw, herkunft) {
+  if (!raw || typeof raw !== "object") {
+    throw new Error(`Szenen-Snapshot ${herkunft}: kein Objekt, sondern ${typeof raw}.`);
+  }
+  const obj = raw;
+  if (obj.schema_version !== SZENEN_SNAPSHOT_SCHEMA_VERSION) {
+    throw new Error(
+      `Szenen-Snapshot ${herkunft}: schema_version ${String(obj.schema_version)} wird nicht gelesen, erwartet ${SZENEN_SNAPSHOT_SCHEMA_VERSION}.`
+    );
+  }
+  if (!Array.isArray(obj.events)) {
+    throw new Error(`Szenen-Snapshot ${herkunft}: "events" fehlt oder ist kein Array.`);
+  }
+  const events = obj.events;
+  for (const [i, event] of events.entries()) {
+    if (!event || typeof event.type !== "string" || typeof event.ts !== "number") {
+      throw new Error(
+        `Szenen-Snapshot ${herkunft}: Ereignis ${i} hat keinen Typ oder keinen Zeitstempel.`
+      );
+    }
+  }
+  const consumed = obj.consumed;
+  if (!consumed || typeof consumed.count !== "number" || typeof consumed.max_ts !== "number") {
+    throw new Error(`Szenen-Snapshot ${herkunft}: "consumed" fehlt oder ist unvollstaendig.`);
+  }
+  if (!Array.isArray(consumed.paths)) {
+    throw new Error(
+      `Szenen-Snapshot ${herkunft}: "consumed.paths" fehlt. Ohne die aufgenommenen Dateinamen laesst sich nicht entscheiden, welche Datei in events/ noch aussteht.`
+    );
+  }
+  if (consumed.count !== events.length) {
+    throw new Error(
+      `Szenen-Snapshot ${herkunft}: consumed.count ${consumed.count} passt nicht zu ${events.length} Ereignis(sen) in der Datei \u2014 die Datei ist unvollstaendig.`
+    );
+  }
+  const echt = maxTsOf(events);
+  if (consumed.max_ts !== echt) {
+    throw new Error(
+      `Szenen-Snapshot ${herkunft}: consumed.max_ts ${consumed.max_ts} passt nicht zum groessten Zeitstempel ${echt} in der Datei.`
+    );
+  }
+  return { schema_version: SZENEN_SNAPSHOT_SCHEMA_VERSION, consumed, events };
+}
+function mergeSnapshotAndPending(snapshot, pending, bereitsImSnapshot = 0) {
+  if (!snapshot) return { events: pending, bereitsImSnapshot };
+  return { events: [...snapshot.events, ...pending], bereitsImSnapshot };
+}
+
 // src/lib/hfEventLog.ts
 function treeUrl(namespace, subdir = "") {
   const parts = [namespace.replace(/\/$/, ""), subdir].filter(Boolean).join("/");
@@ -8410,6 +8497,16 @@ async function loadPendingEvents(namespace, token, sinceTs, knownPaths) {
   for (const f of pending) knownPaths?.add(f.path);
   return raw.flatMap((e) => Array.isArray(e) ? e : [e]);
 }
+async function findLatestSzenenSnapshotPath(namespace, token) {
+  const files = await hfListDir(namespace, "", token);
+  const treffer = files.filter((f) => f.type === "file" && istSzenenSnapshotDatei(f.path.split("/").pop() || "")).map((f) => f.path).sort((a, b) => b.localeCompare(a));
+  return treffer[0] ?? null;
+}
+async function loadLatestSzenenSnapshot(namespace, token) {
+  const pfad = await findLatestSzenenSnapshotPath(namespace, token);
+  if (!pfad) return null;
+  return parseSzenenSnapshot(await hfDownloadJsonByPath(pfad, token), pfad);
+}
 var SESSION_CLIENT_ID = `client-${crypto.randomUUID().slice(0, 8)}`;
 function tsToFilename(ts) {
   return new Date(ts).toISOString().replace(/:/g, "-").replace(".", "-");
@@ -8438,11 +8535,20 @@ async function writeHFEvent(namespace, token, type, payload, prevTs, options) {
 
 // src/lib/szenen/hfEventChannel.ts
 function createHfEventChannel(options) {
-  const { namespace, token, sinceTs = 0 } = options;
+  const { namespace, token, sinceTs = 0, ohneSnapshot = false } = options;
   const knownPaths = /* @__PURE__ */ new Set();
   let cachedRawEvents = [];
   let syncInFlight = null;
+  let snapshot = null;
+  let snapshotGeladen = ohneSnapshot;
   const refresh = async () => {
+    if (!snapshotGeladen) {
+      snapshot = await loadLatestSzenenSnapshot(namespace, token);
+      snapshotGeladen = true;
+      for (const name of aufgenommeneDateien(snapshot)) {
+        knownPaths.add(`${namespace}events/${name}`);
+      }
+    }
     const neue = await loadPendingEvents(namespace, token, sinceTs, knownPaths);
     if (neue.length) cachedRawEvents = [...cachedRawEvents, ...neue];
   };
@@ -8457,12 +8563,13 @@ function createHfEventChannel(options) {
   return {
     async readEvents() {
       await sync();
-      return cachedRawEvents.filter((event) => typeof event.type === "string" && event.type.startsWith(SZENEN_EVENT_PREFIX)).map((event) => ({
+      const pending = cachedRawEvents.filter((event) => typeof event.type === "string" && event.type.startsWith(SZENEN_EVENT_PREFIX)).map((event) => ({
         type: event.type,
         payload: event.payload,
         clientId: event.clientId,
         ts: event.ts
       }));
+      return mergeSnapshotAndPending(snapshot, pending).events;
     },
     async appendEvent(type, payload) {
       if (!type.startsWith(SZENEN_EVENT_PREFIX)) {
@@ -8478,6 +8585,7 @@ function createHfEventChannel(options) {
 // src/lib/szenen/inMemoryEventChannel.ts
 function createInMemoryEventChannel(options = {}) {
   const log = options.shared ?? [];
+  const snapshot = options.snapshot ?? null;
   let tick = 0;
   const now = options.now ?? (() => ++tick);
   const clientId = options.clientId ?? "client-a";
@@ -8486,7 +8594,8 @@ function createInMemoryEventChannel(options = {}) {
       return log;
     },
     async readEvents() {
-      return log.map((event) => ({ ...event }));
+      const { events } = mergeSnapshotAndPending(snapshot, log);
+      return events.map((event) => ({ ...event }));
     },
     async appendEvent(type, payload) {
       log.push({ type, payload, clientId, ts: now() });
@@ -8495,7 +8604,7 @@ function createInMemoryEventChannel(options = {}) {
       log.push(event);
     },
     withClient(otherClientId) {
-      return createInMemoryEventChannel({ clientId: otherClientId, now, shared: log });
+      return createInMemoryEventChannel({ clientId: otherClientId, now, shared: log, snapshot });
     }
   };
   return channel;
@@ -19403,6 +19512,9 @@ var SzenenView = ({
   SZENEN_EVENT_TYPES,
   SZENEN_ITEM_PREFIX,
   SZENEN_SCHEMAS,
+  SZENEN_SNAPSHOT_FILE,
+  SZENEN_SNAPSHOT_PREFIX,
+  SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView,
   UNCHECKED_PUBLISH_RULES,
   UPLOAD_MAX_BYTES,
@@ -19415,6 +19527,7 @@ var SzenenView = ({
   buildDerivationSystemInstruction,
   buildDerivationUserPrompt,
   buildSystemInstruction,
+  buildSzenenSnapshot,
   buildUserPrompt,
   buildVersionDag,
   callOptional,
@@ -19505,6 +19618,7 @@ var SzenenView = ({
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
   ladeVorschauen,
@@ -19512,6 +19626,7 @@ var SzenenView = ({
   linkFor,
   locatorTeile,
   logRevisionOf,
+  mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
   mitDefaultVorlage,
   noticeFor,
@@ -19520,6 +19635,7 @@ var SzenenView = ({
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
+  parseSzenenSnapshot,
   preferredHeadRevisionOf,
   preferredVersionId,
   promptDiagnosticsOf,
@@ -19547,6 +19663,7 @@ var SzenenView = ({
   selectableTargetModels,
   showChain,
   simulatedAnswerFor,
+  szenenSnapshotFilename,
   totalModelCalls,
   typAusBytes,
   unclassifiedPublishRules,

package/dist/szenen.mjs

@@ -21,6 +21,9 @@ import {
   SZENEN_EVENT_TYPES,
   SZENEN_ITEM_PREFIX,
   SZENEN_SCHEMAS,
+  SZENEN_SNAPSHOT_FILE,
+  SZENEN_SNAPSHOT_PREFIX,
+  SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView,
   UNCHECKED_PUBLISH_RULES,
   UPLOAD_MAX_BYTES,
@@ -32,6 +35,7 @@ import {
   bildPfad,
   buildSystemInstruction,
   buildSystemInstruction2,
+  buildSzenenSnapshot,
   buildUserPrompt,
   buildUserPrompt2,
   callOptional,
@@ -112,6 +116,7 @@ import {
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
   ladeVorschauen,
@@ -119,6 +124,7 @@ import {
   linkFor,
   locatorTeile,
   logRevisionOf,
+  mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
   mitDefaultVorlage,
   noticeFor,
@@ -127,6 +133,7 @@ import {
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
+  parseSzenenSnapshot,
   preferredHeadRevisionOf,
   promptDiagnosticsOf,
   publishedHeadsOf,
@@ -150,6 +157,7 @@ import {
   selectableTargetModels,
   showChain,
   simulatedAnswerFor,
+  szenenSnapshotFilename,
   typAusBytes,
   unclassifiedPublishRules,
   unsupportedReason,
@@ -158,7 +166,7 @@ import {
   validateElementVersion,
   validatePayload,
   withReference
-} from "./chunk-B2YV4TNI.mjs";
+} from "./chunk-5QA6DTJ6.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
@@ -194,6 +202,7 @@ function totalModelCalls(checks) {
 // src/lib/szenen/inMemoryEventChannel.ts
 function createInMemoryEventChannel(options = {}) {
   const log = options.shared ?? [];
+  const snapshot = options.snapshot ?? null;
   let tick = 0;
   const now = options.now ?? (() => ++tick);
   const clientId = options.clientId ?? "client-a";
@@ -202,7 +211,8 @@ function createInMemoryEventChannel(options = {}) {
       return log;
     },
     async readEvents() {
-      return log.map((event) => ({ ...event }));
+      const { events } = mergeSnapshotAndPending(snapshot, log);
+      return events.map((event) => ({ ...event }));
     },
     async appendEvent(type, payload) {
       log.push({ type, payload, clientId, ts: now() });
@@ -211,7 +221,7 @@ function createInMemoryEventChannel(options = {}) {
       log.push(event);
     },
     withClient(otherClientId) {
-      return createInMemoryEventChannel({ clientId: otherClientId, now, shared: log });
+      return createInMemoryEventChannel({ clientId: otherClientId, now, shared: log, snapshot });
     }
   };
   return channel;
@@ -1665,6 +1675,9 @@ export {
   SZENEN_EVENT_TYPES,
   SZENEN_ITEM_PREFIX,
   SZENEN_SCHEMAS,
+  SZENEN_SNAPSHOT_FILE,
+  SZENEN_SNAPSHOT_PREFIX,
+  SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView,
   UNCHECKED_PUBLISH_RULES,
   UPLOAD_MAX_BYTES,
@@ -1677,6 +1690,7 @@ export {
   buildSystemInstruction as buildDerivationSystemInstruction,
   buildUserPrompt as buildDerivationUserPrompt,
   buildSystemInstruction2 as buildSystemInstruction,
+  buildSzenenSnapshot,
   buildUserPrompt2 as buildUserPrompt,
   buildVersionDag,
   callOptional,
@@ -1767,6 +1781,7 @@ export {
   isOk,
   isProjectionCurrent,
   isSzenenItemId,
+  istSzenenSnapshotDatei,
   istZipDatei,
   itemIdForRun,
   ladeVorschauen,
@@ -1774,6 +1789,7 @@ export {
   linkFor,
   locatorTeile,
   logRevisionOf,
+  mergeSnapshotAndPending,
   mergeSzenenBatchOrigin,
   mitDefaultVorlage,
   noticeFor,
@@ -1782,6 +1798,7 @@ export {
   parseDerivationResponse,
   parseRunResponse,
   parseSeedListe,
+  parseSzenenSnapshot,
   preferredHeadRevisionOf,
   preferredVersionId,
   promptDiagnosticsOf,
@@ -1809,6 +1826,7 @@ export {
   selectableTargetModels,
   showChain,
   simulatedAnswerFor,
+  szenenSnapshotFilename,
   totalModelCalls,
   typAusBytes,
   unclassifiedPublishRules,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslsp1/fa-app-tools",
-  "version": "7.0.1",
+  "version": "7.2.0",
   "description": "Shared tools and hooks for Fine Art flow apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",