@terraforge/terraform 0.0.20 → 0.0.22

package/dist/index.d.mts

@@ -191,6 +191,17 @@ type GetDataProps<T = State> = {
   type: string;
   state: T;
 };
+type RefreshResourceProps<T = State> = {
+  type: string;
+  priorInputState: T;
+  priorOutputState: T;
+};
+type RefreshResourceResult<T = State> = {
+  kind: 'unchanged' | 'updated';
+  state: T;
+} | {
+  kind: 'deleted';
+};
 interface Provider {
   ownResource(id: string): boolean;
   getResource(props: GetProps): Promise<{
@@ -214,6 +225,7 @@ interface Provider {
   getData?(props: GetDataProps): Promise<{
     state: State;
   }>;
+  refreshResource?(props: RefreshResourceProps): Promise<RefreshResourceResult | undefined>;
   destroy?(): Promise<void>;
 }
 //#endregion
@@ -284,6 +296,20 @@ declare class TerraformProvider implements Provider {
   }: GetDataProps): Promise<{
     state: State$1;
   }>;
+  refreshResource({
+    type,
+    priorInputState,
+    priorOutputState
+  }: RefreshResourceProps): Promise<{
+    kind: "deleted";
+    state?: undefined;
+  } | {
+    kind: "unchanged";
+    state: State$1;
+  } | {
+    kind: "updated";
+    state: State$1;
+  }>;
 }
 //#endregion
 //#region src/plugin/registry.d.ts

package/dist/index.mjs

@@ -217,6 +217,16 @@ const generateValue = (prop, ctx) => {
 
 //#endregion
 //#region src/provider.ts
+const areStatesEqual = (left, right) => {
+	const replacer = (_, value) => {
+		if (value !== null && value instanceof Object && !Array.isArray(value)) return Object.keys(value).sort().reduce((sorted, key) => {
+			sorted[key] = value[key];
+			return sorted;
+		}, {});
+		return value;
+	};
+	return JSON.stringify(left, replacer) === JSON.stringify(right, replacer);
+};
 var TerraformProvider = class {
 	configured;
 	plugin;
@@ -305,6 +315,24 @@ var TerraformProvider = class {
 		if (!data) throw new Error(`Data source not found ${type}`);
 		return { state: data };
 	}
+	async refreshResource({ type, priorInputState, priorOutputState }) {
+		const plugin = await this.configure();
+		const refreshedState = await plugin.readResource(type, priorOutputState);
+		if (!refreshedState) return { kind: "deleted" };
+		const mergedState = {
+			...refreshedState,
+			...priorInputState
+		};
+		const { requiresReplace, plannedState } = await plugin.planResourceChange(type, refreshedState, mergedState, priorInputState);
+		if (requiresReplace.length === 0 && areStatesEqual(plannedState, refreshedState)) return {
+			kind: "unchanged",
+			state: refreshedState
+		};
+		return {
+			kind: "updated",
+			state: refreshedState
+		};
+	}
 };
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terraforge/terraform",
-	"version": "0.0.20",
+	"version": "0.0.22",
 	"type": "module",
 	"repository": {
 		"type": "git",