@persistica/flux-agent 0.0.2 → 0.0.6

package/README.md

@@ -0,0 +1,22 @@
+# Flux Agent
+
+```TypeScript
+import { FluxAgent, FluxAgentNetworkConnection } from '@persistica/flux-agent';
+
+const NETWORK_ID = 'network-id-to-connect-to';
+
+const fluxAgent = new FluxAgent(NETWORK_ID);
+
+// * Connect to network
+const fluxNetworkConnection: FluxAgentNetworkConnection = await fluxAgent
+    .connect(
+        'CODE_TO_ACCESS_NETWORK',
+    );
+
+console.log(`✅ Agent connected to network ID: '${NETWORK_ID}'`);
+
+// * Join network channel
+const fluxConnectedAgentNetworkChannel: FluxNetworkChannel = await fluxNetworkConnection
+    .joinChannel('connected-agents');
+
+```

package/{index.cjs → index.js}

@@ -1,29 +1,3 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// packages/flux/agent/src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  FluxAgent: () => FluxAgent
-});
-module.exports = __toCommonJS(index_exports);
-
 // libs/flux/shared/types/src/lib/channel.type.ts
 var validateChannelNameOrThrow = (channelName) => {
   if (channelName.includes(":")) {
@@ -57,6 +31,7 @@ var SUBSCRIBED_NETWORK_CHANNEL_NAME = "subscribed-to-nc-name";
 var UNSUBSCRIBE_NETWORK_CHANNEL_NAME = "unsubscribe-nc-name";
 var AUTHORITY_CHANNEL_SUBSCRIBE = "acs";
 var AUTHORITY_DISCONNECT_AGENT = "ada";
+var ERROR = "e";
 
 // libs/flux/shared/types/src/lib/client.type.ts
 var validateAgentUIDOrThrow = (clientOwnUID) => {
@@ -72,6 +47,32 @@ var validateAgentUIDOrThrow = (clientOwnUID) => {
   return true;
 };
 
+// libs/flux/shared/types/src/lib/network.type.ts
+var validateNetworkIdOrThrow = (networkId) => {
+  if (typeof networkId !== "string") {
+    throw new Error("Network ID must be a string");
+  }
+  if (networkId === "") {
+    throw new Error("Network ID cannot be empty");
+  }
+  if (networkId === "undefined" || networkId === "null") {
+    throw new Error('Network ID cannot be "null" or "undefined"');
+  }
+  if (networkId.includes(":")) {
+    throw new Error("Network ID cannot contain :");
+  }
+  if (networkId.includes("/")) {
+    throw new Error("Network ID cannot contain /");
+  }
+  if (!/^[A-Za-z0-9-]+$/.test(networkId)) {
+    throw new Error("Network ID can only contain letters, numbers and dashes ('-')");
+  }
+  if (networkId.length > 100) {
+    throw new Error("Network ID cannot be longer than 100 characters");
+  }
+  return true;
+};
+
 // libs/flux/shared/ws/src/lib/rpc/rpc-server.class.ts
 var RPCServer = class {
   methods = /* @__PURE__ */ new Map();
@@ -811,6 +812,9 @@ var FluxWebSocketConnection = class {
         break;
       }
       default:
+        if (message_.startsWith(`${ERROR}:`)) {
+          throw new Error(message_.substring(message_.indexOf(":") + 1) ?? "Unknown error");
+        }
         PicoLogger.log(`\u{1F50C} Unhandled type: "${message_}"`, "ws-client");
         break;
     }
@@ -818,7 +822,7 @@ var FluxWebSocketConnection = class {
 };
 
 // packages/flux/agent/src/lib/flux-agent.class.ts
-var import_nanoid = require("nanoid");
+import { nanoid } from "nanoid";
 
 // packages/flux/agent/src/lib/utils/obscuring/shared.utils.ts
 var ALGORITHM = { name: "AES-GCM", length: 256 };
@@ -1029,8 +1033,9 @@ var FluxAgent = class {
   constructor(networkId, options) {
     this.networkId = networkId;
     this.options = options;
+    validateNetworkIdOrThrow(this.networkId);
   }
-  id = (0, import_nanoid.nanoid)();
+  id = nanoid();
   fluxWebSocketConnection;
   fluxClientData = new FluxClientData();
   stateManager = new StateManager();
@@ -1093,7 +1098,6 @@ var FluxAgent = class {
     this.fluxClientData.onMessage(cb);
   }
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   FluxAgent
-});
+};

package/package.json

@@ -1,27 +1,23 @@
 {
-  "name": "@persistica/flux-agent",
-  "version": "0.0.2",
-  "description": "Persistica Flux Agent",
-  "type": "module",
-  "keywords": [],
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "./index.cjs",
-  "types": "./index.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/rujorgensen/persistica.git"
-  },
-  "author": "pixl.prophet",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/rujorgensen/persistica/issues"
-  },
-  "homepage": "https://github.com/rujorgensen/persistica#readme",
-  "dependencies": {
-    "nanoid": "5.1.5"
-  },
-  "packageManager": "bun@1.2.20",
-  "module": "./index.js"
+    "name": "@persistica/flux-agent",
+    "version": "0.0.6",
+    "description": "Persistica Flux Agent",
+    "type": "module",
+    "keywords": [],
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": "./index.js",
+    "main": "./index.js",
+    "types": "./src/index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/rujorgensen/persistica.git"
+    },
+    "author": "pixl.prophet",
+    "license": "ISC",
+    "bugs": {
+        "url": "https://github.com/rujorgensen/persistica/issues"
+    },
+    "homepage": "https://github.com/rujorgensen/persistica#readme"
 }