@osdk/client 2.4.2 → 2.5.0-beta.10

package/build/types/observable/ObservableClient.d.ts

@@ -2,25 +2,17 @@ import type { ActionDefinition, ActionValidationResponse, InterfaceDefinition, O
 import type { ActionSignatureFromDef } from "../actions/applyAction.js";
 import { type Client } from "../Client.js";
 import type { Canonical } from "./internal/Canonical.js";
+import type { CommonObserveOptions, InvalidationMode, ObserveOptions, Observer, Status } from "./ObservableClient/common.js";
+import type { ObserveLinks } from "./ObservableClient/ObserveLink.js";
 import type { OptimisticBuilder } from "./OptimisticBuilder.js";
-export type Status = "init" | "loading" | "loaded" | "error";
-export interface Observer<T> {
-	next: (value: T) => void;
-	error: (err: any) => void;
-	complete: () => void;
-}
 export declare namespace ObservableClient {
 	interface ApplyActionOptions {
 		optimisticUpdate?: (ctx: OptimisticBuilder) => void;
 	}
 }
-export interface CommonObserveOptions {
-	dedupeInterval?: number;
-}
-export interface ObserveOptions {
-	mode?: "offline" | "force";
-}
 export interface ObserveObjectOptions<T extends ObjectTypeDefinition | InterfaceDefinition> extends ObserveOptions {
+	apiName: T["apiName"] | T;
+	pk: PrimaryKeyType<T>;
 	select?: PropertyKeys<T>[];
 }
 export type OrderBy<Q extends ObjectTypeDefinition | InterfaceDefinition> = { [K in PropertyKeys<Q>]? : "asc" | "desc" | undefined };
@@ -29,7 +21,7 @@ export interface ObserveListOptions<Q extends ObjectTypeDefinition | InterfaceDe
 	where?: WhereClause<Q>;
 	pageSize?: number;
 	orderBy?: OrderBy<Q>;
-	invalidationMode?: "in-place" | "wait" | "reset";
+	invalidationMode?: InvalidationMode;
 	expectedLength?: number;
 	streamUpdates?: boolean;
 }
@@ -43,15 +35,111 @@ export interface ObserveObjectsArgs<T extends ObjectTypeDefinition | InterfaceDe
 	resolvedList: Array<Osdk.Instance<T>>;
 	isOptimistic: boolean;
 	lastUpdated: number;
-	fetchMore: () => Promise<unknown>;
+	fetchMore: () => Promise<void>;
+	hasMore: boolean;
+	status: Status;
+}
+/**
+* User facing callback args for `observeLink`
+*/
+export interface ObserveLinkCallbackArgs<T extends ObjectTypeDefinition | InterfaceDefinition> {
+	resolvedList: Osdk.Instance<T>[];
+	isOptimistic: boolean;
+	lastUpdated: number;
+	fetchMore: () => Promise<void>;
 	hasMore: boolean;
 	status: Status;
 }
-export interface ObservableClient {
+/**
+* Public interface for reactive data management with automatic updates.
+*
+* The ObservableClient provides a reactive data layer with:
+* - Real-time object and collection observation
+* - Automatic cache updates when data changes
+* - Optimistic updates for immediate UI feedback
+* - Pagination support for large collections
+* - Link traversal for relationship navigation
+*/
+export interface ObservableClient extends ObserveLinks {
+	/**
+	* Observe a single object with automatic updates when it changes.
+	*
+	* @param apiName - The object type definition or name
+	* @param pk - The object's primary key
+	* @param options - Observation options including deduplication interval
+	* @param subFn - Observer that receives object state updates
+	* @returns Subscription that can be unsubscribed to stop updates
+	*
+	* The observer will receive:
+	* - Initial loading state if data not cached
+	* - Loaded state with the object data
+	* - Updates when the object changes
+	* - Error state if fetch fails
+	*/
 	observeObject<T extends ObjectTypeDefinition>(apiName: T["apiName"] | T, pk: PrimaryKeyType<T>, options: ObserveOptions, subFn: Observer<ObserveObjectArgs<T>>): Unsubscribable;
+	/**
+	* Observe a filtered and sorted collection of objects.
+	*
+	* @param options - Filter, sort, and pagination options
+	* @param subFn - Observer that receives collection state updates
+	* @returns Subscription that can be unsubscribed to stop updates
+	*
+	* Supports:
+	* - Filtering with where clauses
+	* - Sorting with orderBy
+	* - Pagination via fetchMore() in the payload
+	* - Automatic updates when any matching object changes
+	*/
 	observeList<T extends ObjectTypeDefinition | InterfaceDefinition>(options: ObserveListOptions<T>, subFn: Observer<ObserveObjectsArgs<T>>): Unsubscribable;
+	/**
+	* Execute an action with optional optimistic updates.
+	*
+	* @param action - Action definition to execute
+	* @param args - Arguments for the action
+	* @param opts - Options including optimistic updates
+	* @returns Promise that resolves when the action completes
+	*
+	* When providing optimistic updates:
+	* - Changes appear immediately in the UI
+	* - Server request still happens in background
+	* - On success, server data replaces optimistic data
+	* - On failure, optimistic changes automatically roll back
+	*/
 	applyAction: <Q extends ActionDefinition<any>>(action: Q, args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] | Array<Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0]>, opts?: ObservableClient.ApplyActionOptions) => Promise<unknown>;
+	/**
+	* Validate action parameters without executing the action.
+	*
+	* @param action - Action definition to validate
+	* @param args - Arguments to validate
+	* @returns Promise with validation result
+	*
+	* Use this to:
+	* - Pre-validate forms before submission
+	* - Display warnings or errors in the UI
+	* - Enable/disable action buttons based on validity
+	*/
 	validateAction: <Q extends ActionDefinition<any>>(action: Q, args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0]) => Promise<ActionValidationResponse>;
+	/**
+	* Invalidates the entire cache, forcing all queries to refetch.
+	* Use sparingly as this can cause significant network traffic.
+	*/
+	invalidateAll(): Promise<void>;
+	/**
+	* Invalidates specific objects in the cache.
+	* @param objects - Single object or array of objects to invalidate
+	*/
+	invalidateObjects(objects: Osdk.Instance<ObjectTypeDefinition> | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>): Promise<void>;
+	/**
+	* Invalidates all cached data for a specific object type.
+	* This includes:
+	* - All objects of the specified type
+	* - All lists containing objects of this type
+	* - All links where the source is of this type
+	*
+	* @param type - Object type definition or API name string
+	* @returns Promise that resolves when invalidation is complete
+	*/
+	invalidateObjectType<T extends ObjectTypeDefinition>(type: T | T["apiName"]): Promise<void>;
 	canonicalizeWhereClause: <T extends ObjectTypeDefinition | InterfaceDefinition>(where: WhereClause<T>) => Canonical<WhereClause<T>>;
 }
 export declare function createObservableClient(client: Client): ObservableClient;

