pulumi-improvmx 0.1.0-alpha.0

package/.gitattributes

@@ -0,0 +1 @@
+* linguist-generated

package/README.md

@@ -0,0 +1 @@
+Manage ImprovMX email forwarding resources.

package/config/index.ts

@@ -0,0 +1,5 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+// Export members:
+export * from "./vars";

package/config/vars.ts

@@ -0,0 +1,20 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as utilities from "../utilities";
+
+declare var exports: any;
+const __config = new pulumi.Config("improvmx");
+
+/**
+ * The ImprovMX API token. Can also be set via IMPROVMX_API_TOKEN env var.
+ */
+export declare const apiToken: string | undefined;
+Object.defineProperty(exports, "apiToken", {
+    get() {
+        return __config.get("apiToken");
+    },
+    enumerable: true,
+});
+

package/domain.ts

@@ -0,0 +1,105 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as utilities from "./utilities";
+
+/**
+ * Manages an ImprovMX domain for email forwarding.
+ */
+export class Domain extends pulumi.CustomResource {
+    /**
+     * Get an existing Domain resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    public static get(name: string, id: pulumi.Input<pulumi.ID>, opts?: pulumi.CustomResourceOptions): Domain {
+        return new Domain(name, undefined as any, { ...opts, id: id });
+    }
+
+    /** @internal */
+    public static readonly __pulumiType = 'improvmx:index:Domain';
+
+    /**
+     * Returns true if the given object is an instance of Domain.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    public static isInstance(obj: any): obj is Domain {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === Domain.__pulumiType;
+    }
+
+    /**
+     * Whether the domain's DNS is correctly configured.
+     */
+    declare public /*out*/ readonly active: pulumi.Output<boolean>;
+    /**
+     * Display name of the domain.
+     */
+    declare public /*out*/ readonly display: pulumi.Output<string>;
+    /**
+     * The domain name to register with ImprovMX.
+     */
+    declare public readonly domain: pulumi.Output<string>;
+    /**
+     * Email address for delivery notifications.
+     */
+    declare public readonly notificationEmail: pulumi.Output<string | undefined>;
+    /**
+     * Webhook URL for delivery notifications.
+     */
+    declare public readonly webhook: pulumi.Output<string | undefined>;
+
+    /**
+     * Create a Domain resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: DomainArgs, opts?: pulumi.CustomResourceOptions) {
+        let resourceInputs: pulumi.Inputs = {};
+        opts = opts || {};
+        if (!opts.id) {
+            if (args?.domain === undefined && !opts.urn) {
+                throw new Error("Missing required property 'domain'");
+            }
+            resourceInputs["domain"] = args?.domain;
+            resourceInputs["notificationEmail"] = args?.notificationEmail;
+            resourceInputs["webhook"] = args?.webhook;
+            resourceInputs["active"] = undefined /*out*/;
+            resourceInputs["display"] = undefined /*out*/;
+        } else {
+            resourceInputs["active"] = undefined /*out*/;
+            resourceInputs["display"] = undefined /*out*/;
+            resourceInputs["domain"] = undefined /*out*/;
+            resourceInputs["notificationEmail"] = undefined /*out*/;
+            resourceInputs["webhook"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(Domain.__pulumiType, name, resourceInputs, opts);
+    }
+}
+
+/**
+ * The set of arguments for constructing a Domain resource.
+ */
+export interface DomainArgs {
+    /**
+     * The domain name to register with ImprovMX.
+     */
+    domain: pulumi.Input<string>;
+    /**
+     * Email address for delivery notifications.
+     */
+    notificationEmail?: pulumi.Input<string>;
+    /**
+     * Webhook URL for delivery notifications.
+     */
+    webhook?: pulumi.Input<string>;
+}

package/emailAlias.ts

