@machinemetrics/mm-erp-sdk 0.9.5 → 0.9.6-beta.1

package/dist/migrations/20260617160000_create_sdk_runtime_state_table.d.ts

@@ -0,0 +1,4 @@
+import type { Knex } from "knex";
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20260617160000_create_sdk_runtime_state_table.d.ts.map

package/dist/migrations/20260617160000_create_sdk_runtime_state_table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260617160000_create_sdk_runtime_state_table.d.ts","sourceRoot":"","sources":["../../src/migrations/20260617160000_create_sdk_runtime_state_table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpD"}

package/dist/migrations/20260617160000_create_sdk_runtime_state_table.js

@@ -0,0 +1,11 @@
+export async function up(knex) {
+    await knex.schema.createTable("sdk_runtime_state", (table) => {
+        table.string("key").primary();
+        table.text("value").notNullable();
+        table.string("updated_at").notNullable();
+    });
+}
+export async function down(knex) {
+    await knex.schema.dropTable("sdk_runtime_state");
+}
+//# sourceMappingURL=20260617160000_create_sdk_runtime_state_table.js.map

package/dist/migrations/20260617160000_create_sdk_runtime_state_table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260617160000_create_sdk_runtime_state_table.js","sourceRoot":"","sources":["../../src/migrations/20260617160000_create_sdk_runtime_state_table.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,IAAU;IACjC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC3D,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAU;IACnC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;AACnD,CAAC"}

