@relkit/providers-local 0.0.0

package/dist/state.js

@@ -0,0 +1,69 @@
+import { randomUUID } from "node:crypto";
+import { lstatSync, mkdirSync, renameSync } from "node:fs";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
+const DEFAULT_STATE_ROOT = join(".relkit", "state");
+export class LocalProviderStateError extends Error {
+    code = "RELKIT_LOCAL_PROVIDER_STATE_INVALID";
+    constructor(message = "Local provider state root is invalid") {
+        super(message);
+        this.name = "LocalProviderStateError";
+    }
+}
+/** Owns the capability directories used by one local provider generation. */
+export function createLocalProviderStateRoot(requestedRoot) {
+    if (requestedRoot !== undefined && requestedRoot.trim() === "") {
+        throw new LocalProviderStateError("State root must not be empty");
+    }
+    const root = resolve(requestedRoot ?? join(process.cwd(), DEFAULT_STATE_ROOT));
+    if (root === resolve("/"))
+        throw new LocalProviderStateError("State root is too broad");
+    ensureDirectory(root);
+    const buckets = join(root, "buckets");
+    const cache = join(root, "cache");
+    ensureDirectory(buckets);
+    ensureDirectory(cache);
+    return Object.freeze({ root, buckets, cache });
+}
+/** Moves malformed provider state aside so a later startup can continue safely. */
+export function quarantineStateFile(file, ownerRoot) {
+    const path = resolve(file);
+    const root = resolve(ownerRoot);
+    const relation = relative(root, path);
+    if (relation === "" || relation.startsWith("..") || isAbsolute(relation)) {
+        throw new LocalProviderStateError("State quarantine path escapes its owner");
+    }
+    const quarantine = join(root, ".relkit-quarantine");
+    ensureDirectory(quarantine);
+    const target = join(quarantine, `${basename(path)}.${randomUUID()}.bad`);
+    try {
+        renameSync(path, target);
+    }
+    catch {
+        throw new LocalProviderStateError("Malformed provider state could not be quarantined");
+    }
+    return target;
+}
+export function ensureOwnedDirectory(path) {
+    const resolved = resolve(path);
+    ensureDirectory(resolved);
+    return resolved;
+}
+function ensureDirectory(path) {
+    try {
+        const info = lstatSync(path);
+        if (!info.isDirectory() || info.isSymbolicLink()) {
+            throw new LocalProviderStateError("Provider state path is not a real directory");
+        }
+    }
+    catch (cause) {
+        if (cause.code !== "ENOENT")
+            throw cause;
+        try {
+            mkdirSync(path, { recursive: true, mode: 0o700 });
+        }
+        catch {
+            throw new LocalProviderStateError("Provider state directory could not be created");
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@relkit/providers-local",
+  "version": "0.0.0",
+  "description": "Local runtime providers for RELKIT development and testing.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/providers-local"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@relkit/agents": "0.0.0",
+    "@relkit/app": "0.0.0",
+    "@relkit/buckets": "0.0.0",
+    "@relkit/cache": "0.0.0",
+    "@relkit/contracts": "0.0.0",
+    "@relkit/events": "0.0.0",
+    "@relkit/jobs": "0.0.0",
+    "@relkit/runtime-effect": "0.0.0",
+    "cron-parser": "5.10.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}