package/build/types/observable/ObservableClient.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,kBACA,0BACA,qBACA,sBACA,MACA,gBACA,cACA,mBACK,WAAY;AAEnB,cAAc,8BAA8B,2BAA4B;AACxE,cAAiC,cAAc,cAAe;AAG9D,cAAc,iBAAiB,yBAA0B;AAGzD,cAAc,yBAAyB,wBAAyB;AAEhE,YAAY,SAAS,SAAS,YAAY,WAAW;AAErD,iBAAiB,SAAS,GAAG;CAC3B,OAAOA,OAAO;CACd,QAAQC;CACR;AACD;AAED,yBAAiB;WACE,mBAAmB;EAClC,oBAAoBC,KAAK;CAC1B;;AAGH,iBAAiB,qBAAqB;CACpC;AACD;AAED,iBAAiB,eAAe;CAC9B,OAAO,YAAY;AACpB;AAED,iBAAiB,qBACf,UAAU,uBAAuB,6BACzB,eAAe;CACvB,SAAS,aAAa;AACvB;AAED,YAAY,QAAQ,UAAU,uBAAuB,0BAClD,KAAK,aAAa,OAAM,QAAQ;AAGnC,iBAAiB,mBACf,UAAU,uBAAuB,6BACzB,sBAAsB,eAAe;CAC7C,MAAM,KAAK,GAAG,YAAY;CAC1B,QAAQ,YAAY;CACpB;CACA,UAAU,QAAQ;CAClB,mBAAmB,aAAa,SAAS;CACzC;CACA;AACD;AAED,iBAAiB,kBAAkB,UAAU,sBAAsB;CACjE,QAAQ,KAAK,SAAS;CACtB;CACA,QAAQ;CACR;AACD;AAED,iBAAiB,mBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,MAAM,KAAK,SAAS;CAClC;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;AAED,iBAAiB,iBAAiB;CAChC,cAAc,UAAU,sBACtBC,SAAS,EAAE,aAAa,GACxBC,IAAI,eAAe,IACnBC,SAAS,gBACTC,OAAO,SAAS,kBAAkB,MACjC;CAEH,YAAY,UAAU,uBAAuB,qBAC3CC,SAAS,mBAAmB,IAC5BC,OAAO,SAAS,mBAAmB,MAClC;CAEH,cAAc,UAAU,uBACtBC,QAAQ,GACRC,MACI,WAAW,uBAAuB,GAAG,gBAAgB,KACrD,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,KAC/DC,OAAO,iBAAiB,uBACrB;CAEL,iBAAiB,UAAU,uBACzBF,QAAQ,GACRG,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;CAEb,0BACE,UAAU,uBAAuB,qBAEjCC,OAAO,YAAY,OAChB,UAAU,YAAY;AAC5B;AAED,OAAO,iBAAS,uBAAuBC,QAAQ,SAAS;AA0BxD,iBAAiB,eAAe;CAC9B;AACD","names":["value: T","err: any","ctx: OptimisticBuilder","apiName: T[\"apiName\"] | T","pk: PrimaryKeyType<T>","options: ObserveOptions","subFn: Observer<ObserveObjectArgs<T>>","options: ObserveListOptions<T>","subFn: Observer<ObserveObjectsArgs<T>>","action: Q","args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>","opts?: ObservableClient.ApplyActionOptions","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","where: WhereClause<T>","client: Client"],"sources":["../../../src/observable/ObservableClient.ts"],"version":3,"file":"ObservableClient.d.ts"}
+{"mappings":"AAgBA,cACE,kBACA,0BACA,qBACA,sBACA,MACA,gBACA,cACA,mBACK,WAAY;AAEnB,cAAc,8BAA8B,2BAA4B;AACxE,cAAiC,cAAc,cAAe;AAG9D,cAAc,iBAAiB,yBAA0B;AAGzD,cACE,sBACA,kBACA,gBACA,UACA,cACK,8BAA+B;AACtC,cAAc,oBAAoB,mCAAoC;AACtE,cAAc,yBAAyB,wBAAyB;AAEhE,yBAAiB;WACE,mBAAmB;EAClC,oBAAoBA,KAAK;CAC1B;;AAGH,iBAAiB,qBACf,UAAU,uBAAuB,6BACzB,eAAe;CACvB,SAAS,EAAE,aAAa;CACxB,IAAI,eAAe;CACnB,SAAS,aAAa;AACvB;AAED,YAAY,QAAQ,UAAU,uBAAuB,0BAClD,KAAK,aAAa,OAAM,QAAQ;AAGnC,iBAAiB,mBACf,UAAU,uBAAuB,6BACzB,sBAAsB,eAAe;CAC7C,MAAM,KAAK,GAAG,YAAY;CAC1B,QAAQ,YAAY;CACpB;CACA,UAAU,QAAQ;CAClB,mBAAmB;CACnB;CACA;AACD;AAID,iBAAiB,kBAAkB,UAAU,sBAAsB;CACjE,QAAQ,KAAK,SAAS;CACtB;CACA,QAAQ;CACR;AACD;AAGD,iBAAiB,mBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,MAAM,KAAK,SAAS;CAClC;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;;;;AAKD,iBAAiB,wBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,KAAK,SAAS;CAC5B;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;;;;;;;;;;;AAYD,iBAAiB,yBAAyB,aAAa;;;;;;;;;;;;;;;;CAgBrD,cAAc,UAAU,sBACtBC,SAAS,EAAE,aAAa,GACxBC,IAAI,eAAe,IACnBC,SAAS,gBACTC,OAAO,SAAS,kBAAkB,MACjC;;;;;;;;;;;;;;CAeH,YAAY,UAAU,uBAAuB,qBAC3CC,SAAS,mBAAmB,IAC5BC,OAAO,SAAS,mBAAmB,MAClC;;;;;;;;;;;;;;;CAgBH,cAAc,UAAU,uBACtBC,QAAQ,GACRC,MACI,WAAW,uBAAuB,GAAG,gBAAgB,KACrD,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,KAC/DC,OAAO,iBAAiB,uBACrB;;;;;;;;;;;;;CAcL,iBAAiB,UAAU,uBACzBF,QAAQ,GACRG,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;;;;;CAMb,iBAAiB;;;;;CAMjB,kBACEC,SACI,KAAK,SAAS,wBACd,cAAc,KAAK,SAAS,yBAC/B;;;;;;;;;;;CAYH,qBAAqB,UAAU,sBAC7BC,MAAM,IAAI,EAAE,aACX;CAEH,0BACE,UAAU,uBAAuB,qBAEjCC,OAAO,YAAY,OAChB,UAAU,YAAY;AAC5B;AAED,OAAO,iBAAS,uBAAuBC,QAAQ,SAAS;AA0BxD,iBAAiB,eAAe;CAC9B;AACD","names":["ctx: OptimisticBuilder","apiName: T[\"apiName\"] | T","pk: PrimaryKeyType<T>","options: ObserveOptions","subFn: Observer<ObserveObjectArgs<T>>","options: ObserveListOptions<T>","subFn: Observer<ObserveObjectsArgs<T>>","action: Q","args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>","opts?: ObservableClient.ApplyActionOptions","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>","type: T | T[\"apiName\"]","where: WhereClause<T>","client: Client"],"sources":["../../../src/observable/ObservableClient.ts"],"version":3,"file":"ObservableClient.d.ts"}

