@terraforge/core 0.0.3 → 0.0.4

package/dist/index.d.ts

@@ -21,6 +21,7 @@ declare class Output<T = unknown> extends Future<T> {
 }
 declare const deferredOutput: unknown;
 declare const output: unknown;
+type URN = `urn:${string}`;
 declare const nodeMetaSymbol: unknown;
 type Node<
 	T extends Tag = Tag,
@@ -28,7 +29,8 @@ type Node<
 	O extends State = any,
 	C extends Config = Config
 > = {
-	[nodeMetaSymbol]: Meta<T, I, O, C>;
+	readonly [nodeMetaSymbol]: Meta<T, I, O, C>;
+	readonly urn: URN;
 } & O;
 declare const isNode: (obj: object) => obj is {
 	[nodeMetaSymbol]: Meta;
@@ -57,6 +59,7 @@ type Resource<
 	O extends State = State
 > = O & {
 	readonly [nodeMetaSymbol]: ResourceMeta<I, O>;
+	readonly urn: URN;
 };
 type ResourceClass<
 	I extends State = State,
@@ -71,7 +74,6 @@ declare class Stack extends Group {
 	constructor(app: App, name: string);
 	dependsOn(...stacks: Stack[]);
 }
-type URN = `urn:${string}`;
 type Tag = "resource" | "data";
 type State = Record<string, unknown>;
 type Config = {
@@ -232,9 +234,22 @@ type WorkSpaceOptions = {
 declare class WorkSpace {
 	protected props: WorkSpaceOptions;
 	constructor(props: WorkSpaceOptions);
+	/**
+	* Deploy the entire app or use the filter option to deploy specific stacks inside your app.
+	*/
 	deploy(app: App, options?: ProcedureOptions);
+	/**
+	* Delete the entire app or use the filter option to delete specific stacks inside your app.
+	*/
 	delete(app: App, options?: ProcedureOptions);
+	/**
+	* Hydrate the outputs of the resources & data-sources inside your app.
+	*/
 	hydrate(app: App);
+	/**
+	* Refresh the state of the resources & data-sources inside your app.
+	*/
+	refresh(app: App);
 	protected destroyProviders();
 }
 type ResourceOperation = "create" | "update" | "delete" | "replace" | "import" | "resolve" | "get";

package/dist/index.js

@@ -382,7 +382,7 @@ var lockApp = async (lockBackend, app, fn) => {
 
 // src/workspace/concurrency.ts
 import promiseLimit from "p-limit";
-var concurrencyQueue = (concurrency) => {
+var createConcurrencyQueue = (concurrency) => {
   const queue = promiseLimit(concurrency);
   return (cb) => {
     return queue(cb);
@@ -631,7 +631,7 @@ var deleteApp = async (app, opt) => {
   if (opt.filters && opt.filters.length > 0) {
     stackStates = stackStates.filter((stackState) => opt.filters.includes(stackState.name));
   }
-  const queue = concurrencyQueue(opt.concurrency ?? 10);
+  const queue = createConcurrencyQueue(opt.concurrency ?? 10);
   const graph = new DependencyGraph;
   const allNodes = {};
   for (const stackState of Object.values(appState.stacks)) {
@@ -854,7 +854,7 @@ var deployApp = async (app, opt) => {
     stacks = app.stacks.filter((stack) => opt.filters.includes(stack.name));
     filteredOutStacks = app.stacks.filter((stack) => !opt.filters.includes(stack.name));
   }
-  const queue = concurrencyQueue(opt.concurrency ?? 10);
+  const queue = createConcurrencyQueue(opt.concurrency ?? 10);
   const graph = new DependencyGraph;
   const allNodes = {};
   for (const stackState of Object.values(appState.stacks)) {
@@ -1020,6 +1020,41 @@ var hydrate = async (app, opt) => {
   }
 };
 
+// src/workspace/procedure/refresh.ts
+var refresh = async (app, opt) => {
+  const appState = await opt.backend.state.get(app.urn);
+  const queue = createConcurrencyQueue(opt.concurrency ?? 10);
+  if (appState) {
+    await Promise.all(Object.values(appState.stacks).map((stackState) => {
+      return Promise.all(Object.values(stackState.nodes).map((nodeState) => {
+        return queue(async () => {
+          const provider = findProvider(opt.providers, nodeState.provider);
+          if (nodeState.tag === "data") {
+            const result = await provider.getData?.({
+              type: nodeState.type,
+              state: nodeState.output
+            });
+            if (result && !compareState(result.state, nodeState.output)) {
+              nodeState.output = result.state;
+              nodeState.input = result.state;
+            }
+          } else if (nodeState.tag === "resource") {
+            const result = await provider.getResource({
+              type: nodeState.type,
+              state: nodeState.output
+            });
+            if (result && !compareState(result.state, nodeState.output)) {
+              nodeState.output = result.state;
+              nodeState.input = result.state;
+            }
+          }
+        });
+      }));
+    }));
+    await opt.backend.state.update(app.urn, appState);
+  }
+};
+
 // src/workspace/workspace.ts
 class WorkSpace {
   props;
@@ -1047,6 +1082,15 @@ class WorkSpace {
   hydrate(app) {
     return hydrate(app, this.props);
   }
+  refresh(app) {
+    return lockApp(this.props.backend.lock, app, async () => {
+      try {
+        await refresh(app, this.props);
+      } finally {
+        await this.destroyProviders();
+      }
+    });
+  }
   async destroyProviders() {
     await Promise.all(this.props.providers.map((p) => {
       return p.destroy?.();
@@ -1306,6 +1350,9 @@ var createCustomResourceClass = (providerId, resourceType) => {
           if (key === nodeMetaSymbol) {
             return meta;
           }
+          if (key === "urn") {
+            return meta.urn;
+          }
           if (typeof key === "symbol") {
             return;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terraforge/core",
-	"version": "0.0.3",
+	"version": "0.0.4",
 	"type": "module",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",