@xyo-network/archivist 2.32.0-rc.1 → 2.32.0-rc.4

package/dist/esm/XyoStorageArchivist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyoStorageArchivist.d.ts","sourceRoot":"","sources":["../../src/XyoStorageArchivist.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAqB,MAAM,sBAAsB,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAIzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAUjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,oBAAY,+BAA+B,GAAG,6CAA6C,CAAA;AAC3F,eAAO,MAAM,+BAA+B,EAAE,+BAA+E,CAAA;AAE7H,oBAAY,yBAAyB,GAAG,kBAAkB,CAAC;IACzD,MAAM,EAAE,+BAA+B,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAC,CAAA;AAQF,qBAAa,mBAAoB,SAAQ,YAAY,CAAC,yBAAyB,CAAC;IAC9E,IAAW,IAAI,iCAEd;IAED,IAAW,SAAS,WAEnB;IAED,IAAW,UAAU,WAEpB;IAED,IAAW,YAAY,WAEtB;IAEe,OAAO;IAWvB,OAAO,CAAC,OAAO,CAAW;gBAEd,MAAM,CAAC,EAAE,sBAAsB,CAAC,yBAAyB,CAAC;IAK/D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC;IAWzC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC;IAarD,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBxD,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAc/D,GAAG,IAAI,eAAe,CAAC,UAAU,CAAC;IAQ5B,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;CAmBhD"}

package/dist/esm/XyoStorageArchivist.js

@@ -0,0 +1,130 @@
+import { assertEx } from '@xylabs/sdk-js';
+import { XyoPayloadWrapper } from '@xyo-network/payload';
+import compact from 'lodash/compact';
+import store from 'store2';
+import { XyoArchivistAllQuerySchema, XyoArchivistClearQuerySchema, XyoArchivistCommitQuerySchema, XyoArchivistDeleteQuerySchema, XyoArchivistFindQuerySchema, XyoArchivistInsertQuerySchema, } from './Queries';
+import { XyoArchivist } from './XyoArchivist';
+export const XyoStorageArchivistConfigSchema = 'network.xyo.module.config.archivist.storage';
+class StorageArchivistError extends Error {
+    constructor(action, error, message) {
+        super(`Storage Archivist [${action}] failed${message ? ` (${message})` : ''}`, { cause: error });
+    }
+}
+export class XyoStorageArchivist extends XyoArchivist {
+    get type() {
+        return this.config?.type ?? 'local';
+    }
+    get namespace() {
+        return this.config?.namespace ?? 'xyoarch';
+    }
+    get maxEntries() {
+        return this.config?.maxEntries ?? 1000;
+    }
+    get maxEntrySize() {
+        return this.config?.maxEntries ?? 16000;
+    }
+    queries() {
+        return [
+            XyoArchivistAllQuerySchema,
+            XyoArchivistDeleteQuerySchema,
+            XyoArchivistClearQuerySchema,
+            XyoArchivistFindQuerySchema,
+            XyoArchivistCommitQuerySchema,
+            ...super.queries(),
+        ];
+    }
+    storage;
+    constructor(config) {
+        super({ ...config, schema: XyoStorageArchivistConfigSchema });
+        this.storage = store[this.type].namespace(this.namespace);
+    }
+    delete(hashes) {
+        try {
+            return hashes.map((hash) => {
+                this.storage.remove(hash);
+                return true;
+            });
+        }
+        catch (ex) {
+            throw new StorageArchivistError('delete', ex, 'unexpected');
+        }
+    }
+    clear() {
+        try {
+            this.storage.clear();
+        }
+        catch (ex) {
+            throw new StorageArchivistError('clear', ex, 'unexpected');
+        }
+    }
+    async get(hashes) {
+        try {
+            return await Promise.all(hashes.map(async (hash) => {
+                const value = this.storage.get(hash);
+                return value ?? (await this.getFromParents(hash)) ?? null;
+            }));
+        }
+        catch (ex) {
+            throw new StorageArchivistError('get', ex, 'unexpected');
+        }
+    }
+    async insert(payloads) {
+        try {
+            const storedPayloads = payloads.map((payload) => {
+                const wrapper = new XyoPayloadWrapper(payload);
+                const hash = wrapper.hash;
+                const value = JSON.stringify(wrapper.payload);
+                assertEx(value.length < this.maxEntrySize, `Payload too large [${wrapper.hash}, ${value.length}]`);
+                this.storage.set(hash, wrapper.payload);
+                return wrapper.payload;
+            });
+            const boundwitness = this.bindPayloads(storedPayloads);
+            if (this.writeThrough) {
+                await this.writeToParents([boundwitness, ...storedPayloads]);
+            }
+            return boundwitness;
+        }
+        catch (ex) {
+            throw new StorageArchivistError('insert', ex, 'unexpected');
+        }
+    }
+    async find(filter) {
+        try {
+            const x = (await this.all()).filter((payload) => {
+                if (filter.schema && filter.schema !== payload.schema) {
+                    return false;
+                }
+                return true;
+            });
+            return x;
+        }
+        catch (ex) {
+            throw new StorageArchivistError('find', ex, 'unexpected');
+        }
+    }
+    all() {
+        try {
+            return Object.entries(this.storage.getAll()).map(([, value]) => value);
+        }
+        catch (ex) {
+            throw new StorageArchivistError('all', ex, 'unexpected');
+        }
+    }
+    async commit() {
+        try {
+            const payloads = await this.all();
+            assertEx(payloads.length > 0, 'Nothing to commit');
+            const block = this.bindPayloads(payloads);
+            await Promise.allSettled(compact(Object.values(this.parents?.commit ?? [])?.map(async (parent) => {
+                const query = { payloads: [block, ...payloads], schema: XyoArchivistInsertQuerySchema };
+                return await parent?.query(query);
+            })));
+            await this.clear();
+            return block;
+        }
+        catch (ex) {
+            throw new StorageArchivistError('commit', ex, 'unexpected');
+        }
+    }
+}
+//# sourceMappingURL=XyoStorageArchivist.js.map

