velocious 1.0.493 → 1.0.495

package/build/src/sync/server-sequence-allocator.js

@@ -0,0 +1,220 @@
+// @ts-check
+import Configuration from "../configuration.js";
+import TableData from "../database/table-data/index.js";
+/**
+ * Allocation queues per database+table, serializing insert/last-insert-id
+ * pairs across all allocator instances in this process.
+ * @type {Map<string, Promise<void>>}
+ */
+const allocationQueues = new Map();
+/**
+ * Allocates monotonically increasing server sync sequences from an
+ * AUTO_INCREMENT id table: every allocation inserts a row and returns the
+ * driver's last-insert id, so sequences stay unique and increasing across
+ * processes sharing the same database.
+ *
+ * Backed by an auto-created `velocious_server_sequences` table on the
+ * configured database, with a process-local memory counter fallback when no
+ * database is configured (mirroring the sync scope store). Apps with an
+ * existing sequence table (for example a bare `id`-only AUTO_INCREMENT table)
+ * point `tableName` at it and pass `insertData: {}` to insert empty rows.
+ */
+export default class ServerSequenceAllocator {
+    /**
+     * Creates a server sequence allocator.
+     * @param {object} [args] - Options.
+     * @param {import("../configuration.js").default} [args.configuration] - Configuration owning the database. Defaults to the current configuration, resolved lazily per allocation.
+     * @param {string} [args.databaseIdentifier] - Database identifier.
+     * @param {Record<string, ?>} [args.insertData] - Row payload inserted per allocation. Defaults to `{created_at: new Date()}` matching the auto-created table; pass `{}` for bare id-only tables.
+     * @param {string} [args.tableName] - Sequence table name.
+     */
+    constructor({ configuration, databaseIdentifier = "default", insertData, tableName = "velocious_server_sequences" } = {}) {
+        this.configuration = configuration;
+        this.databaseIdentifier = databaseIdentifier;
+        this.insertData = insertData;
+        this.tableName = tableName;
+        this._memorySequence = 0;
+        this._isReady = false;
+        /** @type {Promise<void> | null} */
+        this._readyPromise = null;
+    }
+    /**
+     * Allocates the next monotonically increasing sequence.
+     *
+     * Allocations serialize through a module-level queue per database+table so
+     * parallel `next()` calls - including calls from other allocator instances
+     * sharing the same table and connection - cannot interleave their insert
+     * and last-insert-id reads and hand out duplicate sequences.
+     * @returns {Promise<number>} Next sequence value.
+     */
+    async next() {
+        const queueKey = `${this.databaseIdentifier}::${this.tableName}`;
+        const previousAllocation = allocationQueues.get(queueKey) ?? Promise.resolve();
+        const allocation = previousAllocation.then(() => this._allocateNext());
+        allocationQueues.set(queueKey, allocation.then(() => undefined, () => undefined));
+        return await allocation;
+    }
+    /**
+     * Ensures the backing table exists.
+     * @returns {Promise<void>} Resolves when ready.
+     */
+    async ensureReady() {
+        if (this._isReady)
+            return;
+        if (this._usesMemoryStorage()) {
+            this._isReady = true;
+            return;
+        }
+        if (this._readyPromise)
+            return await this._readyPromise;
+        this._readyPromise = this._withDb(async (db) => {
+            const created = await this._ensureSequencesTable(db);
+            // DDL joins any transaction already open on this connection (the mixin's
+            // beforeCreate allocation always runs inside the record save transaction),
+            // and on transactional-DDL databases (MSSQL, PostgreSQL, SQLite) a rollback
+            // of that outer transaction removes the just-created table again. Only
+            // cache readiness when the table was not created inside an active
+            // transaction; otherwise the next allocation re-verifies the table.
+            if (!created || !db.insideTransaction())
+                this._isReady = true;
+        });
+        try {
+            await this._readyPromise;
+        }
+        finally {
+            if (!this._isReady)
+                this._readyPromise = null;
+        }
+    }
+    /**
+     * Allocates one sequence value after queueing.
+     * @returns {Promise<number>} Allocated sequence value.
+     */
+    async _allocateNext() {
+        await this.ensureReady();
+        if (this._usesMemoryStorage()) {
+            return ++this._memorySequence;
+        }
+        return await this._withDb(async (db) => {
+            // The allocated id must be returned by the insert statement itself (OUTPUT
+            // INSERTED/RETURNING), like the record create path does: MSSQL's
+            // SCOPE_IDENTITY() only sees inserts from the same batch/scope, so reading
+            // the last-insert id as a separate query always returns NULL there. Drivers
+            // without insert-returning support (older SQLite) keep the reliable
+            // connection-scoped last-insert-id fallback.
+            const insertSql = db.insertSql({
+                data: this._insertPayload(),
+                returnLastInsertedColumnNames: ["id"],
+                tableName: this.tableName
+            });
+            const insertResult = await db.query(insertSql);
+            const insertedId = Array.isArray(insertResult) ? insertResult[0]?.id : undefined;
+            if (insertedId !== undefined && insertedId !== null)
+                return Number(insertedId);
+            return Number(await db.lastInsertID());
+        });
+    }
+    /**
+     * Builds the row payload inserted per allocation.
+     * @returns {Record<string, ?>} Insert payload.
+     */
+    _insertPayload() {
+        return this.insertData ?? { created_at: new Date() };
+    }
+    /**
+     * Resolves the configuration owning the sequence table.
+     * @returns {import("../configuration.js").default} Resolved configuration.
+     */
+    _getConfiguration() {
+        return this.configuration ?? Configuration.current();
+    }
+    /**
+     * Whether the allocator runs without a configured database.
+     * @returns {boolean} Whether memory storage is used.
+     */
+    _usesMemoryStorage() {
+        try {
+            return !this._getConfiguration().getDatabaseConfiguration()[this.databaseIdentifier];
+        }
+        catch {
+            return true;
+        }
+    }
+    /**
+     * Runs a callback with a database connection.
+     * @template Result
+     * @param {(db: import("../database/drivers/base.js").default) => Promise<Result>} callback - Database callback.
+     * @returns {Promise<Result>} Callback result.
+     */
+    async _withDb(callback) {
+        return await this._getConfiguration().ensureConnections({ name: "Server sequence allocator" }, async (dbs) => {
+            const db = dbs[this.databaseIdentifier];
+            if (!db)
+                throw new Error(`No database connection available for identifier: ${this.databaseIdentifier}`);
+            return await callback(db);
+        });
+    }
+    /**
+     * Ensures the sequences table exists.
+     * @param {import("../database/drivers/base.js").default} db - Database connection.
+     * @returns {Promise<boolean>} Whether the table had to be created.
+     */
+    async _ensureSequencesTable(db) {
+        if (await db.tableExists(this.tableName))
+            return false;
+        const table = new TableData(this.tableName, { ifNotExists: true });
+        table.bigint("id", { autoIncrement: true, null: false, primaryKey: true });
+        table.datetime("created_at", { null: false });
+        await db.createTable(table);
+        return true;
+    }
+}
+/**
+ * Wires server sequencing onto a sync model class: registers a beforeCreate
+ * lifecycle callback assigning the next sequence when the record has none, and
+ * defines an `advance<Column>()` instance method (when the model does not
+ * already define one) that re-sequences the record through the allocator.
+ *
+ * The sequence is always written through the model's generated typed setter
+ * (for example `setServerSequence`), so the model must expose the generated
+ * `set<Column>`/`has<Column>` accessors for the column.
+ * @template {typeof import("../database/record/index.js").default} TModelClass
+ * @param {TModelClass} ModelClass - Sync model class to sequence.
+ * @param {object} args - Options.
+ * @param {ServerSequenceAllocator} args.allocator - Allocator providing sequence values.
+ * @param {string} [args.column] - Sequence attribute name.
+ * @returns {TModelClass} The given model class.
+ */
+export function withServerSequence(ModelClass, { allocator, column = "serverSequence" }) {
+    if (!(allocator instanceof ServerSequenceAllocator)) {
+        throw new Error(`withServerSequence requires a ServerSequenceAllocator, got: ${String(allocator)}`);
+    }
+    const upperColumn = `${column.charAt(0).toUpperCase()}${column.slice(1)}`;
+    const advanceMethodName = `advance${upperColumn}`;
+    const hasMethodName = `has${upperColumn}`;
+    const setterMethodName = `set${upperColumn}`;
+    // Narrows the prototype to dynamic method access for the configured column name.
+    const prototype = /** @type {Record<string, ?>} */ (ModelClass.prototype);
+    if (typeof prototype[setterMethodName] != "function" || typeof prototype[hasMethodName] != "function") {
+        throw new Error(`withServerSequence requires generated ${setterMethodName} and ${hasMethodName} accessors on ${ModelClass.name}`);
+    }
+    if (typeof prototype[advanceMethodName] != "function") {
+        /**
+         * Assigns the next server-side sequence.
+         * @this {Record<string, ?>}
+         * @returns {Promise<void>}
+         */
+        prototype[advanceMethodName] = async function advanceServerSequenceThroughAllocator() {
+            this[setterMethodName](await allocator.next());
+        };
+    }
+    ModelClass.beforeCreate(async (record) => {
+        // Narrows the record to dynamic method access for the configured column name.
+        const dynamicRecord = /** @type {Record<string, ?>} */ ( /** @type {?} */(record));
+        if (dynamicRecord[hasMethodName]())
+            return;
+        await dynamicRecord[advanceMethodName]();
+    });
+    return ModelClass;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyLXNlcXVlbmNlLWFsbG9jYXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zeW5jL3NlcnZlci1zZXF1ZW5jZS1hbGxvY2F0b3IuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sYUFBYSxNQUFNLHFCQUFxQixDQUFBO0FBQy9DLE9BQU8sU0FBUyxNQUFNLGlDQUFpQyxDQUFBO0FBRXZEOzs7O0dBSUc7QUFDSCxNQUFNLGdCQUFnQixHQUFHLElBQUksR0FBRyxFQUFFLENBQUE7QUFFbEM7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLHVCQUF1QjtJQUMxQzs7Ozs7OztPQU9HO0lBQ0gsWUFBWSxFQUFDLGFBQWEsRUFBRSxrQkFBa0IsR0FBRyxTQUFTLEVBQUUsVUFBVSxFQUFFLFNBQVMsR0FBRyw0QkFBNEIsRUFBQyxHQUFHLEVBQUU7UUFDcEgsSUFBSSxDQUFDLGFBQWEsR0FBRyxhQUFhLENBQUE7UUFDbEMsSUFBSSxDQUFDLGtCQUFrQixHQUFHLGtCQUFrQixDQUFBO1FBQzVDLElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFBO1FBQzVCLElBQUksQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFBO1FBQzFCLElBQUksQ0FBQyxlQUFlLEdBQUcsQ0FBQyxDQUFBO1FBQ3hCLElBQUksQ0FBQyxRQUFRLEdBQUcsS0FBSyxDQUFBO1FBQ3JCLG1DQUFtQztRQUNuQyxJQUFJLENBQUMsYUFBYSxHQUFHLElBQUksQ0FBQTtJQUMzQixDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSCxLQUFLLENBQUMsSUFBSTtRQUNSLE1BQU0sUUFBUSxHQUFHLEdBQUcsSUFBSSxDQUFDLGtCQUFrQixLQUFLLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQTtRQUNoRSxNQUFNLGtCQUFrQixHQUFHLGdCQUFnQixDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsSUFBSSxPQUFPLENBQUMs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LE9BQU8sU0FBUyxDQUFDLGFBQWEsQ0FBQyxJQUFJLFVBQVUsRUFBRSxDQUFDO1FBQ3RHLE1BQU0sSUFBSSxLQUFLLENBQUMseUNBQXlDLGdCQUFnQixRQUFRLGFBQWEsaUJBQWlCLFVBQVUsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFBO0lBQ25JLENBQUM7SUFFRCxJQUFJLE9BQU8sU0FBUyxDQUFDLGlCQUFpQixDQUFDLElBQUksVUFBVSxFQUFFLENBQUM7UUFDdEQ7Ozs7V0FJRztRQUNILFNBQVMsQ0FBQyxpQkFBaUIsQ0FBQyxHQUFHLEtBQUssVUFBVSxxQ0FBcUM7WUFDakYsSUFBSSxDQUFDLGdCQUFnQixDQUFDLENBQUMsTUFBTSxTQUFTLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQTtRQUNoRCxDQUFDLENBQUE7SUFDSCxDQUFDO0lBRUQsVUFBVSxDQUFDLFlBQVksQ0FBQyxLQUFLLEVBQUUsTUFBTSxFQUFFLEVBQUU7UUFDdkMsOEVBQThFO1FBQzlFLE1BQU0sYUFBYSxHQUFHLGdDQUFnQyxDQUFDLEVBQUMsZ0JBQWlCLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQTtRQUVsRixJQUFJLGFBQWEsQ0FBQyxhQUFhLENBQUMsRUFBRTtZQUFFLE9BQU07UUFFMUMsTUFBTSxhQUFhLENBQUMsaUJBQWlCLENBQUMsRUFBRSxDQUFBO0lBQzFDLENBQUMsQ0FBQyxDQUFBO0lBRUYsT0FBTyxVQUFVLENBQUE7QUFDbkIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgQ29uZmlndXJhdGlvbiBmcm9tIFwiLi4vY29uZmlndXJhdGlvbi5qc1wiXG5pbXBvcnQgVGFibGVEYXRhIGZyb20gXCIuLi9kYXRhYmFzZS90YWJsZS1kYXRhL2luZGV4LmpzXCJcblxuLyoqXG4gKiBBbGxvY2F0aW9uIHF1ZXVlcyBwZXIgZGF0YWJhc2UrdGFibGUsIHNlcmlhbGl6aW5nIGluc2VydC9sYXN0LWluc2VydC1pZFxuICogcGFpcnMgYWNyb3NzIGFsbCBhbGxvY2F0b3IgaW5zdGFuY2VzIGluIHRoaXMgcHJvY2Vzcy5cbiAqIEB0eXBlIHtNYXA8c3RyaW5nLCBQcm9taXNlPHZvaWQ+Pn1cbiAqL1xuY29uc3QgYWxsb2NhdGlvblF1ZXVlcyA9IG5ldyBNYXAoKVxuXG4vKipcbiAqIEFsbG9jYXRlcyBtb25vdG9uaWNhbGx5IGluY3JlYXNpbmcgc2VydmVyIHN5bmMgc2VxdWVuY2VzIGZyb20gYW5cbiAqIEFVVE9fSU5DUkVNRU5UIGlkIHRhYmxlOiBldmVyeSBhbGxvY2F0aW9uIGluc2VydHMgYSByb3cgYW5kIHJldHVybnMgdGhlXG4gKiBkcml2ZXIncyBsYXN0LWluc2VydCBpZCwgc28gc2VxdWVuY2VzIHN0YXkgdW5pcXVlIGFuZCBpbmNyZWFzaW5nIGFjcm9zc1xuICogcHJvY2Vzc2VzIHNoYXJpbmcgdGhlIHNhbWUgZGF0YWJhc2UuXG4gKlxuICogQmFja2VkIGJ5IGFuIGF1dG8tY3JlYXRlZCBgdmVsb2Npb3VzX3NlcnZlcl9zZXF1ZW5jZXNgIHRhYmxlIG9uIHRoZVxuICogY29uZmlndXJlZCBkYXRhYmFzZSwgd2l0aCBhIHByb2Nlc3MtbG9jYWwgbWVtb3J5IGNvdW50ZXIgZmFsbGJhY2sgd2hlbiBub1xuICogZGF0YWJhc2UgaXMgY29uZmlndXJlZCAobWlycm9yaW5nIHRoZSBzeW5jIHNjb3BlIHN0b3JlKS4gQXBwcyB3aXRoIGFuXG4gKiBleGlzdGluZyBzZXF1ZW5jZSB0YWJsZSAoZm9yIGV4YW1wbGUgYSBiYXJlIGBpZGAtb25seSBBVVRPX0lOQ1JFTUVOVCB0YWJsZSlcbiAqIHBvaW50IGB0YWJsZU5hbWVgIGF0IGl0IGFuZCBwYXNzIGBpbnNlcnREYXRhOiB7fWAgdG8gaW5zZXJ0IGVtcHR5IHJvd3MuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFNlcnZlclNlcXVlbmNlQWxsb2NhdG9yIHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBzZXJ2ZXIgc2VxdWVuY2UgYWxsb2NhdG9yLlxuICAgKiBAcGFyYW0ge29iamVjdH0gW2FyZ3NdIC0gT3B0aW9ucy5cbiAgICogQHBhcmFtIHtpbXBvcnQoXCIuLi9jb25maWd1cmF0aW9uLmpzXCIpLmRlZmF1bHR9IFthcmdzLmNvbmZpZ3VyYXRpb25dIC0gQ29uZmlndXJhdGlvbiBvd25pbmcgdGhlIGRhdGFiYXNlLiBEZWZhdWx0cyB0byB0aGUgY3VycmVudCBjb25maWd1cmF0aW9uLCByZXNvbHZlZCBsYXppbHkgcGVyIGFsbG9jYXRpb24uXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBbYXJncy5kYXRhYmFzZUlkZW50aWZpZXJdIC0gRGF0YWJhc2UgaWRlbnRpZmllci5cbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gW2FyZ3MuaW5zZXJ0RGF0YV0gLSBSb3cgcGF5bG9hZCBpbnNlcnRlZCBwZXIgYWxsb2NhdGlvbi4gRGVmYXVsdHMgdG8gYHtjcmVhdGVkX2F0OiBuZXcgRGF0ZSgpfWAgbWF0Y2hpbmcgdGhlIGF1dG8tY3JlYXRlZCB0YWJsZTsgcGFzcyBge31gIGZvciBiYXJlIGlkLW9ubHkgdGFibGVzLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MudGFibGVOYW1lXSAtIFNlcXVlbmNlIHRhYmxlIG5hbWUuXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7Y29uZmlndXJhdGlvbiwgZGF0YWJhc2VJZGVudGlmaWVyID0gXCJkZWZhdWx0XCIsIGluc2VydERhdGEsIHRhYmxlTmFtZSA9IFwidmVsb2Npb3VzX3NlcnZlcl9zZXF1ZW5jZXNcIn0gPSB7fSkge1xuICAgIHRoaXMuY29uZmlndXJhdGlvbiA9IGNvbmZpZ3VyYXRpb25cbiAgICB0aGlzLmRhdGFiYXNlSWRlbnRpZmllciA9IGRhdGFiYXNlSWRlbnRpZmllclxuICAgIHRoaXMuaW5zZXJ0RGF0YSA9IGluc2VydERhdGFcbiAgICB0aGlzLnRhYmxlTmFtZSA9IHRhYmxlTmFtZVxuICAgIHRoaXMuX21lbW9yeVNlcXVlbmNlID0gMFxuICAgIHRoaXMuX2lzUmVhZHkgPSBmYWxzZVxuICAgIC8qKiBAdHlwZSB7UHJvbWlzZTx2b2lkPiB8IG51bGx9ICovXG4gICAgdGhpcy5fcmVhZHlQcm9taXNlID0gbnVsbFxuICB9XG5cbiAgLyoqXG4gICAqIEFsbG9jYXRlcyB0aGUgbmV4dCBtb25vdG9uaWNhbGx5IGluY3JlYXNpbmcgc2VxdWVuY2UuXG4gICAqXG4gICAqIEFsbG9jYXRpb25zIHNlcmlhbGl6ZSB0aHJvdWdoIGEgbW9kdWxlLWxldmVsIHF1ZXVlIHBlciBkYXRhYmFzZSt0YWJsZSBzb1xuICAgKiBwYXJhbGxlbCBgbmV4dCgpYCBjYWxscyAtIGluY2x1ZGluZyBjYWxscyBmcm9tIG90aGVyIGFsbG9jYXRvciBpbnN0YW5jZXNcbiAgICogc2hhcmluZyB0aGUgc2FtZSB0YWJsZSBhbmQgY29ubmVjdGlvbiAtIGNhbm5vdCBpbnRlcmxlYXZlIHRoZWlyIGluc2VydFxuICAgKiBhbmQgbGFzdC1pbnNlcnQtaWQgcmVhZHMgYW5kIGhhbmQgb3V0IGR1cGxpY2F0ZSBzZXF1ZW5jZXMuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPG51bWJlcj59IE5leHQgc2VxdWVuY2UgdmFsdWUuXG4gICAqL1xuICBhc3luYyBuZXh0KCkge1xuICAgIGNvbnN0IHF1ZXVlS2V5ID0gYCR7dGhpcy5kYXRhYmFzZUlkZW50aWZpZXJ9Ojoke3RoaXMudGFibGVOYW1lfWBcbiAgICBjb25zdCBwcmV2aW91c0FsbG9jYXRpb24gPSBhbGxvY2F0aW9uUXVldWVzLmdldChxdWV1ZUtleSkgPz8gUHJvbWlzZS5yZXNvbHZlKClcbiAgICBjb25zdCBhbGxvY2F0aW9uID0gcHJldmlvdXNBbGxvY2F0aW9uLnRoZW4oKCkgPT4gdGhpcy5fYWxsb2NhdGVOZXh0KCkpXG5cbiAgICBhbGxvY2F0aW9uUXVldWVzLnNldChxdWV1ZUtleSwgYWxsb2NhdGlvbi50aGVuKCgpID0+IHVuZGVmaW5lZCwgKCkgPT4gdW5kZWZpbmVkKSlcblxuICAgIHJldHVybiBhd2FpdCBhbGxvY2F0aW9uXG4gIH1cblxuICAvKipcbiAgICogRW5zdXJlcyB0aGUgYmFja2luZyB0YWJsZSBleGlzdHMuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fSBSZXNvbHZlcyB3aGVuIHJlYWR5LlxuICAgKi9cbiAgYXN5bmMgZW5zdXJlUmVhZHkoKSB7XG4gICAgaWYgKHRoaXMuX2lzUmVhZHkpIHJldHVyblxuXG4gICAgaWYgKHRoaXMuX3VzZXNNZW1vcnlTdG9yYWdlKCkpIHtcbiAgICAgIHRoaXMuX2lzUmVhZHkgPSB0cnVlXG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICBpZiAodGhpcy5fcmVhZHlQcm9taXNlKSByZXR1cm4gYXdhaXQgdGhpcy5fcmVhZHlQcm9taXNlXG5cbiAgICB0aGlzLl9yZWFkeVByb21pc2UgPSB0aGlzLl93aXRoRGIoYXN5bmMgKGRiKSA9PiB7XG4gICAgICBjb25zdCBjcmVhdGVkID0gYXdhaXQgdGhpcy5fZW5zdXJlU2VxdWVuY2VzVGFibGUoZGIpXG5cbiAgICAgIC8vIERETCBqb2lucyBhbnkgdHJhbnNhY3Rpb24gYWxyZWFkeSBvcGVuIG9uIHRoaXMgY29ubmVjdGlvbiAodGhlIG1peGluJ3NcbiAgICAgIC8vIGJlZm9yZUNyZWF0ZSBhbGxvY2F0aW9uIGFsd2F5cyBydW5zIGluc2lkZSB0aGUgcmVjb3JkIHNhdmUgdHJhbnNhY3Rpb24pLFxuICAgICAgLy8gYW5kIG9uIHRyYW5zYWN0aW9uYWwtRERMIGRhdGFiYXNlcyAoTVNTUUwsIFBvc3RncmVTUUwsIFNRTGl0ZSkgYSByb2xsYmFja1xuICAgICAgLy8gb2YgdGhhdCBvdXRlciB0cmFuc2FjdGlvbiByZW1vdmVzIHRoZSBqdXN0LWNyZWF0ZWQgdGFibGUgYWdhaW4uIE9ubHlcbiAgICAgIC8vIGNhY2hlIHJlYWRpbmVzcyB3aGVuIHRoZSB0YWJsZSB3YXMgbm90IGNyZWF0ZWQgaW5zaWRlIGFuIGFjdGl2ZVxuICAgICAgLy8gdHJhbnNhY3Rpb247IG90aGVyd2lzZSB0aGUgbmV4dCBhbGxvY2F0aW9uIHJlLXZlcmlmaWVzIHRoZSB0YWJsZS5cbiAgICAgIGlmICghY3JlYXRlZCB8fCAhZGIuaW5zaWRlVHJhbnNhY3Rpb24oKSkgdGhpcy5faXNSZWFkeSA9IHRydWVcbiAgICB9KVxuXG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IHRoaXMuX3JlYWR5UHJvbWlzZVxuICAgIH0gZmluYWxseSB7XG4gICAgICBpZiAoIXRoaXMuX2lzUmVhZHkpIHRoaXMuX3JlYWR5UHJvbWlzZSA9IG51bGxcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogQWxsb2NhdGVzIG9uZSBzZXF1ZW5jZSB2YWx1ZSBhZnRlciBxdWV1ZWluZy5cbiAgICogQHJldHVybnMge1Byb21pc2U8bnVtYmVyPn0gQWxsb2NhdGVkIHNlcXVlbmNlIHZhbHVlLlxuICAgKi9cbiAgYXN5bmMgX2FsbG9jYXRlTmV4dCgpIHtcbiAgICBhd2FpdCB0aGlzLmVuc3VyZVJlYWR5KClcblxuICAgIGlmICh0aGlzLl91c2VzTWVtb3J5U3RvcmFnZSgpKSB7XG4gICAgICByZXR1cm4gKyt0aGlzLl9tZW1vcnlTZXF1ZW5jZVxuICAgIH1cblxuICAgIHJldHVybiBhd2FpdCB0aGlzLl93aXRoRGIoYXN5bmMgKGRiKSA9PiB7XG4gICAgICAvLyBUaGUgYWxsb2NhdGVkIGlkIG11c3QgYmUgcmV0dXJuZWQgYnkgdGhlIGluc2VydCBzdGF0ZW1lbnQgaXRzZWxmIChPVVRQVVRcbiAgICAgIC8vIElOU0VSVEVEL1JFVFVSTklORyksIGxpa2UgdGhlIHJlY29yZCBjcmVhdGUgcGF0aCBkb2VzOiBNU1NRTCdzXG4gICAgICAvLyBTQ09QRV9JREVOVElUWSgpIG9ubHkgc2VlcyBpbnNlcnRzIGZyb20gdGhlIHNhbWUgYmF0Y2gvc2NvcGUsIHNvIHJlYWRpbmdcbiAgICAgIC8vIHRoZSBsYXN0LWluc2VydCBpZCBhcyBhIHNlcGFyYXRlIHF1ZXJ5IGFsd2F5cyByZXR1cm5zIE5VTEwgdGhlcmUuIERyaXZlcnNcbiAgICAgIC8vIHdpdGhvdXQgaW5zZXJ0LXJldHVybmluZyBzdXBwb3J0IChvbGRlciBTUUxpdGUpIGtlZXAgdGhlIHJlbGlhYmxlXG4gICAgICAvLyBjb25uZWN0aW9uLXNjb3BlZCBsYXN0LWluc2VydC1pZCBmYWxsYmFjay5cbiAgICAgIGNvbnN0IGluc2VydFNxbCA9IGRiLmluc2VydFNxbCh7XG4gICAgICAgIGRhdGE6IHRoaXMuX2luc2VydFBheWxvYWQoKSxcbiAgICAgICAgcmV0dXJuTGFzdEluc2VydGVkQ29sdW1uTmFtZXM6IFtcImlkXCJdLFxuICAgICAgICB0YWJsZU5hbWU6IHRoaXMudGFibGVOYW1lXG4gICAgICB9KVxuICAgICAgY29uc3QgaW5zZXJ0UmVzdWx0ID0gYXdhaXQgZGIucXVlcnkoaW5zZXJ0U3FsKVxuICAgICAgY29uc3QgaW5zZXJ0ZWRJZCA9IEFycmF5LmlzQXJyYXkoaW5zZXJ0UmVzdWx0KSA/IGluc2VydFJlc3VsdFswXT8uaWQgOiB1bmRlZmluZWRcblxuICAgICAgaWYgKGluc2VydGVkSWQgIT09IHVuZGVmaW5lZCAmJiBpbnNlcnRlZElkICE9PSBudWxsKSByZXR1cm4gTnVtYmVyKGluc2VydGVkSWQpXG5cbiAgICAgIHJldHVybiBOdW1iZXIoYXdhaXQgZGIubGFzdEluc2VydElEKCkpXG4gICAgfSlcbiAgfVxuXG4gIC8qKlxuICAgKiBCdWlsZHMgdGhlIHJvdyBwYXlsb2FkIGluc2VydGVkIHBlciBhbGxvY2F0aW9uLlxuICAgKiBAcmV0dXJucyB7UmVjb3JkPHN0cmluZywgPz59IEluc2VydCBwYXlsb2FkLlxuICAgKi9cbiAgX2luc2VydFBheWxvYWQoKSB7XG4gICAgcmV0dXJuIHRoaXMuaW5zZXJ0RGF0YSA/PyB7Y3JlYXRlZF9hdDogbmV3IERhdGUoKX1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZXNvbHZlcyB0aGUgY29uZmlndXJhdGlvbiBvd25pbmcgdGhlIHNlcXVlbmNlIHRhYmxlLlxuICAgKiBAcmV0dXJucyB7aW1wb3J0KFwiLi4vY29uZmlndXJhdGlvbi5qc1wiKS5kZWZhdWx0fSBSZXNvbHZlZCBjb25maWd1cmF0aW9uLlxuICAgKi9cbiAgX2dldENvbmZpZ3VyYXRpb24oKSB7XG4gICAgcmV0dXJuIHRoaXMuY29uZmlndXJhdGlvbiA/PyBDb25maWd1cmF0aW9uLmN1cnJlbnQoKVxuICB9XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdGhlIGFsbG9jYXRvciBydW5zIHdpdGhvdXQgYSBjb25maWd1cmVkIGRhdGFiYXNlLlxuICAgKiBAcmV0dXJucyB7Ym9vbGVhbn0gV2hldGhlciBtZW1vcnkgc3RvcmFnZSBpcyB1c2VkLlxuICAgKi9cbiAgX3VzZXNNZW1vcnlTdG9yYWdlKCkge1xuICAgIHRyeSB7XG4gICAgICByZXR1cm4gIXRoaXMuX2dldENvbmZpZ3VyYXRpb24oKS5nZXREYXRhYmFzZUNvbmZpZ3VyYXRpb24oKVt0aGlzLmRhdGFiYXNlSWRlbnRpZmllcl1cbiAgICB9IGNhdGNoIHtcbiAgICAgIHJldHVybiB0cnVlXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJ1bnMgYSBjYWxsYmFjayB3aXRoIGEgZGF0YWJhc2UgY29ubmVjdGlvbi5cbiAgICogQHRlbXBsYXRlIFJlc3VsdFxuICAgKiBAcGFyYW0geyhkYjogaW1wb3J0KFwiLi4vZGF0YWJhc2UvZHJpdmVycy9iYXNlLmpzXCIpLmRlZmF1bHQpID0+IFByb21pc2U8UmVzdWx0Pn0gY2FsbGJhY2sgLSBEYXRhYmFzZSBjYWxsYmFjay5cbiAgICogQHJldHVybnMge1Byb21pc2U8UmVzdWx0Pn0gQ2FsbGJhY2sgcmVzdWx0LlxuICAgKi9cbiAgYXN5bmMgX3dpdGhEYihjYWxsYmFjaykge1xuICAgIHJldHVybiBhd2FpdCB0aGlzLl9nZXRDb25maWd1cmF0aW9uKCkuZW5zdXJlQ29ubmVjdGlvbnMoe25hbWU6IFwiU2VydmVyIHNlcXVlbmNlIGFsbG9jYXRvclwifSwgYXN5bmMgKGRicykgPT4ge1xuICAgICAgY29uc3QgZGIgPSBkYnNbdGhpcy5kYXRhYmFzZUlkZW50aWZpZXJdXG5cbiAgICAgIGlmICghZGIpIHRocm93IG5ldyBFcnJvcihgTm8gZGF0YWJhc2UgY29ubmVjdGlvbiBhdmFpbGFibGUgZm9yIGlkZW50aWZpZXI6ICR7dGhpcy5kYXRhYmFzZUlkZW50aWZpZXJ9YClcblxuICAgICAgcmV0dXJuIGF3YWl0IGNhbGxiYWNrKGRiKVxuICAgIH0pXG4gIH1cblxuICAvKipcbiAgICogRW5zdXJlcyB0aGUgc2VxdWVuY2VzIHRhYmxlIGV4aXN0cy5cbiAgICogQHBhcmFtIHtpbXBvcnQoXCIuLi9kYXRhYmFzZS9kcml2ZXJzL2Jhc2UuanNcIikuZGVmYXVsdH0gZGIgLSBEYXRhYmFzZSBjb25uZWN0aW9uLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxib29sZWFuPn0gV2hldGhlciB0aGUgdGFibGUgaGFkIHRvIGJlIGNyZWF0ZWQuXG4gICAqL1xuICBhc3luYyBfZW5zdXJlU2VxdWVuY2VzVGFibGUoZGIpIHtcbiAgICBpZiAoYXdhaXQgZGIudGFibGVFeGlzdHModGhpcy50YWJsZU5hbWUpKSByZXR1cm4gZmFsc2VcblxuICAgIGNvbnN0IHRhYmxlID0gbmV3IFRhYmxlRGF0YSh0aGlzLnRhYmxlTmFtZSwge2lmTm90RXhpc3RzOiB0cnVlfSlcblxuICAgIHRhYmxlLmJpZ2ludChcImlkXCIsIHthdXRvSW5jcmVtZW50OiB0cnVlLCBudWxsOiBmYWxzZSwgcHJpbWFyeUtleTogdHJ1ZX0pXG4gICAgdGFibGUuZGF0ZXRpbWUoXCJjcmVhdGVkX2F0XCIsIHtudWxsOiBmYWxzZX0pXG5cbiAgICBhd2FpdCBkYi5jcmVhdGVUYWJsZSh0YWJsZSlcblxuICAgIHJldHVybiB0cnVlXG4gIH1cbn1cblxuLyoqXG4gKiBXaXJlcyBzZXJ2ZXIgc2VxdWVuY2luZyBvbnRvIGEgc3luYyBtb2RlbCBjbGFzczogcmVnaXN0ZXJzIGEgYmVmb3JlQ3JlYXRlXG4gKiBsaWZlY3ljbGUgY2FsbGJhY2sgYXNzaWduaW5nIHRoZSBuZXh0IHNlcXVlbmNlIHdoZW4gdGhlIHJlY29yZCBoYXMgbm9uZSwgYW5kXG4gKiBkZWZpbmVzIGFuIGBhZHZhbmNlPENvbHVtbj4oKWAgaW5zdGFuY2UgbWV0aG9kICh3aGVuIHRoZSBtb2RlbCBkb2VzIG5vdFxuICogYWxyZWFkeSBkZWZpbmUgb25lKSB0aGF0IHJlLXNlcXVlbmNlcyB0aGUgcmVjb3JkIHRocm91Z2ggdGhlIGFsbG9jYXRvci5cbiAqXG4gKiBUaGUgc2VxdWVuY2UgaXMgYWx3YXlzIHdyaXR0ZW4gdGhyb3VnaCB0aGUgbW9kZWwncyBnZW5lcmF0ZWQgdHlwZWQgc2V0dGVyXG4gKiAoZm9yIGV4YW1wbGUgYHNldFNlcnZlclNlcXVlbmNlYCksIHNvIHRoZSBtb2RlbCBtdXN0IGV4cG9zZSB0aGUgZ2VuZXJhdGVkXG4gKiBgc2V0PENvbHVtbj5gL2BoYXM8Q29sdW1uPmAgYWNjZXNzb3JzIGZvciB0aGUgY29sdW1uLlxuICogQHRlbXBsYXRlIHt0eXBlb2YgaW1wb3J0KFwiLi4vZGF0YWJhc2UvcmVjb3JkL2luZGV4LmpzXCIpLmRlZmF1bHR9IFRNb2RlbENsYXNzXG4gKiBAcGFyYW0ge1RNb2RlbENsYXNzfSBNb2RlbENsYXNzIC0gU3luYyBtb2RlbCBjbGFzcyB0byBzZXF1ZW5jZS5cbiAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gT3B0aW9ucy5cbiAqIEBwYXJhbSB7U2VydmVyU2VxdWVuY2VBbGxvY2F0b3J9IGFyZ3MuYWxsb2NhdG9yIC0gQWxsb2NhdG9yIHByb3ZpZGluZyBzZXF1ZW5jZSB2YWx1ZXMuXG4gKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MuY29sdW1uXSAtIFNlcXVlbmNlIGF0dHJpYnV0ZSBuYW1lLlxuICogQHJldHVybnMge1RNb2RlbENsYXNzfSBUaGUgZ2l2ZW4gbW9kZWwgY2xhc3MuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB3aXRoU2VydmVyU2VxdWVuY2UoTW9kZWxDbGFzcywge2FsbG9jYXRvciwgY29sdW1uID0gXCJzZXJ2ZXJTZXF1ZW5jZVwifSkge1xuICBpZiAoIShhbGxvY2F0b3IgaW5zdGFuY2VvZiBTZXJ2ZXJTZXF1ZW5jZUFsbG9jYXRvcikpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoYHdpdGhTZXJ2ZXJTZXF1ZW5jZSByZXF1aXJlcyBhIFNlcnZlclNlcXVlbmNlQWxsb2NhdG9yLCBnb3Q6ICR7U3RyaW5nKGFsbG9jYXRvcil9YClcbiAgfVxuXG4gIGNvbnN0IHVwcGVyQ29sdW1uID0gYCR7Y29sdW1uLmNoYXJBdCgwKS50b1VwcGVyQ2FzZSgpfSR7Y29sdW1uLnNsaWNlKDEpfWBcbiAgY29uc3QgYWR2YW5jZU1ldGhvZE5hbWUgPSBgYWR2YW5jZSR7dXBwZXJDb2x1bW59YFxuICBjb25zdCBoYXNNZXRob2ROYW1lID0gYGhhcyR7dXBwZXJDb2x1bW59YFxuICBjb25zdCBzZXR0ZXJNZXRob2ROYW1lID0gYHNldCR7dXBwZXJDb2x1bW59YFxuXG4gIC8vIE5hcnJvd3MgdGhlIHByb3RvdHlwZSB0byBkeW5hbWljIG1ldGhvZCBhY2Nlc3MgZm9yIHRoZSBjb25maWd1cmVkIGNvbHVtbiBuYW1lLlxuICBjb25zdCBwcm90b3R5cGUgPSAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsID8+fSAqLyAoTW9kZWxDbGFzcy5wcm90b3R5cGUpXG5cbiAgaWYgKHR5cGVvZiBwcm90b3R5cGVbc2V0dGVyTWV0aG9kTmFtZV0gIT0gXCJmdW5jdGlvblwiIHx8IHR5cGVvZiBwcm90b3R5cGVbaGFzTWV0aG9kTmFtZV0gIT0gXCJmdW5jdGlvblwiKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGB3aXRoU2VydmVyU2VxdWVuY2UgcmVxdWlyZXMgZ2VuZXJhdGVkICR7c2V0dGVyTWV0aG9kTmFtZX0gYW5kICR7aGFzTWV0aG9kTmFtZX0gYWNjZXNzb3JzIG9uICR7TW9kZWxDbGFzcy5uYW1lfWApXG4gIH1cblxuICBpZiAodHlwZW9mIHByb3RvdHlwZVthZHZhbmNlTWV0aG9kTmFtZV0gIT0gXCJmdW5jdGlvblwiKSB7XG4gICAgLyoqXG4gICAgICogQXNzaWducyB0aGUgbmV4dCBzZXJ2ZXItc2lkZSBzZXF1ZW5jZS5cbiAgICAgKiBAdGhpcyB7UmVjb3JkPHN0cmluZywgPz59XG4gICAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59XG4gICAgICovXG4gICAgcHJvdG90eXBlW2FkdmFuY2VNZXRob2ROYW1lXSA9IGFzeW5jIGZ1bmN0aW9uIGFkdmFuY2VTZXJ2ZXJTZXF1ZW5jZVRocm91Z2hBbGxvY2F0b3IoKSB7XG4gICAgICB0aGlzW3NldHRlck1ldGhvZE5hbWVdKGF3YWl0IGFsbG9jYXRvci5uZXh0KCkpXG4gICAgfVxuICB9XG5cbiAgTW9kZWxDbGFzcy5iZWZvcmVDcmVhdGUoYXN5bmMgKHJlY29yZCkgPT4ge1xuICAgIC8vIE5hcnJvd3MgdGhlIHJlY29yZCB0byBkeW5hbWljIG1ldGhvZCBhY2Nlc3MgZm9yIHRoZSBjb25maWd1cmVkIGNvbHVtbiBuYW1lLlxuICAgIGNvbnN0IGR5bmFtaWNSZWNvcmQgPSAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsID8+fSAqLyAoLyoqIEB0eXBlIHs/fSAqLyAocmVjb3JkKSlcblxuICAgIGlmIChkeW5hbWljUmVjb3JkW2hhc01ldGhvZE5hbWVdKCkpIHJldHVyblxuXG4gICAgYXdhaXQgZHluYW1pY1JlY29yZFthZHZhbmNlTWV0aG9kTmFtZV0oKVxuICB9KVxuXG4gIHJldHVybiBNb2RlbENsYXNzXG59XG4iXX0=

package/build/src/sync/sync-attribute-normalizer.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Builds the error thrown for a failed sync attribute validation.
+ * @callback SyncAttributeErrorFactory
+ * @param {string} message - Human-readable validation message.
+ * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
+ * @returns {Error} Error to throw.
+ */
+/**
+ * Declarative validation schema for one writable sync attribute.
+ *
+ * Keys are camelCase attribute names; each attribute also accepts its
+ * snake_case column key on input (the camelCase key wins when both are given)
+ * and is written under the snake_case column key on output. Error messages
+ * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
+ * label defaults to the camelCase attribute name; apps pin exact messages per
+ * attribute through the `*Message` overrides.
+ * @typedef {object} SyncAttributeSchemaEntry
+ * @property {"date" | "json" | "raw" | "string"} type - Attribute value type.
+ * @property {boolean} [required] - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
+ * @property {number} [maxLength] - Maximum string length, checked after trimming.
+ * @property {string} [label] - Label used in derived messages and codes.
+ * @property {string} [column] - Output column key. Defaults to the snake_cased attribute name.
+ * @property {string} [requiredMessage] - Pinned message for required rejections.
+ * @property {string} [tooLongMessage] - Pinned message for too-long rejections.
+ * @property {string} [invalidMessage] - Pinned message for invalid dates and non-object/non-string json values.
+ * @property {string} [invalidJsonMessage] - Pinned message for unparseable json strings.
+ */
+/**
+ * Normalizes writable sync attributes against a declarative schema.
+ *
+ * Only present keys are validated, so required attributes may be absent —
+ * create defaults own that concern. Input keys not declared in the schema are
+ * rejected by default so misspelled or read-only attributes fail loudly
+ * instead of being silently discarded (`unknownAttributes: "ignore"` opts
+ * out). Validation failures throw through the given error factory so apps
+ * control the raised error class.
+ * @param {object} args - Options.
+ * @param {Record<string, ?>} args.attributes - Raw incoming attributes (camelCase and/or snake_case keys).
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Maps validation failures to thrown errors.
+ * @param {Record<string, SyncAttributeSchemaEntry>} args.schema - Attribute schema keyed by camelCase attribute name.
+ * @param {"error" | "ignore"} [args.unknownAttributes] - Unknown input-key handling. Defaults to "error".
+ * @returns {Record<string, ?>} Normalized values keyed by snake_case column names.
+ */
+export default function normalizeAttributesWithSchema({ attributes, errorFactory, schema, unknownAttributes }: {
+    attributes: Record<string, unknown>;
+    errorFactory: SyncAttributeErrorFactory;
+    schema: Record<string, SyncAttributeSchemaEntry>;
+    unknownAttributes?: "error" | "ignore" | undefined;
+}): Record<string, unknown>;
+/**
+ * Builds the error thrown for a failed sync attribute validation.
+ */
+export type SyncAttributeErrorFactory = (message: string, details: {
+    cause?: Error;
+    code: string;
+}) => Error;
+/**
+ * Declarative validation schema for one writable sync attribute.
+ *
+ * Keys are camelCase attribute names; each attribute also accepts its
+ * snake_case column key on input (the camelCase key wins when both are given)
+ * and is written under the snake_case column key on output. Error messages
+ * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
+ * label defaults to the camelCase attribute name; apps pin exact messages per
+ * attribute through the `*Message` overrides.
+ */
+export type SyncAttributeSchemaEntry = {
+    /**
+     * - Attribute value type.
+     */
+    type: "date" | "json" | "raw" | "string";
+    /**
+     * - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
+     */
+    required?: boolean | undefined;
+    /**
+     * - Maximum string length, checked after trimming.
+     */
+    maxLength?: number | undefined;
+    /**
+     * - Label used in derived messages and codes.
+     */
+    label?: string | undefined;
+    /**
+     * - Output column key. Defaults to the snake_cased attribute name.
+     */
+    column?: string | undefined;
+    /**
+     * - Pinned message for required rejections.
+     */
+    requiredMessage?: string | undefined;
+    /**
+     * - Pinned message for too-long rejections.
+     */
+    tooLongMessage?: string | undefined;
+    /**
+     * - Pinned message for invalid dates and non-object/non-string json values.
+     */
+    invalidMessage?: string | undefined;
+    /**
+     * - Pinned message for unparseable json strings.
+     */
+    invalidJsonMessage?: string | undefined;
+};
+//# sourceMappingURL=sync-attribute-normalizer.d.ts.map

package/build/src/sync/sync-attribute-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-attribute-normalizer.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-attribute-normalizer.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,+GANG;IAAgC,UAAU,EAAlC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC;IACe,YAAY,EAA5C,yBAAyB;IACsB,MAAM,EAArD,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC;IACd,iBAAiB;CACnD,GAAU,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAqC7B;;;;kDA7EU,MAAM,WACN;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,KAC3B,KAAK;;;;;;;;;;;;;;;UAaJ,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ"}

package/build/src/sync/sync-attribute-normalizer.js

@@ -0,0 +1,172 @@
+// @ts-check
+import { snakeCaseKey } from "typanic";
+/**
+ * Builds the error thrown for a failed sync attribute validation.
+ * @callback SyncAttributeErrorFactory
+ * @param {string} message - Human-readable validation message.
+ * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
+ * @returns {Error} Error to throw.
+ */
+/**
+ * Declarative validation schema for one writable sync attribute.
+ *
+ * Keys are camelCase attribute names; each attribute also accepts its
+ * snake_case column key on input (the camelCase key wins when both are given)
+ * and is written under the snake_case column key on output. Error messages
+ * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
+ * label defaults to the camelCase attribute name; apps pin exact messages per
+ * attribute through the `*Message` overrides.
+ * @typedef {object} SyncAttributeSchemaEntry
+ * @property {"date" | "json" | "raw" | "string"} type - Attribute value type.
+ * @property {boolean} [required] - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
+ * @property {number} [maxLength] - Maximum string length, checked after trimming.
+ * @property {string} [label] - Label used in derived messages and codes.
+ * @property {string} [column] - Output column key. Defaults to the snake_cased attribute name.
+ * @property {string} [requiredMessage] - Pinned message for required rejections.
+ * @property {string} [tooLongMessage] - Pinned message for too-long rejections.
+ * @property {string} [invalidMessage] - Pinned message for invalid dates and non-object/non-string json values.
+ * @property {string} [invalidJsonMessage] - Pinned message for unparseable json strings.
+ */
+/**
+ * Normalizes writable sync attributes against a declarative schema.
+ *
+ * Only present keys are validated, so required attributes may be absent —
+ * create defaults own that concern. Input keys not declared in the schema are
+ * rejected by default so misspelled or read-only attributes fail loudly
+ * instead of being silently discarded (`unknownAttributes: "ignore"` opts
+ * out). Validation failures throw through the given error factory so apps
+ * control the raised error class.
+ * @param {object} args - Options.
+ * @param {Record<string, ?>} args.attributes - Raw incoming attributes (camelCase and/or snake_case keys).
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Maps validation failures to thrown errors.
+ * @param {Record<string, SyncAttributeSchemaEntry>} args.schema - Attribute schema keyed by camelCase attribute name.
+ * @param {"error" | "ignore"} [args.unknownAttributes] - Unknown input-key handling. Defaults to "error".
+ * @returns {Record<string, ?>} Normalized values keyed by snake_case column names.
+ */
+export default function normalizeAttributesWithSchema({ attributes, errorFactory, schema, unknownAttributes = "error" }) {
+    if (!attributes || typeof attributes != "object")
+        throw new Error(`normalizeAttributesWithSchema requires an attributes object, got: ${String(attributes)}`);
+    if (typeof errorFactory != "function")
+        throw new Error("normalizeAttributesWithSchema requires an errorFactory function");
+    if (!schema || typeof schema != "object")
+        throw new Error(`normalizeAttributesWithSchema requires a schema object, got: ${String(schema)}`);
+    if (unknownAttributes != "error" && unknownAttributes != "ignore") {
+        throw new Error(`normalizeAttributesWithSchema unknownAttributes must be "error" or "ignore", got: ${String(unknownAttributes)}`);
+    }
+    /** @type {Record<string, ?>} */
+    const normalized = {};
+    /** @type {Set<string>} */
+    const knownInputKeys = new Set();
+    for (const [attributeName, entry] of Object.entries(schema)) {
+        const column = entry.column ?? snakeCaseKey(attributeName);
+        const inputKeys = column == attributeName ? [attributeName] : [column, attributeName];
+        for (const inputKey of inputKeys) {
+            knownInputKeys.add(inputKey);
+            if (!Object.prototype.hasOwnProperty.call(attributes, inputKey))
+                continue;
+            normalized[column] = normalizeAttributeValue({ attributeName, entry, errorFactory, value: attributes[inputKey] });
+        }
+    }
+    if (unknownAttributes == "error") {
+        for (const inputKey of Object.keys(attributes)) {
+            if (!knownInputKeys.has(inputKey)) {
+                throw errorFactory(`Unknown attribute: ${inputKey}.`, { code: "sync-unknown-attribute" });
+            }
+        }
+    }
+    return normalized;
+}
+/**
+ * Normalizes one present attribute value per its schema entry.
+ * @param {object} args - Options.
+ * @param {string} args.attributeName - camelCase attribute name.
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
+ * @param {?} args.value - Raw value.
+ * @returns {?} Normalized value.
+ */
+function normalizeAttributeValue({ attributeName, entry, errorFactory, value }) {
+    const label = entry.label ?? attributeName;
+    if (entry.type == "string")
+        return normalizeString({ entry, errorFactory, label, value });
+    if (entry.type == "date")
+        return normalizeDate({ entry, errorFactory, label, value });
+    if (entry.type == "json")
+        return normalizeJson({ entry, errorFactory, label, value });
+    if (entry.type == "raw")
+        return value;
+    throw new Error(`Unknown sync attribute schema type for ${attributeName}: ${String(entry.type)}`);
+}
+/**
+ * Normalizes a string attribute: trims, rejects blank required values after trimming, maps empty optional values to null and bounds the trimmed length.
+ * @param {object} args - Options.
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
+ * @param {string} args.label - Message/code label.
+ * @param {?} args.value - Raw value.
+ * @returns {string | null} Normalized string.
+ */
+function normalizeString({ entry, errorFactory, label, value }) {
+    const requiredError = () => errorFactory(entry.requiredMessage ?? `${label} is required.`, { code: `sync-${label}-required` });
+    if (value === null || value === undefined || value === "") {
+        if (entry.required)
+            throw requiredError();
+        return null;
+    }
+    const stringValue = String(value).trim();
+    if (stringValue === "") {
+        if (entry.required)
+            throw requiredError();
+        return null;
+    }
+    if (entry.maxLength !== undefined && stringValue.length > entry.maxLength) {
+        throw errorFactory(entry.tooLongMessage ?? `${label} is too long (maximum is ${entry.maxLength} characters).`, { code: `sync-${label}-too-long` });
+    }
+    return stringValue;
+}
+/**
+ * Normalizes a date attribute: Date instances pass through, strings/numbers are parsed and invalid or missing-required values are rejected.
+ * @param {object} args - Options.
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
+ * @param {string} args.label - Message/code label.
+ * @param {?} args.value - Raw value.
+ * @returns {Date | null} Normalized date.
+ */
+function normalizeDate({ entry, errorFactory, label, value }) {
+    if (!entry.required && (value === null || value === undefined || value === ""))
+        return null;
+    const dateValue = value instanceof Date ? value : typeof value == "string" || typeof value == "number" ? new Date(value) : null;
+    if (!dateValue || Number.isNaN(dateValue.getTime())) {
+        throw errorFactory(entry.invalidMessage ?? `${label} must be a valid datetime.`, { code: `sync-${label}-invalid-datetime` });
+    }
+    return dateValue;
+}
+/**
+ * Normalizes a json attribute: empty values become null, objects pass through, strings must parse as JSON and other types are rejected.
+ * @param {object} args - Options.
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
+ * @param {string} args.label - Message/code label.
+ * @param {?} args.value - Raw value.
+ * @returns {?} Normalized json value.
+ */
+function normalizeJson({ entry, errorFactory, label, value }) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    if (typeof value == "object")
+        return value;
+    if (typeof value == "string") {
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            throw errorFactory(entry.invalidJsonMessage ?? `${label} must be valid JSON.`, {
+                cause: /** @type {Error} */ (error),
+                code: `sync-${label}-invalid-json`
+            });
+        }
+    }
+    throw errorFactory(entry.invalidMessage ?? `${label} must be an object or JSON string.`, { code: `sync-${label}-invalid` });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luYy1hdHRyaWJ1dGUtbm9ybWFsaXplci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zeW5jL3N5bmMtYXR0cmlidXRlLW5vcm1hbGl6ZXIuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxZQUFZLEVBQUMsTUFBTSxTQUFTLENBQUE7QUFFcEM7Ozs7OztHQU1HO0FBRUg7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FtQkc7QUFFSDs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLENBQUMsT0FBTyxVQUFVLDZCQUE2QixDQUFDLEVBQUMsVUFBVSxFQUFFLFlBQVksRUFBRSxNQUFNLEVBQUUsaUJBQWlCLEdBQUcsT0FBTyxFQUFDO0lBQ25ILElBQUksQ0FBQyxVQUFVLElBQUksT0FBTyxVQUFVLElBQUksUUFBUTtRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMscUVBQXFFLE1BQU0sQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDLENBQUE7SUFDNUosSUFBSSxPQUFPLFlBQVksSUFBSSxVQUFVO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxpRUFBaUUsQ0FBQyxDQUFBO0lBQ3pILElBQUksQ0FBQyxNQUFNLElBQUksT0FBTyxNQUFNLElBQUksUUFBUTtRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0VBQWdFLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUE7SUFDM0ksSUFBSSxpQkFBaUIsSUFBSSxPQUFPLElBQUksaUJBQWlCLElBQUksUUFBUSxFQUFFLENBQUM7UUFDbEUsTUFBTSxJQUFJLEtBQUssQ0FBQyxxRkFBcUYsTUFBTSxDQUFDLGlCQUFpQixDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ25JLENBQUM7SUFFRCxnQ0FBZ0M7SUFDaEMsTUFBTSxVQUFVLEdBQUcsRUFBRSxDQUFBO0lBQ3JCLDBCQUEwQjtJQUMxQixNQUFNLGNBQWMsR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFBO0lBRWhDLEtBQUssTUFBTSxDQUFDLGFBQWEsRUFBRSxLQUFLLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDNUQsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLE1BQU0sSUFBSSxZQUFZLENBQUMsYUFBYSxDQUFDLENBQUE7UUFDMUQsTUFBTSxTQUFTLEdBQUcsTUFBTSxJQUFJLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsYUFBYSxDQUFDLENBQUE7UUFFckYsS0FBSyxNQUFNLFFBQVEsSUFBSSxTQUFTLEVBQUUsQ0FBQztZQUNqQyxjQUFjLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFBO1lBRTVCLElBQUksQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLFFBQVEsQ0FBQztnQkFBRSxTQUFRO1lBRXpFLFVBQVUsQ0FBQyxNQUFNLENBQUMsR0FBRyx1QkFBdUIsQ0FBQyxFQUFDLGFBQWEsRUFBRSxLQUFLLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxVQUFVLENBQUMsUUFBUSxDQUFDLEVBQUMsQ0FBQyxDQUFBO1FBQ2pILENBQUM7SUFDSCxDQUFDO0lBRUQsSUFBSSxpQkFBaUIsSUFBSSxPQUFPLEVBQUUsQ0FBQztRQUNqQyxLQUFLLE1BQU0sUUFBUSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztZQUMvQyxJQUFJLENBQUMsY0FBYyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO2dCQUNsQyxNQUFNLFlBQVksQ0FBQyxzQkFBc0IsUUFBUSxHQUFHLEVBQUUsRUFBQyxJQUFJLEVBQUUsd0JBQXdCLEVBQUMsQ0FBQyxDQUFBO1lBQ3pGLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU8sVUFBVSxDQUFBO0FBQ25CLENBQUM7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILFNBQVMsdUJBQXVCLENBQUMsRUFBQyxhQUFhLEVBQUUsS0FBSyxFQUFFLFlBQVksRUFBRSxLQUFLLEVBQUM7SUFDMUUsTUFBTSxLQUFLLEdBQUcsS0FBSyxDQUFDLEtBQUssSUFBSSxhQUFhLENBQUE7SUFFMUMsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLFFBQVE7UUFBRSxPQUFPLGVBQWUsQ0FBQyxFQUFDLEtBQUssRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7SUFDdkYsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLE1BQU07UUFBRSxPQUFPLGFBQWEsQ0FBQyxFQUFDLEtBQUssRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7SUFDbkYsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLE1BQU07UUFBRSxPQUFPLGFBQWEsQ0FBQyxFQUFDLEtBQUssRUFBRSxZQUFZLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7SUFDbkYsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLEtBQUs7UUFBRSxPQUFPLEtBQUssQ0FBQTtJQUVyQyxNQUFNLElBQUksS0FBSyxDQUFDLDBDQUEwQyxhQUFhLEtBQUssTUFBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUE7QUFDbkcsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxlQUFlLENBQUMsRUFBQyxLQUFLLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUM7SUFDMUQsTUFBTSxhQUFhLEdBQUcsR0FBRyxFQUFFLENBQUMsWUFBWSxDQUFDLEtBQUssQ0FBQyxlQUFlLElBQUksR0FBRyxLQUFLLGVBQWUsRUFBRSxFQUFDLElBQUksRUFBRSxRQUFRLEtBQUssV0FBVyxFQUFDLENBQUMsQ0FBQTtJQUU1SCxJQUFJLEtBQUssS0FBSyxJQUFJLElBQUksS0FBSyxLQUFLLFNBQVMsSUFBSSxLQUFLLEtBQUssRUFBRSxFQUFFLENBQUM7UUFDMUQsSUFB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LWNoZWNrXG5cbmltcG9ydCB7c25ha2VDYXNlS2V5fSBmcm9tIFwidHlwYW5pY1wiXG5cbi8qKlxuICogQnVpbGRzIHRoZSBlcnJvciB0aHJvd24gZm9yIGEgZmFpbGVkIHN5bmMgYXR0cmlidXRlIHZhbGlkYXRpb24uXG4gKiBAY2FsbGJhY2sgU3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeVxuICogQHBhcmFtIHtzdHJpbmd9IG1lc3NhZ2UgLSBIdW1hbi1yZWFkYWJsZSB2YWxpZGF0aW9uIG1lc3NhZ2UuXG4gKiBAcGFyYW0ge3tjYXVzZT86IEVycm9yLCBjb2RlOiBzdHJpbmd9fSBkZXRhaWxzIC0gU3RhYmxlIG1hY2hpbmUtcmVhZGFibGUgY29kZSBhbmQgb3B0aW9uYWwgY2F1c2UuXG4gKiBAcmV0dXJucyB7RXJyb3J9IEVycm9yIHRvIHRocm93LlxuICovXG5cbi8qKlxuICogRGVjbGFyYXRpdmUgdmFsaWRhdGlvbiBzY2hlbWEgZm9yIG9uZSB3cml0YWJsZSBzeW5jIGF0dHJpYnV0ZS5cbiAqXG4gKiBLZXlzIGFyZSBjYW1lbENhc2UgYXR0cmlidXRlIG5hbWVzOyBlYWNoIGF0dHJpYnV0ZSBhbHNvIGFjY2VwdHMgaXRzXG4gKiBzbmFrZV9jYXNlIGNvbHVtbiBrZXkgb24gaW5wdXQgKHRoZSBjYW1lbENhc2Uga2V5IHdpbnMgd2hlbiBib3RoIGFyZSBnaXZlbilcbiAqIGFuZCBpcyB3cml0dGVuIHVuZGVyIHRoZSBzbmFrZV9jYXNlIGNvbHVtbiBrZXkgb24gb3V0cHV0LiBFcnJvciBtZXNzYWdlc1xuICogZGVmYXVsdCB0byBgPGxhYmVsPiAuLi5gIHBocmFzaW5ncyB3aXRoIGBzeW5jLTxsYWJlbD4tLi4uYCBjb2Rlcywgd2hlcmUgdGhlXG4gKiBsYWJlbCBkZWZhdWx0cyB0byB0aGUgY2FtZWxDYXNlIGF0dHJpYnV0ZSBuYW1lOyBhcHBzIHBpbiBleGFjdCBtZXNzYWdlcyBwZXJcbiAqIGF0dHJpYnV0ZSB0aHJvdWdoIHRoZSBgKk1lc3NhZ2VgIG92ZXJyaWRlcy5cbiAqIEB0eXBlZGVmIHtvYmplY3R9IFN5bmNBdHRyaWJ1dGVTY2hlbWFFbnRyeVxuICogQHByb3BlcnR5IHtcImRhdGVcIiB8IFwianNvblwiIHwgXCJyYXdcIiB8IFwic3RyaW5nXCJ9IHR5cGUgLSBBdHRyaWJ1dGUgdmFsdWUgdHlwZS5cbiAqIEBwcm9wZXJ0eSB7Ym9vbGVhbn0gW3JlcXVpcmVkXSAtIFdoZXRoZXIgcHJlc2VudCBibGFuay9hYnNlbnQgdmFsdWVzIGFyZSByZWplY3RlZCAoc3RyaW5ncyByZWplY3QgYmxhbmstYWZ0ZXItdHJpbSwgZGF0ZXMgcmVqZWN0IG51bGwpLlxuICogQHByb3BlcnR5IHtudW1iZXJ9IFttYXhMZW5ndGhdIC0gTWF4aW11bSBzdHJpbmcgbGVuZ3RoLCBjaGVja2VkIGFmdGVyIHRyaW1taW5nLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtsYWJlbF0gLSBMYWJlbCB1c2VkIGluIGRlcml2ZWQgbWVzc2FnZXMgYW5kIGNvZGVzLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IFtjb2x1bW5dIC0gT3V0cHV0IGNvbHVtbiBrZXkuIERlZmF1bHRzIHRvIHRoZSBzbmFrZV9jYXNlZCBhdHRyaWJ1dGUgbmFtZS5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbcmVxdWlyZWRNZXNzYWdlXSAtIFBpbm5lZCBtZXNzYWdlIGZvciByZXF1aXJlZCByZWplY3Rpb25zLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IFt0b29Mb25nTWVzc2FnZV0gLSBQaW5uZWQgbWVzc2FnZSBmb3IgdG9vLWxvbmcgcmVqZWN0aW9ucy5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbaW52YWxpZE1lc3NhZ2VdIC0gUGlubmVkIG1lc3NhZ2UgZm9yIGludmFsaWQgZGF0ZXMgYW5kIG5vbi1vYmplY3Qvbm9uLXN0cmluZyBqc29uIHZhbHVlcy5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBbaW52YWxpZEpzb25NZXNzYWdlXSAtIFBpbm5lZCBtZXNzYWdlIGZvciB1bnBhcnNlYWJsZSBqc29uIHN0cmluZ3MuXG4gKi9cblxuLyoqXG4gKiBOb3JtYWxpemVzIHdyaXRhYmxlIHN5bmMgYXR0cmlidXRlcyBhZ2FpbnN0IGEgZGVjbGFyYXRpdmUgc2NoZW1hLlxuICpcbiAqIE9ubHkgcHJlc2VudCBrZXlzIGFyZSB2YWxpZGF0ZWQsIHNvIHJlcXVpcmVkIGF0dHJpYnV0ZXMgbWF5IGJlIGFic2VudCDigJRcbiAqIGNyZWF0ZSBkZWZhdWx0cyBvd24gdGhhdCBjb25jZXJuLiBJbnB1dCBrZXlzIG5vdCBkZWNsYXJlZCBpbiB0aGUgc2NoZW1hIGFyZVxuICogcmVqZWN0ZWQgYnkgZGVmYXVsdCBzbyBtaXNzcGVsbGVkIG9yIHJlYWQtb25seSBhdHRyaWJ1dGVzIGZhaWwgbG91ZGx5XG4gKiBpbnN0ZWFkIG9mIGJlaW5nIHNpbGVudGx5IGRpc2NhcmRlZCAoYHVua25vd25BdHRyaWJ1dGVzOiBcImlnbm9yZVwiYCBvcHRzXG4gKiBvdXQpLiBWYWxpZGF0aW9uIGZhaWx1cmVzIHRocm93IHRocm91Z2ggdGhlIGdpdmVuIGVycm9yIGZhY3Rvcnkgc28gYXBwc1xuICogY29udHJvbCB0aGUgcmFpc2VkIGVycm9yIGNsYXNzLlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBPcHRpb25zLlxuICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gYXJncy5hdHRyaWJ1dGVzIC0gUmF3IGluY29taW5nIGF0dHJpYnV0ZXMgKGNhbWVsQ2FzZSBhbmQvb3Igc25ha2VfY2FzZSBrZXlzKS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeX0gYXJncy5lcnJvckZhY3RvcnkgLSBNYXBzIHZhbGlkYXRpb24gZmFpbHVyZXMgdG8gdGhyb3duIGVycm9ycy5cbiAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgU3luY0F0dHJpYnV0ZVNjaGVtYUVudHJ5Pn0gYXJncy5zY2hlbWEgLSBBdHRyaWJ1dGUgc2NoZW1hIGtleWVkIGJ5IGNhbWVsQ2FzZSBhdHRyaWJ1dGUgbmFtZS5cbiAqIEBwYXJhbSB7XCJlcnJvclwiIHwgXCJpZ25vcmVcIn0gW2FyZ3MudW5rbm93bkF0dHJpYnV0ZXNdIC0gVW5rbm93biBpbnB1dC1rZXkgaGFuZGxpbmcuIERlZmF1bHRzIHRvIFwiZXJyb3JcIi5cbiAqIEByZXR1cm5zIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gTm9ybWFsaXplZCB2YWx1ZXMga2V5ZWQgYnkgc25ha2VfY2FzZSBjb2x1bW4gbmFtZXMuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGZ1bmN0aW9uIG5vcm1hbGl6ZUF0dHJpYnV0ZXNXaXRoU2NoZW1hKHthdHRyaWJ1dGVzLCBlcnJvckZhY3RvcnksIHNjaGVtYSwgdW5rbm93bkF0dHJpYnV0ZXMgPSBcImVycm9yXCJ9KSB7XG4gIGlmICghYXR0cmlidXRlcyB8fCB0eXBlb2YgYXR0cmlidXRlcyAhPSBcIm9iamVjdFwiKSB0aHJvdyBuZXcgRXJyb3IoYG5vcm1hbGl6ZUF0dHJpYnV0ZXNXaXRoU2NoZW1hIHJlcXVpcmVzIGFuIGF0dHJpYnV0ZXMgb2JqZWN0LCBnb3Q6ICR7U3RyaW5nKGF0dHJpYnV0ZXMpfWApXG4gIGlmICh0eXBlb2YgZXJyb3JGYWN0b3J5ICE9IFwiZnVuY3Rpb25cIikgdGhyb3cgbmV3IEVycm9yKFwibm9ybWFsaXplQXR0cmlidXRlc1dpdGhTY2hlbWEgcmVxdWlyZXMgYW4gZXJyb3JGYWN0b3J5IGZ1bmN0aW9uXCIpXG4gIGlmICghc2NoZW1hIHx8IHR5cGVvZiBzY2hlbWEgIT0gXCJvYmplY3RcIikgdGhyb3cgbmV3IEVycm9yKGBub3JtYWxpemVBdHRyaWJ1dGVzV2l0aFNjaGVtYSByZXF1aXJlcyBhIHNjaGVtYSBvYmplY3QsIGdvdDogJHtTdHJpbmcoc2NoZW1hKX1gKVxuICBpZiAodW5rbm93bkF0dHJpYnV0ZXMgIT0gXCJlcnJvclwiICYmIHVua25vd25BdHRyaWJ1dGVzICE9IFwiaWdub3JlXCIpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoYG5vcm1hbGl6ZUF0dHJpYnV0ZXNXaXRoU2NoZW1hIHVua25vd25BdHRyaWJ1dGVzIG11c3QgYmUgXCJlcnJvclwiIG9yIFwiaWdub3JlXCIsIGdvdDogJHtTdHJpbmcodW5rbm93bkF0dHJpYnV0ZXMpfWApXG4gIH1cblxuICAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsID8+fSAqL1xuICBjb25zdCBub3JtYWxpemVkID0ge31cbiAgLyoqIEB0eXBlIHtTZXQ8c3RyaW5nPn0gKi9cbiAgY29uc3Qga25vd25JbnB1dEtleXMgPSBuZXcgU2V0KClcblxuICBmb3IgKGNvbnN0IFthdHRyaWJ1dGVOYW1lLCBlbnRyeV0gb2YgT2JqZWN0LmVudHJpZXMoc2NoZW1hKSkge1xuICAgIGNvbnN0IGNvbHVtbiA9IGVudHJ5LmNvbHVtbiA/PyBzbmFrZUNhc2VLZXkoYXR0cmlidXRlTmFtZSlcbiAgICBjb25zdCBpbnB1dEtleXMgPSBjb2x1bW4gPT0gYXR0cmlidXRlTmFtZSA/IFthdHRyaWJ1dGVOYW1lXSA6IFtjb2x1bW4sIGF0dHJpYnV0ZU5hbWVdXG5cbiAgICBmb3IgKGNvbnN0IGlucHV0S2V5IG9mIGlucHV0S2V5cykge1xuICAgICAga25vd25JbnB1dEtleXMuYWRkKGlucHV0S2V5KVxuXG4gICAgICBpZiAoIU9iamVjdC5wcm90b3R5cGUuaGFzT3duUHJvcGVydHkuY2FsbChhdHRyaWJ1dGVzLCBpbnB1dEtleSkpIGNvbnRpbnVlXG5cbiAgICAgIG5vcm1hbGl6ZWRbY29sdW1uXSA9IG5vcm1hbGl6ZUF0dHJpYnV0ZVZhbHVlKHthdHRyaWJ1dGVOYW1lLCBlbnRyeSwgZXJyb3JGYWN0b3J5LCB2YWx1ZTogYXR0cmlidXRlc1tpbnB1dEtleV19KVxuICAgIH1cbiAgfVxuXG4gIGlmICh1bmtub3duQXR0cmlidXRlcyA9PSBcImVycm9yXCIpIHtcbiAgICBmb3IgKGNvbnN0IGlucHV0S2V5IG9mIE9iamVjdC5rZXlzKGF0dHJpYnV0ZXMpKSB7XG4gICAgICBpZiAoIWtub3duSW5wdXRLZXlzLmhhcyhpbnB1dEtleSkpIHtcbiAgICAgICAgdGhyb3cgZXJyb3JGYWN0b3J5KGBVbmtub3duIGF0dHJpYnV0ZTogJHtpbnB1dEtleX0uYCwge2NvZGU6IFwic3luYy11bmtub3duLWF0dHJpYnV0ZVwifSlcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICByZXR1cm4gbm9ybWFsaXplZFxufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgb25lIHByZXNlbnQgYXR0cmlidXRlIHZhbHVlIHBlciBpdHMgc2NoZW1hIGVudHJ5LlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBPcHRpb25zLlxuICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MuYXR0cmlidXRlTmFtZSAtIGNhbWVsQ2FzZSBhdHRyaWJ1dGUgbmFtZS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZVNjaGVtYUVudHJ5fSBhcmdzLmVudHJ5IC0gU2NoZW1hIGVudHJ5LlxuICogQHBhcmFtIHtTeW5jQXR0cmlidXRlRXJyb3JGYWN0b3J5fSBhcmdzLmVycm9yRmFjdG9yeSAtIEVycm9yIGZhY3RvcnkuXG4gKiBAcGFyYW0gez99IGFyZ3MudmFsdWUgLSBSYXcgdmFsdWUuXG4gKiBAcmV0dXJucyB7P30gTm9ybWFsaXplZCB2YWx1ZS5cbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplQXR0cmlidXRlVmFsdWUoe2F0dHJpYnV0ZU5hbWUsIGVudHJ5LCBlcnJvckZhY3RvcnksIHZhbHVlfSkge1xuICBjb25zdCBsYWJlbCA9IGVudHJ5LmxhYmVsID8/IGF0dHJpYnV0ZU5hbWVcblxuICBpZiAoZW50cnkudHlwZSA9PSBcInN0cmluZ1wiKSByZXR1cm4gbm9ybWFsaXplU3RyaW5nKHtlbnRyeSwgZXJyb3JGYWN0b3J5LCBsYWJlbCwgdmFsdWV9KVxuICBpZiAoZW50cnkudHlwZSA9PSBcImRhdGVcIikgcmV0dXJuIG5vcm1hbGl6ZURhdGUoe2VudHJ5LCBlcnJvckZhY3RvcnksIGxhYmVsLCB2YWx1ZX0pXG4gIGlmIChlbnRyeS50eXBlID09IFwianNvblwiKSByZXR1cm4gbm9ybWFsaXplSnNvbih7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSlcbiAgaWYgKGVudHJ5LnR5cGUgPT0gXCJyYXdcIikgcmV0dXJuIHZhbHVlXG5cbiAgdGhyb3cgbmV3IEVycm9yKGBVbmtub3duIHN5bmMgYXR0cmlidXRlIHNjaGVtYSB0eXBlIGZvciAke2F0dHJpYnV0ZU5hbWV9OiAke1N0cmluZyhlbnRyeS50eXBlKX1gKVxufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgYSBzdHJpbmcgYXR0cmlidXRlOiB0cmltcywgcmVqZWN0cyBibGFuayByZXF1aXJlZCB2YWx1ZXMgYWZ0ZXIgdHJpbW1pbmcsIG1hcHMgZW1wdHkgb3B0aW9uYWwgdmFsdWVzIHRvIG51bGwgYW5kIGJvdW5kcyB0aGUgdHJpbW1lZCBsZW5ndGguXG4gKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIE9wdGlvbnMuXG4gKiBAcGFyYW0ge1N5bmNBdHRyaWJ1dGVTY2hlbWFFbnRyeX0gYXJncy5lbnRyeSAtIFNjaGVtYSBlbnRyeS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeX0gYXJncy5lcnJvckZhY3RvcnkgLSBFcnJvciBmYWN0b3J5LlxuICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MubGFiZWwgLSBNZXNzYWdlL2NvZGUgbGFiZWwuXG4gKiBAcGFyYW0gez99IGFyZ3MudmFsdWUgLSBSYXcgdmFsdWUuXG4gKiBAcmV0dXJucyB7c3RyaW5nIHwgbnVsbH0gTm9ybWFsaXplZCBzdHJpbmcuXG4gKi9cbmZ1bmN0aW9uIG5vcm1hbGl6ZVN0cmluZyh7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSkge1xuICBjb25zdCByZXF1aXJlZEVycm9yID0gKCkgPT4gZXJyb3JGYWN0b3J5KGVudHJ5LnJlcXVpcmVkTWVzc2FnZSA/PyBgJHtsYWJlbH0gaXMgcmVxdWlyZWQuYCwge2NvZGU6IGBzeW5jLSR7bGFiZWx9LXJlcXVpcmVkYH0pXG5cbiAgaWYgKHZhbHVlID09PSBudWxsIHx8IHZhbHVlID09PSB1bmRlZmluZWQgfHwgdmFsdWUgPT09IFwiXCIpIHtcbiAgICBpZiAoZW50cnkucmVxdWlyZWQpIHRocm93IHJlcXVpcmVkRXJyb3IoKVxuXG4gICAgcmV0dXJuIG51bGxcbiAgfVxuXG4gIGNvbnN0IHN0cmluZ1ZhbHVlID0gU3RyaW5nKHZhbHVlKS50cmltKClcblxuICBpZiAoc3RyaW5nVmFsdWUgPT09IFwiXCIpIHtcbiAgICBpZiAoZW50cnkucmVxdWlyZWQpIHRocm93IHJlcXVpcmVkRXJyb3IoKVxuXG4gICAgcmV0dXJuIG51bGxcbiAgfVxuXG4gIGlmIChlbnRyeS5tYXhMZW5ndGggIT09IHVuZGVmaW5lZCAmJiBzdHJpbmdWYWx1ZS5sZW5ndGggPiBlbnRyeS5tYXhMZW5ndGgpIHtcbiAgICB0aHJvdyBlcnJvckZhY3RvcnkoZW50cnkudG9vTG9uZ01lc3NhZ2UgPz8gYCR7bGFiZWx9IGlzIHRvbyBsb25nIChtYXhpbXVtIGlzICR7ZW50cnkubWF4TGVuZ3RofSBjaGFyYWN0ZXJzKS5gLCB7Y29kZTogYHN5bmMtJHtsYWJlbH0tdG9vLWxvbmdgfSlcbiAgfVxuXG4gIHJldHVybiBzdHJpbmdWYWx1ZVxufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgYSBkYXRlIGF0dHJpYnV0ZTogRGF0ZSBpbnN0YW5jZXMgcGFzcyB0aHJvdWdoLCBzdHJpbmdzL251bWJlcnMgYXJlIHBhcnNlZCBhbmQgaW52YWxpZCBvciBtaXNzaW5nLXJlcXVpcmVkIHZhbHVlcyBhcmUgcmVqZWN0ZWQuXG4gKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIE9wdGlvbnMuXG4gKiBAcGFyYW0ge1N5bmNBdHRyaWJ1dGVTY2hlbWFFbnRyeX0gYXJncy5lbnRyeSAtIFNjaGVtYSBlbnRyeS5cbiAqIEBwYXJhbSB7U3luY0F0dHJpYnV0ZUVycm9yRmFjdG9yeX0gYXJncy5lcnJvckZhY3RvcnkgLSBFcnJvciBmYWN0b3J5LlxuICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MubGFiZWwgLSBNZXNzYWdlL2NvZGUgbGFiZWwuXG4gKiBAcGFyYW0gez99IGFyZ3MudmFsdWUgLSBSYXcgdmFsdWUuXG4gKiBAcmV0dXJucyB7RGF0ZSB8IG51bGx9IE5vcm1hbGl6ZWQgZGF0ZS5cbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplRGF0ZSh7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSkge1xuICBpZiAoIWVudHJ5LnJlcXVpcmVkICYmICh2YWx1ZSA9PT0gbnVsbCB8fCB2YWx1ZSA9PT0gdW5kZWZpbmVkIHx8IHZhbHVlID09PSBcIlwiKSkgcmV0dXJuIG51bGxcblxuICBjb25zdCBkYXRlVmFsdWUgPSB2YWx1ZSBpbnN0YW5jZW9mIERhdGUgPyB2YWx1ZSA6IHR5cGVvZiB2YWx1ZSA9PSBcInN0cmluZ1wiIHx8IHR5cGVvZiB2YWx1ZSA9PSBcIm51bWJlclwiID8gbmV3IERhdGUodmFsdWUpIDogbnVsbFxuXG4gIGlmICghZGF0ZVZhbHVlIHx8IE51bWJlci5pc05hTihkYXRlVmFsdWUuZ2V0VGltZSgpKSkge1xuICAgIHRocm93IGVycm9yRmFjdG9yeShlbnRyeS5pbnZhbGlkTWVzc2FnZSA/PyBgJHtsYWJlbH0gbXVzdCBiZSBhIHZhbGlkIGRhdGV0aW1lLmAsIHtjb2RlOiBgc3luYy0ke2xhYmVsfS1pbnZhbGlkLWRhdGV0aW1lYH0pXG4gIH1cblxuICByZXR1cm4gZGF0ZVZhbHVlXG59XG5cbi8qKlxuICogTm9ybWFsaXplcyBhIGpzb24gYXR0cmlidXRlOiBlbXB0eSB2YWx1ZXMgYmVjb21lIG51bGwsIG9iamVjdHMgcGFzcyB0aHJvdWdoLCBzdHJpbmdzIG11c3QgcGFyc2UgYXMgSlNPTiBhbmQgb3RoZXIgdHlwZXMgYXJlIHJlamVjdGVkLlxuICogQHBhcmFtIHtvYmplY3R9IGFyZ3MgLSBPcHRpb25zLlxuICogQHBhcmFtIHtTeW5jQXR0cmlidXRlU2NoZW1hRW50cnl9IGFyZ3MuZW50cnkgLSBTY2hlbWEgZW50cnkuXG4gKiBAcGFyYW0ge1N5bmNBdHRyaWJ1dGVFcnJvckZhY3Rvcnl9IGFyZ3MuZXJyb3JGYWN0b3J5IC0gRXJyb3IgZmFjdG9yeS5cbiAqIEBwYXJhbSB7c3RyaW5nfSBhcmdzLmxhYmVsIC0gTWVzc2FnZS9jb2RlIGxhYmVsLlxuICogQHBhcmFtIHs/fSBhcmdzLnZhbHVlIC0gUmF3IHZhbHVlLlxuICogQHJldHVybnMgez99IE5vcm1hbGl6ZWQganNvbiB2YWx1ZS5cbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplSnNvbih7ZW50cnksIGVycm9yRmFjdG9yeSwgbGFiZWwsIHZhbHVlfSkge1xuICBpZiAodmFsdWUgPT09IG51bGwgfHwgdmFsdWUgPT09IHVuZGVmaW5lZCB8fCB2YWx1ZSA9PT0gXCJcIikgcmV0dXJuIG51bGxcbiAgaWYgKHR5cGVvZiB2YWx1ZSA9PSBcIm9iamVjdFwiKSByZXR1cm4gdmFsdWVcblxuICBpZiAodHlwZW9mIHZhbHVlID09IFwic3RyaW5nXCIpIHtcbiAgICB0cnkge1xuICAgICAgcmV0dXJuIEpTT04ucGFyc2UodmFsdWUpXG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHRocm93IGVycm9yRmFjdG9yeShlbnRyeS5pbnZhbGlkSnNvbk1lc3NhZ2UgPz8gYCR7bGFiZWx9IG11c3QgYmUgdmFsaWQgSlNPTi5gLCB7XG4gICAgICAgIGNhdXNlOiAvKiogQHR5cGUge0Vycm9yfSAqLyAoZXJyb3IpLFxuICAgICAgICBjb2RlOiBgc3luYy0ke2xhYmVsfS1pbnZhbGlkLWpzb25gXG4gICAgICB9KVxuICAgIH1cbiAgfVxuXG4gIHRocm93IGVycm9yRmFjdG9yeShlbnRyeS5pbnZhbGlkTWVzc2FnZSA/PyBgJHtsYWJlbH0gbXVzdCBiZSBhbiBvYmplY3Qgb3IgSlNPTiBzdHJpbmcuYCwge2NvZGU6IGBzeW5jLSR7bGFiZWx9LWludmFsaWRgfSlcbn1cbiJdfQ==