package/build/types/observable/Unsubscribable.d.ts

@@ -0,0 +1,3 @@
+export interface Unsubscribable {
+	unsubscribe: () => void;
+}

package/build/types/observable/Unsubscribable.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,iBAAiB,eAAe;CAC9B;AACD","names":[],"sources":["../../../src/observable/Unsubscribable.ts"],"version":3,"file":"Unsubscribable.d.ts"}

package/build/types/observable/internal/AbstractHelper.d.ts

@@ -0,0 +1,17 @@
+import type { CommonObserveOptions, Observer } from "../ObservableClient/common.js";
+import type { CacheKeys } from "./CacheKeys.js";
+import type { KnownCacheKey } from "./KnownCacheKey.js";
+import type { Query } from "./Query.js";
+import { QuerySubscription } from "./QuerySubscription.js";
+import type { Store } from "./Store.js";
+export declare abstract class AbstractHelper<
+	TQuery extends Query<KnownCacheKey, any, CommonObserveOptions>,
+	TObserveOptions extends CommonObserveOptions
+> {
+	protected readonly store: Store;
+	protected readonly cacheKeys: CacheKeys<KnownCacheKey>;
+	constructor(store: Store, cacheKeys: CacheKeys<KnownCacheKey>);
+	observe(options: TObserveOptions, subFn: Observer<TQuery extends Query<any, infer PAYLOAD, any> ? PAYLOAD : never>): QuerySubscription<TQuery>;
+	abstract getQuery(options: TObserveOptions): TQuery;
+	protected _subscribe(query: TQuery, options: TObserveOptions, subFn: Observer<TQuery extends Query<any, infer PAYLOAD, any> ? PAYLOAD : never>): QuerySubscription<TQuery>;
+}

package/build/types/observable/internal/AbstractHelper.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,sBACA,gBACK,+BAAgC;AACvC,cAAc,iBAAiB,gBAAiB;AAChD,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AACxC,SAAS,yBAAyB,wBAAyB;AAC3D,cAAc,aAAa,YAAa;AAExC,OAAO,uBAAe;CACpB,eAAe,MAAM,oBAAoB;CACzC,wBAAwB;EACxB;CACA,mBAAmB,OAAO;CAC1B,mBAAmB,WAAW,UAAU;CAExC,YAAYA,OAAO,OAAOC,WAAW,UAAU;CAK/C,QACEC,SAAS,iBACTC,OAAO,SACL,eAAe,iBAAiB,gBAAgB,mBAEjD,kBAAkB;CAKrB,SAAS,SAASD,SAAS,kBAAkB;CAE7C,UAAU,WACRE,OAAO,QACPF,SAAS,iBACTC,OAAO,SACL,eAAe,iBAAiB,gBAAgB,mBAEjD,kBAAkB;AAkCtB","names":["store: Store","cacheKeys: CacheKeys<KnownCacheKey>","options: TObserveOptions","subFn: Observer<\n      TQuery extends Query<any, infer PAYLOAD, any> ? PAYLOAD : never\n    >","query: TQuery"],"sources":["../../../../src/observable/internal/AbstractHelper.ts"],"version":3,"file":"AbstractHelper.d.ts"}

package/build/types/observable/internal/BatchContext.d.ts

@@ -0,0 +1,11 @@
+import type { Changes } from "./Changes.js";
+import type { KnownCacheKey } from "./KnownCacheKey.js";
+import type { Entry } from "./Layer.js";
+export interface BatchContext {
+	changes: Changes;
+	createLayerIfNeeded: () => void;
+	optimisticWrite: boolean;
+	write: <K extends KnownCacheKey>(k: K, v: Entry<K>["value"], status: Entry<K>["status"]) => Entry<K>;
+	read: <K extends KnownCacheKey>(k: K) => Entry<K> | undefined;
+	delete: <K extends KnownCacheKey>(k: K, status: Entry<K>["status"]) => Entry<K>;
+}

package/build/types/observable/internal/BatchContext.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,eAAe,cAAe;AAC5C,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AAExC,iBAAiB,aAAa;CAC5B,SAAS;CACT;CACA;CAEA,QAAQ,UAAU,eAChBA,GAAG,GACHC,GAAG,MAAM,GAAG,UACZC,QAAQ,MAAM,GAAG,cACd,MAAM;CAEX,OAAO,UAAU,eACfF,GAAG,MACA,MAAM;CAEX,SAAS,UAAU,eACjBA,GAAG,GACHE,QAAQ,MAAM,GAAG,cACd,MAAM;AACZ","names":["k: K","v: Entry<K>[\"value\"]","status: Entry<K>[\"status\"]"],"sources":["../../../../src/observable/internal/BatchContext.ts"],"version":3,"file":"BatchContext.d.ts"}

package/build/types/observable/internal/BulkObjectLoader.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAqBA,cAAiC,cAAc,iBAAkB;AACjE,cACE,oBACK,uDAAwD;AAgB/D,OAAO,iBAAS,oBAAoBA,QAAQ,SAAS;AAIrD,OAAO,cAAM,iBAAiB;;CAW5B,YAAYA,QAAQ,QAAQ,kBAAc;CAO1C,AAAO,MACLC,iBACAC,wCACC,QAAQ;AAuDZ","names":["client: Client","apiName: string","primaryKey: string | number | boolean"],"sources":["../../../../src/observable/internal/BulkObjectLoader.ts"],"version":3,"file":"BulkObjectLoader.d.ts"}
+{"mappings":"AAqBA,cAAiC,cAAc,iBAAkB;AACjE,cACE,oBACK,uDAAwD;AAgB/D,OAAO,iBAAS,oBAAoBA,QAAQ,SAAS;AAIrD,OAAO,cAAM,iBAAiB;;CAW5B,YAAYA,QAAQ,QAAQ,kBAAc;CAO1C,AAAa,MACXC,iBACAC,wCACC,QAAQ;AAyDZ","names":["client: Client","apiName: string","primaryKey: string | number | boolean"],"sources":["../../../../src/observable/internal/BulkObjectLoader.ts"],"version":3,"file":"BulkObjectLoader.d.ts"}

package/build/types/observable/internal/CacheKeys.d.ts

@@ -1,9 +1,15 @@
 import type { CacheKey } from "./CacheKey.js";