package/dist/esm/XyoStorageArchivist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"XyoStorageArchivist.js","sourceRoot":"","sources":["../../src/XyoStorageArchivist.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -1,8 +1,11 @@
 export * from './Archivist';
 export * from './Config';
+export * from './PartialArchivistConfig';
 export * from './Queries';
 export * from './XyoArchivist';
 export * from './XyoArchivistWrapper';
+export * from './XyoCookieArchivist';
 export * from './XyoMemoryArchivist';
 export * from './XyoPayloadFindFilter';
+export * from './XyoStorageArchivist';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA"}

package/dist/esm/index.js

@@ -1,8 +1,11 @@
 export * from './Archivist';
 export * from './Config';
+export * from './PartialArchivistConfig';
 export * from './Queries';
 export * from './XyoArchivist';
 export * from './XyoArchivistWrapper';
+export * from './XyoCookieArchivist';
 export * from './XyoMemoryArchivist';
 export * from './XyoPayloadFindFilter';
+export * from './XyoStorageArchivist';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA"}

package/package.json

@@ -10,14 +10,19 @@
   },
   "dependencies": {
     "@xylabs/sdk-js": "^2.6.7",
-    "@xyo-network/boundwitness": "^2.32.0-rc.1",
-    "@xyo-network/module": "^2.32.0-rc.1",
-    "@xyo-network/payload": "^2.32.0-rc.1",
-    "@xyo-network/promisable": "^2.32.0-rc.1",
+    "@xyo-network/boundwitness": "^2.32.0-rc.4",
+    "@xyo-network/module": "^2.32.0-rc.4",
+    "@xyo-network/payload": "^2.32.0-rc.4",
+    "@xyo-network/promisable": "^2.32.0-rc.4",
+    "js-cookie": "^3.0.1",
     "lodash": "^4.17.21",
     "lru-cache": "^7.14.0",
+    "store2": "^2.14.2",
     "tslib": "^2.4.0"
   },
+  "devDependencies": {
+    "@types/js-cookie": "^3.0.2"
+  },
   "description": "Primary SDK for using XYO Protocol 2.0",
   "browser": "dist/esm/index.js",
   "docs": "dist/docs.json",
@@ -52,6 +57,6 @@
   },
   "sideEffects": false,
   "types": "dist/esm/index.d.ts",
