@graffiti-garden/implementation-local 0.6.3 → 1.0.0

package/dist/esm/objects.js

@@ -0,0 +1,285 @@
+import {
+  GraffitiErrorNotFound,
+  GraffitiErrorSchemaMismatch,
+  GraffitiErrorForbidden,
+  unpackObjectUrl,
+  maskGraffitiObject,
+  isActorAllowedGraffitiObject,
+  compileGraffitiObjectSchema
+} from "@graffiti-garden/api";
+import { randomBase64, decodeObjectUrl, encodeObjectUrl } from "./utilities.js";
+class GraffitiLocalObjects {
+  db_;
+  ajv_;
+  options;
+  operationClock = 0;
+  get db() {
+    if (!this.db_) {
+      this.db_ = (async () => {
+        const { default: PouchDB } = await import("pouchdb");
+        const pouchDbOptions = {
+          name: "graffitiDb",
+          ...this.options.pouchDBOptions
+        };
+        const db = new PouchDB(
+          pouchDbOptions.name,
+          pouchDbOptions
+        );
+        await db.put({
+          _id: "_design/indexes",
+          views: {
+            objectsPerChannelAndLastModified: {
+              map: function(object) {
+                const paddedLastModified = object.lastModified.toString().padStart(15, "0");
+                object.channels.forEach(function(channel) {
+                  const id = encodeURIComponent(channel) + "/" + paddedLastModified;
+                  emit(id);
+                });
+              }.toString()
+            }
+          }
+        }).catch((error) => {
+          if (error && typeof error === "object" && "name" in error && error.name === "conflict") {
+            return;
+          } else {
+            throw error;
+          }
+        });
+        return db;
+      })();
+    }
+    return this.db_;
+  }
+  get ajv() {
+    if (!this.ajv_) {
+      this.ajv_ = (async () => {
+        const { default: Ajv } = await import("ajv");
+        return new Ajv({ strict: false });
+      })();
+    }
+    return this.ajv_;
+  }
+  constructor(options) {
+    this.options = options ?? {};
+  }
+  get = async (...args) => {
+    const [urlObject, schema, session] = args;
+    const url = unpackObjectUrl(urlObject);
+    let doc;
+    try {
+      doc = await (await this.db).get(url);
+    } catch (error) {
+      throw new GraffitiErrorNotFound(
+        "The object you are trying to get either does not exist or you are not allowed to see it"
+      );
+    }
+    if (doc.tombstone) {
+      throw new GraffitiErrorNotFound(
+        "The object you are trying to get either does not exist or you are not allowed to see it"
+      );
+    }
+    const { actor } = decodeObjectUrl(url);
+    const { value, channels, allowed } = doc;
+    const object = {
+      value,
+      channels,
+      allowed,
+      url,
+      actor
+    };
+    if (!isActorAllowedGraffitiObject(object, session)) {
+      throw new GraffitiErrorNotFound(
+        "The object you are trying to get either does not exist or you are not allowed to see it"
+      );
+    }
+    maskGraffitiObject(object, [], session);
+    const validate = compileGraffitiObjectSchema(await this.ajv, schema);
+    if (!validate(object)) {
+      throw new GraffitiErrorSchemaMismatch();
+    }
+    return object;
+  };
+  delete = async (...args) => {
+    const [urlObject, session] = args;
+    const url = unpackObjectUrl(urlObject);
+    const { actor } = decodeObjectUrl(url);
+    if (actor !== session.actor) {
+      throw new GraffitiErrorForbidden(
+        "You cannot delete an object that you did not create."
+      );
+    }
+    let doc;
+    try {
+      doc = await (await this.db).get(url);
+    } catch {
+      throw new GraffitiErrorNotFound("Object not found.");
+    }
+    if (doc.tombstone) {
+      throw new GraffitiErrorNotFound("Object not found.");
+    }
+    doc.tombstone = true;
+    doc.lastModified = this.operationClock;
+    try {
+      await (await this.db).put(doc);
+    } catch {
+      throw new GraffitiErrorNotFound("Object not found.");
+    }
+    this.operationClock++;
+    return;
+  };
+  post = async (...args) => {
+    const [objectPartial, session] = args;
+    const actor = session.actor;
+    const id = randomBase64();
+    const url = encodeObjectUrl(actor, id);
+    const { value, channels, allowed } = objectPartial;
+    const object = {
+      value,
+      channels,
+      allowed,
+      lastModified: this.operationClock,
+      tombstone: false
+    };
+    await (await this.db).put({
+      _id: url,
+      ...object
+    });
+    this.operationClock++;
+    return {
+      ...objectPartial,
+      actor,
+      url
+    };
+  };
+  async *discoverMeta(args, continueParams) {
+    if (continueParams) {
+      const continueBuffer = this.options.continueBuffer ?? 2e3;
+      const timeElapsedSinceLastDiscover = Date.now() - continueParams.lastDiscovered;
+      if (timeElapsedSinceLastDiscover < continueBuffer) {
+        await new Promise(
+          (resolve) => setTimeout(resolve, continueBuffer - timeElapsedSinceLastDiscover)
+        );
+      }
+    }
+    const [discoverChannels, schema, session] = args;
+    const validate = compileGraffitiObjectSchema(await this.ajv, schema);
+    const startKeySuffix = continueParams ? continueParams.ifModifiedSince.toString().padStart(15, "0") : "";
+    const endKeySuffix = "\uFFFF";
+    const processedUrls = /* @__PURE__ */ new Set();
+    const startTime = this.operationClock;
+    for (const channel of discoverChannels) {
+      const keyPrefix = encodeURIComponent(channel) + "/";
+      const startkey = keyPrefix + startKeySuffix;
+      const endkey = keyPrefix + endKeySuffix;
+      const result = await (await this.db).query("indexes/objectsPerChannelAndLastModified", {
+        startkey,
+        endkey,
+        include_docs: true
+      });
+      for (const row of result.rows) {
+        const doc = row.doc;
+        if (!doc) continue;
+        const url = doc._id;
+        if (processedUrls.has(url)) continue;
+        processedUrls.add(url);
+        if (!continueParams && doc.tombstone) continue;
+        const { tombstone, value, channels, allowed } = doc;
+        const { actor } = decodeObjectUrl(url);
+        const object = {
+          url,
+          value,
+          allowed,
+          channels,
+          actor
+        };
+        if (!isActorAllowedGraffitiObject(object, session)) continue;
+        maskGraffitiObject(object, discoverChannels, session);
+        if (!validate(object)) continue;
+        yield tombstone ? {
+          tombstone: true,
+          object: { url }
+        } : { object };
+      }
+    }
+    return {
+      lastDiscovered: Date.now(),
+      ifModifiedSince: startTime
+    };
+  }
+  discoverCursor(args, continueParams) {
+    const [channels, schema, session] = args;
+    return "discover:" + JSON.stringify({
+      channels,
+      schema,
+      continueParams,
+      actor: session?.actor
+    });
+  }
+  async *discoverContinue(args, continueParams, session) {
+    if (session?.actor !== args[2]?.actor) {
+      throw new GraffitiErrorForbidden(
+        "Cannot continue a cursor started by another actor"
+      );
+    }
+    const iterator = this.discoverMeta(args, continueParams);
+    while (true) {
+      const result = await iterator.next();
+      if (result.done) {
+        return {
+          continue: (session2) => this.discoverContinue(args, result.value, session2),
+          cursor: this.discoverCursor(args, result.value)
+        };
+      }
+      yield result.value;
+    }
+  }
+  discover = (...args) => {
+    const [channels, schema, session] = args;
+    const iterator = this.discoverMeta([
+      channels,
+      schema,
+      session
+    ]);
+    const this_ = this;
+    return (async function* () {
+      while (true) {
+        const result = await iterator.next();
+        if (result.done) {
+          return {
+            continue: (session2) => this_.discoverContinue(
+              args,
+              result.value,
+              session2
+            ),
+            cursor: this_.discoverCursor(args, result.value)
+          };
+        }
+        if (result.value.tombstone) continue;
+        yield result.value;
+      }
+    })();
+  };
+  continueDiscover = (...args) => {
+    const [cursor, session] = args;
+    if (cursor.startsWith("discover:")) {
+      const { channels, schema, actor, continueParams } = JSON.parse(
+        cursor.slice("discover:".length)
+      );
+      if (actor && actor !== session?.actor) {
+        throw new GraffitiErrorForbidden(
+          "Cannot continue a cursor started by another actor"
+        );
+      }
+      return this.discoverContinue(
+        [channels, schema, session],
+        continueParams
+      );
+    } else {
+      throw new GraffitiErrorNotFound("Cursor not found");
+    }
+  };
+}
+export {
+  GraffitiLocalObjects
+};
+//# sourceMappingURL=objects.js.map

