memx 0.0.7 → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,239 @@
+/// <reference types="node" />
+export interface AdapterResult {
+    value: Buffer;
+    flags: number;
+    cas: bigint;
+    recycle: () => void;
+}
+export interface Counter {
+    value: bigint;
+    cas: bigint;
+}
+export interface Stats {
+    /** Process id of this server process (32u) */
+    pid: number;
+    /** Number of secs since the server started (32u) */
+    uptime: number;
+    /** current UNIX time according to the server (32u) */
+    time: number;
+    /** Version string of this server (string) */
+    version: string;
+    /** Default size of pointers on the host OS (generally 32 or 64) (32) */
+    pointer_size: number;
+    /** Accumulated user time for this process (microseconds) (32u.32u) */
+    rusage_user: bigint;
+    /** Accumulated system time for this process (microseconds) (32u.32u) */
+    rusage_system: bigint;
+    /** Current number of items stored (64u) */
+    curr_items: bigint;
+    /** Total number of items stored since the server started (64u) */
+    total_items: bigint;
+    /** Current number of bytes used to store items (64u) */
+    bytes: bigint;
+    /** Max number of simultaneous connections (32u) */
+    max_connections: number;
+    /** Number of open connections (32u) */
+    curr_connections: number;
+    /** Total number of connections opened since the server started running (32u) */
+    total_connections: number;
+    /** Conns rejected in maxconns_fast mode (64u) */
+    rejected_connections: bigint;
+    /** Number of connection structures allocated by the server (32u) */
+    connection_structures: number;
+    /** Connections closed by lack of memory (64u) */
+    response_obj_oom: bigint;
+    /** Total response objects in use (64u) */
+    response_obj_count: bigint;
+    /** Total bytes used for resp. objects. is a subset of bytes from read_buf_bytes (64u) */
+    response_obj_bytes: bigint;
+    /** Total read/resp buffers allocated (64u) */
+    read_buf_count: bigint;
+    /** Total read/resp buffer bytes allocated (64u) */
+    read_buf_bytes: bigint;
+    /** Total read/resp buffer bytes cached (64u) */
+    read_buf_bytes_free: bigint;
+    /** Connections closed by lack of memory (64u) */
+    read_buf_oom: bigint;
+    /** Number of misc fds used internally (32u) */
+    reserved_fds: number;
+    /** Cumulative number of retrieval reqs (64u) */
+    cmd_get: bigint;
+    /** Cumulative number of storage reqs (64u) */
+    cmd_set: bigint;
+    /** Cumulative number of flush reqs (64u) */
+    cmd_flush: bigint;
+    /** Cumulative number of touch reqs (64u) */
+    cmd_touch: bigint;
+    /** Number of keys that have been requested and found present (64u) */
+    get_hits: bigint;
+    /** Number of items that have been requested and not found (64u) */
+    get_misses: bigint;
+    /** Number of items that have been requested but had already expired (64u) */
+    get_expired: bigint;
+    /** Number of items that have been requested but have been flushed via flush_all (64u) */
+    get_flushed: bigint;
+    /** Number of deletions reqs for missing keys (64u) */
+    delete_misses: bigint;
+    /** Number of deletion reqs resulting in an item being removed (64u) */
+    delete_hits: bigint;
+    /** Number of incr reqs against missing keys (64u) */
+    incr_misses: bigint;
+    /** Number of successful incr reqs (64u) */
+    incr_hits: bigint;
+    /** Number of decr reqs against missing keys (64u) */
+    decr_misses: bigint;
+    /** Number of successful decr reqs (64u) */
+    decr_hits: bigint;
+    /** Number of CAS reqs against missing keys (64u) */
+    cas_misses: bigint;
+    /** Number of successful CAS reqs (64u) */
+    cas_hits: bigint;
+    /** Number of CAS reqs for which a key was found, but the CAS value did not match (64u) */
+    cas_badval: bigint;
+    /** Number of keys that have been touched with a new expiration time (64u) */
+    touch_hits: bigint;
+    /** Number of items that have been touched and not found (64u) */
+    touch_misses: bigint;
+    /** Number of rejected storage requests caused by attempting to write a value larger than the -I limit (64u) */
+    store_too_large: bigint;
+    /** Number of rejected storage requests caused by exhaustion of the -m memory limit (relevant when -M is used) (64u) */
+    store_no_memory: bigint;
+    /** Number of authentication commands handled, success or failure (64u) */
+    auth_cmds: bigint;
+    /** Number of failed authentications (64u) */
+    auth_errors: bigint;
+    /** Number of connections closed due to reaching their idle timeout (64u) */
+    idle_kicks: bigint;
+    /** Number of valid items removed from cache to free memory for new items (64u) */
+    evictions: bigint;
+    /** Number of times an entry was stored using memory from an expired entry (64u) */
+    reclaimed: bigint;
+    /** Total number of bytes read by this server from network (64u) */
+    bytes_read: bigint;
+    /** Total number of bytes sent by this server to network (64u) */
+    bytes_written: bigint;
+    /** Number of bytes this server is allowed to use for storage (size_t) */
+    limit_maxbytes: bigint;
+    /** Whether or not server is accepting conns (bool) */
+    accepting_conns: boolean;
+    /** Number of times server has stopped accepting new connections (maxconns) (64u) */
+    listen_disabled_num: bigint;
+    /** Number of microseconds in maxconns (64u) */
+    time_in_listen_disabled_us: bigint;
+    /** Number of worker threads requested (see doc/threads.txt) (32u) */
+    threads: number;
+    /** Number of times any connection yielded to another due to hitting the -R limit (64u) */
+    conn_yields: bigint;
+    /** Current size multiplier for hash table (32u) */
+    hash_power_level: number;
+    /** Bytes currently used by hash tables (64u) */
+    hash_bytes: bigint;
+    /** Indicates if the hash table is being grown to a new size (bool) */
+    hash_is_expanding: boolean;
+    /** Items pulled from LRU that were never touched by get/incr/append/etc before expiring (64u) */
+    expired_unfetched: bigint;
+    /** Items evicted from LRU that were never touched by get/incr/append/etc (64u) */
+    evicted_unfetched: bigint;
+    /** Items evicted from LRU that had been hit recently but did not jump to top of LRU (64u) */
+    evicted_active: bigint;
+    /** If a slab page is being moved (bool) */
+    slab_reassign_running: boolean;
+    /** Total slab pages moved (64u) */
+    slabs_moved: bigint;
+    /** Total items freed by LRU Crawler (64u) */
+    crawler_reclaimed: bigint;
+    /** Total items examined by LRU Crawler (64u) */
+    crawler_items_checked: bigint;
+    /** Times LRU tail was found with active ref. Items can be evicted to avoid OOM errors (64u) */
+    lrutail_reflocked: bigint;
+    /** Items moved from HOT/WARM to COLD LRU's (64u) */
+    moves_to_cold: bigint;
+    /** Items moved from COLD to WARM LRU (64u) */
+    moves_to_warm: bigint;
+    /** Items reshuffled within HOT or WARM LRU's (64u) */
+    moves_within_lru: bigint;
+    /** Times worker threads had to directly reclaim or evict items (64u) */
+    direct_reclaims: bigint;
+    /** Number of LRU crawlers running (64u) */
+    lru_crawler_running: bigint;
+    /** Times an LRU crawler was started (64u) */
+    lru_crawler_starts: bigint;
+    /** Number of times the LRU bg thread woke up (64u) */
+    lru_maintainer_juggles: bigint;
+    /** Slab pages returned to global pool for reassignment to other slab classes (32u) */
+    slab_global_page_pool: number;
+    /** Items rescued from eviction in page move (64u) */
+    slab_reassign_rescues: bigint;
+    /** Valid items evicted during a page move (due to no free memory in slab) (64u) */
+    slab_reassign_evictions_nomem: bigint;
+    /** Individual sections of an item rescued during a page move (64u) */
+    slab_reassign_chunk_rescues: bigint;
+    /** Internal stat counter for when the page mover clears memory from the chunk freelist when it wasn't expecting to (64u) */
+    slab_reassign_inline_reclaim: bigint;
+    /** Items busy during page move, requiring a retry before page can be moved (64u) */
+    slab_reassign_busy_items: bigint;
+    /** Items busy during page move, requiring deletion before page can be moved (64u) */
+    slab_reassign_busy_deletes: bigint;
+    /** Logs a worker never wrote due to full buf (64u) */
+    log_worker_dropped: bigint;
+    /** Logs written by a worker, to be picked up (64u) */
+    log_worker_written: bigint;
+    /** Logs not sent to slow watchers (64u) */
+    log_watcher_skipped: bigint;
+    /** Logs written to watchers (64u) */
+    log_watcher_sent: bigint;
+    /** Number of currently active watchers (64u) */
+    log_watchers: bigint;
+    /** Number of times an unexpected napi id is is received. See doc/napi_ids.txt (64u) */
+    unexpected_napi_ids: bigint;
+    /** Number of times napi id of 0 is received resulting in fallback to round robin thread selection. See doc/napi_ids.txt (64u) */
+    round_robin_fallback: bigint;
+    /** Nuumber of times `malloc` failed (64u) */
+    malloc_fails: bigint;
+}
+export interface Adapter {
+    readonly ttl: number;
+    get(key: string): Promise<AdapterResult | undefined>;
+    gat(key: string, ttl: number): Promise<AdapterResult | undefined>;
+    touch(key: string, ttl?: number): Promise<boolean>;
+    set(key: string, value: Buffer, options?: {
+        flags?: number;
+        cas?: bigint;
+        ttl?: number;
+    }): Promise<bigint | undefined>;
+    add(key: string, value: Buffer, options?: {
+        flags?: number;
+        ttl?: number;
+    }): Promise<bigint | undefined>;
+    replace(key: string, value: Buffer, options?: {
+        flags?: number;
+        cas?: bigint;
+        ttl?: number;
+    }): Promise<bigint | undefined>;
+    append(key: string, value: Buffer, options?: {
+        cas?: bigint;
+    }): Promise<boolean>;
+    prepend(key: string, value: Buffer, options?: {
+        cas?: bigint;
+    }): Promise<boolean>;
+    increment(key: string, delta?: bigint | number, options?: {
+        initial?: bigint | number;
+        cas?: bigint;
+        ttl?: number;
+        create?: boolean;
+    }): Promise<Counter | undefined>;
+    decrement(key: string, delta?: bigint | number, options?: {
+        initial?: bigint | number;
+        cas?: bigint;
+        ttl?: number;
+        create?: boolean;
+    }): Promise<Counter | undefined>;
+    delete(key: string, options?: {
+        cas?: bigint;
+    }): Promise<boolean>;
+    flush(ttl?: number): Promise<void>;
+    noop(): Promise<void>;
+    quit(): Promise<void>;
+    version(): Promise<Record<string, string>>;
+    stats(): Promise<Record<string, Stats>>;
+}

