@webiny/pulumi 5.29.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Webiny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PulumiAppModule.d.ts

@@ -0,0 +1,16 @@
+import { PulumiApp } from "./types";
+export interface PulumiAppModuleCallback<TModule, TConfig> {
+    (this: void, app: PulumiApp, config: TConfig): TModule;
+}
+export interface PulumiAppModuleParams<TModule, TConfig> {
+    name: string;
+    config: PulumiAppModuleCallback<TModule, TConfig>;
+}
+export declare type PulumiAppModule<T extends PulumiAppModuleDefinition<any, any>> = T extends PulumiAppModuleDefinition<infer V, any> ? V : never;
+export declare class PulumiAppModuleDefinition<TModule, TConfig> {
+    readonly symbol: symbol;
+    readonly name: string;
+    readonly run: PulumiAppModuleCallback<TModule, TConfig>;
+    constructor(params: PulumiAppModuleParams<TModule, TConfig>);
+}
+export declare function createAppModule<TModule, TConfig = void>(params: PulumiAppModuleParams<TModule, TConfig>): PulumiAppModuleDefinition<TModule, TConfig>;

package/PulumiAppModule.js

@@ -0,0 +1,28 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PulumiAppModuleDefinition = void 0;
+exports.createAppModule = createAppModule;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+class PulumiAppModuleDefinition {
+  constructor(params) {
+    (0, _defineProperty2.default)(this, "symbol", Symbol());
+    (0, _defineProperty2.default)(this, "name", void 0);
+    (0, _defineProperty2.default)(this, "run", void 0);
+    this.name = params.name;
+    this.run = params.config;
+  }
+
+}
+
+exports.PulumiAppModuleDefinition = PulumiAppModuleDefinition;
+
+function createAppModule(params) {
+  return new PulumiAppModuleDefinition(params);
+}

package/PulumiAppModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PulumiAppModuleDefinition","constructor","params","Symbol","name","run","config","createAppModule"],"sources":["PulumiAppModule.ts"],"sourcesContent":["import { PulumiApp } from \"./types\";\n\nexport interface PulumiAppModuleCallback<TModule, TConfig> {\n    (this: void, app: PulumiApp, config: TConfig): TModule;\n}\n\nexport interface PulumiAppModuleParams<TModule, TConfig> {\n    name: string;\n    config: PulumiAppModuleCallback<TModule, TConfig>;\n}\n\nexport type PulumiAppModule<T extends PulumiAppModuleDefinition<any, any>> =\n    T extends PulumiAppModuleDefinition<infer V, any> ? V : never;\n\nexport class PulumiAppModuleDefinition<TModule, TConfig> {\n    public readonly symbol = Symbol();\n    public readonly name: string;\n    public readonly run: PulumiAppModuleCallback<TModule, TConfig>;\n    constructor(params: PulumiAppModuleParams<TModule, TConfig>) {\n        this.name = params.name;\n        this.run = params.config;\n    }\n}\n\nexport function createAppModule<TModule, TConfig = void>(\n    params: PulumiAppModuleParams<TModule, TConfig>\n) {\n    return new PulumiAppModuleDefinition(params);\n}\n"],"mappings":";;;;;;;;;;;;AAcO,MAAMA,yBAAN,CAAkD;EAIrDC,WAAW,CAACC,MAAD,EAAkD;IAAA,8CAHpCC,MAAM,EAG8B;IAAA;IAAA;IACzD,KAAKC,IAAL,GAAYF,MAAM,CAACE,IAAnB;IACA,KAAKC,GAAL,GAAWH,MAAM,CAACI,MAAlB;EACH;;AAPoD;;;;AAUlD,SAASC,eAAT,CACHL,MADG,EAEL;EACE,OAAO,IAAIF,yBAAJ,CAA8BE,MAA9B,CAAP;AACH"}

package/PulumiAppRemoteResource.d.ts

@@ -0,0 +1,5 @@
+import * as pulumi from "@pulumi/pulumi";
+export interface PulumiAppRemoteResource<T> {
+    name: string;
+    readonly output: pulumi.Output<pulumi.Unwrap<T>>;
+}

package/PulumiAppRemoteResource.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/PulumiAppRemoteResource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["PulumiAppRemoteResource.ts"],"sourcesContent":["import * as pulumi from \"@pulumi/pulumi\";\n\nexport interface PulumiAppRemoteResource<T> {\n    name: string;\n    readonly output: pulumi.Output<pulumi.Unwrap<T>>;\n}\n"],"mappings":""}

