@compforge/harness-common 0.5.12 → 0.5.14

package/README.md

@@ -211,3 +211,20 @@ tool and an optional declared version/constraint. `Depot.bins` groups `Bin` decl
 repository-relative paths and `dependencies`, `output` or `cache` kinds. Metadata does not change
 Component identity, prove physical existence or authorize deletion. Discovery, preparation,
 usage protection and reclamation belong to consumers. See [the shared contract](../../../docs/component-depot.md).
+
+## Endpoint
+
+`Endpoint` describes a network access address: optional lowercase `scheme`, `host`, explicit
+`port`, and optional `secure`. It is independent of the Service, DataSource or resource behind
+that address. IPv6 hosts are unbracketed. Credentials, paths, query parameters, execution
+adapters and timeouts are not part of this contract.
+
+Optional `id` and `description` identify and describe the dependency within its consumer.
+Optional `workload` names the consumer Workload from which the address is accessed, not the
+remote Service. Consumers resolve and validate that reference; a declaration does not discover
+instances or grant access. Protocol probing can consume the address fields alone.
+
+`secure: true` requires encrypted transport; the protocol determines whether it uses direct
+TLS or protocol-specific negotiation. Omission makes no encryption requirement. HTTPS/WSS/TLS
+endpoints require `secure: true`. This declaration does not assert connectivity, trust-policy
+approval or authorization. Toolbox owns URL projection, validation and network probing.

package/dist/access/endpoint.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A network access address, independent of the Service, DataSource or resource behind it.
+ * @spec Endpoint contains no credentials, resource path, query or execution adapter.
+ * @spec secure requires encrypted transport; the scheme determines how it is established.
+ * It does not assert reachability, trust-policy approval or application authorization.
+ */
+export interface Endpoint {
+    /** Optional identity within the declaring consumer; not a network address. */
+    readonly id?: string;
+    /** Human-readable description; never credentials or a signed resource URL. */
+    readonly description?: string;
+    /** Canonical consumer Workload name, not the remote Service or destination workload. */
+    readonly workload?: string;
+    /** Lowercase URI scheme without a colon; protocol metadata, not a health assertion. */
+    readonly scheme?: string;
+    /** Hostname or IP literal; IPv6 literals have no surrounding brackets. */
+    readonly host: string;
+    readonly port: number;
+    /** Omission makes no encryption requirement; HTTPS/WSS/TLS endpoints require true. */
+    readonly secure?: boolean;
+}

package/dist/access/endpoint.js

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

package/dist/index.d.ts

@@ -22,3 +22,4 @@ export * from "./system/resource.js";
 export * from "./json.js";
 export * from "./summary.js";
 export * from "./value.js";
+export type { Endpoint } from "./access/endpoint.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-common",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "description": "Execution-neutral client lifecycle and datasource contracts for harnesses",
   "type": "module",
   "scripts": {