velocious 1.0.563 → 1.0.564

package/src/database/record/index.js

@@ -57,6 +57,10 @@ import ValidatorsUniqueness from "./validators/uniqueness.js"
 import registerActsAsListCallbacks from "./acts-as-list.js"
 import UUID from "pure-uuid"
 
+/**
+ * Translation record shape used by translated attributes.
+ * @typedef {VelociousDatabaseRecord & {locale: function(): string}} TranslationBase
+ */
 /**
  * AttachmentDriverConstructor type.
  * @typedef {import("../../configuration-types.js").AttachmentDriverConstructor} AttachmentDriverConstructor
@@ -4452,11 +4456,6 @@ class VelociousDatabaseRecord {
   }
 }
 
-/**
- * Translation record shape used by translated attributes.
- * @typedef {VelociousDatabaseRecord & {locale: function(): string}} TranslationBase
- */
-
 VelociousDatabaseRecord.registerValidatorType("format", ValidatorsFormat)
 VelociousDatabaseRecord.registerValidatorType("length", ValidatorsLength)
 VelociousDatabaseRecord.registerValidatorType("presence", ValidatorsPresence)

package/src/environment-handlers/node/cli/commands/generate/frontend-models.js

@@ -6,8 +6,6 @@ import * as inflection from "inflection"
 import {frontendModelResourceIsBuiltIn, frontendModelResourcesWithBuiltInsForBackendProject} from "../../../../../frontend-models/built-in-resources.js"
 import {frontendModelResourceClassFromDefinition, frontendModelResourceConfigurationFromDefinition} from "../../../../../frontend-models/resource-definition.js"
 
-const FRONTEND_MODELS_REGENERATE_COMMAND = "velocious generate:frontend-models"
-
 /**
  * Attribute metadata used for generated frontend-model JSDoc.
  * @typedef {object} FrontendAttributeConfig
@@ -47,6 +45,7 @@ const FRONTEND_MODELS_REGENERATE_COMMAND = "velocious generate:frontend-models"
  * @property {string | null} sourceFile - Source file that declared the method.
  * @property {string} type - JSDoc parameter type.
  */
