@smartive/datocms-utils 2.3.3 → 3.0.0-next.10

package/package.json

@@ -1,16 +1,38 @@
 {
   "name": "@smartive/datocms-utils",
-  "version": "2.3.3",
+  "version": "3.0.0-next.10",
   "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",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cache-tags": {
+      "types": "./dist/cache-tags/index.d.ts",
+      "import": "./dist/cache-tags/index.js"
+    },
+    "./cache-tags/redis": {
+      "types": "./dist/cache-tags/provider/redis.d.ts",
+      "import": "./dist/cache-tags/provider/redis.js"
+    },
+    "./cache-tags/neon": {
+      "types": "./dist/cache-tags/provider/neon.d.ts",
+      "import": "./dist/cache-tags/provider/neon.js"
+    },
+    "./cache-tags/noop": {
+      "types": "./dist/cache-tags/provider/noop.d.ts",
+      "import": "./dist/cache-tags/provider/noop.js"
+    }
+  },
   "files": [
     "dist/**/*",
     "src/**/*"
   ],
   "scripts": {
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
     "build": "tsc",
     "lint": "eslint src",
     "prettier": "prettier --check src"
@@ -28,23 +50,30 @@
     "type": "git"
   },
   "devDependencies": {
+    "@neondatabase/serverless": "1.0.2",
     "@smartive/eslint-config": "7.0.1",
     "@smartive/prettier-config": "3.1.2",
-    "@types/node": "24.10.12",
+    "@types/node": "24.10.13",
     "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": {
+    "@neondatabase/serverless": "^1.0.0",
+    "graphql": "^15.0.0 || ^16.0.0",
     "ioredis": "^5.4.0"
   },
   "peerDependenciesMeta": {
+    "@neondatabase/serverless": {
+      "optional": true
+    },
+    "graphql": {
+      "optional": true
+    },
     "ioredis": {
       "optional": true
     }

package/src/cache-tags/index.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './utils.js';

package/src/cache-tags/provider/neon.ts

@@ -0,0 +1,80 @@
+import { neon } from '@neondatabase/serverless';
+import { type CacheTag, type CacheTagsProvider } from '../types.js';
+
+type NeonCacheTagsProviderConfig = {
+  /**
+   * Neon connection string. You can find it in the "Connection" tab of your Neon project dashboard.
+   * Has the format `postgresql://user:pass@host/db`
+   */
+  readonly connectionUrl: string;
+  /**
+   * Name of the table where cache tags will be stored. The table must have the following schema:
+   *
+   * ```sql
+   * CREATE TABLE your_table_name (
+   *   query_id TEXT NOT NULL,
+   *   cache_tag TEXT NOT NULL,
+   *   PRIMARY KEY (query_id, cache_tag)
+   * );
+   * ```
+   */
+  readonly table: string;
+};
+
+/**
+ * A `CacheTagsProvider` implementation that uses Neon as the storage backend.
+ */
+export class NeonCacheTagsProvider implements CacheTagsProvider {
+  private readonly sql;
+  private readonly table;
+
+  constructor({ connectionUrl, table }: NeonCacheTagsProviderConfig) {
+    this.sql = neon(connectionUrl, { fullResults: true });
+    this.table = table;
+  }
+
+  public async storeQueryCacheTags(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 this.sql.query(`INSERT INTO ${this.table} VALUES ${placeholders} ON CONFLICT DO NOTHING`, tags);
+  }
+
+  public async queriesReferencingCacheTags(cacheTags: CacheTag[]): Promise<string[]> {
+    if (!cacheTags?.length) {
+      return [];
+    }
+
+    const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
+
+    const { rows } = await this.sql.query(
+      `SELECT DISTINCT query_id FROM ${this.table} WHERE cache_tag IN (${placeholders})`,
+      cacheTags,
+    );
+
+    return rows.reduce<string[]>((queryIds, row) => {
+      if (typeof row.query_id === 'string') {
+        queryIds.push(row.query_id);
+      }
+
+      return queryIds;
+    }, []);
+  }
+
+  public async deleteCacheTags(cacheTags: CacheTag[]) {
+    if (cacheTags.length === 0) {
+      return 0;
+    }
+    const placeholders = cacheTags.map((_, i) => `$${i + 1}`).join(',');
+
+    return (await this.sql.query(`DELETE FROM ${this.table} WHERE cache_tag IN (${placeholders})`, cacheTags)).rowCount ?? 0;
+  }
+
+  public async truncateCacheTags() {
+    return (await this.sql.query(`DELETE FROM ${this.table}`)).rowCount ?? 0;
+  }
+}

package/src/cache-tags/provider/noop.ts

@@ -0,0 +1,32 @@
+import { type CacheTag, type CacheTagsProvider } from '../types.js';
+
+/**
+ * A `CacheTagsProvider` implementation that does not perform any actual storage operations.
+ *
+ * _Note: This implementation is useful for testing purposes or when you want to disable caching without changing the code that interacts with the cache._
+ */
+export class NoopCacheTagsProvider implements CacheTagsProvider {
+  public async storeQueryCacheTags(queryId: string, cacheTags: CacheTag[]) {
+    console.debug('-- storeQueryCacheTags called', { queryId, cacheTags });
+
+    return Promise.resolve();
+  }
+
+  public async queriesReferencingCacheTags(cacheTags: CacheTag[]): Promise<string[]> {
+    console.debug('-- queriesReferencingCacheTags called', { cacheTags });
+
+    return Promise.resolve([]);
+  }
+
+  public async deleteCacheTags(cacheTags: CacheTag[]) {
+    console.debug('-- deleteCacheTags called', { cacheTags });
+
+    return Promise.resolve(0);
+  }
+
+  public async truncateCacheTags() {
+    console.debug('-- truncateCacheTags called');
+
+    return Promise.resolve(0);
+  }
+}

package/src/cache-tags/provider/redis.ts

@@ -0,0 +1,104 @@
+import { Redis } from 'ioredis';
+import { type CacheTag, type CacheTagsProvider } from '../types.js';
+
+type RedisCacheTagsProviderConfig = {
+  /**
+   * Redis connection string. For example, `redis://user:pass@host:port/db`.
+   */
+  readonly connectionUrl: string;
+  /**
+   * Optional prefix for Redis keys. If provided, all keys used to store cache tags will be prefixed with this value.
+   * This can be useful to avoid key collisions if the same Redis instance is used for multiple purposes.
+   * For example, if you set `keyPrefix` to `'myapp:'`, a cache tag like `'tag1'` will be stored under the key `'myapp:tag1'`.
+   */
+  readonly keyPrefix?: string;
+};
+
+/**
+ * A `CacheTagsProvider` implementation that uses Redis as the storage backend.
+ */
+export class RedisCacheTagsProvider implements CacheTagsProvider {
+  private readonly redis;
+  private readonly keyPrefix;
+
+  constructor({ connectionUrl, keyPrefix }: RedisCacheTagsProviderConfig) {
+    this.redis = new Redis(connectionUrl, {
+      maxRetriesPerRequest: 3,
+      lazyConnect: true,
+    });
+    this.keyPrefix = keyPrefix ?? '';
+  }
+
+  public async storeQueryCacheTags(queryId: string, cacheTags: CacheTag[]) {
+    if (!cacheTags?.length) {
+      return;
+    }
+
+    const pipeline = this.redis.pipeline();
+
+    for (const tag of cacheTags) {
+      pipeline.sadd(`${this.keyPrefix}${tag}`, queryId);
+    }
+
+    await pipeline.exec();
+  }
+
+  public async queriesReferencingCacheTags(cacheTags: CacheTag[]) {
+    if (!cacheTags?.length) {
+      return [];
+    }
+
+    const keys = cacheTags.map((tag) => `${this.keyPrefix}${tag}`);
+
+    return this.redis.sunion(...keys);
+  }
+
+  public async deleteCacheTags(cacheTags: CacheTag[]) {
+    if (!cacheTags?.length) {
+      return 0;
+    }
+
+    const keys = cacheTags.map((tag) => `${this.keyPrefix}${tag}`);
+
+    return this.redis.del(...keys);
+  }
+
+  public async truncateCacheTags() {
+    const keys = await this.getKeys();
+
+    if (keys.length === 0) {
+      return 0;
+    }
+
+    return await this.redis.del(...keys);
+  }
+
+  /**
+   * Retrieves all keys matching the given pattern using the Redis SCAN command.
+   * This method is more efficient than using the KEYS command, especially for large datasets.
+   *
+   * @returns An array of matching keys
+   */
+  private async getKeys(): Promise<string[]> {
+    return new Promise((resolve, reject) => {
+      const keys: string[] = [];
+
+      const stream = this.redis.scanStream({
+        match: `${this.keyPrefix}*`,
+        count: 1000,
+      });
+
+      stream.on('data', (resultKeys: string[]) => {
+        keys.push(...resultKeys);
+      });
+
+      stream.on('end', () => {
+        resolve(keys);
+      });
+
+      stream.on('error', (err) => {
+        reject(err);
+      });
+    });
+  }
+}

package/src/cache-tags/types.ts

@@ -0,0 +1,66 @@
+/**
+ * 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[];
+    };
+  };
+};
+
+/**
+ * Configuration object for creating a `CacheTagsProvider` implementation.
+ */
+export interface CacheTagsProvider {
+  /**
+   * 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-tags/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/classnames.ts

@@ -4,4 +4,10 @@
  * @param classNames Array of class names
  * @returns Clean string to be used for class name
  */
-export const classNames = (...classNames: (string | undefined | boolean)[]): string => classNames.filter(Boolean).join(' ');
+export const classNames = (...classNames: unknown[]) =>
+  classNames
+    .filter(
+      (value): value is string | number =>
+        (typeof value === 'string' && value.length > 0) || (typeof value === 'number' && Number.isFinite(value)),
+    )
+    .join(' ');

package/src/index.ts

@@ -1,4 +1,2 @@
-export * from './cache-tags';
-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"}