@distrohelena/canton-typescript-sdk 0.1.36 → 0.1.37

package/README.md

@@ -132,7 +132,7 @@ npm run example:topology:party-hosting
 
 ### Workflow examples
 
-The seven workflow examples are standalone proofs, not a sequence:
+The eight stateful workflow examples are standalone proofs, not a sequence:
 each uploads or verifies the fixture DAR, resolves a party, reads the
 participant status, and creates its own run-scoped data. First make a Canton
 participant available and verify the source with `npm run examples:check`; the
@@ -149,14 +149,33 @@ npm run example:workflow:command-completion
 npm run example:workflow:contract-lifecycle-audit
 npm run example:workflow:update-lookup-reconciliation
 npm run example:workflow:pruning-preflight
+npm run example:workflow:participant-local
 ```
 
-Those seven established stateful workflows intentionally leave durable state behind. A missing `SDK_EXAMPLE_PARTY`
+Those eight established stateful workflows intentionally leave durable state behind. A missing `SDK_EXAMPLE_PARTY`
 causes fallback party allocation, which creates durable topology state; every
 one also creates durable contracts. Set `SDK_EXAMPLE_PARTY` to an existing
 party to rerun the established workflows against that party and avoid fallback
 allocation. The fixture DAR remains installed after a run.
 
+The participant-local command-submission workflow
+(`npm run example:workflow:participant-local`) is a standalone gRPC-only proof
+of the ordinary participant submission authorization route. It uses the normal
+`SDK_EXAMPLE_*` endpoint, authentication, party, and timeout configuration:
+`SDK_EXAMPLE_LEDGER_ENDPOINT`, `SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT`,
+`SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT`, `SDK_EXAMPLE_BEARER_TOKEN`,
+`SDK_EXAMPLE_LEDGER_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_ADMIN_BEARER_TOKEN`,
+`SDK_EXAMPLE_PARTICIPANT_ADMIN_BEARER_TOKEN`, `SDK_EXAMPLE_PARTY`,
+`SDK_EXAMPLE_PARTY_PREFIX`, `SDK_EXAMPLE_TIMEOUT_MS`, and
+`SDK_EXAMPLE_TLS_ROOT_CERTIFICATE`. It configures a command signer that throws
+if touched, then successfully creates and finds one exact active Message through
+`commandService.submitParticipantLocalAndWaitAsync`; that success proves the
+configured external signer was bypassed. An explicit party is reused, while
+fallback allocation creates durable topology; the fixture upload leaves a
+durable DAR and the proof leaves a durable contract. The unchanged
+implementation uses the common compatibility path on Participant 3.5.7 and
+the isolated Participant 3.5.8 sidecar.
+
 The completion-correlation workflow (`npm run example:workflow:command-completion`)
 is a standalone successful proof that creates durable Message state. It uses the
 same normal `SDK_EXAMPLE_*` configuration: `SDK_EXAMPLE_LEDGER_ENDPOINT`,
@@ -185,16 +204,17 @@ The update-lookup reconciliation workflow (`npm run example:workflow:update-look
 
 The pruning-preflight workflow (`npm run example:workflow:pruning-preflight`) is a standalone gRPC-only, read-only operator check. It requires `SDK_EXAMPLE_OFFSET` to be a canonical positive decimal integer and uses the normal endpoint, authentication, and timeout variables: `SDK_EXAMPLE_LEDGER_ENDPOINT`, `SDK_EXAMPLE_LEDGER_ADMIN_ENDPOINT`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_ENDPOINT`, `SDK_EXAMPLE_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_BEARER_TOKEN`, `SDK_EXAMPLE_LEDGER_ADMIN_BEARER_TOKEN`, `SDK_EXAMPLE_PARTICIPANT_ADMIN_BEARER_TOKEN`, and `SDK_EXAMPLE_TIMEOUT_MS`. The participant-admin credential is required for the schedule and safe-pruning context reads. Its safe-pruning context request sends the saved ledger end and a validated current timestamp encoded in `beforeOrAt`; it leaves commitment-state absent. It does not mutate the participant or create durable state: no party, DAR, command, update query, schedule change, or pruning request is made. The later participant watermark classifies the supplied offset as `alreadyPruned`, `beyondLedgerEnd`, or `notObservedPruned`; all-divulged watermarks and schedule/safe-pruning context are reported separately and do not alter that result. `notObservedPruned` is not proven queryable, because pruning can race after the later observation and other query preconditions can still fail. The unchanged implementation is supported on Participant 3.5.7 and the isolated Participant 3.5.8 sidecar.
 
-Each of the seven established stateful workflows prints its actor plus the full participant version returned by the
+Each of the eight established stateful workflows prints its actor plus the full participant version returned by the
 authenticated status API, its parsed release core, and its selected path:
 `Participant version:`, `Release core:`, and `Compatibility path:`. The current
 stateful-workflow implementation uses one common-code path for release cores 3.5.7 and 3.5.8. It
 adds a version-specific behavioral difference only after live evidence proves
 one; it does not infer compatibility from a container tag or endpoint.
 
-- `example:workflow:atomic` first proves that an invalid choice is rejected,
-  then proves an atomic create-and-exercise by reading the created replacement
-  and its exact text.
+- `example:workflow:atomic` first proves that a two-command batch with an
+  invalid second command is rejected without creating its valid first Message,
+  then proves that two independent creates commit atomically and remain active
+  with their exact payloads.
 - `example:workflow:retry` submits a caller-controlled command ID with a
   deduplication duration, retries the exact same request, classifies the
   duplicate outcome, and proves that exactly one matching contract is active.
@@ -212,7 +232,7 @@ request and is not a retry proof. The resume example treats the saved offset as
 exclusive, so its resumed stream must observe only updates after the saved
 ledger end.
 
-The seven established stateful workflow sources and unit contracts were developed
+The eight established stateful workflow sources and unit contracts were developed
 and live-tested against authenticated Participant 3.5.7 and the isolated
 Participant 3.5.8. Both final-tree matrices selected the same unchanged implementation and common
 compatibility path. The normalized outcome comparison is identical: atomic
@@ -220,7 +240,7 @@ reports `invalidChoice` before its replacement proof, retry reports
 `duplicateCommand` with one active contract, resume reports `idle-timeout` and
 a post-offset update, and stale-contract reports `staleContract`.
 
-For those seven established stateful workflows, the best multi-version path reads the authenticated full version, parses its
+For those eight established stateful workflows, the best multi-version path reads the authenticated full version, parses its
 release core, and uses data-only structured compatibility for observed
 outcomes. A behavioral difference is introduced only after live proof; it is
 never inferred from a container tag, endpoint, or prose error message. For the
@@ -682,53 +702,103 @@ signature format and algorithm. This convenience operation is gRPC-only.
 
 ## Canton Manager queries
 
-`CantonManager` keeps gRPC as the write path and selects a single query source
-at initialization. PQS exposes the complete PQS relation surface; gRPC exposes
-an all-hosted-party active-contract snapshot.
+`CantonManager` keeps gRPC as the write path and selects one typed-query source
+at initialization. The same typed query function works with either gRPC or
+PQS; source selection changes how the data is read, not the query grammar.
 
 ```ts
 import {
+    CantonClientOptions,
     CantonManager,
+    CreateCommand,
+    DamlRecord,
     MemoryQueryCache,
     QuerySource,
+    SubmitCommandsRequest,
     TransportKind,
 } from "@distrohelena/canton-typescript-sdk";
 
