@sdlcworks/components 0.0.36 → 0.0.37

package/dist/index.d.ts

@@ -245,18 +245,26 @@ export type ProviderPulumiCtx<I, S, P extends CloudProvider = CloudProvider> = {
 };
 /**
  * Context passed to the connect function.
- * Called once per app component requesting a connection.
+ * Called once per each connection being established.
  * The connect function returns handler entries that can capture this context via closure.
+ *
+ * connectorComponentName — the app component that is requesting the connection (the consumer).
+ * selfComponentName — the app component being connected TO (the dependency / the "self" of the
+ *   infra component being called). For hosting infra components (e.g. k3s) this is the specific
+ *   app component whose allocation info should be used to construct URIs.
+ *   For URL register flows, connectorComponentName is set to ANONYMOUS_CONNECTION_TYPE.
  */
 export type ConnectFnCtx<S, P extends CloudProvider = CloudProvider> = {
 	state: S;
 	getCredentials: GetCredentialsFn<P>;
-	componentName: string;
+	connectorComponentName: string;
+	selfComponentName: string;
 };
 /**
  * Reduced context passed to individual connection handlers.
  * Only contains the per-invocation essentials (connectionData, connectionType, and $).
- * Handlers access state, getCredentials, and componentName via closure from the connect function.
+ * Handlers access state, getCredentials, connectorComponentName, and selfComponentName
+ * via closure from the connect function.
  *
  * $ - Naming function for Pulumi resources created by this handler. Always use $ for resource
  * names so the orchestrator can track which resources are created by connection logic and
@@ -287,7 +295,8 @@ export type ConnectionHandlerResult<TMetadata = undefined> = {
 /**
  * A connection handler entry mapping a ConnectionInterfaceDef to its handler function.
  * The handler receives a reduced context (connectionData and connectionType only).
- * State, getCredentials, and componentName are accessed via closure from the connect function.
+ * State, getCredentials, connectorComponentName, and selfComponentName are accessed via
+ * closure from the connect function.
  * The handler returns typed metadata based on the interface's resultSchema.
  */
 export type ConnectionHandlerEntry<ConnectionType extends string, D extends ConnectionInterfaceDef> = {
@@ -305,8 +314,9 @@ export type ConnectionHandlerDef<D extends ConnectionInterfaceDef> = {
 export declare function connectionHandler<D extends ConnectionInterfaceDef>(entry: ConnectionHandlerDef<D>): ConnectionHandlerDef<D>;
 /**
  * Type for the connect function.
- * Called once per app component requesting a connection.
- * Returns an array of handler entries that can use the context via closure.
+ * Called once per connection being established.
+ * Returns an array of handler entries that can use the context (including
+ * connectorComponentName and selfComponentName) via closure.
  */
 export type ConnectFn<S, ConnectionType extends string, P extends CloudProvider = CloudProvider> = (ctx: ConnectFnCtx<S, P>) => readonly ConnectionHandlerEntry<ConnectionType, any>[];
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdlcworks/components",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "module": "dist/index.js",
   "files": [
     "dist"