-import type { OrderByCanonicalizer } from "./OrderByCanonicalizer.js";
-import type { WhereClauseCanonicalizer } from "./WhereClauseCanonicalizer.js";
-export declare class CacheKeys {
+/**
+* Cache key management with canonicalization.
+* - Uses Trie structure for efficient storage and lookup
+*/
+export declare class CacheKeys<TCacheKey extends CacheKey> {
 	#private;
-	constructor(whereCanonicalizer: WhereClauseCanonicalizer, orderByCanonicalizer: OrderByCanonicalizer, onCreate: (cacheKey: CacheKey) => void);
-	get<K extends CacheKey<string, any, any>>(type: K["type"], ...args: K["__cacheKey"]["args"]): K;
-	remove<K extends CacheKey<string, any, any>>(cacheKey: K): void;
+	constructor({ onCreate, onDestroy }: {
+		onCreate?: (cacheKey: TCacheKey) => void
+		onDestroy?: (cacheKey: TCacheKey) => void
+	});
+	get<K extends TCacheKey>(type: K["type"], ...args: K["__cacheKey"]["args"]): K;
+	retain(cacheKey: TCacheKey): void;
+	release(cacheKey: TCacheKey): void;
 }

package/build/types/observable/internal/CacheKeys.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAmBA,cAAc,gBAAgB,eAAgB;AAG9C,cAAc,4BAA4B,2BAA4B;AACtE,cAAc,gCAAgC,+BAAgC;AAI9E,OAAO,cAAM,UAAU;;CAgBrB,YACEA,oBAAoB,0BACpBC,sBAAsB,sBACtBC,WAAWC,UAAU;CA6DvB,IAAI,UAAU,4BACZC,MAAM,EAAE,SACR,GAAG,MAAM,EAAE,cAAc,UACxB;CAMH,OAAO,UAAU,4BACfC,UAAU;AAIb","names":["whereCanonicalizer: WhereClauseCanonicalizer","orderByCanonicalizer: OrderByCanonicalizer","onCreate: (cacheKey: CacheKey) => void","cacheKey: CacheKey","type: K[\"type\"]","cacheKey: K"],"sources":["../../../../src/observable/internal/CacheKeys.ts"],"version":3,"file":"CacheKeys.d.ts"}
+{"mappings":"AAkBA,cAAc,gBAAgB,eAAgB;;;;;AAO9C,OAAO,cAAM,UAAU,kBAAkB,UAAU;;CAwCjD,YACE,EAAE,UAAU,WAGX,EAHwB;EACvB,YAAYA,UAAU;EACtB,aAAaA,UAAU;CACxB;CAwBH,IAAI,UAAU,WACZC,MAAM,EAAE,SACR,GAAG,MAAM,EAAE,cAAc,UACxB;CAsBH,OAAOD,UAAU;CAIjB,QAAQA,UAAU;AAgBnB","names":["cacheKey: TCacheKey","type: K[\"type\"]"],"sources":["../../../../src/observable/internal/CacheKeys.ts"],"version":3,"file":"CacheKeys.d.ts"}

package/build/types/observable/internal/Changes.d.ts

@@ -1,16 +1,19 @@
 import { MultiMap } from "mnemonist";
 import type { ObjectHolder } from "../../object/convertWireToOsdkObjects/ObjectHolder.js";
-import type { ListCacheKey } from "./ListQuery.js";
-import type { ObjectCacheKey } from "./ObjectQuery.js";
+import type { SpecificLinkCacheKey } from "./links/SpecificLinkCacheKey.js";
+import type { ListCacheKey } from "./list/ListCacheKey.js";
+import type { ObjectCacheKey } from "./object/ObjectCacheKey.js";
 export declare class Changes {
 	modifiedObjects: MultiMap<string, ObjectHolder>;
 	addedObjects: MultiMap<string, ObjectHolder>;
-	added: Set<ListCacheKey | ObjectCacheKey>;
-	modified: Set<ListCacheKey | ObjectCacheKey>;
-	deleted: Set<ListCacheKey | ObjectCacheKey>;
+	added: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey>;
+	modified: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey>;
+	deleted: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey>;
 	registerObject: (cacheKey: ObjectCacheKey, data: ObjectHolder, isNew: boolean) => void;
 	deleteObject: (cacheKey: ObjectCacheKey) => void;
 	registerList: (key: ListCacheKey) => void;
+	registerLink: (cacheKey: SpecificLinkCacheKey) => void;
+	deleteLink: (cacheKey: SpecificLinkCacheKey) => void;
 	isEmpty(): boolean;
 }
 export declare function createChangedObjects(): Changes;

package/build/types/observable/internal/Changes.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,SAAS,gBAAgB,WAAY;AACrC,cAAc,oBAAoB,uDAAwD;AAG1F,cAAc,oBAAoB,gBAAiB;AACnD,cAAc,sBAAsB,kBAAmB;AAEvD,OAAO,cAAM,QAAQ;CACnB,iBAAiB,iBAAiB;CAClC,cAAc,iBAAiB;CAE/B,OAAO,IAAI,eAAe;CAC1B,UAAU,IAAI,eAAe;CAC7B,SAAS,IAAI,eAAe;CAE5B,iBACEA,UAAU,gBACVC,MAAM,cACNC;CAMF,eAAgBF,UAAU;CAI1B,eAAgBG,KAAK;CAIrB;AASD;AAED,OAAO,iBAAS,wBAAwB;AAIxC,OAAO,iBAAS,4BAA4BC,SAAS","names":["cacheKey: ObjectCacheKey","data: ObjectHolder","isNew: boolean","key: ListCacheKey","changes: Changes"],"sources":["../../../../src/observable/internal/Changes.ts"],"version":3,"file":"Changes.d.ts"}
+{"mappings":"AAgBA,SAAS,gBAAgB,WAAY;AACrC,cAAc,oBAAoB,uDAAwD;AAG1F,cAAc,4BAA4B,iCAAkC;AAC5E,cAAc,oBAAoB,wBAAyB;AAC3D,cAAc,sBAAsB,4BAA6B;AAEjE,OAAO,cAAM,QAAQ;CACnB,iBAAiB,iBAAiB;CAClC,cAAc,iBAAiB;CAE/B,OAAO,IAAI,eAAe,iBAAiB;CAC3C,UAAU,IAAI,eAAe,iBAAiB;CAE9C,SAAS,IAAI,eAAe,iBAAiB;CAG7C,iBACEA,UAAU,gBACVC,MAAM,cACNC;CAMF,eAAgBF,UAAU;CAI1B,eAAgBG,KAAK;CAIrB,eAAgBC,UAAU;CAI1B,aAAcA,UAAU;CAIxB;AASD;AAED,OAAO,iBAAS,wBAAwB;AAIxC,OAAO,iBAAS,4BAA4BC,SAAS","names":["cacheKey: ObjectCacheKey","data: ObjectHolder","isNew: boolean","key: ListCacheKey","cacheKey: SpecificLinkCacheKey","changes: Changes"],"sources":["../../../../src/observable/internal/Changes.ts"],"version":3,"file":"Changes.d.ts"}