+const FRONTEND_MODELS_REGENERATE_COMMAND = "velocious generate:frontend-models"
 
 /** Node CLI command that generates frontend model classes from backend project resource config. */
 export default class DbGenerateFrontendModels extends BaseCommand {

package/src/frontend-model-controller.js

@@ -20,6 +20,55 @@ import isDate from "./utils/is-date.js"
 import isPlainObject from "./utils/plain-object.js"
 import {RansackQueryError, normalizeRansackGroup, parseRansackSort} from "./utils/ransack.js"
 
+/**
+ * FrontendModelSearch type.
+ * @typedef {object} FrontendModelSearch
+ * @property {string[]} path - Relationship path.
+ * @property {string} column - Column or attribute name.
+ * @property {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} operator - Search operator.
+ * @property {?} value - Search value.
+ */
+/**
+ * FrontendModelSort type.
+ * @typedef {object} FrontendModelSort
+ * @property {string} column - Attribute name to sort by.
+ * @property {"asc" | "desc"} direction - Sort direction.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelGroup type.
+ * @typedef {object} FrontendModelGroup
+ * @property {string} column - Attribute name to group by.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelPluck type.
+ * @typedef {object} FrontendModelPluck
+ * @property {string} column - Attribute name to pluck.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelPagination type.
+ * @typedef {object} FrontendModelPagination
+ * @property {number | null} limit - Maximum number of records.
+ * @property {number | null} offset - Number of records to skip.
+ * @property {number | null} page - 1-based page number.
+ * @property {number | null} perPage - Page size.
+ */
+/**
+ * @typedef {import("./configuration-types.js").ClientErrorPayloadContext & {
+ *   action: string,
+ *   expectedError: boolean,
+ *   frontendModelEndpoint: true
+ * }} FrontendModelEndpointErrorContext
+ */
+/**
+ * FrontendModelIndexQueryOptions type.
+ * @typedef {object} FrontendModelIndexQueryOptions
+ * @property {boolean} [includePagination] - Whether frontend-model pagination params should be applied.
+ * @property {boolean} [includeSort] - Whether frontend-model sort params should be applied.
+ * @property {import("./frontend-model-resource/base-resource.js").default} [resource] - Resource providing query hooks.
+ */
 /** @typedef {import("./database/query/model-class-query.js").default & Record<symbol, Set<string> | undefined>} FrontendModelQueryMetadata */
 
 /**
@@ -114,62 +163,6 @@ function normalizeFrontendModelSelect(select, rootModelName = null) {
   return normalized
 }
 
-/**
- * FrontendModelSearch type.
- * @typedef {object} FrontendModelSearch
- * @property {string[]} path - Relationship path.
- * @property {string} column - Column or attribute name.
- * @property {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} operator - Search operator.
- * @property {?} value - Search value.
- */
-
-/**
- * FrontendModelSort type.
- * @typedef {object} FrontendModelSort
- * @property {string} column - Attribute name to sort by.
- * @property {"asc" | "desc"} direction - Sort direction.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelGroup type.
- * @typedef {object} FrontendModelGroup
- * @property {string} column - Attribute name to group by.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelPluck type.
- * @typedef {object} FrontendModelPluck
- * @property {string} column - Attribute name to pluck.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelPagination type.
- * @typedef {object} FrontendModelPagination
- * @property {number | null} limit - Maximum number of records.
- * @property {number | null} offset - Number of records to skip.
- * @property {number | null} page - 1-based page number.
- * @property {number | null} perPage - Page size.
- */
-
-/**
- * @typedef {import("./configuration-types.js").ClientErrorPayloadContext & {
- *   action: string,
- *   expectedError: boolean,
- *   frontendModelEndpoint: true
- * }} FrontendModelEndpointErrorContext
- */
-
-/**
- * FrontendModelIndexQueryOptions type.
- * @typedef {object} FrontendModelIndexQueryOptions
- * @property {boolean} [includePagination] - Whether frontend-model pagination params should be applied.
- * @property {boolean} [includeSort] - Whether frontend-model sort params should be applied.
- * @property {import("./frontend-model-resource/base-resource.js").default} [resource] - Resource providing query hooks.
- */
-
 const frontendModelJoinedPathsSymbol = Symbol("frontendModelJoinedPaths")
 const frontendModelGroupedColumnsSymbol = Symbol("frontendModelGroupedColumns")
 const frontendModelWhereNoMatchSymbol = Symbol("frontendModelWhereNoMatch")

package/src/frontend-models/base.js

@@ -17,6 +17,23 @@ import {defineModelScope} from "../utils/model-scope.js"
 import isPlainObject from "../utils/plain-object.js"
 import {readPayloadAssociationCount, readPayloadComputedAbility, readPayloadQueryData, setPayloadAssociationCount, setPayloadComputedAbility, setPayloadQueryData} from "../record-payload-values.js"
 
+/**
+ * Frontend model relationship helper type. Returned by `getRelationshipByName`,
+ * which generated models immediately cast to their concrete relationship type
+ * (e.g. `FrontendModelSingularRelationship<Owner, Target, TargetCreateAttributes>`).
+ * The members use `any` type args so that cast is allowed regardless of the
+ * target model's typed-attribute generics — a concrete `FrontendModelBase` member
+ * here makes the cast a non-overlapping (TS2352) error for every typed model.
+ * @typedef {FrontendModelHasManyRelationship<any, any, any> | FrontendModelSingularRelationship<any, any, any>} FrontendModelRelationship
+ */
+/**
+ * Defines this typedef.
+ * @typedef {{callback: (payload: {id: string, model: FrontendModelBase}) => void, eventFilterKey: string | null, eventFilterPayload: import("./query.js").FrontendModelEventFilterPayload | null, projectionPayload: import("./query.js").FrontendModelProjectionPayload}} FrontendModelModelEventCallbackEntry
+ */
+/**
+ * Defines this typedef.
+ * @typedef {{callback: (payload: {id: string}) => void}} FrontendModelDestroyEventCallbackEntry
+ */
 /**
  * FrontendModelCommandType type.
  * @typedef {"create" | "find" | "index" | "update" | "destroy" | "attach" | "attachmentList" | "download" | "url"} FrontendModelCommandType */
@@ -658,16 +675,6 @@ export class FrontendModelHasManyRelationship {
   }
 }
 
