@terraforge/core 0.0.15 → 0.0.17

package/dist/index.d.mts

@@ -145,6 +145,24 @@ declare class App extends Group {
 declare const enableDebug: () => void;
 declare const createDebugger: (group: string) => (...args: unknown[]) => void;
 //#endregion
+//#region src/workspace/procedure/status.d.ts
+/**
+ * The status of a resource comparing local config with state file.
+ *
+ * - `created`: Resource exists in state and matches current config
+ * - `changed`: Resource exists in state but config has changed
+ * - `pending`: Resource exists in config but not yet deployed (no state)
+ * - `stale`: Resource exists in state but was removed from config
+ */
+type ResourceStatus = 'created' | 'changed' | 'pending' | 'stale';
+type ResourceStatusInfo = {
+  urn: URN;
+  type: string;
+  provider: string;
+  tag: 'resource' | 'data';
+  status: ResourceStatus;
+};
+//#endregion
 //#region src/backend/lock.d.ts
 type LockBackend = {
   insecureReleaseLock(urn: URN): Promise<void>;
@@ -317,6 +335,10 @@ declare class WorkSpace {
    * Refresh the state of the resources & data-sources inside your app.
    */
   refresh(app: App): Promise<void>;
+  /**
+   * Get the status of all resources in the app by comparing current config with state file.
+   */
+  status(app: App): Promise<ResourceStatusInfo[]>;
   protected destroyProviders(): Promise<void>;
 }
 //#endregion
@@ -443,4 +465,4 @@ type CustomResourceProvider = Partial<{
 }>;
 declare const createCustomProvider: (providerId: string, resourceProviders: Record<string, CustomResourceProvider>) => Provider;
 //#endregion
-export { App, AppError, type Config, type CreateProps, type CustomResourceProvider, type DataSource, type DataSourceFunction, type DataSourceMeta, type DeleteProps, DynamoLockBackend, FileLockBackend, FileStateBackend, Future, type GetDataProps, type GetProps, Group, type Input, LockBackend, MemoryLockBackend, MemoryStateBackend, type Meta, type Node, type OptionalInput, type OptionalOutput, Output, type PlanProps, type ProcedureOptions, type Provider, type Resource, ResourceAlreadyExists, type ResourceClass, type ResourceConfig, ResourceError, type ResourceMeta, ResourceNotFound, S3StateBackend, Stack, type State, StateBackend, type Tag, type URN, type UpdateProps, WorkSpace, type WorkSpaceOptions, createCustomProvider, createCustomResourceClass, createDebugger, createMeta, deferredOutput, enableDebug, findInputDeps, getMeta, isDataSource, isNode, isResource, nodeMetaSymbol, output, resolveInputs };
+export { App, AppError, type Config, type CreateProps, type CustomResourceProvider, type DataSource, type DataSourceFunction, type DataSourceMeta, type DeleteProps, DynamoLockBackend, FileLockBackend, FileStateBackend, Future, type GetDataProps, type GetProps, Group, type Input, LockBackend, MemoryLockBackend, MemoryStateBackend, type Meta, type Node, type OptionalInput, type OptionalOutput, Output, type PlanProps, type ProcedureOptions, type Provider, type Resource, ResourceAlreadyExists, type ResourceClass, type ResourceConfig, ResourceError, type ResourceMeta, ResourceNotFound, type ResourceStatus, type ResourceStatusInfo, S3StateBackend, Stack, type State, StateBackend, type Tag, type URN, type UpdateProps, WorkSpace, type WorkSpaceOptions, createCustomProvider, createCustomResourceClass, createDebugger, createMeta, deferredOutput, enableDebug, findInputDeps, getMeta, isDataSource, isNode, isResource, nodeMetaSymbol, output, resolveInputs };

package/dist/index.mjs

@@ -1009,6 +1009,7 @@ const deployApp = async (app, opt) => {
 									}
 								}
 								newResourceState = await replaceResource(node, appState.idempotentToken, nodeState.input, nodeState.output, input, opt);
+								if (newResourceState.output) meta$1.resolve(newResourceState.output);
 							}
 							else {
 								newResourceState = await updateResource(node, appState.idempotentToken, nodeState.input, nodeState.output, input, opt);
@@ -1093,6 +1094,75 @@ const refresh = async (app, opt) => {
 	}
 };
 
+//#endregion
+//#region src/workspace/procedure/status.ts
+/**
+* Extract static values from inputs, replacing Output/Future/Promise with a placeholder.
+* This allows comparing config without needing to resolve dependencies.
+*/
+const extractStaticInputs = (inputs) => {
+	if (inputs instanceof Output || inputs instanceof Future || inputs instanceof Promise) return "__unresolved__";
+	if (Array.isArray(inputs)) return inputs.map(extractStaticInputs);
+	if (inputs !== null && typeof inputs === "object" && inputs.constructor === Object) {
+		const result = {};
+		for (const [key, value] of Object.entries(inputs)) result[key] = extractStaticInputs(value);
+		return result;
+	}
+	return inputs;
+};
+const status = async (app, opt) => {
+	const appState = await opt.backend.state.get(app.urn);
+	const resources = [];
+	const configuredUrns = /* @__PURE__ */ new Set();
+	for (const stack of app.stacks) for (const node of stack.nodes) configuredUrns.add(getMeta(node).urn);
+	for (const stack of app.stacks) {
+		const stackState = appState?.stacks[stack.urn];
+		for (const node of stack.nodes) {
+			const meta = getMeta(node);
+			const nodeState = stackState?.nodes[meta.urn];
+			const baseInfo = {
+				urn: meta.urn,
+				type: meta.type,
+				provider: meta.provider,
+				tag: isResource(node) ? "resource" : "data"
+			};
+			if (!nodeState) {
+				resources.push({
+					...baseInfo,
+					status: "pending"
+				});
+				continue;
+			}
+			const currentInput = extractStaticInputs(meta.input);
+			const hasChanged = !compareState(extractStaticInputs(nodeState.input), currentInput);
+			resources.push({
+				...baseInfo,
+				status: hasChanged ? "changed" : "created"
+			});
+		}
+		if (stackState) {
+			for (const [urn, nodeState] of Object.entries(stackState.nodes)) if (!configuredUrns.has(urn)) resources.push({
+				urn,
+				type: nodeState.type,
+				provider: nodeState.provider,
+				tag: nodeState.tag,
+				status: "stale"
+			});
+		}
+	}
+	if (appState) {
+		const configuredStackUrns = new Set(app.stacks.map((s) => s.urn));
+		for (const [stackUrn, stackState] of Object.entries(appState.stacks)) if (!configuredStackUrns.has(stackUrn)) for (const [urn, nodeState] of Object.entries(stackState.nodes)) resources.push({
+			urn,
+			type: nodeState.type,
+			provider: nodeState.provider,
+			tag: nodeState.tag,
+			status: "stale"
+		});
+	}
+	return resources;
+};
+
 //#endregion
 //#region src/workspace/workspace.ts
 var WorkSpace = class {
@@ -1147,6 +1217,12 @@ var WorkSpace = class {
 			}
 		});
 	}
+	/**
+	* Get the status of all resources in the app by comparing current config with state file.
+	*/
+	status(app) {
+		return status(app, this.props);
+	}
 	async destroyProviders() {
 		await Promise.all(this.props.providers.map((p) => {
 			return p.destroy?.();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terraforge/core",
-	"version": "0.0.15",
+	"version": "0.0.17",
 	"type": "module",
 	"repository": {
 		"type": "git",