sttp-core-rs 0.1.5

Core STTP parsing, validation, storage contracts, and application services for Rust
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
pub const INIT_SCHEMA_QUERY: &str = r#"
            DEFINE TABLE IF NOT EXISTS temporal_node SCHEMAFULL;
            DEFINE FIELD IF NOT EXISTS tenant_id         ON temporal_node TYPE string;
            DEFINE FIELD IF NOT EXISTS session_id        ON temporal_node TYPE string;
            DEFINE FIELD IF NOT EXISTS raw               ON temporal_node TYPE string;
            DEFINE FIELD IF NOT EXISTS tier              ON temporal_node TYPE string;
            DEFINE FIELD IF NOT EXISTS timestamp         ON temporal_node TYPE datetime;
            DEFINE FIELD IF NOT EXISTS compression_depth ON temporal_node TYPE int;
            DEFINE FIELD IF NOT EXISTS parent_node_id    ON temporal_node TYPE option<string>;
            DEFINE FIELD IF NOT EXISTS sync_key          ON temporal_node TYPE string;
            DEFINE FIELD IF NOT EXISTS updated_at        ON temporal_node TYPE datetime;
            DEFINE FIELD IF NOT EXISTS source_metadata   ON temporal_node TYPE option<object>;
            DEFINE FIELD IF NOT EXISTS psi               ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS rho               ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS kappa             ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS user_stability    ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS user_friction     ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS user_logic        ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS user_autonomy     ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS user_psi          ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS model_stability   ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS model_friction    ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS model_logic       ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS model_autonomy    ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS model_psi         ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS comp_stability    ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS comp_friction     ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS comp_logic        ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS comp_autonomy     ON temporal_node TYPE float;
            DEFINE FIELD IF NOT EXISTS comp_psi          ON temporal_node TYPE float;

            DEFINE TABLE IF NOT EXISTS calibration SCHEMAFULL;
            DEFINE FIELD IF NOT EXISTS tenant_id   ON calibration TYPE string;
            DEFINE FIELD IF NOT EXISTS session_id  ON calibration TYPE string;
            DEFINE FIELD IF NOT EXISTS stability   ON calibration TYPE float;
            DEFINE FIELD IF NOT EXISTS friction    ON calibration TYPE float;
            DEFINE FIELD IF NOT EXISTS logic       ON calibration TYPE float;
            DEFINE FIELD IF NOT EXISTS autonomy    ON calibration TYPE float;
            DEFINE FIELD IF NOT EXISTS psi         ON calibration TYPE float;
            DEFINE FIELD IF NOT EXISTS trigger     ON calibration TYPE string;
            DEFINE FIELD IF NOT EXISTS created_at  ON calibration TYPE datetime;

            DEFINE TABLE IF NOT EXISTS sync_checkpoint SCHEMAFULL;
            DEFINE FIELD IF NOT EXISTS tenant_id          ON sync_checkpoint TYPE string;
            DEFINE FIELD IF NOT EXISTS session_id         ON sync_checkpoint TYPE string;
            DEFINE FIELD IF NOT EXISTS connector_id       ON sync_checkpoint TYPE string;
            DEFINE FIELD IF NOT EXISTS cursor_updated_at  ON sync_checkpoint TYPE option<datetime>;
            DEFINE FIELD IF NOT EXISTS cursor_sync_key    ON sync_checkpoint TYPE option<string>;
            DEFINE FIELD IF NOT EXISTS metadata           ON sync_checkpoint TYPE option<object>;
            DEFINE FIELD IF NOT EXISTS updated_at         ON sync_checkpoint TYPE datetime;

            DEFINE INDEX IF NOT EXISTS idx_node_session ON temporal_node FIELDS session_id;
            DEFINE INDEX IF NOT EXISTS idx_node_tenant_session ON temporal_node FIELDS tenant_id, session_id;
            DEFINE INDEX IF NOT EXISTS idx_node_change_cursor ON temporal_node FIELDS tenant_id, session_id, updated_at, sync_key;
            DEFINE INDEX IF NOT EXISTS idx_node_sync_identity ON temporal_node FIELDS tenant_id, session_id, sync_key UNIQUE;
            DEFINE INDEX IF NOT EXISTS idx_cal_session ON calibration FIELDS session_id;
            DEFINE INDEX IF NOT EXISTS idx_cal_tenant_session ON calibration FIELDS tenant_id, session_id;
            DEFINE INDEX IF NOT EXISTS idx_checkpoint_scope ON sync_checkpoint FIELDS tenant_id, session_id, connector_id UNIQUE;
            SELECT * FROM calibration LIMIT 0;
            "#;

