@smartive/datocms-utils 2.3.2 → 3.0.0-next.1

package/dist/cache/index.d.ts

@@ -0,0 +1,4 @@
+export * from './store/postgres.js';
+export * from './store/redis.js';
+export * from './types.js';
+export * from './utils.js';

package/dist/cache/index.js

@@ -0,0 +1,5 @@
+export * from './store/postgres.js';
+export * from './store/redis.js';
+export * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/cache/store/postgres.d.ts

@@ -0,0 +1,4 @@
+import { type CacheTagsStore } from '../types.js';
+export declare const createPostgresCacheTagsStore: ({ table }: {
+    table: string;
+}) => CacheTagsStore;

package/dist/cache/store/postgres.js

@@ -0,0 +1,34 @@
+import { sql } from '@vercel/postgres';
+export const createPostgresCacheTagsStore = ({ table }) => {
+    const storeQueryCacheTags = async (queryId, cacheTags) => {
+        if (!cacheTags?.length) {
+            return;
+        }
+        const tags = cacheTags.flatMap((_, i) => [queryId, cacheTags[i]]);
+        const placeholders = cacheTags.map((_, i) => `($${2 * i + 1}, $${2 * i + 2})`).join(',');
+        await sql.query(`INSERT INTO ${table} VALUES ${placeholders} ON CONFLICT DO NOTHING`, tags);
+    };
+    const queriesReferencingCacheTags = async (cacheTags) => {
+        if (!cacheTags?.length) {
+            return [];
+        }
+        const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
+        const { rows } = await sql.query(`SELECT DISTINCT query_id FROM ${table} WHERE cache_tag IN (${placeholders})`, cacheTags);
+        return rows.map((row) => row.query_id);
+    };
+    const deleteCacheTags = async (cacheTags) => {
+        if (cacheTags.length === 0) {
+            return 0;
+        }
+        const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
+        return (await sql.query(`DELETE FROM ${table} WHERE cache_tag IN (${placeholders})`, cacheTags)).rowCount ?? 0;
+    };
+    const truncateCacheTags = async () => (await sql.query(`DELETE FROM ${table}`)).rowCount ?? 0;
+    return {
+        storeQueryCacheTags,
+        queriesReferencingCacheTags,
+        deleteCacheTags,
+        truncateCacheTags,
+    };
+};
+//# sourceMappingURL=postgres.js.map

package/dist/cache/store/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../../src/cache/store/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAGvC,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,EAAE,KAAK,EAAqB,EAAkB,EAAE;IAC3F,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAAe,EAAE,SAAqB,EAAE,EAAE;QAC3E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEzF,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,WAAW,YAAY,yBAAyB,EAAE,IAAI,CAAC,CAAC;IAC9F,CAAC,CAAC;IAEF,MAAM,2BAA2B,GAAG,KAAK,EAAE,SAAqB,EAAqB,EAAE;QACrF,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEpE,MAAM,EAAE,IAAI,EAAE,GAAqC,MAAM,GAAG,CAAC,KAAK,CAChE,iCAAiC,KAAK,wBAAwB,YAAY,GAAG,EAC7E,SAAS,CACV,CAAC;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,EAAE,SAAqB,EAAE,EAAE;QACtD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEpE,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,wBAAwB,YAAY,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;IACjH,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;IAE9F,OAAO;QACL,mBAAmB;QACnB,2BAA2B;QAC3B,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC,CAAC"}

package/dist/cache/store/redis.d.ts

@@ -0,0 +1,5 @@
+import { type CacheTagsStore } from '../types.js';
+export declare const createRedisCacheTagsStore: ({ url, keyPrefix }: {
+    url: string;
+    keyPrefix?: string;
+}) => CacheTagsStore;

package/dist/cache/store/redis.js