-/**
- * Frontend model relationship helper type. Returned by `getRelationshipByName`,
- * which generated models immediately cast to their concrete relationship type
- * (e.g. `FrontendModelSingularRelationship<Owner, Target, TargetCreateAttributes>`).
- * The members use `any` type args so that cast is allowed regardless of the
- * target model's typed-attribute generics — a concrete `FrontendModelBase` member
- * here makes the cast a non-overlapping (TS2352) error for every typed model.
- * @typedef {FrontendModelHasManyRelationship<any, any, any> | FrontendModelSingularRelationship<any, any, any>} FrontendModelRelationship
- */
-
 /**
  * Copies loaded relationship state between helpers of the same relationship shape.
  * @param {object} args - Arguments.
@@ -1279,15 +1286,6 @@ function cloneFrontendModelAttributes(value) {
  */
 const FRONTEND_MODELS_CHANNEL_NAME = "frontend-models"
 
-/**
- * Defines this typedef.
- * @typedef {{callback: (payload: {id: string, model: FrontendModelBase}) => void, eventFilterKey: string | null, eventFilterPayload: import("./query.js").FrontendModelEventFilterPayload | null, projectionPayload: import("./query.js").FrontendModelProjectionPayload}} FrontendModelModelEventCallbackEntry
- */
-/**
- * Defines this typedef.
- * @typedef {{callback: (payload: {id: string}) => void}} FrontendModelDestroyEventCallbackEntry
- */
-
 /**
  * Runs merge frontend model event preload.
  * @param {Record<string, import("./query.js").FrontendModelTransportValue>} target - Target preload payload.

package/src/frontend-models/outgoing-event-buffer.js

@@ -1,13 +1,12 @@
-// @ts-check
-
-const MAX_BUFFERED_OUTGOING_EVENTS = 50
-
 /**
  * BufferedOutgoingEvent type.
  * @typedef {object} BufferedOutgoingEvent
  * @property {string} customPath - Request path.
  * @property {Record<string, ?>} payload - Command payload.
  */
+// @ts-check
+
+const MAX_BUFFERED_OUTGOING_EVENTS = 50
 
 /**
  * Buffer.

package/src/frontend-models/query.js

@@ -5,28 +5,6 @@ import {normalizeRansackGroup, parseRansackSort} from "../utils/ransack.js"
 import {isModelScopeDescriptor} from "../utils/model-scope.js"
 import isPlainObject from "../utils/plain-object.js"
 
-/** Error raised when a frontend-model query descriptor is malformed. */
-export class FrontendModelQueryError extends Error {
-  /**
-   * Creates a frontend-model query error.
-   * @param {string} message - Error message.
-   */
-  constructor(message) {
-    super(message)
-
-    this.name = "FrontendModelQueryError"
-  }
-}
-
-/**
- * Builds a query descriptor error.
- * @param {string} message - Error message.
- * @returns {FrontendModelQueryError} - Query descriptor error.
- */
-function frontendModelQueryError(message) {
-  return new FrontendModelQueryError(message)
-}
-
 /**
  * FrontendModelSearch type.
  * @typedef {object} FrontendModelSearch
@@ -97,6 +75,46 @@ function frontendModelQueryError(message) {
  * @property {FrontendModelEventFilterPayload | null} eventFilterPayload - Normalized event filter payload, or null when unfiltered.
  * @property {FrontendModelProjectionPayload} projectionPayload - Normalized event serialization projection payload.
  */
