@xyo-network/sdk 7.4.0 → 7.4.2

package/dist/neutral/api-location-diviner.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/modules/api-location-diviner/LocationDiviner/LocationDivinerApi.ts", "../../src/modules/api-location-diviner/LocationDiviner/Queries/LocationHeatmapQuery/LocationHeatmapQuery.ts", "../../src/modules/api-location-diviner/LocationDiviner/Witnesses/CurrentLocationWitness.ts", "../../src/modules/api-location-diviner/LocationDiviner/Witnesses/LocationWitness.ts", "../../src/modules/api-location-diviner/LocationDiviner/Queries/LocationQuadkeyHeatmapQuery/LocationQuadkeyHeatmapQuery.ts", "../../src/modules/api-location-diviner/LocationDiviner/Queries/LocationQuerySchema.ts", "../../src/modules/api-location-diviner/LocationDiviner/Queries/LocationTimeRangeQuery/LocationTimeRangeQuery.ts", "../../src/modules/api-location-diviner/RemoteDivinerConfig.ts", "../../src/modules/api-location-diviner/RemoteDivinerError.ts"],
-  "sourcesContent": ["import { assertEx, fetchJsonClient } from '@ariestools/sdk'\nimport type { ApiConfig, ApiEnvelope } from '@xyo-network/sdk-protocol'\n\nimport type { GetLocationQueryResponse } from './models.ts'\nimport type { LocationQueryCreationResponse, SupportedLocationQueryCreationRequest } from './Queries/index.ts'\n\nclass LocationDivinerApi {\n  config: ApiConfig\n  constructor(config: ApiConfig) {\n    this.config = config\n  }\n\n  async getLocationQuery(hash: string): Promise<GetLocationQueryResponse> {\n    const response = await fetchJsonClient.get<ApiEnvelope<GetLocationQueryResponse>>(`${this.config.apiDomain}/location/query/${hash}`)\n    return assertEx(response.data?.data, () => 'LocationDivinerApi.getLocationQuery: missing response data')\n  }\n\n  async postLocationQuery(request: SupportedLocationQueryCreationRequest): Promise<LocationQueryCreationResponse> {\n    const response = await fetchJsonClient.post<ApiEnvelope<LocationQueryCreationResponse>>(`${this.config.apiDomain}/location/query`, { ...request })\n    return assertEx(response.data?.data, () => 'LocationDivinerApi.postLocationQuery: missing response data')\n  }\n}\n\nexport { LocationDivinerApi }\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { LocationWitnessSchema } from '../../Witnesses/index.ts'\n\nexport const LocationHeatmapQuerySchema: 'network.xyo.location.heatmap.query' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.query', true)\nexport type LocationHeatmapQuerySchema = typeof LocationHeatmapQuerySchema\n\nexport const LocationHeatmapAnswerSchema: 'network.xyo.location.heatmap.answer' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.answer', true)\nexport type LocationHeatmapAnswerSchema = typeof LocationHeatmapAnswerSchema\n\nexport const LocationHeatmapQueryZod: z.ZodMiniObject<{\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n  startTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n  stopTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n}, z.core.$strip> = z.object({\n  schema: z.literal(LocationWitnessSchema),\n  startTime: z.optional(z.string()),\n  stopTime: z.optional(z.string()),\n})\n\nexport type LocationHeatmapQuery = z.infer<typeof LocationHeatmapQueryZod>\n\nexport const isLocationHeatmapQuery: ReturnType<typeof zodIsFactory<LocationHeatmapQuery>> = zodIsFactory(LocationHeatmapQueryZod)\nexport const asLocationHeatmapQuery: ReturnType<typeof zodAsFactory<LocationHeatmapQuery>> = zodAsFactory(LocationHeatmapQueryZod, 'asLocationHeatmapQuery')\nexport const toLocationHeatmapQuery: ReturnType<typeof zodToFactory<LocationHeatmapQuery>> = zodToFactory(LocationHeatmapQueryZod, 'toLocationHeatmapQuery')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema, PayloadZodOfSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nexport const CurrentLocationWitnessSchema: 'co.coinapp.currentlocationwitness' & {\n  readonly __schema: true\n} = asSchema('co.coinapp.currentlocationwitness', true)\nexport type CurrentLocationWitnessSchema = typeof CurrentLocationWitnessSchema\n\nexport const CurrentLocationWitnessPayloadZod: z.ZodMiniObject<{\n  altitudeMeters: z.ZodMiniNumber<number>\n  directionDegrees: z.ZodMiniNumber<number>\n  latitude: z.ZodMiniNumber<number>\n  longitude: z.ZodMiniNumber<number>\n  quadkey: z.ZodMiniString<string>\n  schema: z.ZodMiniLiteral<CurrentLocationWitnessSchema>\n  speedKph: z.ZodMiniNumber<number>\n}, z.core.$strip> = z.extend(PayloadZodOfSchema(CurrentLocationWitnessSchema), {\n  altitudeMeters: z.number(),\n  directionDegrees: z.number(),\n  latitude: z.number(),\n  longitude: z.number(),\n  quadkey: z.string(),\n  speedKph: z.number(),\n})\n\nexport type CurrentLocationWitnessPayload = z.infer<typeof CurrentLocationWitnessPayloadZod>\n\nexport const isCurrentLocationWitnessPayload: ReturnType<typeof zodIsFactory<CurrentLocationWitnessPayload>>\n  = zodIsFactory(CurrentLocationWitnessPayloadZod)\nexport const asCurrentLocationWitnessPayload: ReturnType<typeof zodAsFactory<CurrentLocationWitnessPayload>>\n  = zodAsFactory(CurrentLocationWitnessPayloadZod, 'asCurrentLocationWitnessPayload')\nexport const toCurrentLocationWitnessPayload: ReturnType<typeof zodToFactory<CurrentLocationWitnessPayload>>\n  = zodToFactory(CurrentLocationWitnessPayloadZod, 'toCurrentLocationWitnessPayload')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema, PayloadZodOfSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nexport const LocationWitnessSchema: 'network.xyo.location' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location', true)\nexport type LocationWitnessSchema = typeof LocationWitnessSchema\n\nexport interface Coordinates {\n  accuracy: number | null\n  altitude: number | null\n  altitudeAccuracy: number | null\n  heading: number | null\n  latitude: number\n  longitude: number\n  speed: number | null\n}\nexport interface CurrentLocation {\n  coords: Coordinates\n  timestamp: number\n}\n\nexport const LocationWitnessPayloadZod: z.ZodMiniObject<{\n  currentLocation: z.ZodMiniCustom<CurrentLocation, CurrentLocation>\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n}, z.core.$strip> = z.extend(PayloadZodOfSchema(LocationWitnessSchema), { currentLocation: z.custom<CurrentLocation>() })\n\nexport type LocationWitnessPayload = z.infer<typeof LocationWitnessPayloadZod>\n\nexport const isLocationWitnessPayload: ReturnType<typeof zodIsFactory<LocationWitnessPayload>> = zodIsFactory(LocationWitnessPayloadZod)\nexport const asLocationWitnessPayload: ReturnType<typeof zodAsFactory<LocationWitnessPayload>> = zodAsFactory(LocationWitnessPayloadZod, 'asLocationWitnessPayload')\nexport const toLocationWitnessPayload: ReturnType<typeof zodToFactory<LocationWitnessPayload>> = zodToFactory(LocationWitnessPayloadZod, 'toLocationWitnessPayload')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { LocationWitnessSchema } from '../../Witnesses/index.ts'\n\nexport const LocationQuadkeyHeatmapQuerySchema: 'network.xyo.location.heatmap.quadkey.query' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.quadkey.query', true)\nexport type LocationQuadkeyHeatmapQuerySchema = typeof LocationQuadkeyHeatmapQuerySchema\n\nexport const LocationQuadkeyHeatmapAnswerSchema: 'network.xyo.location.heatmap.quadkey.answer' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.quadkey.answer', true)\nexport type LocationQuadkeyHeatmapAnswerSchema = typeof LocationQuadkeyHeatmapAnswerSchema\n\nexport const LocationQuadkeyHeatmapQueryZod: z.ZodMiniObject<{\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n  startTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n  stopTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n}, z.core.$strip> = z.object({\n  schema: z.literal(LocationWitnessSchema),\n  startTime: z.optional(z.string()),\n  stopTime: z.optional(z.string()),\n})\n\nexport type LocationQuadkeyHeatmapQuery = z.infer<typeof LocationQuadkeyHeatmapQueryZod>\n\nexport const isLocationQuadkeyHeatmapQuery: ReturnType<typeof zodIsFactory<LocationQuadkeyHeatmapQuery>>\n  = zodIsFactory(LocationQuadkeyHeatmapQueryZod)\nexport const asLocationQuadkeyHeatmapQuery: ReturnType<typeof zodAsFactory<LocationQuadkeyHeatmapQuery>>\n  = zodAsFactory(LocationQuadkeyHeatmapQueryZod, 'asLocationQuadkeyHeatmapQuery')\nexport const toLocationQuadkeyHeatmapQuery: ReturnType<typeof zodToFactory<LocationQuadkeyHeatmapQuery>>\n  = zodToFactory(LocationQuadkeyHeatmapQueryZod, 'toLocationQuadkeyHeatmapQuery')\n", "import type { Schema } from '@xyo-network/sdk-protocol'\n\nimport type { LocationHeatmapQuerySchema } from './LocationHeatmapQuery/index.ts'\nimport type { LocationQuadkeyHeatmapQuerySchema } from './LocationQuadkeyHeatmapQuery/index.ts'\nimport type { LocationTimeRangeQuerySchema } from './LocationTimeRangeQuery/index.ts'\n\nexport type LocationQuerySchema = LocationQuadkeyHeatmapQuerySchema | LocationHeatmapQuerySchema | LocationTimeRangeQuerySchema\n\nconst locationQuerySchemas: Record<string, true> = {\n  'network.xyo.location.heatmap.quadkey.query': true,\n  'network.xyo.location.heatmap.query': true,\n  'network.xyo.location.range.query': true,\n}\n\nexport const isSupportedLocationQuerySchema = (schema: Schema): schema is LocationQuerySchema => {\n  return locationQuerySchemas[schema as LocationQuerySchema] || false\n}\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { LocationWitnessSchema } from '../../Witnesses/index.ts'\n\nexport const LocationTimeRangeQuerySchema: 'network.xyo.location.range.query' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.range.query', true)\nexport type LocationTimeRangeQuerySchema = typeof LocationTimeRangeQuerySchema\n\nexport const LocationTimeRangeAnswerSchema: 'network.xyo.location.range.answer' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.range.answer', true)\nexport type LocationTimeRangeAnswerSchema = typeof LocationTimeRangeAnswerSchema\n\nexport const LocationTimeRangeQueryZod: z.ZodMiniObject<{\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n  startTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n  stopTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n}, z.core.$strip> = z.object({\n  schema: z.literal(LocationWitnessSchema),\n  startTime: z.optional(z.string()),\n  // TODO: Bounding rectangle, etc.\n  stopTime: z.optional(z.string()),\n})\n\nexport type LocationTimeRangeQuery = z.infer<typeof LocationTimeRangeQueryZod>\n\nexport const isLocationTimeRangeQuery: ReturnType<typeof zodIsFactory<LocationTimeRangeQuery>> = zodIsFactory(LocationTimeRangeQueryZod)\nexport const asLocationTimeRangeQuery: ReturnType<typeof zodAsFactory<LocationTimeRangeQuery>> = zodAsFactory(LocationTimeRangeQueryZod, 'asLocationTimeRangeQuery')\nexport const toLocationTimeRangeQuery: ReturnType<typeof zodToFactory<LocationTimeRangeQuery>> = zodToFactory(LocationTimeRangeQueryZod, 'toLocationTimeRangeQuery')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport type { ArchivistApi } from '@xyo-network/sdk-protocol'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { DivinerConfigZod } from '#diviner-model'\n\nexport const RemoteDivinerConfigSchema: 'network.xyo.diviner.remote.config' & {\n  readonly __schema: true\n} = asSchema('network.xyo.diviner.remote.config', true)\nexport type RemoteDivinerConfigSchema = typeof RemoteDivinerConfigSchema\n\nexport const RemoteDivinerConfigZod: z.ZodMiniObject<\n  Omit<(typeof DivinerConfigZod)['shape'], 'schema'> & {\n    /** @deprecated use in params instead */\n    api: z.ZodMiniOptional<z.ZodMiniCustom<ArchivistApi, ArchivistApi>>\n    archive: z.ZodMiniOptional<z.ZodMiniString<string>>\n    schema: z.ZodMiniLiteral<RemoteDivinerConfigSchema>\n  },\n  z.core.$strip\n> = z.extend(DivinerConfigZod, {\n  /** @deprecated use in params instead */\n  api: z.optional(z.custom<ArchivistApi>()),\n  archive: z.optional(z.string()),\n  schema: z.literal(RemoteDivinerConfigSchema),\n})\n\nexport type RemoteDivinerConfig = z.infer<typeof RemoteDivinerConfigZod>\n\nexport const isRemoteDivinerConfig: ReturnType<typeof zodIsFactory<RemoteDivinerConfig>> = zodIsFactory(RemoteDivinerConfigZod)\nexport const asRemoteDivinerConfig: ReturnType<typeof zodAsFactory<RemoteDivinerConfig>> = zodAsFactory(RemoteDivinerConfigZod, 'asRemoteDivinerConfig')\nexport const toRemoteDivinerConfig: ReturnType<typeof zodToFactory<RemoteDivinerConfig>> = zodToFactory(RemoteDivinerConfigZod, 'toRemoteDivinerConfig')\n", "import { isString } from '@ariestools/sdk'\n\nexport class RemoteDivinerError extends Error {\n  isRemoteDivinerError = true\n  constructor(action: string, error: Error['cause'], message?: string) {\n    const messageString = isString(message) ? ` (${message})` : ''\n    super(`Remote Diviner [${action}] failed${messageString}`, { cause: error })\n  }\n\n  static isRemoteDivinerError(error: unknown): RemoteDivinerError | undefined {\n    return (error as RemoteDivinerError).isRemoteDivinerError ? (error as RemoteDivinerError) : undefined\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { assertEx, fetchJsonClient } from '@ariestools/sdk'\n\nimport type { GetLocationQueryResponse } from './models.ts'\nimport type { LocationQueryCreationResponse, SupportedLocationQueryCreationRequest } from './Queries/index.ts'\n\ninterface LocationDivinerApiConfig {\n  apiDomain: string\n}\n\ninterface JsonDataEnvelope<T> {\n  data?: T\n}\n\nclass LocationDivinerApi {\n  config: LocationDivinerApiConfig\n  constructor(config: LocationDivinerApiConfig) {\n    this.config = config\n  }\n\n  async getLocationQuery(hash: string): Promise<GetLocationQueryResponse> {\n    const response = await fetchJsonClient.get<JsonDataEnvelope<GetLocationQueryResponse>>(`${this.config.apiDomain}/location/query/${hash}`)\n    return assertEx(response.data?.data, () => 'LocationDivinerApi.getLocationQuery: missing response data')\n  }\n\n  async postLocationQuery(request: SupportedLocationQueryCreationRequest): Promise<LocationQueryCreationResponse> {\n    const response = await fetchJsonClient.post<JsonDataEnvelope<LocationQueryCreationResponse>>(`${this.config.apiDomain}/location/query`, { ...request })\n    return assertEx(response.data?.data, () => 'LocationDivinerApi.postLocationQuery: missing response data')\n  }\n}\n\nexport { LocationDivinerApi }\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { LocationWitnessSchema } from '../../Witnesses/index.ts'\n\nexport const LocationHeatmapQuerySchema: 'network.xyo.location.heatmap.query' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.query', true)\nexport type LocationHeatmapQuerySchema = typeof LocationHeatmapQuerySchema\n\nexport const LocationHeatmapAnswerSchema: 'network.xyo.location.heatmap.answer' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.answer', true)\nexport type LocationHeatmapAnswerSchema = typeof LocationHeatmapAnswerSchema\n\nexport const LocationHeatmapQueryZod: z.ZodMiniObject<{\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n  startTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n  stopTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n}, z.core.$strip> = z.object({\n  schema: z.literal(LocationWitnessSchema),\n  startTime: z.optional(z.string()),\n  stopTime: z.optional(z.string()),\n})\n\nexport type LocationHeatmapQuery = z.infer<typeof LocationHeatmapQueryZod>\n\nexport const isLocationHeatmapQuery: ReturnType<typeof zodIsFactory<LocationHeatmapQuery>> = zodIsFactory(LocationHeatmapQueryZod)\nexport const asLocationHeatmapQuery: ReturnType<typeof zodAsFactory<LocationHeatmapQuery>> = zodAsFactory(LocationHeatmapQueryZod, 'asLocationHeatmapQuery')\nexport const toLocationHeatmapQuery: ReturnType<typeof zodToFactory<LocationHeatmapQuery>> = zodToFactory(LocationHeatmapQueryZod, 'toLocationHeatmapQuery')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema, PayloadZodOfSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nexport const CurrentLocationWitnessSchema: 'co.coinapp.currentlocationwitness' & {\n  readonly __schema: true\n} = asSchema('co.coinapp.currentlocationwitness', true)\nexport type CurrentLocationWitnessSchema = typeof CurrentLocationWitnessSchema\n\nexport const CurrentLocationWitnessPayloadZod: z.ZodMiniObject<{\n  altitudeMeters: z.ZodMiniNumber<number>\n  directionDegrees: z.ZodMiniNumber<number>\n  latitude: z.ZodMiniNumber<number>\n  longitude: z.ZodMiniNumber<number>\n  quadkey: z.ZodMiniString<string>\n  schema: z.ZodMiniLiteral<CurrentLocationWitnessSchema>\n  speedKph: z.ZodMiniNumber<number>\n}, z.core.$strip> = z.extend(PayloadZodOfSchema(CurrentLocationWitnessSchema), {\n  altitudeMeters: z.number(),\n  directionDegrees: z.number(),\n  latitude: z.number(),\n  longitude: z.number(),\n  quadkey: z.string(),\n  speedKph: z.number(),\n})\n\nexport type CurrentLocationWitnessPayload = z.infer<typeof CurrentLocationWitnessPayloadZod>\n\nexport const isCurrentLocationWitnessPayload: ReturnType<typeof zodIsFactory<CurrentLocationWitnessPayload>>\n  = zodIsFactory(CurrentLocationWitnessPayloadZod)\nexport const asCurrentLocationWitnessPayload: ReturnType<typeof zodAsFactory<CurrentLocationWitnessPayload>>\n  = zodAsFactory(CurrentLocationWitnessPayloadZod, 'asCurrentLocationWitnessPayload')\nexport const toCurrentLocationWitnessPayload: ReturnType<typeof zodToFactory<CurrentLocationWitnessPayload>>\n  = zodToFactory(CurrentLocationWitnessPayloadZod, 'toCurrentLocationWitnessPayload')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema, PayloadZodOfSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nexport const LocationWitnessSchema: 'network.xyo.location' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location', true)\nexport type LocationWitnessSchema = typeof LocationWitnessSchema\n\nexport interface Coordinates {\n  accuracy: number | null\n  altitude: number | null\n  altitudeAccuracy: number | null\n  heading: number | null\n  latitude: number\n  longitude: number\n  speed: number | null\n}\nexport interface CurrentLocation {\n  coords: Coordinates\n  timestamp: number\n}\n\nexport const LocationWitnessPayloadZod: z.ZodMiniObject<{\n  currentLocation: z.ZodMiniCustom<CurrentLocation, CurrentLocation>\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n}, z.core.$strip> = z.extend(PayloadZodOfSchema(LocationWitnessSchema), { currentLocation: z.custom<CurrentLocation>() })\n\nexport type LocationWitnessPayload = z.infer<typeof LocationWitnessPayloadZod>\n\nexport const isLocationWitnessPayload: ReturnType<typeof zodIsFactory<LocationWitnessPayload>> = zodIsFactory(LocationWitnessPayloadZod)\nexport const asLocationWitnessPayload: ReturnType<typeof zodAsFactory<LocationWitnessPayload>> = zodAsFactory(LocationWitnessPayloadZod, 'asLocationWitnessPayload')\nexport const toLocationWitnessPayload: ReturnType<typeof zodToFactory<LocationWitnessPayload>> = zodToFactory(LocationWitnessPayloadZod, 'toLocationWitnessPayload')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { LocationWitnessSchema } from '../../Witnesses/index.ts'\n\nexport const LocationQuadkeyHeatmapQuerySchema: 'network.xyo.location.heatmap.quadkey.query' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.quadkey.query', true)\nexport type LocationQuadkeyHeatmapQuerySchema = typeof LocationQuadkeyHeatmapQuerySchema\n\nexport const LocationQuadkeyHeatmapAnswerSchema: 'network.xyo.location.heatmap.quadkey.answer' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.heatmap.quadkey.answer', true)\nexport type LocationQuadkeyHeatmapAnswerSchema = typeof LocationQuadkeyHeatmapAnswerSchema\n\nexport const LocationQuadkeyHeatmapQueryZod: z.ZodMiniObject<{\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n  startTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n  stopTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n}, z.core.$strip> = z.object({\n  schema: z.literal(LocationWitnessSchema),\n  startTime: z.optional(z.string()),\n  stopTime: z.optional(z.string()),\n})\n\nexport type LocationQuadkeyHeatmapQuery = z.infer<typeof LocationQuadkeyHeatmapQueryZod>\n\nexport const isLocationQuadkeyHeatmapQuery: ReturnType<typeof zodIsFactory<LocationQuadkeyHeatmapQuery>>\n  = zodIsFactory(LocationQuadkeyHeatmapQueryZod)\nexport const asLocationQuadkeyHeatmapQuery: ReturnType<typeof zodAsFactory<LocationQuadkeyHeatmapQuery>>\n  = zodAsFactory(LocationQuadkeyHeatmapQueryZod, 'asLocationQuadkeyHeatmapQuery')\nexport const toLocationQuadkeyHeatmapQuery: ReturnType<typeof zodToFactory<LocationQuadkeyHeatmapQuery>>\n  = zodToFactory(LocationQuadkeyHeatmapQueryZod, 'toLocationQuadkeyHeatmapQuery')\n", "import type { Schema } from '@xyo-network/sdk-protocol'\n\nimport type { LocationHeatmapQuerySchema } from './LocationHeatmapQuery/index.ts'\nimport type { LocationQuadkeyHeatmapQuerySchema } from './LocationQuadkeyHeatmapQuery/index.ts'\nimport type { LocationTimeRangeQuerySchema } from './LocationTimeRangeQuery/index.ts'\n\nexport type LocationQuerySchema = LocationQuadkeyHeatmapQuerySchema | LocationHeatmapQuerySchema | LocationTimeRangeQuerySchema\n\nconst locationQuerySchemas: Record<string, true> = {\n  'network.xyo.location.heatmap.quadkey.query': true,\n  'network.xyo.location.heatmap.query': true,\n  'network.xyo.location.range.query': true,\n}\n\nexport const isSupportedLocationQuerySchema = (schema: Schema): schema is LocationQuerySchema => {\n  return locationQuerySchemas[schema as LocationQuerySchema] || false\n}\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { LocationWitnessSchema } from '../../Witnesses/index.ts'\n\nexport const LocationTimeRangeQuerySchema: 'network.xyo.location.range.query' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.range.query', true)\nexport type LocationTimeRangeQuerySchema = typeof LocationTimeRangeQuerySchema\n\nexport const LocationTimeRangeAnswerSchema: 'network.xyo.location.range.answer' & {\n  readonly __schema: true\n} = asSchema('network.xyo.location.range.answer', true)\nexport type LocationTimeRangeAnswerSchema = typeof LocationTimeRangeAnswerSchema\n\nexport const LocationTimeRangeQueryZod: z.ZodMiniObject<{\n  schema: z.ZodMiniLiteral<LocationWitnessSchema>\n  startTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n  stopTime: z.ZodMiniOptional<z.ZodMiniString<string>>\n}, z.core.$strip> = z.object({\n  schema: z.literal(LocationWitnessSchema),\n  startTime: z.optional(z.string()),\n  // TODO: Bounding rectangle, etc.\n  stopTime: z.optional(z.string()),\n})\n\nexport type LocationTimeRangeQuery = z.infer<typeof LocationTimeRangeQueryZod>\n\nexport const isLocationTimeRangeQuery: ReturnType<typeof zodIsFactory<LocationTimeRangeQuery>> = zodIsFactory(LocationTimeRangeQueryZod)\nexport const asLocationTimeRangeQuery: ReturnType<typeof zodAsFactory<LocationTimeRangeQuery>> = zodAsFactory(LocationTimeRangeQueryZod, 'asLocationTimeRangeQuery')\nexport const toLocationTimeRangeQuery: ReturnType<typeof zodToFactory<LocationTimeRangeQuery>> = zodToFactory(LocationTimeRangeQueryZod, 'toLocationTimeRangeQuery')\n", "import {\n  zodAsFactory, zodIsFactory, zodToFactory,\n} from '@ariestools/sdk'\nimport { asSchema } from '@xyo-network/sdk-protocol'\nimport * as z from 'zod/mini'\n\nimport { DivinerConfigZod } from '#diviner-model'\n\nexport const RemoteDivinerConfigSchema: 'network.xyo.diviner.remote.config' & {\n  readonly __schema: true\n} = asSchema('network.xyo.diviner.remote.config', true)\nexport type RemoteDivinerConfigSchema = typeof RemoteDivinerConfigSchema\n\nexport const RemoteDivinerConfigZod: z.ZodMiniObject<\n  Omit<(typeof DivinerConfigZod)['shape'], 'schema'> & {\n    /** @deprecated use in params instead */\n    api: z.ZodMiniOptional<z.ZodMiniCustom<object, object>>\n    archive: z.ZodMiniOptional<z.ZodMiniString<string>>\n    schema: z.ZodMiniLiteral<RemoteDivinerConfigSchema>\n  },\n  z.core.$strip\n> = z.extend(DivinerConfigZod, {\n  /** @deprecated use in params instead */\n  api: z.optional(z.custom<object>()),\n  archive: z.optional(z.string()),\n  schema: z.literal(RemoteDivinerConfigSchema),\n})\n\nexport type RemoteDivinerConfig = z.infer<typeof RemoteDivinerConfigZod>\n\nexport const isRemoteDivinerConfig: ReturnType<typeof zodIsFactory<RemoteDivinerConfig>> = zodIsFactory(RemoteDivinerConfigZod)\nexport const asRemoteDivinerConfig: ReturnType<typeof zodAsFactory<RemoteDivinerConfig>> = zodAsFactory(RemoteDivinerConfigZod, 'asRemoteDivinerConfig')\nexport const toRemoteDivinerConfig: ReturnType<typeof zodToFactory<RemoteDivinerConfig>> = zodToFactory(RemoteDivinerConfigZod, 'toRemoteDivinerConfig')\n", "import { isString } from '@ariestools/sdk'\n\nexport class RemoteDivinerError extends Error {\n  isRemoteDivinerError = true\n  constructor(action: string, error: Error['cause'], message?: string) {\n    const messageString = isString(message) ? ` (${message})` : ''\n    super(`Remote Diviner [${action}] failed${messageString}`, { cause: error })\n  }\n\n  static isRemoteDivinerError(error: unknown): RemoteDivinerError | undefined {\n    return (error as RemoteDivinerError).isRemoteDivinerError ? (error as RemoteDivinerError) : undefined\n  }\n}\n"],
+  "mappings": "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",
   "names": ["zodAsFactory", "zodIsFactory", "zodToFactory", "asSchema", "z", "zodAsFactory", "zodIsFactory", "zodToFactory", "asSchema", "PayloadZodOfSchema", "z", "asSchema", "zodIsFactory", "zodAsFactory", "zodToFactory", "zodAsFactory", "zodIsFactory", "zodToFactory", "asSchema", "z", "asSchema", "zodIsFactory", "zodAsFactory", "zodToFactory", "zodAsFactory", "zodIsFactory", "zodToFactory", "asSchema", "z", "asSchema", "zodIsFactory", "zodAsFactory", "zodToFactory", "zodAsFactory", "zodIsFactory", "zodToFactory", "asSchema", "z"]
 }

