@indigoai-us/hq-cloud 6.16.75-alpha.1 → 6.16.76-alpha.0
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/dist/bin/sync-runner-watch-loop.d.ts +0 -45
- package/dist/bin/sync-runner-watch-loop.d.ts.map +1 -1
- package/dist/bin/sync-runner-watch-loop.js +29 -129
- package/dist/bin/sync-runner-watch-loop.js.map +1 -1
- package/dist/bin/sync-runner.d.ts +2 -0
- package/dist/bin/sync-runner.d.ts.map +1 -1
- package/dist/bin/sync-runner.js.map +1 -1
- package/dist/bin/sync-runner.test.js +134 -431
- package/dist/bin/sync-runner.test.js.map +1 -1
- package/dist/sync/full-pass-interval.d.ts +25 -0
- package/dist/sync/full-pass-interval.d.ts.map +1 -0
- package/dist/sync/full-pass-interval.js +53 -0
- package/dist/sync/full-pass-interval.js.map +1 -0
- package/dist/sync/full-pass-interval.test.d.ts +2 -0
- package/dist/sync/full-pass-interval.test.d.ts.map +1 -0
- package/dist/sync/full-pass-interval.test.js +21 -0
- package/dist/sync/full-pass-interval.test.js.map +1 -0
- package/package.json +1 -1
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { FlagSnapshot } from "@indigoai-us/hq-flags-client";
|
|
2
|
+
/** HQ-flags key controlling only the steady-state full-reconcile cadence. */
|
|
3
|
+
export declare const FULL_PASS_INTERVAL_FLAG = "sync.full-pass.interval-ms";
|
|
4
|
+
/**
|
|
5
|
+
* Realtime has the normal delivery path; this is the bounded recovery sweep.
|
|
6
|
+
* Correctness triggers (startup, watcher overflow, route gaps) bypass it.
|
|
7
|
+
*/
|
|
8
|
+
export declare const DEFAULT_FULL_PASS_INTERVAL_MS: number;
|
|
9
|
+
export type FullPassIntervalSource = {
|
|
10
|
+
read(): number;
|
|
11
|
+
refresh?(): Promise<number>;
|
|
12
|
+
};
|
|
13
|
+
/** Resolve the configured hq-flags value, preserving the shipped default on failure. */
|
|
14
|
+
export declare function intervalFromSnapshot(snapshot: FlagSnapshot | null): number;
|
|
15
|
+
/**
|
|
16
|
+
* Snapshot-backed cadence source. The endpoint only identifies the existing
|
|
17
|
+
* registry; it never controls the interval itself. A missing or unreadable row
|
|
18
|
+
* therefore retains the compiled recovery cadence.
|
|
19
|
+
*/
|
|
20
|
+
export declare function createHqFlagsIntervalSource(options: {
|
|
21
|
+
endpoint?: string;
|
|
22
|
+
getToken?: () => string | Promise<string>;
|
|
23
|
+
fetch?: typeof fetch;
|
|
24
|
+
}): FullPassIntervalSource;
|
|
25
|
+
//# sourceMappingURL=full-pass-interval.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"full-pass-interval.d.ts","sourceRoot":"","sources":["../../src/sync/full-pass-interval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,QAAkB,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,IAAI,MAAM,CAAC;IACf,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAUF,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,GAAG,sBAAsB,CA0BzB"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/** HQ-flags key controlling only the steady-state full-reconcile cadence. */
|
|
2
|
+
export const FULL_PASS_INTERVAL_FLAG = "sync.full-pass.interval-ms";
|
|
3
|
+
/**
|
|
4
|
+
* Realtime has the normal delivery path; this is the bounded recovery sweep.
|
|
5
|
+
* Correctness triggers (startup, watcher overflow, route gaps) bypass it.
|
|
6
|
+
*/
|
|
7
|
+
export const DEFAULT_FULL_PASS_INTERVAL_MS = 6 * 60 * 60_000;
|
|
8
|
+
function positiveInteger(value) {
|
|
9
|
+
if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
|
|
10
|
+
return undefined;
|
|
11
|
+
}
|
|
12
|
+
const intervalMs = Math.trunc(value);
|
|
13
|
+
return intervalMs > 0 ? intervalMs : undefined;
|
|
14
|
+
}
|
|
15
|
+
/** Resolve the configured hq-flags value, preserving the shipped default on failure. */
|
|
16
|
+
export function intervalFromSnapshot(snapshot) {
|
|
17
|
+
const flags = snapshot?.flags;
|
|
18
|
+
return positiveInteger(flags?.[FULL_PASS_INTERVAL_FLAG]) ?? DEFAULT_FULL_PASS_INTERVAL_MS;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Snapshot-backed cadence source. The endpoint only identifies the existing
|
|
22
|
+
* registry; it never controls the interval itself. A missing or unreadable row
|
|
23
|
+
* therefore retains the compiled recovery cadence.
|
|
24
|
+
*/
|
|
25
|
+
export function createHqFlagsIntervalSource(options) {
|
|
26
|
+
const endpoint = (options.endpoint ?? "").trim();
|
|
27
|
+
let current = DEFAULT_FULL_PASS_INTERVAL_MS;
|
|
28
|
+
return {
|
|
29
|
+
read: () => current,
|
|
30
|
+
async refresh() {
|
|
31
|
+
if (!endpoint || !options.getToken)
|
|
32
|
+
return current;
|
|
33
|
+
try {
|
|
34
|
+
const { createFlagClient } = await import("@indigoai-us/hq-flags-client");
|
|
35
|
+
const client = createFlagClient({
|
|
36
|
+
endpoint,
|
|
37
|
+
getToken: options.getToken,
|
|
38
|
+
fetch: options.fetch,
|
|
39
|
+
refreshIntervalMs: 0,
|
|
40
|
+
onError: () => undefined,
|
|
41
|
+
});
|
|
42
|
+
await client.ready();
|
|
43
|
+
current = intervalFromSnapshot(client.snapshot());
|
|
44
|
+
client.close();
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
current = DEFAULT_FULL_PASS_INTERVAL_MS;
|
|
48
|
+
}
|
|
49
|
+
return current;
|
|
50
|
+
},
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
//# sourceMappingURL=full-pass-interval.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"full-pass-interval.js","sourceRoot":"","sources":["../../src/sync/full-pass-interval.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAEpE;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;AAO7D,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,QAA6B;IAChE,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAsD,CAAC;IAC/E,OAAO,eAAe,CAAC,KAAK,EAAE,CAAC,uBAAuB,CAAC,CAAC,IAAI,6BAA6B,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAI3C;IACC,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,OAAO,GAAG,6BAA6B,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;QACnB,KAAK,CAAC,OAAO;YACX,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,OAAO,OAAO,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;gBAC1E,MAAM,MAAM,GAAG,gBAAgB,CAAC;oBAC9B,QAAQ;oBACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,iBAAiB,EAAE,CAAC;oBACpB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;iBACzB,CAAC,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAClD,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,6BAA6B,CAAC;YAC1C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"full-pass-interval.test.d.ts","sourceRoot":"","sources":["../../src/sync/full-pass-interval.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { describe, expect, it } from "vitest";
|
|
2
|
+
import { DEFAULT_FULL_PASS_INTERVAL_MS, FULL_PASS_INTERVAL_FLAG, intervalFromSnapshot, } from "./full-pass-interval.js";
|
|
3
|
+
describe("full-pass interval flag", () => {
|
|
4
|
+
it("uses the six-hour shipped default when no configured flag is available", () => {
|
|
5
|
+
expect(DEFAULT_FULL_PASS_INTERVAL_MS).toBe(6 * 60 * 60_000);
|
|
6
|
+
expect(intervalFromSnapshot(null)).toBe(DEFAULT_FULL_PASS_INTERVAL_MS);
|
|
7
|
+
});
|
|
8
|
+
it("reads a positive millisecond interval from the hq-flags snapshot", () => {
|
|
9
|
+
const snapshot = {
|
|
10
|
+
flags: { [FULL_PASS_INTERVAL_FLAG]: 90 * 60_000 },
|
|
11
|
+
};
|
|
12
|
+
expect(intervalFromSnapshot(snapshot)).toBe(90 * 60_000);
|
|
13
|
+
});
|
|
14
|
+
it("fails closed to the shipped default for an invalid flag value", () => {
|
|
15
|
+
const snapshot = {
|
|
16
|
+
flags: { [FULL_PASS_INTERVAL_FLAG]: 0 },
|
|
17
|
+
};
|
|
18
|
+
expect(intervalFromSnapshot(snapshot)).toBe(DEFAULT_FULL_PASS_INTERVAL_MS);
|
|
19
|
+
});
|
|
20
|
+
});
|
|
21
|
+
//# sourceMappingURL=full-pass-interval.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"full-pass-interval.test.js","sourceRoot":"","sources":["../../src/sync/full-pass-interval.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,CAAC,6BAA6B,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QAC5D,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,QAAQ,GAAG;YACf,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE;SACvB,CAAC;QAE7B,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,QAAQ,GAAG;YACf,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC,EAAE;SACb,CAAC;QAE7B,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
package/package.json
CHANGED