@90soft/parse-server-kit 2.6.0 → 2.8.0

package/dist/database/schema.d.ts

@@ -9,6 +9,19 @@ export interface SchemaConfigOptions {
     recreateModifiedFields?: boolean;
     /** Delete fields not in schema. DANGEROUS. Default: false */
     deleteExtraFields?: boolean;
+    /**
+     * Keep indexes that this schema does not describe. Default: `true`.
+     *
+     * `applyAllIndexes()` creates unique, compound, TTL and 2dsphere indexes by
+     * talking to the MongoDB driver directly, which means parse-server's schema
+     * sync has never heard of them. Left to itself it treats an index it cannot
+     * account for as drift and drops it — taking your uniqueness constraints with
+     * it, quietly, on a restart.
+     *
+     * Defaulted to `true` because the alternative loses data integrity by
+     * accident. Requires parse-server 8.3+; older servers ignore it.
+     */
+    keepUnknownIndexes?: boolean;
 }
 /**
  * Creates Parse Server schema configuration from decorator metadata.
@@ -51,5 +64,6 @@ export declare function createSchemaConfig(options?: SchemaConfigOptions): {
     strict: boolean;
     recreateModifiedFields: boolean;
     deleteExtraFields: boolean;
+    keepUnknownIndexes: boolean;
 };
 //# sourceMappingURL=schema.d.ts.map

package/dist/database/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCnE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCnE"}

package/dist/database/schema.js

@@ -8,7 +8,7 @@ const schemaTypes_1 = require("../decorators/types/schemaTypes");
  * Reads all @ParseClass and @ParseField decorators automatically.
  */
 function createSchemaConfig(options = {}) {
-    const { adminRole = 'SuperAdmin', lockSchemas = false, strict = true, recreateModifiedFields = false, deleteExtraFields = false, } = options;
+    const { adminRole = 'SuperAdmin', lockSchemas = false, strict = true, recreateModifiedFields = false, deleteExtraFields = false, keepUnknownIndexes = true, } = options;
     return {
         definitions: [
             {
@@ -33,6 +33,7 @@ function createSchemaConfig(options = {}) {
         strict,
         recreateModifiedFields,
         deleteExtraFields,
+        keepUnknownIndexes,
     };
 }
 //# sourceMappingURL=schema.js.map

package/dist/database/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":";;AAoBA,gDAkCC;AAtDD,mEAAkE;AAClE,iEAA2D;AAe3D;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,EACJ,SAAS,GAAG,YAAY,EACxB,WAAW,GAAG,KAAK,EACnB,MAAM,GAAG,IAAI,EACb,sBAAsB,GAAG,KAAK,EAC9B,iBAAiB,GAAG,KAAK,GAC1B,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,WAAW,EAAE;YACX;gBACE,SAAS,EAAE,OAAO;gBAClB,MAAM,EAAE,EAAE;gBACV,qBAAqB,EAAE;oBACrB,IAAI,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACnC,GAAG,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBAClC,KAAK,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACpC,MAAM,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACrC,MAAM,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACrC,MAAM,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACrC,eAAe,EAAE,EAAE;iBACpB;aACF;YACD,GAAG,wBAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;gBAC5B,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACxD,OAAO,IAAA,qCAAmB,EAAC,gBAAgB,CAAC,CAAC;YAC/C,CAAC,CAAC;SACH;QACD,WAAW;QACX,MAAM;QACN,sBAAsB;QACtB,iBAAiB;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":";;AAiCA,gDAoCC;AArED,mEAAkE;AAClE,iEAA2D;AA4B3D;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,EACJ,SAAS,GAAG,YAAY,EACxB,WAAW,GAAG,KAAK,EACnB,MAAM,GAAG,IAAI,EACb,sBAAsB,GAAG,KAAK,EAC9B,iBAAiB,GAAG,KAAK,EACzB,kBAAkB,GAAG,IAAI,GAC1B,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,WAAW,EAAE;YACX;gBACE,SAAS,EAAE,OAAO;gBAClB,MAAM,EAAE,EAAE;gBACV,qBAAqB,EAAE;oBACrB,IAAI,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACnC,GAAG,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBAClC,KAAK,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACpC,MAAM,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACrC,MAAM,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACrC,MAAM,EAAE,EAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,EAAE,IAAI,EAAC;oBACrC,eAAe,EAAE,EAAE;iBACpB;aACF;YACD,GAAG,wBAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;gBAC5B,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACxD,OAAO,IAAA,qCAAmB,EAAC,gBAAgB,CAAC,CAAC;YAC/C,CAAC,CAAC;SACH;QACD,WAAW;QACX,MAAM;QACN,sBAAsB;QACtB,iBAAiB;QACjB,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/database/versionRegistry.d.ts

@@ -0,0 +1,35 @@
+export declare const VersionRegistry: {
+    /** The version field of this class, or nothing if it is not versioned. */
+    fieldFor(className: string): string | undefined;
+    isVersioned(className: string): boolean;
+    /** Every versioned class, for tests and for reporting at boot. */
+    classNames(): string[];
+    /** Told by `createVersionedMongoAdapter`, so `verify` can spot its absence. */
+    markAdapterInstalled(): void;
+    adapterIsInstalled(): boolean;
+    /**
+     * Say so, at boot, if optimistic locking has been asked for but cannot work.
+     *
+     * `@ParseVersionField` does nothing on its own — the guarding lives in the
+     * database adapter. Declare the field, forget the adapter (or run on
+     * Postgres, which this does not support), and every save proceeds unguarded
+     * with no error and no log: the exact shape of failure a lock is supposed to
+     * prevent. This turns that silence into a line in the boot output.
+     *
+     * Called from `CloudFunctionRegistry.initialize()`, which consumers already
+     * run after the server is configured — by then both the models and the
+     * adapter are known.
+     */
+    verify(): void;
+};
+/**
+ * Mark this field as the class's version.
+ *
+ * Applies `@ParseField` itself, so the field is declared once. Nothing else in
+ * the codebase reads or writes it: the adapter increments it on every update,
+ * and refuses an update whose asserted version is no longer the current one.
+ */
+export declare function ParseVersionField(options?: {
+    description?: string;
+}): (target: object, propertyKey: string | symbol) => void;
+//# sourceMappingURL=versionRegistry.d.ts.map

package/dist/database/versionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionRegistry.d.ts","sourceRoot":"","sources":["../../src/database/versionRegistry.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,eAAe;IAC1B,0EAA0E;wBACtD,MAAM,GAAG,MAAM,GAAG,SAAS;2BAIxB,MAAM,GAAG,OAAO;IAIvC,kEAAkE;kBACpD,MAAM,EAAE;IAItB,+EAA+E;4BACvD,IAAI;0BAIN,OAAO;IAI7B;;;;;;;;;;;;OAYG;cACO,IAAI;CAmBf,CAAC;AAoDF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAM,GACnC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAmBxD"}

package/dist/database/versionRegistry.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionRegistry = void 0;
+exports.ParseVersionField = ParseVersionField;
+const parseDecorators_1 = require("../decorators/parseDecorators");
+/**
+ * Optimistic locking, declared on the field rather than written into functions.
+ *
+ * Two people reading the same record and both saving is a lost update: the
+ * second write silently overwrites the first, and neither is told. Guarding
+ * against it in every cloud function means remembering to, every time, forever.
+ *
+ * `@ParseVersionField()` moves the guard under the endpoints. It does three
+ * things:
+ *
+ *   1. declares the field as a normal `Number` on the schema;
+ *   2. records that this class is versioned, and by which field, so the
+ *      database adapter can find it;
+ *   3. makes every object read from the database carry the version it read, so
+ *      a later save asserts it without anybody asking.
+ *
+ * The database then does the checking — see `versionedMongoAdapter.ts`. An
+ * endpoint neither reads nor writes the field.
+ */
+/** Where a class parks its version field until `@ParseClass` names the class. */
+const PENDING_VERSION_FIELD = Symbol.for('fsm:pendingVersionField');
+/** className → the field that carries its version. */
+const versionedClasses = new Map();
+// `@ParseField` runs before `@ParseClass`, so the field is known before the
+// class name is. This hook is where the two meet.
+(0, parseDecorators_1.onClassRegistered)((className, constructor) => {
+    const field = constructor[PENDING_VERSION_FIELD];
+    if (field) {
+        versionedClasses.set(className, field);
+    }
+});
+/** Set once `createVersionedMongoAdapter` has actually built the adapter. */
+let adapterInstalled = false;
+exports.VersionRegistry = {
+    /** The version field of this class, or nothing if it is not versioned. */
+    fieldFor(className) {
+        return versionedClasses.get(className);
+    },
+    isVersioned(className) {
+        return versionedClasses.has(className);
+    },
+    /** Every versioned class, for tests and for reporting at boot. */
+    classNames() {
+        return [...versionedClasses.keys()];
+    },
+    /** Told by `createVersionedMongoAdapter`, so `verify` can spot its absence. */
+    markAdapterInstalled() {
+        adapterInstalled = true;
+    },
+    adapterIsInstalled() {
+        return adapterInstalled;
+    },
+    /**
+     * Say so, at boot, if optimistic locking has been asked for but cannot work.
+     *
+     * `@ParseVersionField` does nothing on its own — the guarding lives in the
+     * database adapter. Declare the field, forget the adapter (or run on
+     * Postgres, which this does not support), and every save proceeds unguarded
+     * with no error and no log: the exact shape of failure a lock is supposed to
+     * prevent. This turns that silence into a line in the boot output.
+     *
+     * Called from `CloudFunctionRegistry.initialize()`, which consumers already
+     * run after the server is configured — by then both the models and the
+     * adapter are known.
+     */
+    verify() {
+        const versioned = this.classNames();
+        if (versioned.length === 0)
+            return;
+        if (!adapterInstalled) {
+            console.warn(`[Versioning] ${versioned.length} class(es) declare @ParseVersionField ` +
+                `(${versioned.join(', ')}), but createVersionedMongoAdapter() was never called. ` +
+                'Optimistic locking is INACTIVE — stale saves will overwrite silently. ' +
+                'Pass the adapter to ParseServer via `databaseAdapter`, and note that ' +
+                'this feature is MongoDB-only.');
+            return;
+        }
+        console.log(`[Versioning] Optimistic locking active on: ${versioned.join(', ')}`);
+    },
+};
+/**
+ * Put the version this copy was read at into the payload of every save.
+ *
+ * A Parse save sends only the fields that changed, and a version nobody touched
+ * is not one of them — so the database would have nothing to check against.
+ *
+ * The hook is the payload rather than the object. Marking the field dirty on
+ * read would work too, but it leaves the object permanently dirty, and Parse
+ * then serializes it as a bare pointer in a cloud function response — every
+ * job in a list would come back as `{__type, className, objectId}` and nothing
+ * else. Building the assertion at save time instead touches no state at all.
+ *
+ * `_getSaveJSON` is what both `save()` and `saveAll()` call to build a request
+ * body, which is why an endpoint never has to do this itself.
+ */
+function assertVersionOnSave(prototype, field) {
+    const inherited = prototype._getSaveJSON;
+    if (typeof inherited !== 'function') {
+        // The one place this feature leans on a Parse SDK internal. If the SDK ever
+        // moves it, locking would quietly stop asserting anything — so say so here
+        // rather than let it degrade in silence.
+        console.warn('[Versioning] Parse.Object.prototype._getSaveJSON not found — this Parse ' +
+            'SDK version is not compatible with @ParseVersionField. Optimistic ' +
+            'locking is INACTIVE for this class; saves will not assert a version.');
+        return;
+    }
+    Object.defineProperty(prototype, '_getSaveJSON', {
+        value: function () {
+            const body = inherited.call(this);
+            // A create has nothing to assert against; the adapter gives it its first
+            // version. An object built from an id rather than read has no version to
+            // assert, and is simply not protected.
+            if (this.id) {
+                const version = this.get(field);
+                if (typeof version === 'number') {
+                    body[field] = version;
+                }
+            }
+            return body;
+        },
+        writable: true,
+        configurable: true,
+    });
+}
+/**
+ * Mark this field as the class's version.
+ *
+ * Applies `@ParseField` itself, so the field is declared once. Nothing else in
+ * the codebase reads or writes it: the adapter increments it on every update,
+ * and refuses an update whose asserted version is no longer the current one.
+ */
+function ParseVersionField(options = {}) {
+    return (target, propertyKey) => {
+        const field = String(propertyKey);
+        (0, parseDecorators_1.ParseField)({
+            type: 'Number',
+            // Set by the adapter when the row is created, so a caller never supplies
+            // one and a create that omits it is not a validation failure.
+            required: false,
+            description: options.description ??
+                'Row version. Incremented on every update; a save asserting a stale one is refused',
+        })(target, propertyKey);
+        const constructor = target.constructor;
+        constructor[PENDING_VERSION_FIELD] = field;
+        assertVersionOnSave(target, field);
+    };
+}
+//# sourceMappingURL=versionRegistry.js.map

package/dist/database/versionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionRegistry.js","sourceRoot":"","sources":["../../src/database/versionRegistry.ts"],"names":[],"mappings":"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"}

package/dist/database/versionedMongoAdapter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A save that lost a race, under the one code every conflict reports.
+ *
+ * Shared with the transaction layer deliberately: losing an optimistic lock and
+ * losing a transaction's race are the same event to whoever is looking at it.
+ */
+export declare const VERSION_CONFLICT: number;
+export declare const VERSION_CONFLICT_MESSAGE = "Somebody else changed this while you were working on it. Open it again and redo your change.";
+export type MongoAdapterConstructor = new (options: unknown) => {
+    _adaptiveCollection(className: string): Promise<{
+        _mongoCollection: Record<string, unknown>;
+    }>;
+    connect(): Promise<unknown>;
+    createTransactionalSession(): Promise<unknown>;
+    commitTransactionalSession(session: unknown): Promise<unknown>;
+    abortTransactionalSession(session: unknown): Promise<unknown>;
+    findOneAndUpdate(className: string, schema: unknown, query: Record<string, unknown>, update: Record<string, unknown>, transactionalSession?: unknown): Promise<unknown>;
+    createObject(className: string, schema: unknown, object: Record<string, unknown>, transactionalSession?: unknown): Promise<unknown>;
+    find(className: string, schema: unknown, query: Record<string, unknown>, options: Record<string, unknown>): Promise<unknown[]>;
+};
+/** What `createVersionedMongoAdapter` hands back, structurally. */
+export type VersionedMongoAdapter = InstanceType<MongoAdapterConstructor>;
+/**
+ * The database adapter that makes `@ParseVersionField` mean something.
+ *
+ * Parse turns an object update into exactly one `findOneAndUpdate`, so that is
+ * the one place where a conditional write can be made to cover every save in
+ * the system — cloud function, trigger or REST — without a single endpoint
+ * knowing about it.
+ *
+ * For a versioned class it does two things to the update Parse built:
+ *
+ *   - moves the asserted version out of the update and into the **filter**, so
+ *     the write only lands if the row is still at the version the caller read;
+ *   - replaces it with an increment, so the row always moves on and the next
+ *     reader gets a fresh number.
+ *
+ * When the filter matches nothing it asks whether the row exists at all, so a
+ * lost race is reported as a conflict and a genuinely missing row still reads
+ * as missing.
+ *
+ * Only the single-object path is guarded. `updateObjectsByQuery` (a `many`
+ * update) and `upsertOneObject` are untouched: neither is reached by an object
+ * save, and a bulk update has no one version to assert.
+ *
+ * It carries the ambient transaction too. Both jobs meet in the same place for
+ * the same reason: this is the one point every write in the system passes
+ * through, whichever endpoint, trigger or SDK call started it.
+ */
+export declare function createVersionedMongoAdapter(options: unknown): VersionedMongoAdapter;
+//# sourceMappingURL=versionedMongoAdapter.d.ts.map

package/dist/database/versionedMongoAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionedMongoAdapter.d.ts","sourceRoot":"","sources":["../../src/database/versionedMongoAdapter.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAW,CAAC;AACzC,eAAO,MAAM,wBAAwB,iGAAmB,CAAC;AAEzD,MAAM,MAAM,uBAAuB,GAAG,KAAK,OAAO,EAAE,OAAO,KAAK;IAC9D,mBAAmB,CACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,oBAAoB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,oBAAoB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACvB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAkB1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,GACf,qBAAqB,CAwHvB"}

package/dist/database/versionedMongoAdapter.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION_CONFLICT_MESSAGE = exports.VERSION_CONFLICT = void 0;
+exports.createVersionedMongoAdapter = createVersionedMongoAdapter;
+const ambientSession_1 = require("../transactions/ambientSession");
+const context_1 = require("../transactions/context");
+const versionRegistry_1 = require("./versionRegistry");
+/**
+ * A save that lost a race, under the one code every conflict reports.
+ *
+ * Shared with the transaction layer deliberately: losing an optimistic lock and
+ * losing a transaction's race are the same event to whoever is looking at it.
+ */
+exports.VERSION_CONFLICT = context_1.CONFLICT;
+exports.VERSION_CONFLICT_MESSAGE = context_1.CONFLICT_MESSAGE;
+/**
+ * Load the adapter Parse Server ships with, to extend rather than replace.
+ *
+ * Required lazily so the class is only built when the server is being
+ * configured — importing `parse-server` at module load would pull the whole
+ * server into every unit test that touches a model.
+ */
+function baseAdapter() {
+    // Not exported from the package root, only from its own module.
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { MongoStorageAdapter, } = require('parse-server/lib/Adapters/Storage/Mongo/MongoStorageAdapter');
+    return MongoStorageAdapter;
+}
+/**
+ * The database adapter that makes `@ParseVersionField` mean something.
+ *
+ * Parse turns an object update into exactly one `findOneAndUpdate`, so that is
+ * the one place where a conditional write can be made to cover every save in
+ * the system — cloud function, trigger or REST — without a single endpoint
+ * knowing about it.
+ *
+ * For a versioned class it does two things to the update Parse built:
+ *
+ *   - moves the asserted version out of the update and into the **filter**, so
+ *     the write only lands if the row is still at the version the caller read;
+ *   - replaces it with an increment, so the row always moves on and the next
+ *     reader gets a fresh number.
+ *
+ * When the filter matches nothing it asks whether the row exists at all, so a
+ * lost race is reported as a conflict and a genuinely missing row still reads
+ * as missing.
+ *
+ * Only the single-object path is guarded. `updateObjectsByQuery` (a `many`
+ * update) and `upsertOneObject` are untouched: neither is reached by an object
+ * save, and a bulk update has no one version to assert.
+ *
+ * It carries the ambient transaction too. Both jobs meet in the same place for
+ * the same reason: this is the one point every write in the system passes
+ * through, whichever endpoint, trigger or SDK call started it.
+ */
+function createVersionedMongoAdapter(options) {
+    const MongoStorageAdapter = baseAdapter();
+    // Named differently from the exported `VersionedMongoAdapter` type so the
+    // function's declared return type keeps pointing at the public alias.
+    class VersionedAdapter extends MongoStorageAdapter {
+        async findOneAndUpdate(className, schema, query, update, transactionalSession) {
+            const field = versionRegistry_1.VersionRegistry.fieldFor(className);
+            if (!field) {
+                return super.findOneAndUpdate(className, schema, query, update, transactionalSession);
+            }
+            // A number here is the caller saying "this is what I read". Anything else
+            // — absent, or an operator — is not an assertion, and the row is only
+            // moved on.
+            const asserted = update[field];
+            const hasAssertion = typeof asserted === 'number';
+            const guardedUpdate = {
+                ...update,
+                [field]: { __op: 'Increment', amount: 1 },
+            };
+            const guardedQuery = hasAssertion ? { ...query, [field]: asserted } : query;
+            const result = await super.findOneAndUpdate(className, schema, guardedQuery, guardedUpdate, transactionalSession);
+            if (result || !hasAssertion)
+                return result;
+            // Nothing matched. Either somebody moved it on, or it is gone.
+            if (await this.rowExists(className, schema, query)) {
+                // The typings only admit Parse's own codes; the wire format is a
+                // number, and a code of our own is what keeps this distinguishable
+                // from every meaning Parse already has.
+                throw new Parse.Error(exports.VERSION_CONFLICT, exports.VERSION_CONFLICT_MESSAGE);
+            }
+            return result;
+        }
+        /**
+         * Give a new row its first version.
+         *
+         * Creates never reach `findOneAndUpdate`, so without this the first update
+         * of a row would have nothing to assert against.
+         */
+        createObject(className, schema, object, transactionalSession) {
+            const field = versionRegistry_1.VersionRegistry.fieldFor(className);
+            const versioned = field && typeof object[field] !== 'number'
+                ? { ...object, [field]: 1 }
+                : object;
+            return super.createObject(className, schema, versioned, transactionalSession);
+        }
+        /**
+         * Every collection joins whatever transaction its caller is in.
+         *
+         * The wrapping is per call rather than cached, because `_adaptiveCollection`
+         * hands back a fresh wrapper each time — so there is nothing to accumulate
+         * proxies on.
+         */
+        _adaptiveCollection(className) {
+            return super._adaptiveCollection(className).then(collection => {
+                if (!ambientSession_1.NO_AMBIENT_TRANSACTION.has(className)) {
+                    collection._mongoCollection = (0, ambientSession_1.withAmbientSession)(collection._mongoCollection);
+                }
+                return collection;
+            });
+        }
+        /** Whether the row is there at all, ignoring what version it is at. */
+        async rowExists(className, schema, query) {
+            const rows = await this.find(className, schema, query, { limit: 1 });
+            return rows.length > 0;
+        }
+    }
+    const instance = new VersionedAdapter(options);
+    // What `withTransaction` opens, commits and aborts. It is told the adapter
+    // rather than importing one, so it never learns what a session is.
+    (0, context_1.useTransactionAdapter)(instance);
+    // So a `@ParseVersionField` with no adapter behind it can be reported at boot
+    // instead of failing to guard anything in silence.
+    versionRegistry_1.VersionRegistry.markAdapterInstalled();
+    return instance;
+}
+//# sourceMappingURL=versionedMongoAdapter.js.map

package/dist/database/versionedMongoAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionedMongoAdapter.js","sourceRoot":"","sources":["../../src/database/versionedMongoAdapter.ts"],"names":[],"mappings":"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"}

package/dist/decorators/cloudRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudRegistry.d.ts","sourceRoot":"","sources":["../../src/decorators/cloudRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAGzD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiD;IAEzE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB;IAI/C,MAAM,CAAC,YAAY;IAInB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM;IAI/B,MAAM,CAAC,UAAU;CASlB"}
+{"version":3,"file":"cloudRegistry.d.ts","sourceRoot":"","sources":["../../src/decorators/cloudRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAIzD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiD;IAEzE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB;IAI/C,MAAM,CAAC,YAAY;IAInB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM;IAI/B,MAAM,CAAC,UAAU;CAclB"}

package/dist/decorators/cloudRegistry.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CloudFunctionRegistry = void 0;
 const routeDecorator_1 = require("./routeDecorator");
+const versionRegistry_1 = require("../database/versionRegistry");
 class CloudFunctionRegistry {
     static register(metadata) {
         this.functions.set(metadata.name, metadata);
@@ -19,6 +20,10 @@ class CloudFunctionRegistry {
         });
         // Build entity-based route map after all functions are registered
         routeDecorator_1.RouteRegistry.initialize();
+        // Last point at boot where both the models and the database adapter are
+        // known, so it is the only place that can tell whether a declared
+        // @ParseVersionField actually has anything enforcing it.
+        versionRegistry_1.VersionRegistry.verify();
     }
 }
 exports.CloudFunctionRegistry = CloudFunctionRegistry;

package/dist/decorators/cloudRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudRegistry.js","sourceRoot":"","sources":["../../src/decorators/cloudRegistry.ts"],"names":[],"mappings":";;;AACA,qDAA+C;AAE/C,MAAa,qBAAqB;IAGhC,MAAM,CAAC,QAAQ,CAAC,QAA+B;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAChC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,8BAA8B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,8BAAa,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;;AAvBH,sDAwBC;AAvBgB,+BAAS,GAAuC,IAAI,GAAG,EAAE,CAAC"}
+{"version":3,"file":"cloudRegistry.js","sourceRoot":"","sources":["../../src/decorators/cloudRegistry.ts"],"names":[],"mappings":";;;AACA,qDAA+C;AAC/C,iEAA4D;AAE5D,MAAa,qBAAqB;IAGhC,MAAM,CAAC,QAAQ,CAAC,QAA+B;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,UAAU;QACf,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAChC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,8BAA8B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,8BAAa,CAAC,UAAU,EAAE,CAAC;QAE3B,wEAAwE;QACxE,kEAAkE;QAClE,yDAAyD;QACzD,iCAAe,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;;AA5BH,sDA6BC;AA5BgB,+BAAS,GAAuC,IAAI,GAAG,EAAE,CAAC"}

package/dist/decorators/triggerDecorator.d.ts

@@ -9,10 +9,18 @@ export declare const AfterFind: (config?: TriggerConfig) => (target: any, proper
 export declare const BeforeLogin: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const AfterLogin: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const AfterLogout: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/** parse-server 8.5+. Runs before a password reset email is sent. */
+export declare const BeforePasswordResetRequest: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const BeforeSaveFile: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const AfterSaveFile: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const BeforeDeleteFile: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const AfterDeleteFile: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/** parse-server 8.1+. */
+export declare const BeforeFindFile: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/** parse-server 8.1+. */
+export declare const AfterFindFile: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const BeforeSaveConfig: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const AfterSaveConfig: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const BeforeConnect: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const BeforeSubscribe: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 export declare const AfterEvent: (config?: TriggerConfig) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/triggerDecorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"triggerDecorator.d.ts","sourceRoot":"","sources":["../../src/decorators/triggerDecorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,aAAa,EAAc,MAAM,sBAAsB,CAAC;AA0BhE,eAAO,MAAM,UAAU,YAvBI,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAsBvB,CAAC;AAC/D,eAAO,MAAM,SAAS,YAxBK,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAuBzB,CAAC;AAC7D,eAAO,MAAM,YAAY,YAzBE,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAwBnB,CAAC;AACnE,eAAO,MAAM,WAAW,YA1BG,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAyBrB,CAAC;AACjE,eAAO,MAAM,UAAU,YA3BI,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBA0BvB,CAAC;AAC/D,eAAO,MAAM,SAAS,YA5BK,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBA2BzB,CAAC;AAG7D,eAAO,MAAM,WAAW,YA/BG,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBA8BrB,CAAC;AACjE,eAAO,MAAM,UAAU,YAhCI,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBA+BvB,CAAC;AAC/D,eAAO,MAAM,WAAW,YAjCG,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAgCrB,CAAC;AAGjE,eAAO,MAAM,cAAc,YApCA,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAmCf,CAAC;AACvE,eAAO,MAAM,aAAa,YArCC,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAoCjB,CAAC;AACrE,eAAO,MAAM,gBAAgB,YAtCF,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAqCX,CAAC;AAC3E,eAAO,MAAM,eAAe,YAvCD,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAsCb,CAAC;AAGzE,eAAO,MAAM,aAAa,YA1CC,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBAyCjB,CAAC;AACrE,eAAO,MAAM,eAAe,YA3CD,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBA0Cb,CAAC;AACzE,eAAO,MAAM,UAAU,YA5CI,aAAa,MACnB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,uBA2CvB,CAAC"}
+{"version":3,"file":"triggerDecorator.d.ts","sourceRoot":"","sources":["../../src/decorators/triggerDecorator.ts"],"names":[],"mappings":"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"}

package/dist/decorators/triggerDecorator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AfterEvent = exports.BeforeSubscribe = exports.BeforeConnect = exports.AfterDeleteFile = exports.BeforeDeleteFile = exports.AfterSaveFile = exports.BeforeSaveFile = exports.AfterLogout = exports.AfterLogin = exports.BeforeLogin = exports.AfterFind = exports.BeforeFind = exports.AfterDelete = exports.BeforeDelete = exports.AfterSave = exports.BeforeSave = void 0;
+exports.AfterEvent = exports.BeforeSubscribe = exports.BeforeConnect = exports.AfterSaveConfig = exports.BeforeSaveConfig = exports.AfterFindFile = exports.BeforeFindFile = exports.AfterDeleteFile = exports.BeforeDeleteFile = exports.AfterSaveFile = exports.BeforeSaveFile = exports.BeforePasswordResetRequest = exports.AfterLogout = exports.AfterLogin = exports.BeforeLogin = exports.AfterFind = exports.BeforeFind = exports.AfterDelete = exports.BeforeDelete = exports.AfterSave = exports.BeforeSave = void 0;
 require("reflect-metadata");
 function createTriggerDecorator(type) {
     return function (config = {}) {
@@ -33,11 +33,20 @@ exports.AfterFind = createTriggerDecorator('afterFind');
 exports.BeforeLogin = createTriggerDecorator('beforeLogin');
 exports.AfterLogin = createTriggerDecorator('afterLogin');
 exports.AfterLogout = createTriggerDecorator('afterLogout');
+/** parse-server 8.5+. Runs before a password reset email is sent. */
+exports.BeforePasswordResetRequest = createTriggerDecorator('beforePasswordResetRequest');
 // File triggers
 exports.BeforeSaveFile = createTriggerDecorator('beforeSaveFile');
 exports.AfterSaveFile = createTriggerDecorator('afterSaveFile');
 exports.BeforeDeleteFile = createTriggerDecorator('beforeDeleteFile');
 exports.AfterDeleteFile = createTriggerDecorator('afterDeleteFile');
+/** parse-server 8.1+. */
+exports.BeforeFindFile = createTriggerDecorator('beforeFindFile');
+/** parse-server 8.1+. */
+exports.AfterFindFile = createTriggerDecorator('afterFindFile');
+// Parse Config triggers (parse-server 7.3+)
+exports.BeforeSaveConfig = createTriggerDecorator('beforeSaveConfig');
+exports.AfterSaveConfig = createTriggerDecorator('afterSaveConfig');
 // LiveQuery triggers
 exports.BeforeConnect = createTriggerDecorator('beforeConnect');
 exports.BeforeSubscribe = createTriggerDecorator('beforeSubscribe');

package/dist/decorators/triggerDecorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"triggerDecorator.js","sourceRoot":"","sources":["../../src/decorators/triggerDecorator.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAG1B,SAAS,sBAAsB,CAAC,IAAiB;IAC/C,OAAO,UAAU,SAAwB,EAAE;QACzC,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;YAC/E,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;YACjC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,4CAA4C,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;YAC/E,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YACxF,eAAe,CAAC,IAAI,CAAC;gBACnB,IAAI;gBACJ,OAAO;gBACP,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YACH,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;YAE9E,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,kBAAkB;AACL,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,QAAA,SAAS,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAChD,QAAA,YAAY,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;AACtD,QAAA,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACpD,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,QAAA,SAAS,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAE7D,qBAAqB;AACR,QAAA,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACpD,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,QAAA,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AAEjE,gBAAgB;AACH,QAAA,cAAc,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;AAC1D,QAAA,aAAa,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;AACxD,QAAA,gBAAgB,GAAG,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;AAC9D,QAAA,eAAe,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAEzE,qBAAqB;AACR,QAAA,aAAa,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;AACxD,QAAA,eAAe,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAC5D,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"triggerDecorator.js","sourceRoot":"","sources":["../../src/decorators/triggerDecorator.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAG1B,SAAS,sBAAsB,CAAC,IAAiB;IAC/C,OAAO,UAAU,SAAwB,EAAE;QACzC,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;YAC/E,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC;YACjC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,4CAA4C,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;YAC/E,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YACxF,eAAe,CAAC,IAAI,CAAC;gBACnB,IAAI;gBACJ,OAAO;gBACP,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YACH,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;YAE9E,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,kBAAkB;AACL,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,QAAA,SAAS,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAChD,QAAA,YAAY,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;AACtD,QAAA,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACpD,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,QAAA,SAAS,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAE7D,qBAAqB;AACR,QAAA,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACpD,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,QAAA,WAAW,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;AACjE,qEAAqE;AACxD,QAAA,0BAA0B,GAAG,sBAAsB,CAAC,4BAA4B,CAAC,CAAC;AAE/F,gBAAgB;AACH,QAAA,cAAc,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;AAC1D,QAAA,aAAa,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;AACxD,QAAA,gBAAgB,GAAG,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;AAC9D,QAAA,eAAe,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AACzE,yBAAyB;AACZ,QAAA,cAAc,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;AACvE,yBAAyB;AACZ,QAAA,aAAa,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;AAErE,4CAA4C;AAC/B,QAAA,gBAAgB,GAAG,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;AAC9D,QAAA,eAAe,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAEzE,qBAAqB;AACR,QAAA,aAAa,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;AACxD,QAAA,eAAe,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAC5D,QAAA,UAAU,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC"}

package/dist/decorators/triggerRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"triggerRegistry.d.ts","sourceRoot":"","sources":["../../src/decorators/triggerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAc,MAAM,sBAAsB,CAAC;AAElE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2C;IAElE,OAAO,CAAC,MAAM,CAAC,MAAM;IAIrB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQhD,MAAM,CAAC,WAAW,IAAI,eAAe,EAAE;IAIvC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAIhE,MAAM,CAAC,UAAU,IAAI,IAAI;CAoC1B"}
+{"version":3,"file":"triggerRegistry.d.ts","sourceRoot":"","sources":["../../src/decorators/triggerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAc,MAAM,sBAAsB,CAAC;AAsBlE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2C;IAElE,OAAO,CAAC,MAAM,CAAC,MAAM;IAIrB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQhD,MAAM,CAAC,WAAW,IAAI,eAAe,EAAE;IAIvC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAIhE,MAAM,CAAC,UAAU,IAAI,IAAI;CAqD1B"}