@guckdev/core 0.1.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.
Files changed (62) hide show
  1. package/dist/config.d.ts +19 -0
  2. package/dist/config.d.ts.map +1 -0
  3. package/dist/config.js +178 -0
  4. package/dist/config.js.map +1 -0
  5. package/dist/index.d.ts +7 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/dist/index.js +7 -0
  8. package/dist/index.js.map +1 -0
  9. package/dist/redact.d.ts +3 -0
  10. package/dist/redact.d.ts.map +1 -0
  11. package/dist/redact.js +68 -0
  12. package/dist/redact.js.map +1 -0
  13. package/dist/schema.d.ts +113 -0
  14. package/dist/schema.d.ts.map +1 -0
  15. package/dist/schema.js +2 -0
  16. package/dist/schema.js.map +1 -0
  17. package/dist/store/backends/cloudwatch.d.ts +4 -0
  18. package/dist/store/backends/cloudwatch.d.ts.map +1 -0
  19. package/dist/store/backends/cloudwatch.js +302 -0
  20. package/dist/store/backends/cloudwatch.js.map +1 -0
  21. package/dist/store/backends/k8s.d.ts +4 -0
  22. package/dist/store/backends/k8s.d.ts.map +1 -0
  23. package/dist/store/backends/k8s.js +307 -0
  24. package/dist/store/backends/k8s.js.map +1 -0
  25. package/dist/store/backends/local.d.ts +10 -0
  26. package/dist/store/backends/local.d.ts.map +1 -0
  27. package/dist/store/backends/local.js +31 -0
  28. package/dist/store/backends/local.js.map +1 -0
  29. package/dist/store/backends/types.d.ts +25 -0
  30. package/dist/store/backends/types.d.ts.map +1 -0
  31. package/dist/store/backends/types.js +2 -0
  32. package/dist/store/backends/types.js.map +1 -0
  33. package/dist/store/file-store.d.ts +21 -0
  34. package/dist/store/file-store.d.ts.map +1 -0
  35. package/dist/store/file-store.js +169 -0
  36. package/dist/store/file-store.js.map +1 -0
  37. package/dist/store/filters.d.ts +4 -0
  38. package/dist/store/filters.d.ts.map +1 -0
  39. package/dist/store/filters.js +73 -0
  40. package/dist/store/filters.js.map +1 -0
  41. package/dist/store/read-store.d.ts +35 -0
  42. package/dist/store/read-store.d.ts.map +1 -0
  43. package/dist/store/read-store.js +256 -0
  44. package/dist/store/read-store.js.map +1 -0
  45. package/dist/store/time.d.ts +4 -0
  46. package/dist/store/time.d.ts.map +1 -0
  47. package/dist/store/time.js +47 -0
  48. package/dist/store/time.js.map +1 -0
  49. package/package.json +38 -0
  50. package/src/config.ts +210 -0
  51. package/src/index.ts +6 -0
  52. package/src/redact.ts +83 -0
  53. package/src/schema.ts +130 -0
  54. package/src/store/backends/cloudwatch.ts +373 -0
  55. package/src/store/backends/k8s.ts +400 -0
  56. package/src/store/backends/local.ts +47 -0
  57. package/src/store/backends/types.ts +18 -0
  58. package/src/store/file-store.ts +217 -0
  59. package/src/store/filters.ts +83 -0
  60. package/src/store/read-store.ts +340 -0
  61. package/src/store/time.ts +54 -0
  62. package/tsconfig.json +19 -0