pub fn query_nodes_query(where_clause: &str, capped_limit: usize) -> String {
    format!(
        r#"
            SELECT
                tenant_id AS TenantId,
                session_id AS SessionId,
                raw AS Raw,
                tier AS Tier,
                timestamp AS Timestamp,
                compression_depth AS CompressionDepth,
                parent_node_id AS ParentNodeId,
                sync_key AS SyncKey,
                updated_at AS UpdatedAt,
                source_metadata AS SourceMetadata,
                psi AS Psi,
                rho AS Rho,
                kappa AS Kappa,
                user_stability AS UserStability,
                user_friction AS UserFriction,
                user_logic AS UserLogic,
                user_autonomy AS UserAutonomy,
                user_psi AS UserPsi,
                model_stability AS ModelStability,
                model_friction AS ModelFriction,
                model_logic AS ModelLogic,
                model_autonomy AS ModelAutonomy,
                model_psi AS ModelPsi,
                comp_stability AS CompStability,
                comp_friction AS CompFriction,
                comp_logic AS CompLogic,
                comp_autonomy AS CompAutonomy,
                comp_psi AS CompPsi,
                0 AS ResonanceDelta
            FROM temporal_node
            {where_clause}
            ORDER BY Timestamp DESC
            LIMIT {capped_limit};
            "#
    )
}

pub fn create_temporal_node_query(
    record_id: &str,
    include_parent_assignment: bool,
    include_source_metadata_assignment: bool,
) -> String {
    let parent_assignment = if include_parent_assignment {
        "\n                parent_node_id = $parent_node_id,"
    } else {
        ""
    };

    let source_metadata_assignment = if include_source_metadata_assignment {
        "\n                source_metadata = $source_metadata,"
    } else {
        ""
    };

    format!(
        r#"
            CREATE temporal_node:`{record_id}` SET
                tenant_id = $tenant_id,
                session_id = $session_id,
                raw = $raw,
                tier = $tier,
                timestamp = <datetime>$timestamp,
                compression_depth = $compression_depth,{parent_assignment}
                sync_key = $sync_key,
                updated_at = <datetime>$updated_at,{source_metadata_assignment}
                psi = $psi,
                rho = $rho,
                kappa = $kappa,
                user_stability = $user_stability,
                user_friction = $user_friction,
                user_logic = $user_logic,
                user_autonomy = $user_autonomy,
                user_psi = $user_psi,
                model_stability = $model_stability,
                model_friction = $model_friction,
                model_logic = $model_logic,
                model_autonomy = $model_autonomy,
                model_psi = $model_psi,
                comp_stability = $comp_stability,
                comp_friction = $comp_friction,
                comp_logic = $comp_logic,
                comp_autonomy = $comp_autonomy,
                comp_psi = $comp_psi;
            "#
    )
}

pub fn get_by_resonance_query(current_psi: f32, limit: usize) -> String {
    let psi = format!("{current_psi:.4}");
    format!(
        r#"
            SELECT
                tenant_id AS TenantId,
                session_id AS SessionId,
                raw AS Raw,
                tier AS Tier,
                timestamp AS Timestamp,
                compression_depth AS CompressionDepth,
                parent_node_id AS ParentNodeId,
                sync_key AS SyncKey,
                updated_at AS UpdatedAt,
                source_metadata AS SourceMetadata,
                psi AS Psi,
                rho AS Rho,
                kappa AS Kappa,
                user_stability AS UserStability,
                user_friction AS UserFriction,
                user_logic AS UserLogic,
                user_autonomy AS UserAutonomy,
                user_psi AS UserPsi,
                model_stability AS ModelStability,
                model_friction AS ModelFriction,
                model_logic AS ModelLogic,
                model_autonomy AS ModelAutonomy,
                model_psi AS ModelPsi,
                comp_stability AS CompStability,
                comp_friction AS CompFriction,
                comp_logic AS CompLogic,
                comp_autonomy AS CompAutonomy,
                comp_psi AS CompPsi,
                math::abs(psi - {psi}) AS ResonanceDelta
            FROM temporal_node
                        WHERE session_id = $session_id
                            AND (tenant_id = $tenant_id OR tenant_id = NONE OR tenant_id = '')
            ORDER BY ResonanceDelta ASC
            LIMIT {limit};
            "#
    )
}