@@ -0,0 +1,46 @@
+import { Redis } from 'ioredis';
+export const createRedisCacheTagsStore = ({ url, keyPrefix = '' }) => {
+    const redis = new Redis(url, {
+        maxRetriesPerRequest: 3,
+        lazyConnect: true,
+    });
+    const storeQueryCacheTags = async (queryId, cacheTags) => {
+        if (!cacheTags?.length) {
+            return;
+        }
+        const pipeline = redis.pipeline();
+        for (const tag of cacheTags) {
+            pipeline.sadd(`${keyPrefix}${tag}`, queryId);
+        }
+        await pipeline.exec();
+    };
+    const queriesReferencingCacheTags = async (cacheTags) => {
+        if (!cacheTags?.length) {
+            return [];
+        }
+        const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
+        return redis.sunion(...keys);
+    };
+    const deleteCacheTags = async (cacheTags) => {
+        if (!cacheTags?.length) {
+            return 0;
+        }
+        const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
+        return redis.del(...keys);
+    };
+    const truncateCacheTags = async () => {
+        const pattern = `${keyPrefix}*`;
+        const keys = await redis.keys(pattern);
+        if (keys.length === 0) {
+            return 0;
+        }
+        return await redis.del(...keys);
+    };
+    return {
+        storeQueryCacheTags,
+        queriesReferencingCacheTags,
+        deleteCacheTags,
+        truncateCacheTags,
+    };
+};
+//# sourceMappingURL=redis.js.map

package/dist/cache/store/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../src/cache/store/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,EAAE,EAAuC,EAAkB,EAAE;IACxH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE;QAC3B,oBAAoB,EAAE,CAAC;QACvB,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAAe,EAAE,SAAqB,EAAE,EAAE;QAC3E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAElC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,2BAA2B,GAAG,KAAK,EAAE,SAAqB,EAAE,EAAE;QAClE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC;QAE1D,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,EAAE,SAAqB,EAAE,EAAE;QACtD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC;QAE1D,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAG,GAAG,SAAS,GAAG,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC;IAEF,OAAO;QACL,mBAAmB;QACnB,2BAA2B;QAC3B,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC,CAAC"}

package/dist/cache/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * A branded type for cache tags. This is created by intersecting `string`
+ * with `{ readonly _: unique symbol }`, making it a unique type.
+ * Although it is fundamentally a string, it is treated as a distinct type
+ * due to the unique symbol.
+ */
+export type CacheTag = string & {
+    readonly _: unique symbol;
+};
+/**
+ * A type representing the structure of a webhook payload for cache tag invalidation.
+ * It includes the entity type, event type, and the entity details which contain
+ * the cache tags to be invalidated.
+ */
+export type CacheTagsInvalidateWebhook = {
+    entity_type: 'cda_cache_tags';
+    event_type: 'invalidate';
+    entity: {
+        id: 'cda_cache_tags';
+        type: 'cda_cache_tags';
+        attributes: {
+            tags: CacheTag[];
+        };
+    };
+};
+export type CacheTagsStore = {
+    /**
+     * Stores the cache tags of a query.
+     *
+     * @param {string} queryId Unique query ID
+     * @param {CacheTag[]} cacheTags Array of cache tags
+     *
+     */
+    storeQueryCacheTags(queryId: string, cacheTags: CacheTag[]): Promise<void>;
+    /**
+     * Retrieves the query IDs that reference any of the specified cache tags.
+     *
+     * @param {CacheTag[]} cacheTags Array of cache tags to check
+     * @returns Array of unique query IDs
+     *
+     */
+    queriesReferencingCacheTags(cacheTags: CacheTag[]): Promise<string[]>;
+    /**
+     * Deletes the specified cache tags.
+     *
+     * This removes the cache tag keys entirely. When queries are revalidated and
+     * run again, fresh cache tag mappings will be created.
+     *
+     * @param {CacheTag[]} cacheTags Array of cache tags to delete
+     * @returns Number of keys deleted, or null if there was an error
+     *
+     */
+    deleteCacheTags(cacheTags: CacheTag[]): Promise<number>;
+    /**
+     * Wipes out all cache tags.
+     *
+     * ⚠️ **Warning**: This will delete all cache tag data. Use with caution!
+     */
+    truncateCacheTags(): Promise<number>;
+};

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":""}

package/dist/{utils.d.ts → cache/utils.d.ts}

@@ -1,5 +1,5 @@
 import { type DocumentNode } from 'graphql';