-const manager = new CantonManager({
-    grpc: { transportKind: TransportKind.grpc, ledgerEndpoint: "localhost:6865" },
-    querySource: QuerySource.pqs,
+const options = {
+    grpc: new CantonClientOptions({
+        transportKind: TransportKind.grpc,
+        ledgerEndpoint: "localhost:6865",
+    }),
     pqs: { connectionString: process.env.PQS_URL!, schema: "public" },
     cache: { store: new MemoryQueryCache(), ttlMs: 5_000 },
-});
+};
 
-const contracts = await manager.query.contracts.findMany({
-    where: { templateId: { equals: "packageId:Module:Template" }, active: true },
+const readIous = (manager: CantonManager) => manager.query.contracts.findMany({
+    where: { templateId: { moduleName: { equals: "Main" }, entityName: { equals: "Iou" } } },
+    orderBy: [{ createdAt: "desc" }],
     take: 50,
 });
 
-await manager.grpc.commandService.submitAndWaitAsync(/* existing command request */);
-await manager.disposeAsync();
+const pqsManager = new CantonManager({ ...options, querySource: QuerySource.pqs });
+const grpcManager = new CantonManager({ ...options, querySource: QuerySource.grpc });
+const pqsContracts = await readIous(pqsManager);
+const grpcContracts = await readIous(grpcManager);
+
+// gRPC caching is explicit and point-in-time; ordinary reads never populate it.
+await grpcManager.query.cacheContracts({ parties: ["Alice"] });
+await grpcManager.query.invalidateContractsCache({ parties: ["Alice"] });
+
+// A SubmitCommandsRequest contains a non-empty ordered atomic command batch:
+// all commands commit together, or none of them do.
+await grpcManager.grpc.commandService.submitAndWaitAsync(
+    new SubmitCommandsRequest({
+        applicationId: "example-app",
+        actAs: ["Alice"],
+        commands: [
+            new CreateCommand({
+                templateId: { packageId: "", moduleName: "Main", entityName: "Message" },
+                createArguments: new DamlRecord({ author: "Alice", body: "Hello" }),
+            }),
+        ],
+    }),
+);
+await Promise.all([pqsManager.disposeAsync(), grpcManager.disposeAsync()]);
 ```
 
-With `QuerySource.grpc`, omit `pqs`; contract queries fetch the participant's
-active-contract snapshot using the Ledger API wildcard for all hosted parties.
-PQS-only relation delegates and raw SQL then reject with `QueryCapabilityError`.
-
-PQS managers expose `contracts`, `contractTypes`, `events`, `exercises`,
-`exerciseTypes`, `packages`, `transactions`, and `watermark`. Raw SQL is
-available through `manager.query.$queryRaw(...)` when the selected client is
-PQS-specific. It accepts one read-only statement with positional parameters;
-use a read-only PostgreSQL role as defense in depth.
-
-The PQS relation delegates use a Prisma-like surface: `findMany({ where,
+To migrate a prior singleton submission, pass `commands: [previousCommand]`.
+There is no compatibility alias; put multiple independent commands in that
+array in their required atomic order.
+
+An options object may contain both `grpc` and `pqs`; the PQS setting is used
+only when `querySource` is `pqs`. Both sources expose `contracts`,
+`contractTypes`, `events`, `exercises`, `exerciseTypes`, `packages`,
+`transactions`, and `watermark`, including filters, includes, ordering,
+pagination, projections, grouping, and aggregates. Literal parity requires
+PQS and gRPC to observe the same participant-visible data; independently
+configured participants can legitimately see different contracts.
+
+`cacheContracts` is a gRPC-only explicit prewarm of active contracts for one
+party scope. It needs a cache store and a positive TTL; reads may use a valid
+entry but never renew it. A cached gRPC result is internally consistent at its
+`activeAtOffset`, so it can be stale until expiry, refresh, or
+`invalidateContractsCache`. Under PQS the same lifecycle calls are safe no-ops
+and `cacheContracts` returns `{ source: QuerySource.pqs, cached: false }`.
+
+Typed-query `pk`/`ix` values are canonical and source-independent. Transaction
+and watermark keys are ledger offsets; event, package, contract-type, and
+exercise-type keys are lossless positive-decimal encodings of their stable
+semantic identities. PQS physical keys are retained only for internal joins.
+If pruning has removed history needed by a gRPC typed query, it rejects with
+`QuerySnapshotIncompleteError` rather than returning partial rows, groups, or
+aggregates.
+
+Raw SQL is the sole PQS-only query operation: use
+`pqsManager.query.$queryRaw(...)` for one read-only statement with positional
+parameters and a read-only PostgreSQL role. `$queryRaw` on a gRPC manager
+rejects with `QueryCapabilityError`.
+
+The typed relation delegates use a Prisma-like surface: `findMany({ where,
 select, orderBy, skip, take })`, `findUnique({ where, select })`, `count`, and
 `aggregate({ count, min, max, sum })`. Filters support `equals`, `in`,
 `{ is: null }`, `{ isNot: null }`, and `{ has: party }` on array fields.
-Ordering accepts one field. `exercises` intentionally has no `findUnique`
+Ordering accepts an ordered list of one-field entries, so multi-field ordering
+uses `[{ createdAt: "desc" }, { contractId: "asc" }]`. `exercises` intentionally has no `findUnique`
 because the v1 PQS profile does not declare a stable key. The manager validates
-the selected PQS schema profile before its first query. In gRPC mode, only the
-active-contract `findMany`, `findUnique`, and `count` subset is available;
-unsupported query features reject with `QueryCapabilityError`.
+the selected PQS schema profile before its first PQS query.
 
 - Ledger endpoint:
 - `versionService.getLedgerApiVersionAsync(...)`: `json`, `grpc`

package/dist/cjs/core/types/requests/{submit-command-request.js → submit-commands-request.js}

@@ -1,22 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SubmitCommandRequest = void 0;
+exports.SubmitCommandsRequest = void 0;
 const validation_error_js_1 = require("../../errors/validation-error.js");
 const ledgerStringPattern = /^[A-Za-z0-9#:\-_/ ]+$/;
 const canonicalOffsetPattern = /^(0|[1-9][0-9]*)$/;
 const maximumInt64Offset = "9223372036854775807";
-class SubmitCommandRequest {
+class SubmitCommandsRequest {
     applicationId;
     userId;
     actAs;
     readAs;
-    command;
+    commands;
     commandId;
     deduplicationPeriod;
     disclosedContracts;
     synchronizerId;
     constructor(init) {
-        if (init.actAs.length === 0) {
+        const commands = init.commands;
+        if (!Array.isArray(commands) || commands.length === 0) {
+            throw new validation_error_js_1.ValidationError("submit requests require at least one command");
+        }
+        else if (init.actAs.length === 0) {
             throw new validation_error_js_1.ValidationError("submit requests require at least one actAs party");
         }
         else if (init.commandId !== undefined &&
@@ -30,14 +34,14 @@ class SubmitCommandRequest {
         this.userId = init.userId;
         this.actAs = init.actAs;
         this.readAs = init.readAs ?? [];
-        this.command = init.command;
+        this.commands = Object.freeze([...commands]);
         this.commandId = init.commandId;
         this.deduplicationPeriod = deduplicationPeriod;
         this.disclosedContracts = init.disclosedContracts ?? [];
         this.synchronizerId = init.synchronizerId;
     }
 }
-exports.SubmitCommandRequest = SubmitCommandRequest;
+exports.SubmitCommandsRequest = SubmitCommandsRequest;
 function freezeDeduplicationPeriod(value) {
     if (value === undefined) {
         return undefined;

package/dist/cjs/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExternalPartySigningAlgorithmSpec = exports.ExternalPartySignatureFormat = exports.ExternalPartySignature = exports.ExternalPartyOnboardingTransaction = exports.ExternalPartyCryptoKeyFormat = exports.TransportKind = exports.TransportCapability = exports.SignCommandResult = exports.SignCommandRequest = exports.BearerTokenAuthProvider = exports.SynchronizerConnectivityServiceClient = exports.VersionServiceClient = exports.UserManagementServiceClient = exports.UpdateServiceClient = exports.TrafficControlServiceClient = exports.TopologyManagerWriteServiceClient = exports.TopologyManagerReadServiceClient = exports.TopologyAggregationServiceClient = exports.StateServiceClient = exports.ResourceManagementServiceClient = exports.PruningServiceClient = exports.PartyManagementServiceClient = exports.ParticipantStatusServiceClient = exports.ParticipantRepairServiceClient = exports.ParticipantPackageServiceClient = exports.ParticipantPartyManagementServiceClient = exports.ParticipantInspectionServiceClient = exports.PackageServiceClient = exports.PackageManagementServiceClient = exports.IdentityProviderConfigServiceClient = exports.IdentityInitializationServiceClient = exports.HealthServiceClient = exports.EventQueryServiceClient = exports.ContractServiceClient = exports.CommandSubmissionServiceClient = exports.CommandServiceClient = exports.CommandInspectionServiceClient = exports.CommandCompletionServiceClient = exports.ExternalPartyActivationResponse = exports.ExternalPartyActivationRequest = exports.ExternalPartyActivationClient = exports.CantonClientOptions = exports.CantonHashingClient = exports.PqsSchemaProfileError = exports.PqsQueryError = exports.QueryCapabilityError = exports.MemoryQueryCache = exports.QuerySource = exports.CantonManager = exports.CantonClient = void 0;
-exports.ParticipantDarDescription = exports.PackageReference = exports.PackageMetadataFilter = exports.ActiveContractsTraversalOptions = exports.OperationDeadline = exports.RequestOptions = exports.ReceivedAcsCommitmentState = exports.ReceivedAcsCommitmentPerSynchronizer = exports.ReceivedAcsCommitment = exports.PruningSchedule = exports.ParticipantPruningSchedule = exports.PendingOperationMetadata = exports.PackageStatus = exports.CantonHashPurpose = exports.HashFunction = exports.PackageFormat = exports.OffsetCheckpoint = exports.ObjectMeta = exports.LedgerUser = exports.KnownPackageDetails = exports.IdentityProviderConfig = exports.UserRightKind = exports.EventStreamKind = exports.DamlParty = exports.DamlNumeric = exports.ContractCreated = exports.ContractArchived = exports.CounterParticipantInfo = exports.CommitmentTimeRange = exports.CommitmentInterval = exports.Completion = exports.CommandUpdateSummary = exports.CommandTiming = exports.CommandStatus = exports.CommandState = exports.CommandRequestStatistics = exports.CommandInspectionContract = exports.ConnectedSynchronizerStatus = exports.ConnectedSynchronizer = exports.ConnectedSynchronizerHealth = exports.AdminTopologyQueueStatus = exports.AdminNotInitializedStatus = exports.AdminNotInitializedExternalInputKind = exports.AdminNodeStatus = exports.AdminComponentStatus = exports.AdminComponentHealthKind = exports.SubmissionMode = exports.GrpcChannelSecurity = exports.ExternalPartySigningPublicKey = exports.ExternalPartySigningKeySpec = void 0;
-exports.TopologyForceFlag = exports.TopologyPublicKey = exports.TopologyPartyResult = exports.TopologyPartyParticipantSynchronizerPermission = exports.TopologyPartyParticipant = exports.TopologyMappingResult = exports.TopologyMappingOperation = exports.TopologyMappingCode = exports.TopologyKeyOwnerResult = exports.MultiTopologyTransactionSignature = exports.GeneratedTopologyTransaction = exports.TopologyEncryptionPublicKey = exports.ExternalTopologySignature = exports.TopologyDuration = exports.TopologyBaseResult = exports.TopologyBaseQuery = exports.SynchronizerTrustCertificate = exports.SequencerSynchronizerState = exports.PartyToParticipantParticipant = exports.PartyToParticipantOnboarding = exports.PartyToParticipant = exports.PartyToKeyMapping = exports.PartyHostingLimits = exports.ParticipantSynchronizerPermission = exports.ParticipantSynchronizerLimits = exports.ParticipantPermission = exports.OwnerToKeyMapping = exports.OnboardingRestriction = exports.NamespaceDelegationRestrictionKind = exports.NamespaceDelegationRestriction = exports.NamespaceDelegation = exports.MediatorSynchronizerState = exports.LsuSequencerConnectionSuccessor = exports.LsuSequencerConnection = exports.LsuAnnouncement = exports.DynamicSynchronizerParameters = exports.DynamicSequencingParameters = exports.DecentralizedNamespaceDefinition = exports.AcsCommitmentsCatchUpConfig = exports.WaitCommitmentsSetup = exports.TopologyStateFilter = exports.SynchronizerTimeRange = exports.SlowCounterParticipantSynchronizerConfig = exports.SentAcsCommitmentState = exports.SentAcsCommitmentPerSynchronizer = exports.SentAcsCommitment = exports.SdkCommand = exports.SafeToPruneCommitmentState = exports.ParticipantPackageDescription = exports.ParticipantModuleDescription = void 0;
-exports.ListDecentralizedNamespaceDefinitionRequest = exports.ListAllRequest = exports.ListPackagesRequest = exports.GetCommandStatusRequest = exports.GetActiveContractsRequest = exports.GetActiveContractsPageRequest = exports.GetDarRequest = exports.GetDarContentsRequest = exports.AssembleSignedTopologyTransactionsRequest = exports.SubmitCommandTransactionResponse = exports.DamlRecord = exports.DamlEnum = exports.DamlVariant = exports.DamlGenMap = exports.DamlTextMap = exports.DamlTimestamp = exports.DamlDate = exports.DamlUnit = exports.DamlContractId = exports.PreparedCommandSubmission = exports.DisclosedContract = exports.AllocatePartyRequest = exports.CreateExternalPartyRequest = exports.PreparedDecentralizedParty = exports.FinalizeDecentralizedPartyRequest = exports.CreateDecentralizedPartyRequest = exports.ExerciseCommand = exports.ExerciseByKeyCommand = exports.CreateCommand = exports.CreateAndExerciseCommand = exports.SignedTopologyTransaction = exports.PreparedTopologyTransaction = exports.VettedPackages = exports.VettedPackage = exports.TrafficControlParameters = exports.TopologyVettedPackages = exports.TopologyVettedPackage = exports.TopologyTransactions = exports.TopologyTransactionItem = exports.TopologyTransactionSignature = exports.TopologyTimeRange = exports.TopologyStoreTemporary = exports.TopologyStoreSynchronizer = exports.TopologyStoreKind = exports.TopologyStoreId = exports.TopologyStoreAuthorized = exports.TopologySigningPublicKey = exports.TopologySigningKeysWithThreshold = exports.TopologySignatureFormat = exports.TopologySignatureDelegation = void 0;
-exports.ListDecentralizedNamespaceDefinitionResponse = exports.ListAllResponse = exports.GetUserResponse = exports.GetPartiesResponse = exports.GetPackageStatusResponse = exports.GetPackageResponse = exports.GetLedgerEndResponse = exports.GetLatestPrunedOffsetsResponse = exports.GetIdentityProviderConfigResponse = exports.GetCommandStatusResponse = exports.GetConnectedSynchronizersResponse = exports.GetActiveContractsPageResponse = exports.GetDarResponse = exports.GetDarContentsResponse = exports.AllocatePartyResponse = exports.UploadDarFileRequest = exports.GrantUserRightsRequest = exports.WaitForPartyHostingRequest = exports.TopologyListPartiesRequest = exports.SubmitCommandRequest = exports.ListUsersRequest = exports.ListUserRightsRequest = exports.ListKeyOwnersRequest = exports.ListIdentityProviderConfigsRequest = exports.ListDarsRequest = exports.ListKnownPackagesRequest = exports.ListKnownPartiesRequest = exports.TopologyListVettedPackagesRequest = exports.ListSynchronizerTrustCertificateRequest = exports.ListSynchronizerParametersStateRequest = exports.ListSequencingParametersStateRequest = exports.ListSequencerSynchronizerStateRequest = exports.ListPartyToParticipantRequest = exports.ListPartyToKeyMappingRequest = exports.ListVettedPackagesRequest = exports.ListPartyHostingLimitsRequest = exports.ListParticipantSynchronizerPermissionRequest = exports.ListOwnerToKeyMappingRequest = exports.ListNamespaceDelegationRequest = exports.ListMediatorSynchronizerStateRequest = exports.ListLsuSequencerConnectionSuccessorRequest = exports.ListLsuAnnouncementRequest = exports.GetUserRequest = exports.GetPartiesRequest = exports.GetLedgerEndRequest = exports.GetLatestPrunedOffsetsRequest = exports.GetConnectedSynchronizersRequest = exports.GetPackageStatusRequest = exports.GetPackageRequest = exports.GetIdentityProviderConfigRequest = void 0;
-exports.EndpointNotConfiguredError = exports.ObjectDisposedError = exports.NotSupportedError = exports.ConflictError = exports.TimeoutError = exports.SigningError = exports.GrpcTransportError = exports.TransportError = exports.AuthorizationError = exports.AuthenticationError = exports.ActiveContractsTraversalError = exports.ValidationError = exports.CantonError = exports.SynchronizerTime = exports.ParticipantNodeStatus = exports.PartyDetails = exports.UploadDarFileResponse = exports.GrantUserRightsResponse = exports.SubmitCommandResponse = exports.TopologyListPartiesResponse = exports.TopologyListVettedPackagesResponse = exports.ListVettedPackagesResponse = exports.ListUsersResponse = exports.ListUserRightsResponse = exports.ListSynchronizerTrustCertificateResponse = exports.ListSynchronizerParametersStateResponse = exports.ListSequencingParametersStateResponse = exports.ListSequencerSynchronizerStateResponse = exports.ListPartyToParticipantResponse = exports.ListPartyToKeyMappingResponse = exports.ListPartyHostingLimitsResponse = exports.ListParticipantSynchronizerPermissionResponse = exports.ListKeyOwnersResponse = exports.ListKnownPartiesResponse = exports.ListKnownPackagesResponse = exports.ListIdentityProviderConfigsResponse = exports.ListDarsResponse = exports.ListPackagesResponse = exports.ListOwnerToKeyMappingResponse = exports.ListNamespaceDelegationResponse = exports.ListMediatorSynchronizerStateResponse = exports.ListLsuSequencerConnectionSuccessorResponse = exports.ListLsuAnnouncementResponse = void 0;
+exports.ExternalPartySignatureFormat = exports.ExternalPartySignature = exports.ExternalPartyOnboardingTransaction = exports.ExternalPartyCryptoKeyFormat = exports.TransportKind = exports.TransportCapability = exports.SignCommandResult = exports.SignCommandRequest = exports.BearerTokenAuthProvider = exports.SynchronizerConnectivityServiceClient = exports.VersionServiceClient = exports.UserManagementServiceClient = exports.UpdateServiceClient = exports.TrafficControlServiceClient = exports.TopologyManagerWriteServiceClient = exports.TopologyManagerReadServiceClient = exports.TopologyAggregationServiceClient = exports.StateServiceClient = exports.ResourceManagementServiceClient = exports.PruningServiceClient = exports.PartyManagementServiceClient = exports.ParticipantStatusServiceClient = exports.ParticipantRepairServiceClient = exports.ParticipantPackageServiceClient = exports.ParticipantPartyManagementServiceClient = exports.ParticipantInspectionServiceClient = exports.PackageServiceClient = exports.PackageManagementServiceClient = exports.IdentityProviderConfigServiceClient = exports.IdentityInitializationServiceClient = exports.HealthServiceClient = exports.EventQueryServiceClient = exports.ContractServiceClient = exports.CommandSubmissionServiceClient = exports.CommandServiceClient = exports.CommandInspectionServiceClient = exports.CommandCompletionServiceClient = exports.ExternalPartyActivationResponse = exports.ExternalPartyActivationRequest = exports.ExternalPartyActivationClient = exports.CantonClientOptions = exports.CantonHashingClient = exports.PqsSchemaProfileError = exports.PqsQueryError = exports.QuerySnapshotIncompleteError = exports.QueryCapabilityError = exports.MemoryQueryCache = exports.QuerySource = exports.CantonManager = exports.CantonClient = void 0;
+exports.PackageReference = exports.PackageMetadataFilter = exports.ActiveContractsTraversalOptions = exports.OperationDeadline = exports.RequestOptions = exports.ReceivedAcsCommitmentState = exports.ReceivedAcsCommitmentPerSynchronizer = exports.ReceivedAcsCommitment = exports.PruningSchedule = exports.ParticipantPruningSchedule = exports.PendingOperationMetadata = exports.PackageStatus = exports.CantonHashPurpose = exports.HashFunction = exports.PackageFormat = exports.OffsetCheckpoint = exports.ObjectMeta = exports.LedgerUser = exports.KnownPackageDetails = exports.IdentityProviderConfig = exports.UserRightKind = exports.EventStreamKind = exports.DamlParty = exports.DamlNumeric = exports.ContractCreated = exports.ContractArchived = exports.CounterParticipantInfo = exports.CommitmentTimeRange = exports.CommitmentInterval = exports.Completion = exports.CommandUpdateSummary = exports.CommandTiming = exports.CommandStatus = exports.CommandState = exports.CommandRequestStatistics = exports.CommandInspectionContract = exports.ConnectedSynchronizerStatus = exports.ConnectedSynchronizer = exports.ConnectedSynchronizerHealth = exports.AdminTopologyQueueStatus = exports.AdminNotInitializedStatus = exports.AdminNotInitializedExternalInputKind = exports.AdminNodeStatus = exports.AdminComponentStatus = exports.AdminComponentHealthKind = exports.SubmissionMode = exports.GrpcChannelSecurity = exports.ExternalPartySigningPublicKey = exports.ExternalPartySigningKeySpec = exports.ExternalPartySigningAlgorithmSpec = void 0;
+exports.TopologyPublicKey = exports.TopologyPartyResult = exports.TopologyPartyParticipantSynchronizerPermission = exports.TopologyPartyParticipant = exports.TopologyMappingResult = exports.TopologyMappingOperation = exports.TopologyMappingCode = exports.TopologyKeyOwnerResult = exports.MultiTopologyTransactionSignature = exports.GeneratedTopologyTransaction = exports.TopologyEncryptionPublicKey = exports.ExternalTopologySignature = exports.TopologyDuration = exports.TopologyBaseResult = exports.TopologyBaseQuery = exports.SynchronizerTrustCertificate = exports.SequencerSynchronizerState = exports.PartyToParticipantParticipant = exports.PartyToParticipantOnboarding = exports.PartyToParticipant = exports.PartyToKeyMapping = exports.PartyHostingLimits = exports.ParticipantSynchronizerPermission = exports.ParticipantSynchronizerLimits = exports.ParticipantPermission = exports.OwnerToKeyMapping = exports.OnboardingRestriction = exports.NamespaceDelegationRestrictionKind = exports.NamespaceDelegationRestriction = exports.NamespaceDelegation = exports.MediatorSynchronizerState = exports.LsuSequencerConnectionSuccessor = exports.LsuSequencerConnection = exports.LsuAnnouncement = exports.DynamicSynchronizerParameters = exports.DynamicSequencingParameters = exports.DecentralizedNamespaceDefinition = exports.AcsCommitmentsCatchUpConfig = exports.WaitCommitmentsSetup = exports.TopologyStateFilter = exports.SynchronizerTimeRange = exports.SlowCounterParticipantSynchronizerConfig = exports.SentAcsCommitmentState = exports.SentAcsCommitmentPerSynchronizer = exports.SentAcsCommitment = exports.SdkCommand = exports.SafeToPruneCommitmentState = exports.ParticipantPackageDescription = exports.ParticipantModuleDescription = exports.ParticipantDarDescription = void 0;
+exports.ListAllRequest = exports.ListPackagesRequest = exports.GetCommandStatusRequest = exports.GetActiveContractsRequest = exports.GetActiveContractsPageRequest = exports.GetDarRequest = exports.GetDarContentsRequest = exports.AssembleSignedTopologyTransactionsRequest = exports.SubmitCommandTransactionResponse = exports.DamlRecord = exports.DamlEnum = exports.DamlVariant = exports.DamlGenMap = exports.DamlTextMap = exports.DamlTimestamp = exports.DamlDate = exports.DamlUnit = exports.DamlContractId = exports.PreparedCommandSubmission = exports.DisclosedContract = exports.AllocatePartyRequest = exports.CreateExternalPartyRequest = exports.PreparedDecentralizedParty = exports.FinalizeDecentralizedPartyRequest = exports.CreateDecentralizedPartyRequest = exports.ExerciseCommand = exports.ExerciseByKeyCommand = exports.CreateCommand = exports.CreateAndExerciseCommand = exports.SignedTopologyTransaction = exports.PreparedTopologyTransaction = exports.VettedPackages = exports.VettedPackage = exports.TrafficControlParameters = exports.TopologyVettedPackages = exports.TopologyVettedPackage = exports.TopologyTransactions = exports.TopologyTransactionItem = exports.TopologyTransactionSignature = exports.TopologyTimeRange = exports.TopologyStoreTemporary = exports.TopologyStoreSynchronizer = exports.TopologyStoreKind = exports.TopologyStoreId = exports.TopologyStoreAuthorized = exports.TopologySigningPublicKey = exports.TopologySigningKeysWithThreshold = exports.TopologySignatureFormat = exports.TopologySignatureDelegation = exports.TopologyForceFlag = void 0;
+exports.ListAllResponse = exports.GetUserResponse = exports.GetPartiesResponse = exports.GetPackageStatusResponse = exports.GetPackageResponse = exports.GetLedgerEndResponse = exports.GetLatestPrunedOffsetsResponse = exports.GetIdentityProviderConfigResponse = exports.GetCommandStatusResponse = exports.GetConnectedSynchronizersResponse = exports.GetActiveContractsPageResponse = exports.GetDarResponse = exports.GetDarContentsResponse = exports.AllocatePartyResponse = exports.UploadDarFileRequest = exports.GrantUserRightsRequest = exports.WaitForPartyHostingRequest = exports.TopologyListPartiesRequest = exports.SubmitCommandsRequest = exports.ListUsersRequest = exports.ListUserRightsRequest = exports.ListKeyOwnersRequest = exports.ListIdentityProviderConfigsRequest = exports.ListDarsRequest = exports.ListKnownPackagesRequest = exports.ListKnownPartiesRequest = exports.TopologyListVettedPackagesRequest = exports.ListSynchronizerTrustCertificateRequest = exports.ListSynchronizerParametersStateRequest = exports.ListSequencingParametersStateRequest = exports.ListSequencerSynchronizerStateRequest = exports.ListPartyToParticipantRequest = exports.ListPartyToKeyMappingRequest = exports.ListVettedPackagesRequest = exports.ListPartyHostingLimitsRequest = exports.ListParticipantSynchronizerPermissionRequest = exports.ListOwnerToKeyMappingRequest = exports.ListNamespaceDelegationRequest = exports.ListMediatorSynchronizerStateRequest = exports.ListLsuSequencerConnectionSuccessorRequest = exports.ListLsuAnnouncementRequest = exports.GetUserRequest = exports.GetPartiesRequest = exports.GetLedgerEndRequest = exports.GetLatestPrunedOffsetsRequest = exports.GetConnectedSynchronizersRequest = exports.GetPackageStatusRequest = exports.GetPackageRequest = exports.GetIdentityProviderConfigRequest = exports.ListDecentralizedNamespaceDefinitionRequest = void 0;
+exports.EndpointNotConfiguredError = exports.ObjectDisposedError = exports.NotSupportedError = exports.ConflictError = exports.TimeoutError = exports.SigningError = exports.GrpcTransportError = exports.TransportError = exports.AuthorizationError = exports.AuthenticationError = exports.ActiveContractsTraversalError = exports.ValidationError = exports.CantonError = exports.SynchronizerTime = exports.ParticipantNodeStatus = exports.PartyDetails = exports.UploadDarFileResponse = exports.GrantUserRightsResponse = exports.SubmitCommandResponse = exports.TopologyListPartiesResponse = exports.TopologyListVettedPackagesResponse = exports.ListVettedPackagesResponse = exports.ListUsersResponse = exports.ListUserRightsResponse = exports.ListSynchronizerTrustCertificateResponse = exports.ListSynchronizerParametersStateResponse = exports.ListSequencingParametersStateResponse = exports.ListSequencerSynchronizerStateResponse = exports.ListPartyToParticipantResponse = exports.ListPartyToKeyMappingResponse = exports.ListPartyHostingLimitsResponse = exports.ListParticipantSynchronizerPermissionResponse = exports.ListKeyOwnersResponse = exports.ListKnownPartiesResponse = exports.ListKnownPackagesResponse = exports.ListIdentityProviderConfigsResponse = exports.ListDarsResponse = exports.ListPackagesResponse = exports.ListOwnerToKeyMappingResponse = exports.ListNamespaceDelegationResponse = exports.ListMediatorSynchronizerStateResponse = exports.ListLsuSequencerConnectionSuccessorResponse = exports.ListLsuAnnouncementResponse = exports.ListDecentralizedNamespaceDefinitionResponse = void 0;
 var canton_client_js_1 = require("./client/canton-client.js");
 Object.defineProperty(exports, "CantonClient", { enumerable: true, get: function () { return canton_client_js_1.CantonClient; } });
 var canton_manager_js_1 = require("./query/canton-manager.js");
@@ -16,6 +16,8 @@ var memory_query_cache_js_1 = require("./query/cache/memory-query-cache.js");
 Object.defineProperty(exports, "MemoryQueryCache", { enumerable: true, get: function () { return memory_query_cache_js_1.MemoryQueryCache; } });
 var query_capability_error_js_1 = require("./query/errors/query-capability-error.js");
 Object.defineProperty(exports, "QueryCapabilityError", { enumerable: true, get: function () { return query_capability_error_js_1.QueryCapabilityError; } });
+var query_snapshot_incomplete_error_js_1 = require("./query/errors/query-snapshot-incomplete-error.js");
+Object.defineProperty(exports, "QuerySnapshotIncompleteError", { enumerable: true, get: function () { return query_snapshot_incomplete_error_js_1.QuerySnapshotIncompleteError; } });
 var pqs_query_error_js_1 = require("./query/errors/pqs-query-error.js");
 Object.defineProperty(exports, "PqsQueryError", { enumerable: true, get: function () { return pqs_query_error_js_1.PqsQueryError; } });
 var pqs_schema_profile_error_js_1 = require("./query/errors/pqs-schema-profile-error.js");
@@ -458,8 +460,8 @@ var list_user_rights_request_js_1 = require("./core/types/requests/list-user-rig
 Object.defineProperty(exports, "ListUserRightsRequest", { enumerable: true, get: function () { return list_user_rights_request_js_1.ListUserRightsRequest; } });
 var list_users_request_js_1 = require("./core/types/requests/list-users-request.js");
 Object.defineProperty(exports, "ListUsersRequest", { enumerable: true, get: function () { return list_users_request_js_1.ListUsersRequest; } });
-var submit_command_request_js_1 = require("./core/types/requests/submit-command-request.js");
-Object.defineProperty(exports, "SubmitCommandRequest", { enumerable: true, get: function () { return submit_command_request_js_1.SubmitCommandRequest; } });
+var submit_commands_request_js_1 = require("./core/types/requests/submit-commands-request.js");
+Object.defineProperty(exports, "SubmitCommandsRequest", { enumerable: true, get: function () { return submit_commands_request_js_1.SubmitCommandsRequest; } });
 var topology_list_parties_request_js_1 = require("./core/types/requests/topology-list-parties-request.js");
 Object.defineProperty(exports, "TopologyListPartiesRequest", { enumerable: true, get: function () { return topology_list_parties_request_js_1.TopologyListPartiesRequest; } });
 var wait_for_party_hosting_request_js_1 = require("./core/types/requests/wait-for-party-hosting-request.js");

package/dist/cjs/query/canonical/in-memory-query-evaluator.js

@@ -0,0 +1,291 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryQueryEvaluator = void 0;
+const query_dataset_js_1 = require("./query-dataset.js");
+const query_schema_js_1 = require("./query-schema.js");
+/** Reference evaluator for normalized canonical plans; it intentionally has no transport concerns. */
+class InMemoryQueryEvaluator {
+    execute(dataset, query) {
+        const compiled = (0, query_dataset_js_1.createQueryDataset)(dataset);
+        switch (query.kind) {
+            case "findMany": return freeze(this.findMany(compiled, query));
+            case "findUnique": return freeze(this.findMany(compiled, { kind: "findMany", relation: query.relation, predicate: query.predicate, select: query.select, includes: query.includes, orderBy: [], skip: 0, take: 1, activeOnly: false })[0]);
+            case "count": return this.filtered(compiled, query.relation, query.predicate, query.parties, query.activeOnly).length;
+            case "aggregate": return freeze(this.aggregate(this.filtered(compiled, query.relation, query.predicate), query));
+            case "groupBy": return freeze(this.groupBy(compiled, query));
+        }
+    }
+    findMany(dataset, query) {
+        const rows = this.order(this.filtered(dataset, query.relation, query.predicate, query.parties, query.activeOnly), query.orderBy)
+            .slice(query.skip, query.take === undefined ? undefined : query.skip + query.take);
+        return rows.map((row) => this.shape(dataset, query.relation, row, query.select, query.includes));
+    }
+    filtered(dataset, relation, predicate, parties, activeOnly = false) {
+        return dataset.rows[relation].filter((row) => (!activeOnly || row.active === true)
+            && (parties === undefined || (Array.isArray(row.witnesses) && row.witnesses.some((party) => parties.includes(String(party)))))
+            && (predicate === undefined || this.matches(dataset, relation, row, predicate)));
+    }
+    matches(dataset, relation, row, predicate) {
+        switch (predicate.kind) {
+            case "and": return predicate.children.every((child) => this.matches(dataset, relation, row, child));
+            case "or": return predicate.children.some((child) => this.matches(dataset, relation, row, child));
+            case "not": return !this.matches(dataset, relation, row, predicate.child);
+            case "relation": {
+                const edge = query_schema_js_1.queryRelationEdges[relation]?.[predicate.edge];
+                if (edge === undefined) {
+                    throw new Error(`Unknown ${relation}.${predicate.edge} edge`);
+                }
+                const related = this.related(dataset, relation, row, predicate.edge);
+                const result = related.map((target) => this.matches(dataset, edge.target, target, predicate.predicate));
+                return predicate.quantifier === "one" ? result[0] === true : predicate.quantifier === "some" ? result.some(Boolean) : predicate.quantifier === "none" ? !result.some(Boolean) : result.every(Boolean);
+            }
+            case "scalar": {
+                const actual = at(row, predicate.path);
+                const expected = predicate.value;
+                switch (predicate.operator) {
+                    case "equals": return actual !== null && actual !== undefined && expected !== null && expected !== undefined && equal(actual, expected);
+                    case "in": return actual !== null && actual !== undefined && Array.isArray(expected) && expected.some((candidate) => candidate !== null && candidate !== undefined && equal(actual, candidate));
+                    case "is": return actual === null || actual === undefined;
+                    case "isNot": return actual !== null && actual !== undefined;
+                    case "lt": return compare(actual, expected) < 0;
+                    case "lte": return compare(actual, expected) <= 0;
+                    case "gt": return compare(actual, expected) > 0;
+                    case "gte": return compare(actual, expected) >= 0;
+                    case "like": return typeof actual === "string" && typeof expected === "string" && sqlLike(actual, expected, false);
+                    case "ilike": return typeof actual === "string" && typeof expected === "string" && sqlLike(actual, expected, true);
+                    case "has": return Array.isArray(actual) && actual.some((entry) => equal(entry, expected));
+                }
+                return false;
+            }
+        }
+    }
+    related(dataset, relation, row, edge) {
+        return [...(0, query_dataset_js_1.relatedQueryRows)(dataset, relation, row, edge)];
+    }
+    shape(dataset, relation, row, selection, includes) {
+        const fields = selection?.fields ?? Object.keys(row);
+        const result = Object.fromEntries(fields.filter((field) => Object.hasOwn(row, field)).map((field) => [field, clone(row[field])]));
+        for (const projection of selection?.json ?? []) {
+            result[projection.name] = project(at(row, [projection.field, ...projection.path]), projection.as);
+        }
+        for (const include of includes) {
+            const targets = this.related(dataset, relation, row, include.edge).filter((target) => include.predicate === undefined || this.matches(dataset, include.relation, target, include.predicate));
+            const bounded = this.order(targets, include.orderBy).slice(include.skip, include.take === undefined ? undefined : include.skip + include.take)
+                .map((target) => this.shape(dataset, include.relation, target, include.select, include.includes));
+            result[include.edge] = include.cardinality === "many" ? bounded : (bounded[0] ?? null);
+        }
+        return result;
+    }
+    order(rows, orderBy) {
+        return rows.map((row, index) => ({ row, index })).sort((left, right) => {
+            for (const order of orderBy) {
+                const compared = postgresCompare(at(left.row, order.path), at(right.row, order.path), order.direction);
+                if (compared !== 0) {
+                    return compared;
+                }
+            }
+            return left.index - right.index;
+        }).map(({ row }) => row);
+    }
+    aggregate(rows, query) {
+        const metadata = query_schema_js_1.queryRelationMetadata[query.relation];
+        const result = {};
+        if (query.aggregates.count) {
+            result.count = rows.length;
+        }
+        for (const operation of ["min", "max", "sum"]) {
+            if (query.aggregates[operation].length > 0) {
+                for (const field of query.aggregates[operation]) {
+                    if (!metadata.numericFields.includes(field)) {
+                        throw new Error(`${field} is not a numeric aggregate field of ${query.relation}`);
+                    }
+                }
+                result[operation] = Object.fromEntries(query.aggregates[operation].map((field) => [field, aggregate(rows.map((row) => at(row, [field])), operation)]));
+            }
+        }
+        return result;
+    }
+    groupBy(dataset, query) {
+        const groups = new Map();
+        for (const row of this.filtered(dataset, query.relation, query.predicate)) {
+            const keyVariants = query.by.map((key) => this.groupValues(dataset, query.relation, row, key));
+            for (const keys of cartesian(keyVariants)) {
+                const identity = JSON.stringify(keys.map(keyIdentity));
+                const group = groups.get(identity) ?? { keys, rows: [] };
+                group.rows.push(row);
+                groups.set(identity, group);
+            }
+        }
+        return [...groups.values()].map(({ keys, rows }) => {
+            const result = Object.fromEntries(query.by.map((key, index) => [groupName(key), clone(keys[index])]));
+            if (query.aggregates.count) {
+                result.count = rows.length;
+            }
+            for (const operation of ["min", "max", "sum"]) {
+                for (const field of query.aggregates[operation]) {
+                    result[`${operation}_${field}`] = aggregate(rows.map((row) => at(row, [field])), operation);
+                }
+            }
+            return result;
+        });
+    }
+    groupValues(dataset, relation, row, key) {
+        if (key.kind === "field") {
+            const value = at(row, key.path);
+            return Array.isArray(value) ? value : [value];
+        }
+        else if (key.kind === "json") {
+            return [project(at(row, [key.field, ...key.path]), key.as)];
+        }
+        else if (key.kind !== "bucket") {
+            return [];
+        }
+        const value = key.path.length === 1 ? at(row, key.path) : this.related(dataset, relation, row, key.path[0])[0] && at(this.related(dataset, relation, row, key.path[0])[0], [key.path[1]]);
+        return [bucket(value, key.bucket)];
+    }
+}
+exports.InMemoryQueryEvaluator = InMemoryQueryEvaluator;
+function at(value, path) {
+    let current = value;
+    for (const key of path) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function clone(value) {
+    return (0, query_dataset_js_1.immutableQueryValue)(value);
+}
+function freeze(value) {
+    if (value === null || typeof value !== "object" || value instanceof Date || value instanceof Uint8Array) {
+        return value;
+    }
+    else if (Object.isFrozen(value)) {
+        return value;
+    }
+    for (const child of Object.values(value)) {
+        freeze(child);
+    }
+    return Object.freeze(value);
+}
+function equal(left, right) {
+    if (left instanceof Date) {
+        return left.toISOString() === (right instanceof Date ? right.toISOString() : String(right));
+    }
+    else if (right instanceof Date) {
+        return String(left) === right.toISOString();
+    }
+    else if (left instanceof Uint8Array || right instanceof Uint8Array) {
+        return JSON.stringify(Array.from(left)) === JSON.stringify(Array.from(right));
+    }
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function compare(left, right) {
+    if (left === null || left === undefined || right === null || right === undefined) {
+        return Number.NaN;
+    }
+    else if (left instanceof Date || right instanceof Date) {
+        const leftTime = left instanceof Date ? left.getTime() : new Date(String(left)).getTime();
+        const rightTime = right instanceof Date ? right.getTime() : new Date(String(right)).getTime();
+        return !Number.isFinite(leftTime) || !Number.isFinite(rightTime) ? Number.NaN : leftTime < rightTime ? -1 : leftTime > rightTime ? 1 : 0;
+    }
+    const leftValue = numeric(left) ?? String(left);
+    const rightValue = numeric(right) ?? String(right);
+    return leftValue < rightValue ? -1 : leftValue > rightValue ? 1 : 0;
+}
+function numeric(value) {
+    return typeof value === "string" && /^-?\d+$/.test(value) ? BigInt(value) : typeof value === "number" && Number.isFinite(value) ? BigInt(value) : undefined;
+}
+function postgresCompare(left, right, direction) {
+    const leftNull = left === null || left === undefined;
+    const rightNull = right === null || right === undefined;
+    if (leftNull || rightNull) {
+        if (leftNull && rightNull) {
+            return 0;
+        }
+        return leftNull ? (direction === "asc" ? 1 : -1) : (direction === "asc" ? -1 : 1);
+    }
+    const result = compare(left, right);
+    return direction === "asc" ? result : -result;
+}
+function sqlLike(value, pattern, insensitive) {
+    let expression = "^";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === "\\" && index + 1 < pattern.length) {
+            expression += escapeRegex(pattern[++index]);
+        }
+        else if (character === "%") {
+            expression += ".*";
+        }
+        else if (character === "_") {
+            expression += ".";
+        }
+        else {
+            expression += escapeRegex(character);
+        }
+    }
+    return new RegExp(`${expression}$`, insensitive ? "isu" : "su").test(value);
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function project(value, as) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    else if (as === "boolean") {
+        return value === true || value === "true";
+    }
+    else if (as === "timestamp") {
+        return (0, query_dataset_js_1.immutableQueryValue)(value instanceof Date ? value : new Date(String(value)));
+    }
+    return String(value);
+}
+function aggregate(values, operation) {
+    const present = values.filter((value) => value !== null && value !== undefined);
+    if (present.length === 0) {
+        return null;
+    }
+    const numbers = present.map((value) => BigInt(String(value)));
+    if (operation === "sum") {
+        return numbers.reduce((total, value) => total + value, 0n).toString();
+    }
+    return numbers.reduce((winner, value) => operation === "min" ? value < winner ? value : winner : value > winner ? value : winner).toString();
+}
+function cartesian(parts) {
+    return parts.reduce((all, part) => all.flatMap((prefix) => part.map((value) => [...prefix, value])), [[]]);
+}
+function keyIdentity(value) {
+    return value instanceof Date ? value.toISOString() : value;
+}
+function groupName(key) {
+    return key.kind === "field" ? key.path.join("_") : key.kind === "json" ? key.name : key.path.join("_") + "_" + key.bucket;
+}
+function bucket(value, unit) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    const date = value instanceof Date ? new Date(value.getTime()) : new Date(String(value));
+    if (Number.isNaN(date.getTime())) {
+        return null;
+    }
+    else if (unit === "hour") {
+        date.setUTCMinutes(0, 0, 0);
+    }
+    else if (unit === "day") {
+        date.setUTCHours(0, 0, 0, 0);
+    }
+    else if (unit === "month") {
+        date.setUTCDate(1);
+        date.setUTCHours(0, 0, 0, 0);
+    }
+    else {
+        const day = date.getUTCDay() || 7;
+        date.setUTCDate(date.getUTCDate() - day + 1);
+        date.setUTCHours(0, 0, 0, 0);
+    }
+    return date;
+}