atabey-shared 0.0.37 → 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 (221) hide show
  1. package/README.md +64 -25
  2. package/dist/agent-identity.d.ts +1 -0
  3. package/dist/agent-identity.js +2 -0
  4. package/dist/agent-identity.js.map +1 -0
  5. package/dist/api-catalog.d.ts +1 -0
  6. package/dist/api-catalog.js +2 -0
  7. package/dist/api-catalog.js.map +1 -0
  8. package/dist/audit-chain.d.ts +1 -51
  9. package/dist/audit-chain.js +1 -84
  10. package/dist/audit-chain.js.map +1 -1
  11. package/dist/audit.d.ts +1 -113
  12. package/dist/audit.js +1 -284
  13. package/dist/audit.js.map +1 -1
  14. package/dist/constants.d.ts +1 -152
  15. package/dist/constants.js +1 -215
  16. package/dist/constants.js.map +1 -1
  17. package/dist/database.d.ts +1 -5
  18. package/dist/database.js +1 -12
  19. package/dist/database.js.map +1 -1
  20. package/dist/errors.d.ts +1 -46
  21. package/dist/errors.js +1 -68
  22. package/dist/errors.js.map +1 -1
  23. package/dist/file-lock.d.ts +1 -88
  24. package/dist/file-lock.js +1 -250
  25. package/dist/file-lock.js.map +1 -1
  26. package/dist/fs.d.ts +1 -9
  27. package/dist/fs.js +1 -53
  28. package/dist/fs.js.map +1 -1
  29. package/dist/index.d.ts +2 -22
  30. package/dist/index.js +2 -22
  31. package/dist/index.js.map +1 -1
  32. package/dist/job-queue.d.ts +1 -53
  33. package/dist/job-queue.js +1 -126
  34. package/dist/job-queue.js.map +1 -1
  35. package/dist/lock.d.ts +1 -82
  36. package/dist/lock.js +1 -158
  37. package/dist/lock.js.map +1 -1
  38. package/dist/logger.d.ts +1 -30
  39. package/dist/logger.js +1 -126
  40. package/dist/logger.js.map +1 -1
  41. package/dist/memory-prune.d.ts +1 -0
  42. package/dist/memory-prune.js +2 -0
  43. package/dist/memory-prune.js.map +1 -0
  44. package/dist/migrations.d.ts +1 -0
  45. package/dist/migrations.js +2 -0
  46. package/dist/migrations.js.map +1 -0
  47. package/dist/modules/agent/agent-identity.d.ts +34 -0
  48. package/dist/modules/agent/agent-identity.js +77 -0
  49. package/dist/modules/agent/agent-identity.js.map +1 -0
  50. package/dist/modules/agent/api-catalog.d.ts +57 -0
  51. package/dist/modules/agent/api-catalog.js +254 -0
  52. package/dist/modules/agent/api-catalog.js.map +1 -0
  53. package/dist/modules/agent/index.d.ts +3 -0
  54. package/dist/modules/agent/index.js +4 -0
  55. package/dist/modules/agent/index.js.map +1 -0
  56. package/dist/modules/agent/tokenizer.d.ts +54 -0
  57. package/dist/modules/agent/tokenizer.js +272 -0
  58. package/dist/modules/agent/tokenizer.js.map +1 -0
  59. package/dist/modules/concurrency/file-lock.d.ts +93 -0
  60. package/dist/modules/concurrency/file-lock.js +240 -0
  61. package/dist/modules/concurrency/file-lock.js.map +1 -0
  62. package/dist/modules/concurrency/index.d.ts +6 -0
  63. package/dist/modules/concurrency/index.js +7 -0
  64. package/dist/modules/concurrency/index.js.map +1 -0
  65. package/dist/modules/concurrency/job-queue.d.ts +76 -0
  66. package/dist/modules/concurrency/job-queue.js +200 -0
  67. package/dist/modules/concurrency/job-queue.js.map +1 -0
  68. package/dist/modules/concurrency/lock.d.ts +82 -0
  69. package/dist/modules/concurrency/lock.js +159 -0
  70. package/dist/modules/concurrency/lock.js.map +1 -0
  71. package/dist/modules/concurrency/resilience.d.ts +84 -0
  72. package/dist/modules/concurrency/resilience.js +217 -0
  73. package/dist/modules/concurrency/resilience.js.map +1 -0
  74. package/dist/modules/concurrency/worker-pool.d.ts +52 -0
  75. package/dist/modules/concurrency/worker-pool.js +229 -0
  76. package/dist/modules/concurrency/worker-pool.js.map +1 -0
  77. package/dist/modules/concurrency/worker-thread.d.ts +21 -0
  78. package/dist/modules/concurrency/worker-thread.js +67 -0
  79. package/dist/modules/concurrency/worker-thread.js.map +1 -0
  80. package/dist/modules/index.d.ts +14 -0
  81. package/dist/modules/index.js +15 -0
  82. package/dist/modules/index.js.map +1 -0
  83. package/dist/modules/observability/audit-chain.d.ts +80 -0
  84. package/dist/modules/observability/audit-chain.js +262 -0
  85. package/dist/modules/observability/audit-chain.js.map +1 -0
  86. package/dist/modules/observability/audit.d.ts +121 -0
  87. package/dist/modules/observability/audit.js +322 -0
  88. package/dist/modules/observability/audit.js.map +1 -0
  89. package/dist/modules/observability/index.d.ts +4 -0
  90. package/dist/modules/observability/index.js +5 -0
  91. package/dist/modules/observability/index.js.map +1 -0
  92. package/dist/modules/observability/logger.d.ts +31 -0
  93. package/dist/modules/observability/logger.js +153 -0
  94. package/dist/modules/observability/logger.js.map +1 -0
  95. package/dist/modules/observability/otel.d.ts +39 -0
  96. package/dist/modules/observability/otel.js +93 -0
  97. package/dist/modules/observability/otel.js.map +1 -0
  98. package/dist/modules/primitives/constants.d.ts +150 -0
  99. package/dist/modules/primitives/constants.js +212 -0
  100. package/dist/modules/primitives/constants.js.map +1 -0
  101. package/dist/modules/primitives/errors.d.ts +46 -0
  102. package/dist/modules/primitives/errors.js +69 -0
  103. package/dist/modules/primitives/errors.js.map +1 -0
  104. package/dist/modules/primitives/fs.d.ts +9 -0
  105. package/dist/modules/primitives/fs.js +54 -0
  106. package/dist/modules/primitives/fs.js.map +1 -0
  107. package/dist/modules/primitives/index.d.ts +7 -0
  108. package/dist/modules/primitives/index.js +8 -0
  109. package/dist/modules/primitives/index.js.map +1 -0
  110. package/dist/modules/primitives/outbound-http.d.ts +32 -0
  111. package/dist/modules/primitives/outbound-http.js +88 -0
  112. package/dist/modules/primitives/outbound-http.js.map +1 -0
  113. package/dist/modules/primitives/string.d.ts +1 -0
  114. package/dist/modules/primitives/string.js +30 -0
  115. package/dist/modules/primitives/string.js.map +1 -0
  116. package/dist/modules/primitives/time.d.ts +5 -0
  117. package/dist/modules/primitives/time.js +35 -0
  118. package/dist/modules/primitives/time.js.map +1 -0
  119. package/dist/modules/primitives/types.d.ts +27 -0
  120. package/dist/modules/primitives/types.js +17 -0
  121. package/dist/modules/primitives/types.js.map +1 -0
  122. package/dist/modules/sandbox/index.d.ts +3 -0
  123. package/dist/modules/sandbox/index.js +4 -0
  124. package/dist/modules/sandbox/index.js.map +1 -0
  125. package/dist/modules/sandbox/sandbox-fs.d.ts +28 -0
  126. package/dist/modules/sandbox/sandbox-fs.js +143 -0
  127. package/dist/modules/sandbox/sandbox-fs.js.map +1 -0
  128. package/dist/modules/sandbox/sandbox-runtime.d.ts +78 -0
  129. package/dist/modules/sandbox/sandbox-runtime.js +282 -0
  130. package/dist/modules/sandbox/sandbox-runtime.js.map +1 -0
  131. package/dist/modules/sandbox/sandbox.d.ts +54 -0
  132. package/dist/modules/sandbox/sandbox.js +179 -0
  133. package/dist/modules/sandbox/sandbox.js.map +1 -0
  134. package/dist/modules/security/index.d.ts +5 -0
  135. package/dist/modules/security/index.js +6 -0
  136. package/dist/modules/security/index.js.map +1 -0
  137. package/dist/modules/security/pii.d.ts +70 -0
  138. package/dist/modules/security/pii.js +276 -0
  139. package/dist/modules/security/pii.js.map +1 -0
  140. package/dist/modules/security/policy-gate.d.ts +42 -0
  141. package/dist/modules/security/policy-gate.js +172 -0
  142. package/dist/modules/security/policy-gate.js.map +1 -0
  143. package/dist/modules/security/retention.d.ts +68 -0
  144. package/dist/modules/security/retention.js +218 -0
  145. package/dist/modules/security/retention.js.map +1 -0
  146. package/dist/modules/security/secrets.d.ts +99 -0
  147. package/dist/modules/security/secrets.js +371 -0
  148. package/dist/modules/security/secrets.js.map +1 -0
  149. package/dist/modules/security/tls.d.ts +87 -0
  150. package/dist/modules/security/tls.js +154 -0
  151. package/dist/modules/security/tls.js.map +1 -0
  152. package/dist/modules/storage/database.d.ts +6 -0
  153. package/dist/modules/storage/database.js +16 -0
  154. package/dist/modules/storage/database.js.map +1 -0
  155. package/dist/modules/storage/index.d.ts +4 -0
  156. package/dist/modules/storage/index.js +5 -0
  157. package/dist/modules/storage/index.js.map +1 -0
  158. package/dist/modules/storage/memory-prune.d.ts +18 -0
  159. package/dist/modules/storage/memory-prune.js +48 -0
  160. package/dist/modules/storage/memory-prune.js.map +1 -0
  161. package/dist/modules/storage/migrations.d.ts +69 -0
  162. package/dist/modules/storage/migrations.js +394 -0
  163. package/dist/modules/storage/migrations.js.map +1 -0
  164. package/dist/modules/storage/storage.d.ts +341 -0
  165. package/dist/modules/storage/storage.js +1004 -0
  166. package/dist/modules/storage/storage.js.map +1 -0
  167. package/dist/otel.d.ts +1 -0
  168. package/dist/otel.js +2 -0
  169. package/dist/otel.js.map +1 -0
  170. package/dist/outbound-http.d.ts +1 -0
  171. package/dist/outbound-http.js +2 -0
  172. package/dist/outbound-http.js.map +1 -0
  173. package/dist/pii.d.ts +1 -69
  174. package/dist/pii.js +1 -219
  175. package/dist/pii.js.map +1 -1
  176. package/dist/policy-gate.d.ts +1 -42
  177. package/dist/policy-gate.js +1 -147
  178. package/dist/policy-gate.js.map +1 -1
  179. package/dist/resilience.d.ts +1 -84
  180. package/dist/resilience.js +1 -216
  181. package/dist/resilience.js.map +1 -1
  182. package/dist/retention.d.ts +1 -63
  183. package/dist/retention.js +1 -170
  184. package/dist/retention.js.map +1 -1
  185. package/dist/sandbox-fs.d.ts +1 -28
  186. package/dist/sandbox-fs.js +1 -149
  187. package/dist/sandbox-fs.js.map +1 -1
  188. package/dist/sandbox-runtime.d.ts +1 -85
  189. package/dist/sandbox-runtime.js +1 -249
  190. package/dist/sandbox-runtime.js.map +1 -1
  191. package/dist/sandbox.d.ts +1 -54
  192. package/dist/sandbox.js +1 -178
  193. package/dist/sandbox.js.map +1 -1
  194. package/dist/secrets.d.ts +1 -0
  195. package/dist/secrets.js +2 -0
  196. package/dist/secrets.js.map +1 -0
  197. package/dist/storage.d.ts +1 -274
  198. package/dist/storage.js +1 -723
  199. package/dist/storage.js.map +1 -1
  200. package/dist/string.d.ts +1 -1
  201. package/dist/string.js +1 -29
  202. package/dist/string.js.map +1 -1
  203. package/dist/time.d.ts +1 -5
  204. package/dist/time.js +1 -30
  205. package/dist/time.js.map +1 -1
  206. package/dist/tls.d.ts +1 -0
  207. package/dist/tls.js +2 -0
  208. package/dist/tls.js.map +1 -0
  209. package/dist/tokenizer.d.ts +1 -0
  210. package/dist/tokenizer.js +2 -0
  211. package/dist/tokenizer.js.map +1 -0
  212. package/dist/types.d.ts +1 -27
  213. package/dist/types.js +1 -16
  214. package/dist/types.js.map +1 -1
  215. package/dist/worker-pool.d.ts +1 -52
  216. package/dist/worker-pool.js +1 -209
  217. package/dist/worker-pool.js.map +1 -1
  218. package/dist/worker-thread.d.ts +1 -21
  219. package/dist/worker-thread.js +1 -66
  220. package/dist/worker-thread.js.map +1 -1
  221. package/package.json +51 -29