package/dist/services/mm-api-service/company-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"company-info.d.ts","sourceRoot":"","sources":["../../../src/services/mm-api-service/company-info.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4BD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAAa,OAAO,CAAC,WAAW,CAsDrE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,WAAW,CAS1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAQ,uBAGP,KACA,OAAO,CAAC,IAAI,CAkBd,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAElD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAG5D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}
+{"version":3,"file":"company-info.d.ts","sourceRoot":"","sources":["../../../src/services/mm-api-service/company-info.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4BD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAAa,OAAO,CAAC,WAAW,CAsDrE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,WAAW,CAS1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAQ,uBAGP,KACA,OAAO,CAAC,IAAI,CAkBd,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAElD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAG5D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/services/mm-api-service/company-info.js

@@ -1,10 +1,9 @@
 /**
  * Company info from MM (`/accounts/current`) is loaded during SDK startup
  * (`ApplicationInitializer.initialize` → {@link ensureCompanyInfo}), written to shared
- * job-state, and read by synchronous {@link getCachedCompanyInfo} and related getters.
+ * SQLite runtime state, and read by synchronous {@link getCachedCompanyInfo} and related getters.
  *
- * Persisted data is scoped to whatever filesystem sees the job-state file (default under `/tmp`):
- * e.g. one container’s filesystem unless that path is mounted shared. Company fields are treated
+ * Persisted data lives in `sdk_runtime_state` (same SQLite file as `SQLITE_DB_PATH`). Company fields are treated
  * as stable for the deployment; refreshing them if MM changes is the SDK’s responsibility when we
  * add that behavior—not connector boilerplate.
  *
@@ -32,7 +31,7 @@ function hydrateCacheFromDiskIfPresent() {
     return null;
 }
 /**
- * Resolves company info for synchronous readers: in-memory, then persisted job-state.
+ * Resolves company info for synchronous readers: in-memory, then persisted SQLite runtime state.
  * @throws Error if neither is available (initialization / API fetch has not populated data).
  */
 function resolveCompanyInfoOrThrow() {
@@ -43,7 +42,7 @@ function resolveCompanyInfoOrThrow() {
     if (fromDisk) {
         return fromDisk;
     }
-    throw new Error("Company info is not available: run ApplicationInitializer.initialize() or ensureCompanyInfo() in a process with API access, or ensure job-state.json contains companyInfo from a prior fetch");
+    throw new Error("Company info is not available: run ApplicationInitializer.initialize() or ensureCompanyInfo() in a process with API access, or ensure sdk_runtime_state contains companyInfo from a prior fetch");
 }
 /**
  * Fetches company info from MM, updates in-memory cache and persisted job-state.

package/dist/services/mm-api-service/company-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"company-info.js","sourceRoot":"","sources":["../../../src/services/mm-api-service/company-info.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"company-info.js","sourceRoot":"","sources":["../../../src/services/mm-api-service/company-info.ts"],"names":[],"mappings":"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"}

package/dist/services/mm-api-service/token-mgr.d.ts

@@ -1,6 +1,6 @@
 /**
  * Manages the MM API token with caching and expiration checking
- * Tokens are cached across jobs and job instances in local-data-store/jobs-shared-data.ts
+ * Tokens are cached across jobs and job instances in SQLite runtime state (jobs-shared-data.ts).
  * @jest-environment node
  */
 export declare class MMTokenManager {

package/dist/services/mm-api-service/token-mgr.js

@@ -4,7 +4,7 @@ import { CoreConfiguration } from "../data-sync-service/configuration-manager.js
 import { logger } from "../reporting-service/index.js";
 /**
  * Manages the MM API token with caching and expiration checking
- * Tokens are cached across jobs and job instances in local-data-store/jobs-shared-data.ts
+ * Tokens are cached across jobs and job instances in SQLite runtime state (jobs-shared-data.ts).
  * @jest-environment node
  */
 export class MMTokenManager {

package/dist/utils/application-initializer.js

@@ -26,7 +26,7 @@ export class ApplicationInitializer {
             logger.info("Running database migrations...");
             await ApplicationInitializer.runMigrations();
             logger.info("Database migrations completed successfully");
-            // Loads company info from MM into memory + job-state (timezone, locationRef, companyId).
+            // Loads company info from MM into memory + SQLite runtime state (timezone, locationRef, companyId).
             // Retries until success; failure aborts init. Confirms the MM API token works for /accounts/current.
             await ensureCompanyInfo();
             logger.info("\n================================APPLICATION INITIALIZATION COMPLETED================================\n");

package/dist/utils/application-initializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"application-initializer.js","sourceRoot":"","sources":["../../src/utils/application-initializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,gBAAgB,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU;QAC5B,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CACT,8FAA8F,CAC/F,CAAC;YAEF,uCAAuC;YACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;YAExE,kCAAkC;YAClC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACrD,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAE9D,qDAAqD;YACrD,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAC9C,MAAM,sBAAsB,CAAC,aAAa,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAE1D,yFAAyF;YACzF,qGAAqG;YACrG,MAAM,iBAAiB,EAAE,CAAC;YAE1B,MAAM,CAAC,IAAI,CACT,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;YACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,aAAa;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"application-initializer.js","sourceRoot":"","sources":["../../src/utils/application-initializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,gBAAgB,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU;QAC5B,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CACT,8FAA8F,CAC/F,CAAC;YAEF,uCAAuC;YACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;YAExE,kCAAkC;YAClC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACrD,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAE9D,qDAAqD;YACrD,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAC9C,MAAM,sBAAsB,CAAC,aAAa,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAE1D,oGAAoG;YACpG,qGAAqG;YACrG,MAAM,iBAAiB,EAAE,CAAC;YAE1B,MAAM,CAAC,IAAI,CACT,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;YACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,aAAa;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/utils/local-data-store/database-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database-lock.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/database-lock.ts"],"names":[],"mappings":"AAKA,UAAU,YAAY;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,YASlC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,KAAG,OAmBzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,KAAG,OAmBzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,OAGtC,CAAC"}
+{"version":3,"file":"database-lock.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/database-lock.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAYD;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,YAElC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,KAAG,OAczD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,KAAG,OAUzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,OAEtC,CAAC"}

package/dist/utils/local-data-store/database-lock.js

@@ -1,15 +1,19 @@
-import { readDatabaseLockState, writeDatabaseLockState, } from "./jobs-shared-data.js";
+import { getRuntimeStateJson, setRuntimeStateJson, withImmediateTransaction, } from "./sdk-runtime-state-db.js";
+const DATABASE_LOCK_KEY = "databaseLock";
+const defaultLock = () => ({
+    isLocked: false,
+    lockedBy: "",
+    lockedAt: null,
+});
+function readLock() {
+    return getRuntimeStateJson(DATABASE_LOCK_KEY) ?? defaultLock();
+}
 /**
  * Gets the current database lock state
  * @returns The current database lock state
  */
 export const getDatabaseLock = () => {
-    const data = readDatabaseLockState();
-    return (data.databaseLock ?? {
-        isLocked: false,
-        lockedBy: "",
-        lockedAt: null,
-    });
+    return readLock();
 };
 /**
  * Attempts to acquire the database lock
@@ -17,22 +21,18 @@ export const getDatabaseLock = () => {
  * @returns true if lock was acquired, false if database is already locked
  */
 export const acquireDatabaseLock = (processName) => {
-    const data = readDatabaseLockState();
-    const currentLock = data.databaseLock ?? {
-        isLocked: false,
-        lockedBy: "",
-        lockedAt: null,
-    };
-    if (currentLock.isLocked) {
-        return false;
-    }
-    data.databaseLock = {
-        isLocked: true,
-        lockedBy: processName,
-        lockedAt: new Date().toISOString(),
-    };
-    writeDatabaseLockState(data);
-    return true;
+    return withImmediateTransaction(() => {
+        const currentLock = readLock();
+        if (currentLock.isLocked) {
+            return false;
+        }
+        setRuntimeStateJson(DATABASE_LOCK_KEY, {
+            isLocked: true,
+            lockedBy: processName,
+            lockedAt: new Date().toISOString(),
+        });
+        return true;
+    });
 };
 /**
  * Releases the database lock
@@ -40,29 +40,20 @@ export const acquireDatabaseLock = (processName) => {
  * @returns true if lock was released, false if process doesn't own the lock
  */
 export const releaseDatabaseLock = (processName) => {
-    const data = readDatabaseLockState();
-    const currentLock = data.databaseLock ?? {
-        isLocked: false,
-        lockedBy: "",
-        lockedAt: null,
-    };
-    if (!currentLock.isLocked || currentLock.lockedBy !== processName) {
-        return false;
-    }
-    data.databaseLock = {
-        isLocked: false,
-        lockedBy: "",
-        lockedAt: null,
-    };
-    writeDatabaseLockState(data);
-    return true;
+    return withImmediateTransaction(() => {
+        const currentLock = readLock();
+        if (!currentLock.isLocked || currentLock.lockedBy !== processName) {
+            return false;
+        }
+        setRuntimeStateJson(DATABASE_LOCK_KEY, defaultLock());
+        return true;
+    });
 };
 /**
  * Checks if the database is available for use
  * @returns true if database is available, false if locked
  */
 export const isDatabaseAvailable = () => {
-    const lock = getDatabaseLock();
-    return !lock.isLocked;
+    return !readLock().isLocked;
 };
 //# sourceMappingURL=database-lock.js.map

package/dist/utils/local-data-store/database-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"database-lock.js","sourceRoot":"","sources":["../../../src/utils/local-data-store/database-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAQ/B;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAiB,EAAE;IAChD,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,OAAO,CACJ,IAAI,CAAC,YAA6B,IAAI;QACrC,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,IAAI;KACf,CACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAW,EAAE;IAClE,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,MAAM,WAAW,GAAI,IAAI,CAAC,YAA6B,IAAI;QACzD,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,YAAY,GAAG;QAClB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;IACF,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAW,EAAE;IAClE,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,MAAM,WAAW,GAAI,IAAI,CAAC,YAA6B,IAAI;QACzD,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,YAAY,GAAG;QAClB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAY,EAAE;IAC/C,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;AACxB,CAAC,CAAC"}
+{"version":3,"file":"database-lock.js","sourceRoot":"","sources":["../../../src/utils/local-data-store/database-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAQzC,MAAM,WAAW,GAAG,GAAiB,EAAE,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,IAAI;CACf,CAAC,CAAC;AAEH,SAAS,QAAQ;IACf,OAAO,mBAAmB,CAAe,iBAAiB,CAAC,IAAI,WAAW,EAAE,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAiB,EAAE;IAChD,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAW,EAAE;IAClE,OAAO,wBAAwB,CAAC,GAAG,EAAE;QACnC,MAAM,WAAW,GAAG,QAAQ,EAAE,CAAC;QAC/B,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mBAAmB,CAAC,iBAAiB,EAAE;YACrC,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAW,EAAE;IAClE,OAAO,wBAAwB,CAAC,GAAG,EAAE;QACnC,MAAM,WAAW,GAAG,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mBAAmB,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAY,EAAE;IAC/C,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;AAC9B,CAAC,CAAC"}

package/dist/utils/local-data-store/jobs-shared-data.d.ts

@@ -4,19 +4,9 @@ import type { CompanyInfo } from "../../services/mm-api-service/company-info.js"
  */
 export declare const readPersistedCompanyInfo: () => CompanyInfo | null;
 /**
- * Persists company info for other processes on the same host (same job-state file).
+ * Persists company info for other processes sharing the same SQLite database file.
  */
 export declare const writePersistedCompanyInfo: (info: CompanyInfo) => void;
-/**
- * Reads the database lock state from the shared storage file
- * @returns The data stored in the file
- */
-export declare const readDatabaseLockState: () => Record<string, unknown>;
-/**
- * Writes the database lock state to the shared storage file
- * @param data The lock state data to write
- */
-export declare const writeDatabaseLockState: (data: Record<string, unknown>) => void;
 export declare const getInitialLoadComplete: () => boolean;
 export declare const setInitialLoadComplete: (complete: boolean) => void;
 interface CachedToken {

package/dist/utils/local-data-store/jobs-shared-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs-shared-data.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/jobs-shared-data.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AA2DjF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,WAAW,GAAG,IAIzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,WAAW,KAAG,IAI7D,CAAC;AAGF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAE9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAEtE,CAAC;AAGF,eAAO,MAAM,sBAAsB,QAAO,OAGzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,KAAG,IAI1D,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAAW,GAAG,IAGjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,WAAW,KAAG,IAIzD,CAAC"}
+{"version":3,"file":"jobs-shared-data.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/jobs-shared-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AA6BjF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,WAAW,GAAG,IAGzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,WAAW,KAAG,IAE7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,OAEzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,KAAG,IAE1D,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAAW,GAAG,IAEjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,WAAW,KAAG,IAEzD,CAAC"}

package/dist/utils/local-data-store/jobs-shared-data.js

@@ -1,13 +1,12 @@
-import fs from "fs";
-import path from "path";
-import { mkdirSync } from "fs";
+import { getRuntimeStateJson, setRuntimeStateJson, } from "./sdk-runtime-state-db.js";
 /**
- * This file contains the logic for storing and retrieving data from the job state file.
- * It is used to store data that is shared between jobs, and (more importantly) across job instances.
- * Company info (timezone, locationRef, companyId) is persisted here so processes that share this
- * file path (same host /tmp, or a shared volume) can read it after SDK init; offset is not stored.
+ * Cross-process runtime state shared between Bree workers (company info, token cache,
+ * initial-load flag). Stored in SQLite (`sdk_runtime_state`) keyed by SQLITE_DB_PATH so
+ * each key is updated independently under WAL — no whole-file read-modify-write races.
  */
 const COMPANY_INFO_STORAGE_KEY = "companyInfo";
+const INITIAL_LOAD_COMPLETE_KEY = "initialLoadComplete";
+const MM_API_TOKEN_KEY = "mmApiToken";
 function isPersistedCompanyInfo(value) {
     if (!value || typeof value !== "object") {
         return false;
@@ -18,94 +17,37 @@ function isPersistedCompanyInfo(value) {
         typeof o.locationRef === "string" &&
         typeof o.companyId === "string");
 }
-const STORAGE_FILE = path.join("/tmp", "job-state.json");
-// Ensure parent directory exists
-const parentDir = path.dirname(STORAGE_FILE);
-try {
-    mkdirSync(parentDir, { recursive: true });
-}
-catch (error) {
-    if (error.code !== "EEXIST") {
-        throw error;
-    }
-}
-//#region Non-exported functions
-const ensureStorageFile = () => {
-    if (!fs.existsSync(STORAGE_FILE)) {
-        fs.writeFileSync(STORAGE_FILE, JSON.stringify({}), "utf-8");
-    }
-};
-const readStorage = () => {
-    ensureStorageFile();
-    try {
-        return JSON.parse(fs.readFileSync(STORAGE_FILE, "utf-8"));
-    }
-    catch (error) {
-        console.error(`Failed to read storage from ${STORAGE_FILE}:`, error);
-        return {};
-    }
-};
-const writeStorage = (data) => {
-    ensureStorageFile();
-    fs.writeFileSync(STORAGE_FILE, JSON.stringify(data, null, 2), "utf-8");
-};
-//#endregion
 /**
  * Reads company info written by initialization (or a prior API fetch) for use across processes.
  */
 export const readPersistedCompanyInfo = () => {
-    const data = readStorage();
-    const raw = data[COMPANY_INFO_STORAGE_KEY];
+    const raw = getRuntimeStateJson(COMPANY_INFO_STORAGE_KEY);
     return isPersistedCompanyInfo(raw) ? raw : null;
 };
 /**
- * Persists company info for other processes on the same host (same job-state file).
+ * Persists company info for other processes sharing the same SQLite database file.
  */
 export const writePersistedCompanyInfo = (info) => {
-    const data = readStorage();
-    data[COMPANY_INFO_STORAGE_KEY] = info;
-    writeStorage(data);
-};
-//#region Database lock storage functions
-/**
- * Reads the database lock state from the shared storage file
- * @returns The data stored in the file
- */
-export const readDatabaseLockState = () => {
-    return readStorage();
-};
-/**
- * Writes the database lock state to the shared storage file
- * @param data The lock state data to write
- */
-export const writeDatabaseLockState = (data) => {
-    writeStorage(data);
+    setRuntimeStateJson(COMPANY_INFO_STORAGE_KEY, info);
 };
-//#endregion
 export const getInitialLoadComplete = () => {
-    const data = readStorage();
-    return data.initialLoadComplete ?? false;
+    return getRuntimeStateJson(INITIAL_LOAD_COMPLETE_KEY) ?? false;
 };
 export const setInitialLoadComplete = (complete) => {
-    const data = readStorage();
-    data.initialLoadComplete = complete;
-    writeStorage(data);
+    setRuntimeStateJson(INITIAL_LOAD_COMPLETE_KEY, complete);
 };
 /**
  * Gets the cached MM API token and its expiration
  * @returns The cached token and expiration or null if not found
  */
 export const getCachedMMToken = () => {
-    const data = readStorage();
-    return data.mmApiToken ?? null;
+    return getRuntimeStateJson(MM_API_TOKEN_KEY);
 };
 /**
  * Sets the MM API token and its expiration in the cache
  * @param tokenData The token and expiration to cache
  */
 export const setCachedMMToken = (tokenData) => {
-    const data = readStorage();
-    data.mmApiToken = tokenData;
-    writeStorage(data);
+    setRuntimeStateJson(MM_API_TOKEN_KEY, tokenData);
 };
 //# sourceMappingURL=jobs-shared-data.js.map

package/dist/utils/local-data-store/jobs-shared-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs-shared-data.js","sourceRoot":"","sources":["../../../src/utils/local-data-store/jobs-shared-data.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jobs-shared-data.js","sourceRoot":"","sources":["../../../src/utils/local-data-store/jobs-shared-data.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AAEH,MAAM,wBAAwB,GAAG,aAAa,CAAC;AAC/C,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AACxD,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrB,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAuB,EAAE;IAC/D,MAAM,GAAG,GAAG,mBAAmB,CAAU,wBAAwB,CAAC,CAAC;IACnE,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAAiB,EAAQ,EAAE;IACnE,mBAAmB,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAY,EAAE;IAClD,OAAO,mBAAmB,CAAU,yBAAyB,CAAC,IAAI,KAAK,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAiB,EAAQ,EAAE;IAChE,mBAAmB,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC,CAAC;AAOF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAuB,EAAE;IACvD,OAAO,mBAAmB,CAAc,gBAAgB,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAsB,EAAQ,EAAE;IAC/D,mBAAmB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/utils/local-data-store/sdk-runtime-state-db.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reads a JSON value for `key`, or null when unset.
+ */
+export declare function getRuntimeStateJson<T>(key: string): T | null;
+/**
+ * Upserts a JSON-serializable value for `key` without touching other keys.
+ */
+export declare function setRuntimeStateJson(key: string, value: unknown): void;
+/**
+ * Runs `fn` inside BEGIN IMMEDIATE so cross-process writers serialize safely.
+ */
+export declare function withImmediateTransaction<T>(fn: () => T): T;
+/** Visible for integration tests that need an isolated database file. */
+export declare function resetRuntimeStateDbForTests(): void;
+//# sourceMappingURL=sdk-runtime-state-db.d.ts.map

package/dist/utils/local-data-store/sdk-runtime-state-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runtime-state-db.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/sdk-runtime-state-db.ts"],"names":[],"mappings":"AAoGA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAM5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAW1D;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD"}

package/dist/utils/local-data-store/sdk-runtime-state-db.js

@@ -0,0 +1,123 @@
+import fs from "fs";
+import path from "path";
+import Database from "better-sqlite3";
+const TABLE = "sdk_runtime_state";
+const LEGACY_JOB_STATE_FILE = path.join("/tmp", "job-state.json");
+const LEGACY_IMPORT_FLAG_KEY = "_legacyJobStateImported";
+let db = null;
+function dbPath() {
+    return process.env.SQLITE_DB_PATH || "./local.sqlite3";
+}
+function ensureDbDirectory(filename) {
+    const parentDir = path.dirname(path.resolve(filename));
+    try {
+        fs.mkdirSync(parentDir, { recursive: true });
+    }
+    catch (error) {
+        if (error.code !== "EEXIST") {
+            throw error;
+        }
+    }
+}
+function getDb() {
+    if (!db) {
+        const filename = dbPath();
+        ensureDbDirectory(filename);
+        const instance = new Database(filename);
+        instance.pragma("journal_mode = WAL");
+        instance.pragma("busy_timeout = 5000");
+        instance.exec(`
+      CREATE TABLE IF NOT EXISTS ${TABLE} (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `);
+        db = instance;
+        try {
+            importLegacyJobStateFileOnce();
+        }
+        catch (error) {
+            instance.close();
+            db = null;
+            throw error;
+        }
+    }
+    return db;
+}
+function readRaw(key) {
+    const row = getDb()
+        .prepare(`SELECT value FROM ${TABLE} WHERE key = ?`)
+        .get(key);
+    return row?.value ?? null;
+}
+function writeRaw(key, value) {
+    const updatedAt = new Date().toISOString();
+    getDb()
+        .prepare(`INSERT INTO ${TABLE} (key, value, updated_at) VALUES (?, ?, ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`)
+        .run(key, value, updatedAt);
+}
+function importLegacyJobStateFileOnce() {
+    if (readRaw(LEGACY_IMPORT_FLAG_KEY)) {
+        return;
+    }
+    if (fs.existsSync(LEGACY_JOB_STATE_FILE)) {
+        const raw = fs.readFileSync(LEGACY_JOB_STATE_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.companyInfo && !readRaw("companyInfo")) {
+            writeRaw("companyInfo", JSON.stringify(data.companyInfo));
+        }
+        if (data.mmApiToken && !readRaw("mmApiToken")) {
+            writeRaw("mmApiToken", JSON.stringify(data.mmApiToken));
+        }
+        if (data.initialLoadComplete !== undefined &&
+            !readRaw("initialLoadComplete")) {
+            writeRaw("initialLoadComplete", JSON.stringify(data.initialLoadComplete));
+        }
+        if (data.databaseLock && !readRaw("databaseLock")) {
+            writeRaw("databaseLock", JSON.stringify(data.databaseLock));
+        }
+    }
+    writeRaw(LEGACY_IMPORT_FLAG_KEY, JSON.stringify(true));
+}
+/**
+ * Reads a JSON value for `key`, or null when unset.
+ */
+export function getRuntimeStateJson(key) {
+    const raw = readRaw(key);
+    if (raw === null) {
+        return null;
+    }
+    return JSON.parse(raw);
+}
+/**
+ * Upserts a JSON-serializable value for `key` without touching other keys.
+ */
+export function setRuntimeStateJson(key, value) {
+    writeRaw(key, JSON.stringify(value));
+}
+/**
+ * Runs `fn` inside BEGIN IMMEDIATE so cross-process writers serialize safely.
+ */
+export function withImmediateTransaction(fn) {
+    const database = getDb();
+    database.prepare("BEGIN IMMEDIATE").run();
+    try {
+        const result = fn();
+        database.prepare("COMMIT").run();
+        return result;
+    }
+    catch (error) {
+        database.prepare("ROLLBACK").run();
+        throw error;
+    }
+}
+/** Visible for integration tests that need an isolated database file. */
+export function resetRuntimeStateDbForTests() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+//# sourceMappingURL=sdk-runtime-state-db.js.map

package/dist/utils/local-data-store/sdk-runtime-state-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runtime-state-db.js","sourceRoot":"","sources":["../../../src/utils/local-data-store/sdk-runtime-state-db.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@machinemetrics/mm-erp-sdk",
   "description": "A library for syncing data between MachineMetrics and ERP systems",
-  "version": "0.9.5",
+  "version": "0.9.6-beta.1",
   "license": "MIT",
   "author": "machinemetrics",
   "main": "dist/index.js",
@@ -19,7 +19,8 @@
     "start": "tsc --project tsconfig.build.json --watch",
     "type-check": "tsc --noEmit",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:concurrency": "RUN_STATE_CONCURRENCY_IT=1 vitest run test/concurrency"
   },
   "dependencies": {
     "@azure/msal-node": "^2.12.0",
@@ -44,6 +45,8 @@
     "odbc": "^2.4.8"
   },
   "devDependencies": {
+    "@rollup/rollup-linux-x64-gnu": "^4.62.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/json-stable-stringify": "^1.1.0",
     "@types/lodash": "^4.17.10",
     "@types/luxon": "^3.7.1",

package/src/migrations/20260617160000_create_sdk_runtime_state_table.ts

@@ -0,0 +1,13 @@
+import type { Knex } from "knex";
+
+export async function up(knex: Knex): Promise<void> {
+  await knex.schema.createTable("sdk_runtime_state", (table) => {
+    table.string("key").primary();
+    table.text("value").notNullable();
+    table.string("updated_at").notNullable();
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  await knex.schema.dropTable("sdk_runtime_state");
+}

package/src/services/mm-api-service/company-info.ts

@@ -1,10 +1,9 @@
 /**
  * Company info from MM (`/accounts/current`) is loaded during SDK startup
  * (`ApplicationInitializer.initialize` → {@link ensureCompanyInfo}), written to shared
- * job-state, and read by synchronous {@link getCachedCompanyInfo} and related getters.
+ * SQLite runtime state, and read by synchronous {@link getCachedCompanyInfo} and related getters.
  *
- * Persisted data is scoped to whatever filesystem sees the job-state file (default under `/tmp`):
- * e.g. one container’s filesystem unless that path is mounted shared. Company fields are treated
+ * Persisted data lives in `sdk_runtime_state` (same SQLite file as `SQLITE_DB_PATH`). Company fields are treated
  * as stable for the deployment; refreshing them if MM changes is the SDK’s responsibility when we
  * add that behavior—not connector boilerplate.
  *
@@ -49,7 +48,7 @@ function hydrateCacheFromDiskIfPresent(): CompanyInfo | null {
 }
 
 /**
- * Resolves company info for synchronous readers: in-memory, then persisted job-state.
+ * Resolves company info for synchronous readers: in-memory, then persisted SQLite runtime state.
  * @throws Error if neither is available (initialization / API fetch has not populated data).
  */
 function resolveCompanyInfoOrThrow(): CompanyInfo {
@@ -61,7 +60,7 @@ function resolveCompanyInfoOrThrow(): CompanyInfo {
     return fromDisk;
   }
   throw new Error(
-    "Company info is not available: run ApplicationInitializer.initialize() or ensureCompanyInfo() in a process with API access, or ensure job-state.json contains companyInfo from a prior fetch"
+    "Company info is not available: run ApplicationInitializer.initialize() or ensureCompanyInfo() in a process with API access, or ensure sdk_runtime_state contains companyInfo from a prior fetch"
   );
 }
 

package/src/services/mm-api-service/token-mgr.ts

@@ -8,7 +8,7 @@ import { logger } from "../reporting-service/index.js";
 
 /**
  * Manages the MM API token with caching and expiration checking
- * Tokens are cached across jobs and job instances in local-data-store/jobs-shared-data.ts
+ * Tokens are cached across jobs and job instances in SQLite runtime state (jobs-shared-data.ts).
  * @jest-environment node
  */
 export class MMTokenManager {

package/src/utils/application-initializer.ts

@@ -33,7 +33,7 @@ export class ApplicationInitializer {
       await ApplicationInitializer.runMigrations();
       logger.info("Database migrations completed successfully");
 
-      // Loads company info from MM into memory + job-state (timezone, locationRef, companyId).
+      // Loads company info from MM into memory + SQLite runtime state (timezone, locationRef, companyId).
       // Retries until success; failure aborts init. Confirms the MM API token works for /accounts/current.
       await ensureCompanyInfo();
 

package/src/utils/local-data-store/database-lock.ts

@@ -1,7 +1,10 @@
 import {
-  readDatabaseLockState,
-  writeDatabaseLockState,
-} from "./jobs-shared-data.js";
+  getRuntimeStateJson,
+  setRuntimeStateJson,
+  withImmediateTransaction,
+} from "./sdk-runtime-state-db.js";
+
+const DATABASE_LOCK_KEY = "databaseLock";
 
 interface DatabaseLock {
   isLocked: boolean;
@@ -9,19 +12,22 @@ interface DatabaseLock {
   lockedAt: string | null;
 }
 
+const defaultLock = (): DatabaseLock => ({
+  isLocked: false,
+  lockedBy: "",
+  lockedAt: null,
+});
+
+function readLock(): DatabaseLock {
+  return getRuntimeStateJson<DatabaseLock>(DATABASE_LOCK_KEY) ?? defaultLock();
+}
+
 /**
  * Gets the current database lock state
  * @returns The current database lock state
  */
 export const getDatabaseLock = (): DatabaseLock => {
-  const data = readDatabaseLockState();
-  return (
-    (data.databaseLock as DatabaseLock) ?? {
-      isLocked: false,
-      lockedBy: "",
-      lockedAt: null,
-    }
-  );
+  return readLock();
 };
 
 /**
@@ -30,24 +36,19 @@ export const getDatabaseLock = (): DatabaseLock => {
  * @returns true if lock was acquired, false if database is already locked
  */
 export const acquireDatabaseLock = (processName: string): boolean => {
-  const data = readDatabaseLockState();
-  const currentLock = (data.databaseLock as DatabaseLock) ?? {
-    isLocked: false,
-    lockedBy: "",
-    lockedAt: null,
-  };
-
-  if (currentLock.isLocked) {
-    return false;
-  }
+  return withImmediateTransaction(() => {
+    const currentLock = readLock();
+    if (currentLock.isLocked) {
+      return false;
+    }
 
-  data.databaseLock = {
-    isLocked: true,
-    lockedBy: processName,
-    lockedAt: new Date().toISOString(),
-  };
-  writeDatabaseLockState(data);
-  return true;
+    setRuntimeStateJson(DATABASE_LOCK_KEY, {
+      isLocked: true,
+      lockedBy: processName,
+      lockedAt: new Date().toISOString(),
+    });
+    return true;
+  });
 };
 
 /**
@@ -56,24 +57,15 @@ export const acquireDatabaseLock = (processName: string): boolean => {
  * @returns true if lock was released, false if process doesn't own the lock
  */
 export const releaseDatabaseLock = (processName: string): boolean => {
-  const data = readDatabaseLockState();
-  const currentLock = (data.databaseLock as DatabaseLock) ?? {
-    isLocked: false,
-    lockedBy: "",
-    lockedAt: null,
-  };
-
-  if (!currentLock.isLocked || currentLock.lockedBy !== processName) {
-    return false;
-  }
+  return withImmediateTransaction(() => {
+    const currentLock = readLock();
+    if (!currentLock.isLocked || currentLock.lockedBy !== processName) {
+      return false;
+    }
 
-  data.databaseLock = {
-    isLocked: false,
-    lockedBy: "",
-    lockedAt: null,
-  };
-  writeDatabaseLockState(data);
-  return true;
+    setRuntimeStateJson(DATABASE_LOCK_KEY, defaultLock());
+    return true;
+  });
 };
 
 /**
@@ -81,6 +73,5 @@ export const releaseDatabaseLock = (processName: string): boolean => {
  * @returns true if database is available, false if locked
  */
 export const isDatabaseAvailable = (): boolean => {
-  const lock = getDatabaseLock();
-  return !lock.isLocked;
+  return !readLock().isLocked;
 };

package/src/utils/local-data-store/jobs-shared-data.ts

@@ -1,16 +1,18 @@
-import fs from "fs";
-import path from "path";
-import { mkdirSync } from "fs";
 import type { CompanyInfo } from "../../services/mm-api-service/company-info.js";
+import {
+  getRuntimeStateJson,
+  setRuntimeStateJson,
+} from "./sdk-runtime-state-db.js";
 
 /**
- * This file contains the logic for storing and retrieving data from the job state file.
- * It is used to store data that is shared between jobs, and (more importantly) across job instances.
- * Company info (timezone, locationRef, companyId) is persisted here so processes that share this
- * file path (same host /tmp, or a shared volume) can read it after SDK init; offset is not stored.
+ * Cross-process runtime state shared between Bree workers (company info, token cache,
+ * initial-load flag). Stored in SQLite (`sdk_runtime_state`) keyed by SQLITE_DB_PATH so
+ * each key is updated independently under WAL — no whole-file read-modify-write races.
  */
 
 const COMPANY_INFO_STORAGE_KEY = "companyInfo";
+const INITIAL_LOAD_COMPLETE_KEY = "initialLoadComplete";
+const MM_API_TOKEN_KEY = "mmApiToken";
 
 function isPersistedCompanyInfo(value: unknown): value is CompanyInfo {
   if (!value || typeof value !== "object") {
@@ -25,86 +27,27 @@ function isPersistedCompanyInfo(value: unknown): value is CompanyInfo {
   );
 }
 
-const STORAGE_FILE = path.join("/tmp", "job-state.json");
-
-// Ensure parent directory exists
-const parentDir = path.dirname(STORAGE_FILE);
-try {
-  mkdirSync(parentDir, { recursive: true });
-} catch (error) {
-  if ((error as NodeJS.ErrnoException).code !== "EEXIST") {
-    throw error;
-  }
-}
-
-//#region Non-exported functions
-const ensureStorageFile = () => {
-  if (!fs.existsSync(STORAGE_FILE)) {
-    fs.writeFileSync(STORAGE_FILE, JSON.stringify({}), "utf-8");
-  }
-};
-
-const readStorage = (): Record<string, unknown> => {
-  ensureStorageFile();
-  try {
-    return JSON.parse(fs.readFileSync(STORAGE_FILE, "utf-8"));
-  } catch (error) {
-    console.error(`Failed to read storage from ${STORAGE_FILE}:`, error);
-    return {};
-  }
-};
-
-const writeStorage = (data: Record<string, unknown>): void => {
-  ensureStorageFile();
-  fs.writeFileSync(STORAGE_FILE, JSON.stringify(data, null, 2), "utf-8");
-};
-//#endregion
-
 /**
  * Reads company info written by initialization (or a prior API fetch) for use across processes.
  */
 export const readPersistedCompanyInfo = (): CompanyInfo | null => {
-  const data = readStorage();
-  const raw = data[COMPANY_INFO_STORAGE_KEY];
+  const raw = getRuntimeStateJson<unknown>(COMPANY_INFO_STORAGE_KEY);
   return isPersistedCompanyInfo(raw) ? raw : null;
 };
 
 /**
- * Persists company info for other processes on the same host (same job-state file).
+ * Persists company info for other processes sharing the same SQLite database file.
  */
 export const writePersistedCompanyInfo = (info: CompanyInfo): void => {
-  const data = readStorage();
-  data[COMPANY_INFO_STORAGE_KEY] = info;
-  writeStorage(data);
-};
-
-//#region Database lock storage functions
-/**
- * Reads the database lock state from the shared storage file
- * @returns The data stored in the file
- */
-export const readDatabaseLockState = (): Record<string, unknown> => {
-  return readStorage();
-};
-
-/**
- * Writes the database lock state to the shared storage file
- * @param data The lock state data to write
- */
-export const writeDatabaseLockState = (data: Record<string, unknown>): void => {
-  writeStorage(data);
+  setRuntimeStateJson(COMPANY_INFO_STORAGE_KEY, info);
 };
-//#endregion
 
 export const getInitialLoadComplete = (): boolean => {
-  const data = readStorage();
-  return (data.initialLoadComplete as boolean) ?? false;
+  return getRuntimeStateJson<boolean>(INITIAL_LOAD_COMPLETE_KEY) ?? false;
 };
 
 export const setInitialLoadComplete = (complete: boolean): void => {
-  const data = readStorage();
-  data.initialLoadComplete = complete;
-  writeStorage(data);
+  setRuntimeStateJson(INITIAL_LOAD_COMPLETE_KEY, complete);
 };
 
 interface CachedToken {
@@ -117,8 +60,7 @@ interface CachedToken {
  * @returns The cached token and expiration or null if not found
  */
 export const getCachedMMToken = (): CachedToken | null => {
-  const data = readStorage();
-  return (data.mmApiToken as CachedToken) ?? null;
+  return getRuntimeStateJson<CachedToken>(MM_API_TOKEN_KEY);
 };
 
 /**
@@ -126,7 +68,5 @@ export const getCachedMMToken = (): CachedToken | null => {
  * @param tokenData The token and expiration to cache
  */
 export const setCachedMMToken = (tokenData: CachedToken): void => {
-  const data = readStorage();
-  data.mmApiToken = tokenData;
-  writeStorage(data);
+  setRuntimeStateJson(MM_API_TOKEN_KEY, tokenData);
 };

package/src/utils/local-data-store/sdk-runtime-state-db.test.ts

@@ -0,0 +1,106 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import {
+  getRuntimeStateJson,
+  resetRuntimeStateDbForTests,
+} from "./sdk-runtime-state-db.js";
+
+const LEGACY_JOB_STATE_FILE = path.join("/tmp", "job-state.json");
+
+function mockLegacyFileExists(exists: boolean): void {
+  const realExistsSync = fs.existsSync.bind(fs);
+  vi.spyOn(fs, "existsSync").mockImplementation((filePath) => {
+    if (path.resolve(String(filePath)) === LEGACY_JOB_STATE_FILE) {
+      return exists;
+    }
+    return realExistsSync(filePath);
+  });
+}
+
+function mockLegacyFileContents(contents: string): void {
+  mockLegacyFileExists(true);
+  const realReadFileSync = fs.readFileSync.bind(fs);
+  vi.spyOn(fs, "readFileSync").mockImplementation((filePath, encoding) => {
+    if (path.resolve(String(filePath)) === LEGACY_JOB_STATE_FILE) {
+      return contents;
+    }
+    return realReadFileSync(filePath, encoding);
+  });
+}
+
+describe("sdk-runtime-state-db legacy import", () => {
+  let sqlitePath: string;
+
+  beforeEach(() => {
+    sqlitePath = path.join(
+      os.tmpdir(),
+      `sdk-runtime-state-${process.pid}-${Date.now()}.sqlite3`
+    );
+    process.env.SQLITE_DB_PATH = sqlitePath;
+    resetRuntimeStateDbForTests();
+  });
+
+  afterEach(() => {
+    resetRuntimeStateDbForTests();
+    delete process.env.SQLITE_DB_PATH;
+    for (const suffix of ["", "-wal", "-shm"]) {
+      try {
+        fs.rmSync(`${sqlitePath}${suffix}`);
+      } catch {
+        // ignore
+      }
+    }
+    vi.restoreAllMocks();
+  });
+
+  it("marks import complete when the legacy file is absent", () => {
+    mockLegacyFileExists(false);
+
+    getRuntimeStateJson("companyInfo");
+
+    expect(getRuntimeStateJson<boolean>("_legacyJobStateImported")).toBe(true);
+    expect(getRuntimeStateJson("companyInfo")).toBeNull();
+  });
+
+  it("imports legacy keys when the legacy file is valid", () => {
+    mockLegacyFileContents(
+      JSON.stringify({
+        companyInfo: { timezone: "US/Central" },
+        mmApiToken: { token: "abc", expiresAt: "2099-01-01T00:00:00.000Z" },
+        initialLoadComplete: true,
+        databaseLock: { holder: "worker-1" },
+      })
+    );
+
+    expect(getRuntimeStateJson<{ timezone: string }>("companyInfo")).toEqual({
+      timezone: "US/Central",
+    });
+    expect(getRuntimeStateJson<{ token: string }>("mmApiToken")).toEqual({
+      token: "abc",
+      expiresAt: "2099-01-01T00:00:00.000Z",
+    });
+    expect(getRuntimeStateJson<boolean>("initialLoadComplete")).toBe(true);
+    expect(getRuntimeStateJson<{ holder: string }>("databaseLock")).toEqual({
+      holder: "worker-1",
+    });
+    expect(getRuntimeStateJson<boolean>("_legacyJobStateImported")).toBe(true);
+  });
+
+  it("fails fast on corrupt legacy JSON and retries import on next access", () => {
+    mockLegacyFileContents("{ invalid json");
+
+    expect(() => getRuntimeStateJson("companyInfo")).toThrow(SyntaxError);
+
+    vi.restoreAllMocks();
+    mockLegacyFileContents(
+      JSON.stringify({ companyInfo: { timezone: "US/Eastern" } })
+    );
+
+    expect(getRuntimeStateJson<{ timezone: string }>("companyInfo")).toEqual({
+      timezone: "US/Eastern",
+    });
+    expect(getRuntimeStateJson<boolean>("_legacyJobStateImported")).toBe(true);
+  });
+});

package/src/utils/local-data-store/sdk-runtime-state-db.ts

@@ -0,0 +1,141 @@
+import fs from "fs";
+import path from "path";
+import Database from "better-sqlite3";
+
+const TABLE = "sdk_runtime_state";
+const LEGACY_JOB_STATE_FILE = path.join("/tmp", "job-state.json");
+const LEGACY_IMPORT_FLAG_KEY = "_legacyJobStateImported";
+
+let db: Database.Database | null = null;
+
+function dbPath(): string {
+  return process.env.SQLITE_DB_PATH || "./local.sqlite3";
+}
+
+function ensureDbDirectory(filename: string): void {
+  const parentDir = path.dirname(path.resolve(filename));
+  try {
+    fs.mkdirSync(parentDir, { recursive: true });
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code !== "EEXIST") {
+      throw error;
+    }
+  }
+}
+
+function getDb(): Database.Database {
+  if (!db) {
+    const filename = dbPath();
+    ensureDbDirectory(filename);
+    const instance = new Database(filename);
+    instance.pragma("journal_mode = WAL");
+    instance.pragma("busy_timeout = 5000");
+    instance.exec(`
+      CREATE TABLE IF NOT EXISTS ${TABLE} (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `);
+    db = instance;
+    try {
+      importLegacyJobStateFileOnce();
+    } catch (error) {
+      instance.close();
+      db = null;
+      throw error;
+    }
+  }
+  return db;
+}
+
+function readRaw(key: string): string | null {
+  const row = getDb()
+    .prepare(`SELECT value FROM ${TABLE} WHERE key = ?`)
+    .get(key) as { value: string } | undefined;
+  return row?.value ?? null;
+}
+
+function writeRaw(key: string, value: string): void {
+  const updatedAt = new Date().toISOString();
+  getDb()
+    .prepare(
+      `INSERT INTO ${TABLE} (key, value, updated_at) VALUES (?, ?, ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`
+    )
+    .run(key, value, updatedAt);
+}
+
+function importLegacyJobStateFileOnce(): void {
+  if (readRaw(LEGACY_IMPORT_FLAG_KEY)) {
+    return;
+  }
+
+  if (fs.existsSync(LEGACY_JOB_STATE_FILE)) {
+    const raw = fs.readFileSync(LEGACY_JOB_STATE_FILE, "utf-8");
+    const data = JSON.parse(raw) as Record<string, unknown>;
+
+    if (data.companyInfo && !readRaw("companyInfo")) {
+      writeRaw("companyInfo", JSON.stringify(data.companyInfo));
+    }
+    if (data.mmApiToken && !readRaw("mmApiToken")) {
+      writeRaw("mmApiToken", JSON.stringify(data.mmApiToken));
+    }
+    if (
+      data.initialLoadComplete !== undefined &&
+      !readRaw("initialLoadComplete")
+    ) {
+      writeRaw(
+        "initialLoadComplete",
+        JSON.stringify(data.initialLoadComplete)
+      );
+    }
+    if (data.databaseLock && !readRaw("databaseLock")) {
+      writeRaw("databaseLock", JSON.stringify(data.databaseLock));
+    }
+  }
+
+  writeRaw(LEGACY_IMPORT_FLAG_KEY, JSON.stringify(true));
+}
+
+/**
+ * Reads a JSON value for `key`, or null when unset.
+ */
+export function getRuntimeStateJson<T>(key: string): T | null {
+  const raw = readRaw(key);
+  if (raw === null) {
+    return null;
+  }
+  return JSON.parse(raw) as T;
+}
+
+/**
+ * Upserts a JSON-serializable value for `key` without touching other keys.
+ */
+export function setRuntimeStateJson(key: string, value: unknown): void {
+  writeRaw(key, JSON.stringify(value));
+}
+
+/**
+ * Runs `fn` inside BEGIN IMMEDIATE so cross-process writers serialize safely.
+ */
+export function withImmediateTransaction<T>(fn: () => T): T {
+  const database = getDb();
+  database.prepare("BEGIN IMMEDIATE").run();
+  try {
+    const result = fn();
+    database.prepare("COMMIT").run();
+    return result;
+  } catch (error) {
+    database.prepare("ROLLBACK").run();
+    throw error;
+  }
+}
+
+/** Visible for integration tests that need an isolated database file. */
+export function resetRuntimeStateDbForTests(): void {
+  if (db) {
+    db.close();
+    db = null;
+  }
+}