@temporalio/core-bridge 1.13.0 → 1.13.2
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.
- package/Cargo.lock +239 -382
- package/Cargo.toml +11 -11
- package/lib/native.d.ts +10 -3
- package/package.json +3 -3
- package/releases/aarch64-apple-darwin/index.node +0 -0
- package/releases/aarch64-unknown-linux-gnu/index.node +0 -0
- package/releases/x86_64-apple-darwin/index.node +0 -0
- package/releases/x86_64-pc-windows-msvc/index.node +0 -0
- package/releases/x86_64-unknown-linux-gnu/index.node +0 -0
- package/sdk-core/.cargo/config.toml +71 -11
- package/sdk-core/.clippy.toml +1 -0
- package/sdk-core/.github/workflows/heavy.yml +2 -0
- package/sdk-core/.github/workflows/per-pr.yml +50 -18
- package/sdk-core/ARCHITECTURE.md +44 -48
- package/sdk-core/Cargo.toml +26 -7
- package/sdk-core/README.md +4 -0
- package/sdk-core/arch_docs/diagrams/TimerMachine_Coverage.puml +14 -0
- package/sdk-core/arch_docs/diagrams/initial_event_history.png +0 -0
- package/sdk-core/arch_docs/sdks_intro.md +299 -0
- package/sdk-core/client/Cargo.toml +8 -7
- package/sdk-core/client/src/callback_based.rs +1 -2
- package/sdk-core/client/src/lib.rs +485 -299
- package/sdk-core/client/src/metrics.rs +32 -8
- package/sdk-core/client/src/proxy.rs +124 -5
- package/sdk-core/client/src/raw.rs +598 -307
- package/sdk-core/client/src/replaceable.rs +253 -0
- package/sdk-core/client/src/retry.rs +9 -6
- package/sdk-core/client/src/worker_registry/mod.rs +19 -3
- package/sdk-core/client/src/workflow_handle/mod.rs +20 -17
- package/sdk-core/core/Cargo.toml +100 -31
- package/sdk-core/core/src/core_tests/activity_tasks.rs +55 -225
- package/sdk-core/core/src/core_tests/mod.rs +2 -8
- package/sdk-core/core/src/core_tests/queries.rs +3 -5
- package/sdk-core/core/src/core_tests/replay_flag.rs +3 -62
- package/sdk-core/core/src/core_tests/updates.rs +4 -5
- package/sdk-core/core/src/core_tests/workers.rs +4 -3
- package/sdk-core/core/src/core_tests/workflow_cancels.rs +10 -7
- package/sdk-core/core/src/core_tests/workflow_tasks.rs +28 -291
- package/sdk-core/core/src/ephemeral_server/mod.rs +15 -3
- package/sdk-core/core/src/internal_flags.rs +11 -1
- package/sdk-core/core/src/lib.rs +50 -36
- package/sdk-core/core/src/pollers/mod.rs +5 -5
- package/sdk-core/core/src/pollers/poll_buffer.rs +2 -2
- package/sdk-core/core/src/protosext/mod.rs +13 -5
- package/sdk-core/core/src/protosext/protocol_messages.rs +4 -11
- package/sdk-core/core/src/retry_logic.rs +256 -108
- package/sdk-core/core/src/telemetry/metrics.rs +1 -0
- package/sdk-core/core/src/telemetry/mod.rs +8 -2
- package/sdk-core/core/src/telemetry/prometheus_meter.rs +2 -2
- package/sdk-core/core/src/test_help/integ_helpers.rs +971 -0
- package/sdk-core/core/src/test_help/mod.rs +10 -1100
- package/sdk-core/core/src/test_help/unit_helpers.rs +218 -0
- package/sdk-core/core/src/worker/activities/activity_heartbeat_manager.rs +42 -6
- package/sdk-core/core/src/worker/activities/local_activities.rs +19 -19
- package/sdk-core/core/src/worker/activities.rs +10 -3
- package/sdk-core/core/src/worker/client/mocks.rs +3 -3
- package/sdk-core/core/src/worker/client.rs +130 -93
- package/sdk-core/core/src/worker/heartbeat.rs +12 -13
- package/sdk-core/core/src/worker/mod.rs +31 -21
- package/sdk-core/core/src/worker/nexus.rs +14 -3
- package/sdk-core/core/src/worker/slot_provider.rs +9 -0
- package/sdk-core/core/src/worker/tuner.rs +159 -0
- package/sdk-core/core/src/worker/workflow/history_update.rs +3 -265
- package/sdk-core/core/src/worker/workflow/machines/activity_state_machine.rs +1 -54
- package/sdk-core/core/src/worker/workflow/machines/cancel_external_state_machine.rs +0 -82
- package/sdk-core/core/src/worker/workflow/machines/cancel_workflow_state_machine.rs +0 -67
- package/sdk-core/core/src/worker/workflow/machines/child_workflow_state_machine.rs +1 -192
- package/sdk-core/core/src/worker/workflow/machines/continue_as_new_workflow_state_machine.rs +0 -43
- package/sdk-core/core/src/worker/workflow/machines/local_activity_state_machine.rs +6 -554
- package/sdk-core/core/src/worker/workflow/machines/modify_workflow_properties_state_machine.rs +0 -71
- package/sdk-core/core/src/worker/workflow/machines/nexus_operation_state_machine.rs +102 -3
- package/sdk-core/core/src/worker/workflow/machines/patch_state_machine.rs +10 -539
- package/sdk-core/core/src/worker/workflow/machines/signal_external_state_machine.rs +0 -139
- package/sdk-core/core/src/worker/workflow/machines/timer_state_machine.rs +1 -119
- package/sdk-core/core/src/worker/workflow/machines/upsert_search_attributes_state_machine.rs +6 -63
- package/sdk-core/core/src/worker/workflow/machines/workflow_machines.rs +9 -4
- package/sdk-core/core/src/worker/workflow/mod.rs +5 -1
- package/sdk-core/core/src/worker/workflow/workflow_stream.rs +8 -3
- package/sdk-core/core-api/Cargo.toml +4 -4
- package/sdk-core/core-api/src/envconfig.rs +153 -54
- package/sdk-core/core-api/src/lib.rs +68 -0
- package/sdk-core/core-api/src/telemetry/metrics.rs +2 -1
- package/sdk-core/core-api/src/telemetry.rs +13 -0
- package/sdk-core/core-c-bridge/Cargo.toml +13 -8
- package/sdk-core/core-c-bridge/include/temporal-sdk-core-c-bridge.h +184 -22
- package/sdk-core/core-c-bridge/src/client.rs +462 -184
- package/sdk-core/core-c-bridge/src/envconfig.rs +314 -0
- package/sdk-core/core-c-bridge/src/lib.rs +1 -0
- package/sdk-core/core-c-bridge/src/random.rs +4 -4
- package/sdk-core/core-c-bridge/src/runtime.rs +22 -23
- package/sdk-core/core-c-bridge/src/testing.rs +1 -4
- package/sdk-core/core-c-bridge/src/tests/context.rs +31 -31
- package/sdk-core/core-c-bridge/src/tests/mod.rs +32 -28
- package/sdk-core/core-c-bridge/src/tests/utils.rs +7 -7
- package/sdk-core/core-c-bridge/src/worker.rs +319 -66
- package/sdk-core/fsm/rustfsm_procmacro/src/lib.rs +6 -1
- package/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/dupe_transitions_fail.stderr +5 -5
- package/sdk-core/sdk/Cargo.toml +8 -2
- package/sdk-core/sdk/src/activity_context.rs +1 -1
- package/sdk-core/sdk/src/app_data.rs +1 -1
- package/sdk-core/sdk/src/interceptors.rs +1 -4
- package/sdk-core/sdk/src/lib.rs +1 -5
- package/sdk-core/sdk/src/workflow_context/options.rs +10 -1
- package/sdk-core/sdk/src/workflow_future.rs +1 -1
- package/sdk-core/sdk-core-protos/Cargo.toml +6 -6
- package/sdk-core/sdk-core-protos/build.rs +10 -23
- package/sdk-core/sdk-core-protos/protos/api_upstream/.github/workflows/create-release.yml +9 -1
- package/sdk-core/sdk-core-protos/protos/api_upstream/openapi/openapiv2.json +254 -5
- package/sdk-core/sdk-core-protos/protos/api_upstream/openapi/openapiv3.yaml +234 -5
- package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/common/v1/message.proto +1 -1
- package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/deployment/v1/message.proto +6 -0
- package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/namespace/v1/message.proto +6 -2
- package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/workflowservice/v1/request_response.proto +60 -2
- package/sdk-core/sdk-core-protos/protos/api_upstream/temporal/api/workflowservice/v1/service.proto +30 -6
- package/sdk-core/sdk-core-protos/protos/local/temporal/sdk/core/workflow_activation/workflow_activation.proto +2 -0
- package/sdk-core/{test-utils → sdk-core-protos}/src/canned_histories.rs +5 -5
- package/sdk-core/sdk-core-protos/src/history_builder.rs +2 -2
- package/sdk-core/sdk-core-protos/src/lib.rs +25 -9
- package/sdk-core/sdk-core-protos/src/test_utils.rs +89 -0
- package/sdk-core/sdk-core-protos/src/utilities.rs +14 -5
- package/sdk-core/tests/c_bridge_smoke_test.c +10 -0
- package/sdk-core/tests/cloud_tests.rs +10 -8
- package/sdk-core/tests/common/http_proxy.rs +134 -0
- package/sdk-core/{test-utils/src/lib.rs → tests/common/mod.rs} +214 -281
- package/sdk-core/{test-utils/src → tests/common}/workflows.rs +4 -3
- package/sdk-core/tests/fuzzy_workflow.rs +1 -1
- package/sdk-core/tests/global_metric_tests.rs +8 -7
- package/sdk-core/tests/heavy_tests.rs +7 -3
- package/sdk-core/tests/integ_tests/client_tests.rs +111 -24
- package/sdk-core/tests/integ_tests/ephemeral_server_tests.rs +14 -9
- package/sdk-core/tests/integ_tests/heartbeat_tests.rs +4 -4
- package/sdk-core/tests/integ_tests/metrics_tests.rs +114 -14
- package/sdk-core/tests/integ_tests/pagination_tests.rs +273 -0
- package/sdk-core/tests/integ_tests/polling_tests.rs +311 -93
- package/sdk-core/tests/integ_tests/queries_tests.rs +4 -4
- package/sdk-core/tests/integ_tests/update_tests.rs +13 -7
- package/sdk-core/tests/integ_tests/visibility_tests.rs +26 -9
- package/sdk-core/tests/integ_tests/worker_tests.rs +668 -13
- package/sdk-core/tests/integ_tests/worker_versioning_tests.rs +40 -24
- package/sdk-core/tests/integ_tests/workflow_tests/activities.rs +244 -11
- package/sdk-core/tests/integ_tests/workflow_tests/appdata_propagation.rs +1 -1
- package/sdk-core/tests/integ_tests/workflow_tests/cancel_external.rs +78 -2
- package/sdk-core/tests/integ_tests/workflow_tests/cancel_wf.rs +61 -2
- package/sdk-core/tests/integ_tests/workflow_tests/child_workflows.rs +465 -7
- package/sdk-core/tests/integ_tests/workflow_tests/continue_as_new.rs +41 -2
- package/sdk-core/tests/integ_tests/workflow_tests/determinism.rs +315 -3
- package/sdk-core/tests/integ_tests/workflow_tests/eager.rs +1 -1
- package/sdk-core/tests/integ_tests/workflow_tests/local_activities.rs +1990 -14
- package/sdk-core/tests/integ_tests/workflow_tests/modify_wf_properties.rs +65 -2
- package/sdk-core/tests/integ_tests/workflow_tests/nexus.rs +123 -23
- package/sdk-core/tests/integ_tests/workflow_tests/patches.rs +525 -3
- package/sdk-core/tests/integ_tests/workflow_tests/replay.rs +65 -16
- package/sdk-core/tests/integ_tests/workflow_tests/resets.rs +32 -23
- package/sdk-core/tests/integ_tests/workflow_tests/signals.rs +126 -5
- package/sdk-core/tests/integ_tests/workflow_tests/stickyness.rs +1 -2
- package/sdk-core/tests/integ_tests/workflow_tests/timers.rs +124 -8
- package/sdk-core/tests/integ_tests/workflow_tests/upsert_search_attrs.rs +62 -2
- package/sdk-core/tests/integ_tests/workflow_tests.rs +67 -8
- package/sdk-core/tests/main.rs +26 -17
- package/sdk-core/tests/manual_tests.rs +5 -1
- package/sdk-core/tests/runner.rs +22 -40
- package/sdk-core/tests/shared_tests/mod.rs +1 -1
- package/sdk-core/tests/shared_tests/priority.rs +1 -1
- package/sdk-core/{core/benches/workflow_replay.rs → tests/workflow_replay_bench.rs} +10 -5
- package/src/client.rs +97 -20
- package/src/helpers/callbacks.rs +4 -4
- package/src/helpers/errors.rs +7 -1
- package/src/helpers/handles.rs +1 -0
- package/src/helpers/try_from_js.rs +4 -3
- package/src/lib.rs +3 -2
- package/src/metrics.rs +3 -0
- package/src/runtime.rs +5 -2
- package/src/worker.rs +9 -12
- package/ts/native.ts +13 -3
- package/sdk-core/arch_docs/diagrams/workflow_internals.svg +0 -1
- package/sdk-core/core/src/core_tests/child_workflows.rs +0 -281
- package/sdk-core/core/src/core_tests/determinism.rs +0 -318
- package/sdk-core/core/src/core_tests/local_activities.rs +0 -1442
- package/sdk-core/test-utils/Cargo.toml +0 -38
- package/sdk-core/test-utils/src/histfetch.rs +0 -28
- package/sdk-core/test-utils/src/interceptors.rs +0 -46
|
@@ -21,6 +21,8 @@ use temporal_sdk_core_protos::{
|
|
|
21
21
|
enums::v1::{CommandType, EventType},
|
|
22
22
|
failure::v1::{self as failure, Failure, failure::FailureInfo},
|
|
23
23
|
history::v1::{
|
|
24
|
+
NexusOperationCancelRequestCompletedEventAttributes,
|
|
25
|
+
NexusOperationCancelRequestFailedEventAttributes,
|
|
24
26
|
NexusOperationCanceledEventAttributes, NexusOperationCompletedEventAttributes,
|
|
25
27
|
NexusOperationFailedEventAttributes, NexusOperationStartedEventAttributes,
|
|
26
28
|
NexusOperationTimedOutEventAttributes, history_event,
|
|
@@ -63,6 +65,12 @@ fsm! {
|
|
|
63
65
|
--(NexusOperationFailed(NexusOperationFailedEventAttributes), on_failed)--> Failed;
|
|
64
66
|
Started
|
|
65
67
|
--(NexusOperationCanceled(NexusOperationCanceledEventAttributes), on_canceled)--> Cancelled;
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
Started --(NexusOperationCancelRequestCompleted(NexusOperationCancelRequestCompletedEventAttributes), shared on_cancel_request_completed)--> Started;
|
|
71
|
+
Started --(NexusOperationCancelRequestCompleted(NexusOperationCancelRequestCompletedEventAttributes), shared on_cancel_request_completed)--> Cancelled;
|
|
72
|
+
Started --(NexusOperationCancelRequestFailed(NexusOperationCancelRequestFailedEventAttributes), shared on_cancel_request_failed)--> Started;
|
|
73
|
+
|
|
66
74
|
Started
|
|
67
75
|
--(NexusOperationTimedOut(NexusOperationTimedOutEventAttributes), on_timed_out)--> TimedOut;
|
|
68
76
|
|
|
@@ -72,12 +80,20 @@ fsm! {
|
|
|
72
80
|
Cancelled --(NexusOperationCompleted(NexusOperationCompletedEventAttributes), shared on_completed)--> Cancelled;
|
|
73
81
|
Cancelled --(NexusOperationFailed(NexusOperationFailedEventAttributes), shared on_failed)--> Cancelled;
|
|
74
82
|
Cancelled --(NexusOperationTimedOut(NexusOperationTimedOutEventAttributes), shared on_timed_out)--> Cancelled;
|
|
83
|
+
Cancelled --(NexusOperationCancelRequestCompleted(NexusOperationCancelRequestCompletedEventAttributes), on_cancel_request_completed)--> Cancelled;
|
|
84
|
+
Cancelled --(NexusOperationCancelRequestFailed(NexusOperationCancelRequestFailedEventAttributes))--> Cancelled;
|
|
75
85
|
Cancelled --(NexusOperationCanceled(NexusOperationCanceledEventAttributes))--> Cancelled;
|
|
76
86
|
|
|
77
87
|
// Ignore cancels in all terminal states
|
|
78
88
|
Completed --(Cancel)--> Completed;
|
|
79
89
|
Failed --(Cancel)--> Failed;
|
|
80
90
|
TimedOut --(Cancel)--> TimedOut;
|
|
91
|
+
Completed --(NexusOperationCancelRequestCompleted(NexusOperationCancelRequestCompletedEventAttributes))--> Completed;
|
|
92
|
+
Failed --(NexusOperationCancelRequestCompleted(NexusOperationCancelRequestCompletedEventAttributes))--> Failed;
|
|
93
|
+
TimedOut --(NexusOperationCancelRequestCompleted(NexusOperationCancelRequestCompletedEventAttributes))--> TimedOut;
|
|
94
|
+
Completed --(NexusOperationCancelRequestFailed(NexusOperationCancelRequestFailedEventAttributes))--> Completed;
|
|
95
|
+
Failed --(NexusOperationCancelRequestFailed(NexusOperationCancelRequestFailedEventAttributes))--> Failed;
|
|
96
|
+
TimedOut --(NexusOperationCancelRequestFailed(NexusOperationCancelRequestFailedEventAttributes))--> TimedOut;
|
|
81
97
|
}
|
|
82
98
|
|
|
83
99
|
#[derive(Debug, derive_more::Display)]
|
|
@@ -311,6 +327,45 @@ impl Started {
|
|
|
311
327
|
)])
|
|
312
328
|
}
|
|
313
329
|
|
|
330
|
+
pub(super) fn on_cancel_request_completed(
|
|
331
|
+
self,
|
|
332
|
+
ss: &mut SharedState,
|
|
333
|
+
_: NexusOperationCancelRequestCompletedEventAttributes,
|
|
334
|
+
) -> NexusOperationMachineTransition<StartedOrCancelled> {
|
|
335
|
+
if ss.cancel_type == NexusOperationCancellationType::WaitCancellationRequested {
|
|
336
|
+
TransitionResult::ok(
|
|
337
|
+
[NexusOperationCommand::Cancel(ss.cancelled_failure(
|
|
338
|
+
"Nexus operation cancellation request completed".to_owned(),
|
|
339
|
+
))],
|
|
340
|
+
StartedOrCancelled::Cancelled(Default::default()),
|
|
341
|
+
)
|
|
342
|
+
} else {
|
|
343
|
+
TransitionResult::ok([], StartedOrCancelled::Started(Default::default()))
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
pub(super) fn on_cancel_request_failed(
|
|
348
|
+
self,
|
|
349
|
+
ss: &mut SharedState,
|
|
350
|
+
fa: NexusOperationCancelRequestFailedEventAttributes,
|
|
351
|
+
) -> NexusOperationMachineTransition<Started> {
|
|
352
|
+
if ss.cancel_type == NexusOperationCancellationType::WaitCancellationRequested {
|
|
353
|
+
let message = "Nexus operation cancellation request failed".to_string();
|
|
354
|
+
TransitionResult::ok(
|
|
355
|
+
[NexusOperationCommand::Fail(ss.failure(
|
|
356
|
+
message.clone(),
|
|
357
|
+
fa.failure.unwrap_or_else(|| Failure {
|
|
358
|
+
message,
|
|
359
|
+
..Default::default()
|
|
360
|
+
}),
|
|
361
|
+
))],
|
|
362
|
+
self,
|
|
363
|
+
)
|
|
364
|
+
} else {
|
|
365
|
+
TransitionResult::ok([], self)
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
|
|
314
369
|
pub(super) fn on_timed_out(
|
|
315
370
|
self,
|
|
316
371
|
toa: NexusOperationTimedOutEventAttributes,
|
|
@@ -356,6 +411,13 @@ impl Cancelled {
|
|
|
356
411
|
NexusOperationMachineTransition::ok([], self)
|
|
357
412
|
}
|
|
358
413
|
|
|
414
|
+
pub(super) fn on_cancel_request_completed(
|
|
415
|
+
self,
|
|
416
|
+
_: NexusOperationCancelRequestCompletedEventAttributes,
|
|
417
|
+
) -> NexusOperationMachineTransition<Cancelled> {
|
|
418
|
+
NexusOperationMachineTransition::ok([], self)
|
|
419
|
+
}
|
|
420
|
+
|
|
359
421
|
pub(super) fn on_failed(
|
|
360
422
|
self,
|
|
361
423
|
ss: &mut SharedState,
|
|
@@ -454,6 +516,36 @@ impl TryFrom<HistEventData> for NexusOperationMachineEvents {
|
|
|
454
516
|
}
|
|
455
517
|
}
|
|
456
518
|
Ok(EventType::NexusOperationCancelRequested) => Self::NexusOperationCancelRequested,
|
|
519
|
+
Ok(EventType::NexusOperationCancelRequestCompleted) => {
|
|
520
|
+
if let Some(
|
|
521
|
+
history_event::Attributes::NexusOperationCancelRequestCompletedEventAttributes(
|
|
522
|
+
attrs,
|
|
523
|
+
),
|
|
524
|
+
) = e.attributes
|
|
525
|
+
{
|
|
526
|
+
Self::NexusOperationCancelRequestCompleted(attrs)
|
|
527
|
+
} else {
|
|
528
|
+
return Err(WFMachinesError::Nondeterminism(
|
|
529
|
+
"NexusOperationCancelRequestCompleted attributes were unset or malformed"
|
|
530
|
+
.to_string(),
|
|
531
|
+
));
|
|
532
|
+
}
|
|
533
|
+
}
|
|
534
|
+
Ok(EventType::NexusOperationCancelRequestFailed) => {
|
|
535
|
+
if let Some(
|
|
536
|
+
history_event::Attributes::NexusOperationCancelRequestFailedEventAttributes(
|
|
537
|
+
attrs,
|
|
538
|
+
),
|
|
539
|
+
) = e.attributes
|
|
540
|
+
{
|
|
541
|
+
Self::NexusOperationCancelRequestFailed(attrs)
|
|
542
|
+
} else {
|
|
543
|
+
return Err(WFMachinesError::Nondeterminism(
|
|
544
|
+
"NexusOperationCancelRequestFailed attributes were unset or malformed"
|
|
545
|
+
.to_string(),
|
|
546
|
+
));
|
|
547
|
+
}
|
|
548
|
+
}
|
|
457
549
|
_ => {
|
|
458
550
|
return Err(WFMachinesError::Nondeterminism(format!(
|
|
459
551
|
"Nexus operation machine does not handle this event: {e:?}"
|
|
@@ -599,12 +691,19 @@ impl TryFrom<CommandType> for NexusOperationMachineEvents {
|
|
|
599
691
|
|
|
600
692
|
impl SharedState {
|
|
601
693
|
fn cancelled_failure(&self, message: String) -> Failure {
|
|
602
|
-
|
|
694
|
+
self.failure(
|
|
603
695
|
message,
|
|
604
|
-
|
|
696
|
+
Failure {
|
|
605
697
|
failure_info: Some(FailureInfo::CanceledFailureInfo(Default::default())),
|
|
606
698
|
..Default::default()
|
|
607
|
-
}
|
|
699
|
+
},
|
|
700
|
+
)
|
|
701
|
+
}
|
|
702
|
+
|
|
703
|
+
fn failure(&self, message: String, cause: Failure) -> Failure {
|
|
704
|
+
Failure {
|
|
705
|
+
message,
|
|
706
|
+
cause: Some(Box::new(cause)),
|
|
608
707
|
failure_info: Some(FailureInfo::NexusOperationExecutionFailureInfo(
|
|
609
708
|
failure::NexusOperationFailureInfo {
|
|
610
709
|
scheduled_event_id: self.scheduled_event_id,
|