@c9up/echo 0.2.3 → 0.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/README.md +1 -1
  2. package/dist/CacheManager.d.ts +13 -2
  3. package/dist/CacheManager.d.ts.map +1 -1
  4. package/dist/CacheManager.js +309 -56
  5. package/dist/CacheManager.js.map +1 -1
  6. package/dist/EchoProvider.d.ts.map +1 -1
  7. package/dist/EchoProvider.js +32 -3
  8. package/dist/EchoProvider.js.map +1 -1
  9. package/dist/StoreManager.d.ts +38 -11
  10. package/dist/StoreManager.d.ts.map +1 -1
  11. package/dist/StoreManager.js +80 -22
  12. package/dist/StoreManager.js.map +1 -1
  13. package/dist/bytes.d.ts +13 -0
  14. package/dist/bytes.d.ts.map +1 -0
  15. package/dist/bytes.js +35 -0
  16. package/dist/bytes.js.map +1 -0
  17. package/dist/claim.d.ts +15 -0
  18. package/dist/claim.d.ts.map +1 -0
  19. package/dist/claim.js +10 -0
  20. package/dist/claim.js.map +1 -0
  21. package/dist/configure.d.ts +1 -0
  22. package/dist/configure.d.ts.map +1 -1
  23. package/dist/configure.js +3 -0
  24. package/dist/configure.js.map +1 -1
  25. package/dist/console/cacheClear.d.ts +13 -0
  26. package/dist/console/cacheClear.d.ts.map +1 -0
  27. package/dist/console/cacheClear.js +69 -0
  28. package/dist/console/cacheClear.js.map +1 -0
  29. package/dist/console/cacheDelete.d.ts +11 -0
  30. package/dist/console/cacheDelete.d.ts.map +1 -0
  31. package/dist/console/cacheDelete.js +42 -0
  32. package/dist/console/cacheDelete.js.map +1 -0
  33. package/dist/console/cachePrune.d.ts +9 -0
  34. package/dist/console/cachePrune.d.ts.map +1 -0
  35. package/dist/console/cachePrune.js +35 -0
  36. package/dist/console/cachePrune.js.map +1 -0
  37. package/dist/console/contract.d.ts +64 -0
  38. package/dist/console/contract.d.ts.map +1 -0
  39. package/dist/console/contract.js +32 -0
  40. package/dist/console/contract.js.map +1 -0
  41. package/dist/console/index.d.ts +25 -0
  42. package/dist/console/index.d.ts.map +1 -0
  43. package/dist/console/index.js +38 -0
  44. package/dist/console/index.js.map +1 -0
  45. package/dist/console/store.d.ts +14 -0
  46. package/dist/console/store.d.ts.map +1 -0
  47. package/dist/console/store.js +35 -0
  48. package/dist/console/store.js.map +1 -0
  49. package/dist/drivers/MemoryDriver.d.ts +37 -1
  50. package/dist/drivers/MemoryDriver.d.ts.map +1 -1
  51. package/dist/drivers/MemoryDriver.js +170 -72
  52. package/dist/drivers/MemoryDriver.js.map +1 -1
  53. package/dist/drivers/RedisDriver.d.ts +15 -8
  54. package/dist/drivers/RedisDriver.d.ts.map +1 -1
  55. package/dist/drivers/RedisDriver.js +198 -97
  56. package/dist/drivers/RedisDriver.js.map +1 -1
  57. package/dist/drivers/TieredDriver.d.ts +42 -0
  58. package/dist/drivers/TieredDriver.d.ts.map +1 -1
  59. package/dist/drivers/TieredDriver.js +114 -9
  60. package/dist/drivers/TieredDriver.js.map +1 -1
  61. package/dist/duration.d.ts +13 -3
  62. package/dist/duration.d.ts.map +1 -1
  63. package/dist/duration.js +22 -7
  64. package/dist/duration.js.map +1 -1
  65. package/dist/errors.d.ts +60 -2
  66. package/dist/errors.d.ts.map +1 -1
  67. package/dist/errors.js +81 -6
  68. package/dist/errors.js.map +1 -1
  69. package/dist/index.d.ts +4 -4
  70. package/dist/index.d.ts.map +1 -1
  71. package/dist/index.js +3 -3
  72. package/dist/index.js.map +1 -1
  73. package/dist/quasar.d.ts +1 -1
  74. package/dist/quasar.d.ts.map +1 -1
  75. package/dist/quasar.js +106 -19
  76. package/dist/quasar.js.map +1 -1
  77. package/dist/services/main.d.ts +1 -1
  78. package/dist/services/main.d.ts.map +1 -1
  79. package/dist/services/main.js +22 -5
  80. package/dist/services/main.js.map +1 -1
  81. package/dist/types.d.ts +44 -2
  82. package/dist/types.d.ts.map +1 -1
  83. package/dist/vendor/quasarConnection.d.ts +44 -3
  84. package/dist/vendor/quasarConnection.d.ts.map +1 -1
  85. package/dist/vendor/quasarConnection.js +64 -23
  86. package/dist/vendor/quasarConnection.js.map +1 -1
  87. package/package.json +5 -1
  88. package/src/CacheManager.ts +367 -69
  89. package/src/EchoProvider.ts +45 -4
  90. package/src/StoreManager.ts +131 -35
  91. package/src/bytes.ts +38 -0
  92. package/src/claim.ts +22 -0
  93. package/src/configure.ts +4 -0
  94. package/src/console/cacheClear.ts +96 -0
  95. package/src/console/cacheDelete.ts +65 -0
  96. package/src/console/cachePrune.ts +57 -0
  97. package/src/console/contract.ts +93 -0
  98. package/src/console/index.ts +61 -0
  99. package/src/console/store.ts +47 -0
  100. package/src/drivers/MemoryDriver.ts +221 -69
  101. package/src/drivers/RedisDriver.ts +234 -104
  102. package/src/drivers/TieredDriver.ts +169 -9
  103. package/src/duration.ts +28 -7
  104. package/src/errors.ts +103 -6
  105. package/src/index.ts +17 -3
  106. package/src/quasar.ts +145 -30
  107. package/src/services/main.ts +26 -8
  108. package/src/types.ts +46 -7
  109. package/src/vendor/quasarConnection.ts +105 -22