package/dist/esm/objects.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/objects.ts"],
+  "sourcesContent": ["import type {\n  Graffiti,\n  GraffitiObjectBase,\n  JSONSchema,\n  GraffitiSession,\n  GraffitiObjectStreamContinue,\n  GraffitiObjectStreamContinueEntry,\n} from \"@graffiti-garden/api\";\nimport {\n  GraffitiErrorNotFound,\n  GraffitiErrorSchemaMismatch,\n  GraffitiErrorForbidden,\n  unpackObjectUrl,\n  maskGraffitiObject,\n  isActorAllowedGraffitiObject,\n  compileGraffitiObjectSchema,\n} from \"@graffiti-garden/api\";\nimport { randomBase64, decodeObjectUrl, encodeObjectUrl } from \"./utilities.js\";\nimport type Ajv from \"ajv\";\n\n/**\n * Constructor options for the GraffitiPoubchDB class.\n */\nexport interface GraffitiLocalOptions {\n  /**\n   * Options to pass to the PouchDB constructor.\n   * Defaults to `{ name: \"graffitiDb\" }`.\n   *\n   * See the [PouchDB documentation](https://pouchdb.com/api.html#create_database)\n   * for available options.\n   */\n  pouchDBOptions?: PouchDB.Configuration.DatabaseConfiguration;\n  /**\n   * Wait at least this long (in milliseconds) before continuing a stream.\n   * A basic form of rate limiting. Defaults to 2 seconds.\n   */\n  continueBuffer?: number;\n}\n\ntype GraffitiObjectData = {\n  tombstone: boolean;\n  value: {};\n  channels: string[];\n  allowed?: string[] | null;\n  lastModified: number;\n};\n\ntype ContinueDiscoverParams = {\n  lastDiscovered: number;\n  ifModifiedSince: number;\n};\n\n/**\n * An implementation of only the database operations of the\n * GraffitiAPI without synchronization or session management.\n */\nexport class GraffitiLocalObjects {\n  protected db_: Promise<PouchDB.Database<GraffitiObjectData>> | undefined;\n  protected ajv_: Promise<Ajv> | undefined;\n  protected readonly options: GraffitiLocalOptions;\n  protected operationClock: number = 0;\n\n  get db() {\n    if (!this.db_) {\n      this.db_ = (async () => {\n        const { default: PouchDB } = await import(\"pouchdb\");\n        const pouchDbOptions = {\n          name: \"graffitiDb\",\n          ...this.options.pouchDBOptions,\n        };\n        const db = new PouchDB<GraffitiObjectData>(\n          pouchDbOptions.name,\n          pouchDbOptions,\n        );\n        await db\n          //@ts-ignore\n          .put({\n            _id: \"_design/indexes\",\n            views: {\n              objectsPerChannelAndLastModified: {\n                map: function (object: GraffitiObjectData) {\n                  const paddedLastModified = object.lastModified\n                    .toString()\n                    .padStart(15, \"0\");\n                  object.channels.forEach(function (channel) {\n                    const id =\n                      encodeURIComponent(channel) + \"/\" + paddedLastModified;\n                    //@ts-ignore\n                    emit(id);\n                  });\n                }.toString(),\n              },\n            },\n          })\n          //@ts-ignore\n          .catch((error) => {\n            if (\n              error &&\n              typeof error === \"object\" &&\n              \"name\" in error &&\n              error.name === \"conflict\"\n            ) {\n              // Design document already exists\n              return;\n            } else {\n              throw error;\n            }\n          });\n        return db;\n      })();\n    }\n    return this.db_;\n  }\n\n  protected get ajv() {\n    if (!this.ajv_) {\n      this.ajv_ = (async () => {\n        const { default: Ajv } = await import(\"ajv\");\n        return new Ajv({ strict: false });\n      })();\n    }\n    return this.ajv_;\n  }\n\n  constructor(options?: GraffitiLocalOptions) {\n    this.options = options ?? {};\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    const [urlObject, schema, session] = args;\n    const url = unpackObjectUrl(urlObject);\n\n    let doc: GraffitiObjectData;\n    try {\n      doc = await (await this.db).get(url);\n    } catch (error) {\n      throw new GraffitiErrorNotFound(\n        \"The object you are trying to get either does not exist or you are not allowed to see it\",\n      );\n    }\n\n    if (doc.tombstone) {\n      throw new GraffitiErrorNotFound(\n        \"The object you are trying to get either does not exist or you are not allowed to see it\",\n      );\n    }\n\n    const { actor } = decodeObjectUrl(url);\n    const { value, channels, allowed } = doc;\n    const object: GraffitiObjectBase = {\n      value,\n      channels,\n      allowed,\n      url,\n      actor,\n    };\n\n    if (!isActorAllowedGraffitiObject(object, session)) {\n      throw new GraffitiErrorNotFound(\n        \"The object you are trying to get either does not exist or you are not allowed to see it\",\n      );\n    }\n\n    // Mask out the allowed list and channels\n    // if the user is not the owner\n    maskGraffitiObject(object, [], session);\n\n    const validate = compileGraffitiObjectSchema(await this.ajv, schema);\n    if (!validate(object)) {\n      throw new GraffitiErrorSchemaMismatch();\n    }\n    return object;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const [urlObject, session] = args;\n\n    const url = unpackObjectUrl(urlObject);\n    const { actor } = decodeObjectUrl(url);\n    if (actor !== session.actor) {\n      throw new GraffitiErrorForbidden(\n        \"You cannot delete an object that you did not create.\",\n      );\n    }\n\n    let doc: GraffitiObjectData & PouchDB.Core.IdMeta & PouchDB.Core.GetMeta;\n    try {\n      doc = await (await this.db).get(url);\n    } catch {\n      throw new GraffitiErrorNotFound(\"Object not found.\");\n    }\n\n    if (doc.tombstone) {\n      throw new GraffitiErrorNotFound(\"Object not found.\");\n    }\n\n    // Set the tombstone and update lastModified\n    doc.tombstone = true;\n    doc.lastModified = this.operationClock;\n    try {\n      await (await this.db).put(doc);\n    } catch {\n      throw new GraffitiErrorNotFound(\"Object not found.\");\n    }\n    this.operationClock++;\n\n    return;\n  };\n\n  post: Graffiti[\"post\"] = async (...args) => {\n    const [objectPartial, session] = args;\n\n    const actor = session.actor;\n    const id = randomBase64();\n    const url = encodeObjectUrl(actor, id);\n\n    const { value, channels, allowed } = objectPartial;\n    const object: GraffitiObjectData = {\n      value,\n      channels,\n      allowed,\n      lastModified: this.operationClock,\n      tombstone: false,\n    };\n\n    await (\n      await this.db\n    ).put({\n      _id: url,\n      ...object,\n    });\n    this.operationClock++;\n\n    return {\n      ...objectPartial,\n      actor,\n      url,\n    };\n  };\n\n  protected async *discoverMeta<Schema extends JSONSchema>(\n    args: Parameters<typeof Graffiti.prototype.discover<Schema>>,\n    continueParams?: {\n      lastDiscovered: number;\n      ifModifiedSince: number;\n    },\n  ): AsyncGenerator<\n    GraffitiObjectStreamContinueEntry<Schema>,\n    ContinueDiscoverParams\n  > {\n    // If we are continuing a discover, make sure to wait at\n    // least 2 seconds since the last poll to start a new one.\n    if (continueParams) {\n      const continueBuffer = this.options.continueBuffer ?? 2000;\n      const timeElapsedSinceLastDiscover =\n        Date.now() - continueParams.lastDiscovered;\n      if (timeElapsedSinceLastDiscover < continueBuffer) {\n        // Continue was called too soon,\n        // wait a bit before continuing\n        await new Promise((resolve) =>\n          setTimeout(resolve, continueBuffer - timeElapsedSinceLastDiscover),\n        );\n      }\n    }\n\n    const [discoverChannels, schema, session] = args;\n    const validate = compileGraffitiObjectSchema(await this.ajv, schema);\n    const startKeySuffix = continueParams\n      ? continueParams.ifModifiedSince.toString().padStart(15, \"0\")\n      : \"\";\n    const endKeySuffix = \"\\uffff\";\n\n    const processedUrls = new Set<string>();\n\n    const startTime = this.operationClock;\n\n    for (const channel of discoverChannels) {\n      const keyPrefix = encodeURIComponent(channel) + \"/\";\n      const startkey = keyPrefix + startKeySuffix;\n      const endkey = keyPrefix + endKeySuffix;\n\n      const result = await (\n        await this.db\n      ).query<GraffitiObjectData>(\"indexes/objectsPerChannelAndLastModified\", {\n        startkey,\n        endkey,\n        include_docs: true,\n      });\n\n      for (const row of result.rows) {\n        const doc = row.doc;\n        if (!doc) continue;\n\n        const url = doc._id;\n\n        if (processedUrls.has(url)) continue;\n        processedUrls.add(url);\n\n        // If this is not a continuation, skip tombstones\n        if (!continueParams && doc.tombstone) continue;\n\n        const { tombstone, value, channels, allowed } = doc;\n        const { actor } = decodeObjectUrl(url);\n\n        const object: GraffitiObjectBase = {\n          url,\n          value,\n          allowed,\n          channels,\n          actor,\n        };\n\n        if (!isActorAllowedGraffitiObject(object, session)) continue;\n\n        maskGraffitiObject(object, discoverChannels, session);\n\n        if (!validate(object)) continue;\n\n        yield tombstone\n          ? {\n              tombstone: true,\n              object: { url },\n            }\n          : { object };\n      }\n    }\n\n    return {\n      lastDiscovered: Date.now(),\n      ifModifiedSince: startTime,\n    };\n  }\n\n  protected discoverCursor(\n    args: Parameters<typeof Graffiti.prototype.discover<{}>>,\n    continueParams: {\n      lastDiscovered: number;\n      ifModifiedSince: number;\n    },\n  ): string {\n    const [channels, schema, session] = args;\n    return (\n      \"discover:\" +\n      JSON.stringify({\n        channels,\n        schema,\n        continueParams,\n        actor: session?.actor,\n      })\n    );\n  }\n\n  protected async *discoverContinue<Schema extends JSONSchema>(\n    args: Parameters<typeof Graffiti.prototype.discover<Schema>>,\n    continueParams: {\n      lastDiscovered: number;\n      ifModifiedSince: number;\n    },\n    session?: GraffitiSession | null,\n  ): GraffitiObjectStreamContinue<Schema> {\n    if (session?.actor !== args[2]?.actor) {\n      throw new GraffitiErrorForbidden(\n        \"Cannot continue a cursor started by another actor\",\n      );\n    }\n    const iterator = this.discoverMeta<Schema>(args, continueParams);\n\n    while (true) {\n      const result = await iterator.next();\n      if (result.done) {\n        return {\n          continue: (session) =>\n            this.discoverContinue<Schema>(args, result.value, session),\n          cursor: this.discoverCursor(args, result.value),\n        };\n      }\n      yield result.value;\n    }\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const [channels, schema, session] = args;\n    const iterator = this.discoverMeta<(typeof args)[1]>([\n      channels,\n      schema,\n      session,\n    ]);\n\n    const this_ = this;\n    return (async function* () {\n      while (true) {\n        const result = await iterator.next();\n        if (result.done) {\n          return {\n            continue: (session) =>\n              this_.discoverContinue<(typeof args)[1]>(\n                args,\n                result.value,\n                session,\n              ),\n            cursor: this_.discoverCursor(args, result.value),\n          };\n        }\n        // Make sure to filter out tombstones\n        if (result.value.tombstone) continue;\n        yield result.value;\n      }\n    })();\n  };\n\n  continueDiscover: Graffiti[\"continueDiscover\"] = (...args) => {\n    const [cursor, session] = args;\n    if (cursor.startsWith(\"discover:\")) {\n      // TODO: use AJV here\n      const { channels, schema, actor, continueParams } = JSON.parse(\n        cursor.slice(\"discover:\".length),\n      );\n      if (actor && actor !== session?.actor) {\n        throw new GraffitiErrorForbidden(\n          \"Cannot continue a cursor started by another actor\",\n        );\n      }\n      return this.discoverContinue<{}>(\n        [channels, schema, session],\n        continueParams,\n      );\n    } else {\n      throw new GraffitiErrorNotFound(\"Cursor not found\");\n    }\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["session"]
+}

