@tryghost/limit-service 1.3.1 → 1.3.2
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.
- package/README.md +1 -1
- package/lib/limit.js +6 -47
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -158,7 +158,7 @@ db.transaction((transacting) => {
|
|
|
158
158
|
|
|
159
159
|
### Types of limits
|
|
160
160
|
At the moment there are four different types of limits that limit service allows to define. These types are:
|
|
161
|
-
1. `flag` - is an "on/off" switch for certain feature. Example use case: "disable all emails". It's identified by a `disabled: true` property in the "limits" configuration.
|
|
161
|
+
1. `flag` - is an "on/off" switch for certain feature. Example use case: "disable all emails". It's identified by a `disabled: true` property in the "limits" configuration.
|
|
162
162
|
2. `max` - checks if the maximum amount of the resource has been used up.Example use case: "disable creating a staff user when maximum of 5 has been reached". To configure this limit add `max: NUMBER` to the configuration. The limits that support max checks are: `members`, and `staff`
|
|
163
163
|
3. `maxPeriodic` - it's a variation of `max` type with a difference that the check is done over certain period of time. Example use case: "disable sending emails when the sent emails count has acceded a limit for last billing period". To enable this limit define `maxPeriodic: NUMBER` in the limit configuration and provide a subscription configuration when initializing the limit service instance. The subscription object comes as a separate parameter and has to contain two properties: `startDate` and `interval`, where `startDate` is a date in ISO 8601 format and period is `'month'` (other values like `'year'` are not supported yet)
|
|
164
164
|
4. `allowList` - checks if provided value is defined in configured "allowlist". Example use case: "disable theme activation if it is not an official theme". To configure this limit define ` allowlist: ['VALUE_1', 'VALUE_2', 'VALUE_N']` property in the "limits" parameter.
|
package/lib/limit.js
CHANGED
|
@@ -264,7 +264,6 @@ class FlagLimit extends Limit {
|
|
|
264
264
|
* @param {Number} options.config.disabled - disabled/enabled flag for the limit
|
|
265
265
|
* @param {String} options.config.error - error message to use when limit is reached
|
|
266
266
|
* @param {String} options.helpLink - URL to the resource explaining how the limit works
|
|
267
|
-
* @param {Function} [options.config.currentCountQuery] - query checking the state that would be compared against the limit
|
|
268
267
|
* @param {Object} [options.db] - instance of knex db connection that currentCountQuery can use to run state check through
|
|
269
268
|
* @param {Object} options.errors - instance of errors compatible with GhostError errors (@tryghost/errors)
|
|
270
269
|
*/
|
|
@@ -274,7 +273,6 @@ class FlagLimit extends Limit {
|
|
|
274
273
|
|
|
275
274
|
this.disabled = config.disabled;
|
|
276
275
|
this.fallbackMessage = `Your plan does not support ${userFacingLimitName}. Please upgrade to enable ${userFacingLimitName}.`;
|
|
277
|
-
this.currentCountQueryFn = config?.currentCountQuery || null;
|
|
278
276
|
}
|
|
279
277
|
|
|
280
278
|
generateError() {
|
|
@@ -290,59 +288,20 @@ class FlagLimit extends Limit {
|
|
|
290
288
|
}
|
|
291
289
|
|
|
292
290
|
/**
|
|
293
|
-
*
|
|
294
|
-
* @param {Object} [options.transacting] Transaction to run the count query on
|
|
295
|
-
* @returns {Promise<boolean>} - returns the current count of items that would be compared against the limit
|
|
291
|
+
* Flag limits are on/off so using a feature is always over the limit
|
|
296
292
|
*/
|
|
297
|
-
async
|
|
298
|
-
if (
|
|
299
|
-
return false;
|
|
300
|
-
}
|
|
301
|
-
|
|
302
|
-
return await this.currentCountQueryFn(options.transacting ?? this.db?.knex);
|
|
303
|
-
}
|
|
304
|
-
|
|
305
|
-
// As Flag limits are on/off, we won't check against max values.
|
|
306
|
-
// `errorIfWouldGoOverLimit` and `errorIfIsOverLimit` end up doing the same thing.
|
|
307
|
-
async _isOrWouldOverLimitError(options = {}) {
|
|
308
|
-
if (!this.disabled) {
|
|
309
|
-
return;
|
|
310
|
-
}
|
|
311
|
-
|
|
312
|
-
// If no currentCountQuery is provided, throw error when disabled
|
|
313
|
-
if (!this.currentCountQueryFn || typeof this.currentCountQueryFn !== 'function') {
|
|
293
|
+
async errorIfWouldGoOverLimit() {
|
|
294
|
+
if (this.disabled) {
|
|
314
295
|
throw this.generateError();
|
|
315
296
|
}
|
|
316
|
-
|
|
317
|
-
// If currentCountQuery is provided, check if feature is in use
|
|
318
|
-
const featureInUse = await this.currentCountQuery(options);
|
|
319
|
-
|
|
320
|
-
// Only throw error if feature is NOT in use (allowing grandfathering)
|
|
321
|
-
if (!featureInUse) {
|
|
322
|
-
throw this.generateError();
|
|
323
|
-
}
|
|
324
|
-
}
|
|
325
|
-
|
|
326
|
-
/**
|
|
327
|
-
* Flag limits are usually on/off so using a feature is always over the limit,
|
|
328
|
-
* unless the limit has a currentCountQuery function provided to check if the
|
|
329
|
-
* feature is in use. This is a use case for when we introduce a new limit and
|
|
330
|
-
* customers have already been using this feature. We don't want to take it
|
|
331
|
-
* away from them.
|
|
332
|
-
*/
|
|
333
|
-
async errorIfWouldGoOverLimit(options = {}) {
|
|
334
|
-
await this._isOrWouldOverLimitError(options);
|
|
335
297
|
}
|
|
336
298
|
|
|
337
299
|
/**
|
|
338
300
|
* Flag limits are on/off. They don't necessarily mean the limit wasn't possible to reach
|
|
339
|
-
*
|
|
340
|
-
* feature is in use. This is a use case for when we introduce a new limit and
|
|
341
|
-
* customers have already been using this feature. We don't want to take it
|
|
342
|
-
* away from them.
|
|
301
|
+
* NOTE: this method should not be relied on as it's impossible to check the limit was surpassed!
|
|
343
302
|
*/
|
|
344
|
-
async errorIfIsOverLimit(
|
|
345
|
-
|
|
303
|
+
async errorIfIsOverLimit() {
|
|
304
|
+
return;
|
|
346
305
|
}
|
|
347
306
|
}
|
|
348
307
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tryghost/limit-service",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.2",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
6
|
"url": "git+https://github.com/TryGhost/SDK.git",
|
|
@@ -34,5 +34,5 @@
|
|
|
34
34
|
"lodash": "^4.17.21",
|
|
35
35
|
"luxon": "^1.26.0"
|
|
36
36
|
},
|
|
37
|
-
"gitHead": "
|
|
37
|
+
"gitHead": "abcb7f69994ec865f1c51184744b2401242713ba"
|
|
38
38
|
}
|