package/build/types/observable/internal/KnownCacheKey.d.ts

@@ -0,0 +1,4 @@
+import type { SpecificLinkCacheKey } from "./links/SpecificLinkCacheKey.js";
+import type { ListCacheKey } from "./list/ListCacheKey.js";
+import type { ObjectCacheKey } from "./object/ObjectCacheKey.js";
+export type KnownCacheKey = ObjectCacheKey | SpecificLinkCacheKey | ListCacheKey;

package/build/types/observable/internal/KnownCacheKey.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,4BAA4B,iCAAkC;AAC5E,cAAc,oBAAoB,wBAAyB;AAC3D,cAAc,sBAAsB,4BAA6B;AAEjE,YAAY,gBACR,iBACA,uBACA","names":[],"sources":["../../../../src/observable/internal/KnownCacheKey.ts"],"version":3,"file":"KnownCacheKey.d.ts"}

package/build/types/observable/internal/Layer.d.ts

@@ -1,4 +1,4 @@
-import type { CacheKey } from "./CacheKey.js";
+import type { KnownCacheKey } from "./KnownCacheKey.js";
 export declare class Layer {
 	#private;
 	constructor(parent: Layer | undefined, layerId: unknown);
@@ -6,15 +6,14 @@ export declare class Layer {
 	get layerId(): unknown;
 	addLayer(layerId: unknown): Layer;
 	removeLayer(layerId: unknown): Layer;
-	entries(): IterableIterator<[CacheKey<string, any, any>, Entry<any>]>;
-	keys(): IterableIterator<CacheKey<string, any, any>>;
-	get<K extends CacheKey<string, unknown, any>>(cacheKey: K): Entry<K> | undefined;
-	set<K extends CacheKey<string, unknown, any>>(cacheKey: K, value: Entry<K>): void;
+	entries(): IterableIterator<[KnownCacheKey, Entry<any>]>;
+	keys(): IterableIterator<KnownCacheKey>;
+	get<K extends KnownCacheKey>(cacheKey: K): Entry<K> | undefined;
+	set<K extends KnownCacheKey>(cacheKey: K, value: Entry<K>): void;
 }
-export declare class Entry<K extends CacheKey<any, any, any>> {
+export interface Entry<K extends KnownCacheKey> {
 	readonly cacheKey: K;
 	value: K["__cacheKey"]["value"] | undefined;
 	lastUpdated: number;
 	status: "init" | "loading" | "loaded" | "error";
-	constructor(cacheKey: K, value: K["__cacheKey"]["value"], lastUpdated: number, status?: "init" | "loading" | "loaded" | "error");
 }

package/build/types/observable/internal/Layer.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,gBAAgB,eAAgB;AAc9C,OAAO,cAAM,MAAM;;CAKjB,YAAYA,QAAQ,mBAAmBC;CAKvC,IAAI,eAAe;CAInB,IAAI;CAIJ,SAASA,mBAAmB;CAI5B,YAAYA,mBAAmB;CAc/B,WAAW,kBAAkB,4BAA4B;CAIzD,QAAQ,iBAAiB;CAIzB,AAAO,IAAI,UAAU,gCACnBC,UAAU,IACT,MAAM;CAKT,AAAO,IAAI,UAAU,gCACnBA,UAAU,GACVC,OAAO,MAAM;AAIhB;AAED,OAAO,cAAM,MAAM,UAAU,yBAAyB;CACpD,SAAS,UAAU;CACnB,OAAO,EAAE,cAAc;CACvB;CACA,QAAQ,SAAS,YAAY,WAAW;CAExC,YACED,UAAU,GACVE,OAAO,EAAE,cAAc,UACvBC,qBACAC,SAAQ,SAAS,YAAY,WAAW;AAO3C","names":["parent: Layer | undefined","layerId: unknown","cacheKey: K","value: Entry<K>","value: K[\"__cacheKey\"][\"value\"]","lastUpdated: number","status: \"init\" | \"loading\" | \"loaded\" | \"error\""],"sources":["../../../../src/observable/internal/Layer.ts"],"version":3,"file":"Layer.d.ts"}
+{"mappings":"AAgBA,cAAc,qBAAqB,oBAAqB;AAcxD,OAAO,cAAM,MAAM;;CAKjB,YAAYA,QAAQ,mBAAmBC;CAKvC,IAAI,eAAe;CAInB,IAAI;CAIJ,SAASA,mBAAmB;CAI5B,YAAYA,mBAAmB;CAc/B,WAAW,kBAAkB,eAAe;CAI5C,QAAQ,iBAAiB;CAIzB,AAAO,IAAI,UAAU,eACnBC,UAAU,IACT,MAAM;CAKT,AAAO,IAAI,UAAU,eACnBA,UAAU,GACVC,OAAO,MAAM;AAIhB;AAED,iBAAiB,MAAM,UAAU,eAAe;UACrC,UAAU;CACnB,OAAO,EAAE,cAAc;CACvB;CACA,QAAQ,SAAS,YAAY,WAAW;AACzC","names":["parent: Layer | undefined","layerId: unknown","cacheKey: K","value: Entry<K>"],"sources":["../../../../src/observable/internal/Layer.ts"],"version":3,"file":"Layer.d.ts"}

package/build/types/observable/internal/Layers.d.ts

@@ -0,0 +1,26 @@
+import type { Logger } from "@osdk/api";
+import type { BatchContext } from "./BatchContext.js";
+import { type Changes } from "./Changes.js";
+import { Layer } from "./Layer.js";
+import type { OptimisticId } from "./OptimisticId.js";
+import { Subjects } from "./Subjects.js";
+export declare class Layers {
+	#private;
+	logger?: Logger;
+	readonly subjects: Subjects;
+	constructor({ logger, onRevalidate }: {
+		logger?: Logger
+		onRevalidate: (changes: Changes, optimisticId?: OptimisticId) => Promise<void>
+	});
+	get top(): Layer;
+	get truth(): Layer;
+	remove(layerId: OptimisticId): void;
+	batch<X>({ optimisticId, changes }: {
+		optimisticId?: OptimisticId
+		changes: Changes
+	}, batchFn: (batchContext: BatchContext) => X): {
+		batchResult: BatchContext
+		retVal: X
+		changes: Changes
+	};
+}

package/build/types/observable/internal/Layers.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,cAAc,WAAY;AAExC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,eAAe,cAAe;AAI5C,SAAS,aAAa,YAAa;AACnC,cAAc,oBAAoB,mBAAoB;AACtD,SAAS,gBAAgB,eAAgB;AAGzC,OAAO,cAAM,OAAO;;CAQlB,SAAS;CAET,SAAS,UAAU;CAEnB,YACE,EAAE,QAAQ,cAMT,EANyB;EACxB,SAAS;EACT,eACEA,SAAS,SACTC,eAAe,iBACZ;CACN;CAQH,IAAI,OAAO;CAIX,IAAI,SAAS;CAIb,OAAOC,SAAS;CA2ChB,AAAO,MAAM,GACX,EAAE,cAAc,SAGf,EAH0B;EACzB,eAAe;EACf,SAAS;CACV,GACDC,UAAUC,cAAc,iBAAiB,IACxC;EACD,aAAa;EACb,QAAQ;EACR,SAAS;CACV;AA2FF","names":["changes: Changes","optimisticId?: OptimisticId","layerId: OptimisticId","batchFn: (batchContext: BatchContext) => X","batchContext: BatchContext"],"sources":["../../../../src/observable/internal/Layers.ts"],"version":3,"file":"Layers.d.ts"}

package/build/types/observable/internal/OrderByCanonicalizer.d.ts

@@ -1,11 +1,4 @@
 import type { Canonical } from "./Canonical.js";
-export declare class WeakRefTrie<X extends object> {
-	#private;
-	constructor(makeData?: (array: any[]) => X);
-	lookupArray<T extends IArguments | any[]>(array: T): X;
-	peekArray<T extends IArguments | any[]>(array: T): X | undefined;
-	removeArray<T extends IArguments | any[]>(array: T): X | undefined;
-}
 export declare class OrderByCanonicalizer {
 	#private;
 	canonicalize: (orderBy: Record<string, "asc" | "desc" | undefined>) => Canonical<Record<string, "asc" | "desc" | undefined>>;

package/build/types/observable/internal/OrderByCanonicalizer.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAmBA,cAAc,iBAAiB,gBAAiB;AAIhD,OAAO,cAAM,YAAY,kBAAkB;;CAWzC,YAAYA,YAAWC,iBAAiB;CAWxC,YAAY,UAAU,oBAAoBC,OAAO,IAAI;CAWrD,UAAU,UAAU,oBAAoBA,OAAO,IAAI;CAUnD,YAAY,UAAU,oBAAoBA,OAAO,IAAI;AAGtD;AAED,OAAO,cAAM,qBAAqB;;CA0BhC,eACEC,SAAS,eAAe,QAAQ,wBAC7B,UAAU,eAAe,QAAQ;AAMvC","names":["makeData: (array: any[]) => X","array: any[]","array: T","orderBy: Record<string, \"asc\" | \"desc\" | undefined>"],"sources":["../../../../src/observable/internal/OrderByCanonicalizer.ts"],"version":3,"file":"OrderByCanonicalizer.d.ts"}
+{"mappings":"AAkBA,cAAc,iBAAiB,gBAAiB;AAGhD,OAAO,cAAM,qBAAqB;;CA0BhC,eACEA,SAAS,eAAe,QAAQ,wBAC7B,UAAU,eAAe,QAAQ;AAMvC","names":["orderBy: Record<string, \"asc\" | \"desc\" | undefined>"],"sources":["../../../../src/observable/internal/OrderByCanonicalizer.ts"],"version":3,"file":"OrderByCanonicalizer.d.ts"}

