@tomflow/proflow-dev-tunnel 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/SETUP.md +15 -3
  3. package/dist/deployment/adapter.d.ts +11 -11
  4. package/dist/deployment/adapter.js +2 -2
  5. package/dist/deployment/descriptor.d.ts +1 -1
  6. package/dist/deployment/descriptor.js +1 -1
  7. package/package.json +3 -3
  8. package/proflow.module.json +1 -1
package/CHANGELOG.md ADDED
@@ -0,0 +1,7 @@
1
+ # @tomflow/proflow-dev-tunnel
2
+
3
+ ## 0.1.8
4
+
5
+ ### Patch Changes
6
+
7
+ - Align all Modules to the seven-command setup contract with executable package-owned setup guidance and full Platform setup aggregation.
package/SETUP.md CHANGED
@@ -1,7 +1,19 @@
1
1
  # @tomflow/proflow-dev-tunnel — Module Setup
2
2
 
3
- Authenticate with Microsoft Dev Tunnels when requested, create or select the required tunnel, and allow the Module to establish and verify the public HTTPS ingress. The resulting tunnel id/public URL/evidence are Module-owned state or shared facts, not values to copy into Platform config.
3
+ ## Goal
4
+ Reach `setupStatus=READY` with one Microsoft Dev Tunnel login and one persistent tunnel selection; public URL/state remain Module-owned shared facts.
4
5
 
5
- ## Completion
6
+ ## Step 1 — Complete Microsoft Dev Tunnel login
7
+ **Type:** human/external
8
+ **Executable:** `platform setup --module dev-tunnel --workspace <workspace>`
9
+ If login is required, complete the Microsoft Dev Tunnel authentication requested by the Module, then rerun the same command.
6
10
 
7
- Setup is complete only when the Module's own `status` reports `setupStatus=READY`. Re-running setup must re-observe reality; it must not resume from a blind historical step index.
11
+ ## Step 2 — Create or select the persistent tunnel
12
+ **Type:** human/external
13
+ **Human action:** Create/select the tunnel and obtain its `tunnelId` and HTTPS public base URL.
14
+ **Verify/commit executable:** `platform setup --module dev-tunnel --workspace <workspace> --input '{"tunnelId":"<id>","publicBaseUrl":"https://<host>"}'`
15
+
16
+ ## Step 3 — Verify completion
17
+ **Type:** automatic verification
18
+ **Executable:** `platform status --workspace <workspace>`
19
+ **Success condition:** `dev-tunnel.setupStatus=READY`. Other Modules consume the resulting public URL through shared facts; the user does not copy it into their configs.
package/dist/deployment/adapter.d.ts CHANGED
@@ -6,7 +6,7 @@ export declare const behaviorAdapter: {
6
6
  readonly ok: true;
7
7
  readonly status: "SUCCEEDED";
8
8
  readonly moduleRef: "dev-tunnel";
9
- readonly moduleVersion: "0.1.7";
9
+ readonly moduleVersion: "0.1.8";
10
10
  };
11
11
  observedEffects: never[];
12
12
  }>;
@@ -16,14 +16,14 @@ export declare const behaviorAdapter: {
16
16
  readonly ok: true;
17
17
  readonly status: "SUCCEEDED";
18
18
  readonly moduleRef: "dev-tunnel";
19
- readonly moduleVersion: "0.1.7";
19
+ readonly moduleVersion: "0.1.8";
20
20
  };
21
21
  observedEffects: string[];