@@ -1 +1 @@
1
- {"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,UAAU,QAAQ;IACjB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE"}
1
+ {"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,UAAU,QAAQ;IACjB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE"}
package/dist/configure.js CHANGED
@@ -15,6 +15,9 @@ export async function configure(codemods) {
15
15
  CACHE_STORE: "memory",
16
16
  });
17
17
  await codemods.addProvider("@c9up/echo/provider");
18
+ // `cache:clear`, `cache:delete` and `cache:prune` are the package's, not the
19
+ // binary's: a project reaches them by listing the module.
20
+ await codemods.registerCommand("@c9up/echo/commands");
18
21
  await codemods.makeUsingStub(stubsRoot, "config/cache.stub");
19
22
  }
20
23
  //# sourceMappingURL=configure.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"configure.js","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkBvC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAkB;IACjD,4EAA4E;IAC5E,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,QAAQ,CAAC,UAAU,CAAC;QACzB,WAAW,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAClD,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAC9D,CAAC"}
1
+ {"version":3,"file":"configure.js","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmBvC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAkB;IACjD,4EAA4E;IAC5E,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,QAAQ,CAAC,UAAU,CAAC;QACzB,WAAW,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAClD,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,QAAQ,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC;IACtD,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAC9D,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * `cache:clear` — empty a store, one of its namespaces, or its entries under
3
+ * some tags.
4
+ *
5
+ * ream cache:clear
6
+ * ream cache:clear redis --namespace=users
7
+ * ream cache:clear --tags=products --tags=shop
8
+ *
9
+ * In production it asks first, unless `--force`.
10
+ */
11
+ import { type EchoCommandClass } from "./contract.js";
12
+ export declare function cacheClearCommand(): EchoCommandClass;
13
+ //# sourceMappingURL=cacheClear.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheClear.d.ts","sourceRoot":"","sources":["../../src/console/cacheClear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAKN,KAAK,gBAAgB,EAErB,MAAM,eAAe,CAAC;AAGvB,wBAAgB,iBAAiB,IAAI,gBAAgB,CA0EpD"}
@@ -0,0 +1,69 @@
1
+ /**
2
+ * `cache:clear` — empty a store, one of its namespaces, or its entries under
3
+ * some tags.
4
+ *
5
+ * ream cache:clear
6
+ * ream cache:clear redis --namespace=users
7
+ * ream cache:clear --tags=products --tags=shop
8
+ *
9
+ * In production it asks first, unless `--force`.
10
+ */
11
+ import { argument, flag, } from "./contract.js";
12
+ import { consent, resolveStore } from "./store.js";
13
+ export function cacheClearCommand() {
14
+ return class CacheClear {
15
+ static commandName = "cache:clear";
16
+ static description = "Clear the application cache";
17
+ static options = { startApp: true };
18
+ static args = [
19
+ argument("store", {
20
+ description: "Define a custom cache store to clear",
21
+ required: false,
22
+ }),
23
+ ];
24
+ static flags = [
25
+ flag("namespace", "string", {
26
+ description: "Select a cache namespace to clear",
27
+ alias: ["n"],
28
+ }),
29
+ flag("tags", "array", {
30
+ description: "Specify tags to invalidate",
31
+ alias: ["t"],
32
+ }),
33
+ flag("force", "boolean", {
34
+ description: "Explicitly force to clear cache in production",
35
+ }),
36
+ ];
37
+ async run() {
38
+ const cache = resolveStore(this.store, this.logger);
39
+ if (cache === undefined) {
40
+ this.exitCode = 1;
41
+ return;
42
+ }
43
+ const tags = this.tags ?? [];
44
+ if (this.namespace && tags.length > 0) {
45
+ this.logger.error("Cannot use --namespace and --tags options together. Please choose one or the other.");
46
+ this.exitCode = 1;
47
+ return;
48
+ }
49
+ if (this.app.inProduction &&
50
+ !this.force &&
51
+ !(await consent(this.prompt, "You are in production environment. Want to continue clearing the cache?"))) {
52
+ return;
53
+ }
54
+ if (tags.length > 0) {
55
+ await cache.deleteByTag({ tags });
56
+ this.logger.success(`Invalidated tags [${tags.join(", ")}] for "${cache.name}" cache successfully`);
57
+ }
58
+ else if (this.namespace) {
59
+ await cache.namespace(this.namespace).clear();
60
+ this.logger.success(`Cleared namespace "${this.namespace}" for "${cache.name}" cache successfully`);
61
+ }
62
+ else {
63
+ await cache.clear();
64
+ this.logger.success(`Cleared "${cache.name}" cache successfully`);
65
+ }
66
+ }
67
+ };
68
+ }
69
+ //# sourceMappingURL=cacheClear.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheClear.js","sourceRoot":"","sources":["../../src/console/cacheClear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACN,QAAQ,EAKR,IAAI,GACJ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,UAAU,iBAAiB;IAChC,OAAO,MAAM,UAAU;QACtB,MAAM,CAAC,WAAW,GAAG,aAAa,CAAC;QACnC,MAAM,CAAC,WAAW,GAAG,6BAA6B,CAAC;QACnD,MAAM,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,GAAG;YACb,QAAQ,CAAC,OAAO,EAAE;gBACjB,WAAW,EAAE,sCAAsC;gBACnD,QAAQ,EAAE,KAAK;aACf,CAAC;SACF,CAAC;QACF,MAAM,CAAC,KAAK,GAAG;YACd,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE;gBAC3B,WAAW,EAAE,mCAAmC;gBAChD,KAAK,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE;gBACrB,WAAW,EAAE,4BAA4B;gBACzC,KAAK,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE;gBACxB,WAAW,EAAE,+CAA+C;aAC5D,CAAC;SACF,CAAC;QAWF,KAAK,CAAC,GAAG;YACR,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAClB,OAAO;YACR,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAChB,qFAAqF,CACrF,CAAC;gBACF,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAClB,OAAO;YACR,CAAC;YACD,IACC,IAAI,CAAC,GAAG,CAAC,YAAY;gBACrB,CAAC,IAAI,CAAC,KAAK;gBACX,CAAC,CAAC,MAAM,OAAO,CACd,IAAI,CAAC,MAAM,EACX,yEAAyE,CACzE,CAAC,EACD,CAAC;gBACF,OAAO;YACR,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB,qBAAqB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,sBAAsB,CAC9E,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB,sBAAsB,IAAI,CAAC,SAAS,UAAU,KAAK,CAAC,IAAI,sBAAsB,CAC9E,CAAC;YACH,CAAC;iBAAM,CAAC;gBACP,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,KAAK,CAAC,IAAI,sBAAsB,CAAC,CAAC;YACnE,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * `cache:delete` — remove one key from a store.
3
+ *
4
+ * ream cache:delete user:42
5
+ * ream cache:delete user:42 redis
6
+ *
7
+ * In production it asks first.
8
+ */
9
+ import { type EchoCommandClass } from "./contract.js";
10
+ export declare function cacheDeleteCommand(): EchoCommandClass;
11
+ //# sourceMappingURL=cacheDelete.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheDelete.d.ts","sourceRoot":"","sources":["../../src/console/cacheDelete.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAKN,KAAK,gBAAgB,EACrB,MAAM,eAAe,CAAC;AAGvB,wBAAgB,kBAAkB,IAAI,gBAAgB,CA8CrD"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * `cache:delete` — remove one key from a store.
3
+ *
4
+ * ream cache:delete user:42
5
+ * ream cache:delete user:42 redis
6
+ *
7
+ * In production it asks first.
8
+ */
9
+ import { argument, } from "./contract.js";
10
+ import { consent, resolveStore } from "./store.js";
11
+ export function cacheDeleteCommand() {
12
+ return class CacheDelete {
13
+ static commandName = "cache:delete";
14
+ static description = "Delete a specific cache entry by key";
15
+ static options = { startApp: true };
16
+ static args = [
17
+ argument("key", { description: "The cache key to delete" }),
18
+ argument("store", {
19
+ description: "Define a custom cache store to delete from",
20
+ required: false,
21
+ }),
22
+ ];
23
+ async run() {
24
+ const cache = resolveStore(this.store, this.logger);
25
+ if (cache === undefined) {
26
+ this.exitCode = 1;
27
+ return;
28
+ }
29
+ if (this.app.inProduction &&
30
+ !(await consent(this.prompt, `You are in production environment. Want to continue deleting cache key "${this.key}"?`))) {
31
+ return;
32
+ }
33
+ if (await cache.delete({ key: this.key })) {
34
+ this.logger.success(`Deleted cache key "${this.key}" from "${cache.name}" cache successfully`);
35
+ }
36
+ else {
37
+ this.logger.warning(`Cache key "${this.key}" not found in "${cache.name}" cache`);
38
+ }
39
+ }
40
+ };
41
+ }
42
+ //# sourceMappingURL=cacheDelete.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheDelete.js","sourceRoot":"","sources":["../../src/console/cacheDelete.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,QAAQ,GAKR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,UAAU,kBAAkB;IACjC,OAAO,MAAM,WAAW;QACvB,MAAM,CAAC,WAAW,GAAG,cAAc,CAAC;QACpC,MAAM,CAAC,WAAW,GAAG,sCAAsC,CAAC;QAC5D,MAAM,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,GAAG;YACb,QAAQ,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;YAC3D,QAAQ,CAAC,OAAO,EAAE;gBACjB,WAAW,EAAE,4CAA4C;gBACzD,QAAQ,EAAE,KAAK;aACf,CAAC;SACF,CAAC;QASF,KAAK,CAAC,GAAG;YACR,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAClB,OAAO;YACR,CAAC;YACD,IACC,IAAI,CAAC,GAAG,CAAC,YAAY;gBACrB,CAAC,CAAC,MAAM,OAAO,CACd,IAAI,CAAC,MAAM,EACX,2EAA2E,IAAI,CAAC,GAAG,IAAI,CACvF,CAAC,EACD,CAAC;gBACF,OAAO;YACR,CAAC;YACD,IAAI,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB,sBAAsB,IAAI,CAAC,GAAG,WAAW,KAAK,CAAC,IAAI,sBAAsB,CACzE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB,cAAc,IAAI,CAAC,GAAG,mBAAmB,KAAK,CAAC,IAAI,SAAS,CAC5D,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * `cache:prune` — drop the entries a store knows to be expired. Only useful
3
+ * for stores that do not expire on their own; Redis does.
4
+ *
5
+ * In production it asks first.
6
+ */
7
+ import { type EchoCommandClass } from "./contract.js";
8
+ export declare function cachePruneCommand(): EchoCommandClass;
9
+ //# sourceMappingURL=cachePrune.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cachePrune.d.ts","sourceRoot":"","sources":["../../src/console/cachePrune.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAKN,KAAK,gBAAgB,EACrB,MAAM,eAAe,CAAC;AAGvB,wBAAgB,iBAAiB,IAAI,gBAAgB,CAwCpD"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * `cache:prune` — drop the entries a store knows to be expired. Only useful
3
+ * for stores that do not expire on their own; Redis does.
4
+ *
5
+ * In production it asks first.
6
+ */
7
+ import { argument, } from "./contract.js";
8
+ import { consent, resolveStore } from "./store.js";
9
+ export function cachePruneCommand() {
10
+ return class CachePrune {
11
+ static commandName = "cache:prune";
12
+ static description = "Remove expired cache entries from the selected store. This command is only useful for stores without native TTL support.";
13
+ static options = { startApp: true };
14
+ static args = [
15
+ argument("store", {
16
+ description: "Define a custom cache store to prune",
17
+ required: false,
18
+ }),
19
+ ];
20
+ async run() {
21
+ const cache = resolveStore(this.store, this.logger);
22
+ if (cache === undefined) {
23
+ this.exitCode = 1;
24
+ return;
25
+ }
26
+ if (this.app.inProduction &&
27
+ !(await consent(this.prompt, "You are in production environment. Want to continue pruning expired cache entries?"))) {
28
+ return;
29
+ }
30
+ await cache.prune();
31
+ this.logger.success(`Pruned expired entries from "${cache.name}" cache successfully`);
32
+ }
33
+ };
34
+ }
35
+ //# sourceMappingURL=cachePrune.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cachePrune.js","sourceRoot":"","sources":["../../src/console/cachePrune.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,QAAQ,GAKR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,UAAU,iBAAiB;IAChC,OAAO,MAAM,UAAU;QACtB,MAAM,CAAC,WAAW,GAAG,aAAa,CAAC;QACnC,MAAM,CAAC,WAAW,GACjB,0HAA0H,CAAC;QAC5H,MAAM,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,GAAG;YACb,QAAQ,CAAC,OAAO,EAAE;gBACjB,WAAW,EAAE,sCAAsC;gBACnD,QAAQ,EAAE,KAAK;aACf,CAAC;SACF,CAAC;QAQF,KAAK,CAAC,GAAG;YACR,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAClB,OAAO;YACR,CAAC;YACD,IACC,IAAI,CAAC,GAAG,CAAC,YAAY;gBACrB,CAAC,CAAC,MAAM,OAAO,CACd,IAAI,CAAC,MAAM,EACX,oFAAoF,CACpF,CAAC,EACD,CAAC;gBACF,OAAO;YACR,CAAC;YACD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,OAAO,CAClB,gCAAgC,KAAK,CAAC,IAAI,sBAAsB,CAChE,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * The console command contract, declared locally.
3
+ *
4
+ * Echo stays framework-agnostic: it must not import `@c9up/ream`, so it
5
+ * describes the shape Ream's console kernel dispatches against rather than
6
+ * importing it. The kernel assigns `logger`, `prompt` and — for a command that
7
+ * starts the app — `app` before it calls `run()`.
8
+ */
9
+ export interface CommandOptions {
10
+ /** Boot the application before `run()`. */
11
+ startApp?: boolean;
12
+ }
13
+ export interface ArgumentMetaData {
14
+ type: "string" | "spread";
15
+ propertyName: string;
16
+ argumentName: string;
17
+ description?: string;
18
+ required: boolean;
19
+ default?: string | string[];
20
+ }
21
+ export interface FlagMetaData {
22
+ type: "string" | "boolean" | "number" | "array";
23
+ propertyName: string;
24
+ flagName: string;
25
+ description?: string;
26
+ alias: string[];
27
+ default?: string | string[] | number | boolean;
28
+ required: boolean;
29
+ }
30
+ /** The slice of the kernel's logger these commands write to. */
31
+ export interface CommandLogger {
32
+ success(message: string): void;
33
+ warning(message: string): void;
34
+ error(message: string): void;
35
+ }
36
+ /** The slice of the kernel's prompt these commands ask through. */
37
+ export interface CommandPrompt {
38
+ confirm(message: string): Promise<boolean>;
39
+ }
40
+ /** The slice of the booted application these commands read. */
41
+ export interface CommandApp {
42
+ readonly inProduction: boolean;
43
+ }
44
+ /** The static side the kernel reads. */
45
+ export interface EchoCommandClass {
46
+ new (): {
47
+ run(): Promise<void> | void;
48
+ };
49
+ commandName: string;
50
+ description: string;
51
+ options?: CommandOptions;
52
+ args?: readonly ArgumentMetaData[];
53
+ flags?: readonly FlagMetaData[];
54
+ help?: string | string[];
55
+ }
56
+ export declare function flag(propertyName: string, type: FlagMetaData["type"], options?: {
57
+ description?: string;
58
+ alias?: string[];
59
+ }): FlagMetaData;
60
+ export declare function argument(propertyName: string, options?: {
61
+ description?: string;
62
+ required?: boolean;
63
+ }): ArgumentMetaData;
64
+ //# sourceMappingURL=contract.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/console/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAC/B;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAChC,QAAQ;QAAE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAOD,wBAAgB,IAAI,CACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAC1B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACtD,YAAY,CASd;AAED,wBAAgB,QAAQ,CACvB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,gBAAgB,CAQlB"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * The console command contract, declared locally.
3
+ *
4
+ * Echo stays framework-agnostic: it must not import `@c9up/ream`, so it
5
+ * describes the shape Ream's console kernel dispatches against rather than
6
+ * importing it. The kernel assigns `logger`, `prompt` and — for a command that
7
+ * starts the app — `app` before it calls `run()`.
8
+ */
9
+ /** `startServer` → `start-server`, matching the framework's decorators. */
10
+ function dashCase(value) {
11
+ return value.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
12
+ }
13
+ export function flag(propertyName, type, options = {}) {
14
+ return {
15
+ type,
16
+ propertyName,
17
+ flagName: dashCase(propertyName),
18
+ description: options.description,
19
+ alias: options.alias ?? [],
20
+ required: false,
21
+ };
22
+ }
23
+ export function argument(propertyName, options = {}) {
24
+ return {
25
+ type: "string",
26
+ propertyName,
27
+ argumentName: dashCase(propertyName),
28
+ description: options.description,
29
+ required: options.required ?? true,
30
+ };
31
+ }
32
+ //# sourceMappingURL=contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/console/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsDH,2EAA2E;AAC3E,SAAS,QAAQ,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,IAAI,CACnB,YAAoB,EACpB,IAA0B,EAC1B,UAAsD,EAAE;IAExD,OAAO;QACN,IAAI;QACJ,YAAY;QACZ,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,QAAQ,EAAE,KAAK;KACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CACvB,YAAoB,EACpB,UAAwD,EAAE;IAE1D,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,YAAY;QACZ,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;KAClC,CAAC;AACH,CAAC"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * `@c9up/echo/commands` — the commands echo ships.
3
+ *
4
+ * // reamrc.ts, written by `configure()`
5
+ * commands: [() => import('@c9up/echo/commands')]
6
+ *
7
+ * A module answering `getMetaData()` / `getCommand()`, which is how a package
8
+ * adds commands: by shipping them, never by a change to the `ream` binary.
9
+ */
10
+ import type { EchoCommandClass } from "./contract.js";
11
+ /** What the kernel reads to list a command without importing it. */
12
+ interface CommandMetaData {
13
+ commandName: string;
14
+ namespace: string | null;
15
+ description: string;
16
+ help?: string | string[];
17
+ aliases: string[];
18
+ options: Record<string, unknown>;
19
+ args: readonly unknown[];
20
+ flags: readonly unknown[];
21
+ }
22
+ export declare function getMetaData(): Promise<CommandMetaData[]>;
23
+ export declare function getCommand(metadata: CommandMetaData): Promise<EchoCommandClass | null>;
24
+ export type { EchoCommandClass } from "./contract.js";
25
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQtD,oEAAoE;AACpE,UAAU,eAAe;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CAC1B;AAgBD,wBAAsB,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAE9D;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAKlC;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * `@c9up/echo/commands` — the commands echo ships.
3
+ *
4
+ * // reamrc.ts, written by `configure()`
5
+ * commands: [() => import('@c9up/echo/commands')]
6
+ *
7
+ * A module answering `getMetaData()` / `getCommand()`, which is how a package
8
+ * adds commands: by shipping them, never by a change to the `ream` binary.
9
+ */
10
+ import { cacheClearCommand } from "./cacheClear.js";
11
+ import { cacheDeleteCommand } from "./cacheDelete.js";
12
+ import { cachePruneCommand } from "./cachePrune.js";
13
+ const COMMANDS = [
14
+ cacheClearCommand(),
15
+ cacheDeleteCommand(),
16
+ cachePruneCommand(),
17
+ ];
18
+ function serialize(command) {
19
+ const colon = command.commandName.indexOf(":");
20
+ return {
21
+ commandName: command.commandName,
22
+ namespace: colon === -1 ? null : command.commandName.slice(0, colon),
23
+ description: command.description,
24
+ help: command.help,
25
+ aliases: [],
26
+ options: { ...command.options },
27
+ args: command.args ?? [],
28
+ flags: command.flags ?? [],
29
+ };
30
+ }
31
+ export async function getMetaData() {
32
+ return COMMANDS.map(serialize);
33
+ }
34
+ export async function getCommand(metadata) {
35
+ return (COMMANDS.find((command) => command.commandName === metadata.commandName) ??
36
+ null);
37
+ }
38
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,QAAQ,GAAgC;IAC7C,iBAAiB,EAAE;IACnB,kBAAkB,EAAE;IACpB,iBAAiB,EAAE;CACnB,CAAC;AAcF,SAAS,SAAS,CAAC,OAAyB;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO;QACN,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QACpE,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;KAC1B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAChC,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,QAAyB;IAEzB,OAAO,CACN,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,CAAC;QACxE,IAAI,CACJ,CAAC;AACH,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * What the three cache commands share: reaching the store they were given,
3
+ * and asking before they touch a production cache.
4
+ */
5
+ import type { CacheManager } from "../CacheManager.js";
6
+ import type { CommandLogger, CommandPrompt } from "./contract.js";
7
+ /**
8
+ * The store a command names, or the default one — `undefined` after reporting
9
+ * why there is none, so the command can stop with a non-zero exit.
10
+ */
11
+ export declare function resolveStore(name: string | undefined, logger: CommandLogger): CacheManager | undefined;
12
+ /** A yes from the operator; a prompt that cannot be answered is a no. */
13
+ export declare function consent(prompt: CommandPrompt, question: string): Promise<boolean>;
14
+ //# sourceMappingURL=store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/console/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,aAAa,GACnB,YAAY,GAAG,SAAS,CAkB1B;AAED,yEAAyE;AACzE,wBAAsB,OAAO,CAC5B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAMlB"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * What the three cache commands share: reaching the store they were given,
3
+ * and asking before they touch a production cache.
4
+ */
5
+ import { getCache } from "../services/main.js";
6
+ /**
7
+ * The store a command names, or the default one — `undefined` after reporting
8
+ * why there is none, so the command can stop with a non-zero exit.
9
+ */
10
+ export function resolveStore(name, logger) {
11
+ const cache = getCache();
12
+ if (cache === undefined) {
13
+ // Naming the wiring beats a stack trace out of the service proxy: the
14
+ // usual cause is a project that never added the provider.
15
+ logger.error("No cache is configured. Add `() => import('@c9up/echo/provider')` to the providers in reamrc.ts.");
16
+ return undefined;
17
+ }
18
+ try {
19
+ return cache.use(name);
20
+ }
21
+ catch {
22
+ logger.error(`"${name ?? "default"}" is not a valid cache store. Double check config/cache.ts file`);
23
+ return undefined;
24
+ }
25
+ }
26
+ /** A yes from the operator; a prompt that cannot be answered is a no. */
27
+ export async function consent(prompt, question) {
28
+ try {
29
+ return await prompt.confirm(question);
30
+ }
31
+ catch {
32
+ return false;
33
+ }
34
+ }
35
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/console/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC3B,IAAwB,EACxB,MAAqB;IAErB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,sEAAsE;QACtE,0DAA0D;QAC1D,MAAM,CAAC,KAAK,CACX,kGAAkG,CAClG,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACJ,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,CAAC,KAAK,CACX,IAAI,IAAI,IAAI,SAAS,iEAAiE,CACtF,CAAC;QACF,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,MAAqB,EACrB,QAAgB;IAEhB,IAAI,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}
@@ -4,9 +4,43 @@
4
4
  * as the L1 tier of {@link TieredDriver}.