-import { type CacheTag } from './types';
+import { type CacheTag } from './types.js';
 /**
  * Converts the value of DatoCMS's `X-Cache-Tags` header into an array of strings typed as `CacheTag`.
  * For example, it transforms `'tag-a tag-2 other-tag'` into `['tag-a', 'tag-2', 'other-tag']`.

package/dist/cache/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cache/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAsB,EAAE,EAAE,CACtE,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAe,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAuB,QAAsB,EAAE,SAAsB,EAAU,EAAE;IAC9G,OAAO,UAAU,CAAC,MAAM,CAAC;SACtB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SACvB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;SACvC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,2 @@
-export * from './cache-tags';
-export * as postgres from './cache-tags';
-export * as redis from './cache-tags-redis';
-export * from './classnames';
-export * from './links';
-export * from './types';
+export * from './classnames.js';
+export * from './links.js';

package/dist/index.js

@@ -1,7 +1,3 @@
-export * from './cache-tags';
-export * as postgres from './cache-tags';
-export * as redis from './cache-tags-redis';
-export * from './classnames';
-export * from './links';
-export * from './types';
+export * from './classnames.js';
+export * from './links.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,QAAQ,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/package.json

@@ -1,30 +1,26 @@
 {
   "name": "@smartive/datocms-utils",
-  "version": "2.3.2",
+  "version": "3.0.0-next.1",
   "description": "A set of utilities and helpers to work with DatoCMS in a Next.js project.",
   "type": "module",
   "source": "./src/index.ts",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist/**/*",
-    "src/**/*"
-  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "import": "./dist/index.js"
     },