package/build/src/sync/sync-resource-base.d.ts

@@ -14,6 +14,54 @@
  * @augments {FrontendModelBaseResource<TModelClass>}
  */
 export default class SyncResourceBase<TModelClass extends typeof import("../database/record/index.js").default = typeof import("../database/record/index.js").default> extends FrontendModelBaseResource<TModelClass> {
+    /**
+     * Declarative quick-search text columns. When declared, an index search on
+     * the pseudo-column `quickSearch` expands to an OR of LIKE conditions over
+     * these root-table columns instead of hitting the controller default.
+     * @type {string[] | null} */
+    static quickSearchColumns: string[] | null;
+    /**
+     * Declarative writable-attribute schema consumed by
+     * {@link SyncResourceBase#normalizeWritableAttributes}, keyed by camelCase
+     * attribute name.
+     * @type {Record<string, import("./sync-attribute-normalizer.js").SyncAttributeSchemaEntry> | null} */
+    static writableAttributes: Record<string, import("./sync-attribute-normalizer.js").SyncAttributeSchemaEntry> | null;
+    /**
+     * Expands a `quickSearch` pseudo-column search into an OR of LIKE conditions
+     * over the declared {@link SyncResourceBase.quickSearchColumns}.
+     * @param {object} args - Search args.
+     * @param {import("../frontend-model-resource/base-resource.js").FrontendModelResourceAnyQuery} args.query - Query to filter.
+     * @param {import("../frontend-model-resource/base-resource.js").FrontendModelResourceSearch} args.search - Search payload.
+     * @returns {boolean} Whether the search was handled as a quick search.
+     */
+    applyQuickSearch({ query, search }: {
+        query: import("../frontend-model-resource/base-resource.js").FrontendModelResourceAnyQuery;
+        search: import("../frontend-model-resource/base-resource.js").FrontendModelResourceSearch;
+    }): boolean;
+    /**
+     * Normalizes incoming writable attributes through the declared
+     * {@link SyncResourceBase.writableAttributes} schema: camelCase and
+     * snake_case input keys are accepted, values are validated per type and the
+     * normalized values are written under snake_case column keys. Validation
+     * failures throw client-safe errors built by
+     * {@link SyncResourceBase#writableAttributeError}.
+     * @param {Record<string, ?>} attributes - Raw incoming attributes.
+     * @param {{unknownAttributes?: "error" | "ignore"}} [options] - Unknown input-key handling. Defaults to "error".
+     * @returns {Record<string, ?>} Normalized attributes keyed by column names.
+     */
+    normalizeWritableAttributes(attributes: Record<string, unknown>, options?: {
+        unknownAttributes?: "error" | "ignore";
+    }): Record<string, unknown>;
+    /**
+     * Builds the client-safe error thrown for a failed writable-attribute validation.
+     * @param {string} message - Human-readable validation message.
+     * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
+     * @returns {Error} Client-safe error.
+     */
+    writableAttributeError(message: string, { cause, code }: {
+        cause?: Error;
+        code: string;
+    }): Error;
     /**
      * Returns a stable change-feed page after app authorization.
      * @returns {Promise<Record<string, ?>>} Change-feed page result.

package/build/src/sync/sync-resource-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-resource-base.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-resource-base.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,sCAHqE,WAAW,SAAnE,cAAe,6BAA6B,EAAE,OAAQ;IAIjE;;;OAGG;IACH,WAFa,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC,CAStC;IAED;;;OAGG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC,CAQtC;IAED;;;;OAIG;IACH,qBAHW,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,GACf,sBAAsB,GAAG,IAAI,CAoBzC;IAED;;;;OAIG;IACH,qCAHW;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAC,GAC/D;QAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC,CAAA;KAAC,CAQvD;IAED;;;OAGG;IACH,sBAFa,OAAO,mCAAmC,EAAE,OAAO,CAM/D;IAED;;;OAGG;IACH,qBAFa,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAI7B;IAED;;;OAGG;IACH,kBAFa,cAAc,6BAA6B,EAAE,OAAO,CAQhE;IAED;;;;OAIG;IACH,wBAHW;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAC,GAC/D,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;;OAIG;IACH,yBAHW;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,KAAK,EAAE,OAAO,wCAAwC,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAC,GAChI,IAAI,CAIhB;IAED;;;OAGG;IACH,sBAFa,cAAc,mCAAmC,EAAE,OAAO,CAItE;CACF;;;;;;;;gBApIa,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC;;;;kBACjB,MAAM;;sCAPkB,6CAA6C"}
+{"version":3,"file":"sync-resource-base.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-resource-base.js"],"names":[],"mappings":"AAWA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,sCAHqE,WAAW,SAAnE,cAAe,6BAA6B,EAAE,OAAQ;IAIjE;;;;iCAI6B;IAC7B,2BADU,MAAM,EAAE,GAAG,IAAI,CACO;IAEhC;;;;0GAIsG;IACtG,2BADU,MAAM,CAAC,MAAM,EAAE,OAAO,gCAAgC,EAAE,wBAAwB,CAAC,GAAG,IAAI,CAClE;IAgBhC;;;;;;;OAOG;IACH,oCAJG;QAAkG,KAAK,EAA/F,OAAO,6CAA6C,EAAE,6BAA6B;QACK,MAAM,EAA9F,OAAO,6CAA6C,EAAE,2BAA2B;KACzF,GAAU,OAAO,CA6BnB;IAED;;;;;;;;;;OAUG;IACH,wCAJW,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,YACjB;QAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;KAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAa7B;IAED;;;;;OAKG;IACH,gCAJW,MAAM,mBACN;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAC3B,KAAK,CAIjB;IAED;;;OAGG;IACH,WAFa,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC,CAStC;IAED;;;OAGG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC,CAQtC;IAED;;;;OAIG;IACH,qBAHW,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,GACf,sBAAsB,GAAG,IAAI,CAoBzC;IAED;;;;OAIG;IACH,qCAHW;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAC,GAC/D;QAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC,CAAA;KAAC,CAQvD;IAED;;;OAGG;IACH,sBAFa,OAAO,mCAAmC,EAAE,OAAO,CAM/D;IAED;;;OAGG;IACH,qBAFa,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAI7B;IAED;;;OAGG;IACH,kBAFa,cAAc,6BAA6B,EAAE,OAAO,CAQhE;IAED;;;;OAIG;IACH,wBAHW;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAC,GAC/D,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;;OAIG;IACH,yBAHW;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,KAAK,EAAE,OAAO,wCAAwC,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAA;KAAC,GAChI,IAAI,CAIhB;IAED;;;OAGG;IACH,sBAFa,cAAc,mCAAmC,EAAE,OAAO,CAItE;CACF;;;;;;;;gBAvOa,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC;;;;kBACjB,MAAM;;sCAXkB,6CAA6C"}