package/dist/types.mjs

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

package/dist/types.mjs.map

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

package/dist/utils.cjs

@@ -0,0 +1,182 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  Bundle: () => Bundle,
+  Factory: () => Factory,
+  PoorManLock: () => PoorManLock
+});
+module.exports = __toCommonJS(utils_exports);
+var import_node_assert = __toESM(require("node:assert"));
+var import_internals = require("./internals.cjs");
+var Factory = class {
+  #factory;
+  #client;
+  #ttl;
+  constructor(client, factory, ttl) {
+    (0, import_node_assert.default)(typeof factory === "function", "Invalid or no factory specified");
+    (0, import_node_assert.default)(client, "No client specified");
+    this.#factory = factory;
+    this.#client = client;
+    this.#ttl = ttl;
+  }
+  async get(key) {
+    const cached = await this.#client.getc(key);
+    if (cached) {
+      void (0, import_internals.logPromiseError)(
+        this.#client.touch(key),
+        `Factory error touching key "${this.#client.prefix}${key}"`
+      );
+      return cached.value;
+    }
+    const created = await this.#factory(key);
+    if (created) {
+      void (0, import_internals.logPromiseError)(
+        this.#client.set(key, created, { ttl: this.#ttl }),
+        `Factory error setting key "${this.#client.prefix}${key}"`
+      );
+    }
+    return created;
+  }
+};
+var Bundle = class {
+  #client;
+  #name;
+  #ttl;
+  constructor(client, name, ttl) {
+    (0, import_node_assert.default)(client, "No client specified");
+    (0, import_node_assert.default)(name, "No bundle name specified");
+    this.#client = client;
+    this.#name = name;
+    this.#ttl = ttl || 0;
+  }
+  async #appendKey(key) {
+    await (0, import_internals.logPromiseError)((async () => {
+      const added = await this.#client.add(this.#name, key, { ttl: this.#ttl });
+      if (!added) {
+        await this.#client.append(this.#name, `\0${key}`);
+        await this.#client.touch(this.#name, this.#ttl);
+      }
+    })(), `Bundle "${this.#client.prefix}${this.#name}" error recording key "${key}"`);
+  }
+  async #removeKey(key) {
+    await (0, import_internals.logPromiseError)((async () => {
+      const result = await this.#client.getc(this.#name);
+      if (!result)
+        return;
+      const keys = result.value.split("\0").filter((k) => k !== key).join("\0");
+      await this.#client.set(this.#name, keys, { cas: result.cas, ttl: this.#ttl });
+    })(), `Bundle "${this.#client.prefix}${this.#name}" error clearing key "${key}"`);
+  }
+  async add(key, value) {
+    await this.#client.set(`${this.#name}:${key}`, value, { ttl: this.#ttl });
+    await this.#appendKey(key);
+  }
+  async get(key) {
+    const result = await this.#client.getc(`${this.#name}:${key}`);
+    if (result)
+      return result.value;
+    await this.#removeKey(key);
+    return void 0;
+  }
+  async delete(key) {
+    await this.#client.delete(`${this.#name}:${key}`);
+    await this.#removeKey(key);
+  }
+  async list() {
+    const result = await this.#client.getc(this.#name);
+    if (!result)
+      return {};
+    const results = {};
+    const promises = [];
+    for (const key of new Set(result.value.split("\0"))) {
+      promises.push(this.#client.getc(`${this.#name}:${key}`).then((result2) => {
+        if (result2)
+          results[key] = result2.value;
+      }));
+    }
+    await Promise.all(promises);
+    await (0, import_internals.logPromiseError)(
+      this.#client.set(this.#name, Object.keys(results).join("\0"), { cas: result.cas, ttl: this.#ttl }),
+      `Bundle "${this.#client.prefix}${this.#name}" error compacting keys`
+    );
+    return results;
+  }
+};
+var PoorManLock = class {
+  #client;
+  #name;
+  constructor(client, name) {
+    (0, import_node_assert.default)(client, "No client specified");
+    (0, import_node_assert.default)(name, "No lock name specified");
+    this.#client = client;
+    this.#name = name;
+  }
+  async execute(executor, options) {
+    const { timeout = 5e3, owner = false } = options || {};
+    const end = Date.now() + timeout;
+    let cas;
+    do {
+      cas = await this.#client.add(this.#name, owner, { ttl: 2 });
+      if (cas !== void 0)
+        break;
+      await new Promise((resolve) => setTimeout(resolve, 100));
+    } while (Date.now() < end);
+    if (cas === void 0) {
+      const other = await this.#client.getc(this.#name);
+      const owner2 = other && other.value ? `"${other.value}"` : "anonymous";
+      throw new Error(`Lock "${this.#client.prefix}${this.#name}" timeout (owner=${owner2})`);
+    }
+    const interval = setInterval(() => {
+      void (0, import_internals.logPromiseError)((async () => {
+        const replaced = await this.#client.replace(this.#name, owner, { ttl: 2, cas });
+        (0, import_node_assert.default)(replaced !== void 0, `Lock "${this.#client.prefix}${this.#name}" not replaced`);
+        cas = replaced;
+      })(), `Error extending lock "${this.#client.prefix}${this.#name}"`);
+    }, 100);
+    try {
+      return await executor();
+    } finally {
+      clearInterval(interval);
+      await (0, import_internals.logPromiseError)(
+        this.#client.delete(this.#name, { cas }),
+        `Error deleting lock "${this.#client.prefix}${this.#name}"`
+      );
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Bundle,
+  Factory,
+  PoorManLock
+});
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/utils.ts"],
+  "mappings": "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",
+  "names": ["assert", "result", "owner"]
+}