package/build/types/observable/internal/Queries.d.ts

@@ -0,0 +1,9 @@
+import type { KnownCacheKey } from "./KnownCacheKey.js";
+import type { Query } from "./Query.js";
+export declare class Queries {
+	map: Map<KnownCacheKey, Query<any, any, any>>;
+	peek<K extends KnownCacheKey>(cacheKey: K): K["__cacheKey"]["query"] | undefined;
+	get<K extends KnownCacheKey>(cacheKey: K, createQuery: () => K["__cacheKey"]["query"]): K["__cacheKey"]["query"];
+	keys(): IterableIterator<KnownCacheKey>;
+	delete<K extends KnownCacheKey>(cacheKey: K): void;
+}

package/build/types/observable/internal/Queries.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AAExC,OAAO,cAAM,QAAQ;CAGnB,KAAK,IACH,eACA;CAGF,KAAK,UAAU,eACbA,UAAU,IACT,EAAE,cAAc;CAInB,IAAI,UAAU,eACZA,UAAU,GACVC,mBAAmB,EAAE,cAAc,WAClC,EAAE,cAAc;CASnB,QAAQ,iBAAiB;CAIzB,OAAO,UAAU,eAAeD,UAAU;AAI3C","names":["cacheKey: K","createQuery: () => K[\"__cacheKey\"][\"query\"]"],"sources":["../../../../src/observable/internal/Queries.ts"],"version":3,"file":"Queries.d.ts"}

package/build/types/observable/internal/Query.d.ts

@@ -1,28 +1,44 @@
 import type { Logger } from "@osdk/api";
 import type { Connectable, Observable, Observer, Subscribable, Subscription } from "rxjs";
-import type { CommonObserveOptions, Status } from "../ObservableClient.js";
-import type { CacheKey } from "./CacheKey.js";
+import type { CommonObserveOptions, Status } from "../ObservableClient/common.js";
+import type { BatchContext } from "./BatchContext.js";
+import type { CacheKeys } from "./CacheKeys.js";
 import type { Changes } from "./Changes.js";
+import type { KnownCacheKey } from "./KnownCacheKey.js";
 import type { Entry } from "./Layer.js";
 import type { OptimisticId } from "./OptimisticId.js";
-import type { BatchContext, Store, SubjectPayload } from "./Store.js";
+import type { Store } from "./Store.js";
+import type { SubjectPayload } from "./SubjectPayload.js";
 export declare abstract class Query<
-	KEY extends CacheKey,
+	KEY extends KnownCacheKey,
 	PAYLOAD,
 	O extends CommonObserveOptions
 > implements Subscribable<PAYLOAD> {
 	#private;
 	lastFetchStarted?: number;
-	pendingFetch?: Promise<unknown>;
+	pendingFetch?: Promise<void>;
 	retainCount: number;
 	options: O;
 	cacheKey: KEY;
 	store: Store;
 	abortController?: AbortController;
+	protected readonly cacheKeys: CacheKeys<KnownCacheKey>;
 	constructor(store: Store, observable: Observable<SubjectPayload<KEY>>, opts: O, cacheKey: KEY, logger?: Logger);
 	protected abstract _createConnectable(subject: Observable<SubjectPayload<KEY>>): Connectable<PAYLOAD>;
 	subscribe(observer: Observer<PAYLOAD>): Subscription;
 	/**
+	* Register a subscription's dedupeInterval value
+	*/
+	registerSubscriptionDedupeInterval(subscriptionId: string, dedupeInterval: number | undefined): void;
+	/**
+	* Unregister a subscription's dedupeInterval value
+	*/
+	unregisterSubscriptionDedupeInterval(subscriptionId: string): void;
+	/**
+	* Get the minimum dedupeInterval from all active subscriptions
+	*/
+	private getMinimumDedupeInterval;
+	/**
 	* Causes the query to revalidate. This will cause the query to fetch
 	* the latest data from the server and update the store if it is deemed
 	* "stale" or if `force` is true.
@@ -32,7 +48,7 @@ export declare abstract class Query<
 	*/
 	revalidate(force?: boolean): Promise<void>;
 	protected _preFetch(): void;
-	protected abstract _fetchAndStore(): Promise<unknown>;
+	protected abstract _fetchAndStore(): Promise<void>;
 	/**
 	* Sets the status of the query in the store (but does not store that in `changes`).
 	*
@@ -62,4 +78,5 @@ export declare abstract class Query<
 	*          revalidation is complete. Otherwise, undefined.
 	*/
 	maybeUpdateAndRevalidate?: (changes: Changes, optimisticId: OptimisticId | undefined) => Promise<void> | undefined;
+	abstract invalidateObjectType(objectType: string, changes: Changes | undefined): Promise<void>;
 }