@@ -0,0 +1,19 @@
1
+ import { GuckConfig } from "./schema.js";
2
+ export type LoadedConfig = {
3
+ rootDir: string;
4
+ configPath?: string;
5
+ localConfigPath?: string;
6
+ config: GuckConfig;
7
+ };
8
+ export declare const findRepoRoot: (startDir: string) => string;
9
+ type LoadConfigOptions = {
10
+ cwd?: string;
11
+ configPath?: string;
12
+ };
13
+ export declare const loadConfig: (options?: LoadConfigOptions) => LoadedConfig;
14
+ export declare const resolveStoreDir: (config: GuckConfig, rootDir: string) => string;
15
+ export declare const resolveCheckpointPath: (storeDir: string) => string;
16
+ export declare const readCheckpoint: (storeDir: string) => number | undefined;
17
+ export declare const getDefaultConfig: () => GuckConfig;
18
+ export {};
19
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0BzC,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AA4BF,eAAO,MAAM,YAAY,aAAc,MAAM,KAAG,MAY/C,CAAC;AA+CF,KAAK,iBAAiB,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,UAAU,aAAa,iBAAiB,KAAQ,YAmD5D,CAAC;AAEF,eAAO,MAAM,eAAe,WAAY,UAAU,WAAW,MAAM,KAAG,MAKrE,CAAC;AAEF,eAAO,MAAM,qBAAqB,aAAc,MAAM,KAAG,MAExD,CAAC;AAEF,eAAO,MAAM,cAAc,aAAc,MAAM,KAAG,MAAM,GAAG,SAkB1D,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,UAA4B,CAAC"}
package/dist/config.js ADDED
@@ -0,0 +1,178 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ const DEFAULT_CONFIG = {
4
+ version: 1,
5
+ enabled: true,
6
+ store_dir: "logs/guck",
7
+ default_service: "guck",
8
+ sdk: {
9
+ enabled: true,
10
+ capture_stdout: true,
11
+ capture_stderr: true,
12
+ },
13
+ read: {
14
+ backend: "local",
15
+ },
16
+ redaction: {
17
+ enabled: true,
18
+ keys: ["authorization", "api_key", "token", "secret", "password"],
19
+ patterns: ["sk-[A-Za-z0-9]{20,}", "Bearer\\s+[A-Za-z0-9._-]+"],
20
+ },
21
+ mcp: {
22
+ max_results: 200,
23
+ default_lookback_ms: 300000,
24
+ },
25
+ };
26
+ const readJsonFile = (filePath) => {
27
+ try {
28
+ const raw = fs.readFileSync(filePath, "utf8");
29
+ return JSON.parse(raw);
30
+ }
31
+ catch {
32
+ return null;
33
+ }
34
+ };
35
+ const isDirectory = (filePath) => {
36
+ try {
37
+ return fs.statSync(filePath).isDirectory();
38
+ }
39
+ catch {
40
+ return false;
41
+ }
42
+ };
43
+ const isDirOrFile = (filePath) => {
44
+ try {
45
+ fs.accessSync(filePath);
46
+ return true;
47
+ }
48
+ catch {
49
+ return false;
50
+ }
51
+ };
52
+ export const findRepoRoot = (startDir) => {
53
+ let current = path.resolve(startDir);
54
+ while (true) {
55
+ if (isDirOrFile(path.join(current, ".git"))) {
56
+ return current;
57
+ }
58
+ const parent = path.dirname(current);
59
+ if (parent === current) {
60
+ return startDir;
61
+ }
62
+ current = parent;
63
+ }
64
+ };
65
+ const mergeSdkConfig = (base, override) => {
66
+ return {
67
+ ...base,
68
+ ...(override ?? {}),
69
+ };
70
+ };
71
+ const mergeConfig = (base, override) => {
72
+ return {
73
+ ...base,
74
+ ...override,
75
+ sdk: mergeSdkConfig(base.sdk, override.sdk),
76
+ read: {
77
+ ...(base.read ?? { backend: "local" }),
78
+ ...(override.read ?? {}),
79
+ backends: override.read?.backends ?? base.read?.backends,
80
+ },
81
+ redaction: {
82
+ ...base.redaction,
83
+ ...(override.redaction ?? {}),
84
+ },
85
+ mcp: {
86
+ ...base.mcp,
87
+ ...(override.mcp ?? {}),
88
+ },
89
+ };
90
+ };
91
+ const parseBool = (value) => {
92
+ if (value === undefined) {
93
+ return undefined;
94
+ }
95
+ const normalized = value.trim().toLowerCase();
96
+ if (normalized === "true") {
97
+ return true;
98
+ }
99
+ if (normalized === "false") {
100
+ return false;
101
+ }
102
+ return undefined;
103
+ };
104
+ export const loadConfig = (options = {}) => {
105
+ const cwd = options.cwd ??
106
+ process.env.GUCK_CWD ??
107
+ process.env.INIT_CWD ??
108
+ process.cwd();
109
+ const explicitConfig = options.configPath ?? process.env.GUCK_CONFIG ?? process.env.GUCK_CONFIG_PATH;
110
+ let rootDir = findRepoRoot(cwd);
111
+ let configPath = path.join(rootDir, ".guck.json");
112
+ if (explicitConfig) {
113
+ const resolvedConfig = path.isAbsolute(explicitConfig)
114
+ ? explicitConfig
115
+ : path.resolve(cwd, explicitConfig);
116
+ if (isDirectory(resolvedConfig)) {
117
+ rootDir = resolvedConfig;
118
+ configPath = path.join(rootDir, ".guck.json");
119
+ }
120
+ else {
121
+ rootDir = path.dirname(resolvedConfig);
122
+ configPath = resolvedConfig;
123
+ }
124
+ }
125
+ const configExists = isDirOrFile(configPath);
126
+ const configJson = configExists ? readJsonFile(configPath) : null;
127
+ let config = DEFAULT_CONFIG;
128
+ if (configJson && typeof configJson === "object") {
129
+ config = mergeConfig(config, configJson);
130
+ }
131
+ const envEnabled = parseBool(process.env.GUCK_ENABLED);
132
+ if (envEnabled !== undefined) {
133
+ config = { ...config, enabled: envEnabled };
134
+ }
135
+ if (process.env.GUCK_DIR) {
136
+ config = { ...config, store_dir: process.env.GUCK_DIR };
137
+ }
138
+ if (process.env.GUCK_SERVICE) {
139
+ config = { ...config, default_service: process.env.GUCK_SERVICE };
140
+ }
141
+ return {
142
+ rootDir,
143
+ configPath: configExists ? configPath : undefined,
144
+ localConfigPath: undefined,
145
+ config,
146
+ };
147
+ };
148
+ export const resolveStoreDir = (config, rootDir) => {
149
+ if (path.isAbsolute(config.store_dir)) {
150
+ return config.store_dir;
151
+ }
152
+ return path.join(rootDir, config.store_dir);
153
+ };
154
+ export const resolveCheckpointPath = (storeDir) => {
155
+ return path.join(storeDir, ".guck-checkpoint");
156
+ };
157
+ export const readCheckpoint = (storeDir) => {
158
+ const checkpointPath = resolveCheckpointPath(storeDir);
159
+ if (!isDirOrFile(checkpointPath)) {
160
+ return undefined;
161
+ }
162
+ try {
163
+ const raw = fs.readFileSync(checkpointPath, "utf8").trim();
164
+ if (!raw) {
165
+ return undefined;
166
+ }
167
+ const parsed = Number(raw);
168
+ if (Number.isNaN(parsed)) {
169
+ return undefined;
170
+ }
171
+ return parsed;
172
+ }
173
+ catch {
174
+ return undefined;
175
+ }
176
+ };
177
+ export const getDefaultConfig = () => DEFAULT_CONFIG;
178
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export * from "./config.js";
2
+ export * from "./redact.js";
3
+ export * from "./schema.js";
4
+ export * from "./store/file-store.js";
5
+ export * from "./store/read-store.js";
6
+ export * from "./store/time.js";
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,7 @@
1
+ export * from "./config.js";
2
+ export * from "./redact.js";
3
+ export * from "./schema.js";
4
+ export * from "./store/file-store.js";
5
+ export * from "./store/read-store.js";
6
+ export * from "./store/time.js";
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { GuckConfig, GuckEvent } from "./schema.js";
2
+ export declare const redactEvent: (config: GuckConfig, event: GuckEvent) => GuckEvent;
3
+ //# sourceMappingURL=redact.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgEpD,eAAO,MAAM,WAAW,WAAY,UAAU,SAAS,SAAS,KAAG,SAkBlE,CAAC"}
package/dist/redact.js ADDED
@@ -0,0 +1,68 @@
1
+ const REDACTED_VALUE = "[REDACTED]";
2
+ const normalizeKeySet = (keys) => {
3
+ return new Set(keys.map((key) => key.trim().toLowerCase()).filter(Boolean));
4
+ };
5
+ const compilePatterns = (patterns) => {
6
+ return patterns
7
+ .map((pattern) => {
8
+ try {
9
+ return new RegExp(pattern, "gi");
10
+ }
11
+ catch {
12
+ return null;
13
+ }
14
+ })
15
+ .filter((pattern) => Boolean(pattern));
16
+ };
17
+ const redactString = (value, patterns) => {
18
+ let next = value;
19
+ for (const pattern of patterns) {
20
+ next = next.replace(pattern, REDACTED_VALUE);
21
+ }
22
+ return next;
23
+ };
24
+ const redactValue = (value, keySet, patterns) => {
25
+ if (value === null || value === undefined) {
26
+ return value;
27
+ }
28
+ if (typeof value === "string") {
29
+ return redactString(value, patterns);
30
+ }
31
+ if (typeof value === "number" || typeof value === "boolean") {
32
+ return value;
33
+ }
34
+ if (Array.isArray(value)) {
35
+ return value.map((entry) => redactValue(entry, keySet, patterns));
36
+ }
37
+ if (typeof value === "object") {
38
+ const next = {};
39
+ for (const [key, entry] of Object.entries(value)) {
40
+ if (keySet.has(key.toLowerCase())) {
41
+ next[key] = REDACTED_VALUE;
42
+ }
43
+ else {
44
+ next[key] = redactValue(entry, keySet, patterns);
45
+ }
46
+ }
47
+ return next;
48
+ }
49
+ return value;
50
+ };
51
+ export const redactEvent = (config, event) => {
52
+ if (!config.redaction.enabled) {
53
+ return event;
54
+ }
55
+ const keySet = normalizeKeySet(config.redaction.keys);
56
+ const patterns = compilePatterns(config.redaction.patterns);
57
+ return {
58
+ ...event,
59
+ message: event.message ? redactString(event.message, patterns) : event.message,
60
+ data: event.data
61
+ ? redactValue(event.data, keySet, patterns)
62
+ : event.data,
63
+ tags: event.tags
64
+ ? redactValue(event.tags, keySet, patterns)
65
+ : event.tags,
66
+ };
67
+ };
68
+ //# sourceMappingURL=redact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC,MAAM,eAAe,GAAG,CAAC,IAAc,EAAe,EAAE;IACtD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,QAAkB,EAAY,EAAE;IACvD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,IAAI,CAAC;YACH,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,QAAkB,EAAU,EAAE;IACjE,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAClB,KAAc,EACd,MAAmB,EACnB,QAAkB,EACT,EAAE;IACX,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,KAAgB,EAAa,EAAE;IAC7E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE5D,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;QAC9E,IAAI,EAAE,KAAK,CAAC,IAAI;YACd,CAAC,CAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAA6B;YACxE,CAAC,CAAC,KAAK,CAAC,IAAI;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;YACd,CAAC,CAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAA4B;YACvE,CAAC,CAAC,KAAK,CAAC,IAAI;KACf,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,113 @@
1
+ export type GuckLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
2
+ export type GuckSourceKind = "sdk" | "stdout" | "stderr" | "mcp";
3
+ export type GuckSource = {
4
+ kind: GuckSourceKind;
5
+ file?: string;
6
+ line?: number;
7
+ backend?: string;
8
+ backend_id?: string;
9
+ };
10
+ export type GuckSdkConfig = {
11
+ enabled: boolean;
12
+ capture_stdout: boolean;
13
+ capture_stderr: boolean;
14
+ };
15
+ export type GuckEvent = {
16
+ id: string;
17
+ ts: string;
18
+ level: GuckLevel;
19
+ type: string;
20
+ service: string;
21
+ run_id: string;
22
+ session_id?: string;
23
+ message?: string;
24
+ data?: Record<string, unknown>;
25
+ tags?: Record<string, string>;
26
+ trace_id?: string;
27
+ span_id?: string;
28
+ source?: GuckSource;
29
+ };
30
+ export type GuckConfig = {
31
+ version: 1;
32
+ enabled: boolean;
33
+ store_dir: string;
34
+ default_service: string;
35
+ sdk: GuckSdkConfig;
36
+ read?: GuckReadConfig;
37
+ redaction: {
38
+ enabled: boolean;
39
+ keys: string[];
40
+ patterns: string[];
41
+ };
42
+ mcp: {
43
+ max_results: number;
44
+ default_lookback_ms: number;
45
+ };
46
+ };
47
+ export type GuckReadBackendType = "local" | "cloudwatch" | "k8s";
48
+ export type GuckLocalReadBackendConfig = {
49
+ type: "local";
50
+ id?: string;
51
+ dir?: string;
52
+ };
53
+ export type GuckCloudWatchReadBackendConfig = {
54
+ type: "cloudwatch";
55
+ id?: string;
56
+ logGroup: string;
57
+ region: string;
58
+ profile?: string;
59
+ service?: string;
60
+ };
61
+ export type GuckK8sReadBackendConfig = {
62
+ type: "k8s";
63
+ id?: string;
64
+ namespace: string;
65
+ selector: string;
66
+ context?: string;
67
+ container?: string;
68
+ service?: string;
69
+ };
70
+ export type GuckReadBackendConfig = GuckLocalReadBackendConfig | GuckCloudWatchReadBackendConfig | GuckK8sReadBackendConfig;
71
+ export type GuckReadConfig = {
72
+ backend: "local" | "multi";
73
+ backends?: GuckReadBackendConfig[];
74
+ };
75
+ export type GuckSearchParams = {
76
+ service?: string;
77
+ session_id?: string;
78
+ run_id?: string;
79
+ types?: string[];
80
+ levels?: GuckLevel[];
81
+ contains?: string;
82
+ since?: string;
83
+ until?: string;
84
+ limit?: number;
85
+ backends?: string[];
86
+ config_path?: string;
87
+ };
88
+ export type GuckStatsParams = {
89
+ service?: string;
90
+ session_id?: string;
91
+ since?: string;
92
+ until?: string;
93
+ group_by: "type" | "level" | "stage";
94
+ limit?: number;
95
+ backends?: string[];
96
+ config_path?: string;
97
+ };
98
+ export type GuckSessionsParams = {
99
+ service?: string;
100
+ since?: string;
101
+ limit?: number;
102
+ backends?: string[];
103
+ config_path?: string;
104
+ };
105
+ export type GuckTailParams = {
106
+ service?: string;
107
+ session_id?: string;
108
+ run_id?: string;
109
+ limit?: number;
110
+ backends?: string[];
111
+ config_path?: string;
112
+ };
113
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,aAAa,CAAC;IACnB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,GAAG,EAAE;QACH,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,YAAY,GAAG,KAAK,CAAC;AAEjE,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,0BAA0B,GAC1B,+BAA+B,GAC/B,wBAAwB,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
package/dist/schema.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import { GuckCloudWatchReadBackendConfig } from "../../schema.js";
2
+ import { ReadBackend } from "./types.js";
3
+ export declare const createCloudWatchBackend: (config: GuckCloudWatchReadBackendConfig) => ReadBackend;
4
+ //# sourceMappingURL=cloudwatch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloudwatch.d.ts","sourceRoot":"","sources":["../../../src/store/backends/cloudwatch.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,+BAA+B,EAKhC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAA6C,MAAM,YAAY,CAAC;AAqNpF,eAAO,MAAM,uBAAuB,WAC1B,+BAA+B,KACtC,WAkJF,CAAC"}