22
22
  } | {
23
23
  result: {
24
24
  contract: "deployment.result.v1";
25
25
  moduleRef: "dev-tunnel";
26
- moduleVersion: "0.1.7";
26
+ moduleVersion: "0.1.8";
27
27
  ok: false;
28
28
  status: "FAILED";
29
29
  error: {
@@ -40,7 +40,7 @@ export declare const behaviorAdapter: {
40
40
  ok: true;
41
41
  status: "SUCCEEDED";
42
42
  moduleRef: "dev-tunnel";
43
- moduleVersion: "0.1.7";
43
+ moduleVersion: "0.1.8";
44
44
  data: {
45
45
  setupStatus: "ACTION_REQUIRED" | "READY";
46
46
  runtimeStatus: "FAILED" | "RUNNING" | "STOPPED";
@@ -52,7 +52,7 @@ export declare const behaviorAdapter: {
52
52
  result: {
53
53
  contract: "deployment.result.v1";
54
54
  moduleRef: "dev-tunnel";
55
- moduleVersion: "0.1.7";
55
+ moduleVersion: "0.1.8";
56
56
  ok: false;
57
57
  status: "ACTION_REQUIRED";
58
58
  actionRequired: {
@@ -67,7 +67,7 @@ export declare const behaviorAdapter: {
67
67
  readonly ok: true;
68
68
  readonly status: "SUCCEEDED";
69
69
  readonly moduleRef: "dev-tunnel";
70
- readonly moduleVersion: "0.1.7";
70
+ readonly moduleVersion: "0.1.8";
71
71
  };
72
72
  observedEffects: never[];
73
73
  }>;
@@ -77,7 +77,7 @@ export declare const behaviorAdapter: {
77
77
  ok: true;
78
78
  status: "SUCCEEDED";
79
79
  moduleRef: "dev-tunnel";
80
- moduleVersion: "0.1.7";
80
+ moduleVersion: "0.1.8";
81
81
  data: {
82
82
  docs: string;
83
83
  setup: string;
@@ -89,7 +89,7 @@ export declare const behaviorAdapter: {
89
89
  result: {
90
90
  contract: "deployment.result.v1";
91
91
  moduleRef: "dev-tunnel";
92
- moduleVersion: "0.1.7";
92
+ moduleVersion: "0.1.8";
93
93
  ok: false;
94
94
  status: "FAILED";
95
95
  error: {
@@ -105,7 +105,7 @@ export declare const behaviorAdapter: {
105
105
  ok: true;
106
106
  status: "SUCCEEDED";
107
107
  moduleRef: "dev-tunnel";
108
- moduleVersion: "0.1.7";
108
+ moduleVersion: "0.1.8";
109
109
  data: import("../src/resource-adapter.ts").DevTunnelObservation;
110
110
  };
111
111
  observedEffects: string[];
@@ -116,14 +116,14 @@ export declare const behaviorAdapter: {
116
116
  readonly ok: true;
117
117
  readonly status: "SUCCEEDED";
118
118
  readonly moduleRef: "dev-tunnel";
119
- readonly moduleVersion: "0.1.7";
119
+ readonly moduleVersion: "0.1.8";
120
120
  };
121
121
  observedEffects: string[];
122
122
  } | {
123
123
  result: {
124
124
  contract: "deployment.result.v1";
125
125
  moduleRef: "dev-tunnel";
126
- moduleVersion: "0.1.7";
126
+ moduleVersion: "0.1.8";
127
127
  ok: false;
128
128
  status: "FAILED";
129
129
  error: {
package/dist/deployment/adapter.js CHANGED
@@ -168,7 +168,7 @@ export const behaviorAdapter = {
168
168
  status: "ACTION_REQUIRED",
169
169
  actionRequired: {
170
170
  action: "complete-tunnel-login",
171
- description: "Complete Microsoft Dev Tunnel login, then rerun setup.",
171
+ description: `Run devtunnel user login, complete Microsoft authentication, then rerun platform setup --module dev-tunnel --workspace ${JSON.stringify(context.workspaceRoot)}.`,
172
172
  },
173
173
  },
174
174
  observedEffects: [],
@@ -182,7 +182,7 @@ export const behaviorAdapter = {
182
182
  status: "ACTION_REQUIRED",
183
183
  actionRequired: {
184
184
  action: "select-or-create-tunnel",
185
- description: "Create or select the persistent Dev Tunnel and provide tunnelId plus publicBaseUrl to this setup step.",
185
+ description: `Create/select the persistent tunnel (for example devtunnel create <tunnel-id>), then run platform setup --module dev-tunnel --workspace ${JSON.stringify(context.workspaceRoot)} --input '{"tunnelId":"<id>","publicBaseUrl":"https://<host>"}'.`,
186
186
  },
187
187
  },
188
188
  observedEffects: [],
package/dist/deployment/descriptor.d.ts CHANGED
@@ -3,7 +3,7 @@ export declare const descriptor: {
3
3
  readonly contractVersion: "1.0.0";
4
4
  readonly moduleRef: "dev-tunnel";
5
5
  readonly packageName: "@tomflow/proflow-dev-tunnel";
6
- readonly moduleVersion: "0.1.7";
6
+ readonly moduleVersion: "0.1.8";
7
7
  readonly kind: "external-resource";
8
8
  readonly templateVersion: "1.0.0";
9
9
  readonly platformCompatibility: ">=1.0.0 <2.0.0";
package/dist/deployment/descriptor.js CHANGED
@@ -3,7 +3,7 @@ export const descriptor = {
3
3
  contractVersion: "1.0.0",
4
4
  moduleRef: "dev-tunnel",
5
5
  packageName: "@tomflow/proflow-dev-tunnel",
6
- moduleVersion: "0.1.7",
6
+ moduleVersion: "0.1.8",
7
7
  kind: "external-resource",
8
8
  templateVersion: "1.0.0",
9
9
  platformCompatibility: ">=1.0.0 <2.0.0",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tomflow/proflow-dev-tunnel",
3
- "version": "0.1.7",
3
+ "version": "0.1.8",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -19,10 +19,10 @@
19
19
  "SETUP.md"
20
20
  ],
21
21
  "dependencies": {
22
- "@tomflow/proflow-module-contract": "^0.1.4"
22
+ "@tomflow/proflow-module-contract": "^0.1.5"
23
23
  },
24
24
  "devDependencies": {
25
- "@tomflow/proflow-deployment-conformance": "^0.1.4"
25
+ "@tomflow/proflow-deployment-conformance": "^0.1.5"
26
26
  },
27
27
  "description": "Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process.",
28
28
  "keywords": [
package/proflow.module.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "contractVersion": "1.0.0",
4
4
  "moduleRef": "dev-tunnel",
5
5
  "packageName": "@tomflow/proflow-dev-tunnel",
6
- "moduleVersion": "0.1.7",
6
+ "moduleVersion": "0.1.8",
7
7
  "kind": "external-resource",
8
8
  "templateVersion": "1.0.0",
9
9
  "platformCompatibility": ">=1.0.0 <2.0.0",