package/PulumiAppResource.d.ts

@@ -0,0 +1,27 @@
+import * as pulumi from "@pulumi/pulumi";
+export interface PulumiAppResourceConstructor<T = any, TArgs = any> {
+    new (name: string, args: TArgs, opts?: pulumi.CustomResourceOptions): T;
+}
+export declare type PulumiAppResourceType<T extends PulumiAppResourceConstructor> = T extends PulumiAppResourceConstructor<infer TType> ? TType : never;
+export declare type PulumiAppResourceArgs<T extends PulumiAppResourceConstructor> = T extends PulumiAppResourceConstructor<any, infer TArgs> ? Exclude<TArgs, undefined> : never;
+export interface CreatePulumiAppResourceParams<TConstructor extends PulumiAppResourceConstructor> {
+    name: string;
+    config: PulumiAppResourceArgs<TConstructor>;
+    opts?: pulumi.CustomResourceOptions;
+}
+export interface PulumiAppResourceConfigModifier<T> {
+    (value: pulumi.Unwrap<T>): T | void;
+}
+export interface PulumiAppResourceConfigSetter<T> {
+    (value: T): void;
+    (fcn: PulumiAppResourceConfigModifier<T>): void;
+}
+export declare type PulumiAppResourceConfigProxy<T extends object> = {
+    readonly [K in keyof T]-?: PulumiAppResourceConfigSetter<T[K]>;
+};
+export interface PulumiAppResource<T extends PulumiAppResourceConstructor> {
+    name: string;
+    readonly config: PulumiAppResourceConfigProxy<PulumiAppResourceArgs<T>>;
+    readonly opts: pulumi.CustomResourceOptions;
+    readonly output: pulumi.Output<pulumi.Unwrap<PulumiAppResourceType<T>>>;
+}

package/PulumiAppResource.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/PulumiAppResource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["PulumiAppResource.ts"],"sourcesContent":["import * as pulumi from \"@pulumi/pulumi\";\n\nexport interface PulumiAppResourceConstructor<T = any, TArgs = any> {\n    new (name: string, args: TArgs, opts?: pulumi.CustomResourceOptions): T;\n}\n\nexport type PulumiAppResourceType<T extends PulumiAppResourceConstructor> =\n    T extends PulumiAppResourceConstructor<infer TType> ? TType : never;\n\nexport type PulumiAppResourceArgs<T extends PulumiAppResourceConstructor> =\n    T extends PulumiAppResourceConstructor<any, infer TArgs> ? Exclude<TArgs, undefined> : never;\n\nexport interface CreatePulumiAppResourceParams<TConstructor extends PulumiAppResourceConstructor> {\n    name: string;\n    config: PulumiAppResourceArgs<TConstructor>;\n    opts?: pulumi.CustomResourceOptions;\n}\n\nexport interface PulumiAppResourceConfigModifier<T> {\n    (value: pulumi.Unwrap<T>): T | void;\n}\n\nexport interface PulumiAppResourceConfigSetter<T> {\n    (value: T): void;\n    (fcn: PulumiAppResourceConfigModifier<T>): void;\n}\n\nexport type PulumiAppResourceConfigProxy<T extends object> = {\n    readonly [K in keyof T]-?: PulumiAppResourceConfigSetter<T[K]>;\n};\n\nexport interface PulumiAppResource<T extends PulumiAppResourceConstructor> {\n    name: string;\n    readonly config: PulumiAppResourceConfigProxy<PulumiAppResourceArgs<T>>;\n    readonly opts: pulumi.CustomResourceOptions;\n    readonly output: pulumi.Output<pulumi.Unwrap<PulumiAppResourceType<T>>>;\n}\n"],"mappings":""}

package/README.md