package/build/types/observable/internal/Query.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,cAAc,WAAY;AACxC,cACE,aACA,YACA,UACA,cACA,oBACK,MAAO;AAEd,cAAc,sBAAsB,cAAc,wBAAyB;AAC3E,cAAc,gBAAgB,eAAgB;AAC9C,cAAc,eAAe,cAAe;AAC5C,cAAc,aAAa,YAAa;AACxC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,cAAc,OAAO,sBAAsB,YAAa;AAEtE,OAAO,uBAAe;CACpB,YAAY;CACZ;CACA,UAAU;aACC,aAAa,SAAS;;CACjC;CACA,eAAe;CACf;CACA,SAAS;CACT,UAAU;CACV,OAAO;CACP,kBAAkB;CAQlB,YACEA,OAAO,OACPC,YAAY,WAAW,eAAe,OACtCC,MAAM,GACNC,UAAU,KACVC,SAAS;CAoBX,mBAAmB,mBACjBC,SAAS,WAAW,eAAe,QAClC,YAAY;CAEf,AAAO,UACLC,UAAU,SAAS,WAClB;;;;;;;;;CAcH,AAAM,WAAWC,kBAAkB;CAiEnC,UAAU;CAEV,mBAAmB,kBAAkB;;;;;;;;CASrC,UACEC,QAAQ,QACRC,OAAO;CAWT;;;;CAWA,UAAU;;;;;;;;;CAUV,SAAS,aACPC,MAAM,IAAI,cAAc,UACxBF,QAAQ,QACRC,OAAO,eACN,MAAM;;;;;;;CAQT,4BACEE,SAAS,SACTC,cAAc,6BACX;AACN","names":["store: Store","observable: Observable<SubjectPayload<KEY>>","opts: O","cacheKey: KEY","logger?: Logger","subject: Observable<SubjectPayload<KEY>>","observer: Observer<PAYLOAD>","force?: boolean","status: Status","batch: BatchContext","data: KEY[\"__cacheKey\"][\"value\"]","changes: Changes","optimisticId: OptimisticId | undefined"],"sources":["../../../../src/observable/internal/Query.ts"],"version":3,"file":"Query.d.ts"}
+{"mappings":"AAgBA,cAAc,cAAc,WAAY;AACxC,cACE,aACA,YACA,UACA,cACA,oBACK,MAAO;AAEd,cACE,sBACA,cACK,+BAAgC;AACvC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,iBAAiB,gBAAiB;AAChD,cAAc,eAAe,cAAe;AAC5C,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AACxC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,aAAa,YAAa;AACxC,cAAc,sBAAsB,qBAAsB;AAE1D,OAAO,uBAAe;CACpB,YAAY;CACZ;CACA,UAAU;aACC,aAAa,SAAS;;CACjC;CACA,eAAe;CACf;CACA,SAAS;CACT,UAAU;CACV,OAAO;CACP,kBAAkB;CASlB,mBAAmB,WAAW,UAAU;CAExC,YACEA,OAAO,OACPC,YAAY,WAAW,eAAe,OACtCC,MAAM,GACNC,UAAU,KACVC,SAAS;CAqBX,mBAAmB,mBACjBC,SAAS,WAAW,eAAe,QAClC,YAAY;CAEf,AAAO,UACLC,UAAU,SAAS,WAClB;;;;CASH,mCACEC,wBACAC;;;;CAUF,qCAAqCD;;;;CAOrC,QAAQ;;;;;;;;;CAgBR,AAAM,WAAWE,kBAAkB;CAiEnC,UAAU;CAEV,mBAAmB,kBAAkB;;;;;;;;CASrC,UACEC,QAAQ,QACRC,OAAO;CAyBT;;;;CAWA,UAAU;;;;;;;;;CAUV,SAAS,aACPC,MAAM,IAAI,cAAc,UACxBF,QAAQ,QACRC,OAAO,eACN,MAAM;;;;;;;CAQT,4BACEE,SAAS,SACTC,cAAc,6BACX;CAEL,SAAS,qBACPC,oBACAC,SAAS,sBACR;AACJ","names":["store: Store","observable: Observable<SubjectPayload<KEY>>","opts: O","cacheKey: KEY","logger?: Logger","subject: Observable<SubjectPayload<KEY>>","observer: Observer<PAYLOAD>","subscriptionId: string","dedupeInterval: number | undefined","force?: boolean","status: Status","batch: BatchContext","data: KEY[\"__cacheKey\"][\"value\"]","changes: Changes","optimisticId: OptimisticId | undefined","objectType: string","changes: Changes | undefined"],"sources":["../../../../src/observable/internal/Query.ts"],"version":3,"file":"Query.d.ts"}

package/build/types/observable/internal/QuerySubscription.d.ts

@@ -0,0 +1 @@
+export {};

package/build/types/observable/internal/QuerySubscription.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"","names":[],"sources":["../../../../src/observable/internal/QuerySubscription.ts"],"version":3,"file":"QuerySubscription.d.ts"}

package/build/types/observable/internal/Store.d.ts

@@ -1,79 +1,69 @@
-import type { ActionDefinition, ActionEditResponse, ActionValidationResponse, InterfaceDefinition, ObjectTypeDefinition, PrimaryKeyType, WhereClause } from "@osdk/api";
-import type { Observer } from "rxjs";
-import { BehaviorSubject } from "rxjs";
+import type { ActionDefinition, ActionEditResponse, ActionValidationResponse, ObjectTypeDefinition, Osdk, PrimaryKeyType } from "@osdk/api";
 import type { ActionSignatureFromDef } from "../../actions/applyAction.js";
 import { type Client } from "../../Client.js";
-import type { ListPayload } from "../ListPayload.js";
-import type { ObjectPayload } from "../ObjectPayload.js";
-import type { ObserveListOptions, ObserveObjectOptions, OrderBy, Unsubscribable } from "../ObservableClient.js";
 import type { OptimisticBuilder } from "../OptimisticBuilder.js";