package/dist/utils.d.ts

@@ -0,0 +1,22 @@
+import type { MemxClient, Serializable } from './client';
+export declare class Factory<T extends Serializable> {
+    #private;
+    constructor(client: MemxClient, factory: (key: string) => T | Promise<T>, ttl?: number);
+    get(key: string): Promise<T>;
+}
+export declare class Bundle<T extends Serializable = Serializable> {
+    #private;
+    constructor(client: MemxClient, name: string, ttl?: number);
+    add(key: string, value: T): Promise<void>;
+    get(key: string): Promise<T | undefined>;
+    delete(key: string): Promise<void>;
+    list(): Promise<Record<string, T>>;
+}
+export declare class PoorManLock {
+    #private;
+    constructor(client: MemxClient, name: string);
+    execute<T>(executor: () => T | Promise<T>, options?: {
+        timeout?: number;
+        owner?: string;
+    }): Promise<T>;
+}

package/dist/utils.mjs

@@ -0,0 +1,145 @@
+// utils.ts
+import assert from "node:assert";
+import { logPromiseError } from "./internals.mjs";
+var Factory = class {
+  #factory;
+  #client;
+  #ttl;
+  constructor(client, factory, ttl) {
+    assert(typeof factory === "function", "Invalid or no factory specified");
+    assert(client, "No client specified");
+    this.#factory = factory;
+    this.#client = client;
+    this.#ttl = ttl;
+  }
+  async get(key) {
+    const cached = await this.#client.getc(key);
+    if (cached) {
+      void logPromiseError(
+        this.#client.touch(key),
+        `Factory error touching key "${this.#client.prefix}${key}"`
+      );
+      return cached.value;
+    }
+    const created = await this.#factory(key);
+    if (created) {
+      void logPromiseError(
+        this.#client.set(key, created, { ttl: this.#ttl }),
+        `Factory error setting key "${this.#client.prefix}${key}"`
+      );
+    }
+    return created;
+  }
+};
+var Bundle = class {
+  #client;
+  #name;
+  #ttl;
+  constructor(client, name, ttl) {
+    assert(client, "No client specified");
+    assert(name, "No bundle name specified");
+    this.#client = client;
+    this.#name = name;
+    this.#ttl = ttl || 0;
+  }
+  async #appendKey(key) {
+    await logPromiseError((async () => {
+      const added = await this.#client.add(this.#name, key, { ttl: this.#ttl });
+      if (!added) {
+        await this.#client.append(this.#name, `\0${key}`);
+        await this.#client.touch(this.#name, this.#ttl);
+      }
+    })(), `Bundle "${this.#client.prefix}${this.#name}" error recording key "${key}"`);
+  }
+  async #removeKey(key) {
+    await logPromiseError((async () => {
+      const result = await this.#client.getc(this.#name);
+      if (!result)
+        return;
+      const keys = result.value.split("\0").filter((k) => k !== key).join("\0");
+      await this.#client.set(this.#name, keys, { cas: result.cas, ttl: this.#ttl });
+    })(), `Bundle "${this.#client.prefix}${this.#name}" error clearing key "${key}"`);
+  }
+  async add(key, value) {
+    await this.#client.set(`${this.#name}:${key}`, value, { ttl: this.#ttl });
+    await this.#appendKey(key);
+  }
+  async get(key) {
+    const result = await this.#client.getc(`${this.#name}:${key}`);
+    if (result)
+      return result.value;
+    await this.#removeKey(key);
+    return void 0;
+  }
+  async delete(key) {
+    await this.#client.delete(`${this.#name}:${key}`);
+    await this.#removeKey(key);
+  }
+  async list() {
+    const result = await this.#client.getc(this.#name);
+    if (!result)
+      return {};
+    const results = {};
+    const promises = [];
+    for (const key of new Set(result.value.split("\0"))) {
+      promises.push(this.#client.getc(`${this.#name}:${key}`).then((result2) => {
+        if (result2)
+          results[key] = result2.value;
+      }));
+    }
+    await Promise.all(promises);
+    await logPromiseError(
+      this.#client.set(this.#name, Object.keys(results).join("\0"), { cas: result.cas, ttl: this.#ttl }),
+      `Bundle "${this.#client.prefix}${this.#name}" error compacting keys`
+    );
+    return results;
+  }
+};
+var PoorManLock = class {
+  #client;
+  #name;
+  constructor(client, name) {
+    assert(client, "No client specified");
+    assert(name, "No lock name specified");
+    this.#client = client;
+    this.#name = name;
+  }
+  async execute(executor, options) {
+    const { timeout = 5e3, owner = false } = options || {};
+    const end = Date.now() + timeout;
+    let cas;
+    do {
+      cas = await this.#client.add(this.#name, owner, { ttl: 2 });
+      if (cas !== void 0)
+        break;
+      await new Promise((resolve) => setTimeout(resolve, 100));
+    } while (Date.now() < end);
+    if (cas === void 0) {
+      const other = await this.#client.getc(this.#name);
+      const owner2 = other && other.value ? `"${other.value}"` : "anonymous";
+      throw new Error(`Lock "${this.#client.prefix}${this.#name}" timeout (owner=${owner2})`);
+    }
+    const interval = setInterval(() => {
+      void logPromiseError((async () => {
+        const replaced = await this.#client.replace(this.#name, owner, { ttl: 2, cas });
+        assert(replaced !== void 0, `Lock "${this.#client.prefix}${this.#name}" not replaced`);
+        cas = replaced;
+      })(), `Error extending lock "${this.#client.prefix}${this.#name}"`);
+    }, 100);
+    try {
+      return await executor();
+    } finally {
+      clearInterval(interval);
+      await logPromiseError(
+        this.#client.delete(this.#name, { cas }),
+        `Error deleting lock "${this.#client.prefix}${this.#name}"`
+      );
+    }
+  }
+};
+export {
+  Bundle,
+  Factory,
+  PoorManLock
+};
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/utils.ts"],
+  "mappings": "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",
+  "names": ["result", "owner"]
+}