@@ -0,0 +1,138 @@
+# `@webiny/pulumi`
+
+[![](https://img.shields.io/npm/dw/@webiny/pulumi.svg)](https://www.npmjs.com/package/@webiny/pulumi)
+[![](https://img.shields.io/npm/v/@webiny/pulumi.svg)](https://www.npmjs.com/package/@webiny/pulumi)
+[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
+
+A small framework for creating flexible Pulumi programs.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Overview](#overview)
+- [Examples](#examples)
+- [Reference](#reference)
+    - [Functions](#functions)
+        - [`createPulumiApp`](#createPulumiApp)
+
+## Installation
+
+```
+npm install --save @webiny/pulumi
+```
+
+Or if you prefer yarn:
+
+```
+yarn add @webiny/pulumi
+```
+
+## Overview
+
+The `@webiny/pulumi` package enables creation of flexible Pulumi apps (programs). 
+
+More specifically, a Pulumi app not only encapsulates the essential Pulumi program code defined by developers, but also, once defined, provides a way to adjust any defined cloud infrastructure resource configuration and even add new resources into the mix.
+
+This is useful when you just want to export a simple constructor function to the user, and not bother them with all the internals. And, as mentioned, in those rare cases when the user actually needs to perform further adjustments, a Pulumi app provides a way to do it.   
+
+> 💡 **TIP**
+>
+> Pulumi apps are heavily used in real Webiny projects. As mentioned, this is because of their ability to abstract the actual cloud infrastructure code from the user, and, at the same time, provide a way for the user to perform adjustments when needed.
+
+The following example shows how a Pulumi app looks in the actual code:
+
+```ts
+// This is imported in our Pulumi program's entrypoint file (index.ts).
+import createXyzApp from "@webiny/xyz-app";
+
+export = async () => {
+    const xyzApp = createXyzApp({
+        pulumi: app => {
+            // Let's imagine the `xyz` Pulumi app deploys an Amazon S3 bucket.
+            // Then, we would be able to do something like the following:
+            app.resources.bucket.config.acl(aws.s3.CannedAcl.Private);
+            app.resources.bucket.config.forceDestroy(true);
+        }
+    });
+
+    return xyzApp.run();
+};
+
+```
+
+## Examples
+
+| Example                           | Description                                                     |
+| --------------------------------- | --------------------------------------------------------------- |
+| [Quick Example](./docs/examples/quickExample.md) | Shows how to create and use a simple Pulumi app. |
+
+## Reference
+
+### Functions
+
+#### `createPulumiApp`
+
+<details>
+<summary>Type Declaration</summary>
+<p>
+
+```ts
+export interface CreatePulumiAppParams<TResources extends Record<string, unknown>> {
+    name: string;
+    path: string;
+    config?: Record<string, any>;
+    program(app: PulumiApp): TResources | Promise<TResources>;
+}
+
+export declare function createPulumiApp<TResources extends Record<string, unknown>>(params: CreatePulumiAppParams<TResources>): PulumiApp<TResources>;
+```
+
+</p>
+</details>
+
+Creates a new Pulumi app.
+
+```ts
+// Defining the app.
+import * as aws from "@pulumi/aws";
+import { createPulumiApp } from "@webiny/pulumi";
+
+export interface CreateMyAppParams {
+    pulumi?: (app: ReturnType<typeof createMyApp>) => void;
+}
+
+const createMyApp = (projectAppConfig: CreateMyAppParams) => {
+    const app = createPulumiApp({
+        name: "my-app",
+        path: "relative/path/from/cwd",
+        program: async app => {
+            const bucket = app.addResource(aws.s3.Bucket, {
+                name: "my-app",
+                config: {
+                    acl: aws.s3.CannedAcl.PublicRead,
+                    forceDestroy: false,
+                    website: {
+                        indexDocument: "index.html",
+                        errorDocument: "index.html"
+                    }
+                }
+            });
+
+            app.addOutputs({
+                appStorage: bucket.output.id
+            });
+
+            return {
+                bucket
+            };
+        }
+    });
+
+    if (projectAppConfig.pulumi) {
+        projectAppConfig.pulumi(app);
+    }
+
+    return app;
+};
+```

package/createPulumiApp.d.ts

@@ -0,0 +1,2 @@
+import { CreatePulumiAppParams, PulumiApp } from "./types";
+export declare function createPulumiApp<TResources extends Record<string, unknown>>(params: CreatePulumiAppParams<TResources>): PulumiApp<TResources>;

package/createPulumiApp.js

@@ -0,0 +1,210 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createPulumiApp = createPulumiApp;
+
+var _findUp = _interopRequireDefault(require("find-up"));
+
+var _path = _interopRequireDefault(require("path"));
+
+var pulumi = _interopRequireWildcard(require("@pulumi/pulumi"));
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+function createPulumiApp(params) {
+  let projectRootPath = _findUp.default.sync("webiny.project.ts");
+
+  if (projectRootPath) {
+    projectRootPath = _path.default.dirname(projectRootPath).replace(/\\/g, "/");
+  } else {
+    throw new Error("Couldn't detect Webiny project.");
+  }
+
+  const appRelativePath = params.path;
+
+  const appRootPath = _path.default.join(projectRootPath, appRelativePath);
+
+  const projectAppWorkspacePath = _path.default.join(projectRootPath, ".webiny", "workspaces", appRelativePath);
+
+  const app = {
+    resourceHandlers: [],
+    handlers: [],
+    outputs: {},
+    modules: new Map(),
+    paths: {
+      absolute: appRootPath,
+      relative: appRelativePath,
+      workspace: projectAppWorkspacePath
+    },
+    resources: {},
+    name: params.name,
+    program: params.program,
+    params: {
+      create: params.config || {},
+      run: {}
+    },
+
+    async run(config) {
+      app.params.run = config;
+      Object.assign(app.resources, await app.program(app));
+
+      for (const handler of app.handlers) {
+        await handler();
+      }
+
+      app.params.run = {};
+      return app.outputs;
+    },
+
+    onResource(handler) {
+      app.resourceHandlers.push(handler);
+    },
+
+    /**
+     * Adds a resource to pulumi app.
+     * It's not running the script immediately, but enqueues the call.
+     * This way we are still able to modify the config of the resource.
+     * @param resourceConstructor Resource to be added, ie aws.s3.Bucket
+     * @param params Parameters to configure the resource
+     * @returns Object giving access to both resource outputs and its config.
+     */
+    addResource(resourceConstructor, params) {
+      const config = params.config ?? {};
+      const opts = params.opts ?? {};
+      const promise = new Promise(resolve => {
+        app.handlers.push(() => {
+          app.resourceHandlers.forEach(handler => handler(resourceInstance));
+          const resourceInstance = new resourceConstructor(resource.name, config, opts);
+          resolve(resourceInstance);
+        });
+      });
+      const resource = {
+        name: params.name,
+        config: createPulumiAppResourceConfigProxy(config),
+        opts,
+        output: pulumi.output(promise)
+      };
+      return resource;
+    },
+
+    addRemoteResource(name, getter) {
+      const promise = getter();
+      const resource = {
+        name,
+        output: pulumi.output(promise)
+      };
+      return resource;
+    },
+
+    /**
+     * Registers output value within pulumi app.
+     * @param name Name of the output value
+     * @param output Value of the output
+     */
+    addOutput(name, output) {
+      app.outputs[name] = output;
+    },
+
+    /**
+     * Registers one or more output values.
+     * @param outputs Dictionary containing output values.
+     */
+    addOutputs(outputs) {
+      Object.assign(app.outputs, outputs);
+    },
+
+    /**
+     * Registers an app module within app.
+     * Allows to decompose application into smaller pieces.
+     * Added module can be then retrieved with `getModule`.
+     * @param module
+     * @param config
+     */
+    addModule(module, config) {
+      if (app.modules.has(module.symbol)) {
+        throw new Error(`Module "${module.name}" is already present in the "${app.name}" application.`);
+      }
+
+      const createdModule = module.run(app, config);
+      app.modules.set(module.symbol, createdModule);
+      return createdModule;
+    },
+
+    /**
+     * Returns a module by its definition
+     * @param def
+     * @param opts
+     */
+    getModule(def, opts) {
+      const module = app.modules.get(def.symbol);
+
+      if (!module) {
+        if (opts !== null && opts !== void 0 && opts.optional) {
+          return null;
+        } else {
+          throw new Error(`Module "${def.name}" not found in "${app.name}" app`);
+        }
+      }
+
+      return module;
+    },
+
+    /**
+     * Schedules a handler to be executed when running pulumi script.
+     * Anything, that is returned from handler will be wrapped in pulumi.Output
+     * so it can be used in other places.
+     * @param handler Handler to be executed.
+     * @returns Result of the handler wrapped with pulumi.Output
+     */
+    addHandler(handler) {
+      const promise = new Promise(resolve => {
+        app.handlers.push(async () => {
+          resolve(await handler());
+        });
+      });
+      return pulumi.output(promise);
+    },
+
+    getParam(param) {
+      if (typeof param === "function") {
+        return param(app);
+      }
+
+      return param;
+    }
+
+  };
+  return app;
+}
+
+function createPulumiAppResourceConfigProxy(obj) {
+  return new Proxy(obj, {
+    get(target, p) {
+      const key = p;
+
+      const setter = value => {
+        if (typeof value === "function") {
+          const modifier = value;
+          const currentValue = target[key]; // Wrap a current config with a function.
+
+          const newValue = pulumi.output(currentValue).apply(v => {
+            const newValue = modifier(v);
+            return pulumi.output(newValue);
+          });
+          target[key] = newValue;
+        } else {
+          target[key] = value;
+        }
+      };
+
+      return setter;
+    }
+
+  });
+}

package/createPulumiApp.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createPulumiApp","params","projectRootPath","findUp","sync","path","dirname","replace","Error","appRelativePath","appRootPath","join","projectAppWorkspacePath","app","resourceHandlers","handlers","outputs","modules","Map","paths","absolute","relative","workspace","resources","name","program","create","config","run","Object","assign","handler","onResource","push","addResource","resourceConstructor","opts","promise","Promise","resolve","forEach","resourceInstance","resource","createPulumiAppResourceConfigProxy","output","pulumi","addRemoteResource","getter","addOutput","addOutputs","addModule","module","has","symbol","createdModule","set","getModule","def","get","optional","addHandler","getParam","param","obj","Proxy","target","p","key","setter","value","modifier","currentValue","newValue","apply","v"],"sources":["createPulumiApp.ts"],"sourcesContent":["import findUp from \"find-up\";\nimport path from \"path\";\nimport * as pulumi from \"@pulumi/pulumi\";\nimport { PulumiAppModuleDefinition } from \"./PulumiAppModule\";\nimport {\n    PulumiAppResourceArgs,\n    PulumiAppResourceConstructor,\n    PulumiAppResourceType,\n    PulumiAppResource,\n    CreatePulumiAppResourceParams,\n    PulumiAppResourceConfigSetter,\n    PulumiAppResourceConfigModifier,\n    PulumiAppResourceConfigProxy\n} from \"./PulumiAppResource\";\nimport {\n    CreatePulumiAppParams,\n    PulumiApp,\n    PulumiAppParam,\n    PulumiAppParamCallback,\n    ResourceHandler\n} from \"~/types\";\nimport { PulumiAppRemoteResource } from \"~/PulumiAppRemoteResource\";\n\nexport function createPulumiApp<TResources extends Record<string, unknown>>(\n    params: CreatePulumiAppParams<TResources>\n): PulumiApp<TResources> {\n    let projectRootPath = findUp.sync(\"webiny.project.ts\");\n    if (projectRootPath) {\n        projectRootPath = path.dirname(projectRootPath).replace(/\\\\/g, \"/\");\n    } else {\n        throw new Error(\"Couldn't detect Webiny project.\");\n    }\n\n    const appRelativePath = params.path;\n    const appRootPath = path.join(projectRootPath, appRelativePath);\n\n    const projectAppWorkspacePath = path.join(\n        projectRootPath,\n        \".webiny\",\n        \"workspaces\",\n        appRelativePath\n    );\n\n    const app: PulumiApp<TResources> = {\n        resourceHandlers: [],\n        handlers: [],\n        outputs: {},\n        modules: new Map<symbol, unknown>(),\n        paths: {\n            absolute: appRootPath,\n            relative: appRelativePath,\n            workspace: projectAppWorkspacePath\n        },\n\n        resources: {} as TResources,\n        name: params.name,\n        program: params.program,\n        params: {\n            create: params.config || {},\n            run: {}\n        },\n\n        async run(config) {\n            app.params.run = config;\n\n            Object.assign(app.resources, await app.program(app));\n\n            for (const handler of app.handlers) {\n                await handler();\n            }\n\n            app.params.run = {};\n\n            return app.outputs;\n        },\n\n        onResource(handler: ResourceHandler) {\n            app.resourceHandlers.push(handler);\n        },\n\n        /**\n         * Adds a resource to pulumi app.\n         * It's not running the script immediately, but enqueues the call.\n         * This way we are still able to modify the config of the resource.\n         * @param resourceConstructor Resource to be added, ie aws.s3.Bucket\n         * @param params Parameters to configure the resource\n         * @returns Object giving access to both resource outputs and its config.\n         */\n        addResource<T extends PulumiAppResourceConstructor>(\n            resourceConstructor: T,\n            params: CreatePulumiAppResourceParams<T>\n        ) {\n            const config = params.config ?? ({} as PulumiAppResourceArgs<T>);\n            const opts = params.opts ?? {};\n\n            const promise = new Promise<PulumiAppResourceType<T>>(resolve => {\n                app.handlers.push(() => {\n                    app.resourceHandlers.forEach(handler => handler(resourceInstance));\n                    const resourceInstance = new resourceConstructor(resource.name, config, opts);\n                    resolve(resourceInstance);\n                });\n            });\n\n            const resource: PulumiAppResource<T> = {\n                name: params.name,\n                config: createPulumiAppResourceConfigProxy(config),\n                opts,\n                output: pulumi.output(promise)\n            };\n\n            return resource;\n        },\n\n        addRemoteResource<T>(name: string, getter: () => Promise<T>) {\n            const promise = getter();\n\n            const resource: PulumiAppRemoteResource<T> = {\n                name,\n                output: pulumi.output(promise)\n            };\n\n            return resource;\n        },\n\n        /**\n         * Registers output value within pulumi app.\n         * @param name Name of the output value\n         * @param output Value of the output\n         */\n        addOutput<T>(name: string, output: T) {\n            app.outputs[name] = output;\n        },\n\n        /**\n         * Registers one or more output values.\n         * @param outputs Dictionary containing output values.\n         */\n        addOutputs(outputs: Record<string, unknown>) {\n            Object.assign(app.outputs, outputs);\n        },\n\n        /**\n         * Registers an app module within app.\n         * Allows to decompose application into smaller pieces.\n         * Added module can be then retrieved with `getModule`.\n         * @param module\n         * @param config\n         */\n        addModule<TModule, TConfig>(\n            module: PulumiAppModuleDefinition<TModule, TConfig>,\n            config?: TConfig\n        ) {\n            if (app.modules.has(module.symbol)) {\n                throw new Error(\n                    `Module \"${module.name}\" is already present in the \"${app.name}\" application.`\n                );\n            }\n\n            const createdModule = module.run(app, config as TConfig);\n            app.modules.set(module.symbol, createdModule);\n\n            return createdModule;\n        },\n\n        /**\n         * Returns a module by its definition\n         * @param def\n         * @param opts\n         */\n        getModule<TConfig, TModule>(\n            def: PulumiAppModuleDefinition<TModule, TConfig>,\n            opts?: { optional: boolean }\n        ) {\n            const module = app.modules.get(def.symbol);\n\n            if (!module) {\n                if (opts?.optional) {\n                    return null;\n                } else {\n                    throw new Error(`Module \"${def.name}\" not found in \"${app.name}\" app`);\n                }\n            }\n\n            return module;\n        },\n\n        /**\n         * Schedules a handler to be executed when running pulumi script.\n         * Anything, that is returned from handler will be wrapped in pulumi.Output\n         * so it can be used in other places.\n         * @param handler Handler to be executed.\n         * @returns Result of the handler wrapped with pulumi.Output\n         */\n        addHandler<T>(handler: () => Promise<T> | T) {\n            const promise = new Promise<T>(resolve => {\n                app.handlers.push(async () => {\n                    resolve(await handler());\n                });\n            });\n\n            return pulumi.output(promise);\n        },\n\n        getParam<T>(param: PulumiAppParam<T>) {\n            if (typeof param === \"function\") {\n                return (param as PulumiAppParamCallback<T>)(app);\n            }\n\n            return param;\n        }\n    };\n\n    return app;\n}\n\nfunction createPulumiAppResourceConfigProxy<T extends object>(obj: T) {\n    return new Proxy(obj, {\n        get(target, p: string) {\n            type V = T[keyof T];\n            const key = p as keyof T;\n            const setter: PulumiAppResourceConfigSetter<V> = (\n                value: V | PulumiAppResourceConfigModifier<V>\n            ) => {\n                if (typeof value === \"function\") {\n                    const modifier = value as PulumiAppResourceConfigModifier<V>;\n                    const currentValue = target[key];\n                    // Wrap a current config with a function.\n                    const newValue = pulumi.output(currentValue).apply(v => {\n                        const newValue = modifier(v);\n                        return pulumi.output(newValue);\n                    });\n\n                    target[key] = newValue as unknown as V;\n                } else {\n                    target[key] = value;\n                }\n            };\n\n            return setter;\n        }\n    }) as PulumiAppResourceConfigProxy<T>;\n}\n"],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./createPulumiApp";
+export * from "./PulumiAppModule";
+export * from "./PulumiAppResource";
+export * from "./PulumiAppRemoteResource";
+export * from "./types";

package/index.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var _createPulumiApp = require("./createPulumiApp");
+
+Object.keys(_createPulumiApp).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _createPulumiApp[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _createPulumiApp[key];
+    }
+  });
+});
+
+var _PulumiAppModule = require("./PulumiAppModule");
+
+Object.keys(_PulumiAppModule).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _PulumiAppModule[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _PulumiAppModule[key];
+    }
+  });
+});
+
+var _PulumiAppResource = require("./PulumiAppResource");
+
+Object.keys(_PulumiAppResource).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _PulumiAppResource[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _PulumiAppResource[key];
+    }
+  });
+});
+
+var _PulumiAppRemoteResource = require("./PulumiAppRemoteResource");
+
+Object.keys(_PulumiAppRemoteResource).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _PulumiAppRemoteResource[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _PulumiAppRemoteResource[key];
+    }
+  });
+});
+
+var _types = require("./types");
+
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["index.ts"],"sourcesContent":["export * from \"./createPulumiApp\";\nexport * from \"./PulumiAppModule\";\nexport * from \"./PulumiAppResource\";\nexport * from \"./PulumiAppRemoteResource\";\nexport * from \"./types\";\n"],"mappings":";;;;;;AAAA;;AAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;AACA;;AAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;AACA;;AAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;AACA;;AAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA;;AACA;;AAAA;EAAA;EAAA;EAAA;IAAA;IAAA;MAAA;IAAA;EAAA;AAAA"}

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@webiny/pulumi",
+	"version": "5.29.0-beta.0",
+	"main": "index.js",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"description": "A simple Node.js Pulumi SDK.",
+	"author": "Webiny Ltd",
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public",
+		"directory": "dist"
+	},
+	"dependencies": {
+		"@pulumi/pulumi": "^3.34.0",
+		"find-up": "5.0.0"
+	},
+	"devDependencies": {
+		"@babel/cli": "^7.16.0",
+		"@babel/core": "^7.16.0",
+		"@types/lodash": "^4.14.178",
+		"@types/node": "^10.0.0",
+		"@webiny/cli": "^5.29.0-beta.0",
+		"@webiny/project-utils": "^5.29.0-beta.0",
+		"rimraf": "^3.0.2",
+		"typescript": "4.5.5"
+	},
+	"scripts": {
+		"build": "yarn webiny run build",
+		"watch": "yarn webiny run watch"
+	},
+	"gitHead": "e221dc575942c512548be142e20c5bd1231edcda"
+}

