velocious 1.0.493 → 1.0.494

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"root":["../index.js","../bin/velocious.js","../src/application.js","../src/configuration-resolver.js","../src/configuration-types.js","../src/configuration.js","../src/controller.js","../src/current-configuration.js","../src/current.js","../src/error-logger.js","../src/frontend-model-controller.js","../src/initializer.js","../src/logger.js","../src/mailer.js","../src/record-payload-values.js","../src/time-zone.js","../src/velocious-error.js","../src/authorization/ability.js","../src/authorization/base-resource.js","../src/background-jobs/client.js","../src/background-jobs/cron-expression.js","../src/background-jobs/forked-runner-child.js","../src/background-jobs/job-record.js","../src/background-jobs/job-registry.js","../src/background-jobs/job-runner.js","../src/background-jobs/job.js","../src/background-jobs/json-socket.js","../src/background-jobs/main.js","../src/background-jobs/normalize-error.js","../src/background-jobs/scheduler.js","../src/background-jobs/socket-request.js","../src/background-jobs/status-reporter.js","../src/background-jobs/store.js","../src/background-jobs/types.js","../src/background-jobs/worker.js","../src/background-jobs/web/authorization.js","../src/background-jobs/web/controller.js","../src/background-jobs/web/index.js","../src/background-jobs/web/path-matcher.js","../src/background-jobs/web/registry.js","../src/beacon/client.js","../src/beacon/in-process-broker.js","../src/beacon/in-process-client.js","../src/beacon/server.js","../src/beacon/types.js","../src/cli/base-command.js","../src/cli/browser-cli.js","../src/cli/index.js","../src/cli/tenant-database-command-helper.js","../src/cli/use-browser-cli.js","../src/cli/commands/background-jobs-main.js","../src/cli/commands/background-jobs-runner.js","../src/cli/commands/background-jobs-worker.js","../src/cli/commands/beacon.js","../src/cli/commands/console.js","../src/cli/commands/init.js","../src/cli/commands/routes.js","../src/cli/commands/run-script.js","../src/cli/commands/runner.js","../src/cli/commands/server.js","../src/cli/commands/test.js","../src/cli/commands/db/base-command.js","../src/cli/commands/db/create.js","../src/cli/commands/db/drop.js","../src/cli/commands/db/migrate.js","../src/cli/commands/db/reset.js","../src/cli/commands/db/rollback.js","../src/cli/commands/db/seed.js","../src/cli/commands/db/schema/dump.js","../src/cli/commands/db/schema/load.js","../src/cli/commands/db/tenants/check.js","../src/cli/commands/db/tenants/create.js","../src/cli/commands/db/tenants/drop.js","../src/cli/commands/db/tenants/migrate.js","../src/cli/commands/destroy/migration.js","../src/cli/commands/generate/base-models.js","../src/cli/commands/generate/frontend-models.js","../src/cli/commands/generate/migration.js","../src/cli/commands/generate/model.js","../src/cli/commands/lint/relationships.js","../src/database/annotations-async-hooks.js","../src/database/annotations.js","../src/database/datetime-storage.js","../src/database/handler.js","../src/database/initializer-from-require-context.js","../src/database/migrations-ledger.js","../src/database/migrator.js","../src/database/use-database.js","../src/database/drivers/base-column.js","../src/database/drivers/base-columns-index.js","../src/database/drivers/base-foreign-key.js","../src/database/drivers/base-table.js","../src/database/drivers/base.js","../src/database/drivers/mssql/column.js","../src/database/drivers/mssql/columns-index.js","../src/database/drivers/mssql/connect-connection.js","../src/database/drivers/mssql/foreign-key.js","../src/database/drivers/mssql/index.js","../src/database/drivers/mssql/options.js","../src/database/drivers/mssql/query-parser.js","../src/database/drivers/mssql/structure-sql.js","../src/database/drivers/mssql/table.js","../src/database/drivers/mssql/sql/alter-table.js","../src/database/drivers/mssql/sql/create-database.js","../src/database/drivers/mssql/sql/create-index.js","../src/database/drivers/mssql/sql/create-table.js","../src/database/drivers/mssql/sql/delete.js","../src/database/drivers/mssql/sql/drop-database.js","../src/database/drivers/mssql/sql/drop-table.js","../src/database/drivers/mssql/sql/insert.js","../src/database/drivers/mssql/sql/remove-index.js","../src/database/drivers/mssql/sql/update.js","../src/database/drivers/mssql/sql/upsert.js","../src/database/drivers/mysql/column.js","../src/database/drivers/mysql/columns-index.js","../src/database/drivers/mysql/foreign-key.js","../src/database/drivers/mysql/index.js","../src/database/drivers/mysql/options.js","../src/database/drivers/mysql/query-parser.js","../src/database/drivers/mysql/query.js","../src/database/drivers/mysql/structure-sql.js","../src/database/drivers/mysql/table.js","../src/database/drivers/mysql/sql/alter-table.js","../src/database/drivers/mysql/sql/create-database.js","../src/database/drivers/mysql/sql/create-index.js","../src/database/drivers/mysql/sql/create-table.js","../src/database/drivers/mysql/sql/delete.js","../src/database/drivers/mysql/sql/drop-database.js","../src/database/drivers/mysql/sql/drop-table.js","../src/database/drivers/mysql/sql/insert.js","../src/database/drivers/mysql/sql/remove-index.js","../src/database/drivers/mysql/sql/update.js","../src/database/drivers/mysql/sql/upsert.js","../src/database/drivers/pgsql/column.js","../src/database/drivers/pgsql/columns-index.js","../src/database/drivers/pgsql/foreign-key.js","../src/database/drivers/pgsql/index.js","../src/database/drivers/pgsql/options.js","../src/database/drivers/pgsql/query-parser.js","../src/database/drivers/pgsql/structure-sql.js","../src/database/drivers/pgsql/table.js","../src/database/drivers/pgsql/sql/alter-table.js","../src/database/drivers/pgsql/sql/create-database.js","../src/database/drivers/pgsql/sql/create-index.js","../src/database/drivers/pgsql/sql/create-table.js","../src/database/drivers/pgsql/sql/delete.js","../src/database/drivers/pgsql/sql/drop-database.js","../src/database/drivers/pgsql/sql/drop-table.js","../src/database/drivers/pgsql/sql/insert.js","../src/database/drivers/pgsql/sql/remove-index.js","../src/database/drivers/pgsql/sql/update.js","../src/database/drivers/pgsql/sql/upsert.js","../src/database/drivers/sqlite/base.js","../src/database/drivers/sqlite/column.js","../src/database/drivers/sqlite/columns-index.js","../src/database/drivers/sqlite/connection-sql-js.js","../src/database/drivers/sqlite/foreign-key.js","../src/database/drivers/sqlite/index.js","../src/database/drivers/sqlite/index.native.js","../src/database/drivers/sqlite/index.web.js","../src/database/drivers/sqlite/options.js","../src/database/drivers/sqlite/query-parser.js","../src/database/drivers/sqlite/query.js","../src/database/drivers/sqlite/query.native.js","../src/database/drivers/sqlite/query.web.js","../src/database/drivers/sqlite/structure-sql.js","../src/database/drivers/sqlite/table-rebuilder.js","../src/database/drivers/sqlite/table.js","../src/database/drivers/sqlite/web-persistence.js","../src/database/drivers/sqlite/sql/alter-table.js","../src/database/drivers/sqlite/sql/create-index.js","../src/database/drivers/sqlite/sql/create-table.js","../src/database/drivers/sqlite/sql/delete.js","../src/database/drivers/sqlite/sql/drop-table.js","../src/database/drivers/sqlite/sql/insert.js","../src/database/drivers/sqlite/sql/remove-index.js","../src/database/drivers/sqlite/sql/update.js","../src/database/drivers/sqlite/sql/upsert.js","../src/database/drivers/structure-sql/utils.js","../src/database/migration/index.js","../src/database/migrator/files-finder.js","../src/database/migrator/types.js","../src/database/pool/async-tracked-multi-connection.js","../src/database/pool/base-methods-forward.js","../src/database/pool/base.js","../src/database/pool/single-multi-use.js","../src/database/query/alter-table-base.js","../src/database/query/base.js","../src/database/query/create-database-base.js","../src/database/query/create-index-base.js","../src/database/query/create-table-base.js","../src/database/query/delete-base.js","../src/database/query/drop-database-base.js","../src/database/query/drop-table-base.js","../src/database/query/from-base.js","../src/database/query/from-plain.js","../src/database/query/from-table.js","../src/database/query/index.js","../src/database/query/insert-base.js","../src/database/query/join-base.js","../src/database/query/join-object.js","../src/database/query/join-plain.js","../src/database/query/join-tracker.js","../src/database/query/model-class-query.js","../src/database/query/order-base.js","../src/database/query/order-column.js","../src/database/query/order-plain.js","../src/database/query/preloader.js","../src/database/query/query-data.js","../src/database/query/remove-index-base.js","../src/database/query/select-base.js","../src/database/query/select-plain.js","../src/database/query/select-table-and-column.js","../src/database/query/update-base.js","../src/database/query/upsert-base.js","../src/database/query/where-base.js","../src/database/query/where-combinator.js","../src/database/query/where-hash.js","../src/database/query/where-model-class-hash.js","../src/database/query/where-not.js","../src/database/query/where-plain.js","../src/database/query/with-count.js","../src/database/query/preloader/belongs-to.js","../src/database/query/preloader/ensure-model-class-initialized.js","../src/database/query/preloader/has-many.js","../src/database/query/preloader/has-one.js","../src/database/query/preloader/selection.js","../src/database/query-parser/base-query-parser.js","../src/database/query-parser/from-parser.js","../src/database/query-parser/group-parser.js","../src/database/query-parser/joins-parser.js","../src/database/query-parser/limit-parser.js","../src/database/query-parser/options.js","../src/database/query-parser/order-parser.js","../src/database/query-parser/select-parser.js","../src/database/query-parser/where-parser.js","../src/database/record/acts-as-list.js","../src/database/record/auditing.js","../src/database/record/index.js","../src/database/record/record-not-found-error.js","../src/database/record/state-machine.js","../src/database/record/user-module.js","../src/database/record/attachments/attachment-record.js","../src/database/record/attachments/download.js","../src/database/record/attachments/handle.js","../src/database/record/attachments/normalize-input.js","../src/database/record/attachments/store.js","../src/database/record/attachments/storage-drivers/filesystem.js","../src/database/record/attachments/storage-drivers/native.js","../src/database/record/attachments/storage-drivers/s3.js","../src/database/record/instance-relationships/base.js","../src/database/record/instance-relationships/belongs-to.js","../src/database/record/instance-relationships/has-many.js","../src/database/record/instance-relationships/has-one.js","../src/database/record/relationships/base.js","../src/database/record/relationships/belongs-to.js","../src/database/record/relationships/has-many.js","../src/database/record/relationships/has-one.js","../src/database/record/validators/base.js","../src/database/record/validators/format.js","../src/database/record/validators/presence.js","../src/database/record/validators/uniqueness.js","../src/database/table-data/index.js","../src/database/table-data/table-column.js","../src/database/table-data/table-foreign-key.js","../src/database/table-data/table-index.js","../src/database/table-data/table-reference.js","../src/database/tenants/data-copier.js","../src/database/tenants/schema-cloner.js","../src/database/tenants/tenant-table-plan.js","../src/environment-handlers/base.js","../src/environment-handlers/browser.js","../src/environment-handlers/node.js","../src/environment-handlers/node/cli/commands/background-jobs-main.js","../src/environment-handlers/node/cli/commands/background-jobs-runner.js","../src/environment-handlers/node/cli/commands/background-jobs-worker.js","../src/environment-handlers/node/cli/commands/beacon.js","../src/environment-handlers/node/cli/commands/cli-command-context.js","../src/environment-handlers/node/cli/commands/console.js","../src/environment-handlers/node/cli/commands/init.js","../src/environment-handlers/node/cli/commands/routes.js","../src/environment-handlers/node/cli/commands/run-script.js","../src/environment-handlers/node/cli/commands/runner.js","../src/environment-handlers/node/cli/commands/server.js","../src/environment-handlers/node/cli/commands/test.js","../src/environment-handlers/node/cli/commands/db/seed.js","../src/environment-handlers/node/cli/commands/db/schema/dump.js","../src/environment-handlers/node/cli/commands/db/schema/load.js","../src/environment-handlers/node/cli/commands/destroy/migration.js","../src/environment-handlers/node/cli/commands/generate/base-models.js","../src/environment-handlers/node/cli/commands/generate/frontend-models.js","../src/environment-handlers/node/cli/commands/generate/generated-file-banner.js","../src/environment-handlers/node/cli/commands/generate/migration.js","../src/environment-handlers/node/cli/commands/generate/model.js","../src/environment-handlers/node/cli/commands/lint/relationships.js","../src/error-reporting/request-details.js","../src/frontend-model-resource/base-resource.js","../src/frontend-model-resource/velocious-attachment-resource.js","../src/frontend-models/base.js","../src/frontend-models/built-in-resources.js","../src/frontend-models/clear-pending-debounced-callback.js","../src/frontend-models/event-hook-models.js","../src/frontend-models/model-registry.js","../src/frontend-models/outgoing-event-buffer.js","../src/frontend-models/preloader.js","../src/frontend-models/query.js","../src/frontend-models/resource-config-validation.js","../src/frontend-models/resource-definition.js","../src/frontend-models/transport-serialization.js","../src/frontend-models/use-created-event.js","../src/frontend-models/use-destroyed-event.js","../src/frontend-models/use-model-class-event.js","../src/frontend-models/use-updated-event.js","../src/frontend-models/websocket-channel.js","../src/frontend-models/websocket-publishers.js","../src/http-client/header.js","../src/http-client/index.js","../src/http-client/request.js","../src/http-client/response.js","../src/http-client/websocket-client.js","../src/http-server/cookie.js","../src/http-server/development-reloader.js","../src/http-server/index.js","../src/http-server/remote-address.js","../src/http-server/server-client.js","../src/http-server/server-lock.js","../src/http-server/websocket-channel-subscribers.js","../src/http-server/websocket-channel.js","../src/http-server/websocket-connection.js","../src/http-server/websocket-event-log-store.js","../src/http-server/websocket-events-host.js","../src/http-server/websocket-events.js","../src/http-server/client/index.js","../src/http-server/client/params-to-object.js","../src/http-server/client/request-parser.js","../src/http-server/client/request-runner.js","../src/http-server/client/request-timing.js","../src/http-server/client/request.js","../src/http-server/client/response.js","../src/http-server/client/websocket-request.js","../src/http-server/client/websocket-session.js","../src/http-server/client/request-buffer/form-data-part.js","../src/http-server/client/request-buffer/header.js","../src/http-server/client/request-buffer/index.js","../src/http-server/client/uploaded-file/memory-uploaded-file.js","../src/http-server/client/uploaded-file/temporary-uploaded-file.js","../src/http-server/client/uploaded-file/uploaded-file.js","../src/http-server/worker-handler/channel-subscriber-dispatch.js","../src/http-server/worker-handler/in-process.js","../src/http-server/worker-handler/index.js","../src/http-server/worker-handler/worker-script.js","../src/http-server/worker-handler/worker-thread.js","../src/jobs/mail-delivery.js","../src/logger/base-logger.js","../src/logger/console-logger.js","../src/logger/file-logger.js","../src/logger/outputs/array-output.js","../src/logger/outputs/console-output.js","../src/logger/outputs/file-output.js","../src/logger/outputs/stdout-output.js","../src/mailer/base.js","../src/mailer/delivery.js","../src/mailer/index.js","../src/mailer/backends/smtp.js","../src/packages/velocious-package.js","../src/plugins/sqljs-wasm-route-controller.js","../src/plugins/sqljs-wasm-route.js","../src/routes/app-routes.js","../src/routes/base-route.js","../src/routes/basic-route.js","../src/routes/get-route.js","../src/routes/index.js","../src/routes/namespace-route.js","../src/routes/plugin-routes.js","../src/routes/post-route.js","../src/routes/resolver.js","../src/routes/resource-route.js","../src/routes/root-route.js","../src/routes/built-in/debug/controller.js","../src/routes/built-in/errors/controller.js","../src/routes/hooks/frontend-model-command-route-hook.js","../src/sync/conflict-strategy.js","../src/sync/device-identity.js","../src/sync/local-mutation-log.js","../src/sync/offline-grant.js","../src/sync/peer-mutation-bundle.js","../src/sync/query-scope.js","../src/sync/server-change-feed.js","../src/sync/stable-json.js","../src/sync/sync-api-client-types.js","../src/sync/sync-api-client.js","../src/sync/sync-api-controller.js","../src/sync/sync-client-registry.js","../src/sync/sync-client-types.js","../src/sync/sync-client.js","../src/sync/sync-envelope-replay-service.js","../src/sync/sync-model-change-feed-service.js","../src/sync/sync-replay-upsert-applier.js","../src/sync/sync-resource-base.js","../src/sync/sync-scope-store.js","../src/tenants/default-tenant-database-provisioning.js","../src/tenants/tenant-iterator.js","../src/tenants/tenant.js","../src/testing/base-expect.js","../src/testing/browser-frontend-model-event-hook-scenarios.js","../src/testing/browser-test-app.js","../src/testing/expect-to-change.js","../src/testing/expect-utils.js","../src/testing/expect.js","../src/testing/request-client.js","../src/testing/test-files-finder.js","../src/testing/test-filter-parser.js","../src/testing/test-runner.js","../src/testing/test-suite-splitter.js","../src/testing/test.js","../src/types/external-modules.d.ts","../src/utils/backtrace-cleaner-node.js","../src/utils/backtrace-cleaner.js","../src/utils/deburr-column-name.js","../src/utils/event-emitter.js","../src/utils/file-exists.js","../src/utils/format-value.js","../src/utils/is-date.js","../src/utils/model-scope.js","../src/utils/nest-callbacks.js","../src/utils/plain-object.js","../src/utils/ransack.js","../src/utils/rest-args-error.js","../src/utils/singularize-model-name.js","../src/utils/split-sql-statements.js","../src/utils/to-import-specifier.js","../src/utils/with-tracked-stack-async-hooks.js","../src/utils/with-tracked-stack.js"],"version":"6.0.3"}
1
+ {"root":["../index.js","../bin/velocious.js","../src/application.js","../src/configuration-resolver.js","../src/configuration-types.js","../src/configuration.js","../src/controller.js","../src/current-configuration.js","../src/current.js","../src/error-logger.js","../src/frontend-model-controller.js","../src/initializer.js","../src/logger.js","../src/mailer.js","../src/record-payload-values.js","../src/time-zone.js","../src/velocious-error.js","../src/authorization/ability.js","../src/authorization/base-resource.js","../src/background-jobs/client.js","../src/background-jobs/cron-expression.js","../src/background-jobs/forked-runner-child.js","../src/background-jobs/job-record.js","../src/background-jobs/job-registry.js","../src/background-jobs/job-runner.js","../src/background-jobs/job.js","../src/background-jobs/json-socket.js","../src/background-jobs/main.js","../src/background-jobs/normalize-error.js","../src/background-jobs/scheduler.js","../src/background-jobs/socket-request.js","../src/background-jobs/status-reporter.js","../src/background-jobs/store.js","../src/background-jobs/types.js","../src/background-jobs/worker.js","../src/background-jobs/web/authorization.js","../src/background-jobs/web/controller.js","../src/background-jobs/web/index.js","../src/background-jobs/web/path-matcher.js","../src/background-jobs/web/registry.js","../src/beacon/client.js","../src/beacon/in-process-broker.js","../src/beacon/in-process-client.js","../src/beacon/server.js","../src/beacon/types.js","../src/cli/base-command.js","../src/cli/browser-cli.js","../src/cli/index.js","../src/cli/tenant-database-command-helper.js","../src/cli/use-browser-cli.js","../src/cli/commands/background-jobs-main.js","../src/cli/commands/background-jobs-runner.js","../src/cli/commands/background-jobs-worker.js","../src/cli/commands/beacon.js","../src/cli/commands/console.js","../src/cli/commands/init.js","../src/cli/commands/routes.js","../src/cli/commands/run-script.js","../src/cli/commands/runner.js","../src/cli/commands/server.js","../src/cli/commands/test.js","../src/cli/commands/db/base-command.js","../src/cli/commands/db/create.js","../src/cli/commands/db/drop.js","../src/cli/commands/db/migrate.js","../src/cli/commands/db/reset.js","../src/cli/commands/db/rollback.js","../src/cli/commands/db/seed.js","../src/cli/commands/db/schema/dump.js","../src/cli/commands/db/schema/load.js","../src/cli/commands/db/tenants/check.js","../src/cli/commands/db/tenants/create.js","../src/cli/commands/db/tenants/drop.js","../src/cli/commands/db/tenants/migrate.js","../src/cli/commands/destroy/migration.js","../src/cli/commands/generate/base-models.js","../src/cli/commands/generate/frontend-models.js","../src/cli/commands/generate/migration.js","../src/cli/commands/generate/model.js","../src/cli/commands/lint/relationships.js","../src/database/annotations-async-hooks.js","../src/database/annotations.js","../src/database/datetime-storage.js","../src/database/handler.js","../src/database/initializer-from-require-context.js","../src/database/migrations-ledger.js","../src/database/migrator.js","../src/database/use-database.js","../src/database/drivers/base-column.js","../src/database/drivers/base-columns-index.js","../src/database/drivers/base-foreign-key.js","../src/database/drivers/base-table.js","../src/database/drivers/base.js","../src/database/drivers/mssql/column.js","../src/database/drivers/mssql/columns-index.js","../src/database/drivers/mssql/connect-connection.js","../src/database/drivers/mssql/foreign-key.js","../src/database/drivers/mssql/index.js","../src/database/drivers/mssql/options.js","../src/database/drivers/mssql/query-parser.js","../src/database/drivers/mssql/structure-sql.js","../src/database/drivers/mssql/table.js","../src/database/drivers/mssql/sql/alter-table.js","../src/database/drivers/mssql/sql/create-database.js","../src/database/drivers/mssql/sql/create-index.js","../src/database/drivers/mssql/sql/create-table.js","../src/database/drivers/mssql/sql/delete.js","../src/database/drivers/mssql/sql/drop-database.js","../src/database/drivers/mssql/sql/drop-table.js","../src/database/drivers/mssql/sql/insert.js","../src/database/drivers/mssql/sql/remove-index.js","../src/database/drivers/mssql/sql/update.js","../src/database/drivers/mssql/sql/upsert.js","../src/database/drivers/mysql/column.js","../src/database/drivers/mysql/columns-index.js","../src/database/drivers/mysql/foreign-key.js","../src/database/drivers/mysql/index.js","../src/database/drivers/mysql/options.js","../src/database/drivers/mysql/query-parser.js","../src/database/drivers/mysql/query.js","../src/database/drivers/mysql/structure-sql.js","../src/database/drivers/mysql/table.js","../src/database/drivers/mysql/sql/alter-table.js","../src/database/drivers/mysql/sql/create-database.js","../src/database/drivers/mysql/sql/create-index.js","../src/database/drivers/mysql/sql/create-table.js","../src/database/drivers/mysql/sql/delete.js","../src/database/drivers/mysql/sql/drop-database.js","../src/database/drivers/mysql/sql/drop-table.js","../src/database/drivers/mysql/sql/insert.js","../src/database/drivers/mysql/sql/remove-index.js","../src/database/drivers/mysql/sql/update.js","../src/database/drivers/mysql/sql/upsert.js","../src/database/drivers/pgsql/column.js","../src/database/drivers/pgsql/columns-index.js","../src/database/drivers/pgsql/foreign-key.js","../src/database/drivers/pgsql/index.js","../src/database/drivers/pgsql/options.js","../src/database/drivers/pgsql/query-parser.js","../src/database/drivers/pgsql/structure-sql.js","../src/database/drivers/pgsql/table.js","../src/database/drivers/pgsql/sql/alter-table.js","../src/database/drivers/pgsql/sql/create-database.js","../src/database/drivers/pgsql/sql/create-index.js","../src/database/drivers/pgsql/sql/create-table.js","../src/database/drivers/pgsql/sql/delete.js","../src/database/drivers/pgsql/sql/drop-database.js","../src/database/drivers/pgsql/sql/drop-table.js","../src/database/drivers/pgsql/sql/insert.js","../src/database/drivers/pgsql/sql/remove-index.js","../src/database/drivers/pgsql/sql/update.js","../src/database/drivers/pgsql/sql/upsert.js","../src/database/drivers/sqlite/base.js","../src/database/drivers/sqlite/column.js","../src/database/drivers/sqlite/columns-index.js","../src/database/drivers/sqlite/connection-sql-js.js","../src/database/drivers/sqlite/foreign-key.js","../src/database/drivers/sqlite/index.js","../src/database/drivers/sqlite/index.native.js","../src/database/drivers/sqlite/index.web.js","../src/database/drivers/sqlite/options.js","../src/database/drivers/sqlite/query-parser.js","../src/database/drivers/sqlite/query.js","../src/database/drivers/sqlite/query.native.js","../src/database/drivers/sqlite/query.web.js","../src/database/drivers/sqlite/structure-sql.js","../src/database/drivers/sqlite/table-rebuilder.js","../src/database/drivers/sqlite/table.js","../src/database/drivers/sqlite/web-persistence.js","../src/database/drivers/sqlite/sql/alter-table.js","../src/database/drivers/sqlite/sql/create-index.js","../src/database/drivers/sqlite/sql/create-table.js","../src/database/drivers/sqlite/sql/delete.js","../src/database/drivers/sqlite/sql/drop-table.js","../src/database/drivers/sqlite/sql/insert.js","../src/database/drivers/sqlite/sql/remove-index.js","../src/database/drivers/sqlite/sql/update.js","../src/database/drivers/sqlite/sql/upsert.js","../src/database/drivers/structure-sql/utils.js","../src/database/migration/index.js","../src/database/migrator/files-finder.js","../src/database/migrator/types.js","../src/database/pool/async-tracked-multi-connection.js","../src/database/pool/base-methods-forward.js","../src/database/pool/base.js","../src/database/pool/single-multi-use.js","../src/database/query/alter-table-base.js","../src/database/query/base.js","../src/database/query/create-database-base.js","../src/database/query/create-index-base.js","../src/database/query/create-table-base.js","../src/database/query/delete-base.js","../src/database/query/drop-database-base.js","../src/database/query/drop-table-base.js","../src/database/query/from-base.js","../src/database/query/from-plain.js","../src/database/query/from-table.js","../src/database/query/index.js","../src/database/query/insert-base.js","../src/database/query/join-base.js","../src/database/query/join-object.js","../src/database/query/join-plain.js","../src/database/query/join-tracker.js","../src/database/query/model-class-query.js","../src/database/query/order-base.js","../src/database/query/order-column.js","../src/database/query/order-plain.js","../src/database/query/preloader.js","../src/database/query/query-data.js","../src/database/query/remove-index-base.js","../src/database/query/select-base.js","../src/database/query/select-plain.js","../src/database/query/select-table-and-column.js","../src/database/query/update-base.js","../src/database/query/upsert-base.js","../src/database/query/where-base.js","../src/database/query/where-combinator.js","../src/database/query/where-hash.js","../src/database/query/where-model-class-hash.js","../src/database/query/where-not.js","../src/database/query/where-plain.js","../src/database/query/with-count.js","../src/database/query/preloader/belongs-to.js","../src/database/query/preloader/ensure-model-class-initialized.js","../src/database/query/preloader/has-many.js","../src/database/query/preloader/has-one.js","../src/database/query/preloader/selection.js","../src/database/query-parser/base-query-parser.js","../src/database/query-parser/from-parser.js","../src/database/query-parser/group-parser.js","../src/database/query-parser/joins-parser.js","../src/database/query-parser/limit-parser.js","../src/database/query-parser/options.js","../src/database/query-parser/order-parser.js","../src/database/query-parser/select-parser.js","../src/database/query-parser/where-parser.js","../src/database/record/acts-as-list.js","../src/database/record/auditing.js","../src/database/record/index.js","../src/database/record/record-not-found-error.js","../src/database/record/state-machine.js","../src/database/record/user-module.js","../src/database/record/attachments/attachment-record.js","../src/database/record/attachments/download.js","../src/database/record/attachments/handle.js","../src/database/record/attachments/normalize-input.js","../src/database/record/attachments/store.js","../src/database/record/attachments/storage-drivers/filesystem.js","../src/database/record/attachments/storage-drivers/native.js","../src/database/record/attachments/storage-drivers/s3.js","../src/database/record/instance-relationships/base.js","../src/database/record/instance-relationships/belongs-to.js","../src/database/record/instance-relationships/has-many.js","../src/database/record/instance-relationships/has-one.js","../src/database/record/relationships/base.js","../src/database/record/relationships/belongs-to.js","../src/database/record/relationships/has-many.js","../src/database/record/relationships/has-one.js","../src/database/record/validators/base.js","../src/database/record/validators/format.js","../src/database/record/validators/presence.js","../src/database/record/validators/uniqueness.js","../src/database/table-data/index.js","../src/database/table-data/table-column.js","../src/database/table-data/table-foreign-key.js","../src/database/table-data/table-index.js","../src/database/table-data/table-reference.js","../src/database/tenants/data-copier.js","../src/database/tenants/schema-cloner.js","../src/database/tenants/tenant-table-plan.js","../src/environment-handlers/base.js","../src/environment-handlers/browser.js","../src/environment-handlers/node.js","../src/environment-handlers/node/cli/commands/background-jobs-main.js","../src/environment-handlers/node/cli/commands/background-jobs-runner.js","../src/environment-handlers/node/cli/commands/background-jobs-worker.js","../src/environment-handlers/node/cli/commands/beacon.js","../src/environment-handlers/node/cli/commands/cli-command-context.js","../src/environment-handlers/node/cli/commands/console.js","../src/environment-handlers/node/cli/commands/init.js","../src/environment-handlers/node/cli/commands/routes.js","../src/environment-handlers/node/cli/commands/run-script.js","../src/environment-handlers/node/cli/commands/runner.js","../src/environment-handlers/node/cli/commands/server.js","../src/environment-handlers/node/cli/commands/test.js","../src/environment-handlers/node/cli/commands/db/seed.js","../src/environment-handlers/node/cli/commands/db/schema/dump.js","../src/environment-handlers/node/cli/commands/db/schema/load.js","../src/environment-handlers/node/cli/commands/destroy/migration.js","../src/environment-handlers/node/cli/commands/generate/base-models.js","../src/environment-handlers/node/cli/commands/generate/frontend-models.js","../src/environment-handlers/node/cli/commands/generate/generated-file-banner.js","../src/environment-handlers/node/cli/commands/generate/migration.js","../src/environment-handlers/node/cli/commands/generate/model.js","../src/environment-handlers/node/cli/commands/lint/relationships.js","../src/error-reporting/request-details.js","../src/frontend-model-resource/base-resource.js","../src/frontend-model-resource/velocious-attachment-resource.js","../src/frontend-models/base.js","../src/frontend-models/built-in-resources.js","../src/frontend-models/clear-pending-debounced-callback.js","../src/frontend-models/event-hook-models.js","../src/frontend-models/model-registry.js","../src/frontend-models/outgoing-event-buffer.js","../src/frontend-models/preloader.js","../src/frontend-models/query.js","../src/frontend-models/resource-config-validation.js","../src/frontend-models/resource-definition.js","../src/frontend-models/transport-serialization.js","../src/frontend-models/use-created-event.js","../src/frontend-models/use-destroyed-event.js","../src/frontend-models/use-model-class-event.js","../src/frontend-models/use-updated-event.js","../src/frontend-models/websocket-channel.js","../src/frontend-models/websocket-publishers.js","../src/http-client/header.js","../src/http-client/index.js","../src/http-client/request.js","../src/http-client/response.js","../src/http-client/websocket-client.js","../src/http-server/cookie.js","../src/http-server/development-reloader.js","../src/http-server/index.js","../src/http-server/remote-address.js","../src/http-server/server-client.js","../src/http-server/server-lock.js","../src/http-server/websocket-channel-subscribers.js","../src/http-server/websocket-channel.js","../src/http-server/websocket-connection.js","../src/http-server/websocket-event-log-store.js","../src/http-server/websocket-events-host.js","../src/http-server/websocket-events.js","../src/http-server/client/index.js","../src/http-server/client/params-to-object.js","../src/http-server/client/request-parser.js","../src/http-server/client/request-runner.js","../src/http-server/client/request-timing.js","../src/http-server/client/request.js","../src/http-server/client/response.js","../src/http-server/client/websocket-request.js","../src/http-server/client/websocket-session.js","../src/http-server/client/request-buffer/form-data-part.js","../src/http-server/client/request-buffer/header.js","../src/http-server/client/request-buffer/index.js","../src/http-server/client/uploaded-file/memory-uploaded-file.js","../src/http-server/client/uploaded-file/temporary-uploaded-file.js","../src/http-server/client/uploaded-file/uploaded-file.js","../src/http-server/worker-handler/channel-subscriber-dispatch.js","../src/http-server/worker-handler/in-process.js","../src/http-server/worker-handler/index.js","../src/http-server/worker-handler/worker-script.js","../src/http-server/worker-handler/worker-thread.js","../src/jobs/mail-delivery.js","../src/logger/base-logger.js","../src/logger/console-logger.js","../src/logger/file-logger.js","../src/logger/outputs/array-output.js","../src/logger/outputs/console-output.js","../src/logger/outputs/file-output.js","../src/logger/outputs/stdout-output.js","../src/mailer/base.js","../src/mailer/delivery.js","../src/mailer/index.js","../src/mailer/backends/smtp.js","../src/packages/velocious-package.js","../src/plugins/sqljs-wasm-route-controller.js","../src/plugins/sqljs-wasm-route.js","../src/routes/app-routes.js","../src/routes/base-route.js","../src/routes/basic-route.js","../src/routes/get-route.js","../src/routes/index.js","../src/routes/namespace-route.js","../src/routes/plugin-routes.js","../src/routes/post-route.js","../src/routes/resolver.js","../src/routes/resource-route.js","../src/routes/root-route.js","../src/routes/built-in/debug/controller.js","../src/routes/built-in/errors/controller.js","../src/routes/hooks/frontend-model-command-route-hook.js","../src/sync/conflict-strategy.js","../src/sync/device-identity.js","../src/sync/local-mutation-log.js","../src/sync/offline-grant.js","../src/sync/peer-mutation-bundle.js","../src/sync/query-scope.js","../src/sync/server-change-feed.js","../src/sync/server-sequence-allocator.js","../src/sync/stable-json.js","../src/sync/sync-api-client-types.js","../src/sync/sync-api-client.js","../src/sync/sync-api-controller.js","../src/sync/sync-attribute-normalizer.js","../src/sync/sync-client-registry.js","../src/sync/sync-client-types.js","../src/sync/sync-client.js","../src/sync/sync-envelope-replay-service.js","../src/sync/sync-model-change-feed-service.js","../src/sync/sync-replay-upsert-applier.js","../src/sync/sync-resource-base.js","../src/sync/sync-scope-store.js","../src/tenants/default-tenant-database-provisioning.js","../src/tenants/tenant-iterator.js","../src/tenants/tenant.js","../src/testing/base-expect.js","../src/testing/browser-frontend-model-event-hook-scenarios.js","../src/testing/browser-test-app.js","../src/testing/expect-to-change.js","../src/testing/expect-utils.js","../src/testing/expect.js","../src/testing/request-client.js","../src/testing/test-files-finder.js","../src/testing/test-filter-parser.js","../src/testing/test-runner.js","../src/testing/test-suite-splitter.js","../src/testing/test.js","../src/types/external-modules.d.ts","../src/utils/backtrace-cleaner-node.js","../src/utils/backtrace-cleaner.js","../src/utils/deburr-column-name.js","../src/utils/event-emitter.js","../src/utils/file-exists.js","../src/utils/format-value.js","../src/utils/is-date.js","../src/utils/model-scope.js","../src/utils/nest-callbacks.js","../src/utils/plain-object.js","../src/utils/ransack.js","../src/utils/rest-args-error.js","../src/utils/singularize-model-name.js","../src/utils/split-sql-statements.js","../src/utils/to-import-specifier.js","../src/utils/with-tracked-stack-async-hooks.js","../src/utils/with-tracked-stack.js"],"version":"6.0.3"}
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "velocious": "build/bin/velocious.js"
4
4
  },
