@interncom/diplomatic 0.15.1 → 0.16.0

package/dist/web/entdb/entdb.d.ts

@@ -30,6 +30,19 @@ export interface IDateRange {
     start: Date;
     end: Date;
 }
+/** Lexicographic tag range. Inclusive unless excludeStart / excludeEnd. */
+export type ITagRange = {
+    start: string;
+    end: string;
+    excludeStart?: boolean;
+    excludeEnd?: boolean;
+};
+/** Exact tag, lexicographic range, or prefix. One shape per query. */
+export type TagSpec = string | {
+    range: ITagRange;
+} | {
+    prefix: string;
+};
 export type EntitiesQuery = {
     type: string;
 } | {
@@ -40,11 +53,20 @@ export type EntitiesQuery = {
     pid: EntityID;
 } | {
     type: string;
-    tag: string;
+    tag: TagSpec;
 } | {
     type: string;
     updatedBetween: IDateRange;
 };
+/** Whether tag falls in r (inclusive by default). Does not check start > end. */
+export declare function tagInRange(tag: string, r: ITagRange): boolean;
+/**
+ * Whether a tag spec can match. InvalidParam if range start > end.
+ * False (Success) for empty exact string or empty prefix.
+ */
+export declare function tagSpecMayMatch(spec: TagSpec): ValStat<boolean>;
+/** Whether tag satisfies an exact / range / prefix spec. */
+export declare function tagMatches(tag: string, spec: TagSpec): boolean;
 /**
  * Normalize tags for storage/index: drop non-strings and empty strings, dedupe
  * (first occurrence wins). Returns undefined when there are no tags left.

package/dist/web/entdb/idb.d.ts

@@ -1,7 +1,7 @@
 import { Status } from "../shared/consts";
 import { EntityID, GroupID, Hash, ICrypto, IOp } from "../shared/types";
 import { ValStat } from "../shared/valstat.ts";
-import { EntitiesQuery, IEntDB, IEntity, IEntRow } from "./entdb";
+import { EntitiesQuery, IEntDB, IEntity, IEntRow, TagSpec } from "./entdb";
 export declare const entityTableName = "entities";
 export declare const typeIndexName = "entity_type_created_at";
 export declare const typeUpdatedAtIndexName = "entity_type_updated_at";
@@ -35,7 +35,7 @@ export declare class EntIDB implements IEntDB {
     getAllOfTypeUpdatedBetween<T>(opType: string, start: Date, end: Date): Promise<ValStat<IEntity<T>[]>>;
     getGroupMembers<T>(opType: string, gid: GroupID): Promise<ValStat<IEntity<T>[]>>;
     getAllOfType<T>(opType: string): Promise<ValStat<IEntity<T>[]>>;
-    getByTag<T>(opType: string, tag: string): Promise<ValStat<IEntity<T>[]>>;
+    getByTag<T>(opType: string, spec: TagSpec): Promise<ValStat<IEntity<T>[]>>;
     private getAllEntities;
     getEntities<T>(query: EntitiesQuery): Promise<ValStat<IEntity<T>[]>>;
     countEntities({ type }: {

package/dist/web/entdb/memory.d.ts

@@ -1,18 +1,7 @@
-import { IEntDB, IEntity, IEntRow } from "./entdb";
+import { EntitiesQuery, IEntDB, IEntity, IEntRow } from "./entdb";
 import { Status } from "../shared/consts";
-import { EntityID, GroupID, Hash, ICrypto, IOp } from "../shared/types";
+import { EntityID, Hash, ICrypto, IOp } from "../shared/types";
 import { ValStat } from "../shared/valstat.ts";
-interface IDateRange {
-    start: Date;
-    end: Date;
-}
-type EntitiesQuery = {
-    type: string;
-    gid?: GroupID;
-    pid?: EntityID;
-    tag?: string;
-    updatedBetween?: IDateRange;
-};
 /** Options for {@link EntDBMemory}. */
 export type EntDBMemoryOptions = {
     /**
@@ -42,6 +31,11 @@ export declare class EntDBMemory implements IEntDB {
     private unindex;
     private clearIndexes;
     private bucketList;
+    /**
+     * List by tag spec. Exact uses the tag map; range/prefix scan tag keys
+     * (Map order is insertion, not lexicographic).
+     */
+    private byTagSpec;
     apply(ops: IOp[]): Promise<{
         stats: Status[];
         types: Set<string>;
@@ -57,4 +51,3 @@ export declare class EntDBMemory implements IEntDB {
     }): Promise<ValStat<number>>;
     checksum(crypto: ICrypto): Promise<ValStat<Hash>>;
 }
-export {};

package/dist/web/index.d.ts

@@ -2,6 +2,7 @@ import { SyncClient } from "./client";
 import crypto from "./crypto";
 import { CachedEntDB, type CachedEntDBOptions, openEntDB, type OpenEntDBOptions } from "./entdb/cached";
 import { EntitiesQuery, entStateManager, IEntDB, IEntity, IEntRow, isLiveEnt, isTombstone, ITombstone, normalizeTags, nullEntDB, revFromEntity, revFromHead } from "./entdb/entdb";
+import type { ITagRange, TagSpec } from "./entdb/entdb";
 import { EntIDB } from "./entdb/idb";
 import { EntDBMemory, type EntDBMemoryOptions } from "./entdb/memory";
 import { useClient, useClientState, useClientXferState, useSyncOnResume } from "./react/useClient";
@@ -43,4 +44,4 @@ import type { WipeOpts } from "./types";
 export { largeBlobCapable } from "./shared/webauthn/largeBlob";
 export { webAuthnLastError } from "./shared/webauthn/common";
 export { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, asDHKEReq, asDHKEResp, asSealedMasterKey, b64tob, b64urltob, btob64, btob64url, btoh, CachedEntDB, checksumEntRevs, checksumSet, Clock, cmpBytes, crypto, Decoder, DEFAULT_PRF_SALT, defaultPeekProgressEvery, defaultWebAuthnRpId, eidCodec, Enclave, encodeEntRev, Encoder, EntDBMemory, EntIDB, EntitiesQuery, EntityID, entStateManager, genSingletonEID, GroupID, hostHTTPTransport, htob, HTTPTransport, IDBSeedStore, IDBStore, idleProgress, IEntDB, IEntity, isApldState, isLiveEnt, isPendingApply, isTerminalApplyFailure, isTombstone, IStore, KEYRING_MAX, keyringCredIds, keyringKind, keyringLabel, MASTER_SEED_LEN, MemoryStore, normalizeTags, nullEntDB, nullStateManager, openDiplomaticClient, openEntDB, openIDBStore, PairRequest, PasskeySeedStore, prfCapable, PrfSeedStore, revFromEntity, revFromHead, SEALED_MASTER_KEY_LEN, setApld, shouldEmitItemProgress, SingletonStateManager, StateManager, Status, SyncClient, TypedEventEmitter, useClient, useClientState, useClientXferState, useStateWatcher, useStateWatcherSuspense, useSyncOnResume, WorkerClient, };
-export type { ApldState, Applier, BundleHost, CachedEntDBOptions, DHKEReq, DHKEResp, EntDBMemoryOptions, HostHandle, HostStatsUpdate, IClient, ICrypto, IDeleteParams, IDiplomaticClientState, IEntRev, IEntRow, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITombstone, ITransport, IUpdateParams, Keyring, KeyringEntry, KeyringRow, ListMsgsOpts, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, PasskeySeedStoreOpts, PersistKeyring, PrfRp, PrfSeedStoreOpts, ReconcileOpts, ReconcileReport, SealedMasterKey, SetSeedOpts, SyncProgressEvent, WipeOpts, WorkerClientOptions, };
+export type { ApldState, Applier, BundleHost, CachedEntDBOptions, DHKEReq, DHKEResp, EntDBMemoryOptions, HostHandle, HostStatsUpdate, IClient, ICrypto, IDeleteParams, IDiplomaticClientState, IEntRev, IEntRow, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITagRange, ITombstone, ITransport, IUpdateParams, Keyring, KeyringEntry, KeyringRow, ListMsgsOpts, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, PasskeySeedStoreOpts, PersistKeyring, PrfRp, PrfSeedStoreOpts, ReconcileOpts, ReconcileReport, SealedMasterKey, SetSeedOpts, SyncProgressEvent, TagSpec, WipeOpts, WorkerClientOptions, };