package/types.d.ts

@@ -0,0 +1,53 @@
+import * as pulumi from "@pulumi/pulumi";
+import { PulumiAppModuleDefinition } from "./PulumiAppModule";
+import { PulumiAppResourceConstructor, PulumiAppResource, CreatePulumiAppResourceParams } from "./PulumiAppResource";
+import { PulumiAppRemoteResource } from "./PulumiAppRemoteResource";
+export interface ResourceHandler {
+    (resource: PulumiAppResource<PulumiAppResourceConstructor>): void;
+}
+export declare type PulumiAppParamCallback<T> = (app: PulumiApp) => T;
+export declare type PulumiAppParam<T> = T | PulumiAppParamCallback<T>;
+export declare type PulumiProgram<TResources = Record<string, any>> = (app: PulumiApp) => TResources | Promise<TResources>;
+export declare type CreateConfig = Record<string, any>;
+export declare type RunConfig = Record<string, any>;
+export interface CreatePulumiAppParams<TResources extends Record<string, unknown>> {
+    name: string;
+    path: string;
+    config?: CreateConfig;
+    program(app: PulumiApp): TResources | Promise<TResources>;
+}
+export interface PulumiApp<TResources = Record<string, unknown>> {
+    resourceHandlers: ResourceHandler[];
+    handlers: (() => void | Promise<void>)[];
+    outputs: Record<string, any>;
+    modules: Map<symbol, unknown>;
+    paths: {
+        absolute: string;
+        relative: string;
+        workspace: string;
+    };
+    name: string;
+    program: PulumiProgram<TResources>;
+    resources: TResources;
+    params: {
+        create: CreateConfig;
+        run: RunConfig;
+    };
+    run(params: RunConfig): Record<string, any>;
+    onResource(handler: ResourceHandler): void;
+    addResource<T extends PulumiAppResourceConstructor>(resourceConstructor: T, params: CreatePulumiAppResourceParams<T>): PulumiAppResource<T>;
+    addRemoteResource<T>(name: string, getter: () => Promise<T>): PulumiAppRemoteResource<T>;
+    addOutput<T>(name: string, output: T): void;
+    addOutputs(outputs: Record<string, unknown>): void;
+    addModule<TModule>(def: PulumiAppModuleDefinition<TModule, void>): TModule;
+    addModule<TModule, TConfig>(def: PulumiAppModuleDefinition<TModule, TConfig>, config: TConfig): TModule;
+    getModule<TConfig, TModule>(def: PulumiAppModuleDefinition<TModule, TConfig>): TModule;
+    getModule<TConfig, TModule>(def: PulumiAppModuleDefinition<TModule, TConfig>, opts: {
+        optional: false;
+    }): TModule;
+    getModule<TConfig, TModule>(def: PulumiAppModuleDefinition<TModule, TConfig>, opts: {
+        optional: true;
+    }): TModule | null;
+    addHandler<T>(handler: () => Promise<T> | T): pulumi.Output<pulumi.Unwrap<T>>;
+    getParam<T>(param: T | ((app: PulumiApp) => T)): T;
+}

