@hasna/connectors 1.4.4 → 1.4.5

package/dist/lib/paths.d.ts

@@ -0,0 +1,28 @@
+/** The effective user home, mirroring the pre-existing connectors resolution (`HOME` || `USERPROFILE` || `os.homedir()`). Read at call time. */
+export declare function effectiveHome(): string;
+/** Pre-XDG default home: `~/.hasna/connectors`. */
+export declare function legacyHomeDir(): string;
+/**
+ * The @hasna/paths-resolved data home for connectors (XDG / macOS home
+ * layout). The home override mirrors the pre-existing `$HOME`-first
+ * resolution so the resolver follows the same home the legacy path does.
+ */
+export declare function resolverHome(): string;
+/**
+ * Whether the resolver (XDG) data home should be adopted as the store home.
+ * The resolver home is adopted only when the operator has set `HASNA_DATA_HOME`
+ * (the data-kind override — a deliberate opt-in to the XDG layout) or the store
+ * has already been physically migrated there (`connectors.db` exists). A machine
+ * that only redirects another kind (e.g. cache to tmpfs) must NOT have its data
+ * home moved, and a live store at the legacy home must never become invisible
+ * on upgrade.
+ */
+export declare function adoptResolverHome(resolved: string, env?: NodeJS.ProcessEnv): boolean;
+/** The exact-app override root, when set: `HASNA_CONNECTORS_DIR`. */
+export declare function exactConnectorsHome(): string | undefined;
+/**
+ * Effective connectors home: the exact-app override (`HASNA_CONNECTORS_DIR`)
+ * wins unconditionally; otherwise the resolver (XDG) data home once adopted;
+ * otherwise the legacy `~/.hasna/connectors` default.
+ */
+export declare function connectorsHome(): string;

package/dist/lib/paths.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {
@@ -72,6 +72,7 @@
   },
   "dependencies": {
     "@hasna/events": "0.1.8",
+    "@hasna/paths": "0.1.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",