@@ -0,0 +1,99 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as utilities from "./utilities";
+
+/**
+ * Manages an ImprovMX email alias (forwarding rule).
+ */
+export class EmailAlias extends pulumi.CustomResource {
+    /**
+     * Get an existing EmailAlias resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    public static get(name: string, id: pulumi.Input<pulumi.ID>, opts?: pulumi.CustomResourceOptions): EmailAlias {
+        return new EmailAlias(name, undefined as any, { ...opts, id: id });
+    }
+
+    /** @internal */
+    public static readonly __pulumiType = 'improvmx:index:EmailAlias';
+
+    /**
+     * Returns true if the given object is an instance of EmailAlias.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    public static isInstance(obj: any): obj is EmailAlias {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === EmailAlias.__pulumiType;
+    }
+
+    /**
+     * The alias name (e.g., 'info', '*' for catch-all).
+     */
+    declare public readonly alias: pulumi.Output<string>;
+    /**
+     * The domain this alias belongs to.
+     */
+    declare public readonly domain: pulumi.Output<string>;
+    /**
+     * Comma-separated destination email addresses.
+     */
+    declare public readonly forward: pulumi.Output<string>;
+
+    /**
+     * Create a EmailAlias resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: EmailAliasArgs, opts?: pulumi.CustomResourceOptions) {
+        let resourceInputs: pulumi.Inputs = {};
+        opts = opts || {};
+        if (!opts.id) {
+            if (args?.alias === undefined && !opts.urn) {
+                throw new Error("Missing required property 'alias'");
+            }
+            if (args?.domain === undefined && !opts.urn) {
+                throw new Error("Missing required property 'domain'");
+            }
+            if (args?.forward === undefined && !opts.urn) {
+                throw new Error("Missing required property 'forward'");
+            }
+            resourceInputs["alias"] = args?.alias;
+            resourceInputs["domain"] = args?.domain;
+            resourceInputs["forward"] = args?.forward;
+        } else {
+            resourceInputs["alias"] = undefined /*out*/;
+            resourceInputs["domain"] = undefined /*out*/;
+            resourceInputs["forward"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(EmailAlias.__pulumiType, name, resourceInputs, opts);
+    }
+}
+
+/**
+ * The set of arguments for constructing a EmailAlias resource.
+ */
+export interface EmailAliasArgs {
+    /**
+     * The alias name (e.g., 'info', '*' for catch-all).
+     */
+    alias: pulumi.Input<string>;
+    /**
+     * The domain this alias belongs to.
+     */
+    domain: pulumi.Input<string>;
+    /**
+     * Comma-separated destination email addresses.
+     */
+    forward: pulumi.Input<string>;
+}

package/index.ts

@@ -0,0 +1,60 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as utilities from "./utilities";
+
+// Export members:
+export { DomainArgs } from "./domain";
+export type Domain = import("./domain").Domain;
+export const Domain: typeof import("./domain").Domain = null as any;
+utilities.lazyLoad(exports, ["Domain"], () => require("./domain"));
+
+export { EmailAliasArgs } from "./emailAlias";
+export type EmailAlias = import("./emailAlias").EmailAlias;
+export const EmailAlias: typeof import("./emailAlias").EmailAlias = null as any;
+utilities.lazyLoad(exports, ["EmailAlias"], () => require("./emailAlias"));
+
+export { ProviderArgs } from "./provider";
+export type Provider = import("./provider").Provider;
+export const Provider: typeof import("./provider").Provider = null as any;
+utilities.lazyLoad(exports, ["Provider"], () => require("./provider"));
+
+export { SmtpCredentialArgs } from "./smtpCredential";
+export type SmtpCredential = import("./smtpCredential").SmtpCredential;
+export const SmtpCredential: typeof import("./smtpCredential").SmtpCredential = null as any;
+utilities.lazyLoad(exports, ["SmtpCredential"], () => require("./smtpCredential"));
+
+
+// Export sub-modules:
+import * as config from "./config";
+
+export {
+    config,
+};
+
+const _module = {
+    version: utilities.getVersion(),
+    construct: (name: string, type: string, urn: string): pulumi.Resource => {
+        switch (type) {
+            case "improvmx:index:Domain":
+                return new Domain(name, <any>undefined, { urn })
+            case "improvmx:index:EmailAlias":
+                return new EmailAlias(name, <any>undefined, { urn })
+            case "improvmx:index:SmtpCredential":
+                return new SmtpCredential(name, <any>undefined, { urn })
+            default:
+                throw new Error(`unknown resource type ${type}`);
+        }
+    },
+};
+pulumi.runtime.registerResourceModule("improvmx", "index", _module)
+pulumi.runtime.registerResourcePackage("improvmx", {
+    version: utilities.getVersion(),
+    constructProvider: (name: string, type: string, urn: string): pulumi.ProviderResource => {
+        if (type !== "pulumi:providers:improvmx") {
+            throw new Error(`unknown provider type ${type}`);
+        }
+        return new Provider(name, <any>undefined, { urn });
+    },
+});

