datastore-api 2.0.1 → 2.2.0

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.
@@ -1,567 +0,0 @@
1
- "use strict";
2
- /*
3
- * dstore.ts - Datastore Compatibility layer
4
- * Try to get a smoother api for transactions and such.
5
- * A little bit inspired by the Python2 ndb interface.
6
- *
7
- * In future https://github.com/graphql/dataloader might be used for batching.
8
- *
9
- * Created by Dr. Maximillian Dornseif 2021-12-05 in huwawi3backend 11.10.0
10
- * Copyright (c) 2021, 2022 Dr. Maximillian Dornseif
11
- */
12
- var __importDefault = (this && this.__importDefault) || function (mod) {
13
- return (mod && mod.__esModule) ? mod : { "default": mod };
14
- };
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.DstoreError = exports.Dstore = exports.KEYSYM = exports.Transaction = exports.Query = exports.Key = exports.Datastore = void 0;
17
- const async_hooks_1 = require("async_hooks");
18
- const promises_1 = require("timers/promises");
19
- const datastore_1 = require("@google-cloud/datastore");
20
- const entity_1 = require("@google-cloud/datastore/build/src/entity");
21
- const assertate_1 = require("assertate");
22
- const debug_1 = __importDefault(require("debug"));
23
- const prom_client_1 = __importDefault(require("prom-client"));
24
- /** @ignore */
25
- var datastore_2 = require("@google-cloud/datastore");
26
- Object.defineProperty(exports, "Datastore", { enumerable: true, get: function () { return datastore_2.Datastore; } });
27
- Object.defineProperty(exports, "Key", { enumerable: true, get: function () { return datastore_2.Key; } });
28
- Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return datastore_2.Query; } });
29
- Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return datastore_2.Transaction; } });
30
- /** @ignore */
31
- const debug = (0, debug_1.default)('ds:api');
32
- /** @ignore */
33
- const transactionAsyncLocalStorage = new async_hooks_1.AsyncLocalStorage();
34
- /** @ignore */
35
- const metricHistogram = new prom_client_1.default.Histogram({
36
- name: 'dstore_requests_seconds',
37
- help: 'How long did Datastore operations take?',
38
- labelNames: ['operation'],
39
- });
40
- const metricFailureCounter = new prom_client_1.default.Counter({
41
- name: 'dstore_failures_total',
42
- help: 'How many Datastore operations failed?',
43
- labelNames: ['operation'],
44
- });
45
- /** Use instead of Datastore.KEY
46
- *
47
- * Even better: use `_key` instead.
48
- */
49
- exports.KEYSYM = datastore_1.Datastore.KEY;
50
- /** Dstore implements a slightly more accessible version of the [Google Cloud Datastore: Node.js Client](https://cloud.google.com/nodejs/docs/reference/datastore/latest)
51
-
52
- [@google-cloud/datastore](https://github.com/googleapis/nodejs-datastore#readme) is a strange beast: [The documentation is auto generated](https://cloud.google.com/nodejs/docs/reference/datastore/latest) and completely shy of documenting any advanced concepts.
53
- (Example: If you ask the datastore to auto-generate keys during save: how do you retrieve the generated key?) Generally I suggest to look at the Python 2.x [db](https://cloud.google.com/appengine/docs/standard/python/datastore/api-overview) and [ndb](https://cloud.google.com/appengine/docs/standard/python/ndb) documentation to get a better explanation of the workings of the datastore.
54
-
55
- Also the typings are strange. The Google provided type `Entities` can be the on disk representation, the same but including a key reference (`Datastore.KEY` - [[IDstoreEntry]]), a list of these or a structured object containing the on disk representation under the `data` property and a `key` property and maybe some configuration like `excludeFromIndexes` ([[DstoreSaveEntity]]) or a list of these.
56
-
57
- KvStore tries to abstract away most surprises the datastore provides to you but als tries to stay as API compatible as possible to [@google-cloud/datastore](https://github.com/googleapis/nodejs-datastore).
58
-
59
- Main differences:
60
-
61
- - Everything asynchronous is Promise-based - no callbacks.
62
- - [[get]] always returns a single [[IDstoreEntry]].
63
- - [[getMulti]] always returns an Array<[[IDstoreEntry]]> of the same length as the input Array. Items not found are represented by null.
64
- - [[set]] is called with `(key, value)` and always returns the complete [[Key]] of the entity being written. Keys are normalized, numeric IDs are always encoded as strings.
65
- - [[key]] handles [[Key]] object instantiation for you.
66
- - [[readKey]] extracts the key from an [[IDstoreEntry]] you have read without the need of fancy `Symbol`-based access to `entity[Datastore.KEY]`. If needed, it tries to deserialize `_keyStr` to create `entity[Datastore.KEY]`. This ist important when rehydrating an [[IDstoreEntry]] from a serializing cache.
67
- - [[allocateOneId]] returns a single numeric string encoded unique datastore id without the need of fancy unpacking.
68
- - [[runInTransaction]] allows you to provide a function to be executed inside an transaction without the need of passing around the transaction object. This is modelled after Python 2.7 [ndb's `@ndb.transactional` feature](https://cloud.google.com/appengine/docs/standard/python/ndb/transactions). This is implemented via node's [AsyncLocalStorage](https://nodejs.org/docs/latest-v14.x/api/async_hooks.html).
69
- - [[keySerialize]] is synchronous.
70
-
71
- This documentation also tries to document the little known idiosyncrasies of the [@google-cloud/datastore](https://github.com/googleapis/nodejs-datastore) library. See the corresponding functions.
72
- */
73
- class Dstore {
74
- /** Generate a Dstore instance for a specific [[Datastore]] instance.
75
-
76
- ```
77
- const dstore = Dstore(new Datastore())
78
- ```
79
-
80
- You are encouraged to provide the second parameter to provide the ProjectID. This makes [[keySerialize]] more robust. Usually you can get this from the Environment:
81
-
82
- ```
83
- const dstore = Dstore(new Datastore(), process.env.GCLOUD_PROJECT)
84
-
85
- @param datastore A [[Datastore]] instance. Can be freely accessed by the client. Be aware that using this inside [[runInTransaction]] ignores the transaction.
86
- @param projectId The `GCLOUD_PROJECT ID`. Used for Key generation during serialization.
87
- ```
88
- */
89
- constructor(datastore, projectId, logger) {
90
- this.datastore = datastore;
91
- this.projectId = projectId;
92
- this.logger = logger;
93
- this.urlSaveKey = new entity_1.entity.URLSafeKey();
94
- (0, assertate_1.assertIsObject)(datastore);
95
- }
96
- /** Gets the Datastore or the current Transaction. */
97
- getDoT() {
98
- return (transactionAsyncLocalStorage.getStore() || this.datastore);
99
- }
100
- /** `key()` creates a [[Key]] Object from a path.
101
- *
102
- * Compatible to [Datastore.key](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_key_member_1_)
103
- *
104
- * If the Path has an odd number of elements, it is considered an incomplete Key. This can only be used for saving and will prompt the Datastore to auto-generate an (random) ID. See also [[save]].
105
- *
106
- * @category Datastore Drop-In
107
- */
108
- key(path) {
109
- return this.datastore.key(path);
110
- }
111
- /** `keyFromSerialized()` serializes [[Key]] to a string.
112
- *
113
- * Compatible to [keyToLegacyUrlSafe](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_keyToLegacyUrlSafe_member_1_), but does not support the "locationPrefix" since the use for this parameter is undocumented and unknown. It seems to be an artifact from early App Engine days.
114
- *
115
- * It can be a synchronous function because it does not look up the `projectId`. Instead it is assumed, that you give the `projectId` upon instantiation of [[Dstore]]. It also seems, that a wrong `projectId` bears no ill effects.
116
- *
117
- * @category Datastore Drop-In
118
- */
119
- keySerialize(key) {
120
- var _a;
121
- return key ? this.urlSaveKey.legacyEncode((_a = this.projectId) !== null && _a !== void 0 ? _a : '', key) : '';
122
- }
123
- /** `keyFromSerialized()` deserializes a string created with [[keySerialize]] to a [[Key]].
124
- *
125
- * Compatible to [keyFromLegacyUrlsafe](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_keyFromLegacyUrlsafe_member_1_).
126
- *
127
- * @category Datastore Drop-In
128
- */
129
- keyFromSerialized(text) {
130
- return this.urlSaveKey.legacyDecode(text);
131
- }
132
- /** `readKey()` extracts the [[Key]] from an [[IDstoreEntry]].
133
- *
134
- * Is is an alternative to `entity[Datastore.KEY]` which tends to fail in various contexts and also confuses older Typescript compilers.
135
- * It can extract the [[Key]] form a [[IDstoreEntry]] which has been serialized to JSON by leveraging the property `_keyStr`.
136
- *
137
- * @category Additional
138
- */
139
- readKey(ent) {
140
- (0, assertate_1.assertIsObject)(ent);
141
- let ret = ent[datastore_1.Datastore.KEY];
142
- if (ent._keyStr && !ret) {
143
- ret = this.keyFromSerialized(ent._keyStr);
144
- }
145
- (0, assertate_1.assertIsObject)(ret, 'entity[Datastore.KEY]/entity._keyStr', `Entity is missing the datastore Key: ${JSON.stringify(ent)}`);
146
- return ret;
147
- }
148
- /** `fixKeys()` is called for all [[IDstoreEntry]]sa returned from [[Dstore]].
149
- *
150
- * Is ensures that besides `entity[Datastore.KEY]` there is `_keyStr` to be leveraged by [[readKey]].
151
- *
152
- * @internal
153
- */
154
- fixKeys(entities) {
155
- entities.forEach((x) => {
156
- if (!!(x === null || x === void 0 ? void 0 : x[datastore_1.Datastore.KEY]) && x[datastore_1.Datastore.KEY]) {
157
- (0, assertate_1.assertIsDefined)(x[datastore_1.Datastore.KEY]);
158
- (0, assertate_1.assertIsObject)(x[datastore_1.Datastore.KEY]);
159
- // Old TypesScript has problems with symbols as a property
160
- x._keyStr = this.keySerialize(x[datastore_1.Datastore.KEY]);
161
- }
162
- });
163
- return entities;
164
- }
165
- /** `get()` reads a [[IDstoreEntry]] from the Datastore.
166
- *
167
- * It returns [[IDstoreEntry]] or `null` if not found.
168
-
169
- * The underlying Datastore API Call is [lookup](https://cloud.google.com/datastore/docs/reference/data/rest/v1/projects/lookup).
170
- *
171
- * It is in the Spirit of [Datastore.get()]. Unfortunately currently (late 2021) there is no formal documentation from Google on [Datastore.get()].
172
- *
173
- * Differences between [[Dstore.get]] and [[Datastore.get]]:
174
- *
175
- * - [Dstore.get]] takes a single [[Key]] as Parameter, no Array. Check [[getMulti]] if you want Arrays.
176
- * - [Dstore.get]] returns a single [[IDstoreEntry]], no Array.
177
- *
178
- * @category Datastore Drop-In
179
- */
180
- async get(key) {
181
- (0, assertate_1.assertIsObject)(key);
182
- (0, assertate_1.assert)(!Array.isArray(key));
183
- (0, assertate_1.assert)(key.path.length % 2 == 0, `key.path must be complete: ${JSON.stringify(key.path)}`);
184
- const result = await this.getMulti([key]);
185
- return (result === null || result === void 0 ? void 0 : result[0]) || null;
186
- }
187
- /** `getMulti()` reads several [[IDstoreEntry]]s from the Datastore.
188
- *
189
- * It returns a list of [[IDstoreEntry]]s or `undefined` if not found. Entries are in the same Order as the keys in the Parameter.
190
- * This is different from the @google-cloud/datastore where not found items are not present in the result and the order in the result list is undefined.
191
- *
192
- * The underlying Datastore API Call is [lookup](https://cloud.google.com/datastore/docs/reference/data/rest/v1/projects/lookup).
193
- *
194
- * It is in the Spirit of [Datastore.get()]. Unfortunately currently (late 2021) there is no formal documentation from Google on [Datastore.get()].
195
- *
196
- * Differences between [[Dstore.getMulti]] and [[Datastore.get]]:
197
- *
198
- * - [[Dstore.getMulti]] always takes an Array of [[Key]]s as Parameter.
199
- * - [[Dstore.getMulti]] returns always a Array of [[IDstoreEntry]], or null.
200
- * - [[Datastore.get]] has many edge cases - e.g. when not being able to find any of the provided keys - which return surprising results. [[Dstore.getMulti]] always returns an Array. TODO: return a Array with the same length as the Input.
201
- *
202
- * @category Datastore Drop-In
203
- */
204
- async getMulti(keys) {
205
- var _a;
206
- // assertIsArray(keys);
207
- let results;
208
- const metricEnd = metricHistogram.startTimer();
209
- try {
210
- results = this.fixKeys(keys.length > 0
211
- ? (_a = (await this.getDoT().get(keys))) === null || _a === void 0 ? void 0 : _a[0]
212
- : []);
213
- }
214
- catch (error) {
215
- metricFailureCounter.inc({ operation: 'get' });
216
- await (0, promises_1.setImmediate)();
217
- throw new DstoreError('datastore.getMulti error', error, { keys });
218
- }
219
- finally {
220
- metricEnd({ operation: 'get' });
221
- }
222
- // Sort resulting entities by the keys they were requested with.
223
- (0, assertate_1.assertIsArray)(results);
224
- const entities = results;
225
- const entitiesByKey = {};
226
- entities.forEach((entity) => {
227
- entitiesByKey[JSON.stringify(entity[datastore_1.Datastore.KEY])] = entity;
228
- });
229
- return keys.map((key) => entitiesByKey[JSON.stringify(key)] || null);
230
- }
231
- /** `set()` is addition to [[Datastore]]. It provides a classic Key-value Interface.
232
- *
233
- * Instead providing a nested [[DstoreSaveEntity]] to [[save]] you can call set directly as `set( key, value)`.
234
- * Observe that set takes a [[Key]] as first parameter. you call it like this;
235
- *
236
- * ```js
237
- * const ds = Dstore()
238
- * ds.set(ds.key('kind', '123'), {props1: 'foo', prop2: 'bar'})
239
- * ```
240
- *
241
- * It returns the [[Key]] of the Object being written.
242
- * If the Key provided was an incomplete [[Key]] it will return a completed [[Key]].
243
- * See [[save]] for more information on key generation.
244
- *
245
- * @category Additional
246
- */
247
- async set(key, data) {
248
- (0, assertate_1.assertIsObject)(key);
249
- (0, assertate_1.assertIsObject)(data);
250
- const saveEntity = { key, data };
251
- await this.save([saveEntity]);
252
- return saveEntity.key;
253
- }
254
- /** `save()` is compatible to [Datastore.save()](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_save_member_1_).
255
- *
256
- * The single Parameter is a list of [[DstoreSaveEntity]]s.
257
- * If called within a transaction it returns `undefined`.
258
- * If not, it returns a [[CommitResponse]] which is not documented by Google.
259
- *
260
- * Different [DstoreSaveEntity]]s in the `entities` parameter can have different values in their [[DstoreSaveEntity.method]] property.
261
- * This allows you to do `insert`, `update` and `upsert` (the default) in a single request.
262
- *
263
- * `save()` seems to basically be an alias to [upsert](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_upsert_member_1_).
264
- *
265
- * If the [[Key]] provided in [[DstoreSaveEntity.key]] was an incomplete [[Key]] it will be updated by `save()` inside the [[DstoreSaveEntity]].
266
- *
267
- * If the Datastore generates a new ID because of an incomplete [[Key]] *on first save* it will return an large integer as [[Key.id]].
268
- * On every subsequent `save()` an string encoded number representation is returned.
269
- * @todo Dstore should normalizes that and always return an string encoded number representation.
270
- *
271
- * Each [[DstoreSaveEntity]] can have an `excludeFromIndexes` property which is somewhat underdocumented.
272
- * It can use something like JSON-Path notation
273
- * ([Source](https://github.com/googleapis/nodejs-datastore/blob/2941f2f0f132b41534e303d441d837051ce88fd7/src/index.ts#L948))
274
- * [.*](https://github.com/googleapis/nodejs-datastore/blob/406b15d2014087172df617c6e0a397a2c0902c5f/test/index.ts#L1598),
275
- * [parent[]](https://github.com/googleapis/nodejs-datastore/blob/406b15d2014087172df617c6e0a397a2c0902c5f/test/index.ts#L1672),
276
- * [parent.*](https://github.com/googleapis/nodejs-datastore/blob/406b15d2014087172df617c6e0a397a2c0902c5f/test/index.ts#L1672),
277
- * [parent[].*](https://github.com/googleapis/nodejs-datastore/blob/406b15d2014087172df617c6e0a397a2c0902c5f/test/index.ts#L1672)
278
- * and [more complex patterns](https://github.com/googleapis/nodejs-datastore/blob/406b15d2014087172df617c6e0a397a2c0902c5f/test/index.ts#L1754)
279
- * seem to be supported patterns.
280
- *
281
- * If the caller has not provided an `excludeLargeProperties` in a [[DstoreSaveEntity]] we will default it
282
- * to `excludeLargeProperties: true`. Without this you can not store strings longer than 1500 bytes easily
283
- * ([source](https://github.com/googleapis/nodejs-datastore/blob/c7a08a8382c6706ccbfbbf77950babf40bac757c/src/entity.ts#L961)).
284
- *
285
- * @category Datastore Drop-In
286
- */
287
- async save(entities) {
288
- (0, assertate_1.assertIsArray)(entities);
289
- let ret;
290
- const metricEnd = metricHistogram.startTimer();
291
- try {
292
- // Within Transaction we don't get any answer here!
293
- // [ { mutationResults: [ [Object], [Object] ], indexUpdates: 51 } ]
294
- for (const e of entities) {
295
- (0, assertate_1.assertIsObject)(e.key);
296
- (0, assertate_1.assertIsObject)(e.data);
297
- this.fixKeys([e.data]);
298
- e.excludeLargeProperties =
299
- e.excludeLargeProperties === undefined
300
- ? true
301
- : e.excludeLargeProperties;
302
- }
303
- ret = (await this.getDoT().save(entities)) || undefined;
304
- for (const e of entities) {
305
- e.data[datastore_1.Datastore.KEY] = e.key;
306
- this.fixKeys([e.data]);
307
- }
308
- }
309
- catch (error) {
310
- metricFailureCounter.inc({ operation: 'save' });
311
- await (0, promises_1.setImmediate)();
312
- throw new DstoreError('datastore.save error', error);
313
- }
314
- finally {
315
- metricEnd({ operation: 'save' });
316
- }
317
- return ret;
318
- }
319
- /** `insert()` is compatible to [Datastore.insert()](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_insert_member_1_).
320
- *
321
- * The single Parameter is a list of [[DstoreSaveEntity]]s.
322
- * If called within a transaction it returns `undefined`.
323
- * If not, it returns a [[CommitResponse]] which is not documented by Google.
324
- *
325
- * `insert()` seems to be like [[save]] where [[DstoreSaveEntity.method]] is set to `'insert'`. It throws an [[DstoreError]] if there is already a Entity with the same [[Key]] in the Datastore.
326
- *
327
- * For handling of incomplete [[Key]]s see [[save]].
328
- *
329
- * This function can be completely emulated by using [[save]] with `method: 'insert'` inside each [[DstoreSaveEntity]].
330
- *
331
- * @throws [[DstoreError]]
332
- * @category Datastore Drop-In
333
- */
334
- async insert(entities) {
335
- (0, assertate_1.assertIsArray)(entities);
336
- let ret;
337
- const metricEnd = metricHistogram.startTimer();
338
- try {
339
- ret = (await this.getDoT().insert(entities)) || undefined;
340
- }
341
- catch (error) {
342
- // console.error(error)
343
- metricFailureCounter.inc({ operation: 'insert' });
344
- await (0, promises_1.setImmediate)();
345
- throw new DstoreError('datastore.insert error', error);
346
- }
347
- finally {
348
- metricEnd({ operation: 'insert' });
349
- }
350
- return ret;
351
- }
352
- /** `update()` is compatible to [Datastore.update()](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_update_member_1_).
353
-
354
- * The single Parameter is a list of [[DstoreSaveEntity]]s.
355
- * If called within a transaction it returns `undefined`.
356
- * If not, it returns a [[CommitResponse]] which is not documented by Google.
357
- *
358
- * `update()` seems to be like [[save]] where [[DstoreSaveEntity.method]] is set to `'update'`.
359
- * It throws an [[DstoreError]] if there is no Entity with the same [[Key]] in the Datastore. `update()` *overwrites all existing data* for that [[Key]].
360
- * There was an alpha functionality called `merge()` in the Datastore which read an Entity, merged it with the new data and wrote it back, but this was never documented.
361
- *
362
- * `update()` is idempotent. Updating the same [[Key]] twice is no error.
363
- *
364
- * This function can be completely emulated by using [[save]] with `method: 'update'` inside each [[DstoreSaveEntity]].
365
- *
366
- * @throws [[DstoreError]]
367
- * @category Datastore Drop-In
368
- */
369
- async update(entities) {
370
- (0, assertate_1.assertIsArray)(entities);
371
- entities.forEach((entity) => (0, assertate_1.assertIsObject)(entity.key));
372
- entities.forEach((entity) => (0, assertate_1.assert)(entity.key.path.length % 2 == 0, `entity.key.path must be complete: ${JSON.stringify([
373
- entity.key.path,
374
- entity,
375
- ])}`));
376
- let ret;
377
- const metricEnd = metricHistogram.startTimer();
378
- try {
379
- ret = (await this.getDoT().update(entities)) || undefined;
380
- }
381
- catch (error) {
382
- // console.error(error)
383
- metricFailureCounter.inc({ operation: 'update' });
384
- await (0, promises_1.setImmediate)();
385
- throw new DstoreError('datastore.update error', error);
386
- }
387
- finally {
388
- metricEnd({ operation: 'update' });
389
- }
390
- return ret;
391
- }
392
- /** `delete()` is compatible to [Datastore.delete()].
393
- *
394
- * Unfortunately currently (late 2021) there is no formal documentation from Google on [Datastore.delete()].
395
- *
396
- * The single Parameter is a list of [[Key]]s.
397
- * If called within a transaction it returns `undefined`.
398
- * If not, it returns a [[CommitResponse]] which is not documented by Google.
399
- *
400
- * `delete()` is idempotent. Deleting the same [[Key]] twice is no error.
401
- *
402
- * @throws [[DstoreError]]
403
- * @category Datastore Drop-In
404
- */
405
- async delete(keys) {
406
- (0, assertate_1.assertIsArray)(keys);
407
- keys.forEach((key) => (0, assertate_1.assertIsObject)(key));
408
- keys.forEach((key) => (0, assertate_1.assert)(key.path.length % 2 == 0, `key.path must be complete: ${JSON.stringify(key.path)}`));
409
- let ret;
410
- const metricEnd = metricHistogram.startTimer();
411
- try {
412
- ret = (await this.getDoT().delete(keys)) || undefined;
413
- }
414
- catch (error) {
415
- metricFailureCounter.inc({ operation: 'delete' });
416
- await (0, promises_1.setImmediate)();
417
- throw new DstoreError('datastore.delete error', error);
418
- }
419
- finally {
420
- metricEnd({ operation: 'delete' });
421
- }
422
- return ret;
423
- }
424
- /** `createQuery()` creates an "empty" [[Query]] Object.
425
- *
426
- * Compatible to [createQuery](https://cloud.google.com/nodejs/docs/reference/datastore/latest/datastore/datastore#_google_cloud_datastore_Datastore_createQuery_member_1_) in the datastore.
427
- *
428
- * @param kind Name of the [[Datastore]][Kind](https://cloud.google.com/datastore/docs/concepts/entities#kinds_and_identifiers) ("Table") which should be searched.
429
- *
430
- * @category Datastore Drop-In
431
- */
432
- createQuery(kind) {
433
- try {
434
- return this.getDoT().createQuery(kind);
435
- }
436
- catch (error) {
437
- throw new DstoreError('datastore.createQuery error', error);
438
- }
439
- }
440
- async runQuery(query) {
441
- let ret;
442
- const metricEnd = metricHistogram.startTimer();
443
- try {
444
- const [entities, info] = await this.getDoT().runQuery(query);
445
- ret = [this.fixKeys(entities), info];
446
- }
447
- catch (error) {
448
- await (0, promises_1.setImmediate)();
449
- throw new DstoreError('datastore.runQuery error', error);
450
- }
451
- finally {
452
- metricEnd({ operation: 'query' });
453
- }
454
- return ret;
455
- }
456
- async query(kindName, filters = [], limit = 2500, ordering = [], selection = [], cursor) {
457
- (0, assertate_1.assertIsString)(kindName);
458
- (0, assertate_1.assertIsArray)(filters);
459
- (0, assertate_1.assertIsNumber)(limit);
460
- try {
461
- const q = this.createQuery(kindName);
462
- for (const filterSpec of filters) {
463
- q.filter(...filterSpec);
464
- }
465
- for (const orderField of ordering) {
466
- q.order(orderField);
467
- }
468
- if (limit > 0) {
469
- q.limit(limit);
470
- }
471
- if (selection.length > 0) {
472
- q.select(selection);
473
- }
474
- return await this.runQuery(q);
475
- }
476
- catch (error) {
477
- await (0, promises_1.setImmediate)();
478
- throw new DstoreError('datastore.query error', error, {
479
- kindName,
480
- filters,
481
- limit,
482
- ordering,
483
- });
484
- }
485
- }
486
- /** Allocate one ID in the Datastore.
487
- *
488
- * Currently (late 2021) there is no documentation provided by Google for the underlying node function.
489
- * Check the Documentation for [the low-level function](https://cloud.google.com/datastore/docs/reference/data/rest/v1/projects/allocateIds)
490
- * and [the conceptual overview](https://cloud.google.com/datastore/docs/concepts/entities#assigning_your_own_numeric_id)
491
- * and [this Stackoverflow post](https://stackoverflow.com/questions/60516959/how-does-allocateids-work-in-cloud-datastore-mode).
492
- *
493
- * The ID is a string encoded large number. This function will never return the same ID twice for any given Datastore.
494
- * If you provide a kindName the ID will be namespaced to this kind.
495
- * In fact the generated ID is namespaced via an incomplete [[Key]] of the given Kind.
496
- */
497
- async allocateOneId(kindName = 'Numbering') {
498
- (0, assertate_1.assertIsString)(kindName);
499
- const ret = (await this.datastore.allocateIds(this.key([kindName]), 1))[0][0].id;
500
- (0, assertate_1.assertIsString)(ret);
501
- return ret;
502
- }
503
- /** This tries to give high level access to transactions.
504
-
505
- So called "Gross Group Transactions" are always enabled. Transactions are never Cross Project. `runInTransaction()` works only if you use the same [[KvStore] instance for all access within the Transaction.
506
-
507
- [[runInTransaction]] is modelled after Python 2.7 [ndb's `@ndb.transactional` feature](https://cloud.google.com/appengine/docs/standard/python/ndb/transactions). This is based on node's [AsyncLocalStorage](https://nodejs.org/docs/latest-v14.x/api/async_hooks.html).
508
-
509
- Transactions frequently fail if you try to access the same data via in a transaction. See the [Documentation on Locking](https://cloud.google.com/datastore/docs/concepts/transactions#transaction_locks) for further reference. You are advised to use [p-limit](https://github.com/sindresorhus/p-limit)(1) to serialize transactions touching the same resource. This should work nicely with node's single process model. It is a much bigger problem on shared-nothing approaches, like Python on App Engine.
510
-
511
- Transactions might be wrapped in [p-retry](https://github.com/sindresorhus/p-retry) to implement automatically retrying them with exponential back-off should they fail due to contention.
512
-
513
- Be aware that Transactions differ considerable between Master-Slave Datastore (very old), High Replication Datastore (old, later called [Google Cloud Datastore](https://cloud.google.com/datastore/docs/concepts/cloud-datastore-transactions)) and [Firestore in Datastore Mode](https://cloud.google.com/datastore/docs/firestore-or-datastore#in_datastore_mode) (current).
514
-
515
- Most Applications today are running on "Firestore in Datastore Mode". Beware that the Datastore-Emulator fails with `error: 3 INVALID_ARGUMENT: Only ancestor queries are allowed inside transactions.` during [[runQuery]] while the Datastore on Google Infrastructure does not have such an restriction anymore as of 2022.
516
- */
517
- async runInTransaction(func) {
518
- let ret;
519
- const transaction = this.datastore.transaction();
520
- await transactionAsyncLocalStorage.run(transaction, async () => {
521
- const [transactionInfo, transactionRunApiResponse] = await transaction.run();
522
- let commitApiResponse;
523
- try {
524
- ret = await func();
525
- }
526
- catch (error) {
527
- const rollbackInfo = await transaction.rollback();
528
- debug('Transaction failed, rollback initiated: %O %O %O %O', transactionInfo, transactionRunApiResponse, rollbackInfo, error);
529
- await (0, promises_1.setImmediate)();
530
- throw new DstoreError('datastore.transaction execution error', error);
531
- }
532
- try {
533
- commitApiResponse = await transaction.commit()[0];
534
- }
535
- catch (error) {
536
- debug('Transaction commit failed: %O %O %O %O ret: %O', transactionInfo, transactionRunApiResponse, commitApiResponse, error, ret);
537
- await (0, promises_1.setImmediate)();
538
- throw new DstoreError('datastore.transaction execution error', error);
539
- }
540
- });
541
- return ret;
542
- }
543
- }
544
- exports.Dstore = Dstore;
545
- class DstoreError extends Error {
546
- constructor(message, originalError, extensions) {
547
- var _a, _b, _c, _d, _e, _f, _g;
548
- super(`${message}: ${originalError === null || originalError === void 0 ? void 0 : originalError.message}`);
549
- // if no name provided, use the default. defineProperty ensures that it stays non-enumerable
550
- if (!this.name) {
551
- Object.defineProperty(this, 'name', { value: 'DstoreError' });
552
- }
553
- // metadata: Metadata { internalRepr: Map(0) {}, options: {} },
554
- this.originalError = originalError;
555
- this.extensions = Object.assign({}, extensions);
556
- this.stack =
557
- (((_a = this.stack) === null || _a === void 0 ? void 0 : _a.split('\n')[0]) || '') +
558
- '\n' +
559
- (((_d = (_c = (_b = originalError === null || originalError === void 0 ? void 0 : originalError.stack) === null || _b === void 0 ? void 0 : _b.split('\n')) === null || _c === void 0 ? void 0 : _c.slice(1)) === null || _d === void 0 ? void 0 : _d.join('\n')) || '') +
560
- '\n' +
561
- (((_g = (_f = (_e = this.stack) === null || _e === void 0 ? void 0 : _e.split('\n')) === null || _f === void 0 ? void 0 : _f.slice(1)) === null || _g === void 0 ? void 0 : _g.join('\n')) || '');
562
- // These are usually present on Datastore Errors
563
- // logger.error({ err: originalError, extensions }, message);
564
- }
565
- }
566
- exports.DstoreError = DstoreError;
567
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHN0b3JlLWFwaS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvZHN0b3JlLWFwaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7OztHQVNHOzs7Ozs7QUFFSCw2Q0FBZ0Q7QUFDaEQsOENBQStDO0FBRS9DLHVEQU1pQztBQUNqQyxxRUFBMEU7QUFPMUUseUNBT21CO0FBQ25CLGtEQUEwQjtBQUMxQiw4REFBcUM7QUFHckMsY0FBYztBQUNkLHFEQU1pQztBQUwvQixzR0FBQSxTQUFTLE9BQUE7QUFDVCxnR0FBQSxHQUFHLE9BQUE7QUFFSCxrR0FBQSxLQUFLLE9BQUE7QUFDTCx3R0FBQSxXQUFXLE9BQUE7QUFHYixjQUFjO0FBQ2QsTUFBTSxLQUFLLEdBQUcsSUFBQSxlQUFLLEVBQUMsUUFBUSxDQUFDLENBQUM7QUFFOUIsY0FBYztBQUNkLE1BQU0sNEJBQTRCLEdBQUcsSUFBSSwrQkFBaUIsRUFBRSxDQUFDO0FBRTdELGNBQWM7QUFDZCxNQUFNLGVBQWUsR0FBRyxJQUFJLHFCQUFVLENBQUMsU0FBUyxDQUFDO0lBQy9DLElBQUksRUFBRSx5QkFBeUI7SUFDL0IsSUFBSSxFQUFFLHlDQUF5QztJQUMvQyxVQUFVLEVBQUUsQ0FBQyxXQUFXLENBQUM7Q0FDMUIsQ0FBQyxDQUFDO0FBQ0gsTUFBTSxvQkFBb0IsR0FBRyxJQUFJLHFCQUFVLENBQUMsT0FBTyxDQUFDO0lBQ2xELElBQUksRUFBRSx1QkFBdUI7SUFDN0IsSUFBSSxFQUFFLHVDQUF1QztJQUM3QyxVQUFVLEVBQUUsQ0FBQyxXQUFXLENBQUM7Q0FDMUIsQ0FBQyxDQUFDO0FBRUg7OztHQUdHO0FBQ1UsUUFBQSxNQUFNLEdBQUcscUJBQVMsQ0FBQyxHQUFHLENBQUM7QUF3RnBDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0VBc0JFO0FBQ0YsTUFBYSxNQUFNO0lBR2pCOzs7Ozs7Ozs7Ozs7OztNQWNFO0lBQ0YsWUFDVyxTQUFvQixFQUNwQixTQUFr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
@@ -1 +0,0 @@
1
- export {};