package/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["import * as pulumi from \"@pulumi/pulumi\";\nimport { PulumiAppModuleDefinition } from \"./PulumiAppModule\";\nimport {\n    PulumiAppResourceConstructor,\n    PulumiAppResource,\n    CreatePulumiAppResourceParams\n} from \"./PulumiAppResource\";\nimport { PulumiAppRemoteResource } from \"~/PulumiAppRemoteResource\";\n\nexport interface ResourceHandler {\n    (resource: PulumiAppResource<PulumiAppResourceConstructor>): void;\n}\n\nexport type PulumiAppParamCallback<T> = (app: PulumiApp) => T;\nexport type PulumiAppParam<T> = T | PulumiAppParamCallback<T>;\n\nexport type PulumiProgram<TResources = Record<string, any>> = (\n    app: PulumiApp\n) => TResources | Promise<TResources>;\n\nexport type CreateConfig = Record<string, any>;\nexport type RunConfig = Record<string, any>;\n\nexport interface CreatePulumiAppParams<TResources extends Record<string, unknown>> {\n    name: string;\n    path: string;\n    config?: CreateConfig;\n    program(app: PulumiApp): TResources | Promise<TResources>;\n}\n\nexport interface PulumiApp<TResources = Record<string, unknown>> {\n    resourceHandlers: ResourceHandler[];\n    handlers: (() => void | Promise<void>)[];\n    outputs: Record<string, any>;\n    modules: Map<symbol, unknown>;\n\n    paths: { absolute: string; relative: string; workspace: string };\n    name: string;\n    program: PulumiProgram<TResources>;\n    resources: TResources;\n    params: {\n        create: CreateConfig;\n        run: RunConfig;\n    };\n\n    run(params: RunConfig): Record<string, any>;\n\n    onResource(handler: ResourceHandler): void;\n\n    addResource<T extends PulumiAppResourceConstructor>(\n        resourceConstructor: T,\n        params: CreatePulumiAppResourceParams<T>\n    ): PulumiAppResource<T>;\n\n    addRemoteResource<T>(name: string, getter: () => Promise<T>): PulumiAppRemoteResource<T>;\n\n    addOutput<T>(name: string, output: T): void;\n    addOutputs(outputs: Record<string, unknown>): void;\n\n    addModule<TModule>(def: PulumiAppModuleDefinition<TModule, void>): TModule;\n    addModule<TModule, TConfig>(\n        def: PulumiAppModuleDefinition<TModule, TConfig>,\n        config: TConfig\n    ): TModule;\n\n    getModule<TConfig, TModule>(def: PulumiAppModuleDefinition<TModule, TConfig>): TModule;\n    getModule<TConfig, TModule>(\n        def: PulumiAppModuleDefinition<TModule, TConfig>,\n        opts: { optional: false }\n    ): TModule;\n    getModule<TConfig, TModule>(\n        def: PulumiAppModuleDefinition<TModule, TConfig>,\n        opts: { optional: true }\n    ): TModule | null;\n\n    addHandler<T>(handler: () => Promise<T> | T): pulumi.Output<pulumi.Unwrap<T>>;\n\n    getParam<T>(param: T | ((app: PulumiApp) => T)): T;\n}\n"],"mappings":""}