package/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "pulumi-improvmx",
+    "version": "0.1.0-alpha.0+dev",
+    "homepage": "https://improvmx.com",
+    "scripts": {
+        "build": "tsc"
+    },
+    "dependencies": {
+        "@pulumi/pulumi": "^3.142.0"
+    },
+    "devDependencies": {
+        "@types/node": "^18",
+        "typescript": "^4.3.5"
+    },
+    "pulumi": {
+        "resource": true,
+        "name": "improvmx",
+        "version": "0.1.0-alpha.0+dev"
+    }
+}

package/provider.ts

@@ -0,0 +1,55 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as utilities from "./utilities";
+
+export class Provider extends pulumi.ProviderResource {
+    /** @internal */
+    public static readonly __pulumiType = 'improvmx';
+
+    /**
+     * Returns true if the given object is an instance of Provider.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    public static isInstance(obj: any): obj is Provider {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === "pulumi:providers:" + Provider.__pulumiType;
+    }
+
+    /**
+     * The ImprovMX API token. Can also be set via IMPROVMX_API_TOKEN env var.
+     */
+    declare public readonly apiToken: pulumi.Output<string | undefined>;
+
+    /**
+     * Create a Provider resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args?: ProviderArgs, opts?: pulumi.ResourceOptions) {
+        let resourceInputs: pulumi.Inputs = {};
+        opts = opts || {};
+        {
+            resourceInputs["apiToken"] = args?.apiToken ? pulumi.secret(args.apiToken) : undefined;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        const secretOpts = { additionalSecretOutputs: ["apiToken"] };
+        opts = pulumi.mergeOptions(opts, secretOpts);
+        super(Provider.__pulumiType, name, resourceInputs, opts);
+    }
+}
+
+/**
+ * The set of arguments for constructing a Provider resource.
+ */
+export interface ProviderArgs {
+    /**
+     * The ImprovMX API token. Can also be set via IMPROVMX_API_TOKEN env var.
+     */
+    apiToken?: pulumi.Input<string>;
+}

package/smtpCredential.ts

@@ -0,0 +1,107 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as utilities from "./utilities";
+
+/**
+ * Manages an ImprovMX SMTP credential for sending email.
+ */
+export class SmtpCredential extends pulumi.CustomResource {
+    /**
+     * Get an existing SmtpCredential resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    public static get(name: string, id: pulumi.Input<pulumi.ID>, opts?: pulumi.CustomResourceOptions): SmtpCredential {
+        return new SmtpCredential(name, undefined as any, { ...opts, id: id });
+    }
+
+    /** @internal */
+    public static readonly __pulumiType = 'improvmx:index:SmtpCredential';
+
+    /**
+     * Returns true if the given object is an instance of SmtpCredential.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    public static isInstance(obj: any): obj is SmtpCredential {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === SmtpCredential.__pulumiType;
+    }
+
+    /**
+     * Unix timestamp when the credential was created.
+     */
+    declare public /*out*/ readonly created: pulumi.Output<number>;
+    /**
+     * The domain this SMTP credential belongs to.
+     */
+    declare public readonly domain: pulumi.Output<string>;
+    /**
+     * The SMTP password.
+     */
+    declare public readonly password: pulumi.Output<string>;
+    /**
+     * The SMTP username.
+     */
+    declare public readonly username: pulumi.Output<string>;
+
+    /**
+     * Create a SmtpCredential resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: SmtpCredentialArgs, opts?: pulumi.CustomResourceOptions) {
+        let resourceInputs: pulumi.Inputs = {};
+        opts = opts || {};
+        if (!opts.id) {
+            if (args?.domain === undefined && !opts.urn) {
+                throw new Error("Missing required property 'domain'");
+            }
+            if (args?.password === undefined && !opts.urn) {
+                throw new Error("Missing required property 'password'");
+            }
+            if (args?.username === undefined && !opts.urn) {
+                throw new Error("Missing required property 'username'");
+            }
+            resourceInputs["domain"] = args?.domain;
+            resourceInputs["password"] = args?.password ? pulumi.secret(args.password) : undefined;
+            resourceInputs["username"] = args?.username;
+            resourceInputs["created"] = undefined /*out*/;
+        } else {
+            resourceInputs["created"] = undefined /*out*/;
+            resourceInputs["domain"] = undefined /*out*/;
+            resourceInputs["password"] = undefined /*out*/;
+            resourceInputs["username"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        const secretOpts = { additionalSecretOutputs: ["password"] };
+        opts = pulumi.mergeOptions(opts, secretOpts);
+        super(SmtpCredential.__pulumiType, name, resourceInputs, opts);
+    }
+}
+
+/**
+ * The set of arguments for constructing a SmtpCredential resource.
+ */
+export interface SmtpCredentialArgs {
+    /**
+     * The domain this SMTP credential belongs to.
+     */
+    domain: pulumi.Input<string>;
+    /**
+     * The SMTP password.
+     */
+    password: pulumi.Input<string>;
+    /**
+     * The SMTP username.
+     */
+    username: pulumi.Input<string>;
+}

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+    "compilerOptions": {
+        "outDir": "bin",
+        "target": "ES2020",
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "declaration": true,
+        "sourceMap": true,
+        "stripInternal": true,
+        "experimentalDecorators": true,
+        "noFallthroughCasesInSwitch": true,
+        "forceConsistentCasingInFileNames": true,
+        "strict": true
+    },
+    "files": [
+        "config/index.ts",
+        "config/vars.ts",
+        "domain.ts",
+        "emailAlias.ts",
+        "index.ts",
+        "provider.ts",
+        "smtpCredential.ts",
+        "utilities.ts"
+    ]
+}