package/dist/neutral/archivist-abstract.mjs

@@ -1,7 +1,6 @@
 // src/modules/archivist-abstract/AbstractArchivist.ts
 import {
   assertEx,
-  difference,
   exists,
   isNull,
   isUndefined
@@ -40,6 +39,8 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   _parentArchivists;
   _payloadCountGauge;
   _payloadCountMeter;
+  activeCacheMutations = 0;
+  cacheGeneration = 0;
   // do not override this!  It is meant to get the this.defaultNextLimitSetting and work if it is overridden
   static get defaultNextLimit() {
     return this.defaultNextLimitSetting;
@@ -102,9 +103,7 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
         await this.globalReentrancyMutex?.acquire();
         return await this.busy(async () => {
           await this.startedAsync("throw");
-          await this.clearHandler();
-          this.reportPayloadCount();
-          await this.emit("cleared", { mod: this });
+          await this.clearWithConfig();
         });
       } finally {
         this.globalReentrancyMutex?.release();
@@ -188,6 +187,7 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   async insert(payloads) {
     this._noOverride("insert");
     this.isSupportedQuery(ArchivistInsertQuerySchema, "insert");
+    const snapshot = this.snapshotPayloads(payloads);
     return await this.spanAsync(`${this.id}|insert`, async () => {
       if (this.reentrancy?.scope === "global" && this.reentrancy.action === "skip" && this.globalReentrancyMutex?.isLocked()) {
         return [];
@@ -196,7 +196,7 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
         await this.globalReentrancyMutex?.acquire();
         return await this.busy(async () => {
           await this.startedAsync("throw");
-          return await this.insertWithConfig(PayloadBuilder.omitStorageMeta(payloads));
+          return await this.insertWithConfig(snapshot);
         });
       } finally {
         this.globalReentrancyMutex?.release();
@@ -206,7 +206,7 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   async insertQuery(payloads, account) {
     this._noOverride("insertQuery");
     const queryPayload = { schema: ArchivistInsertQuerySchema };
-    return await this.sendQueryRaw(queryPayload, payloads, account);
+    return await this.sendQueryRaw(queryPayload, this.snapshotPayloads(payloads), account);
   }
   async next(options) {
     this._noOverride("next");
@@ -261,6 +261,13 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   clearHandler() {
     throw new Error(NOT_IMPLEMENTED);
   }
+  async clearWithConfig(config) {
+    await this.withCacheMutation(async () => {
+      await this.withStorageMutation(async () => await this.clearHandler());
+      this.reportPayloadCount();
+      if (config?.emitEvents ?? true) await this.emit("cleared", { mod: this });
+    });
+  }
   commitHandler() {
     throw new Error(NOT_IMPLEMENTED);
   }
@@ -268,18 +275,20 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
     throw new Error(NOT_IMPLEMENTED);
   }
   async deleteWithConfig(hashes, config) {
-    const emitEvents = config?.emitEvents ?? true;
-    const payloads = await this.deleteHandler(hashes);
-    const hashesDeleted = payloads.map((p) => p._hash);
-    if (emitEvents) {
-      await this.emit("deleted", {
-        hashes: hashesDeleted,
-        payloads,
-        mod: this
-      });
-    }
-    this.reportPayloadCount();
-    return payloads;
+    return await this.withCacheMutation(async () => {
+      const emitEvents = config?.emitEvents ?? true;
+      const payloads = await this.withStorageMutation(async () => await this.deleteHandler(hashes));
+      const hashesDeleted = payloads.map((p) => p._hash);
+      if (emitEvents) {
+        await this.emit("deleted", {
+          hashes: hashesDeleted,
+          payloads,
+          mod: this
+        });
+      }
+      this.reportPayloadCount();
+      return payloads;
+    });
   }
   generateStats() {
     return {
@@ -287,18 +296,18 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
       schema: ArchivistStatsPayloadSchema
     };
   }
+  /**
+   * Inspect local stored roots without consulting public projections, caches or
+   * parents. Backends whose getHandler synthesizes views must override this hook
+   * to read their primary record keys directly.
+   */
+  async getExistingLocalPayloads(hashes) {
+    return await this.exactRepresentations(await this.getHandler(hashes), hashes);
+  }
   async getFromParent(hashes, archivist) {
-    const foundPairs = (await PayloadBuilder.dataHashPairs(await archivist.get(hashes))).filter(([, hash]) => {
-      const askedFor = hashes.includes(hash);
-      if (!askedFor) {
-        console.warn(`Parent returned payload with hash not asked for: ${hash}`);
-      }
-      return askedFor;
-    });
-    const foundHashes = new Set(foundPairs.map(([, hash]) => hash));
-    const foundPayloads = foundPairs.map(([payload]) => payload);
-    const notfound = hashes.filter((hash) => !foundHashes.has(hash));
-    return [foundPayloads, notfound];
+    const foundPayloads = await this.requestedRepresentations(await archivist.get(hashes), hashes);
+    const foundHashes = new Set(foundPayloads.map((payload) => payload._hash));
+    return [foundPayloads, hashes.filter((hash) => !foundHashes.has(hash))];
   }
   async getFromParents(hashes) {
     const parents = Object.values((await this.parentArchivists())?.read ?? {});
@@ -319,58 +328,25 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   getHandler(_hashes) {
     throw new Error(NOT_IMPLEMENTED);
   }
-  // eslint-disable-next-line max-statements
   async getWithConfig(hashes, _config) {
-    const requestedHashes = new Set(hashes);
-    const cache = this._getCache;
-    let fromCache = [];
-    let remainingHashes = [...requestedHashes];
-    if (cache !== void 0) {
-      fromCache = hashes.map((hash) => cache.get(hash)).filter(exists);
-      remainingHashes = hashes.filter((hash) => !fromCache.some((payload) => payload?._hash === hash || payload?._dataHash === hash));
-    }
-    const fromGet = await this.getHandler([...remainingHashes]);
-    const gotten = [...fromCache, ...fromGet].toSorted(PayloadBuilder.compareStorageMeta);
-    const foundPayloads = [];
-    const foundHashes = /* @__PURE__ */ new Set();
-    for (const payload of gotten) {
-      const map = {
-        [payload._hash]: payload,
-        [payload._dataHash]: payload
-      };
-      for (const [key, payload2] of Object.entries(map)) {
-        let requestedPayloadFound = false;
-        const hash = key;
-        if (requestedHashes.has(hash) && !foundHashes.has(hash)) {
-          requestedPayloadFound = true;
-          foundHashes.add(hash);
-        }
-        if (requestedPayloadFound) foundPayloads.push(payload2);
-      }
-    }
-    const notFoundHashes = [...difference(requestedHashes, foundHashes)];
-    const [parentFoundPayloads] = await this.getFromParents(notFoundHashes);
-    if (this.storeParentReads) {
+    const requestedHashes = [...new Set(hashes)];
+    const generation = this.cacheGeneration;
+    const cache = this.activeCacheMutations === 0 ? this._getCache : void 0;
+    const fromCache = await this.requestedRepresentations(requestedHashes.map((hash) => cache?.get(hash)).filter(exists), requestedHashes);
+    const cachedHashes = new Set(fromCache.map((payload) => payload._hash));
+    const remainingHashes = requestedHashes.filter((hash) => !cachedHashes.has(hash));
+    const fromGet = await this.requestedRepresentations(await this.getHandler(remainingHashes), remainingHashes);
+    const foundHashes = new Set([...fromCache, ...fromGet].map((payload) => payload._hash));
+    const [parentFoundPayloads] = await this.getFromParents(requestedHashes.filter((hash) => !foundHashes.has(hash)));
+    if (this.storeParentReads && parentFoundPayloads.length > 0) {
       await this.insertWithConfig(parentFoundPayloads);
     }
-    const result = this.omitClientMetaForDataHashes(
-      hashes,
-      PayloadBuilder.omitPrivateStorageMeta([
-        ...foundPayloads,
-        ...parentFoundPayloads
-      ]).toSorted(PayloadBuilder.compareStorageMeta)
-    );
-    if (cache !== void 0) {
-      for (const payload of fromGet) {
-        cache.set(payload._hash, payload);
-        cache.set(payload._dataHash, payload);
-      }
-      for (const payload of parentFoundPayloads) {
-        cache.set(payload._hash, payload);
-        cache.set(payload._dataHash, payload);
-      }
+    if (this.activeCacheMutations === 0 && generation === this.cacheGeneration) {
+      for (const payload of [...fromGet, ...parentFoundPayloads]) cache?.set(payload._hash, payload);
     }
-    return result;
+    return PayloadBuilder.omitPrivateStorageMeta(
+      [...fromCache, ...fromGet, ...parentFoundPayloads].toSorted(PayloadBuilder.compareStorageMeta)
+    );
   }
   insertHandler(_payloads) {
     throw new Error(NOT_IMPLEMENTED);
@@ -388,27 +364,38 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
     return result;
   }
   async insertWithConfig(payloads, config) {
-    const emitEvents = config?.emitEvents ?? true;
-    const writeToParents = config?.writeToParents ?? true;
-    const withStorageMeta = await PayloadBuilder.addStorageMeta(payloads);
-    const hashes = withStorageMeta.map((p) => p._hash);
-    const existingPayloads = await this.getWithConfig(hashes);
-    const existingHashes = new Set(existingPayloads.map((p) => p._hash));
-    const payloadsToInsert = withStorageMeta.filter((p) => !existingHashes.has(p._hash));
-    const insertedPayloads = await this.insertHandler(payloadsToInsert);
-    if (writeToParents) {
-      await this.writeToParents(insertedPayloads);
-    }
-    if (emitEvents) {
-      await this.emit("inserted", {
-        mod: this,
-        payloads: insertedPayloads,
-        outPayloads: insertedPayloads,
-        inPayloads: payloads
+    const sanitizedPayloads = this.snapshotPayloads(payloads);
+    return await this.withCacheMutation(async () => {
+      const emitEvents = config?.emitEvents ?? true;
+      const writeToParents = config?.writeToParents ?? true;
+      await this.validateInsertPayloads(sanitizedPayloads);
+      const withStorageMeta = await PayloadBuilder.addStorageMeta(sanitizedPayloads);
+      const hashes = [...new Set(withStorageMeta.map((payload) => payload._hash))];
+      const { existingPayloads, insertedPayloads } = await this.withStorageMutation(async () => {
+        const existingPayloads2 = await this.getExistingLocalPayloads(hashes);
+        await this.repairExistingPayloads(existingPayloads2);
+        const existingHashes = new Set(existingPayloads2.map((payload) => payload._hash));
+        const payloadsToInsert = withStorageMeta.filter((payload) => {
+          if (existingHashes.has(payload._hash)) return false;
+          existingHashes.add(payload._hash);
+          return true;
+        });
+        return { existingPayloads: existingPayloads2, insertedPayloads: await this.insertHandler(payloadsToInsert) };
       });
-    }
-    this.reportPayloadCount();
-    return PayloadBuilder.omitPrivateStorageMeta(insertedPayloads);
+      if (writeToParents) {
+        await this.writeToParents([...existingPayloads, ...insertedPayloads]);
+      }
+      if (emitEvents) {
+        await this.emit("inserted", {
+          mod: this,
+          payloads: insertedPayloads,
+          outPayloads: insertedPayloads,
+          inPayloads: payloads
+        });
+      }
+      this.reportPayloadCount();
+      return PayloadBuilder.omitPrivateStorageMeta(insertedPayloads);
+    });
   }
   nextHandler(_options) {
     throw new Error(NOT_IMPLEMENTED);
@@ -433,7 +420,7 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   // eslint-disable-next-line max-statements
   async queryHandler(query, payloads, queryConfig) {
     const sanitizedQuery = PayloadBuilder.omitStorageMeta(query);
-    const sanitizedPayloads = PayloadBuilder.omitStorageMeta(payloads);
+    const sanitizedPayloads = this.snapshotPayloads(payloads);
     const wrappedQuery = QueryBoundWitnessWrapper.parseQuery(sanitizedQuery, sanitizedPayloads);
     const queryPayload = await wrappedQuery.getQuery();
     assertEx(await this.queryable(sanitizedQuery, sanitizedPayloads, queryConfig));
@@ -444,7 +431,7 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
         break;
       }
       case ArchivistClearQuerySchema: {
-        await this.clearHandler();
+        await this.clearWithConfig();
         break;
       }
       case ArchivistCommitQuerySchema: {
@@ -487,6 +474,10 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
     }
     return PayloadBuilder.omitPrivateStorageMeta(resultPayloads);
   }
+  /** Restore derived indexes for a stored root without rewriting its body. */
+  repairExistingPayloads(_payloads) {
+    return void 0;
+  }
   reportPayloadCount() {
     this._noOverride("reportPayloadCount");
     const gauge = this.payloadCountGauge;
@@ -513,8 +504,27 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
   async stateHandler() {
     return [...await super.stateHandler(), await this.generateStats()];
   }
+  /** Enforce backend admission before lookup, repair, insertion or parent writes. */
+  validateInsertPayloads(_payloads) {
+    return void 0;
+  }
+  /** Serialize local storage changes without holding a lock across callbacks or parents. */
+  async withStorageMutation(operation) {
+    return await operation();
+  }
   async writeToParent(parent, payloads) {
-    return await parent.insert(PayloadBuilder.omitStorageMeta(payloads));
+    if (payloads.length === 0) return [];
+    const sanitized = PayloadBuilder.omitStorageMeta(payloads);
+    const hashes = [...new Set(await Promise.all(sanitized.map((payload) => PayloadBuilder.hash(payload))))];
+    const inserted = await this.exactRepresentations(await parent.insert(sanitized), hashes);
+    const insertedHashes = new Set(inserted.map((payload) => payload._hash));
+    const missing = hashes.filter((hash) => !insertedHashes.has(hash));
+    const existing = missing.length > 0 ? await this.exactRepresentations(await parent.get(missing), missing) : [];
+    const acknowledged = new Set([...inserted, ...existing].map((payload) => payload._hash));
+    if (hashes.some((hash) => !acknowledged.has(hash))) {
+      throw new Error("Write parent did not acknowledge all requested payloads");
+    }
+    return [...inserted, ...existing];
   }
   async writeToParents(payloads) {
     const parents = await this.parentArchivists();
@@ -524,16 +534,30 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
       })
     )).filter(exists).flat();
   }
-  omitClientMetaForDataHashes(hashes, payloads) {
-    return payloads.map((payload) => {
-      if (hashes.includes(payload._dataHash) && !hashes.includes(payload._hash)) {
-        const result = PayloadBuilder.omitClientMeta(payload);
-        result._hash = result._dataHash;
-        return result;
-      } else {
-        return payload;
+  async exactRepresentations(payloads, hashes) {
+    const requested = new Set(hashes);
+    const found = /* @__PURE__ */ new Map();
+    for (const payload of payloads) {
+      await this.verifyPayloadIdentity(payload);
+      if (requested.has(payload._hash)) found.set(payload._hash, payload);
+    }
+    return found.values().toArray();
+  }
+  async requestedRepresentations(payloads, hashes) {
+    const requested = new Set(hashes);
+    const result = /* @__PURE__ */ new Map();
+    const sorted = payloads.toSorted(PayloadBuilder.compareStorageMeta);
+    for (const payload of sorted) {
+      await this.verifyPayloadIdentity(payload);
+      if (requested.has(payload._hash) && !result.has(payload._hash)) result.set(payload._hash, payload);
+    }
+    for (const payload of sorted) {
+      if (requested.has(payload._dataHash) && !result.has(payload._dataHash)) {
+        const dataOnly = PayloadBuilder.omitClientMeta(payload);
+        result.set(payload._dataHash, { ...dataOnly, _hash: payload._dataHash });
       }
-    });
+    }
+    return result.values().toArray();
   }
   async resolveArchivists(archivists = [], archivistInstances) {
     const archivistModules = (await Promise.all(archivists.map((archivist) => this.resolve(archivist)))).filter(exists).filter(duplicateModules);
@@ -553,9 +577,71 @@ var AbstractArchivist = class _AbstractArchivist extends AbstractModuleInstance
       return prev;
     }, archivistInstancesMap);
   }
+  snapshotPayloads(payloads) {
+    return JSON.parse(JSON.stringify(PayloadBuilder.omitStorageMeta(payloads)));
+  }
+  async verifyPayloadIdentity(payload) {
+    const canonicalPayload = PayloadBuilder.omitStorageMeta(payload);
+    const [hash, dataHash] = await Promise.all([
+      PayloadBuilder.hash(canonicalPayload),
+      PayloadBuilder.dataHash(canonicalPayload)
+    ]);
+    if (hash !== payload._hash || dataHash !== payload._dataHash) {
+      throw new Error("Archivist returned payload with invalid hash metadata");
+    }
+  }
+  async withCacheMutation(operation) {
+    this.activeCacheMutations++;
+    this.cacheGeneration++;
+    this._getCache?.clear();
+    try {
+      return await operation();
+    } finally {
+      this.activeCacheMutations--;
+      this.cacheGeneration++;
+      this._getCache?.clear();
+    }
+  }
 };
+
+// src/modules/archivist-abstract/payloadAdmission.ts
+import { PayloadBuilder as PayloadBuilder2 } from "@xyo-network/sdk-protocol";
+function validByteLimit(value) {
+  return Number.isSafeInteger(value) && value > 0;
+}
+function validatePayloadAdmissionPolicy(policy) {
+  if (!policy || !Array.isArray(policy.allowedSchemas) || policy.allowedSchemas.some((schema) => typeof schema !== "string" || schema.length === 0 || schema.trim() !== schema) || !validByteLimit(policy.maxPayloadBytes)) {
+    throw new TypeError("Invalid payload admission policy");
+  }
+  if (policy.schemaMaxPayloadBytes !== void 0) {
+    if (policy.schemaMaxPayloadBytes === null || typeof policy.schemaMaxPayloadBytes !== "object" || Array.isArray(policy.schemaMaxPayloadBytes)) {
+      throw new TypeError("Invalid schema payload byte limits");
+    }
+    for (const [schema, limit] of Object.entries(policy.schemaMaxPayloadBytes)) {
+      if (!policy.allowedSchemas.includes(schema) || !validByteLimit(limit)) {
+        throw new TypeError("Invalid schema payload byte limits");
+      }
+    }
+  }
+}
+function validatePayloadAdmission(payloads, policy) {
+  validatePayloadAdmissionPolicy(policy);
+  const allowed = new Set(policy.allowedSchemas);
+  for (const payload of payloads) {
+    if (!allowed.has(payload.schema)) throw new Error("Payload schema is not admitted by this archivist");
+    const schemaLimit = policy.schemaMaxPayloadBytes && Object.hasOwn(policy.schemaMaxPayloadBytes, payload.schema) ? policy.schemaMaxPayloadBytes[payload.schema] : policy.maxPayloadBytes;
+    const limit = Math.min(policy.maxPayloadBytes, schemaLimit);
+    const json = JSON.stringify(PayloadBuilder2.omitStorageMeta(payload));
+    const textEncoder = new TextEncoder();
+    if (textEncoder.encode(json).byteLength > limit) {
+      throw new Error("Payload exceeds this archivist byte limit");
+    }
+  }
+}
 export {
   AbstractArchivist,
-  StorageClassLabel
+  StorageClassLabel,
+  validatePayloadAdmission,
+  validatePayloadAdmissionPolicy
 };
 //# sourceMappingURL=archivist-abstract.mjs.map