-import type { CacheKey } from "./CacheKey.js";
-import type { Canonical } from "./Canonical.js";
+import type { BatchContext } from "./BatchContext.js";
+import { CacheKeys } from "./CacheKeys.js";
 import { type Changes } from "./Changes.js";
-import { Entry } from "./Layer.js";
-import type { ListQueryOptions } from "./ListQuery.js";
-import { ListQuery } from "./ListQuery.js";
-import { ObjectQuery } from "./ObjectQuery.js";
+import type { KnownCacheKey } from "./KnownCacheKey.js";
+import type { Entry } from "./Layer.js";
+import { Layers } from "./Layers.js";
+import { LinksHelper } from "./links/LinksHelper.js";
+import { ListsHelper } from "./list/ListsHelper.js";
+import { ObjectsHelper } from "./object/ObjectsHelper.js";
 import { type OptimisticId } from "./OptimisticId.js";
 import { OrderByCanonicalizer } from "./OrderByCanonicalizer.js";
-import type { SimpleWhereClause } from "./SimpleWhereClause.js";
+import { Queries } from "./Queries.js";
+import type { Subjects } from "./Subjects.js";
 import { WhereClauseCanonicalizer } from "./WhereClauseCanonicalizer.js";
-export interface SubjectPayload<KEY extends CacheKey> extends Entry<KEY> {
-	isOptimistic: boolean;
-}
-export interface BatchContext {
-	changes: Changes;
-	createLayerIfNeeded: () => void;
-	optimisticWrite: boolean;
-	write: <K extends CacheKey<string, any, any>>(k: K, v: Entry<K>["value"], status: Entry<K>["status"]) => Entry<K>;
-	read: <K extends CacheKey<string, any, any>>(k: K) => Entry<K> | undefined;
-	delete: <K extends CacheKey<string, any, any>>(k: K, status: Entry<K>["status"]) => Entry<K>;
-}
 export declare namespace Store {
 	interface ApplyActionOptions {
 		optimisticUpdate?: (ctx: OptimisticBuilder) => void;
 	}
 }
+/**
+* Central data store with layered cache architecture.
+* - Truth layer: server state | Optimistic layers: pending changes
+* - Reference counting prevents memory leaks
+* - Batch operations ensure consistency
+*/
 export declare class Store {
 	#private;
-	whereCanonicalizer: WhereClauseCanonicalizer;
-	orderByCanonicalizer: OrderByCanonicalizer;
-	client: Client;
+	readonly whereCanonicalizer: WhereClauseCanonicalizer;
+	readonly orderByCanonicalizer: OrderByCanonicalizer;
+	readonly client: Client;
+	readonly cacheKeys: CacheKeys<KnownCacheKey>;
+	readonly queries: Queries;
+	readonly layers: Layers;
+	readonly subjects: Subjects;
+	readonly lists: ListsHelper;
+	readonly objects: ObjectsHelper;
+	readonly links: LinksHelper;
 	constructor(client: Client);
 	applyAction: <Q extends ActionDefinition<any>>(action: Q, args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] | Array<Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0]>, opts?: Store.ApplyActionOptions) => Promise<ActionEditResponse>;
 	validateAction: <Q extends ActionDefinition<any>>(action: Q, args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0]) => Promise<ActionValidationResponse>;
-	removeLayer(layerId: OptimisticId): void;
-	getCacheKey<K extends CacheKey<string, any, any>>(type: K["type"], ...args: K["__cacheKey"]["args"]): K;
-	peekSubject: <KEY extends CacheKey<string, any, any>>(cacheKey: KEY) => BehaviorSubject<SubjectPayload<KEY>> | undefined;
-	getSubject: <KEY extends CacheKey<string, any, any>>(cacheKey: KEY) => BehaviorSubject<SubjectPayload<KEY>>;
-	canonicalizeWhereClause<T extends ObjectTypeDefinition | InterfaceDefinition>(where: WhereClause<T>): Canonical<SimpleWhereClause>;
-	observeObject<T extends ObjectTypeDefinition | InterfaceDefinition>(apiName: T["apiName"] | T, pk: PrimaryKeyType<T>, options: ObserveObjectOptions<T>, subFn: Observer<ObjectPayload>): Unsubscribable;
-	observeList<T extends ObjectTypeDefinition | InterfaceDefinition>(options: ObserveListOptions<T>, subFn: Observer<ListPayload>): Unsubscribable;
-	peekQuery<K extends CacheKey>(cacheKey: K): K["__cacheKey"]["query"] | undefined;
-	getListQuery<T extends ObjectTypeDefinition | InterfaceDefinition>(def: Pick<T, "type" | "apiName">, where: WhereClause<T>, orderBy: Record<string, "asc" | "desc" | undefined>, opts: ListQueryOptions): ListQuery;
-	getObjectQuery<T extends ObjectTypeDefinition>(apiName: T["apiName"] | T, pk: PrimaryKeyType<T>): ObjectQuery;
-	getValue<K extends CacheKey<string, any, any>>(cacheKey: K): Entry<K> | undefined;
-	batch: <X>({ optimisticId, changes }: {
+	getValue<K extends KnownCacheKey>(cacheKey: K): Entry<K> | undefined;
+	batch<X>({ optimisticId, changes }: {
 		optimisticId?: OptimisticId
 		changes?: Changes
-	}, batchFn: (batchContext: BatchContext) => X) => {
+	}, batchFn: (batchContext: BatchContext) => X): {
 		batchResult: BatchContext
 		retVal: X
 		changes: Changes
 	};
 	invalidateObject<T extends ObjectTypeDefinition>(apiName: T["apiName"] | T, pk: PrimaryKeyType<T>): Promise<unknown>;
-	maybeRevalidateQueries(changes: Changes, optimisticId?: OptimisticId | undefined): Promise<void>;
 	/**
-	* @param apiName
-	* @param changes The changes we know about / to update
-	* @returns
+	* Invalidates all cache entries for a specific object type.
+	* This will revalidate:
+	* 1. All objects of the specified type
+	* 2. All lists of the specified type
+	* 3. All links where the source object is of the specified type
+	*
+	* @param apiName - The API name of the object type to invalidate
+	* @param changes - Optional changes object to track what has been modified
+	* @returns Promise that resolves when all invalidations are complete
 	*/
 	invalidateObjectType<T extends ObjectTypeDefinition>(apiName: T["apiName"] | T, changes: Changes | undefined): Promise<void>;
-	retain(cacheKey: CacheKey<string, any, any>): void;
-	release(cacheKey: CacheKey<string, any, any>): void;
+	invalidateAll(): Promise<void>;
+	invalidateObjects(objects: Osdk.Instance<ObjectTypeDefinition> | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>): Promise<void>;
 }
-export declare function invalidateList<T extends ObjectTypeDefinition>(store: Store, args: {
-	type: Pick<T, "apiName" | "type">
-	where?: WhereClause<T> | SimpleWhereClause
-	orderBy?: OrderBy<T>
-}): Promise<void>;