@peers-app/peers-sdk 0.29.0 → 0.29.1

package/dist/contracts/system/packages-contract.d.ts

@@ -8,7 +8,10 @@ export declare const PACKAGES_CONTRACT_VERSION = 1;
 export interface IPackagesHostCapabilities {
     /** The host can read package folders: import, create, clone, and reload from disk. */
     fileSystem: boolean;
-    /** The host can create and link a remote repository (`linkRemoteRepo`). */
+    /**
+     * The host can create and link a remote repository (`linkRemoteRepo` without a URL). Recording
+     * a given URL needs no host tooling.
+     */
     linkRemote: boolean;
     /** The host can install the default packages into a context (`installDefaultPackages`). */
     installDefaults: boolean;
@@ -172,6 +175,14 @@ export declare function packageVersionPromotionTargets(versionTag: string | unde
  * @param target - Input as typed.
  */
 export declare function isPackageRepositoryUrl(target: string): boolean;
+/**
+ * Whether a URL may be recorded as a package's source (`Packages.remoteRepo`) by
+ * `linkRemoteRepo`: an `https://` or `http://` URL, a `git@host:` remote, or a Git package
+ * remote, `peers://<groupId>/<repoId>`. No whitespace; at most 2,048 characters.
+ *
+ * @param url - The URL to record.
+ */
+export declare function isPackageSourceUrl(url: string): boolean;
 /** Typed consumer proxy for System Packages v1. */
 export interface IPackagesConsumer extends IContractConsumerBase {
     tools: {
@@ -223,9 +234,14 @@ export interface IPackagesConsumer extends IContractConsumerBase {
         }): Promise<IPackageOperationResult>;
         /** Re-read every package folder on this device and reload packages whose bundles changed. */
         reloadAllPackages(): Promise<IReloadAllPackagesResult>;
-        /** Create and link a remote repository for a local package. */
+        /**
+         * Record a package's source repository. With `remoteRepo` (see {@link isPackageSourceUrl}),
+         * record that URL; otherwise create a remote repository with the host's tooling and link it.
+         * A package that already has a source keeps it and the result carries a warning.
+         */
         linkRemoteRepo(input: {
             packageId: string;
+            remoteRepo?: string;
         }): Promise<IPackageOperationResult>;
         /** Remove a package from the group and unload it here. */
         uninstallPackage(input: {

package/dist/contracts/system/packages-contract.js

@@ -4,6 +4,7 @@ exports.PACKAGES_CONTRACT_VERSION = void 0;
 exports.packageGroupVersionWarning = packageGroupVersionWarning;
 exports.packageVersionPromotionTargets = packageVersionPromotionTargets;
 exports.isPackageRepositoryUrl = isPackageRepositoryUrl;
+exports.isPackageSourceUrl = isPackageSourceUrl;
 exports.getPackagesContractDefinition = getPackagesContractDefinition;
 const system_ids_1 = require("../../system-ids");
 const field_type_1 = require("../../types/field-type");
@@ -43,6 +44,29 @@ function packageVersionPromotionTargets(versionTag) {
 function isPackageRepositoryUrl(target) {
     return /^(https?:\/\/|git@[^:/\s]+:)/.test(target.trim());
 }
+/**
+ * Whether a URL may be recorded as a package's source (`Packages.remoteRepo`) by
+ * `linkRemoteRepo`: an `https://` or `http://` URL, a `git@host:` remote, or a Git package
+ * remote, `peers://<groupId>/<repoId>`. No whitespace; at most 2,048 characters.
+ *
+ * @param url - The URL to record.
+ */
+function isPackageSourceUrl(url) {
+    if (url.length > 2048 || /\s|\p{Cc}/u.test(url))
+        return false;
+    if (/^peers:\/\/[A-Za-z0-9]{25}\/[A-Za-z0-9]{25}$/.test(url))
+        return true;
+    if (/^git@[^:/\\]+:.+$/.test(url))
+        return true;
+    if (!/^https?:\/\//.test(url) || url.includes("\\"))
+        return false;
+    try {
+        return !!new URL(url).hostname;
+    }
+    catch {
+        return false;
+    }
+}
 const field = (name, type, description, opts = {}) => ({ name, type, description, ...opts });
 const packageIdField = field("packageId", field_type_1.FieldType.id, "Package id.");
 const operationResultFields = [
@@ -162,8 +186,11 @@ function getPackagesContractDefinition() {
             },
             {
                 name: "linkRemoteRepo",
-                usageDescription: "Create a remote repository for a local package and link it.",
-                inputFields: [packageIdField],
+                usageDescription: "Record a package's source repository: the given URL, or one created with the host's tooling. A package that already has a source keeps it.",
+                inputFields: [
+                    packageIdField,
+                    field("remoteRepo", field_type_1.FieldType.string, "Record this URL (https://, git@host:, or a Git package peers:// URL) instead of creating a repository.", { optional: true }),
+                ],
                 outputFields: operationResultFields,
             },
             {

package/dist/device/binary-peer-connection-v2.js

@@ -330,11 +330,9 @@ function createBinaryPeerSocket(connectionId, peer, protocol = "binary", receive
     }
     // ─── Drain / Backpressure ────────────────────────────────────────
     // Single persistent drain handler to avoid leaking listeners
-    let drainResolve = null;
+    const drainWaiters = new Set();
     peer.on("drain", () => {
-        if (drainResolve) {
-            const resolve = drainResolve;
-            drainResolve = null;
+        for (const resolve of drainWaiters) {
             resolve();
         }
     });
@@ -351,15 +349,18 @@ function createBinaryPeerSocket(connectionId, peer, protocol = "binary", receive
         // Backpressure: wait for buffer to drain before sending more
         while ((peer.getBufferedAmount?.() ?? 0) > config.highWaterMark) {
             await new Promise((resolve) => {
-                drainResolve = resolve;
+                const resume = () => {
+                    clearInterval(timer);
+                    drainWaiters.delete(resume);
+                    resolve();
+                };
                 // Also poll as fallback (drain event might not fire on all transports)
                 const timer = setInterval(() => {
                     if ((peer.getBufferedAmount?.() ?? 0) <= config.lowWaterMark) {
-                        clearInterval(timer);
-                        drainResolve = null;
-                        resolve();
+                        resume();
                     }
                 }, 5);
+                drainWaiters.add(resume);
             });
         }
         // A retired cipher must not fall back to a clear frame; the peer would close

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-sdk",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-sdk.git"