pub const GET_LAST_AVEC_QUERY: &str = r#"
            SELECT stability, friction, logic, autonomy, psi, created_at
            FROM calibration
                        WHERE session_id = $session_id
                            AND (tenant_id = $tenant_id OR tenant_id = NONE OR tenant_id = '')
            ORDER BY created_at DESC
            LIMIT 1;
            "#;

pub const GET_TRIGGER_HISTORY_QUERY: &str = r#"
            SELECT trigger, created_at FROM calibration
                        WHERE session_id = $session_id
                            AND (tenant_id = $tenant_id OR tenant_id = NONE OR tenant_id = '')
            ORDER BY created_at ASC;
            "#;

pub const STORE_CALIBRATION_QUERY: &str = r#"
            CREATE calibration SET
                tenant_id = $tenant_id,
                session_id = $session_id,
                stability = $stability,
                friction = $friction,
                logic = $logic,
                autonomy = $autonomy,
                psi = $psi,
                trigger = $trigger,
                created_at = <datetime>$created_at;
            "#;

pub const SELECT_TEMPORAL_NODE_LEGACY_SYNC_QUERY: &str = r#"
            SELECT id, session_id, timestamp, sync_key, updated_at
            FROM temporal_node
            WHERE tenant_id = NONE OR tenant_id = '' OR sync_key = NONE OR sync_key = '' OR updated_at = NONE;
            "#;

pub fn update_temporal_node_legacy_sync_query(record_id: &str) -> String {
    format!(
        r#"
            UPDATE temporal_node:`{record_id}` SET
                tenant_id = $tenant_id,
                sync_key = $sync_key,
                updated_at = <datetime>$updated_at;
            "#
    )
}

pub const FIND_EXISTING_NODE_BY_SYNC_KEY_QUERY: &str = r#"
            SELECT
                id AS Id,
                source_metadata AS SourceMetadata
            FROM temporal_node
            WHERE session_id = $session_id
                AND sync_key = $sync_key
                AND (tenant_id = $tenant_id OR tenant_id = NONE OR tenant_id = '')
            LIMIT 1;
            "#;

pub fn update_temporal_node_sync_metadata_query(record_id: &str, clear_source_metadata: bool) -> String {
    let source_metadata_assignment = if clear_source_metadata {
        "source_metadata = NONE,"
    } else {
        "source_metadata = $source_metadata,"
    };

    format!(
        r#"
            UPDATE temporal_node:`{record_id}` SET
                {source_metadata_assignment}
                updated_at = <datetime>$updated_at;
            "#
    )
}

pub fn query_changes_since_query(limit: usize) -> String {
    format!(
        r#"
            SELECT
                tenant_id AS TenantId,
                session_id AS SessionId,
                raw AS Raw,
                tier AS Tier,
                timestamp AS Timestamp,
                compression_depth AS CompressionDepth,
                parent_node_id AS ParentNodeId,
                sync_key AS SyncKey,
                updated_at AS UpdatedAt,
                source_metadata AS SourceMetadata,
                psi AS Psi,
                rho AS Rho,
                kappa AS Kappa,
                user_stability AS UserStability,
                user_friction AS UserFriction,
                user_logic AS UserLogic,
                user_autonomy AS UserAutonomy,
                user_psi AS UserPsi,
                model_stability AS ModelStability,
                model_friction AS ModelFriction,
                model_logic AS ModelLogic,
                model_autonomy AS ModelAutonomy,
                model_psi AS ModelPsi,
                comp_stability AS CompStability,
                comp_friction AS CompFriction,
                comp_logic AS CompLogic,
                comp_autonomy AS CompAutonomy,
                comp_psi AS CompPsi,
                0 AS ResonanceDelta
            FROM temporal_node
            WHERE session_id = $session_id
                AND (tenant_id = $tenant_id OR tenant_id = NONE OR tenant_id = '')
                AND (
                    NOT $include_cursor
                    OR updated_at > <datetime>$cursor_updated_at
                    OR (
                        updated_at = <datetime>$cursor_updated_at
                        AND sync_key > $cursor_sync_key
                    )
                )
            ORDER BY updated_at ASC, sync_key ASC
            LIMIT {limit};
            "#
    )
}