5
5
  */
6
6
  import type { CacheEntry, DriverSetOptions, TaggableDriver } from "../types.js";
7
+ export interface MemoryDriverOptions {
8
+ /** How often expired entries are swept, in milliseconds (default 60 000). */
9
+ sweepIntervalMs?: number;
10
+ /**
11
+ * How many entries the store holds before it evicts the least recently
12
+ * used. Default 1000, as upstream; `0` or `Infinity` for no ceiling.
13
+ */
14
+ maxItems?: number;
15
+ /**
16
+ * Total size of the stored values, in bytes or as `'10mb'`; past it the
17
+ * least recently used entries go. Needs `serialize`, since it measures
18
+ * the JSON.
19
+ */
20
+ maxSize?: number | string;
21
+ /**
22
+ * Largest single value, in bytes or as `'1mb'`. A bigger one is not
23
+ * stored, and the key's previous value goes with it. Defaults to
24
+ * `maxSize` when that is set, and a value over `maxSize` is never stored
25
+ * whatever this says. Needs `serialize`.
26
+ */
27
+ maxEntrySize?: number | string;
28
+ /**
29
+ * Store values as JSON and hand out a fresh copy on every read (default).
30
+ *
31
+ * `false` keeps the caller's object and returns that same reference, which
32
+ * is faster and keeps class instances, Dates and Maps intact — but any
33
+ * reader that mutates what it got rewrites the value for every later one.
34
+ */
35
+ serialize?: boolean;
36
+ }
7
37
  export declare class MemoryDriver implements TaggableDriver {
8
38
  #private;
9
- constructor(sweepIntervalMs?: number, maxItems?: number);
39
+ /**
40
+ * @param options the options, or the sweep interval in milliseconds (the
41
+ * original positional form, kept with `maxItems` beside it).
42
+ */
43
+ constructor(options?: MemoryDriverOptions | number, maxItems?: number);
10
44
  /**
11
45
  * Drop expired entries now, without waiting for the sweep (bentocache
12
46
  * `prune`). Useful before measuring size, or in a test that must not depend
@@ -23,6 +57,8 @@ export declare class MemoryDriver implements TaggableDriver {
23
57
  getEntry<T = unknown>(key: string): Promise<CacheEntry<T> | null>;
24
58
  /** Synchronous read used by both `get` and `getEntry` (and by TieredDriver's L1 fast path). */
25
59
  getEntrySync<T = unknown>(key: string): CacheEntry<T> | null;
60
+ /** How many tags the index holds — what bounds its memory, for diagnostics. */
61
+ tagCount(): number;
26
62
  set(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
27
63
  setEntry(key: string, value: unknown, options: DriverSetOptions): Promise<void>;
28
64
  delete(key: string): Promise<boolean>;
@@ -1 +1 @@
1
- {"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAWhF,qBAAa,YAAa,YAAW,cAAc;;gBAetC,eAAe,SAAS,EAAE,QAAQ,SAAI;IA2ClD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,IAAI,IAAI;IAIT,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAMhD,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIvE,+FAA+F;IAC/F,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IA0EtD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,qEAAqE;IAC/D,WAAW,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAIhB,gEAAgE;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhD,gDAAgD;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}
1
+ {"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IACnC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AA0BD,qBAAa,YAAa,YAAW,cAAc;;IA8BlD;;;OAGG;gBACS,OAAO,GAAE,mBAAmB,GAAG,MAAW,EAAE,QAAQ,CAAC,EAAE,MAAM;IA2EzE;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,IAAI,IAAI;IAIT,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAMhD,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIvE,+FAA+F;IAC/F,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAqD5D,+EAA+E;IAC/E,QAAQ,IAAI,MAAM;IAoFZ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC;IAWV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,qEAAqE;IAC/D,WAAW,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAIhB,gEAAgE;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAehD,gDAAgD;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}