@@ -1,53 +1 @@
1
- /**
2
- * In-Memory Job Queue — concurrency-limited async work dispatcher.
3
- *
4
- * Prevents unbounded parallel LLM / agent work from ballooning memory
5
- * or starving the main event loop. No Redis / BullMQ required.
6
- *
7
- * Jobs run on the calling process (async functions). Pair with WorkerPool
8
- * when true thread isolation is needed for CPU-bound work.
9
- */
10
- export interface JobQueueOptions {
11
- /** Max concurrent running jobs. Default: os.cpus().length (min 1, max 16). */
12
- maxConcurrency?: number;
13
- /** Optional name for diagnostics. */
14
- name?: string;
15
- /** Called when a job fails (after the promise rejects to the caller). */
16
- onError?: (error: unknown, jobId: number) => void;
17
- }
18
- export interface JobQueueStats {
19
- name: string;
20
- maxConcurrency: number;
21
- running: number;
22
- pending: number;
23
- completed: number;
24
- failed: number;
25
- }
26
- export declare class InMemoryJobQueue {
27
- private readonly maxConcurrency;
28
- private readonly name;
29
- private readonly onError?;
30
- private readonly pending;
31
- private running;
32
- private nextId;
33
- private completed;
34
- private failed;
35
- private closed;
36
- constructor(options?: JobQueueOptions);
37
- /**
38
- * Enqueue an async job. Resolves/rejects with the job result.
39
- * Back-pressures via wait in the queue — does not spawn unbounded work.
40
- */
41
- enqueue<T>(fn: () => Promise<T>): Promise<T>;
42
- /** Current queue diagnostics. */
43
- getStats(): JobQueueStats;
44
- /** Reject pending jobs and stop accepting new ones. In-flight jobs finish. */
45
- close(reason?: string): void;
46
- /** Wait until running + pending reach zero (or timeout). */
47
- drain(timeoutMs?: number): Promise<void>;
48
- private pump;
49
- private execute;
50
- }
51
- export declare function getAgentJobQueue(options?: JobQueueOptions): InMemoryJobQueue;
52
- /** Test helper — reset singleton. */
53
- export declare function resetAgentJobQueue(): void;
1
+ export * from "./modules/concurrency/job-queue.js";
package/dist/job-queue.js CHANGED
@@ -1,127 +1,2 @@
1
- /**
2
- * In-Memory Job Queue — concurrency-limited async work dispatcher.
3
- *
4
- * Prevents unbounded parallel LLM / agent work from ballooning memory
5
- * or starving the main event loop. No Redis / BullMQ required.
6
- *
7
- * Jobs run on the calling process (async functions). Pair with WorkerPool
8
- * when true thread isolation is needed for CPU-bound work.
9
- */
10
- import os from "os";
11
- export class InMemoryJobQueue {
12
- maxConcurrency;
13
- name;
14
- onError;
15
- pending = [];
16
- running = 0;
17
- nextId = 1;
18
- completed = 0;
19
- failed = 0;
20
- closed = false;
21
- constructor(options = {}) {
22
- const cpus = Math.max(1, os.cpus()?.length || 1);
23
- const requested = options.maxConcurrency ?? cpus;
24
- this.maxConcurrency = Math.max(1, Math.min(requested, 16));
25
- this.name = options.name ?? "default";
26
- this.onError = options.onError;
27
- }
28
- /**
29
- * Enqueue an async job. Resolves/rejects with the job result.
30
- * Back-pressures via wait in the queue — does not spawn unbounded work.
31
- */
32
- enqueue(fn) {
33
- if (this.closed) {
34
- return Promise.reject(new Error(`[JobQueue:${this.name}] Queue is closed; cannot accept new jobs.`));
35
- }
36
- return new Promise((resolve, reject) => {
37
- const item = {
38
- id: this.nextId++,
39
- run: fn,
40
- resolve,
41
- reject,
42
- };
43
- this.pending.push(item);
44
- this.pump();
45
- });
46
- }
47
- /** Current queue diagnostics. */
48
- getStats() {
49
- return {
50
- name: this.name,
51
- maxConcurrency: this.maxConcurrency,
52
- running: this.running,
53
- pending: this.pending.length,
54
- completed: this.completed,
55
- failed: this.failed,
56
- };
57
- }
58
- /** Reject pending jobs and stop accepting new ones. In-flight jobs finish. */
59
- close(reason = "Queue closed") {
60
- this.closed = true;
61
- while (this.pending.length > 0) {
62
- const item = this.pending.shift();
63
- item?.reject(new Error(`[JobQueue:${this.name}] ${reason}`));
64
- }
65
- }
66
- /** Wait until running + pending reach zero (or timeout). */
67
- async drain(timeoutMs = 30_000) {
68
- const start = Date.now();
69
- while (this.running > 0 || this.pending.length > 0) {
70
- if (Date.now() - start > timeoutMs) {
71
- throw new Error(`[JobQueue:${this.name}] drain timed out after ${timeoutMs}ms`);
72
- }
73
- await new Promise((r) => setTimeout(r, 10));
74
- }
75
- }
76
- pump() {
77
- while (this.running < this.maxConcurrency && this.pending.length > 0) {
78
- const item = this.pending.shift();
79
- if (!item)
80
- break;
81
- this.running++;
82
- void this.execute(item);
83
- }
84
- }
85
- async execute(item) {
86
- try {
87
- const result = await item.run();
88
- this.completed++;
89
- item.resolve(result);
90
- }
91
- catch (error) {
92
- this.failed++;
93
- try {
94
- this.onError?.(error, item.id);
95
- }
96
- catch {
97
- // ignore listener errors
98
- }
99
- item.reject(error);
100
- }
101
- finally {
102
- this.running--;
103
- this.pump();
104
- }
105
- }
106
- }
107
- /** Shared singleton for agent orchestration (lazy). */
108
- let agentJobQueue = null;
109
- export function getAgentJobQueue(options) {
110
- if (!agentJobQueue) {
111
- const fromEnv = process.env.ATABEY_JOB_CONCURRENCY
112
- ? parseInt(process.env.ATABEY_JOB_CONCURRENCY, 10)
113
- : undefined;
114
- agentJobQueue = new InMemoryJobQueue({
115
- name: "agent",
116
- maxConcurrency: options?.maxConcurrency ?? (Number.isFinite(fromEnv) ? fromEnv : undefined),
117
- onError: options?.onError,
118
- });
119
- }
120
- return agentJobQueue;
121
- }
122
- /** Test helper — reset singleton. */
123
- export function resetAgentJobQueue() {
124
- agentJobQueue?.close("reset");
125
- agentJobQueue = null;
126
- }
1
+ export * from "./modules/concurrency/job-queue.js";
127
2
  //# sourceMappingURL=job-queue.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"job-queue.js","sourceRoot":"","sources":["../src/job-queue.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"job-queue.js","sourceRoot":"","sources":["../src/job-queue.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC"}
