@rslsp1/fa-app-tools 7.2.0 → 8.0.0

package/dist/index.d.mts

@@ -6,7 +6,7 @@ import { Node, Edge } from '@xyflow/react';
 import * as zustand_vanilla from 'zustand/vanilla';
 import { F as FeatureSliceId, b as SliceContract, a as PersistenceDescriptor, W as WorkspacePersistence, P as PersistedSlice, L as LoadResult, f as WriteResult, e as WorkspaceTabId, C as CommandResult, R as RequestContext, Q as QueryResult } from './contracts-DdYOMBl9.mjs';
 
-var version = "7.2.0";
+var version = "8.0.0";
 
 declare function useOnClickOutside(ref: RefObject<HTMLElement | null>, handler: (e: MouseEvent | TouchEvent) => void): void;
 
@@ -807,15 +807,30 @@ interface HFFileInfo {
     path: string;
     size: number;
 }
-declare function hfListDir(namespace: string, subdir: string, token: string): Promise<HFFileInfo[]>;
-declare function hfUploadSmallFile(repoPath: string, content: string, token: string, summary?: string): Promise<void>;
+declare function hfListDir(namespace: string, subdir: string, token: string, revision?: string): Promise<HFFileInfo[]>;
+declare function hfUploadSmallFile(repoPath: string, content: string, token: string, summary?: string, options?: {
+    /**
+     * Der Commit, auf dem dieser Schreibvorgang aufsetzt. Ist er nicht mehr
+     * der Kopf, lehnt HF ab (412) und es entsteht **nichts**.
+     */
+    parentCommit?: string;
+}): Promise<void>;
 declare function hfBatchArchive(moves: Array<{
     from: string;
     to: string;
     content: string;
 }>, token: string, summary: string): Promise<void>;
 declare function tsFromEventPath(repoPath: string): number;
-declare function loadPendingEvents(namespace: string, token: string, sinceTs: number, knownPaths?: Set<string>): Promise<HFEvent[]>;
+declare function loadPendingEvents(namespace: string, token: string, sinceTs: number, knownPaths?: Set<string>, 
+/**
+ * Die Revision, an der die **Dateiliste** haengt. Vorgabe `main`.
+ *
+ * Nur die Liste — die Inhalte werden weiterhin ueber `main` geladen, und das
+ * ist richtig: Ereignisdateien sind unveraenderlich, ihr Inhalt haengt nicht
+ * an der Revision. Was an der Revision haengt, ist ausschliesslich die Frage
+ * „welche Dateien gab es zu diesem Zeitpunkt".
+ */
+revision?: string): Promise<HFEvent[]>;
 declare function getSessionClientId(): string;
 declare function writeHFEvent<P>(namespace: string, token: string, type: string, payload: P, prevTs: number[], options?: {
     /**
@@ -825,6 +840,13 @@ declare function writeHFEvent<P>(namespace: string, token: string, type: string,
      * Domains, für die die Logreihenfolge fachlich zählt, schalten es ein.
      */
     ordered?: boolean;
+    /**
+     * Nur schreiben, wenn der Branch noch auf diesem Commit steht.
+     *
+     * Wirft `HfPreconditionFailedError`, wenn nicht — und schreibt dann
+     * **nichts**. Damit wird aus „anhaengen" ein Compare-and-Swap.
+     */
+    parentCommit?: string;
 }): Promise<HFEvent<P>>;
 
 declare function getHFToken(): string | null;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ import { Node, Edge } from '@xyflow/react';
 import * as zustand_vanilla from 'zustand/vanilla';
 import { F as FeatureSliceId, b as SliceContract, a as PersistenceDescriptor, W as WorkspacePersistence, P as PersistedSlice, L as LoadResult, f as WriteResult, e as WorkspaceTabId, C as CommandResult, R as RequestContext, Q as QueryResult } from './contracts-DdYOMBl9.js';
 
-var version = "7.2.0";
+var version = "8.0.0";
 
 declare function useOnClickOutside(ref: RefObject<HTMLElement | null>, handler: (e: MouseEvent | TouchEvent) => void): void;
 
@@ -807,15 +807,30 @@ interface HFFileInfo {
     path: string;
     size: number;
 }
-declare function hfListDir(namespace: string, subdir: string, token: string): Promise<HFFileInfo[]>;
-declare function hfUploadSmallFile(repoPath: string, content: string, token: string, summary?: string): Promise<void>;
+declare function hfListDir(namespace: string, subdir: string, token: string, revision?: string): Promise<HFFileInfo[]>;
+declare function hfUploadSmallFile(repoPath: string, content: string, token: string, summary?: string, options?: {
+    /**
+     * Der Commit, auf dem dieser Schreibvorgang aufsetzt. Ist er nicht mehr
+     * der Kopf, lehnt HF ab (412) und es entsteht **nichts**.
+     */
+    parentCommit?: string;
+}): Promise<void>;
 declare function hfBatchArchive(moves: Array<{
     from: string;
     to: string;
     content: string;
 }>, token: string, summary: string): Promise<void>;
 declare function tsFromEventPath(repoPath: string): number;
-declare function loadPendingEvents(namespace: string, token: string, sinceTs: number, knownPaths?: Set<string>): Promise<HFEvent[]>;
+declare function loadPendingEvents(namespace: string, token: string, sinceTs: number, knownPaths?: Set<string>, 
+/**
+ * Die Revision, an der die **Dateiliste** haengt. Vorgabe `main`.
+ *
+ * Nur die Liste — die Inhalte werden weiterhin ueber `main` geladen, und das
+ * ist richtig: Ereignisdateien sind unveraenderlich, ihr Inhalt haengt nicht
+ * an der Revision. Was an der Revision haengt, ist ausschliesslich die Frage
+ * „welche Dateien gab es zu diesem Zeitpunkt".
+ */
+revision?: string): Promise<HFEvent[]>;
 declare function getSessionClientId(): string;
 declare function writeHFEvent<P>(namespace: string, token: string, type: string, payload: P, prevTs: number[], options?: {
     /**
@@ -825,6 +840,13 @@ declare function writeHFEvent<P>(namespace: string, token: string, type: string,
      * Domains, für die die Logreihenfolge fachlich zählt, schalten es ein.
      */
     ordered?: boolean;
+    /**
+     * Nur schreiben, wenn der Branch noch auf diesem Commit steht.
+     *
+     * Wirft `HfPreconditionFailedError`, wenn nicht — und schreibt dann
+     * **nichts**. Damit wird aus „anhaengen" ein Compare-and-Swap.
+     */
+    parentCommit?: string;
 }): Promise<HFEvent<P>>;
 
 declare function getHFToken(): string | null;