5
5
  "name": "velocious",
6
- "version": "1.0.493",
6
+ "version": "1.0.494",
7
7
  "main": "build/index.js",
8
8
  "types": "build/index.d.ts",
9
9
  "files": [
@@ -73,7 +73,7 @@
73
73
  "sql-escape-string": "^1.1.0",
74
74
  "sql.js": "^1.12.0",
75
75
  "strftime": "^0.10.2",
76
- "typanic": "^1.0.5"
76
+ "typanic": "^1.0.9"
77
77
  },
78
78
  "peerDependencies": {
79
79
  "react": ">=18",
@@ -936,6 +936,12 @@ export default class VelociousDatabaseDriversBase {
936
936
  currentFrame.push(callback)
937
937
  }
938
938
 
939
+ /**
940
+ * Whether a transaction is currently open on this connection.
941
+ * @returns {boolean} - Whether inside a transaction.
942
+ */
943
+ insideTransaction() { return this._transactionsCount > 0 }
944
+
939
945
  /**
940
946
  * Runs start transaction.
941
947
  * @returns {Promise<void>} - Resolves when complete.
@@ -133,7 +133,7 @@ export default class VelociousDatabaseQueryInsertBase {
133
133
  if (this.data && Object.keys(this.data).length > 0) {
134
134
  sql += " VALUES "
135
135
  sql += this._valuesSql(Object.values(this.data))
136
- } else if (driver.getType() == "sqlite" || driver.getType() == "mssql") {
136
+ } else if (driver.getType() == "sqlite" || driver.getType() == "mssql" || driver.getType() == "pgsql") {
137
137
  sql += " DEFAULT VALUES"
138
138
  } else if (driver.getType() == "mysql") {
139
139
  sql += " () VALUES ()"
@@ -0,0 +1,246 @@
1
+ // @ts-check
2
+
3
+ import Configuration from "../configuration.js"
4
+ import TableData from "../database/table-data/index.js"
5
+
6
+ /**
7
+ * Allocation queues per database+table, serializing insert/last-insert-id
8
+ * pairs across all allocator instances in this process.
9
+ * @type {Map<string, Promise<void>>}
10
+ */
11
+ const allocationQueues = new Map()
12
+
13
+ /**
14
+ * Allocates monotonically increasing server sync sequences from an
15
+ * AUTO_INCREMENT id table: every allocation inserts a row and returns the
16
+ * driver's last-insert id, so sequences stay unique and increasing across
17
+ * processes sharing the same database.
18
+ *
19
+ * Backed by an auto-created `velocious_server_sequences` table on the
20
+ * configured database, with a process-local memory counter fallback when no
21
+ * database is configured (mirroring the sync scope store). Apps with an
22
+ * existing sequence table (for example a bare `id`-only AUTO_INCREMENT table)
23
+ * point `tableName` at it and pass `insertData: {}` to insert empty rows.
24
+ */
25
+ export default class ServerSequenceAllocator {
26
+ /**
27
+ * Creates a server sequence allocator.
28
+ * @param {object} [args] - Options.
29
+ * @param {import("../configuration.js").default} [args.configuration] - Configuration owning the database. Defaults to the current configuration, resolved lazily per allocation.
30
+ * @param {string} [args.databaseIdentifier] - Database identifier.
31
+ * @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.
32
+ * @param {string} [args.tableName] - Sequence table name.
33
+ */
34
+ constructor({configuration, databaseIdentifier = "default", insertData, tableName = "velocious_server_sequences"} = {}) {
35
+ this.configuration = configuration
36
+ this.databaseIdentifier = databaseIdentifier
37
+ this.insertData = insertData
38
+ this.tableName = tableName
39
+ this._memorySequence = 0
40
+ this._isReady = false
41
+ /** @type {Promise<void> | null} */
42
+ this._readyPromise = null
43
+ }
44
+
45
+ /**
46
+ * Allocates the next monotonically increasing sequence.
47
+ *
48
+ * Allocations serialize through a module-level queue per database+table so
49
+ * parallel `next()` calls - including calls from other allocator instances
50
+ * sharing the same table and connection - cannot interleave their insert
51
+ * and last-insert-id reads and hand out duplicate sequences.
52
+ * @returns {Promise<number>} Next sequence value.
53
+ */
54
+ async next() {
55
+ const queueKey = `${this.databaseIdentifier}::${this.tableName}`
56
+ const previousAllocation = allocationQueues.get(queueKey) ?? Promise.resolve()
57
+ const allocation = previousAllocation.then(() => this._allocateNext())
58
+
59
+ allocationQueues.set(queueKey, allocation.then(() => undefined, () => undefined))
60
+
61
+ return await allocation
62
+ }
63
+
64
+ /**
65
+ * Ensures the backing table exists.
66
+ * @returns {Promise<void>} Resolves when ready.
67
+ */
68
+ async ensureReady() {
69
+ if (this._isReady) return
70
+
71
+ if (this._usesMemoryStorage()) {
72
+ this._isReady = true
73
+ return
74
+ }
75
+
76
+ if (this._readyPromise) return await this._readyPromise
77
+
78
+ this._readyPromise = this._withDb(async (db) => {
79
+ const created = await this._ensureSequencesTable(db)
80
+
81
+ // DDL joins any transaction already open on this connection (the mixin's
82
+ // beforeCreate allocation always runs inside the record save transaction),
83
+ // and on transactional-DDL databases (MSSQL, PostgreSQL, SQLite) a rollback
84
+ // of that outer transaction removes the just-created table again. Only
85
+ // cache readiness when the table was not created inside an active
86
+ // transaction; otherwise the next allocation re-verifies the table.
87
+ if (!created || !db.insideTransaction()) this._isReady = true
88
+ })
89
+
90
+ try {
91
+ await this._readyPromise
92
+ } finally {
93
+ if (!this._isReady) this._readyPromise = null
94
+ }
95
+ }
96
+
97
+ /**
98
+ * Allocates one sequence value after queueing.
99
+ * @returns {Promise<number>} Allocated sequence value.
100
+ */
101
+ async _allocateNext() {
102
+ await this.ensureReady()
103
+
104
+ if (this._usesMemoryStorage()) {
105
+ return ++this._memorySequence
106
+ }
107
+
108
+ return await this._withDb(async (db) => {
109
+ // The allocated id must be returned by the insert statement itself (OUTPUT
110
+ // INSERTED/RETURNING), like the record create path does: MSSQL's
111
+ // SCOPE_IDENTITY() only sees inserts from the same batch/scope, so reading
112
+ // the last-insert id as a separate query always returns NULL there. Drivers
113
+ // without insert-returning support (older SQLite) keep the reliable
114
+ // connection-scoped last-insert-id fallback.
115
+ const insertSql = db.insertSql({
116
+ data: this._insertPayload(),
117
+ returnLastInsertedColumnNames: ["id"],
118
+ tableName: this.tableName
119
+ })
120
+ const insertResult = await db.query(insertSql)
121
+ const insertedId = Array.isArray(insertResult) ? insertResult[0]?.id : undefined
122
+
123
+ if (insertedId !== undefined && insertedId !== null) return Number(insertedId)
124
+
125
+ return Number(await db.lastInsertID())
126
+ })
127
+ }
128
+
129
+ /**
130
+ * Builds the row payload inserted per allocation.
131
+ * @returns {Record<string, ?>} Insert payload.
132
+ */
133
+ _insertPayload() {
134
+ return this.insertData ?? {created_at: new Date()}
135
+ }
136
+
137
+ /**
138
+ * Resolves the configuration owning the sequence table.
139
+ * @returns {import("../configuration.js").default} Resolved configuration.
140
+ */
141
+ _getConfiguration() {
142
+ return this.configuration ?? Configuration.current()
143
+ }
144
+
145
+ /**
146
+ * Whether the allocator runs without a configured database.
147
+ * @returns {boolean} Whether memory storage is used.
148
+ */
149
+ _usesMemoryStorage() {
150
+ try {
151
+ return !this._getConfiguration().getDatabaseConfiguration()[this.databaseIdentifier]
152
+ } catch {
153
+ return true
154
+ }
155
+ }
156
+
157
+ /**
158
+ * Runs a callback with a database connection.
159
+ * @template Result
160
+ * @param {(db: import("../database/drivers/base.js").default) => Promise<Result>} callback - Database callback.
161
+ * @returns {Promise<Result>} Callback result.
162
+ */
163
+ async _withDb(callback) {
164
+ return await this._getConfiguration().ensureConnections({name: "Server sequence allocator"}, async (dbs) => {
165
+ const db = dbs[this.databaseIdentifier]
166
+
167
+ if (!db) throw new Error(`No database connection available for identifier: ${this.databaseIdentifier}`)
168
+
169
+ return await callback(db)
170
+ })
171
+ }
172
+
173
+ /**
174
+ * Ensures the sequences table exists.
175
+ * @param {import("../database/drivers/base.js").default} db - Database connection.
176
+ * @returns {Promise<boolean>} Whether the table had to be created.
177
+ */
178
+ async _ensureSequencesTable(db) {
179
+ if (await db.tableExists(this.tableName)) return false
180
+
181
+ const table = new TableData(this.tableName, {ifNotExists: true})
182
+
183
+ table.bigint("id", {autoIncrement: true, null: false, primaryKey: true})
184
+ table.datetime("created_at", {null: false})
185
+
186
+ await db.createTable(table)
187
+
188
+ return true
189
+ }
190
+ }
191
+
192
+ /**
193
+ * Wires server sequencing onto a sync model class: registers a beforeCreate
194
+ * lifecycle callback assigning the next sequence when the record has none, and
195
+ * defines an `advance<Column>()` instance method (when the model does not
196
+ * already define one) that re-sequences the record through the allocator.
197
+ *
198
+ * The sequence is always written through the model's generated typed setter
199
+ * (for example `setServerSequence`), so the model must expose the generated
200
+ * `set<Column>`/`has<Column>` accessors for the column.
201
+ * @template {typeof import("../database/record/index.js").default} TModelClass
202
+ * @param {TModelClass} ModelClass - Sync model class to sequence.
203
+ * @param {object} args - Options.
204
+ * @param {ServerSequenceAllocator} args.allocator - Allocator providing sequence values.
205
+ * @param {string} [args.column] - Sequence attribute name.
206
+ * @returns {TModelClass} The given model class.
207
+ */
208
+ export function withServerSequence(ModelClass, {allocator, column = "serverSequence"}) {
209
+ if (!(allocator instanceof ServerSequenceAllocator)) {
210
+ throw new Error(`withServerSequence requires a ServerSequenceAllocator, got: ${String(allocator)}`)
211
+ }
212
+
213
+ const upperColumn = `${column.charAt(0).toUpperCase()}${column.slice(1)}`
214
+ const advanceMethodName = `advance${upperColumn}`
215
+ const hasMethodName = `has${upperColumn}`
216
+ const setterMethodName = `set${upperColumn}`
217
+
218
+ // Narrows the prototype to dynamic method access for the configured column name.
219
+ const prototype = /** @type {Record<string, ?>} */ (ModelClass.prototype)
220
+
221
+ if (typeof prototype[setterMethodName] != "function" || typeof prototype[hasMethodName] != "function") {
222
+ throw new Error(`withServerSequence requires generated ${setterMethodName} and ${hasMethodName} accessors on ${ModelClass.name}`)
223
+ }
224
+
225
+ if (typeof prototype[advanceMethodName] != "function") {
226
+ /**
227
+ * Assigns the next server-side sequence.
228
+ * @this {Record<string, ?>}
229
+ * @returns {Promise<void>}
230
+ */
231
+ prototype[advanceMethodName] = async function advanceServerSequenceThroughAllocator() {
232
+ this[setterMethodName](await allocator.next())
233
+ }
234
+ }
235
+
236
+ ModelClass.beforeCreate(async (record) => {
237
+ // Narrows the record to dynamic method access for the configured column name.
238
+ const dynamicRecord = /** @type {Record<string, ?>} */ (/** @type {?} */ (record))
239
+
240
+ if (dynamicRecord[hasMethodName]()) return
241
+
242
+ await dynamicRecord[advanceMethodName]()
243
+ })
244
+
245
+ return ModelClass
246
+ }
@@ -0,0 +1,186 @@
1
+ // @ts-check
2
+
3
+ import {snakeCaseKey} from "typanic"
4
+
5
+ /**
6
+ * Builds the error thrown for a failed sync attribute validation.
7
+ * @callback SyncAttributeErrorFactory
8
+ * @param {string} message - Human-readable validation message.
9
+ * @param {{cause?: Error, code: string}} details - Stable machine-readable code and optional cause.
10
+ * @returns {Error} Error to throw.
11
+ */
12
+
13
+ /**
14
+ * Declarative validation schema for one writable sync attribute.
15
+ *
16
+ * Keys are camelCase attribute names; each attribute also accepts its
17
+ * snake_case column key on input (the camelCase key wins when both are given)
18
+ * and is written under the snake_case column key on output. Error messages
19
+ * default to `<label> ...` phrasings with `sync-<label>-...` codes, where the
20
+ * label defaults to the camelCase attribute name; apps pin exact messages per
21
+ * attribute through the `*Message` overrides.
22
+ * @typedef {object} SyncAttributeSchemaEntry
23
+ * @property {"date" | "json" | "raw" | "string"} type - Attribute value type.
24
+ * @property {boolean} [required] - Whether present blank/absent values are rejected (strings reject blank-after-trim, dates reject null).
25
+ * @property {number} [maxLength] - Maximum string length, checked after trimming.
26
+ * @property {string} [label] - Label used in derived messages and codes.
27
+ * @property {string} [column] - Output column key. Defaults to the snake_cased attribute name.
28
+ * @property {string} [requiredMessage] - Pinned message for required rejections.
29
+ * @property {string} [tooLongMessage] - Pinned message for too-long rejections.
30
+ * @property {string} [invalidMessage] - Pinned message for invalid dates and non-object/non-string json values.
31
+ * @property {string} [invalidJsonMessage] - Pinned message for unparseable json strings.
32
+ */
33
+
34
+ /**
35
+ * Normalizes writable sync attributes against a declarative schema.
36
+ *
37
+ * Only present keys are validated, so required attributes may be absent —
38
+ * create defaults own that concern. Input keys not declared in the schema are
39
+ * rejected by default so misspelled or read-only attributes fail loudly
40
+ * instead of being silently discarded (`unknownAttributes: "ignore"` opts
41
+ * out). Validation failures throw through the given error factory so apps
42
+ * control the raised error class.
43
+ * @param {object} args - Options.
44
+ * @param {Record<string, ?>} args.attributes - Raw incoming attributes (camelCase and/or snake_case keys).
45
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Maps validation failures to thrown errors.
46
+ * @param {Record<string, SyncAttributeSchemaEntry>} args.schema - Attribute schema keyed by camelCase attribute name.
47
+ * @param {"error" | "ignore"} [args.unknownAttributes] - Unknown input-key handling. Defaults to "error".
48
+ * @returns {Record<string, ?>} Normalized values keyed by snake_case column names.
49
+ */
50
+ export default function normalizeAttributesWithSchema({attributes, errorFactory, schema, unknownAttributes = "error"}) {
51
+ if (!attributes || typeof attributes != "object") throw new Error(`normalizeAttributesWithSchema requires an attributes object, got: ${String(attributes)}`)
52
+ if (typeof errorFactory != "function") throw new Error("normalizeAttributesWithSchema requires an errorFactory function")
53
+ if (!schema || typeof schema != "object") throw new Error(`normalizeAttributesWithSchema requires a schema object, got: ${String(schema)}`)
54
+ if (unknownAttributes != "error" && unknownAttributes != "ignore") {
55
+ throw new Error(`normalizeAttributesWithSchema unknownAttributes must be "error" or "ignore", got: ${String(unknownAttributes)}`)
56
+ }
57
+
58
+ /** @type {Record<string, ?>} */
59
+ const normalized = {}
60
+ /** @type {Set<string>} */
61
+ const knownInputKeys = new Set()
62
+
63
+ for (const [attributeName, entry] of Object.entries(schema)) {
64
+ const column = entry.column ?? snakeCaseKey(attributeName)
65
+ const inputKeys = column == attributeName ? [attributeName] : [column, attributeName]
66
+
67
+ for (const inputKey of inputKeys) {
68
+ knownInputKeys.add(inputKey)
69
+
70
+ if (!Object.prototype.hasOwnProperty.call(attributes, inputKey)) continue
71
+
72
+ normalized[column] = normalizeAttributeValue({attributeName, entry, errorFactory, value: attributes[inputKey]})
73
+ }
74
+ }
75
+
76
+ if (unknownAttributes == "error") {
77
+ for (const inputKey of Object.keys(attributes)) {
78
+ if (!knownInputKeys.has(inputKey)) {
79
+ throw errorFactory(`Unknown attribute: ${inputKey}.`, {code: "sync-unknown-attribute"})
80
+ }
81
+ }
82
+ }
83
+
84
+ return normalized
85
+ }
86
+
87
+ /**
88
+ * Normalizes one present attribute value per its schema entry.
89
+ * @param {object} args - Options.
90
+ * @param {string} args.attributeName - camelCase attribute name.
91
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
92
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
93
+ * @param {?} args.value - Raw value.
94
+ * @returns {?} Normalized value.
95
+ */
96
+ function normalizeAttributeValue({attributeName, entry, errorFactory, value}) {
97
+ const label = entry.label ?? attributeName
98
+
99
+ if (entry.type == "string") return normalizeString({entry, errorFactory, label, value})
100
+ if (entry.type == "date") return normalizeDate({entry, errorFactory, label, value})
101
+ if (entry.type == "json") return normalizeJson({entry, errorFactory, label, value})
102
+ if (entry.type == "raw") return value
103
+
104
+ throw new Error(`Unknown sync attribute schema type for ${attributeName}: ${String(entry.type)}`)
105
+ }
106
+
107
+ /**
108
+ * Normalizes a string attribute: trims, rejects blank required values after trimming, maps empty optional values to null and bounds the trimmed length.
109
+ * @param {object} args - Options.
110
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
111
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
112
+ * @param {string} args.label - Message/code label.
113
+ * @param {?} args.value - Raw value.
114
+ * @returns {string | null} Normalized string.
115
+ */
116
+ function normalizeString({entry, errorFactory, label, value}) {
117
+ const requiredError = () => errorFactory(entry.requiredMessage ?? `${label} is required.`, {code: `sync-${label}-required`})
118
+
119
+ if (value === null || value === undefined || value === "") {
120
+ if (entry.required) throw requiredError()
121
+
122
+ return null
123
+ }
124
+
125
+ const stringValue = String(value).trim()
126
+
127
+ if (stringValue === "") {
128
+ if (entry.required) throw requiredError()
129
+
130
+ return null
131
+ }
132
+
133
+ if (entry.maxLength !== undefined && stringValue.length > entry.maxLength) {
134
+ throw errorFactory(entry.tooLongMessage ?? `${label} is too long (maximum is ${entry.maxLength} characters).`, {code: `sync-${label}-too-long`})
135
+ }
136
+
137
+ return stringValue
138
+ }
139
+
140
+ /**
141
+ * Normalizes a date attribute: Date instances pass through, strings/numbers are parsed and invalid or missing-required values are rejected.
142
+ * @param {object} args - Options.
143
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
144
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
145
+ * @param {string} args.label - Message/code label.
146
+ * @param {?} args.value - Raw value.
147
+ * @returns {Date | null} Normalized date.
148
+ */
149
+ function normalizeDate({entry, errorFactory, label, value}) {
150
+ if (!entry.required && (value === null || value === undefined || value === "")) return null
151
+
152
+ const dateValue = value instanceof Date ? value : typeof value == "string" || typeof value == "number" ? new Date(value) : null
153
+
154
+ if (!dateValue || Number.isNaN(dateValue.getTime())) {
155
+ throw errorFactory(entry.invalidMessage ?? `${label} must be a valid datetime.`, {code: `sync-${label}-invalid-datetime`})
156
+ }
157
+
158
+ return dateValue
159
+ }
160
+
161
+ /**
162
+ * Normalizes a json attribute: empty values become null, objects pass through, strings must parse as JSON and other types are rejected.
163
+ * @param {object} args - Options.
164
+ * @param {SyncAttributeSchemaEntry} args.entry - Schema entry.
165
+ * @param {SyncAttributeErrorFactory} args.errorFactory - Error factory.
166
+ * @param {string} args.label - Message/code label.
167
+ * @param {?} args.value - Raw value.
168
+ * @returns {?} Normalized json value.
169
+ */
170
+ function normalizeJson({entry, errorFactory, label, value}) {
171
+ if (value === null || value === undefined || value === "") return null
172
+ if (typeof value == "object") return value
173
+
174
+ if (typeof value == "string") {
175
+ try {
176
+ return JSON.parse(value)
177
+ } catch (error) {
178
+ throw errorFactory(entry.invalidJsonMessage ?? `${label} must be valid JSON.`, {
179
+ cause: /** @type {Error} */ (error),
180
+ code: `sync-${label}-invalid-json`
181
+ })
182
+ }
183
+ }
184
+
185
+ throw errorFactory(entry.invalidMessage ?? `${label} must be an object or JSON string.`, {code: `sync-${label}-invalid`})
186
+ }