-  "version": "2.32.0-rc.1",
+  "version": "2.32.0-rc.4",
   "stableVersion": "2.31.5"
 }

package/src/Archivist.ts

@@ -1,3 +1,4 @@
+import { XyoBoundWitness } from '@xyo-network/boundwitness'
 import { Module } from '@xyo-network/module'
 import { XyoPayload } from '@xyo-network/payload'
 import { NullablePromisableArray, Promisable, PromisableArray } from '@xyo-network/promisable'
@@ -17,7 +18,7 @@ export interface WriteArchivist<
   TId = string,
   TQuery extends XyoArchivistQuery = XyoArchivistQuery,
 > extends Module<TQuery> {
-  insert(item: TWrite[]): PromisableArray<TWriteResponse>
+  insert(item: TWrite[]): Promisable<TWriteResponse>
   delete?(ids: TId[]): PromisableArray<boolean>
   clear?(): Promisable<void>
 }
@@ -31,13 +32,13 @@ export interface FindArchivist<
   find(filter: TFindFilter): PromisableArray<TFindResponse>
 }
 
-export interface StashArchivist<TReadResponse, TQuery extends XyoArchivistQuery = XyoArchivistQuery> extends Module<TQuery> {
-  commit?(): PromisableArray<TReadResponse>
+export interface StashArchivist<TWriteResponse, TQuery extends XyoArchivistQuery = XyoArchivistQuery> extends Module<TQuery> {
+  commit?(): Promisable<TWriteResponse>
 }
 
 export interface Archivist<
   TReadResponse = XyoPayload | null,
-  TWriteResponse = TReadResponse | null,
+  TWriteResponse = XyoBoundWitness | null,
   TWrite = TReadResponse,
   TFindResponse = TReadResponse | null,
   TFindFilter = XyoPayloadFindFilter,
@@ -46,4 +47,4 @@ export interface Archivist<
 > extends ReadArchivist<TReadResponse, TId, TQuery>,
     FindArchivist<TReadResponse, TFindResponse, TFindFilter, TQuery>,
     WriteArchivist<TReadResponse, TWriteResponse, TWrite, TId, TQuery>,
-    StashArchivist<TReadResponse, TQuery> {}
+    StashArchivist<TWriteResponse, TQuery> {}

package/src/XyoArchivist.ts

@@ -1,7 +1,9 @@
 import { assertEx } from '@xylabs/sdk-js'
+import { XyoBoundWitness } from '@xyo-network/boundwitness'
 import { Module, XyoModule, XyoModuleInitializeQuerySchema, XyoModuleQueryResult, XyoModuleShutdownQuerySchema } from '@xyo-network/module'
-import { XyoPayload } from '@xyo-network/payload'
+import { XyoPayload, XyoPayloadWrapper } from '@xyo-network/payload'
 import { NullablePromisableArray, Promisable, PromisableArray } from '@xyo-network/promisable'
+import compact from 'lodash/compact'
 
 import { Archivist } from './Archivist'
 import { XyoArchivistConfig, XyoArchivistParents } from './Config'
@@ -11,7 +13,9 @@ import {
   XyoArchivistCommitQuerySchema,
   XyoArchivistDeleteQuerySchema,
   XyoArchivistFindQuerySchema,
+  XyoArchivistGetQuery,
   XyoArchivistGetQuerySchema,
+  XyoArchivistInsertQuery,
   XyoArchivistInsertQuerySchema,
   XyoArchivistQuery,
   XyoArchivistQuerySchema,
@@ -19,11 +23,25 @@ import {
 import { XyoPayloadFindFilter } from './XyoPayloadFindFilter'
 
 export abstract class XyoArchivist<TConfig extends XyoPayload = XyoPayload>
-  extends XyoModule<XyoArchivistConfig<TConfig>>
+  extends XyoModule<XyoArchivistConfig<TConfig>, XyoArchivistQuery>
   implements Archivist<XyoPayload, XyoPayload, XyoPayload, XyoPayload, XyoPayloadFindFilter>
 {
-  public override get queries(): XyoArchivistQuerySchema[] {
-    return [XyoModuleInitializeQuerySchema, XyoModuleShutdownQuerySchema, XyoArchivistGetQuerySchema, XyoArchivistInsertQuerySchema]
+  public override queries(): XyoArchivistQuerySchema[] {
+    return [
+      XyoModuleInitializeQuerySchema,
+      XyoModuleShutdownQuerySchema,
+      XyoArchivistGetQuerySchema,
+      XyoArchivistInsertQuerySchema,
+      ...super.queries(),
+    ]
+  }
+
+  public get cacheParentReads() {
+    return !!this.config?.cacheParentReads
+  }
+
+  public get writeThrough() {
+    return !!this.config?.writeThrough
   }
 
   public all(): PromisableArray<XyoPayload> {
@@ -34,7 +52,7 @@ export abstract class XyoArchivist<TConfig extends XyoPayload = XyoPayload>
     throw Error('Not implemented')
   }
 
-  public commit(): PromisableArray<XyoPayload> {
+  public commit(): Promisable<XyoBoundWitness> {
     throw Error('Not implemented')
   }
 
@@ -48,10 +66,10 @@ export abstract class XyoArchivist<TConfig extends XyoPayload = XyoPayload>
 
   abstract get(hashes: string[]): NullablePromisableArray<XyoPayload>
 
-  abstract insert(item: XyoPayload[]): PromisableArray<XyoPayload>
+  abstract insert(item: XyoPayload[]): Promisable<XyoBoundWitness>
 
   async query(query: XyoArchivistQuery): Promise<XyoModuleQueryResult> {
-    if (!this.queries.find((schema) => schema === query.schema)) {
+    if (!this.queries().find((schema) => schema === query.schema)) {
       console.error(`Undeclared Module Query: ${query.schema}`)
     }
 
@@ -64,7 +82,7 @@ export abstract class XyoArchivist<TConfig extends XyoPayload = XyoPayload>
         await this.clear()
         break
       case XyoArchivistCommitQuerySchema:
-        payloads.push(...(await this.commit()))
+        payloads.push(await this.commit())
         break
       case XyoArchivistDeleteQuerySchema:
         await this.delete(query.hashes)
@@ -76,7 +94,7 @@ export abstract class XyoArchivist<TConfig extends XyoPayload = XyoPayload>
         payloads.push(...(await this.get(query.hashes)))
         break
       case XyoArchivistInsertQuerySchema:
-        payloads.push(...(await this.insert(query.payloads)))
+        payloads.push(await this.insert(query.payloads), ...query.payloads)
         break
     }
     return [this.bindPayloads(payloads), payloads]
@@ -92,6 +110,37 @@ export abstract class XyoArchivist<TConfig extends XyoPayload = XyoPayload>
     return resolved
   }
 
+  protected async getFromParents(hash: string) {
+    return compact(
+      await Promise.all(
+        Object.values(this.parents?.read ?? {}).map(async (parent) => {
+          const query: XyoArchivistGetQuery = { hashes: [hash], schema: XyoArchivistGetQuerySchema }
+          const [, payloads] = (await parent?.query(query)) ?? []
+          const wrapper = payloads?.[0] ? new XyoPayloadWrapper(payloads?.[0]) : undefined
+          if (wrapper && wrapper.hash !== hash) {
+            console.warn(`Parent [${parent?.address}] returned payload with invalid hash [${hash} != ${wrapper.hash}]`)
+            return null
+          }
+          return wrapper?.payload
+        }),
+      ),
+    )[0]
+  }
+
+  protected async writeToParent(parent: Module, payloads: XyoPayload[]) {
+    const query: XyoArchivistInsertQuery = { payloads, schema: XyoArchivistInsertQuerySchema }
+    const [, writtenPayloads] = (await parent?.query(query)) ?? []
+    return writtenPayloads
+  }
+
+  protected async writeToParents(payloads: XyoPayload[]) {
+    return await Promise.all(
+      Object.values(this.parents?.write ?? {}).map(async (parent) => {
+        return parent ? await this.writeToParent(parent, payloads) : undefined
+      }),
+    )
+  }
+
   private _parents?: XyoArchivistParents
   get parents() {
     this._parents = this._parents ?? {

package/src/XyoArchivistWrapper.ts

@@ -1,3 +1,4 @@
+import { XyoBoundWitness } from '@xyo-network/boundwitness'
 import { XyoModuleWrapper } from '@xyo-network/module'
 import { XyoPayload } from '@xyo-network/payload'
 
@@ -36,9 +37,9 @@ export class XyoArchivistWrapper extends XyoModuleWrapper implements Archivist {
     return (await this.module.query(query))[1]
   }
 
-  public async insert(payloads: XyoPayload[]): Promise<(XyoPayload | null)[]> {
+  public async insert(payloads: XyoPayload[]): Promise<XyoBoundWitness> {
     const query: XyoArchivistInsertQuery = { payloads, schema: XyoArchivistInsertQuerySchema }
-    return (await this.module.query(query))[1]
+    return (await this.module.query(query))[0]
   }
 
   public async find(filter: XyoPayloadFindFilter): Promise<(XyoPayload | null)[]> {
@@ -51,8 +52,8 @@ export class XyoArchivistWrapper extends XyoModuleWrapper implements Archivist {
     return (await this.module.query(query))[1]
   }
 
-  public async commit(): Promise<(XyoPayload | null)[]> {
+  public async commit(): Promise<XyoBoundWitness> {
     const query: XyoArchivistCommitQuery = { schema: XyoArchivistCommitQuerySchema }
-    return (await this.module.query(query))[1]
+    return (await this.module.query(query))[0]
   }
 }

package/src/XyoCookieArchivist.spec.ts

@@ -0,0 +1,9 @@
+/**
+ * @jest-environment jsdom
+ */
+
+import { testArchivistAll, testArchivistRoundTrip } from './test.spec.test'
+import { XyoCookieArchivist } from './XyoCookieArchivist'
+
+testArchivistRoundTrip(new XyoCookieArchivist({ namespace: 'test' }), 'cookie')
+testArchivistAll(new XyoCookieArchivist({ namespace: 'test' }), 'cookie')

package/src/XyoCookieArchivist.ts

@@ -0,0 +1,176 @@
+import { assertEx } from '@xylabs/sdk-js'
+import { XyoBoundWitness } from '@xyo-network/boundwitness'
+import { XyoPayload, XyoPayloadWrapper } from '@xyo-network/payload'
+import { PromisableArray } from '@xyo-network/promisable'
+import Cookies from 'js-cookie'
+import compact from 'lodash/compact'
+
+import { XyoArchivistConfig } from './Config'
+import { PartialArchivistConfig } from './PartialArchivistConfig'
+import {
+  XyoArchivistAllQuerySchema,
+  XyoArchivistClearQuerySchema,
+  XyoArchivistCommitQuerySchema,
+  XyoArchivistDeleteQuerySchema,
+  XyoArchivistFindQuerySchema,
+  XyoArchivistInsertQuery,
+  XyoArchivistInsertQuerySchema,
+} from './Queries'
+import { XyoArchivist } from './XyoArchivist'
+import { XyoPayloadFindFilter } from './XyoPayloadFindFilter'
+
+export type XyoCookieArchivistConfigSchema = 'network.xyo.module.config.archivist.cookie'
+export const XyoCookieArchivistConfigSchema: XyoCookieArchivistConfigSchema = 'network.xyo.module.config.archivist.cookie'
+
+export type XyoCookieArchivistConfig = XyoArchivistConfig<{
+  schema: XyoCookieArchivistConfigSchema
+  domain?: string
+  maxEntries?: number
+  maxEntrySize?: number
+  namespace?: string
+}>
+
+class CookieArchivistError extends Error {
+  constructor(action: string, error: Error['cause'], message?: string) {
+    super(`Cookie Archivist [${action}] failed${message ? ` (${message})` : ''}`, { cause: error })
+  }
+}
+
+export class XyoCookieArchivist extends XyoArchivist<XyoCookieArchivistConfig> {
+  public get domain() {
+    return this.config?.domain
+  }
+
+  public get namespace() {
+    return this.config?.namespace ?? 'xyoarch'
+  }
+
+  public get maxEntries() {
+    //all browsers support at least 60 cookies
+    return this.config?.maxEntries ?? 60
+  }
+
+  public get maxEntrySize() {
+    //all browsers support at least 4000 length per cookie
+    return this.config?.maxEntrySize ?? 4000
+  }
+
+  public override queries() {
+    return [
+      XyoArchivistAllQuerySchema,
+      XyoArchivistDeleteQuerySchema,
+      XyoArchivistClearQuerySchema,
+      XyoArchivistFindQuerySchema,
+      XyoArchivistCommitQuerySchema,
+      ...super.queries(),
+    ]
+  }
+
+  constructor(config?: PartialArchivistConfig<XyoCookieArchivistConfig>) {
+    super({ ...config, schema: XyoCookieArchivistConfigSchema })
+  }
+
+  private keyFromHash(hash: string) {
+    return `${this.namespace}-${hash}`
+  }
+
+  public delete(hashes: string[]): PromisableArray<boolean> {
+    try {
+      return hashes.map((hash) => {
+        Cookies.remove(this.keyFromHash(hash))
+        return true
+      })
+    } catch (ex) {
+      throw new CookieArchivistError('delete', ex, 'unexpected')
+    }
+  }
+
+  public override clear(): void | Promise<void> {
+    try {
+      Object.entries(Cookies.get()).map(([key]) => {
+        if (key.startsWith(`${this.namespace}-`)) {
+          Cookies.remove(key)
+        }
+      })
+    } catch (ex) {
+      throw new CookieArchivistError('clear', ex, 'unexpected')
+    }
+  }
+
+  public async get(hashes: string[]): Promise<(XyoPayload | null)[]> {
+    try {
+      return await Promise.all(
+        hashes.map(async (hash) => {
+          const cookieString = Cookies.get(this.keyFromHash(hash))
+          return cookieString ? JSON.parse(cookieString) : (await this.getFromParents(hash)) ?? null
+        }),
+      )
+    } catch (ex) {
+      throw new CookieArchivistError('get', ex, 'unexpected')
+    }
+  }
+
+  public async insert(payloads: XyoPayload[]): Promise<XyoBoundWitness> {
+    try {
+      const storedPayloads = payloads.map((payload) => {
+        const wrapper = new XyoPayloadWrapper(payload)
+        const key = this.keyFromHash(wrapper.hash)
+        const value = JSON.stringify(wrapper.payload)
+        assertEx(value.length < this.maxEntrySize, `Payload too large [${wrapper.hash}, ${value.length}]`)
+        Cookies.set(key, JSON.stringify(wrapper.payload))
+        return wrapper.payload
+      })
+      const boundwitness = this.bindPayloads(storedPayloads)
+      if (this.writeThrough) {
+        await this.writeToParents([boundwitness, ...storedPayloads])
+      }
+      return boundwitness
+    } catch (ex) {
+      throw new CookieArchivistError('insert', ex, 'unexpected')
+    }
+  }
+
+  public async find(filter: XyoPayloadFindFilter): Promise<XyoPayload[]> {
+    try {
+      const x = (await this.all()).filter((payload) => {
+        if (filter.schema && filter.schema !== payload.schema) {
+          return false
+        }
+        return true
+      })
+      return x
+    } catch (ex) {
+      throw new CookieArchivistError('find', ex, 'unexpected')
+    }
+  }
+
+  public all(): PromisableArray<XyoPayload> {
+    try {
+      return Object.entries(Cookies.get())
+        .filter(([key]) => key.startsWith(`${this.namespace}-`))
+        .map(([, value]) => JSON.parse(value))
+    } catch (ex) {
+      throw new CookieArchivistError('all', ex, 'unexpected')
+    }
+  }
+
+  public async commit(): Promise<XyoBoundWitness> {
+    try {
+      const payloads = await this.all()
+      assertEx(payloads.length > 0, 'Nothing to commit')
+      const block = this.bindPayloads(payloads)
+      await Promise.allSettled(
+        compact(
+          Object.values(this.parents?.commit ?? [])?.map(async (parent) => {
+            const query: XyoArchivistInsertQuery = { payloads: [block, ...payloads], schema: XyoArchivistInsertQuerySchema }
+            return await parent?.query(query)
+          }),
+        ),
+      )
+      await this.clear()
+      return block
+    } catch (ex) {
+      throw new CookieArchivistError('commit', ex, 'unexpected')
+    }
+  }
+}