package/dist/lock.d.ts CHANGED
@@ -1,82 +1 @@
1
- /**
2
- * [LOCK] Multi-user Distributed Lock Mechanism
3
- *
4
- * Git-based lock system. Enables team members to work on the same
5
- * files/resources without conflicts.
6
- *
7
- * Usage:
8
- * const lock = new DistributedLock("database/schema.sql");
9
- * if (lock.acquire("user-123", 60000)) {
10
- * // Apply changes
11
- * lock.release("user-123");
12
- * }
13
- */
14
- export type LockStatus = "LOCKED" | "AVAILABLE" | "STALE" | "EXPIRED";
15
- export interface LockInfo {
16
- resource: string;
17
- ownerId: string;
18
- ownerName: string;
19
- acquiredAt: string;
20
- expiresAt: string;
21
- reason: string;
22
- traceId?: string;
23
- }
24
- export declare class DistributedLock {
25
- private static TABLE;
26
- /**
27
- * Initialize the locks table (run once at startup).
28
- */
29
- static initialize(): void;
30
- /**
31
- * Attempts to acquire a lock on a resource.
32
- *
33
- * @param resource - Lock resource name (e.g., "apps/backend/src/types/user.ts")
34
- * @param ownerId - Unique owner identifier (e.g., "yusuf", "ci-bot-01")
35
- * @param options - Optional parameters
36
- * @returns true if lock acquired, false if already locked
37
- */
38
- static acquire(resource: string, ownerId: string, options?: {
39
- ownerName?: string;
40
- ttlMs?: number;
41
- reason?: string;
42
- traceId?: string;
43
- force?: boolean;
44
- }): boolean;
45
- /**
46
- * Releases a lock. Only the lock owner can release.
47
- *
48
- * @param resource - Lock resource name
49
- * @param ownerId - Owner identifier for verification
50
- * @returns true if released successfully
51
- */
52
- static release(resource: string, ownerId: string): boolean;
53
- /**
54
- * Checks if a resource is locked.
55
- */
56
- static isLocked(resource: string): boolean;
57
- /**
58
- * Gets lock information for a resource.
59
- */
60
- static getLock(resource: string): LockInfo | null;
61
- /**
62
- * Lists all active locks.
63
- */
64
- static listActiveLocks(): LockInfo[];
65
- /**
66
- * Lists all locks owned by a specific owner.
67
- */
68
- static listOwnerLocks(ownerId: string): LockInfo[];
69
- /**
70
- * Releases all locks owned by a specific owner (e.g., on disconnect).
71
- */
72
- static releaseAllByOwner(ownerId: string): number;
73
- /**
74
- * Releases all expired/stale locks.
75
- */
76
- private static releaseStaleLocks;
77
- /**
78
- * Generates a unique owner ID for the current user/machine.
79
- * Uses git config user.name or hostname as fallback.
80
- */
81
- static getLocalOwnerId(): string;
82
- }
1
+ export * from "./modules/concurrency/lock.js";
package/dist/lock.js CHANGED
@@ -1,159 +1,2 @@
1
- /**
2
- * [LOCK] Multi-user Distributed Lock Mechanism
3
- *
4
- * Git-based lock system. Enables team members to work on the same
5
- * files/resources without conflicts.
6
- *
7
- * Usage:
8
- * const lock = new DistributedLock("database/schema.sql");
9
- * if (lock.acquire("user-123", 60000)) {
10
- * // Apply changes
11
- * lock.release("user-123");
12
- * }
13
- */
14
- import { execSync } from "child_process";
15
- import os from "os";
16
- import { databaseHolder } from "./database.js";
17
- export class DistributedLock {
18
- static TABLE = "distributed_locks";
19
- /**
20
- * Initialize the locks table (run once at startup).
21
- */
22
- static initialize() {
23
- const db = databaseHolder.getDB();
24
- db.exec(`
25
- CREATE TABLE IF NOT EXISTS ${this.TABLE} (
26
- resource TEXT PRIMARY KEY,
27
- ownerId TEXT NOT NULL,
28
- ownerName TEXT NOT NULL,
29
- acquiredAt TEXT NOT NULL,
30
- expiresAt TEXT NOT NULL,
31
- reason TEXT,
32
- traceId TEXT
33
- )
34
- `);
35
- }
36
- /**
37
- * Attempts to acquire a lock on a resource.
38
- *
39
- * @param resource - Lock resource name (e.g., "apps/backend/src/types/user.ts")
40
- * @param ownerId - Unique owner identifier (e.g., "yusuf", "ci-bot-01")
41
- * @param options - Optional parameters
42
- * @returns true if lock acquired, false if already locked
43
- */
44
- static acquire(resource, ownerId, options = {}) {
45
- const db = databaseHolder.getDB();
46
- const now = new Date();
47
- const expiresAt = new Date(now.getTime() + (options.ttlMs || 60000)).toISOString();
48
- const ownerName = options.ownerName || ownerId;
49
- const reason = options.reason || "No reason provided";
50
- // Clean up stale locks first
51
- this.releaseStaleLocks();
52
- // If force=true, override existing lock directly using INSERT OR REPLACE
53
- if (options.force) {
54
- db.prepare(`
55
- INSERT OR REPLACE INTO ${this.TABLE} (resource, ownerId, ownerName, acquiredAt, expiresAt, reason, traceId)
56
- VALUES (?, ?, ?, ?, ?, ?, ?)
57
- `).run(resource, ownerId, ownerName, now.toISOString(), expiresAt, reason, options.traceId || null);
58
- return true;
59
- }
60
- // Acquire new lock atomically using INSERT OR IGNORE.
61
- // If the resource is already locked, changes will be 0.
62
- const result = db.prepare(`
63
- INSERT OR IGNORE INTO ${this.TABLE} (resource, ownerId, ownerName, acquiredAt, expiresAt, reason, traceId)
64
- VALUES (?, ?, ?, ?, ?, ?, ?)
65
- `).run(resource, ownerId, ownerName, now.toISOString(), expiresAt, reason, options.traceId || null);
66
- return result.changes > 0;
67
- }
68
- /**
69
- * Releases a lock. Only the lock owner can release.
70
- *
71
- * @param resource - Lock resource name
72
- * @param ownerId - Owner identifier for verification
73
- * @returns true if released successfully
74
- */
75
- static release(resource, ownerId) {
76
- const db = databaseHolder.getDB();
77
- const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE resource = ? AND ownerId = ?`).run(resource, ownerId);
78
- return result.changes > 0;
79
- }
80
- /**
81
- * Checks if a resource is locked.
82
- */
83
- static isLocked(resource) {
84
- const db = databaseHolder.getDB();
85
- const nowIso = new Date().toISOString();
86
- const lock = db.prepare(`SELECT * FROM ${this.TABLE} WHERE resource = ? AND expiresAt > ?`).get(resource, nowIso);
87
- return !!lock;
88
- }
89
- /**
90
- * Gets lock information for a resource.
91
- */
92
- static getLock(resource) {
93
- const db = databaseHolder.getDB();
94
- this.releaseStaleLocks();
95
- const lock = db.prepare(`SELECT * FROM ${this.TABLE} WHERE resource = ?`).get(resource);
96
- return lock || null;
97
- }
98
- /**
99
- * Lists all active locks.
100
- */
101
- static listActiveLocks() {
102
- const db = databaseHolder.getDB();
103
- this.releaseStaleLocks();
104
- const nowIso = new Date().toISOString();
105
- return db.prepare(`SELECT * FROM ${this.TABLE} WHERE expiresAt > ? ORDER BY acquiredAt DESC`).all(nowIso);
106
- }
107
- /**
108
- * Lists all locks owned by a specific owner.
109
- */
110
- static listOwnerLocks(ownerId) {
111
- const db = databaseHolder.getDB();
112
- return db.prepare(`SELECT * FROM ${this.TABLE} WHERE ownerId = ? ORDER BY acquiredAt DESC`).all(ownerId);
113
- }
114
- /**
115
- * Releases all locks owned by a specific owner (e.g., on disconnect).
116
- */
117
- static releaseAllByOwner(ownerId) {
118
- const db = databaseHolder.getDB();
119
- const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE ownerId = ?`).run(ownerId);
120
- return result.changes;
121
- }
122
- /**
123
- * Releases all expired/stale locks.
124
- */
125
- static releaseStaleLocks() {
126
- const db = databaseHolder.getDB();
127
- const nowIso = new Date().toISOString();
128
- const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE expiresAt < ?`).run(nowIso);
129
- return result.changes;
130
- }
131
- /**
132
- * Generates a unique owner ID for the current user/machine.
133
- * Uses git config user.name or hostname as fallback.
134
- */
135
- static getLocalOwnerId() {
136
- // Try git config
137
- try {
138
- const name = execSync("git config user.name", { encoding: "utf8" }).trim();
139
- if (name)
140
- return name;
141
- }
142
- catch {
143
- // Fallback
144
- }
145
- // Try environment
146
- if (process.env.USER)
147
- return process.env.USER;
148
- if (process.env.USERNAME)
149
- return process.env.USERNAME;
150
- // Fallback to hostname
151
- try {
152
- return os.hostname();
153
- }
154
- catch {
155
- return "unknown-user";
156
- }
157
- }
158
- }
1
+ export * from "./modules/concurrency/lock.js";
159
2
  //# sourceMappingURL=lock.js.map
package/dist/lock.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}
package/dist/logger.d.ts CHANGED
@@ -1,30 +1 @@
1
- export declare enum LogLevel {
2
- DEBUG = 0,
3
- INFO = 1,
4
- WARN = 2,
5
- ERROR = 3,
6
- FATAL = 4
7
- }
8
- export interface LoggerConfig {
9
- minLevel: LogLevel;
10
- enableColors: boolean;
11
- jsonFormat: boolean;
12
- logFile?: string;
13
- enablePiiMasking: boolean;
14
- piiWarning: boolean;
15
- }
16
- export declare class EnterpriseLogger {
17
- private config;
18
- private static instance;
19
- private constructor();
20
- static getInstance(): EnterpriseLogger;
21
- configure(config: Partial<LoggerConfig>): void;
22
- private formatMessage;
23
- private log;
24
- debug(message: string, meta?: unknown): void;
25
- info(message: string, meta?: unknown): void;
26
- warn(message: string, meta?: unknown): void;
27
- error(message: string, meta?: unknown): void;
28
- fatal(message: string, meta?: unknown): void;
29
- }
30
- export declare const logger: EnterpriseLogger;
1
+ export * from "./modules/observability/logger.js";
package/dist/logger.js CHANGED
@@ -1,127 +1,2 @@
1
- import chalk from "chalk";
2
- import path from "path";
3
- import { appendFile, ensureDir } from "./fs.js";
4
- import { containsPII, maskObject, maskText } from "./pii.js";
5
- export var LogLevel;
6
- (function (LogLevel) {
7
- LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
8
- LogLevel[LogLevel["INFO"] = 1] = "INFO";
9
- LogLevel[LogLevel["WARN"] = 2] = "WARN";
10
- LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
11
- LogLevel[LogLevel["FATAL"] = 4] = "FATAL";
12
- })(LogLevel || (LogLevel = {}));
13
- export class EnterpriseLogger {
14
- config;
15
- static instance;
16
- constructor() {
17
- const isProd = process.env.NODE_ENV === "production";
18
- this.config = {
19
- minLevel: isProd ? LogLevel.INFO : LogLevel.DEBUG,
20
- enableColors: !isProd,
21
- jsonFormat: isProd,
22
- enablePiiMasking: true, // KVKK: PII masking ON by default
23
- piiWarning: true,
24
- };
25
- }
26
- static getInstance() {
27
- if (!EnterpriseLogger.instance) {
28
- EnterpriseLogger.instance = new EnterpriseLogger();
29
- }
30
- return EnterpriseLogger.instance;
31
- }
32
- configure(config) {
33
- this.config = { ...this.config, ...config };
34
- if (this.config.logFile) {
35
- try {
36
- ensureDir(path.dirname(this.config.logFile));
37
- }
38
- catch (err) {
39
- // Directly write to stderr — using console here would be circular
40
- process.stderr.write(`[Logger] Failed to create log directory: ${err}\n`);
41
- }
42
- }
43
- }
44
- formatMessage(level, message, meta) {
45
- const timestamp = new Date().toISOString();
46
- const pid = process.pid;
47
- // [KVKK] PII masking — mask sensitive data before logging
48
- const safeMessage = this.config.enablePiiMasking ? maskText(message) : message;
49
- const safeMeta = this.config.enablePiiMasking && meta ? maskObject(meta) : meta;
50
- // [KVKK] Warn if PII detected in production
51
- if (this.config.piiWarning && (containsPII(message) || (meta && containsPII(JSON.stringify(meta))))) {
52
- process.stderr.write(`[PII WARNING] Potential PII detected in log at ${timestamp}\n`);
53
- }
54
- if (this.config.jsonFormat) {
55
- return JSON.stringify({
56
- timestamp,
57
- level: LogLevel[level],
58
- pid,
59
- message: safeMessage,
60
- meta: safeMeta,
61
- });
62
- }
63
- const levelName = LogLevel[level].padEnd(5);
64
- let coloredLevel = levelName;
65
- if (this.config.enableColors) {
66
- switch (level) {
67
- case LogLevel.DEBUG:
68
- coloredLevel = chalk.blue(levelName);
69
- break;
70
- case LogLevel.INFO:
71
- coloredLevel = chalk.green(levelName);
72
- break;
73
- case LogLevel.WARN:
74
- coloredLevel = chalk.yellow(levelName);
75
- break;
76
- case LogLevel.ERROR:
77
- coloredLevel = chalk.red(levelName);
78
- break;
79
- case LogLevel.FATAL:
80
- coloredLevel = chalk.bgRed.white.bold(levelName);
81
- break;
82
- }
83
- }
84
- const metaStr = safeMeta ? ` | Meta: ${JSON.stringify(safeMeta)}` : "";
85
- return `[${timestamp}] [PID:${pid}] [${coloredLevel}]: ${safeMessage}${metaStr}`;
86
- }
87
- log(level, message, meta) {
88
- if (level < this.config.minLevel)
89
- return;
90
- const formatted = this.formatMessage(level, message, meta);
91
- // Route to stderr for ERROR/FATAL, stdout otherwise.
92
- // Using process.write directly here is intentional — this IS the logger.
93
- if (level >= LogLevel.ERROR) {
94
- process.stderr.write(formatted + "\n");
95
- }
96
- else {
97
- process.stdout.write(formatted + "\n");
98
- }
99
- // Output to file if configured
100
- if (this.config.logFile) {
101
- try {
102
- appendFile(this.config.logFile, formatted + "\n");
103
- }
104
- catch (err) {
105
- // Directly write to stderr — using console here would be circular
106
- process.stderr.write(`[Logger] Failed to write to log file: ${err}\n`);
107
- }
108
- }
109
- }
110
- debug(message, meta) {
111
- this.log(LogLevel.DEBUG, message, meta);
112
- }
113
- info(message, meta) {
114
- this.log(LogLevel.INFO, message, meta);
115
- }
116
- warn(message, meta) {
117
- this.log(LogLevel.WARN, message, meta);
118
- }
119
- error(message, meta) {
120
- this.log(LogLevel.ERROR, message, meta);
121
- }
122
- fatal(message, meta) {
123
- this.log(LogLevel.FATAL, message, meta);
124
- }
125
- }
126
- export const logger = EnterpriseLogger.getInstance();
1
+ export * from "./modules/observability/logger.js";
127
2
  //# sourceMappingURL=logger.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}
@@ -0,0 +1 @@
1
+ export * from "./modules/storage/memory-prune.js";
@@ -0,0 +1,2 @@
1
+ export * from "./modules/storage/memory-prune.js";
2
+ //# sourceMappingURL=memory-prune.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-prune.js","sourceRoot":"","sources":["../src/memory-prune.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}
@@ -0,0 +1 @@
1
+ export * from "./modules/storage/migrations.js";
@@ -0,0 +1,2 @@
1
+ export * from "./modules/storage/migrations.js";
2
+ //# sourceMappingURL=migrations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrations.js","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Agent Identity — cryptographically signed agent tokens.
3
+ *
4
+ * Problem: `ATABEY_ACTIVE_AGENT` is a plain env var, so any tool/subprocess can
5
+ * impersonate `@manager` or `@security`. When `ATABEY_AGENT_SECRET` is set,
6
+ * Atabey accepts an HMAC-signed `ATABEY_AGENT_TOKEN` and verifies it
7
+ * (fail-closed on tampering/expiry). Set `ATABEY_AGENT_IDENTITY_REQUIRED=true`
8
+ * to refuse plain-env identity entirely.
9
+ *
10
+ * Token format: `${agent}.${issuedAt}.${expiresAt}.${hmacSha256Base64url}`
11
+ */
12
+ export interface AgentIdentity {
13
+ agent: string;
14
+ issuedAt: number;
15
+ expiresAt: number;
16
+ }
17
+ export interface AgentTokenResult {
18
+ valid: boolean;
19
+ agent?: string;
20
+ reason?: string;
21
+ }
22
+ /** True when agent-token verification is mandatory (plain env rejected). */
23
+ export declare function isAgentIdentityEnforced(): boolean;
24
+ /** Sign an agent identity into a compact token. */
25
+ export declare function signAgentToken(agent: string, options?: {
26
+ ttlMs?: number;
27
+ key?: string | Buffer;
28
+ }): string;
29
+ /** Verify an agent token (signature + expiry). */
30
+ export declare function verifyAgentToken(token: string, options?: {
31
+ key?: string | Buffer;
32
+ }): AgentTokenResult;
33
+ /** Decode a token's identity without verification (for diagnostics only). */
34
+ export declare function decodeAgentToken(token: string): AgentIdentity | null;