@hops-ops/distributed 0.0.0

package/dist/replica/distributed-replica/impl.d.ts

@@ -0,0 +1,44 @@
+import type { GraphqlVariables } from '../../types.js';
+import { type DistributedCommandMetadata } from '../../protocol.js';
+import { replicaCommandAuthority, replicaCommandDirectProjection, replicaResultObservation, type ReplicaCommandAuthorityRegistration, type ReplicaCommandDirectProjection, type ReplicaCommandSurfaceContract, type ReplicaResultObservationRegistration } from '../command-runtime.js';
+import { type MaterializedReplicaResult } from '../materialize.js';
+import { type ReplicaIndexSemanticChange } from '../index-maintenance.js';
+import type { DistributedReplicaOptions, DistributedReplica as DistributedReplicaApi, ReplicaAuthoritativeScope, ReplicaBaseWriter, ReplicaDehydratedState, ReplicaIdentity, ReplicaIndexInspection, ReplicaIndexTarget, ReplicaModelArtifact, ReplicaOperationArtifact, ReplicaOptimisticWriter, ReplicaRecordInspection, ReplicaRevalidationPlan, ReplicaRevision, ReplicaResultEnvelope, ReplicaSnapshot, ReplicaWatch, ReplicaWriteSource, WatchReplicaOptions } from '../types.js';
+import type { QueryState } from './types.js';
+import { ReplicaWatchState } from './watch.js';
+export declare class DistributedReplicaImpl implements DistributedReplicaApi {
+    #private;
+    constructor(options?: DistributedReplicaOptions);
+    get scope(): ReplicaAuthoritativeScope | undefined;
+    get authorizationGeneration(): number;
+    [replicaCommandAuthority](contract: ReplicaCommandSurfaceContract): ReplicaCommandAuthorityRegistration;
+    [replicaResultObservation](observer: (envelope: ReplicaResultEnvelope<unknown>) => void): ReplicaResultObservationRegistration;
+    [replicaCommandDirectProjection](commandId: string, projection: ReplicaCommandDirectProjection): void;
+    read<TData, TVariables extends GraphqlVariables>(artifact: ReplicaOperationArtifact<TData, TVariables>, variables: TVariables): ReplicaSnapshot<TData>;
+    watch<TData, TVariables extends GraphqlVariables>(artifact: ReplicaOperationArtifact<TData, TVariables>, variables: TVariables, options?: WatchReplicaOptions): ReplicaWatch<TData>;
+    writeResult<TData, TVariables extends GraphqlVariables>(artifact: ReplicaOperationArtifact<TData, TVariables>, variables: TVariables, envelope: ReplicaResultEnvelope<TData>, source: ReplicaWriteSource): void;
+    revalidate(plan: ReplicaRevalidationPlan): Promise<void>;
+    invalidateAuthorization(): void;
+    dehydrate(): ReplicaDehydratedState;
+    hydrate(state: ReplicaDehydratedState, authoritativeScope: ReplicaAuthoritativeScope): boolean;
+    createOptimisticLayer(id: string, update: (writer: ReplicaOptimisticWriter) => void, semanticChanges?: readonly ReplicaIndexSemanticChange[]): void;
+    markOptimisticLayerAccepted(id: string, receipt?: DistributedCommandMetadata): boolean;
+    confirmOptimisticLayer<T>(id: string, update: (writer: ReplicaBaseWriter) => T): T;
+    rejectOptimisticLayer(id: string): boolean;
+    tombstoneRecord(model: ReplicaModelArtifact, identity: ReplicaIdentity, revision: ReplicaRevision): boolean;
+    markIndexStale(target: ReplicaIndexTarget, reason: string): boolean;
+    retainRecord(model: ReplicaModelArtifact, identity: ReplicaIdentity): void;
+    releaseRecord(model: ReplicaModelArtifact, identity: ReplicaIdentity): void;
+    gc(): readonly string[];
+    inspectRecord(model: ReplicaModelArtifact, identity: ReplicaIdentity): ReplicaRecordInspection | undefined;
+    inspectIndex(target: ReplicaIndexTarget): ReplicaIndexInspection | undefined;
+    /** Package-internal hook used by one watched operation. */
+    _register<TData, TVariables extends GraphqlVariables>(watch: ReplicaWatchState<TData, TVariables>): () => void;
+    /** Package-internal query-state lookup. */
+    _state(key: string): QueryState;
+    /** Package-internal materialization for watch construction. */
+    _materialize<TData, TVariables extends GraphqlVariables>(artifact: ReplicaOperationArtifact<TData, TVariables>, variables: TVariables): MaterializedReplicaResult<TData>;
+    /** Package-internal cache-and-live coordinator. */
+    _fetch<TData, TVariables extends GraphqlVariables>(watch: ReplicaWatchState<TData, TVariables>, force: boolean): Promise<void>;
+    _reportObserverErrors(errors: unknown[]): void;
+}