+/**
+ * FrontendModelSort type.
+ * @typedef {object} FrontendModelSort
+ * @property {string} column - Attribute name to sort by.
+ * @property {"asc" | "desc"} direction - Sort direction.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelGroup type.
+ * @typedef {object} FrontendModelGroup
+ * @property {string} column - Attribute name to group by.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/**
+ * FrontendModelPluck type.
+ * @typedef {object} FrontendModelPluck
+ * @property {string} column - Attribute name to pluck.
+ * @property {string[]} path - Relationship path from root model.
+ */
+/** Error raised when a frontend-model query descriptor is malformed. */
+export class FrontendModelQueryError extends Error {
+  /**
+   * Creates a frontend-model query error.
+   * @param {string} message - Error message.
+   */
+  constructor(message) {
+    super(message)
+
+    this.name = "FrontendModelQueryError"
+  }
+}
+
+/**
+ * Builds a query descriptor error.
+ * @param {string} message - Error message.
+ * @returns {FrontendModelQueryError} - Query descriptor error.
+ */
+function frontendModelQueryError(message) {
+  return new FrontendModelQueryError(message)
+}
 
 /**
  * Runs the normalizePreload helper.
@@ -490,28 +508,6 @@ export function normalizeJoins(joins) {
   return normalized
 }
 
-/**
- * FrontendModelSort type.
- * @typedef {object} FrontendModelSort
- * @property {string} column - Attribute name to sort by.
- * @property {"asc" | "desc"} direction - Sort direction.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelGroup type.
- * @typedef {object} FrontendModelGroup
- * @property {string} column - Attribute name to group by.
- * @property {string[]} path - Relationship path from root model.
- */
-
-/**
- * FrontendModelPluck type.
- * @typedef {object} FrontendModelPluck
- * @property {string} column - Attribute name to pluck.
- * @property {string[]} path - Relationship path from root model.
- */
-
 /**
  * Runs normalize sort direction.
  * @param {?} direction - Direction value.

package/src/frontend-models/resource-definition.js

@@ -5,6 +5,13 @@ import FrontendModelBaseResource from "../frontend-model-resource/base-resource.
 import restArgsError from "../utils/rest-args-error.js"
 import {validateFrontendModelResourceCommandName} from "./resource-config-validation.js"
 
+/**
+ * Resolved frontend-model resource registration for a replay resource type.
+ * @typedef {object} FrontendModelResolvedResourceRegistration
+ * @property {string} modelName - Effective frontend model name (modelName override or registry key).
+ * @property {import("../configuration-types.js").FrontendModelResourceClassType} resourceClass - Registered resource class.
+ * @property {import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration} resourceConfiguration - Normalized resource configuration.
+ */
 const BASE_FRONTEND_MODEL_ABILITY_ACTIONS = ["create", "destroy", "read", "update"]
 const SHA256_INITIAL_HASH = [
   0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a,
@@ -1027,14 +1034,6 @@ function normalizeFrontendModelResourcePathForMatch(path) {
   return withLeadingSlash
 }
 
-/**
- * Resolved frontend-model resource registration for a replay resource type.
- * @typedef {object} FrontendModelResolvedResourceRegistration
- * @property {string} modelName - Effective frontend model name (modelName override or registry key).
- * @property {import("../configuration-types.js").FrontendModelResourceClassType} resourceClass - Registered resource class.
- * @property {import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration} resourceConfiguration - Normalized resource configuration.
- */
-
 /**
  * Resolves the registered frontend-model resource class for a resource type
  * across all backend projects. A resource's effective name is its

package/src/frontend-models/transport-serialization.js

@@ -4,28 +4,26 @@ import {resolveFrontendModelClass} from "./model-registry.js"
 import isPlainObject from "../utils/plain-object.js"
 import {formatDateInTimeZone, validateTimeZone} from "../time-zone.js"
 
-const TYPE_KEY = "__velocious_type"
-const TYPE_DATE = "date"
-const TYPE_UNDEFINED = "undefined"
-const TYPE_BIGINT = "bigint"
-const TYPE_NUMBER = "number"
-const TYPE_FRONTEND_MODEL = "frontend_model"
-const NUMBER_NAN = "NaN"
-const NUMBER_POSITIVE_INFINITY = "Infinity"
-const NUMBER_NEGATIVE_INFINITY = "-Infinity"
-const PRELOADED_RELATIONSHIPS_KEY = "__preloadedRelationships"
-
 /**
  * Frontend model transport serialization options.
  * @typedef {object} FrontendModelTransportSerializationOptions
  * @property {string | undefined} [timeZone] - IANA timezone used when serializing Date instants.
  */
-
 /**
  * Normalized frontend model transport serialization options.
  * @typedef {object} NormalizedFrontendModelTransportSerializationOptions
  * @property {string | undefined} timeZone - Validated IANA timezone used when serializing Date instants.
  */
+const TYPE_KEY = "__velocious_type"
+const TYPE_DATE = "date"
+const TYPE_UNDEFINED = "undefined"
+const TYPE_BIGINT = "bigint"
+const TYPE_NUMBER = "number"
+const TYPE_FRONTEND_MODEL = "frontend_model"
+const NUMBER_NAN = "NaN"
+const NUMBER_POSITIVE_INFINITY = "Infinity"
+const NUMBER_NEGATIVE_INFINITY = "-Infinity"
+const PRELOADED_RELATIONSHIPS_KEY = "__preloadedRelationships"
 
 /**
  * Assign a key to a plain object without triggering the `__proto__` setter.

package/src/frontend-models/websocket-channel.js

@@ -4,6 +4,18 @@ import VelociousWebsocketChannel from "../http-server/websocket-channel.js"
 import Response from "../http-server/client/response.js"
 import {serializeFrontendModelTransportValue} from "./transport-serialization.js"
 
+/**
+ * Defines this typedef.
+ * @typedef {{action?: string, id?: string | number, matchedEventFilterKeys?: string[], record?: import("./query.js").FrontendModelTransportValue, [key: string]: import("./query.js").FrontendModelTransportValue | string[] | undefined}} FrontendModelLifecycleBroadcastBody
+ */
+/**
+ * Defines this typedef.
+ * @typedef {{headers?: () => Record<string, string | string[] | undefined>, remoteAddress?: () => string | undefined}} FrontendModelWebsocketUpgradeRequest
+ */
+/**
+ * Defines this typedef.
+ * @typedef {{headers: () => Record<string, string | string[] | undefined>, header: (name: string) => string | string[] | undefined, metadata: (key?: string) => Record<string, import("./query.js").FrontendModelTransportValue> | import("./query.js").FrontendModelTransportValue | undefined, path: () => string, httpMethod: () => string, remoteAddress: () => string | undefined, origin: () => string | string[] | undefined}} FrontendModelWebsocketSyntheticRequest
+ */
 const EVENT_FILTER_KEYS = new Set(["joins", "key", "searches", "where"])
 
 // Mirrors FRONTEND_MODELS_CHANNEL_NAME in ./websocket-publishers.js, duplicated here
@@ -21,19 +33,6 @@ function transportSerializationOptionsForConfiguration(configuration) {
   }
 }
 
