@solongate/proxy 0.48.0 → 0.49.0

package/dist/sync.d.ts

@@ -0,0 +1,82 @@
+import type { PolicySet } from './core/index.js';
+export interface PolicySyncOptions {
+    /** Absolute path to local policy JSON file (null if cloud-only) */
+    localPath: string | null;
+    /** SolonGate API key */
+    apiKey: string;
+    /** SolonGate API URL */
+    apiUrl: string;
+    /** Polling interval in ms (default: 60000) */
+    pollIntervalMs?: number;
+    /** Called when policy is updated from either source */
+    onPolicyUpdate: (policy: PolicySet) => void;
+    /** Initial policy (the currently loaded one) */
+    initialPolicy: PolicySet;
+    /** Cloud policy ID — determines which cloud policy to push/pull */
+    policyId?: string;
+}
+/**
+ * Bidirectional policy sync between local JSON file and SolonGate Cloud.
+ *
+ * - Watches local file for changes → pushes to cloud API (using policyId from CLI)
+ * - Polls cloud API for changes → writes to local file
+ * - Version number determines which is newer (higher wins)
+ * - Loop prevention: skipNextWatch flag when writing to file
+ */
+export declare class PolicySyncManager {
+    private localPath;
+    private apiKey;
+    private apiUrl;
+    private pollIntervalMs;
+    private onPolicyUpdate;
+    private currentPolicy;
+    private localVersion;
+    private cloudVersion;
+    private lastWriteTime;
+    private debounceTimer;
+    private pollTimer;
+    private watcher;
+    private isLiveKey;
+    /** The cloud policy ID from --policy-id flag. This is the ONLY source of truth for which cloud policy to use. */
+    private policyId?;
+    constructor(opts: PolicySyncOptions);
+    /**
+     * Start watching local file and polling cloud.
+     */
+    start(): void;
+    /**
+     * Stop all watchers and timers.
+     */
+    stop(): void;
+    /**
+     * Watch local file for changes (debounced).
+     */
+    private startFileWatcher;
+    /**
+     * Handle local file change event.
+     */
+    private onFileChange;
+    /**
+     * Poll cloud for policy changes.
+     */
+    private startPolling;
+    /**
+     * Handle poll tick — fetch cloud policy and compare.
+     */
+    private onPollTick;
+    /**
+     * Push policy to cloud API.
+     * Uses this.policyId (from --policy-id CLI flag) as the cloud policy ID.
+     * Falls back to policy.id from local file only if --policy-id was not set.
+     */
+    private pushToCloud;
+    /**
+     * Write policy to local file (with loop prevention).
+     * Does NOT write the 'id' field — cloud ID is managed by --policy-id flag.
+     */
+    private writeToFile;
+    /**
+     * Compare two policies by rules content (ignoring timestamps and id).
+     */
+    private policiesEqual;
+}

package/package.json

@@ -1,20 +1,24 @@
 {
   "name": "@solongate/proxy",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "description": "AI tool security proxy — protect any AI tool server with customizable policies, path/command constraints, rate limiting, and audit logging. Zero code changes required.",
   "type": "module",
   "bin": {
     "solongate": "./dist/index.js",
     "solongate-proxy": "./dist/index.js",
     "solongate-init": "./dist/init.js",
+    "solongate-audit": "./dist/audit/index.js",
     "proxy": "./dist/index.js"
   },
   "main": "./dist/lib.js",
+  "types": "./dist/lib.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/lib.d.ts",
       "import": "./dist/lib.js"
     },
     "./cli": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
@@ -58,16 +62,16 @@
   },
   "devDependencies": {
     "@open-policy-agent/opa-wasm": "^1.10.0",
+    "chalk": "^5.3.0",
     "esbuild": "^0.19.12",
     "tsup": "^8.3.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
-    "@solongate/core": "0.5.0",
-    "@solongate/policy-engine": "0.3.1",
     "@solongate/tsconfig": "0.0.0"
   },
   "scripts": {
-    "build": "tsup && pnpm build:hooks",
+    "build": "tsup && pnpm build:types && pnpm build:hooks",
+    "build:types": "node scripts/build-types.mjs",
     "build:hooks": "node scripts/bundle-hooks.mjs",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",