-    "./redis": {
-      "types": "./dist/cache-tags-redis.d.ts",
-      "default": "./dist/cache-tags-redis.js"
-    },
-    "./postgres": {
-      "types": "./dist/cache-tags.d.ts",
-      "default": "./dist/cache-tags.js"
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js"
     }
   },
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ],
   "scripts": {
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
     "build": "tsc",
     "lint": "eslint src",
     "prettier": "prettier --check src"
@@ -45,20 +41,27 @@
     "@smartive/eslint-config": "7.0.1",
     "@smartive/prettier-config": "3.1.2",
     "@types/node": "24.10.12",
+    "@vercel/postgres": "0.10.0",
     "eslint": "9.39.2",
     "eslint-import-resolver-typescript": "4.4.4",
+    "graphql": "16.12.0",
+    "ioredis": "5.9.2",
     "prettier": "3.8.1",
-    "typescript": "5.9.3",
-    "ioredis": "5.9.2"
-  },
-  "dependencies": {
-    "@vercel/postgres": "^0.10.0",
-    "graphql": "^16.9.0"
+    "rimraf": "6.1.2",
+    "typescript": "5.9.3"
   },
   "peerDependencies": {
+    "@vercel/postgres": "^0.10.0",
+    "graphql": "^15.0.0 || ^16.0.0",
     "ioredis": "^5.4.0"
   },
   "peerDependenciesMeta": {
+    "@vercel/postgres": {
+      "optional": true
+    },
+    "graphql": {
+      "optional": true
+    },
     "ioredis": {
       "optional": true
     }

package/src/cache/index.ts

@@ -0,0 +1,4 @@
+export * from './store/postgres.js';
+export * from './store/redis.js';
+export * from './types.js';
+export * from './utils.js';

package/src/cache/store/postgres.ts

@@ -0,0 +1,48 @@
+import { sql } from '@vercel/postgres';
+import { type CacheTag, type CacheTagsStore } from '../types.js';
+
+export const createPostgresCacheTagsStore = ({ table }: { table: string }): CacheTagsStore => {
+  const storeQueryCacheTags = async (queryId: string, cacheTags: CacheTag[]) => {
+    if (!cacheTags?.length) {
+      return;
+    }
+
+    const tags = cacheTags.flatMap((_, i) => [queryId, cacheTags[i]]);
+    const placeholders = cacheTags.map((_, i) => `($${2 * i + 1}, $${2 * i + 2})`).join(',');
+
+    await sql.query(`INSERT INTO ${table} VALUES ${placeholders} ON CONFLICT DO NOTHING`, tags);
+  };
+
+  const queriesReferencingCacheTags = async (cacheTags: CacheTag[]): Promise<string[]> => {
+    if (!cacheTags?.length) {
+      return [];
+    }
+
+    const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
+
+    const { rows }: { rows: { query_id: string }[] } = await sql.query(
+      `SELECT DISTINCT query_id FROM ${table} WHERE cache_tag IN (${placeholders})`,
+      cacheTags,
+    );
+
+    return rows.map((row) => row.query_id);
+  };
+
+  const deleteCacheTags = async (cacheTags: CacheTag[]) => {
+    if (cacheTags.length === 0) {
+      return 0;
+    }
+    const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
+
+    return (await sql.query(`DELETE FROM ${table} WHERE cache_tag IN (${placeholders})`, cacheTags)).rowCount ?? 0;
+  };
+
+  const truncateCacheTags = async () => (await sql.query(`DELETE FROM ${table}`)).rowCount ?? 0;
+
+  return {
+    storeQueryCacheTags,
+    queriesReferencingCacheTags,
+    deleteCacheTags,
+    truncateCacheTags,
+  };
+};

package/src/cache/store/redis.ts

@@ -0,0 +1,61 @@
+import { Redis } from 'ioredis';
+import { type CacheTag, type CacheTagsStore } from '../types.js';
+
+export const createRedisCacheTagsStore = ({ url, keyPrefix = '' }: { url: string; keyPrefix?: string }): CacheTagsStore => {
+  const redis = new Redis(url, {
+    maxRetriesPerRequest: 3,
+    lazyConnect: true,
+  });
+
+  const storeQueryCacheTags = async (queryId: string, cacheTags: CacheTag[]) => {
+    if (!cacheTags?.length) {
+      return;
+    }
+
+    const pipeline = redis.pipeline();
+
+    for (const tag of cacheTags) {
+      pipeline.sadd(`${keyPrefix}${tag}`, queryId);
+    }
+
+    await pipeline.exec();
+  };
+
+  const queriesReferencingCacheTags = async (cacheTags: CacheTag[]) => {
+    if (!cacheTags?.length) {
+      return [];
+    }
+
+    const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
+
+    return redis.sunion(...keys);
+  };
+
+  const deleteCacheTags = async (cacheTags: CacheTag[]) => {
+    if (!cacheTags?.length) {
+      return 0;
+    }
+
+    const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
+
+    return redis.del(...keys);
+  };
+
+  const truncateCacheTags = async () => {
+    const pattern = `${keyPrefix}*`;
+    const keys = await redis.keys(pattern);
+
+    if (keys.length === 0) {
+      return 0;
+    }
+
+    return await redis.del(...keys);
+  };
+
+  return {
+    storeQueryCacheTags,
+    queriesReferencingCacheTags,
+    deleteCacheTags,
+    truncateCacheTags,
+  };
+};

package/src/cache/types.ts

@@ -0,0 +1,63 @@
+/**
+ * A branded type for cache tags. This is created by intersecting `string`
+ * with `{ readonly _: unique symbol }`, making it a unique type.
+ * Although it is fundamentally a string, it is treated as a distinct type
+ * due to the unique symbol.
+ */
+export type CacheTag = string & { readonly _: unique symbol };
+
+/**
+ * A type representing the structure of a webhook payload for cache tag invalidation.
+ * It includes the entity type, event type, and the entity details which contain
+ * the cache tags to be invalidated.
+ */
+export type CacheTagsInvalidateWebhook = {
+  entity_type: 'cda_cache_tags';
+  event_type: 'invalidate';
+  entity: {
+    id: 'cda_cache_tags';
+    type: 'cda_cache_tags';
+    attributes: {
+      tags: CacheTag[];
+    };
+  };
+};
+
+export type CacheTagsStore = {
+  /**
+   * Stores the cache tags of a query.
+   *
+   * @param {string} queryId Unique query ID
+   * @param {CacheTag[]} cacheTags Array of cache tags
+   *
+   */
+  storeQueryCacheTags(queryId: string, cacheTags: CacheTag[]): Promise<void>;
+
+  /**
+   * Retrieves the query IDs that reference any of the specified cache tags.
+   *
+   * @param {CacheTag[]} cacheTags Array of cache tags to check
+   * @returns Array of unique query IDs
+   *
+   */
+  queriesReferencingCacheTags(cacheTags: CacheTag[]): Promise<string[]>;
+
+  /**
+   * Deletes the specified cache tags.
+   *
+   * This removes the cache tag keys entirely. When queries are revalidated and
+   * run again, fresh cache tag mappings will be created.
+   *
+   * @param {CacheTag[]} cacheTags Array of cache tags to delete
+   * @returns Number of keys deleted, or null if there was an error
+   *
+   */
+  deleteCacheTags(cacheTags: CacheTag[]): Promise<number>;
+
+  /**
+   * Wipes out all cache tags.
+   *
+   * ⚠️ **Warning**: This will delete all cache tag data. Use with caution!
+   */
+  truncateCacheTags(): Promise<number>;
+};

package/src/{utils.ts → cache/utils.ts}

@@ -1,6 +1,6 @@
 import { print, type DocumentNode } from 'graphql';
 import { createHash } from 'node:crypto';
-import { type CacheTag } from './types';
+import { type CacheTag } from './types.js';
 
 /**
  * Converts the value of DatoCMS's `X-Cache-Tags` header into an array of strings typed as `CacheTag`.

package/src/index.ts

@@ -1,6 +1,2 @@
-export * from './cache-tags';
-export * as postgres from './cache-tags';
-export * as redis from './cache-tags-redis';
-export * from './classnames';
-export * from './links';
-export * from './types';
+export * from './classnames.js';
+export * from './links.js';

package/dist/cache-tags-redis.d.ts

@@ -1,39 +0,0 @@
-import { type CacheTag } from './types';
-/**
- * Stores the cache tags of a query in Redis.
- *
- * For each cache tag, adds the query ID to a Redis Set. Sets are unordered
- * collections of unique strings, perfect for tracking which queries use which tags.
- *
- * @param {string} queryId Unique query ID
- * @param {CacheTag[]} cacheTags Array of cache tags
- *
- */
-export declare const storeQueryCacheTags: (queryId: string, cacheTags: CacheTag[]) => Promise<void>;
-/**
- * Retrieves the query IDs that reference any of the specified cache tags.
- *
- * Uses Redis SUNION to efficiently find all queries associated with the given tags.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to check
- * @returns Array of unique query IDs
- *
- */
-export declare const queriesReferencingCacheTags: (cacheTags: CacheTag[]) => Promise<string[]>;
-/**
- * Deletes the specified cache tags from Redis.
- *
- * This removes the cache tag keys entirely. When queries are revalidated and
- * run again, fresh cache tag mappings will be created.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to delete
- * @returns Number of keys deleted, or null if there was an error
- *
- */
-export declare const deleteCacheTags: (cacheTags: CacheTag[]) => Promise<number>;
-/**
- * Wipes out all cache tags from Redis.
- *
- * ⚠️ **Warning**: This will delete all cache tag data. Use with caution!
- */
-export declare const truncateCacheTags: () => Promise<void>;

package/dist/cache-tags-redis.js

@@ -1,80 +0,0 @@
-import { Redis } from 'ioredis';
-let redis = null;
-const getRedis = () => {
-    redis ??= new Redis(process.env.REDIS_URL, {
-        maxRetriesPerRequest: 3,
-        lazyConnect: true,
-    });
-    return redis;
-};
-const keyPrefix = process.env.REDIS_KEY_PREFIX ? `${process.env.REDIS_KEY_PREFIX}:` : '';
-/**
- * Stores the cache tags of a query in Redis.
- *
- * For each cache tag, adds the query ID to a Redis Set. Sets are unordered
- * collections of unique strings, perfect for tracking which queries use which tags.
- *
- * @param {string} queryId Unique query ID
- * @param {CacheTag[]} cacheTags Array of cache tags
- *
- */
-export const storeQueryCacheTags = async (queryId, cacheTags) => {
-    if (!cacheTags?.length) {
-        return;
-    }
-    const redis = getRedis();
-    const pipeline = redis.pipeline();
-    for (const tag of cacheTags) {
-        pipeline.sadd(`${keyPrefix}${tag}`, queryId);
-    }
-    await pipeline.exec();
-};
-/**
- * Retrieves the query IDs that reference any of the specified cache tags.
- *
- * Uses Redis SUNION to efficiently find all queries associated with the given tags.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to check
- * @returns Array of unique query IDs
- *
- */
-export const queriesReferencingCacheTags = async (cacheTags) => {
-    if (!cacheTags?.length) {
-        return [];
-    }
-    const redis = getRedis();
-    const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
-    return redis.sunion(...keys);
-};
-/**
- * Deletes the specified cache tags from Redis.
- *
- * This removes the cache tag keys entirely. When queries are revalidated and
- * run again, fresh cache tag mappings will be created.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to delete
- * @returns Number of keys deleted, or null if there was an error
- *
- */
-export const deleteCacheTags = async (cacheTags) => {
-    if (!cacheTags?.length) {
-        return 0;
-    }
-    const redis = getRedis();
-    const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
-    return redis.del(...keys);
-};
-/**
- * Wipes out all cache tags from Redis.
- *
- * ⚠️ **Warning**: This will delete all cache tag data. Use with caution!
- */
-export const truncateCacheTags = async () => {
-    const redis = getRedis();
-    const pattern = `${keyPrefix}*`;
-    const keys = await redis.keys(pattern);
-    if (keys.length > 0) {
-        await redis.del(...keys);
-    }
-};
-//# sourceMappingURL=cache-tags-redis.js.map

package/dist/cache-tags-redis.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache-tags-redis.js","sourceRoot":"","sources":["../src/cache-tags-redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,IAAI,KAAK,GAAiB,IAAI,CAAC;AAE/B,MAAM,QAAQ,GAAG,GAAU,EAAE;IAC3B,KAAK,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAU,EAAE;QAC1C,oBAAoB,EAAE,CAAC;QACvB,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAEzF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,OAAe,EAAE,SAAqB,EAAiB,EAAE;IACjG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,EAAE,SAAqB,EAAqB,EAAE;IAC5F,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC;IAE1D,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,SAAqB,EAAmB,EAAE;IAC9E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC;IAE1D,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,IAAmB,EAAE;IACzD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,GAAG,SAAS,GAAG,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC"}

package/dist/cache-tags.d.ts

@@ -1,43 +0,0 @@
-import { type CacheTag } from './types';
-export { generateQueryId, parseXCacheTagsResponseHeader } from './utils';
-/**
- * Stores the cache tags of a query in the database.
- *
- * @param {string} queryId Unique query ID
- * @param {CacheTag[]} cacheTags Array of cache tags
- * @param {string} tableId Database table ID
- */
-export declare const storeQueryCacheTags: (queryId: string, cacheTags: CacheTag[], tableId: string) => Promise<void>;
-/**
- * Retrieves the queries that reference cache tags.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags
- * @param {string} tableId Database table ID
- * @returns Array of query IDs
- */
-export declare const queriesReferencingCacheTags: (cacheTags: CacheTag[], tableId: string) => Promise<string[]>;
-/**
- * Deletes the specified cache tags from the database.
- *
- * This removes the cache tag keys entirely. When queries are revalidated and
- * run again, fresh cache tag mappings will be created.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to delete
- * @param {string} tableId Database table ID
- *
- */
-export declare const deleteCacheTags: (cacheTags: CacheTag[], tableId: string) => Promise<void>;
-/**
- * Deletes the cache tags of a query from the database.
- *
- * @param {string} queryId Unique query ID
- * @param {string} tableId Database table ID
- * @deprecated Use `deleteCacheTags` instead.
- */
-export declare const deleteQueries: (queryIds: string[], tableId: string) => Promise<void>;
-/**
- * Wipes out all cache tags from the database.
- *
- * @param {string} tableId Database table ID
- */
-export declare function truncateCacheTags(tableId: string): Promise<void>;

package/dist/cache-tags.js

@@ -1,72 +0,0 @@
-import { sql } from '@vercel/postgres';
-export { generateQueryId, parseXCacheTagsResponseHeader } from './utils';
-/**
- * Stores the cache tags of a query in the database.
- *
- * @param {string} queryId Unique query ID
- * @param {CacheTag[]} cacheTags Array of cache tags
- * @param {string} tableId Database table ID
- */
-export const storeQueryCacheTags = async (queryId, cacheTags, tableId) => {
-    if (!cacheTags?.length) {
-        return;
-    }
-    const tags = cacheTags.flatMap((_, i) => [queryId, cacheTags[i]]);
-    const placeholders = cacheTags.map((_, i) => `($${2 * i + 1}, $${2 * i + 2})`).join(',');
-    await sql.query(`INSERT INTO ${tableId} VALUES ${placeholders} ON CONFLICT DO NOTHING`, tags);
-};
-/**
- * Retrieves the queries that reference cache tags.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags
- * @param {string} tableId Database table ID
- * @returns Array of query IDs
- */
-export const queriesReferencingCacheTags = async (cacheTags, tableId) => {
-    if (!cacheTags?.length) {
-        return [];
-    }
-    const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
-    const { rows } = await sql.query(`SELECT DISTINCT query_id FROM ${tableId} WHERE cache_tag IN (${placeholders})`, cacheTags);
-    return rows.map((row) => row.query_id);
-};
-/**
- * Deletes the specified cache tags from the database.
- *
- * This removes the cache tag keys entirely. When queries are revalidated and
- * run again, fresh cache tag mappings will be created.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to delete
- * @param {string} tableId Database table ID
- *
- */
-export const deleteCacheTags = async (cacheTags, tableId) => {
-    if (cacheTags.length === 0) {
-        return;
-    }
-    const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
-    await sql.query(`DELETE FROM ${tableId} WHERE cache_tag IN (${placeholders})`, cacheTags);
-};
-/**
- * Deletes the cache tags of a query from the database.
- *
- * @param {string} queryId Unique query ID
- * @param {string} tableId Database table ID
- * @deprecated Use `deleteCacheTags` instead.
- */
-export const deleteQueries = async (queryIds, tableId) => {
-    if (!queryIds?.length) {
-        return;
-    }
-    const placeholders = queryIds.map((_, i) => `$${i + 1}`).join(',');
-    await sql.query(`DELETE FROM ${tableId} WHERE query_id IN (${placeholders})`, queryIds);
-};
-/**
- * Wipes out all cache tags from the database.
- *
- * @param {string} tableId Database table ID
- */
-export async function truncateCacheTags(tableId) {
-    await sql.query(`DELETE FROM ${tableId}`);
-}
-//# sourceMappingURL=cache-tags.js.map

package/dist/cache-tags.js.map

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

package/dist/types.d.ts

@@ -1,25 +0,0 @@
-/**
- * A branded type for cache tags. This is created by intersecting `string`
- * with `{ readonly _: unique symbol }`, making it a unique type.
- * Although it is fundamentally a string, it is treated as a distinct type
- * due to the unique symbol.
- */
-export type CacheTag = string & {
-    readonly _: unique symbol;
-};
-/**
- * A type representing the structure of a webhook payload for cache tag invalidation.
- * It includes the entity type, event type, and the entity details which contain
- * the cache tags to be invalidated.
- */
-export type CacheTagsInvalidateWebhook = {
-    entity_type: 'cda_cache_tags';
-    event_type: 'invalidate';
-    entity: {
-        id: 'cda_cache_tags';
-        type: 'cda_cache_tags';
-        attributes: {
-            tags: CacheTag[];
-        };
-    };
-};

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAsB,EAAE,EAAE,CACtE,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAe,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAuB,QAAsB,EAAE,SAAsB,EAAU,EAAE;IAC9G,OAAO,UAAU,CAAC,MAAM,CAAC;SACtB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SACvB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;SACvC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC,CAAC"}

package/src/cache-tags-redis.ts

@@ -1,96 +0,0 @@
-import { Redis } from 'ioredis';
-import { type CacheTag } from './types';
-
-let redis: Redis | null = null;
-
-const getRedis = (): Redis => {
-  redis ??= new Redis(process.env.REDIS_URL!, {
-    maxRetriesPerRequest: 3,
-    lazyConnect: true,
-  });
-
-  return redis;
-};
-
-const keyPrefix = process.env.REDIS_KEY_PREFIX ? `${process.env.REDIS_KEY_PREFIX}:` : '';
-
-/**
- * Stores the cache tags of a query in Redis.
- *
- * For each cache tag, adds the query ID to a Redis Set. Sets are unordered
- * collections of unique strings, perfect for tracking which queries use which tags.
- *
- * @param {string} queryId Unique query ID
- * @param {CacheTag[]} cacheTags Array of cache tags
- *
- */
-export const storeQueryCacheTags = async (queryId: string, cacheTags: CacheTag[]): Promise<void> => {
-  if (!cacheTags?.length) {
-    return;
-  }
-
-  const redis = getRedis();
-  const pipeline = redis.pipeline();
-
-  for (const tag of cacheTags) {
-    pipeline.sadd(`${keyPrefix}${tag}`, queryId);
-  }
-
-  await pipeline.exec();
-};
-
-/**
- * Retrieves the query IDs that reference any of the specified cache tags.
- *
- * Uses Redis SUNION to efficiently find all queries associated with the given tags.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to check
- * @returns Array of unique query IDs
- *
- */
-export const queriesReferencingCacheTags = async (cacheTags: CacheTag[]): Promise<string[]> => {
-  if (!cacheTags?.length) {
-    return [];
-  }
-
-  const redis = getRedis();
-  const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
-
-  return redis.sunion(...keys);
-};
-
-/**
- * Deletes the specified cache tags from Redis.
- *
- * This removes the cache tag keys entirely. When queries are revalidated and
- * run again, fresh cache tag mappings will be created.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to delete
- * @returns Number of keys deleted, or null if there was an error
- *
- */
-export const deleteCacheTags = async (cacheTags: CacheTag[]): Promise<number> => {
-  if (!cacheTags?.length) {
-    return 0;
-  }
-
-  const redis = getRedis();
-  const keys = cacheTags.map((tag) => `${keyPrefix}${tag}`);
-
-  return redis.del(...keys);
-};
-
-/**
- * Wipes out all cache tags from Redis.
- *
- * ⚠️ **Warning**: This will delete all cache tag data. Use with caution!
- */
-export const truncateCacheTags = async (): Promise<void> => {
-  const redis = getRedis();
-  const pattern = `${keyPrefix}*`;
-  const keys = await redis.keys(pattern);
-
-  if (keys.length > 0) {
-    await redis.del(...keys);
-  }
-};

package/src/cache-tags.ts

@@ -1,88 +0,0 @@
-import { sql } from '@vercel/postgres';
-import { type CacheTag } from './types';
-
-export { generateQueryId, parseXCacheTagsResponseHeader } from './utils';
-
-/**
- * Stores the cache tags of a query in the database.
- *
- * @param {string} queryId Unique query ID
- * @param {CacheTag[]} cacheTags Array of cache tags
- * @param {string} tableId Database table ID
- */
-export const storeQueryCacheTags = async (queryId: string, cacheTags: CacheTag[], tableId: string) => {
-  if (!cacheTags?.length) {
-    return;
-  }
-
-  const tags = cacheTags.flatMap((_, i) => [queryId, cacheTags[i]]);
-  const placeholders = cacheTags.map((_, i) => `($${2 * i + 1}, $${2 * i + 2})`).join(',');
-
-  await sql.query(`INSERT INTO ${tableId} VALUES ${placeholders} ON CONFLICT DO NOTHING`, tags);
-};
-
-/**
- * Retrieves the queries that reference cache tags.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags
- * @param {string} tableId Database table ID
- * @returns Array of query IDs
- */
-export const queriesReferencingCacheTags = async (cacheTags: CacheTag[], tableId: string): Promise<string[]> => {
-  if (!cacheTags?.length) {
-    return [];
-  }
-
-  const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
-
-  const { rows }: { rows: { query_id: string }[] } = await sql.query(
-    `SELECT DISTINCT query_id FROM ${tableId} WHERE cache_tag IN (${placeholders})`,
-    cacheTags,
-  );
-
-  return rows.map((row) => row.query_id);
-};
-
-/**
- * Deletes the specified cache tags from the database.
- *
- * This removes the cache tag keys entirely. When queries are revalidated and
- * run again, fresh cache tag mappings will be created.
- *
- * @param {CacheTag[]} cacheTags Array of cache tags to delete
- * @param {string} tableId Database table ID
- *
- */
-export const deleteCacheTags = async (cacheTags: CacheTag[], tableId: string) => {
-  if (cacheTags.length === 0) {
-    return;
-  }
-  const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
-
-  await sql.query(`DELETE FROM ${tableId} WHERE cache_tag IN (${placeholders})`, cacheTags);
-};
-
-/**
- * Deletes the cache tags of a query from the database.
- *
- * @param {string} queryId Unique query ID
- * @param {string} tableId Database table ID
- * @deprecated Use `deleteCacheTags` instead.
- */
-export const deleteQueries = async (queryIds: string[], tableId: string) => {
-  if (!queryIds?.length) {
-    return;
-  }
-  const placeholders = queryIds.map((_, i) => `$${i + 1}`).join(',');
-
-  await sql.query(`DELETE FROM ${tableId} WHERE query_id IN (${placeholders})`, queryIds);
-};
-
-/**
- * Wipes out all cache tags from the database.
- *
- * @param {string} tableId Database table ID
- */
-export async function truncateCacheTags(tableId: string) {
-  await sql.query(`DELETE FROM ${tableId}`);
-}

package/src/types.ts

@@ -1,24 +0,0 @@
-/**
- * A branded type for cache tags. This is created by intersecting `string`
- * with `{ readonly _: unique symbol }`, making it a unique type.
- * Although it is fundamentally a string, it is treated as a distinct type
- * due to the unique symbol.
- */
-export type CacheTag = string & { readonly _: unique symbol };
-
-/**
- * A type representing the structure of a webhook payload for cache tag invalidation.
- * It includes the entity type, event type, and the entity details which contain
- * the cache tags to be invalidated.
- */
-export type CacheTagsInvalidateWebhook = {
-  entity_type: 'cda_cache_tags';
-  event_type: 'invalidate';
-  entity: {
-    id: 'cda_cache_tags';
-    type: 'cda_cache_tags';
-    attributes: {
-      tags: CacheTag[];
-    };
-  };
-};