-/**
- * Defines this typedef.
- * @typedef {{action?: string, id?: string | number, matchedEventFilterKeys?: string[], record?: import("./query.js").FrontendModelTransportValue, [key: string]: import("./query.js").FrontendModelTransportValue | string[] | undefined}} FrontendModelLifecycleBroadcastBody
- */
-/**
- * Defines this typedef.
- * @typedef {{headers?: () => Record<string, string | string[] | undefined>, remoteAddress?: () => string | undefined}} FrontendModelWebsocketUpgradeRequest
- */
-/**
- * Defines this typedef.
- * @typedef {{headers: () => Record<string, string | string[] | undefined>, header: (name: string) => string | string[] | undefined, metadata: (key?: string) => Record<string, import("./query.js").FrontendModelTransportValue> | import("./query.js").FrontendModelTransportValue | undefined, path: () => string, httpMethod: () => string, remoteAddress: () => string | undefined, origin: () => string | string[] | undefined}} FrontendModelWebsocketSyntheticRequest
- */
-
 /**
  * Per-session channel subscription for frontend-model lifecycle events.
  * Replaces the legacy `FrontendModelWebsocketChannel` (Phase 3).

package/src/http-server/client/websocket-session.js

@@ -9,6 +9,10 @@ import WebsocketRequest from "./websocket-request.js"
 import WebsocketChannel from "../websocket-channel.js"
 import {websocketEventLogStoreForConfiguration} from "../websocket-event-log-store.js"
 
+/**
+ * Defines this typedef.
+ * @typedef {{type: "subscribe", channel: string, lastEventId?: string, params?: Record<string, ?>} | {type: "metadata", data?: Record<string, ?>} | {type?: "request", body?: ?, headers?: Record<string, ?>, id?: string | number | null, method: string, path: string} | Record<string, ?>} WebsocketSessionMessage
+ */
 const WEBSOCKET_FINAL_FRAME = 0x80
 const WEBSOCKET_OPCODE_CONTINUATION = 0x0
 const WEBSOCKET_OPCODE_TEXT = 0x1