package/dist/esm/tests.spec.js

@@ -1,8 +1,7 @@
 import {
   graffitiCRUDTests,
   graffitiDiscoverTests,
-  graffitiOrphanTests,
-  graffitiChannelStatsTests
+  graffitiMediaTests
 } from "@graffiti-garden/api/tests";
 import { GraffitiLocal } from "./index";
 const useGraffiti = () => new GraffitiLocal();
@@ -10,6 +9,5 @@ const useSession1 = () => ({ actor: "someone" });
 const useSession2 = () => ({ actor: "someoneelse" });
 graffitiCRUDTests(useGraffiti, useSession1, useSession2);
 graffitiDiscoverTests(useGraffiti, useSession1, useSession2);
-graffitiOrphanTests(useGraffiti, useSession1, useSession2);
-graffitiChannelStatsTests(useGraffiti, useSession1, useSession2);
+graffitiMediaTests(useGraffiti, useSession1, useSession2);
 //# sourceMappingURL=tests.spec.js.map

package/dist/esm/tests.spec.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/tests.spec.ts"],
-  "sourcesContent": ["import {\n  graffitiCRUDTests,\n  graffitiDiscoverTests,\n  graffitiOrphanTests,\n  graffitiChannelStatsTests,\n} from \"@graffiti-garden/api/tests\";\nimport { GraffitiLocal } from \"./index\";\n\nconst useGraffiti = () => new GraffitiLocal();\nconst useSession1 = () => ({ actor: \"someone\" });\nconst useSession2 = () => ({ actor: \"someoneelse\" });\n\ngraffitiCRUDTests(useGraffiti, useSession1, useSession2);\ngraffitiDiscoverTests(useGraffiti, useSession1, useSession2);\ngraffitiOrphanTests(useGraffiti, useSession1, useSession2);\ngraffitiChannelStatsTests(useGraffiti, useSession1, useSession2);\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB;AAE9B,MAAM,cAAc,MAAM,IAAI,cAAc;AAC5C,MAAM,cAAc,OAAO,EAAE,OAAO,UAAU;AAC9C,MAAM,cAAc,OAAO,EAAE,OAAO,cAAc;AAElD,kBAAkB,aAAa,aAAa,WAAW;AACvD,sBAAsB,aAAa,aAAa,WAAW;AAC3D,oBAAoB,aAAa,aAAa,WAAW;AACzD,0BAA0B,aAAa,aAAa,WAAW;",
+  "sourcesContent": ["import {\n  graffitiCRUDTests,\n  graffitiDiscoverTests,\n  graffitiMediaTests,\n} from \"@graffiti-garden/api/tests\";\nimport { GraffitiLocal } from \"./index\";\n\nconst useGraffiti = () => new GraffitiLocal();\nconst useSession1 = () => ({ actor: \"someone\" });\nconst useSession2 = () => ({ actor: \"someoneelse\" });\n\ngraffitiCRUDTests(useGraffiti, useSession1, useSession2);\ngraffitiDiscoverTests(useGraffiti, useSession1, useSession2);\ngraffitiMediaTests(useGraffiti, useSession1, useSession2);\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,qBAAqB;AAE9B,MAAM,cAAc,MAAM,IAAI,cAAc;AAC5C,MAAM,cAAc,OAAO,EAAE,OAAO,UAAU;AAC9C,MAAM,cAAc,OAAO,EAAE,OAAO,cAAc;AAElD,kBAAkB,aAAa,aAAa,WAAW;AACvD,sBAAsB,aAAa,aAAa,WAAW;AAC3D,mBAAmB,aAAa,aAAa,WAAW;",
   "names": []
 }

package/dist/esm/utilities.js

@@ -1,60 +1,81 @@
-import {
-  GraffitiErrorInvalidSchema,
-  GraffitiErrorPatchError,
-  GraffitiErrorPatchTestFailed
-} from "@graffiti-garden/api";
-function unpackObjectUrl(url) {
-  return typeof url === "string" ? url : url.url;
-}
-function randomBase64(numBytes = 24) {
-  const bytes = new Uint8Array(numBytes);
-  crypto.getRandomValues(bytes);
+function encodeBase64(bytes) {
   const base64 = btoa(String.fromCodePoint(...bytes));
   return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/\=+$/, "");
 }
-function applyGraffitiPatch(apply, prop, patch, object) {
-  const ops = patch[prop];
-  if (!ops || !ops.length) return;
-  try {
-    object[prop] = apply(object[prop], ops, true, false).newDocument;
-  } catch (e) {
-    if (typeof e === "object" && e && "name" in e && typeof e.name === "string" && "message" in e && typeof e.message === "string") {
-      if (e.name === "TEST_OPERATION_FAILED") {
-        throw new GraffitiErrorPatchTestFailed(e.message);
-      } else {
-        throw new GraffitiErrorPatchError(e.name + ": " + e.message);
-      }
-    } else {
-      throw e;
-    }
-  }
+function decodeBase64(base64Url) {
+  let base64 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
+  while (base64.length % 4 !== 0) base64 += "=";
+  return Uint8Array.from(atob(base64), (c) => c.charCodeAt(0));
+}
+function randomBase64(numBytes = 32) {
+  const bytes = new Uint8Array(numBytes);
+  crypto.getRandomValues(bytes);
+  return encodeBase64(bytes);
+}
+const OBJECT_URL_PREFIX = "graffiti:object:";
+const MEDIA_URL_PREFIX = "graffiti:media:";
+function encodeGraffitiUrl(actor, id, prefix) {
+  return `${prefix}${encodeURIComponent(actor)}:${encodeURIComponent(id)}`;
 }
-function compileGraffitiObjectSchema(ajv, schema) {
-  try {
-    return ajv.compile(schema);
-  } catch (error) {
-    throw new GraffitiErrorInvalidSchema(
-      error instanceof Error ? error.message : void 0
-    );
+function encodeObjectUrl(actor, id) {
+  return encodeGraffitiUrl(actor, id, OBJECT_URL_PREFIX);
+}
+function encodeMediaUrl(actor, id) {
+  return encodeGraffitiUrl(actor, id, MEDIA_URL_PREFIX);
+}
+function decodeGraffitiUrl(url, prefix) {
+  if (!url.startsWith(prefix)) {
+    throw new Error(`URL does not start with ${prefix}`);
+  }
+  const slices = url.slice(prefix.length).split(":");
+  if (slices.length !== 2) {
+    throw new Error("URL has too many colon-seperated parts");
   }
+  const [actor, id] = slices.map(decodeURIComponent);
+  return { actor, id };
 }
-function maskGraffitiObject(object, channels, session) {
-  if (object.actor !== session?.actor) {
-    object.allowed = object.allowed && session ? [session.actor] : void 0;
-    object.channels = object.channels.filter(
-      (channel) => channels.includes(channel)
-    );
+function decodeObjectUrl(url) {
+  return decodeGraffitiUrl(url, OBJECT_URL_PREFIX);
+}
+function decodeMediaUrl(url) {
+  return decodeGraffitiUrl(url, MEDIA_URL_PREFIX);
+}
+async function blobToBase64(blob) {
+  if (typeof FileReader !== "undefined") {
+    return new Promise((resolve, reject) => {
+      const r = new FileReader();
+      r.onload = () => {
+        if (typeof r.result === "string") {
+          resolve(r.result);
+        } else {
+          reject(new Error("Unexpected result type"));
+        }
+      };
+      r.onerror = reject;
+      r.readAsDataURL(blob);
+    });
+  }
+  if (typeof Buffer !== "undefined") {
+    const ab = await blob.arrayBuffer();
+    return `data:${blob.type};base64,${Buffer.from(ab).toString("base64")}`;
   }
+  throw new Error("Unsupported environment");
 }
-function isActorAllowedGraffitiObject(object, session) {
-  return object.allowed === void 0 || object.allowed === null || !!session?.actor && (object.actor === session.actor || object.allowed.includes(session.actor));
+async function base64ToBlob(dataUrl) {
+  const response = await fetch(dataUrl);
+  return await response.blob();
 }
 export {
-  applyGraffitiPatch,
-  compileGraffitiObjectSchema,
-  isActorAllowedGraffitiObject,
-  maskGraffitiObject,
-  randomBase64,
-  unpackObjectUrl
+  base64ToBlob,
+  blobToBase64,
+  decodeBase64,
+  decodeGraffitiUrl,
+  decodeMediaUrl,
+  decodeObjectUrl,
+  encodeBase64,
+  encodeGraffitiUrl,
+  encodeMediaUrl,
+  encodeObjectUrl,
+  randomBase64
 };
 //# sourceMappingURL=utilities.js.map

package/dist/esm/utilities.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utilities.ts"],
-  "sourcesContent": ["import {\n  GraffitiErrorInvalidSchema,\n  GraffitiErrorPatchError,\n  GraffitiErrorPatchTestFailed,\n} from \"@graffiti-garden/api\";\nimport type {\n  GraffitiObject,\n  GraffitiObjectBase,\n  GraffitiPatch,\n  JSONSchema,\n  GraffitiSession,\n  GraffitiObjectUrl,\n} from \"@graffiti-garden/api\";\nimport type { Ajv } from \"ajv\";\nimport type { applyPatch } from \"fast-json-patch\";\n\nexport function unpackObjectUrl(url: string | GraffitiObjectUrl) {\n  return typeof url === \"string\" ? url : url.url;\n}\n\nexport function randomBase64(numBytes: number = 24) {\n  const bytes = new Uint8Array(numBytes);\n  crypto.getRandomValues(bytes);\n  // Convert it to base64\n  const base64 = btoa(String.fromCodePoint(...bytes));\n  // Make sure it is url safe\n  return base64.replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/\\=+$/, \"\");\n}\n\nexport function applyGraffitiPatch<Prop extends keyof GraffitiPatch>(\n  apply: typeof applyPatch,\n  prop: Prop,\n  patch: GraffitiPatch,\n  object: GraffitiObjectBase,\n): void {\n  const ops = patch[prop];\n  if (!ops || !ops.length) return;\n  try {\n    object[prop] = apply(object[prop], ops, true, false).newDocument;\n  } catch (e) {\n    if (\n      typeof e === \"object\" &&\n      e &&\n      \"name\" in e &&\n      typeof e.name === \"string\" &&\n      \"message\" in e &&\n      typeof e.message === \"string\"\n    ) {\n      if (e.name === \"TEST_OPERATION_FAILED\") {\n        throw new GraffitiErrorPatchTestFailed(e.message);\n      } else {\n        throw new GraffitiErrorPatchError(e.name + \": \" + e.message);\n      }\n    } else {\n      throw e;\n    }\n  }\n}\n\nexport function compileGraffitiObjectSchema<Schema extends JSONSchema>(\n  ajv: Ajv,\n  schema: Schema,\n) {\n  try {\n    // Force the validation guard because\n    // it is too big for the type checker.\n    // Fortunately json-schema-to-ts is\n    // well tested against ajv.\n    return ajv.compile(schema) as (\n      data: GraffitiObjectBase,\n    ) => data is GraffitiObject<Schema>;\n  } catch (error) {\n    throw new GraffitiErrorInvalidSchema(\n      error instanceof Error ? error.message : undefined,\n    );\n  }\n}\n\nexport function maskGraffitiObject(\n  object: GraffitiObjectBase,\n  channels: string[],\n  session?: GraffitiSession | null,\n): void {\n  if (object.actor !== session?.actor) {\n    object.allowed = object.allowed && session ? [session.actor] : undefined;\n    object.channels = object.channels.filter((channel) =>\n      channels.includes(channel),\n    );\n  }\n}\nexport function isActorAllowedGraffitiObject(\n  object: GraffitiObjectBase,\n  session?: GraffitiSession | null,\n) {\n  return (\n    object.allowed === undefined ||\n    object.allowed === null ||\n    (!!session?.actor &&\n      (object.actor === session.actor ||\n        object.allowed.includes(session.actor)))\n  );\n}\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAYA,SAAS,gBAAgB,KAAiC;AAC/D,SAAO,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC7C;AAEO,SAAS,aAAa,WAAmB,IAAI;AAClD,QAAM,QAAQ,IAAI,WAAW,QAAQ;AACrC,SAAO,gBAAgB,KAAK;AAE5B,QAAM,SAAS,KAAK,OAAO,cAAc,GAAG,KAAK,CAAC;AAElD,SAAO,OAAO,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,QAAQ,EAAE;AAC1E;AAEO,SAAS,mBACd,OACA,MACA,OACA,QACM;AACN,QAAM,MAAM,MAAM,IAAI;AACtB,MAAI,CAAC,OAAO,CAAC,IAAI,OAAQ;AACzB,MAAI;AACF,WAAO,IAAI,IAAI,MAAM,OAAO,IAAI,GAAG,KAAK,MAAM,KAAK,EAAE;AAAA,EACvD,SAAS,GAAG;AACV,QACE,OAAO,MAAM,YACb,KACA,UAAU,KACV,OAAO,EAAE,SAAS,YAClB,aAAa,KACb,OAAO,EAAE,YAAY,UACrB;AACA,UAAI,EAAE,SAAS,yBAAyB;AACtC,cAAM,IAAI,6BAA6B,EAAE,OAAO;AAAA,MAClD,OAAO;AACL,cAAM,IAAI,wBAAwB,EAAE,OAAO,OAAO,EAAE,OAAO;AAAA,MAC7D;AAAA,IACF,OAAO;AACL,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEO,SAAS,4BACd,KACA,QACA;AACA,MAAI;AAKF,WAAO,IAAI,QAAQ,MAAM;AAAA,EAG3B,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AACF;AAEO,SAAS,mBACd,QACA,UACA,SACM;AACN,MAAI,OAAO,UAAU,SAAS,OAAO;AACnC,WAAO,UAAU,OAAO,WAAW,UAAU,CAAC,QAAQ,KAAK,IAAI;AAC/D,WAAO,WAAW,OAAO,SAAS;AAAA,MAAO,CAAC,YACxC,SAAS,SAAS,OAAO;AAAA,IAC3B;AAAA,EACF;AACF;AACO,SAAS,6BACd,QACA,SACA;AACA,SACE,OAAO,YAAY,UACnB,OAAO,YAAY,QAClB,CAAC,CAAC,SAAS,UACT,OAAO,UAAU,QAAQ,SACxB,OAAO,QAAQ,SAAS,QAAQ,KAAK;AAE7C;",
+  "sourcesContent": ["export function encodeBase64(bytes: Uint8Array): string {\n  // Convert it to base64\n  const base64 = btoa(String.fromCodePoint(...bytes));\n  // Make sure it is url safe\n  return base64.replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/\\=+$/, \"\");\n}\n\nexport function decodeBase64(base64Url: string): Uint8Array {\n  // Undo url-safe base64\n  let base64 = base64Url.replace(/-/g, \"+\").replace(/_/g, \"/\");\n  // Add padding if necessary\n  while (base64.length % 4 !== 0) base64 += \"=\";\n  // Decode\n  return Uint8Array.from(atob(base64), (c) => c.charCodeAt(0));\n}\n\nexport function randomBase64(numBytes: number = 32): string {\n  // Generate random bytes\n  const bytes = new Uint8Array(numBytes);\n  crypto.getRandomValues(bytes);\n  return encodeBase64(bytes);\n}\n\nconst OBJECT_URL_PREFIX = \"graffiti:object:\";\nconst MEDIA_URL_PREFIX = \"graffiti:media:\";\n\nexport function encodeGraffitiUrl(actor: string, id: string, prefix: string) {\n  return `${prefix}${encodeURIComponent(actor)}:${encodeURIComponent(id)}`;\n}\nexport function encodeObjectUrl(actor: string, id: string) {\n  return encodeGraffitiUrl(actor, id, OBJECT_URL_PREFIX);\n}\nexport function encodeMediaUrl(actor: string, id: string) {\n  return encodeGraffitiUrl(actor, id, MEDIA_URL_PREFIX);\n}\n\nexport function decodeGraffitiUrl(url: string, prefix: string) {\n  if (!url.startsWith(prefix)) {\n    throw new Error(`URL does not start with ${prefix}`);\n  }\n  const slices = url.slice(prefix.length).split(\":\");\n  if (slices.length !== 2) {\n    throw new Error(\"URL has too many colon-seperated parts\");\n  }\n  const [actor, id] = slices.map(decodeURIComponent);\n  return { actor, id };\n}\nexport function decodeObjectUrl(url: string) {\n  return decodeGraffitiUrl(url, OBJECT_URL_PREFIX);\n}\nexport function decodeMediaUrl(url: string) {\n  return decodeGraffitiUrl(url, MEDIA_URL_PREFIX);\n}\n\nexport async function blobToBase64(blob: Blob): Promise<string> {\n  if (typeof FileReader !== \"undefined\") {\n    return new Promise((resolve, reject) => {\n      const r = new FileReader();\n      r.onload = () => {\n        if (typeof r.result === \"string\") {\n          resolve(r.result);\n        } else {\n          reject(new Error(\"Unexpected result type\"));\n        }\n      };\n      r.onerror = reject;\n      r.readAsDataURL(blob);\n    });\n  }\n\n  if (typeof Buffer !== \"undefined\") {\n    const ab = await blob.arrayBuffer();\n    return `data:${blob.type};base64,${Buffer.from(ab).toString(\"base64\")}`;\n  }\n\n  throw new Error(\"Unsupported environment\");\n}\n\nexport async function base64ToBlob(dataUrl: string) {\n  const response = await fetch(dataUrl);\n  return await response.blob();\n}\n"],
+  "mappings": "AAAO,SAAS,aAAa,OAA2B;AAEtD,QAAM,SAAS,KAAK,OAAO,cAAc,GAAG,KAAK,CAAC;AAElD,SAAO,OAAO,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,QAAQ,EAAE;AAC1E;AAEO,SAAS,aAAa,WAA+B;AAE1D,MAAI,SAAS,UAAU,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG;AAE3D,SAAO,OAAO,SAAS,MAAM,EAAG,WAAU;AAE1C,SAAO,WAAW,KAAK,KAAK,MAAM,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC7D;AAEO,SAAS,aAAa,WAAmB,IAAY;AAE1D,QAAM,QAAQ,IAAI,WAAW,QAAQ;AACrC,SAAO,gBAAgB,KAAK;AAC5B,SAAO,aAAa,KAAK;AAC3B;AAEA,MAAM,oBAAoB;AAC1B,MAAM,mBAAmB;AAElB,SAAS,kBAAkB,OAAe,IAAY,QAAgB;AAC3E,SAAO,GAAG,MAAM,GAAG,mBAAmB,KAAK,CAAC,IAAI,mBAAmB,EAAE,CAAC;AACxE;AACO,SAAS,gBAAgB,OAAe,IAAY;AACzD,SAAO,kBAAkB,OAAO,IAAI,iBAAiB;AACvD;AACO,SAAS,eAAe,OAAe,IAAY;AACxD,SAAO,kBAAkB,OAAO,IAAI,gBAAgB;AACtD;AAEO,SAAS,kBAAkB,KAAa,QAAgB;AAC7D,MAAI,CAAC,IAAI,WAAW,MAAM,GAAG;AAC3B,UAAM,IAAI,MAAM,2BAA2B,MAAM,EAAE;AAAA,EACrD;AACA,QAAM,SAAS,IAAI,MAAM,OAAO,MAAM,EAAE,MAAM,GAAG;AACjD,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,MAAM,wCAAwC;AAAA,EAC1D;AACA,QAAM,CAAC,OAAO,EAAE,IAAI,OAAO,IAAI,kBAAkB;AACjD,SAAO,EAAE,OAAO,GAAG;AACrB;AACO,SAAS,gBAAgB,KAAa;AAC3C,SAAO,kBAAkB,KAAK,iBAAiB;AACjD;AACO,SAAS,eAAe,KAAa;AAC1C,SAAO,kBAAkB,KAAK,gBAAgB;AAChD;AAEA,eAAsB,aAAa,MAA6B;AAC9D,MAAI,OAAO,eAAe,aAAa;AACrC,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,IAAI,IAAI,WAAW;AACzB,QAAE,SAAS,MAAM;AACf,YAAI,OAAO,EAAE,WAAW,UAAU;AAChC,kBAAQ,EAAE,MAAM;AAAA,QAClB,OAAO;AACL,iBAAO,IAAI,MAAM,wBAAwB,CAAC;AAAA,QAC5C;AAAA,MACF;AACA,QAAE,UAAU;AACZ,QAAE,cAAc,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AAEA,MAAI,OAAO,WAAW,aAAa;AACjC,UAAM,KAAK,MAAM,KAAK,YAAY;AAClC,WAAO,QAAQ,KAAK,IAAI,WAAW,OAAO,KAAK,EAAE,EAAE,SAAS,QAAQ,CAAC;AAAA,EACvE;AAEA,QAAM,IAAI,MAAM,yBAAyB;AAC3C;AAEA,eAAsB,aAAa,SAAiB;AAClD,QAAM,WAAW,MAAM,MAAM,OAAO;AACpC,SAAO,MAAM,SAAS,KAAK;AAC7B;",
   "names": []
 }

package/dist/{session-manager.d.ts → identity.d.ts}

@@ -10,13 +10,15 @@ import type { Graffiti } from "@graffiti-garden/api";
  * It can be used in node.js but will not persist
  * login state and a proposed username must be provided.
  */
-export declare class GraffitiLocalSessionManager {
+export declare class GraffitiLocalIdentity {
     sessionEvents: Graffiti["sessionEvents"];
+    handleToActor: Graffiti["handleToActor"];
+    actorToHandle: Graffiti["actorToHandle"];
     constructor();
-    loggedInActors: string[];
-    protected getLoggedInActors(): string[];
-    protected setLoggedInActors(actors: string[]): void;
+    loggedInHandles: string[];
+    protected getLoggedInHandles(): string[];
+    protected setLoggedInHandles(handles: string[]): void;
     login: Graffiti["login"];
     logout: Graffiti["logout"];
 }
-//# sourceMappingURL=session-manager.d.ts.map
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAIT,MAAM,sBAAsB,CAAC;AAK9B;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAqB;IAE7D,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAItC;IAEF,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAOtC;;IAyBF,eAAe,EAAE,MAAM,EAAE,CAAM;IAE/B,SAAS,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAWxC,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE;IAQ9C,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAyBtB;IAEF,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAmBxB;CACH"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { Graffiti, type GraffitiSession } from "@graffiti-garden/api";
-import { GraffitiLocalSessionManager } from "./session-manager.js";
-import { type GraffitiLocalOptions } from "./database.js";
+import { GraffitiLocalIdentity } from "./identity";
+import { GraffitiLocalObjects, type GraffitiLocalOptions } from "./objects";
+import { GraffitiLocalMedia } from "./media";
 export type { GraffitiLocalOptions };
 /**
  * A local implementation of the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)
@@ -9,22 +10,23 @@ export type { GraffitiLocalOptions };
  * It can also be configured to work with an external [CouchDB](https://couchdb.apache.org/) server,
  * although using it with a remote server will not be secure.
  */
-export declare class GraffitiLocal extends Graffiti {
-    protected sessionManagerLocal: GraffitiLocalSessionManager;
-    login: (proposal?: {
-        actor?: string;
-        scope?: {};
-    }) => Promise<void>;
+export declare class GraffitiLocal implements Graffiti {
+    protected graffitiLocalIdentity: GraffitiLocalIdentity;
+    login: (actor?: string) => Promise<void>;
     logout: (session: GraffitiSession) => Promise<void>;
+    handleToActor: (handle: string) => Promise<string>;
+    actorToHandle: (actor: string) => Promise<string>;
     sessionEvents: EventTarget;
-    put: Graffiti["put"];
+    protected graffitiLocalObjects: GraffitiLocalObjects;
+    post: Graffiti["post"];
     get: Graffiti["get"];
-    patch: Graffiti["patch"];
     delete: Graffiti["delete"];
     discover: Graffiti["discover"];
-    recoverOrphans: Graffiti["recoverOrphans"];
-    channelStats: Graffiti["channelStats"];
-    continueObjectStream: Graffiti["continueObjectStream"];
+    continueDiscover: Graffiti["continueDiscover"];
+    protected graffitiLocalMedia: GraffitiLocalMedia;
+    postMedia: Graffiti["postMedia"];
+    getMedia: Graffiti["getMedia"];
+    deleteMedia: Graffiti["deleteMedia"];
     constructor(options?: GraffitiLocalOptions);
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,mBAAmB,8BAAqC;IAClE,KAAK;aA+Bq7tB,CAAC;aAA6iB,CAAC;wBA/Bn6uB;IACtE,MAAM,8CAAkE;IACxE,aAAa,cAA0C;IAEvD,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC3C,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACvC,oBAAoB,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;gBAE3C,OAAO,CAAC,EAAE,oBAAoB;CAiB3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,SAAS,CAAC,qBAAqB,wBAA+B;IAC9D,KAAK,oCAAqE;IAC1E,MAAM,8CAAsE;IAC5E,aAAa,sCAEX;IACF,aAAa,qCAEX;IACF,aAAa,cAA4C;IAEzD,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACrD,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAE/C,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACjD,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAEzB,OAAO,CAAC,EAAE,oBAAoB;CAyB3C"}

package/dist/media.d.ts

@@ -0,0 +1,9 @@
+import { type Graffiti } from "@graffiti-garden/api";
+export declare class GraffitiLocalMedia {
+    protected db: Pick<Graffiti, "post" | "get" | "delete">;
+    constructor(db: Pick<Graffiti, "post" | "get" | "delete">);
+    postMedia: Graffiti["postMedia"];
+    getMedia: Graffiti["getMedia"];
+    deleteMedia: Graffiti["deleteMedia"];
+}
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,sBAAsB,CAAC;AAwB9B,qBAAa,kBAAkB;IAC7B,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC;gBAE5C,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAIzD,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAqB9B;IAEF,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAqC5B;IAEF,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,CAMlC;CACH"}