pub const GET_SYNC_CHECKPOINT_QUERY: &str = r#"
            SELECT
                session_id AS SessionId,
                connector_id AS ConnectorId,
                cursor_updated_at AS CursorUpdatedAt,
                cursor_sync_key AS CursorSyncKey,
                updated_at AS UpdatedAt,
                metadata AS Metadata
            FROM sync_checkpoint
            WHERE session_id = $session_id
                AND connector_id = $connector_id
                AND (tenant_id = $tenant_id OR tenant_id = NONE OR tenant_id = '')
            LIMIT 1;
            "#;

pub fn upsert_sync_checkpoint_query(record_id: &str, include_metadata_assignment: bool) -> String {
    let metadata_assignment = if include_metadata_assignment {
        "metadata = $metadata,"
    } else {
        "metadata = NONE,"
    };

    format!(
        r#"
            UPSERT sync_checkpoint:`{record_id}` SET
                tenant_id = $tenant_id,
                session_id = $session_id,
                connector_id = $connector_id,
                cursor_updated_at = <datetime>$cursor_updated_at,
                cursor_sync_key = $cursor_sync_key,
                {metadata_assignment}
                updated_at = <datetime>$updated_at;
            "#
    )
}

pub const SELECT_CALIBRATION_MISSING_TENANT_QUERY: &str = r#"
            SELECT id, session_id
            FROM calibration
            WHERE tenant_id = NONE OR tenant_id = '';
            "#;

pub const SELECT_SCOPE_BY_NODE_ID_QUERY: &str = r#"
                        SELECT
                                tenant_id AS TenantId,
                                session_id AS SessionId
                        FROM temporal_node
            WHERE id = type::record('temporal_node', $node_id)
                        LIMIT 1;
                        "#;

pub const COUNT_TEMPORAL_SCOPE_QUERY: &str = r#"
                        SELECT count() AS Count
                        FROM temporal_node
                        WHERE session_id = $session_id
                            AND (tenant_id = $tenant_id OR ($include_legacy AND (tenant_id = NONE OR tenant_id = '')))
                        LIMIT 1;
                        "#;

pub const COUNT_CALIBRATION_SCOPE_QUERY: &str = r#"
                        SELECT count() AS Count
                        FROM calibration
                        WHERE session_id = $session_id
                            AND (tenant_id = $tenant_id OR ($include_legacy AND (tenant_id = NONE OR tenant_id = '')))
                        LIMIT 1;
                        "#;

pub const APPLY_SCOPE_REKEY_QUERY: &str = r#"
                        BEGIN TRANSACTION;

                        UPDATE temporal_node
                        SET
                                tenant_id = $target_tenant_id,
                                session_id = $target_session_id
                        WHERE session_id = $source_session_id
                            AND (tenant_id = $source_tenant_id OR ($source_include_legacy AND (tenant_id = NONE OR tenant_id = '')));

                        UPDATE calibration
                        SET
                                tenant_id = $target_tenant_id,
                                session_id = $target_session_id
                        WHERE session_id = $source_session_id
                            AND (tenant_id = $source_tenant_id OR ($source_include_legacy AND (tenant_id = NONE OR tenant_id = '')));

                        COMMIT TRANSACTION;
                        "#;

pub fn update_record_tenant_query(record_id: &str) -> String {
    format!(
        r#"
            UPDATE {record_id}
            SET tenant_id = $tenant_id;
            "#
    )
}