@@ -31,11 +35,6 @@ const WEBSOCKET_MAX_INBOUND_FRAME_BYTES_BIGINT = BigInt(WEBSOCKET_MAX_FINAL_FRAM
 /** Cap on fragment count for a single fragmented message. */
 const WEBSOCKET_MAX_FRAGMENTED_MESSAGE_FRAGMENTS = 1024
 
-/**
- * Defines this typedef.
- * @typedef {{type: "subscribe", channel: string, lastEventId?: string, params?: Record<string, ?>} | {type: "metadata", data?: Record<string, ?>} | {type?: "request", body?: ?, headers?: Record<string, ?>, id?: string | number | null, method: string, path: string} | Record<string, ?>} WebsocketSessionMessage
- */
-
 /**
  * Runs subscribe message.
  * @param {WebsocketSessionMessage} message - Raw websocket message.

package/src/http-server/client-delivery-queue.js

@@ -1,3 +1,10 @@
+/**
+ * @typedef {object} DeliveryTask
+ * @property {number} byteLength - Retained complete-buffer bytes.
+ * @property {boolean} countedFrame - Whether this task is an outbound frame.
+ * @property {() => Promise<void>} delivery - Delivery operation.
+ * @property {(error?: Error) => void} settle - Settles the enqueue promise.
+ */
 // @ts-check
 
 export class ClientDeliveryQueueOverflowError extends Error {
@@ -17,14 +24,6 @@ export class ClientDeliveryQueueOverflowError extends Error {
   }
 }
 
-/**
- * @typedef {object} DeliveryTask
- * @property {number} byteLength - Retained complete-buffer bytes.
- * @property {boolean} countedFrame - Whether this task is an outbound frame.
- * @property {() => Promise<void>} delivery - Delivery operation.
- * @property {(error?: Error) => void} settle - Settles the enqueue promise.
- */
-
 export default class ClientDeliveryQueue {
   /**
    * Builds a per-client delivery queue.

package/src/http-server/websocket-event-log-store.js

@@ -4,11 +4,6 @@ import {randomUUID} from "crypto"
 import TableData from "../database/table-data/index.js"
 import Logger from "../logger.js"
 
-const EVENTS_TABLE = "websocket_channel_events"
-const REPLAY_CHANNELS_TABLE = "websocket_replay_channels"
-const DEFAULT_RETENTION_MS = 10 * 60 * 1000
-const stores = new WeakMap()
-
 /**
  * WebsocketEventRow type.
  * @typedef {object} WebsocketEventRow
@@ -18,12 +13,15 @@ const stores = new WeakMap()
  * @property {string} payload_json - Serialized payload.
  * @property {number | string} sequence - Sequence number.
  */
-
 /**
  * WebsocketReplayChannelRow type.
  * @typedef {object} WebsocketReplayChannelRow
  * @property {string} channel - Channel name.
  */
+const EVENTS_TABLE = "websocket_channel_events"
+const REPLAY_CHANNELS_TABLE = "websocket_replay_channels"
+const DEFAULT_RETENTION_MS = 10 * 60 * 1000
+const stores = new WeakMap()
 
 /**
  * Runs the websocketEventLogStoreForConfiguration helper.

package/src/plugins/sqljs-wasm-route.js

@@ -2,23 +2,21 @@ import {createRequire} from "node:module"
 import path from "node:path"
 import SqlJsWasmRouteController from "./sqljs-wasm-route-controller.js"
 
-const require = createRequire(import.meta.url)
-const sqlJsEntryPath = require.resolve("sql.js")
-const sqlJsDistDirectory = path.dirname(sqlJsEntryPath)
-
 /**
  * InstallSqlJsWasmRouteArgs type.
  * @typedef {object} InstallSqlJsWasmRouteArgs
  * @property {import("../configuration.js").default} configuration - Velocious configuration instance.
  * @property {string} [routePrefix] - Route prefix used for sql.js asset serving.
  */
-
 /**
  * SqlJsLocateFileFromBackendArgs type.
  * @typedef {object} SqlJsLocateFileFromBackendArgs
  * @property {string} backendBaseUrl - Backend base URL (for example `https://api.example.com`).
  * @property {string} [routePrefix] - Route prefix used for sql.js asset serving.
  */
+const require = createRequire(import.meta.url)
+const sqlJsEntryPath = require.resolve("sql.js")
+const sqlJsDistDirectory = path.dirname(sqlJsEntryPath)
 
 /**
  * Runs normalize route prefix.

package/src/sync/conflict-strategy.js

@@ -1,17 +1,11 @@
-// @ts-check
-
-const CONFLICT_STRATEGIES = new Set(["optimisticVersion", "serverWins", "lastWriterWins", "fieldThreeWay", "appendOnly"])
-
 /**
  * @typedef {null | string | number | boolean | unknown[] | Record<string, unknown>} SyncJsonValue
  */
-
 /**
  * @typedef {object} SyncConflictRecord
  * @property {Record<string, SyncJsonValue>} attributes - Record attributes.
  * @property {string | number | boolean | null} [version] - Record version value.
  */
-
 /**
  * @typedef {object} SyncConflictResult
  * @property {Record<string, SyncJsonValue>} [attributes] - Attributes to apply when replay may continue.
@@ -19,6 +13,9 @@ const CONFLICT_STRATEGIES = new Set(["optimisticVersion", "serverWins", "lastWri
  * @property {"applied" | "conflict" | "rejected"} status - Conflict decision.
  * @property {string} strategy - Strategy that produced the decision.
  */
+// @ts-check
+
+const CONFLICT_STRATEGIES = new Set(["optimisticVersion", "serverWins", "lastWriterWins", "fieldThreeWay", "appendOnly"])
 
 /**
  * Evaluates a replay mutation against server/base state using a sync conflict strategy.

package/src/sync/device-identity.js

@@ -1,13 +1,7 @@
-// @ts-check
-
-const ECDSA_P256_SHA256_ALGORITHM = "ECDSA-P256-SHA256"
-const ECDSA_P256_SHA256_SIGNATURE_PREFIX = "ecdsa-p256-sha256-"
-
 /**
  * JSON Web Key used by the sync signing helpers.
  * @typedef {import("node:crypto").webcrypto.JsonWebKey} SyncJsonWebKey
  */
-
 /**
  * Backend-signed device certificate payload.
  * @typedef {object} DeviceCertificatePayload
@@ -18,7 +12,6 @@ const ECDSA_P256_SHA256_SIGNATURE_PREFIX = "ecdsa-p256-sha256-"
  * @property {string} expiresAt - ISO timestamp after which the certificate is invalid.
  * @property {string} issuedAt - ISO timestamp when the backend issued the certificate.
  */
-
 /**
  * Backend-signed device certificate envelope.
  * @typedef {object} DeviceCertificate
@@ -26,7 +19,6 @@ const ECDSA_P256_SHA256_SIGNATURE_PREFIX = "ecdsa-p256-sha256-"
  * @property {DeviceCertificatePayload} certificate - Certificate payload.
  * @property {string} signature - Backend signature over the certificate payload.
  */
-
 /**
  * Sync mutation payload signed by a device.
  * @typedef {object} SyncMutation
@@ -43,7 +35,6 @@ const ECDSA_P256_SHA256_SIGNATURE_PREFIX = "ecdsa-p256-sha256-"
  * @property {Record<string, import("../configuration-types.js").FrontendModelSyncJsonValue>} [payload] - Domain command payload.
  * @property {string} policyHash - Sync policy hash the mutation was checked against.
  */
-
 /**
  * Device-signed mutation envelope.
  * @typedef {object} SignedSyncMutation
@@ -52,6 +43,10 @@ const ECDSA_P256_SHA256_SIGNATURE_PREFIX = "ecdsa-p256-sha256-"
  * @property {SyncMutation} mutation - Mutation payload.
  * @property {string} signature - Device signature over the mutation envelope.
  */
+// @ts-check
+
+const ECDSA_P256_SHA256_ALGORITHM = "ECDSA-P256-SHA256"
+const ECDSA_P256_SHA256_SIGNATURE_PREFIX = "ecdsa-p256-sha256-"
 
 /**
  * Generates an ECDSA P-256 keypair exported as JWKs.