package/utilities.ts

@@ -0,0 +1,96 @@
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+
+import * as runtime from "@pulumi/pulumi/runtime";
+import * as pulumi from "@pulumi/pulumi";
+
+export function getEnv(...vars: string[]): string | undefined {
+    for (const v of vars) {
+        const value = process.env[v];
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+
+export function getEnvBoolean(...vars: string[]): boolean | undefined {
+    const s = getEnv(...vars);
+    if (s !== undefined) {
+        // NOTE: these values are taken from https://golang.org/src/strconv/atob.go?s=351:391#L1, which is what
+        // Terraform uses internally when parsing boolean values.
+        if (["1", "t", "T", "true", "TRUE", "True"].find(v => v === s) !== undefined) {
+            return true;
+        }
+        if (["0", "f", "F", "false", "FALSE", "False"].find(v => v === s) !== undefined) {
+            return false;
+        }
+    }
+    return undefined;
+}
+
+export function getEnvNumber(...vars: string[]): number | undefined {
+    const s = getEnv(...vars);
+    if (s !== undefined) {
+        const f = parseFloat(s);
+        if (!isNaN(f)) {
+            return f;
+        }
+    }
+    return undefined;
+}
+
+export function getVersion(): string {
+    let version = require('./package.json').version;
+    // Node allows for the version to be prefixed by a "v", while semver doesn't.
+    // If there is a v, strip it off.
+    if (version.indexOf('v') === 0) {
+        version = version.slice(1);
+    }
+    return version;
+}
+
+/** @internal */
+export function resourceOptsDefaults(): any {
+    return { version: getVersion() };
+}
+
+/** @internal */
+export function lazyLoad(exports: any, props: string[], loadModule: any) {
+    for (let property of props) {
+        Object.defineProperty(exports, property, {
+            enumerable: true,
+            get: function() {
+                return loadModule()[property];
+            },
+        });
+    }
+}
+
+/** @internal */
+export async function callAsync<T>(
+    tok: string,
+    props: pulumi.Inputs,
+    res?: pulumi.Resource,
+    opts?: {property?: string},
+): Promise<T> {
+    const o: any = runtime.call<T>(tok, props, res);
+    const value = await o.promise(true /*withUnknowns*/);
+    const isKnown = await o.isKnown;
+    const isSecret = await o.isSecret;
+    const problem: string|undefined =
+        !isKnown ? "an unknown value"
+        : isSecret ? "a secret value"
+        : undefined;
+    // Ingoring o.resources silently. They are typically non-empty, r.f() calls include r as a dependency.
+    if (problem) {
+        throw new Error(`Plain resource method "${tok}" incorrectly returned ${problem}. ` +
+            "This is an error in the provider, please report this to the provider developer.");
+    }
+    // Extract a single property if requested.
+    if (opts && opts.property) {
+        return value[opts.property];
+    }
+    return value;
+}