@ohos-ports/drizzle-orm 0.45.2-beta.0

package/cache/core/cache.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cache_exports = {};
+__export(cache_exports, {
+  Cache: () => Cache,
+  NoopCache: () => NoopCache,
+  hashQuery: () => hashQuery
+});
+module.exports = __toCommonJS(cache_exports);
+var import_entity = require("../../entity.cjs");
+class Cache {
+  static [import_entity.entityKind] = "Cache";
+}
+class NoopCache extends Cache {
+  strategy() {
+    return "all";
+  }
+  static [import_entity.entityKind] = "NoopCache";
+  async get(_key) {
+    return void 0;
+  }
+  async put(_hashedQuery, _response, _tables, _config) {
+  }
+  async onMutate(_params) {
+  }
+}
+async function hashQuery(sql, params) {
+  const dataToHash = `${sql}-${JSON.stringify(params)}`;
+  const encoder = new TextEncoder();
+  const data = encoder.encode(dataToHash);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = [...new Uint8Array(hashBuffer)];
+  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+  return hashHex;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Cache,
+  NoopCache,
+  hashQuery
+});
+//# sourceMappingURL=cache.cjs.map

package/cache/core/cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/core/cache.ts"],"sourcesContent":["import { entityKind } from '~/entity.ts';\nimport type { Table } from '~/index.ts';\nimport type { CacheConfig } from './types.ts';\n\nexport abstract class Cache {\n\tstatic readonly [entityKind]: string = 'Cache';\n\n\tabstract strategy(): 'explicit' | 'all';\n\n\t/**\n\t * Invoked if we should check cache for cached response\n\t * @param sql\n\t * @param tables\n\t */\n\tabstract get(\n\t\tkey: string,\n\t\ttables: string[],\n\t\tisTag: boolean,\n\t\tisAutoInvalidate?: boolean,\n\t): Promise<any[] | undefined>;\n\n\t/**\n\t * Invoked if new query should be inserted to cache\n\t * @param sql\n\t * @param tables\n\t */\n\tabstract put(\n\t\thashedQuery: string,\n\t\tresponse: any,\n\t\ttables: string[],\n\t\tisTag: boolean,\n\t\tconfig?: CacheConfig,\n\t): Promise<void>;\n\n\t/**\n\t * Invoked if insert, update, delete was invoked\n\t * @param tables\n\t */\n\tabstract onMutate(\n\t\tparams: MutationOption,\n\t): Promise<void>;\n}\n\nexport class NoopCache extends Cache {\n\toverride strategy() {\n\t\treturn 'all' as const;\n\t}\n\n\tstatic override readonly [entityKind]: string = 'NoopCache';\n\n\toverride async get(_key: string): Promise<any[] | undefined> {\n\t\treturn undefined;\n\t}\n\toverride async put(\n\t\t_hashedQuery: string,\n\t\t_response: any,\n\t\t_tables: string[],\n\t\t_config?: any,\n\t): Promise<void> {\n\t\t// noop\n\t}\n\toverride async onMutate(_params: MutationOption): Promise<void> {\n\t\t// noop\n\t}\n}\n\nexport type MutationOption = { tags?: string | string[]; tables?: Table<any> | Table<any>[] | string | string[] };\n\nexport async function hashQuery(sql: string, params?: any[]) {\n\tconst dataToHash = `${sql}-${JSON.stringify(params)}`;\n\tconst encoder = new TextEncoder();\n\tconst data = encoder.encode(dataToHash);\n\tconst hashBuffer = await crypto.subtle.digest('SHA-256', data);\n\tconst hashArray = [...new Uint8Array(hashBuffer)];\n\tconst hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');\n\n\treturn hashHex;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA2B;AAIpB,MAAe,MAAM;AAAA,EAC3B,QAAiB,wBAAU,IAAY;AAoCxC;AAEO,MAAM,kBAAkB,MAAM;AAAA,EAC3B,WAAW;AACnB,WAAO;AAAA,EACR;AAAA,EAEA,QAA0B,wBAAU,IAAY;AAAA,EAEhD,MAAe,IAAI,MAA0C;AAC5D,WAAO;AAAA,EACR;AAAA,EACA,MAAe,IACd,cACA,WACA,SACA,SACgB;AAAA,EAEjB;AAAA,EACA,MAAe,SAAS,SAAwC;AAAA,EAEhE;AACD;AAIA,eAAsB,UAAU,KAAa,QAAgB;AAC5D,QAAM,aAAa,GAAG,GAAG,IAAI,KAAK,UAAU,MAAM,CAAC;AACnD,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,OAAO,QAAQ,OAAO,UAAU;AACtC,QAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI;AAC7D,QAAM,YAAY,CAAC,GAAG,IAAI,WAAW,UAAU,CAAC;AAChD,QAAM,UAAU,UAAU,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AAE7E,SAAO;AACR;","names":[]}

package/cache/core/cache.d.cts

@@ -0,0 +1,36 @@
+import { entityKind } from "../../entity.cjs";
+import type { Table } from "../../index.cjs";
+import type { CacheConfig } from "./types.cjs";
+export declare abstract class Cache {
+    static readonly [entityKind]: string;
+    abstract strategy(): 'explicit' | 'all';
+    /**
+     * Invoked if we should check cache for cached response
+     * @param sql
+     * @param tables
+     */
+    abstract get(key: string, tables: string[], isTag: boolean, isAutoInvalidate?: boolean): Promise<any[] | undefined>;
+    /**
+     * Invoked if new query should be inserted to cache
+     * @param sql
+     * @param tables
+     */
+    abstract put(hashedQuery: string, response: any, tables: string[], isTag: boolean, config?: CacheConfig): Promise<void>;
+    /**
+     * Invoked if insert, update, delete was invoked
+     * @param tables
+     */
+    abstract onMutate(params: MutationOption): Promise<void>;
+}
+export declare class NoopCache extends Cache {
+    strategy(): "all";
+    static readonly [entityKind]: string;
+    get(_key: string): Promise<any[] | undefined>;
+    put(_hashedQuery: string, _response: any, _tables: string[], _config?: any): Promise<void>;
+    onMutate(_params: MutationOption): Promise<void>;
+}
+export type MutationOption = {
+    tags?: string | string[];
+    tables?: Table<any> | Table<any>[] | string | string[];
+};
+export declare function hashQuery(sql: string, params?: any[]): Promise<string>;

package/cache/core/cache.d.ts

@@ -0,0 +1,36 @@
+import { entityKind } from "../../entity.js";
+import type { Table } from "../../index.js";
+import type { CacheConfig } from "./types.js";
+export declare abstract class Cache {
+    static readonly [entityKind]: string;
+    abstract strategy(): 'explicit' | 'all';
+    /**
+     * Invoked if we should check cache for cached response
+     * @param sql
+     * @param tables
+     */
+    abstract get(key: string, tables: string[], isTag: boolean, isAutoInvalidate?: boolean): Promise<any[] | undefined>;
+    /**
+     * Invoked if new query should be inserted to cache
+     * @param sql
+     * @param tables
+     */
+    abstract put(hashedQuery: string, response: any, tables: string[], isTag: boolean, config?: CacheConfig): Promise<void>;
+    /**
+     * Invoked if insert, update, delete was invoked
+     * @param tables
+     */
+    abstract onMutate(params: MutationOption): Promise<void>;
+}
+export declare class NoopCache extends Cache {
+    strategy(): "all";
+    static readonly [entityKind]: string;
+    get(_key: string): Promise<any[] | undefined>;
+    put(_hashedQuery: string, _response: any, _tables: string[], _config?: any): Promise<void>;
+    onMutate(_params: MutationOption): Promise<void>;
+}
+export type MutationOption = {
+    tags?: string | string[];
+    tables?: Table<any> | Table<any>[] | string | string[];
+};
+export declare function hashQuery(sql: string, params?: any[]): Promise<string>;

package/cache/core/cache.js

@@ -0,0 +1,32 @@
+import { entityKind } from "../../entity.js";
+class Cache {
+  static [entityKind] = "Cache";
+}
+class NoopCache extends Cache {
+  strategy() {
+    return "all";
+  }
+  static [entityKind] = "NoopCache";
+  async get(_key) {
+    return void 0;
+  }
+  async put(_hashedQuery, _response, _tables, _config) {
+  }
+  async onMutate(_params) {
+  }
+}
+async function hashQuery(sql, params) {
+  const dataToHash = `${sql}-${JSON.stringify(params)}`;
+  const encoder = new TextEncoder();
+  const data = encoder.encode(dataToHash);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = [...new Uint8Array(hashBuffer)];
+  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+  return hashHex;
+}
+export {
+  Cache,
+  NoopCache,
+  hashQuery
+};
+//# sourceMappingURL=cache.js.map

package/cache/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/core/cache.ts"],"sourcesContent":["import { entityKind } from '~/entity.ts';\nimport type { Table } from '~/index.ts';\nimport type { CacheConfig } from './types.ts';\n\nexport abstract class Cache {\n\tstatic readonly [entityKind]: string = 'Cache';\n\n\tabstract strategy(): 'explicit' | 'all';\n\n\t/**\n\t * Invoked if we should check cache for cached response\n\t * @param sql\n\t * @param tables\n\t */\n\tabstract get(\n\t\tkey: string,\n\t\ttables: string[],\n\t\tisTag: boolean,\n\t\tisAutoInvalidate?: boolean,\n\t): Promise<any[] | undefined>;\n\n\t/**\n\t * Invoked if new query should be inserted to cache\n\t * @param sql\n\t * @param tables\n\t */\n\tabstract put(\n\t\thashedQuery: string,\n\t\tresponse: any,\n\t\ttables: string[],\n\t\tisTag: boolean,\n\t\tconfig?: CacheConfig,\n\t): Promise<void>;\n\n\t/**\n\t * Invoked if insert, update, delete was invoked\n\t * @param tables\n\t */\n\tabstract onMutate(\n\t\tparams: MutationOption,\n\t): Promise<void>;\n}\n\nexport class NoopCache extends Cache {\n\toverride strategy() {\n\t\treturn 'all' as const;\n\t}\n\n\tstatic override readonly [entityKind]: string = 'NoopCache';\n\n\toverride async get(_key: string): Promise<any[] | undefined> {\n\t\treturn undefined;\n\t}\n\toverride async put(\n\t\t_hashedQuery: string,\n\t\t_response: any,\n\t\t_tables: string[],\n\t\t_config?: any,\n\t): Promise<void> {\n\t\t// noop\n\t}\n\toverride async onMutate(_params: MutationOption): Promise<void> {\n\t\t// noop\n\t}\n}\n\nexport type MutationOption = { tags?: string | string[]; tables?: Table<any> | Table<any>[] | string | string[] };\n\nexport async function hashQuery(sql: string, params?: any[]) {\n\tconst dataToHash = `${sql}-${JSON.stringify(params)}`;\n\tconst encoder = new TextEncoder();\n\tconst data = encoder.encode(dataToHash);\n\tconst hashBuffer = await crypto.subtle.digest('SHA-256', data);\n\tconst hashArray = [...new Uint8Array(hashBuffer)];\n\tconst hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');\n\n\treturn hashHex;\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAIpB,MAAe,MAAM;AAAA,EAC3B,QAAiB,UAAU,IAAY;AAoCxC;AAEO,MAAM,kBAAkB,MAAM;AAAA,EAC3B,WAAW;AACnB,WAAO;AAAA,EACR;AAAA,EAEA,QAA0B,UAAU,IAAY;AAAA,EAEhD,MAAe,IAAI,MAA0C;AAC5D,WAAO;AAAA,EACR;AAAA,EACA,MAAe,IACd,cACA,WACA,SACA,SACgB;AAAA,EAEjB;AAAA,EACA,MAAe,SAAS,SAAwC;AAAA,EAEhE;AACD;AAIA,eAAsB,UAAU,KAAa,QAAgB;AAC5D,QAAM,aAAa,GAAG,GAAG,IAAI,KAAK,UAAU,MAAM,CAAC;AACnD,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,OAAO,QAAQ,OAAO,UAAU;AACtC,QAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI;AAC7D,QAAM,YAAY,CAAC,GAAG,IAAI,WAAW,UAAU,CAAC;AAChD,QAAM,UAAU,UAAU,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AAE7E,SAAO;AACR;","names":[]}

package/cache/core/index.cjs

@@ -0,0 +1,23 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var core_exports = {};
+module.exports = __toCommonJS(core_exports);
+__reExport(core_exports, require("./cache.cjs"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./cache.cjs")
+});
+//# sourceMappingURL=index.cjs.map

package/cache/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/core/index.ts"],"sourcesContent":["export * from './cache.ts';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,yBAAc,uBAAd;","names":[]}

package/cache/core/index.d.cts

@@ -0,0 +1 @@
+export * from "./cache.cjs";

package/cache/core/index.d.ts

@@ -0,0 +1 @@
+export * from "./cache.js";

package/cache/core/index.js

@@ -0,0 +1,2 @@
+export * from "./cache.js";
+//# sourceMappingURL=index.js.map

package/cache/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/core/index.ts"],"sourcesContent":["export * from './cache.ts';\n"],"mappings":"AAAA,cAAc;","names":[]}

package/cache/core/types.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/cache/core/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/core/types.ts"],"sourcesContent":["export type CacheConfig = {\n\t/**\n\t * expire time, in seconds (a positive integer)\n\t */\n\tex?: number;\n\t/**\n\t * expire time, in milliseconds (a positive integer).\n\t */\n\tpx?: number;\n\t/**\n\t * Unix time at which the key will expire, in seconds (a positive integer).\n\t */\n\texat?: number;\n\t/**\n\t * Unix time at which the key will expire, in milliseconds (a positive integer)\n\t */\n\tpxat?: number;\n\t/**\n\t * Retain the time to live associated with the key.\n\t */\n\tkeepTtl?: boolean;\n\t/**\n\t * Set an expiration (TTL or time to live) on one or more fields of a given hash key.\n\t * Used for HEXPIRE command\n\t */\n\thexOptions?: 'NX' | 'nx' | 'XX' | 'xx' | 'GT' | 'gt' | 'LT' | 'lt';\n};\n\nexport type WithCacheConfig = { enable: boolean; config?: CacheConfig; tag?: string; autoInvalidate?: boolean };\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/cache/core/types.d.cts

@@ -0,0 +1,33 @@
+export type CacheConfig = {
+    /**
+     * expire time, in seconds (a positive integer)
+     */
+    ex?: number;
+    /**
+     * expire time, in milliseconds (a positive integer).
+     */
+    px?: number;
+    /**
+     * Unix time at which the key will expire, in seconds (a positive integer).
+     */
+    exat?: number;
+    /**
+     * Unix time at which the key will expire, in milliseconds (a positive integer)
+     */
+    pxat?: number;
+    /**
+     * Retain the time to live associated with the key.
+     */
+    keepTtl?: boolean;
+    /**
+     * Set an expiration (TTL or time to live) on one or more fields of a given hash key.
+     * Used for HEXPIRE command
+     */
+    hexOptions?: 'NX' | 'nx' | 'XX' | 'xx' | 'GT' | 'gt' | 'LT' | 'lt';
+};
+export type WithCacheConfig = {
+    enable: boolean;
+    config?: CacheConfig;
+    tag?: string;
+    autoInvalidate?: boolean;
+};

package/cache/core/types.d.ts

@@ -0,0 +1,33 @@
+export type CacheConfig = {
+    /**
+     * expire time, in seconds (a positive integer)
+     */
+    ex?: number;
+    /**
+     * expire time, in milliseconds (a positive integer).
+     */
+    px?: number;
+    /**
+     * Unix time at which the key will expire, in seconds (a positive integer).
+     */
+    exat?: number;
+    /**
+     * Unix time at which the key will expire, in milliseconds (a positive integer)
+     */
+    pxat?: number;
+    /**
+     * Retain the time to live associated with the key.
+     */
+    keepTtl?: boolean;
+    /**
+     * Set an expiration (TTL or time to live) on one or more fields of a given hash key.
+     * Used for HEXPIRE command
+     */
+    hexOptions?: 'NX' | 'nx' | 'XX' | 'xx' | 'GT' | 'gt' | 'LT' | 'lt';
+};
+export type WithCacheConfig = {
+    enable: boolean;
+    config?: CacheConfig;
+    tag?: string;
+    autoInvalidate?: boolean;
+};

package/cache/core/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/cache/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/cache/upstash/cache.cjs

@@ -0,0 +1,195 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cache_exports = {};
+__export(cache_exports, {
+  UpstashCache: () => UpstashCache,
+  upstashCache: () => upstashCache
+});
+module.exports = __toCommonJS(cache_exports);
+var import_redis = require("@upstash/redis");
+var import_core = require("../core/index.cjs");
+var import_entity = require("../../entity.cjs");
+var import__ = require("../../index.cjs");
+const getByTagScript = `
+local tagsMapKey = KEYS[1] -- tags map key
+local tag        = ARGV[1] -- tag
+
+local compositeTableName = redis.call('HGET', tagsMapKey, tag)
+if not compositeTableName then
+  return nil
+end
+
+local value = redis.call('HGET', compositeTableName, tag)
+return value
+`;
+const onMutateScript = `
+local tagsMapKey = KEYS[1] -- tags map key
+local tables     = {}      -- initialize tables array
+local tags       = ARGV    -- tags array
+
+for i = 2, #KEYS do
+  tables[#tables + 1] = KEYS[i] -- add all keys except the first one to tables
+end
+
+if #tags > 0 then
+  for _, tag in ipairs(tags) do
+    if tag ~= nil and tag ~= '' then
+      local compositeTableName = redis.call('HGET', tagsMapKey, tag)
+      if compositeTableName then
+        redis.call('HDEL', compositeTableName, tag)
+      end
+    end
+  end
+  redis.call('HDEL', tagsMapKey, unpack(tags))
+end
+
+local keysToDelete = {}
+
+if #tables > 0 then
+  local compositeTableNames = redis.call('SUNION', unpack(tables))
+  for _, compositeTableName in ipairs(compositeTableNames) do
+    keysToDelete[#keysToDelete + 1] = compositeTableName
+  end
+  for _, table in ipairs(tables) do
+    keysToDelete[#keysToDelete + 1] = table
+  end
+  redis.call('DEL', unpack(keysToDelete))
+end
+`;
+class UpstashCache extends import_core.Cache {
+  constructor(redis, config, useGlobally) {
+    super();
+    this.redis = redis;
+    this.useGlobally = useGlobally;
+    this.internalConfig = this.toInternalConfig(config);
+    this.luaScripts = {
+      getByTagScript: this.redis.createScript(getByTagScript, { readonly: true }),
+      onMutateScript: this.redis.createScript(onMutateScript)
+    };
+  }
+  static [import_entity.entityKind] = "UpstashCache";
+  /**
+   * Prefix for sets which denote the composite table names for each unique table
+   *
+   * Example: In the composite table set of "table1", you may find
+   * `${compositeTablePrefix}table1,table2` and `${compositeTablePrefix}table1,table3`
+   */
+  static compositeTableSetPrefix = "__CTS__";
+  /**
+   * Prefix for hashes which map hash or tags to cache values
+   */
+  static compositeTablePrefix = "__CT__";
+  /**
+   * Key which holds the mapping of tags to composite table names
+   *
+   * Using this tagsMapKey, you can find the composite table name for a given tag
+   * and get the cache value for that tag:
+   *
+   * ```ts
+   * const compositeTable = redis.hget(tagsMapKey, 'tag1')
+   * console.log(compositeTable) // `${compositeTablePrefix}table1,table2`
+   *
+   * const cachevalue = redis.hget(compositeTable, 'tag1')
+   */
+  static tagsMapKey = "__tagsMap__";
+  /**
+   * Queries whose auto invalidation is false aren't stored in their respective
+   * composite table hashes because those hashes are deleted when a mutation
+   * occurs on related tables.
+   *
+   * Instead, they are stored in a separate hash with the prefix
+   * `__nonAutoInvalidate__` to prevent them from being deleted when a mutation
+   */
+  static nonAutoInvalidateTablePrefix = "__nonAutoInvalidate__";
+  luaScripts;
+  internalConfig;
+  strategy() {
+    return this.useGlobally ? "all" : "explicit";
+  }
+  toInternalConfig(config) {
+    return config ? {
+      seconds: config.ex,
+      hexOptions: config.hexOptions
+    } : {
+      seconds: 1
+    };
+  }
+  async get(key, tables, isTag = false, isAutoInvalidate) {
+    if (!isAutoInvalidate) {
+      const result2 = await this.redis.hget(UpstashCache.nonAutoInvalidateTablePrefix, key);
+      return result2 === null ? void 0 : result2;
+    }
+    if (isTag) {
+      const result2 = await this.luaScripts.getByTagScript.exec([UpstashCache.tagsMapKey], [key]);
+      return result2 === null ? void 0 : result2;
+    }
+    const compositeKey = this.getCompositeKey(tables);
+    const result = (await this.redis.hget(compositeKey, key)) ?? void 0;
+    return result === null ? void 0 : result;
+  }
+  async put(key, response, tables, isTag = false, config) {
+    const isAutoInvalidate = tables.length !== 0;
+    const pipeline = this.redis.pipeline();
+    const ttlSeconds = config && config.ex ? config.ex : this.internalConfig.seconds;
+    const hexOptions = config && config.hexOptions ? config.hexOptions : this.internalConfig?.hexOptions;
+    if (!isAutoInvalidate) {
+      if (isTag) {
+        pipeline.hset(UpstashCache.tagsMapKey, { [key]: UpstashCache.nonAutoInvalidateTablePrefix });
+        pipeline.hexpire(UpstashCache.tagsMapKey, key, ttlSeconds, hexOptions);
+      }
+      pipeline.hset(UpstashCache.nonAutoInvalidateTablePrefix, { [key]: response });
+      pipeline.hexpire(UpstashCache.nonAutoInvalidateTablePrefix, key, ttlSeconds, hexOptions);
+      await pipeline.exec();
+      return;
+    }
+    const compositeKey = this.getCompositeKey(tables);
+    pipeline.hset(compositeKey, { [key]: response });
+    pipeline.hexpire(compositeKey, key, ttlSeconds, hexOptions);
+    if (isTag) {
+      pipeline.hset(UpstashCache.tagsMapKey, { [key]: compositeKey });
+      pipeline.hexpire(UpstashCache.tagsMapKey, key, ttlSeconds, hexOptions);
+    }
+    for (const table of tables) {
+      pipeline.sadd(this.addTablePrefix(table), compositeKey);
+    }
+    await pipeline.exec();
+  }
+  async onMutate(params) {
+    const tags = Array.isArray(params.tags) ? params.tags : params.tags ? [params.tags] : [];
+    const tables = Array.isArray(params.tables) ? params.tables : params.tables ? [params.tables] : [];
+    const tableNames = tables.map((table) => (0, import_entity.is)(table, import__.Table) ? table[import__.OriginalName] : table);
+    const compositeTableSets = tableNames.map((table) => this.addTablePrefix(table));
+    await this.luaScripts.onMutateScript.exec([UpstashCache.tagsMapKey, ...compositeTableSets], tags);
+  }
+  addTablePrefix = (table) => `${UpstashCache.compositeTableSetPrefix}${table}`;
+  getCompositeKey = (tables) => `${UpstashCache.compositeTablePrefix}${tables.sort().join(",")}`;
+}
+function upstashCache({ url, token, config, global = false }) {
+  const redis = new import_redis.Redis({
+    url,
+    token
+  });
+  return new UpstashCache(redis, config, global);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UpstashCache,
+  upstashCache
+});
+//# sourceMappingURL=cache.cjs.map

package/cache/upstash/cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cache/upstash/cache.ts"],"sourcesContent":["import { Redis } from '@upstash/redis';\nimport type { MutationOption } from '~/cache/core/index.ts';\nimport { Cache } from '~/cache/core/index.ts';\nimport { entityKind, is } from '~/entity.ts';\nimport { OriginalName, Table } from '~/index.ts';\nimport type { CacheConfig } from '../core/types.ts';\n\nconst getByTagScript = `\nlocal tagsMapKey = KEYS[1] -- tags map key\nlocal tag        = ARGV[1] -- tag\n\nlocal compositeTableName = redis.call('HGET', tagsMapKey, tag)\nif not compositeTableName then\n  return nil\nend\n\nlocal value = redis.call('HGET', compositeTableName, tag)\nreturn value\n`;\n\nconst onMutateScript = `\nlocal tagsMapKey = KEYS[1] -- tags map key\nlocal tables     = {}      -- initialize tables array\nlocal tags       = ARGV    -- tags array\n\nfor i = 2, #KEYS do\n  tables[#tables + 1] = KEYS[i] -- add all keys except the first one to tables\nend\n\nif #tags > 0 then\n  for _, tag in ipairs(tags) do\n    if tag ~= nil and tag ~= '' then\n      local compositeTableName = redis.call('HGET', tagsMapKey, tag)\n      if compositeTableName then\n        redis.call('HDEL', compositeTableName, tag)\n      end\n    end\n  end\n  redis.call('HDEL', tagsMapKey, unpack(tags))\nend\n\nlocal keysToDelete = {}\n\nif #tables > 0 then\n  local compositeTableNames = redis.call('SUNION', unpack(tables))\n  for _, compositeTableName in ipairs(compositeTableNames) do\n    keysToDelete[#keysToDelete + 1] = compositeTableName\n  end\n  for _, table in ipairs(tables) do\n    keysToDelete[#keysToDelete + 1] = table\n  end\n  redis.call('DEL', unpack(keysToDelete))\nend\n`;\n\ntype Script = ReturnType<Redis['createScript']>;\n\ntype ExpireOptions = 'NX' | 'nx' | 'XX' | 'xx' | 'GT' | 'gt' | 'LT' | 'lt';\n\nexport class UpstashCache extends Cache {\n\tstatic override readonly [entityKind]: string = 'UpstashCache';\n\t/**\n\t * Prefix for sets which denote the composite table names for each unique table\n\t *\n\t * Example: In the composite table set of \"table1\", you may find\n\t * `${compositeTablePrefix}table1,table2` and `${compositeTablePrefix}table1,table3`\n\t */\n\tprivate static compositeTableSetPrefix = '__CTS__';\n\t/**\n\t * Prefix for hashes which map hash or tags to cache values\n\t */\n\tprivate static compositeTablePrefix = '__CT__';\n\t/**\n\t * Key which holds the mapping of tags to composite table names\n\t *\n\t * Using this tagsMapKey, you can find the composite table name for a given tag\n\t * and get the cache value for that tag:\n\t *\n\t * ```ts\n\t * const compositeTable = redis.hget(tagsMapKey, 'tag1')\n\t * console.log(compositeTable) // `${compositeTablePrefix}table1,table2`\n\t *\n\t * const cachevalue = redis.hget(compositeTable, 'tag1')\n\t */\n\tprivate static tagsMapKey = '__tagsMap__';\n\t/**\n\t * Queries whose auto invalidation is false aren't stored in their respective\n\t * composite table hashes because those hashes are deleted when a mutation\n\t * occurs on related tables.\n\t *\n\t * Instead, they are stored in a separate hash with the prefix\n\t * `__nonAutoInvalidate__` to prevent them from being deleted when a mutation\n\t */\n\tprivate static nonAutoInvalidateTablePrefix = '__nonAutoInvalidate__';\n\n\tprivate luaScripts: {\n\t\tgetByTagScript: Script;\n\t\tonMutateScript: Script;\n\t};\n\n\tprivate internalConfig: { seconds: number; hexOptions?: ExpireOptions };\n\n\tconstructor(public redis: Redis, config?: CacheConfig, protected useGlobally?: boolean) {\n\t\tsuper();\n\t\tthis.internalConfig = this.toInternalConfig(config);\n\t\tthis.luaScripts = {\n\t\t\tgetByTagScript: this.redis.createScript(getByTagScript, { readonly: true }),\n\t\t\tonMutateScript: this.redis.createScript(onMutateScript),\n\t\t};\n\t}\n\n\tpublic strategy() {\n\t\treturn this.useGlobally ? 'all' : 'explicit';\n\t}\n\n\tprivate toInternalConfig(config?: CacheConfig): { seconds: number; hexOptions?: ExpireOptions } {\n\t\treturn config\n\t\t\t? {\n\t\t\t\tseconds: config.ex!,\n\t\t\t\thexOptions: config.hexOptions,\n\t\t\t}\n\t\t\t: {\n\t\t\t\tseconds: 1,\n\t\t\t};\n\t}\n\n\toverride async get(\n\t\tkey: string,\n\t\ttables: string[],\n\t\tisTag: boolean = false,\n\t\tisAutoInvalidate?: boolean,\n\t): Promise<any[] | undefined> {\n\t\tif (!isAutoInvalidate) {\n\t\t\tconst result = await this.redis.hget(UpstashCache.nonAutoInvalidateTablePrefix, key);\n\t\t\treturn result === null ? undefined : result as any[];\n\t\t}\n\n\t\tif (isTag) {\n\t\t\tconst result = await this.luaScripts.getByTagScript.exec([UpstashCache.tagsMapKey], [key]);\n\t\t\treturn result === null ? undefined : result as any[];\n\t\t}\n\n\t\t// Normal cache lookup for the composite key\n\t\tconst compositeKey = this.getCompositeKey(tables);\n\t\tconst result = await this.redis.hget(compositeKey, key) ?? undefined; // Retrieve result for normal query\n\t\treturn result === null ? undefined : result as any[];\n\t}\n\n\toverride async put(\n\t\tkey: string,\n\t\tresponse: any,\n\t\ttables: string[],\n\t\tisTag: boolean = false,\n\t\tconfig?: CacheConfig,\n\t): Promise<void> {\n\t\tconst isAutoInvalidate = tables.length !== 0;\n\n\t\tconst pipeline = this.redis.pipeline();\n\t\tconst ttlSeconds = config && config.ex ? config.ex : this.internalConfig.seconds;\n\t\tconst hexOptions = config && config.hexOptions ? config.hexOptions : this.internalConfig?.hexOptions;\n\n\t\tif (!isAutoInvalidate) {\n\t\t\tif (isTag) {\n\t\t\t\tpipeline.hset(UpstashCache.tagsMapKey, { [key]: UpstashCache.nonAutoInvalidateTablePrefix });\n\t\t\t\tpipeline.hexpire(UpstashCache.tagsMapKey, key, ttlSeconds, hexOptions);\n\t\t\t}\n\n\t\t\tpipeline.hset(UpstashCache.nonAutoInvalidateTablePrefix, { [key]: response });\n\t\t\tpipeline.hexpire(UpstashCache.nonAutoInvalidateTablePrefix, key, ttlSeconds, hexOptions);\n\t\t\tawait pipeline.exec();\n\t\t\treturn;\n\t\t}\n\n\t\tconst compositeKey = this.getCompositeKey(tables);\n\n\t\tpipeline.hset(compositeKey, { [key]: response }); // Store the result with the tag under the composite key\n\t\tpipeline.hexpire(compositeKey, key, ttlSeconds, hexOptions); // Set expiration for the composite key\n\n\t\tif (isTag) {\n\t\t\tpipeline.hset(UpstashCache.tagsMapKey, { [key]: compositeKey }); // Store the tag and its composite key in the map\n\t\t\tpipeline.hexpire(UpstashCache.tagsMapKey, key, ttlSeconds, hexOptions); // Set expiration for the tag\n\t\t}\n\n\t\tfor (const table of tables) {\n\t\t\tpipeline.sadd(this.addTablePrefix(table), compositeKey);\n\t\t}\n\n\t\tawait pipeline.exec();\n\t}\n\n\toverride async onMutate(params: MutationOption) {\n\t\tconst tags = Array.isArray(params.tags) ? params.tags : params.tags ? [params.tags] : [];\n\t\tconst tables = Array.isArray(params.tables) ? params.tables : params.tables ? [params.tables] : [];\n\t\tconst tableNames: string[] = tables.map((table) => is(table, Table) ? table[OriginalName] : table as string);\n\n\t\tconst compositeTableSets = tableNames.map((table) => this.addTablePrefix(table));\n\t\tawait this.luaScripts.onMutateScript.exec([UpstashCache.tagsMapKey, ...compositeTableSets], tags);\n\t}\n\n\tprivate addTablePrefix = (table: string) => `${UpstashCache.compositeTableSetPrefix}${table}`;\n\tprivate getCompositeKey = (tables: string[]) => `${UpstashCache.compositeTablePrefix}${tables.sort().join(',')}`;\n}\n\nexport function upstashCache(\n\t{ url, token, config, global = false }: { url: string; token: string; config?: CacheConfig; global?: boolean },\n): UpstashCache {\n\tconst redis = new Redis({\n\t\turl,\n\t\ttoken,\n\t});\n\n\treturn new UpstashCache(redis, config, global);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAsB;AAEtB,kBAAsB;AACtB,oBAA+B;AAC/B,eAAoC;AAGpC,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAavB,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuChB,MAAM,qBAAqB,kBAAM;AAAA,EA2CvC,YAAmB,OAAc,QAAgC,aAAuB;AACvF,UAAM;AADY;AAA8C;AAEhE,SAAK,iBAAiB,KAAK,iBAAiB,MAAM;AAClD,SAAK,aAAa;AAAA,MACjB,gBAAgB,KAAK,MAAM,aAAa,gBAAgB,EAAE,UAAU,KAAK,CAAC;AAAA,MAC1E,gBAAgB,KAAK,MAAM,aAAa,cAAc;AAAA,IACvD;AAAA,EACD;AAAA,EAjDA,QAA0B,wBAAU,IAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhD,OAAe,0BAA0B;AAAA;AAAA;AAAA;AAAA,EAIzC,OAAe,uBAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAatC,OAAe,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS5B,OAAe,+BAA+B;AAAA,EAEtC;AAAA,EAKA;AAAA,EAWD,WAAW;AACjB,WAAO,KAAK,cAAc,QAAQ;AAAA,EACnC;AAAA,EAEQ,iBAAiB,QAAuE;AAC/F,WAAO,SACJ;AAAA,MACD,SAAS,OAAO;AAAA,MAChB,YAAY,OAAO;AAAA,IACpB,IACE;AAAA,MACD,SAAS;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAe,IACd,KACA,QACA,QAAiB,OACjB,kBAC6B;AAC7B,QAAI,CAAC,kBAAkB;AACtB,YAAMA,UAAS,MAAM,KAAK,MAAM,KAAK,aAAa,8BAA8B,GAAG;AACnF,aAAOA,YAAW,OAAO,SAAYA;AAAA,IACtC;AAEA,QAAI,OAAO;AACV,YAAMA,UAAS,MAAM,KAAK,WAAW,eAAe,KAAK,CAAC,aAAa,UAAU,GAAG,CAAC,GAAG,CAAC;AACzF,aAAOA,YAAW,OAAO,SAAYA;AAAA,IACtC;AAGA,UAAM,eAAe,KAAK,gBAAgB,MAAM;AAChD,UAAM,SAAS,MAAM,KAAK,MAAM,KAAK,cAAc,GAAG,KAAK;AAC3D,WAAO,WAAW,OAAO,SAAY;AAAA,EACtC;AAAA,EAEA,MAAe,IACd,KACA,UACA,QACA,QAAiB,OACjB,QACgB;AAChB,UAAM,mBAAmB,OAAO,WAAW;AAE3C,UAAM,WAAW,KAAK,MAAM,SAAS;AACrC,UAAM,aAAa,UAAU,OAAO,KAAK,OAAO,KAAK,KAAK,eAAe;AACzE,UAAM,aAAa,UAAU,OAAO,aAAa,OAAO,aAAa,KAAK,gBAAgB;AAE1F,QAAI,CAAC,kBAAkB;AACtB,UAAI,OAAO;AACV,iBAAS,KAAK,aAAa,YAAY,EAAE,CAAC,GAAG,GAAG,aAAa,6BAA6B,CAAC;AAC3F,iBAAS,QAAQ,aAAa,YAAY,KAAK,YAAY,UAAU;AAAA,MACtE;AAEA,eAAS,KAAK,aAAa,8BAA8B,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC;AAC5E,eAAS,QAAQ,aAAa,8BAA8B,KAAK,YAAY,UAAU;AACvF,YAAM,SAAS,KAAK;AACpB;AAAA,IACD;AAEA,UAAM,eAAe,KAAK,gBAAgB,MAAM;AAEhD,aAAS,KAAK,cAAc,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC;AAC/C,aAAS,QAAQ,cAAc,KAAK,YAAY,UAAU;AAE1D,QAAI,OAAO;AACV,eAAS,KAAK,aAAa,YAAY,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC;AAC9D,eAAS,QAAQ,aAAa,YAAY,KAAK,YAAY,UAAU;AAAA,IACtE;AAEA,eAAW,SAAS,QAAQ;AAC3B,eAAS,KAAK,KAAK,eAAe,KAAK,GAAG,YAAY;AAAA,IACvD;AAEA,UAAM,SAAS,KAAK;AAAA,EACrB;AAAA,EAEA,MAAe,SAAS,QAAwB;AAC/C,UAAM,OAAO,MAAM,QAAQ,OAAO,IAAI,IAAI,OAAO,OAAO,OAAO,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;AACvF,UAAM,SAAS,MAAM,QAAQ,OAAO,MAAM,IAAI,OAAO,SAAS,OAAO,SAAS,CAAC,OAAO,MAAM,IAAI,CAAC;AACjG,UAAM,aAAuB,OAAO,IAAI,CAAC,cAAU,kBAAG,OAAO,cAAK,IAAI,MAAM,qBAAY,IAAI,KAAe;AAE3G,UAAM,qBAAqB,WAAW,IAAI,CAAC,UAAU,KAAK,eAAe,KAAK,CAAC;AAC/E,UAAM,KAAK,WAAW,eAAe,KAAK,CAAC,aAAa,YAAY,GAAG,kBAAkB,GAAG,IAAI;AAAA,EACjG;AAAA,EAEQ,iBAAiB,CAAC,UAAkB,GAAG,aAAa,uBAAuB,GAAG,KAAK;AAAA,EACnF,kBAAkB,CAAC,WAAqB,GAAG,aAAa,oBAAoB,GAAG,OAAO,KAAK,EAAE,KAAK,GAAG,CAAC;AAC/G;AAEO,SAAS,aACf,EAAE,KAAK,OAAO,QAAQ,SAAS,MAAM,GACtB;AACf,QAAM,QAAQ,IAAI,mBAAM;AAAA,IACvB;AAAA,IACA;AAAA,EACD,CAAC;AAED,SAAO,IAAI,aAAa,OAAO,QAAQ,MAAM;AAC9C;","names":["result"]}

package/cache/upstash/cache.d.cts

@@ -0,0 +1,59 @@
+import { Redis } from '@upstash/redis';
+import type { MutationOption } from "../core/index.cjs";
+import { Cache } from "../core/index.cjs";
+import { entityKind } from "../../entity.cjs";
+import type { CacheConfig } from "../core/types.cjs";
+export declare class UpstashCache extends Cache {
+    redis: Redis;
+    protected useGlobally?: boolean | undefined;
+    static readonly [entityKind]: string;
+    /**
+     * Prefix for sets which denote the composite table names for each unique table
+     *
+     * Example: In the composite table set of "table1", you may find
+     * `${compositeTablePrefix}table1,table2` and `${compositeTablePrefix}table1,table3`
+     */
+    private static compositeTableSetPrefix;
+    /**
+     * Prefix for hashes which map hash or tags to cache values
+     */
+    private static compositeTablePrefix;
+    /**
+     * Key which holds the mapping of tags to composite table names
+     *
+     * Using this tagsMapKey, you can find the composite table name for a given tag
+     * and get the cache value for that tag:
+     *
+     * ```ts
+     * const compositeTable = redis.hget(tagsMapKey, 'tag1')
+     * console.log(compositeTable) // `${compositeTablePrefix}table1,table2`
+     *
+     * const cachevalue = redis.hget(compositeTable, 'tag1')
+     */
+    private static tagsMapKey;
+    /**
+     * Queries whose auto invalidation is false aren't stored in their respective
+     * composite table hashes because those hashes are deleted when a mutation
+     * occurs on related tables.
+     *
+     * Instead, they are stored in a separate hash with the prefix
+     * `__nonAutoInvalidate__` to prevent them from being deleted when a mutation
+     */
+    private static nonAutoInvalidateTablePrefix;
+    private luaScripts;
+    private internalConfig;
+    constructor(redis: Redis, config?: CacheConfig, useGlobally?: boolean | undefined);
+    strategy(): "all" | "explicit";
+    private toInternalConfig;
+    get(key: string, tables: string[], isTag?: boolean, isAutoInvalidate?: boolean): Promise<any[] | undefined>;
+    put(key: string, response: any, tables: string[], isTag?: boolean, config?: CacheConfig): Promise<void>;
+    onMutate(params: MutationOption): Promise<void>;
+    private addTablePrefix;
+    private getCompositeKey;
+}
+export declare function upstashCache({ url, token, config, global }: {
+    url: string;
+    token: string;
+    config?: CacheConfig;
+    global?: boolean;
+}): UpstashCache;

package/cache/upstash/cache.d.ts

@@ -0,0 +1,59 @@
+import { Redis } from '@upstash/redis';
+import type { MutationOption } from "../core/index.js";
+import { Cache } from "../core/index.js";
+import { entityKind } from "../../entity.js";
+import type { CacheConfig } from "../core/types.js";
+export declare class UpstashCache extends Cache {
+    redis: Redis;
+    protected useGlobally?: boolean | undefined;
+    static readonly [entityKind]: string;
+    /**
+     * Prefix for sets which denote the composite table names for each unique table
+     *
+     * Example: In the composite table set of "table1", you may find
+     * `${compositeTablePrefix}table1,table2` and `${compositeTablePrefix}table1,table3`
+     */
+    private static compositeTableSetPrefix;
+    /**
+     * Prefix for hashes which map hash or tags to cache values
+     */
+    private static compositeTablePrefix;
+    /**
+     * Key which holds the mapping of tags to composite table names
+     *
+     * Using this tagsMapKey, you can find the composite table name for a given tag
+     * and get the cache value for that tag:
+     *
+     * ```ts
+     * const compositeTable = redis.hget(tagsMapKey, 'tag1')
+     * console.log(compositeTable) // `${compositeTablePrefix}table1,table2`
+     *
+     * const cachevalue = redis.hget(compositeTable, 'tag1')
+     */
+    private static tagsMapKey;
+    /**
+     * Queries whose auto invalidation is false aren't stored in their respective
+     * composite table hashes because those hashes are deleted when a mutation
+     * occurs on related tables.
+     *
+     * Instead, they are stored in a separate hash with the prefix
+     * `__nonAutoInvalidate__` to prevent them from being deleted when a mutation
+     */
+    private static nonAutoInvalidateTablePrefix;
+    private luaScripts;
+    private internalConfig;
+    constructor(redis: Redis, config?: CacheConfig, useGlobally?: boolean | undefined);
+    strategy(): "all" | "explicit";
+    private toInternalConfig;
+    get(key: string, tables: string[], isTag?: boolean, isAutoInvalidate?: boolean): Promise<any[] | undefined>;
+    put(key: string, response: any, tables: string[], isTag?: boolean, config?: CacheConfig): Promise<void>;
+    onMutate(params: MutationOption): Promise<void>;
+    private addTablePrefix;
+    private getCompositeKey;
+}
+export declare function upstashCache({ url, token, config, global }: {
+    url: string;
+    token: string;
+    config?: CacheConfig;
+    global?: boolean;
+}): UpstashCache;